commit bash-20040121 snapshot

This commit is contained in:
Chet Ramey
2011-12-03 12:53:44 -05:00
parent 43cdcad8f4
commit 12d937f9af
59 changed files with 28288 additions and 946 deletions
+134 -169
View File
@@ -1,11 +1,11 @@
This is bashref.info, produced by makeinfo version 4.5 from
/usr/homes/chet/src/bash/src/doc/bashref.texi.
This is bashref.info, produced by makeinfo version 4.2 from
/usr/src/local/bash/bash-20040121/doc/bashref.texi.
This text is a brief description of the features that are present in
the Bash shell (version 3.0-alpha, 13 November 2003).
the Bash shell (version 3.0-beta1, 24 January 2004).
This is Edition 3.0, last updated 13 November 2003, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-alpha.
This is Edition 3.0, last updated 24 January 2004, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-beta1.
Copyright (C) 1988-2003 Free Software Foundation, Inc.
@@ -37,10 +37,10 @@ Bash Features
*************
This text is a brief description of the features that are present in
the Bash shell (version 3.0-alpha, 13 November 2003)..
the Bash shell (version 3.0-beta1, 24 January 2004)..
This is Edition 3.0, last updated 13 November 2003, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-alpha.
This is Edition 3.0, last updated 24 January 2004, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-beta1.
Bash contains features that appear in other popular shells, and some
features that only appear in Bash. Some of the shells that Bash has
@@ -731,7 +731,6 @@ syntax, it may be replaced with one or more newlines.
command in LIST that is executed, or false if any of the
expressions is invalid.
The `break' and `continue' builtins (*note Bourne Shell Builtins::)
may be used to control loop execution.
@@ -896,7 +895,6 @@ Conditional Constructs
value of EXPRESSION1 is sufficient to determine the return value
of the entire conditional expression.

File: bashref.info, Node: Command Grouping, Prev: Conditional Constructs, Up: Compound Commands
@@ -1301,7 +1299,6 @@ the expanded value.
`~-N'
The string that would be displayed by `dirs -N'

File: bashref.info, Node: Shell Parameter Expansion, Next: Command Substitution, Prev: Tilde Expansion, Up: Shell Expansions
@@ -1448,7 +1445,6 @@ if the colon is omitted, the operator tests only for existence.
member of the array in turn, and the expansion is the resultant
list.

File: bashref.info, Node: Command Substitution, Next: Arithmetic Expansion, Prev: Shell Parameter Expansion, Up: Shell Expansions
@@ -1756,7 +1752,6 @@ redirections, as described in the following table:
integer port number or service name, Bash attempts to open a UDP
connection to the corresponding socket.
A failure to open or create a file causes the redirection to fail.
Redirecting Input
@@ -2715,7 +2710,6 @@ POSIX 1003.2 standard.
`-x KEYSEQ:SHELL-COMMAND'
Cause SHELL-COMMAND to be executed whenever KEYSEQ is entered.
The return status is zero unless an invalid option is supplied or
an error occurs.
@@ -3011,7 +3005,6 @@ POSIX 1003.2 standard.
`-u FD'
Read input from file descriptor FD.
`shopt'
shopt [-pqsu] [-o] [OPTNAME ...]
Toggle the values of variables controlling optional shell behavior.
@@ -3221,7 +3214,6 @@ POSIX 1003.2 standard.
If set, the `echo' builtin expands backslash-escape sequences
by default.
The return status when listing options is zero if all OPTNAMES are
enabled, non-zero otherwise. When setting or unsetting options,
the return status is zero unless an OPTNAME is not a valid shell
@@ -3315,7 +3307,6 @@ POSIX 1003.2 standard.
`-v'
The maximum amount of virtual memory available to the process.
If LIMIT is given, it is the new value of the specified resource;
the special LIMIT values `hard', `soft', and `unlimited' stand for
the current hard limit, the current soft limit, and no limit,
@@ -3336,7 +3327,6 @@ POSIX 1003.2 standard.
Remove each NAME from the list of aliases. If `-a' is supplied,
all aliases are removed. Aliases are described in *Note Aliases::.

