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

commit bash-20150227 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2015-03-09 11:11:06 -04:00
parent 60b80a1f45
commit 8a0829e94a
27 changed files with 18361 additions and 17520 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+15
View File
@@ -8037,3 +8037,18 @@ lib/readline/doc/rltech.texi
readline's terminal state if it wants to handle a signal before
the line handler restores it. Suggested by Ulf Magnusson
<ulfalizer@gmail.com>
2/24
----
lib/readline/histfile.c
- history_do_write,history_truncate_file: if the write fails, make sure
to set history_lines_written_to_file to 0 so we don't lose those
history entries
2/27
----
execute_cmd.c
- execute_function: unwind-protect the value of line_number_for_err_trap,
so a function that returns a non-zero value and triggers an ERR trap
has the right value for LINENO. Any simple command in the function
body can change it. Bug report from Paul Donohue <gnu@paulsd.com>
doc/bash.0
+763 -755
View File
File diff suppressed because it is too large Load Diff
doc/bash.html
+188 -27
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2014 August 27<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2015 January 19<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -42,7 +42,7 @@ bash - GNU Bourne-Again SHell
<H3>COPYRIGHT</H3>
Bash is Copyright &#169; 1989-2013 by the Free Software Foundation, Inc.
Bash is Copyright &#169; 1989-2015 by the Free Software Foundation, Inc.
<A NAME="lbAE">&nbsp;</A>
<H3>DESCRIPTION</H3>
@@ -941,10 +941,10 @@ right of the operator is considered a pattern and matched according
to the rules described below under <B>Pattern Matching</B>,
as if the <B>extglob</B> shell option were enabled.
The <B>=</B> operator is equivalent to <B>==</B>.
If the shell option
If the
<B>nocasematch</B>
is enabled, the match is performed without regard to the case
shell option is enabled, the match is performed without regard to the case
of alphabetic characters.
The return value is 0 if the string matches (<B>==</B>) or does not match
(<B>!=</B>) the pattern, and 1 otherwise.
@@ -961,10 +961,10 @@ The return value is 0 if the string matches
the pattern, and 1 otherwise.
If the regular expression is syntactically incorrect, the conditional
expression's return value is 2.
If the shell option
If the
<B>nocasematch</B>
is enabled, the match is performed without regard to the case
shell option is enabled, the match is performed without regard to the case
of alphabetic characters.
Any part of the pattern may be quoted to force the quoted portion
to be matched as a string.
@@ -1119,10 +1119,10 @@ command substitution, process substitution and quote removal.
Each <I>pattern</I> examined is expanded using tilde
expansion, parameter and variable expansion, arithmetic expansion,
command substitution, and process substitution.
If the shell option
If the
<B>nocasematch</B>
is enabled, the match is performed without regard to the case
shell option is enabled, the match is performed without regard to the case
of alphabetic characters.
When a match is found, the corresponding <I>list</I> is executed.
If the <B>;;</B> operator is used, no subsequent matches are attempted after
@@ -1643,7 +1643,7 @@ If the control variable in a <B>for</B> loop has the nameref attribute,
the list of words can be a list of shell variables, and a name reference
will be established for each word in the list, in turn, when the loop is
executed.
Array variables cannot be given the <B>meref</B> attribute.
Array variables cannot be given the <B>nameref</B> attribute.
However, nameref variables can reference array variables and subscripted
array variables.
Namerefs can be unset using the <B>-n</B> option to the <B>unset</B> builtin.
@@ -3229,8 +3229,6 @@ of the special parameters <B>*</B> and <B>@</B> (see
above). ${#<I>name</I>[<I>subscript</I>]} expands to the length of
${<I>name</I>[<I>subscript</I>]}. If <I>subscript</I> is <B>*</B> or
<B>@</B>, the expansion is the number of elements in the array.
Referencing an array variable without a subscript is equivalent to
referencing the array with a subscript of 0.
If the
<I>subscript</I>
@@ -3241,6 +3239,14 @@ so negative indices count back from the end of the
array, and an index of -1 references the last element.
<P>
Referencing an array variable without a subscript is equivalent to
referencing the array with a subscript of 0.
Any reference to a variable using a valid subscript is legal, and
<B>bash</B>
will create an array if necessary.
<P>
An array variable is considered set if a subscript has been assigned a
value. The null string is a valid value.
<P>
@@ -3580,12 +3586,16 @@ The <I>parameter</I> is a shell parameter as described above
<P>
If the first character of <I>parameter</I> is an exclamation point (<B>!</B>),
and <I>parameter</I> is not a <I>nameref</I>,
it introduces a level of variable indirection.
<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
expanded and that value is used in the rest of the substitution, rather
than the value of <I>parameter</I> itself.
This is known as <I>indirect expansion</I>.
If <I>parameter</I> is a nameref, this expands to the name of the
variable referenced by <I>parameter</I> instead of performing the
complete indirect expansion.
The exceptions to this are the expansions of ${<B>!</B><I>prefix</I><B>*</B>} and
${<B>!</B><I>name</I>[<I>@</I>]} described below.
The exclamation point must immediately follow the left brace in order to
@@ -3850,6 +3860,11 @@ If <I>pattern</I> begins with <B>%</B>, it must match at the end
of the expanded value of <I>parameter</I>.
If <I>string</I> is null, matches of <I>pattern</I> are deleted
and the <B>/</B> following <I>pattern</I> may be omitted.
If the
<B>nocasematch</B>
shell option is enabled, the match is performed without regard to the case
of alphabetic characters.
If
<I>parameter</I>
@@ -3915,6 +3930,71 @@ or
the case modification operation is applied to each member of the
array in turn, and the expansion is the resultant list.
<DT>${<I>parameter</I><B>@</B><I>operator</I>}<DD>
<B>Parameter transformation</B>.
The expansion is either a transformation of the value of <I>parameter</I>
or information about <I>parameter</I> itself, depending on the value of
<I>operator</I>. Each <I>operator</I> is a single letter:
<P>
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><B>Q</B>
<DD>
The expansion is a string that is the value of <I>parameter</I> quoted in a
format that can be reused as input.
<DT><B>E</B>
<DD>
The expansion is a string that is the value of <I>parameter</I> with backslash
escape sequences expanded as with the <B>$'...'</B> quoting mechansim.
<DT><B>P</B>
<DD>
The expansion is a string that is the result of expanding the value of
<I>parameter</I> as if it were a prompt string (see <B>PROMPTING</B> below).
<DT><B>A</B>
<DD>
The expansion is a string in the form of a <B>declare</B> command that, if
evaluated, will recreate <I>parameter</I> with its attributes and value.
<DT><B>a</B>
<DD>
The expansion is a string consisting of flag values representing
<I>parameter</I>'s attributes.
</DL>
<P>
If
<I>parameter</I>
is
<B>@</B>
or
<B>*</B>,
the operation is applied to each positional
parameter in turn, and the expansion is the resultant list.
If
<I>parameter</I>
is an array variable subscripted with
<B>@</B>
or
<B>*</B>,
the case modification operation is applied to each member of the
array in turn, and the expansion is the resultant list.
<P>
The result of the expansion is subject to word splitting and pathname
expansion as described below.
</DL>
</DL>
<A NAME="lbBC">&nbsp;</A>
<H4>Command Substitution</H4>
@@ -4232,6 +4312,11 @@ is set, each matching filename that also matches one of the patterns in
</FONT>
is removed from the list of matches.
If the <B>nocaseglob</B> option is set, the matching against the patterns in
<FONT SIZE=-1><B>GLOBIGNORE</B>
</FONT>
is performed without regard to case.
The filenames
<B>``.''</B>
@@ -4785,7 +4870,7 @@ current source until a line containing only
(with no trailing blanks)
is seen. All of
the lines read up to that point are then used as the standard
input for a command.
input (or file descriptor <I>n</I> if <I>n</I> is specified) for a command.
<P>
The format of here-documents is:
@@ -4793,7 +4878,7 @@ The format of here-documents is:
<P>
<PRE>
<B>&lt;&lt;</B>[<B>-</B>]<I>word</I>
[<I>n</I>]<B>&lt;&lt;</B>[<B>-</B>]<I>word</I>
<I>here-document</I>
<I>delimiter</I>
</PRE>
@@ -4853,7 +4938,7 @@ A variant of here documents, the format is:
<P>
<PRE>
<B>&lt;&lt;&lt;</B><I>word</I>
[<I>n</I>]<B>&lt;&lt;&lt;</B><I>word</I>
</PRE>
</DL>
@@ -4865,10 +4950,11 @@ brace expansion, tilde expansion, parameter and variable expansion,
command substitution, arithmetic expansion, and quote removal.
Pathname expansion and word splitting are not performed.
The result is supplied as a single string to the command on its
standard input.
standard input (or file descriptor <I>n</I> if <I>n</I> is specified).
<A NAME="lbBQ">&nbsp;</A>
<H4>Duplicating File Descriptors</H4>
<P>
<P>
The redirection operator
@@ -5346,7 +5432,7 @@ is a decimal number between 2 and 64 representing the arithmetic
base, and <I>n</I> is a number in that base.
If <I>base#</I> is omitted, then base 10 is used.
When specifying <I>n</I>,
the digits greater&lt; than 9 are represented by the lowercase letters,
the digits greater than 9 are represented by the lowercase letters,
the uppercase letters, @, and _, in that order.
If <I>base</I> is less than or equal to 36, lowercase and uppercase
letters may be used interchangeably to represent numbers between 10
@@ -6843,6 +6929,13 @@ If set to <B>audible</B>, readline attempts to ring the terminal's bell.
If set to <B>On</B>, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their readline
equivalents.
<DT><B>colored-completion-prefix (Off)</B>
<DD>
If set to <B>On</B>, when listing completions, readline displays the
common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the <B>LS_COLORS</B>
environment variable.
<DT><B>colored-stats (Off)</B>
<DD>
@@ -6919,6 +7012,14 @@ or
When set to <B>On</B>, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
<DT><B>enable-bracketed-paste (Off)</B>
<DD>
When set to <B>On</B>, readline will configure the terminal in a way
that will enable it to insert each paste into the editing buffer as a
single string of characters, instead of treating each character as if
it had been read from the keyboard. This can prevent pasted characters
from being interpreted as editing commands.
<DT><B>enable-keypad (Off)</B>
<DD>
@@ -6942,7 +7043,7 @@ attempts word completion.
If set to <B>On</B>, the history code attempts to place point at the
same location on each history line retrieved with <B>previous-history</B>
or <B>next-history</B>.
<DT><B>history-size (0)</B>
<DT><B>history-size (unset)</B>
<DD>
Set the maximum number of history entries saved in the history list.
@@ -6989,6 +7090,16 @@ the value of
<B>editing-mode</B>
also affects the default keymap.
<DT><B>emacs-mode-string (@)</B>
<DD>
This string is displayed immediately before the last line of the primary
prompt when emacs editing mode is active. The value is expanded like a
key binding, so the standard set of meta- and control prefixes and
backslash escape sequences is available.
Use the \1 and \2 escapes to begin and end sequences of
non-printing characters, which can be used to embed a terminal control
sequence into the mode string.
<DT><B>keyseq-timeout (500)</B>
<DD>
@@ -7092,6 +7203,28 @@ performing completion in the middle of a word. If enabled, readline
does not insert characters from the completion that match characters
after point in the word being completed, so portions of the word
following the cursor are not duplicated.
<DT><B>vi-cmd-mode-string ((cmd))</B>
<DD>
This string is displayed immediately before the last line of the primary
prompt when vi editing mode is active and in command mode.
The value is expanded like a
key binding, so the standard set of meta- and control prefixes and
backslash escape sequences is available.
Use the \1 and \2 escapes to begin and end sequences of
non-printing characters, which can be used to embed a terminal control
sequence into the mode string.
<DT><B>vi-ins-mode-string ((ins))</B>
<DD>
This string is displayed immediately before the last line of the primary
prompt when vi editing mode is active and in insertion mode.
The value is expanded like a
key binding, so the standard set of meta- and control prefixes and
backslash escape sequences is available.
Use the \1 and \2 escapes to begin and end sequences of
non-printing characters, which can be used to embed a terminal control
sequence into the mode string.
<DT><B>visible-stats (Off)</B>
<DD>
@@ -7133,7 +7266,7 @@ key bindings, perhaps to bind the key sequences output by the
terminal's function keys. The word on the right side of the
<B>=</B>
is tested against the both full name of the terminal and the portion
is tested against both the full name of the terminal and the portion
of the terminal name before the first <B>-</B>. This allows
<I>sun</I>
@@ -7677,7 +7810,7 @@ If the command is followed by digits, executing
again ends the numeric argument, but is otherwise ignored.
As a special case, if this command is immediately followed by a
character that is neither a digit or minus sign, the argument count
character that is neither a digit nor minus sign, the argument count
for the next command is multiplied by four.
The argument count is initially one, so executing this function the
first time makes the argument count four, a second time makes the
@@ -8144,6 +8277,11 @@ is removed before attempting a match.
Any completion that matches the pattern will be removed from the list.
A leading <B>!</B> negates the pattern; in this case any completion
not matching the pattern will be removed.
If the
<B>nocasematch</B>
shell option is enabled, the match is performed without regard to the case
of alphabetic characters.
<P>
Finally, any prefix and suffix specified with the <B>-P</B> and <B>-S</B>
@@ -9270,6 +9408,10 @@ Intended to be used with shell functions.
<DD>
Tell readline not to quote the completed words if they are filenames
(quoting filenames is the default).
<DT><B>nosort</B>
<DD>
Tell readline not to sort the list of possible completions alphabetically.
<DT><B>nospace</B>
<DD>
@@ -10581,7 +10723,7 @@ evaluates to 0,
<B>let</B>
returns 1; 0 is returned otherwise.
<DT><B>local</B> [<I>option</I>] [<I>name</I>[=<I>value</I>] ...]<DD>
<DT><B>local</B> [<I>option</I>] [<I>name</I>[=<I>value</I>] ... | - ]<DD>
For each argument, a local variable named
<I>name</I>
@@ -10596,6 +10738,10 @@ is used within a function, it causes the variable
<I>name</I>
to have a visible scope restricted to that function and its children.
If <I>name</I> is -, the set of shell options is made local to the function
in which <B>local</B> is invoked: shell options changed using the
<B>set</B> builtin inside the function are restored to their original values
when the function returns.
With no operands,
<B>local</B>
@@ -10982,7 +11128,7 @@ buffer before editing begins.
<DD>
<B>read</B> returns after reading <I>nchars</I> characters rather than
waiting for a complete line of input, but honor a delimiter if fewer
waiting for a complete line of input, but honors a delimiter if fewer
than <I>nchars</I> characters are read before the delimiter.
<DT><B>-N </B><I>nchars</I>
@@ -11166,8 +11312,9 @@ Options, if specified, have the following meanings:
<DT><B>-a</B>
<DD>
Automatically mark variables and functions which are modified or
created for export to the environment of subsequent commands.
Each variable or function that is created or modified is given the
export attribute and marked for export to the environment of
subsequent commands.
<DT><B>-b</B>
<DD>
@@ -12166,7 +12313,9 @@ If set,
<B>bash</B>
matches patterns in a case-insensitive fashion when performing matching
while executing <B>case</B> or <B>[[</B> conditional commands.
while executing <B>case</B> or <B>[[</B> conditional commands,
when performing pattern substitution word expansions,
or when filtering possible completions as part of programmable completion.
<DT><B>nullglob</B>
<DD>
@@ -12626,7 +12775,7 @@ option suppresses shell function lookup, as with the <B>command</B> builtin.
returns true if all of the arguments are found, false if
any are not found.
<DT><B>ulimit</B> [<B>-HSTabcdefilmnpqrstuvx</B> [<I>limit</I>]]<DD>
<DT><B>ulimit</B> [<B>-HSabcdefiklmnpqrstuvxPT</B> [<I>limit</I>]]<DD>
Provides control over the resources available to the shell and to
processes started by it, on systems that allow such control.
The <B>-H</B> and <B>-S</B> options specify that the hard or soft limit is
@@ -12687,6 +12836,10 @@ The maximum size of files written by the shell and its children
<DD>
The maximum number of pending signals
<DT><B>-k</B>
<DD>
The maximum number of kqueues that may be allocated
<DT><B>-l</B>
<DD>
@@ -12733,6 +12886,10 @@ some systems, to its children
<DD>
The maximum number of file locks
<DT><B>-P</B>
<DD>
The maximum number of pseudoterminals
<DT><B>-T</B>
<DD>
@@ -12760,10 +12917,14 @@ which is in seconds;
which is in units of 512-byte blocks;
and
<B>-P</B>,
<B>-T</B>,
<B>-b</B>,
<B>-k</B>,
<B>-n</B>,
and
@@ -13186,7 +13347,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 4.3<TH ALIGN=CENTER width=33%>2014 August 27<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2015 January 19<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13292,6 +13453,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 15 September 2014 12:02:02 EDT
Time: 23 February 2015 09:20:49 EST
</BODY>
</HTML>
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+5621 -5412
View File
File diff suppressed because it is too large Load Diff
doc/bashref.aux
+54 -54
View File
@@ -96,22 +96,22 @@
@xrdef{Shell Parameter Expansion-pg}{23}
@xrdef{Command Substitution-title}{Command Substitution}
@xrdef{Command Substitution-snt}{Section@tie 3.5.4}
@xrdef{Command Substitution-pg}{28}
@xrdef{Arithmetic Expansion-title}{Arithmetic Expansion}
@xrdef{Arithmetic Expansion-snt}{Section@tie 3.5.5}
@xrdef{Process Substitution-title}{Process Substitution}
@xrdef{Process Substitution-snt}{Section@tie 3.5.6}
@xrdef{Command Substitution-pg}{29}
@xrdef{Arithmetic Expansion-pg}{29}
@xrdef{Word Splitting-title}{Word Splitting}
@xrdef{Word Splitting-snt}{Section@tie 3.5.7}
@xrdef{Arithmetic Expansion-pg}{29}
@xrdef{Process Substitution-pg}{29}
@xrdef{Word Splitting-pg}{29}
@xrdef{Filename Expansion-title}{Filename Expansion}
@xrdef{Filename Expansion-snt}{Section@tie 3.5.8}
@xrdef{Process Substitution-pg}{30}
@xrdef{Word Splitting-pg}{30}
@xrdef{Filename Expansion-pg}{30}
@xrdef{Pattern Matching-title}{Pattern Matching}
@xrdef{Pattern Matching-snt}{Section@tie 3.5.8.1}
@xrdef{Filename Expansion-pg}{30}
@xrdef{Pattern Matching-pg}{30}
@xrdef{Pattern Matching-pg}{31}
@xrdef{Quote Removal-title}{Quote Removal}
@xrdef{Quote Removal-snt}{Section@tie 3.5.9}
@xrdef{Redirections-title}{Redirections}
@@ -122,26 +122,26 @@
@xrdef{Executing Commands-snt}{Section@tie 3.7}
@xrdef{Simple Command Expansion-title}{Simple Command Expansion}
@xrdef{Simple Command Expansion-snt}{Section@tie 3.7.1}
@xrdef{Executing Commands-pg}{35}
@xrdef{Simple Command Expansion-pg}{35}
@xrdef{Command Search and Execution-title}{Command Search and Execution}
@xrdef{Command Search and Execution-snt}{Section@tie 3.7.2}
@xrdef{Command Search and Execution-pg}{36}
@xrdef{Executing Commands-pg}{36}
@xrdef{Simple Command Expansion-pg}{36}
@xrdef{Command Execution Environment-title}{Command Execution Environment}
@xrdef{Command Execution Environment-snt}{Section@tie 3.7.3}
@xrdef{Command Search and Execution-pg}{37}
@xrdef{Command Execution Environment-pg}{37}
@xrdef{Environment-title}{Environment}
@xrdef{Environment-snt}{Section@tie 3.7.4}
@xrdef{Environment-pg}{38}
@xrdef{Exit Status-title}{Exit Status}
@xrdef{Exit Status-snt}{Section@tie 3.7.5}
@xrdef{Environment-pg}{38}
@xrdef{Exit Status-pg}{38}
@xrdef{Signals-title}{Signals}
@xrdef{Signals-snt}{Section@tie 3.7.6}
@xrdef{Exit Status-pg}{39}
@xrdef{Signals-pg}{39}
@xrdef{Shell Scripts-title}{Shell Scripts}
@xrdef{Shell Scripts-snt}{Section@tie 3.8}
@xrdef{Signals-pg}{39}
@xrdef{Shell Scripts-pg}{39}
@xrdef{Shell Scripts-pg}{40}
@xrdef{Shell Builtin Commands-title}{Shell Builtin Commands}
@xrdef{Shell Builtin Commands-snt}{Chapter@tie 4}
@xrdef{Bourne Shell Builtins-title}{Bourne Shell Builtins}
@@ -155,7 +155,7 @@
@xrdef{Modifying Shell Behavior-snt}{Section@tie 4.3}
@xrdef{The Set Builtin-title}{The Set Builtin}
@xrdef{The Set Builtin-snt}{Section@tie 4.3.1}
@xrdef{Modifying Shell Behavior-pg}{58}
@xrdef{Modifying Shell Behavior-pg}{59}
@xrdef{The Set Builtin-pg}{59}
@xrdef{The Shopt Builtin-title}{The Shopt Builtin}
@xrdef{The Shopt Builtin-snt}{Section@tie 4.3.2}
@@ -264,121 +264,121 @@
@xrdef{Readline Init File Syntax-pg}{104}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2}
@xrdef{Conditional Init Constructs-pg}{111}
@xrdef{Conditional Init Constructs-pg}{112}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 8.3.3}
@xrdef{Sample Init File-pg}{112}
@xrdef{Sample Init File-pg}{113}
@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}{115}
@xrdef{Commands For Moving-pg}{115}
@xrdef{Commands For History-pg}{116}
@xrdef{Bindable Readline Commands-pg}{116}
@xrdef{Commands For Moving-pg}{116}
@xrdef{Commands For History-pg}{117}
@xrdef{Commands For Text-title}{Commands For Changing Text}
@xrdef{Commands For Text-snt}{Section@tie 8.4.3}
@xrdef{Commands For Text-pg}{117}
@xrdef{Commands For Text-pg}{118}
@xrdef{Commands For Killing-title}{Killing And Yanking}
@xrdef{Commands For Killing-snt}{Section@tie 8.4.4}
@xrdef{Commands For Killing-pg}{118}
@xrdef{Commands For Killing-pg}{119}
@xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
@xrdef{Numeric Arguments-snt}{Section@tie 8.4.5}
@xrdef{Numeric Arguments-pg}{119}
@xrdef{Commands For Completion-title}{Letting Readline Type For You}
@xrdef{Commands For Completion-snt}{Section@tie 8.4.6}
@xrdef{Commands For Completion-pg}{120}
@xrdef{Numeric Arguments-pg}{121}
@xrdef{Commands For Completion-pg}{121}
@xrdef{Keyboard Macros-title}{Keyboard Macros}
@xrdef{Keyboard Macros-snt}{Section@tie 8.4.7}
@xrdef{Keyboard Macros-pg}{121}
@xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
@xrdef{Miscellaneous Commands-snt}{Section@tie 8.4.8}
@xrdef{Miscellaneous Commands-pg}{122}
@xrdef{Keyboard Macros-pg}{123}
@xrdef{Miscellaneous Commands-pg}{123}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 8.5}
@xrdef{Programmable Completion-title}{Programmable Completion}
@xrdef{Programmable Completion-snt}{Section@tie 8.6}
@xrdef{Readline vi Mode-pg}{124}
@xrdef{Programmable Completion-pg}{124}
@xrdef{Readline vi Mode-pg}{125}
@xrdef{Programmable Completion-pg}{126}
@xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins}
@xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7}
@xrdef{Programmable Completion Builtins-pg}{126}
@xrdef{Programmable Completion Builtins-pg}{128}
@xrdef{A Programmable Completion Example-title}{A Programmable Completion Example}
@xrdef{A Programmable Completion Example-snt}{Section@tie 8.8}
@xrdef{A Programmable Completion Example-pg}{130}
@xrdef{A Programmable Completion Example-pg}{131}
@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}{133}
@xrdef{Bash History Facilities-pg}{133}
@xrdef{Bash History Builtins-pg}{133}
@xrdef{Using History Interactively-pg}{134}
@xrdef{Bash History Facilities-pg}{134}
@xrdef{Bash History Builtins-pg}{134}
@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}{135}
@xrdef{Event Designators-pg}{135}
@xrdef{History Interaction-pg}{136}
@xrdef{Event Designators-pg}{136}
@xrdef{Word Designators-title}{Word Designators}
@xrdef{Word Designators-snt}{Section@tie 9.3.2}
@xrdef{Word Designators-pg}{136}
@xrdef{Word Designators-pg}{137}
@xrdef{Modifiers-title}{Modifiers}
@xrdef{Modifiers-snt}{Section@tie 9.3.3}
@xrdef{Modifiers-pg}{137}
@xrdef{Modifiers-pg}{138}
@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}{138}
@xrdef{Basic Installation-pg}{138}
@xrdef{Installing Bash-pg}{139}
@xrdef{Basic Installation-pg}{139}
@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}{139}
@xrdef{Compiling For Multiple Architectures-pg}{139}
@xrdef{Installation Names-pg}{139}
@xrdef{Specifying the System Type-pg}{139}
@xrdef{Compilers and Options-pg}{140}
@xrdef{Compiling For Multiple Architectures-pg}{140}
@xrdef{Installation Names-pg}{140}
@xrdef{Specifying the System Type-pg}{140}
@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}{140}
@xrdef{Operation Controls-pg}{140}
@xrdef{Optional Features-pg}{140}
@xrdef{Sharing Defaults-pg}{141}
@xrdef{Operation Controls-pg}{141}
@xrdef{Optional Features-pg}{141}
@xrdef{Reporting Bugs-title}{Reporting Bugs}
@xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}}
@xrdef{Reporting Bugs-pg}{145}
@xrdef{Reporting Bugs-pg}{146}
@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}{146}
@xrdef{Major Differences From The Bourne Shell-pg}{147}
@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}{152}
@xrdef{GNU Free Documentation License-pg}{153}
@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}{160}
@xrdef{Builtin Index-pg}{160}
@xrdef{Indexes-pg}{161}
@xrdef{Builtin Index-pg}{161}
@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}{161}
@xrdef{Variable Index-pg}{161}
@xrdef{Reserved Word Index-pg}{162}
@xrdef{Variable Index-pg}{162}
@xrdef{Function Index-title}{Function Index}
@xrdef{Function Index-snt}{Section@tie @char68.4}
@xrdef{Function Index-pg}{163}
@xrdef{Function Index-pg}{164}
@xrdef{Concept Index-title}{Concept Index}
@xrdef{Concept Index-snt}{Section@tie @char68.5}
@xrdef{Concept Index-pg}{165}
@xrdef{Concept Index-pg}{166}
doc/bashref.bt
+6 -6
View File
@@ -35,7 +35,7 @@
\entry{printf}{54}{\code {printf}}
\entry{read}{55}{\code {read}}
\entry{readarray}{56}{\code {readarray}}
\entry{source}{56}{\code {source}}
\entry{source}{57}{\code {source}}
\entry{type}{57}{\code {type}}
\entry{typeset}{57}{\code {typeset}}
\entry{ulimit}{57}{\code {ulimit}}
@@ -52,8 +52,8 @@
\entry{wait}{99}{\code {wait}}
\entry{disown}{99}{\code {disown}}
\entry{suspend}{99}{\code {suspend}}
\entry{compgen}{126}{\code {compgen}}
\entry{complete}{127}{\code {complete}}
\entry{compopt}{130}{\code {compopt}}
\entry{fc}{133}{\code {fc}}
\entry{history}{134}{\code {history}}
\entry{compgen}{128}{\code {compgen}}
\entry{complete}{128}{\code {complete}}
\entry{compopt}{131}{\code {compopt}}
\entry{fc}{134}{\code {fc}}
\entry{history}{135}{\code {history}}
doc/bashref.bts
+6 -6
View File
@@ -15,9 +15,9 @@
\entry {\code {caller}}{50}
\entry {\code {cd}}{42}
\entry {\code {command}}{50}
\entry {\code {compgen}}{126}
\entry {\code {complete}}{127}
\entry {\code {compopt}}{130}
\entry {\code {compgen}}{128}
\entry {\code {complete}}{128}
\entry {\code {compopt}}{131}
\entry {\code {continue}}{42}
\initial {D}
\entry {\code {declare}}{50}
@@ -31,14 +31,14 @@
\entry {\code {exit}}{43}
\entry {\code {export}}{43}
\initial {F}
\entry {\code {fc}}{133}
\entry {\code {fc}}{134}
\entry {\code {fg}}{98}
\initial {G}
\entry {\code {getopts}}{43}
\initial {H}
\entry {\code {hash}}{44}
\entry {\code {help}}{53}
\entry {\code {history}}{134}
\entry {\code {history}}{135}
\initial {J}
\entry {\code {jobs}}{98}
\initial {K}
@@ -63,7 +63,7 @@
\entry {\code {set}}{59}
\entry {\code {shift}}{45}
\entry {\code {shopt}}{63}
\entry {\code {source}}{56}
\entry {\code {source}}{57}
\entry {\code {suspend}}{99}
\initial {T}
\entry {\code {test}}{45}
doc/bashref.cp
+23 -23
View File
@@ -51,26 +51,26 @@
\entry{expansion, tilde}{22}{expansion, tilde}
\entry{parameter expansion}{23}{parameter expansion}
\entry{expansion, parameter}{23}{expansion, parameter}
\entry{command substitution}{28}{command substitution}
\entry{command substitution}{29}{command substitution}
\entry{expansion, arithmetic}{29}{expansion, arithmetic}
\entry{arithmetic expansion}{29}{arithmetic expansion}
\entry{process substitution}{29}{process substitution}
\entry{word splitting}{29}{word splitting}
\entry{process substitution}{30}{process substitution}
\entry{word splitting}{30}{word splitting}
\entry{expansion, filename}{30}{expansion, filename}
\entry{expansion, pathname}{30}{expansion, pathname}
\entry{filename expansion}{30}{filename expansion}
\entry{pathname expansion}{30}{pathname expansion}
\entry{pattern matching}{30}{pattern matching}
\entry{matching, pattern}{30}{matching, pattern}
\entry{pattern matching}{31}{pattern matching}
\entry{matching, pattern}{31}{matching, pattern}
\entry{redirection}{32}{redirection}
\entry{command expansion}{35}{command expansion}
\entry{command execution}{36}{command execution}
\entry{command search}{36}{command search}
\entry{command expansion}{36}{command expansion}
\entry{command execution}{37}{command execution}
\entry{command search}{37}{command search}
\entry{execution environment}{37}{execution environment}
\entry{environment}{38}{environment}
\entry{exit status}{38}{exit status}
\entry{exit status}{39}{exit status}
\entry{signal handling}{39}{signal handling}
\entry{shell script}{39}{shell script}
\entry{shell script}{40}{shell script}
\entry{special builtin}{68}{special builtin}
\entry{login shell}{82}{login shell}
\entry{interactive shell}{82}{interactive shell}
@@ -103,16 +103,16 @@
\entry{kill ring}{103}{kill ring}
\entry{initialization file, readline}{104}{initialization file, readline}
\entry{variables, readline}{105}{variables, readline}
\entry{programmable completion}{124}{programmable completion}
\entry{completion builtins}{126}{completion builtins}
\entry{History, how to use}{132}{History, how to use}
\entry{command history}{133}{command history}
\entry{history list}{133}{history list}
\entry{history builtins}{133}{history builtins}
\entry{history expansion}{135}{history expansion}
\entry{event designators}{135}{event designators}
\entry{history events}{135}{history events}
\entry{installation}{138}{installation}
\entry{configuration}{138}{configuration}
\entry{Bash installation}{138}{Bash installation}
\entry{Bash configuration}{138}{Bash configuration}
\entry{programmable completion}{126}{programmable completion}
\entry{completion builtins}{128}{completion builtins}
\entry{History, how to use}{133}{History, how to use}
\entry{command history}{134}{command history}
\entry{history list}{134}{history list}
\entry{history builtins}{134}{history builtins}
\entry{history expansion}{136}{history expansion}
\entry{event designators}{136}{event designators}
\entry{history events}{136}{history events}
\entry{installation}{139}{installation}
\entry{configuration}{139}{configuration}
\entry{Bash installation}{139}{Bash installation}
\entry{Bash configuration}{139}{Bash configuration}
doc/bashref.cps
+23 -23
View File
@@ -6,18 +6,18 @@
\entry {arrays}{89}
\initial {B}
\entry {background}{97}
\entry {Bash configuration}{138}
\entry {Bash installation}{138}
\entry {Bash configuration}{139}
\entry {Bash installation}{139}
\entry {Bourne shell}{5}
\entry {brace expansion}{21}
\entry {builtin}{3}
\initial {C}
\entry {command editing}{102}
\entry {command execution}{36}
\entry {command expansion}{35}
\entry {command history}{133}
\entry {command search}{36}
\entry {command substitution}{28}
\entry {command execution}{37}
\entry {command expansion}{36}
\entry {command history}{134}
\entry {command search}{37}
\entry {command substitution}{29}
\entry {command timing}{8}
\entry {commands, compound}{9}
\entry {commands, conditional}{10}
@@ -28,8 +28,8 @@
\entry {commands, shell}{8}
\entry {commands, simple}{8}
\entry {comments, shell}{7}
\entry {completion builtins}{126}
\entry {configuration}{138}
\entry {completion builtins}{128}
\entry {configuration}{139}
\entry {control operator}{3}
\entry {coprocess}{15}
\initial {D}
@@ -38,9 +38,9 @@
\entry {editing command lines}{102}
\entry {environment}{38}
\entry {evaluation, arithmetic}{87}
\entry {event designators}{135}
\entry {event designators}{136}
\entry {execution environment}{37}
\entry {exit status}{3, 38}
\entry {exit status}{3, 39}
\entry {expansion}{21}
\entry {expansion, arithmetic}{29}
\entry {expansion, brace}{21}
@@ -57,15 +57,15 @@
\entry {foreground}{97}
\entry {functions, shell}{17}
\initial {H}
\entry {history builtins}{133}
\entry {history events}{135}
\entry {history expansion}{135}
\entry {history list}{133}
\entry {History, how to use}{132}
\entry {history builtins}{134}
\entry {history events}{136}
\entry {history expansion}{136}
\entry {history list}{134}
\entry {History, how to use}{133}
\initial {I}
\entry {identifier}{3}
\entry {initialization file, readline}{104}
\entry {installation}{138}
\entry {installation}{139}
\entry {interaction, readline}{101}
\entry {interactive shell}{82, 83}
\entry {internationalization}{7}
@@ -79,7 +79,7 @@
\entry {localization}{7}
\entry {login shell}{82}
\initial {M}
\entry {matching, pattern}{30}
\entry {matching, pattern}{31}
\entry {metacharacter}{3}
\initial {N}
\entry {name}{3}
@@ -93,14 +93,14 @@
\entry {parameters, positional}{20}
\entry {parameters, special}{20}
\entry {pathname expansion}{30}
\entry {pattern matching}{30}
\entry {pattern matching}{31}
\entry {pipeline}{8}
\entry {POSIX}{3}
\entry {POSIX Mode}{94}
\entry {process group}{3}
\entry {process group ID}{3}
\entry {process substitution}{29}
\entry {programmable completion}{124}
\entry {process substitution}{30}
\entry {programmable completion}{126}
\entry {prompting}{92}
\initial {Q}
\entry {quoting}{6}
@@ -114,7 +114,7 @@
\initial {S}
\entry {shell arithmetic}{87}
\entry {shell function}{17}
\entry {shell script}{39}
\entry {shell script}{40}
\entry {shell variable}{18}
\entry {shell, interactive}{83}
\entry {signal}{4}
@@ -131,6 +131,6 @@
\entry {variables, readline}{105}
\initial {W}
\entry {word}{4}
\entry {word splitting}{29}
\entry {word splitting}{30}
\initial {Y}
\entry {yanking text}{103}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.fn
+108 -107
View File
@@ -1,107 +1,108 @@
\entry{beginning-of-line (C-a)}{115}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{115}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{115}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{115}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{115}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{115}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{115}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{115}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{115}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{115}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{116}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{116}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{116}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{116}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{116}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{116}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{116}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{116}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{116}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{116}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{116}{\code {history-search-backward ()}}
\entry{history-substr-search-forward ()}{116}{\code {history-substr-search-forward ()}}
\entry{history-substr-search-backward ()}{117}{\code {history-substr-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{117}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{117}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{117}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{117}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{117}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{117}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{117}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{118}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{transpose-chars (C-t)}{118}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{118}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{118}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{118}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{118}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{118}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{118}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{118}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{118}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{118}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{118}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{119}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{119}{\code {shell-kill-word ()}}
\entry{shell-backward-kill-word ()}{119}{\code {shell-backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{119}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{119}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{119}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{119}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{119}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{119}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{119}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{119}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{119}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{119}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{119}{\code {universal-argument ()}}
\entry{complete (TAB)}{120}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{120}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{120}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{120}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{120}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{120}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{120}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{120}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{121}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{121}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{121}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{121}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{121}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{121}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{121}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{121}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{121}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{121}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-|a)}{121}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{121}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{121}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{121}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{122}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{122}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{122}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{122}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{122}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{122}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{122}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{122}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{122}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{122}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{122}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{122}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{122}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{123}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{123}{\code {dump-functions ()}}
\entry{dump-variables ()}{123}{\code {dump-variables ()}}
\entry{dump-macros ()}{123}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{123}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{123}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{123}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{123}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{123}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{123}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{124}{\code {magic-space ()}}
\entry{alias-expand-line ()}{124}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{124}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{124}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{124}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{124}{\code {edit-and-execute-command (C-xC-e)}}
\entry{beginning-of-line (C-a)}{116}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{116}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{116}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{116}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{116}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{116}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{116}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{116}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{116}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{116}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{117}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{117}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{117}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{117}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{117}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{117}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{117}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{117}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{117}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{117}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{117}{\code {history-search-backward ()}}
\entry{history-substr-search-forward ()}{117}{\code {history-substr-search-forward ()}}
\entry{history-substr-search-backward ()}{118}{\code {history-substr-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{118}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{118}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{118}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{118}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{118}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{118}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{118}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{119}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{119}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{119}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{119}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{119}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{119}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{119}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{119}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{119}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{119}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{120}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{120}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{120}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{120}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{120}{\code {shell-kill-word ()}}
\entry{shell-backward-kill-word ()}{120}{\code {shell-backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{120}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{120}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{120}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{120}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{120}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{120}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{120}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{120}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{120}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{121}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{121}{\code {universal-argument ()}}
\entry{complete (TAB)}{121}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{121}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{121}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{121}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{121}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{122}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{122}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{122}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{122}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{122}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{122}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{122}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{122}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{122}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{122}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{122}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{122}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{122}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-|a)}{122}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{123}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{123}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{123}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{123}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{123}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{123}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{123}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{123}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{123}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{123}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{123}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{123}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{123}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{123}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{124}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{124}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{124}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{124}{\code {dump-functions ()}}
\entry{dump-variables ()}{124}{\code {dump-variables ()}}
\entry{dump-macros ()}{124}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{124}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{124}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{125}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{125}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{125}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{125}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{125}{\code {magic-space ()}}
\entry{alias-expand-line ()}{125}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{125}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{125}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{125}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{125}{\code {edit-and-execute-command (C-xC-e)}}
doc/bashref.fns
+108 -107
View File
@@ -1,127 +1,128 @@
\initial {A}
\entry {\code {abort (C-g)}}{122}
\entry {\code {accept-line (Newline or Return)}}{116}
\entry {\code {alias-expand-line ()}}{124}
\entry {\code {abort (C-g)}}{123}
\entry {\code {accept-line (Newline or Return)}}{117}
\entry {\code {alias-expand-line ()}}{125}
\initial {B}
\entry {\code {backward-char (C-b)}}{115}
\entry {\code {backward-delete-char (Rubout)}}{117}
\entry {\code {backward-kill-line (C-x Rubout)}}{118}
\entry {\code {backward-kill-word (M-\key {DEL})}}{119}
\entry {\code {backward-word (M-b)}}{115}
\entry {\code {beginning-of-history (M-<)}}{116}
\entry {\code {beginning-of-line (C-a)}}{115}
\entry {\code {backward-char (C-b)}}{116}
\entry {\code {backward-delete-char (Rubout)}}{118}
\entry {\code {backward-kill-line (C-x Rubout)}}{119}
\entry {\code {backward-kill-word (M-\key {DEL})}}{120}
\entry {\code {backward-word (M-b)}}{116}
\entry {\code {beginning-of-history (M-<)}}{117}
\entry {\code {beginning-of-line (C-a)}}{116}
\entry {\code {bracketed-paste-begin ()}}{119}
\initial {C}
\entry {\code {call-last-kbd-macro (C-x e)}}{121}
\entry {\code {capitalize-word (M-c)}}{118}
\entry {\code {character-search (C-])}}{122}
\entry {\code {character-search-backward (M-C-])}}{122}
\entry {\code {clear-screen (C-l)}}{115}
\entry {\code {complete (\key {TAB})}}{120}
\entry {\code {complete-command (M-!)}}{121}
\entry {\code {complete-filename (M-/)}}{120}
\entry {\code {complete-hostname (M-@)}}{121}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{121}
\entry {\code {complete-username (M-~)}}{121}
\entry {\code {complete-variable (M-$)}}{121}
\entry {\code {copy-backward-word ()}}{119}
\entry {\code {copy-forward-word ()}}{119}
\entry {\code {copy-region-as-kill ()}}{119}
\entry {\code {call-last-kbd-macro (C-x e)}}{123}
\entry {\code {capitalize-word (M-c)}}{119}
\entry {\code {character-search (C-])}}{123}
\entry {\code {character-search-backward (M-C-])}}{124}
\entry {\code {clear-screen (C-l)}}{116}
\entry {\code {complete (\key {TAB})}}{121}
\entry {\code {complete-command (M-!)}}{122}
\entry {\code {complete-filename (M-/)}}{122}
\entry {\code {complete-hostname (M-@)}}{122}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{122}
\entry {\code {complete-username (M-~)}}{122}
\entry {\code {complete-variable (M-$)}}{122}
\entry {\code {copy-backward-word ()}}{120}
\entry {\code {copy-forward-word ()}}{120}
\entry {\code {copy-region-as-kill ()}}{120}
\initial {D}
\entry {\code {dabbrev-expand ()}}{121}
\entry {\code {delete-char (C-d)}}{117}
\entry {\code {delete-char-or-list ()}}{120}
\entry {\code {delete-horizontal-space ()}}{119}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{119}
\entry {\code {display-shell-version (C-x C-v)}}{123}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{122}
\entry {\code {downcase-word (M-l)}}{118}
\entry {\code {dump-functions ()}}{123}
\entry {\code {dump-macros ()}}{123}
\entry {\code {dump-variables ()}}{123}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{121}
\entry {\code {dabbrev-expand ()}}{122}
\entry {\code {delete-char (C-d)}}{118}
\entry {\code {delete-char-or-list ()}}{122}
\entry {\code {delete-horizontal-space ()}}{120}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{121}
\entry {\code {display-shell-version (C-x C-v)}}{125}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{123}
\entry {\code {downcase-word (M-l)}}{119}
\entry {\code {dump-functions ()}}{124}
\entry {\code {dump-macros ()}}{124}
\entry {\code {dump-variables ()}}{124}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{122}
\initial {E}
\entry {\code {edit-and-execute-command (C-xC-e)}}{124}
\entry {\code {end-kbd-macro (C-x ))}}{121}
\entry {\code {\i {end-of-file} (usually C-d)}}{117}
\entry {\code {end-of-history (M->)}}{116}
\entry {\code {end-of-line (C-e)}}{115}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{122}
\entry {\code {edit-and-execute-command (C-xC-e)}}{125}
\entry {\code {end-kbd-macro (C-x ))}}{123}
\entry {\code {\i {end-of-file} (usually C-d)}}{118}
\entry {\code {end-of-history (M->)}}{117}
\entry {\code {end-of-line (C-e)}}{116}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{123}
\initial {F}
\entry {\code {forward-backward-delete-char ()}}{117}
\entry {\code {forward-char (C-f)}}{115}
\entry {\code {forward-search-history (C-s)}}{116}
\entry {\code {forward-word (M-f)}}{115}
\entry {\code {forward-backward-delete-char ()}}{118}
\entry {\code {forward-char (C-f)}}{116}
\entry {\code {forward-search-history (C-s)}}{117}
\entry {\code {forward-word (M-f)}}{116}
\initial {G}
\entry {\code {glob-complete-word (M-g)}}{123}
\entry {\code {glob-expand-word (C-x *)}}{123}
\entry {\code {glob-list-expansions (C-x g)}}{123}
\entry {\code {glob-complete-word (M-g)}}{124}
\entry {\code {glob-expand-word (C-x *)}}{124}
\entry {\code {glob-list-expansions (C-x g)}}{125}
\initial {H}
\entry {\code {history-and-alias-expand-line ()}}{124}
\entry {\code {history-expand-line (M-^)}}{123}
\entry {\code {history-search-backward ()}}{116}
\entry {\code {history-search-forward ()}}{116}
\entry {\code {history-substr-search-backward ()}}{117}
\entry {\code {history-substr-search-forward ()}}{116}
\entry {\code {history-and-alias-expand-line ()}}{125}
\entry {\code {history-expand-line (M-^)}}{125}
\entry {\code {history-search-backward ()}}{117}
\entry {\code {history-search-forward ()}}{117}
\entry {\code {history-substr-search-backward ()}}{118}
\entry {\code {history-substr-search-forward ()}}{117}
\initial {I}
\entry {\code {insert-comment (M-#)}}{123}
\entry {\code {insert-completions (M-*)}}{120}
\entry {\code {insert-last-argument (M-. or M-_)}}{124}
\entry {\code {insert-comment (M-#)}}{124}
\entry {\code {insert-completions (M-*)}}{121}
\entry {\code {insert-last-argument (M-. or M-_)}}{125}
\initial {K}
\entry {\code {kill-line (C-k)}}{118}
\entry {\code {kill-region ()}}{119}
\entry {\code {kill-whole-line ()}}{118}
\entry {\code {kill-word (M-d)}}{118}
\entry {\code {kill-line (C-k)}}{119}
\entry {\code {kill-region ()}}{120}
\entry {\code {kill-whole-line ()}}{120}
\entry {\code {kill-word (M-d)}}{120}
\initial {M}
\entry {\code {magic-space ()}}{124}
\entry {\code {menu-complete ()}}{120}
\entry {\code {menu-complete-backward ()}}{120}
\entry {\code {magic-space ()}}{125}
\entry {\code {menu-complete ()}}{121}
\entry {\code {menu-complete-backward ()}}{121}
\initial {N}
\entry {\code {next-history (C-n)}}{116}
\entry {\code {non-incremental-forward-search-history (M-n)}}{116}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{116}
\entry {\code {next-history (C-n)}}{117}
\entry {\code {non-incremental-forward-search-history (M-n)}}{117}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{117}
\initial {O}
\entry {\code {operate-and-get-next (C-o)}}{124}
\entry {\code {overwrite-mode ()}}{118}
\entry {\code {operate-and-get-next (C-o)}}{125}
\entry {\code {overwrite-mode ()}}{119}
\initial {P}
\entry {\code {possible-command-completions (C-x !)}}{121}
\entry {\code {possible-completions (M-?)}}{120}
\entry {\code {possible-filename-completions (C-x /)}}{120}
\entry {\code {possible-hostname-completions (C-x @)}}{121}
\entry {\code {possible-username-completions (C-x ~)}}{121}
\entry {\code {possible-variable-completions (C-x $)}}{121}
\entry {\code {prefix-meta (\key {ESC})}}{122}
\entry {\code {previous-history (C-p)}}{116}
\entry {\code {print-last-kbd-macro ()}}{122}
\entry {\code {possible-command-completions (C-x !)}}{122}
\entry {\code {possible-completions (M-?)}}{121}
\entry {\code {possible-filename-completions (C-x /)}}{122}
\entry {\code {possible-hostname-completions (C-x @)}}{122}
\entry {\code {possible-username-completions (C-x ~)}}{122}
\entry {\code {possible-variable-completions (C-x $)}}{122}
\entry {\code {prefix-meta (\key {ESC})}}{123}
\entry {\code {previous-history (C-p)}}{117}
\entry {\code {print-last-kbd-macro ()}}{123}
\initial {Q}
\entry {\code {quoted-insert (C-q or C-v)}}{117}
\entry {\code {quoted-insert (C-q or C-v)}}{118}
\initial {R}
\entry {\code {re-read-init-file (C-x C-r)}}{122}
\entry {\code {redraw-current-line ()}}{115}
\entry {\code {reverse-search-history (C-r)}}{116}
\entry {\code {revert-line (M-r)}}{122}
\entry {\code {re-read-init-file (C-x C-r)}}{123}
\entry {\code {redraw-current-line ()}}{116}
\entry {\code {reverse-search-history (C-r)}}{117}
\entry {\code {revert-line (M-r)}}{123}
\initial {S}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{118}
\entry {\code {set-mark (C-@)}}{122}
\entry {\code {shell-backward-kill-word ()}}{119}
\entry {\code {shell-backward-word ()}}{115}
\entry {\code {shell-expand-line (M-C-e)}}{123}
\entry {\code {shell-forward-word ()}}{115}
\entry {\code {shell-kill-word ()}}{119}
\entry {\code {skip-csi-sequence ()}}{122}
\entry {\code {start-kbd-macro (C-x ()}}{121}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{119}
\entry {\code {set-mark (C-@)}}{123}
\entry {\code {shell-backward-kill-word ()}}{120}
\entry {\code {shell-backward-word ()}}{116}
\entry {\code {shell-expand-line (M-C-e)}}{125}
\entry {\code {shell-forward-word ()}}{116}
\entry {\code {shell-kill-word ()}}{120}
\entry {\code {skip-csi-sequence ()}}{124}
\entry {\code {start-kbd-macro (C-x ()}}{123}
\initial {T}
\entry {\code {tilde-expand (M-&)}}{122}
\entry {\code {transpose-chars (C-t)}}{118}
\entry {\code {transpose-words (M-t)}}{118}
\entry {\code {tilde-expand (M-&)}}{123}
\entry {\code {transpose-chars (C-t)}}{119}
\entry {\code {transpose-words (M-t)}}{119}
\initial {U}
\entry {\code {undo (C-_ or C-x C-u)}}{122}
\entry {\code {universal-argument ()}}{119}
\entry {\code {unix-filename-rubout ()}}{119}
\entry {\code {unix-line-discard (C-u)}}{118}
\entry {\code {unix-word-rubout (C-w)}}{119}
\entry {\code {upcase-word (M-u)}}{118}
\entry {\code {undo (C-_ or C-x C-u)}}{123}
\entry {\code {universal-argument ()}}{121}
\entry {\code {unix-filename-rubout ()}}{120}
\entry {\code {unix-line-discard (C-u)}}{120}
\entry {\code {unix-word-rubout (C-w)}}{120}
\entry {\code {upcase-word (M-u)}}{119}
\initial {Y}
\entry {\code {yank (C-y)}}{119}
\entry {\code {yank-last-arg (M-. or M-_)}}{117}
\entry {\code {yank-nth-arg (M-C-y)}}{117}
\entry {\code {yank-pop (M-y)}}{119}
\entry {\code {yank (C-y)}}{120}
\entry {\code {yank-last-arg (M-. or M-_)}}{118}
\entry {\code {yank-nth-arg (M-C-y)}}{118}
\entry {\code {yank-pop (M-y)}}{120}
doc/bashref.html
+732 -572
View File
File diff suppressed because it is too large Load Diff
doc/bashref.info
+4536 -4504
View File
File diff suppressed because it is too large Load Diff
doc/bashref.log
+123 -126
View File
@@ -1,4 +1,7 @@
This is TeX, Version 3.1415926 (TeX Live 2011/Fink) (format=tex 2012.4.18) 15 SEP 2014 12:01
This is pdfTeX, Version 3.14159265-2.6-1.40.15 (TeX Live 2014/MacPorts 2014_5) (preloaded format=pdftex 2014.11.4) 23 FEB 2015 09:20
entering extended mode
restricted \write18 enabled.
%&-line parsing enabled.
**/usr/homes/chet/src/bash/src/doc/bashref.texi
(/usr/homes/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
Loading texinfo [version 2013-09-11.11]:
@@ -14,78 +17,78 @@ Loading texinfo [version 2013-09-11.11]:
\headlinebox=\box16
\footlinebox=\box17
\margin=\insert252
\EMsimple=\toks12
\EMsimple=\toks13
\groupbox=\box18
\groupinvalidhelp=\toks13
\groupinvalidhelp=\toks14
\mil=\dimen25
\exdentamount=\skip18
\inmarginspacing=\skip19
\centerpenalty=\count26
\centerpenalty=\count27
pdf,
\tempnum=\count27
\lnkcount=\count28
\filename=\toks14
\filenamelength=\count29
\pgn=\count30
\toksA=\toks15
\toksB=\toks16
\toksC=\toks17
\toksD=\toks18
\tempnum=\count28
\lnkcount=\count29
\filename=\toks15
\filenamelength=\count30
\pgn=\count31
\toksA=\toks16
\toksB=\toks17
\toksC=\toks18
\toksD=\toks19
\boxA=\box19
\countA=\count31
\nopdfimagehelp=\toks19
\countA=\count32
\nopdfimagehelp=\toks20
fonts,
\sffam=\fam8
\textleading=\dimen26
markup,
\fontdepth=\count32
\fontdepth=\count33
glyphs,
\errorbox=\box20
page headings,
\titlepagetopglue=\skip20
\titlepagebottomglue=\skip21
\evenheadline=\toks20
\oddheadline=\toks21
\evenfootline=\toks22
\oddfootline=\toks23
\evenheadline=\toks21
\oddheadline=\toks22
\evenfootline=\toks23
\oddfootline=\toks24
tables,
\tableindent=\dimen27
\itemindent=\dimen28
\itemmargin=\dimen29
\itemmax=\dimen30
\itemno=\count33
\itemno=\count34
\multitableparskip=\skip22
\multitableparindent=\skip23
\multitablecolspace=\dimen31
\multitablelinespace=\skip24
\colcount=\count34
\everytab=\toks24
\colcount=\count35
\everytab=\toks25
conditionals,
\doignorecount=\count35
\doignorecount=\count36
indexing,
\whatsitskip=\skip25
\whatsitpenalty=\count36
\whatsitpenalty=\count37
\secondaryindent=\skip26
\partialpage=\box21
\doublecolumnhsize=\dimen32
sectioning,
\unnumberedno=\count37
\chapno=\count38
\secno=\count39
\subsecno=\count40
\subsubsecno=\count41
\appendixno=\count42
\absseclevel=\count43
\secbase=\count44
\unnumberedno=\count38
\chapno=\count39
\secno=\count40
\subsecno=\count41
\subsubsecno=\count42
\appendixno=\count43
\absseclevel=\count44
\secbase=\count45
\chapheadingskip=\skip27
\secheadingskip=\skip28
\subsecheadingskip=\skip29
toc,
\tocfile=\write0
\contentsrightmargin=\skip30
\savepageno=\count45
\lastnegativepageno=\count46
\savepageno=\count46
\lastnegativepageno=\count47
\tocindent=\dimen33
environments,
\lispnarrowing=\skip31
@@ -106,28 +109,27 @@ defuns,
\defbodyindent=\skip38
\defargsindent=\skip39
\deflastargmargin=\skip40
\defunpenalty=\count47
\parencount=\count48
\brackcount=\count49
\defunpenalty=\count48
\parencount=\count49
\brackcount=\count50
macros,
\macscribble=\write1
\paramno=\count50
\macname=\toks25
\paramno=\count51
\macname=\toks26
cross references,
\auxfile=\write2
\savesfregister=\count51
\auxfile=\write1
\savesfregister=\count52
\toprefbox=\box23
\printedrefnamebox=\box24
\infofilenamebox=\box25
\printedmanualbox=\box26
insertions,
\footnoteno=\count52
\footnoteno=\count53
\SAVEfootins=\box27
\SAVEmargin=\box28
(/sw/share/texmf-dist/tex/generic/epsf/epsf.tex
(/opt/local/share/texmf/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
\epsffilein=\read0
\epsffilein=\read1
\epsfframemargin=\dimen39
\epsfframethickness=\dimen40
\epsfrsize=\dimen41
@@ -137,55 +139,53 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
\epsfysize=\dimen45
\pspoints=\dimen46
)
\noepsfhelp=\toks26
\noepsfhelp=\toks27
localization,
\nolanghelp=\toks27
\countUTFx=\count53
\countUTFy=\count54
\countUTFz=\count55
\nolanghelp=\toks28
\countUTFx=\count54
\countUTFy=\count55
\countUTFz=\count56
formatting,
\defaultparindent=\dimen47
and turning on texinfo input format.)
(./bashref.aux)
\openout2 = `bashref.aux'.
\openout1 = `bashref.aux'.
@cpindfile=@write3
@fnindfile=@write4
@vrindfile=@write5
@tpindfile=@write6
@kyindfile=@write7
@pgindfile=@write8
@cpindfile=@write2
@fnindfile=@write3
@vrindfile=@write4
@tpindfile=@write5
@kyindfile=@write6
@pgindfile=@write7
texinfo.tex: doing @include of version.texi
(./version.texi)
@btindfile=@write9
@rwindfile=@write10
@btindfile=@write8
@rwindfile=@write9
[1
\openout3 = `bashref.cp'.
\openout2 = `bashref.cp'.
\openout4 = `bashref.fn'.
\openout3 = `bashref.fn'.
\openout5 = `bashref.vr'.
\openout4 = `bashref.vr'.
\openout6 = `bashref.tp'.
\openout5 = `bashref.tp'.
\openout7 = `bashref.ky'.
\openout6 = `bashref.ky'.
\openout8 = `bashref.pg'.
\openout7 = `bashref.pg'.
\openout9 = `bashref.bt'.
\openout8 = `bashref.bt'.
\openout10 = `bashref.rw'.
\openout9 = `bashref.rw'.
]
\openout1 = `bashref.tmp'.
(./bashref.tmp) [2] (./bashref.toc
[-1] [-2] [-3]) [-4] Chapter 1
{/opt/local/var/db/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2] (./bashref.to
c [-1] [-2] [-3]) [-4] (./bashref.toc)
(./bashref.toc) Chapter 1
\openout0 = `bashref.toc'.
Chapter 2 [1] [2] [3] Chapter 3 [4] [5] [6]
[7] [8] [9] [10]
Chapter 2 [1] [2] [3] Chapter 3 [4] [5] [6] [7]
[8] [9] [10]
Overfull \hbox (38.26587pt too wide) in paragraph at lines 866--866
[]@texttt case @textttsl word @texttt in [ [(] @textttsl pat-tern @texttt [| @
textttsl pattern@texttt ][]) @textttsl command-list @texttt ;;][] esac[]
@@ -240,7 +240,7 @@ arallel -k traceroute[]
[16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27] [28] [29] [30]
[31] [32] [33] [34] [35] [36] [37] [38] [39] Chapter 4 [40] [41] [42] [43]
[44] [45] [46] [47] [48] [49] [50] [51] [52] [53]
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4184--4184
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4234--4234
[]@texttt mapfile [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ] [
-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl f
d@texttt ][]
@@ -254,7 +254,7 @@ d@texttt ][]
.etc.
[54] [55]
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4383--4383
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4433--4433
[]@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
[-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
fd@texttt ][]
@@ -269,7 +269,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4383--4383
[56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] Chapter 5 [68]
[69] [70] [71] [72] [73] [74] [75] [76] [77] [78] Chapter 6 [79]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6018--6018
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6078--6078
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -282,7 +282,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6019--6019
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6079--6079
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -296,7 +296,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6019--6019
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6020--6020
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6080--6080
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -314,8 +314,8 @@ texinfo.tex: doing @include of rluser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [100]
[101] [102] [103] [104] [105] [106] [107] [108] [109]
Underfull \hbox (badness 7540) in paragraph at lines 742--748
[101] [102] [103] [104] [105] [106] [107] [108] [109] [110]
Underfull \hbox (badness 7540) in paragraph at lines 794--800
[]@textrm In the above ex-am-ple, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -328,7 +328,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 742--748
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 742--748
Underfull \hbox (badness 10000) in paragraph at lines 794--800
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -340,8 +340,8 @@ e func-tion
.@texttt v
.etc.
[110] [111] [112]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 937--937
[111] [112] [113]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 989--989
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -353,9 +353,9 @@ gnored[]
.@texttt t
.etc.
[113] [114] [115] [116] [117] [118] [119] [120] [121] [122] [123] [124]
[125] [126] [127] [128] [129] [130]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 2158--2158
[114] [115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125]
[126] [127] [128] [129] [130] [131]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 2225--2225
[] @texttt # Tilde expansion, with side effect of expanding tilde to full p
athname[]
@@ -367,49 +367,46 @@ athname[]
.@penalty 10000
.etc.
[131])
[132])
texinfo.tex: doing @include of hsuser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[132] [133] [134] [135] [136]) Chapter 10 [137] [138] [139] [140] [141]
[142] [143] Appendix A [144] Appendix B [145] [146] [147] [148] [149] [150]
Appendix C [151]
[133] [134] [135] [136] [137]) Chapter 10 [138] [139] [140] [141] [142]
[143] [144] Appendix A [145] Appendix B [146] [147] [148] [149] [150] [151]
Appendix C [152]
texinfo.tex: doing @include of fdl.texi
(./fdl.texi [152] [153] [154] [155] [156] [157] [158])
Appendix D [159] (./bashref.bts) [160] (./bashref.rws) (./bashref.vrs [161]
[162]) (./bashref.fns [163] [164]) (./bashref.cps [165])
Overfull \vbox (10.81442pt too high) has occurred while \output is active
\vbox(643.2+0.0)x433.62
.\glue(\topskip) 0.0
.\hbox(652.26442+1.75)x433.62, glue set 18.01016fil
..\vbox(652.26442+1.75)x207.80492, glue set 0.00302
...\glue(\topskip) 26.12001
...\hbox(9.87999+0.0)x207.80492, glue set 197.6216fil []
...\penalty 10000
...\glue 3.46501 plus 1.05006
...\glue 0.0 plus 1.0
...etc.
..\glue 0.0 plus 1.0fil
..\vbox(652.26442+1.75)x207.80492, glue set 0.0716
...\glue(\splittopskip) 29.75
...\hbox(6.25+1.75)x207.80492, glue set 96.39734fill []
...\glue 0.0 plus 1.0
...\glue(\parskip) 0.0
...\glue(\baselineskip) 2.5
...etc.
.\penalty 10000
.\glue 0.0 plus 1.0fill
[166] )
(./fdl.texi [153] [154] [155] [156] [157] [158] [159])
Appendix D [160] (./bashref.bts) [161] (./bashref.rws) (./bashref.vrs [162]
[163]) (./bashref.fns [164] [165]) (./bashref.cps [166] [167]) [168] )
Here is how much of TeX's memory you used:
2225 strings out of 497974
30407 string characters out of 3220833
68686 words of memory out of 3000000
3040 multiletter control sequences out of 15000+200000
32896 words of font info for 113 fonts, out of 3000000 for 9000
2745 strings out of 497110
37296 string characters out of 6206875
151210 words of memory out of 5000000
3523 multiletter control sequences out of 15000+600000
32896 words of font info for 113 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
16i,6n,14p,319b,749s stack positions out of 5000i,500n,10000p,200000b,50000s
16i,6n,16p,319b,967s stack positions out of 5000i,500n,10000p,200000b,80000s
{/opt/loc
al/share/texmf-texlive/fonts/enc/dvips/cm-super/cm-super-t1.enc}</opt/local/sha
re/texmf-texlive/fonts/type1/public/amsfonts/cm/cmbx12.pfb></opt/local/share/te
xmf-texlive/fonts/type1/public/amsfonts/cm/cmcsc10.pfb></opt/local/share/texmf-
texlive/fonts/type1/public/amsfonts/cm/cmmi10.pfb></opt/local/share/texmf-texli
ve/fonts/type1/public/amsfonts/cm/cmmi12.pfb></opt/local/share/texmf-texlive/fo
nts/type1/public/amsfonts/cm/cmmi9.pfb></opt/local/share/texmf-texlive/fonts/ty
pe1/public/amsfonts/cm/cmr10.pfb></opt/local/share/texmf-texlive/fonts/type1/pu
blic/amsfonts/cm/cmr9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/am
sfonts/cm/cmsl10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfont
s/cm/cmsltt10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/c
m/cmsy10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmt
i10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.p
fb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></
opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/lo
cal/share/texmf-texlive/fonts/type1/public/cm-super/sfrm1095.pfb>
Output written on bashref.pdf (174 pages, 727093 bytes).
PDF statistics:
2542 PDF objects out of 2984 (max. 8388607)
2324 compressed objects within 24 object streams
300 named destinations out of 1000 (max. 500000)
1125 words of extra memory for PDF output out of 10000 (max. 10000000)
Output written on bashref.dvi (172 pages, 724260 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+4143 -3969
View File
File diff suppressed because it is too large Load Diff
doc/bashref.toc
+58 -58
View File
@@ -30,36 +30,36 @@
@numsubsecentry{Brace Expansion}{3.5.1}{Brace Expansion}{21}
@numsubsecentry{Tilde Expansion}{3.5.2}{Tilde Expansion}{22}
@numsubsecentry{Shell Parameter Expansion}{3.5.3}{Shell Parameter Expansion}{23}
@numsubsecentry{Command Substitution}{3.5.4}{Command Substitution}{28}
@numsubsecentry{Command Substitution}{3.5.4}{Command Substitution}{29}
@numsubsecentry{Arithmetic Expansion}{3.5.5}{Arithmetic Expansion}{29}
@numsubsecentry{Process Substitution}{3.5.6}{Process Substitution}{29}
@numsubsecentry{Word Splitting}{3.5.7}{Word Splitting}{29}
@numsubsecentry{Process Substitution}{3.5.6}{Process Substitution}{30}
@numsubsecentry{Word Splitting}{3.5.7}{Word Splitting}{30}
@numsubsecentry{Filename Expansion}{3.5.8}{Filename Expansion}{30}
@numsubsubsecentry{Pattern Matching}{3.5.8.1}{Pattern Matching}{30}
@numsubsubsecentry{Pattern Matching}{3.5.8.1}{Pattern Matching}{31}
@numsubsecentry{Quote Removal}{3.5.9}{Quote Removal}{32}
@numsecentry{Redirections}{3.6}{Redirections}{32}
@numsubsecentry{Redirecting Input}{3.6.1}{}{33}
@numsubsecentry{Redirecting Output}{3.6.2}{}{33}
@numsubsecentry{Appending Redirected Output}{3.6.3}{}{33}
@numsubsecentry{Redirecting Standard Output and Standard Error}{3.6.4}{}{33}
@numsubsecentry{Redirecting Output}{3.6.2}{}{34}
@numsubsecentry{Appending Redirected Output}{3.6.3}{}{34}
@numsubsecentry{Redirecting Standard Output and Standard Error}{3.6.4}{}{34}
@numsubsecentry{Appending Standard Output and Standard Error}{3.6.5}{}{34}
@numsubsecentry{Here Documents}{3.6.6}{}{34}
@numsubsecentry{Here Strings}{3.6.7}{}{34}
@numsubsecentry{Here Documents}{3.6.6}{}{35}
@numsubsecentry{Here Strings}{3.6.7}{}{35}
@numsubsecentry{Duplicating File Descriptors}{3.6.8}{}{35}
@numsubsecentry{Moving File Descriptors}{3.6.9}{}{35}
@numsubsecentry{Opening File Descriptors for Reading and Writing}{3.6.10}{}{35}
@numsecentry{Executing Commands}{3.7}{Executing Commands}{35}
@numsubsecentry{Simple Command Expansion}{3.7.1}{Simple Command Expansion}{35}
@numsubsecentry{Command Search and Execution}{3.7.2}{Command Search and Execution}{36}
@numsubsecentry{Moving File Descriptors}{3.6.9}{}{36}
@numsubsecentry{Opening File Descriptors for Reading and Writing}{3.6.10}{}{36}
@numsecentry{Executing Commands}{3.7}{Executing Commands}{36}
@numsubsecentry{Simple Command Expansion}{3.7.1}{Simple Command Expansion}{36}
@numsubsecentry{Command Search and Execution}{3.7.2}{Command Search and Execution}{37}
@numsubsecentry{Command Execution Environment}{3.7.3}{Command Execution Environment}{37}
@numsubsecentry{Environment}{3.7.4}{Environment}{38}
@numsubsecentry{Exit Status}{3.7.5}{Exit Status}{38}
@numsubsecentry{Exit Status}{3.7.5}{Exit Status}{39}
@numsubsecentry{Signals}{3.7.6}{Signals}{39}
@numsecentry{Shell Scripts}{3.8}{Shell Scripts}{39}
@numsecentry{Shell Scripts}{3.8}{Shell Scripts}{40}
@numchapentry{Shell Builtin Commands}{4}{Shell Builtin Commands}{41}
@numsecentry{Bourne Shell Builtins}{4.1}{Bourne Shell Builtins}{41}
@numsecentry{Bash Builtin Commands}{4.2}{Bash Builtins}{48}
@numsecentry{Modifying Shell Behavior}{4.3}{Modifying Shell Behavior}{58}
@numsecentry{Modifying Shell Behavior}{4.3}{Modifying Shell Behavior}{59}
@numsubsecentry{The Set Builtin}{4.3.1}{The Set Builtin}{59}
@numsubsecentry{The Shopt Builtin}{4.3.2}{The Shopt Builtin}{63}
@numsecentry{Special Builtins}{4.4}{Special Builtins}{68}
@@ -96,44 +96,44 @@
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{103}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{104}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{104}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{111}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{112}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{115}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{115}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{116}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{117}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{118}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{119}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{120}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{121}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{122}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{124}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{124}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{126}
@numsecentry{A Programmable Completion Example}{8.8}{A Programmable Completion Example}{130}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{133}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{133}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{133}
@numsecentry{History Expansion}{9.3}{History Interaction}{135}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{135}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{136}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{137}
@numchapentry{Installing Bash}{10}{Installing Bash}{138}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{138}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{139}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{139}
@numsecentry{Installation Names}{10.4}{Installation Names}{139}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{139}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{140}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{140}
@numsecentry{Optional Features}{10.8}{Optional Features}{140}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{145}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{146}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{150}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{152}
@appentry{Indexes}{D}{Indexes}{160}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{160}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{161}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{161}
@appsecentry{Function Index}{D.4}{Function Index}{163}
@appsecentry{Concept Index}{D.5}{Concept Index}{165}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{112}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{113}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{116}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{116}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{117}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{118}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{119}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{121}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{121}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{123}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{123}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{125}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{126}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{128}
@numsecentry{A Programmable Completion Example}{8.8}{A Programmable Completion Example}{131}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{134}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{134}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{134}
@numsecentry{History Expansion}{9.3}{History Interaction}{136}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{136}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{137}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{138}
@numchapentry{Installing Bash}{10}{Installing Bash}{139}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{139}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{140}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{140}
@numsecentry{Installation Names}{10.4}{Installation Names}{140}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{140}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{141}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{141}
@numsecentry{Optional Features}{10.8}{Optional Features}{141}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{146}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{147}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{151}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{153}
@appentry{Indexes}{D}{Indexes}{161}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{161}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{162}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{162}
@appsecentry{Function Index}{D.4}{Function Index}{164}
@appsecentry{Concept Index}{D.5}{Concept Index}{166}
doc/bashref.vr
+15 -9
View File
@@ -119,34 +119,40 @@
\entry{bell-style}{105}{\code {bell-style}}
\entry{bind-tty-special-chars}{105}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{105}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{105}{\code {colored-completion-prefix}}
\entry{colored-stats}{105}{\code {colored-stats}}
\entry{comment-begin}{105}{\code {comment-begin}}
\entry{completion-display-width}{105}{\code {completion-display-width}}
\entry{completion-ignore-case}{105}{\code {completion-ignore-case}}
\entry{completion-ignore-case}{106}{\code {completion-ignore-case}}
\entry{completion-map-case}{106}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{106}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{106}{\code {completion-query-items}}
\entry{convert-meta}{106}{\code {convert-meta}}
\entry{disable-completion}{106}{\code {disable-completion}}
\entry{editing-mode}{106}{\code {editing-mode}}
\entry{enable-keypad}{106}{\code {enable-keypad}}
\entry{emacs-mode-string}{106}{\code {emacs-mode-string}}
\entry{echo-control-characters}{107}{\code {echo-control-characters}}
\entry{enable-bracketed-paste}{107}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{107}{\code {enable-keypad}}
\entry{expand-tilde}{107}{\code {expand-tilde}}
\entry{history-preserve-point}{107}{\code {history-preserve-point}}
\entry{history-size}{107}{\code {history-size}}
\entry{horizontal-scroll-mode}{107}{\code {horizontal-scroll-mode}}
\entry{input-meta}{107}{\code {input-meta}}
\entry{meta-flag}{107}{\code {meta-flag}}
\entry{isearch-terminators}{107}{\code {isearch-terminators}}
\entry{keymap}{107}{\code {keymap}}
\entry{isearch-terminators}{108}{\code {isearch-terminators}}
\entry{keymap}{108}{\code {keymap}}
\entry{mark-modified-lines}{108}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{108}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{108}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{108}{\code {menu-complete-display-prefix}}
\entry{output-meta}{108}{\code {output-meta}}
\entry{page-completions}{108}{\code {page-completions}}
\entry{revert-all-at-newline}{108}{\code {revert-all-at-newline}}
\entry{menu-complete-display-prefix}{109}{\code {menu-complete-display-prefix}}
\entry{output-meta}{109}{\code {output-meta}}
\entry{page-completions}{109}{\code {page-completions}}
\entry{revert-all-at-newline}{109}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{109}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{109}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{109}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{109}{\code {skip-completed-text}}
\entry{visible-stats}{109}{\code {visible-stats}}
\entry{vi-cmd-mode-string}{110}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{110}{\code {vi-ins-mode-string}}
\entry{visible-stats}{110}{\code {visible-stats}}
doc/bashref.vrs
+15 -9
View File
@@ -52,6 +52,7 @@
\initial {C}
\entry {\code {CDPATH}}{69}
\entry {\code {CHILD_MAX}}{72}
\entry {\code {colored-completion-prefix}}{105}
\entry {\code {colored-stats}}{105}
\entry {\code {COLUMNS}}{72}
\entry {\code {comment-begin}}{105}
@@ -63,7 +64,7 @@
\entry {\code {COMP_WORDBREAKS}}{73}
\entry {\code {COMP_WORDS}}{73}
\entry {\code {completion-display-width}}{105}
\entry {\code {completion-ignore-case}}{105}
\entry {\code {completion-ignore-case}}{106}
\entry {\code {completion-map-case}}{106}
\entry {\code {completion-prefix-display-length}}{106}
\entry {\code {completion-query-items}}{106}
@@ -74,9 +75,12 @@
\entry {\code {DIRSTACK}}{73}
\entry {\code {disable-completion}}{106}
\initial {E}
\entry {\code {echo-control-characters}}{107}
\entry {\code {editing-mode}}{106}
\entry {\code {EMACS}}{73}
\entry {\code {enable-keypad}}{106}
\entry {\code {emacs-mode-string}}{106}
\entry {\code {enable-bracketed-paste}}{107}
\entry {\code {enable-keypad}}{107}
\entry {\code {ENV}}{73}
\entry {\code {EUID}}{73}
\entry {\code {expand-tilde}}{107}
@@ -109,9 +113,9 @@
\entry {\code {IGNOREEOF}}{76}
\entry {\code {input-meta}}{107}
\entry {\code {INPUTRC}}{76}
\entry {\code {isearch-terminators}}{107}
\entry {\code {isearch-terminators}}{108}
\initial {K}
\entry {\code {keymap}}{107}
\entry {\code {keymap}}{108}
\initial {L}
\entry {\code {LANG}}{76}
\entry {\code {LC_ALL}}{76}
@@ -130,7 +134,7 @@
\entry {\code {mark-modified-lines}}{108}
\entry {\code {mark-symlinked-directories}}{108}
\entry {\code {match-hidden-files}}{108}
\entry {\code {menu-complete-display-prefix}}{108}
\entry {\code {menu-complete-display-prefix}}{109}
\entry {\code {meta-flag}}{107}
\initial {O}
\entry {\code {OLDPWD}}{77}
@@ -138,9 +142,9 @@
\entry {\code {OPTERR}}{77}
\entry {\code {OPTIND}}{69}
\entry {\code {OSTYPE}}{77}
\entry {\code {output-meta}}{108}
\entry {\code {output-meta}}{109}
\initial {P}
\entry {\code {page-completions}}{108}
\entry {\code {page-completions}}{109}
\entry {\code {PATH}}{69}
\entry {\code {PIPESTATUS}}{77}
\entry {\code {POSIXLY_CORRECT}}{77}
@@ -157,7 +161,7 @@
\entry {\code {READLINE_LINE}}{78}
\entry {\code {READLINE_POINT}}{78}
\entry {\code {REPLY}}{78}
\entry {\code {revert-all-at-newline}}{108}
\entry {\code {revert-all-at-newline}}{109}
\initial {S}
\entry {\code {SECONDS}}{78}
\entry {\code {SHELL}}{78}
@@ -176,4 +180,6 @@
\initial {U}
\entry {\code {UID}}{79}
\initial {V}
\entry {\code {visible-stats}}{109}
\entry {\code {vi-cmd-mode-string}}{110}
\entry {\code {vi-ins-mode-string}}{110}
\entry {\code {visible-stats}}{110}
doc/builtins.0
+252 -242
View File
@@ -1,4 +1,4 @@
BASH_BUILTINS(1) BASH_BUILTINS(1)
BASH_BUILTINS(1) General Commands Manual BASH_BUILTINS(1)
@@ -195,10 +195,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
various shell variables set by the programmable completion
facilities, while available, will not have useful values.
The matches will be generated in the same way as if the pro-
grammable completion code had generated them directly from a
completion specification with the same flags. If _w_o_r_d is speci-
fied, only those completions matching _w_o_r_d will be displayed.
The matches will be generated in the same way as if the program-
mable completion code had generated them directly from a comple-
tion specification with the same flags. If _w_o_r_d is specified,
only those completions matching _w_o_r_d will be displayed.
The return value is true unless an invalid option is supplied,
or no matches were generated.
@@ -207,49 +207,51 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
_p_a_t] [--WW _w_o_r_d_l_i_s_t] [--FF _f_u_n_c_t_i_o_n] [--CC _c_o_m_m_a_n_d]
[--XX _f_i_l_t_e_r_p_a_t] [--PP _p_r_e_f_i_x] [--SS _s_u_f_f_i_x] _n_a_m_e [_n_a_m_e _._._.]
ccoommpplleettee --pprr [--DDEE] [_n_a_m_e ...]
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
to be reused as input. The --rr option removes a completion spec-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
pletion specifications. The --DD option indicates that the
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
attempted on a blank line.
The process of applying these completion specifications when
word completion is attempted is described above under PPrroo--
ggrraammmmaabbllee CCoommpplleettiioonn.
The process of applying these completion specifications when
word completion is attempted is described above under PPrrooggrraamm--
mmaabbllee CCoommpplleettiioonn.
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
sion before the ccoommpplleettee builtin is invoked.
--oo _c_o_m_p_-_o_p_t_i_o_n
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
tions. _c_o_m_p_-_o_p_t_i_o_n may be one of:
bbaasshhddeeffaauulltt
Perform the rest of the default bbaasshh completions
if the compspec generates no matches.
ddeeffaauulltt Use readline's default filename completion if
ddeeffaauulltt Use readline's default filename completion if
the compspec generates no matches.
ddiirrnnaammeess
Perform directory name completion if the comp-
Perform directory name completion if the comp-
spec generates no matches.
ffiilleennaammeess
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
shell functions.
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
default).
nnoossoorrtt Tell readline not to sort the list of possible
completions alphabetically.
nnoossppaaccee Tell readline not to append a space (the
default) to words completed at the end of the
line.
@@ -290,9 +292,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--kk.
rruunnnniinngg Names of running jobs, if job control is active.
sseerrvviiccee Service names. May also be specified as --ss.
sseettoopptt Valid arguments for the --oo option to the sseett
sseettoopptt Valid arguments for the --oo option to the sseett
builtin.
sshhoopptt Shell option names as accepted by the sshhoopptt
sshhoopptt Shell option names as accepted by the sshhoopptt
builtin.
ssiiggnnaall Signal names.
ssttooppppeedd Names of stopped jobs, if job control is active.
@@ -334,118 +336,118 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ated by the preceding options and arguments, and each
completion matching _f_i_l_t_e_r_p_a_t is removed from the list.
A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this
case, any completion not matching _f_i_l_t_e_r_p_a_t is removed.
case, any completion not matching _f_i_l_t_e_r_p_a_t is removed.
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
for a _n_a_m_e for which no specification exists, or an error occurs
adding a completion specification.
ccoommppoopptt [--oo _o_p_t_i_o_n] [--DDEE] [++oo _o_p_t_i_o_n] [_n_a_m_e]
Modify completion options for each _n_a_m_e according to the
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
options should apply to the ``default'' command completion; that
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
that is, completion attempted on a blank line.
The return value is true unless an invalid option is supplied,
The return value is true unless an invalid option is supplied,
an attempt is made to modify the options for a _n_a_m_e for which no
completion specification exists, or an output error occurs.
ccoonnttiinnuuee [_n]
Resume the next iteration of the enclosing ffoorr, wwhhiillee, uunnttiill, or
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
loop) is resumed. The return value is 0 unless _n is not greater
than or equal to 1.
ddeeccllaarree [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
ttyyppeesseett [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
display the attributes and values of each _n_a_m_e. When --pp is used
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
the attributes specified by the additional options. If no other
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where the function is defined are displayed as well. The --FF
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where the function is defined are displayed as well. The --FF
option implies --ff. The --gg option forces variables to be created
or modified at the global scope, even when ddeeccllaarree is executed
in a shell function. It is ignored in all other cases. The
following options can be used to restrict output to variables
or modified at the global scope, even when ddeeccllaarree is executed
in a shell function. It is ignored in all other cases. The
following options can be used to restrict output to variables
with the specified attribute or to give variables attributes:
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
above).
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
above).
--ff Use function names only.
--ii The variable is treated as an integer; arithmetic evalua-
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
the variable is assigned a value.
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
attribute is disabled.
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
attribute cannot be applied to array variables.
--rr Make _n_a_m_es readonly. These names cannot then be assigned
values by subsequent assignment statements or unset.
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
variables.
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
attribute is disabled.
--xx Mark _n_a_m_es for export to subsequent commands via the
--xx Mark _n_a_m_es for export to subsequent commands via the
environment.
Using `+' instead of `-' turns off the attribute instead, with
Using `+' instead of `-' turns off the attribute instead, with
the exceptions that ++aa may not be used to destroy an array vari-
able and ++rr will not remove the readonly attribute. When used
able and ++rr will not remove the readonly attribute. When used
in a function, ddeeccllaarree and ttyyppeesseett make each _n_a_m_e local, as with
the llooccaall command, unless the --gg option is supplied. If a vari-
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
take effect until subsequent assignments. The return value is 0
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
off array status for an array variable, or an attempt is made to
display a non-existent function with --ff.
ddiirrss [[--ccllppvv]] [[++_n]] [[--_n]]
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
entries from the list.
--cc Clears the directory stack by deleting all of the
entries.
--ll Produces a listing using full pathnames; the default
--ll Produces a listing using full pathnames; the default
listing format uses a tilde to denote the home directory.
--pp Print the directory stack with one entry per line.
--vv Print the directory stack with one entry per line, pre-
@@ -544,101 +546,101 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
returns failure. An interactive shell returns failure if the
file cannot be executed. If _c_o_m_m_a_n_d is not specified, any redi-
rections take effect in the current shell, and the return status
is 0. If there is a redirection error, the return status is 1.
is 0. If there is a redirection error, the return status is 1.
eexxiitt [_n]
Cause the shell to exit with a status of _n. If _n is omitted,
Cause the shell to exit with a status of _n. If _n is omitted,
the exit status is that of the last command executed. A trap on
EEXXIITT is executed before the shell terminates.
eexxppoorrtt [--ffnn] [_n_a_m_e[=_w_o_r_d]] ...
eexxppoorrtt --pp
The supplied _n_a_m_e_s are marked for automatic export to the envi-
ronment of subsequently executed commands. If the --ff option is
given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or
if the --pp option is supplied, a list of names of all exported
variables is printed. The --nn option causes the export property
The supplied _n_a_m_e_s are marked for automatic export to the envi-
ronment of subsequently executed commands. If the --ff option is
given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or
if the --pp option is supplied, a list of names of all exported
variables is printed. The --nn option causes the export property
to be removed from each _n_a_m_e. If a variable name is followed by
=_w_o_r_d, the value of the variable is set to _w_o_r_d. eexxppoorrtt returns
an exit status of 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 sup-
of the _n_a_m_e_s is not a valid shell variable name, or --ff is sup-
plied with a _n_a_m_e that is not a function.
ffcc [--ee _e_n_a_m_e] [--llnnrr] [_f_i_r_s_t] [_l_a_s_t]
ffcc --ss [_p_a_t=_r_e_p] [_c_m_d]
The first form selects a range of commands from _f_i_r_s_t to _l_a_s_t
from the history list and displays or edits and re-executes
them. _F_i_r_s_t and _l_a_s_t may be specified as a string (to locate
the last command beginning with that string) or as a number (an
index into the history list, where a negative number is used as
an offset from the current command number). If _l_a_s_t is not
specified it is set to the current command for listing (so that
``fc -l -10'' prints the last 10 commands) and to _f_i_r_s_t other-
wise. If _f_i_r_s_t is not specified it is set to the previous com-
The first form selects a range of commands from _f_i_r_s_t to _l_a_s_t
from the history list and displays or edits and re-executes
them. _F_i_r_s_t and _l_a_s_t may be specified as a string (to locate
the last command beginning with that string) or as a number (an
index into the history list, where a negative number is used as
an offset from the current command number). If _l_a_s_t is not
specified it is set to the current command for listing (so that
``fc -l -10'' prints the last 10 commands) and to _f_i_r_s_t other-
wise. If _f_i_r_s_t is not specified it is set to the previous com-
mand for editing and -16 for listing.
The --nn option suppresses the command numbers when listing. The
--rr option reverses the order of the commands. If the --ll option
is given, the commands are listed on standard output. Other-
wise, the editor given by _e_n_a_m_e is invoked on a file containing
those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT
variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set.
If neither variable is set, _v_i is used. When editing is com-
The --nn option suppresses the command numbers when listing. The
--rr option reverses the order of the commands. If the --ll option
is given, the commands are listed on standard output. Other-
wise, the editor given by _e_n_a_m_e is invoked on a file containing
those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT
variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set.
If neither variable is set, _v_i is used. When editing is com-
plete, the edited commands are echoed and executed.
In the second form, _c_o_m_m_a_n_d is re-executed after each instance
of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is intepreted the same as
_f_i_r_s_t above. A useful alias to use with this is ``r="fc -s"'',
so that typing ``r cc'' runs the last command beginning with
In the second form, _c_o_m_m_a_n_d is re-executed after each instance
of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is intepreted the same as
_f_i_r_s_t above. A useful alias to use with this is ``r="fc -s"'',
so that typing ``r cc'' runs the last command beginning with
``cc'' and typing ``r'' re-executes the last command.
If the first form is used, the return value is 0 unless an
invalid option is encountered or _f_i_r_s_t or _l_a_s_t specify history
lines out of range. If the --ee option is supplied, the return
If the first form is used, the return value is 0 unless an
invalid option is encountered or _f_i_r_s_t or _l_a_s_t specify history
lines out of range. If the --ee option is supplied, the return
value is the value of the last command executed or failure if an
error occurs with the temporary file of commands. If the second
form is used, the return status is that of the command re-exe-
cuted, unless _c_m_d does not specify a valid history line, in
form is used, the return status is that of the command re-exe-
cuted, unless _c_m_d does not specify a valid history line, in
which case ffcc returns failure.
ffgg [_j_o_b_s_p_e_c]
Resume _j_o_b_s_p_e_c in the foreground, and make it the current job.
Resume _j_o_b_s_p_e_c in the foreground, and make it the current job.
If _j_o_b_s_p_e_c is not present, the shell's notion of the _c_u_r_r_e_n_t _j_o_b
is used. The return value is that of the command placed into
the foreground, or failure if run when job control is disabled
is used. The return value is that of the command placed into
the foreground, or failure if run when job control is disabled
or, when run with job control enabled, if _j_o_b_s_p_e_c does not spec-
ify a valid job or _j_o_b_s_p_e_c specifies a job that was started
ify a valid job or _j_o_b_s_p_e_c specifies a job that was started
without job control.
ggeettooppttss _o_p_t_s_t_r_i_n_g _n_a_m_e [_a_r_g_s]
ggeettooppttss is used by shell procedures to parse positional parame-
ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog-
nized; if a character is followed by a colon, the option is
expected to have an argument, which should be separated from it
by white space. The colon and question mark characters may not
be used as option characters. Each time it is invoked, ggeettooppttss
places the next option in the shell variable _n_a_m_e, initializing
ggeettooppttss is used by shell procedures to parse positional parame-
ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog-
nized; if a character is followed by a colon, the option is
expected to have an argument, which should be separated from it
by white space. The colon and question mark characters may not
be used as option characters. Each time it is invoked, ggeettooppttss
places the next option in the shell variable _n_a_m_e, initializing
_n_a_m_e if it does not exist, and the index of the next argument to
be processed into the variable OOPPTTIINNDD. OOPPTTIINNDD is initialized to
1 each time the shell or a shell script is invoked. When an
option requires an argument, ggeettooppttss places that argument into
the variable OOPPTTAARRGG. The shell does not reset OOPPTTIINNDD automati-
cally; it must be manually reset between multiple calls to
1 each time the shell or a shell script is invoked. When an
option requires an argument, ggeettooppttss places that argument into
the variable OOPPTTAARRGG. The shell does not reset OOPPTTIINNDD automati-
cally; it must be manually reset between multiple calls to
ggeettooppttss within the same shell invocation if a new set of parame-
ters is to be used.
When the end of options is encountered, ggeettooppttss exits with a
return value greater than zero. OOPPTTIINNDD is set to the index of
When the end of options is encountered, ggeettooppttss exits with a
return value greater than zero. OOPPTTIINNDD is set to the index of
the first non-option argument, and _n_a_m_e is set to ?.
ggeettooppttss normally parses the positional parameters, but if more
ggeettooppttss normally parses the positional parameters, but if more
arguments are given in _a_r_g_s, ggeettooppttss parses those instead.
ggeettooppttss can report errors in two ways. If the first character
of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In
normal operation, diagnostic messages are printed when invalid
options or missing option arguments are encountered. If the
variable OOPPTTEERRRR is set to 0, no error messages will be dis-
ggeettooppttss can report errors in two ways. If the first character
of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In
normal operation, diagnostic messages are printed when invalid
options or missing option arguments are encountered. If the
variable OOPPTTEERRRR is set to 0, no error messages will be dis-
played, even if the first character of _o_p_t_s_t_r_i_n_g is not a colon.
If an invalid option is seen, ggeettooppttss places ? into _n_a_m_e and, if
@@ -740,99 +742,103 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
lowing meanings:
--ll List process IDs in addition to the normal information.
--nn Display information only about jobs that have changed
status since the user was last notified of their status.
--pp List only the process ID of the job's process group
status since the user was last notified of their status.
--pp List only the process ID of the job's process group
leader.
--rr Display only running jobs.
--ss Display only stopped jobs.
If _j_o_b_s_p_e_c is given, output is restricted to information about
that job. The return status is 0 unless an invalid option is
If _j_o_b_s_p_e_c is given, output is restricted to information about
that job. The return status is 0 unless an invalid option is
encountered or an invalid _j_o_b_s_p_e_c is supplied.
If the --xx option is supplied, jjoobbss replaces any _j_o_b_s_p_e_c found in
_c_o_m_m_a_n_d or _a_r_g_s with the corresponding process group ID, and
_c_o_m_m_a_n_d or _a_r_g_s with the corresponding process group ID, and
executes _c_o_m_m_a_n_d passing it _a_r_g_s, returning its exit status.
kkiillll [--ss _s_i_g_s_p_e_c | --nn _s_i_g_n_u_m | --_s_i_g_s_p_e_c] [_p_i_d | _j_o_b_s_p_e_c] ...
kkiillll --ll [_s_i_g_s_p_e_c | _e_x_i_t___s_t_a_t_u_s]
Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes
named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive
signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or
a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not
present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the
signal names. If any arguments are supplied when --ll is given,
the names of the signals corresponding to the arguments are
Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes
named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive
signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or
a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not
present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the
signal names. If any arguments are supplied when --ll is given,
the names of the signals corresponding to the arguments are
listed, and the return status is 0. The _e_x_i_t___s_t_a_t_u_s argument to
--ll is a number specifying either a signal number or the exit
status of a process terminated by a signal. kkiillll returns true
if at least one signal was successfully sent, or false if an
--ll is a number specifying either a signal number or the exit
status of a process terminated by a signal. kkiillll returns true
if at least one signal was successfully sent, or false if an
error occurs or an invalid option is encountered.
lleett _a_r_g [_a_r_g ...]
Each _a_r_g is an arithmetic expression to be evaluated (see AARRIITTHH--
MMEETTIICC EEVVAALLUUAATTIIOONN above). If the last _a_r_g evaluates to 0, lleett
MMEETTIICC EEVVAALLUUAATTIIOONN above). If the last _a_r_g evaluates to 0, lleett
returns 1; 0 is returned otherwise.
llooccaall [_o_p_t_i_o_n] [_n_a_m_e[=_v_a_l_u_e] ...]
For each argument, a local variable named _n_a_m_e is created, and
assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted
llooccaall [_o_p_t_i_o_n] [_n_a_m_e[=_v_a_l_u_e] ... | - ]
For each argument, a local variable named _n_a_m_e is created, and
assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted
by ddeeccllaarree. When llooccaall is used within a function, it causes the
variable _n_a_m_e to have a visible scope restricted to that func-
tion and its children. With no operands, llooccaall writes a list of
local variables to the standard output. It is an error to use
llooccaall when not within a function. The return status is 0 unless
llooccaall is used outside a function, an invalid _n_a_m_e is supplied,
or _n_a_m_e is a readonly variable.
variable _n_a_m_e to have a visible scope restricted to that func-
tion and its children. If _n_a_m_e is -, the set of shell options
is made local to the function in which llooccaall is invoked: shell
options changed using the sseett builtin inside the function are
restored to their original values when the function returns.
With no operands, llooccaall writes a list of local variables to the
standard output. It is an error to use llooccaall when not within a
function. The return status is 0 unless llooccaall is used outside a
function, an invalid _n_a_m_e is supplied, or _n_a_m_e is a readonly
variable.
llooggoouutt Exit a login shell.
mmaappffiillee [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC
mmaappffiillee [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC
_c_a_l_l_b_a_c_k] [--cc _q_u_a_n_t_u_m] [_a_r_r_a_y]
rreeaaddaarrrraayy [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC
_c_a_l_l_b_a_c_k] [--cc _q_u_a_n_t_u_m] [_a_r_r_a_y]
Read lines from the standard input into the indexed array vari-
able _a_r_r_a_y, or from file descriptor _f_d if the --uu option is sup-
plied. The variable MMAAPPFFIILLEE is the default _a_r_r_a_y. Options, if
Read lines from the standard input into the indexed array vari-
able _a_r_r_a_y, or from file descriptor _f_d if the --uu option is sup-
plied. The variable MMAAPPFFIILLEE is the default _a_r_r_a_y. Options, if
supplied, have the following meanings:
--dd The first character of _d_e_l_i_m is used to terminate each
--dd The first character of _d_e_l_i_m is used to terminate each
input line, rather than newline.
--nn Copy at most _c_o_u_n_t lines. If _c_o_u_n_t is 0, all lines are
--nn Copy at most _c_o_u_n_t lines. If _c_o_u_n_t is 0, all lines are
copied.
--OO Begin assigning to _a_r_r_a_y at index _o_r_i_g_i_n. The default
--OO Begin assigning to _a_r_r_a_y at index _o_r_i_g_i_n. The default
index is 0.
--ss Discard the first _c_o_u_n_t lines read.
--tt Remove a trailing newline from each line read.
--uu Read lines from file descriptor _f_d instead of the stan-
--uu Read lines from file descriptor _f_d instead of the stan-
dard input.
--CC Evaluate _c_a_l_l_b_a_c_k each time _q_u_a_n_t_u_m lines are read. The
--CC Evaluate _c_a_l_l_b_a_c_k each time _q_u_a_n_t_u_m lines are read. The
--cc option specifies _q_u_a_n_t_u_m.
--cc Specify the number of lines read between each call to
--cc Specify the number of lines read between each call to
_c_a_l_l_b_a_c_k.
If --CC is specified without --cc, the default quantum is 5000.
If --CC is specified without --cc, the default quantum is 5000.
When _c_a_l_l_b_a_c_k is evaluated, it is supplied the index of the next
array element to be assigned and the line to be assigned to that
element as additional arguments. _c_a_l_l_b_a_c_k is evaluated after
element as additional arguments. _c_a_l_l_b_a_c_k is evaluated after
the line is read but before the array element is assigned.
If not supplied with an explicit origin, mmaappffiillee will clear
If not supplied with an explicit origin, mmaappffiillee will clear
_a_r_r_a_y before assigning to it.
mmaappffiillee returns successfully unless an invalid option or option
argument is supplied, _a_r_r_a_y is invalid or unassignable, or if
mmaappffiillee returns successfully unless an invalid option or option
argument is supplied, _a_r_r_a_y is invalid or unassignable, or if
_a_r_r_a_y is not an indexed array.
ppooppdd [-nn] [+_n] [-_n]
Removes entries from the directory stack. With no arguments,
removes the top directory from the stack, and performs a ccdd to
Removes entries from the directory stack. With no arguments,
removes the top directory from the stack, and performs a ccdd to
the new top directory. Arguments, if supplied, have the follow-
ing meanings:
--nn Suppresses the normal change of directory when removing
directories from the stack, so that only the stack is
--nn Suppresses the normal change of directory when removing
directories from the stack, so that only the stack is
manipulated.
++_n Removes the _nth entry counting from the left of the list
shown by ddiirrss, starting with zero. For example: ``popd
++_n Removes the _nth entry counting from the left of the list
shown by ddiirrss, starting with zero. For example: ``popd
+0'' removes the first directory, ``popd +1'' the second.
--_n Removes the _nth entry counting from the right of the list
shown by ddiirrss, starting with zero. For example: ``popd
@@ -862,64 +868,64 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
corresponding _a_r_g_u_m_e_n_t (except that \\cc terminates output,
backslashes in \\'', \\"", and \\?? are not removed, and octal
escapes beginning with \\00 may contain up to four digits).
%%qq causes pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a
%%qq causes pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a
format that can be reused as shell input.
%%((_d_a_t_e_f_m_t))TT
causes pprriinnttff to output the date-time string resulting
from using _d_a_t_e_f_m_t as a format string for _s_t_r_f_t_i_m_e(3).
causes pprriinnttff to output the date-time string resulting
from using _d_a_t_e_f_m_t as a format string for _s_t_r_f_t_i_m_e(3).
The corresponding _a_r_g_u_m_e_n_t is an integer representing the
number of seconds since the epoch. Two special argument
values may be used: -1 represents the current time, and
-2 represents the time the shell was invoked. If no
argument is specified, conversion behaves as if -1 had
been given. This is an exception to the usual pprriinnttff
number of seconds since the epoch. Two special argument
values may be used: -1 represents the current time, and
-2 represents the time the shell was invoked. If no
argument is specified, conversion behaves as if -1 had
been given. This is an exception to the usual pprriinnttff
behavior.
Arguments to non-string format specifiers are treated as C con-
Arguments to non-string format specifiers are treated as C con-
stants, except that a leading plus or minus sign is allowed, and
if the leading character is a single or double quote, the value
if the leading character is a single or double quote, the value
is the ASCII value of the following character.
The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_-
The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_-
_m_e_n_t_s. If the _f_o_r_m_a_t requires more _a_r_g_u_m_e_n_t_s than are supplied,
the extra format specifications behave as if a zero value or
null string, as appropriate, had been supplied. The return
the extra format specifications behave as if a zero value or
null string, as appropriate, had been supplied. The return
value is zero on success, non-zero on failure.
ppuusshhdd [--nn] [+_n] [-_n]
ppuusshhdd [--nn] [_d_i_r]
Adds a directory to the top of the directory stack, or rotates
the stack, making the new top of the stack the current working
Adds a directory to the top of the directory stack, or rotates
the stack, making the new top of the stack the current working
directory. With no arguments, exchanges the top two directories
and returns 0, unless the directory stack is empty. Arguments,
and returns 0, unless the directory stack is empty. Arguments,
if supplied, have the following meanings:
--nn Suppresses the normal change of directory when adding
directories to the stack, so that only the stack is
--nn Suppresses the normal change of directory when adding
directories to the stack, so that only the stack is
manipulated.
++_n Rotates the stack so that the _nth directory (counting
from the left of the list shown by ddiirrss, starting with
++_n Rotates the stack so that the _nth directory (counting
from the left of the list shown by ddiirrss, starting with
zero) is at the top.
--_n Rotates the stack so that the _nth directory (counting
from the right of the list shown by ddiirrss, starting with
--_n Rotates the stack so that the _nth directory (counting
from the right of the list shown by ddiirrss, starting with
zero) is at the top.
_d_i_r Adds _d_i_r to the directory stack at the top, making it the
new current working directory as if it had been supplied
new current working directory as if it had been supplied
as the argument to the ccdd builtin.
If the ppuusshhdd command is successful, a ddiirrss is performed as well.
If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r
fails. With the second form, ppuusshhdd returns 0 unless the direc-
tory stack is empty, a non-existent directory stack element is
specified, or the directory change to the specified new current
If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r
fails. With the second form, ppuusshhdd returns 0 unless the direc-
tory stack is empty, a non-existent directory stack element is
specified, or the directory change to the specified new current
directory fails.
ppwwdd [--LLPP]
Print the absolute pathname of the current working directory.
Print the absolute pathname of the current working directory.
The pathname printed contains no symbolic links if the --PP option
is supplied or the --oo pphhyyssiiccaall option to the sseett builtin command
is enabled. If the --LL 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
is enabled. If the --LL 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.
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
@@ -953,7 +959,7 @@ 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, but honor a delim-
waiting for a complete line of input, but honors 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
@@ -1045,9 +1051,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ues for the positional parameters and are assigned, in order, to
$$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
subsequent commands.
--aa Each variable or function that is created or modified is
given the export attribute and marked for export to the
environment of subsequent commands.
--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.
@@ -1341,8 +1347,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ddiirreexxppaanndd
If set, bbaasshh replaces directory names with the results
of word expansion when performing filename completion.
This changes the contents of the readline editing
buffer. If not set, bbaasshh attempts to preserve what the
This changes the contents of the readline editing buf-
fer. If not set, bbaasshh attempts to preserve what the
user typed.
ddiirrssppeellll
If set, bbaasshh attempts spelling correction on directory
@@ -1466,7 +1472,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
nnooccaasseemmaattcchh
If set, bbaasshh matches patterns in a case-insensitive
fashion when performing matching while executing ccaassee or
[[[[ conditional commands.
[[[[ conditional commands, when performing pattern substi-
tution word expansions, or when filtering possible com-
pletions as part of programmable completion.
nnuullllgglloobb
If set, bbaasshh allows patterns which match no files (see
PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string,
@@ -1638,7 +1646,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
function 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]]
uulliimmiitt [--HHSSaabbccddeeffiikkllmmnnppqqrrssttuuvvxxPPTT [_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.
The --HH and --SS options specify that the hard or soft limit is set
@@ -1662,6 +1670,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--ff The maximum size of files written by the shell and its
children
--ii The maximum number of pending signals
--kk The maximum number of kqueues that may be allocated
--ll The maximum size that may be locked into memory
--mm The maximum resident set size (many systems do not honor
this limit)
@@ -1677,15 +1686,16 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--vv The maximum amount of virtual memory available to the
shell and, on some systems, to its children
--xx The maximum number of file locks
--PP The maximum number of pseudoterminals
--TT The maximum number of threads
If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the
new value of the specified resource. 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 status is 0 unless an invalid option or argument is sup-
plied, or an error occurs while setting a new limit.
blocks; and --PP, --TT, --bb, --kk, --nn, and --uu, which are unscaled val-
ues. The return status is 0 unless an invalid option or argu-
ment 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
doc/builtins.ps
+1502 -1462
View File
File diff suppressed because it is too large Load Diff
doc/rbash.0
+9 -9
View File
@@ -1,4 +1,4 @@
RBASH(1) RBASH(1)
RBASH(1) General Commands Manual RBASH(1)
@@ -18,16 +18,16 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL
+o specifying command names containing //
+o specifying a filename containing a // as an argument to the ..
+o specifying a filename containing a // as an argument to the ..
builtin command
+o specifying a filename containing a slash as an argument to the
+o specifying a filename containing a slash as an argument to the
--pp option to the hhaasshh builtin command
+o importing function definitions from the shell environment at
+o importing function definitions from the shell environment at
startup
+o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at
+o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at
startup
+o redirecting output using the >, >|, <>, >&, &>, and >> redirect-
@@ -36,10 +36,10 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL
+o using the eexxeecc builtin command to replace the shell with another
command
+o adding or deleting builtin commands with the --ff and --dd options
+o adding or deleting builtin commands with the --ff and --dd options
to the eennaabbllee builtin command
+o using the eennaabbllee builtin command to enable disabled shell
+o using the eennaabbllee builtin command to enable disabled shell
builtins
+o specifying the --pp option to the ccoommmmaanndd builtin command
@@ -48,8 +48,8 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL
These restrictions are enforced after any startup files are read.
When a command that is found to be a shell script is executed, rrbbaasshh
turns off any restrictions in the shell spawned to execute the script.
When a command that is found to be a shell script is executed, rrbbaasshh
turns off any restrictions in the shell spawned to execute the script.
SSEEEE AALLSSOO
bash(1)
doc/rbash.ps
+41 -35
View File
@@ -1,9 +1,9 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Mon Sep 15 12:01:54 2014
%%Creator: groff version 1.22.2
%%CreationDate: Mon Feb 23 09:20:39 2015
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.19 2
%%DocumentSuppliedResources: procset grops 1.22 2
%%Pages: 1
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
@@ -13,7 +13,7 @@
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%%BeginResource: procset grops 1.22 2
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
@@ -71,6 +71,7 @@ exch pop add exch pop
/level0 save def
1 setlinecap
1 setlinejoin
DEFS/BPhook known{DEFS begin BPhook end}if
72 RES div dup scale
LS{
90 rotate
@@ -136,7 +137,10 @@ pop
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
1 index/FID ne
2 index/UniqueID ne
and
{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
@@ -174,8 +178,10 @@ newpath
userdict begin
/showpage{}def
/setpagedevice{}def
mark
}bind def
/PEND{
cleartomark
countdictstack CNT sub{end}repeat
level1 restore
}bind def
@@ -226,47 +232,47 @@ def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(RB)72 48 Q 376.2(ASH\(1\) RB)-.35 F(ASH\(1\))
-.35 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
(rbash \255 restricted bash, see)108 96 Q/F2 10/Times-Bold@0 SF(bash)2.5
E F0(\(1\))A F1(RESTRICTED SHELL)72 112.8 Q F0(If)108 124.8 Q F2(bash)
4.397 E F0 1.897(is started with the name)4.397 F F2(rbash)4.397 E F0
4.397(,o)C 4.397(rt)-4.397 G(he)-4.397 E F2<ad72>4.397 E F0 1.896
/F0 10/Times-Roman@0 SF(RB)72 48 Q 130.47(ASH\(1\) General)-.35 F
(Commands Manual)2.5 E(RB)132.97 E(ASH\(1\))-.35 E/F1 10.95/Times-Bold@0
SF -.219(NA)72 84 S(ME).219 E F0(rbash \255 restricted bash, see)108 96
Q/F2 10/Times-Bold@0 SF(bash)2.5 E F0(\(1\))A F1(RESTRICTED SHELL)72
112.8 Q F0(If)108 124.8 Q F2(bash)4.397 E F0 1.897
(is started with the name)4.397 F F2(rbash)4.397 E F0 4.397(,o)C 4.397
(rt)-4.397 G(he)-4.397 E F2<ad72>4.397 E F0 1.896
(option is supplied at in)4.397 F -.2(vo)-.4 G 1.896
(cation, the shell becomes).2 F 3.445(restricted. A)108 136.8 R .945
(restricted shell is used to set up an en)3.445 F .946
(vironment more controlled than the standard shell.)-.4 F(It)5.946 E
(beha)108 148.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E F2
(bash)2.5 E F0(with the e)2.5 E(xception that the follo)-.15 E
(wing are disallo)-.25 E(wed or not performed:)-.25 E 32.5<8363>108
165.6 S(hanging directories with)-32.5 E F2(cd)2.5 E F0 32.5<8373>108
182.4 S(etting or unsetting the v)-32.5 E(alues of)-.25 E/F3 9
(wing are disallo)-.25 E(wed or not performed:)-.25 E<83>108 165.6 Q
(changing directories with)144 165.6 Q F2(cd)2.5 E F0<83>108 182.4 Q
(setting or unsetting the v)144 182.4 Q(alues of)-.25 E/F3 9
/Times-Bold@0 SF(SHELL)2.5 E/F4 9/Times-Roman@0 SF(,)A F3 -.666(PA)2.25
G(TH)-.189 E F4(,)A F3(ENV)2.25 E F4(,)A F0(or)2.25 E F3 -.27(BA)2.5 G
(SH_ENV).27 E F0 32.5<8373>108 199.2 S
(pecifying command names containing)-32.5 E F2(/)2.5 E F0 32.5<8373>108
216 S(pecifying a \214lename containing a)-32.5 E F2(/)2.5 E F0
(as an ar)2.5 E(gument to the)-.18 E F2(.)2.5 E F0 -.2(bu)5 G
(iltin command).2 E 32.5<8373>108 232.8 S .45
(pecifying a \214lename containing a slash as an ar)-32.5 F .449
(SH_ENV).27 E F0<83>108 199.2 Q(specifying command names containing)144
199.2 Q F2(/)2.5 E F0<83>108 216 Q(specifying a \214lename containing a)
144 216 Q F2(/)2.5 E F0(as an ar)2.5 E(gument to the)-.18 E F2(.)2.5 E
F0 -.2(bu)5 G(iltin command).2 E<83>108 232.8 Q .45
(specifying a \214lename containing a slash as an ar)144 232.8 R .449
(gument to the)-.18 F F2<ad70>2.949 E F0 .449(option to the)2.949 F F2
(hash)2.949 E F0 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 244.8 Q
32.5<8369>108 261.6 S(mporting function de\214nitions from the shell en)
-32.5 E(vironment at startup)-.4 E 32.5<8370>108 278.4 S(arsing the v)
-32.5 E(alue of)-.25 E F3(SHELLOPTS)2.5 E F0(from the shell en)2.25 E
(vironment at startup)-.4 E 32.5<8372>108 295.2 S(edirecting output usi\
ng the >, >|, <>, >&, &>, and >> redirection operators)-32.5 E 32.5
<8375>108 312 S(sing the)-32.5 E F2(exec)2.5 E F0 -.2(bu)2.5 G
(iltin command to replace the shell with another command).2 E 32.5<8361>
108 328.8 S(dding or deleting b)-32.5 E(uiltin commands with the)-.2 E
<83>108 261.6 Q(importing function de\214nitions from the shell en)144
261.6 Q(vironment at startup)-.4 E<83>108 278.4 Q(parsing the v)144
278.4 Q(alue of)-.25 E F3(SHELLOPTS)2.5 E F0(from the shell en)2.25 E
(vironment at startup)-.4 E<83>108 295.2 Q(redirecting output using the\
>, >|, <>, >&, &>, and >> redirection operators)144 295.2 Q<83>108 312
Q(using the)144 312 Q F2(exec)2.5 E F0 -.2(bu)2.5 G
(iltin command to replace the shell with another command).2 E<83>108
328.8 Q(adding or deleting b)144 328.8 Q(uiltin commands with the)-.2 E
F2<ad66>2.5 E F0(and)2.5 E F2<ad64>2.5 E F0(options to the)2.5 E F2
(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E 32.5<8375>108 345.6 S
(sing the)-32.5 E F2(enable)2.5 E F0 -.2(bu)2.5 G
(iltin command to enable disabled shell b).2 E(uiltins)-.2 E 32.5<8373>
108 362.4 S(pecifying the)-32.5 E F2<ad70>2.5 E F0(option to the)2.5 E
F2(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E 32.5<8374>108 379.2
S(urning of)-32.5 E 2.5(fr)-.25 G(estricted mode with)-2.5 E F2(set +r)
2.5 E F0(or)2.5 E F2(set +o r)2.5 E(estricted)-.18 E F0(.)A
(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 345.6 Q
(using the)144 345.6 Q F2(enable)2.5 E F0 -.2(bu)2.5 G
(iltin command to enable disabled shell b).2 E(uiltins)-.2 E<83>108
362.4 Q(specifying the)144 362.4 Q F2<ad70>2.5 E F0(option to the)2.5 E
F2(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 379.2 Q
(turning of)144 379.2 Q 2.5(fr)-.25 G(estricted mode with)-2.5 E F2
(set +r)2.5 E F0(or)2.5 E F2(set +o r)2.5 E(estricted)-.18 E F0(.)A
(These restrictions are enforced after an)108 396 Q 2.5(ys)-.15 G
(tartup \214les are read.)-2.5 E .429
(When a command that is found to be a shell script is e)108 412.8 R -.15
execute_cmd.c
+3 -2
View File
@@ -616,7 +616,7 @@ execute_command_internal (command, asynchronous, pipe_in, pipe_out,
/* Fork a subshell, turn off the subshell bit, turn off job
control and call execute_command () on the command again. */
line_number_for_err_trap = line_number;
line_number_for_err_trap = line_number; /* XXX - save value? */
tcmd = make_command_string (command);
paren_pid = make_child (savestring (tcmd), asynchronous);
@@ -2565,7 +2565,7 @@ execute_connection (command, asynchronous, pipe_in, pipe_out, fds_to_close)
invert = (command->flags & CMD_INVERT_RETURN) != 0;
ignore_return = (command->flags & CMD_IGNORE_RETURN) != 0;
line_number_for_err_trap = line_number;
line_number_for_err_trap = line_number; /* XXX - save value? */
exec_result = execute_pipeline (command, asynchronous, pipe_in, pipe_out, fds_to_close);
if (asynchronous)
@@ -4553,6 +4553,7 @@ execute_function (var, words, flags, fds_to_close, async, subshell)
add_unwind_protect (maybe_restore_getopt_state, gs);
add_unwind_protect (pop_context, (char *)NULL);
unwind_protect_int (line_number);
unwind_protect_int (line_number_for_err_trap);
unwind_protect_int (return_catch_flag);
unwind_protect_jmp_buf (return_catch);
add_unwind_protect (dispose_command, (char *)tc);
lib/readline/histfile.c
+17 -3
View File
@@ -1,6 +1,6 @@
/* histfile.c - functions to manipulate the history file. */
/* Copyright (C) 1989-2010 Free Software Foundation, Inc.
/* Copyright (C) 1989-2015 Free Software Foundation, Inc.
This file contains the GNU History Library (History), a set of
routines for managing the text of previously typed lines.
@@ -35,6 +35,10 @@
#include <stdio.h>
#if defined (HAVE_LIMITS_H)
# include <limits.h>
#endif
#include <sys/types.h>
#if ! defined (_MINIX) && defined (HAVE_SYS_FILE_H)
# include <sys/file.h>
@@ -99,6 +103,10 @@ extern int errno;
#include "rlshell.h"
#include "xmalloc.h"
#if !defined (PATH_MAX)
# define PATH_MAX 1024 /* default */
#endif
/* If non-zero, we write timestamps to the history file in history_do_write() */
int history_write_timestamps = 0;
@@ -530,7 +538,10 @@ history_truncate_file (fname, lines)
history_lines_written_to_file = orig_lines - lines;
if (rv != 0 && filename && bakname)
histfile_restore (bakname, filename);
{
histfile_restore (bakname, filename);
history_lines_written_to_file = 0;
}
else if (rv == 0 && bakname)
unlink (bakname);
@@ -689,7 +700,10 @@ mmap_error:
rv = errno;
if (rv != 0 && output && bakname)
histfile_restore (bakname, output);
{
histfile_restore (bakname, output);
history_lines_written_to_file = 0;
}
else if (rv == 0 && bakname)
unlink (bakname);