commit bash-20160212 snapshot

This commit is contained in:
Chet Ramey
2016-02-23 10:05:33 -05:00
parent 0f0e2f213d
commit 71574d7e0e
107 changed files with 4197 additions and 4694 deletions
+14 -12
View File
@@ -225,7 +225,7 @@ DDEEFFIINNIITTIIOONNSS
ccoonnttrrooll ooppeerraattoorr
A _t_o_k_e_n that performs a control function. It is one of the fol-
lowing symbols:
|||| && &&&& ;; ;;;; (( )) || ||&& <<nneewwlliinnee>>
|||| && &&&& ;; ;;;; ;;&& ;;;;&& (( )) || ||&& <<nneewwlliinnee>>
RREESSEERRVVEEDD WWOORRDDSS
_R_e_s_e_r_v_e_d _w_o_r_d_s are words that have a special meaning to the shell. The
@@ -4934,17 +4934,19 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
rreeaadd [--eerrss] [--aa _a_n_a_m_e] [--dd _d_e_l_i_m] [--ii _t_e_x_t] [--nn _n_c_h_a_r_s] [--NN _n_c_h_a_r_s] [--pp
_p_r_o_m_p_t] [--tt _t_i_m_e_o_u_t] [--uu _f_d] [_n_a_m_e ...]
One line is read from the standard input, or from the file
descriptor _f_d supplied as an argument to the --uu option, and the
descriptor _f_d supplied as an argument to the --uu option, split
into words as described above under WWoorrdd SSpplliittttiinngg, and the
first word is assigned to the first _n_a_m_e, the second word to the
second _n_a_m_e, and so on, with leftover words and their interven-
ing separators assigned to the last _n_a_m_e. If there are fewer
words read from the input stream than names, the remaining names
are assigned empty values. The characters in IIFFSS are used to
split the line into words using the same rules the shell uses
for expansion (described above under WWoorrdd SSpplliittttiinngg). The back-
slash character (\\) may be used to remove any special meaning
for the next character read and for line continuation. Options,
if supplied, have the following meanings:
second _n_a_m_e, and so on. If there are more words than names, the
remaining words and their intervening delimiters are assigned to
the last _n_a_m_e. If there are fewer words read from the input
stream than names, the remaining names are assigned empty val-
ues. The characters in IIFFSS are used to split the line into
words using the same rules the shell uses for expansion
(described above under WWoorrdd SSpplliittttiinngg). The backslash character
(\\) may be used to remove any special meaning for the next char-
acter read and for line continuation. Options, if supplied,
have the following meanings:
--aa _a_n_a_m_e
The words are assigned to sequential indices of the array
variable _a_n_a_m_e, starting at 0. _a_n_a_m_e is unset before any
@@ -5898,4 +5900,4 @@ BBUUGGSS
GNU Bash 4.4 2016 January 25 BASH(1)
GNU Bash 4.4 2016 February 8 BASH(1)
+4 -4
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Wed Jan 27 14:48:54 EST 2016
.\" Last Change: Mon Feb 8 10:15:48 EST 2016
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2016 January 27" "GNU Bash 4.4"
.TH BASH 1 "2016 February 8" "GNU Bash 4.4"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -487,8 +487,8 @@ A \fItoken\fP that performs a control function. It is one of the following
symbols:
.RS
.PP
.if t \fB|| & && ; ;; ( ) | |& <newline>\fP
.if n \fB|| & && ; ;; ( ) | |& <newline>\fP
.if t \fB|| & && ; ;; ;& ;;& ( ) | |& <newline>\fP
.if n \fB|| & && ; ;; ;& ;;& ( ) | |& <newline>\fP
.RE
.PD
.SH "RESERVED WORDS"
+10 -7
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2016 January 25<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2016 February 8<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -638,7 +638,7 @@ symbols:
<DL COMPACT><DT><DD>
<P>
<B>|| &amp; &amp;&amp; ; ;; ( ) | |&amp; &lt;newline&gt;</B>
<B>|| &amp; &amp;&amp; ; ;; ;&amp; ;;&amp; ( ) | |&amp; &lt;newline&gt;</B>
</DL>
@@ -11155,15 +11155,18 @@ reading the name of the current directory or an
invalid option is supplied.
<DT><B>read</B> [<B>-ers</B>] [<B>-a</B> <I>aname</I>] [<B>-d</B> <I>delim</I>] [<B>-i</B> <I>text</I>] [<B>-n</B> <I>nchars</I>] [<B>-N</B> <I>nchars</I>] [<B>-p</B> <I>prompt</I>] [<B>-t</B> <I>timeout</I>] [<B>-u</B> <I>fd</I>] [<I>name</I> ...]<DD>
One line is read from the standard input, or from the file descriptor
<I>fd</I> supplied as an argument to the <B>-u</B> option, and the first word
<I>fd</I> supplied as an argument to the <B>-u</B> option,
split into words as described above under <B>Word Splitting</B>,
and the first word
is assigned to the first
<I>name</I>,
the second word to the second
<I>name</I>,
and so on, with leftover words and their intervening separators assigned
to the last
and so on.
If there are more words than names, the remaining words and their
intervening delimiters are assigned to the last
<I>name</I>.
If there are fewer words read from the input stream than names,
@@ -13474,7 +13477,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2016 January 25<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2016 February 8<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13580,6 +13583,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 25 January 2016 10:12:33 EST
Time: 08 February 2016 10:17:49 EST
</BODY>
</HTML>
+153 -151
View File
@@ -2,9 +2,9 @@ This is bash.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 25 January 2016).
Bash shell (version 4.4, 8 February 2016).
This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 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 4.4, 25 January 2016). The Bash home page is
Bash shell (version 4.4, 8 February 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -174,8 +174,8 @@ These definitions are used throughout the remainder of this manual.
'control operator'
A 'token' that performs a control function. It is a 'newline' or
one of the following: '||', '&&', '&', ';', ';;', '|', '|&', '(',
or ')'.
one of the following: '||', '&&', '&', ';', ';;', ';&', ';;&', '|',
'|&', '(', or ')'.
'exit status'
The value returned by a command to its caller. The value is
@@ -3675,22 +3675,24 @@ standard.
[-N NCHARS] [-p PROMPT] [-t TIMEOUT] [-u FD] [NAME ...]
One line is read from the standard input, or from the file
descriptor FD supplied as an argument to the '-u' option, and the
descriptor FD supplied as an argument to the '-u' option, split
into words as described above in *note Word Splitting::, and the
first word is assigned to the first NAME, the second word to the
second NAME, and so on, with leftover words and their intervening
separators assigned to the last NAME. If there are fewer words
read from the input stream than names, the remaining names are
assigned empty values. The characters in the value of the 'IFS'
variable are used to split the line into words using the same rules
the shell uses for expansion (described above in *note Word
Splitting::). The backslash character '\' may be used to remove
any special meaning for the next character read and for line
continuation. If no names are supplied, the line read is assigned
to the variable 'REPLY'. The exit status is zero, unless
end-of-file is encountered, 'read' times out (in which case the
status is greater than 128), a variable assignment error (such as
assigning to a readonly variable) occurs, or an invalid file
descriptor is supplied as the argument to '-u'.
second NAME, and so on. If there are more words than names, the
remaining words and their intervening delimiters are assigned to
the last NAME. If there are fewer words read from the input stream
than names, the remaining names are assigned empty values. The
characters in the value of the 'IFS' variable are used to split the
line into words using the same rules the shell uses for expansion
(described above in *note Word Splitting::). The backslash
character '\' may be used to remove any special meaning for the
next character read and for line continuation. If no names are
supplied, the line read is assigned to the variable 'REPLY'. The
exit status is zero, unless end-of-file is encountered, 'read'
times out (in which case the status is greater than 128), a
variable assignment error (such as assigning to a readonly
variable) occurs, or an invalid file descriptor is supplied as the
argument to '-u'.
Options, if supplied, have the following meanings:
@@ -10664,7 +10666,7 @@ D.1 Index of Shell Builtin Commands
* pwd: Bourne Shell Builtins.
(line 205)
* read: Bash Builtins. (line 458)
* readarray: Bash Builtins. (line 548)
* readarray: Bash Builtins. (line 550)
* readonly: Bourne Shell Builtins.
(line 215)
* return: Bourne Shell Builtins.
@@ -10673,7 +10675,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 255)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 557)
* source: Bash Builtins. (line 559)
* suspend: Job Control Builtins.
(line 101)
* test: Bourne Shell Builtins.
@@ -10682,12 +10684,12 @@ D.1 Index of Shell Builtin Commands
(line 343)
* trap: Bourne Shell Builtins.
(line 349)
* type: Bash Builtins. (line 562)
* typeset: Bash Builtins. (line 594)
* ulimit: Bash Builtins. (line 600)
* type: Bash Builtins. (line 564)
* typeset: Bash Builtins. (line 596)
* ulimit: Bash Builtins. (line 602)
* umask: Bourne Shell Builtins.
(line 398)
* unalias: Bash Builtins. (line 699)
* unalias: Bash Builtins. (line 701)
* unset: Bourne Shell Builtins.
(line 416)
* wait: Job Control Builtins.
@@ -11323,129 +11325,129 @@ Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9619
Node: Shell Syntax10838
Node: Shell Operation11864
Node: Quoting13157
Node: Escape Character14457
Node: Single Quotes14942
Node: Double Quotes15290
Node: ANSI-C Quoting16568
Node: Locale Translation17821
Node: Comments18717
Node: Shell Commands19335
Node: Simple Commands20207
Node: Pipelines20838
Node: Lists23581
Node: Compound Commands25310
Node: Looping Constructs26313
Node: Conditional Constructs28776
Node: Command Grouping39697
Node: Coprocesses41176
Node: GNU Parallel43008
Node: Shell Functions46981
Node: Shell Parameters52187
Node: Positional Parameters56589
Node: Special Parameters57489
Node: Shell Expansions60826
Node: Brace Expansion62763
Node: Tilde Expansion65544
Node: Shell Parameter Expansion67892
Node: Command Substitution82024
Node: Arithmetic Expansion83379
Node: Process Substitution84311
Node: Word Splitting85431
Node: Filename Expansion87375
Node: Pattern Matching89659
Node: Quote Removal93357
Node: Redirections93652
Node: Executing Commands102901
Node: Simple Command Expansion103571
Node: Command Search and Execution105501
Node: Command Execution Environment107837
Node: Environment110821
Node: Exit Status112480
Node: Signals114150
Node: Shell Scripts116117
Node: Shell Builtin Commands118632
Node: Bourne Shell Builtins120666
Node: Bash Builtins141268
Node: Modifying Shell Behavior169784
Node: The Set Builtin170129
Node: The Shopt Builtin180542
Node: Special Builtins196162
Node: Shell Variables197141
Node: Bourne Shell Variables197578
Node: Bash Variables199609
Node: Bash Features227873
Node: Invoking Bash228772
Node: Bash Startup Files234721
Node: Interactive Shells239824
Node: What is an Interactive Shell?240234
Node: Is this Shell Interactive?240883
Node: Interactive Shell Behavior241698
Node: Bash Conditional Expressions245073
Node: Shell Arithmetic249074
Node: Aliases251851
Node: Arrays254399
Node: The Directory Stack259483
Node: Directory Stack Builtins260267
Node: Controlling the Prompt263235
Node: The Restricted Shell265981
Node: Bash POSIX Mode267806
Node: Job Control277718
Node: Job Control Basics278178
Node: Job Control Builtins282897
Node: Job Control Variables287427
Node: Command Line Editing288583
Node: Introduction and Notation290254
Node: Readline Interaction291877
Node: Readline Bare Essentials293068
Node: Readline Movement Commands294851
Node: Readline Killing Commands295811
Node: Readline Arguments297729
Node: Searching298773
Node: Readline Init File300959
Node: Readline Init File Syntax302106
Node: Conditional Init Constructs321870
Node: Sample Init File324395
Node: Bindable Readline Commands327512
Node: Commands For Moving328716
Node: Commands For History329859
Node: Commands For Text334148
Node: Commands For Killing337537
Node: Numeric Arguments340018
Node: Commands For Completion341157
Node: Keyboard Macros345348
Node: Miscellaneous Commands346035
Node: Readline vi Mode351839
Node: Programmable Completion352746
Node: Programmable Completion Builtins360207
Node: A Programmable Completion Example370093
Node: Using History Interactively375345
Node: Bash History Facilities376029
Node: Bash History Builtins379030
Node: History Interaction383027
Node: Event Designators385991
Node: Word Designators387210
Node: Modifiers388847
Node: Installing Bash390249
Node: Basic Installation391386
Node: Compilers and Options394077
Node: Compiling For Multiple Architectures394818
Node: Installation Names396481
Node: Specifying the System Type397299
Node: Sharing Defaults398015
Node: Operation Controls398688
Node: Optional Features399646
Node: Reporting Bugs409903
Node: Major Differences From The Bourne Shell411097
Node: GNU Free Documentation License427949
Node: Indexes453126
Node: Builtin Index453580
Node: Reserved Word Index460407
Node: Variable Index462855
Node: Function Index478314
Node: Concept Index491534
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661

