From: Jim Meyering <jim@meyering.net>
Date: Wed, 3 Mar 2004 07:52:36 +0000 (+0000)
Subject: (chown invocation): Document that chown now falls
X-Git-Tag: v5.2.1~75
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=50c485dac0fe0075a570656fd0a168a07177d32f;p=thirdparty%2Fcoreutils.git

(chown invocation): Document that chown now falls
back on USER.GROUP parsing regardless of POSIX version, as POSIX
1003.1-2001 allows that behavior as a compatible extension.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 5d37be7d04..6e074f5fa9 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7712,11 +7712,13 @@ is omitted, only the group of the files is changed; in this case,
 @end table
 
 Some older scripts may still use @samp{.} in place of the @samp{:} separator.
-@acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow that,
-but you may be able to work around the compatibility problems by setting
-@samp{_POSIX2_VERSION=199209} in your environment.
-New scripts should avoid the use of @samp{.} because @sc{gnu} @command{chown}
-may fail if @var{owner} contains @samp{.} characters.
+@acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not
+require support for that, but for backward compatibility @acronym{GNU}
+@command{chown} supports @samp{.} so long as no ambiguity results.
+New scripts should avoid the use of @samp{.} because it is not
+portable, and because it has undesirable results if the entire
+@var{owner@samp{.}group} happens to identify a user whose name
+contains @samp{.}.
 
 Warning: The @command{chown} command may clear the set-user-ID or
 set-group-ID bits on some systems.  The @command{chown} command is