--- find.1.orig 2004-12-02 16:18:22.000000000 +0100 +++ find.1 2004-12-02 16:39:41.000000000 +0100 @@ -3,7 +3,7 @@ find \- search for files in a directory hierarchy .SH SYNOPSIS .B find -[-H] [-L] [-P] [path...] [expression] +[\-H] [\-L] [\-P] [path...] [expression] .SH DESCRIPTION This manual page documents the GNU version of @@ -18,7 +18,7 @@ .B find moves on to the next file name. .PP -The `-H', `-L' and `-P' options control the treatment of symbolic +The `\-H', `\-L' and `\-P' options control the treatment of symbolic links. Command-line arguments following these are taken to be names of files or directories to be examined, up to the first argument that begins with `\-', `(', `)', `,', or `!'. That argument and any @@ -31,7 +31,7 @@ These options control the behaviour of .B find but are specified immediately after the last path name. The two -`real' options `-H', `-L' and `-P' must appear before the first path +`real' options `\-H', `\-L' and `\-P' must appear before the first path name, if at all. .SH OPTIONS .IP \-P @@ -71,7 +71,7 @@ Using \-H causes the \-lname and \-ilname predicates always to return false. .P -If more than one of \-H, \-L and -P are both specified, each overrides +If more than one of \-H, \-L and \-P are both specified, each overrides the others; the last one appearing on the command line takes effect. Since it is the default, the \-P option should be considered to be in effect unless either \-H or \-L is specified. @@ -195,7 +195,7 @@ command line usage, not to any conditions that .B find might encounter when it searches directories. The default behaviour -corresponds to \-warn if standard input is a tty, and to -nowarn +corresponds to \-warn if standard input is a tty, and to \-nowarn otherwise. .IP \-xdev Don't descend directories on other filesystems. @@ -254,7 +254,7 @@ patterns `fo*' and `F??' match the file names `Foo', `FOO', `foo', `fOo', etc. In these patterns, unlike filename expansion by the shell, an initial '.' can be matched by '*'. That is, -.B find -name *bar +.B find \-name *bar will match the file `.foobar'. .IP "\-inum \fIn\fR" @@ -379,7 +379,7 @@ .in +1i find . \-wholename './sr*sc' .br -.in -1i +.in \-1i will print an entry for a directory called './src/misc' (if one exists). To ignore a whole directory tree, use \-prune rather than checking every file in the tree. For example, to skip the @@ -387,9 +387,9 @@ print the names of the other files found, do something like this: .br .in +1i -find . \-wholename './src/emacs' -prune -o -print +find . \-wholename './src/emacs' \-prune \-o \-print .br -.in -1i +.in \-1i .IP "\-xtype \fIc\fR" The same as \-type unless the file is a symbolic link. For symbolic links: if the \-H or \-P option was specified, true if the file is a @@ -415,7 +415,7 @@ Both of these constructions might need to be escaped (with a `\e') or quoted to protect them from expansion by the shell. See the .B EXAMPLES -section for examples of the use of the `-exec' option. +section for examples of the use of the `\-exec' option. The command is executed in the starting directory. .IP "\-exec \fIcommand\fR +" @@ -451,7 +451,7 @@ .IP \-print0 True; print the full file name on the standard output, followed by a -null character (instead of the newline character that `-print' uses). +null character (instead of the newline character that `\-print' uses). This allows file names that contain newlines or other types of white space to be correctly interpreted by programs that process the \fBfind\fR output. This option corresponds to the `\-0' option of @@ -525,7 +525,7 @@ .IP T time, 24-hour (hh:mm:ss) .IP + -Date and time, separated by '+', for example `2004-04-28+22:22:05'. +Date and time, separated by '+', for example `2004\-04\-28+22:22:05'. The time is given in the current timezone (which may be affected by setting the TZ environment variable). This is a GNU extension. .IP X @@ -630,7 +630,7 @@ .IP %U File's numeric user ID. .IP %y -File's type (like in ls -l), U=unknown type (shouldn't happen) +File's type (like in ls \-l), U=unknown type (shouldn't happen) .IP %Y File's type (like %y), plus follow symlinks: L=loop, N=nonexistent .PP @@ -667,7 +667,7 @@ Exit immediately with return value zero. No child proceses will be left running, but no more paths specified on the command line will be processed. For example, -.B find /tmp/foo /tmp/bar -print -quit +.B find /tmp/foo /tmp/bar \-print \-quit will print only .BR /tmp/foo . @@ -742,25 +742,25 @@ .IP "Other predicates" The predicates -`-atime', -`-ctime', -`-depth', -`-group', -`-links', -`-mtime', -`-nogroup', -`-nouser', -`-perm', -`-print', -`-prune', -`-size', -`-user' and -`-xdev', +`\-atime', +`\-ctime', +`\-depth', +`\-group', +`\-links', +`\-mtime', +`\-nogroup', +`\-nouser', +`\-perm', +`\-print', +`\-prune', +`\-size', +`\-user' and +`\-xdev', are all supported. .P The POSIX standard specifies parentheses `(', `)', negation `!' and the -`and' and `or' operators (`-a', `-o'). +`and' and `or' operators (`\-a', `\-o'). .P All other options, predicates, expressions and so forth are extensions beyond the POSIX standard. Many of these extensions are not unique to @@ -779,30 +779,30 @@ other internationalization variables. .IP LC_COLLATE The POSIX standard specifies that this variable affects the pattern -matching to be used for the `-name' option. GNU find uses the +matching to be used for the `\-name' option. GNU find uses the .BR fnmatch (3) library function, and so support for `LC_COLLATE' depends on the system library. .IP POSIX also specifies that the `LC_COLLATE' environment variable affects the interpretation of the user's response to the -query issued by `-ok', but this is not the case for GNU find. +query issued by `\-ok', but this is not the case for GNU find. .IP LC_CTYPE This variable affects the treatment of character classes used with -the `-name' option, if the system's +the `\-name' option, if the system's .BR fnmatch (3) library function supports this. It has no effect on the behaviour -of the `-ok' expression. +of the `\-ok' expression. .IP LC_MESSAGES Determines the locale to be used for internationalised messages. .IP NLSPATH Determines the location of the internationalisation message catalogues. .IP PATH Affects the directores which are searched to find the executables -invoked by `-exec' and `-ok'. +invoked by `\-exec' and `\-ok'. .SH "EXAMPLES" .nf -.B find /tmp -name core -type f -print | xargs /bin/rm -f +.B find /tmp \-name core \-type f \-print | xargs /bin/rm \-f .fi Find files named @@ -812,7 +812,7 @@ and delete them. Note that this will work incorrectly if there are any filenames containing newlines, single or double quotes, or spaces. .P -.B find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f +.B find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f .fi Find files named @@ -824,14 +824,14 @@ are correctly handled. The .B \-name test comes before the -.B -type +.B \-type test in order to avoid having to call .B stat(2) on every file. .P .nf -.B find . -type f -exec file '{}' \e\; +.B find . \-type f \-exec file '{}' \e\; .fi Runs `file' on every file in or below the current directory. Notice @@ -842,8 +842,8 @@ .P .nf -.B find / \( -perm +4000 -fprintf /root/suid.txt '%#m %u %p\en' \) , \e -.B \( -size +100M -fprintf /root/big.txt '%-10s %p\en' \) +.B find / \( \-perm +4000 \-fprintf /root/suid.txt '%#m %u %p\en' \) , \e +.B \( \-size +100M \-fprintf /root/big.txt '%\-10s %p\en' \) .fi Traverse the filesystem just once, listing setuid files and @@ -878,6 +878,6 @@ 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 -.I bug-findutils +.I bug\-findutils mailing list. To join the list, send email to -.IR bug-findutils-request@gnu.org . +.IR bug\-findutils\-request@gnu.org .