dump(8)'s manual page is confusing in its use of records, blocks,

blocksizes, etc
does not give the default of -b
only mentiones rdump in the NAME section
uses both filesystem and file system in similar contexts

PR:		34248
Submitted by:	Gary W. Swearingen <swear@blarg.net>
MFC after:	3 days

1 files changed, 26 insertions, 13 deletions

diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8
index e20dacb..87b8577 100644
--- a/sbin/dump/dump.8
+++ b/sbin/dump/dump.8
@@ -53,7 +53,11 @@
 .Op Fl T Ar date
 .Ar filesystem
 .Nm
-.Op Fl W Li \&| Fl w
+.Fl W | Fl w
+.Pp
+.Nm rdump
+is an alternate name for
+.Nm .
 .Pp
 .in \" XXX
 (The
@@ -83,17 +87,23 @@ On media that cannot reliably return an end-of-media indication
 (such as some cartridge tape drives)
 each volume is of a fixed size;
 the actual size is determined by the tape size and density and/or
-block count options below.
+.Fl B
+options.
 By default, the same output file name is used for each volume
 after prompting the operator to change media.
 .Pp
+The filesystem to be dumped is specified by the argument
+.Ar filesystem
+as either its device-special file or its mount point
+(if that is in a standard entry in /etc/fstab).
+.Pp
 The following options are supported by
 .Nm :
 .Bl -tag -width Ds
 .It Fl 0\-9
 Dump levels.
 A level 0, full backup,
-guarantees the entire file system is copied
+guarantees the entire filesystem is copied
 (but see also the
 .Fl h
 option below).
@@ -112,11 +122,15 @@ recommended when appending to an existing tape, or using a tape
 drive with hardware compression (where you can never be sure about
 the compression ratio).
 .It Fl B Ar records
-The number of 1 KB blocks per volume.
+The number of kilobytes per output volume, except that if it is
+not an integer multiple of the output block size,
+the command uses the next smaller such multiple.
 This option overrides the calculation of tape size
 based on length and density.
 .It Fl b Ar blocksize
-The number of kilobytes per dump record.
+The number of kilobytes per output block, except that if it is
+larger than 64, the command uses 64. (See the BUGS section.)
+The default block size is 10.
 .It Fl c
 Change the defaults for use with a cartridge tape drive, with a density
 of 8000 bpi, and a length of 1700 feet.
@@ -243,7 +257,7 @@ but the
 option may be used to change it.
 .It Fl W
 .Nm Dump
-tells the operator what file systems need to be dumped.
+tells the operator what filesystems need to be dumped.
 This information is gleaned from the files
 .Pa dumpdates
 and
@@ -252,12 +266,12 @@ The
 .Fl W
 option causes
 .Nm
-to print out, for each file system in
+to print out, for each filesystem in
 the
 .Pa dumpdates
 file
 the most recent dump date and level,
-and highlights those file systems that should be dumped.
+and highlights those filesystems that should be dumped.
 If the
 .Fl W
 option is set, all other options are ignored, and
@@ -343,8 +357,7 @@ Always start with a level 0 backup, for example:
 This should be done at set intervals, say once a month or once every two months,
 and on a set of fresh tapes that is saved forever.
 .It
-After a level 0, dumps of active file
-systems are taken on a daily basis,
+After a level 0, dumps of active filesystems are taken on a daily basis,
 using a modified Tower of Hanoi algorithm,
 with this sequence of dump levels:
 .Bd -literal -offset indent
@@ -355,7 +368,7 @@ For the daily dumps, it should be possible to use a fixed number of tapes
 for each day, used on a weekly basis.
 Each week, a level 1 dump is taken, and
 the daily Hanoi sequence repeats beginning with 3.
-For weekly dumps, another fixed set of tapes per dumped file system is
+For weekly dumps, another fixed set of tapes per dumped filesystem is
 used, also on a cyclical basis.
 .El
 .Pp
@@ -378,7 +391,7 @@ see the
 .Fl D
 option)
 .It Pa /etc/fstab
-dump table: file systems and frequency
+dump table: filesystems and frequency
 .It Pa /etc/group
 to find group
 .Em operator
@@ -404,7 +417,7 @@ is written.
 Currently,
 .Xr physio 9
 slices all requests into chunks of 64 KB.  Therefore, it is
-impossible to use a larger tape blocksize, so
+impossible to use a larger output block size, so
 .Nm
 will prevent this from happening.
 .Pp