Module Name: othersrc
Committed By: wiz
Date: Sat Mar 19 08:56:00 UTC 2011
Modified Files:
othersrc/external/bsd/find2/dist: find2.1
Log Message:
Sort options; use complete sentences in all option descriptions; add
EXIT STATUS section; use Ss for non-standard sections; upgrade history;
use standard section headers; some whitespace and punctuation nits.
To generate a diff of this commit:
cvs rdiff -u -r1.1.1.1 -r1.2 othersrc/external/bsd/find2/dist/find2.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: othersrc/external/bsd/find2/dist/find2.1
diff -u othersrc/external/bsd/find2/dist/find2.1:1.1.1.1 othersrc/external/bsd/find2/dist/find2.1:1.2
--- othersrc/external/bsd/find2/dist/find2.1:1.1.1.1 Sat Mar 19 04:44:51 2011
+++ othersrc/external/bsd/find2/dist/find2.1 Sat Mar 19 08:56:00 2011
@@ -1,7 +1,7 @@
-.\" $NetBSD: find2.1,v 1.1.1.1 2011/03/19 04:44:51 agc Exp $ */
+.\" $NetBSD: find2.1,v 1.2 2011/03/19 08:56:00 wiz Exp $ */
.\"
.\"
-.\" $NetBSD: find2.1,v 1.1.1.1 2011/03/19 04:44:51 agc Exp $
+.\" $NetBSD: find2.1,v 1.2 2011/03/19 08:56:00 wiz Exp $
.\"
.\" Copyright (c) 2005-2011 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -34,14 +34,14 @@
.Nd find and display selected file system entries
.Sh SYNOPSIS
.Nm
-.Op Fl 0HLPXilvx
+.Op Fl 0HiLlPvXx
.Ar selection
-.Ar directory...
+.Ar directory ...
.Sh DESCRIPTION
The
.Nm
-utility selects file system entries and displays them. It performs the same
-work that
+utility selects file system entries and displays them.
+It performs the same work that
.Xr find 1
does, but uses a more socially-acceptable set of selection criteria, based
upon the same operator set as used in the C language.
@@ -49,48 +49,44 @@
.Pp
.Bl -tag -width Ds
.It Fl 0
-(zero) terminate the names of file system entries with a nul byte (ASCII 0),
+(Zero) terminate the names of file system entries with a nul byte (ASCII 0),
which can be use by
.Xr xargs 1
to nullify certain types of security compromises using files with
embedded blanks.
.It Fl H
-use
+Use
.Xr stat 2
instead of
.Xr lstat 2
to gather information on file system entries, the same as
-.Fl L
+.Fl L .
+.It Fl i
+Ignore case in file system entry names when doing comparisons.
.It Fl L
-use
+Use
.Xr stat 2
instead of
.Xr lstat 2
to gather information on file system entries, the same as
.Fl H .
+.It Fl l
+Display file system information in the form of a long listing.
.It Fl P
-use
+Use
.Xr lstat 2
instead of
.Xr stat 2
to gather information on file system entries (the default).
+.It Fl v
+Enables verbose mode - explain the commands as they are executed.
.It Fl X
Do not follow a symbolic link if its target is a directory.
-.It Fl i
-Ignore case in file system entry names when doing comparisons.
-.It Fl l
-Display file system information in the form of a long listing.
-.It Fl v
-enables verbose mode - explain the commands as they are executed.
.It Fl x
Restrict the search to the same device as the one upon which the original
directory is situated.
.El
-.Pp
-The
-.Nm
-utility exits 0 on success, and \*[Gt]0 if an error occurs.
-.Sh SELECTION CRITERIA
+.Ss SELECTION CRITERIA
The selection criteria are based on the C language, and attempt to be
concise and easily remembered.
.Pp
@@ -131,7 +127,7 @@
.Dl G
.Dl T
.Pp
-which correspond to kilo (1024), mega, giga and tera,
+which correspond to kilo (1024), mega, giga, and tera,
respectively.
.Pp
For fields like mage, cage, and aage, some
@@ -150,14 +146,13 @@
and
.Pa ||
can be used to build up selection criteria consisting of multiple criteria).
-.Sh FIELDS
-.Pp
+.Ss FIELDS
The individual fields are:
.Ar pathname
is the full path name of the file.
.Ar fnmatch
means that the globbing or wildcard match, using the shell expansion
-rules described in
+rules described in
.Xr fnmatch 3
are used.
.Ar regexp
@@ -188,18 +183,16 @@
is the mode of the file,
and
.Ar blocks
-is the number of blocks used for the contents of
-the file.
+is the number of blocks used for the contents of the file.
.Ar type
-is the type of the directory entry,
+is the type of the directory entry,
Possible values for this field are outlined below.
-and
.Ar dev
is the device number on which the entry is stored.
.Ar uid
and
.Ar gid
-are the user and group identifiers,
+are the user and group identifiers,
The
.Ar fstype
field matches the file system type on which the entry resides,
@@ -210,7 +203,8 @@
.Dq age
fields,
.Ar mage ,
-.Ar cage and
+.Ar cage ,
+and
.Ar aage
which correspond to the total time elapsed from the
mtime, ctime and atime fields, respectively.
@@ -250,10 +244,12 @@
.Dl socket
.Dl S_IFSOCK
.Dl s
-.Pp
+.Sh EXIT STATUS
+.Ex -std find2
.Sh EXAMPLES
-The simplest example is one to find a file named "defs.h", starting
-the search from the current working directory:
+The simplest example is one to find a file named
+.Dq Pa defs.h ,
+starting the search from the current working directory:
.Dl find2 'name == defs.h'\ .
.Pp
We can also use shell 'globbing' to achieve the same kind of searching:
@@ -302,17 +298,17 @@
.Xr find 1 ,
.Xr xargs 1 ,
.Xr lstat 2 ,
-.Xr stat 2
-.Xr fnmatch 3
+.Xr stat 2 ,
+.Xr fnmatch 3 ,
.Xr re_format 7
.Sh HISTORY
The
.Nm
utility first appeared in
-.Nx 3.0 .
-.Sh AUTHOR
+.Nx 6.0 .
+.Sh AUTHORS
The
.Nm
utility was written by
-.An Alistair Crooks ,
+.An Alistair Crooks
.An [email protected] .
