library - get a line from a user with editing. Release candidate.
| readline.3 (readline-7.0-rc1) | : | readline.3 (readline-7.0-rc2) |
|---|
| | |
| skipping to change at line 188 | | skipping to change at line 188 |
|---|
| value are replaced with an ellipsis when displaying possible compl
etions. | | value are replaced with an ellipsis when displaying possible compl
etions. |
| completion-query-items (100) | | completion-query-items (100) |
| This determines when the user is queried about viewing the number
of possible completions gener- | | This determines when the user is queried about viewing the number
of possible completions gener- |
| ated by the possible-completions command. It may be set to any in
teger value greater than or | | ated by the possible-completions command. It may be set to any in
teger value greater than or |
| equal to zero. If the number of possible completions is greate
r than or equal to the value of | | equal to zero. If the number of possible completions is greate
r than or equal to the value of |
| this variable, the user is asked whether or not he wishes to view
them; otherwise they are simply | | this variable, the user is asked whether or not he wishes to view
them; otherwise they are simply |
| listed on the terminal. A negative value causes readline to never
ask. | | listed on the terminal. A negative value causes readline to never
ask. |
| convert-meta (On) | | convert-meta (On) |
| If set to On, readline will convert characters with the eighth b
it set to an ASCII key sequence | | If set to On, readline will convert characters with the eighth b
it set to an ASCII key sequence |
| by stripping the eighth bit and prefixing it with an escape charac
ter (in effect, using escape as | | by stripping the eighth bit and prefixing it with an escape charac
ter (in effect, using escape as |
|
| the meta prefix). | | the meta prefix). The default is On, but readline will set i |
| | t to Off if the locale contains |
| | eight-bit characters. |
| disable-completion (Off) | | disable-completion (Off) |
| If set to On, readline will inhibit word completion. Completion c
haracters will be inserted into | | If set to On, readline will inhibit word completion. Completion c
haracters will be inserted into |
| the line as if they had been mapped to self-insert. | | the line as if they had been mapped to self-insert. |
|
| editing-mode (emacs) | | |
| Controls whether readline begins with a set of key bindings simila | | |
| r to Emacs or vi. editing-mode | | |
| can be set to either emacs or vi. | | |
| echo-control-characters (On) | | echo-control-characters (On) |
| When set to On, on operating systems that indicate they support
it, readline echoes a character | | When set to On, on operating systems that indicate they support
it, readline echoes a character |
| corresponding to a signal generated from the keyboard. | | corresponding to a signal generated from the keyboard. |
|
| | editing-mode (emacs) |
| | Controls whether readline begins with a set of key bindings simila |
| | r to Emacs or vi. editing-mode |
| | can be set to either emacs or vi. |
| enable-bracketed-paste (Off) | | enable-bracketed-paste (Off) |
|
| When set to On, readline will configure the terminal in a way that | | When set to On, readline will configure the terminal in a way tha |
| will enable it to insert each | | t will enable it to insert each |
| paste into the editing buffer as a single string of characters, i | | paste into the editing buffer as a single string of characters, in |
| nstead of treating each charac- | | stead of treating each charac- |
| ter as if it had been read from the keyboard. This can prevent | | ter as if it had been read from the keyboard. This can preve |
| pasted characters from being | | nt pasted characters from being |
| interpreted as editing commands. | | interpreted as editing commands. |
| enable-keypad (Off) | | enable-keypad (Off) |
|
| When set to On, readline will try to enable the application keypa
d when it is called. Some sys- | | When set to On, readline will try to enable the application keypad
when it is called. Some sys- |
| tems need this to enable the arrow keys. | | tems need this to enable the arrow keys. |
| enable-meta-key (On) | | enable-meta-key (On) |
|
| When set to On, readline will try to enable any meta modifier key
the terminal claims to support | | When set to On, readline will try to enable any meta modifier key
the terminal claims to support |
| when it is called. On many terminals, the meta key is used to sen
d eight-bit characters. | | when it is called. On many terminals, the meta key is used to sen
d eight-bit characters. |
| expand-tilde (Off) | | expand-tilde (Off) |
| If set to On, tilde expansion is performed when readline attempts
word completion. | | If set to On, tilde expansion is performed when readline attempts
word completion. |
| history-preserve-point (Off) | | history-preserve-point (Off) |
|
| If set to On, the history code attempts to place point at the sam
e location on each history line | | If set to On, the history code attempts to place point at the same
location on each history line |
| retrieved with previous-history or next-history. | | retrieved with previous-history or next-history. |
| history-size (unset) | | history-size (unset) |
|
| Set the maximum number of history entries saved in the history lis | | Set the maximum number of history entries saved in the history li |
| t. If set to zero, any exist- | | st. If set to zero, any exist- |
| ing history entries are deleted and no new entries are saved. If | | ing history entries are deleted and no new entries are saved. If |
| set to a value less than zero, | | set to a value less than zero, |
| the number of history entries is not limited. By default, the num | | the number of history entries is not limited. By default, the n |
| ber of history entries is not | | umber of history entries is not |
| limited. | | limited. If an attempt is made to set history-size to a non-numer |
| | ic value, the maximum number of |
| | history entries will be set to 500. |
| horizontal-scroll-mode (Off) | | horizontal-scroll-mode (Off) |
| When set to On, makes readline use a single line for display, scro
lling the input horizontally on | | When set to On, makes readline use a single line for display, scro
lling the input horizontally on |
| a single screen line when it becomes longer than the screen width
rather than wrapping to a new | | a single screen line when it becomes longer than the screen width
rather than wrapping to a new |
| line. | | line. |
| input-meta (Off) | | input-meta (Off) |
| If set to On, readline will enable eight-bit input (that is, it w
ill not clear the eighth bit in | | If set to On, readline will enable eight-bit input (that is, it w
ill not clear the eighth bit in |
| the characters it reads), regardless of what the terminal claims
it can support. The name | | the characters it reads), regardless of what the terminal claims
it can support. The name |
|
| meta-flag is a synonym for this variable. | | meta-flag is a synonym for this variable. The default is Off, bu |
| | t readline will set it to On if |
| | the locale contains eight-bit characters. |
| isearch-terminators (``C-[ C-J'') | | isearch-terminators (``C-[ C-J'') |
| The string of characters that should terminate an incremental sear
ch without subsequently execut- | | The string of characters that should terminate an incremental sear
ch without subsequently execut- |
|
| ing the character as a command. If this variable has not been giv
en a value, the characters ESC | | ing the character as a command. If this variable has not been gi
ven a value, the characters ESC |
| and C-J will terminate an incremental search. | | and C-J will terminate an incremental search. |
| keymap (emacs) | | keymap (emacs) |
|
| Set the current readline keymap. The set of legal keymap names i | | Set the current readline keymap. The set of legal keymap names is |
| s emacs, emacs-standard, emacs- | | emacs, emacs-standard, emacs- |
| meta, emacs-ctlx, vi, vi-move, vi-command, and vi-insert. vi is e | | meta, emacs-ctlx, vi, vi-move, vi-command, and vi-insert. vi is |
| quivalent to vi-command; emacs | | equivalent to vi-command; emacs |
| is equivalent to emacs-standard. The default value is emacs. | | is equivalent to emacs-standard. The default value is emacs. The |
| The value of editing-mode also | | value of editing-mode also |
| affects the default keymap. | | affects the default keymap. |
| emacs-mode-string (@) | | emacs-mode-string (@) |
|
| This string is displayed immediately before the last line of the p | | This string is displayed immediately before the last line of the |
| rimary prompt when emacs edit- | | primary prompt when emacs edit- |
| ing mode is active. The value is expanded like a key binding, s | | ing mode is active. The value is expanded like a key binding, so |
| o the standard set of meta- and | | the standard set of meta- and |
| control prefixes and backslash escape sequences is available. Use
the \1 and \2 escapes to begin | | control prefixes and backslash escape sequences is available. Use
the \1 and \2 escapes to begin |
|
| and end sequences of non-printing characters, which can be u
sed to embed a terminal control | | and end sequences of non-printing characters, which can be used
to embed a terminal control |
| sequence into the mode string. | | sequence into the mode string. |
| keyseq-timeout (500) | | keyseq-timeout (500) |
|
| Specifies the duration readline will wait for a character when rea | | Specifies the duration readline will wait for a character when re |
| ding an ambiguous key sequence | | ading an ambiguous key sequence |
| (one that can form a complete key sequence using the input read | | (one that can form a complete key sequence using the input read so |
| so far, or can take additional | | far, or can take additional |
| input to complete a longer key sequence). If no input is received | | input to complete a longer key sequence). If no input is receiv |
| within the timeout, readline | | ed within the timeout, readline |
| will use the shorter but complete key sequence. The value is | | will use the shorter but complete key sequence. The value is spec |
| specified in milliseconds, so a | | ified in milliseconds, so a |
| value of 1000 means that readline will wait one second for additio
nal input. If this variable is | | value of 1000 means that readline will wait one second for additio
nal input. If this variable is |
|
| set to a value less than or equal to zero, or to a non-numeric
value, readline will wait until | | set to a value less than or equal to zero, or to a non-numeric val
ue, readline will wait until |
| another key is pressed to decide which key sequence to complete. | | another key is pressed to decide which key sequence to complete. |
| mark-directories (On) | | mark-directories (On) |
| If set to On, completed directory names have a slash appended. | | If set to On, completed directory names have a slash appended. |
| mark-modified-lines (Off) | | mark-modified-lines (Off) |
| If set to On, history lines that have been modified are displayed
with a preceding asterisk (*). | | If set to On, history lines that have been modified are displayed
with a preceding asterisk (*). |
| mark-symlinked-directories (Off) | | mark-symlinked-directories (Off) |
| If set to On, completed names which are symbolic links to director
ies have a slash appended (sub- | | If set to On, completed names which are symbolic links to director
ies have a slash appended (sub- |
| ject to the value of mark-directories). | | ject to the value of mark-directories). |
| match-hidden-files (On) | | match-hidden-files (On) |
|
| This variable, when set to On, causes readline to match files who | | This variable, when set to On, causes readline to match files whos |
| se names begin with a `.' (hid- | | e names begin with a `.' (hid- |
| den files) when performing filename completion. If set to Off, th | | den files) when performing filename completion. If set to Off, t |
| e leading `.' must be supplied | | he leading `.' must be supplied |
| by the user in the filename to be completed. | | by the user in the filename to be completed. |
| menu-complete-display-prefix (Off) | | menu-complete-display-prefix (Off) |
|
| If set to On, menu completion displays the common prefix of t
he list of possible completions | | If set to On, menu completion displays the common prefix of the
list of possible completions |
| (which may be empty) before cycling through the list. | | (which may be empty) before cycling through the list. |
| output-meta (Off) | | output-meta (Off) |
|
| If set to On, readline will display characters with the eighth bit | | If set to On, readline will display characters with the eighth bi |
| set directly rather than as a | | t set directly rather than as a |
| meta-prefixed escape sequence. | | meta-prefixed escape sequence. The default is Off, but readline w |
| | ill set it to On if the locale |
| | contains eight-bit characters. |
| page-completions (On) | | page-completions (On) |
| If set to On, readline uses an internal more-like pager to displ
ay a screenful of possible com- | | If set to On, readline uses an internal more-like pager to displ
ay a screenful of possible com- |
| pletions at a time. | | pletions at a time. |
| print-completions-horizontally (Off) | | print-completions-horizontally (Off) |
| If set to On, readline will display completions with matches sorte
d horizontally in alphabetical | | If set to On, readline will display completions with matches sorte
d horizontally in alphabetical |
| order, rather than down the screen. | | order, rather than down the screen. |
| revert-all-at-newline (Off) | | revert-all-at-newline (Off) |
| If set to On, readline will undo all changes to history lines be
fore returning when accept-line | | If set to On, readline will undo all changes to history lines be
fore returning when accept-line |
| is executed. By default, history lines may be modified and retain
individual undo lists across | | is executed. By default, history lines may be modified and retain
individual undo lists across |
| calls to readline. | | calls to readline. |
| | |
| skipping to change at line 889 | | skipping to change at line 893 |
|---|
| | |
| Once you have determined that a bug actually exists, mail a bug report to
bug-readline@gnu.org. If you | | Once you have determined that a bug actually exists, mail a bug report to
bug-readline@gnu.org. If you |
| have a fix, you are welcome to mail that as well! Suggestions and `ph
ilosophical' bug reports may be | | have a fix, you are welcome to mail that as well! Suggestions and `ph
ilosophical' bug reports may be |
| mailed to bug-readline@gnu.org or posted to the Usenet newsgroup gnu.bash
.bug. | | mailed to bug-readline@gnu.org or posted to the Usenet newsgroup gnu.bash
.bug. |
| | |
| Comments and bug reports concerning this manual page should be directed t
o chet.ramey@case.edu. | | Comments and bug reports concerning this manual page should be directed t
o chet.ramey@case.edu. |
| | |
| BUGS | | BUGS |
| It's too big and too slow. | | It's too big and too slow. |
| | |
|
| GNU Readline 6.3 2014 November 19
READLINE(3) | | GNU Readline 7.0 2016 February 28
READLINE(3) |
| | | |
| End of changes. 19 change blocks. |
|---|
| 51 lines changed or deleted | | 59 lines changed or added |
|---|
"Fossies" - the Fresh Open Source Software Archive 