File: bashref.info, Node: The Set Builtin, Next: Special Builtins, Prev: Bash Builtins, Up: Shell Builtin Commands
@@ -3683,7 +3673,6 @@ shell. In some cases, Bash assigns a default value to the variable.
`PS2'
The secondary prompt string. The default value is `> '.

File: bashref.info, Node: Bash Variables, Prev: Bourne Shell Variables, Up: Shell Variables
@@ -3776,7 +3765,6 @@ Variables::).
`BASH_VERSINFO[5]'
The value of `MACHTYPE'.
`BASH_VERSION'
The version number of the current instance of Bash.
@@ -4157,7 +4145,6 @@ Variables::).
The numeric real user id of the current user. This variable is
readonly.

File: bashref.info, Node: Bash Features, Next: Job Control, Prev: Shell Variables, Up: Top
@@ -4255,7 +4242,6 @@ the single-character options to be recognized.
Show version information for this instance of Bash on the standard
output and exit successfully.
There are several single-character options that may be supplied at
invocation which are not available with the `set' builtin.
@@ -4307,7 +4293,6 @@ invocation which are not available with the `set' builtin.
processing. Any arguments after the `--' are treated as filenames
and arguments.
A _login_ shell is one whose first character of argument zero is
`-', or one invoked with the `--login' option.
@@ -4699,7 +4684,6 @@ checked. If the FILE argument to one of the primaries is one of
greater than or equal to ARG2, respectively. ARG1 and ARG2 may be
positive or negative integers.

