[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v2 04/18] doc/bash.1: improve typography of ellipses
From: |
G. Branden Robinson |
Subject: |
[PATCH v2 04/18] doc/bash.1: improve typography of ellipses |
Date: |
Wed, 31 Jan 2024 12:54:27 -0600 |
v2: Prevent confclit with PATCH v2 01/18.
Apply ellipsis advice from groff_man_style(7).
• The dummy character escape sequence \& follows the ellipsis when
further text will follow after space on the output line, keeping
its last period from being interpreted as the end of a sentence
and causing additional inter‐sentence space to be placed after
it. See subsection “Portability” below.
[...]
\& Dummy character. Insert at the beginning of an input
line to prevent a dot or apostrophe from being
interpreted as beginning a roff control line. Append to
an end‐of‐sentence punctuation sequence to keep it from
being recognized as such.
\| Thin space (one‐sixth em on typesetters, zero‐width on
terminals); a non‐breaking space. Used primarily in
ellipses (“.\|.\|.”) to space the dots more pleasantly on
typesetters like dvi, pdf, and ps.
Break some long input lines.
\newline Join the next input line to the current one. Except for
the update of the input line counter (used for diagnostic
messages and related purposes), a series of lines ending
in backslash‐newline appears to groff as a single input
line. Use this escape sequence to split excessively long
input lines for document maintenance.
Set the ellipsis in roman instead of bold in the few cases where it
wasn't already. As far as I can tell, it is never employed as a literal
in this man page.
Set some Bash literal syntax in bold, not roman, namely command
"$(( ))" and arithmetic "(( ))" substitutions.
Use \(dq special character escape sequence to smuggle a double quote
into paragraph tags that call macros. (All the *roffs I have ready
access to [groff, Heirloom Doctools, DWB 3.3], plus mandoc(1) support
this special character, but Seventh Edition Unix troff does not, and a
grep of Solaris 10 troff suggests it doesn't either. This man page
already uses `aq`, which is no _more_ portable than `dq`--DWB 3.3
supports `aq` on _fewer_ output devices, in fact.)
---
doc/bash.1 | 132 +++++++++++++++++++++++++++++++----------------------
1 file changed, 78 insertions(+), 54 deletions(-)
diff --git a/doc/bash.1 b/doc/bash.1
index 0f6192fc..5484e496 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -559,7 +559,8 @@ .SS Pipelines
The format for a pipeline is:
.RS
.PP
-[\fBtime\fP [\fB\-p\fP]] [ ! ] \fIcommand1\fP [ [\fB|\fP\(bv\fB|&\fP]
\fIcommand2\fP ... ]
+[\fBtime\fP [\fB\-p\fP]] [ ! ] \fIcommand1\fP [ [\fB|\fP\(bv\fB|&\fP]
+\fIcommand2\fP .\|.\|.\& ]
.RE
.PP
The standard output of
@@ -857,7 +858,8 @@ .SS Compound Commands
the entire conditional expression.
.RE
.TP
-\fBfor\fP \fIname\fP [ [ \fBin\fP [ \fIword ...\fP ] ] ; ] \fBdo\fP \fIlist\fP
; \fBdone\fP
+\fBfor\fP \fIname\fP [ [ \fBin\fP [ \fIword .\|.\|.\&\fP ] ] ; ] \
+\fBdo\fP \fIlist\fP ; \fBdone\fP
The list of words following \fBin\fP is expanded, generating a list
of items.
The variable \fIname\fP is set to each element of this list
@@ -919,8 +921,9 @@ .SS Compound Commands
.IR list ,
or zero if no commands were executed.
.TP
-\fBcase\fP \fIword\fP \fBin\fP [ [(] \fIpattern\fP [ \fB|\fP \fIpattern\fP ] \
-... ) \fIlist\fP ;; ] ... \fBesac\fP
+\fBcase\fP \fIword\fP \fBin\fP [ [(] \fIpattern\fP \
+[ \fB|\fP \fIpattern\fP ] .\|.\|.\& ) \fIlist\fP ;; ] .\|.\|.\& \
+\fBesac\fP
A \fBcase\fP command first expands \fIword\fP, and tries to match
it against each \fIpattern\fP in turn, using the matching rules
described under
@@ -950,7 +953,7 @@ .SS Compound Commands
last command executed in \fIlist\fP.
.TP
\fBif\fP \fIlist\fP; \fBthen\fP \fIlist\fP; \
-[ \fBelif\fP \fIlist\fP; \fBthen\fP \fIlist\fP; ] ... \
+[ \fBelif\fP \fIlist\fP; \fBthen\fP \fIlist\fP; ] .\|.\|.\& \
[ \fBelse\fP \fIlist\fP; ] \fBfi\fP
The
.B if
@@ -1319,8 +1322,9 @@ .SH PARAMETERS
.B integer
attribute set, then
.I value
-is evaluated as an arithmetic expression even if the $((...)) expansion is
-not used (see
+is evaluated as an arithmetic expression even if the
+.BR $(( .\|.\|.\& ))
+expansion is not used (see
.B "Arithmetic Expansion"
below).
Word splitting and pathname expansion are not performed.
@@ -1427,7 +1431,7 @@ .SS Special Parameters
.SM
.B IFS
special variable. That is, "\fB$*\fP" is equivalent
-to "\fB$1\fP\fIc\fP\fB$2\fP\fIc\fP\fB...\fP", where
+to "\fB$1\fP\fIc\fP\fB$2\fP\fIc\fP.\|.\|.", where
.I c
is the first character of the value of the
.SM
@@ -1452,7 +1456,7 @@ .SS Special Parameters
When the
expansion occurs within double quotes, each parameter expands to a
separate word. That is, "\fB$@\fP" is equivalent to
-"\fB$1\fP"\ "\fB$2\fP"\ ...
+"\fB$1\fP"\ "\fB$2\fP"\ .\|.\|.
If the double-quoted expansion occurs within a word, the expansion of
the first parameter is joined with the beginning part of the original
word, and the expansion of the last parameter is joined with the last
@@ -2838,7 +2842,7 @@ .SS Arrays
builtins. Each attribute applies to all members of an array.
.PP
Arrays are assigned to using compound assignments of the form
-\fIname\fP=\fB(\fPvalue\fI1\fP ... value\fIn\fP\fB)\fP, where each
+\fIname\fP=\fB(\fPvalue\fI1\fP .\|.\|.\& value\fIn\fP\fB)\fP, where each
\fIvalue\fP may be of the form [\fIsubscript\fP]=\fIstring\fP.
Indexed array assignments do not require anything but \fIstring\fP.
Each \fIvalue\fP in the list is expanded using the shell expansions
@@ -2858,9 +2862,10 @@ .SS Arrays
may be either assignment statements, for which the subscript is required,
or a list of words that is interpreted as a sequence of alternating keys
and values:
-\fIname\fP=\fB( \fP\fIkey1 value1 key2 value2\fP ...\fB)\fP.
+\fIname\fP=\fB( \fP\fIkey1 value1 key2 value2\fP .\|.\|.\&\fB)\fP.
These are treated identically to
-\fIname\fP=\fB(\fP [\fIkey1\fP]=\fIvalue1\fP [\fIkey2\fP]=\fIvalue2\fP
...\fB)\fP.
+\fIname\fP=\fB(\fP [\fIkey1\fP]=\fIvalue1\fP [\fIkey2\fP]=\fIvalue2\fP
+\&.\|.\|.\&\fB)\fP.
The first word in the list determines how the remaining words
are interpreted; all assignments in a list must be of the same type.
When using key/value pairs, the keys may not be missing or empty;
@@ -3600,7 +3605,8 @@ .SS Parameter Expansion
.TP
.B E
The expansion is a string that is the value of \fIparameter\fP with backslash
-escape sequences expanded as with the \fB$\(aq...\(aq\fP quoting mechanism.
+escape sequences expanded as with the \fB$\(aq\fP.\|.\|.\%\fB\(aq\fP
+quoting mechanism.
.TP
.B P
The expansion is a string that is the result of expanding the value of
@@ -4034,7 +4040,7 @@ .SS Pathname Expansion
.B ?
Matches any single character.
.TP
-.B [...]
+.BR [ .\|.\|. ]
Matches any one of the enclosed characters.
A pair of characters separated by a hyphen denotes a
\fIrange expression\fP;
@@ -6904,7 +6910,7 @@ .SS Commands for Changing Text
.B tab\-insert (C\-v TAB)
Insert a tab character.
.TP
-.B "self\-insert (a, b, A, 1, !, ...)"
+.B "self\-insert (a, b, A, 1, !, \fR.\|.\|.\fP)"
Insert the character typed.
.TP
.B transpose\-chars (C\-t)
@@ -7016,7 +7022,7 @@ .SS Killing and Yanking
.SS Numeric Arguments
.PD 0
.TP
-.B digit\-argument (M\-0, M\-1, ..., M\-\-)
+.B digit\-argument (M\-0, M\-1, \fR.\|.\|.\fP, M\-\-)
Add this digit to the argument already accumulating, or start a new
argument. M\-\- starts a negative argument.
.TP
@@ -7168,7 +7174,7 @@ .SS Miscellaneous
ring the terminal's bell (subject to the setting of
.BR bell\-style ).
.TP
-.B do\-lowercase\-version (M\-A, M\-B, M\-\fIx\fP, ...)
+.B do\-lowercase\-version (M\-A, M\-B, M\-\fIx\fP, \fR.\|.\|.\fP)
If the metafied character \fIx\fP is uppercase, run the command
that is bound to the corresponding metafied lowercase character.
The behavior is undefined if \fIx\fP is already lowercase.
@@ -7994,7 +8000,7 @@ .SH "SHELL BUILTIN COMMANDS"
.I filename
is not found or cannot be read.
.TP
-\fBalias\fP [\fB\-p\fP] [\fIname\fP[=\fIvalue\fP] ...]
+\fBalias\fP [\fB\-p\fP] [\fIname\fP[=\fIvalue\fP] .\|.\|.]
\fBAlias\fP with no arguments or with the
.B \-p
option prints the list of aliases in the form
@@ -8008,7 +8014,7 @@ .SH "SHELL BUILTIN COMMANDS"
\fBAlias\fP returns true unless a \fIname\fP is given for which
no alias has been defined.
.TP
-\fBbg\fP [\fIjobspec\fP ...]
+\fBbg\fP [\fIjobspec\fP .\|.\|.]
Resume each suspended job \fIjobspec\fP in the background, as if it
had been started with
.BR & .
@@ -8271,7 +8277,7 @@ .SH "SHELL BUILTIN COMMANDS"
The return value is true if the directory was successfully changed;
false otherwise.
.TP
-\fBcommand\fP [\fB\-pVv\fP] \fIcommand\fP [\fIarg\fP ...]
+\fBcommand\fP [\fB\-pVv\fP] \fIcommand\fP [\fIarg\fP .\|.\|.]
Run
.I command
with
@@ -8348,10 +8354,11 @@ .SH "SHELL BUILTIN COMMANDS"
.br
[\fB\-G\fP \fIglobpat\fP] [\fB\-W\fP \fIwordlist\fP] [\fB\-F\fP
\fIfunction\fP] [\fB\-C\fP \fIcommand\fP]
.br
-[\fB\-X\fP \fIfilterpat\fP] [\fB\-P\fP \fIprefix\fP] [\fB\-S\fP \fIsuffix\fP]
\fIname\fP [\fIname ...\fP]
+[\fB\-X\fP \fIfilterpat\fP] [\fB\-P\fP \fIprefix\fP] \
+[\fB\-S\fP \fIsuffix\fP] \fIname\fP [\fIname\fP .\|.\|.]
.PD 0
.TP
-\fBcomplete\fP \fB\-pr\fP [\fB\-DEI\fP] [\fIname\fP ...]
+\fBcomplete\fP \fB\-pr\fP [\fB\-DEI\fP] [\fIname\fP .\|.\|.]
.PD
Specify how arguments to each \fIname\fP should be completed.
If the \fB\-p\fP option is supplied, or if no options or \fIname\fPs
@@ -8637,10 +8644,12 @@ .SH "SHELL BUILTIN COMMANDS"
loop).
The return value is 0 unless \fIn\fP is not greater than or equal to 1.
.TP
-\fBdeclare\fP [\fB\-aAfFgiIlnrtux\fP] [\fB\-p\fP] [\fIname\fP[=\fIvalue\fP]
...]
+\fBdeclare\fP [\fB\-aAfFgiIlnrtux\fP] [\fB\-p\fP] \
+[\fIname\fP[=\fIvalue\fP] .\|.\|.]
.PD 0
.TP
-\fBtypeset\fP [\fB\-aAfFgiIlnrtux\fP] [\fB\-p\fP] [\fIname\fP[=\fIvalue\fP]
...]
+\fBtypeset\fP [\fB\-aAfFgiIlnrtux\fP] [\fB\-p\fP] \
+[\fIname\fP[=\fIvalue\fP] .\|.\|.]
.PD
Declare variables and/or give them attributes.
If no \fIname\fPs are given then display the values of variables.
@@ -8824,7 +8833,8 @@ .SH "SHELL BUILTIN COMMANDS"
of the directory stack.
.RE
.TP
-\fBdisown\fP [\fB\-ar\fP] [\fB\-h\fP] [\fIjobspec\fP ... | \fIpid\fP ... ]
+\fBdisown\fP [\fB\-ar\fP] [\fB\-h\fP] \
+[\fIjobspec\fP .\|.\|. | \fIpid\fP .\|.\|. ]
Without options, remove each
.I jobspec
from the table of active jobs.
@@ -8853,7 +8863,7 @@ .SH "SHELL BUILTIN COMMANDS"
.I jobspec
does not specify a valid job.
.TP
-\fBecho\fP [\fB\-neE\fP] [\fIarg\fP ...]
+\fBecho\fP [\fB\-neE\fP] [\fIarg\fP .\|.\|.]
Output the \fIarg\fPs, separated by spaces, followed by a newline.
The return status is 0 unless a write error occurs.
If \fB\-n\fP is specified, the trailing newline is
@@ -8923,7 +8933,8 @@ .SH "SHELL BUILTIN COMMANDS"
.PD
.RE
.TP
-\fBenable\fP [\fB\-a\fP] [\fB\-dnps\fP] [\fB\-f\fP \fIfilename\fP] [\fIname\fP
...]
+\fBenable\fP [\fB\-a\fP] [\fB\-dnps\fP] [\fB\-f\fP \fIfilename\fP] \
+[\fIname\fP .\|.\|.]
Enable and disable builtin shell commands.
Disabling a builtin allows a disk command which has the same name
as a shell builtin to be executed without specifying a full pathname,
@@ -8974,7 +8985,7 @@ .SH "SHELL BUILTIN COMMANDS"
is not a shell builtin or there is an error loading a new builtin
from a shared object.
.TP
-\fBeval\fP [\fIarg\fP ...]
+\fBeval\fP [\fIarg\fP .\|.\|.]
The \fIarg\fPs are read and concatenated together into a single
command. This command is then read and executed by the shell, and
its exit status is returned as the value of
@@ -9034,7 +9045,7 @@ .SH "SHELL BUILTIN COMMANDS"
.B EXIT
is executed before the shell terminates.
.TP
-\fBexport\fP [\fB\-fn\fP\^] [\fIname\fP[=\fIword\fP]] ...
+\fBexport\fP [\fB\-fn\fP\^] [\fIname\fP[=\fIword\fP]] .\|.\|.
.PD 0
.TP
.B export \-p
@@ -9181,7 +9192,7 @@ .SH "SHELL BUILTIN COMMANDS"
.I jobspec
specifies a job that was started without job control.
.TP
-\fBgetopts\fP \fIoptstring\fP \fIname\fP [\fIarg ...\fP]
+\fBgetopts\fP \fIoptstring\fP \fIname\fP [\fIarg\fP .\|.\|.]
.B getopts
is used by shell procedures to parse positional parameters.
.I optstring
@@ -9361,9 +9372,9 @@ .SH "SHELL BUILTIN COMMANDS"
.TP
\fBhistory\fP \fB\-anrw\fP [\fIfilename\fP]
.TP
-\fBhistory\fP \fB\-p\fP \fIarg\fP [\fIarg ...\fP]
+\fBhistory\fP \fB\-p\fP \fIarg\fP [\fIarg\fP .\|.\|.]
.TP
-\fBhistory\fP \fB\-s\fP \fIarg\fP [\fIarg ...\fP]
+\fBhistory\fP \fB\-s\fP \fIarg\fP [\fIarg\fP .\|.\|.]
.PD
With no options, display the command
history list with line numbers. Lines listed
@@ -9464,10 +9475,10 @@ .SH "SHELL BUILTIN COMMANDS"
history expansion supplied as an argument to \fB\-p\fP fails.
.RE
.TP
-\fBjobs\fP [\fB\-lnprs\fP] [ \fIjobspec\fP ... ]
+\fBjobs\fP [\fB\-lnprs\fP] [ \fIjobspec\fP .\|.\|. ]
.PD 0
.TP
-\fBjobs\fP \fB\-x\fP \fIcommand\fP [ \fIargs\fP ... ]
+\fBjobs\fP \fB\-x\fP \fIcommand\fP [ \fIargs\fP .\|.\|. ]
.PD
The first form lists the active jobs. The options have the following
meanings:
@@ -9518,7 +9529,8 @@ .SH "SHELL BUILTIN COMMANDS"
returning its exit status.
.RE
.TP
-\fBkill\fP [\fB\-s\fP \fIsigspec\fP | \fB\-n\fP \fIsignum\fP |
\fB\-\fP\fIsigspec\fP] [\fIpid\fP | \fIjobspec\fP] ...
+\fBkill\fP [\fB\-s\fP \fIsigspec\fP | \fB\-n\fP \fIsignum\fP |
\fB\-\fP\fIsigspec\fP] \
+[\fIpid\fP | \fIjobspec\fP] .\|.\|.
.PD 0
.TP
\fBkill\fP \fB\-l\fP|\fB\-L\fP [\fIsigspec\fP | \fIexit_status\fP]
@@ -9565,7 +9577,7 @@ .SH "SHELL BUILTIN COMMANDS"
returns true if at least one signal was successfully sent, or false
if an error occurs or an invalid option is encountered.
.TP
-\fBlet\fP \fIarg\fP [\fIarg\fP ...]
+\fBlet\fP \fIarg\fP [\fIarg\fP .\|.\|.]
Each
.I arg
is an arithmetic expression to be evaluated (see
@@ -9579,7 +9591,7 @@ .SH "SHELL BUILTIN COMMANDS"
.B let
returns 1; 0 is returned otherwise.
.TP
-\fBlocal\fP [\fIoption\fP] [\fIname\fP[=\fIvalue\fP] ... | \- ]
+\fBlocal\fP [\fIoption\fP] [\fIname\fP[=\fIvalue\fP] .\|.\|. | \- ]
For each argument, a local variable named
.I name
is created, and assigned
@@ -9898,7 +9910,11 @@ .SH "SHELL BUILTIN COMMANDS"
reading the name of the current directory or an
invalid option is supplied.
.TP
-\fBread\fP [\fB\-Eers\fP] [\fB\-a\fP \fIaname\fP] [\fB\-d\fP \fIdelim\fP]
[\fB\-i\fP \fItext\fP] [\fB\-n\fP \fInchars\fP] [\fB\-N\fP \fInchars\fP]
[\fB\-p\fP \fIprompt\fP] [\fB\-t\fP \fItimeout\fP] [\fB\-u\fP \fIfd\fP]
[\fIname\fP ...]
+\fBread\fP [\fB\-Eers\fP] [\fB\-a\fP \fIaname\fP] \
+[\fB\-d\fP \fIdelim\fP] [\fB\-i\fP \fItext\fP] \
+[\fB\-n\fP \fInchars\fP] [\fB\-N\fP \fInchars\fP] \
+[\fB\-p\fP \fIprompt\fP] [\fB\-t\fP \fItimeout\fP] \
+[\fB\-u\fP \fIfd\fP] [\fIname\fP .\|.\|.]
One line is read from the standard input, or from the file descriptor
\fIfd\fP supplied as an argument to the \fB\-u\fP option,
split into words as described
@@ -10049,7 +10065,8 @@ .SH "SHELL BUILTIN COMMANDS"
or an invalid file descriptor is supplied as the argument to \fB\-u\fP.
.RE
.TP
-\fBreadonly\fP [\fB\-aAf\fP] [\fB\-p\fP] [\fIname\fP[=\fIword\fP] ...]
+\fBreadonly\fP [\fB\-aAf\fP] [\fB\-p\fP] \
+[\fIname\fP[=\fIword\fP] .\|.\|.]
.PD
The given
\fInames\fP are marked readonly; the values of these
@@ -10123,10 +10140,12 @@ .SH "SHELL BUILTIN COMMANDS"
Any command associated with the \fBRETURN\fP trap is executed
before execution resumes after the function or script.
.TP
-\fBset\fP [\fB\-abefhkmnptuvxBCEHPT\fP] [\fB\-o\fP \fIoption\-name\fP]
[\fB\-\-\fP] [\fB\-\fP] [\fIarg\fP ...]
+\fBset\fP [\fB\-abefhkmnptuvxBCEHPT\fP] [\fB\-o\fP \fIoption\-name\fP] \
+[\fB\-\-\fP] [\fB\-\fP] [\fIarg\fP .\|.\|.]
.PD 0
.TP
-\fBset\fP [\fB+abefhkmnptuvxBCEHPT\fP] [\fB+o\fP \fIoption\-name\fP]
[\fB\-\-\fP] [\fB\-\fP] [\fIarg\fP ...]
+\fBset\fP [\fB+abefhkmnptuvxBCEHPT\fP] [\fB+o\fP \fIoption\-name\fP] \
+[\fB\-\-\fP] [\fB\-\fP] [\fIarg\fP .\|.\|.]
.TP
\fBset \-o\fP
.TP
@@ -10143,7 +10162,7 @@ .SH "SHELL BUILTIN COMMANDS"
as values for the positional parameters and are assigned, in order, to
.BR $1 ,
.BR $2 ,
-.B ...
+\&.\|.\|.,
.BR $\fIn\fP .
Options, if specified, have the following meanings:
.RS
@@ -10521,9 +10540,9 @@ .SH "SHELL BUILTIN COMMANDS"
.RE
.TP
\fBshift\fP [\fIn\fP]
-The positional parameters from \fIn\fP+1 ... are renamed to
+The positional parameters from \fIn\fP+1 .\|.\|.\& are renamed to
.B $1
-.B ....
+.B .\|.\|..
Parameters represented by the numbers \fB$#\fP
down to \fB$#\fP\-\fIn\fP+1 are unset.
.I n
@@ -10543,7 +10562,7 @@ .SH "SHELL BUILTIN COMMANDS"
.B $#
or less than zero; otherwise 0.
.TP
-\fBshopt\fP [\fB\-pqsu\fP] [\fB\-o\fP] [\fIoptname\fP ...]
+\fBshopt\fP [\fB\-pqsu\fP] [\fB\-o\fP] [\fIoptname\fP .\|.\|.]
Toggle the values of settings controlling optional shell behavior.
The settings can be either those listed below, or, if the
.B \-o
@@ -10997,8 +11016,9 @@ .SH "SHELL BUILTIN COMMANDS"
.B noexpand_translation
If set,
.B bash
-encloses the translated results of $"..." quoting in single quotes
-instead of double quotes.
+encloses the translated results of
+.BR $\(dq .\|.\|.\& \(dq
+quoting in single quotes instead of double quotes.
If the string is not translated, this has no effect.
.TP 8
.B nullglob
@@ -11219,7 +11239,7 @@ .SH "SHELL BUILTIN COMMANDS"
Print the accumulated user and system times for the shell and
for processes run from the shell. The return status is 0.
.TP
-\fBtrap\fP [\fB\-lp\fP] [[\fIaction\fP] \fIsigspec\fP ...]
+\fBtrap\fP [\fB\-lp\fP] [[\fIaction\fP] \fIsigspec\fP .\|.\|.]
The
.I action
is a command that is read and executed when the shell receives
@@ -11364,7 +11384,7 @@ .SH "SHELL BUILTIN COMMANDS"
\fBtrue\fP
Does nothing, returns a 0 status.
.TP
-\fBtype\fP [\fB\-aftpP\fP] \fIname\fP [\fIname\fP ...]
+\fBtype\fP [\fB\-aftpP\fP] \fIname\fP [\fIname\fP .\|.\|.]
With no options,
indicate how each
.I name
@@ -11604,7 +11624,7 @@ .SH "SHELL BUILTIN COMMANDS"
The return status is 0 if the mode was successfully changed or if
no \fImode\fP argument was supplied, and false otherwise.
.TP
-\fBunalias\fP [\-\fBa\fP] [\fIname\fP ...]
+\fBunalias\fP [\-\fBa\fP] [\fIname\fP .\|.\|.]
Remove each \fIname\fP from the list of defined aliases. If
.B \-a
is supplied, all alias definitions are removed. The return
@@ -11612,7 +11632,7 @@ .SH "SHELL BUILTIN COMMANDS"
.I name
is not a defined alias.
.TP
-\fBunset\fP [\-\fBfv\fP] [\-\fBn\fP] [\fIname\fP ...]
+\fBunset\fP [\-\fBfv\fP] [\-\fBn\fP] [\fIname\fP .\|.\|.]
For each
.IR name ,
remove the corresponding variable or function.
@@ -11680,7 +11700,7 @@ .SH "SHELL BUILTIN COMMANDS"
.I name
is readonly or may not be unset.
.TP
-\fBwait\fP [\fB\-fn\fP] [\fP\-p\fP \fIvarname\fP] [\fIid ...\fP]
+\fBwait\fP [\fB\-fn\fP] [\fP\-p\fP \fIvarname\fP] [\fIid\fP .\|.\|.]
Wait for each specified child process and return its termination status.
Each
.I id
@@ -11923,7 +11943,9 @@ .SH "SHELL COMPATIBILITY MODE"
and \fB*\fP differently depending on whether the array is indexed or
associative, and differently than in previous versions.
.IP \(bu
-arithmetic commands ( ((...)) ) and the expressions in an arithmetic for
+arithmetic commands (
+.BR (( .\|.\|.\& ))
+) and the expressions in an arithmetic for
statement can be expanded more than once
.IP \(bu
expressions used as arguments to arithmetic operators in the \fB[[\fP
@@ -11932,7 +11954,9 @@ .SH "SHELL COMPATIBILITY MODE"
the expressions in substring parameter brace expansion can be
expanded more than once
.IP \(bu
-the expressions in the $(( ... )) word expansion can be expanded
+the expressions in the
+.BR $(( .\|.\|.\& ))
+word expansion can be expanded
more than once
.IP \(bu
arithmetic expressions used as indexed array subscripts can be
--
2.30.2
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH v2 04/18] doc/bash.1: improve typography of ellipses,
G. Branden Robinson <=