summaryrefslogtreecommitdiff
path: root/doc/readline.info
diff options
context:
space:
mode:
Diffstat (limited to 'doc/readline.info')
-rw-r--r--doc/readline.info462
1 files changed, 287 insertions, 175 deletions
diff --git a/doc/readline.info b/doc/readline.info
index 93d54dc..73b6a97 100644
--- a/doc/readline.info
+++ b/doc/readline.info
@@ -1,10 +1,10 @@
-This is readline.info, produced by makeinfo version 6.7 from rlman.texi.
+This is readline.info, produced by makeinfo version 6.8 from rlman.texi.
-This manual describes the GNU Readline Library (version 8.1, 29 October
-2020), a library which aids in the consistency of user interface across
+This manual describes the GNU Readline Library (version 8.2, 11 March
+2022), a library which aids in the consistency of user interface across
discrete programs which provide a command line interface.
- Copyright (C) 1988-2020 Free Software Foundation, Inc.
+ Copyright (C) 1988-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -309,7 +309,7 @@ File: readline.info, Node: Readline Init File, Next: Bindable Readline Command
Although the Readline library comes with a set of Emacs-like keybindings
installed by default, it is possible to use a different set of
keybindings. Any user can customize programs that use Readline by
-putting commands in an "inputrc" file, conventionally in his home
+putting commands in an "inputrc" file, conventionally in their home
directory. The name of this file is taken from the value of the
environment variable 'INPUTRC'. If that variable is unset, the default
is '~/.inputrc'. If that file does not exist or cannot be read, the
@@ -363,6 +363,32 @@ Variable Settings
A great deal of run-time behavior is changeable with the following
variables.
+ 'active-region-start-color'
+ A string variable that controls the text color and background
+ when displaying the text in the active region (see the
+ description of 'enable-active-region' below). This string
+ must not take up any physical character positions on the
+ display, so it should consist only of terminal escape
+ sequences. It is output to the terminal before displaying the
+ text in the active region. This variable is reset to the
+ default value whenever the terminal type changes. The default
+ value is the string that puts the terminal in standout mode,
+ as obtained from the terminal's terminfo description. A
+ sample value might be '\e[01;33m'.
+
+ 'active-region-end-color'
+ A string variable that "undoes" the effects of
+ 'active-region-start-color' and restores "normal" terminal
+ display appearance after displaying text in the active region.
+ This string must not take up any physical character positions
+ on the display, so it should consist only of terminal escape
+ sequences. It is output to the terminal after displaying the
+ text in the active region. This variable is reset to the
+ default value whenever the terminal type changes. The default
+ value is the string that restores the terminal from standout
+ mode, as obtained from the terminal's terminfo description. A
+ sample value might be '\e[0m'.
+
'bell-style'
Controls what happens when Readline wants to ring the terminal
bell. If set to 'none', Readline never rings the bell. If
@@ -384,7 +410,10 @@ Variable Settings
If set to 'on', 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 'LS_COLORS' environment variable. The default is
+ value of the 'LS_COLORS' environment variable. If there is a
+ color definition in 'LS_COLORS' for the custom suffix
+ 'readline-colored-completion-prefix', Readline uses this color
+ for the common prefix instead of its default. The default is
'off'.
'colored-stats'
@@ -430,8 +459,9 @@ Variable Settings
than or equal to this value, Readline will ask whether or not
the user wishes to view them; otherwise, they are simply
listed. This variable must be set to an integer value greater
- than or equal to 0. A negative value means Readline should
- never ask. The default limit is '100'.
+ than or equal to zero. A zero value means Readline should
+ never ask; negative values are treated as zero. The default
+ limit is '100'.
'convert-meta'
If set to 'on', Readline will convert characters with the
@@ -467,13 +497,27 @@ Variable Settings
non-printing characters, which can be used to embed a terminal
control sequence into the mode string. The default is '@'.
+ 'enable-active-region'
+ The "point" is the current cursor position, and "mark" refers
+ to a saved cursor position (*note Commands For Moving::). The
+ text between the point and mark is referred to as the
+ "region". When this variable is set to 'On', Readline allows
+ certain commands to designate the region as "active". When
+ the region is active, Readline highlights the text in the
+ region using the value of the 'active-region-start-color',
+ which defaults to the string that enables the terminal's
+ standout mode. The active region shows the text inserted by
+ bracketed-paste and any matching text found by incremental and
+ non-incremental history searches. The default is 'On'.
+
'enable-bracketed-paste'
- When set to 'On', 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. The default is 'On'.
+ When set to 'On', Readline configures the terminal 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 is called putting the
+ terminal into "bracketed paste mode"; it prevents Readline
+ from executing any editing commands bound to key sequences
+ appearing in the pasted text. The default is 'On'.
'enable-keypad'
When set to 'on', Readline will try to enable the application
@@ -1145,6 +1189,11 @@ File: readline.info, Node: Commands For History, Next: Commands For Text, Pre
supplied, specifies the history entry to use instead of the current
line.
+'fetch-history ()'
+ With a numeric argument, fetch that entry from the history list and
+ make it the current line. Without an argument, move back to the
+ first entry in the history list.
+

