Bug 112465

Summary: [patch] dumpfs.8: -m description incomprehensible
Product: Documentation Reporter: Christian Weisgerber <naddy>
Component: Books & ArticlesAssignee: Pav Lucistnik <pav>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Christian Weisgerber freebsd_committer freebsd_triage 2007-05-06 21:40:02 UTC
Currently, the -m option to dumpfs is described in dumpfs.8 like this:

     If -m is specified, the file system is marshalled in terms of a newfs(8)
     command to generate the file system.

This is incomprehensible.

OpenBSD has recently ported the functionality from FreeBSD and
modified the man page description:

     If -m is specified, a newfs(8) command is output that can be used to gen-
     erate a new file system with equivalent settings.

I suggest that our dumpfs.8 adopt the same phrasing.  This loses
the mnemonic value of -m, but clearness should be more important.
Comment 1 Pav Lucistnik freebsd_committer freebsd_triage 2007-05-12 23:28:21 UTC
State Changed
From-To: open->patched

Committed (I changed output for printed, output sounds awkward IMHO). 


Comment 2 Pav Lucistnik freebsd_committer freebsd_triage 2007-05-12 23:28:21 UTC
Responsible Changed
From-To: freebsd-doc->pav

Will MFC later
Comment 3 dfilter service freebsd_committer freebsd_triage 2007-05-12 23:35:28 UTC
pav         2007-05-12 22:35:22 UTC

  FreeBSD src repository (doc,ports committer)

  Modified files:
    sbin/dumpfs          dumpfs.8 
  Log:
  Replace incomprehensive description of -m by much clearer text from OpenBSD,
  with the exception of one word.
  
  PR:             docs/112465
  Submitted by:   naddy
  Obtained from:  OpenBSD
  MFC after:      1 week
  
  Revision  Changes    Path
  1.16      +3 -2      src/sbin/dumpfs/dumpfs.8
_______________________________________________
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"
Comment 4 Pav Lucistnik freebsd_committer freebsd_triage 2007-05-19 12:32:44 UTC
State Changed
From-To: patched->closed

MFC'ed.