test-packsizelimit: test with python 3

[bup.git] / Documentation / bup-web.md

diff --git a/Documentation/bup-web.md b/Documentation/bup-web.md
index 6b650885fdd89e764b8578ae84e6e9a74b9b4f81..03a0a77d1e9c275fe6f41b15132d51ba8d0bdd09 100644 (file)
--- a/Documentation/bup-web.md
+++ b/Documentation/bup-web.md
@@ -10,6 +10,8 @@ bup-web - Start web server to browse bup repositiory
 
 bup web [[hostname]:port]
 
+bup web unix://path
+
 # DESCRIPTION
 
 `bup web` starts a web server that can browse bup repositories. The file
@@ -21,15 +23,18 @@ hierarchy is the same as that shown by `bup-fuse`(1), `bup-ls`(1) and
 you'd like to expose the web server to anyone on your network (dangerous!) you
 can omit the bind address to bind to all available interfaces: `:8080`.
 
+When `unix://path` is specified, the server will listen on the
+filesystem socket at `path` rather than a network socket.
+
 A `SIGTERM` signal may be sent to the server to request an orderly
 shutdown.
 
 # OPTIONS
 
---human-readable
+\--human-readable
 :   display human readable file sizes (i.e. 3.9K, 4.7M)
 
---browser
+\--browser
 :   open the site in the default browser
 
 # EXAMPLES
@@ -44,6 +49,14 @@ shutdown.
     ^C
     Interrupted.
 
+    $ bup web unix://socket &
+    Serving HTTP on filesystem socket 'socket'
+    $ curl --unix-socket ./socket http://localhost/
+    $ fg
+    bup web unix://socket
+    ^C
+    Interrupted.
+
     $ bup web &
     [1] 30980
     Serving HTTP on 127.0.0.1:8080...