svn commit: r215639 - stable/7/bin/echo
jilles at FreeBSD.org
Sun Nov 21 17:14:23 UTC 2010
Date: Sun Nov 21 17:14:22 2010
New Revision: 215639
MFC r215211: echo(1): Clarify portability and mention literal "--" handling.
stable/7/bin/echo/ (props changed)
--- stable/7/bin/echo/echo.1 Sun Nov 21 17:12:27 2010 (r215638)
+++ stable/7/bin/echo/echo.1 Sun Nov 21 17:14:22 2010 (r215639)
@@ -32,7 +32,7 @@
.\" @(#)echo.1 8.1 (Berkeley) 7/22/93
-.Dd April 12, 2003
+.Dd November 12, 2010
.Dt ECHO 1
@@ -56,24 +56,37 @@ The following option is available:
.Bl -tag -width flag
.It Fl n
Do not print the trailing newline character.
-This may also be achieved by appending
+The end-of-options marker
+is not recognized and written literally.
+The newline may also be suppressed by appending
to the end of the string, as is done
by iBCS2 compatible systems.
-Note that this option as well as the effect of
+Note that the
+option as well as the effect of
are implementation-defined in
as amended by Cor.\& 1-2002.
-Applications aiming for maximum
-portability are strongly encouraged to use
+should only be used if the first argument does not start with a hyphen
+.Pq Ql "-"
+and does not contain any backslashes
+.Pq Ql "\e" .
+If this is not sufficient,
.Xr printf 1
-to suppress the newline character.
+should be used.
-Some shells may provide a builtin
+Most shells provide a builtin
-command which is similar or identical to this utility.
+command which tends to differ from this utility
+in the treatment of options and backslashes.
.Xr builtin 1
More information about the svn-src-stable-7