(yes invocation): "--" is now supported.

(false invocation, true invocation): --help and --version now
work unconditionally.

1 files changed, 4 insertions, 10 deletions

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index a09321503..acf42c036 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -9069,6 +9069,8 @@ given, it prints @samp{y} followed by a newline forever until killed.
 Upon a write error, @command{yes} exits with status @samp{1}.
 
 The only options are a lone @option{--help} or @option{--version}.
+To output an argument that begins with
+@samp{-}, precede it with @option{--}, e.g., @samp{yes -- --help}.
 @xref{Common options}.
 
 
@@ -9104,11 +9106,7 @@ pipeline.
 @dfn{failure}.  It can be used as a place holder in shell scripts
 where an unsuccessful command is needed.
 
-@vindex POSIXLY_CORRECT
-By default, @command{false} honors the @option{--help} and @option{--version}
-options.  However, that is contrary to @acronym{POSIX}, so when the environment
-variable @env{POSIXLY_CORRECT} is set, @command{false} ignores @emph{all}
-command line arguments, including @option{--help} and @option{--version}.
+@command{false} honors the @option{--help} and @option{--version} options.
 
 This version of @command{false} is implemented as a C program, and is thus
 more secure and faster than a shell script implementation, and may safely
@@ -9136,11 +9134,7 @@ In most modern shells, @command{true} is a built-in command, so when
 you use @samp{true} in a script, you're probably using the built-in
 command, not the one documented here.
 
-@vindex POSIXLY_CORRECT
-By default, @command{true} honors the @option{--help} and @option{--version}
-options.  However, that is contrary to @acronym{POSIX}, so when the environment
-variable @env{POSIXLY_CORRECT} is set, @command{true} ignores @emph{all}
-command line arguments, including @option{--help} and @option{--version}.
+@command{true} honors the @option{--help} and @option{--version} options.
 
 Note, however, that it is possible to cause @command{true}
 to exit with nonzero status: when invoked in non-@acronym{POSIX} mode,