diff options
Diffstat (limited to 'Doc/help/print')
| -rw-r--r-- | Doc/help/print | 86 |
1 files changed, 43 insertions, 43 deletions
diff --git a/Doc/help/print b/Doc/help/print index 3bf470e5d..fd6dd0b02 100644 --- a/Doc/help/print +++ b/Doc/help/print @@ -1,51 +1,51 @@ 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 + 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 + `\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- + -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 + 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- + -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 + -i If given together with -o or -O, sorting is performed case-independently. -l Print the arguments separated by newlines instead of spa- - ces. Note: if the list of arguments is empty, print -l - will still output one empty line. To print a possi- - bly-empty list of arguments one per line, use print -C1, + ces. Note: if the list of arguments is empty, print -l + will still output one empty line. To print a possi- + bly-empty list of arguments one per line, use print -C1, as in `print -rC1 -- "$list[@]"'. - -m Take the first argument as a pattern (should be quoted), + -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. - Again, print -rNC1 -- "$list[@]" is a canonical way to + -N Print the arguments separated and terminated by nulls. + Again, print -rNC1 -- "$list[@]" is a canonical way to print an arbitrary list as null-delimited records. -o Print the arguments sorted in ascending order. @@ -54,29 +54,29 @@ print [ -abcDilmnNoOpPrsSz ] [ -u n ] [ -f format ] [ -C cols ] -p Print the arguments to the input of the coprocess. - -P Perform prompt expansion (see EXPANSION OF PROMPT SE- + -P Perform prompt expansion (see EXPANSION OF PROMPT SE- QUENCES in zshmisc(1)). In combination with `-f', prompt - escape sequences are parsed only within interpolated ar- + escape sequences are parsed only within interpolated ar- guments, not within the format string. -r Ignore the escape conventions of echo. - -R Emulate the BSD echo command, which does not process es- - cape 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 + -R Emulate the BSD echo command, which does not process es- + cape 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 + -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 + -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 + line from a history file with the HIST_LEX_WORDS option active. -u n Print the arguments to file descriptor n. @@ -87,33 +87,33 @@ print [ -abcDilmnNoOpPrsSz ] [ -u n ] [ -f format ] [ -C cols ] -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 in- + string assuming a tab stop every tab-stop characters. + This is appropriate for formatting code that may be in- dented with tabs. Note that leading tabs of any argument 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 + 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 + 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. + 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 + 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 + 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- + in the arguments are being used to produce a table for- mat. - -z Push the arguments onto the editing buffer stack, sepa- + -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 + 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 ... ] |