[src/trunk]: src/usr.sbin/mtree improve enumeration of the different specfile...

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

details:   https://anonhg.NetBSD.org/src/rev/e3289723da1e
branches:  trunk
changeset: 516244:e3289723da1e
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Oct 19 02:57:34 2001 +0000

description:
improve enumeration of the different specfile entry types

diffstat:

 usr.sbin/mtree/mtree.8 |  50 +++++++++++++++++++++++++++-----------------------
 1 files changed, 27 insertions(+), 23 deletions(-)

diffs (111 lines):

diff -r 15ccd0c09540 -r e3289723da1e usr.sbin/mtree/mtree.8
--- a/usr.sbin/mtree/mtree.8    Fri Oct 19 02:53:02 2001 +0000
+++ b/usr.sbin/mtree/mtree.8    Fri Oct 19 02:57:34 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mtree.8,v 1.23 2001/10/09 04:50:01 lukem Exp $
+.\"    $NetBSD: mtree.8,v 1.24 2001/10/19 02:57:34 lukem Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)mtree.8    8.2 (Berkeley) 12/11/93
 .\"
-.Dd October 9, 2001
+.Dd October 19, 2001
 .Dt MTREE 8
 .Os
 .Sh NAME
@@ -359,10 +359,12 @@
 and
 .Sy uid .
 .Pp
-There are four types of lines in a specification.
+There are four types of lines in a specification:
 .Pp
-The first type of line sets a global value for a keyword, and consists of
-the string
+.Bl -enum
+.It
+Set global values for a keyword.
+This consists of the string
 .Ql /set
 followed by whitespace, followed by sets of keyword/value
 pairs, separated by whitespace.
@@ -371,17 +373,18 @@
 followed by a value, without whitespace characters.
 Once a keyword has been set, its value remains unchanged until either
 reset or unset.
-.Pp
-The second type of line unsets keywords and consists of the string
+.It
+Unset global values for a keyword.
+This consists of the string
 .Ql /unset ,
 followed by whitespace, followed by one or more keywords,
 separated by whitespace.
+.It
+A file specification, consisting of a path name, followed by whitespace,
+followed by zero or more whitespace separated keyword/value pairs.
 .Pp
-The third type of line is a file specification and consists of a file
-name, followed by whitespace, followed by zero or more whitespace
-separated keyword/value pairs.
-The file name may be preceded by whitespace characters.
-The file name may contain any of the standard file name matching
+The path name may be preceded by whitespace characters.
+The path name may contain any of the standard path name matching
 characters
 .Po
 .Ql [ ,
@@ -396,7 +399,7 @@
 .Nm
 uses
 .Xr strsvis 3
-(in VIS_CSTYLE format) to encode file names containing
+(in VIS_CSTYLE format) to encode path names containing
 non-printable characters. Whitespace characters are encoded as
 .Ql \es
 (space),
@@ -405,7 +408,7 @@
 .Ql \en
 (new line).
 .Ql #
-characters in file names are escaped by a preceding backslash
+characters in path names are escaped by a preceding backslash
 .Ql \e
 to distinguish them from comments.
 .Pp
@@ -417,22 +420,23 @@
 These values override, without changing, the global value of the
 corresponding keyword.
 .Pp
-A path that contains a slash
+A path name that contains a slash
 .Pq Ql /
 that is not the first character will be treated as a full path
 (relative to the root of the tree).
-All parent directories referenced in the path must exist.
-The current directory path used by relative paths will be updated
+All parent directories referenced in the path name must exist.
+The current directory path used by relative path names will be updated
 appropriately.
 .Pp
-A path that does not contain a slash will be treated as a relative path.
+A path name that does not contain a slash will be treated as a relative path.
 Specifying a directory will cause subsequent files to be searched
 for in that directory hierarchy.
-Which brings us to the last type of line in a specification: a line
-containing only the string
-.Dq Sy \&..
-causes the current directory
-path (used by relative paths) to ascend one level.
+.It
+A line containing only the string
+.Ql \&..
+which causes the current directory path (used by relative paths)
+to ascend one level.
+.El
 .Pp
 Empty lines and lines whose first non-whitespace character is a hash
 mark