commit bash-20181123 snapshot

2026-07-12 06:30:50 +02:00 · 2018-12-03 10:29:56 -05:00
parent d61300ec87
commit 0712a90cd8
42 changed files with 3440 additions and 4637 deletions
@@ -5211,8 +5211,8 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
                     displayed only if input is coming from a terminal.
              --rr     Backslash does not act as an escape character.  The back-
                     slash  is considered to be part of the line.  In particu-
-                     lar, a backslash-newline pair may not be used as  a  line
-                     continuation.
+                     lar, a backslash-newline pair may not then be used  as  a
+                     line continuation.
              --ss     Silent mode.  If input is coming from a terminal, charac-
                     ters are not echoed.
              --tt _t_i_m_e_o_u_t
@@ -8036,8 +8036,8 @@ Mark \fIname\fPs for export to subsequent commands via the environment.
 .PP
 Using `+' instead of `\-'
 turns off the attribute instead,
-with the exceptions that \fB+a\fP
-may not be used to destroy an array variable and \fB+r\fP will not
+with the exceptions that \fB+a\fP and \fB+A\fP
+may not be used to destroy array variables and \fB+r\fP will not
 remove the readonly attribute.
 When used in a function,
 .B declare
@@ -9195,7 +9195,7 @@ is displayed only if input is coming from a terminal.
 .B \-r
 Backslash does not act as an escape character.
 The backslash is considered to be part of the line.
-In particular, a backslash-newline pair may not be used as a line
+In particular, a backslash-newline pair may not then be used as a line
 continuation.
 .TP
 .B \-s
@@ -11634,7 +11634,7 @@ is displayed only if input is coming from a terminal.
 <DD>
 Backslash does not act as an escape character.
 The backslash is considered to be part of the line.
-In particular, a backslash-newline pair may not be used as a line
+In particular, a backslash-newline pair may not then be used as a line
 continuation.
 <DT><B>-s</B>

@@ -14022,6 +14022,6 @@ There may be only one active coprocess at a time.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 16 November 2018 09:02:02 EST
+Time: 19 November 2018 15:21:08 EST
 </BODY>
 </HTML>
@@ -3847,8 +3847,8 @@ standard.
     '-r'
          If this option is given, backslash does not act as an escape
          character.  The backslash is considered to be part of the
-          line.  In particular, a backslash-newline pair may not be used
-          as a line continuation.
+          line.  In particular, a backslash-newline pair may not then be
+          used as a line continuation.

     '-s'
          Silent mode.  If input is coming from a terminal, characters
@@ -11732,82 +11732,82 @@ Node: Shell Scripts120604
 Node: Shell Builtin Commands123119
 Node: Bourne Shell Builtins125157
 Node: Bash Builtins145907
