man: import changes from plan 9

R=rsc
CC=plan9port.codebot
http://codereview.appspot.com/4559071

man/man8/venti-fmt.8

@@ -69,14 +69,15 @@ syncindex \- prepare and maintain a venti server
 .PP
 .B venti/buildindex
 [
-.B -B
-.I blockcachesize
-]
-[
-.B -Z
+.B -bd
+] [
+.B -i
+.I isect
+] ... [
+.B -M
+.I imemsize
 ]
 .I venti.conf
-.I tmp
 .PP
 .B venti/checkindex
 [
@@ -94,17 +95,6 @@ syncindex \- prepare and maintain a venti server
 .B -afv 
 ]
 .I file
-.PP
-.B venti/copy
-[
-.B -f
-]
-.I src
-.I dst
-.I score
-[
-.I type
-]
 .SH DESCRIPTION
 These commands aid in the setup, maintenance, and debugging of
 venti servers.
@@ -325,13 +315,12 @@ This command is typically used to build a new index for a Venti
 system when the old index becomes too small, or to rebuild
 an index after media failure.
 Small errors in an index can usually be fixed with
-.IR checkindex .
-.PP
-The
-.I tmp
-file, usually a disk partition, must be large enough to store a copy of the index.
-This temporary space is used to perform a merge sort of index entries
-generated by reading the arenas.
+.IR checkindex ,
+but 
+.I checkindex
+requires a large temporary workspace and 
+.I buildindex
+does not.
 .PP
 Options to 
 .I buildindex
@@ -339,18 +328,26 @@ are:
 .TF "\fL-M\fI imemsize"
 .PD
 .TP
-.BI -B " blockcachesize
+.B -b
+Reinitialise the Bloom filter, if any.
+.TP
+.B -d
+`Dumb' mode; run all three passes.
+.TP
+.BI -i " isect
+Only rebuild index section
+.IR isect ;
+may be repeated to rebuild multiple sections.
+The name
+.L none
+is special and just reads the arenas.
+.TP
+.BI -M " imemsize
 The amount of memory, in bytes, to use for caching raw disk accesses while running
 .IR buildindex .
 (This is not a property of the created index.)
-The default is 8k.
-.TP
-.B -Z
-Do not zero the index.
-This option should only be used when it is known that the index was already zeroed.
-(Version 1 indexes only; see the discussion in
-.I fmtindex
-above.)
+The usual suffices apply.
+The default is 256M.
 .PD
 .PP
 .I Checkindex
@@ -409,5 +406,3 @@ Increase the verbosity of output.
 .SH BUGS
 .I Buildindex
 should allow an individual index section to be rebuilt.
-The merge sort could be performed in the space used to store the
-index rather than requiring a temporary file.