pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-08-07 10:42:28 +02:00
Code Issues Packages Projects Releases Wiki Activity

commit bash-20091015 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-08 20:18:35 -05:00
parent d5362af881
commit e1e48bbabe
99 changed files with 30476 additions and 24169 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.0
+1857 -1843
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+5 -4
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet@po.cwru.edu
.\"
.\" Last Change: Fri Oct 9 12:07:53 EDT 2009
.\" Last Change: Fri Oct 16 12:24:25 EDT 2009
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2009 October 9" "GNU Bash-4.1"
.TH BASH 1 "2009 October 16" "GNU Bash-4.1"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -7787,7 +7787,7 @@ Exit a login shell.
.TP
\fBreadarray\fP [\fB\-n\fP \fIcount\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIcount\fP] [\fB\-t\fP] [\fB\-u\fP \fIfd\fP] [\fB\-C\fP \fIcallback\fP] [\fB\-c\fP \fIquantum\fP] [\fIarray\fP]
.PD
Read lines from the standard input into array variable
Read lines from the standard input into the indexed array variable
.IR array ,
or from file descriptor
.IR fd
@@ -7845,7 +7845,8 @@ If not supplied with an explicit origin, \fBmapfile\fP will clear \fIarray\fP
before assigning to it.
.PP
\fBmapfile\fP returns successfully unless an invalid option or option
argument is supplied, or \fIarray\fP is invalid or unassignable.
argument is supplied, \fIarray\fP is invalid or unassignable, or if
\fIarray\fP is not an indexed array.
.RE
.TP
\fBpopd\fP [\-\fBn\fP] [+\fIn\fP] [\-\fIn\fP]
doc/bash.1~
+5
View File
@@ -4969,6 +4969,11 @@ When set to \fBOn\fP, readline will try to enable the application
keypad when it is called. Some systems need this to enable the
arrow keys.
.TP
.B enable\-meta\-key (On)
When set to \fBOn\fP, readline will try to enable any meta modifier
key the terminal claims to support when it is called. On many terminals,
the meta key is used to send eight-bit characters.
.TP
.B expand\-tilde (Off)
If set to \fBon\fP, tilde expansion is performed when readline
attempts word completion.
doc/bash.html
+26 -8
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2009 September 16<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2009 October 9<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -902,6 +902,11 @@ as primaries.
<P>
When used with <B>[[</B>, The <B>&lt;</B> and <B>&gt;</B> operators sort
lexicographically using the current locale.
<P>
When the <B>==</B> and <B>!=</B> operators are used, the string to the
right of the operator is considered a pattern and matched according
to the rules described below under <B>Pattern Matching</B>.
@@ -1411,8 +1416,8 @@ The expanded result is single-quoted, as if the dollar sign had
not been present.
<P>
A double-quoted string preceded by a dollar sign (<B>$</B>) will cause
the string to be translated according to the current locale.
A double-quoted string preceded by a dollar sign (<B>$</B>dq<I>string</I>dq)
will cause the string to be translated according to the current locale.
If the current locale is <B>C</B> or <B>POSIX</B>, the dollar sign
is ignored.
If the string is translated and replaced, the replacement is
@@ -3235,7 +3240,7 @@ interpreted as part of its name.
</DL>
<P>
If the first character of <I>parameter</I> is an exclamation point,
If the first character of <I>parameter</I> is an exclamation point (<B>!</B>),
a level of variable indirection is introduced.
<B>Bash</B> uses the value of the variable formed from the rest of
<I>parameter</I> as the name of the variable; this variable is then
@@ -6435,6 +6440,12 @@ keyboard.
When set to <B>On</B>, readline will try to enable the application
keypad when it is called. Some systems need this to enable the
arrow keys.
<DT><B>enable-meta-key (On)</B>
<DD>
When set to <B>On</B>, readline will try to enable any meta modifier
key the terminal claims to support when it is called. On many terminals,
the meta key is used to send eight-bit characters.
<DT><B>expand-tilde (Off)</B>
<DD>
@@ -10215,7 +10226,7 @@ option is used, the pathname printed may contain symbolic links.
The return status is 0 unless an error occurs while
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>-p</B> <I>prompt</I>] [<B>-t</B> <I>timeout</I>] [<B>-u</B> <I>fd</I>] [<I>name</I> ...]<DD>
<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
is assigned to the first
@@ -10284,7 +10295,14 @@ buffer before editing begins.
<DD>
<B>read</B> returns after reading <I>nchars</I> characters rather than
waiting for a complete line of input.
waiting for a complete line of input, but honor a delimiter if fewer
than <I>nchars</I> characters are read before the delimiter.
<DT><B>-N </B><I>nchars</I>
<DD>
<B>read</B> returns after reading exactly <I>nchars</I> characters rather
than waiting for a complete line of input, unless EOF is encountered or
<B>read</B> times out. Any delimiter is ignored.
<DT><B>-p </B><I>prompt</I>
<DD>
@@ -12237,7 +12255,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash-4.1<TH ALIGN=CENTER width=33%>2009 September 16<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash-4.1<TH ALIGN=CENTER width=33%>2009 October 9<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -12343,6 +12361,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 16 September 2009 21:35:09 EDT
Time: 12 October 2009 10:07:29 EDT
</BODY>
</HTML>
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+5180 -5162
View File
File diff suppressed because it is too large Load Diff
doc/bashref.aux
+55 -55
View File
@@ -66,9 +66,9 @@
@xrdef{Coprocesses-title}{Coprocesses}
@xrdef{Coprocesses-snt}{Section@tie 3.2.5}
@xrdef{Command Grouping-pg}{13}
@xrdef{Coprocesses-pg}{13}
@xrdef{Shell Functions-title}{Shell Functions}
@xrdef{Shell Functions-snt}{Section@tie 3.3}
@xrdef{Coprocesses-pg}{14}
@xrdef{Shell Functions-pg}{14}
@xrdef{Shell Parameters-title}{Shell Parameters}
@xrdef{Shell Parameters-snt}{Section@tie 3.4}
@@ -87,9 +87,9 @@
@xrdef{Tilde Expansion-title}{Tilde Expansion}
@xrdef{Tilde Expansion-snt}{Section@tie 3.5.2}
@xrdef{Brace Expansion-pg}{18}
@xrdef{Tilde Expansion-pg}{18}
@xrdef{Shell Parameter Expansion-title}{Shell Parameter Expansion}
@xrdef{Shell Parameter Expansion-snt}{Section@tie 3.5.3}
@xrdef{Tilde Expansion-pg}{19}
@xrdef{Shell Parameter Expansion-pg}{19}
@xrdef{Command Substitution-title}{Command Substitution}
@xrdef{Command Substitution-snt}{Section@tie 3.5.4}
@@ -221,14 +221,14 @@
@xrdef{Job Control-snt}{Chapter@tie 7}
@xrdef{Job Control Basics-title}{Job Control Basics}
@xrdef{Job Control Basics-snt}{Section@tie 7.1}
@xrdef{Job Control-pg}{87}
@xrdef{Job Control Basics-pg}{87}
@xrdef{Job Control-pg}{89}
@xrdef{Job Control Basics-pg}{89}
@xrdef{Job Control Builtins-title}{Job Control Builtins}
@xrdef{Job Control Builtins-snt}{Section@tie 7.2}
@xrdef{Job Control Builtins-pg}{88}
@xrdef{Job Control Builtins-pg}{90}
@xrdef{Job Control Variables-title}{Job Control Variables}
@xrdef{Job Control Variables-snt}{Section@tie 7.3}
@xrdef{Job Control Variables-pg}{90}
@xrdef{Job Control Variables-pg}{92}
@xrdef{Command Line Editing-title}{Command Line Editing}
@xrdef{Command Line Editing-snt}{Chapter@tie 8}
@xrdef{Introduction and Notation-title}{Introduction to Line Editing}
@@ -237,142 +237,142 @@
@xrdef{Readline Interaction-snt}{Section@tie 8.2}
@xrdef{Readline Bare Essentials-title}{Readline Bare Essentials}
@xrdef{Readline Bare Essentials-snt}{Section@tie 8.2.1}
@xrdef{Command Line Editing-pg}{91}
@xrdef{Introduction and Notation-pg}{91}
@xrdef{Readline Interaction-pg}{91}
@xrdef{Command Line Editing-pg}{93}
@xrdef{Introduction and Notation-pg}{93}
@xrdef{Readline Interaction-pg}{93}
@xrdef{Readline Movement Commands-title}{Readline Movement Commands}
@xrdef{Readline Movement Commands-snt}{Section@tie 8.2.2}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3}
@xrdef{Readline Bare Essentials-pg}{92}
@xrdef{Readline Movement Commands-pg}{92}
@xrdef{Readline Bare Essentials-pg}{94}
@xrdef{Readline Movement Commands-pg}{94}
@xrdef{Readline Arguments-title}{Readline Arguments}
@xrdef{Readline Arguments-snt}{Section@tie 8.2.4}
@xrdef{Searching-title}{Searching for Commands in the History}
@xrdef{Searching-snt}{Section@tie 8.2.5}
@xrdef{Readline Killing Commands-pg}{93}
@xrdef{Readline Arguments-pg}{93}
@xrdef{Searching-pg}{93}
@xrdef{Readline Killing Commands-pg}{95}
@xrdef{Readline Arguments-pg}{95}
@xrdef{Searching-pg}{95}
@xrdef{Readline Init File-title}{Readline Init File}
@xrdef{Readline Init File-snt}{Section@tie 8.3}
@xrdef{Readline Init File Syntax-title}{Readline Init File Syntax}
@xrdef{Readline Init File Syntax-snt}{Section@tie 8.3.1}
@xrdef{Readline Init File-pg}{94}
@xrdef{Readline Init File Syntax-pg}{94}
@xrdef{Readline Init File-pg}{96}
@xrdef{Readline Init File Syntax-pg}{96}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2}
@xrdef{Conditional Init Constructs-pg}{100}
@xrdef{Conditional Init Constructs-pg}{102}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 8.3.3}
@xrdef{Sample Init File-pg}{101}
@xrdef{Sample Init File-pg}{103}
@xrdef{Bindable Readline Commands-title}{Bindable Readline Commands}
@xrdef{Bindable Readline Commands-snt}{Section@tie 8.4}
@xrdef{Commands For Moving-title}{Commands For Moving}
@xrdef{Commands For Moving-snt}{Section@tie 8.4.1}
@xrdef{Commands For History-title}{Commands For Manipulating The History}
@xrdef{Commands For History-snt}{Section@tie 8.4.2}
@xrdef{Bindable Readline Commands-pg}{104}
@xrdef{Commands For Moving-pg}{104}
@xrdef{Commands For History-pg}{105}
@xrdef{Bindable Readline Commands-pg}{106}
@xrdef{Commands For Moving-pg}{106}
@xrdef{Commands For History-pg}{107}
@xrdef{Commands For Text-title}{Commands For Changing Text}
@xrdef{Commands For Text-snt}{Section@tie 8.4.3}
@xrdef{Commands For Text-pg}{106}
@xrdef{Commands For Text-pg}{108}
@xrdef{Commands For Killing-title}{Killing And Yanking}
@xrdef{Commands For Killing-snt}{Section@tie 8.4.4}
@xrdef{Commands For Killing-pg}{107}
@xrdef{Commands For Killing-pg}{109}
@xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
@xrdef{Numeric Arguments-snt}{Section@tie 8.4.5}
@xrdef{Commands For Completion-title}{Letting Readline Type For You}
@xrdef{Commands For Completion-snt}{Section@tie 8.4.6}
@xrdef{Numeric Arguments-pg}{108}
@xrdef{Commands For Completion-pg}{108}
@xrdef{Numeric Arguments-pg}{110}
@xrdef{Commands For Completion-pg}{110}
@xrdef{Keyboard Macros-title}{Keyboard Macros}
@xrdef{Keyboard Macros-snt}{Section@tie 8.4.7}
@xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
@xrdef{Miscellaneous Commands-snt}{Section@tie 8.4.8}
@xrdef{Keyboard Macros-pg}{110}
@xrdef{Miscellaneous Commands-pg}{110}
@xrdef{Keyboard Macros-pg}{112}
@xrdef{Miscellaneous Commands-pg}{112}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 8.5}
@xrdef{Readline vi Mode-pg}{112}
@xrdef{Readline vi Mode-pg}{114}
@xrdef{Programmable Completion-title}{Programmable Completion}
@xrdef{Programmable Completion-snt}{Section@tie 8.6}
@xrdef{Programmable Completion-pg}{113}
@xrdef{Programmable Completion-pg}{115}
@xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins}
@xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7}
@xrdef{Programmable Completion Builtins-pg}{115}
@xrdef{Programmable Completion Builtins-pg}{117}
@xrdef{Using History Interactively-title}{Using History Interactively}
@xrdef{Using History Interactively-snt}{Chapter@tie 9}
@xrdef{Bash History Facilities-title}{Bash History Facilities}
@xrdef{Bash History Facilities-snt}{Section@tie 9.1}
@xrdef{Bash History Builtins-title}{Bash History Builtins}
@xrdef{Bash History Builtins-snt}{Section@tie 9.2}
@xrdef{Using History Interactively-pg}{119}
@xrdef{Bash History Facilities-pg}{119}
@xrdef{Bash History Builtins-pg}{119}
@xrdef{Using History Interactively-pg}{121}
@xrdef{Bash History Facilities-pg}{121}
@xrdef{Bash History Builtins-pg}{121}
@xrdef{History Interaction-title}{History Expansion}
@xrdef{History Interaction-snt}{Section@tie 9.3}
@xrdef{Event Designators-title}{Event Designators}
@xrdef{Event Designators-snt}{Section@tie 9.3.1}
@xrdef{History Interaction-pg}{121}
@xrdef{Event Designators-pg}{121}
@xrdef{History Interaction-pg}{123}
@xrdef{Event Designators-pg}{123}
@xrdef{Word Designators-title}{Word Designators}
@xrdef{Word Designators-snt}{Section@tie 9.3.2}
@xrdef{Word Designators-pg}{122}
@xrdef{Word Designators-pg}{124}
@xrdef{Modifiers-title}{Modifiers}
@xrdef{Modifiers-snt}{Section@tie 9.3.3}
@xrdef{Modifiers-pg}{123}
@xrdef{Modifiers-pg}{125}
@xrdef{Installing Bash-title}{Installing Bash}
@xrdef{Installing Bash-snt}{Chapter@tie 10}
@xrdef{Basic Installation-title}{Basic Installation}
@xrdef{Basic Installation-snt}{Section@tie 10.1}
@xrdef{Compilers and Options-title}{Compilers and Options}
@xrdef{Compilers and Options-snt}{Section@tie 10.2}
@xrdef{Installing Bash-pg}{125}
@xrdef{Basic Installation-pg}{125}
@xrdef{Installing Bash-pg}{127}
@xrdef{Basic Installation-pg}{127}
@xrdef{Compiling For Multiple Architectures-title}{Compiling For Multiple Architectures}
@xrdef{Compiling For Multiple Architectures-snt}{Section@tie 10.3}
@xrdef{Installation Names-title}{Installation Names}
@xrdef{Installation Names-snt}{Section@tie 10.4}
@xrdef{Specifying the System Type-title}{Specifying the System Type}
@xrdef{Specifying the System Type-snt}{Section@tie 10.5}
@xrdef{Compilers and Options-pg}{126}
@xrdef{Compiling For Multiple Architectures-pg}{126}
@xrdef{Installation Names-pg}{126}
@xrdef{Specifying the System Type-pg}{126}
@xrdef{Compilers and Options-pg}{128}
@xrdef{Compiling For Multiple Architectures-pg}{128}
@xrdef{Installation Names-pg}{128}
@xrdef{Specifying the System Type-pg}{128}
@xrdef{Sharing Defaults-title}{Sharing Defaults}
@xrdef{Sharing Defaults-snt}{Section@tie 10.6}
@xrdef{Operation Controls-title}{Operation Controls}
@xrdef{Operation Controls-snt}{Section@tie 10.7}
@xrdef{Optional Features-title}{Optional Features}
@xrdef{Optional Features-snt}{Section@tie 10.8}
@xrdef{Sharing Defaults-pg}{127}
@xrdef{Operation Controls-pg}{127}
@xrdef{Optional Features-pg}{127}
@xrdef{Sharing Defaults-pg}{129}
@xrdef{Operation Controls-pg}{129}
@xrdef{Optional Features-pg}{129}
@xrdef{Reporting Bugs-title}{Reporting Bugs}
@xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}}
@xrdef{Reporting Bugs-pg}{133}
@xrdef{Reporting Bugs-pg}{135}
@xrdef{Major Differences From The Bourne Shell-title}{Major Differences From The Bourne Shell}
@xrdef{Major Differences From The Bourne Shell-snt}{Appendix@tie @char66{}}
@xrdef{Major Differences From The Bourne Shell-pg}{135}
@xrdef{Major Differences From The Bourne Shell-pg}{137}
@xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
@xrdef{GNU Free Documentation License-snt}{Appendix@tie @char67{}}
@xrdef{GNU Free Documentation License-pg}{141}
@xrdef{GNU Free Documentation License-pg}{143}
@xrdef{Indexes-title}{Indexes}
@xrdef{Indexes-snt}{Appendix@tie @char68{}}
@xrdef{Builtin Index-title}{Index of Shell Builtin Commands}
@xrdef{Builtin Index-snt}{Section@tie @char68.1}
@xrdef{Indexes-pg}{149}
@xrdef{Builtin Index-pg}{149}
@xrdef{Indexes-pg}{151}
@xrdef{Builtin Index-pg}{151}
@xrdef{Reserved Word Index-title}{Index of Shell Reserved Words}
@xrdef{Reserved Word Index-snt}{Section@tie @char68.2}
@xrdef{Variable Index-title}{Parameter and Variable Index}
@xrdef{Variable Index-snt}{Section@tie @char68.3}
@xrdef{Reserved Word Index-pg}{150}
@xrdef{Variable Index-pg}{150}
@xrdef{Reserved Word Index-pg}{152}
@xrdef{Variable Index-pg}{152}
@xrdef{Function Index-title}{Function Index}
@xrdef{Function Index-snt}{Section@tie @char68.4}
@xrdef{Function Index-pg}{152}
@xrdef{Function Index-pg}{154}
@xrdef{Concept Index-title}{Concept Index}
@xrdef{Concept Index-snt}{Section@tie @char68.5}
@xrdef{Concept Index-pg}{154}
@xrdef{Concept Index-pg}{156}
doc/bashref.bt
+13 -13
View File
@@ -34,7 +34,7 @@
\entry{mapfile}{46}{\code {mapfile}}
\entry{printf}{47}{\code {printf}}
\entry{read}{47}{\code {read}}
\entry{readarray}{48}{\code {readarray}}
\entry{readarray}{49}{\code {readarray}}
\entry{source}{49}{\code {source}}
\entry{type}{49}{\code {type}}
\entry{typeset}{49}{\code {typeset}}
@@ -45,15 +45,15 @@
\entry{dirs}{81}{\code {dirs}}
\entry{popd}{82}{\code {popd}}
\entry{pushd}{82}{\code {pushd}}
\entry{bg}{88}{\code {bg}}
\entry{fg}{88}{\code {fg}}
\entry{jobs}{88}{\code {jobs}}
\entry{kill}{89}{\code {kill}}
\entry{wait}{89}{\code {wait}}
\entry{disown}{89}{\code {disown}}
\entry{suspend}{89}{\code {suspend}}
\entry{compgen}{115}{\code {compgen}}
\entry{complete}{115}{\code {complete}}
\entry{compopt}{118}{\code {compopt}}
\entry{fc}{119}{\code {fc}}
\entry{history}{120}{\code {history}}
\entry{bg}{90}{\code {bg}}
\entry{fg}{90}{\code {fg}}
\entry{jobs}{90}{\code {jobs}}
\entry{kill}{91}{\code {kill}}
\entry{wait}{91}{\code {wait}}
\entry{disown}{91}{\code {disown}}
\entry{suspend}{91}{\code {suspend}}
\entry{compgen}{117}{\code {compgen}}
\entry{complete}{117}{\code {complete}}
\entry{compopt}{120}{\code {compopt}}
\entry{fc}{121}{\code {fc}}
\entry{history}{122}{\code {history}}
doc/bashref.bts
+13 -13
View File
@@ -7,7 +7,7 @@
\initial {A}
\entry {\code {alias}}{41}
\initial {B}
\entry {\code {bg}}{88}
\entry {\code {bg}}{90}
\entry {\code {bind}}{41}
\entry {\code {break}}{35}
\entry {\code {builtin}}{43}
@@ -15,14 +15,14 @@
\entry {\code {caller}}{43}
\entry {\code {cd}}{36}
\entry {\code {command}}{43}
\entry {\code {compgen}}{115}
\entry {\code {complete}}{115}
\entry {\code {compopt}}{118}
\entry {\code {compgen}}{117}
\entry {\code {complete}}{117}
\entry {\code {compopt}}{120}
\entry {\code {continue}}{36}
\initial {D}
\entry {\code {declare}}{43}
\entry {\code {dirs}}{81}
\entry {\code {disown}}{89}
\entry {\code {disown}}{91}
\initial {E}
\entry {\code {echo}}{45}
\entry {\code {enable}}{45}
@@ -31,18 +31,18 @@
\entry {\code {exit}}{36}
\entry {\code {export}}{36}
\initial {F}
\entry {\code {fc}}{119}
\entry {\code {fg}}{88}
\entry {\code {fc}}{121}
\entry {\code {fg}}{90}
\initial {G}
\entry {\code {getopts}}{37}
\initial {H}
\entry {\code {hash}}{37}
\entry {\code {help}}{46}
\entry {\code {history}}{120}
\entry {\code {history}}{122}
\initial {J}
\entry {\code {jobs}}{88}
\entry {\code {jobs}}{90}
\initial {K}
\entry {\code {kill}}{89}
\entry {\code {kill}}{91}
\initial {L}
\entry {\code {let}}{46}
\entry {\code {local}}{46}
@@ -56,7 +56,7 @@
\entry {\code {pwd}}{38}
\initial {R}
\entry {\code {read}}{47}
\entry {\code {readarray}}{48}
\entry {\code {readarray}}{49}
\entry {\code {readonly}}{38}
\entry {\code {return}}{38}
\initial {S}
@@ -64,7 +64,7 @@
\entry {\code {shift}}{38}
\entry {\code {shopt}}{55}
\entry {\code {source}}{49}
\entry {\code {suspend}}{89}
\entry {\code {suspend}}{91}
\initial {T}
\entry {\code {test}}{39}
\entry {\code {times}}{40}
@@ -77,4 +77,4 @@
\entry {\code {unalias}}{50}
\entry {\code {unset}}{41}
\initial {W}
\entry {\code {wait}}{89}
\entry {\code {wait}}{91}
doc/bashref.cp
+30 -30
View File
@@ -36,7 +36,7 @@
\entry{commands, looping}{9}{commands, looping}
\entry{commands, conditional}{10}{commands, conditional}
\entry{commands, grouping}{13}{commands, grouping}
\entry{coprocess}{13}{coprocess}
\entry{coprocess}{14}{coprocess}
\entry{shell function}{14}{shell function}
\entry{functions, shell}{14}{functions, shell}
\entry{parameters}{15}{parameters}
@@ -47,8 +47,8 @@
\entry{expansion}{17}{expansion}
\entry{brace expansion}{18}{brace expansion}
\entry{expansion, brace}{18}{expansion, brace}
\entry{tilde expansion}{18}{tilde expansion}
\entry{expansion, tilde}{18}{expansion, tilde}
\entry{tilde expansion}{19}{tilde expansion}
\entry{expansion, tilde}{19}{expansion, tilde}
\entry{parameter expansion}{19}{parameter expansion}
\entry{expansion, parameter}{19}{expansion, parameter}
\entry{command substitution}{22}{command substitution}
@@ -89,30 +89,30 @@
\entry{prompting}{82}{prompting}
\entry{restricted shell}{84}{restricted shell}
\entry{POSIX Mode}{84}{POSIX Mode}
\entry{job control}{87}{job control}
\entry{foreground}{87}{foreground}
\entry{background}{87}{background}
\entry{suspending jobs}{87}{suspending jobs}
\entry{Readline, how to use}{90}{Readline, how to use}
\entry{interaction, readline}{91}{interaction, readline}
\entry{notation, readline}{92}{notation, readline}
\entry{command editing}{92}{command editing}
\entry{editing command lines}{92}{editing command lines}
\entry{killing text}{93}{killing text}
\entry{yanking text}{93}{yanking text}
\entry{kill ring}{93}{kill ring}
\entry{initialization file, readline}{94}{initialization file, readline}
\entry{variables, readline}{95}{variables, readline}
\entry{programmable completion}{113}{programmable completion}
\entry{completion builtins}{115}{completion builtins}
\entry{History, how to use}{118}{History, how to use}
\entry{command history}{119}{command history}
\entry{history list}{119}{history list}
\entry{history builtins}{119}{history builtins}
\entry{history expansion}{121}{history expansion}
\entry{event designators}{121}{event designators}
\entry{history events}{121}{history events}
\entry{installation}{125}{installation}
\entry{configuration}{125}{configuration}
\entry{Bash installation}{125}{Bash installation}
\entry{Bash configuration}{125}{Bash configuration}
\entry{job control}{89}{job control}
\entry{foreground}{89}{foreground}
\entry{background}{89}{background}
\entry{suspending jobs}{89}{suspending jobs}
\entry{Readline, how to use}{92}{Readline, how to use}
\entry{interaction, readline}{93}{interaction, readline}
\entry{notation, readline}{94}{notation, readline}
\entry{command editing}{94}{command editing}
\entry{editing command lines}{94}{editing command lines}
\entry{killing text}{95}{killing text}
\entry{yanking text}{95}{yanking text}
\entry{kill ring}{95}{kill ring}
\entry{initialization file, readline}{96}{initialization file, readline}
\entry{variables, readline}{97}{variables, readline}
\entry{programmable completion}{115}{programmable completion}
\entry{completion builtins}{117}{completion builtins}
\entry{History, how to use}{120}{History, how to use}
\entry{command history}{121}{command history}
\entry{history list}{121}{history list}
\entry{history builtins}{121}{history builtins}
\entry{history expansion}{123}{history expansion}
\entry{event designators}{123}{event designators}
\entry{history events}{123}{history events}
\entry{installation}{127}{installation}
\entry{configuration}{127}{configuration}
\entry{Bash installation}{127}{Bash installation}
\entry{Bash configuration}{127}{Bash configuration}
doc/bashref.cps
+30 -30
View File
@@ -5,17 +5,17 @@
\entry {arithmetic, shell}{78}
\entry {arrays}{80}
\initial {B}
\entry {background}{87}
\entry {Bash configuration}{125}
\entry {Bash installation}{125}
\entry {background}{89}
\entry {Bash configuration}{127}
\entry {Bash installation}{127}
\entry {Bourne shell}{5}
\entry {brace expansion}{18}
\entry {builtin}{3}
\initial {C}
\entry {command editing}{92}
\entry {command editing}{94}
\entry {command execution}{30}
\entry {command expansion}{29}
\entry {command history}{119}
\entry {command history}{121}
\entry {command search}{30}
\entry {command substitution}{22}
\entry {command timing}{8}
@@ -28,17 +28,17 @@
\entry {commands, shell}{7}
\entry {commands, simple}{8}
\entry {comments, shell}{7}
\entry {completion builtins}{115}
\entry {configuration}{125}
\entry {completion builtins}{117}
\entry {configuration}{127}
\entry {control operator}{3}
\entry {coprocess}{13}
\entry {coprocess}{14}
\initial {D}
\entry {directory stack}{81}
\initial {E}
\entry {editing command lines}{92}
\entry {editing command lines}{94}
\entry {environment}{31}
\entry {evaluation, arithmetic}{78}
\entry {event designators}{121}
\entry {event designators}{123}
\entry {execution environment}{30}
\entry {exit status}{3, 32}
\entry {expansion}{17}
@@ -47,34 +47,34 @@
\entry {expansion, filename}{24}
\entry {expansion, parameter}{19}
\entry {expansion, pathname}{24}
\entry {expansion, tilde}{18}
\entry {expansion, tilde}{19}
\entry {expressions, arithmetic}{78}
\entry {expressions, conditional}{76}
\initial {F}
\entry {field}{3}
\entry {filename}{3}
\entry {filename expansion}{24}
\entry {foreground}{87}
\entry {foreground}{89}
\entry {functions, shell}{14}
\initial {H}
\entry {history builtins}{119}
\entry {history events}{121}
\entry {history expansion}{121}
\entry {history list}{119}
\entry {History, how to use}{118}
\entry {history builtins}{121}
\entry {history events}{123}
\entry {history expansion}{123}
\entry {history list}{121}
\entry {History, how to use}{120}
\initial {I}
\entry {identifier}{3}
\entry {initialization file, readline}{94}
\entry {installation}{125}
\entry {interaction, readline}{91}
\entry {initialization file, readline}{96}
\entry {installation}{127}
\entry {interaction, readline}{93}
\entry {interactive shell}{73, 75}
\entry {internationalization}{7}
\initial {J}
\entry {job}{3}
\entry {job control}{3, 87}
\entry {job control}{3, 89}
\initial {K}
\entry {kill ring}{93}
\entry {killing text}{93}
\entry {kill ring}{95}
\entry {killing text}{95}
\initial {L}
\entry {localization}{7}
\entry {login shell}{73}
@@ -84,7 +84,7 @@
\initial {N}
\entry {name}{3}
\entry {native languages}{7}
\entry {notation, readline}{92}
\entry {notation, readline}{94}
\initial {O}
\entry {operator, shell}{3}
\initial {P}
@@ -100,13 +100,13 @@
\entry {process group}{3}
\entry {process group ID}{3}
\entry {process substitution}{23}
\entry {programmable completion}{113}
\entry {programmable completion}{115}
\entry {prompting}{82}
\initial {Q}
\entry {quoting}{6}
\entry {quoting, ANSI}{6}
\initial {R}
\entry {Readline, how to use}{90}
\entry {Readline, how to use}{92}
\entry {redirection}{26}
\entry {reserved word}{3}
\entry {restricted shell}{84}
@@ -121,16 +121,16 @@
\entry {signal handling}{32}
\entry {special builtin}{4, 59}
\entry {startup files}{73}
\entry {suspending jobs}{87}
\entry {suspending jobs}{89}
\initial {T}
\entry {tilde expansion}{18}
\entry {tilde expansion}{19}
\entry {token}{4}
\entry {translation, native languages}{7}
\initial {V}
\entry {variable, shell}{15}
\entry {variables, readline}{95}
\entry {variables, readline}{97}
\initial {W}
\entry {word}{4}
\entry {word splitting}{23}
\initial {Y}
\entry {yanking text}{93}
\entry {yanking text}{95}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.fn
+103 -103
View File
@@ -1,103 +1,103 @@
\entry{beginning-of-line (C-a)}{104}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{104}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{104}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{104}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{104}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{104}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{104}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{104}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{104}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{104}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{105}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{105}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{105}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{105}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{105}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{105}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{105}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{105}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{105}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{105}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{105}{\code {history-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{105}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{106}{\code {yank-last-arg (M-. or M-_)}}
\entry{delete-char (C-d)}{106}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{106}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{106}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{106}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{106}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{transpose-chars (C-t)}{106}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{106}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{106}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{106}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{107}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{107}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{107}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{107}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{107}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{107}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{107}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{107}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{107}{\code {shell-kill-word ()}}
\entry{backward-kill-word ()}{107}{\code {backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{107}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{107}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{107}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{108}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{108}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{108}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{108}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{108}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{108}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{108}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{108}{\code {universal-argument ()}}
\entry{complete (TAB)}{108}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{108}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{109}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{109}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{109}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{109}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{109}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{109}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{109}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{109}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{109}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{109}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{109}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{109}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{109}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{110}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{110}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{110}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-{\tt \char 123})}{110}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{110}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{110}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{110}{\code {call-last-kbd-macro (C-x e)}}
\entry{re-read-init-file (C-x C-r)}{110}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{110}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{110}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{110}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{110}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{110}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{111}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{111}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{111}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{111}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{111}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{111}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{111}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{111}{\code {dump-functions ()}}
\entry{dump-variables ()}{111}{\code {dump-variables ()}}
\entry{dump-macros ()}{111}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{112}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{112}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{112}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{112}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{112}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{112}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{112}{\code {magic-space ()}}
\entry{alias-expand-line ()}{112}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{112}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{112}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{112}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{112}{\code {edit-and-execute-command (C-xC-e)}}
\entry{beginning-of-line (C-a)}{106}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{106}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{106}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{106}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{106}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{106}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{106}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{106}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{106}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{106}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{107}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{107}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{107}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{107}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{107}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{107}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{107}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{107}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{107}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{107}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{107}{\code {history-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{107}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{108}{\code {yank-last-arg (M-. or M-_)}}
\entry{delete-char (C-d)}{108}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{108}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{108}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{108}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{108}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{transpose-chars (C-t)}{108}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{108}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{108}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{108}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{109}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{109}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{109}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{109}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{109}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{109}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{109}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{109}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{109}{\code {shell-kill-word ()}}
\entry{backward-kill-word ()}{109}{\code {backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{109}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{109}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{109}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{110}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{110}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{110}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{110}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{110}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{110}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{110}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{110}{\code {universal-argument ()}}
\entry{complete (TAB)}{110}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{110}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{111}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{111}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{111}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{111}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{111}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{111}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{111}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{111}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{111}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{111}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{111}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{111}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{111}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{112}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{112}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{112}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-{\tt \char 123})}{112}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{112}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{112}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{112}{\code {call-last-kbd-macro (C-x e)}}
\entry{re-read-init-file (C-x C-r)}{112}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{112}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{112}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{112}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{112}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{112}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{113}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{113}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{113}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{113}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{113}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{113}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{113}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{113}{\code {dump-functions ()}}
\entry{dump-variables ()}{113}{\code {dump-variables ()}}
\entry{dump-macros ()}{113}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{114}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{114}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{114}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{114}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{114}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{114}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{114}{\code {magic-space ()}}
\entry{alias-expand-line ()}{114}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{114}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{114}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{114}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{114}{\code {edit-and-execute-command (C-xC-e)}}
doc/bashref.fns
+103 -103
View File
@@ -1,123 +1,123 @@
\initial {A}
\entry {\code {abort (C-g)}}{110}
\entry {\code {accept-line (Newline or Return)}}{105}
\entry {\code {alias-expand-line ()}}{112}
\entry {\code {abort (C-g)}}{112}
\entry {\code {accept-line (Newline or Return)}}{107}
\entry {\code {alias-expand-line ()}}{114}
\initial {B}
\entry {\code {backward-char (C-b)}}{104}
\entry {\code {backward-delete-char (Rubout)}}{106}
\entry {\code {backward-kill-line (C-x Rubout)}}{107}
\entry {\code {backward-kill-word ()}}{107}
\entry {\code {backward-kill-word (M-\key {DEL})}}{107}
\entry {\code {backward-word (M-b)}}{104}
\entry {\code {beginning-of-history (M-<)}}{105}
\entry {\code {beginning-of-line (C-a)}}{104}
\entry {\code {backward-char (C-b)}}{106}
\entry {\code {backward-delete-char (Rubout)}}{108}
\entry {\code {backward-kill-line (C-x Rubout)}}{109}
\entry {\code {backward-kill-word ()}}{109}
\entry {\code {backward-kill-word (M-\key {DEL})}}{109}
\entry {\code {backward-word (M-b)}}{106}
\entry {\code {beginning-of-history (M-<)}}{107}
\entry {\code {beginning-of-line (C-a)}}{106}
\initial {C}
\entry {\code {call-last-kbd-macro (C-x e)}}{110}
\entry {\code {capitalize-word (M-c)}}{107}
\entry {\code {character-search (C-])}}{111}
\entry {\code {character-search-backward (M-C-])}}{111}
\entry {\code {clear-screen (C-l)}}{104}
\entry {\code {complete (\key {TAB})}}{108}
\entry {\code {complete-command (M-!)}}{109}
\entry {\code {complete-filename (M-/)}}{109}
\entry {\code {complete-hostname (M-@)}}{109}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{110}
\entry {\code {complete-username (M-~)}}{109}
\entry {\code {complete-variable (M-$)}}{109}
\entry {\code {copy-backward-word ()}}{108}
\entry {\code {copy-forward-word ()}}{108}
\entry {\code {copy-region-as-kill ()}}{108}
\entry {\code {call-last-kbd-macro (C-x e)}}{112}
\entry {\code {capitalize-word (M-c)}}{109}
\entry {\code {character-search (C-])}}{113}
\entry {\code {character-search-backward (M-C-])}}{113}
\entry {\code {clear-screen (C-l)}}{106}
\entry {\code {complete (\key {TAB})}}{110}
\entry {\code {complete-command (M-!)}}{111}
\entry {\code {complete-filename (M-/)}}{111}
\entry {\code {complete-hostname (M-@)}}{111}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{112}
\entry {\code {complete-username (M-~)}}{111}
\entry {\code {complete-variable (M-$)}}{111}
\entry {\code {copy-backward-word ()}}{110}
\entry {\code {copy-forward-word ()}}{110}
\entry {\code {copy-region-as-kill ()}}{110}
\initial {D}
\entry {\code {dabbrev-expand ()}}{110}
\entry {\code {delete-char (C-d)}}{106}
\entry {\code {delete-char-or-list ()}}{109}
\entry {\code {delete-horizontal-space ()}}{107}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{108}
\entry {\code {display-shell-version (C-x C-v)}}{112}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{110}
\entry {\code {downcase-word (M-l)}}{106}
\entry {\code {dump-functions ()}}{111}
\entry {\code {dump-macros ()}}{111}
\entry {\code {dump-variables ()}}{111}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{110}
\entry {\code {dabbrev-expand ()}}{112}
\entry {\code {delete-char (C-d)}}{108}
\entry {\code {delete-char-or-list ()}}{111}
\entry {\code {delete-horizontal-space ()}}{109}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{110}
\entry {\code {display-shell-version (C-x C-v)}}{114}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{112}
\entry {\code {downcase-word (M-l)}}{108}
\entry {\code {dump-functions ()}}{113}
\entry {\code {dump-macros ()}}{113}
\entry {\code {dump-variables ()}}{113}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{112}
\initial {E}
\entry {\code {edit-and-execute-command (C-xC-e)}}{112}
\entry {\code {end-kbd-macro (C-x ))}}{110}
\entry {\code {end-of-history (M->)}}{105}
\entry {\code {end-of-line (C-e)}}{104}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{111}
\entry {\code {edit-and-execute-command (C-xC-e)}}{114}
\entry {\code {end-kbd-macro (C-x ))}}{112}
\entry {\code {end-of-history (M->)}}{107}
\entry {\code {end-of-line (C-e)}}{106}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{113}
\initial {F}
\entry {\code {forward-backward-delete-char ()}}{106}
\entry {\code {forward-char (C-f)}}{104}
\entry {\code {forward-search-history (C-s)}}{105}
\entry {\code {forward-word (M-f)}}{104}
\entry {\code {forward-backward-delete-char ()}}{108}
\entry {\code {forward-char (C-f)}}{106}
\entry {\code {forward-search-history (C-s)}}{107}
\entry {\code {forward-word (M-f)}}{106}
\initial {G}
\entry {\code {glob-complete-word (M-g)}}{112}
\entry {\code {glob-expand-word (C-x *)}}{112}
\entry {\code {glob-list-expansions (C-x g)}}{112}
\entry {\code {glob-complete-word (M-g)}}{114}
\entry {\code {glob-expand-word (C-x *)}}{114}
\entry {\code {glob-list-expansions (C-x g)}}{114}
\initial {H}
\entry {\code {history-and-alias-expand-line ()}}{112}
\entry {\code {history-expand-line (M-^)}}{112}
\entry {\code {history-search-backward ()}}{105}
\entry {\code {history-search-forward ()}}{105}
\entry {\code {history-and-alias-expand-line ()}}{114}
\entry {\code {history-expand-line (M-^)}}{114}
\entry {\code {history-search-backward ()}}{107}
\entry {\code {history-search-forward ()}}{107}
\initial {I}
\entry {\code {insert-comment (M-#)}}{111}
\entry {\code {insert-completions (M-*)}}{109}
\entry {\code {insert-last-argument (M-. or M-_)}}{112}
\entry {\code {insert-comment (M-#)}}{113}
\entry {\code {insert-completions (M-*)}}{111}
\entry {\code {insert-last-argument (M-. or M-_)}}{114}
\initial {K}
\entry {\code {kill-line (C-k)}}{107}
\entry {\code {kill-region ()}}{108}
\entry {\code {kill-whole-line ()}}{107}
\entry {\code {kill-word (M-d)}}{107}
\entry {\code {kill-line (C-k)}}{109}
\entry {\code {kill-region ()}}{110}
\entry {\code {kill-whole-line ()}}{109}
\entry {\code {kill-word (M-d)}}{109}
\initial {M}
\entry {\code {magic-space ()}}{112}
\entry {\code {menu-complete ()}}{109}
\entry {\code {menu-complete-backward ()}}{109}
\entry {\code {magic-space ()}}{114}
\entry {\code {menu-complete ()}}{111}
\entry {\code {menu-complete-backward ()}}{111}
\initial {N}
\entry {\code {next-history (C-n)}}{105}
\entry {\code {non-incremental-forward-search-history (M-n)}}{105}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{105}
\entry {\code {next-history (C-n)}}{107}
\entry {\code {non-incremental-forward-search-history (M-n)}}{107}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{107}
\initial {O}
\entry {\code {operate-and-get-next (C-o)}}{112}
\entry {\code {overwrite-mode ()}}{107}
\entry {\code {operate-and-get-next (C-o)}}{114}
\entry {\code {overwrite-mode ()}}{109}
\initial {P}
\entry {\code {possible-command-completions (C-x !)}}{110}
\entry {\code {possible-completions (M-?)}}{108}
\entry {\code {possible-filename-completions (C-x /)}}{109}
\entry {\code {possible-hostname-completions (C-x @)}}{109}
\entry {\code {possible-username-completions (C-x ~)}}{109}
\entry {\code {possible-variable-completions (C-x $)}}{109}
\entry {\code {prefix-meta (\key {ESC})}}{110}
\entry {\code {previous-history (C-p)}}{105}
\entry {\code {possible-command-completions (C-x !)}}{112}
\entry {\code {possible-completions (M-?)}}{110}
\entry {\code {possible-filename-completions (C-x /)}}{111}
\entry {\code {possible-hostname-completions (C-x @)}}{111}
\entry {\code {possible-username-completions (C-x ~)}}{111}
\entry {\code {possible-variable-completions (C-x $)}}{111}
\entry {\code {prefix-meta (\key {ESC})}}{112}
\entry {\code {previous-history (C-p)}}{107}
\initial {Q}
\entry {\code {quoted-insert (C-q or C-v)}}{106}
\entry {\code {quoted-insert (C-q or C-v)}}{108}
\initial {R}
\entry {\code {re-read-init-file (C-x C-r)}}{110}
\entry {\code {redraw-current-line ()}}{104}
\entry {\code {reverse-search-history (C-r)}}{105}
\entry {\code {revert-line (M-r)}}{110}
\entry {\code {re-read-init-file (C-x C-r)}}{112}
\entry {\code {redraw-current-line ()}}{106}
\entry {\code {reverse-search-history (C-r)}}{107}
\entry {\code {revert-line (M-r)}}{112}
\initial {S}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{106}
\entry {\code {set-mark (C-@)}}{111}
\entry {\code {shell-backward-word ()}}{104}
\entry {\code {shell-expand-line (M-C-e)}}{112}
\entry {\code {shell-forward-word ()}}{104}
\entry {\code {shell-kill-word ()}}{107}
\entry {\code {skip-csi-sequence ()}}{111}
\entry {\code {start-kbd-macro (C-x ()}}{110}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{108}
\entry {\code {set-mark (C-@)}}{113}
\entry {\code {shell-backward-word ()}}{106}
\entry {\code {shell-expand-line (M-C-e)}}{114}
\entry {\code {shell-forward-word ()}}{106}
\entry {\code {shell-kill-word ()}}{109}
\entry {\code {skip-csi-sequence ()}}{113}
\entry {\code {start-kbd-macro (C-x ()}}{112}
\initial {T}
\entry {\code {tilde-expand (M-&)}}{111}
\entry {\code {transpose-chars (C-t)}}{106}
\entry {\code {transpose-words (M-t)}}{106}
\entry {\code {tilde-expand (M-&)}}{113}
\entry {\code {transpose-chars (C-t)}}{108}
\entry {\code {transpose-words (M-t)}}{108}
\initial {U}
\entry {\code {undo (C-_ or C-x C-u)}}{110}
\entry {\code {universal-argument ()}}{108}
\entry {\code {unix-filename-rubout ()}}{107}
\entry {\code {unix-line-discard (C-u)}}{107}
\entry {\code {unix-word-rubout (C-w)}}{107}
\entry {\code {upcase-word (M-u)}}{106}
\entry {\code {undo (C-_ or C-x C-u)}}{112}
\entry {\code {universal-argument ()}}{110}
\entry {\code {unix-filename-rubout ()}}{109}
\entry {\code {unix-line-discard (C-u)}}{109}
\entry {\code {unix-word-rubout (C-w)}}{109}
\entry {\code {upcase-word (M-u)}}{108}
\initial {Y}
\entry {\code {yank (C-y)}}{108}
\entry {\code {yank-last-arg (M-. or M-_)}}{106}
\entry {\code {yank-nth-arg (M-C-y)}}{105}
\entry {\code {yank-pop (M-y)}}{108}
\entry {\code {yank (C-y)}}{110}
\entry {\code {yank-last-arg (M-. or M-_)}}{108}
\entry {\code {yank-nth-arg (M-C-y)}}{107}
\entry {\code {yank-pop (M-y)}}{110}
doc/bashref.html
+33 -9
View File
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on September, 16 2009 by texi2html 1.64 -->
<!-- Created on October, 12 2009 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -33,10 +33,10 @@ Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
<H1>Bash Reference Manual</H1></P><P>
This text is a brief description of the features that are present in
the Bash shell (version 4.1, 16 September 2009).
the Bash shell (version 4.1, 9 October 2009).
</P><P>
This is Edition 4.1, last updated 16 September 2009,
This is Edition 4.1, last updated 9 October 2009,
of <CITE>The GNU Bash Reference Manual</CITE>,
for <CODE>Bash</CODE>, Version 4.1.
</P><P>
@@ -1318,6 +1318,10 @@ Conditional operators such as <SAMP>`-f'</SAMP> must be unquoted to be recognize
as primaries.
</P><P>
When used with <SAMP>`[['</SAMP>, The <SAMP>`&#60;'</SAMP> and <SAMP>`&#62;'</SAMP> operators sort
lexicographically using the current locale.
</P><P>
When the <SAMP>`=='</SAMP> and <SAMP>`!='</SAMP> operators are used, the string to the
right of the operator is considered a pattern and matched according
to the rules described below in <A HREF="bashref.html#SEC37">3.5.8.1 Pattern Matching</A>.
@@ -2159,7 +2163,7 @@ is followed by a character that is not to be
interpreted as part of its name.
</P><P>
If the first character of <VAR>parameter</VAR> is an exclamation point,
If the first character of <VAR>parameter</VAR> is an exclamation point (!),
a level of variable indirection is introduced.
Bash uses the value of the variable formed from the rest of
<VAR>parameter</VAR> as the name of the variable; this variable is then
@@ -2794,7 +2798,7 @@ may instead be preceded by a word of the form {<VAR>varname</VAR>}.
In this case, for each redirection operator except
&#62;&#38;- and &#60;&#38;-, the shell will allocate a file descriptor greater
than 10 and assign it to {<VAR>varname</VAR>}. If &#62;&#38;- or &#60;&#38;- is preceded
by {<VAR>varname</VAR>}, the value of {<VAR>varname</VAR>} defines the file
by {<VAR>varname</VAR>}, the value of <VAR>varname</VAR> defines the file
descriptor to close.
</P><P>
@@ -4812,7 +4816,7 @@ non-zero on failure.
<DT><CODE>read</CODE>
<DD><A NAME="IDX103"></A>
<TABLE><tr><td>&nbsp;</td><td class=example><pre>read [-ers] [-a <VAR>aname</VAR>] [-d <VAR>delim</VAR>] [-i <VAR>text</VAR>] [-n <VAR>nchars</VAR>] [-p <VAR>prompt</VAR>] [-t <VAR>timeout</VAR>] [-u <VAR>fd</VAR>] [<VAR>name</VAR> <small>...</small>]
<TABLE><tr><td>&nbsp;</td><td class=example><pre>read [-ers] [-a <VAR>aname</VAR>] [-d <VAR>delim</VAR>] [-i <VAR>text</VAR>] [-n <VAR>nchars</VAR>] [-N <VAR>nchars</VAR>] [-p <VAR>prompt</VAR>] [-t <VAR>timeout</VAR>] [-u <VAR>fd</VAR>] [<VAR>name</VAR> <small>...</small>]
</pre></td></tr></table>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
is assigned to the first <VAR>name</VAR>, the second word to the second <VAR>name</VAR>,
@@ -4860,7 +4864,14 @@ the editing buffer before editing begins.
<DT><CODE>-n <VAR>nchars</VAR></CODE>
<DD><CODE>read</CODE> returns after reading <VAR>nchars</VAR> characters rather than
waiting for a complete line of input.
waiting for a complete line of input, but honor a delimiter if fewer
than <VAR>nchars</VAR> characters are read before the delimiter.
<P>
<DT><CODE>-N <VAR>nchars</VAR></CODE>
<DD><CODE>read</CODE> returns after reading exactly <VAR>nchars</VAR> characters rather
than waiting for a complete line of input, unless EOF is encountered or
<CODE>read</CODE> times out. Any delimiter is ignored.
<P>
<DT><CODE>-p <VAR>prompt</VAR></CODE>
@@ -8621,6 +8632,12 @@ The <CODE>ulimit</CODE> builtin uses a block size of 512 bytes for the <SAMP>`-c
and <SAMP>`-f'</SAMP> options.
<P>
<LI>
The arrival of <CODE>SIGCHLD</CODE> when a trap is set on <CODE>SIGCHLD</CODE> does
not interrupt the <CODE>wait</CODE> builtin and cause it to return immediately.
The trap command is run once for each child that exits.
<P>
</OL>
<P>
@@ -9643,6 +9660,13 @@ keypad when it is called. Some systems need this to enable the
arrow keys. The default is <SAMP>`off'</SAMP>.
<P>
<DT><CODE>enable-meta-key</CODE>
<DD>When set to <SAMP>`on'</SAMP>, Readline will try to enable any meta modifier
key the terminal claims to support when it is called. On many terminals,
the meta key is used to send eight-bit characters.
The default is <SAMP>`on'</SAMP>.
<P>
<DT><CODE>expand-tilde</CODE>
<DD><A NAME="IDX316"></A>
If set to <SAMP>`on'</SAMP>, tilde expansion is performed when Readline
@@ -16019,7 +16043,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="bashref.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
This document was generated by <I>Chet Ramey</I> on <I>September, 16 2009</I>
This document was generated by <I>Chet Ramey</I> on <I>October, 12 2009</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -16181,7 +16205,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
by <I>Chet Ramey</I> on <I>September, 16 2009</I>
by <I>Chet Ramey</I> on <I>October, 12 2009</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
doc/bashref.log
+32 -32
View File
@@ -1,4 +1,4 @@
This is TeX, Version 3.141592 (Web2C 7.5.4) (format=tex 2008.12.11) 16 SEP 2009 21:37
This is TeX, Version 3.141592 (Web2C 7.5.4) (format=tex 2008.12.11) 12 OCT 2009 10:07
**/Users/chet/src/bash/src/doc/bashref.texi
(/Users/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
Loading texinfo [version 2009-01-18.17]:
@@ -193,7 +193,7 @@ textttsl pat-tern@texttt ][]) @textttsl command-list @texttt ;;][] esac[][]
[10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24]
[25] [26] [27] [28] [29] [30] [31] [32] Chapter 4 [33] [34] [35] [36] [37]
[38] [39] [40] [41]
Underfull \hbox (badness 5231) in paragraph at lines 3294--3307
Underfull \hbox (badness 5231) in paragraph at lines 3297--3310
@texttt emacs-meta[]@textrm , @texttt emacs-ctlx[]@textrm , @texttt vi[]@textr
m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
@@ -206,10 +206,10 @@ m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
.etc.
[42] [43] [44] [45] [46]
Overfull \hbox (102.08961pt too wide) in paragraph at lines 3719--3719
Overfull \hbox (172.34125pt too wide) in paragraph at lines 3722--3722
[]@texttt read [-ers] [-a @textttsl aname@texttt ] [-d @textttsl de-lim@texttt
] [-i @textttsl text@texttt ] [-n @textttsl nchars@texttt ] [-p @textttsl prom
pt@texttt ] [-t @textttsl time-
] [-i @textttsl text@texttt ] [-n @textttsl nchars@texttt ] [-N @textttsl ncha
rs@texttt ] [-p @textttsl prompt@texttt ] [-t @textttsl time-
@hbox(7.60416+2.43333)x433.62
.@glue(@leftskip) 86.72375
@@ -220,7 +220,7 @@ pt@texttt ] [-t @textttsl time-
.etc.
[47] [48] [49] [50] [51] [52] [53] [54] [55]
Underfull \hbox (badness 2573) in paragraph at lines 4398--4402
Underfull \hbox (badness 2573) in paragraph at lines 4407--4411
[]@textrm Error trac-ing is en-abled: com-mand sub-sti-tu-tion, shell
@hbox(7.60416+2.12917)x433.62, glue set 2.95305
@@ -237,7 +237,7 @@ Underfull \hbox (badness 2573) in paragraph at lines 4398--4402
[56] [57] [58] Chapter 5 [59] [60] [61] [62] [63] [64] [65] [66] [67] [68]
[69] Chapter 6 [70]
Overfull \hbox (51.96864pt too wide) in paragraph at lines 5266--5266
Overfull \hbox (51.96864pt too wide) in paragraph at lines 5275--5275
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -250,7 +250,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (76.23077pt too wide) in paragraph at lines 5267--5267
Overfull \hbox (76.23077pt too wide) in paragraph at lines 5276--5276
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -264,7 +264,7 @@ Overfull \hbox (76.23077pt too wide) in paragraph at lines 5267--5267
.etc.
Overfull \hbox (34.72258pt too wide) in paragraph at lines 5268--5268
Overfull \hbox (34.72258pt too wide) in paragraph at lines 5277--5277
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -277,7 +277,7 @@ tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
[71] [72]
Underfull \hbox (badness 2245) in paragraph at lines 5442--5444
Underfull \hbox (badness 2245) in paragraph at lines 5451--5453
[]@textrm When a lo-gin shell ex-its, Bash reads and ex-e-cutes com-mands from
the file
@@ -290,7 +290,7 @@ the file
.etc.
[73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85]
Underfull \hbox (badness 2521) in paragraph at lines 6581--6584
Underfull \hbox (badness 2521) in paragraph at lines 6595--6598
@textrm `@texttt --enable-strict-posix-default[]@textrm '[] to @texttt configur
e[] @textrm when build-ing (see Sec-tion 10.8
@@ -302,10 +302,10 @@ e[] @textrm when build-ing (see Sec-tion 10.8
.@texttt n
.etc.
Chapter 7 [86] [87] [88] [89]
(/Users/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [90] [91]
[92] [93] [94] [95] [96]
Underfull \hbox (badness 5231) in paragraph at lines 529--545
Chapter 7 [86] [87] [88] [89] [90] [91]
(/Users/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [92] [93]
[94] [95] [96] [97] [98]
Underfull \hbox (badness 5231) in paragraph at lines 535--551
@texttt emacs-meta[]@textrm , @texttt emacs-ctlx[]@textrm , @texttt vi[]@textr
m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
@@ -317,8 +317,8 @@ m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
.@texttt c
.etc.
[97] [98] [99] [100] [101]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 865--865
[99] [100] [101] [102] [103]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 871--871
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -330,9 +330,9 @@ gnored[]
.@texttt t
.etc.
[102] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113]
[114]
Overfull \hbox (12.05716pt too wide) in paragraph at lines 1783--1783
[104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115]
[116]
Overfull \hbox (12.05716pt too wide) in paragraph at lines 1789--1789
[]@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-DE] [-
A @textttsl ac-tion@texttt ] [-
@@ -344,8 +344,8 @@ A @textttsl ac-tion@texttt ] [-
.@texttt m
.etc.
[115] [116]
Underfull \hbox (badness 2753) in paragraph at lines 1893--1896
[117] [118]
Underfull \hbox (badness 2753) in paragraph at lines 1899--1902
@texttt hostname[]@textrm Hostnames, as taken from the file spec-i-fied by
@hbox(7.60416+2.12917)x433.62, glue set 3.02202
@@ -356,9 +356,9 @@ Underfull \hbox (badness 2753) in paragraph at lines 1893--1896
.@texttt o
.etc.
[117]) (/Users/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[118] [119] [120] [121] [122]) Chapter 10 [123] [124] [125] [126] [127]
Underfull \hbox (badness 2772) in paragraph at lines 7182--7186
[119]) (/Users/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[120] [121] [122] [123] [124]) Chapter 10 [125] [126] [127] [128] [129]
Underfull \hbox (badness 2772) in paragraph at lines 7196--7200
[]@textrm Enable sup-port for large files (@texttt http://www.sas.com/standard
s/large_
@@ -370,18 +370,18 @@ s/large_
.@textrm a
.etc.
[128] [129] [130] Appendix A [131] [132] Appendix B [133] [134] [135] [136]
[137] [138] [139] Appendix C [140] (./fdl.texi [141] [142] [143] [144] [145]
[146] [147]) Appendix D [148] (./bashref.bts) [149] (./bashref.rws)
(./bashref.vrs [150] [151]) (./bashref.fns [152] [153]) (./bashref.cps [154])
[155] [156] )
[130] [131] [132] Appendix A [133] [134] Appendix B [135] [136] [137] [138]
[139] [140] [141] Appendix C [142] (./fdl.texi [143] [144] [145] [146] [147]
[148] [149]) Appendix D [150] (./bashref.bts) [151] (./bashref.rws)
(./bashref.vrs [152] [153]) (./bashref.fns [154] [155]) (./bashref.cps [156])
[157] [158] )
Here is how much of TeX's memory you used:
2078 strings out of 97980
28503 string characters out of 1221004
65674 words of memory out of 1500000
65668 words of memory out of 1500000
2894 multiletter control sequences out of 10000+50000
32127 words of font info for 112 fonts, out of 1200000 for 2000
51 hyphenation exceptions out of 8191
16i,6n,14p,315b,699s stack positions out of 5000i,500n,6000p,200000b,5000s
Output written on bashref.dvi (162 pages, 661824 bytes).
Output written on bashref.dvi (164 pages, 663028 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1699 -1669
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+4 -3
View File
@@ -3648,7 +3648,7 @@ parent.
mapfile [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}] [
-C @var{callback}] [-c @var{quantum}] [@var{array}]
@end example
Read lines from the standard input into array variable @var{array},
Read lines from the standard input into the indexed array variable @var{array},
or from file descriptor @var{fd}
if the @option{-u} option is supplied.
The variable @code{MAPFILE} is the default @var{array}.
@@ -3684,7 +3684,8 @@ If not supplied with an explicit origin, @code{mapfile} will clear @var{array}
before assigning to it.
@code{mapfile} returns successfully unless an invalid option or option
argument is supplied, or @var{array} is invalid or unassignable.
argument is supplied, @var{array} is invalid or unassignable, or @var{array}
is not an indexed array.
@item printf
@btindex printf
@@ -3808,7 +3809,7 @@ Read input from file descriptor @var{fd}.
readarray [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}] [
-C @var{callback}] [-c @var{quantum}] [@var{array}]
@end example
Read lines from the standard input into array variable @var{array},
Read lines from the standard input into the indexed array variable @var{array},
or from file descriptor @var{fd}
if the @option{-u} option is supplied.
doc/bashref.texi~
+8 -2
View File
@@ -3719,7 +3719,7 @@ non-zero on failure.
@item read
@btindex read
@example
read [-ers] [-a @var{aname}] [-d @var{delim}] [-i @var{text}] [-n @var{nchars}] [-p @var{prompt}] [-t @var{timeout}] [-u @var{fd}] [@var{name} @dots{}]
read [-ers] [-a @var{aname}] [-d @var{delim}] [-i @var{text}] [-n @var{nchars}] [-N @var{nchars}] [-p @var{prompt}] [-t @var{timeout}] [-u @var{fd}] [@var{name} @dots{}]
@end example
One line is read from the standard input, or from the file descriptor
@var{fd} supplied as an argument to the @option{-u} option, and the first word
@@ -3762,7 +3762,13 @@ the editing buffer before editing begins.
@item -n @var{nchars}
@code{read} returns after reading @var{nchars} characters rather than
waiting for a complete line of input.
waiting for a complete line of input, but honor a delimiter if fewer
than @var{nchars} characters are read before the delimiter.
@item -N @var{nchars}
@code{read} returns after reading exactly @var{nchars} characters rather
than waiting for a complete line of input, unless EOF is encountered or
@code{read} times out. Any delimiter is ignored.
@item -p @var{prompt}
Display @var{prompt}, without a trailing newline, before attempting
doc/bashref.toc
+56 -56
View File
@@ -20,14 +20,14 @@
@numsubsubsecentry{Looping Constructs}{3.2.4.1}{Looping Constructs}{9}
@numsubsubsecentry{Conditional Constructs}{3.2.4.2}{Conditional Constructs}{10}
@numsubsubsecentry{Grouping Commands}{3.2.4.3}{Command Grouping}{13}
@numsubsecentry{Coprocesses}{3.2.5}{Coprocesses}{13}
@numsubsecentry{Coprocesses}{3.2.5}{Coprocesses}{14}
@numsecentry{Shell Functions}{3.3}{Shell Functions}{14}
@numsecentry{Shell Parameters}{3.4}{Shell Parameters}{15}
@numsubsecentry{Positional Parameters}{3.4.1}{Positional Parameters}{16}
@numsubsecentry{Special Parameters}{3.4.2}{Special Parameters}{16}
@numsecentry{Shell Expansions}{3.5}{Shell Expansions}{17}
@numsubsecentry{Brace Expansion}{3.5.1}{Brace Expansion}{18}
@numsubsecentry{Tilde Expansion}{3.5.2}{Tilde Expansion}{18}
@numsubsecentry{Tilde Expansion}{3.5.2}{Tilde Expansion}{19}
@numsubsecentry{Shell Parameter Expansion}{3.5.3}{Shell Parameter Expansion}{19}
@numsubsecentry{Command Substitution}{3.5.4}{Command Substitution}{22}
@numsubsecentry{Arithmetic Expansion}{3.5.5}{Arithmetic Expansion}{23}
@@ -81,57 +81,57 @@
@numsecentry{Controlling the Prompt}{6.9}{Printing a Prompt}{82}
@numsecentry{The Restricted Shell}{6.10}{The Restricted Shell}{84}
@numsecentry{Bash POSIX Mode}{6.11}{Bash POSIX Mode}{84}
@numchapentry{Job Control}{7}{Job Control}{87}
@numsecentry{Job Control Basics}{7.1}{Job Control Basics}{87}
@numsecentry{Job Control Builtins}{7.2}{Job Control Builtins}{88}
@numsecentry{Job Control Variables}{7.3}{Job Control Variables}{90}
@numchapentry{Command Line Editing}{8}{Command Line Editing}{91}
@numsecentry{Introduction to Line Editing}{8.1}{Introduction and Notation}{91}
@numsecentry{Readline Interaction}{8.2}{Readline Interaction}{91}
@numsubsecentry{Readline Bare Essentials}{8.2.1}{Readline Bare Essentials}{92}
@numsubsecentry{Readline Movement Commands}{8.2.2}{Readline Movement Commands}{92}
@numsubsecentry{Readline Killing Commands}{8.2.3}{Readline Killing Commands}{93}
@numsubsecentry{Readline Arguments}{8.2.4}{Readline Arguments}{93}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{93}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{94}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{94}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{100}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{101}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{104}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{104}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{105}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{106}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{107}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{108}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{108}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{110}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{110}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{112}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{113}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{115}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{119}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{119}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{119}
@numsecentry{History Expansion}{9.3}{History Interaction}{121}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{121}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{122}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{123}
@numchapentry{Installing Bash}{10}{Installing Bash}{125}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{125}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{126}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{126}
@numsecentry{Installation Names}{10.4}{Installation Names}{126}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{126}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{127}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{127}
@numsecentry{Optional Features}{10.8}{Optional Features}{127}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{133}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{135}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{139}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{141}
@appentry{Indexes}{D}{Indexes}{149}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{149}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{150}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{150}
@appsecentry{Function Index}{D.4}{Function Index}{152}
@appsecentry{Concept Index}{D.5}{Concept Index}{154}
@numchapentry{Job Control}{7}{Job Control}{89}
@numsecentry{Job Control Basics}{7.1}{Job Control Basics}{89}
@numsecentry{Job Control Builtins}{7.2}{Job Control Builtins}{90}
@numsecentry{Job Control Variables}{7.3}{Job Control Variables}{92}
@numchapentry{Command Line Editing}{8}{Command Line Editing}{93}
@numsecentry{Introduction to Line Editing}{8.1}{Introduction and Notation}{93}
@numsecentry{Readline Interaction}{8.2}{Readline Interaction}{93}
@numsubsecentry{Readline Bare Essentials}{8.2.1}{Readline Bare Essentials}{94}
@numsubsecentry{Readline Movement Commands}{8.2.2}{Readline Movement Commands}{94}
@numsubsecentry{Readline Killing Commands}{8.2.3}{Readline Killing Commands}{95}
@numsubsecentry{Readline Arguments}{8.2.4}{Readline Arguments}{95}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{95}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{96}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{96}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{102}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{103}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{106}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{106}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{107}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{108}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{109}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{110}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{110}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{112}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{112}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{114}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{115}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{117}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{121}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{121}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{121}
@numsecentry{History Expansion}{9.3}{History Interaction}{123}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{123}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{124}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{125}
@numchapentry{Installing Bash}{10}{Installing Bash}{127}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{127}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{128}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{128}
@numsecentry{Installation Names}{10.4}{Installation Names}{128}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{128}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{129}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{129}
@numsecentry{Optional Features}{10.8}{Optional Features}{129}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{135}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{137}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{141}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{143}
@appentry{Indexes}{D}{Indexes}{151}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{151}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{152}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{152}
@appsecentry{Function Index}{D.4}{Function Index}{154}
@appsecentry{Concept Index}{D.5}{Concept Index}{156}
doc/bashref.vr
+28 -28
View File
@@ -98,31 +98,31 @@
\entry{TMOUT}{69}{\code {TMOUT}}
\entry{TMPDIR}{70}{\code {TMPDIR}}
\entry{UID}{70}{\code {UID}}
\entry{auto_resume}{90}{\code {auto_resume}}
\entry{bell-style}{95}{\code {bell-style}}
\entry{bind-tty-special-chars}{95}{\code {bind-tty-special-chars}}
\entry{comment-begin}{95}{\code {comment-begin}}
\entry{completion-prefix-display-length}{95}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{95}{\code {completion-query-items}}
\entry{convert-meta}{96}{\code {convert-meta}}
\entry{disable-completion}{96}{\code {disable-completion}}
\entry{editing-mode}{96}{\code {editing-mode}}
\entry{enable-keypad}{96}{\code {enable-keypad}}
\entry{expand-tilde}{96}{\code {expand-tilde}}
\entry{history-preserve-point}{96}{\code {history-preserve-point}}
\entry{history-size}{96}{\code {history-size}}
\entry{horizontal-scroll-mode}{96}{\code {horizontal-scroll-mode}}
\entry{input-meta}{96}{\code {input-meta}}
\entry{meta-flag}{96}{\code {meta-flag}}
\entry{isearch-terminators}{97}{\code {isearch-terminators}}
\entry{keymap}{97}{\code {keymap}}
\entry{mark-modified-lines}{97}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{97}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{97}{\code {match-hidden-files}}
\entry{output-meta}{97}{\code {output-meta}}
\entry{page-completions}{97}{\code {page-completions}}
\entry{revert-all-at-newline}{98}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{98}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{98}{\code {show-all-if-unmodified}}
\entry{skip-completed-text}{98}{\code {skip-completed-text}}
\entry{visible-stats}{98}{\code {visible-stats}}
\entry{auto_resume}{92}{\code {auto_resume}}
\entry{bell-style}{97}{\code {bell-style}}
\entry{bind-tty-special-chars}{97}{\code {bind-tty-special-chars}}
\entry{comment-begin}{97}{\code {comment-begin}}
\entry{completion-prefix-display-length}{97}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{97}{\code {completion-query-items}}
\entry{convert-meta}{98}{\code {convert-meta}}
\entry{disable-completion}{98}{\code {disable-completion}}
\entry{editing-mode}{98}{\code {editing-mode}}
\entry{enable-keypad}{98}{\code {enable-keypad}}
\entry{expand-tilde}{98}{\code {expand-tilde}}
\entry{history-preserve-point}{98}{\code {history-preserve-point}}
\entry{history-size}{98}{\code {history-size}}
\entry{horizontal-scroll-mode}{98}{\code {horizontal-scroll-mode}}
\entry{input-meta}{99}{\code {input-meta}}
\entry{meta-flag}{99}{\code {meta-flag}}
\entry{isearch-terminators}{99}{\code {isearch-terminators}}
\entry{keymap}{99}{\code {keymap}}
\entry{mark-modified-lines}{99}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{99}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{99}{\code {match-hidden-files}}
\entry{output-meta}{99}{\code {output-meta}}
\entry{page-completions}{99}{\code {page-completions}}
\entry{revert-all-at-newline}{100}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{100}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{100}{\code {show-all-if-unmodified}}
\entry{skip-completed-text}{100}{\code {skip-completed-text}}
\entry{visible-stats}{100}{\code {visible-stats}}
doc/bashref.vrs
+28 -28
View File
@@ -17,7 +17,7 @@
\initial {0}
\entry {\code {0}}{17}
\initial {A}
\entry {\code {auto_resume}}{90}
\entry {\code {auto_resume}}{92}
\initial {B}
\entry {\code {BASH}}{61}
\entry {\code {BASH_ALIASES}}{62}
@@ -36,12 +36,12 @@
\entry {\code {BASH_XTRACEFD}}{63}
\entry {\code {BASHOPTS}}{62}
\entry {\code {BASHPID}}{62}
\entry {\code {bell-style}}{95}
\entry {\code {bind-tty-special-chars}}{95}
\entry {\code {bell-style}}{97}
\entry {\code {bind-tty-special-chars}}{97}
\initial {C}
\entry {\code {CDPATH}}{61}
\entry {\code {COLUMNS}}{64}
\entry {\code {comment-begin}}{95}
\entry {\code {comment-begin}}{97}
\entry {\code {COMP_CWORD}}{64}
\entry {\code {COMP_KEY}}{64}
\entry {\code {COMP_LINE}}{64}
@@ -49,19 +49,19 @@
\entry {\code {COMP_TYPE}}{64}
\entry {\code {COMP_WORDBREAKS}}{64}
\entry {\code {COMP_WORDS}}{64}
\entry {\code {completion-prefix-display-length}}{95}
\entry {\code {completion-query-items}}{95}
\entry {\code {completion-prefix-display-length}}{97}
\entry {\code {completion-query-items}}{97}
\entry {\code {COMPREPLY}}{65}
\entry {\code {convert-meta}}{96}
\entry {\code {convert-meta}}{98}
\initial {D}
\entry {\code {DIRSTACK}}{65}
\entry {\code {disable-completion}}{96}
\entry {\code {disable-completion}}{98}
\initial {E}
\entry {\code {editing-mode}}{96}
\entry {\code {editing-mode}}{98}
\entry {\code {EMACS}}{65}
\entry {\code {enable-keypad}}{96}
\entry {\code {enable-keypad}}{98}
\entry {\code {EUID}}{65}
\entry {\code {expand-tilde}}{96}
\entry {\code {expand-tilde}}{98}
\initial {F}
\entry {\code {FCEDIT}}{65}
\entry {\code {FIGNORE}}{65}
@@ -76,23 +76,23 @@
\entry {\code {HISTFILE}}{66}
\entry {\code {HISTFILESIZE}}{66}
\entry {\code {HISTIGNORE}}{66}
\entry {\code {history-preserve-point}}{96}
\entry {\code {history-size}}{96}
\entry {\code {history-preserve-point}}{98}
\entry {\code {history-size}}{98}
\entry {\code {HISTSIZE}}{66}
\entry {\code {HISTTIMEFORMAT}}{66}
\entry {\code {HOME}}{61}
\entry {\code {horizontal-scroll-mode}}{96}
\entry {\code {horizontal-scroll-mode}}{98}
\entry {\code {HOSTFILE}}{67}
\entry {\code {HOSTNAME}}{67}
\entry {\code {HOSTTYPE}}{67}
\initial {I}
\entry {\code {IFS}}{61}
\entry {\code {IGNOREEOF}}{67}
\entry {\code {input-meta}}{96}
\entry {\code {input-meta}}{99}
\entry {\code {INPUTRC}}{67}
\entry {\code {isearch-terminators}}{97}
\entry {\code {isearch-terminators}}{99}
\initial {K}
\entry {\code {keymap}}{97}
\entry {\code {keymap}}{99}
\initial {L}
\entry {\code {LANG}}{67}
\entry {\code {LC_ALL}}{67}
@@ -107,19 +107,19 @@
\entry {\code {MAIL}}{61}
\entry {\code {MAILCHECK}}{68}
\entry {\code {MAILPATH}}{61}
\entry {\code {mark-modified-lines}}{97}
\entry {\code {mark-symlinked-directories}}{97}
\entry {\code {match-hidden-files}}{97}
\entry {\code {meta-flag}}{96}
\entry {\code {mark-modified-lines}}{99}
\entry {\code {mark-symlinked-directories}}{99}
\entry {\code {match-hidden-files}}{99}
\entry {\code {meta-flag}}{99}
\initial {O}
\entry {\code {OLDPWD}}{68}
\entry {\code {OPTARG}}{61}
\entry {\code {OPTERR}}{68}
\entry {\code {OPTIND}}{61}
\entry {\code {OSTYPE}}{68}
\entry {\code {output-meta}}{97}
\entry {\code {output-meta}}{99}
\initial {P}
\entry {\code {page-completions}}{97}
\entry {\code {page-completions}}{99}
\entry {\code {PATH}}{61}
\entry {\code {PIPESTATUS}}{68}
\entry {\code {POSIXLY_CORRECT}}{68}
@@ -134,15 +134,15 @@
\initial {R}
\entry {\code {RANDOM}}{68}
\entry {\code {REPLY}}{68}
\entry {\code {revert-all-at-newline}}{98}
\entry {\code {revert-all-at-newline}}{100}
\initial {S}
\entry {\code {SECONDS}}{69}
\entry {\code {SHELL}}{69}
\entry {\code {SHELLOPTS}}{69}
\entry {\code {SHLVL}}{69}
\entry {\code {show-all-if-ambiguous}}{98}
\entry {\code {show-all-if-unmodified}}{98}
\entry {\code {skip-completed-text}}{98}
\entry {\code {show-all-if-ambiguous}}{100}
\entry {\code {show-all-if-unmodified}}{100}
\entry {\code {skip-completed-text}}{100}
\initial {T}
\entry {\code {TEXTDOMAIN}}{7}
\entry {\code {TEXTDOMAINDIR}}{7}
@@ -152,4 +152,4 @@
\initial {U}
\entry {\code {UID}}{70}
\initial {V}
\entry {\code {visible-stats}}{98}
\entry {\code {visible-stats}}{100}
doc/builtins.0
+304 -297
View File
@@ -859,8 +859,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
occurs while reading the name of the current directory or an
invalid option is supplied.
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] [--pp _p_r_o_m_p_t] [--tt
_t_i_m_e_o_u_t] [--uu _f_d] [_n_a_m_e ...]
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
first word is assigned to the first _n_a_m_e, the second word to the
@@ -889,112 +889,119 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
placed into the editing buffer before editing begins.
--nn _n_c_h_a_r_s
rreeaadd returns after reading _n_c_h_a_r_s characters rather than
waiting for a complete line of input.
waiting for a complete line of input, but honor a delim-
iter if fewer than _n_c_h_a_r_s characters are read before the
delimiter.
--NN _n_c_h_a_r_s
rreeaadd returns after reading exactly _n_c_h_a_r_s characters
rather than waiting for a complete line of input, unless
EOF is encountered or rreeaadd times out. Any delimiter is
ignored.
--pp _p_r_o_m_p_t
Display _p_r_o_m_p_t on standard error, without a trailing new-
line, before attempting to read any input. The prompt is
displayed only if input is coming from a terminal.
--rr Backslash does not act as an escape character. The back-
slash is considered to be part of the line. In particu-
lar, a backslash-newline pair may not be used as a line
slash is considered to be part of the line. In particu-
lar, a backslash-newline pair may not be used as a line
continuation.
--ss Silent mode. If input is coming from a terminal, charac-
ters are not echoed.
--tt _t_i_m_e_o_u_t
Cause rreeaadd to time out and return failure if a complete
line of input is not read within _t_i_m_e_o_u_t seconds. _t_i_m_e_-
_o_u_t may be a decimal number with a fractional portion
following the decimal point. This option is only effec-
tive if rreeaadd is reading input from a terminal, pipe, or
other special file; it has no effect when reading from
regular files. If _t_i_m_e_o_u_t is 0, rreeaadd returns success if
input is available on the specified file descriptor,
failure otherwise. The exit status is greater than 128
Cause rreeaadd to time out and return failure if a complete
line of input is not read within _t_i_m_e_o_u_t seconds. _t_i_m_e_-
_o_u_t may be a decimal number with a fractional portion
following the decimal point. This option is only effec-
tive if rreeaadd is reading input from a terminal, pipe, or
other special file; it has no effect when reading from
regular files. If _t_i_m_e_o_u_t is 0, rreeaadd returns success if
input is available on the specified file descriptor,
failure otherwise. The exit status is greater than 128
if the timeout is exceeded.
--uu _f_d Read input from file descriptor _f_d.
If no _n_a_m_e_s are supplied, the line read is assigned to the vari-
able RREEPPLLYY. The return code is zero, unless end-of-file is
encountered, rreeaadd times out (in which case the return code is
greater than 128), or an invalid file descriptor is supplied as
able RREEPPLLYY. The return code is zero, unless end-of-file is
encountered, rreeaadd times out (in which case the return code is
greater than 128), or an invalid file descriptor is supplied as
the argument to --uu.
rreeaaddoonnllyy [--aaAAppff] [_n_a_m_e[=_w_o_r_d] ...]
The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s
may not be changed by subsequent assignment. If the --ff option
is supplied, the functions corresponding to the _n_a_m_e_s are so
marked. The --aa option restricts the variables to indexed
arrays; the --AA option restricts the variables to associative
arrays. If no _n_a_m_e arguments are given, or if the --pp option is
supplied, a list of all readonly names is printed. The --pp
option causes output to be displayed in a format that may be
reused as input. If a variable name is followed by =_w_o_r_d, the
value of the variable is set to _w_o_r_d. The return status is 0
The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s
may not be changed by subsequent assignment. If the --ff option
is supplied, the functions corresponding to the _n_a_m_e_s are so
marked. The --aa option restricts the variables to indexed
arrays; the --AA option restricts the variables to associative
arrays. If no _n_a_m_e arguments are given, or if the --pp option is
supplied, a list of all readonly names is printed. The --pp
option causes output to be displayed in a format that may be
reused as input. If a variable name is followed by =_w_o_r_d, the
value of the variable is set to _w_o_r_d. The return status is 0
unless an invalid option is encountered, one of the _n_a_m_e_s is not
a valid shell variable name, or --ff is supplied with a _n_a_m_e that
a valid shell variable name, or --ff is supplied with a _n_a_m_e that
is not a function.
rreettuurrnn [_n]
Causes a function to exit with the return value specified by _n.
If _n is omitted, the return status is that of the last command
executed in the function body. If used outside a function, but
during execution of a script by the .. (ssoouurrccee) command, it
Causes a function to exit with the return value specified by _n.
If _n is omitted, the return status is that of the last command
executed in the function body. If used outside a function, but
during execution of a script by the .. (ssoouurrccee) command, it
causes the shell to stop executing that script and return either
_n or the exit status of the last command executed within the
script as the exit status of the script. If used outside a
function and not during execution of a script by .., the return
_n or the exit status of the last command executed within the
script as the exit status of the script. If used outside a
function and not during execution of a script by .., the return
status is false. Any command associated with the RREETTUURRNN trap is
executed before execution resumes after the function or script.
executed before execution resumes after the function or script.
sseett [----aabbeeffhhkkmmnnppttuuvvxxBBCCEEHHPPTT] [--oo _o_p_t_i_o_n] [_a_r_g ...]
sseett [++aabbeeffhhkkmmnnppttuuvvxxBBCCEEHHPPTT] [++oo _o_p_t_i_o_n] [_a_r_g ...]
Without options, the name and value of each shell variable are
Without options, the name and value of each shell variable are
displayed in a format that can be reused as input for setting or
resetting the currently-set variables. Read-only variables can-
not be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are listed.
The output is sorted according to the current locale. When
options are specified, they set or unset shell attributes. Any
arguments remaining after option processing are treated as val-
not be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are listed.
The output is sorted according to the current locale. When
options are specified, they set or unset shell attributes. Any
arguments remaining after option processing are treated as val-
ues for the positional parameters and are assigned, in order, to
$$11, $$22, ...... $$_n. Options, if specified, have the following
$$11, $$22, ...... $$_n. Options, if specified, have the following
meanings:
--aa Automatically mark variables and functions which are
modified or created for export to the environment of
--aa Automatically mark variables and functions which are
modified or created for export to the environment of
subsequent commands.
--bb Report the status of terminated background jobs immedi-
--bb Report the status of terminated background jobs immedi-
ately, rather than before the next primary prompt. This
is effective only when job control is enabled.
--ee Exit immediately if a _p_i_p_e_l_i_n_e (which may consist of a
single _s_i_m_p_l_e _c_o_m_m_a_n_d), a _s_u_b_s_h_e_l_l command enclosed in
parentheses, or one of the commands executed as part of
a command list enclosed by braces (see SSHHEELLLL GGRRAAMMMMAARR
--ee Exit immediately if a _p_i_p_e_l_i_n_e (which may consist of a
single _s_i_m_p_l_e _c_o_m_m_a_n_d), a _s_u_b_s_h_e_l_l command enclosed in
parentheses, or one of the commands executed as part of
a command list enclosed by braces (see SSHHEELLLL GGRRAAMMMMAARR
above) exits with a non-zero status. The shell does not
exit if the command that fails is part of the command
list immediately following a wwhhiillee or uunnttiill keyword,
part of the test following the iiff or eelliiff reserved
words, part of any command executed in a &&&& or |||| list
except the command following the final &&&& or ||||, any
command in a pipeline but the last, or if the command's
return value is being inverted with !!. A trap on EERRRR,
exit if the command that fails is part of the command
list immediately following a wwhhiillee or uunnttiill keyword,
part of the test following the iiff or eelliiff reserved
words, part of any command executed in a &&&& or |||| list
except the command following the final &&&& or ||||, any
command in a pipeline but the last, or if the command's
return value is being inverted with !!. A trap on EERRRR,
if set, is executed before the shell exits. This option
applies to the shell environment and each subshell envi-
ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT
ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT
above), and may cause subshells to exit before executing
all the commands in the subshell.
--ff Disable pathname expansion.
--hh Remember the location of commands as they are looked up
--hh Remember the location of commands as they are looked up
for execution. This is enabled by default.
--kk All arguments in the form of assignment statements are
placed in the environment for a command, not just those
--kk All arguments in the form of assignment statements are
placed in the environment for a command, not just those
that precede the command name.
--mm Monitor mode. Job control is enabled. This option is
on by default for interactive shells on systems that
support it (see JJOOBB CCOONNTTRROOLL above). Background pro-
cesses run in a separate process group and a line con-
taining their exit status is printed upon their comple-
--mm Monitor mode. Job control is enabled. This option is
on by default for interactive shells on systems that
support it (see JJOOBB CCOONNTTRROOLL above). Background pro-
cesses run in a separate process group and a line con-
taining their exit status is printed upon their comple-
tion.
--nn Read commands but do not execute them. This may be used
to check a shell script for syntax errors. This is
to check a shell script for syntax errors. This is
ignored by interactive shells.
--oo _o_p_t_i_o_n_-_n_a_m_e
The _o_p_t_i_o_n_-_n_a_m_e can be one of the following:
@@ -1002,10 +1009,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
Same as --aa.
bbrraacceeeexxppaanndd
Same as --BB.
eemmaaccss Use an emacs-style command line editing inter-
eemmaaccss Use an emacs-style command line editing inter-
face. This is enabled by default when the shell
is interactive, unless the shell is started with
the ----nnooeeddiittiinngg option. This also affects the
the ----nnooeeddiittiinngg option. This also affects the
editing interface used for rreeaadd --ee.
eerrrrttrraaccee
Same as --EE.
@@ -1019,8 +1026,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
HHIISSTTOORRYY. This option is on by default in inter-
active shells.
iiggnnoorreeeeooff
The effect is as if the shell command
``IGNOREEOF=10'' had been executed (see SShheellll
The effect is as if the shell command
``IGNOREEOF=10'' had been executed (see SShheellll
VVaarriiaabblleess above).
kkeeyywwoorrdd Same as --kk.
mmoonniittoorr Same as --mm.
@@ -1035,215 +1042,215 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
pphhyyssiiccaall
Same as --PP.
ppiippeeffaaiill
If set, the return value of a pipeline is the
value of the last (rightmost) command to exit
with a non-zero status, or zero if all commands
in the pipeline exit successfully. This option
If set, the return value of a pipeline is the
value of the last (rightmost) command to exit
with a non-zero status, or zero if all commands
in the pipeline exit successfully. This option
is disabled by default.
ppoossiixx Change the behavior of bbaasshh where the default
operation differs from the POSIX standard to
ppoossiixx Change the behavior of bbaasshh where the default
operation differs from the POSIX standard to
match the standard (_p_o_s_i_x _m_o_d_e).
pprriivviilleeggeedd
Same as --pp.
vveerrbboossee Same as --vv.
vvii Use a vi-style command line editing interface.
vvii Use a vi-style command line editing interface.
This also affects the editing interface used for
rreeaadd --ee.
xxttrraaccee Same as --xx.
If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the
current options are printed. If ++oo is supplied with no
_o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the
current option settings is displayed on the standard
current options are printed. If ++oo is supplied with no
_o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the
current option settings is displayed on the standard
output.
--pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and
$$BBAASSHH__EENNVV files are not processed, shell functions are
not inherited from the environment, and the SSHHEELLLLOOPPTTSS,
BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they
--pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and
$$BBAASSHH__EENNVV files are not processed, shell functions are
not inherited from the environment, and the SSHHEELLLLOOPPTTSS,
BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they
appear in the environment, are ignored. If the shell is
started with the effective user (group) id not equal to
the real user (group) id, and the --pp option is not sup-
started with the effective user (group) id not equal to
the real user (group) id, and the --pp option is not sup-
plied, these actions are taken and the effective user id
is set to the real user id. If the --pp option is sup-
plied at startup, the effective user id is not reset.
Turning this option off causes the effective user and
is set to the real user id. If the --pp option is sup-
plied at startup, the effective user id is not reset.
Turning this option off causes the effective user and
group ids to be set to the real user and group ids.
--tt Exit after reading and executing one command.
--uu Treat unset variables and parameters other than the spe-
cial parameters "@" and "*" as an error when performing
parameter expansion. If expansion is attempted on an
unset variable or parameter, the shell prints an error
message, and, if not interactive, exits with a non-zero
cial parameters "@" and "*" as an error when performing
parameter expansion. If expansion is attempted on an
unset variable or parameter, the shell prints an error
message, and, if not interactive, exits with a non-zero
status.
--vv Print shell input lines as they are read.
--xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee
--xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee
command, sseelleecctt command, or arithmetic ffoorr command, dis-
play the expanded value of PPSS44, followed by the command
play the expanded value of PPSS44, followed by the command
and its expanded arguments or associated word list.
--BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn
--BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn
above). This is on by default.
--CC If set, bbaasshh does not overwrite an existing file with
the >>, >>&&, and <<>> redirection operators. This may be
--CC If set, bbaasshh does not overwrite an existing file with
the >>, >>&&, and <<>> redirection operators. This may be
overridden when creating output files by using the redi-
rection operator >>|| instead of >>.
--EE If set, any trap on EERRRR is inherited by shell functions,
command substitutions, and commands executed in a sub-
shell environment. The EERRRR trap is normally not inher-
command substitutions, and commands executed in a sub-
shell environment. The EERRRR trap is normally not inher-
ited in such cases.
--HH Enable !! style history substitution. This option is on
by default when the shell is interactive.
--PP If set, the shell does not follow symbolic links when
executing commands such as ccdd that change the current
--PP If set, the shell does not follow symbolic links when
executing commands such as ccdd that change the current
working directory. It uses the physical directory
structure instead. By default, bbaasshh follows the logical
chain of directories when performing commands which
chain of directories when performing commands which
change the current directory.
--TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by
shell functions, command substitutions, and commands
executed in a subshell environment. The DDEEBBUUGG and
--TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by
shell functions, command substitutions, and commands
executed in a subshell environment. The DDEEBBUUGG and
RREETTUURRNN traps are normally not inherited in such cases.
---- If no arguments follow this option, then the positional
---- If no arguments follow this option, then the positional
parameters are unset. Otherwise, the positional parame-
ters are set to the _a_r_gs, even if some of them begin
ters are set to the _a_r_gs, even if some of them begin
with a --.
-- Signal the end of options, cause all remaining _a_r_gs to
-- Signal the end of options, cause all remaining _a_r_gs to
be assigned to the positional parameters. The --xx and --vv
options are turned off. If there are no _a_r_gs, the posi-
tional parameters remain unchanged.
The options are off by default unless otherwise noted. Using +
rather than - causes these options to be turned off. The
options can also be specified as arguments to an invocation of
the shell. The current set of options may be found in $$--. The
The options are off by default unless otherwise noted. Using +
rather than - causes these options to be turned off. The
options can also be specified as arguments to an invocation of
the shell. The current set of options may be found in $$--. The
return status is always true unless an invalid option is encoun-
tered.
sshhiifftt [_n]
The positional parameters from _n+1 ... are renamed to $$11 ........
Parameters represented by the numbers $$## down to $$##-_n+1 are
unset. _n must be a non-negative number less than or equal to
$$##. If _n is 0, no parameters are changed. If _n is not given,
it is assumed to be 1. If _n is greater than $$##, the positional
parameters are not changed. The return status is greater than
The positional parameters from _n+1 ... are renamed to $$11 ........
Parameters represented by the numbers $$## down to $$##-_n+1 are
unset. _n must be a non-negative number less than or equal to
$$##. If _n is 0, no parameters are changed. If _n is not given,
it is assumed to be 1. If _n is greater than $$##, the positional
parameters are not changed. The return status is greater than
zero if _n is greater than $$## or less than zero; otherwise 0.
sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...]
Toggle the values of variables controlling optional shell behav-
ior. With no options, or with the --pp option, a list of all set-
table options is displayed, with an indication of whether or not
each is set. The --pp option causes output to be displayed in a
form that may be reused as input. Other options have the fol-
each is set. The --pp option causes output to be displayed in a
form that may be reused as input. Other options have the fol-
lowing meanings:
--ss Enable (set) each _o_p_t_n_a_m_e.
--uu Disable (unset) each _o_p_t_n_a_m_e.
--qq Suppresses normal output (quiet mode); the return status
--qq Suppresses normal output (quiet mode); the return status
indicates whether the _o_p_t_n_a_m_e is set or unset. If multi-
ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta-
tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other-
ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta-
tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other-
wise.
--oo Restricts the values of _o_p_t_n_a_m_e to be those defined for
--oo Restricts the values of _o_p_t_n_a_m_e to be those defined for
the --oo option to the sseett builtin.
If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis-
If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis-
play is limited to those options which are set or unset, respec-
tively. Unless otherwise noted, the sshhoopptt options are disabled
tively. Unless otherwise noted, the sshhoopptt options are disabled
(unset) by default.
The return status when listing options is zero if all _o_p_t_n_a_m_e_s
are enabled, non-zero otherwise. When setting or unsetting
options, the return status is zero unless an _o_p_t_n_a_m_e is not a
The return status when listing options is zero if all _o_p_t_n_a_m_e_s
are enabled, non-zero otherwise. When setting or unsetting
options, the return status is zero unless an _o_p_t_n_a_m_e is not a
valid shell option.
The list of sshhoopptt options is:
aauuttooccdd If set, a command name that is the name of a directory
is executed as if it were the argument to the ccdd com-
aauuttooccdd If set, a command name that is the name of a directory
is executed as if it were the argument to the ccdd com-
mand. This option is only used by interactive shells.
ccddaabbllee__vvaarrss
If set, an argument to the ccdd builtin command that is
not a directory is assumed to be the name of a variable
If set, an argument to the ccdd builtin command that is
not a directory is assumed to be the name of a variable
whose value is the directory to change to.
ccddssppeellll If set, minor errors in the spelling of a directory com-
ponent in a ccdd command will be corrected. The errors
ponent in a ccdd command will be corrected. The errors
checked for are transposed characters, a missing charac-
ter, and one character too many. If a correction is
found, the corrected file name is printed, and the com-
mand proceeds. This option is only used by interactive
ter, and one character too many. If a correction is
found, the corrected file name is printed, and the com-
mand proceeds. This option is only used by interactive
shells.
cchheecckkhhaasshh
If set, bbaasshh checks that a command found in the hash ta-
ble exists before trying to execute it. If a hashed
command no longer exists, a normal path search is per-
ble exists before trying to execute it. If a hashed
command no longer exists, a normal path search is per-
formed.
cchheecckkjjoobbss
If set, bbaasshh lists the status of any stopped and running
jobs before exiting an interactive shell. If any jobs
jobs before exiting an interactive shell. If any jobs
are running, this causes the exit to be deferred until a
second exit is attempted without an intervening command
(see JJOOBB CCOONNTTRROOLL above). The shell always postpones
second exit is attempted without an intervening command
(see JJOOBB CCOONNTTRROOLL above). The shell always postpones
exiting if any jobs are stopped.
cchheecckkwwiinnssiizzee
If set, bbaasshh checks the window size after each command
and, if necessary, updates the values of LLIINNEESS and CCOOLL--
If set, bbaasshh checks the window size after each command
and, if necessary, updates the values of LLIINNEESS and CCOOLL--
UUMMNNSS.
ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple-
line command in the same history entry. This allows
ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple-
line command in the same history entry. This allows
easy re-editing of multi-line commands.
ccoommppaatt3311
If set, bbaasshh changes its behavior to that of version 3.1
with respect to quoted arguments to the conditional com-
mand's =~ operator.
ddiirrssppeellll
If set, bbaasshh attempts spelling correction on directory
names during word completion if the directory name ini-
If set, bbaasshh attempts spelling correction on directory
names during word completion if the directory name ini-
tially supplied does not exist.
ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in
ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in
the results of pathname expansion.
eexxeeccffaaiill
If set, a non-interactive shell will not exit if it can-
not execute the file specified as an argument to the
eexxeecc builtin command. An interactive shell does not
not execute the file specified as an argument to the
eexxeecc builtin command. An interactive shell does not
exit if eexxeecc fails.
eexxppaanndd__aalliiaasseess
If set, aliases are expanded as described above under
If set, aliases are expanded as described above under
AALLIIAASSEESS. This option is enabled by default for interac-
tive shells.
eexxttddeebbuugg
If set, behavior intended for use by debuggers is
If set, behavior intended for use by debuggers is
enabled:
11.. The --FF option to the ddeeccllaarree builtin displays the
source file name and line number corresponding to
each function name supplied as an argument.
22.. If the command run by the DDEEBBUUGG trap returns a
non-zero value, the next command is skipped and
22.. If the command run by the DDEEBBUUGG trap returns a
non-zero value, the next command is skipped and
not executed.
33.. If the command run by the DDEEBBUUGG trap returns a
value of 2, and the shell is executing in a sub-
routine (a shell function or a shell script exe-
cuted by the .. or ssoouurrccee builtins), a call to
33.. If the command run by the DDEEBBUUGG trap returns a
value of 2, and the shell is executing in a sub-
routine (a shell function or a shell script exe-
cuted by the .. or ssoouurrccee builtins), a call to
rreettuurrnn is simulated.
44.. BBAASSHH__AARRGGCC and BBAASSHH__AARRGGVV are updated as described
44.. BBAASSHH__AARRGGCC and BBAASSHH__AARRGGVV are updated as described
in their descriptions above.
55.. Function tracing is enabled: command substitu-
55.. Function tracing is enabled: command substitu-
tion, shell functions, and subshells invoked with
(( _c_o_m_m_a_n_d )) inherit the DDEEBBUUGG and RREETTUURRNN traps.
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
_c_o_m_m_a_n_d )) inherit the EERRRROORR trap.
eexxttgglloobb If set, the extended pattern matching features described
above under PPaatthhnnaammee EExxppaannssiioonn are enabled.
eexxttqquuoottee
If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed
within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double
If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed
within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double
quotes. This option is enabled by default.
ffaaiillgglloobb
If set, patterns which fail to match filenames during
If set, patterns which fail to match filenames during
pathname expansion result in an expansion error.
ffoorrccee__ffiiggnnoorree
If set, the suffixes specified by the FFIIGGNNOORREE shell
variable cause words to be ignored when performing word
If set, the suffixes specified by the FFIIGGNNOORREE shell
variable cause words to be ignored when performing word
completion even if the ignored words are the only possi-
ble completions. See SSHHEELLLL VVAARRIIAABBLLEESS above for a
description of FFIIGGNNOORREE. This option is enabled by
description of FFIIGGNNOORREE. This option is enabled by
default.
gglloobbssttaarr
If set, the pattern **** used in a pathname expansion con-
@@ -1254,58 +1261,58 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
If set, shell error messages are written in the standard
GNU error message format.
hhiissttaappppeenndd
If set, the history list is appended to the file named
by the value of the HHIISSTTFFIILLEE variable when the shell
If set, the history list is appended to the file named
by the value of the HHIISSTTFFIILLEE variable when the shell
exits, rather than overwriting the file.
hhiissttrreeeeddiitt
If set, and rreeaaddlliinnee is being used, a user is given the
If set, and rreeaaddlliinnee is being used, a user is given the
opportunity to re-edit a failed history substitution.
hhiissttvveerriiffyy
If set, and rreeaaddlliinnee is being used, the results of his-
tory substitution are not immediately passed to the
shell parser. Instead, the resulting line is loaded
If set, and rreeaaddlliinnee is being used, the results of his-
tory substitution are not immediately passed to the
shell parser. Instead, the resulting line is loaded
into the rreeaaddlliinnee editing buffer, allowing further modi-
fication.
hhoossttccoommpplleettee
If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to
perform hostname completion when a word containing a @@
is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE
perform hostname completion when a word containing a @@
is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE
above). This is enabled by default.
hhuuppoonneexxiitt
If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter-
active login shell exits.
iinntteerraaccttiivvee__ccoommmmeennttss
If set, allow a word beginning with ## to cause that word
and all remaining characters on that line to be ignored
in an interactive shell (see CCOOMMMMEENNTTSS above). This
and all remaining characters on that line to be ignored
in an interactive shell (see CCOOMMMMEENNTTSS above). This
option is enabled by default.
lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line
lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line
commands are saved to the history with embedded newlines
rather than using semicolon separators where possible.
llooggiinn__sshheellll
The shell sets this option if it is started as a login
shell (see IINNVVOOCCAATTIIOONN above). The value may not be
The shell sets this option if it is started as a login
shell (see IINNVVOOCCAATTIIOONN above). The value may not be
changed.
mmaaiillwwaarrnn
If set, and a file that bbaasshh is checking for mail has
been accessed since the last time it was checked, the
message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis-
If set, and a file that bbaasshh is checking for mail has
been accessed since the last time it was checked, the
message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis-
played.
nnoo__eemmppttyy__ccmmdd__ccoommpplleettiioonn
If set, and rreeaaddlliinnee is being used, bbaasshh will not
If set, and rreeaaddlliinnee is being used, bbaasshh will not
attempt to search the PPAATTHH for possible completions when
completion is attempted on an empty line.
nnooccaasseegglloobb
If set, bbaasshh matches filenames in a case-insensitive
If set, bbaasshh matches filenames in a case-insensitive
fashion when performing pathname expansion (see PPaatthhnnaammee
EExxppaannssiioonn above).
nnooccaasseemmaattcchh
If set, bbaasshh matches patterns in a case-insensitive
If set, bbaasshh matches patterns in a case-insensitive
fashion when performing matching while executing ccaassee or
[[[[ conditional commands.
nnuullllgglloobb
If set, bbaasshh allows patterns which match no files (see
PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string,
If set, bbaasshh allows patterns which match no files (see
PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string,
rather than themselves.
pprrooggccoommpp
If set, the programmable completion facilities (see PPrroo--
@@ -1313,47 +1320,47 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
enabled by default.
pprroommppttvvaarrss
If set, prompt strings undergo parameter expansion, com-
mand substitution, arithmetic expansion, and quote
removal after being expanded as described in PPRROOMMPPTTIINNGG
mand substitution, arithmetic expansion, and quote
removal after being expanded as described in PPRROOMMPPTTIINNGG
above. This option is enabled by default.
rreessttrriicctteedd__sshheellll
The shell sets this option if it is started in
The shell sets this option if it is started in
restricted mode (see RREESSTTRRIICCTTEEDD SSHHEELLLL below). The value
may not be changed. This is not reset when the startup
files are executed, allowing the startup files to dis-
may not be changed. This is not reset when the startup
files are executed, allowing the startup files to dis-
cover whether or not a shell is restricted.
sshhiifftt__vveerrbboossee
If set, the sshhiifftt builtin prints an error message when
If set, the sshhiifftt builtin prints an error message when
the shift count exceeds the number of positional parame-
ters.
ssoouurrcceeppaatthh
If set, the ssoouurrccee (..) builtin uses the value of PPAATTHH to
find the directory containing the file supplied as an
find the directory containing the file supplied as an
argument. This option is enabled by default.
xxppgg__eecchhoo
If set, the eecchhoo builtin expands backslash-escape
If set, the eecchhoo builtin expands backslash-escape
sequences by default.
ssuussppeenndd [--ff]
Suspend the execution of this shell until it receives a SSIIGGCCOONNTT
Suspend the execution of this shell until it receives a SSIIGGCCOONNTT
signal. A login shell cannot be suspended; the --ff option can be
used to override this and force the suspension. The return sta-
tus is 0 unless the shell is a login shell and --ff is not sup-
tus is 0 unless the shell is a login shell and --ff is not sup-
plied, or if job control is not enabled.
tteesstt _e_x_p_r
[[ _e_x_p_r ]]
Return a status of 0 or 1 depending on the evaluation of the
conditional expression _e_x_p_r. Each operator and operand must be
a separate argument. Expressions are composed of the primaries
described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. tteesstt does not
Return a status of 0 or 1 depending on the evaluation of the
conditional expression _e_x_p_r. Each operator and operand must be
a separate argument. Expressions are composed of the primaries
described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. tteesstt does not
accept any options, nor does it accept and ignore an argument of
---- as signifying the end of options.
Expressions may be combined using the following operators,
Expressions may be combined using the following operators,
listed in decreasing order of precedence. The evaluation
depends on the number of arguments; see below.
!! _e_x_p_r True if _e_x_p_r is false.
(( _e_x_p_r ))
Returns the value of _e_x_p_r. This may be used to override
Returns the value of _e_x_p_r. This may be used to override
the normal precedence of operators.
_e_x_p_r_1 -aa _e_x_p_r_2
True if both _e_x_p_r_1 and _e_x_p_r_2 are true.
@@ -1370,59 +1377,59 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
null.
2 arguments
If the first argument is !!, the expression is true if and
only if the second argument is null. If the first argu-
ment is one of the unary conditional operators listed
above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is
only if the second argument is null. If the first argu-
ment is one of the unary conditional operators listed
above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is
true if the unary test is true. If the first argument is
not a valid unary conditional operator, the expression is
false.
3 arguments
If the second argument is one of the binary conditional
If the second argument is one of the binary conditional
operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the
result of the expression is the result of the binary test
using the first and third arguments as operands. The --aa
and --oo operators are considered binary operators when
there are three arguments. If the first argument is !!,
the value is the negation of the two-argument test using
using the first and third arguments as operands. The --aa
and --oo operators are considered binary operators when
there are three arguments. If the first argument is !!,
the value is the negation of the two-argument test using
the second and third arguments. If the first argument is
exactly (( and the third argument is exactly )), the result
is the one-argument test of the second argument. Other-
is the one-argument test of the second argument. Other-
wise, the expression is false.
4 arguments
If the first argument is !!, the result is the negation of
the three-argument expression composed of the remaining
the three-argument expression composed of the remaining
arguments. Otherwise, the expression is parsed and eval-
uated according to precedence using the rules listed
uated according to precedence using the rules listed
above.
5 or more arguments
The expression is parsed and evaluated according to
The expression is parsed and evaluated according to
precedence using the rules listed above.
ttiimmeess Print the accumulated user and system times for the shell and
ttiimmeess Print the accumulated user and system times for the shell and
for processes run from the shell. The return status is 0.
ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...]
The command _a_r_g is to be read and executed when the shell
receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a
single _s_i_g_s_p_e_c) or --, each specified signal is reset to its
original disposition (the value it had upon entrance to the
shell). If _a_r_g is the null string the signal specified by each
_s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes.
If _a_r_g is not present and --pp has been supplied, then the trap
commands associated with each _s_i_g_s_p_e_c are displayed. If no
arguments are supplied or if only --pp is given, ttrraapp prints the
list of commands associated with each signal. The --ll option
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
The command _a_r_g is to be read and executed when the shell
receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a
single _s_i_g_s_p_e_c) or --, each specified signal is reset to its
original disposition (the value it had upon entrance to the
shell). If _a_r_g is the null string the signal specified by each
_s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes.
If _a_r_g is not present and --pp has been supplied, then the trap
commands associated with each _s_i_g_s_p_e_c are displayed. If no
arguments are supplied or if only --pp is given, ttrraapp prints the
list of commands associated with each signal. The --ll option
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
case insensitive and the SIG prefix is optional.
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command,
_s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the
first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR
above). Refer to the description of the eexxttddeebbuugg option to the
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command,
_s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the
first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR
above). Refer to the description of the eexxttddeebbuugg option to the
sshhoopptt builtin for details of its effect on the DDEEBBUUGG trap. If a
_s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell
function or a script executed with the .. or ssoouurrccee builtins fin-
@@ -1430,53 +1437,53 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a sim-
ple command has a non-zero exit status, subject to the following
conditions. The EERRRR trap is not executed if the failed command
is part of the command list immediately following a wwhhiillee or
uunnttiill keyword, part of the test in an _i_f statement, part of a
command executed in a &&&& or |||| list, or if the command's return
value is being inverted via !!. These are the same conditions
conditions. The EERRRR trap is not executed if the failed command
is part of the command list immediately following a wwhhiillee or
uunnttiill keyword, part of the test in an _i_f statement, part of a
command executed in a &&&& or |||| list, or if the command's return
value is being inverted via !!. These are the same conditions
obeyed by the eerrrreexxiitt option.
Signals ignored upon entry to the shell cannot be trapped or
reset. Trapped signals that are not being ignored are reset to
Signals ignored upon entry to the shell cannot be trapped or
reset. Trapped signals that are not being ignored are reset to
their original values in a subshell or subshell environment when
one is created. The return status is false if any _s_i_g_s_p_e_c is
one is created. The return status is false if any _s_i_g_s_p_e_c is
invalid; otherwise ttrraapp returns true.
ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...]
With no options, indicate how each _n_a_m_e would be interpreted if
With no options, indicate how each _n_a_m_e would be interpreted if
used as a command name. If the --tt option is used, ttyyppee prints a
string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or
_f_i_l_e if _n_a_m_e is an alias, shell reserved word, function,
builtin, or disk file, respectively. If the _n_a_m_e is not found,
then nothing is printed, and an exit status of false is
returned. If the --pp option is used, ttyyppee either returns the
string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or
_f_i_l_e if _n_a_m_e is an alias, shell reserved word, function,
builtin, or disk file, respectively. If the _n_a_m_e is not found,
then nothing is printed, and an exit status of false is
returned. If the --pp option is used, ttyyppee either returns the
name of the disk file that would be executed if _n_a_m_e were speci-
fied as a command name, or nothing if ``type -t name'' would not
return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e,
return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e,
even if ``type -t name'' would not return _f_i_l_e. If a command is
hashed, --pp and --PP print the hashed value, not necessarily the
hashed, --pp and --PP print the hashed value, not necessarily the
file that appears first in PPAATTHH. If the --aa option is used, ttyyppee
prints all of the places that contain an executable named _n_a_m_e.
This includes aliases and functions, if and only if the --pp
option is not also used. The table of hashed commands is not
consulted when using --aa. The --ff option suppresses shell func-
tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if
prints all of the places that contain an executable named _n_a_m_e.
This includes aliases and functions, if and only if the --pp
option is not also used. The table of hashed commands is not
consulted when using --aa. The --ff option suppresses shell func-
tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if
all of the arguments are found, false if any are not found.
uulliimmiitt [--HHSSTTaabbccddeeffiillmmnnppqqrrssttuuvvxx [_l_i_m_i_t]]
Provides control over the resources available to the shell and
to processes started by it, on systems that allow such control.
Provides control over the resources available to the shell and
to processes started by it, on systems that allow such control.
The --HH and --SS options specify that the hard or soft limit is set
for the given resource. A hard limit cannot be increased by a
non-root user once it is set; a soft limit may be increased up
to the value of the hard limit. If neither --HH nor --SS is speci-
for the given resource. A hard limit cannot be increased by a
non-root user once it is set; a soft limit may be increased up
to the value of the hard limit. If neither --HH nor --SS is speci-
fied, both the soft and hard limits are set. The value of _l_i_m_i_t
can be a number in the unit specified for the resource or one of
the special values hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the
current hard limit, the current soft limit, and no limit,
respectively. If _l_i_m_i_t is omitted, the current value of the
soft limit of the resource is printed, unless the --HH option is
current hard limit, the current soft limit, and no limit,
respectively. If _l_i_m_i_t is omitted, the current value of the
soft limit of the resource is printed, unless the --HH option is
given. When more than one resource is specified, the limit name
and unit are printed before the value. Other options are inter-
preted as follows:
@@ -1485,11 +1492,11 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--cc The maximum size of core files created
--dd The maximum size of a process's data segment
--ee The maximum scheduling priority ("nice")
--ff The maximum size of files written by the shell and its
--ff The maximum size of files written by the shell and its
children
--ii The maximum number of pending signals
--ll The maximum size that may be locked into memory
--mm The maximum resident set size (many systems do not honor
--mm The maximum resident set size (many systems do not honor
this limit)
--nn The maximum number of open file descriptors (most systems
do not allow this value to be set)
@@ -1498,58 +1505,58 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--rr The maximum real-time scheduling priority
--ss The maximum stack size
--tt The maximum amount of cpu time in seconds
--uu The maximum number of processes available to a single
--uu The maximum number of processes available to a single
user
--vv The maximum amount of virtual memory available to the
--vv The maximum amount of virtual memory available to the
shell
--xx The maximum number of file locks
--TT The maximum number of threads
If _l_i_m_i_t is given, it is the new value of the specified resource
(the --aa option is display only). If no option is given, then --ff
is assumed. Values are in 1024-byte increments, except for --tt,
which is in seconds, --pp, which is in units of 512-byte blocks,
and --TT, --bb, --nn, and --uu, which are unscaled values. The return
is assumed. Values are in 1024-byte increments, except for --tt,
which is in seconds, --pp, which is in units of 512-byte blocks,
and --TT, --bb, --nn, and --uu, which are unscaled values. The return
status is 0 unless an invalid option or argument is supplied, or
an error occurs while setting a new limit.
uummaasskk [--pp] [--SS] [_m_o_d_e]
The user file-creation mask is set to _m_o_d_e. If _m_o_d_e begins with
a digit, it is interpreted as an octal number; otherwise it is
interpreted as a symbolic mode mask similar to that accepted by
_c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is
printed. The --SS option causes the mask to be printed in sym-
bolic form; the default output is an octal number. If the --pp
a digit, it is interpreted as an octal number; otherwise it is
interpreted as a symbolic mode mask similar to that accepted by
_c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is
printed. The --SS option causes the mask to be printed in sym-
bolic form; the default output is an octal number. If the --pp
option is supplied, and _m_o_d_e is omitted, the output is in a form
that may be reused as input. The return status is 0 if the mode
was successfully changed or if no _m_o_d_e argument was supplied,
was successfully changed or if no _m_o_d_e argument was supplied,
and false otherwise.
uunnaalliiaass [-aa] [_n_a_m_e ...]
Remove each _n_a_m_e from the list of defined aliases. If --aa is
supplied, all alias definitions are removed. The return value
Remove each _n_a_m_e from the list of defined aliases. If --aa is
supplied, all alias definitions are removed. The return value
is true unless a supplied _n_a_m_e is not a defined alias.
uunnsseett [-ffvv] [_n_a_m_e ...]
For each _n_a_m_e, remove the corresponding variable or function.
For each _n_a_m_e, remove the corresponding variable or function.
If no options are supplied, or the --vv option is given, each _n_a_m_e
refers to a shell variable. Read-only variables may not be
unset. If --ff is specified, each _n_a_m_e refers to a shell func-
tion, and the function definition is removed. Each unset vari-
able or function is removed from the environment passed to sub-
sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD,
refers to a shell variable. Read-only variables may not be
unset. If --ff is specified, each _n_a_m_e refers to a shell func-
tion, and the function definition is removed. Each unset vari-
able or function is removed from the environment passed to sub-
sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD,
FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special
properties, even if they are subsequently reset. The exit sta-
properties, even if they are subsequently reset. The exit sta-
tus is true unless a _n_a_m_e is readonly.
wwaaiitt [_n _._._.]
Wait for each specified process and return its termination sta-
tus. Each _n may be a process ID or a job specification; if a
job spec is given, all processes in that job's pipeline are
waited for. If _n is not given, all currently active child pro-
cesses are waited for, and the return status is zero. If _n
specifies a non-existent process or job, the return status is
127. Otherwise, the return status is the exit status of the
Wait for each specified process and return its termination sta-
tus. Each _n may be a process ID or a job specification; if a
job spec is given, all processes in that job's pipeline are
waited for. If _n is not given, all currently active child pro-
cesses are waited for, and the return status is zero. If _n
specifies a non-existent process or job, the return status is
127. Otherwise, the return status is the exit status of the
last process or job waited for.
SSEEEE AALLSSOO
doc/builtins.ps
+821 -808
View File
File diff suppressed because it is too large Load Diff
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Wed Sep 16 21:35:02 2009
%%CreationDate: Mon Oct 12 10:07:24 2009
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.19 2
doc/version.texi
+2 -2
View File
@@ -2,9 +2,9 @@
Copyright (C) 1988-2009 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Fri Oct 9 12:07:41 EDT 2009
@set LASTCHANGE Fri Oct 16 12:23:41 EDT 2009
@set EDITION 4.1
@set VERSION 4.1
@set UPDATED 9 October 2009
@set UPDATED 16 October 2009
@set UPDATED-MONTH October 2009
doc/version.texi~
+3 -3
View File
@@ -2,9 +2,9 @@
Copyright (C) 1988-2009 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Wed Sep 16 21:33:56 EDT 2009
@set LASTCHANGE Fri Oct 9 12:07:41 EDT 2009
@set EDITION 4.1
@set VERSION 4.1
@set UPDATED 16 September 2009
@set UPDATED-MONTH September 2009
@set UPDATED 9 October 2009
@set UPDATED-MONTH October 2009