mirror of
git://git.sv.gnu.org/findutils.git
synced 2026-01-31 05:38:59 +01:00
find.1: fix and improve some more markups
Mark whitespace in commands as non-breakable in more cases to avoid unwanted hyphenation in the middle of commands. For this to work, some cases need to have some consecutive lines joined into one '.B' or '.BR', the latter may require quoting the first argument within "...". * find/find.1: Do the above. (.IP -path): Improve indentation using '.in +4m', and set filename as italic. (.BR "ls -l"): Escape the minus of the option. (.BR "\-size\ \-1\|048\|576c"): Add space before dot '.', the 2nd arg. (.B \-exec ... \e+): No need to escape '+': remove '\e'. (.B \-execdir ... \e+): Likewise. (POSIXLY_CORRECT): Set the strings '+zzz' and '/zzz' in the -perm description as italic.
This commit is contained in:
97
find/find.1
97
find/find.1
@@ -147,7 +147,8 @@ If
|
||||
is in effect and one of the
|
||||
paths specified on the command line is a symbolic link to a directory,
|
||||
the contents of that directory will be examined (though of course
|
||||
\-maxdepth 0 would prevent this).
|
||||
.B \-maxdepth\ 0
|
||||
would prevent this).
|
||||
.P
|
||||
If more than one of
|
||||
.BR \-H ,
|
||||
@@ -224,8 +225,7 @@ is not doing what you want. The list of debug options should be comma
|
||||
separated. Compatibility of the debug options is not guaranteed
|
||||
between releases of findutils. For a complete list of valid debug
|
||||
options, see the output of
|
||||
.B find \-D
|
||||
.BR help .
|
||||
.BR "find \-D\ help" .
|
||||
Valid debug options include
|
||||
.RS
|
||||
.IP exec
|
||||
@@ -285,8 +285,7 @@ modern versions of Unix, file types are returned by
|
||||
and so these predicates are faster to evaluate than predicates which
|
||||
need to stat the file first.
|
||||
If you use the
|
||||
.B \-fstype
|
||||
.I FOO
|
||||
.B "\-fstype\ \fIFOO\fR"
|
||||
predicate and specify a filesystem type
|
||||
.I FOO
|
||||
which is not known (that is, present in `/etc/mtab') at the time
|
||||
@@ -308,9 +307,9 @@ predicates which are likely to fail are evaluated earlier.
|
||||
The cost-based optimiser has a fixed idea of how likely any given test
|
||||
is to succeed. In some cases the probability takes account of the
|
||||
specific nature of the test (for example,
|
||||
.B \-type f
|
||||
.B \-type\ f
|
||||
is assumed to be more likely to succeed than
|
||||
.BR "\-type c" ).
|
||||
.BR "\-type\ c" ).
|
||||
The cost-based optimiser is currently being evaluated.
|
||||
If it does not actually improve the performance of
|
||||
.BR find ,
|
||||
@@ -458,8 +457,7 @@ and
|
||||
.B \-iregex
|
||||
tests which occur later on the command line. To see which regular
|
||||
expression types are known, use
|
||||
.B \-regextype
|
||||
.BR help .
|
||||
.BR "\-regextype\ help" .
|
||||
The Texinfo documentation (see
|
||||
.B SEE
|
||||
.BR ALSO )
|
||||
@@ -647,8 +645,7 @@ File was last accessed less than, more than or exactly
|
||||
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
|
||||
.BR +1 ,
|
||||
.BR "\-atime\ +1" ,
|
||||
a file has to have been accessed at least
|
||||
.I two
|
||||
days ago.
|
||||
@@ -873,13 +870,14 @@ File name matches shell pattern
|
||||
.IR pattern .
|
||||
The metacharacters do not treat `/' or `.\&' specially;
|
||||
so, for example,
|
||||
.br
|
||||
.in +1i
|
||||
.in +4m
|
||||
.nf
|
||||
find . \-path \(dq./sr*sc\(dq
|
||||
.br
|
||||
.in -1i
|
||||
will print an entry for a directory called `./src/misc' (if one
|
||||
exists). To ignore a whole directory tree, use
|
||||
.fi
|
||||
.in
|
||||
will print an entry for a directory called
|
||||
.I ./src/misc
|
||||
(if one exists). To ignore a whole directory tree, use
|
||||
.B \-prune
|
||||
rather than
|
||||
checking every file in the tree.
|
||||
@@ -889,10 +887,11 @@ would only make sense to use an absolute path name here if the
|
||||
relevant start point is also an absolute path. This means that this
|
||||
command will never match anything:
|
||||
.br
|
||||
.in +1i
|
||||
.in +4m
|
||||
.nf
|
||||
find bar \-path /foo/bar/myfile \-print
|
||||
.br
|
||||
.in -1i
|
||||
.fi
|
||||
.in
|
||||
Find compares the
|
||||
.B \-path
|
||||
argument with the concatenation of a directory name and the base name
|
||||
@@ -937,8 +936,7 @@ section for some illustrative examples. If no permission bits in
|
||||
.I mode
|
||||
are set, this test matches any file (the idea here is to be consistent
|
||||
with the behaviour of
|
||||
.B \-perm
|
||||
.BR \-000 ).
|
||||
.BR "\-perm\ \-000" ).
|
||||
|
||||
.IP "\-perm +\fImode\fR"
|
||||
This is no longer supported (and has been deprecated since 2005). Use
|
||||
@@ -1000,7 +998,7 @@ for gibibytes (GiB, units of 1024 * 1024 * 1024 = 1\|073\|741\|824 bytes)
|
||||
The size is simply the st_size member of the struct stat populated by
|
||||
the lstat (or stat) system call, rounded up as shown above.
|
||||
In other words, it's consistent with the result you get for
|
||||
.BR "ls -l" .
|
||||
.BR "ls\ \-l" .
|
||||
Bear in
|
||||
mind that the `%k' and `%b' format specifiers of
|
||||
.B \-printf
|
||||
@@ -1013,9 +1011,9 @@ 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
|
||||
.B \-size \-1M
|
||||
.B \-size\ \-1M
|
||||
is not equivalent to
|
||||
.BR "\-size \-1\|048\|576c".
|
||||
.BR "\-size\ \-1\|048\|576c" .
|
||||
The former only matches empty files, the latter matches files from 0 to
|
||||
1,048,575 bytes.
|
||||
.IP \-true
|
||||
@@ -1659,14 +1657,15 @@ you cannot usefully use
|
||||
and
|
||||
.B \-delete
|
||||
together.
|
||||
For example, to skip the
|
||||
directory `src/emacs' and all files and directories under it, and
|
||||
print the names of the other files found, do something like this:
|
||||
.br
|
||||
.in +1i
|
||||
For example, to skip the directory
|
||||
.I src/emacs
|
||||
and all files and directories under it, and print the names of the other files
|
||||
found, do something like this:
|
||||
.in +4m
|
||||
.nf
|
||||
find . \-path ./src/emacs \-prune \-o \-print
|
||||
.br
|
||||
.in -1i
|
||||
.fi
|
||||
.in
|
||||
|
||||
|
||||
.IP "\-quit"
|
||||
@@ -1681,27 +1680,27 @@ simply makes
|
||||
.B find
|
||||
stop immediately. No child processes will be left
|
||||
running. Any command lines which have been built by
|
||||
.B \-exec ... \e+
|
||||
.B \-exec\ ...\ +
|
||||
or
|
||||
.B \-execdir ... \e+
|
||||
.B \-execdir\ ...\ +
|
||||
are invoked before the program is
|
||||
exited. After
|
||||
.B \-quit
|
||||
is executed, no more files specified on the command line will be
|
||||
processed. For example,
|
||||
.RB ` find
|
||||
.B /tmp/foo /tmp/bar -print
|
||||
.BR -quit `
|
||||
will print only `/tmp/foo`. One common use of
|
||||
.RB ` "find\ \fI/tmp/foo\fP\ \fI/tmp/bar\fP\ \-print\ \-quit" `
|
||||
will print only `/tmp/foo`.
|
||||
.br
|
||||
One common use of
|
||||
.B \-quit
|
||||
is to stop searching the file system once we have
|
||||
found what we want. For example, if we want to find just a single
|
||||
file we can do this:
|
||||
.br
|
||||
.in +1i
|
||||
.in +4m
|
||||
.nf
|
||||
find / -name needle -print -quit
|
||||
.br
|
||||
.in -1i
|
||||
.fi
|
||||
.in
|
||||
|
||||
.SS OPERATORS
|
||||
Listed in order of decreasing precedence:
|
||||
@@ -2052,13 +2051,11 @@ all messages printed on stderr are diagnostics and must result in a
|
||||
non-zero exit status.
|
||||
.IP
|
||||
When POSIXLY_CORRECT is not set,
|
||||
.B \-perm
|
||||
+zzz
|
||||
.B "\-perm \fI+zzz\fR"
|
||||
is treated just like
|
||||
.B \-perm
|
||||
/zzz
|
||||
.B "\-perm \fI/zzz\fR"
|
||||
if
|
||||
+zzz is not a valid symbolic mode. When POSIXLY_CORRECT is set, such
|
||||
\fI+zzz\fR is not a valid symbolic mode. When POSIXLY_CORRECT is set, such
|
||||
constructs are treated as an error.
|
||||
.IP
|
||||
When POSIXLY_CORRECT is set, the response to the prompt made by the
|
||||
@@ -2341,9 +2338,9 @@ When some error occurs,
|
||||
may stop immediately, without completing all the actions specified.
|
||||
For example, some starting points may not have been examined or some
|
||||
pending program invocations for
|
||||
.B \-exec \&...\& {} +
|
||||
.B \-exec\ \&...\&\ {}\ +
|
||||
or
|
||||
.B \-execdir \&...\& {} +
|
||||
.B "\-execdir\ \&...\&\ {}\ +
|
||||
may not have been performed.
|
||||
.
|
||||
.SH "HISTORY"
|
||||
@@ -2352,7 +2349,7 @@ example) used in filename patterns will match a leading `.', because
|
||||
IEEE POSIX interpretation 126 requires this.
|
||||
.P
|
||||
As of findutils-4.3.3,
|
||||
.B \-perm /000
|
||||
.B \-perm\ /000
|
||||
now matches all files instead of none.
|
||||
.P
|
||||
Nanosecond-resolution
|
||||
|
||||
Reference in New Issue
Block a user