File: readline.info, Node: Commands For Text, Next: Commands For Killing, Prev: Commands For History, Up: Bindable Readline Commands
@@ -1519,7 +1568,7 @@ and subsequent lines with 'j', and so forth.
aiding in the consistency of user interface across discrete programs
that need to provide a command line interface.
- Copyright (C) 1988-2020 Free Software Foundation, Inc.
+ Copyright (C) 1988-2022 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice pare
@@ -1807,7 +1856,14 @@ These variables are available to function writers.
-- Variable: int rl_done
Setting this to a non-zero value causes Readline to return the
- current line immediately.
+ current line immediately. Readline will set this variable when it
+ has read a key sequence bound to 'accept-line' and is about to
+ return the line to the caller.
+
+ -- Variable: int rl_eof_found
+ Readline will set this variable when it has read an EOF character
+ (e.g., the stty 'EOF' character) on an empty line or encountered a
+ read error and is about to return a NULL line to the caller.
-- Variable: int rl_num_chars_to_read
Setting this to a positive value before calling 'readline()' causes
@@ -1918,6 +1974,10 @@ These variables are available to function writers.
If non-zero, this is the address of a function to call if a read
system call is interrupted when Readline is reading terminal input.
+ -- Variable: rl_hook_func_t * rl_timeout_event_hook
+ If non-zero, this is the address of a function to call if Readline
+ times out while reading input.
+
-- Variable: rl_hook_func_t * rl_input_available_hook
If non-zero, Readline will use this function's return value when it
needs to determine whether or not there is available input on the
@@ -2049,6 +2109,15 @@ These variables are available to function writers.
'RL_STATE_DONE'
Readline has read a key sequence bound to 'accept-line' and is
about to return the line to the caller.
+ 'RL_STATE_TIMEOUT'
+ Readline has timed out (it did not receive a line or specified
+ number of characters before the timeout duration specified by
+ 'rl_set_timeout' elapsed) and is returning that status to the
+ caller.
+ 'RL_STATE_EOF'
+ Readline has read an EOF character (e.g., the stty 'EOF'
+ character) or encountered a read error and is about to return
+ a NULL line to the caller.
-- Variable: int rl_explicit_arg
Set to a non-zero value if an explicit numeric argument was
@@ -2322,6 +2391,14 @@ associate a new function name with an arbitrary function.
parameter. It takes a "translated" key sequence and should be used
if the key sequence can include NUL.
+ -- Function: int rl_trim_arg_from_keyseq (const char *keyseq, size_t
+ len, Keymap map)
+ If there is a numeric argument at the beginning of KEYSEQ, possibly
+ including digits, return the index of the first character in KEYSEQ
+ following the numeric argument. This can be used to skip over the
+ numeric argument (which is available as 'rl_numeric_arg' while
+ traversing the key sequence that invoked the current command.
+
-- Function: char ** rl_invoking_keyseqs (rl_command_func_t *function)
Return an array of strings representing the key sequences used to
invoke FUNCTION in the current keymap.
@@ -2490,8 +2567,8 @@ File: readline.info, Node: Redisplay, Next: Modifying Text, Prev: Allowing Un
characters that take up no physical screen space when displayed by
bracketing a sequence of such characters with the special markers
'RL_PROMPT_START_IGNORE' and 'RL_PROMPT_END_IGNORE' (declared in
- 'readline.h'). This may be used to embed terminal-specific escape
- sequences in prompts.
+ 'readline.h' as '\001' and '\002', respectively). This may be used
+ to embed terminal-specific escape sequences in prompts.
-- Function: int rl_set_prompt (const char *prompt)
Make Readline use PROMPT for subsequent redisplay. This calls
@@ -2570,6 +2647,26 @@ File: readline.info, Node: Character Input, Next: Terminal Management, Prev:
waiting period is one-tenth of a second. Returns the old timeout
value.
+ -- Function: int rl_set_timeout (unsigned int secs, unsigned int usecs)
+ Set a timeout for subsequent calls to 'readline()'. If Readline
+ does not read a complete line, or the number of characters
+ specified by 'rl_num_chars_to_read', before the duration specfied
+ by SECS (in seconds) and USECS (microseconds), it returns and sets
+ 'RL_STATE_TIMEOUT' in 'rl_readline_state'. Passing 0 for 'secs'
+ and 'usecs' cancels any previously set timeout; the convenience
+ macro 'rl_clear_timeout()' is shorthand for this. Returns 0 if the
+ timeout is set successfully.
+
+ -- Function: int rl_timeout_remaining (unsigned int *secs, unsigned int
+ *usecs)
+ Return the number of seconds and microseconds remaining in the
+ current timeout duration in *SECS and *USECS, respectively. Both
+ *SECS and *USECS must be non-NULL to return any values. The return
+ value is -1 on error or when there is no timeout set, 0 when the
+ timeout has expired (leaving *SECS and *USECS unchanged), and 1 if
+ the timeout has not expired. If either of SECS and USECS is
+ 'NULL', the return value indicates whether the timeout has expired.
+