End Tag Table
BIN
View File
Binary file not shown.
+773 -767
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -39,7 +39,7 @@
\entry{type}{57}{\code {type}}
\entry{typeset}{57}{\code {typeset}}
\entry{ulimit}{57}{\code {ulimit}}
\entry{unalias}{58}{\code {unalias}}
\entry{unalias}{59}{\code {unalias}}
\entry{set}{59}{\code {set}}
\entry{shopt}{63}{\code {shopt}}
\entry{dirs}{92}{\code {dirs}}
+1 -1
View File
@@ -74,7 +74,7 @@
\initial {U}
\entry {\code {ulimit}}{57}
\entry {\code {umask}}{47}
\entry {\code {unalias}}{58}
\entry {\code {unalias}}{59}
\entry {\code {unset}}{48}
\initial {W}
\entry {\code {wait}}{101}
BIN
View File
Binary file not shown.
+11 -7
View File
@@ -1,9 +1,9 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This text is a brief description of the features that are present in
the Bash shell (version 4.4, 25 January 2016).
the Bash shell (version 4.4, 8 February 2016).
This is Edition 4.4, last updated 25 January 2016,
This is Edition 4.4, last updated 8 February 2016,
of The GNU Bash Reference Manual,
for Bash, Version 4.4.
@@ -285,10 +285,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
<h1 class="top">Bash Features</h1>
<p>This text is a brief description of the features that are present in
the Bash shell (version 4.4, 25 January 2016).
the Bash shell (version 4.4, 8 February 2016).
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 4.4, last updated 25 January 2016,
<p>This is Edition 4.4, last updated 8 February 2016,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 4.4.
</p>
@@ -480,7 +480,7 @@ than by an executable program somewhere in the file system.
<dd><a name="index-control-operator"></a>
<p>A <code>token</code> that performs a control function. It is a <code>newline</code>
or one of the following:
&lsquo;<samp>||</samp>&rsquo;, &lsquo;<samp>&amp;&amp;</samp>&rsquo;, &lsquo;<samp>&amp;</samp>&rsquo;, &lsquo;<samp>;</samp>&rsquo;, &lsquo;<samp>;;</samp>&rsquo;,
&lsquo;<samp>||</samp>&rsquo;, &lsquo;<samp>&amp;&amp;</samp>&rsquo;, &lsquo;<samp>&amp;</samp>&rsquo;, &lsquo;<samp>;</samp>&rsquo;, &lsquo;<samp>;;</samp>&rsquo;, &lsquo;<samp>;&amp;</samp>&rsquo;, &lsquo;<samp>;;&amp;</samp>&rsquo;,
&lsquo;<samp>|</samp>&rsquo;, &lsquo;<samp>|&amp;</samp>&rsquo;, &lsquo;<samp>(</samp>&rsquo;, or &lsquo;<samp>)</samp>&rsquo;.
</p>
</dd>
@@ -5101,9 +5101,13 @@ non-zero on failure.
</pre></div>
<p>One line is read from the standard input, or from the file descriptor
<var>fd</var> supplied as an argument to the <samp>-u</samp> option, and the first word
<var>fd</var> supplied as an argument to the <samp>-u</samp> option,
split into words as described above in <a href="#Word-Splitting">Word Splitting</a>,
and the first word
is assigned to the first <var>name</var>, the second word to the second <var>name</var>,
and so on, with leftover words and their intervening separators assigned
and so on.
If there are more words than names,
the remaining words and their intervening delimiters are assigned
to the last <var>name</var>.
If there are fewer words read from the input stream than names,
the remaining names are assigned empty values.
+153 -151
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 25 January 2016).
Bash shell (version 4.4, 8 February 2016).
This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 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 4.4, 25 January 2016). The Bash home page is
Bash shell (version 4.4, 8 February 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -174,8 +174,8 @@ These definitions are used throughout the remainder of this manual.
'control operator'
A 'token' that performs a control function. It is a 'newline' or
one of the following: '||', '&&', '&', ';', ';;', '|', '|&', '(',
or ')'.
one of the following: '||', '&&', '&', ';', ';;', ';&', ';;&', '|',
'|&', '(', or ')'.
'exit status'
The value returned by a command to its caller. The value is
@@ -3675,22 +3675,24 @@ standard.
[-N NCHARS] [-p PROMPT] [-t TIMEOUT] [-u FD] [NAME ...]
One line is read from the standard input, or from the file
descriptor FD supplied as an argument to the '-u' option, and the
descriptor FD supplied as an argument to the '-u' option, split
into words as described above in *note Word Splitting::, and the
first word is assigned to the first NAME, the second word to the
second NAME, and so on, with leftover words and their intervening
separators assigned to the last NAME. If there are fewer words
read from the input stream than names, the remaining names are
assigned empty values. The characters in the value of the 'IFS'
variable are used to split the line into words using the same rules
the shell uses for expansion (described above in *note Word
Splitting::). The backslash character '\' may be used to remove
any special meaning for the next character read and for line
continuation. If no names are supplied, the line read is assigned
to the variable 'REPLY'. The exit status is zero, unless
end-of-file is encountered, 'read' times out (in which case the
status is greater than 128), a variable assignment error (such as
assigning to a readonly variable) occurs, or an invalid file
descriptor is supplied as the argument to '-u'.
second NAME, and so on. If there are more words than names, the
remaining words and their intervening delimiters are assigned to
the last NAME. If there are fewer words read from the input stream
than names, the remaining names are assigned empty values. The
characters in the value of the 'IFS' variable are used to split the
line into words using the same rules the shell uses for expansion
(described above in *note Word Splitting::). The backslash
character '\' may be used to remove any special meaning for the
next character read and for line continuation. If no names are
supplied, the line read is assigned to the variable 'REPLY'. The
exit status is zero, unless end-of-file is encountered, 'read'
times out (in which case the status is greater than 128), a
variable assignment error (such as assigning to a readonly
variable) occurs, or an invalid file descriptor is supplied as the
argument to '-u'.
Options, if supplied, have the following meanings:
@@ -10664,7 +10666,7 @@ D.1 Index of Shell Builtin Commands
* pwd: Bourne Shell Builtins.
(line 205)
* read: Bash Builtins. (line 458)
* readarray: Bash Builtins. (line 548)
* readarray: Bash Builtins. (line 550)
* readonly: Bourne Shell Builtins.
(line 215)
* return: Bourne Shell Builtins.
@@ -10673,7 +10675,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 255)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 557)
* source: Bash Builtins. (line 559)
* suspend: Job Control Builtins.
(line 101)
* test: Bourne Shell Builtins.
@@ -10682,12 +10684,12 @@ D.1 Index of Shell Builtin Commands
(line 343)
* trap: Bourne Shell Builtins.
(line 349)
* type: Bash Builtins. (line 562)
* typeset: Bash Builtins. (line 594)
* ulimit: Bash Builtins. (line 600)
* type: Bash Builtins. (line 564)
* typeset: Bash Builtins. (line 596)
* ulimit: Bash Builtins. (line 602)
* umask: Bourne Shell Builtins.
(line 398)
* unalias: Bash Builtins. (line 699)
* unalias: Bash Builtins. (line 701)
* unset: Bourne Shell Builtins.
(line 416)
* wait: Job Control Builtins.
@@ -11323,129 +11325,129 @@ Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9619
Node: Shell Syntax10838
Node: Shell Operation11864
Node: Quoting13157
Node: Escape Character14457
Node: Single Quotes14942
Node: Double Quotes15290
Node: ANSI-C Quoting16568
Node: Locale Translation17821
Node: Comments18717
Node: Shell Commands19335
Node: Simple Commands20207
Node: Pipelines20838
Node: Lists23581
Node: Compound Commands25310
Node: Looping Constructs26313
Node: Conditional Constructs28776
Node: Command Grouping39697
Node: Coprocesses41176
Node: GNU Parallel43008
Node: Shell Functions46981
Node: Shell Parameters52187
Node: Positional Parameters56589
Node: Special Parameters57489
Node: Shell Expansions60826
Node: Brace Expansion62763
Node: Tilde Expansion65544
Node: Shell Parameter Expansion67892
Node: Command Substitution82024
Node: Arithmetic Expansion83379
Node: Process Substitution84311
Node: Word Splitting85431
Node: Filename Expansion87375
Node: Pattern Matching89659
Node: Quote Removal93357
Node: Redirections93652
Node: Executing Commands102901
Node: Simple Command Expansion103571
Node: Command Search and Execution105501
Node: Command Execution Environment107837
Node: Environment110821
Node: Exit Status112480
Node: Signals114150
Node: Shell Scripts116117
Node: Shell Builtin Commands118632
Node: Bourne Shell Builtins120666
Node: Bash Builtins141268
Node: Modifying Shell Behavior169784
Node: The Set Builtin170129
Node: The Shopt Builtin180542
Node: Special Builtins196162
Node: Shell Variables197141
Node: Bourne Shell Variables197578
Node: Bash Variables199609
Node: Bash Features227873
Node: Invoking Bash228772
Node: Bash Startup Files234721
Node: Interactive Shells239824
Node: What is an Interactive Shell?240234
Node: Is this Shell Interactive?240883
Node: Interactive Shell Behavior241698
Node: Bash Conditional Expressions245073
Node: Shell Arithmetic249074
Node: Aliases251851
Node: Arrays254399
Node: The Directory Stack259483
Node: Directory Stack Builtins260267
Node: Controlling the Prompt263235
Node: The Restricted Shell265981
Node: Bash POSIX Mode267806
Node: Job Control277718
Node: Job Control Basics278178
Node: Job Control Builtins282897
Node: Job Control Variables287427
Node: Command Line Editing288583
Node: Introduction and Notation290254
Node: Readline Interaction291877
Node: Readline Bare Essentials293068
Node: Readline Movement Commands294851
Node: Readline Killing Commands295811
Node: Readline Arguments297729
Node: Searching298773
Node: Readline Init File300959
Node: Readline Init File Syntax302106
Node: Conditional Init Constructs321870
Node: Sample Init File324395
Node: Bindable Readline Commands327512
Node: Commands For Moving328716
Node: Commands For History329859
Node: Commands For Text334148
Node: Commands For Killing337537
Node: Numeric Arguments340018
Node: Commands For Completion341157
Node: Keyboard Macros345348
Node: Miscellaneous Commands346035
Node: Readline vi Mode351839
Node: Programmable Completion352746
Node: Programmable Completion Builtins360207
Node: A Programmable Completion Example370093
Node: Using History Interactively375345
Node: Bash History Facilities376029
Node: Bash History Builtins379030
Node: History Interaction383027
Node: Event Designators385991
Node: Word Designators387210
Node: Modifiers388847
Node: Installing Bash390249
Node: Basic Installation391386
Node: Compilers and Options394077
Node: Compiling For Multiple Architectures394818
Node: Installation Names396481
Node: Specifying the System Type397299
Node: Sharing Defaults398015
Node: Operation Controls398688
Node: Optional Features399646
Node: Reporting Bugs409903
Node: Major Differences From The Bourne Shell411097
Node: GNU Free Documentation License427949
Node: Indexes453126
Node: Builtin Index453580
Node: Reserved Word Index460407
Node: Variable Index462855
Node: Function Index478314
Node: Concept Index491534
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661

