fix for EXIT trap in -c command; suspend -f now suspends even if job control is not enabled

2026-07-01 01:20:00 +02:00 · 2022-05-18 09:50:42 -04:00
parent f9ed510acb
commit daff9ecae9
24 changed files with 8106 additions and 8115 deletions
@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Mon May  2 09:00:07 EDT 2022
+.\"	Last Change: Tue May 17 09:34:43 EDT 2022
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2022 May 2" "GNU Bash 5.2"
+.TH BASH 1 "2022 May 17" "GNU Bash 5.2"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -420,12 +420,14 @@ No other startup files are read.
 .PP
 .B Bash
 attempts to determine when it is being run with its standard input
-connected to a network connection, as when executed by the remote shell
-daemon, usually \fIrshd\fP, or the secure shell daemon \fIsshd\fP.
+connected to a network connection, as when executed by
+the historical remote shell daemon, usually \fIrshd\fP,
+or the secure shell daemon \fIsshd\fP.
 If
 .B bash
-determines it is being run in this fashion, it reads and executes
-commands from \fI~/.bashrc\fP, if that file exists and is readable.
+determines it is being run non-interactively in this fashion,
+it reads and executes commands from \fI~/.bashrc\fP,
+if that file exists and is readable.
 It will not do this if invoked as \fBsh\fP.
 The
 .B \-\-norc
@@ -589,8 +591,9 @@ The
 variable may be used to specify the format of
 the time information.
 .PP
-Each command in a multi-command
-pipeline is executed in a \fIsubshell\fP, which is a
+Each command in a multi-command pipeline,
+where pipes are created,
+is executed in a \fIsubshell\fP, which is a
 separate process.
 See
 .SM
@@ -10641,12 +10644,16 @@ by default.
 Suspend the execution of this shell until it receives a
 .SM
 .B SIGCONT
-signal.  A login shell cannot be suspended; the
+signal.  A login shell,
+or a shell without job control enabled,
+cannot be suspended; the
 .B \-f
 option can be used to override this and force the suspension.
-The return status is 0 unless the shell is a login shell and
+The return status is 0 unless the shell is a login shell
+or job control is not enabled
+and
 .B \-f
-is not supplied, or if job control is not enabled.
+is not supplied.
 .TP
 \fBtest\fP \fIexpr\fP
 .PD 0
@@ -3,7 +3,7 @@
 </HEAD>
 <BODY><TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2022 March 11<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2022 May 2<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <BR><A HREF="#index">Index</A>
@@ -787,7 +787,9 @@ variable may be used to specify the format of
 the time information.
 <P>

-Each command in a pipeline is executed in a <I>subshell</I>, which is a
+Each command in a multi-command pipeline,
+where pipes are created,
+is executed in a <I>subshell</I>, which is a
 separate process.
 See
 <FONT SIZE=-1><B>COMMAND EXECUTION ENVIRONMENT</B></FONT>
@@ -4856,7 +4858,9 @@ or a
 <B>^</B>

 then any character not enclosed is matched.
-The sorting order of characters in range expressions is determined by
+The sorting order of characters in range expressions,
+and the characters included in the range,
+are determined by
 the current locale and the values of the
 <FONT SIZE=-1><B>LC_COLLATE</B>

@@ -14677,7 +14681,7 @@ There may be only one active coprocess at a time.
 <HR>
 <TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>GNU Bash 5.2<TH ALIGN=CENTER width=33%>2022 March 11<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>GNU Bash 5.2<TH ALIGN=CENTER width=33%>2022 May 2<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <HR>
@@ -14784,6 +14788,6 @@ There may be only one active coprocess at a time.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 08 April 2022 15:46:17 EDT
+Time: 04 May 2022 15:11:14 EDT
 </BODY>
 </HTML>
@@ -1,9 +1,9 @@
 This is bash.info, produced by makeinfo version 6.8 from bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 5.2, 11 April 2022).
+Bash shell (version 5.2, 2 May 2022).

-   This is Edition 5.2, last updated 11 April 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 2 May 2022, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.2.

   Copyright (C) 1988-2022 Free Software Foundation, Inc.
@@ -26,10 +26,10 @@ Bash Features
 *************

 This text is a brief description of the features that are present in the
-Bash shell (version 5.2, 11 April 2022).  The Bash home page is
+Bash shell (version 5.2, 2 May 2022).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.2, last updated 11 April 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 2 May 2022, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.2.

   Bash contains features that appear in other popular shells, and some
@@ -704,11 +704,12 @@ information.
   If the pipeline is not executed asynchronously (*note Lists::), the
 shell waits for all commands in the pipeline to complete.

