commit bash-20041209 snapshot

doc/bashref.info

@@ -2,10 +2,10 @@ This is bashref.info, produced by makeinfo version 4.7 from
 /Users/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.1-devel, 24 November 2004).
+the Bash shell (version 3.1-devel, 1 December 2004).
 
-   This is Edition 3.1-devel, last updated 24 November 2004, of `The
-GNU Bash Reference Manual', for `Bash', Version 3.1-devel.
+   This is Edition 3.1-devel, last updated 1 December 2004, of `The GNU
+Bash Reference Manual', for `Bash', Version 3.1-devel.
 
    Copyright (C) 1988-2004 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.1-devel, 24 November 2004)..
+the Bash shell (version 3.1-devel, 1 December 2004)..
 
-   This is Edition 3.1-devel, last updated 24 November 2004, of `The
-GNU Bash Reference Manual', for `Bash', Version 3.1-devel.
+   This is Edition 3.1-devel, last updated 1 December 2004, of `The GNU
+Bash Reference Manual', for `Bash', Version 3.1-devel.
 
    Bash contains features that appear in other popular shells, and some
 features that only appear in Bash.  Some of the shells that Bash has
@@ -978,11 +978,11 @@ 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
 identical between a function and its caller with the exception that the
-`DEBUG' trap below) is not inherited unless the function has been given
-the `trace' attribute using the `declare' builtin or the `-o functrace'
-option has been enabled with the `set' builtin, (in which case all
-functions inherit the `DEBUG' trap).  *Note Bourne Shell Builtins::,
-for the description of the `trap' builtin.
+`DEBUG' and `RETURN' traps are not inherited unless the function has
+been given the `trace' attribute using the `declare' builtin or the `-o
+functrace' option has been enabled with the `set' builtin, (in which
+case all functions inherit the `DEBUG' and `RETURN' traps).  *Note
+Bourne Shell Builtins::, for the description of the `trap' builtin.
 
    If the builtin command `return' is executed in a function, the
 function completes and execution resumes with the next command after
@@ -2803,8 +2803,8 @@ POSIX 1003.2 standard.
 
     `-t'
           Give each NAME the `trace' attribute.  Traced functions
-          inherit the `DEBUG' trap from the calling shell.  The trace
-          attribute has no special meaning for variables.
+          inherit the `DEBUG' and `RETURN' traps from the calling shell.
+          The trace attribute has no special meaning for variables.
 
     `-x'
           Mark each NAME for export to subsequent commands via the
@@ -3566,10 +3566,10 @@ This builtin is so complicated that it deserves its own section.
                /usr/local
 
     `-T'
-          If set, any trap on `DEBUG' is inherited by shell functions,
-          command substitutions, and commands executed in a subshell
-          environment.  The `DEBUG' trap is normally not inherited in
-          such cases.
+          If set, any trap on `DEBUG' and `RETURN' are inherited by
+          shell functions, command substitutions, and commands executed
+          in a subshell environment.  The `DEBUG' and `RETURN' traps
+          are normally not inherited in such cases.
 
     `--'
           If no arguments follow this option, then the positional
@@ -8353,7 +8353,9 @@ included in SVR4.2 as the baseline reference.
      `DEBUG'.  Commands specified with an `RETURN' trap are executed
      before execution resumes after a shell function or a shell script
      executed with `.' or `source' returns.  The `RETURN' trap is not
-     inherited by shell functions.
+     inherited by shell functions unless the function has been given
+     the `trace' attribute or the `functrace' option has been enabled
+     using the `shopt' builtin.
 
    * The Bash `type' builtin is more extensive and gives more
      information about the names it finds (*note Bash Builtins::).
@@ -9442,129 +9444,129 @@ Concept Index
 
 
 Tag Table:
-Node: Top1375
-Node: Introduction3537
-Node: What is Bash?3766
-Node: What is a shell?4859
-Node: Definitions7400
-Node: Basic Shell Features10141
-Node: Shell Syntax11360
-Node: Shell Operation12392
-Node: Quoting13686
-Node: Escape Character14960
-Node: Single Quotes15445
-Node: Double Quotes15793
-Node: ANSI-C Quoting16819
-Node: Locale Translation17775
-Node: Comments18671
-Node: Shell Commands19285
-Node: Simple Commands20051
-Node: Pipelines20682
-Node: Lists22557
-Node: Compound Commands24188
-Node: Looping Constructs24972
-Node: Conditional Constructs27419
-Node: Command Grouping34486
-Node: Shell Functions35935
-Node: Shell Parameters40203
-Node: Positional Parameters42533
-Node: Special Parameters43433
-Node: Shell Expansions46358
-Node: Brace Expansion48283
-Node: Tilde Expansion50608
-Node: Shell Parameter Expansion52959
-Node: Command Substitution60468
-Node: Arithmetic Expansion61801
-Node: Process Substitution62651
-Node: Word Splitting63701
-Node: Filename Expansion65162
-Node: Pattern Matching67298
-Node: Quote Removal70623
-Node: Redirections70918
-Node: Executing Commands78648
-Node: Simple Command Expansion79323
-Node: Command Search and Execution81253
-Node: Command Execution Environment83259
-Node: Environment86030
-Node: Exit Status87690
-Node: Signals88894
-Node: Shell Scripts90858
-Node: Shell Builtin Commands93376
-Node: Bourne Shell Builtins94955
-Node: Bash Builtins111908
-Node: The Set Builtin140035
-Node: Special Builtins148413
-Node: Shell Variables149390
-Node: Bourne Shell Variables149830
-Node: Bash Variables151811
-Node: Bash Features171518
-Node: Invoking Bash172401
-Node: Bash Startup Files178222
-Node: Interactive Shells183080
-Node: What is an Interactive Shell?183490
-Node: Is this Shell Interactive?184140
-Node: Interactive Shell Behavior184955
-Node: Bash Conditional Expressions188231
-Node: Shell Arithmetic191810
-Node: Aliases194556
-Node: Arrays197124
-Node: The Directory Stack200391
-Node: Directory Stack Builtins201105
-Node: Printing a Prompt203996
-Node: The Restricted Shell206710
-Node: Bash POSIX Mode208542
-Node: Job Control215875
-Node: Job Control Basics216342
-Node: Job Control Builtins220718
-Node: Job Control Variables225070
-Node: Command Line Editing226228
-Node: Introduction and Notation227227
-Node: Readline Interaction228849
-Node: Readline Bare Essentials230040
-Node: Readline Movement Commands231829
-Node: Readline Killing Commands232794
-Node: Readline Arguments234714
-Node: Searching235758
-Node: Readline Init File237944
-Node: Readline Init File Syntax239003
-Node: Conditional Init Constructs250862
-Node: Sample Init File253395
-Node: Bindable Readline Commands256512
-Node: Commands For Moving257719
-Node: Commands For History258580
-Node: Commands For Text261735
-Node: Commands For Killing264408
-Node: Numeric Arguments266550
-Node: Commands For Completion267689
-Node: Keyboard Macros271282
-Node: Miscellaneous Commands271853
-Node: Readline vi Mode277164
-Node: Programmable Completion278078
-Node: Programmable Completion Builtins283890
-Node: Using History Interactively291486
-Node: Bash History Facilities292166
-Node: Bash History Builtins294861
-Node: History Interaction298718
-Node: Event Designators301274
-Node: Word Designators302289
-Node: Modifiers303928
-Node: Installing Bash305334
-Node: Basic Installation306471
-Node: Compilers and Options309163
-Node: Compiling For Multiple Architectures309904
-Node: Installation Names311568
-Node: Specifying the System Type312386
-Node: Sharing Defaults313102
-Node: Operation Controls313775
-Node: Optional Features314733
-Node: Reporting Bugs323012
-Node: Major Differences From The Bourne Shell324206
-Node: Copying This Manual339978
-Node: GNU Free Documentation License340254
-Node: Builtin Index362660
-Node: Reserved Word Index369209
-Node: Variable Index371645
-Node: Function Index382505
-Node: Concept Index389225
+Node: Top1373
+Node: Introduction3533
+Node: What is Bash?3762
+Node: What is a shell?4855
+Node: Definitions7396
+Node: Basic Shell Features10137
+Node: Shell Syntax11356
+Node: Shell Operation12388
+Node: Quoting13682
+Node: Escape Character14956
+Node: Single Quotes15441
+Node: Double Quotes15789
+Node: ANSI-C Quoting16815
+Node: Locale Translation17771
+Node: Comments18667
+Node: Shell Commands19281
+Node: Simple Commands20047
+Node: Pipelines20678
+Node: Lists22553
+Node: Compound Commands24184
+Node: Looping Constructs24968
+Node: Conditional Constructs27415
+Node: Command Grouping34482
+Node: Shell Functions35931
+Node: Shell Parameters40221
+Node: Positional Parameters42551
+Node: Special Parameters43451
+Node: Shell Expansions46376
+Node: Brace Expansion48301
+Node: Tilde Expansion50626
+Node: Shell Parameter Expansion52977
+Node: Command Substitution60486
+Node: Arithmetic Expansion61819
+Node: Process Substitution62669
+Node: Word Splitting63719
+Node: Filename Expansion65180
+Node: Pattern Matching67316
+Node: Quote Removal70641
+Node: Redirections70936
+Node: Executing Commands78666
+Node: Simple Command Expansion79341
+Node: Command Search and Execution81271
+Node: Command Execution Environment83277
+Node: Environment86048
+Node: Exit Status87708
+Node: Signals88912
+Node: Shell Scripts90876
+Node: Shell Builtin Commands93394
+Node: Bourne Shell Builtins94973
+Node: Bash Builtins111926
+Node: The Set Builtin140066
+Node: Special Builtins148473
+Node: Shell Variables149450
+Node: Bourne Shell Variables149890
+Node: Bash Variables151871
+Node: Bash Features171578
+Node: Invoking Bash172461
+Node: Bash Startup Files178282
+Node: Interactive Shells183140
+Node: What is an Interactive Shell?183550
+Node: Is this Shell Interactive?184200
+Node: Interactive Shell Behavior185015
+Node: Bash Conditional Expressions188291
+Node: Shell Arithmetic191870
+Node: Aliases194616
+Node: Arrays197184
+Node: The Directory Stack200451
+Node: Directory Stack Builtins201165
+Node: Printing a Prompt204056
+Node: The Restricted Shell206770
+Node: Bash POSIX Mode208602
+Node: Job Control215935
+Node: Job Control Basics216402
+Node: Job Control Builtins220778
+Node: Job Control Variables225130
+Node: Command Line Editing226288
+Node: Introduction and Notation227287
+Node: Readline Interaction228909
+Node: Readline Bare Essentials230100
+Node: Readline Movement Commands231889
+Node: Readline Killing Commands232854
+Node: Readline Arguments234774
+Node: Searching235818
+Node: Readline Init File238004
+Node: Readline Init File Syntax239063
+Node: Conditional Init Constructs250922
+Node: Sample Init File253455
+Node: Bindable Readline Commands256572
+Node: Commands For Moving257779
+Node: Commands For History258640
+Node: Commands For Text261795
+Node: Commands For Killing264468
+Node: Numeric Arguments266610
+Node: Commands For Completion267749
+Node: Keyboard Macros271342
+Node: Miscellaneous Commands271913
+Node: Readline vi Mode277224
+Node: Programmable Completion278138
+Node: Programmable Completion Builtins283950
+Node: Using History Interactively291546
+Node: Bash History Facilities292226
+Node: Bash History Builtins294921
+Node: History Interaction298778
+Node: Event Designators301334
+Node: Word Designators302349
+Node: Modifiers303988
+Node: Installing Bash305394
+Node: Basic Installation306531
+Node: Compilers and Options309223
+Node: Compiling For Multiple Architectures309964
+Node: Installation Names311628
+Node: Specifying the System Type312446
+Node: Sharing Defaults313162
+Node: Operation Controls313835
+Node: Optional Features314793
+Node: Reporting Bugs323072
+Node: Major Differences From The Bourne Shell324266
+Node: Copying This Manual340174
+Node: GNU Free Documentation License340450
+Node: Builtin Index362856
+Node: Reserved Word Index369405
+Node: Variable Index371841
+Node: Function Index382701
+Node: Concept Index389421
 
 End Tag Table