-Node: Modifying Shell Behavior174815
-Node: The Set Builtin175160
-Node: The Shopt Builtin185573
-Node: Special Builtins203145
-Node: Shell Variables204124
-Node: Bourne Shell Variables204561
-Node: Bash Variables206665
-Node: Bash Features237125
-Node: Invoking Bash238024
-Node: Bash Startup Files244037
-Node: Interactive Shells249140
-Node: What is an Interactive Shell?249550
-Node: Is this Shell Interactive?250199
-Node: Interactive Shell Behavior251014
-Node: Bash Conditional Expressions254501
-Node: Shell Arithmetic259078
-Node: Aliases261895
-Node: Arrays264515
-Node: The Directory Stack269881
-Node: Directory Stack Builtins270665
-Node: Controlling the Prompt273633
-Node: The Restricted Shell276399
-Node: Bash POSIX Mode278224
-Node: Job Control289157
-Node: Job Control Basics289617
-Node: Job Control Builtins294585
-Node: Job Control Variables299312
-Node: Command Line Editing300468
-Node: Introduction and Notation302139
-Node: Readline Interaction303762
-Node: Readline Bare Essentials304953
-Node: Readline Movement Commands306736
-Node: Readline Killing Commands307696
-Node: Readline Arguments309614
-Node: Searching310658
-Node: Readline Init File312844
-Node: Readline Init File Syntax313991
-Node: Conditional Init Constructs334430
-Node: Sample Init File338626
-Node: Bindable Readline Commands341743
-Node: Commands For Moving342947
-Node: Commands For History344796
-Node: Commands For Text349091
-Node: Commands For Killing352479
-Node: Numeric Arguments354960
-Node: Commands For Completion356099
-Node: Keyboard Macros360290
-Node: Miscellaneous Commands360977
-Node: Readline vi Mode366930
-Node: Programmable Completion367837
-Node: Programmable Completion Builtins375617
-Node: A Programmable Completion Example386310
-Node: Using History Interactively391550
-Node: Bash History Facilities392234
-Node: Bash History Builtins395239
-Node: History Interaction399770
-Node: Event Designators403390
-Node: Word Designators404609
-Node: Modifiers406246
-Node: Installing Bash407648
-Node: Basic Installation408785
-Node: Compilers and Options412043
-Node: Compiling For Multiple Architectures412784
-Node: Installation Names414477
-Node: Specifying the System Type415295
-Node: Sharing Defaults416011
-Node: Operation Controls416684
-Node: Optional Features417642
-Node: Reporting Bugs428160
-Node: Major Differences From The Bourne Shell429354
-Node: GNU Free Documentation License446206
-Node: Indexes471383
-Node: Builtin Index471837
-Node: Reserved Word Index478664
-Node: Variable Index481112
-Node: Function Index496863
-Node: Concept Index510166
+Node: Modifying Shell Behavior174820
+Node: The Set Builtin175165
+Node: The Shopt Builtin185578
+Node: Special Builtins203150
+Node: Shell Variables204129
+Node: Bourne Shell Variables204566
+Node: Bash Variables206670
+Node: Bash Features237130
+Node: Invoking Bash238029
+Node: Bash Startup Files244042
+Node: Interactive Shells249145
+Node: What is an Interactive Shell?249555
+Node: Is this Shell Interactive?250204
+Node: Interactive Shell Behavior251019
+Node: Bash Conditional Expressions254506
+Node: Shell Arithmetic259083
+Node: Aliases261900
+Node: Arrays264520
+Node: The Directory Stack269886
+Node: Directory Stack Builtins270670
+Node: Controlling the Prompt273638
+Node: The Restricted Shell276404
+Node: Bash POSIX Mode278229
+Node: Job Control289162
+Node: Job Control Basics289622
+Node: Job Control Builtins294590
+Node: Job Control Variables299317
+Node: Command Line Editing300473
+Node: Introduction and Notation302144
+Node: Readline Interaction303767
+Node: Readline Bare Essentials304958
+Node: Readline Movement Commands306741
+Node: Readline Killing Commands307701
+Node: Readline Arguments309619
+Node: Searching310663
+Node: Readline Init File312849
+Node: Readline Init File Syntax313996
+Node: Conditional Init Constructs334435
+Node: Sample Init File338631
+Node: Bindable Readline Commands341748
+Node: Commands For Moving342952
+Node: Commands For History344801
+Node: Commands For Text349096
+Node: Commands For Killing352484
+Node: Numeric Arguments354965
+Node: Commands For Completion356104
+Node: Keyboard Macros360295
+Node: Miscellaneous Commands360982
+Node: Readline vi Mode366935
+Node: Programmable Completion367842
+Node: Programmable Completion Builtins375622
+Node: A Programmable Completion Example386315
+Node: Using History Interactively391555
+Node: Bash History Facilities392239
+Node: Bash History Builtins395244
+Node: History Interaction399775
+Node: Event Designators403395
+Node: Word Designators404614
+Node: Modifiers406251
+Node: Installing Bash407653
+Node: Basic Installation408790
+Node: Compilers and Options412048
+Node: Compiling For Multiple Architectures412789
+Node: Installation Names414482
+Node: Specifying the System Type415300
+Node: Sharing Defaults416016
+Node: Operation Controls416689
+Node: Optional Features417647
+Node: Reporting Bugs428165
+Node: Major Differences From The Bourne Shell429359
+Node: GNU Free Documentation License446211
+Node: Indexes471388
+Node: Builtin Index471842
+Node: Reserved Word Index478669
+Node: Variable Index481117
+Node: Function Index496868
+Node: Concept Index510171

 End Tag Table
@@ -5303,7 +5303,7 @@ The prompt is displayed only if input is coming from a terminal.
 <dt><code>-r</code></dt>
 <dd><p>If this option is given, backslash does not act as an escape character.
 The backslash is considered to be part of the line.
-In particular, a backslash-newline pair may not be used as a line
+In particular, a backslash-newline pair may not then be used as a line
 continuation.
 </p>
 </dd>
@@ -3847,8 +3847,8 @@ standard.
     '-r'
          If this option is given, backslash does not act as an escape
          character.  The backslash is considered to be part of the
-          line.  In particular, a backslash-newline pair may not be used
-          as a line continuation.
+          line.  In particular, a backslash-newline pair may not then be
+          used as a line continuation.

     '-s'
          Silent mode.  If input is coming from a terminal, characters
@@ -11732,82 +11732,82 @@ Node: Shell Scripts120604
 Node: Shell Builtin Commands123119
 Node: Bourne Shell Builtins125157
 Node: Bash Builtins145907
-Node: Modifying Shell Behavior174815
-Node: The Set Builtin175160
-Node: The Shopt Builtin185573
-Node: Special Builtins203145
-Node: Shell Variables204124
-Node: Bourne Shell Variables204561
-Node: Bash Variables206665
-Node: Bash Features237125
-Node: Invoking Bash238024
-Node: Bash Startup Files244037
-Node: Interactive Shells249140
-Node: What is an Interactive Shell?249550
-Node: Is this Shell Interactive?250199
-Node: Interactive Shell Behavior251014
-Node: Bash Conditional Expressions254501
-Node: Shell Arithmetic259078
-Node: Aliases261895
-Node: Arrays264515
-Node: The Directory Stack269881
-Node: Directory Stack Builtins270665
-Node: Controlling the Prompt273633
-Node: The Restricted Shell276399
-Node: Bash POSIX Mode278224
-Node: Job Control289157
-Node: Job Control Basics289617
-Node: Job Control Builtins294585
-Node: Job Control Variables299312
-Node: Command Line Editing300468
-Node: Introduction and Notation302139
-Node: Readline Interaction303762
-Node: Readline Bare Essentials304953
-Node: Readline Movement Commands306736
-Node: Readline Killing Commands307696
-Node: Readline Arguments309614
-Node: Searching310658
-Node: Readline Init File312844
-Node: Readline Init File Syntax313991
-Node: Conditional Init Constructs334430
-Node: Sample Init File338626
-Node: Bindable Readline Commands341743
-Node: Commands For Moving342947
-Node: Commands For History344796
-Node: Commands For Text349091
-Node: Commands For Killing352479
-Node: Numeric Arguments354960
-Node: Commands For Completion356099
-Node: Keyboard Macros360290
-Node: Miscellaneous Commands360977
-Node: Readline vi Mode366930
-Node: Programmable Completion367837
-Node: Programmable Completion Builtins375617
-Node: A Programmable Completion Example386310
-Node: Using History Interactively391550
-Node: Bash History Facilities392234
-Node: Bash History Builtins395239
-Node: History Interaction399770
-Node: Event Designators403390
-Node: Word Designators404609
-Node: Modifiers406246
-Node: Installing Bash407648
-Node: Basic Installation408785
-Node: Compilers and Options412043
-Node: Compiling For Multiple Architectures412784
-Node: Installation Names414477
-Node: Specifying the System Type415295
-Node: Sharing Defaults416011
-Node: Operation Controls416684
-Node: Optional Features417642
-Node: Reporting Bugs428160
-Node: Major Differences From The Bourne Shell429354
-Node: GNU Free Documentation License446206
-Node: Indexes471383
-Node: Builtin Index471837
-Node: Reserved Word Index478664
-Node: Variable Index481112
-Node: Function Index496863
-Node: Concept Index510166
+Node: Modifying Shell Behavior174820
+Node: The Set Builtin175165
+Node: The Shopt Builtin185578
+Node: Special Builtins203150
+Node: Shell Variables204129
+Node: Bourne Shell Variables204566
+Node: Bash Variables206670
+Node: Bash Features237130
+Node: Invoking Bash238029
+Node: Bash Startup Files244042
+Node: Interactive Shells249145
+Node: What is an Interactive Shell?249555
+Node: Is this Shell Interactive?250204
+Node: Interactive Shell Behavior251019
+Node: Bash Conditional Expressions254506
+Node: Shell Arithmetic259083
+Node: Aliases261900
+Node: Arrays264520
+Node: The Directory Stack269886
+Node: Directory Stack Builtins270670
+Node: Controlling the Prompt273638
+Node: The Restricted Shell276404
+Node: Bash POSIX Mode278229
+Node: Job Control289162
+Node: Job Control Basics289622
+Node: Job Control Builtins294590
+Node: Job Control Variables299317
+Node: Command Line Editing300473
+Node: Introduction and Notation302144
+Node: Readline Interaction303767
+Node: Readline Bare Essentials304958
+Node: Readline Movement Commands306741
+Node: Readline Killing Commands307701
+Node: Readline Arguments309619
+Node: Searching310663
+Node: Readline Init File312849
+Node: Readline Init File Syntax313996
+Node: Conditional Init Constructs334435
+Node: Sample Init File338631
+Node: Bindable Readline Commands341748
+Node: Commands For Moving342952
+Node: Commands For History344801
+Node: Commands For Text349096
+Node: Commands For Killing352484
+Node: Numeric Arguments354965
+Node: Commands For Completion356104
+Node: Keyboard Macros360295
+Node: Miscellaneous Commands360982
+Node: Readline vi Mode366935
+Node: Programmable Completion367842
+Node: Programmable Completion Builtins375622
+Node: A Programmable Completion Example386315
+Node: Using History Interactively391555
+Node: Bash History Facilities392239
+Node: Bash History Builtins395244
+Node: History Interaction399775
+Node: Event Designators403395
+Node: Word Designators404614
+Node: Modifiers406251
+Node: Installing Bash407653
+Node: Basic Installation408790
+Node: Compilers and Options412048
+Node: Compiling For Multiple Architectures412789
+Node: Installation Names414482
+Node: Specifying the System Type415300
+Node: Sharing Defaults416016
+Node: Operation Controls416689
+Node: Optional Features417647
+Node: Reporting Bugs428165
+Node: Major Differences From The Bourne Shell429359
+Node: GNU Free Documentation License446211
+Node: Indexes471388
+Node: Builtin Index471842
+Node: Reserved Word Index478669
+Node: Variable Index481117
+Node: Function Index496868
+Node: Concept Index510171

 End Tag Table
