From: Paul Eggert <eggert@cs.ucla.edu>
Date: Mon, 10 Jan 2005 18:08:12 +0000 (+0000)
Subject: Document changes responding to POSIX interpretations about pathchk -p
X-Git-Tag: CPPI-1_12~1643
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=23c6e3110efc3487a2212c75dbac9192f6648016;p=thirdparty%2Fcoreutils.git

Document changes responding to POSIX interpretations about pathchk -p
dated 2005-01-06.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 0effaa09fc..c8fc980866 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -10240,21 +10240,39 @@ its file system's maximum.
 A nonexistent @var{name} is not an error, so long a file with that
 name could be created under the above conditions.
 
-The program accepts the following option.  Also see @ref{Common options}.
+The program accepts the following options.  Also see @ref{Common options}.
 Options must precede operands.
 
 @table @samp
 
 @item -p
-@itemx --portability
 @opindex -p
-@opindex --portability
-Do not perform checks based on the underlying file system.  Instead,
-check the length of each file name and its components against the
-@acronym{POSIX} minimum limits for portability.  Also check that the file
-name contains only characters that are in the portable file name
+Instead of performing checks based on the underlying file system,
+print a message if any of these conditions is true:
+
+@enumerate
+@item
+A file name is empty.
+
+@item
+The length of a file name or one of its components exceeds the
+@acronym{POSIX} minimum limits for portability.
+
+@item
+A file name contains a character outside the portable file name
 character set, namely, the ASCII letters and digits, @samp{-},
 @samp{.}, @samp{/}, and @samp{_}.
+@end enumerate
+
+@item -P
+@opindex -P
+Print a message if a file name is empty, or if it contains a component
+that begins with @samp{-}.
+
+@item --portability
+@opindex --portability
+Print a message if a file name is not portable to all @acronym{POSIX}
+hosts.  This option is equivalent to @samp{-p -P}.
 
 @end table