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 <a...@netbsd.org> .\" 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 a...@netbsd.org .