@@ -1,4 +1,4 @@
-This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2018/MacPorts 2018.47642_1) (preloaded format=pdfetex 2018.9.7)  16 NOV 2018 09:02
+This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2018/MacPorts 2018.47642_1) (preloaded format=pdfetex 2018.9.7)  19 NOV 2018 15:21
 entering extended mode
 restricted \write18 enabled.
 file:line:error style messages enabled.
@@ -295,7 +295,7 @@ s/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fonts/typ
 e1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
 lic/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm
 -super/sfrm1440.pfb>
-Output written on bashref.pdf (184 pages, 753023 bytes).
+Output written on bashref.pdf (184 pages, 753033 bytes).
 PDF statistics:
 2624 PDF objects out of 2984 (max. 8388607)
 2395 compressed objects within 24 object streams
@@ -1,7 +1,7 @@
 %!PS-Adobe-2.0
 %%Creator: dvips(k) 5.998 Copyright 2018 Radical Eye Software
 %%Title: bashref.dvi
-%%CreationDate: Fri Nov 16 14:01:57 2018
+%%CreationDate: Mon Nov 19 20:21:05 2018
 %%Pages: 184
 %%PageOrder: Ascend
 %%BoundingBox: 0 0 612 792
@@ -12,7 +12,7 @@
 %DVIPSWebPage: (www.radicaleye.com)
 %DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
 %DVIPSParameters: dpi=600
-%DVIPSSource:  TeX output 2018.11.16:0901
+%DVIPSSource:  TeX output 2018.11.19:1521
 %%BeginProcSet: tex.pro 0 0
 %!
 /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -12461,26 +12461,27 @@ b(a)h(terminal.)630 3345 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f
 (giv)m(en,)k(bac)m(kslash)d(do)s(es)f(not)h(act)h(as)f(an)f(escap)s(e)h
 (c)m(haracter.)1110 3455 y(The)30 b(bac)m(kslash)i(is)f(considered)g
 (to)h(b)s(e)e(part)h(of)g(the)g(line.)43 b(In)30 b(particular,)i(a)1110
