From: =?UTF-8?q?Rog=C3=A9rio=20Theodoro=20de=20Brito?= <rbrito@ime.usp.br>
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 <hch@lst.de> and "A. Costa" <agcosta@gis.net>
Bug-Debian: http://bugs.debian.org/598714
Bug-Debian: http://bugs.debian.org/575201
Forwarded: no
Reviewed-by: Rogério Theodoro de Brito <rbrito@ime.usp.br>
---
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
|