File: bashref.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditional Expressions, Up: Bash Features
@@ -5016,7 +5000,6 @@ Directory Stack Builtins
Makes the current working directory be the top of the stack,
and then executes the equivalent of ``cd' DIR'. `cd's to DIR.

File: bashref.info, Node: Printing a Prompt, Next: The Restricted Shell, Prev: The Directory Stack, Up: Bash Features
@@ -5089,10 +5072,11 @@ which can appear in the prompt variables:
The release of Bash, version + patchlevel (e.g., 2.00.0)
`\w'
The current working directory.
The current working directory, with `$HOME' abbreviated with a
tilde.
`\W'
The basename of `$PWD'.
The basename of `$PWD', with `$HOME' abbreviated with a tilde.
`\!'
The history number of this command.
@@ -5532,7 +5516,6 @@ Job Control Builtins
signal. The `-f' option means to suspend even if the shell is a
login shell.
When job control is not active, the `kill' and `wait' builtins do
not accept JOBSPEC arguments. They must be supplied process IDs.
@@ -5559,7 +5542,6 @@ Job Control Variables
a prefix of a stopped job's name; this provides functionality
analogous to the `%' job ID.

File: bashref.info, Node: Command Line Editing, Next: Installing Bash, Prev: Using History Interactively, Up: Top
@@ -5766,7 +5748,6 @@ available to be yanked back later, when you are typing another line.
Kill from the cursor to the previous whitespace. This is
different than `M-<DEL>' because the word boundaries differ.
Here is how to "yank" the text back into the line. Yanking means to
copy the most-recently-killed text from the kill buffer.
@@ -6044,7 +6025,6 @@ Variable Settings
appended to the filename when listing possible completions.
The default is `off'.
Key Bindings
The syntax for controlling key bindings in the init file is
simple. First you need to find the name of the command that you
@@ -6099,7 +6079,6 @@ Key Bindings
`<ESC> <[> <1> <1> <~>' is bound to insert the text `Function
Key 1'.
The following GNU Emacs style escape sequences are available when
specifying key sequences:
@@ -6165,7 +6144,6 @@ Key Bindings
the line:
"\C-x\\": "\\"

File: bashref.info, Node: Conditional Init Constructs, Next: Sample Init File, Prev: Readline Init File Syntax, Up: Readline Init File
@@ -6397,7 +6375,6 @@ Commands For Moving
`redraw-current-line ()'
Refresh the current line. By default, this is unbound.

File: bashref.info, Node: Commands For History, Next: Commands For Text, Prev: Commands For Moving, Up: Bindable Readline Commands
@@ -6468,7 +6445,6 @@ Commands For Manipulating The History
through the history list, inserting the last argument of each line
in turn.

File: bashref.info, Node: Commands For Text, Next: Commands For Killing, Prev: Commands For History, Up: Bindable Readline Commands
@@ -6533,7 +6509,6 @@ Commands For Changing Text
By default, this command is unbound.

File: bashref.info, Node: Commands For Killing, Next: Numeric Arguments, Prev: Commands For Text, Up: Bindable Readline Commands
@@ -6709,7 +6684,6 @@ Letting Readline Type For You
completions enclosed within braces so the list is available to the
shell (*note Brace Expansion::).

File: bashref.info, Node: Keyboard Macros, Next: Miscellaneous Commands, Prev: Commands For Completion, Up: Bindable Readline Commands
@@ -6727,7 +6701,6 @@ Keyboard Macros
Re-execute the last keyboard macro defined, by making the
characters in the macro appear as if typed at the keyboard.

File: bashref.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up: Bindable Readline Commands
@@ -6862,7 +6835,6 @@ Some Miscellaneous Commands
result as shell commands. Bash attempts to invoke `$FCEDIT',
`$EDITOR', and `emacs' as the editor, in that order.

File: bashref.info, Node: Readline vi Mode, Next: Programmable Completion, Prev: Bindable Readline Commands, Up: Command Line Editing
@@ -7195,7 +7167,6 @@ completion facilities.
for a NAME for which no specification exists, or an error occurs
adding a completion specification.

File: bashref.info, Node: Using History Interactively, Next: Command Line Editing, Prev: Job Control, Up: Top
@@ -7354,12 +7325,10 @@ and history file.
The ARGs are added to the end of the history list as a single
entry.
When any of the `-w', `-r', `-a', or `-n' options is used, if
FILENAME is given, then it is used as the history file. If not,
then the value of the `HISTFILE' variable is used.

File: bashref.info, Node: History Interaction, Prev: Bash History Builtins, Up: Using History Interactively
@@ -7449,7 +7418,6 @@ history list.
`!#'
The entire command line typed so far.

File: bashref.info, Node: Word Designators, Next: Modifiers, Prev: Event Designators, Up: History Interaction
@@ -7508,7 +7476,6 @@ line separated by single spaces.
`X-'
Abbreviates `X-$' like `X*', but omits the last word.
If a word designator is supplied without an event specification, the
previous command is used as the event.
@@ -7563,7 +7530,6 @@ more of the following modifiers, each preceded by a `:'.
`G'
Apply the following `s' modifier once to each word in the event.

File: bashref.info, Node: Installing Bash, Next: Reporting Bugs, Prev: Command Line Editing, Up: Top
@@ -7997,7 +7963,6 @@ does not provide the necessary support.
Specification, version 2. *Note Bash Builtins::, for a
description of the escape sequences that `echo' recognizes.
The file `config-top.h' contains C Preprocessor `#define' statements
for options which are not settable from `configure'. Some of these are
not meant to be changed; beware of the consequences if you do. Read
@@ -9249,129 +9214,129 @@ Concept Index

Tag Table:
Node: Top1373
Node: Introduction3532
Node: What is Bash?3757
Node: What is a shell?4845
Node: Definitions7381
Node: Basic Shell Features10121
Node: Shell Syntax11339
Node: Shell Operation12363
Node: Quoting13648
Node: Escape Character14910
Node: Single Quotes15382
Node: Double Quotes15717
Node: ANSI-C Quoting16730
Node: Locale Translation17673
Node: Comments18556
Node: Shell Commands19161
Node: Simple Commands19922
Node: Pipelines20543
Node: Lists22409
Node: Compound Commands24031
Node: Looping Constructs24803
Node: Top1376
Node: Introduction3533
Node: What is Bash?3758
Node: What is a shell?4846
Node: Definitions7382
Node: Basic Shell Features10122
Node: Shell Syntax11340
Node: Shell Operation12364
Node: Quoting13649
Node: Escape Character14911
Node: Single Quotes15383
Node: Double Quotes15718
Node: ANSI-C Quoting16731
Node: Locale Translation17674
Node: Comments18557
Node: Shell Commands19162
Node: Simple Commands19923
Node: Pipelines20544
Node: Lists22410
Node: Compound Commands24032
Node: Looping Constructs24804
Node: Conditional Constructs27237
Node: Command Grouping34290
Node: Shell Functions35726
Node: Shell Parameters39991
Node: Positional Parameters41562
Node: Special Parameters42453
Node: Shell Expansions45111
Node: Brace Expansion47031
Node: Tilde Expansion49347
Node: Shell Parameter Expansion51679
Node: Command Substitution58933
Node: Arithmetic Expansion60255
Node: Process Substitution61096
Node: Word Splitting62133
Node: Filename Expansion63585
Node: Pattern Matching65709
Node: Quote Removal69030
Node: Redirections69316
Node: Executing Commands76791
Node: Simple Command Expansion77458
Node: Command Search and Execution79379
Node: Command Execution Environment81376
Node: Environment84138
Node: Exit Status85789
Node: Signals86984
Node: Shell Scripts88939
Node: Shell Builtin Commands91450
Node: Bourne Shell Builtins92880
Node: Bash Builtins109763
Node: The Set Builtin137885
Node: Special Builtins146103
Node: Shell Variables147075
Node: Bourne Shell Variables147511
Node: Bash Variables149488
Node: Bash Features168993
Node: Invoking Bash169875
Node: Bash Startup Files175686
Node: Interactive Shells180556
Node: What is an Interactive Shell?180958
Node: Is this Shell Interactive?181593
Node: Interactive Shell Behavior182399
Node: Bash Conditional Expressions185666
Node: Shell Arithmetic189086
Node: Aliases191826
Node: Arrays194329
Node: The Directory Stack197349
Node: Directory Stack Builtins198055
Node: Printing a Prompt200934
Node: The Restricted Shell203560
Node: Bash POSIX Mode205385
Node: Job Control212031
Node: Job Control Basics212497
Node: Job Control Builtins216777
Node: Job Control Variables221073
Node: Command Line Editing222223
Node: Introduction and Notation223221
Node: Readline Interaction224838
Node: Readline Bare Essentials226024
Node: Readline Movement Commands227804
Node: Readline Killing Commands228760
Node: Readline Arguments230669
Node: Searching231704
Node: Readline Init File233881
Node: Readline Init File Syntax234935
Node: Conditional Init Constructs246579
Node: Sample Init File249103
Node: Bindable Readline Commands252286
Node: Commands For Moving253485
Node: Commands For History254334
Node: Commands For Text257223
Node: Commands For Killing259884
Node: Numeric Arguments261834
Node: Commands For Completion262961
Node: Keyboard Macros266542
Node: Miscellaneous Commands267101
Node: Readline vi Mode272400
Node: Programmable Completion273309
Node: Programmable Completion Builtins279116
Node: Using History Interactively286478
Node: Bash History Facilities287157
Node: Bash History Builtins289847
Node: History Interaction293699
Node: Event Designators296250
Node: Word Designators297254
Node: Modifiers298884
Node: Installing Bash300281
Node: Basic Installation301415
Node: Compilers and Options304100
Node: Compiling For Multiple Architectures304834
Node: Installation Names306491
Node: Specifying the System Type307302
Node: Sharing Defaults308011
Node: Operation Controls308676
Node: Optional Features309627
Node: Reporting Bugs317899
Node: Major Differences From The Bourne Shell319074
Node: Copying This Manual334822
Node: GNU Free Documentation License335076
Node: Builtin Index357469
Node: Reserved Word Index361096
Node: Variable Index362572
Node: Function Index369565
Node: Concept Index374115
Node: Command Grouping34289
Node: Shell Functions35725
Node: Shell Parameters39990
Node: Positional Parameters41561
Node: Special Parameters42452
Node: Shell Expansions45110
Node: Brace Expansion47030
Node: Tilde Expansion49346
Node: Shell Parameter Expansion51677
Node: Command Substitution58930
Node: Arithmetic Expansion60252
Node: Process Substitution61093
Node: Word Splitting62130
Node: Filename Expansion63582
Node: Pattern Matching65706
Node: Quote Removal69027
Node: Redirections69313
Node: Executing Commands76787
Node: Simple Command Expansion77454
Node: Command Search and Execution79375
Node: Command Execution Environment81372
Node: Environment84134
Node: Exit Status85785
Node: Signals86980
Node: Shell Scripts88935
Node: Shell Builtin Commands91446
Node: Bourne Shell Builtins92876
Node: Bash Builtins109759
Node: The Set Builtin137876
Node: Special Builtins146094
Node: Shell Variables147066
Node: Bourne Shell Variables147502
Node: Bash Variables149478
Node: Bash Features168981
Node: Invoking Bash169863
Node: Bash Startup Files175672
Node: Interactive Shells180542
Node: What is an Interactive Shell?180944
Node: Is this Shell Interactive?181579
Node: Interactive Shell Behavior182385
Node: Bash Conditional Expressions185652
Node: Shell Arithmetic189071
Node: Aliases191811
Node: Arrays194314
Node: The Directory Stack197334
Node: Directory Stack Builtins198040
Node: Printing a Prompt200918
Node: The Restricted Shell203627
Node: Bash POSIX Mode205452
Node: Job Control212098
Node: Job Control Basics212564
Node: Job Control Builtins216844
Node: Job Control Variables221139
Node: Command Line Editing222288
Node: Introduction and Notation223286
Node: Readline Interaction224903
Node: Readline Bare Essentials226089
Node: Readline Movement Commands227869
Node: Readline Killing Commands228825
Node: Readline Arguments230733
Node: Searching231768
Node: Readline Init File233945
Node: Readline Init File Syntax234999
Node: Conditional Init Constructs246640
Node: Sample Init File249164
Node: Bindable Readline Commands252347
Node: Commands For Moving253546
Node: Commands For History254394
Node: Commands For Text257282
Node: Commands For Killing259942
Node: Numeric Arguments261892
Node: Commands For Completion263019
Node: Keyboard Macros266599
Node: Miscellaneous Commands267157
Node: Readline vi Mode272455
Node: Programmable Completion273364
Node: Programmable Completion Builtins279171
Node: Using History Interactively286532
Node: Bash History Facilities287211
Node: Bash History Builtins289901
Node: History Interaction293751
Node: Event Designators296302
Node: Word Designators297305
Node: Modifiers298934
Node: Installing Bash300330
Node: Basic Installation301464
Node: Compilers and Options304149
Node: Compiling For Multiple Architectures304883
Node: Installation Names306540
Node: Specifying the System Type307351
Node: Sharing Defaults308060
Node: Operation Controls308725
Node: Optional Features309676
Node: Reporting Bugs317947
Node: Major Differences From The Bourne Shell319122
Node: Copying This Manual334870
Node: GNU Free Documentation License335124
Node: Builtin Index357517
Node: Reserved Word Index361144
Node: Variable Index362620
Node: Function Index369613
Node: Concept Index374163

End Tag Table