/usr/share/zsh/5.5.1/help
Edit: /usr/share/zsh/5.5.1/help/print (5415B)
print [ -abcDilmnNoOpPrsSz ] [ -u n ] [ -f format ] [ -C cols ]
[ -v name ] [ -xX tabstop ] [ -R [ -en ]] [ arg ... ]
With the `-f' option the arguments are printed as described by
printf. With no flags or with the flag `-', the arguments are
printed on the standard output as described by echo, with the
following differences: the escape sequence `\M-x' (or `\Mx')
metafies the character x (sets the highest bit), `\C-x' (or
`\Cx') produces a control character (`\C-@' and `\C-?' give the
characters NULL and delete), a character code in octal is repre-
sented by `\NNN' (instead of `\0NNN'), and `\E' is a synonym for
`\e'. Finally, if not in an escape sequence, `\' escapes the
following character and is not printed.
-a Print arguments with the column incrementing first. Only
useful with the -c and -C options.
-b Recognize all the escape sequences defined for the bind-
key command, see the section `Zle Builtins' in zshzle(1).
-c Print the arguments in columns. Unless -a is also given,
arguments are printed with the row incrementing first.
-C cols
Print the arguments in cols columns. Unless -a is also
given, arguments are printed with the row incrementing
first.
-D Treat the arguments as paths, replacing directory pre-
fixes with ~ expressions corresponding to directory
names, as appropriate.
-i If given together with -o or -O, sorting is performed
case-independently.
-l Print the arguments separated by newlines instead of spa-
ces.
-m Take the first argument as a pattern (should be quoted),
and remove it from the argument list together with subse-
quent arguments that do not match this pattern.
-n Do not add a newline to the output.
-N Print the arguments separated and terminated by nulls.
-o Print the arguments sorted in ascending order.
-O Print the arguments sorted in descending order.
-p Print the arguments to the input of the coprocess.
-P Perform prompt expansion (see EXPANSION OF PROMPT
SEQUENCES in zshmisc(1)). In combination with `-f',
prompt escape sequences are parsed only within interpo-
lated arguments, not within the format string.
-r Ignore the escape conventions of echo.
-R Emulate the BSD echo command, which does not process
escape sequences unless the -e flag is given. The -n
flag suppresses the trailing newline. Only the -e and -n
flags are recognized after -R; all other arguments and
options are printed.
-s Place the results in the history list instead of on the
standard output. Each argument to the print command is
treated as a single word in the history, regardless of
its content.
-S Place the results in the history list instead of on the
standard output. In this case only a single argument is
allowed; it will be split into words as if it were a full
shell command line. The effect is similar to reading the
line from a history file with the HIST_LEX_WORDS option
active.
-u n Print the arguments to file descriptor n.
-v name
Store the printed arguments as the value of the parameter
name.
-x tab-stop
Expand leading tabs on each line of output in the printed
string assuming a tab stop every tab-stop characters.
This is appropriate for formatting code that may be
indented with tabs. Note that leading tabs of any argu-
ment to print, not just the first, are expanded, even if
print is using spaces to separate arguments (the column
count is maintained across arguments but may be incorrect
on output owing to previous unexpanded tabs).
The start of the output of each print command is assumed
to be aligned with a tab stop. Widths of multibyte char-
acters are handled if the option MULTIBYTE is in effect.
This option is ignored if other formatting options are in
effect, namely column alignment or printf style, or if
output is to a special location such as shell history or
the command line editor.
-X tab-stop
This is similar to -x, except that all tabs in the
printed string are expanded. This is appropriate if tabs
in the arguments are being used to produce a table for-
mat.
-z Push the arguments onto the editing buffer stack, sepa-
rated by spaces.
If any of `-m', `-o' or `-O' are used in combination with `-f'
and there are no arguments (after the removal process in the
case of `-m') then nothing is printed.
pushln [ arg ... ]
Equivalent to print -nz.