File: readline.info, Node: Terminal Management, Next: Utility Functions, Prev: Character Input, Up: Readline Convenience Functions
@@ -3011,13 +3108,13 @@ File: readline.info, Node: Readline Signal Handling, Next: Custom Completers,
Signals are asynchronous events sent to a process by the Unix kernel,
sometimes on behalf of another process. They are intended to indicate
-exceptional events, like a user pressing the interrupt key on his
-terminal, or a network connection being broken. There is a class of
-signals that can be sent to the process currently reading input from the
-keyboard. Since Readline changes the terminal attributes when it is
-called, it needs to perform special processing when such a signal is
-received in order to restore the terminal to a sane state, or provide
-application writers with functions to do so manually.
+exceptional events, like a user pressing the terminal's interrupt key,
+or a network connection being broken. There is a class of signals that
+can be sent to the process currently reading input from the keyboard.
+Since Readline changes the terminal attributes when it is called, it
+needs to perform special processing when such a signal is received in
+order to restore the terminal to a sane state, or provide application
+writers with functions to do so manually.
Readline contains an internal signal handler that is installed for a
number of signals ('SIGINT', 'SIGQUIT', 'SIGTERM', 'SIGHUP', 'SIGALRM',
@@ -3520,9 +3617,10 @@ File: readline.info, Node: Completion Variables, Next: A Short Completion Exam
-- Variable: int rl_completion_query_items
Up to this many items will be displayed in response to a
- possible-completions call. After that, readline asks the user if
- she is sure she wants to see them all. The default value is 100.
- A negative value indicates that Readline should never ask the user.
+ possible-completions call. After that, readline asks the user for
+ confirmation before displaying them. The default value is 100. A
+ negative value indicates that Readline should never ask for
+ confirmation.
-- Variable: int rl_completion_append_character
When a single completion alternative matches at the end of the
@@ -4633,6 +4731,10 @@ Function and Variable Index
(line 10)
* accept-line (Newline or Return): Commands For History.
(line 6)
+* active-region-end-color: Readline Init File Syntax.
+ (line 48)
+* active-region-start-color: Readline Init File Syntax.
+ (line 35)
* backward-char (C-b): Commands For Moving. (line 15)
* backward-delete-char (Rubout): Commands For Text. (line 17)
* backward-kill-line (C-x Rubout): Commands For Killing.
@@ -4644,11 +4746,11 @@ Function and Variable Index
(line 19)
* beginning-of-line (C-a): Commands For Moving. (line 6)
* bell-style: Readline Init File Syntax.
- (line 35)
+ (line 61)
* bind-tty-special-chars: Readline Init File Syntax.
- (line 42)
+ (line 68)
* blink-matching-paren: Readline Init File Syntax.
- (line 47)
+ (line 73)
* bracketed-paste-begin (): Commands For Text. (line 36)
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
* capitalize-word (M-c): Commands For Text. (line 69)
@@ -4659,25 +4761,25 @@ Function and Variable Index
* clear-display (M-C-l): Commands For Moving. (line 40)
* clear-screen (C-l): Commands For Moving. (line 45)
* colored-completion-prefix: Readline Init File Syntax.
- (line 52)
+ (line 78)
* colored-stats: Readline Init File Syntax.
- (line 59)
+ (line 88)
* comment-begin: Readline Init File Syntax.
- (line 65)
+ (line 94)
* complete (<TAB>): Commands For Completion.
(line 6)
* completion-display-width: Readline Init File Syntax.
- (line 70)
+ (line 99)
* completion-ignore-case: Readline Init File Syntax.
- (line 77)
+ (line 106)
* completion-map-case: Readline Init File Syntax.
- (line 82)
+ (line 111)
* completion-prefix-display-length: Readline Init File Syntax.
- (line 88)
+ (line 117)
* completion-query-items: Readline Init File Syntax.
- (line 95)
+ (line 124)
* convert-meta: Readline Init File Syntax.
- (line 105)
+ (line 135)
* copy-backward-word (): Commands For Killing.
(line 60)
* copy-forward-word (): Commands For Killing.
@@ -4691,7 +4793,7 @@ Function and Variable Index
(line 48)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* disable-completion: Readline Init File Syntax.
- (line 113)
+ (line 143)
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
(line 14)
* downcase-word (M-l): Commands For Text. (line 65)
@@ -4702,17 +4804,19 @@ Function and Variable Index
* dump-variables (): Miscellaneous Commands.
(line 76)
* echo-control-characters: Readline Init File Syntax.
- (line 118)
+ (line 148)
* editing-mode: Readline Init File Syntax.
- (line 123)
+ (line 153)
* emacs-editing-mode (C-e): Miscellaneous Commands.
(line 88)
* emacs-mode-string: Readline Init File Syntax.
- (line 129)
+ (line 159)
+* enable-active-region: Readline Init File Syntax.
+ (line 169)
* enable-bracketed-paste: Readline Init File Syntax.
- (line 139)
+ (line 182)
* enable-keypad: Readline Init File Syntax.
- (line 147)
+ (line 191)
* end-kbd-macro (C-x )): Keyboard Macros. (line 9)
* end-of-file (usually C-d): Commands For Text. (line 6)
* end-of-history (M->): Commands For History.
@@ -4721,36 +4825,38 @@ Function and Variable Index
* exchange-point-and-mark (C-x C-x): Miscellaneous Commands.
(line 37)
* expand-tilde: Readline Init File Syntax.
- (line 158)
+ (line 202)
+* fetch-history (): Commands For History.
+ (line 102)
* forward-backward-delete-char (): Commands For Text. (line 21)
* forward-char (C-f): Commands For Moving. (line 12)
* forward-search-history (C-s): Commands For History.
(line 32)
* forward-word (M-f): Commands For Moving. (line 18)
* history-preserve-point: Readline Init File Syntax.
- (line 162)
+ (line 206)
* history-search-backward (): Commands For History.
(line 56)
* history-search-forward (): Commands For History.
(line 50)
* history-size: Readline Init File Syntax.
- (line 168)
+ (line 212)
* history-substring-search-backward (): Commands For History.
(line 68)
* history-substring-search-forward (): Commands For History.
(line 62)
* horizontal-scroll-mode: Readline Init File Syntax.
- (line 177)
+ (line 221)
* input-meta: Readline Init File Syntax.
- (line 186)
+ (line 230)
* insert-comment (M-#): Miscellaneous Commands.
(line 61)
* insert-completions (M-*): Commands For Completion.
(line 18)
* isearch-terminators: Readline Init File Syntax.
- (line 194)
+ (line 238)
* keymap: Readline Init File Syntax.
- (line 201)
+ (line 245)
* kill-line (C-k): Commands For Killing.
(line 6)
* kill-region (): Commands For Killing.
@@ -4760,19 +4866,19 @@ Function and Variable Index
* kill-word (M-d): Commands For Killing.
(line 23)
* mark-modified-lines: Readline Init File Syntax.
- (line 231)
+ (line 275)
* mark-symlinked-directories: Readline Init File Syntax.
- (line 236)
+ (line 280)
* match-hidden-files: Readline Init File Syntax.
- (line 241)
+ (line 285)
* menu-complete (): Commands For Completion.
(line 22)
* menu-complete-backward (): Commands For Completion.
(line 34)
* menu-complete-display-prefix: Readline Init File Syntax.
- (line 248)
+ (line 292)
* meta-flag: Readline Init File Syntax.
- (line 186)
+ (line 230)
* next-history (C-n): Commands For History.
(line 16)
* next-screen-line (): Commands For Moving. (line 33)
@@ -4783,10 +4889,10 @@ Function and Variable Index
* operate-and-get-next (C-o): Commands For History.
(line 95)
* output-meta: Readline Init File Syntax.
- (line 253)
+ (line 297)
* overwrite-mode (): Commands For Text. (line 73)
* page-completions: Readline Init File Syntax.
- (line 259)
+ (line 303)
* possible-completions (M-?): Commands For Completion.
(line 11)
* prefix-meta (<ESC>): Miscellaneous Commands.
@@ -4803,27 +4909,27 @@ Function and Variable Index
* reverse-search-history (C-r): Commands For History.
(line 26)
* revert-all-at-newline: Readline Init File Syntax.
- (line 269)
+ (line 313)
* revert-line (M-r): Miscellaneous Commands.
(line 26)
* rl_activate_mark: Miscellaneous Functions.
(line 55)
* rl_add_defun: Function Naming. (line 18)
* rl_add_funmap_entry: Associating Function Names and Bindings.
- (line 54)
+ (line 62)
* rl_add_undo: Allowing Undoing. (line 39)
* rl_alphabetic: Utility Functions. (line 38)
-* rl_already_prompted: Readline Variables. (line 63)
+* rl_already_prompted: Readline Variables. (line 70)
* rl_attempted_completion_function: Completion Variables.
(line 11)
* rl_attempted_completion_over: Completion Variables.
- (line 255)
+ (line 256)
* rl_basic_quote_characters: Completion Variables.
(line 143)
* rl_basic_word_break_characters: Completion Variables.
(line 137)
* rl_begin_undo_group: Allowing Undoing. (line 28)
-* rl_binding_keymap: Readline Variables. (line 184)
+* rl_binding_keymap: Readline Variables. (line 195)
* rl_bind_key: Binding Keys. (line 21)
* rl_bind_keyseq: Binding Keys. (line 57)
* rl_bind_keyseq_if_unbound: Binding Keys. (line 75)
@@ -4866,7 +4972,7 @@ Function and Variable Index
* rl_complete_internal: Completion Functions.
(line 9)
* rl_completion_append_character: Completion Variables.
- (line 184)
+ (line 185)
* rl_completion_display_matches_hook: Completion Variables.
(line 124)
* rl_completion_entry_function: How Completing Works.
@@ -4874,11 +4980,11 @@ Function and Variable Index
* rl_completion_entry_function <1>: Completion Variables.
(line 6)
* rl_completion_found_quote: Completion Variables.
- (line 214)
+ (line 215)
* rl_completion_invoking_key: Completion Variables.
- (line 278)
+ (line 279)
* rl_completion_mark_symlink_dirs: Completion Variables.
- (line 220)
+ (line 221)
* rl_completion_matches: Completion Functions.
(line 43)
* rl_completion_mode: Completion Functions.
@@ -4886,13 +4992,13 @@ Function and Variable Index
* rl_completion_query_items: Completion Variables.
(line 178)
* rl_completion_quote_character: Completion Variables.
- (line 202)
+ (line 203)
* rl_completion_suppress_append: Completion Variables.
- (line 196)
+ (line 197)
* rl_completion_suppress_quote: Completion Variables.
- (line 208)
+ (line 209)
* rl_completion_type: Completion Variables.
- (line 270)
+ (line 271)
* rl_completion_word_break_hook: Completion Variables.
(line 151)
* rl_copy_keymap: Keymaps. (line 16)
@@ -4902,36 +5008,37 @@ Function and Variable Index
(line 62)
* rl_delete_text: Modifying Text. (line 10)
* rl_deprep_terminal: Terminal Management. (line 12)
-* rl_deprep_term_function: Readline Variables. (line 174)
+* rl_deprep_term_function: Readline Variables. (line 185)
* rl_ding: Utility Functions. (line 35)
* rl_directory_completion_hook: Completion Variables.
(line 63)
* rl_directory_rewrite_hook;: Completion Variables.
(line 81)
* rl_discard_keymap: Keymaps. (line 25)
-* rl_dispatching: Readline Variables. (line 40)
+* rl_dispatching: Readline Variables. (line 47)
* rl_display_match_list: Utility Functions. (line 41)
-* rl_display_prompt: Readline Variables. (line 58)
+* rl_display_prompt: Readline Variables. (line 65)
* rl_done: Readline Variables. (line 27)
* rl_do_undo: Allowing Undoing. (line 47)
* rl_echo_signal_char: Readline Signal Handling.
(line 143)
-* rl_editing_mode: Readline Variables. (line 281)
+* rl_editing_mode: Readline Variables. (line 301)
* rl_empty_keymap: Keymaps. (line 33)
* rl_end: Readline Variables. (line 18)
* rl_end_undo_group: Allowing Undoing. (line 34)
-* rl_erase_empty_line: Readline Variables. (line 46)
-* rl_event_hook: Readline Variables. (line 123)
+* rl_eof_found: Readline Variables. (line 33)
+* rl_erase_empty_line: Readline Variables. (line 53)
+* rl_event_hook: Readline Variables. (line 130)
* rl_execute_next: Character Input. (line 25)
-* rl_executing_key: Readline Variables. (line 191)
-* rl_executing_keymap: Readline Variables. (line 180)
-* rl_executing_keyseq: Readline Variables. (line 195)
-* rl_executing_macro: Readline Variables. (line 188)
+* rl_executing_key: Readline Variables. (line 202)
+* rl_executing_keymap: Readline Variables. (line 191)
+* rl_executing_keyseq: Readline Variables. (line 206)
+* rl_executing_macro: Readline Variables. (line 199)
* rl_expand_prompt: Redisplay. (line 66)
-* rl_explicit_arg: Readline Variables. (line 272)
+* rl_explicit_arg: Readline Variables. (line 292)
* rl_extend_line_buffer: Utility Functions. (line 26)
* rl_filename_completion_desired: Completion Variables.
- (line 235)
+ (line 236)
* rl_filename_completion_function: Completion Functions.
(line 57)
* rl_filename_dequoting_function: Completion Variables.
@@ -4939,7 +5046,7 @@ Function and Variable Index
* rl_filename_quote_characters: Completion Variables.
(line 166)
* rl_filename_quoting_desired: Completion Variables.
- (line 245)
+ (line 246)
* rl_filename_quoting_function: Completion Variables.
(line 23)
* rl_filename_rewrite_hook: Completion Variables.
@@ -4953,16 +5060,16 @@ Function and Variable Index
(line 113)
* rl_free_undo_list: Allowing Undoing. (line 44)
* rl_function_dumper: Associating Function Names and Bindings.
- (line 38)
+ (line 46)
* rl_function_of_keyseq: Associating Function Names and Bindings.
(line 13)
* rl_function_of_keyseq_len: Associating Function Names and Bindings.
(line 22)
* rl_funmap_names: Associating Function Names and Bindings.
- (line 48)
+ (line 56)
* rl_generic_bind: Binding Keys. (line 87)
* rl_getc: Character Input. (line 14)
-* rl_getc_function: Readline Variables. (line 128)
+* rl_getc_function: Readline Variables. (line 135)
* rl_get_keymap: Keymaps. (line 40)
* rl_get_keymap_by_name: Keymaps. (line 46)
* rl_get_keymap_name: Keymaps. (line 51)
@@ -4970,32 +5077,32 @@ Function and Variable Index
(line 165)
* rl_get_termcap: Miscellaneous Functions.
(line 41)
-* rl_gnu_readline_p: Readline Variables. (line 82)
+* rl_gnu_readline_p: Readline Variables. (line 89)
* rl_ignore_completion_duplicates: Completion Variables.
- (line 231)
+ (line 232)
* rl_ignore_some_completions_function: Completion Variables.
(line 55)
* rl_inhibit_completion: Completion Variables.
- (line 284)
+ (line 285)
* rl_initialize: Utility Functions. (line 30)
-* rl_input_available_hook: Readline Variables. (line 140)
+* rl_input_available_hook: Readline Variables. (line 151)
* rl_insert_completions: Completion Functions.
(line 31)
* rl_insert_text: Modifying Text. (line 6)
-* rl_instream: Readline Variables. (line 96)
+* rl_instream: Readline Variables. (line 103)
* rl_invoking_keyseqs: Associating Function Names and Bindings.
- (line 29)
+ (line 37)
* rl_invoking_keyseqs_in_map: Associating Function Names and Bindings.
- (line 33)
+ (line 41)
* rl_keep_mark_active: Miscellaneous Functions.
(line 65)
-* rl_key_sequence_length: Readline Variables. (line 199)
+* rl_key_sequence_length: Readline Variables. (line 210)
* rl_kill_text: Modifying Text. (line 18)
-* rl_last_func: Readline Variables. (line 109)
-* rl_library_version: Readline Variables. (line 72)
+* rl_last_func: Readline Variables. (line 116)
+* rl_library_version: Readline Variables. (line 79)
* rl_line_buffer: Readline Variables. (line 8)
* rl_list_funmap_names: Associating Function Names and Bindings.
- (line 44)
+ (line 52)
* rl_macro_bind: Miscellaneous Functions.
(line 6)
* rl_macro_dumper: Miscellaneous Functions.
@@ -5009,13 +5116,13 @@ Function and Variable Index
* rl_modifying: Allowing Undoing. (line 56)
* rl_named_function: Associating Function Names and Bindings.
(line 10)
-* rl_numeric_arg: Readline Variables. (line 276)
-* rl_num_chars_to_read: Readline Variables. (line 31)
+* rl_numeric_arg: Readline Variables. (line 296)
+* rl_num_chars_to_read: Readline Variables. (line 38)
* rl_on_new_line: Redisplay. (line 14)
* rl_on_new_line_with_prompt: Redisplay. (line 18)
-* rl_outstream: Readline Variables. (line 100)
+* rl_outstream: Readline Variables. (line 107)
* rl_parse_and_bind: Binding Keys. (line 95)
-* rl_pending_input: Readline Variables. (line 36)
+* rl_pending_input: Readline Variables. (line 43)
* rl_pending_signal: Readline Signal Handling.
(line 102)
* rl_persistent_signal_handlers: Readline Signal Handling.
@@ -5023,19 +5130,19 @@ Function and Variable Index
* rl_point: Readline Variables. (line 14)
* rl_possible_completions: Completion Functions.
(line 27)
-* rl_prefer_env_winsize: Readline Variables. (line 104)
+* rl_prefer_env_winsize: Readline Variables. (line 111)
* rl_prep_terminal: Terminal Management. (line 6)
-* rl_prep_term_function: Readline Variables. (line 167)
-* rl_pre_input_hook: Readline Variables. (line 118)
-* rl_prompt: Readline Variables. (line 52)
+* rl_prep_term_function: Readline Variables. (line 178)
+* rl_pre_input_hook: Readline Variables. (line 125)
+* rl_prompt: Readline Variables. (line 59)
* rl_push_macro_input: Modifying Text. (line 25)
-* rl_readline_name: Readline Variables. (line 91)
-* rl_readline_state: Readline Variables. (line 202)
-* rl_readline_version: Readline Variables. (line 75)
+* rl_readline_name: Readline Variables. (line 98)
+* rl_readline_state: Readline Variables. (line 213)
+* rl_readline_version: Readline Variables. (line 82)
* rl_read_init_file: Binding Keys. (line 100)
* rl_read_key: Character Input. (line 6)
* rl_redisplay: Redisplay. (line 6)
-* rl_redisplay_function: Readline Variables. (line 161)
+* rl_redisplay_function: Readline Variables. (line 172)
* rl_replace_line: Utility Functions. (line 21)
* rl_reset_after_signal: Readline Signal Handling.
(line 121)
@@ -5060,15 +5167,20 @@ Function and Variable Index
(line 153)
* rl_set_signals: Readline Signal Handling.
(line 176)
+* rl_set_timeout: Character Input. (line 42)
* rl_show_char: Redisplay. (line 36)
-* rl_signal_event_hook: Readline Variables. (line 136)
+* rl_signal_event_hook: Readline Variables. (line 143)
* rl_sort_completion_matches: Completion Variables.
- (line 262)
+ (line 263)
* rl_special_prefixes: Completion Variables.
(line 171)
-* rl_startup_hook: Readline Variables. (line 114)
+* rl_startup_hook: Readline Variables. (line 121)
* rl_stuff_char: Character Input. (line 18)
-* rl_terminal_name: Readline Variables. (line 86)
+* rl_terminal_name: Readline Variables. (line 93)
+* rl_timeout_event_hook: Readline Variables. (line 147)
+* rl_timeout_remaining: Character Input. (line 52)
+* rl_trim_arg_from_keyseq: Associating Function Names and Bindings.
+ (line 29)
* rl_tty_set_default_bindings: Terminal Management. (line 17)
* rl_tty_set_echoing: Terminal Management. (line 27)
* rl_tty_unset_default_bindings: Terminal Management. (line 22)
@@ -5090,13 +5202,13 @@ Function and Variable Index
* shell-transpose-words (M-C-t): Commands For Killing.
(line 32)
* show-all-if-ambiguous: Readline Init File Syntax.
- (line 275)
+ (line 319)
* show-all-if-unmodified: Readline Init File Syntax.
- (line 281)
+ (line 325)
* show-mode-in-prompt: Readline Init File Syntax.
- (line 290)
+ (line 334)
* skip-completed-text: Readline Init File Syntax.
- (line 296)
+ (line 340)
* skip-csi-sequence (): Miscellaneous Commands.
(line 52)
* start-kbd-macro (C-x (): Keyboard Macros. (line 6)
@@ -5116,13 +5228,13 @@ Function and Variable Index
(line 39)
* upcase-word (M-u): Commands For Text. (line 61)
* vi-cmd-mode-string: Readline Init File Syntax.
- (line 309)
+ (line 353)
* vi-editing-mode (M-C-j): Miscellaneous Commands.
(line 92)
* vi-ins-mode-string: Readline Init File Syntax.
- (line 320)
+ (line 364)
* visible-stats: Readline Init File Syntax.
- (line 331)
+ (line 375)
* yank (C-y): Commands For Killing.
(line 70)
* yank-last-arg (M-. or M-_): Commands For History.
@@ -5135,59 +5247,59 @@ Function and Variable Index

Tag Table:
-Node: Top864
-Node: Command Line Editing1589
-Node: Introduction and Notation2241
-Node: Readline Interaction3865
-Node: Readline Bare Essentials5057
-Node: Readline Movement Commands6841
-Node: Readline Killing Commands7802
-Node: Readline Arguments9721
-Node: Searching10766
-Node: Readline Init File12919
+Node: Top862
+Node: Command Line Editing1587
+Node: Introduction and Notation2239
+Node: Readline Interaction3863
+Node: Readline Bare Essentials5055
+Node: Readline Movement Commands6839
+Node: Readline Killing Commands7800
+Node: Readline Arguments9719
+Node: Searching10764
+Node: Readline Init File12917
Node: Readline Init File Syntax14073
-Node: Conditional Init Constructs34331
-Node: Sample Init File38528
-Node: Bindable Readline Commands41653
-Node: Commands For Moving42708
-Node: Commands For History44467
-Node: Commands For Text49230
-Node: Commands For Killing52933
-Node: Numeric Arguments55647
-Node: Commands For Completion56787
-Node: Keyboard Macros58756
-Node: Miscellaneous Commands59444
-Node: Readline vi Mode63366
-Node: Programming with GNU Readline65183
-Node: Basic Behavior66169
-Node: Custom Functions69852
-Node: Readline Typedefs71335
-Node: Function Writing72969
-Node: Readline Variables74283
-Node: Readline Convenience Functions86955
-Node: Function Naming88027
-Node: Keymaps89289
-Node: Binding Keys92368
-Node: Associating Function Names and Bindings96916
-Node: Allowing Undoing99695
-Node: Redisplay102245
-Node: Modifying Text106269
-Node: Character Input107516
-Node: Terminal Management109414
-Node: Utility Functions111237
-Node: Miscellaneous Functions114565
-Node: Alternate Interface117984
-Node: A Readline Example120726
-Node: Alternate Interface Example122665
-Node: Readline Signal Handling126197
-Node: Custom Completers135456
-Node: How Completing Works136176
-Node: Completion Functions139483
-Node: Completion Variables143057
-Node: A Short Completion Example158850
-Node: GNU Free Documentation License171630
-Node: Concept Index196804
-Node: Function and Variable Index198325
+Node: Conditional Init Constructs36992
+Node: Sample Init File41189
+Node: Bindable Readline Commands44314
+Node: Commands For Moving45369
+Node: Commands For History47128
+Node: Commands For Text52092
+Node: Commands For Killing55795
+Node: Numeric Arguments58509
+Node: Commands For Completion59649
+Node: Keyboard Macros61618
+Node: Miscellaneous Commands62306
+Node: Readline vi Mode66228
+Node: Programming with GNU Readline68045
+Node: Basic Behavior69031
+Node: Custom Functions72714
+Node: Readline Typedefs74197
+Node: Function Writing75831
+Node: Readline Variables77145
+Node: Readline Convenience Functions90820
+Node: Function Naming91892
+Node: Keymaps93154
+Node: Binding Keys96233
+Node: Associating Function Names and Bindings100781
+Node: Allowing Undoing104011
+Node: Redisplay106561
+Node: Modifying Text110620
+Node: Character Input111867
+Node: Terminal Management114947
+Node: Utility Functions116770
+Node: Miscellaneous Functions120098
+Node: Alternate Interface123517
+Node: A Readline Example126259
+Node: Alternate Interface Example128198
+Node: Readline Signal Handling131730
+Node: Custom Completers140983
+Node: How Completing Works141703
+Node: Completion Functions145010
+Node: Completion Variables148584
+Node: A Short Completion Example164390
+Node: GNU Free Documentation License177170
+Node: Concept Index202344
+Node: Function and Variable Index203865

End Tag Table