commit a7f1ab2973109633eb0b310212ef82c8e1eb2f3e
from: Russ Cox <rsc@swtch.com>
date: Tue May 10 17:45:19 2011 UTC

man: import fixes from plan 9 (0intro@gmail.com)

R=rsc
http://codereview.appspot.com/4519049

commit - 333482548d6b93fede42dc1944d3bb692098a211
commit + a7f1ab2973109633eb0b310212ef82c8e1eb2f3e
blob - 3ce718df103aec47e1150743db80b47cf95c2ac6
blob + 39f7c00ffe1e03d2f0b7e9e442b22ca8b04fe0be
--- man/man1/vac.1
+++ man/man1/vac.1
@@ -105,7 +105,7 @@ of 512 bytes to 52k.
 Reduce the number of blocks written to Venti by comparing the files to be stored with
 the contents of an existing
 .I vac
-file tree given by
+file tree whose score is stored in
 .IR oldvacfile .
 .TP
 .BI -e " exclude
@@ -122,7 +122,7 @@ matches any sequence of characters including slashes.
 .BI -f " vacfile
 The results of 
 .I vac
-are place in
+are placed in
 .IR vacfile ,
 or the standard output if no file is given.
 .TP
blob - cf16009124940b7cb1bf7bbdceef1666d1cb7f34
blob + 59db9e4f1e9b8f5f9ce7dfc5d66d166603cca60f
--- man/man1/venti.1
+++ man/man1/venti.1
@@ -133,7 +133,7 @@ The
 .B -i
 and
 .B -r
-option control
+options control
 .IR copy 's
 reaction to errors reading
 from
blob - 0383c0411e75ad4f6b41333f9fda1ab9251ec55e
blob + 6a144d83adad41825a62e8161398167c992cd5c3
--- man/man8/venti.8
+++ man/man8/venti.8
@@ -37,7 +37,8 @@ venti  \- archival storage server
 .I webroot
 ]
 .SH DESCRIPTION
-Venti is a SHA1-addressed archival storage server.
+.I Venti
+is a SHA1-addressed archival storage server.
 See 
 .IR venti (7)
 for a full introduction to the system.
@@ -222,11 +223,13 @@ the venti protocol as described in
 .IR venti (7),
 and one serving HTTP
 (conventionally TCP port 
-.BR venti ,
+.BR http ,
 80).
 .PP
 The venti web server provides the following 
 URLs for accessing status information:
+.TF "\fL/storage"
+.PD
 .TP
 .B /index
 A summary of the usage of the arenas and index sections.
@@ -317,6 +320,8 @@ The configuration file consists of lines in the form d
 Lines starting with
 .B #
 are comments.
+.TF "\fLindex\fI name "
+.PD
 .TP
 .BI index " name
 Names the index for the system.
@@ -350,7 +355,7 @@ flag to update the index.
 The configuration file also holds configuration parameters
 for the venti server itself.
 These are:
-.TF httpaddr netaddr
+.TF "\fLhttpaddr\fI netaddr "
 .TP
 .BI mem " size
 lump cache size
@@ -376,8 +381,9 @@ queue writes in memory
 (default is not to queue)
 .TP
 .BI webroot " dir
-directory tree containing files for HTTP server
-to consult for unrecognized URLs
+directory tree containing files for
+.IR venti 's
+internal HTTP server to consult for unrecognized URLs
 .PD
 .PP
 The units for the various cache sizes above can be specified by appending a
@@ -415,6 +421,8 @@ can be specified in the configuration file.
 The command line options override those found in a
 configuration file.
 Additional options are:
+.TF "\fL-c\fI config"
+.PD
 .TP
 .BI -c " config
 The server configuration file
@@ -452,12 +460,13 @@ icmem 30M
 % 
 .EE
 .PP
-Format the index sections, the arena partition, and 
+Format the index sections, the arena partition,
+the bloom filter, and
 finally the main index:
 .IP
 .EX
-% venti/fmtisect isect0. /tmp/disks/isect0 &
-% venti/fmtisect isect1. /tmp/disks/isect1 &
+% venti/fmtisect isect0. /tmp/disks/isect0
+% venti/fmtisect isect1. /tmp/disks/isect1
 % venti/fmtarenas arenas0. /tmp/disks/arenas &
 % venti/fmtbloom /tmp/disks/bloom &
 % wait