commit bash-20040422 snapshot

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.5 from
 /usr/homes/chet/src/bash/src/doc/bashref.texi.
 
 This text is a brief description of the features that are present in
-the Bash shell (version 3.0-beta1, 28 January 2004).
+the Bash shell (version 3.0-beta1, 20 April 2004).
 
-   This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash
+   This is Edition 3.0, last updated 20 April 2004, of `The GNU Bash
 Reference Manual', for `Bash', Version 3.0-beta1.
 
    Copyright (C) 1988-2003 Free Software Foundation, Inc.
@@ -37,9 +37,9 @@ Bash Features
 *************
 
    This text is a brief description of the features that are present in
-the Bash shell (version 3.0-beta1, 28 January 2004)..
+the Bash shell (version 3.0-beta1, 20 April 2004)..
 
-   This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash
+   This is Edition 3.0, last updated 20 April 2004, of `The GNU Bash
 Reference Manual', for `Bash', Version 3.0-beta1.
 
    Bash contains features that appear in other popular shells, and some
@@ -975,7 +975,7 @@ terminated by a semicolon, a `&', or a newline.
    When a function is executed, the arguments to the function become
 the positional parameters during its execution (*note Positional
 Parameters::).  The special parameter `#' that expands to the number of
-positional parameters is updated to reflect the change.  Positional
+positional parameters is updated to reflect the change.  Special
 parameter `0' is unchanged.  The first element of the `FUNCNAME'
 variable is set to the name of the function while the function is
 executing.  All other aspects of the shell execution environment are
