diff options
| author | Bjarni Ingi Gislason <bjarniig@rhi.hi.is> | 2018-03-12 22:33:56 +0100 |
|---|---|---|
| committer | Bernhard Voelker <mail@bernhard-voelker.de> | 2018-03-13 21:52:06 +0100 |
| commit | a0fada430a89e89861825c57bc5116529de68485 (patch) | |
| tree | 97f828b16238a399a1650ac7e4237972a9f60e3d | |
| parent | 040f20b91e47c2b29b2696110ce263d0f53c1e99 (diff) | |
| download | findutils-a0fada430a.tar.gz | |
doc: fix various syntax issues in find.1
Changes:
- Avoid warning "(macro BR): only 1 argument, but more are expected".
- Change misused SI (metric) numeric prefixes to the binary ones, like
a bare "1K blocks" to "1 KB blocks".
- Protect a full stop (.) with "\&", if it has a blank (white-space)
in front of or (ignoring transparent characters to the full stop) after
it, and it does not mean an end of a sentence.
- Change the name of a macro for two fonts (e.g., BR and IR) to one
letter, if there is only one argument.
- Use a macro to change to the italic font, instead of \fI [1], if
possible.
- Remove space in the first column, if not intented.
- Move a full stop (period) and a comma outside of a quoted text, if
it is at the end of the quote and does not end a quoted sentence.
- Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front
of a name for an option.
- Split lines longer than 80 characters into two or more lines.
- Separate the sentences and subordinate clauses; each begins on a new
line. Or: Adjust space between sentences (two spaces).
- Fix the spelling of "kibi", "mebi", and "gibi".
* find/find.1: Do the above.
Patch contributed via https://sv.gnu.org/patch/?9585
Copyright-paperwork-exempt: Yes
| -rw-r--r-- | find/find.1 | 327 |
1 files changed, 200 insertions, 127 deletions
diff --git a/find/find.1 b/find/find.1 index e376ab6..0437cd8 100644 --- a/find/find.1 +++ b/find/find.1 @@ -1,9 +1,10 @@ +'\" t .TH FIND 1 \" -*- nroff -*- .SH NAME find \- search for files in a directory hierarchy .SH SYNOPSIS .B find -[\-H] [\-L] [\-P] [\-D debugopts] [\-Olevel] [starting-point...] [expression] +[\-H] [\-L] [\-P] [\-D debugopts] [\-Olevel] [starting-point...\&] [expression] .SH DESCRIPTION This manual page documents the GNU version of @@ -14,10 +15,11 @@ searches the directory tree rooted at each given starting-point by evaluating the given expression from left to right, according to the rules of precedence (see section OPERATORS), until the outcome is known (the left hand side is false for \fIand\fR operations, true for -\fIor\fR), at which point +.IR or ), +at which point .B find moves on to the next file name. If no starting-point is specified, -`.' is assumed. +`.\&' is assumed. .PP If you are using .B find @@ -25,7 +27,8 @@ in an environment where security is important (for example if you are using it to search directories that are writable by other users), you should read the `Security Considerations' chapter of the findutils documentation, which is called \fBFinding Files\fP and comes with -findutils. That document also includes a lot more detail +findutils. +That document also includes a lot more detail and discussion than this manual page, so you may find it a more useful source of information. .SH OPTIONS @@ -119,13 +122,16 @@ Do not follow symbolic links, except while processing the command line arguments. When .B find examines or prints information about files, the information used -shall be taken from the properties of the symbolic link itself. The -only exception to this behaviour is when a file specified on the -command line is a symbolic link, and the link can be resolved. For -that situation, the information used is taken from whatever the link -points to (that is, the link is followed). The information about the -link itself is used as a fallback if the file pointed to by the -symbolic link cannot be examined. If +shall be taken from the properties of the symbolic link itself. +The only exception to this behaviour is when a file specified on the +command line is a symbolic link, +and the link can be resolved. +For that situation, the information used is taken from whatever the +link points to +(that is, the link is followed). +The information about the link itself is used as a fallback if the +file pointed to by the symbolic link cannot be examined. +If .B \-H is in effect and one of the paths specified on the command line is a symbolic link to a directory, @@ -235,7 +241,8 @@ program tries to minimise such calls. Show the expression tree in its original and optimised form. .RE .IP \-Olevel -Enables query optimisation. The +Enables query optimisation. +The .B find program reorders tests to speed up execution while preserving the overall effect; that is, predicates with side effects are not @@ -290,8 +297,8 @@ specific nature of the test (for example, .B \-type f is assumed to be more likely to succeed than .BR "\-type c" ). -The cost-based optimiser is currently being evaluated. If it does -not actually improve the performance of +The cost-based optimiser is currently being evaluated. +If it does not actually improve the performance of .BR find , it will be removed again. Conversely, optimisations that prove to be reliable, robust and effective may be enabled at lower optimisation @@ -420,7 +427,7 @@ and .B \-iregex tests which occur later on the command line. To see which regular expression types are known, use -.B -regextype +.B \-regextype .BR help . The Texinfo documentation (see .B SEE @@ -442,15 +449,17 @@ produced, the exit status of .B find is not affected. If the POSIXLY_CORRECT environment variable is set, and -.B \-warn is also used, it is not specified which, if any, warnings will be active. +.B \-warn +is also used, it is not specified which, if any, +warnings will be active. .SS GLOBAL OPTIONS Global options always return true. Global options take effect even for tests which occur earlier on the command line. To prevent confusion, global options should specified on the command-line after the list of start points, just before the -first test, positional option or action. If you specify a global -option in some other place, +first test, positional option or action. +If you specify a global option in some other place, .B find will issue a warning message explaining that this can be confusing. @@ -460,7 +469,8 @@ not the same kind of option as for example. .IP \-d -A synonym for \-depth, for compatibility with FreeBSD, NetBSD, MacOS X and OpenBSD. +A synonym for \-depth, for compatibility with FreeBSD, NetBSD, \ +MacOS X and OpenBSD. .IP \-depth Process each directory's contents before the directory itself. The @@ -476,18 +486,20 @@ and exit. Normally, \fBfind\fR will emit an error message when it fails to stat a file. If you give this option and a file is deleted between the time \fBfind\fR reads the name of the file from the directory and the time it tries to stat -the file, no error message will be issued. This also applies to files -or directories whose names are given on the command line. This option takes -effect at the time the command line is read, which means that you cannot search -one part of the filesystem with this option on and part of it with this option -off (if you need to do that, you will need to issue two \fBfind\fR commands +the file, no error message will be issued. +This also applies to files or directories whose names are given on the +command line. +This option takes effect at the time the command line is read, +which means that you cannot search one part of the filesystem with +this option on and part of it with this option off +(if you need to do that, you will need to issue two \fBfind\fR commands instead, one with the option and one without it). .IP "\-maxdepth \fIlevels\fR" Descend at most \fIlevels\fR (a non-negative integer) levels of directories below the starting-points. .B \-maxdepth 0 - means only apply the tests and actions to the starting-points themselves. +means only apply the tests and actions to the starting-points themselves. .IP "\-mindepth \fIlevels\fR" Do not apply any tests or actions at levels less than \fIlevels\fR (a @@ -511,7 +523,7 @@ subdirectories than their hard link count. This option is needed when searching filesystems that do not follow the Unix directory-link convention, such as CD-ROM or MS-DOS filesystems or AFS volume mount points. Each directory on a normal Unix filesystem has at least 2 -hard links: its name and its `.' entry. Additionally, its +hard links: its name and its `.\&' entry. Additionally, its subdirectories (if any) each have a `..\&' entry linked to that directory. When .B find @@ -531,7 +543,7 @@ Don't descend directories on other filesystems. Some tests, for example .B \-newerXY and -.BR -samefile , +.BR \-samefile , allow comparison between the file currently being examined and some reference file specified on the command line. When these tests are used, the interpretation of the reference file is determined by the @@ -575,7 +587,9 @@ option is in effect, the access time of the file it points to is always used. .IP "\-atime \fIn\fR" -File was last accessed \fIn\fR*24 hours ago. +File was last accessed +.IR n *24 +hours ago. When find figures out how many 24-hour periods ago the file was last accessed, any fractional part is ignored, so to match .B \-atime @@ -597,7 +611,9 @@ option is in effect, the status-change time of the file it points to is always used. .IP "\-ctime \fIn\fR" -File's status was last changed \fIn\fR*24 hours ago. +File's status was last changed +.IR n *24 +hours ago. See the comments for .B \-atime to understand how rounding affects the interpretation of file status @@ -628,15 +644,18 @@ succeeds can actually be executed. Always false. .IP "\-fstype \fItype\fR" -File is on a filesystem of type \fItype\fR. The valid filesystem -types vary among different versions of Unix; an incomplete list of +File is on a filesystem of type +.IR type . +The valid filesystem types vary among different versions of Unix; +an incomplete list of filesystem types that are accepted on some version of Unix or another is: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. You can use .B \-printf with the %F directive to see the types of your filesystems. .IP "\-gid \fIn\fR" -File's numeric group ID is \fIn\fR. +File's numeric group ID is +.IR n . .IP "\-group \fIgname\fR" File belongs to group \fIgname\fR (numeric group ID allowed). @@ -658,11 +677,13 @@ Like .BR \-name , but the match is case insensitive. For example, the patterns `fo*' and `F??' match the file names `Foo', `FOO', `foo', -`fOo', etc. The pattern `*foo*` will also match a file -called '.foobar'. +`fOo', etc. +The pattern `*foo*` will also match a file called '.foobar'. .IP "\-inum \fIn\fR" -File has inode number \fIn\fR. It is normally easier to use the +File has inode number +.IR n . +It is normally easier to use the .B \-samefile test instead. @@ -685,7 +706,8 @@ File has \fIn\fR hard links. .IP "\-lname \fIpattern\fR" File is a symbolic link whose contents match shell pattern -\fIpattern\fR. The metacharacters do not treat `/' or `.' specially. +.IR pattern . +The metacharacters do not treat `/' or `.\&' specially. If the .B \-L option or the @@ -697,7 +719,9 @@ is broken. File's data was last modified \fIn\fR minutes ago. .IP "\-mtime \fIn\fR" -File's data was last modified \fIn\fR*24 hours ago. +File's data was last modified +.IR n *24 +hours ago. See the comments for .B \-atime to understand how rounding affects the interpretation of file @@ -705,16 +729,19 @@ modification times. .IP "\-name \fIpattern\fR" Base of file name (the path with the leading directories removed) -matches shell pattern \fIpattern\fR. Because the leading directories -are removed, the file names considered for a match with +matches shell pattern +.IR pattern . +Because the leading directories are removed, +the file names considered for a match with .B \-name will never include a slash, so `\-name a/b' will never match anything (you probably need to use .B \-path -instead). A warning is issued if you try to do this, unless the environment variable -POSIXLY_CORRECT is set. +instead). +A warning is issued if you try to do this, +unless the environment variable POSIXLY_CORRECT is set. The metacharacters (`*', `?', -and `[]') match a `.' at the start of the base name (this is a change +and `[]') match a `.\&' at the start of the base name (this is a change in findutils-4.2.2; see section STANDARDS CONFORMANCE below). To ignore a directory and the files under it, use .BR \-prune ; @@ -726,12 +753,14 @@ special, despite the fact that some shells including Bash imbue braces with a special meaning in shell patterns. The filename matching is performed with the use of the .BR fnmatch (3) -library function. Don't forget to enclose the pattern in quotes -in order to protect it from expansion by the shell. +library function. +Don't forget to enclose the pattern in quotes in order to protect it +from expansion by the shell. .IP "\-newer \fIfile\fR" -File was modified more recently than \fIfile\fR. If \fIfile\fR is a -symbolic link and the +File was modified more recently than +.IR file . +If \fIfile\fR is a symbolic link and the .B \-H option or the .B \-L @@ -740,8 +769,9 @@ modification time of the file it points to is always used. .IP "\-newerXY \fIreference\fR" Succeeds if timestamp \fIX\fR of the file being considered is newer -than timestamp \fIY\fR of the file \fIreference\fR. The letters -\fIX\fR and \fIY\fR can be any of the following letters: +than timestamp \fIY\fR of the file +.IR reference . +The letters \fIX\fR and \fIY\fR can be any of the following letters: .TS ll @@ -782,8 +812,10 @@ No group corresponds to file's numeric group ID. No user corresponds to file's numeric user ID. .IP "\-path \fIpattern\fR" -File name matches shell pattern \fIpattern\fR. The metacharacters do -not treat `/' or `.' specially; so, for example, +File name matches shell pattern +.IR pattern . +The metacharacters do not treat `/' or `.\&' specially; +so, for example, .br .in +1i find . \-path \(dq./sr*sc\(dq @@ -831,7 +863,7 @@ Since an exact match is required, if you want to use this form for symbolic modes, you may have to specify a rather complex mode string. For example `\-perm g=w' will only match files which have mode 0020 (that is, ones for which group write permission is the only permission -set). It is more likely that you will want to use the `/' or `-' +set). It is more likely that you will want to use the `/' or `\-' forms, for example `\-perm \-g=w', which matches any file with group write permission. See the .B EXAMPLES @@ -841,7 +873,8 @@ section for some illustrative examples. All of the permission bits \fImode\fR are set for the file. Symbolic modes are accepted in this form, and this is usually the way in which you would want to use them. You must specify `u', `g' or `o' if -you use a symbolic mode. See the +you use a symbolic mode. +See the .B EXAMPLES section for some illustrative examples. @@ -875,10 +908,13 @@ in the client's kernel and so cannot make use of the UID mapping information held on the server. .IP "\-regex \fIpattern\fR" -File name matches regular expression \fIpattern\fR. This is a match -on the whole path, not a search. For example, to match a file named -`./fubar3', you can use the regular expression `.*bar.' or `.*b.*3', -but not `f.*r3'. The regular expressions understood by +File name matches regular expression +.IR pattern . +This is a match on the whole path, not a search. +For example, to match a file named `./fubar3', +you can use the regular expression `.*bar.\&' or `.*b.*3', +but not `f.*r3'. +The regular expressions understood by .B find are by default Emacs Regular Expressions (except that `.' matches newline), but this can be changed with the @@ -886,7 +922,9 @@ newline), but this can be changed with the option. .IP "\-samefile \fIname\fR" -File refers to the same inode as \fIname\fR. When +File refers to the same inode as +.IR name . +When .B \-L is in effect, this can include symbolic links. @@ -901,11 +939,11 @@ for bytes .IP `w' for two-byte words .IP `k' -for Kibibytes (KiB, units of 1024 bytes) +for kibibytes (KiB, units of 1024 bytes) .IP `M' -for Mebibytes (MiB, units of 1024 * 1024 = 1048576 bytes) +for mebibytes (MiB, units of 1024 * 1024 = 1\|048\|576 bytes) .IP `G' -for Gibibytes (GiB, units of 1024 * 1024 * 1024 = 1073741824 bytes) +for gibibytes (GiB, units of 1024 * 1024 * 1024 = 1\|073\|741\|824 bytes) .RE .IP The size does not count indirect blocks, but it does count blocks in @@ -919,17 +957,19 @@ differently. The `b' suffix always denotes 512-byte blocks and never .IP The + and - prefixes signify greater than and less than, as usual; i.e., an exact size of \fIn\fR units does not match. -Bear in mind that the size is rounded up to the next unit. Therefore -.BR "\-size \-1M" +Bear in mind that the size is rounded up to the next unit. +Therefore +.B \-size \-1M is not equivalent to -.BR "\-size \-1048576c". +.BR "\-size \-1\|048\|576c". The former only matches empty files, the latter matches files from 0 to 1,048,575 bytes. .IP \-true Always true. .IP "\-type \fIc\fR" -File is of type \fIc\fR: +File is of type +.IR c : .RS .IP b block (buffered) special @@ -960,7 +1000,8 @@ door (Solaris) To search for more than one type at once, you can supply the combined list of type letters separated by a comma `,' (GNU extension). .IP "\-uid \fIn\fR" -File's numeric user ID is \fIn\fR. +File's numeric user ID is +.IR n . .IP "\-used \fIn\fR" File was last accessed \fIn\fR days after its status was last changed. @@ -993,7 +1034,9 @@ links: if the or .B \-P option was specified, true if the file is a -link to a file of type \fIc\fR; if the +link to a file of type +.IR c ; +if the .B \-L option has been given, true if \fIc\fR is `l'. In other words, for symbolic links, @@ -1002,7 +1045,8 @@ checks the type of the file that .B \-type does not check. .IP "\-context \fIpattern\fR" -(SELinux only) Security context of the file matches glob \fIpattern\fR. +(SELinux only) Security context of the file matches glob +.IR pattern . .SS ACTIONS .IP "\-delete\fR" @@ -1044,7 +1088,9 @@ and together. .IP "\-exec \fIcommand\fR ;" -Execute \fIcommand\fR; true if 0 status is returned. All following +Execute +.IR command ; +true if 0 status is returned. All following arguments to .B find are taken to be arguments to the command until an argument consisting @@ -1060,8 +1106,8 @@ section for examples of the use of the .B \-exec option. The specified command is run once for each matched file. -The command is executed in the starting directory. There are -unavoidable security problems surrounding use of the +The command is executed in the starting directory. +There are unavoidable security problems surrounding use of the .B \-exec action; you should use the @@ -1129,7 +1175,8 @@ returns a non-zero exit status. If .B find encounters an error, this can sometimes cause an immediate exit, so some pending commands may not be run -at all. The result of the action depends on whether the +at all. +The result of the action depends on whether the .B + or the .B ; @@ -1158,7 +1205,9 @@ See the section for information about how unusual characters in filenames are handled. .IP "\-fprint \fIfile\fR" -True; print the full file name into file \fIfile\fR. If \fIfile\fR +True; print the full file name into file +.IR file . +If \fIfile\fR does not exist when \fBfind\fR is run, it is created; if it does exist, it is truncated. The file names `/dev/stdout' and `/dev/stderr' are handled specially; they refer to the standard @@ -1192,7 +1241,7 @@ section for information about how unusual characters in filenames are handled. True; list current file in .B ls \-dils format on standard output. -The block counts are of 1K blocks, unless the environment variable +The block counts are of 1\ KB blocks, unless the environment variable POSIXLY_CORRECT is set, in which case 512-byte blocks are used. See the .B UNUSUAL FILENAMES @@ -1215,10 +1264,11 @@ response. This regular expression is obtained from the system if the message translations. If the system has no suitable definition, .BR find 's -own definition will be used. In either case, the interpretation of -the regular expression itself will be affected by the environment -variables 'LC_CTYPE' (character classes) and 'LC_COLLATE' (character -ranges and equivalence classes). +own definition will be used. +In either case, the interpretation of the regular expression itself +will be affected by the environment variables 'LC_CTYPE' +(character classes) and 'LC_COLLATE' (character ranges and equivalence +classes). @@ -1233,7 +1283,8 @@ If the command is run, its standard input is redirected from .IP \-print True; print the full file name on the standard output, followed by a -newline. If you are piping the output of +newline. +If you are piping the output of .B find into another program and there is the faintest possibility that the files which you are searching for might contain a newline, then you should @@ -1299,11 +1350,12 @@ A literal percent sign. .IP %a File's last access time in the format returned by the C `ctime' function. .IP %A\fIk\fP -File's last access time in the format specified by \fIk\fR, which is -either `@' or a directive for the C `strftime' function. The possible -values for \fIk\fR are listed below; some of them might not be -available on all systems, due to differences in `strftime' between -systems. +File's last access time in the format specified by +.IR k , +which is either `@' or a directive for the C `strftime' function. +The possible values for \fIk\fR are listed below; +some of them might not be available on all systems, +due to differences in `strftime' between systems. .RS .IP @ seconds since Jan.\& 1, 1970, 00:00 GMT, with fractional part. @@ -1324,7 +1376,7 @@ locale's AM or PM .IP r time, 12-hour (hh:mm:ss [AP]M) .IP S -Second (00.00 .. 61.00). There is a fractional part. +Second (00.00 \&..\& 61.00). There is a fractional part. .IP T time, 24-hour (hh:mm:ss.xxxxxxxxxx) .IP + @@ -1374,7 +1426,7 @@ locale's date representation (mm/dd/yy) .IP y last two digits of year (00..99) .IP Y -year (1970...) +year (1970...\&) .RE .IP %b The amount of disk space used for this file in 512-byte blocks. Since disk @@ -1384,7 +1436,8 @@ greater than %s/512, but it can also be smaller if the file is a sparse file. File's last status change time in the format returned by the C `ctime' function. .IP %C\fIk\fP -File's last status change time in the format specified by \fIk\fR, +File's last status change time in the format specified by +.IR k , which is the same as for %A. .IP %d File's depth in the directory tree; 0 means the file is a starting-point. @@ -1409,9 +1462,10 @@ Starting-point under which file was found. .IP %i File's inode number (in decimal). .IP %k -The amount of disk space used for this file in 1K blocks. Since disk space is -allocated in multiples of the filesystem block size this is usually greater -than %s/1024, but it can also be smaller if the file is a sparse file. +The amount of disk space used for this file in 1\ KB blocks. +Since disk space is allocated in multiples of the filesystem block +size this is usually greater than %s/1024, +but it can also be smaller if the file is a sparse file. .IP %l Object of symbolic link (empty string if file is not a symbolic link). .IP %m @@ -1419,8 +1473,9 @@ File's permission bits (in octal). This option uses the `traditional' numbers which most Unix implementations use, but if your particular implementation uses an unusual ordering of octal permissions bits, you will see a difference between the actual value of the file's mode and -the output of %m. Normally you will want to have a leading -zero on this number, and to do this, you should use the +the output of %m. +Normally you will want to have a leading zero on this number, +and to do this, you should use the .B # flag (as in, for example, `%#m'). .IP %M @@ -1441,15 +1496,18 @@ File's sparseness. This is calculated as (BLOCKSIZE*st_blocks / st_size). The exact value you will get for an ordinary file of a certain length is system-dependent. However, normally sparse files will have values less than 1.0, and files which use indirect blocks -may have a value which is greater than 1.0. The value used for -BLOCKSIZE is system-dependent, but is usually 512 bytes. If the file -size is zero, the value printed is undefined. On systems which lack -support for st_blocks, a file's sparseness is assumed to be 1.0. +may have a value which is greater than 1.0. +The value used for BLOCKSIZE is system-dependent, but is usually 512 +bytes. +If the file size is zero, the value printed is undefined. +On systems which lack support for st_blocks, +a file's sparseness is assumed to be 1.0. .IP %t File's last modification time in the format returned by the C `ctime' function. .IP %T\fIk\fP -File's last modification time in the format specified by \fIk\fR, +File's last modification time in the format specified by +.IR k , which is the same as for %A. .IP %u File's user name, or numeric user ID if the user has no name. @@ -1521,8 +1579,9 @@ Any command lines which have been built up with .B \-execdir \&...\& {} + will be invoked before .B find -exits. The exit status may or may not be zero, depending on whether -an error has already occurred. +exits. +The exit status may or may not be zero, +depending on whether an error has already occurred. .SS OPERATORS .P @@ -1538,7 +1597,9 @@ True if \fIexpr\fR is false. This character will also usually need protection from interpretation by the shell. .IP "\-not \fIexpr\fR" -Same as ! \fIexpr\fR, but not POSIX compliant. +Same as !\& +.IR expr , +but not POSIX compliant. .IP "\fIexpr1 expr2\fR" Two expressions in a row are taken to be joined with an @@ -1547,10 +1608,13 @@ implied \fIexpr2\fR is not evaluated if \fIexpr1\fR is false. .IP "\fIexpr1\fR \-a \fIexpr2\fR" -Same as \fIexpr1 expr2\fR. +Same as +.IR "expr1 expr2" . .IP "\fIexpr1\fR \-and \fIexpr2\fR" -Same as \fIexpr1 expr2\fR, but not POSIX compliant. +Same as +.IR "expr1 expr2" , +but not POSIX compliant. .IP "\fIexpr1\fR \-o \fIexpr2\fR" Or; \fIexpr2\fR is not evaluated if \fIexpr1\fR is true. @@ -1558,12 +1622,15 @@ Or; \fIexpr2\fR is not evaluated if \fIexpr1\fR is true. .IP "\fIexpr1\fR \-or \fIexpr2\fR" Same as \fIexpr1\fR .B \-o -\fIexpr2\fR, but not POSIX compliant. +.IR expr2 , +but not POSIX compliant. .IP "\fIexpr1\fR , \fIexpr2\fR" List; both \fIexpr1\fR and \fIexpr2\fR are always evaluated. The value of \fIexpr1\fR is discarded; the value of the list is the value -of \fIexpr2\fR. The comma operator can be useful for searching for +of +.IR expr2 . +The comma operator can be useful for searching for several different types of thing, but traversing the filesystem hierarchy only once. The .B \-fprintf @@ -1666,11 +1733,12 @@ POSIX conformance of the system's .BR fnmatch (3) library function. As of findutils-4.2.2, shell metacharacters (`*', `?' or `[]' for example) will match a leading `.', because -IEEE PASC interpretation 126 requires this. This is a change from -previous versions of findutils. +IEEE PASC interpretation 126 requires this. +This is a change from previous versions of findutils. .IP \fB\-type\fR -Supported. POSIX specifies `b', `c', `d', `l', `p', `f' and `s'. +Supported. +POSIX specifies `b', `c', `d', `l', `p', `f' and `s'. GNU find also supports `D', representing a Door, where the OS provides these. Furthermore, GNU find allows multiple types to be specified at once in a comma-separated list. @@ -1683,8 +1751,8 @@ When the `POSIXLY_CORRECT' environment variable is set, these patterns are taken system's definition of a positive (yes) or negative (no) response. See the system's documentation for \fBnl_langinfo\fP(3), in particular YESEXPR and -NOEXPR. When `POSIXLY_CORRECT' is not set, the patterns are instead -taken from +NOEXPR. +When `POSIXLY_CORRECT' is not set, the patterns are instead taken from .BR find 's own message catalogue. @@ -1715,7 +1783,7 @@ The primaries .BR \-print , .BR \-prune , .BR \-size , -.BR \-user +.B \-user and .B \-xdev are all supported. @@ -1799,12 +1867,13 @@ other internationalization variables. The POSIX standard specifies that this variable affects the pattern matching to be used for the .B \-name -option. GNU find uses the +option. +GNU find uses the .BR fnmatch (3) library function, and so support for `LC_COLLATE' depends on the -system library. This variable also affects the interpretation of -the response to -.BR \-ok; +system library. +This variable also affects the interpretation of the response to +.BR \-ok ; while the `LC_MESSAGES' variable selects the actual pattern used to interpret the response to .BR \-ok , @@ -1830,7 +1899,7 @@ filenames are printed; see the section UNUSUAL FILENAMES. Determines the locale to be used for internationalised messages. If the `POSIXLY_CORRECT' environment variable is set, this also determines the interpretation of the response to the prompt made by the -.BR \-ok +.B \-ok action. .IP NLSPATH @@ -1928,7 +1997,8 @@ could have been used in that case also. .P .nf -.B find / \e( \-perm \-4000 \-fprintf /root/suid.txt \(aq%#m %u %p\en\(aq \e) , \e +.B find / \e( \-perm \-4000 \-fprintf /root/suid.txt \ +\(aq%#m %u %p\en\(aq \e) , \e .B \e( \-size +100M \-fprintf /root/big.txt \(aq%\-10s %p\en\(aq \e) .fi @@ -1954,7 +2024,7 @@ a file will have to have a modification in the past which is less than .P .nf -.B find /sbin /usr/sbin -executable \e! -readable \-print +.B find /sbin /usr/sbin \-executable \e! \-readable \-print .fi Search for files which are executable but not readable. @@ -2073,9 +2143,9 @@ what is going on. .P .nf -.B find repo/ \e( -exec test -d \(aq{}\(aq/.svn \e; -or \e -.B -exec test -d {}/.git \e; -or -exec test -d {}/CVS \e; \e) \e -.B -print -prune +.B find repo/ \e( \-exec test \-d \(aq{}\(aq/.svn \e; \-or \e +.B \-exec test \-d {}/.git \e; \-or \-exec test \-d {}/CVS \e; \e) \e +.B \-print \-prune .fi Given the following directory of projects and their associated SCM @@ -2099,7 +2169,7 @@ already found project3/.svn), but ensures sibling directories .P .nf -.B find /tmp -type f,d,l +.B find /tmp \-type f,d,l .fi Search for files, directories, and symbolic links in the directory @@ -2108,16 +2178,17 @@ passing these types as a comma-separated list (GNU extension), which is otherwise equivalent to the longer, yet more portable: .nf -.B find /tmp \e( -type f -o -type d -o -type l \e) +.B find /tmp \e( \-type f \-o \-type d \-o \-type l \e) .fi .SH EXIT STATUS .PP .B find exits with status 0 if all files are processed successfully, greater -than 0 if errors occur. This is deliberately a very broad -description, but if the return value is non-zero, you should not rely -on the correctness of the results of +than 0 if errors occur. +This is deliberately a very broad description, +but if the return value is non-zero, +you should not rely on the correctness of the results of .BR find . When some error occurs, @@ -2285,8 +2356,10 @@ action. The best way to report a bug is to use the form at https://savannah.gnu.org/bugs/?group=findutils. The reason for this is that you will then be able to track progress in -fixing the problem. Other comments about \fBfind\fP(1) and about -the findutils package in general can be sent to the +fixing the problem. +Other comments about \fBfind\fP(1) and about the findutils package in +general can be sent to the .I bug\-findutils -mailing list. To join the list, send email to +mailing list. +To join the list, send email to .IR bug\-findutils\-request@gnu.org . |
