"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/readline.3" between
readline-7.0-rc1.tar.gz and readline-7.0-rc2.tar.gz

About: GNU Readline 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

Home  |  About  |  All  |  Newest  |  Fossies Dox  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTPS