From: =?UTF-8?q?Rog=C3=A9rio=20Theodoro=20de=20Brito?= Date: Thu, 25 Nov 2010 00:00:00 -0200 Subject: Fix manpages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove typos, references in the "See also" sections of the manpages to commands that are not available in Debian systems (and, quite probably, other systems too) and non-Linux specific comments. Authored also by Christoph Hellwig and "A. Costa" Bug-Debian: http://bugs.debian.org/598714 Bug-Debian: http://bugs.debian.org/575201 Forwarded: no Reviewed-by: Rogério Theodoro de Brito --- fsck_hfs.tproj/fsck_hfs.8 | 18 +++++++----------- newfs_hfs.tproj/newfs_hfs.8 | 23 ++++++++--------------- 2 files changed, 15 insertions(+), 26 deletions(-) diff --git a/fsck_hfs.tproj/fsck_hfs.8 b/fsck_hfs.tproj/fsck_hfs.8 index aec9949..0bc804d 100644 --- a/fsck_hfs.tproj/fsck_hfs.8 +++ b/fsck_hfs.tproj/fsck_hfs.8 @@ -19,18 +19,18 @@ .Dt FSCK_HFS 8 .Os "Mac OS X" .Sh NAME -.Nm fsck_hfs +.Nm fsck.hfs .Nd HFS file system consistency check .Sh SYNOPSIS -.Nm fsck_hfs +.Nm fsck.hfs .Fl q .Op Fl df .Ar special ... -.Nm fsck_hfs +.Nm fsck.hfs .Fl p .Op Fl df .Ar special ... -.Nm fsck_hfs +.Nm fsck.hfs .Op Fl n | y | r .Op Fl dfgl .Op Fl m Ar mode @@ -52,9 +52,7 @@ The second form of preens the specified file systems. It is normally started by .Xr fsck 8 -run from -.Pa /etc/rc.boot -during automatic reboot, when a HFS file system is detected. +during system boot, when a HFS file system is detected. When preening file systems, .Nm will fix common inconsistencies for file systems that were not @@ -105,9 +103,9 @@ to check and repair journaled HFS+ file systems. .It Fl g Causes .Nm -to generate it's output strings in GUI format. +to generate its output strings in GUI format. This option is used when another application with a graphical user interface -(like Mac OS X Disk Utility) is envoking the +(like Mac OS X Disk Utility) is invoking the .Nm tool. .It Fl l @@ -144,8 +142,6 @@ specified file system for a new catalog file and if there is no damage to the leaf nodes in the existing catalog file. .El .Pp -Because of inconsistencies between the block device and the buffer cache, -the raw device should always be used. .Sh SEE ALSO .Xr fsck 8 .Sh BUGS diff --git a/newfs_hfs.tproj/newfs_hfs.8 b/newfs_hfs.tproj/newfs_hfs.8 index d002cc9..fe91962 100644 --- a/newfs_hfs.tproj/newfs_hfs.8 +++ b/newfs_hfs.tproj/newfs_hfs.8 @@ -19,10 +19,10 @@ .Dt NEWFS_HFS 8 .Os "Mac OS X" .Sh NAME -.Nm newfs_hfs +.Nm mkfs.hfs .Nd construct a new HFS Plus file system .Sh SYNOPSIS -.Nm newfs_hfs +.Nm mkfs.hfs .Op Fl N Ar [partition-size] .Op Fl U Ar uid .Op Fl G Ar gid @@ -37,19 +37,13 @@ .Op Fl v Ar volume-name .Ar special .Sh DESCRIPTION -.Nm Newfs_hfs +.Nm mkfs.hfs builds an HFS Plus file system on the specified special device. -Before running -.Nm newfs_hfs -the disk should be partitioned using the -.Em Disk Utility -application or -.Xr pdisk 8 . .Pp The file system default parameters are calculated based on the size of the disk partition. Typically the defaults are reasonable, however -.Nm newfs_hfs +.Nm mkfs.hfs has several options to allow the defaults to be selectively overridden. The options are as follows: .Bl -tag -width Fl @@ -66,7 +60,7 @@ Set the group of the file system's root directory to Specify the access permissions mask for the file system's root directory. .It Fl h Creates a legacy HFS format filesystem. This option -is not recomended for file systems that will be +is not recommended for file systems that will be primarily used with Mac OS X or Darwin. .It Fl s Creates a case-sensitive HFS Plus filesystem. By @@ -93,7 +87,7 @@ sizes are specified with the option followed by a comma separated list of the form arg=blocks. .Pp -Example: -c c=5000,e=500 +Example: \-c c=5000,e=500 .Bl -tag -width Fl .It Em a=blocks Set the attribute file clump size. @@ -126,7 +120,7 @@ the form arg=bytes. The size must be a power of two and no larger than 32768 bytes. .Pp -Example: -n c=8192,e=4096 +Example: \-n c=8192,e=4096 .Bl -tag -width Fl .It Em a=bytes Set the attribute b-tree node size. @@ -139,8 +133,7 @@ Set the extent overflow b-tree node size. Volume name (file system name) in ascii or UTF-8 format. .El .Sh SEE ALSO -.Xr mount 8 , -.Xr pdisk 8 +.Xr mount 8 .Sh HISTORY The .Nm