@@ -1351,8 +1351,8 @@ if the colon is omitted, the operator tests only for existence.
 `${PARAMETER:=WORD}'
      If PARAMETER is unset or null, the expansion of WORD is assigned
      to PARAMETER.  The value of PARAMETER is then substituted.
-     Positional parameters and special parameters may not be assigned
-     to in this way.
+     Positional parameters and special parameters may not be assigned to
+     in this way.
 
 `${PARAMETER:?WORD}'
      If PARAMETER is null or unset, the expansion of WORD (or a message
@@ -4809,15 +4809,16 @@ builtin commands.
 
    The first word of each simple command, if unquoted, is checked to see
 if it has an alias.  If so, that word is replaced by the text of the
-alias.  The alias name and the replacement text may contain any valid
-shell input, including shell metacharacters, with the exception that
-the alias name may not contain `='.  The first word of the replacement
-text is tested for aliases, but a word that is identical to an alias
-being expanded is not expanded a second time.  This means that one may
-alias `ls' to `"ls -F"', for instance, and Bash does not try to
-recursively expand the replacement text. If the last character of the
-alias value is a space or tab character, then the next command word
-following the alias is also checked for alias expansion.
+alias.  The characters `/', `$', ``', `=' and any of the shell
+metacharacters or quoting characters listed above may not appear in an
+alias name.  The replacement text may contain any valid shell input,
+including shell metacharacters.  The first word of the replacement text
+is tested for aliases, but a word that is identical to an alias being
+expanded is not expanded a second time.  This means that one may alias
+`ls' to `"ls -F"', for instance, and Bash does not try to recursively
+expand the replacement text. If the last character of the alias value
+is a space or tab character, then the next command word following the
+alias is also checked for alias expansion.
 
    Aliases are created and listed with the `alias' command, and removed
 with the `unalias' command.
@@ -5428,7 +5429,7 @@ output.  If the `-b' option to the `set' builtin is enabled, Bash
 reports such changes immediately (*note The Set Builtin::).  Any trap
 on `SIGCHLD' is executed for each child process that exits.
 
-   If an attempt to exit Bash is while jobs are stopped, the shell
+   If an attempt to exit Bash is made while jobs are stopped, the shell
 prints a message warning that there are stopped jobs.  The `jobs'
 command may then be used to inspect their status.  If a second attempt
 to exit is made without an intervening command, Bash does not print
@@ -9256,129 +9257,129 @@ Concept Index
 
 
 Tag Table:
-Node: Top1371
-Node: Introduction3528
-Node: What is Bash?3753
-Node: What is a shell?4841
-Node: Definitions7377
-Node: Basic Shell Features10117
-Node: Shell Syntax11335
-Node: Shell Operation12359
-Node: Quoting13644
-Node: Escape Character14906
-Node: Single Quotes15378
-Node: Double Quotes15713
-Node: ANSI-C Quoting16726
-Node: Locale Translation17669
-Node: Comments18552
-Node: Shell Commands19157
-Node: Simple Commands19918
-Node: Pipelines20539
-Node: Lists22405
-Node: Compound Commands24027
-Node: Looping Constructs24799
-Node: Conditional Constructs27233
-Node: Command Grouping34286
-Node: Shell Functions35722
-Node: Shell Parameters39987
-Node: Positional Parameters41558
-Node: Special Parameters42449
-Node: Shell Expansions45107
-Node: Brace Expansion47027
-Node: Tilde Expansion49343
-Node: Shell Parameter Expansion51675
-Node: Command Substitution58929
-Node: Arithmetic Expansion60251
-Node: Process Substitution61092
-Node: Word Splitting62129
-Node: Filename Expansion63581
-Node: Pattern Matching65705
-Node: Quote Removal69026
-Node: Redirections69312
-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 Builtin137881
-Node: Special Builtins146099
-Node: Shell Variables147071
-Node: Bourne Shell Variables147507
-Node: Bash Variables149484
-Node: Bash Features168989
-Node: Invoking Bash169871
-Node: Bash Startup Files175682
-Node: Interactive Shells180552
-Node: What is an Interactive Shell?180954
-Node: Is this Shell Interactive?181589
-Node: Interactive Shell Behavior182395
-Node: Bash Conditional Expressions185662
-Node: Shell Arithmetic189082
-Node: Aliases191822
-Node: Arrays194325
-Node: The Directory Stack197345
-Node: Directory Stack Builtins198051
-Node: Printing a Prompt200930
-Node: The Restricted Shell203639
-Node: Bash POSIX Mode205464
-Node: Job Control212110
-Node: Job Control Basics212576
-Node: Job Control Builtins216856
-Node: Job Control Variables221152
-Node: Command Line Editing222302
-Node: Introduction and Notation223300
-Node: Readline Interaction224917
-Node: Readline Bare Essentials226103
-Node: Readline Movement Commands227883
-Node: Readline Killing Commands228839
-Node: Readline Arguments230748
-Node: Searching231783
-Node: Readline Init File233960
-Node: Readline Init File Syntax235014
-Node: Conditional Init Constructs246658
-Node: Sample Init File249182
-Node: Bindable Readline Commands252365
-Node: Commands For Moving253564
-Node: Commands For History254413
-Node: Commands For Text257302
-Node: Commands For Killing259963
-Node: Numeric Arguments262093
-Node: Commands For Completion263220
-Node: Keyboard Macros266801
-Node: Miscellaneous Commands267360
-Node: Readline vi Mode272659
-Node: Programmable Completion273568
-Node: Programmable Completion Builtins279375
-Node: Using History Interactively286737
-Node: Bash History Facilities287416
-Node: Bash History Builtins290106
-Node: History Interaction293958
-Node: Event Designators296509
-Node: Word Designators297513
-Node: Modifiers299143
-Node: Installing Bash300540
-Node: Basic Installation301674
-Node: Compilers and Options304359
-Node: Compiling For Multiple Architectures305093
-Node: Installation Names306750
-Node: Specifying the System Type307561
-Node: Sharing Defaults308270
-Node: Operation Controls308935
-Node: Optional Features309886
-Node: Reporting Bugs318158
-Node: Major Differences From The Bourne Shell319333
-Node: Copying This Manual335081
-Node: GNU Free Documentation License335335
-Node: Builtin Index357728
-Node: Reserved Word Index361355
-Node: Variable Index362831
-Node: Function Index369824
-Node: Concept Index374437
+Node: Top1367
+Node: Introduction3520
+Node: What is Bash?3745
+Node: What is a shell?4833
+Node: Definitions7369
+Node: Basic Shell Features10109
+Node: Shell Syntax11327
+Node: Shell Operation12351
+Node: Quoting13636
+Node: Escape Character14898
+Node: Single Quotes15370
+Node: Double Quotes15705
+Node: ANSI-C Quoting16718
+Node: Locale Translation17661
+Node: Comments18544
+Node: Shell Commands19149
+Node: Simple Commands19910
+Node: Pipelines20531
+Node: Lists22397
+Node: Compound Commands24019
+Node: Looping Constructs24791
+Node: Conditional Constructs27225
+Node: Command Grouping34278
+Node: Shell Functions35714
+Node: Shell Parameters39976
+Node: Positional Parameters41547
+Node: Special Parameters42438
+Node: Shell Expansions45096
+Node: Brace Expansion47016
+Node: Tilde Expansion49332
+Node: Shell Parameter Expansion51664
+Node: Command Substitution58918
+Node: Arithmetic Expansion60240
+Node: Process Substitution61081
+Node: Word Splitting62118
+Node: Filename Expansion63570
+Node: Pattern Matching65694
+Node: Quote Removal69015
+Node: Redirections69301
+Node: Executing Commands76776
+Node: Simple Command Expansion77443
+Node: Command Search and Execution79364
+Node: Command Execution Environment81361
+Node: Environment84123
+Node: Exit Status85774
+Node: Signals86969
+Node: Shell Scripts88924
+Node: Shell Builtin Commands91435
+Node: Bourne Shell Builtins92865
+Node: Bash Builtins109748
+Node: The Set Builtin137870
+Node: Special Builtins146088
+Node: Shell Variables147060
+Node: Bourne Shell Variables147496
+Node: Bash Variables149473
+Node: Bash Features168978
+Node: Invoking Bash169860
+Node: Bash Startup Files175671
+Node: Interactive Shells180541
+Node: What is an Interactive Shell?180943
+Node: Is this Shell Interactive?181578
+Node: Interactive Shell Behavior182384
+Node: Bash Conditional Expressions185651
+Node: Shell Arithmetic189071
+Node: Aliases191811
+Node: Arrays194374
+Node: The Directory Stack197394
+Node: Directory Stack Builtins198100
+Node: Printing a Prompt200979
+Node: The Restricted Shell203688
+Node: Bash POSIX Mode205513
+Node: Job Control212159
+Node: Job Control Basics212625
+Node: Job Control Builtins216910
+Node: Job Control Variables221206
+Node: Command Line Editing222356
+Node: Introduction and Notation223354
+Node: Readline Interaction224971
+Node: Readline Bare Essentials226157
+Node: Readline Movement Commands227937
+Node: Readline Killing Commands228893
+Node: Readline Arguments230802
+Node: Searching231837
+Node: Readline Init File234014
+Node: Readline Init File Syntax235068
+Node: Conditional Init Constructs246712
+Node: Sample Init File249236
+Node: Bindable Readline Commands252419
+Node: Commands For Moving253618
+Node: Commands For History254467
+Node: Commands For Text257356
+Node: Commands For Killing260017
+Node: Numeric Arguments262147
+Node: Commands For Completion263274
+Node: Keyboard Macros266855
+Node: Miscellaneous Commands267414
+Node: Readline vi Mode272713
+Node: Programmable Completion273622
+Node: Programmable Completion Builtins279429
+Node: Using History Interactively286791
+Node: Bash History Facilities287470
+Node: Bash History Builtins290160
+Node: History Interaction294012
+Node: Event Designators296563
+Node: Word Designators297567
+Node: Modifiers299197
+Node: Installing Bash300594
+Node: Basic Installation301728
+Node: Compilers and Options304413
+Node: Compiling For Multiple Architectures305147
+Node: Installation Names306804
+Node: Specifying the System Type307615
+Node: Sharing Defaults308324
+Node: Operation Controls308989
+Node: Optional Features309940
+Node: Reporting Bugs318212
+Node: Major Differences From The Bourne Shell319387
+Node: Copying This Manual335135
+Node: GNU Free Documentation License335389
+Node: Builtin Index357782
+Node: Reserved Word Index361409
+Node: Variable Index362885
+Node: Function Index369878
+Node: Concept Index374491
 
 End Tag Table