docs/84408: dump(8) manpage doesn't require an option and has wrong default

[Gary W. Swearingen]

>Number:         84408
>Category:       docs
>Synopsis:       dump(8) manpage doesn't require an option and has wrong default
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 31 18:30:22 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

-- dump(8) manpage synopsis doesn't require use of an option like the
program does. (An option is not optional!)

    $ dump /dev/ad0s3e
    dump: option requires an argument -- d

-- It also lists the wrong default /dev/sa0:

    $ dump -a /dev/ad0s3e
    ...
    DUMP: Cannot open output "/dev/nsa0".

-- Freebie: dump isn't restricted to just a tape unit so it doesn't
   only have a "default tape unit". I changed wording.

>How-To-Repeat:
n/a

>Fix:

--- dump..orig.8	Sun Jul 31 11:11:22 2005
+++ dump.8	Sun Jul 31 11:18:27 2005
@@ -38,7 +38,7 @@
 .Nd file system backup
 .Sh SYNOPSIS
 .Nm
-.Op Fl 0123456789acLnSu
+.Fl 0123456789acLnSu
 .Op Fl B Ar records
 .Op Fl b Ar blocksize
 .Op Fl C Ar cachesize
@@ -449,8 +449,8 @@
 .El
 .Sh FILES
 .Bl -tag -width /etc/dumpdates -compact
-.It Pa /dev/sa0
-default tape unit to dump to
+.It Pa /dev/nsa0
+default destination of the dump
 .It Pa /etc/dumpdates
 dump date records
 (this can be changed;
>Release-Note:
>Audit-Trail:
>Unformatted: