commit bash-20090806 snapshot

doc/bashref.info

@@ -4357,10 +4357,10 @@ Variables::).
      list of possible hostname completions may be changed while the
      shell is running; the next time hostname completion is attempted
      after the value is changed, Bash adds the contents of the new file
-     to the existing list.  If `HOSTFILE' is set, but has no value,
-     Bash attempts to read `/etc/hosts' to obtain the list of possible
-     hostname completions.  When `HOSTFILE' is unset, the hostname list
-     is cleared.
+     to the existing list.  If `HOSTFILE' is set, but has no value, or
+     does not name a readable file, Bash attempts to read `/etc/hosts'
+     to obtain the list of possible hostname completions.  When
+     `HOSTFILE' is unset, the hostname list is cleared.
 
 `HOSTNAME'
      The name of the current host.
@@ -7190,6 +7190,11 @@ File: bashref.info,  Node: Commands For Completion,  Next: Keyboard Macros,  Pre
      command is intended to be bound to <TAB>, but is unbound by
      default.
 
+`menu-complete-backward ()'
+     Identical to `menu-complete', but moves backward through the list
+     of possible completions, as if `menu-complete' had been given a
+     negative argument.
+
 `delete-char-or-list ()'
      Deletes the character under the cursor if not at the beginning or
      end of the line (like `delete-char').  If at the end of the line,
@@ -7562,19 +7567,23 @@ completion facilities.
      no matches were generated.
 
 `complete'
-          `complete [-abcdefgjksuv] [-o COMP-OPTION] [-E] [-A ACTION] [-G GLOBPAT] [-W WORDLIST]
+          `complete [-abcdefgjksuv] [-o COMP-OPTION] [-DE] [-A ACTION] [-G GLOBPAT] [-W WORDLIST]
           [-F FUNCTION] [-C COMMAND] [-X FILTERPAT]
           [-P PREFIX] [-S SUFFIX] NAME [NAME ...]'
-          `complete -pr [-E] [NAME ...]'
+          `complete -pr [-DE] [NAME ...]'
 
      Specify how arguments to each NAME should be completed.  If the
      `-p' 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 `-r' option removes a completion
      specification for each NAME, or, if no NAMEs are supplied, all
-     completion specifications.  The `-E' option indicates that the
-     remaining options and actions should apply to "empty" command
-     completion; that is, completion attempted on a blank line.
+     completion specifications.  The `-D' 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 `-E' 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 (*note Programmable
@@ -7747,12 +7756,18 @@ completion facilities.
      adding a completion specification.
 
 `compopt'
-          `compopt' [-o OPTION] [+o OPTION] [NAME]
+          `compopt' [-o OPTION] [-DE] [+o OPTION] [NAME]
      Modify completion options for each NAME according to the OPTIONs,
      or for the currently-execution completion if no NAMEs are supplied.
      If no OPTIONs are given, display the completion options for each
      NAME or the current completion.  The possible values of OPTION are
-     those valid for the `complete' builtin described above.
+     those valid for the `complete' builtin described above.  The `-D'
+     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
+     `-E' 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, an
      attempt is made to modify the options for a NAME for which no
@@ -9526,7 +9541,7 @@ D.1 Index of Shell Builtin Commands
 * complete:                              Programmable Completion Builtins.
                                                               (line  28)
 * compopt:                               Programmable Completion Builtins.
-                                                              (line 213)
+                                                              (line 217)
 * continue:                              Bourne Shell Builtins.
                                                               (line  55)
 * declare:                               Bash Builtins.       (line 142)
@@ -9847,7 +9862,7 @@ D.4 Function Index
 * copy-region-as-kill ():                Commands For Killing. (line 54)
 * delete-char (C-d):                     Commands For Text.    (line  6)
 * delete-char-or-list ():                Commands For Completion.
-                                                               (line 34)
+                                                               (line 39)
 * delete-horizontal-space ():            Commands For Killing. (line 46)
 * digit-argument (M-0, M-1, ... M--):    Numeric Arguments.    (line  6)
 * do-uppercase-version (M-a, M-b, M-X, ...): Miscellaneous Commands.
@@ -9880,6 +9895,8 @@ D.4 Function Index
 * kill-word (M-d):                       Commands For Killing. (line 19)
 * menu-complete ():                      Commands For Completion.
                                                                (line 22)
+* menu-complete-backward ():             Commands For Completion.
+                                                               (line 34)
 * next-history (C-n):                    Commands For History. (line 17)
 * non-incremental-forward-search-history (M-n): Commands For History.
                                                                (line 41)
@@ -10000,7 +10017,7 @@ D.5 Concept Index
 * history list:                          Bash History Facilities.
                                                               (line   6)
 * History, how to use:                   Programmable Completion Builtins.
-                                                              (line 225)
+                                                              (line 235)
 * identifier:                            Definitions.         (line  51)
 * initialization file, readline:         Readline Init File.  (line   6)
 * installation:                          Basic Installation.  (line   6)
@@ -10135,74 +10152,74 @@ Node: Special Builtins165022
 Node: Shell Variables166001
 Node: Bourne Shell Variables166441
 Node: Bash Variables168422
-Node: Bash Features190761
-Node: Invoking Bash191644
-Node: Bash Startup Files197453
-Node: Interactive Shells202422
-Node: What is an Interactive Shell?202832
-Node: Is this Shell Interactive?203481
-Node: Interactive Shell Behavior204296
-Node: Bash Conditional Expressions207576
-Node: Shell Arithmetic211101
-Node: Aliases213847
-Node: Arrays216419
-Node: The Directory Stack220377
-Node: Directory Stack Builtins221091
-Node: Printing a Prompt223983
-Node: The Restricted Shell226735
-Node: Bash POSIX Mode228567
-Node: Job Control236420
-Node: Job Control Basics236880
-Node: Job Control Builtins241597
-Node: Job Control Variables245961
-Node: Command Line Editing247119
-Node: Introduction and Notation248686
-Node: Readline Interaction250308
-Node: Readline Bare Essentials251499
-Node: Readline Movement Commands253288
-Node: Readline Killing Commands254253
-Node: Readline Arguments256173
-Node: Searching257217
-Node: Readline Init File259403
-Node: Readline Init File Syntax260550
-Node: Conditional Init Constructs273784
-Node: Sample Init File276317
-Node: Bindable Readline Commands279434
-Node: Commands For Moving280641
-Node: Commands For History281785
-Node: Commands For Text284940
-Node: Commands For Killing287613
-Node: Numeric Arguments290064
-Node: Commands For Completion291203
-Node: Keyboard Macros294970
-Node: Miscellaneous Commands295541
-Node: Readline vi Mode300852
-Node: Programmable Completion301766
-Node: Programmable Completion Builtins307599
-Node: Using History Interactively316025
-Node: Bash History Facilities316709
-Node: Bash History Builtins319623
-Node: History Interaction323480
-Node: Event Designators326185
-Node: Word Designators327200
-Node: Modifiers328839
-Node: Installing Bash330243
-Node: Basic Installation331380
-Node: Compilers and Options334072
-Node: Compiling For Multiple Architectures334813
-Node: Installation Names336477
-Node: Specifying the System Type337295
-Node: Sharing Defaults338011
-Node: Operation Controls338684
-Node: Optional Features339642
-Node: Reporting Bugs349044
-Node: Major Differences From The Bourne Shell350245
-Node: GNU Free Documentation License366932
-Node: Indexes392128
-Node: Builtin Index392582
-Node: Reserved Word Index399409
-Node: Variable Index401857
-Node: Function Index413663
-Node: Concept Index420395
+Node: Bash Features190795
+Node: Invoking Bash191678
+Node: Bash Startup Files197487
+Node: Interactive Shells202456
+Node: What is an Interactive Shell?202866
+Node: Is this Shell Interactive?203515
+Node: Interactive Shell Behavior204330
+Node: Bash Conditional Expressions207610
+Node: Shell Arithmetic211135
+Node: Aliases213881
+Node: Arrays216453
+Node: The Directory Stack220411
+Node: Directory Stack Builtins221125
+Node: Printing a Prompt224017
+Node: The Restricted Shell226769
+Node: Bash POSIX Mode228601
+Node: Job Control236454
+Node: Job Control Basics236914
+Node: Job Control Builtins241631
+Node: Job Control Variables245995
+Node: Command Line Editing247153
+Node: Introduction and Notation248720
+Node: Readline Interaction250342
+Node: Readline Bare Essentials251533
+Node: Readline Movement Commands253322
+Node: Readline Killing Commands254287
+Node: Readline Arguments256207
+Node: Searching257251
+Node: Readline Init File259437
+Node: Readline Init File Syntax260584
+Node: Conditional Init Constructs273818
+Node: Sample Init File276351
+Node: Bindable Readline Commands279468
+Node: Commands For Moving280675
+Node: Commands For History281819
+Node: Commands For Text284974
+Node: Commands For Killing287647
+Node: Numeric Arguments290098
+Node: Commands For Completion291237
+Node: Keyboard Macros295197
+Node: Miscellaneous Commands295768
+Node: Readline vi Mode301079
+Node: Programmable Completion301993
+Node: Programmable Completion Builtins307826
+Node: Using History Interactively316867
+Node: Bash History Facilities317551
+Node: Bash History Builtins320465
+Node: History Interaction324322
+Node: Event Designators327027
+Node: Word Designators328042
+Node: Modifiers329681
+Node: Installing Bash331085
+Node: Basic Installation332222
+Node: Compilers and Options334914
+Node: Compiling For Multiple Architectures335655
+Node: Installation Names337319
+Node: Specifying the System Type338137
+Node: Sharing Defaults338853
+Node: Operation Controls339526
+Node: Optional Features340484
+Node: Reporting Bugs349886
+Node: Major Differences From The Bourne Shell351087
+Node: GNU Free Documentation License367774
+Node: Indexes392970
+Node: Builtin Index393424
+Node: Reserved Word Index400251
+Node: Variable Index402699
+Node: Function Index414505
+Node: Concept Index421376
 
 End Tag Table