date and time created 91/03/07 20:22:38 by bostic

SCCS-vsn: bin/sh/bltin/echo.1 5.1

diff --git a/usr/src/bin/sh/bltin/echo.1 b/usr/src/bin/sh/bltin/echo.1
new file mode 100644 (file)
index 0000000..4a3ee3b
--- /dev/null
+++ b/usr/src/bin/sh/bltin/echo.1
@@ -0,0 +1,94 @@
+.\" Copyright (c) 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" Kenneth Almquist.
+.\"
+.\" %sccs.include.redist.man%
+.\"
+.\"    @(#)echo.1      5.1 (Berkeley) %G%
+.\"
+.TH ECHO 1""
+.UC 7
+.SH NAME
+echo \- produce message in a shell script
+.SH SYNOPSIS
+.B echo
+[
+.B -n
+|
+.B -e
+]
+.I args...
+.SH COPYRIGHT
+Copyright 1989 by Kenneth Almquist.
+.SH DESCRIPTION
+.I Echo
+prints its arguments on the standard output, separated by spaces.
+Unless the
+.B -n
+option is present, a newline is output following the arguments.
+The
+.B -e
+option causes
+.I echo
+to treat the escape sequences specially, as described in the following
+paragraph.  The
+.B -e
+option is the default, and is provided solely for compatibility with
+other systems.
+Only one of the options
+.B -n
+and
+.B -e
+may be given.
+.PP
+If any of the following sequences of characters is encountered during
+output, the sequence is not output.  Instead, the specified action is
+performed:
+.nr i 0.6i
+.de i
+.sp
+.ti -\\niu
+\\$1   \c
+.if \w'\\$1'-\\ni .br
+..
+.in 1.1i
+.ta 0.6i
+.i \eb
+A backspace character is output.
+.i \ec
+Subsequent output is suppressed.  This is normally used at the end of the
+last argument to suppress the trailing newline that
+.I echo
+would otherwise output.
+.i \ef
+Output a form feed.
+.i \en
+Output a newline character.
+.i \er
+Output a carriage return.
+.i \et
+Output a (horizontal) tab character.
+.i \ev
+Output a vertical tab.
+.i \e0\fIdigits\fR
+Output the character whose value is given by zero to three digits.
+If there are zero digits, a nul character is output.
+.i \e\e
+Output a backslash.
+.in -1.1i
+.SH HINTS
+Remember that backslash is special to the shell and needs to be escaped.
+To output a message to standard error, say
+.sp
+.ti +1i
+echo message >&2
+.SH BUGS
+The octal character escape mechanism (\e0\fIdigits\fR) differs from the
+C language mechanism.
+.PP
+There is no way to force
+.I echo
+to treat its arguments literally, rather than interpreting them as
+options and escape sequences.