-3565 y(bac)m(kslash-newline)f(pair)f(ma)m(y)h(not)g(b)s(e)f(used)f(as)i
-(a)g(line)f(con)m(tin)m(uation.)630 3718 y Ft(-s)384
-b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i(coming)g(from)f
-(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 3828
-y(ec)m(ho)s(ed.)630 3981 y Ft(-t)i Fj(timeout)1110 4091
-y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f(failure)i
-(if)g(a)g(complete)h(line)f(of)1110 4200 y(input)26 b(\(or)h(a)g(sp)s
-(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h(is)f(not)g(read)g
-(within)f Fr(time-)1110 4310 y(out)37 b Fu(seconds.)53
-b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n)m(um)m(b)s(er)d
-(with)h(a)h(fractional)1110 4419 y(p)s(ortion)29 b(follo)m(wing)h(the)f
-(decimal)h(p)s(oin)m(t.)40 b(This)29 b(option)g(is)g(only)g(e\013ectiv)
-m(e)j(if)1110 4529 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h
-(terminal,)i(pip)s(e,)e(or)g(other)f(sp)s(ecial)i(\014le;)1110
-4639 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g
-(\014les.)42 b(If)30 b Ft(read)g Fu(times)h(out,)1110
-4748 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)
-m(to)h(the)e(sp)s(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p
-Fu(.)1110 4858 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e
-Fu(returns)f(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110
+3565 y(bac)m(kslash-newline)26 b(pair)e(ma)m(y)h(not)g(then)g(b)s(e)f
+(used)g(as)h(a)g(line)g(con)m(tin)m(uation.)630 3718
+y Ft(-s)384 b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i
+(coming)g(from)f(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110
+3828 y(ec)m(ho)s(ed.)630 3981 y Ft(-t)i Fj(timeout)1110
+4091 y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f
+(failure)i(if)g(a)g(complete)h(line)f(of)1110 4200 y(input)26
+b(\(or)h(a)g(sp)s(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h
+(is)f(not)g(read)g(within)f Fr(time-)1110 4310 y(out)37
+b Fu(seconds.)53 b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n)
+m(um)m(b)s(er)d(with)h(a)h(fractional)1110 4419 y(p)s(ortion)29
+b(follo)m(wing)h(the)f(decimal)h(p)s(oin)m(t.)40 b(This)29
+b(option)g(is)g(only)g(e\013ectiv)m(e)j(if)1110 4529
+y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h(terminal,)i(pip)s(e,)e
+(or)g(other)f(sp)s(ecial)i(\014le;)1110 4639 y(it)31
+b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g(\014les.)42
+b(If)30 b Ft(read)g Fu(times)h(out,)1110 4748 y Ft(read)d
+Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)m(to)h(the)e(sp)s
+(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p Fu(.)1110
+4858 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e Fu(returns)f
+(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110
 4967 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g
 (input)f(is)h(a)m(v)-5 b(ailable)34 b(on)c(the)i(sp)s(eci\014ed)1110
 5077 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46
@@ -4207,8 +4207,8 @@ the environment.
@end table

 Using @samp{+} instead of @samp{-} turns off the attribute instead,
-with the exceptions that @samp{+a}
-may not be used to destroy an array variable and @samp{+r} will not
+with the exceptions that @samp{+a} and @samp{+A}
+may not be used to destroy array variables and @samp{+r} will not
 remove the readonly attribute.
 When used in a function, @code{declare} makes each @var{name} local,
 as with the @code{local} command, unless the @option{-g} option is used.
@@ -4564,7 +4564,7 @@ The prompt is displayed only if input is coming from a terminal.
@item -r
 If this option is given, backslash does not act as an escape character.
 The backslash is considered to be part of the line.
-In particular, a backslash-newline pair may not be used as a line
+In particular, a backslash-newline pair may not then be used as a line
 continuation.

@item -s
@@ -1017,8 +1017,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
                     displayed only if input is coming from a terminal.
              --rr     Backslash does not act as an escape character.  The back-
                     slash  is considered to be part of the line.  In particu-
-                     lar, a backslash-newline pair may not be used as  a  line
-                     continuation.
+                     lar, a backslash-newline pair may not then be used  as  a
+                     line continuation.
              --ss     Silent mode.  If input is coming from a terminal, charac-
                     ters are not echoed.
              --tt _t_i_m_e_o_u_t
@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.3
-%%CreationDate: Fri Nov 16 09:01:51 2018
+%%CreationDate: Mon Nov 19 15:20:58 2018
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%DocumentSuppliedResources: procset grops 1.22 3