From bebfdb960ecbd9fa49f6b2a457189744c8f2c134 Mon Sep 17 00:00:00 2001
From: jay <jay>
Date: Sun, 8 Aug 2004 12:24:01 +0000
Subject: [PATCH] Deprecate -path and -ipath in favour of -wholename and
 -iwholename

---
 doc/find.texi | 17 ++++++++++++-----
 find/find.1   | 44 +++++++++++++++++++++++++-------------------
 2 files changed, 37 insertions(+), 24 deletions(-)

diff --git a/doc/find.texi b/doc/find.texi
index 6475b0c..285087e 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -355,15 +355,22 @@ find /usr/local/doc -name '*.texi'
 @node Full Name Patterns
 @subsection Full Name Patterns
 
-@deffn Test -path pattern
-@deffnx Test -ipath pattern
+@deffn Test -wholename pattern
+@deffnx Test -iwholename pattern
 True if the entire file name, starting with the command line argument
 under which the file was found, matches shell pattern @var{pattern}.
-For @samp{-ipath}, the match is case-insensitive.  To ignore a whole
+For @samp{-iwholename}, the match is case-insensitive.  To ignore a whole
 directory tree, use @samp{-prune} rather than checking every file in the
 tree (@pxref{Directories}).
 @end deffn
 
+@deffn Test -path pattern
+@deffnx Test -ipath pattern
+These tests are deprecated, but work as for @samp{-wholename} and @samp{-iwholename},
+respectively.  The @samp{-ipath} test is a GNU extension, but @samp{-path} is also 
+provided by HP-UX @code{find}.
+@end deffn
+
 @deffn Test -regex expr
 @deffnx Test -iregex expr
 True if the entire file name matches regular expression @var{expr}.
@@ -464,7 +471,7 @@ works even in character classes.
 @end table
 
 In the @code{find} tests that do shell pattern matching (@samp{-name},
-@samp{-path}, etc.), wildcards in the pattern do not match a @samp{.}
+@samp{-wholename}, etc.), wildcards in the pattern do not match a @samp{.}
 at the beginning of a file name.  This is not the case for
 @code{locate}.  Thus, @samp{find -name '*macs'} does not match a file
 named @file{.emacs}, but @samp{locate '*macs'} does.
@@ -846,7 +853,7 @@ For example, to skip the directory @file{src/emacs} and all files and
 directories under it, and print the names of the other files found:
 
 @example
-find . -path './src/emacs' -prune -o -print
+find . -wholename './src/emacs' -prune -o -print
 @end example
 @end deffn
 
diff --git a/find/find.1 b/find/find.1
index e7d976b..89de17c 100644
--- a/find/find.1
+++ b/find/find.1
@@ -132,9 +132,12 @@ patterns `fo*' and `F??' match the file names `Foo', `FOO', `foo',
 .IP "\-inum \fIn\fR"
 File has inode number \fIn\fR.
 .IP "\-ipath \fIpattern\fR"
-Like \-path, but the match is case insensitive.
+Behaves in the same way as \-iwholename.  This option is deprecated,
+so please do not use it.
 .IP "\-iregex \fIpattern\fR"
 Like \-regex, but the match is case insensitive.
+.IP "\-iwholename \fIpattern\fR"
+Like \-wholename, but the match is case insensitive.
 .IP "\-links \fIn\fR"
 File has \fIn\fR links.
 .IP "\-lname \fIpattern\fR"
@@ -149,7 +152,7 @@ Base of file name (the path with the leading directories removed)
 matches shell pattern \fIpattern\fR.  The metacharacters (`*', `?',
 and `[]') do not match a `.' at the start of the base name.  To ignore
 a directory and the files under it, use \-prune; see an example in the
-description of \-path.  Braces are not recognised as being special,
+description of \-wholename.  Braces are not recognised as being special,
 despite the fact that some shells including Bash ibmue braces with 
 a special meaning in shell patterns.   The filename matching is
 performed with the use of the 
@@ -164,23 +167,8 @@ No user corresponds to file's numeric user ID.
 .IP \-nogroup
 No group corresponds to file's numeric group ID.
 .IP "\-path \fIpattern\fR"
-File name matches shell pattern \fIpattern\fR.  The metacharacters do
-not treat `/' or `.' specially; so, for example,
-.br
-.in +1i
-find . \-path './sr*sc'
-.br
-.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
-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
-find . \-path './src/emacs' -prune -o -print
-.br
-.in -1i
+See \-wholename.   The predicate \-path is also supported by HP-UX 
+.BR find .
 .IP "\-perm \fImode\fR"
 File's permission bits are exactly \fImode\fR (octal or symbolic).
 Symbolic modes use mode 0 as a point of departure.
@@ -252,6 +240,24 @@ File's numeric user ID is \fIn\fR.
 File was last accessed \fIn\fR days after its status was last changed.
 .IP "\-user \fIuname\fR"
 File is owned by user \fIuname\fR (numeric user ID allowed).
+.IP "\-wholename \fIpattern\fR"
+File name matches shell pattern \fIpattern\fR.  The metacharacters do
+not treat `/' or `.' specially; so, for example,
+.br
+.in +1i
+find . \-wholename './sr*sc'
+.br
+.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
+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
+find . \-wholename './src/emacs' -prune -o -print
+.br
+.in -1i
 .IP "\-xtype \fIc\fR"
 The same as \-type unless the file is a symbolic link.  For symbolic
 links: if \-follow has not been given, true if the file is a link to a
-- 
2.11.4.GIT