1
0
Fork 0
mirror of git://git.code.sf.net/p/cdesktopenv/code synced 2025-03-09 15:50:02 +00:00

sh.1: Add missing printf -v doc (re: eb760a62); more tweaks

Also add a missing 'Shell Variables' heading that is referred to
elsewhere, and capitalise the ASCII acronym.
This commit is contained in:
Martijn Dekker 2021-11-19 05:21:20 +01:00
parent 15bbc2f632
commit 745ffd366d

View file

@ -1537,7 +1537,7 @@ In this case, the
portion of portion of
.I word\^ .I word\^
will be re-evaluated for each element. will be re-evaluated for each element.
.PP .SS Shell Variables.
The following The following
parameters parameters
are automatically set by the shell: are automatically set by the shell:
@ -1609,7 +1609,7 @@ so that the value is safe for being evaluated by the shell.
.TP .TP
.B .sh.edchar .B .sh.edchar
This variable contains the value of the keyboard character This variable contains the value of the keyboard character
(or sequence of characters if the first character is an ESC, ascii (or sequence of characters if the first character is an ESC, ASCII
.BR 033\^ ) .BR 033\^ )
that has that has
been entered when processing a been entered when processing a
@ -2839,12 +2839,12 @@ Causes the remainder of the string to be ignored.
.TP .TP
.B \eE .B \eE
Equivalent to the escape character Equivalent to the escape character
(ascii (ASCII
.BR 033 ), .BR 033 ),
.TP .TP
.B \ee .B \ee
Equivalent to the escape character Equivalent to the escape character
(ascii (ASCII
.BR 033 ), .BR 033 ),
.TP .TP
.BI \ec x .BI \ec x
@ -4637,7 +4637,7 @@ For example,
.B M-f .B M-f
(pronounced Meta f) (pronounced Meta f)
is entered by depressing ESC is entered by depressing ESC
(ascii (ASCII
.BR 033 ) .BR 033 )
followed by `f'. followed by `f'.
.RB ( M-F .RB ( M-F
@ -6506,11 +6506,11 @@ escape conventions will be applied:
.PD 0 .PD 0
.TP .TP
.B \ea .B \ea
The alert character (ascii The alert character (ASCII
.BR 07 ). .BR 07 ).
.TP .TP
.B \eb .B \eb
The backspace character (ascii The backspace character (ASCII
.BR 010 ). .BR 010 ).
.TP .TP
.B \ec .B \ec
@ -6520,27 +6520,27 @@ to end without processing more arguments and
not adding a new-line. not adding a new-line.
.TP .TP
.B \ef .B \ef
The formfeed character (ascii The formfeed character (ASCII
.BR 014 ). .BR 014 ).
.TP .TP
.B \en .B \en
The newline character (ascii The newline character (ASCII
.BR 012 ). .BR 012 ).
.TP .TP
.B \er .B \er
The carriage return character (ascii The carriage return character (ASCII
.BR 015 ). .BR 015 ).
.TP .TP
.B \et .B \et
The tab character (ascii The tab character (ASCII
.BR 011 ). .BR 011 ).
.TP .TP
.B \ev .B \ev
The vertical tab character (ascii The vertical tab character (ASCII
.BR 013 ). .BR 013 ).
.TP .TP
.B \eE .B \eE
The escape character (ascii The escape character (ASCII
.BR 033 ). .BR 033 ).
.TP .TP
.B \e\e .B \e\e
@ -6607,7 +6607,7 @@ is used, no
is added to the output. is added to the output.
.RE .RE
.TP .TP
\f3printf\fP \f2format\^\fP \*(OK \f2arg\^\fP .\|.\|. \*(CK \f3printf\fP \*(OK \f3\-v\fP \f2vname\fP \*(CK \f2format\^\fP \*(OK \f2arg\^\fP .\|.\|. \*(CK
The arguments The arguments
.I arg\^ .I arg\^
are printed on standard output are printed on standard output
@ -6766,6 +6766,13 @@ formats, separates groups of digits with the grouping delimiter
on groups of 3 in the C locale). on groups of 3 in the C locale).
.PD .PD
.PP .PP
.TP
The \f3\-v\fP option assigns the output directly to a variable instead of
writing it to standard output. This is faster than capturing the output using a
command substitution and avoids the latter's stripping of final linefeed
characters (\fB\\n\fR). The \f2vname\fP argument should be a valid variable
name, optionally with one or more array subscripts in square brackets.
Note that square brackets should be quoted to avoid pathname expansion.
.RE .RE
.TP .TP
\f3pwd\fP \*(OK \f3\-LP\fP \*(CK \f3pwd\fP \*(OK \f3\-LP\fP \*(CK