[src/trunk]: src/usr.sbin/mtree - Sort order of options mentioned in text;

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/399fdb3dcb6c
branches:  trunk
changeset: 781843:399fdb3dcb6c
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Oct 03 19:27:48 2012 +0000

description:
- Sort order of options mentioned in text;
- improve wording;
- remove unneeded macros (fixes mandoc(1) warnings);
- in the `EXAMPLES' section, for `-d', mention the use of `-U'
  besides that of `-u' (as the former is a variant on the latter).

>From Bug Hunting.

diffstat:

 usr.sbin/mtree/mtree.8 |  28 ++++++++++++++--------------
 1 files changed, 14 insertions(+), 14 deletions(-)

diffs (106 lines):

diff -r 330498200eeb -r 399fdb3dcb6c usr.sbin/mtree/mtree.8
--- a/usr.sbin/mtree/mtree.8    Wed Oct 03 19:19:09 2012 +0000
+++ b/usr.sbin/mtree/mtree.8    Wed Oct 03 19:27:48 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mtree.8,v 1.53 2010/01/20 14:00:48 wiz Exp $
+.\"    $NetBSD: mtree.8,v 1.54 2012/10/03 19:27:48 wiz Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -104,8 +104,8 @@
 (beginning with
 .Dq \&./ )
 is always printed as the first field;
+.Fl K ,
 .Fl k ,
-.Fl K ,
 and
 .Fl R
 can be used to control which other keywords are printed;
@@ -113,6 +113,7 @@
 and
 .Fl I
 can be used to control which files are printed;
+and the
 .Fl S
 option can be used to sort the output.
 .It Fl c
@@ -187,13 +188,13 @@
 set either in the specification or the file, exact checking will be
 performed.
 This option may not be set at the same time as the
-.Fl u
+.Fl U
 or
-.Fl U
+.Fl u
 option.
 .It Fl M
 Permit merging of specification entries with different types,
-with the last entry take precedence.
+with the last entry taking precedence.
 .It Fl m
 If the schg and/or sappnd flags are specified, reset these flags.
 Note that this is only possible with securelevel less than 1 (i.e.,
@@ -287,9 +288,9 @@
 ownership, mode, flags, or time
 when creating new directories or changing existing entries.
 This option will be most useful when used in conjunction with
-.Fl u
+.Fl U
 or
-.Fl U .
+.Fl u .
 .It Fl X Ar exclude-file
 The specified file contains
 .Xr fnmatch 3
@@ -329,7 +330,6 @@
 .Sy char
 file types.
 The argument must be one of the following forms:
-.Pp
 .Bl -tag -width 4n
 .It Ar format , Ns Ar major , Ns Ar minor
 A device with
@@ -498,7 +498,6 @@
 .Sy uid .
 .Pp
 There are four types of lines in a specification:
-.Pp
 .Bl -enum
 .It
 Set global values for a keyword.
@@ -581,7 +580,7 @@
 Multiple entries for the same full path are permitted if the types
 are the same (unless
 .Fl M
-is given, and then the types may differ);
+is given, in which case the types may differ);
 in this case the settings for the last entry take precedence.
 .Pp
 A path name that does not contain a slash will be treated as a relative path.
@@ -631,10 +630,11 @@
 .Pp
 The
 .Fl d
-and
+option can be used in combination with
+.Fl U
+or
 .Fl u
-options can be used in combination to create directory hierarchies
-for distributions and other such things.
+to create directory hierarchies for, for example, distributions.
 .Sh SEE ALSO
 .Xr chflags 1 ,
 .Xr chgrp 1 ,
@@ -681,8 +681,8 @@
 .Fl D ,
 .Fl E ,
 .Fl I ,
+.Fl L ,
 .Fl l ,
-.Fl L ,
 .Fl N ,
 .Fl P ,
 .Fl R ,