-   Each command in a pipeline is executed in its own "subshell", which
-is a separate process (*note Command Execution Environment::).  If the
-'lastpipe' option is enabled using the 'shopt' builtin (*note The Shopt
-Builtin::), the last element of a pipeline may be run by the shell
-process when job control is not active.
+   Each command in a multi-command pipeline, where pipes are created, is
+executed in its own "subshell", which is a separate process (*note
+Command Execution Environment::).  If the 'lastpipe' option is enabled
+using the 'shopt' builtin (*note The Shopt Builtin::), the last element
+of a pipeline may be run by the shell process when job control is not
+active.

   The exit status of a pipeline is the exit status of the last command
 in the pipeline, unless the 'pipefail' option is enabled (*note The Set
@@ -2431,9 +2432,10 @@ characters must be quoted if they are to be matched literally.
     character not enclosed is matched.  A '-' may be matched by
     including it as the first or last character in the set.  A ']' may
     be matched by including it as the first character in the set.  The
-     sorting order of characters in range expressions is determined by
-     the current locale and the values of the 'LC_COLLATE' and 'LC_ALL'
-     shell variables, if set.
+     sorting order of characters in range expressions, and the
+     characters included in the range, are determined by the current
+     locale and the values of the 'LC_COLLATE' and 'LC_ALL' shell
+     variables, if set.

     For example, in the default C locale, '[a-dx-z]' is equivalent to
     '[abcdxyz]'.  Many locales sort characters in dictionary order, and
@@ -12499,138 +12501,138 @@ D.5 Concept Index


 Tag Table:
-Node: Top888
-Node: Introduction2799
-Node: What is Bash?3012
-Node: What is a shell?4123
-Node: Definitions6658
-Node: Basic Shell Features9606
-Node: Shell Syntax10822
-Node: Shell Operation11845
-Node: Quoting13135
-Node: Escape Character14436
-Node: Single Quotes14918
-Node: Double Quotes15263
-Node: ANSI-C Quoting16538
-Node: Locale Translation17845
-Node: Creating Internationalized Scripts19153
-Node: Comments23267
-Node: Shell Commands23882
-Node: Reserved Words24817
-Node: Simple Commands25570
-Node: Pipelines26221
-Node: Lists29177
-Node: Compound Commands30969
-Node: Looping Constructs31978
-Node: Conditional Constructs34470
-Node: Command Grouping48811
-Node: Coprocesses50286
-Node: GNU Parallel52946
-Node: Shell Functions53860
-Node: Shell Parameters61742
-Node: Positional Parameters66127
-Node: Special Parameters67026
-Node: Shell Expansions70237
-Node: Brace Expansion72361
-Node: Tilde Expansion75092
-Node: Shell Parameter Expansion77710
-Node: Command Substitution96058
-Node: Arithmetic Expansion97410
-Node: Process Substitution98375
-Node: Word Splitting99492
-Node: Filename Expansion101433
-Node: Pattern Matching104179
-Node: Quote Removal108784
-Node: Redirections109076
-Node: Executing Commands118733
-Node: Simple Command Expansion119400
-Node: Command Search and Execution121507
-Node: Command Execution Environment123882
-Node: Environment126914
-Node: Exit Status128574
-Node: Signals130355
-Node: Shell Scripts133801
-Node: Shell Builtin Commands136825
-Node: Bourne Shell Builtins138860
-Node: Bash Builtins160318
-Node: Modifying Shell Behavior191171
-Node: The Set Builtin191513
-Node: The Shopt Builtin202111
-Node: Special Builtins218020
-Node: Shell Variables218996
-Node: Bourne Shell Variables219430
-Node: Bash Variables221531
-Node: Bash Features254344
-Node: Invoking Bash255354
-Node: Bash Startup Files261364
-Node: Interactive Shells266464
-Node: What is an Interactive Shell?266871
-Node: Is this Shell Interactive?267517
-Node: Interactive Shell Behavior268329
-Node: Bash Conditional Expressions271955
-Node: Shell Arithmetic276594
-Node: Aliases279535
-Node: Arrays282145
-Node: The Directory Stack288533
-Node: Directory Stack Builtins289314
-Node: Controlling the Prompt293571
-Node: The Restricted Shell296533
-Node: Bash POSIX Mode299140
-Node: Shell Compatibility Mode311061
-Node: Job Control319087
-Node: Job Control Basics319544
-Node: Job Control Builtins324543
-Node: Job Control Variables329940
-Node: Command Line Editing331093
-Node: Introduction and Notation332761
-Node: Readline Interaction334381
-Node: Readline Bare Essentials335569
-Node: Readline Movement Commands337349
-Node: Readline Killing Commands338306
-Node: Readline Arguments340221
-Node: Searching341262
-Node: Readline Init File343445
-Node: Readline Init File Syntax344703
-Node: Conditional Init Constructs367899
-Node: Sample Init File372092
-Node: Bindable Readline Commands375213
-Node: Commands For Moving376414
-Node: Commands For History378462
-Node: Commands For Text383453
-Node: Commands For Killing387099
-Node: Numeric Arguments390129
-Node: Commands For Completion391265
-Node: Keyboard Macros395453
-Node: Miscellaneous Commands396137
-Node: Readline vi Mode402073
-Node: Programmable Completion402977
-Node: Programmable Completion Builtins410754
-Node: A Programmable Completion Example421446
-Node: Using History Interactively426690
-Node: Bash History Facilities427371
-Node: Bash History Builtins430373
-Node: History Interaction435378
-Node: Event Designators438995
-Node: Word Designators440346
-Node: Modifiers442103
-Node: Installing Bash443911
-Node: Basic Installation445045
-Node: Compilers and Options448764
-Node: Compiling For Multiple Architectures449502
-Node: Installation Names451192
-Node: Specifying the System Type453298
-Node: Sharing Defaults454011
-Node: Operation Controls454681
-Node: Optional Features455636
-Node: Reporting Bugs466851
-Node: Major Differences From The Bourne Shell468123
-Node: GNU Free Documentation License484970
-Node: Indexes510144
-Node: Builtin Index510595
-Node: Reserved Word Index517419
-Node: Variable Index519864
-Node: Function Index536635
-Node: Concept Index550416
+Node: Top882
+Node: Introduction2787
+Node: What is Bash?3000
+Node: What is a shell?4111
+Node: Definitions6646
+Node: Basic Shell Features9594
+Node: Shell Syntax10810
+Node: Shell Operation11833
+Node: Quoting13123
+Node: Escape Character14424
+Node: Single Quotes14906
+Node: Double Quotes15251
+Node: ANSI-C Quoting16526
+Node: Locale Translation17833
+Node: Creating Internationalized Scripts19141
+Node: Comments23255
+Node: Shell Commands23870
+Node: Reserved Words24805
+Node: Simple Commands25558
+Node: Pipelines26209
+Node: Lists29205
+Node: Compound Commands30997
+Node: Looping Constructs32006
+Node: Conditional Constructs34498
+Node: Command Grouping48839
+Node: Coprocesses50314
+Node: GNU Parallel52974
+Node: Shell Functions53888
+Node: Shell Parameters61770
+Node: Positional Parameters66155
+Node: Special Parameters67054
+Node: Shell Expansions70265
+Node: Brace Expansion72389
+Node: Tilde Expansion75120
+Node: Shell Parameter Expansion77738
+Node: Command Substitution96086
+Node: Arithmetic Expansion97438
+Node: Process Substitution98403
+Node: Word Splitting99520
+Node: Filename Expansion101461
+Node: Pattern Matching104207
+Node: Quote Removal108861
+Node: Redirections109153
+Node: Executing Commands118810
+Node: Simple Command Expansion119477
+Node: Command Search and Execution121584
+Node: Command Execution Environment123959
+Node: Environment126991
+Node: Exit Status128651
+Node: Signals130432
+Node: Shell Scripts133878
+Node: Shell Builtin Commands136902
+Node: Bourne Shell Builtins138937
+Node: Bash Builtins160395
+Node: Modifying Shell Behavior191248
+Node: The Set Builtin191590
+Node: The Shopt Builtin202188
+Node: Special Builtins218097
+Node: Shell Variables219073
+Node: Bourne Shell Variables219507
+Node: Bash Variables221608
+Node: Bash Features254421
+Node: Invoking Bash255431
+Node: Bash Startup Files261441
+Node: Interactive Shells266541
+Node: What is an Interactive Shell?266948
+Node: Is this Shell Interactive?267594
+Node: Interactive Shell Behavior268406
+Node: Bash Conditional Expressions272032
+Node: Shell Arithmetic276671
+Node: Aliases279612
+Node: Arrays282222
+Node: The Directory Stack288610
+Node: Directory Stack Builtins289391
+Node: Controlling the Prompt293648
+Node: The Restricted Shell296610
+Node: Bash POSIX Mode299217
+Node: Shell Compatibility Mode311138
+Node: Job Control319164
+Node: Job Control Basics319621
+Node: Job Control Builtins324620
+Node: Job Control Variables330017
+Node: Command Line Editing331170
+Node: Introduction and Notation332838
+Node: Readline Interaction334458
+Node: Readline Bare Essentials335646
+Node: Readline Movement Commands337426
+Node: Readline Killing Commands338383
+Node: Readline Arguments340298
+Node: Searching341339
+Node: Readline Init File343522
+Node: Readline Init File Syntax344780
+Node: Conditional Init Constructs367976
+Node: Sample Init File372169
+Node: Bindable Readline Commands375290
+Node: Commands For Moving376491
+Node: Commands For History378539
+Node: Commands For Text383530
+Node: Commands For Killing387176
+Node: Numeric Arguments390206
+Node: Commands For Completion391342
+Node: Keyboard Macros395530
+Node: Miscellaneous Commands396214
+Node: Readline vi Mode402150
+Node: Programmable Completion403054
+Node: Programmable Completion Builtins410831
+Node: A Programmable Completion Example421523
+Node: Using History Interactively426767
+Node: Bash History Facilities427448
+Node: Bash History Builtins430450
+Node: History Interaction435455
+Node: Event Designators439072
+Node: Word Designators440423
+Node: Modifiers442180
+Node: Installing Bash443988
+Node: Basic Installation445122
+Node: Compilers and Options448841
+Node: Compiling For Multiple Architectures449579
+Node: Installation Names451269
+Node: Specifying the System Type453375
+Node: Sharing Defaults454088
+Node: Operation Controls454758
+Node: Optional Features455713
+Node: Reporting Bugs466928
+Node: Major Differences From The Bourne Shell468200
+Node: GNU Free Documentation License485047
+Node: Indexes510221
+Node: Builtin Index510672
+Node: Reserved Word Index517496
+Node: Variable Index519941
+Node: Function Index536712
+Node: Concept Index550493

 End Tag Table

@@ -4,9 +4,9 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <!-- This text is a brief description of the features that are present in
-the Bash shell (version 5.2, 11 April 2022).
+the Bash shell (version 5.2, 17 May 2022).

-This is Edition 5.2, last updated 11 April 2022,
+This is Edition 5.2, last updated 17 May 2022,
 of The GNU Bash Reference Manual,
 for Bash, Version 5.2.

@@ -77,10 +77,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
 <span id="Bash-Features-1"></span><h1 class="top">Bash Features</h1>

 <p>This text is a brief description of the features that are present in
-the Bash shell (version 5.2, 11 April 2022).
+the Bash shell (version 5.2, 17 May 2022).
 The Bash home page is <a href="http://www.gnu.org/software/bash/">http://www.gnu.org/software/bash/</a>.
 </p>
-<p>This is Edition 5.2, last updated 11 April 2022,
+<p>This is Edition 5.2, last updated 17 May 2022,
 of <cite>The GNU Bash Reference Manual</cite>,
 for <code>Bash</code>, Version 5.2.
 </p>
@@ -1104,7 +1104,9 @@ the time information.
 <p>If the pipeline is not executed asynchronously (see <a href="#Lists">Lists of Commands</a>), the
 shell waits for all commands in the pipeline to complete.
 </p>
-<p>Each command in a pipeline is executed in its own <em>subshell</em>, which is a
+<p>Each command in a multi-command pipeline,
+where pipes are created,
+is executed in its own <em>subshell</em>, which is a
 separate process (see <a href="#Command-Execution-Environment">Command Execution Environment</a>).
 If the <code>lastpipe</code> option is enabled using the <code>shopt</code> builtin
 (see <a href="#The-Shopt-Builtin">The Shopt Builtin</a>),
@@ -3307,7 +3309,9 @@ then any character not enclosed is matched.  A &lsquo;<samp>-</samp>&rsquo;
 may be matched by including it as the first or last character
 in the set.  A &lsquo;<samp>]</samp>&rsquo; may be matched by including it as the first
 character in the set.
-The sorting order of characters in range expressions is determined by
+The sorting order of characters in range expressions,
+and the characters included in the range,
+are determined by
 the current locale and the values of the
 <code>LC_COLLATE</code> and <code>LC_ALL</code> shell variables, if set.
 </p>
@@ -7987,10 +7991,12 @@ No other startup files are read.
 <span id="Invoked-by-remote-shell-daemon"></span><h4 class="subsubheading">Invoked by remote shell daemon</h4>

 <p>Bash attempts to determine when it is being run with its standard input
-connected to a network connection, as when executed by the remote shell
-daemon, usually <code>rshd</code>, or the secure shell daemon <code>sshd</code>.
-If Bash determines it is being run in
-this fashion, it reads and executes commands from <samp>~/.bashrc</samp>, if that
+connected to a network connection, as when executed by
+the historical remote shell daemon, usually <code>rshd</code>,
+or the secure shell daemon <code>sshd</code>.
+If Bash
+determines it is being run non-interactively in this fashion,
+it reads and executes commands from <samp>~/.bashrc</samp>, if that
 file exists and is readable.
 It will not do this if invoked as <code>sh</code>.
 The <samp>--norc</samp> option may be used to inhibit this behavior, and the
@@ -9865,9 +9871,17 @@ argument restricts operation to running jobs.

 <p>Suspend the execution of this shell until it receives a
 <code>SIGCONT</code> signal.
-A login shell cannot be suspended; the <samp>-f</samp>
+A login shell,
+or a shell without job control enabled,
+cannot be suspended; the <samp>-f</samp>
 option can be used to override this and force the suspension.
