From swear@blarg.net  Mon Jan 14 18:31:28 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 157A237B405
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Jan 2002 18:31:28 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id BF5C5BCFF
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Jan 2002 18:31:27 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id SAA32581
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Jan 2002 18:31:27 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g0F2YBb04988;
	Mon, 14 Jan 2002 18:34:11 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <jwofjwuyu4.fjw@localhost.localdomain>
Date: 14 Jan 2002 18:34:11 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: dump(8) man page is misleading in nodump paragraph
X-GNATS-Notify:

>Number:         33907
>Category:       docs
>Synopsis:       dump(8) man page is misleading in nodump paragraph
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 14 18:40:00 PST 2002
>Closed-Date:    Sun Feb 10 14:14:11 PST 2002
>Last-Modified:  Sun Feb 10 14:14:31 PST 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-PRERELEASE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The paragraph of the dump(8) man page which discusses the "nodump" file
flag is only true with certain values of dump level and the -h option
which the paragraph doesn't mention.  The lack of -h mention makes the
paragraph strictly untrue and will mislead those who have forgotten or
not noticed the -h option.  (I say from personal experience which would
have cost me much wasted "chflags"ing, save a lucky -questions thread.)

Also: The man page doesn't have "chflags(1)" in "SEE ALSO" which may be
used to change the "nodump" flag and which references "chflags(2)" which
discusses the "UF_NODUMP" constant mentioned in the dump(8) man page.
================
>How-To-Repeat:
n/a
================
>Fix:

Note: Maybe "chflags(2)" should also be in SEE ALSO; I omitted it.

patch -d "unknown uncompressed man directory" < this-PR

--- /tmp/dump..orig.8	Mon Jan 14 17:03:21 2002
+++ /tmp/dump.8	Mon Jan 14 17:49:46 2002
@@ -264,21 +264,12 @@
 Is like W, but prints only those filesystems which need to be dumped.
 .El
 .Pp
-.Nm Dump
-honors the user
+Directories and regular files which have their
 .Dq nodump
 flag
 .Pq Dv UF_NODUMP
-on regular files and directories.
-If a directory is marked
-.Dq nodump ,
-the latter and all files and directories under it will not be backed
-up.
-That is,
-.Nm
-propagates the
-.Dq nodump
-flag on directories.
+set will be omitted along with everything under such directories,
+all subject to the -h option.
 .Pp
 .Nm Dump
 requires operator intervention on these conditions:
@@ -386,6 +377,7 @@
 .Em operator
 .El
 .Sh SEE ALSO
+.Xr chflags 1 ,
 .Xr fstab 5 ,
 .Xr restore 8 ,
 .Xr rmt 8
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sun Feb 10 14:14:11 PST 2002 
State-Changed-Why:  
Patch applied after a small change, thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=33907 
>Unformatted:
