document print builtin changes

This commit is contained in:
tg 2016-11-11 21:37:44 +00:00
parent 6267ea36a4
commit 945ef46af1

77
mksh.1
View File

@ -1,4 +1,4 @@
.\" $MirOS: src/bin/mksh/mksh.1,v 1.417 2016/09/29 09:04:56 tg Exp $ .\" $MirOS: src/bin/mksh/mksh.1,v 1.418 2016/11/11 21:37:44 tg Exp $
.\" $OpenBSD: ksh.1,v 1.160 2015/07/04 13:27:04 feinerer Exp $ .\" $OpenBSD: ksh.1,v 1.160 2015/07/04 13:27:04 feinerer Exp $
.\"- .\"-
.\" Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, .\" Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
@ -76,7 +76,7 @@
.\" with -mandoc, it might implement .Mx itself, but we want to .\" with -mandoc, it might implement .Mx itself, but we want to
.\" use our own definition. And .Dd must come *first*, always. .\" use our own definition. And .Dd must come *first*, always.
.\" .\"
.Dd $Mdocdate: September 29 2016 $ .Dd $Mdocdate: November 11 2016 $
.\" .\"
.\" Check which macro package we use, and do other -mdoc setup. .\" Check which macro package we use, and do other -mdoc setup.
.\" .\"
@ -3757,46 +3757,57 @@ however, distributors may have added this as builtin as a speed hack.
.Pp .Pp
.It Xo .It Xo
.Ic print .Ic print
.Oo Fl Anprsu Ns Oo Ar n Oc \*(Ba .Oo Fl AclNnprsu Ns Oo Ar n Oc \*(Ba
.Fl R Op Fl en Oc .Fl R Op Fl en Oc
.Op Ar argument ... .Op Ar argument ...
.Xc .Xc
.Ic print Print the specified argument(s) on the standard output,
prints its arguments on the standard output, separated by spaces and separated by spaces, terminated with a newline.
terminated with a newline. The C escapes mentioned in
The
.Fl n
option suppresses the newline.
By default, certain C escapes are translated.
These include these mentioned in
.Sx Backslash expansion .Sx Backslash expansion
above, as well as above, as well as
.Dq Li \ec , .Dq Li \ec ,
which is equivalent to using the which is equivalent to using the
.Fl n .Fl n
option. option, are interpreted.
Backslash expansion may be inhibited with the .Pp
.Fl r The options are as follows:
option. .Bl -tag -width Ds
The .It Fl A
.Fl s Each
option prints to the history file instead of standard output; the .Ar argument
.Fl u is arithmetically evaluated; the character corresponding to the
option prints to file descriptor resulting value is printed.
.Ar n Empty
.Po .Ar argument Ns s
.Ar n separate input words.
defaults to 1 if omitted .It Fl c
.Pc ; The output is printed columnised, line by line, similar to how the
and the .Xr rs 1
.Fl p utility, tab completion, the
option prints to the co-process (see .Ic kill Fl l
built-in utility and the
.Ic select
statement do.
.It Fl l
Change the output word separator to newline.
.It Fl N
Change the output word and line separator to ASCII NUL.
.It Fl n
Do not print the trailing line separator.
.It Fl p
Print to the co-process (see
.Sx Co-processes .Sx Co-processes
above). above).
The .It Fl r
.Fl A Inhibit backslash expansion.
option prints the character corresponding to each .It Fl s
.Ar argument Ns 's value . Print to the history file instead of standard output.
.It Fl u Op Ar n
Print to the file descriptor
.Ar n Pq defaults to 1 if omitted
instead of standard output.
.El
.Pp .Pp
The The
.Fl R .Fl R
@ -6694,7 +6705,7 @@ for the in-memory portion of the history is slow, should use
.Xr memmove 3 . .Xr memmove 3 .
.Pp .Pp
This document attempts to describe This document attempts to describe
.Nm mksh\ R53 .Nm mksh\ R54
and up, and up,
.\" with vendor patches from insert-your-name-here, .\" with vendor patches from insert-your-name-here,
compiled without any options impacting functionality, such as compiled without any options impacting functionality, such as