From garys@opusnet.com  Sun Jul 31 18:27:15 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C3E5816A420
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 31 Jul 2005 18:27:15 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1B4A343D62
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 31 Jul 2005 18:27:14 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id A7FE545D00C4; Sun, 31 Jul 2005 11:27:10 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j6VISTon036903
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 31 Jul 2005 11:28:29 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j6VISOgZ036902;
	Sun, 31 Jul 2005 11:28:24 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <zm8xzm7ruf.xzm@mail.opusnet.com>
Date: Sun, 31 Jul 2005 11:28:24 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: dump(8) manpage doesn't require an option and has wrong default
X-GNATS-Notify:

>Number:         84408
>Category:       docs
>Synopsis:       [patch] dump(8) manpage doesn't require an option and has wrong default
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 31 18:30:22 GMT 2005
>Closed-Date:    Thu Oct 12 20:25:38 GMT 2006
>Last-Modified:  Mon Oct 16 12:00:43 GMT 2006
>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:

From: garys@opusnet.com (Gary W. Swearingen)
To: FreeBSD-gnats-submit@FreeBSD.org
Cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/84408: dump(8) manpage doesn't require an option and has
 wrong default
Date: Sun, 31 Jul 2005 16:35:29 -0700

 I was wrong about the "wrong default"; I forgot I had TAPE defined
 when I tested.
 
 The patch should have only been:
 
 --- 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
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Thu Oct 12 20:22:49 UTC 2006 
State-Changed-Why:  
Actually they are optional; the old BSD 4.3 suntax support got in 
the way (should be fixed now). 


Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: ru 
Responsible-Changed-When: Thu Oct 12 20:22:49 UTC 2006 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=84408 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84408: commit references a PR
Date: Thu, 12 Oct 2006 20:22:39 +0000 (UTC)

 ru          2006-10-12 20:22:31 UTC
 
   FreeBSD src repository
 
   Modified files:
     sbin/dump            main.c 
   Log:
   Make "dump /filesystem" (without options) work.
   
   PR:             docs/84408
   MFC after:      3 days
   
   Revision  Changes    Path
   1.65      +5 -2      src/sbin/dump/main.c
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84408: commit references a PR
Date: Mon, 16 Oct 2006 11:52:17 +0000 (UTC)

 ru          2006-10-16 11:52:00 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     sbin/dump            main.c 
   Log:
   MFC: 1.65: Make "dump /filesystem" (without options) work.
   
   PR:             docs/84408
   Approved by:    re (hrs)
   
   Revision  Changes    Path
   1.63.2.2  +5 -2      src/sbin/dump/main.c
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
