Subject: misc/5402: dump man page is incorrect
To: None <gnats-bugs@gnats.netbsd.org>
From: None <ksulliva@psc.edu>
List: netbsd-bugs
Date: 05/05/1998 09:00:41
>Number:         5402
>Category:       misc
>Synopsis:       dump man page is incorrect
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people (Misc Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue May  5 06:05:01 1998
>Last-Modified:
>Originator:     Kevin Sullivan
>Organization:
Pittsburgh Supercomputing Center
>Release:        1.3
>Environment:
	
System: NetBSD kludge.psc.edu 1.3 NetBSD 1.3 (KLUDGE) #0: Tue Jan 6 15:49:51 EST 1998 ksulliva@pit.psc.edu:/usr/src/sys/arch/i386/compile/KLUDGE i386


>Description:

The dump(8) man page says:

A level
number above 0, incremental backup, tells dump to copy all files
new or modified since the last dump of the same or lower level.

However, tests on dump show that "dump -N" will dump all files since
the last "N-1 or lower" dump, not "N or lower" as the man page states.

The "Unix System Admin Handbook (2nd ed)" agrees with dump's behavior,
as does the dump program on Digital Unix.  Thus, the man page is
probably the one in error.

I saw this error in 1.3, but it remains in -current.

>How-To-Repeat:

>Fix:
In dump.8:

@@ -107,5 +107,5 @@
 tells dump to
 copy all files new or modified since the
-last dump of the same or lower level.
+last dump of a lower level.
 The default level is 9.
 .It Fl B Ar records

>Audit-Trail:
>Unformatted: