'\"macro stdmacro
.if n .pH g1.echo @(#)echo	40.3 of 9/20/89
.\" @(#)echo.1 1.4 88/10/17 SMI;
'\"macro stdmacro
.\" Copyright (c) 1988 Sun Microsystems, Inc - All Rights Reserved.
.if n .pH g1.echo @(#)echo	32.1 of 6/23/88
.nr X
.if \nX=0 .ds x} echo 1 "BSD Compatibility Package" "\&"
.if \nX=1 .ds x} echo 1 "BSD Compatibility Package"
.if \nX=2 .ds x} echo 1 "" "\&"
.if \nX=3 .ds x} echo "" "" "\&"
.TH \*(x}
.SH NAME
\f4echo\f1 \- echo arguments 
.SH SYNOPSIS
\f4/usr/ucb/echo\f1
[ arg ] ...
.br
\f4/usr/ucb/echo\f1
[
\f4\-n\f1
]
[ arg ]
.SH DESCRIPTION
.I echo\^
writes its arguments separated by blanks and terminated by
a new-line on the standard output.
.PP
The
\f4/usr/bin/sh\f1
version
understands the following C-like escape conventions;
beware of conflicts with the shell's use of \f4\e\fP:
.PP
.RS
.PD 0
.TP
\f4\eb\f1
backspace
.TP
\f4\ec\f1
print line without new-line
.TP
\f4\ef\f1
form-feed
.TP
\f4\en\f1
new-line
.TP
\f4\er\f1
carriage return
.TP
\f4\et\f1
tab
.TP
\f4\ev\f1
vertical tab
.TP
\f4\e\e\f1
backslash
.TP
\f4\e0\f2n\^\f1
where
.I n\^
is the 8-bit character whose \s-1ASCII\s0 code is
the 1-, 2- or 3-digit octal number representing that character.
.RE
.PD
.PP
The following option is available to
\f4/usr/bin/sh\f1
users only if
\f4/usr/ucb\f1
preceds
\f4/usr/bin\f1
in the user's
.SM PATH\s0.
It is available to
\f4/usr/csh\f1
users, regardless of 
.SM PATH\s0:
.RS
.TP
\f4\-n\f1
Do not add
the newline to the output.
.RE
.PP
.I echo\^
is useful for producing diagnostics in command files
and for sending known data into a pipe.
.SH SEE ALSO
\f4sh\fP(1)
in the \f2User's Reference Manual\f1.
.SH NOTES
The
\f4\-n\f1
option is a transition aid for
.SM BSD
applications, and may not be supported in future 
releases.
.PP
The
When representing an 8-bit character by using the escape convention
\f4\e0\f2n\^,\f1
the
.I n\^
must
\f4always\f1
be preceded by the digit zero (0).
.sp .5
For example, typing:
\f4echo \'\s-1WARNING\s+1:\e07\'\f1
will print the phrase
\f4WARNING\s+1:\f1
and sound the ``bell'' on your terminal.
The use of single (or double) quotes
(or two backslashes) is required to protect the ``\e''
that precedes the ``07''.
.sp .5
For the octal equivalents of each character,
see
ascii\^(5), in the \f2System Administrator's Reference Manual\f1.
.\"	@(#)echo.1	6.2 of 9/2/83
.Ee
