[src/trunk]: src/lib/libc/gen more markup, sort options

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

details:   https://anonhg.NetBSD.org/src/rev/0d743100b1f0
branches:  trunk
changeset: 780936:0d743100b1f0
user:      christos <christos%NetBSD.org@localhost>
date:      Sun Aug 12 13:31:41 2012 +0000

description:
more markup, sort options

diffstat:

 lib/libc/gen/glob.3 |  67 +++++++++++++++++++++++++++-------------------------
 1 files changed, 35 insertions(+), 32 deletions(-)

diffs (118 lines):

diff -r f3d42b36d663 -r 0d743100b1f0 lib/libc/gen/glob.3
--- a/lib/libc/gen/glob.3       Sun Aug 12 13:26:18 2012 +0000
+++ b/lib/libc/gen/glob.3       Sun Aug 12 13:31:41 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: glob.3,v 1.40 2011/10/25 09:28:17 wiz Exp $
+.\"    $NetBSD: glob.3,v 1.41 2012/08/12 13:31:41 christos Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)glob.3     8.3 (Berkeley) 4/16/94
 .\"
-.Dd November 30, 2010
+.Dd August 12, 2012
 .Dt GLOB 3
 .Os
 .Sh NAME
@@ -230,31 +230,6 @@
 .Xr find 1
 patterns
 .Pc .
-.It Dv GLOB_MAGCHAR
-Set by the
-.Fn glob
-function if the pattern included globbing characters.
-See the description of the usage of the
-.Fa gl_matchc
-structure member for more details.
-.It Dv GLOB_NOMAGIC
-Is the same as
-.Dv GLOB_NOCHECK
-but it only appends the
-.Fa pattern
-if it does not contain any of the special characters ``*'', ``?'' or ``[''.
-.Dv GLOB_NOMAGIC
-is provided to simplify implementing the historic
-.Xr csh 1
-globbing behavior and should probably not be used anywhere else.
-.It Dv GLOB_NOESCAPE
-Disable the use of the backslash
-.Pq Ql \e
-character for quoting.
-.It Dv GLOB_TILDE
-Expand patterns that start with
-.Ql ~
-to user name home directories.
 .It Dv GLOB_LIMIT
 Limit the amount of memory used to store matched strings to
 .Li 64K ,
@@ -267,8 +242,27 @@
 service attack via patterns that expand to a very large number of matches,
 such as a long string of
 .Li */../*/..
-.It Dv GLOB_PERIOD
-Allow metacharacters to match a leading period in a filename.
+.It Dv GLOB_MAGCHAR
+Set by the
+.Fn glob
+function if the pattern included globbing characters.
+See the description of the usage of the
+.Fa gl_matchc
+structure member for more details.
+.It Dv GLOB_NOESCAPE
+Disable the use of the backslash
+.Pq Ql \e
+character for quoting.
+.It Dv GLOB_NOMAGIC
+Is the same as
+.Dv GLOB_NOCHECK
+but it only appends the
+.Fa pattern
+if it does not contain any of the special characters ``*'', ``?'' or ``[''.
+.Dv GLOB_NOMAGIC
+is provided to simplify implementing the historic
+.Xr csh 1
+globbing behavior and should probably not be used anywhere else.
 .It Dv GLOB_NO_DOTDIRS
 Hide
 .Sq Li \&.
@@ -277,13 +271,19 @@
 from metacharacter matches, regardless of whether
 .Dv GLOB_PERIOD
 is set and whether the pattern component begins with a literal period.
-.Dv GLOB_STAR
+.It Dv GLOB_PERIOD
+Allow metacharacters to match a leading period in a filename.
+.It Dv GLOB_STAR
 Indicates that two adjacent
 .Li *
 characters will do a recursive match in all subdirs, without following
 symbolic links and three adjacent
 .Li *
 characters will also follow symbolic links.
+.It Dv GLOB_TILDE
+Expand patterns that start with
+.Ql ~
+to user name home directories.
 .El
 .Pp
 If, during the search, a directory is encountered that cannot be opened
@@ -486,11 +486,14 @@
 that the flags
 .Dv GLOB_ALTDIRFUNC ,
 .Dv GLOB_BRACE ,
+.Dv GLOB_LIMIT ,
 .Dv GLOB_MAGCHAR ,
+.Dv GLOB_NOESCAPE ,
 .Dv GLOB_NOMAGIC ,
+.Dv GLOB_NO_DOTDIRS ,
+.Dv GLOB_PERIOD ,
+.Dv GLOB_STAR ,
 .Dv GLOB_TILDE ,
-and
-.Dv GLOB_LIMIT
 and the fields
 .Fa gl_matchc
 and