-</p></dd>
+The return status is 0 unless the shell is a login shell
+or job control is not enabled
+and
+<samp>-f</samp>
+is not supplied.
+</p>
+</dd>
 </dl>

 <p>When job control is not active, the <code>kill</code> and <code>wait</code>
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.8 from
 bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 5.2, 11 April 2022).
+Bash shell (version 5.2, 17 May 2022).

-   This is Edition 5.2, last updated 11 April 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 17 May 2022, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.2.

   Copyright (C) 1988-2022 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
 *************

 This text is a brief description of the features that are present in the
-Bash shell (version 5.2, 11 April 2022).  The Bash home page is
+Bash shell (version 5.2, 17 May 2022).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.2, last updated 11 April 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 17 May 2022, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.2.

   Bash contains features that appear in other popular shells, and some
@@ -705,11 +705,12 @@ information.
   If the pipeline is not executed asynchronously (*note Lists::), the
 shell waits for all commands in the pipeline to complete.

-   Each command in a pipeline is executed in its own "subshell", which
-is a separate process (*note Command Execution Environment::).  If the
-'lastpipe' option is enabled using the 'shopt' builtin (*note The Shopt
-Builtin::), the last element of a pipeline may be run by the shell
-process when job control is not active.
+   Each command in a multi-command pipeline, where pipes are created, is
+executed in its own "subshell", which is a separate process (*note
+Command Execution Environment::).  If the 'lastpipe' option is enabled
+using the 'shopt' builtin (*note The Shopt Builtin::), the last element
+of a pipeline may be run by the shell process when job control is not
+active.

   The exit status of a pipeline is the exit status of the last command
 in the pipeline, unless the 'pipefail' option is enabled (*note The Set
@@ -2432,9 +2433,10 @@ characters must be quoted if they are to be matched literally.
     character not enclosed is matched.  A '-' may be matched by
     including it as the first or last character in the set.  A ']' may
     be matched by including it as the first character in the set.  The
-     sorting order of characters in range expressions is determined by
-     the current locale and the values of the 'LC_COLLATE' and 'LC_ALL'
-     shell variables, if set.
+     sorting order of characters in range expressions, and the
+     characters included in the range, are determined by the current
+     locale and the values of the 'LC_COLLATE' and 'LC_ALL' shell
+     variables, if set.

     For example, in the default C locale, '[a-dx-z]' is equivalent to
     '[abcdxyz]'.  Many locales sort characters in dictionary order, and
@@ -6147,14 +6149,15 @@ Invoked by remote shell daemon
 ..............................

 Bash attempts to determine when it is being run with its standard input
-connected to a network connection, as when executed by the remote shell
-daemon, usually 'rshd', or the secure shell daemon 'sshd'.  If Bash
-determines it is being run in this fashion, it reads and executes
-commands from '~/.bashrc', if that file exists and is readable.  It will
-not do this if invoked as 'sh'.  The '--norc' option may be used to
-inhibit this behavior, and the '--rcfile' option may be used to force
-another file to be read, but neither 'rshd' nor 'sshd' generally invoke
-the shell with those options or allow them to be specified.
+connected to a network connection, as when executed by the historical
+remote shell daemon, usually 'rshd', or the secure shell daemon 'sshd'.
+If Bash determines it is being run non-interactively in this fashion, it
+reads and executes commands from '~/.bashrc', if that file exists and is
+readable.  It will not do this if invoked as 'sh'.  The '--norc' option
+may be used to inhibit this behavior, and the '--rcfile' option may be
+used to force another file to be read, but neither 'rshd' nor 'sshd'
+generally invoke the shell with those options or allow them to be
+specified.

 Invoked with unequal effective and real UID/GIDs
 ................................................
@@ -7651,8 +7654,11 @@ File: bashref.info,  Node: Job Control Builtins,  Next: Job Control Variables,
          suspend [-f]

     Suspend the execution of this shell until it receives a 'SIGCONT'
-     signal.  A login shell cannot be suspended; the '-f' option can be
-     used to override this and force the suspension.
+     signal.  A login shell, or a shell without job control enabled,
+     cannot be suspended; the '-f' option can be used to override this
+     and force the suspension.  The return status is 0 unless the shell
+     is a login shell or job control is not enabled and '-f' is not
+     supplied.

   When job control is not active, the 'kill' and 'wait' builtins do not
 accept JOBSPEC arguments.  They must be supplied process IDs.
@@ -12500,138 +12506,138 @@ D.5 Concept Index


 Tag Table:
-Node: Top891
-Node: Introduction2805
-Node: What is Bash?3021
-Node: What is a shell?4135
-Node: Definitions6673
-Node: Basic Shell Features9624
-Node: Shell Syntax10843
-Node: Shell Operation11869
-Node: Quoting13162
-Node: Escape Character14466
-Node: Single Quotes14951
-Node: Double Quotes15299
-Node: ANSI-C Quoting16577
-Node: Locale Translation17887
-Node: Creating Internationalized Scripts19198
-Node: Comments23315
-Node: Shell Commands23933
-Node: Reserved Words24871
-Node: Simple Commands25627
-Node: Pipelines26281
-Node: Lists29240
-Node: Compound Commands31035
-Node: Looping Constructs32047
-Node: Conditional Constructs34542
-Node: Command Grouping48886
-Node: Coprocesses50364
-Node: GNU Parallel53027
-Node: Shell Functions53944
-Node: Shell Parameters61829
-Node: Positional Parameters66217
-Node: Special Parameters67119
-Node: Shell Expansions70333
-Node: Brace Expansion72460
-Node: Tilde Expansion75194
-Node: Shell Parameter Expansion77815
-Node: Command Substitution96166
-Node: Arithmetic Expansion97521
-Node: Process Substitution98489
-Node: Word Splitting99609
-Node: Filename Expansion101553
-Node: Pattern Matching104302
-Node: Quote Removal108910
-Node: Redirections109205
-Node: Executing Commands118865
-Node: Simple Command Expansion119535
-Node: Command Search and Execution121645
-Node: Command Execution Environment124023
-Node: Environment127058
-Node: Exit Status128721
-Node: Signals130505
-Node: Shell Scripts133954
-Node: Shell Builtin Commands136981
-Node: Bourne Shell Builtins139019
-Node: Bash Builtins160480
-Node: Modifying Shell Behavior191336
-Node: The Set Builtin191681
-Node: The Shopt Builtin202282
-Node: Special Builtins218194
-Node: Shell Variables219173
-Node: Bourne Shell Variables219610
-Node: Bash Variables221714
-Node: Bash Features254530
-Node: Invoking Bash255543
-Node: Bash Startup Files261556
-Node: Interactive Shells266659
-Node: What is an Interactive Shell?267069
-Node: Is this Shell Interactive?267718
-Node: Interactive Shell Behavior268533
-Node: Bash Conditional Expressions272162
-Node: Shell Arithmetic276804
-Node: Aliases279748
-Node: Arrays282361
-Node: The Directory Stack288752
-Node: Directory Stack Builtins289536
-Node: Controlling the Prompt293796
-Node: The Restricted Shell296761
-Node: Bash POSIX Mode299371
-Node: Shell Compatibility Mode311295
-Node: Job Control319324
-Node: Job Control Basics319784
-Node: Job Control Builtins324786
-Node: Job Control Variables330186
-Node: Command Line Editing331342
-Node: Introduction and Notation333013
-Node: Readline Interaction334636
-Node: Readline Bare Essentials335827
-Node: Readline Movement Commands337610
-Node: Readline Killing Commands338570
-Node: Readline Arguments340488
-Node: Searching341532
-Node: Readline Init File343718
-Node: Readline Init File Syntax344979
-Node: Conditional Init Constructs368178
-Node: Sample Init File372374
-Node: Bindable Readline Commands375498
-Node: Commands For Moving376702
-Node: Commands For History378753
-Node: Commands For Text383747
-Node: Commands For Killing387396
-Node: Numeric Arguments390429
-Node: Commands For Completion391568
-Node: Keyboard Macros395759
-Node: Miscellaneous Commands396446
-Node: Readline vi Mode402385
-Node: Programmable Completion403292
-Node: Programmable Completion Builtins411072
-Node: A Programmable Completion Example421767
-Node: Using History Interactively427014
-Node: Bash History Facilities427698
-Node: Bash History Builtins430703
-Node: History Interaction435711
-Node: Event Designators439331
-Node: Word Designators440685
-Node: Modifiers442445
-Node: Installing Bash444256
-Node: Basic Installation445393
-Node: Compilers and Options449115
-Node: Compiling For Multiple Architectures449856
-Node: Installation Names451549
-Node: Specifying the System Type453658
-Node: Sharing Defaults454374
-Node: Operation Controls455047
-Node: Optional Features456005
-Node: Reporting Bugs467223
-Node: Major Differences From The Bourne Shell468498
-Node: GNU Free Documentation License485348
-Node: Indexes510525
-Node: Builtin Index510979
-Node: Reserved Word Index517806
-Node: Variable Index520254
-Node: Function Index537028
-Node: Concept Index550812
+Node: Top887
+Node: Introduction2797
+Node: What is Bash?3013
+Node: What is a shell?4127
+Node: Definitions6665
+Node: Basic Shell Features9616
+Node: Shell Syntax10835
+Node: Shell Operation11861
+Node: Quoting13154
+Node: Escape Character14458
+Node: Single Quotes14943
+Node: Double Quotes15291
+Node: ANSI-C Quoting16569
+Node: Locale Translation17879
+Node: Creating Internationalized Scripts19190
+Node: Comments23307
+Node: Shell Commands23925
+Node: Reserved Words24863
+Node: Simple Commands25619
+Node: Pipelines26273
+Node: Lists29272
+Node: Compound Commands31067
+Node: Looping Constructs32079
+Node: Conditional Constructs34574
+Node: Command Grouping48918
+Node: Coprocesses50396
+Node: GNU Parallel53059
+Node: Shell Functions53976
+Node: Shell Parameters61861
+Node: Positional Parameters66249
+Node: Special Parameters67151
+Node: Shell Expansions70365
+Node: Brace Expansion72492
+Node: Tilde Expansion75226
+Node: Shell Parameter Expansion77847
+Node: Command Substitution96198
+Node: Arithmetic Expansion97553
+Node: Process Substitution98521
+Node: Word Splitting99641
+Node: Filename Expansion101585
+Node: Pattern Matching104334
+Node: Quote Removal108991
+Node: Redirections109286
+Node: Executing Commands118946
+Node: Simple Command Expansion119616
+Node: Command Search and Execution121726
+Node: Command Execution Environment124104
+Node: Environment127139
+Node: Exit Status128802
+Node: Signals130586
+Node: Shell Scripts134035
+Node: Shell Builtin Commands137062
+Node: Bourne Shell Builtins139100
+Node: Bash Builtins160561
+Node: Modifying Shell Behavior191417
+Node: The Set Builtin191762
+Node: The Shopt Builtin202363
+Node: Special Builtins218275
+Node: Shell Variables219254
+Node: Bourne Shell Variables219691
+Node: Bash Variables221795
+Node: Bash Features254611
+Node: Invoking Bash255624
+Node: Bash Startup Files261637
+Node: Interactive Shells266768
+Node: What is an Interactive Shell?267178
+Node: Is this Shell Interactive?267827
+Node: Interactive Shell Behavior268642
+Node: Bash Conditional Expressions272271
+Node: Shell Arithmetic276913
+Node: Aliases279857
+Node: Arrays282470
+Node: The Directory Stack288861
+Node: Directory Stack Builtins289645
+Node: Controlling the Prompt293905
+Node: The Restricted Shell296870
+Node: Bash POSIX Mode299480
+Node: Shell Compatibility Mode311404
+Node: Job Control319433
+Node: Job Control Basics319893
+Node: Job Control Builtins324895
+Node: Job Control Variables330465
+Node: Command Line Editing331621
+Node: Introduction and Notation333292
+Node: Readline Interaction334915
+Node: Readline Bare Essentials336106
+Node: Readline Movement Commands337889
+Node: Readline Killing Commands338849
+Node: Readline Arguments340767
+Node: Searching341811
+Node: Readline Init File343997
+Node: Readline Init File Syntax345258
+Node: Conditional Init Constructs368457
+Node: Sample Init File372653
+Node: Bindable Readline Commands375777
+Node: Commands For Moving376981
+Node: Commands For History379032
+Node: Commands For Text384026
+Node: Commands For Killing387675
+Node: Numeric Arguments390708
+Node: Commands For Completion391847
+Node: Keyboard Macros396038
+Node: Miscellaneous Commands396725
+Node: Readline vi Mode402664
+Node: Programmable Completion403571
+Node: Programmable Completion Builtins411351
+Node: A Programmable Completion Example422046
+Node: Using History Interactively427293
+Node: Bash History Facilities427977
+Node: Bash History Builtins430982
+Node: History Interaction435990
+Node: Event Designators439610
+Node: Word Designators440964
+Node: Modifiers442724
+Node: Installing Bash444535
+Node: Basic Installation445672
+Node: Compilers and Options449394
+Node: Compiling For Multiple Architectures450135
+Node: Installation Names451828
+Node: Specifying the System Type453937
+Node: Sharing Defaults454653
+Node: Operation Controls455326
+Node: Optional Features456284
+Node: Reporting Bugs467502
+Node: Major Differences From The Bourne Shell468777
+Node: GNU Free Documentation License485627
+Node: Indexes510804
+Node: Builtin Index511258
+Node: Reserved Word Index518085
+Node: Variable Index520533
+Node: Function Index537307
+Node: Concept Index551091

 End Tag Table

@@ -1,9 +1,11 @@
-This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_2) (preloaded format=pdftex 2021.10.21)  12 APR 2022 10:01
+This is pdfTeX, Version 3.141592653-2.6-1.40.24 (TeX Live 2022/MacPorts 2022.62882_0) (preloaded format=pdfetex 2022.5.4)  4 MAY 2022 15:11
 entering extended mode
 restricted \write18 enabled.
