bug-bash
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]