diff options
author | Fernando ApesteguĂa <fernape@FreeBSD.org> | 2023-09-07 13:27:49 +0000 |
---|---|---|
committer | Fernando ApesteguĂa <fernape@FreeBSD.org> | 2024-04-08 16:35:40 +0000 |
commit | 7e68976408e4df21e120e2d6440392302cac84f3 (patch) | |
tree | 441e93e72aa7b65eb2a33db02c195e4805d933f1 /bin/echo | |
parent | 60d8dbbef075d3b39891ed35e124d0f7ef8e5fb9 (diff) | |
download | src-7e68976408e4df21e120e2d6440392302cac84f3.tar.gz src-7e68976408e4df21e120e2d6440392302cac84f3.zip |
echo(1): Add EXAMPLES
While here add CAVEAT section and promote the use of printf(1)
Reviewed by: gbe@, imp@
Approved by: manpages (gbe)
Differential Revision: https://reviews.freebsd.org/D43493
Diffstat (limited to 'bin/echo')
-rw-r--r-- | bin/echo/echo.1 | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/bin/echo/echo.1 b/bin/echo/echo.1 index aa547d2350f5..cb60bdcc88dd 100644 --- a/bin/echo/echo.1 +++ b/bin/echo/echo.1 @@ -89,6 +89,24 @@ Consult the manual page. .Sh EXIT STATUS .Ex -std +.Sh EXAMPLES +Special treatment of options and backslashes: +.Bd -literal -offset indent +$ /bin/echo "-hello\\tworld" +-hello\tworld +.Ed +.Pp +Avoid new line character: +.Bd -literal -offset indent +$ /bin/echo -n hello;/bin/echo world +helloworld +.Ed +.Pp +Or to achieve the same result: +.Bd -literal -offset indent +$ /bin/echo "hello\\c";/bin/echo world +helloworld +.Ed .Sh SEE ALSO .Xr builtin 1 , .Xr csh 1 , @@ -105,3 +123,14 @@ The .Nm command appeared in .At v2 . +.Sh CAVEATS +The +.Nm +command behaves differently with regards to the built-in +.Nm +shell command in a number of ways including escaped characters handling. +It also differs in behavior between different systems hence complicating writing +portable scripts. +It is advised to use the +.Xr printf 1 +command to avoid these shortcomings. |