xref: /netbsd-src/bin/echo/echo.1 (revision 1290da4db36c46ef567470d635e41a79685b8994)
1*1290da4dSgutteridge.\"	$NetBSD: echo.1,v 1.20 2024/05/14 01:32:24 gutteridge Exp $
249f0ad86Scgd.\"
3667b5ea1Smycroft.\" Copyright (c) 1990, 1993
4667b5ea1Smycroft.\"	The Regents of the University of California.  All rights reserved.
561f28255Scgd.\"
661f28255Scgd.\" This code is derived from software contributed to Berkeley by
761f28255Scgd.\" the Institute of Electrical and Electronics Engineers, Inc.
861f28255Scgd.\"
961f28255Scgd.\" Redistribution and use in source and binary forms, with or without
1061f28255Scgd.\" modification, are permitted provided that the following conditions
1161f28255Scgd.\" are met:
1261f28255Scgd.\" 1. Redistributions of source code must retain the above copyright
1361f28255Scgd.\"    notice, this list of conditions and the following disclaimer.
1461f28255Scgd.\" 2. Redistributions in binary form must reproduce the above copyright
1561f28255Scgd.\"    notice, this list of conditions and the following disclaimer in the
1661f28255Scgd.\"    documentation and/or other materials provided with the distribution.
17b5b29542Sagc.\" 3. Neither the name of the University nor the names of its contributors
1861f28255Scgd.\"    may be used to endorse or promote products derived from this software
1961f28255Scgd.\"    without specific prior written permission.
2061f28255Scgd.\"
2161f28255Scgd.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2261f28255Scgd.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2361f28255Scgd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2461f28255Scgd.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2561f28255Scgd.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2661f28255Scgd.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2761f28255Scgd.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2861f28255Scgd.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2961f28255Scgd.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3061f28255Scgd.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3161f28255Scgd.\" SUCH DAMAGE.
3261f28255Scgd.\"
3349f0ad86Scgd.\"	@(#)echo.1	8.1 (Berkeley) 7/22/93
34346aa5ddScgd.\"
35*1290da4dSgutteridge.Dd May 14, 2024
3661f28255Scgd.Dt ECHO 1
3761f28255Scgd.Os
3861f28255Scgd.Sh NAME
3961f28255Scgd.Nm echo
4061f28255Scgd.Nd write arguments to the standard output
4161f28255Scgd.Sh SYNOPSIS
42c3872193Senami.Nm
4361f28255Scgd.Op Fl n
4424869357Senami.Op Ar string ...
4561f28255Scgd.Sh DESCRIPTION
4661f28255ScgdThe
47c3872193Senami.Nm
4861f28255Scgdutility writes any specified operands, separated by single blank (`` '')
49667b5ea1Smycroftcharacters and followed by a newline (``\en'') character, to the standard
5061f28255Scgdoutput.
5161f28255Scgd.Pp
5261f28255ScgdThe following option is available:
5361f28255Scgd.Bl -tag -width flag
5461f28255Scgd.It Fl n
5561f28255ScgdDo not print the trailing newline character.
5661f28255Scgd.El
5722b0f33cSgutteridge.Pp
5822b0f33cSgutteridgeNote that many shells (e.g.,
5922b0f33cSgutteridge.Xr csh 1
6022b0f33cSgutteridgeand
6122b0f33cSgutteridge.Xr ksh 1 )
6222b0f33cSgutteridgeprovide a built-in
6322b0f33cSgutteridge.Nm
6422b0f33cSgutteridgecommand which tends to differ from this utility in the treatment of options
6522b0f33cSgutteridgeand backslashes.
66*1290da4dSgutteridgeWhere portability is paramount, use
67*1290da4dSgutteridge.Xr printf 1 .
682caf6aacSkleink.Sh EXIT STATUS
6939b251a7Swiz.Ex -std echo
7061f28255Scgd.Sh SEE ALSO
719a9e6da0Swiz.Xr csh 1 ,
729a9e6da0Swiz.Xr ksh 1 ,
7361f28255Scgd.Xr printf 1
7461f28255Scgd.Sh STANDARDS
7561f28255ScgdThe
76c3872193Senami.Nm
77667b5ea1Smycroftutility is expected to be
78667b5ea1Smycroft.St -p1003.2
79667b5ea1Smycroftcompatible.
802c701eeaSsevan.Sh HISTORY
812c701eeaSsevanAn
822c701eeaSsevan.Nm
832c701eeaSsevanutility appeared in
842881adbdSsevan.At v2 .
85