blob: 736841fbb14dec778cb7683fbb0ec991c5a9284f [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001From: =?UTF-8?q?Rog=C3=A9rio=20Theodoro=20de=20Brito?= <rbrito@ime.usp.br>
2Date: Thu, 25 Nov 2010 00:00:00 -0200
3Subject: Fix manpages
4MIME-Version: 1.0
5Content-Type: text/plain; charset=UTF-8
6Content-Transfer-Encoding: 8bit
7
8Remove typos, references in the "See also" sections of the manpages to
9commands that are not available in Debian systems (and, quite probably,
10other systems too) and non-Linux specific comments.
11
12Authored also by Christoph Hellwig <hch@lst.de> and "A. Costa" <agcosta@gis.net>
13
14Bug-Debian: http://bugs.debian.org/598714
15Bug-Debian: http://bugs.debian.org/575201
16Forwarded: no
17Reviewed-by: Rogério Theodoro de Brito <rbrito@ime.usp.br>
18---
19 fsck_hfs.tproj/fsck_hfs.8 | 18 +++++++-----------
20 newfs_hfs.tproj/newfs_hfs.8 | 23 ++++++++---------------
21 2 files changed, 15 insertions(+), 26 deletions(-)
22
23--- a/fsck_hfs.tproj/fsck_hfs.8
24+++ b/fsck_hfs.tproj/fsck_hfs.8
25@@ -19,18 +19,18 @@
26 .Dt FSCK_HFS 8
27 .Os "Mac OS X"
28 .Sh NAME
29-.Nm fsck_hfs
30+.Nm fsck.hfs
31 .Nd HFS file system consistency check
32 .Sh SYNOPSIS
33-.Nm fsck_hfs
34+.Nm fsck.hfs
35 .Fl q
36 .Op Fl df
37 .Ar special ...
38-.Nm fsck_hfs
39+.Nm fsck.hfs
40 .Fl p
41 .Op Fl df
42 .Ar special ...
43-.Nm fsck_hfs
44+.Nm fsck.hfs
45 .Op Fl n | y | r
46 .Op Fl dfgl
47 .Op Fl m Ar mode
48@@ -52,9 +52,7 @@ The second form of
49 preens the specified file systems.
50 It is normally started by
51 .Xr fsck 8
52-run from
53-.Pa /etc/rc.boot
54-during automatic reboot, when a HFS file system is detected.
55+during systen boot, when a HFS file system is detected.
56 When preening file systems,
57 .Nm
58 will fix common inconsistencies for file systems that were not
59@@ -105,9 +103,9 @@ to check and repair journaled HFS+ file
60 .It Fl g
61 Causes
62 .Nm
63-to generate it's output strings in GUI format.
64+to generate its output strings in GUI format.
65 This option is used when another application with a graphical user interface
66-(like Mac OS X Disk Utility) is envoking the
67+(like Mac OS X Disk Utility) is invoking the
68 .Nm
69 tool.
70 .It Fl l
71@@ -144,8 +142,6 @@ specified file system for a new catalog
72 to the leaf nodes in the existing catalog file.
73 .El
74 .Pp
75-Because of inconsistencies between the block device and the buffer cache,
76-the raw device should always be used.
77 .Sh SEE ALSO
78 .Xr fsck 8
79 .Sh BUGS
80--- a/newfs_hfs.tproj/newfs_hfs.8
81+++ b/newfs_hfs.tproj/newfs_hfs.8
82@@ -19,10 +19,10 @@
83 .Dt NEWFS_HFS 8
84 .Os "Mac OS X"
85 .Sh NAME
86-.Nm newfs_hfs
87+.Nm mkfs.hfs
88 .Nd construct a new HFS Plus file system
89 .Sh SYNOPSIS
90-.Nm newfs_hfs
91+.Nm mkfs.hfs
92 .Op Fl N Ar [partition-size]
93 .Op Fl U Ar uid
94 .Op Fl G Ar gid
95@@ -37,19 +37,13 @@
96 .Op Fl v Ar volume-name
97 .Ar special
98 .Sh DESCRIPTION
99-.Nm Newfs_hfs
100+.Nm mkfs.hfs
101 builds an HFS Plus file system on the specified special device.
102-Before running
103-.Nm newfs_hfs
104-the disk should be partitioned using the
105-.Em Disk Utility
106-application or
107-.Xr pdisk 8 .
108 .Pp
109 The file system default parameters are calculated based on
110 the size of the disk partition. Typically the defaults are
111 reasonable, however
112-.Nm newfs_hfs
113+.Nm mkfs.hfs
114 has several options to allow the defaults to be selectively overridden.
115 The options are as follows:
116 .Bl -tag -width Fl
117@@ -66,7 +60,7 @@ Set the group of the file system's root
118 Specify the access permissions mask for the file system's root directory.
119 .It Fl h
120 Creates a legacy HFS format filesystem. This option
121-is not recomended for file systems that will be
122+is not recommended for file systems that will be
123 primarily used with Mac OS X or Darwin.
124 .It Fl s
125 Creates a case-sensitive HFS Plus filesystem. By
126@@ -93,7 +87,7 @@ sizes are specified with the
127 option followed by a comma
128 separated list of the form arg=blocks.
129 .Pp
130-Example: -c c=5000,e=500
131+Example: \-c c=5000,e=500
132 .Bl -tag -width Fl
133 .It Em a=blocks
134 Set the attribute file clump size.
135@@ -126,7 +120,7 @@ the form arg=bytes. The
136 size must be a power of two and no larger than
137 32768 bytes.
138 .Pp
139-Example: -n c=8192,e=4096
140+Example: \-n c=8192,e=4096
141 .Bl -tag -width Fl
142 .It Em a=bytes
143 Set the attribute b-tree node size.
144@@ -139,8 +133,7 @@ Set the extent overflow b-tree node size
145 Volume name (file system name) in ascii or UTF-8 format.
146 .El
147 .Sh SEE ALSO
148-.Xr mount 8 ,
149-.Xr pdisk 8
150+.Xr mount 8
151 .Sh HISTORY
152 The
153 .Nm