End Tag Table
+9 -9
View File
@@ -1,4 +1,4 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/MacPorts 2015_7) (preloaded format=pdfetex 2015.7.15) 25 JAN 2016 10:12
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/MacPorts 2015_7) (preloaded format=pdfetex 2015.7.15) 8 FEB 2016 10:18
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
@@ -255,7 +255,7 @@ d@texttt ][]
.etc.
[54] [55]
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4461--4461
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4465--4465
[]@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
[-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
fd@texttt ][]
@@ -270,7 +270,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4461--4461
[56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] [68] Chapter 5
[69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] Chapter 6 [80]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6167--6167
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6171--6171
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -283,7 +283,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6168--6168
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6172--6172
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -297,7 +297,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6168--6168
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6169--6169
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6173--6173
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -398,7 +398,7 @@ Overfull \vbox (2.87483pt too high) has occurred while \output is active
Here is how much of TeX's memory you used:
4059 strings out of 497110
46657 string characters out of 6206872
138632 words of memory out of 5000000
138667 words of memory out of 5000000
4845 multiletter control sequences out of 15000+600000
33547 words of font info for 115 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
@@ -419,10 +419,10 @@ hare/texmf-texlive/fonts/type1/public/amsfonts/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/cmtt9.pfb></opt/local/share/texmf-texli
ve/fonts/type1/public/cm-super/sfrm1095.pfb>
Output written on bashref.pdf (177 pages, 730457 bytes).
Output written on bashref.pdf (177 pages, 730636 bytes).
PDF statistics:
2567 PDF objects out of 2984 (max. 8388607)
2346 compressed objects within 24 object streams
2569 PDF objects out of 2984 (max. 8388607)
2348 compressed objects within 24 object streams
303 named destinations out of 1000 (max. 500000)
1125 words of extra memory for PDF output out of 10000 (max. 10000000)
BIN
View File
Binary file not shown.
+658 -653
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -212,7 +212,7 @@ than by an executable program somewhere in the file system.
@cindex control operator
A @code{token} that performs a control function. It is a @code{newline}
or one of the following:
@samp{||}, @samp{&&}, @samp{&}, @samp{;}, @samp{;;},
@samp{||}, @samp{&&}, @samp{&}, @samp{;}, @samp{;;}, @samp{;&}, @samp{;;&},
@samp{|}, @samp{|&}, @samp{(}, or @samp{)}.
@item exit status
+12 -10
View File
@@ -940,17 +940,19 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
rreeaadd [--eerrss] [--aa _a_n_a_m_e] [--dd _d_e_l_i_m] [--ii _t_e_x_t] [--nn _n_c_h_a_r_s] [--NN _n_c_h_a_r_s] [--pp
_p_r_o_m_p_t] [--tt _t_i_m_e_o_u_t] [--uu _f_d] [_n_a_m_e ...]
One line is read from the standard input, or from the file
descriptor _f_d supplied as an argument to the --uu option, and the
descriptor _f_d supplied as an argument to the --uu option, split
into words as described above under WWoorrdd SSpplliittttiinngg, and the
first word is assigned to the first _n_a_m_e, the second word to the
second _n_a_m_e, and so on, with leftover words and their interven-
ing separators assigned to the last _n_a_m_e. If there are fewer
words read from the input stream than names, the remaining names
are assigned empty values. The characters in IIFFSS are used to
split the line into words using the same rules the shell uses
for expansion (described above under WWoorrdd SSpplliittttiinngg). The back-
slash character (\\) may be used to remove any special meaning
for the next character read and for line continuation. Options,
if supplied, have the following meanings:
second _n_a_m_e, and so on. If there are more words than names, the
remaining words and their intervening delimiters are assigned to
the last _n_a_m_e. If there are fewer words read from the input
stream than names, the remaining names are assigned empty val-
ues. The characters in IIFFSS are used to split the line into
words using the same rules the shell uses for expansion
(described above under WWoorrdd SSpplliittttiinngg). The backslash character
(\\) may be used to remove any special meaning for the next char-
acter read and for line continuation. Options, if supplied,
have the following meanings:
--aa _a_n_a_m_e
The words are assigned to sequential indices of the array
variable _a_n_a_m_e, starting at 0. _a_n_a_m_e is unset before any
+740 -736
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Jan 25 10:12:22 2016
%%CreationDate: Mon Feb 8 10:16:54 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2016 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Wed Jan 27 14:48:34 EST 2016
@set LASTCHANGE Mon Feb 8 10:16:20 EST 2016
@set EDITION 4.4
@set VERSION 4.4
@set UPDATED 27 January 2016
@set UPDATED-MONTH January 2016
@set UPDATED 8 February 2016
@set UPDATED-MONTH February 2016