Add secondary HTTP storage

Fixes: #858

1 files changed, 22 insertions, 0 deletions

diff --git a/doc/MANUAL.adoc b/doc/MANUAL.adoc
index 50292ee9..fe5f7cdb 100644
--- a/doc/MANUAL.adoc
+++ b/doc/MANUAL.adoc
@@ -796,6 +796,7 @@ Examples:
 +
 * `file:///shared/nfs/directory`
 * `file:///shared/nfs/one|read-only file:///shared/nfs/two`
+* `http://example.org/cache`
 
 [[config_sloppiness]] *sloppiness* (*CCACHE_SLOPPINESS*)::
 
@@ -931,6 +932,27 @@ Optional attributes:
 * *update-mtime*: If *true*, update the modification time (mtime) of cache
   entries that are read. The default is *false*.
 
+=== HTTP storage backend
+
+URL format: `http://HOST[:PORT][/PATH]`
+
+This backend stores data in an HTTP compatible server. The required HTTP
+methods are `GET`, `PUT` and `DELETE`.
+
+Note that ccache will not perform any cleanup of the HTTP storage.
+
+Examples:
+
+* `http://localhost:8080/`
+* `http://example.org/cache`
+
+Known issues and limitations:
+
+* URLs containing IPv6 addresses like `http://[::1]/` are not supported
+* There are no HTTP timeouts implemented or configured
+* Authentication is not yet supported
+* HTTPS is not yet supported
+
 == Cache size management
 
 By default, ccache has a 5 GB limit on the total size of files in the cache and