+ file:line:error style messages enabled.
 %&-line parsing enabled.
-**/usr/local/src/chet/src/bash/src/doc/bashref.texi
-(/usr/local/src/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
+**\input /usr/local/src/chet/src/bash/src/doc/bashref.texi
+(/usr/local/src/chet/src/bash/src/doc/bashref.texi
+(/usr/local/src/chet/src/bash/src/doc/texinfo.tex
 Loading texinfo [version 2015-11-22.14]:
 \outerhsize=\dimen16
 \outervsize=\dimen17
@@ -159,24 +161,27 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
 texinfo.tex: doing @include of version.texi


-(./version.texi) [1{/opt/local/var/db/texmf/fonts/map/pdftex/updmap/pdftex.map}
-] [2] (./bashref.toc [-1] [-2] [-3]) [-4] (./bashref.toc) (./bashref.toc)
-Chapter 1
+(/usr/local/src/chet/src/bash/src/doc/version.texi) [1{/opt/local/var/db/texmf/
+fonts/map/pdftex/updmap/pdftex.map}] [2]
+(/usr/local/src/chet/src/bash/src/doc/bashref.toc [-1] [-2] [-3]) [-4]
+(/usr/local/src/chet/src/bash/src/doc/bashref.toc)
+(/usr/local/src/chet/src/bash/src/doc/bashref.toc) Chapter 1
 \openout0 = `bashref.toc'.

- (./bashref.aux)
+
+(/usr/local/src/chet/src/bash/src/doc/bashref.aux)
 \openout1 = `bashref.aux'.

 Chapter 2 [1] [2]
@cpindfile=@write2
 \openout2 = `bashref.cp'.

- [3] Chapter 3 [4] [5] [6] [7]
+ [3]
+Chapter 3 [4] [5] [6] [7]
@vrindfile=@write3
 \openout3 = `bashref.vr'.

-
-[8]
+ [8]
 Overfull \hbox (3.12749pt too wide) in paragraph at lines 723--724
 @texttt coproc[]| 

@@ -223,7 +228,7 @@ Overfull \hbox (5.95723pt too wide) in paragraph at lines 724--725

 [48] [49] [50] [51]
 [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66]
-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5215--5215
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5219--5219
 []@texttt set [-abefhkmnptuvxBCEHPT] [-o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 

@@ -236,7 +241,7 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5215--5215
 .etc.


-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5216--5216
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5220--5220
 []@texttt set [+abefhkmnptuvxBCEHPT] [+o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 

@@ -320,7 +325,7 @@ texinfo.tex: doing @include of hsuser.texi
 (/usr/local/src/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
 [151] [152] [153] [154] [155] [156]) Chapter 10 [157] [158] [159] [160]
 [161]
-Underfull \hbox (badness 10000) in paragraph at lines 9348--9357
+Underfull \hbox (badness 10000) in paragraph at lines 9352--9361
 []@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
 entation[]@textrm '[],

@@ -333,7 +338,7 @@ entation[]@textrm '[],
 .etc.


-Underfull \hbox (badness 10000) in paragraph at lines 9348--9357
+Underfull \hbox (badness 10000) in paragraph at lines 9352--9361
@textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
 extrm '[], `@texttt strict-posix-default[]@textrm '[], and

@@ -349,37 +354,38 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
 [171] [172] Appendix C [173]
 texinfo.tex: doing @include of fdl.texi

- (./fdl.texi [174] [175] [176] [177] [178] [179]
-[180]) Appendix D [181] [182] [183] [184] [185] [186] [187] [188] [189]
-[190] ) 
+ (/usr/local/src/chet/src/bash/src/doc/fdl.texi
+[174] [175] [176] [177] [178] [179] [180]) Appendix D [181] [182] [183]
+[184] [185] [186] [187] [188] [189] [190] ) 
 Here is how much of TeX's memory you used:
- 4094 strings out of 497086
- 46987 string characters out of 6206519
- 140408 words of memory out of 5000000
- 4867 multiletter control sequences out of 15000+600000
+ 4094 strings out of 497074
+ 47491 string characters out of 6206289
+ 141494 words of memory out of 5000000
+ 4870 multiletter control sequences out of 15000+600000
 34315 words of font info for 116 fonts, out of 8000000 for 9000
 51 hyphenation exceptions out of 8191
- 16i,6n,16p,323b,978s stack positions out of 5000i,500n,10000p,200000b,80000s
-{/opt/local/share/texmf-texlive/fonts/enc/dvips/cm-super/cm-super-t1.enc
-}</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmbx12.pfb></op
-t/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmcsc10.pfb></opt/lo
-cal/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi10.pfb></opt/local/s
-hare/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi12.pfb></opt/local/share/
-texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi9.pfb></opt/local/share/texmf-
-texlive/fonts/type1/public/amsfonts/cm/cmr10.pfb></opt/local/share/texmf-texliv
-e/fonts/type1/public/amsfonts/cm/cmr9.pfb></opt/local/share/texmf-texlive/fonts
-/type1/public/amsfonts/cm/cmsl10.pfb></opt/local/share/texmf-texlive/fonts/type
-1/public/amsfonts/cm/cmsltt10.pfb></opt/local/share/texmf-texlive/fonts/type1/p
-ublic/amsfonts/cm/cmsy10.pfb></opt/local/share/texmf-texlive/fonts/type1/public
-/amsfonts/cm/cmti10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsf
-onts/cm/cmtt10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/
-cm/cmtt12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cm
-tt9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm-super/sfrm1095.pf
-b></opt/local/share/texmf-texlive/fonts/type1/public/cm-super/sfrm1440.pfb>
-Output written on bashref.pdf (196 pages, 794079 bytes).
+ 16i,6n,16p,330b,978s stack positions out of 10000i,1000n,20000p,200000b,200000s
+{/opt/local/share/texmf-texlive/font
+s/enc/dvips/cm-super/cm-super-t1.enc}</opt/local/share/texmf-texlive/fonts/type
+1/public/amsfonts/cm/cmbx12.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
+lic/amsfonts/cm/cmcsc10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/
+amsfonts/cm/cmmi10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfo
+nts/cm/cmmi12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/c
+m/cmmi9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr1
+0.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr9.pfb><
+/opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsl10.pfb></opt/
+local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsltt10.pfb></opt/loc
+al/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/local/sh
+are/texmf-texlive/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/share/t
+exmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/texmf-
+texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texli
+ve/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fon
+ts/type1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/typ
+e1/public/cm-super/sfrm1440.pfb>
+Output written on bashref.pdf (196 pages, 794067 bytes).
 PDF statistics:
- 2750 PDF objects out of 2984 (max. 8388607)
- 2507 compressed objects within 26 object streams
+ 2752 PDF objects out of 2984 (max. 8388607)
+ 2509 compressed objects within 26 object streams
 324 named destinations out of 1000 (max. 500000)
 1141 words of extra memory for PDF output out of 10000 (max. 10000000)

@@ -1,7 +1,7 @@
 %!PS-Adobe-2.0
-%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software
+%%Creator: dvips(k) 2022.1 (TeX Live 2022)  Copyright 2022 Radical Eye Software
 %%Title: bashref.dvi
-%%CreationDate: Tue Apr 12 14:01:11 2022
+%%CreationDate: Wed May  4 19:11:10 2022
 %%Pages: 196
 %%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 2022.04.12:1001
+%DVIPSSource:  TeX output 2022.05.04:1511
 %%BeginProcSet: tex.pro 0 0
 %!
 /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7614,7 +7614,7 @@ ifelse
 TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5
 b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31
 b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(5.2,)g(for)f
-Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3333 1697 y(April)f(2022)150
+Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3364 1697 y(Ma)m(y)g(2022)150
 4927 y Fs(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46
 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11
 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11
@@ -7622,15 +7622,16 @@ b(oundation)p 150 5141 3600 17 v eop end
 %%Page: 2 2
 TeXDict begin 2 1 bop 150 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f
 (description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
-(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.2,)c(11)f(April)f
-(2022\).)150 4523 y(This)j(is)h(Edition)f(5.2,)j(last)f(up)s(dated)d
-(11)j(April)e(2022,)k(of)d Fr(The)f(GNU)h(Bash)g(Reference)g(Man)m(ual)
-p Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
-b(5.2.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
-y Fq(\015)f Fu(1988{2022)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
-b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h
-(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s
-(cumen)m(t)f(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
+(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.2,)c(2)e(Ma)m(y)i
+(2022\).)150 4523 y(This)38 b(is)g(Edition)h(5.2,)j(last)d(up)s(dated)e
+(2)i(Ma)m(y)h(2022,)j(of)38 b Fr(The)g(GNU)h(Bash)g(Reference)g(Man)m
+(ual)p Fu(,)j(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8
+b(ersion)31 b(5.2.)150 4767 y(Cop)m(yrigh)m(t)602 4764
+y(c)577 4767 y Fq(\015)f Fu(1988{2022)35 b(F)-8 b(ree)31
+b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)390 4902
+y(P)m(ermission)21 b(is)f(gran)m(ted)h(to)g(cop)m(y)-8
+b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s(cumen)m(t)f
+(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
 b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26
 b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 5121 y(published)43
 b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8
@@ -8688,158 +8689,158 @@ y Fk(3.2.3)63 b(Pip)s(elines)150 446 y Fu(A)21 b Ft(pipeline)d
 Fu(is)j(a)g(sequence)g(of)g(one)g(or)g(more)g(commands)f(separated)h(b)
 m(y)g(one)g(of)g(the)g(con)m(trol)h(op)s(erators)150
 555 y(`)p Ft(|)p Fu(')31 b(or)f(`)p Ft(|&)p Fu('.)275
-683 y(The)f(format)i(for)f(a)h(pip)s(eline)f(is)390 810
+695 y(The)f(format)i(for)f(a)h(pip)s(eline)f(is)390 834
 y Ft([time)46 b([-p]])h([!])g Fj(command1)e Ft([)j(|)f(or)g(|&)g
-Fj(command2)f Ft(])h(...)150 938 y Fu(The)25 b(output)f(of)i(eac)m(h)g
+Fj(command2)f Ft(])h(...)150 974 y Fu(The)25 b(output)f(of)i(eac)m(h)g
 (command)f(in)f(the)i(pip)s(eline)e(is)i(connected)g(via)f(a)h(pip)s(e)
-e(to)i(the)f(input)f(of)h(the)h(next)150 1047 y(command.)40
+e(to)i(the)f(input)f(of)h(the)h(next)150 1083 y(command.)40
 b(That)29 b(is,)h(eac)m(h)h(command)e(reads)g(the)h(previous)f
-(command's)g(output.)40 b(This)29 b(connection)150 1157
+(command's)g(output.)40 b(This)29 b(connection)150 1193
 y(is)h(p)s(erformed)f(b)s(efore)h(an)m(y)h(redirections)g(sp)s
-(eci\014ed)f(b)m(y)g Fr(command1)p Fu(.)275 1284 y(If)k(`)p
+(eci\014ed)f(b)m(y)g Fr(command1)p Fu(.)275 1333 y(If)k(`)p
 Ft(|&)p Fu(')h(is)f(used,)i Fr(command1)7 b Fu('s)35
 b(standard)f(error,)i(in)e(addition)h(to)h(its)f(standard)f(output,)i
-(is)e(con-)150 1394 y(nected)h(to)g Fr(command2)7 b Fu('s)35
+(is)e(con-)150 1442 y(nected)h(to)g Fr(command2)7 b Fu('s)35
 b(standard)f(input)f(through)h(the)g(pip)s(e;)i(it)f(is)g(shorthand)e
-(for)h Ft(2>&1)29 b(|)p Fu(.)53 b(This)150 1504 y(implicit)41
+(for)h Ft(2>&1)29 b(|)p Fu(.)53 b(This)150 1552 y(implicit)41
 b(redirection)f(of)g(the)g(standard)f(error)g(to)h(the)g(standard)f
-(output)g(is)h(p)s(erformed)e(after)j(an)m(y)150 1613
+(output)g(is)h(p)s(erformed)e(after)j(an)m(y)150 1661
 y(redirections)31 b(sp)s(eci\014ed)f(b)m(y)g Fr(command1)p
-Fu(.)275 1741 y(The)36 b(reserv)m(ed)g(w)m(ord)g Ft(time)g
+Fu(.)275 1801 y(The)36 b(reserv)m(ed)g(w)m(ord)g Ft(time)g
 Fu(causes)h(timing)g(statistics)h(to)f(b)s(e)f(prin)m(ted)g(for)g(the)h
-(pip)s(eline)f(once)h(it)150 1850 y(\014nishes.)51 b(The)34
+(pip)s(eline)f(once)h(it)150 1910 y(\014nishes.)51 b(The)34
 b(statistics)i(curren)m(tly)e(consist)h(of)f(elapsed)h(\(w)m(all-clo)s
-(c)m(k\))i(time)e(and)f(user)f(and)h(system)150 1960
+(c)m(k\))i(time)e(and)f(user)f(and)h(system)150 2020
 y(time)e(consumed)e(b)m(y)h(the)g(command's)g(execution.)44
 b(The)31 b Ft(-p)f Fu(option)i(c)m(hanges)g(the)f(output)g(format)g(to)
-150 2069 y(that)j(sp)s(eci\014ed)e(b)m(y)h Fm(posix)p
+150 2130 y(that)j(sp)s(eci\014ed)e(b)m(y)h Fm(posix)p
 Fu(.)49 b(When)33 b(the)g(shell)g(is)h(in)e Fm(posix)h
 Fu(mo)s(de)g(\(see)h(Section)g(6.11)g([Bash)g(POSIX)150
-2179 y(Mo)s(de],)j(page)e(106\),)j(it)e(do)s(es)e(not)i(recognize)g
+2239 y(Mo)s(de],)j(page)e(106\),)j(it)e(do)s(es)e(not)i(recognize)g
 Ft(time)e Fu(as)h(a)h(reserv)m(ed)f(w)m(ord)f(if)h(the)g(next)g(tok)m
-(en)h(b)s(egins)150 2289 y(with)d(a)g(`)p Ft(-)p Fu('.)49
+(en)h(b)s(egins)150 2349 y(with)d(a)g(`)p Ft(-)p Fu('.)49
 b(The)33 b Ft(TIMEFORMAT)d Fu(v)-5 b(ariable)34 b(ma)m(y)g(b)s(e)f(set)
 g(to)h(a)g(format)f(string)g(that)h(sp)s(eci\014es)f(ho)m(w)g(the)150
-2398 y(timing)38 b(information)g(should)e(b)s(e)h(displa)m(y)m(ed.)62
+2458 y(timing)38 b(information)g(should)e(b)s(e)h(displa)m(y)m(ed.)62
 b(See)38 b(Section)g(5.2)g([Bash)g(V)-8 b(ariables],)41
-b(page)d(78,)i(for)e(a)150 2508 y(description)27 b(of)g(the)h(a)m(v)-5
+b(page)d(78,)i(for)e(a)150 2568 y(description)27 b(of)g(the)h(a)m(v)-5
 b(ailable)29 b(formats.)40 b(The)26 b(use)h(of)g Ft(time)f
 Fu(as)i(a)f(reserv)m(ed)g(w)m(ord)g(p)s(ermits)f(the)h(timing)150
-2617 y(of)38 b(shell)g(builtins,)i(shell)e(functions,)i(and)d(pip)s
+2677 y(of)38 b(shell)g(builtins,)i(shell)e(functions,)i(and)d(pip)s
 (elines.)63 b(An)38 b(external)h Ft(time)e Fu(command)h(cannot)g(time)
-150 2727 y(these)31 b(easily)-8 b(.)275 2854 y(When)26
+150 2787 y(these)31 b(easily)-8 b(.)275 2927 y(When)26
 b(the)h(shell)g(is)g(in)g Fm(posix)f Fu(mo)s(de)g(\(see)i(Section)f
 (6.11)i([Bash)e(POSIX)f(Mo)s(de],)i(page)g(106\),)h Ft(time)150
-2964 y Fu(ma)m(y)d(b)s(e)f(follo)m(w)m(ed)j(b)m(y)d(a)h(newline.)39
+3036 y Fu(ma)m(y)d(b)s(e)f(follo)m(w)m(ed)j(b)m(y)d(a)h(newline.)39
 b(In)25 b(this)h(case,)i(the)d(shell)h(displa)m(ys)g(the)g(total)h
-(user)e(and)g(system)h(time)150 3073 y(consumed)33 b(b)m(y)h(the)h
+(user)e(and)g(system)h(time)150 3146 y(consumed)33 b(b)m(y)h(the)h
 (shell)f(and)f(its)i(c)m(hildren.)51 b(The)34 b Ft(TIMEFORMAT)d
 Fu(v)-5 b(ariable)35 b(ma)m(y)g(b)s(e)e(used)g(to)i(sp)s(ecify)150
-3183 y(the)c(format)f(of)h(the)f(time)h(information.)275
-3311 y(If)36 b(the)h(pip)s(eline)g(is)g(not)g(executed)h(async)m
+3255 y(the)c(format)f(of)h(the)f(time)h(information.)275
+3395 y(If)36 b(the)h(pip)s(eline)g(is)g(not)g(executed)h(async)m
 (hronously)f(\(see)h(Section)g(3.2.4)g([Lists],)i(page)e(10\),)i(the)
-150 3420 y(shell)31 b(w)m(aits)g(for)f(all)h(commands)f(in)g(the)h(pip)
-s(eline)f(to)h(complete.)275 3548 y(Eac)m(h)e(command)g(in)g(a)g(pip)s
-(eline)g(is)g(executed)h(in)e(its)i(o)m(wn)f Fr(subshell)p
-Fu(,)f(whic)m(h)h(is)g(a)g(separate)h(pro)s(cess)150
-3657 y(\(see)g(Section)g(3.7.3)h([Command)e(Execution)h(En)m(vironmen)m
-(t],)g(page)g(43\).)41 b(If)29 b(the)g Ft(lastpipe)e
-Fu(option)j(is)150 3767 y(enabled)35 b(using)g(the)g
-Ft(shopt)f Fu(builtin)g(\(see)i(Section)g(4.3.2)h([The)e(Shopt)f
-(Builtin],)j(page)f(71\),)i(the)d(last)150 3876 y(elemen)m(t)d(of)e(a)h
-(pip)s(eline)f(ma)m(y)h(b)s(e)f(run)f(b)m(y)h(the)h(shell)f(pro)s(cess)
-g(when)f(job)h(con)m(trol)i(is)f(not)f(activ)m(e.)275
-4004 y(The)24 b(exit)i(status)f(of)h(a)f(pip)s(eline)g(is)g(the)g(exit)
-h(status)f(of)h(the)f(last)h(command)f(in)f(the)i(pip)s(eline,)g
-(unless)150 4113 y(the)31 b Ft(pipefail)d Fu(option)j(is)g(enabled)f
-(\(see)i(Section)f(4.3.1)i([The)d(Set)h(Builtin],)g(page)h(67\).)42
-b(If)30 b Ft(pipefail)150 4223 y Fu(is)f(enabled,)g(the)f(pip)s
-(eline's)g(return)g(status)h(is)f(the)h(v)-5 b(alue)29
-b(of)f(the)h(last)g(\(righ)m(tmost\))i(command)d(to)h(exit)150
-4333 y(with)34 b(a)h(non-zero)g(status,)i(or)d(zero)i(if)e(all)i
-(commands)e(exit)h(successfully)-8 b(.)54 b(If)34 b(the)h(reserv)m(ed)g
-(w)m(ord)f(`)p Ft(!)p Fu(')150 4442 y(precedes)e(the)f(pip)s(eline,)h
-(the)f(exit)i(status)f(is)f(the)h(logical)i(negation)f(of)e(the)h(exit)
-g(status)g(as)g(describ)s(ed)150 4552 y(ab)s(o)m(v)m(e.)63
-b(The)38 b(shell)f(w)m(aits)i(for)e(all)i(commands)e(in)g(the)h(pip)s
-(eline)f(to)h(terminate)h(b)s(efore)e(returning)g(a)150
-4661 y(v)-5 b(alue.)150 4846 y Fk(3.2.4)63 b(Lists)41
-b(of)h(Commands)150 4993 y Fu(A)37 b Ft(list)e Fu(is)i(a)g(sequence)g
-(of)g(one)g(or)f(more)h(pip)s(elines)f(separated)h(b)m(y)g(one)g(of)f
-(the)h(op)s(erators)g(`)p Ft(;)p Fu(',)i(`)p Ft(&)p Fu(',)150
-5103 y(`)p Ft(&&)p Fu(',)31 b(or)f(`)p Ft(||)p Fu(',)g(and)g
-(optionally)i(terminated)f(b)m(y)f(one)h(of)f(`)p Ft(;)p
-Fu(',)h(`)p Ft(&)p Fu(',)g(or)f(a)h Ft(newline)p Fu(.)275
-5230 y(Of)23 b(these)h(list)g(op)s(erators,)i(`)p Ft(&&)p
-Fu(')d(and)g(`)p Ft(||)p Fu(')h(ha)m(v)m(e)h(equal)f(precedence,)i
-(follo)m(w)m(ed)f(b)m(y)f(`)p Ft(;)p Fu(')g(and)f(`)p
-Ft(&)p Fu(',)i(whic)m(h)150 5340 y(ha)m(v)m(e)32 b(equal)e(precedence.)
-p eop end
+150 3504 y(shell)31 b(w)m(aits)g(for)f(all)h(commands)f(in)g(the)h(pip)
+s(eline)f(to)h(complete.)275 3644 y(Eac)m(h)d(command)g(in)f(a)i(m)m
+(ulti-command)f(pip)s(eline,)h(where)e(pip)s(es)g(are)h(created,)i(is)e
+(executed)h(in)f(its)150 3753 y(o)m(wn)h Fr(subshell)p
+Fu(,)f(whic)m(h)h(is)g(a)g(separate)h(pro)s(cess)e(\(see)i(Section)g
+(3.7.3)g([Command)f(Execution)g(En)m(viron-)150 3863
+y(men)m(t],)d(page)e(43\).)40 b(If)23 b(the)h Ft(lastpipe)d
+Fu(option)j(is)g(enabled)g(using)f(the)h Ft(shopt)e Fu(builtin)h(\(see)
+i(Section)f(4.3.2)150 3973 y([The)i(Shopt)f(Builtin],)i(page)g(71\),)h
+(the)e(last)h(elemen)m(t)g(of)f(a)g(pip)s(eline)g(ma)m(y)g(b)s(e)f(run)
+g(b)m(y)g(the)h(shell)g(pro)s(cess)150 4082 y(when)j(job)h(con)m(trol)i
+(is)f(not)f(activ)m(e.)275 4222 y(The)24 b(exit)i(status)f(of)h(a)f
+(pip)s(eline)g(is)g(the)g(exit)h(status)f(of)h(the)f(last)h(command)f
+(in)f(the)i(pip)s(eline,)g(unless)150 4331 y(the)31 b
+Ft(pipefail)d Fu(option)j(is)g(enabled)f(\(see)i(Section)f(4.3.1)i
+([The)d(Set)h(Builtin],)g(page)h(67\).)42 b(If)30 b Ft(pipefail)150
+4441 y Fu(is)f(enabled,)g(the)f(pip)s(eline's)g(return)g(status)h(is)f
+(the)h(v)-5 b(alue)29 b(of)f(the)h(last)g(\(righ)m(tmost\))i(command)d
+(to)h(exit)150 4550 y(with)34 b(a)h(non-zero)g(status,)i(or)d(zero)i
+(if)e(all)i(commands)e(exit)h(successfully)-8 b(.)54
+b(If)34 b(the)h(reserv)m(ed)g(w)m(ord)f(`)p Ft(!)p Fu(')150
+4660 y(precedes)e(the)f(pip)s(eline,)h(the)f(exit)i(status)f(is)f(the)h
+(logical)i(negation)f(of)e(the)h(exit)g(status)g(as)g(describ)s(ed)150
+4770 y(ab)s(o)m(v)m(e.)63 b(The)38 b(shell)f(w)m(aits)i(for)e(all)i
+(commands)e(in)g(the)h(pip)s(eline)f(to)h(terminate)h(b)s(efore)e
+(returning)g(a)150 4879 y(v)-5 b(alue.)150 5083 y Fk(3.2.4)63
+b(Lists)41 b(of)h(Commands)150 5230 y Fu(A)37 b Ft(list)e
+Fu(is)i(a)g(sequence)g(of)g(one)g(or)f(more)h(pip)s(elines)f(separated)
+h(b)m(y)g(one)g(of)f(the)h(op)s(erators)g(`)p Ft(;)p
+Fu(',)i(`)p Ft(&)p Fu(',)150 5340 y(`)p Ft(&&)p Fu(',)31
+b(or)f(`)p Ft(||)p Fu(',)g(and)g(optionally)i(terminated)f(b)m(y)f(one)
+h(of)f(`)p Ft(;)p Fu(',)h(`)p Ft(&)p Fu(',)g(or)f(a)h
+Ft(newline)p Fu(.)p eop end
 %%Page: 11 17
 TeXDict begin 11 16 bop 150 -116 a Fu(Chapter)30 b(3:)41
 b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(11)275 299
-y(A)29 b(sequence)h(of)g(one)g(or)g(more)g(newlines)f(ma)m(y)h(app)s
-(ear)f(in)h(a)g Ft(list)e Fu(to)j(delimit)f(commands,)g(equiv-)150
-408 y(alen)m(t)i(to)f(a)g(semicolon.)275 548 y(If)c(a)h(command)f(is)h
-(terminated)g(b)m(y)g(the)g(con)m(trol)h(op)s(erator)f(`)p
+y(Of)23 b(these)h(list)g(op)s(erators,)i(`)p Ft(&&)p
+Fu(')d(and)g(`)p Ft(||)p Fu(')h(ha)m(v)m(e)h(equal)f(precedence,)i
+(follo)m(w)m(ed)f(b)m(y)f(`)p Ft(;)p Fu(')g(and)f(`)p
+Ft(&)p Fu(',)i(whic)m(h)150 408 y(ha)m(v)m(e)32 b(equal)e(precedence.)
+275 536 y(A)f(sequence)h(of)g(one)g(or)g(more)g(newlines)f(ma)m(y)h
+(app)s(ear)f(in)h(a)g Ft(list)e Fu(to)j(delimit)f(commands,)g(equiv-)
+150 646 y(alen)m(t)i(to)f(a)g(semicolon.)275 773 y(If)c(a)h(command)f
+(is)h(terminated)g(b)m(y)g(the)g(con)m(trol)h(op)s(erator)f(`)p
 Ft(&)p Fu(',)h(the)e(shell)h(executes)h(the)f(command)150
-658 y(async)m(hronously)g(in)h(a)g(subshell.)39 b(This)28
+883 y(async)m(hronously)g(in)h(a)g(subshell.)39 b(This)28
 b(is)h(kno)m(wn)f(as)h(executing)h(the)f(command)g(in)f(the)h
-Fr(bac)m(kground)p Fu(,)150 767 y(and)42 b(these)i(are)f(referred)g(to)
+Fr(bac)m(kground)p Fu(,)150 992 y(and)42 b(these)i(are)f(referred)g(to)
 g(as)h Fr(async)m(hronous)i Fu(commands.)78 b(The)43
-b(shell)g(do)s(es)g(not)g(w)m(ait)h(for)f(the)150 877
+b(shell)g(do)s(es)g(not)g(w)m(ait)h(for)f(the)150 1102
 y(command)34 b(to)h(\014nish,)f(and)f(the)h(return)f(status)i(is)f(0)g
 (\(true\).)53 b(When)34 b(job)g(con)m(trol)h(is)f(not)h(activ)m(e)h
-(\(see)150 986 y(Chapter)27 b(7)h([Job)f(Con)m(trol],)i(page)g(113\),)h
-(the)d(standard)g(input)f(for)i(async)m(hronous)f(commands,)h(in)f(the)
-150 1096 y(absence)k(of)f(an)m(y)h(explicit)h(redirections,)f(is)f
-(redirected)h(from)f Ft(/dev/null)p Fu(.)275 1236 y(Commands)19
+(\(see)150 1211 y(Chapter)27 b(7)h([Job)f(Con)m(trol],)i(page)g(113\),)
+h(the)d(standard)g(input)f(for)i(async)m(hronous)f(commands,)h(in)f
+(the)150 1321 y(absence)k(of)f(an)m(y)h(explicit)h(redirections,)f(is)f
+(redirected)h(from)f Ft(/dev/null)p Fu(.)275 1448 y(Commands)19
 b(separated)j(b)m(y)f(a)g(`)p Ft(;)p Fu(')g(are)h(executed)g(sequen)m
 (tially;)k(the)21 b(shell)g(w)m(aits)h(for)f(eac)m(h)h(command)150
-1345 y(to)31 b(terminate)h(in)e(turn.)39 b(The)30 b(return)f(status)i
+1558 y(to)31 b(terminate)h(in)e(turn.)39 b(The)30 b(return)f(status)i
 (is)f(the)h(exit)g(status)g(of)g(the)f(last)h(command)f(executed.)275
-1485 y Fm(and)g Fu(and)h Fm(or)g Fu(lists)h(are)g(sequences)f(of)h(one)
+1685 y Fm(and)g Fu(and)h Fm(or)g Fu(lists)h(are)g(sequences)f(of)h(one)
 g(or)f(more)h(pip)s(elines)e(separated)i(b)m(y)g(the)f(con)m(trol)i(op)
-s(er-)150 1594 y(ators)e(`)p Ft(&&)p Fu(')f(and)g(`)p
+s(er-)150 1795 y(ators)e(`)p Ft(&&)p Fu(')f(and)g(`)p
 Ft(||)p Fu(',)h(resp)s(ectiv)m(ely)-8 b(.)42 b Fm(and)30
 b Fu(and)f Fm(or)h Fu(lists)h(are)g(executed)g(with)f(left)h(asso)s
-(ciativit)m(y)-8 b(.)275 1734 y(An)30 b Fm(and)f Fu(list)i(has)f(the)h
-(form)390 1874 y Fj(command1)46 b Ft(&&)h Fj(command2)150
-2013 y Fr(command2)38 b Fu(is)30 b(executed)i(if,)e(and)g(only)g(if,)h
+(ciativit)m(y)-8 b(.)275 1923 y(An)30 b Fm(and)f Fu(list)i(has)f(the)h
+(form)390 2050 y Fj(command1)46 b Ft(&&)h Fj(command2)150
+2178 y Fr(command2)38 b Fu(is)30 b(executed)i(if,)e(and)g(only)g(if,)h
 Fr(command1)38 b Fu(returns)29 b(an)h(exit)h(status)g(of)g(zero)g
-(\(success\).)275 2153 y(An)f Fm(or)f Fu(list)i(has)f(the)h(form)390
-2293 y Fj(command1)46 b Ft(||)h Fj(command2)150 2432
+(\(success\).)275 2305 y(An)f Fm(or)f Fu(list)i(has)f(the)h(form)390
+2432 y Fj(command1)46 b Ft(||)h Fj(command2)150 2560
 y Fr(command2)38 b Fu(is)30 b(executed)i(if,)e(and)g(only)g(if,)h
 Fr(command1)38 b Fu(returns)29 b(a)i(non-zero)g(exit)g(status.)275
-2572 y(The)h(return)g(status)i(of)f Fm(and)f Fu(and)h
+2687 y(The)h(return)g(status)i(of)f Fm(and)f Fu(and)h
 Fm(or)f Fu(lists)i(is)f(the)g(exit)h(status)g(of)f(the)g(last)h
-(command)f(executed)150 2681 y(in)d(the)h(list.)150 2886
-y Fk(3.2.5)63 b(Comp)s(ound)42 b(Commands)150 3033 y
+(command)f(executed)150 2797 y(in)d(the)h(list.)150 2982
+y Fk(3.2.5)63 b(Comp)s(ound)42 b(Commands)150 3129 y
 Fu(Comp)s(ound)29 b(commands)h(are)i(the)f(shell)g(programming)f
 (language)j(constructs.)42 b(Eac)m(h)32 b(construct)f(b)s(e-)150
-3142 y(gins)25 b(with)f(a)i(reserv)m(ed)f(w)m(ord)f(or)h(con)m(trol)h
+3239 y(gins)25 b(with)f(a)i(reserv)m(ed)f(w)m(ord)f(or)h(con)m(trol)h
 (op)s(erator)f(and)g(is)g(terminated)g(b)m(y)g(a)g(corresp)s(onding)f
-(reserv)m(ed)150 3252 y(w)m(ord)i(or)g(op)s(erator.)40
+(reserv)m(ed)150 3348 y(w)m(ord)i(or)g(op)s(erator.)40
 b(An)m(y)26 b(redirections)g(\(see)i(Section)f(3.6)g([Redirections],)h
-(page)f(38\))h(asso)s(ciated)f(with)150 3361 y(a)k(comp)s(ound)f
+(page)f(38\))h(asso)s(ciated)f(with)150 3458 y(a)k(comp)s(ound)f
 (command)h(apply)f(to)i(all)g(commands)f(within)f(that)i(comp)s(ound)d
-(command)i(unless)f(ex-)150 3471 y(plicitly)i(o)m(v)m(erridden.)275
-3611 y(In)20 b(most)h(cases)g(a)g(list)h(of)f(commands)f(in)g(a)h(comp)
+(command)i(unless)f(ex-)150 3568 y(plicitly)i(o)m(v)m(erridden.)275
+3695 y(In)20 b(most)h(cases)g(a)g(list)h(of)f(commands)f(in)g(a)h(comp)
 s(ound)f(command's)g(description)h(ma)m(y)g(b)s(e)f(separated)150
-3720 y(from)30 b(the)h(rest)g(of)g(the)g(command)g(b)m(y)f(one)h(or)g
+3805 y(from)30 b(the)h(rest)g(of)g(the)g(command)g(b)m(y)f(one)h(or)g
 (more)g(newlines,)g(and)f(ma)m(y)i(b)s(e)e(follo)m(w)m(ed)i(b)m(y)f(a)g
-(newline)150 3830 y(in)f(place)h(of)g(a)g(semicolon.)275
-3969 y(Bash)45 b(pro)m(vides)h(lo)s(oping)g(constructs,)j(conditional)e
+(newline)150 3914 y(in)f(place)h(of)g(a)g(semicolon.)275
+4042 y(Bash)45 b(pro)m(vides)h(lo)s(oping)g(constructs,)j(conditional)e
 (commands,)j(and)44 b(mec)m(hanisms)i(to)g(group)150
-4079 y(commands)30 b(and)g(execute)i(them)e(as)g(a)h(unit.)150
-4283 y Fk(3.2.5.1)63 b(Lo)s(oping)43 b(Constructs)150
-4430 y Fu(Bash)31 b(supp)s(orts)d(the)j(follo)m(wing)g(lo)s(oping)g
-(constructs.)275 4570 y(Note)k(that)f(wherev)m(er)g(a)g(`)p
+4151 y(commands)30 b(and)g(execute)i(them)e(as)g(a)h(unit.)150
+4336 y Fk(3.2.5.1)63 b(Lo)s(oping)43 b(Constructs)150
+4483 y Fu(Bash)31 b(supp)s(orts)d(the)j(follo)m(wing)g(lo)s(oping)g
+(constructs.)275 4611 y(Note)k(that)f(wherev)m(er)g(a)g(`)p
 Ft(;)p Fu(')g(app)s(ears)f(in)h(the)g(description)g(of)g(a)g(command's)
-g(syn)m(tax,)i(it)e(ma)m(y)h(b)s(e)150 4680 y(replaced)c(with)f(one)h
-(or)f(more)g(newlines.)150 4847 y Ft(until)240 b Fu(The)30
+g(syn)m(tax,)i(it)e(ma)m(y)h(b)s(e)150 4720 y(replaced)c(with)f(one)h
+(or)f(more)g(newlines.)150 4866 y Ft(until)240 b Fu(The)30
 b(syn)m(tax)h(of)f(the)h Ft(until)e Fu(command)h(is:)870
-4984 y Ft(until)46 b Fj(test-commands)p Ft(;)e(do)j Fj
+4993 y Ft(until)46 b Fj(test-commands)p Ft(;)e(do)j Fj
 (consequent-commands)p Ft(;)c(done)630 5121 y Fu(Execute)f
 Fr(consequen)m(t-commands)k Fu(as)41 b(long)h(as)f Fr(test-commands)46
 b Fu(has)41 b(an)g(exit)h(status)630 5230 y(whic)m(h)c(is)h(not)g
@@ -10791,17 +10792,18 @@ Ft(^)p Fu(')g(then)f(an)m(y)630 4655 y(c)m(haracter)c(not)f(enclosed)g
 (matc)m(hed)h(b)m(y)f(including)h(it)g(as)g(the)630 4765
 y(\014rst)32 b(or)h(last)h(c)m(haracter)h(in)e(the)g(set.)50
 b(A)33 b(`)p Ft(])p Fu(')g(ma)m(y)h(b)s(e)e(matc)m(hed)i(b)m(y)f
-(including)g(it)g(as)h(the)630 4875 y(\014rst)25 b(c)m(haracter)i(in)e
-(the)h(set.)40 b(The)25 b(sorting)h(order)f(of)h(c)m(haracters)h(in)f
-(range)g(expressions)f(is)630 4984 y(determined)h(b)m(y)h(the)g(curren)
-m(t)f(lo)s(cale)j(and)d(the)h(v)-5 b(alues)27 b(of)g(the)g
-Ft(LC_COLLATE)d Fu(and)i Ft(LC_ALL)630 5094 y Fu(shell)31
-b(v)-5 b(ariables,)31 b(if)f(set.)630 5230 y(F)-8 b(or)34
-b(example,)g(in)f(the)g(default)g(C)f(lo)s(cale,)k(`)p
-Ft([a-dx-z])p Fu(')31 b(is)i(equiv)-5 b(alen)m(t)34 b(to)g(`)p
-Ft([abcdxyz])p Fu('.)630 5340 y(Man)m(y)68 b(lo)s(cales)h(sort)f(c)m
-(haracters)h(in)e(dictionary)i(order,)76 b(and)67 b(in)g(these)h(lo)s
-(cales)p eop end
+(including)g(it)g(as)h(the)630 4875 y(\014rst)c(c)m(haracter)j(in)d
+(the)h(set.)43 b(The)31 b(sorting)g(order)g(of)g(c)m(haracters)h(in)f
+(range)g(expressions,)630 4984 y(and)f(the)h(c)m(haracters)h(included)e
+(in)h(the)f(range,)i(are)f(determined)f(b)m(y)h(the)g(curren)m(t)f(lo)s
+(cale)630 5094 y(and)g(the)g(v)-5 b(alues)31 b(of)g(the)f
+Ft(LC_COLLATE)e Fu(and)h Ft(LC_ALL)g Fu(shell)i(v)-5
+b(ariables,)31 b(if)f(set.)630 5230 y(F)-8 b(or)34 b(example,)g(in)f
+(the)g(default)g(C)f(lo)s(cale,)k(`)p Ft([a-dx-z])p Fu(')31
+b(is)i(equiv)-5 b(alen)m(t)34 b(to)g(`)p Ft([abcdxyz])p
+Fu('.)630 5340 y(Man)m(y)68 b(lo)s(cales)h(sort)f(c)m(haracters)h(in)e
+(dictionary)i(order,)76 b(and)67 b(in)g(these)h(lo)s(cales)p
+eop end
 %%Page: 37 43
 TeXDict begin 37 42 bop 150 -116 a Fu(Chapter)30 b(3:)41
 b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(37)630 299
@@ -801,8 +801,9 @@ the time information.
 If the pipeline is not executed asynchronously (@pxref{Lists}), the
 shell waits for all commands in the pipeline to complete.

-Each command in a multi-command
-pipeline is executed in its own @dfn{subshell}, which is a
+Each command in a multi-command pipeline,
+where pipes are created,
+is executed in its own @dfn{subshell}, which is a
 separate process (@pxref{Command Execution Environment}).
 If the @code{lastpipe} option is enabled using the @code{shopt} builtin
 (@pxref{The Shopt Builtin}),
@@ -7104,10 +7105,12 @@ No other startup files are read.
@subsubheading Invoked by remote shell daemon

 Bash attempts to determine when it is being run with its standard input
-connected to a network connection, as when executed by the remote shell
-daemon, usually @code{rshd}, or the secure shell daemon @code{sshd}.
-If Bash determines it is being run in
-this fashion, it reads and executes commands from @file{~/.bashrc}, if that
+connected to a network connection, as when executed by
+the historical remote shell daemon, usually @code{rshd},
+or the secure shell daemon @code{sshd}.
+If Bash
+determines it is being run non-interactively in this fashion,
+it reads and executes commands from @file{~/.bashrc}, if that
 file exists and is readable.
 It will not do this if invoked as @code{sh}.
 The @option{--norc} option may be used to inhibit this behavior, and the
@@ -8914,8 +8917,16 @@ suspend [-f]

 Suspend the execution of this shell until it receives a
@code{SIGCONT} signal.
-A login shell cannot be suspended; the @option{-f}
+A login shell,
+or a shell without job control enabled,
+cannot be suspended; the @option{-f}
 option can be used to override this and force the suspension.
+The return status is 0 unless the shell is a login shell
+or job control is not enabled
+and
+@option{-f}
+is not supplied.
+
@end table

 When job control is not active, the @code{kill} and @code{wait}
@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.4
-%%CreationDate: Fri Apr  8 15:46:03 2022
+%%CreationDate: Wed May  4 15:10:59 2022
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic
@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.4
-%%CreationDate: Fri Apr  8 15:46:03 2022
+%%CreationDate: Wed May  4 15:11:00 2022
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%DocumentSuppliedResources: procset grops 1.22 4
@@ -2,10 +2,10 @@
 Copyright (C) 1988-2022 Free Software Foundation, Inc.
@end ignore

-@set LASTCHANGE Mon May  2 08:59:39 EDT 2022
+@set LASTCHANGE Tue May 17 09:37:52 EDT 2022

@set EDITION 5.2
@set VERSION 5.2

-@set UPDATED 2 May 2022
+@set UPDATED 17 May 2022
@set UPDATED-MONTH May 2022