pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-06-29 00:19:51 +02:00
Code Issues Packages Projects Releases Wiki Activity

modify readline so it adjusts internal variables when the locale changes between calls to readline()

Browse Source
This commit is contained in:
Chet Ramey
2022-08-15 12:32:00 -04:00
parent 0142068628
commit b9ed20acfd
24 changed files with 4908 additions and 4758 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+30
View File
@@ -3858,3 +3858,33 @@ trap.c
we can restore the value of running_trap. Otherwise, if we longjmp
past this function, we will think we're running a trap after we
finish. Prompted by post from Koichi Murase <myoga.murase@gmail.com>
8/9
---
lib/readline/nls.c
- _rl_current_locale: private variable, stores the value of the
LC_CTYPE locale category, as determined by _rl_init_locale; set
to allocated memory in _rl_init_locale()
- _rl_set_localevars: new function, code from _rl_init_eightbit that
checks the current locale (passed as an argument) and sets the
various locale-aware variables based on it. It accepts a second
argument: FORCE. If non-zero, it means to restore the default "C"
locale values if the locale is "C" or "POSIX", now that this
function can be called multiple times
- _rl_init_eightbit: now just calls _rl_init_locale and
_rl_set_localevars
- _rl_reset_locale: new function, checks whether our the locale has
changed since we last called _rl_init_locale to set our internal
idea of its value. If it has changed, call _rl_set_localevars with
the new locale and a FORCE argument of 1 to change the
locale-dependent variables.
lib/readline/rlprivate.h
- _rl_reset_locale: extern declaration
lib/readline/readline.c
- rl_initialize: call _rl_reset_locale instead of _rl_init_locale so
the internal readline variables get set when we move from a non-
multibyte locale ("C") to a multibyte one ("en_US.UTF-8"). Report
from Alan Coopersmith <alan.coopersmith@oracle.com>
doc/bash.0
+1441 -1436
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+6
View File
@@ -6063,6 +6063,8 @@ by stripping the eighth bit and prefixing an
escape character (in effect, using escape as the \fImeta prefix\fP).
The default is \fIOn\fP, but readline will set it to \fIOff\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B disable\-completion (Off)
If set to \fBOn\fP, readline will inhibit word completion. Completion
@@ -6157,6 +6159,8 @@ regardless of what the terminal claims it can support. The name
is a synonym for this variable.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B isearch\-terminators (``C\-[C\-J'')
The string of characters that should terminate an incremental
@@ -6220,6 +6224,8 @@ eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B page\-completions (On)
If set to \fBOn\fP, readline uses an internal \fImore\fP-like pager
doc/bash.html
+8 -2
View File
@@ -7706,6 +7706,8 @@ by stripping the eighth bit and prefixing an
escape character (in effect, using escape as the <I>meta prefix</I>).
The default is <I>On</I>, but readline will set it to <I>Off</I> if the
locale contains eight-bit characters.
This variable is dependent on the <B>LC_CTYPE</B> locale category, and
may change if the locale is changed.
<DT><B>disable-completion (Off)</B>
<DD>
@@ -7817,6 +7819,8 @@ regardless of what the terminal claims it can support. The name
is a synonym for this variable.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
This variable is dependent on the <B>LC_CTYPE</B> locale category, and
may change if the locale is changed.
<DT><B>isearch-terminators (``C-[C-J'')</B>
<DD>
@@ -7892,6 +7896,8 @@ eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
This variable is dependent on the <B>LC_CTYPE</B> locale category, and
may change if the locale is changed.
<DT><B>page-completions (On)</B>
<DD>
@@ -14887,7 +14893,7 @@ There may be only one active coprocess at a time.
<DT><A HREF="#lbDI">BUGS</A><DD>
</DL>
<HR>
This document was created by man2html from /usr/local/src/bash/bash-20220727/doc/bash.1.<BR>
Time: 29 July 2022 09:05:42 EDT
This document was created by man2html from /usr/local/src/bash/bash-20220811/doc/bash.1.<BR>
Time: 12 August 2022 11:28:52 EDT
</BODY>
</HTML>
doc/bash.info
+79 -73
View File
@@ -8158,7 +8158,9 @@ Variable Settings
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
eight-bit characters. This variable is dependent on the
'LC_CTYPE' locale category, and may change if the locale is
changed.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
@@ -8253,7 +8255,9 @@ Variable Settings
regardless of what the terminal claims it can support. The
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'meta-flag' is a synonym for this variable. This variable is
dependent on the 'LC_CTYPE' locale category, and may change if
the locale is changed.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -8318,7 +8322,9 @@ Variable Settings
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'on' if the locale contains eight-bit characters. This
variable is dependent on the 'LC_CTYPE' locale category, and
may change if the locale is changed.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -8415,7 +8421,7 @@ Key Bindings
string that is inserted when the key is pressed (a MACRO).
The 'bind -p' command displays Readline function names and bindings
in a format that can put directly into an initialization file.
in a format that can be put directly into an initialization file.
*Note Bash Builtins::.
KEYNAME: FUNCTION-NAME or MACRO
@@ -12000,27 +12006,27 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 260)
* DIRSTACK: Bash Variables. (line 264)
* disable-completion: Readline Init File Syntax.
(line 146)
(line 148)
* echo-control-characters: Readline Init File Syntax.
(line 151)
(line 153)
* editing-mode: Readline Init File Syntax.
(line 156)
(line 158)
* EMACS: Bash Variables. (line 274)
* emacs-mode-string: Readline Init File Syntax.
(line 162)
(line 164)
* enable-active-region: Readline Init File Syntax.
(line 172)
(line 174)
* enable-bracketed-paste: Readline Init File Syntax.
(line 185)
(line 187)
* enable-keypad: Readline Init File Syntax.
(line 194)
(line 196)
* ENV: Bash Variables. (line 279)
* EPOCHREALTIME: Bash Variables. (line 284)
* EPOCHSECONDS: Bash Variables. (line 292)
* EUID: Bash Variables. (line 299)
* EXECIGNORE: Bash Variables. (line 303)
* expand-tilde: Readline Init File Syntax.
(line 205)
(line 207)
* FCEDIT: Bash Variables. (line 316)
* FIGNORE: Bash Variables. (line 320)
* FUNCNAME: Bash Variables. (line 326)
@@ -12034,15 +12040,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 402)
* HISTIGNORE: Bash Variables. (line 413)
* history-preserve-point: Readline Init File Syntax.
(line 209)
(line 211)
* history-size: Readline Init File Syntax.
(line 215)
(line 217)
* HISTSIZE: Bash Variables. (line 433)
* HISTTIMEFORMAT: Bash Variables. (line 440)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 224)
(line 226)
* HOSTFILE: Bash Variables. (line 448)
* HOSTNAME: Bash Variables. (line 459)
* HOSTTYPE: Bash Variables. (line 462)
@@ -12050,13 +12056,13 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 465)
* input-meta: Readline Init File Syntax.
(line 233)
(line 235)
* INPUTRC: Bash Variables. (line 475)
* INSIDE_EMACS: Bash Variables. (line 479)
* isearch-terminators: Readline Init File Syntax.
(line 241)
(line 245)
* keymap: Readline Init File Syntax.
(line 248)
(line 252)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 485)
@@ -12078,15 +12084,15 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 540)
* mark-modified-lines: Readline Init File Syntax.
(line 278)
(line 282)
* mark-symlinked-directories: Readline Init File Syntax.
(line 283)
(line 287)
* match-hidden-files: Readline Init File Syntax.
(line 288)
(line 292)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 295)
(line 299)
* meta-flag: Readline Init File Syntax.
(line 233)
(line 235)
* OLDPWD: Bash Variables. (line 544)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -12095,9 +12101,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 551)
* output-meta: Readline Init File Syntax.
(line 300)
(line 304)
* page-completions: Readline Init File Syntax.
(line 306)
(line 312)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 554)
@@ -12120,19 +12126,19 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 626)
* REPLY: Bash Variables. (line 630)
* revert-all-at-newline: Readline Init File Syntax.
(line 316)
(line 322)
* SECONDS: Bash Variables. (line 633)
* SHELL: Bash Variables. (line 642)
* SHELLOPTS: Bash Variables. (line 647)
* SHLVL: Bash Variables. (line 656)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 322)
* show-all-if-unmodified: Readline Init File Syntax.
(line 328)
* show-all-if-unmodified: Readline Init File Syntax.
(line 334)
* show-mode-in-prompt: Readline Init File Syntax.
(line 337)
* skip-completed-text: Readline Init File Syntax.
(line 343)
* skip-completed-text: Readline Init File Syntax.
(line 349)
* SRANDOM: Bash Variables. (line 661)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
@@ -12143,11 +12149,11 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 720)
* UID: Bash Variables. (line 724)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 356)
(line 362)
* vi-ins-mode-string: Readline Init File Syntax.
(line 367)
(line 373)
* visible-stats: Readline Init File Syntax.
(line 378)
(line 384)

File: bash.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -12618,46 +12624,46 @@ Node: Readline Arguments341749
Node: Searching342790
Node: Readline Init File344973
Node: Readline Init File Syntax346231
Node: Conditional Init Constructs369427
Node: Sample Init File373620
Node: Bindable Readline Commands376741
Node: Commands For Moving377942
Node: Commands For History379990
Node: Commands For Text384981
Node: Commands For Killing388627
Node: Numeric Arguments391657
Node: Commands For Completion392793
Node: Keyboard Macros396981
Node: Miscellaneous Commands397665
Node: Readline vi Mode403601
Node: Programmable Completion404505
Node: Programmable Completion Builtins412282
Node: A Programmable Completion Example423031
Node: Using History Interactively428275
Node: Bash History Facilities428956
Node: Bash History Builtins431958
Node: History Interaction436963
Node: Event Designators440580
Node: Word Designators441931
Node: Modifiers443688
Node: Installing Bash445496
Node: Basic Installation446630
Node: Compilers and Options450349
Node: Compiling For Multiple Architectures451087
Node: Installation Names452777
Node: Specifying the System Type454883
Node: Sharing Defaults455596
Node: Operation Controls456266
Node: Optional Features457221
Node: Reporting Bugs468437
Node: Major Differences From The Bourne Shell469709
Node: GNU Free Documentation License486556
Node: Indexes511730
Node: Builtin Index512181
Node: Reserved Word Index519005
Node: Variable Index521450
Node: Function Index538221
Node: Concept Index552002
Node: Conditional Init Constructs369802
Node: Sample Init File373995
Node: Bindable Readline Commands377116
Node: Commands For Moving378317
Node: Commands For History380365
Node: Commands For Text385356
Node: Commands For Killing389002
Node: Numeric Arguments392032
Node: Commands For Completion393168
Node: Keyboard Macros397356
Node: Miscellaneous Commands398040
Node: Readline vi Mode403976
Node: Programmable Completion404880
Node: Programmable Completion Builtins412657
Node: A Programmable Completion Example423406
Node: Using History Interactively428650
Node: Bash History Facilities429331
Node: Bash History Builtins432333
Node: History Interaction437338
Node: Event Designators440955
Node: Word Designators442306
Node: Modifiers444063
Node: Installing Bash445871
Node: Basic Installation447005
Node: Compilers and Options450724
Node: Compiling For Multiple Architectures451462
Node: Installation Names453152
Node: Specifying the System Type455258
Node: Sharing Defaults455971
Node: Operation Controls456641
Node: Optional Features457596
Node: Reporting Bugs468812
Node: Major Differences From The Bourne Shell470084
Node: GNU Free Documentation License486931
Node: Indexes512105
Node: Builtin Index512556
Node: Reserved Word Index519380
Node: Variable Index521825
Node: Function Index538596
Node: Concept Index552377

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+2805 -2800
View File
File diff suppressed because it is too large Load Diff
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+9 -2
View File
@@ -10494,9 +10494,12 @@ The default limit is <code>100</code>.
<dd><p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will convert characters with the
eighth bit set to an <small>ASCII</small> key sequence by stripping the eighth
bit and prefixing an <tt class="key">ESC</tt> character, converting them to a
meta-prefixed key sequence. The default value is &lsquo;<samp>on</samp>&rsquo;, but
meta-prefixed key sequence.
The default value is &lsquo;<samp>on</samp>&rsquo;, but
will be set to &lsquo;<samp>off</samp>&rsquo; if the locale is one that contains
eight-bit characters.
This variable is dependent on the <code>LC_CTYPE</code> locale category, and
may change if the locale is changed.
</p>
</dd>
<dt id='index-disable_002dcompletion'><span><code>disable-completion</code><a href='#index-disable_002dcompletion' class='copiable-anchor'> &para;</a></span></dt>
@@ -10608,6 +10611,8 @@ regardless of what the terminal claims it can support. The
default value is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
The name <code>meta-flag</code> is a synonym for this variable.
This variable is dependent on the <code>LC_CTYPE</code> locale category, and
may change if the locale is changed.
</p>
</dd>
<dt id='index-isearch_002dterminators'><span><code>isearch-terminators</code><a href='#index-isearch_002dterminators' class='copiable-anchor'> &para;</a></span></dt>
@@ -10692,6 +10697,8 @@ eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
This variable is dependent on the <code>LC_CTYPE</code> locale category, and
may change if the locale is changed.
</p>
</dd>
<dt id='index-page_002dcompletions'><span><code>page-completions</code><a href='#index-page_002dcompletions' class='copiable-anchor'> &para;</a></span></dt>
@@ -10808,7 +10815,7 @@ what you find most comfortable.
to a string that is inserted when the key is pressed (a <var>macro</var>).
</p>
<p>The <code>bind&nbsp;<span class="nolinebreak">-p</span></code><!-- /@w --> command displays Readline function names and
bindings in a format that can put directly into an initialization file.
bindings in a format that can be put directly into an initialization file.
See <a href="#Bash-Builtins">Bash Builtin Commands</a>.
</p>
<dl compact="compact">
doc/bashref.info
+79 -73
View File
@@ -8159,7 +8159,9 @@ Variable Settings
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
eight-bit characters. This variable is dependent on the
'LC_CTYPE' locale category, and may change if the locale is
changed.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
@@ -8254,7 +8256,9 @@ Variable Settings
regardless of what the terminal claims it can support. The
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'meta-flag' is a synonym for this variable. This variable is
dependent on the 'LC_CTYPE' locale category, and may change if
the locale is changed.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -8319,7 +8323,9 @@ Variable Settings
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'on' if the locale contains eight-bit characters. This
variable is dependent on the 'LC_CTYPE' locale category, and
may change if the locale is changed.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -8416,7 +8422,7 @@ Key Bindings
string that is inserted when the key is pressed (a MACRO).
The 'bind -p' command displays Readline function names and bindings
in a format that can put directly into an initialization file.
in a format that can be put directly into an initialization file.
*Note Bash Builtins::.
KEYNAME: FUNCTION-NAME or MACRO
@@ -12001,27 +12007,27 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 260)
* DIRSTACK: Bash Variables. (line 264)
* disable-completion: Readline Init File Syntax.
(line 146)
(line 148)
* echo-control-characters: Readline Init File Syntax.
(line 151)
(line 153)
* editing-mode: Readline Init File Syntax.
(line 156)
(line 158)
* EMACS: Bash Variables. (line 274)
* emacs-mode-string: Readline Init File Syntax.
(line 162)
(line 164)
* enable-active-region: Readline Init File Syntax.
(line 172)
(line 174)
* enable-bracketed-paste: Readline Init File Syntax.
(line 185)
(line 187)
* enable-keypad: Readline Init File Syntax.
(line 194)
(line 196)
* ENV: Bash Variables. (line 279)
* EPOCHREALTIME: Bash Variables. (line 284)
* EPOCHSECONDS: Bash Variables. (line 292)
* EUID: Bash Variables. (line 299)
* EXECIGNORE: Bash Variables. (line 303)
* expand-tilde: Readline Init File Syntax.
(line 205)
(line 207)
* FCEDIT: Bash Variables. (line 316)
* FIGNORE: Bash Variables. (line 320)
* FUNCNAME: Bash Variables. (line 326)
@@ -12035,15 +12041,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 402)
* HISTIGNORE: Bash Variables. (line 413)
* history-preserve-point: Readline Init File Syntax.
(line 209)
(line 211)
* history-size: Readline Init File Syntax.
(line 215)
(line 217)
* HISTSIZE: Bash Variables. (line 433)
* HISTTIMEFORMAT: Bash Variables. (line 440)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 224)
(line 226)
* HOSTFILE: Bash Variables. (line 448)
* HOSTNAME: Bash Variables. (line 459)
* HOSTTYPE: Bash Variables. (line 462)
@@ -12051,13 +12057,13 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 465)
* input-meta: Readline Init File Syntax.
(line 233)
(line 235)
* INPUTRC: Bash Variables. (line 475)
* INSIDE_EMACS: Bash Variables. (line 479)
* isearch-terminators: Readline Init File Syntax.
(line 241)
(line 245)
* keymap: Readline Init File Syntax.
(line 248)
(line 252)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 485)
@@ -12079,15 +12085,15 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 540)
* mark-modified-lines: Readline Init File Syntax.
(line 278)
(line 282)
* mark-symlinked-directories: Readline Init File Syntax.
(line 283)
(line 287)
* match-hidden-files: Readline Init File Syntax.
(line 288)
(line 292)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 295)
(line 299)
* meta-flag: Readline Init File Syntax.
(line 233)
(line 235)
* OLDPWD: Bash Variables. (line 544)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -12096,9 +12102,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 551)
* output-meta: Readline Init File Syntax.
(line 300)
(line 304)
* page-completions: Readline Init File Syntax.
(line 306)
(line 312)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 554)
@@ -12121,19 +12127,19 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 626)
* REPLY: Bash Variables. (line 630)
* revert-all-at-newline: Readline Init File Syntax.
(line 316)
(line 322)
* SECONDS: Bash Variables. (line 633)
* SHELL: Bash Variables. (line 642)
* SHELLOPTS: Bash Variables. (line 647)
* SHLVL: Bash Variables. (line 656)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 322)
* show-all-if-unmodified: Readline Init File Syntax.
(line 328)
* show-all-if-unmodified: Readline Init File Syntax.
(line 334)
* show-mode-in-prompt: Readline Init File Syntax.
(line 337)
* skip-completed-text: Readline Init File Syntax.
(line 343)
* skip-completed-text: Readline Init File Syntax.
(line 349)
* SRANDOM: Bash Variables. (line 661)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
@@ -12144,11 +12150,11 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 720)
* UID: Bash Variables. (line 724)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 356)
(line 362)
* vi-ins-mode-string: Readline Init File Syntax.
(line 367)
(line 373)
* visible-stats: Readline Init File Syntax.
(line 378)
(line 384)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -12619,46 +12625,46 @@ Node: Readline Arguments342016
Node: Searching343060
Node: Readline Init File345246
Node: Readline Init File Syntax346507
Node: Conditional Init Constructs369706
Node: Sample Init File373902
Node: Bindable Readline Commands377026
Node: Commands For Moving378230
Node: Commands For History380281
Node: Commands For Text385275
Node: Commands For Killing388924
Node: Numeric Arguments391957
Node: Commands For Completion393096
Node: Keyboard Macros397287
Node: Miscellaneous Commands397974
Node: Readline vi Mode403913
Node: Programmable Completion404820
Node: Programmable Completion Builtins412600
Node: A Programmable Completion Example423352
Node: Using History Interactively428599
Node: Bash History Facilities429283
Node: Bash History Builtins432288
Node: History Interaction437296
Node: Event Designators440916
Node: Word Designators442270
Node: Modifiers444030
Node: Installing Bash445841
Node: Basic Installation446978
Node: Compilers and Options450700
Node: Compiling For Multiple Architectures451441
Node: Installation Names453134
Node: Specifying the System Type455243
Node: Sharing Defaults455959
Node: Operation Controls456632
Node: Optional Features457590
Node: Reporting Bugs468809
Node: Major Differences From The Bourne Shell470084
Node: GNU Free Documentation License486934
Node: Indexes512111
Node: Builtin Index512565
Node: Reserved Word Index519392
Node: Variable Index521840
Node: Function Index538614
Node: Concept Index552398
Node: Conditional Init Constructs370081
Node: Sample Init File374277
Node: Bindable Readline Commands377401
Node: Commands For Moving378605
Node: Commands For History380656
Node: Commands For Text385650
Node: Commands For Killing389299
Node: Numeric Arguments392332
Node: Commands For Completion393471
Node: Keyboard Macros397662
Node: Miscellaneous Commands398349
Node: Readline vi Mode404288
Node: Programmable Completion405195
Node: Programmable Completion Builtins412975
Node: A Programmable Completion Example423727
Node: Using History Interactively428974
Node: Bash History Facilities429658
Node: Bash History Builtins432663
Node: History Interaction437671
Node: Event Designators441291
Node: Word Designators442645
Node: Modifiers444405
Node: Installing Bash446216
Node: Basic Installation447353
Node: Compilers and Options451075
Node: Compiling For Multiple Architectures451816
Node: Installation Names453509
Node: Specifying the System Type455618
Node: Sharing Defaults456334
Node: Operation Controls457007
Node: Optional Features457965
Node: Reporting Bugs469184
Node: Major Differences From The Bourne Shell470459
Node: GNU Free Documentation License487309
Node: Indexes512486
Node: Builtin Index512940
Node: Reserved Word Index519767
Node: Variable Index522215
Node: Function Index538989
Node: Concept Index552773

End Tag Table
doc/bashref.log
+17 -17
View File
@@ -1,11 +1,11 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_0) (preloaded format=pdfetex 2021.8.30) 29 JUL 2022 09:05
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_0) (preloaded format=pdfetex 2021.8.30) 12 AUG 2022 11:28
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\input /usr/local/src/bash/bash-20220727/doc/bashref.texi
(/usr/local/src/bash/bash-20220727/doc/bashref.texi
(/usr/local/src/bash/bash-20220727/doc/texinfo.tex
**\input /usr/local/src/bash/bash-20220811/doc/bashref.texi
(/usr/local/src/bash/bash-20220811/doc/bashref.texi
(/usr/local/src/bash/bash-20220811/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
@@ -161,15 +161,15 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(/usr/local/src/bash/bash-20220727/doc/version.texi) [1{/opt/local/var/db/texmf
(/usr/local/src/bash/bash-20220811/doc/version.texi) [1{/opt/local/var/db/texmf
/fonts/map/pdftex/updmap/pdftex.map}] [2]
(/usr/local/build/bash/bash-20220727/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/local/build/bash/bash-20220727/doc/bashref.toc)
(/usr/local/build/bash/bash-20220727/doc/bashref.toc) Chapter 1
(/usr/local/build/bash/bash-20220811/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/local/build/bash/bash-20220811/doc/bashref.toc)
(/usr/local/build/bash/bash-20220811/doc/bashref.toc) Chapter 1
\openout0 = `bashref.toc'.
(/usr/local/build/bash/bash-20220727/doc/bashref.aux)
(/usr/local/build/bash/bash-20220811/doc/bashref.aux)
\openout1 = `bashref.aux'.
Chapter 2 [1] [2]
@@ -260,9 +260,9 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5231--5231
texinfo.tex: doing @include of rluser.texi
(/usr/local/src/bash/bash-20220727/lib/readline/doc/rluser.texi Chapter 8
(/usr/local/src/bash/bash-20220811/lib/readline/doc/rluser.texi Chapter 8
[116] [117] [118] [119] [120] [121] [122] [123] [124] [125] [126] [127]
Underfull \hbox (badness 7540) in paragraph at lines 861--867
Underfull \hbox (badness 7540) in paragraph at lines 868--874
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -275,7 +275,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 861--867
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 861--867
Underfull \hbox (badness 10000) in paragraph at lines 868--874
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -288,7 +288,7 @@ e func-tion
.etc.
[128] [129] [130]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1095--1095
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1102--1102
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -306,7 +306,7 @@ gnored[]
[133] [134] [135] [136] [137] [138] [139] [140] [141] [142]
[143] [144] [145]
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2120--2120
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2127--2127
[]@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-DEI] [
-A @textttsl ac-tion@texttt ] [-
@@ -322,7 +322,7 @@ Overfull \hbox (15.27109pt too wide) in paragraph at lines 2120--2120
texinfo.tex: doing @include of hsuser.texi
(/usr/local/src/bash/bash-20220727/lib/readline/doc/hsuser.texi Chapter 9
(/usr/local/src/bash/bash-20220811/lib/readline/doc/hsuser.texi Chapter 9
[151] [152] [153] [154] [155] [156]) Chapter 10 [157] [158] [159] [160]
[161]
Underfull \hbox (badness 10000) in paragraph at lines 9386--9395
@@ -354,7 +354,7 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
[171] [172] Appendix C [173]
texinfo.tex: doing @include of fdl.texi
(/usr/local/src/bash/bash-20220727/doc/fdl.texi
(/usr/local/src/bash/bash-20220811/doc/fdl.texi
[174] [175] [176] [177] [178] [179] [180]) Appendix D [181] [182] [183]
[184] [185] [186] [187] [188] [189] [190] )
Here is how much of TeX's memory you used:
@@ -382,7 +382,7 @@ texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texli
ve/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fon
ts/type1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/typ
e1/public/cm-super/sfrm1440.pfb>
Output written on bashref.pdf (196 pages, 795436 bytes).
Output written on bashref.pdf (196 pages, 795736 bytes).
PDF statistics:
2756 PDF objects out of 2984 (max. 8388607)
2513 compressed objects within 26 object streams
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+337 -327
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Fri Jul 29 13:05:39 2022
%%CreationDate: Fri Aug 12 15:28:49 2022
%%Pages: 196
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
@@ -12,7 +12,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2022.07.29:0905
%DVIPSSource: TeX output 2022.08.12:1128
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -17184,49 +17184,53 @@ y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g
518 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46
b(negativ)m(e)d(v)-5 b(alues)41 b(are)f(treated)i(as)1110
628 y(zero.)g(The)29 b(default)i(limit)g(is)g Ft(100)p
Fu(.)630 792 y Ft(convert-meta)1110 902 y Fu(If)22 b(set)g(to)h(`)p
Fu(.)630 774 y Ft(convert-meta)1110 883 y Fu(If)22 b(set)g(to)h(`)p
Ft(on)p Fu(',)h(Readline)f(will)f(con)m(v)m(ert)i(c)m(haracters)f(with)
f(the)g(eigh)m(th)h(bit)f(set)1110 1011 y(to)33 b(an)e
f(the)g(eigh)m(th)h(bit)f(set)1110 993 y(to)33 b(an)e
Fm(asci)r(i)h Fu(k)m(ey)h(sequence)f(b)m(y)g(stripping)f(the)h(eigh)m
(th)h(bit)f(and)f(pre\014xing)1110 1121 y(an)24 b Ft(ESC)g
(th)h(bit)f(and)f(pre\014xing)1110 1103 y(an)24 b Ft(ESC)g
Fu(c)m(haracter,)j(con)m(v)m(erting)f(them)f(to)g(a)g(meta-pre\014xed)f
(k)m(ey)h(sequence.)1110 1230 y(The)i(default)h(v)-5
(k)m(ey)h(sequence.)1110 1212 y(The)i(default)h(v)-5
b(alue)28 b(is)f(`)p Ft(on)p Fu(',)i(but)d(will)i(b)s(e)f(set)h(to)g(`)
p Ft(off)p Fu(')g(if)f(the)h(lo)s(cale)h(is)f(one)1110
1340 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)630
1504 y Ft(disable-completion)1110 1614 y Fu(If)k(set)h(to)h(`)p
Ft(On)p Fu(',)g(Readline)f(will)g(inhibit)f(w)m(ord)h(completion.)60
b(Completion)1110 1724 y(c)m(haracters)28 b(will)e(b)s(e)f(inserted)h
(in)m(to)h(the)g(line)f(as)g(if)g(they)h(had)e(b)s(een)g(mapp)s(ed)1110
1833 y(to)31 b Ft(self-insert)p Fu(.)38 b(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 1998 y Ft(echo-control-characters)1110
2107 y Fu(When)f(set)h(to)g(`)p Ft(on)p Fu(',)f(on)g(op)s(erating)h
(systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 2217
y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m(haracter)h(corresp)s(onding)d
(to)j(a)f(signal)g(generated)1110 2326 y(from)e(the)g(k)m(eyb)s(oard.)
41 b(The)30 b(default)g(is)h(`)p Ft(on)p Fu('.)630 2491
y Ft(editing-mode)1110 2600 y Fu(The)d Ft(editing-mode)e
Fu(v)-5 b(ariable)29 b(con)m(trols)h(whic)m(h)e(default)h(set)h(of)e(k)
m(ey)i(bind-)1110 2710 y(ings)25 b(is)g(used.)38 b(By)26
b(default,)g(Readline)g(starts)f(up)f(in)h(Emacs)g(editing)h(mo)s(de,)
1110 2819 y(where)j(the)g(k)m(eystrok)m(es)i(are)e(most)h(similar)f(to)
h(Emacs.)40 b(This)29 b(v)-5 b(ariable)30 b(can)1110
2929 y(b)s(e)g(set)h(to)g(either)g(`)p Ft(emacs)p Fu(')e(or)h(`)p
Ft(vi)p Fu('.)630 3093 y Ft(emacs-mode-string)1110 3203
y Fu(If)j(the)h Fr(sho)m(w-mo)s(de-in-prompt)h Fu(v)-5
b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110
3313 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f
(of)h(the)f(primary)f(prompt)g(when)1110 3422 y(emacs)g(editing)h(mo)s
(de)e(is)h(activ)m(e.)40 b(The)21 b(v)-5 b(alue)22 b(is)g(expanded)f
(lik)m(e)h(a)h(k)m(ey)f(bind-)1110 3532 y(ing,)27 b(so)f(the)f
(standard)g(set)h(of)f(meta-)i(and)e(con)m(trol)i(pre\014xes)d(and)h
(bac)m(kslash)1110 3641 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5
b(ailable.)41 b(Use)25 b(the)f(`)p Ft(\\1)p Fu(')f(and)h(`)p
Ft(\\2)p Fu(')g(escap)s(es)g(to)g(b)s(egin)1110 3751
y(and)37 b(end)g(sequences)h(of)f(non-prin)m(ting)h(c)m(haracters,)j
(whic)m(h)c(can)h(b)s(e)f(used)1110 3861 y(to)h(em)m(b)s(ed)f(a)g
(terminal)h(con)m(trol)h(sequence)f(in)m(to)g(the)f(mo)s(de)g(string.)
61 b(The)1110 3970 y(default)31 b(is)f(`)p Ft(@)p Fu('.)630
1322 y(that)21 b(con)m(tains)h(eigh)m(t-bit)h(c)m(haracters.)39
b(This)20 b(v)-5 b(ariable)21 b(is)g(dep)s(enden)m(t)f(on)h(the)1110
1431 y Ft(LC_CTYPE)26 b Fu(lo)s(cale)31 b(category)-8
b(,)31 b(and)d(ma)m(y)h(c)m(hange)h(if)e(the)h(lo)s(cale)h(is)f(c)m
(hanged.)630 1577 y Ft(disable-completion)1110 1687 y
Fu(If)36 b(set)h(to)h(`)p Ft(On)p Fu(',)g(Readline)f(will)g(inhibit)f
(w)m(ord)h(completion.)60 b(Completion)1110 1797 y(c)m(haracters)28
b(will)e(b)s(e)f(inserted)h(in)m(to)h(the)g(line)f(as)g(if)g(they)h
(had)e(b)s(een)g(mapp)s(ed)1110 1906 y(to)31 b Ft(self-insert)p
Fu(.)38 b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)630
2052 y Ft(echo-control-characters)1110 2162 y Fu(When)f(set)h(to)g(`)p
Ft(on)p Fu(',)f(on)g(op)s(erating)h(systems)f(that)h(indicate)g(they)g
(supp)s(ort)1110 2271 y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m
(haracter)h(corresp)s(onding)d(to)j(a)f(signal)g(generated)1110
2381 y(from)e(the)g(k)m(eyb)s(oard.)41 b(The)30 b(default)g(is)h(`)p
Ft(on)p Fu('.)630 2527 y Ft(editing-mode)1110 2637 y
Fu(The)d Ft(editing-mode)e Fu(v)-5 b(ariable)29 b(con)m(trols)h(whic)m
(h)e(default)h(set)h(of)e(k)m(ey)i(bind-)1110 2746 y(ings)25
b(is)g(used.)38 b(By)26 b(default,)g(Readline)g(starts)f(up)f(in)h
(Emacs)g(editing)h(mo)s(de,)1110 2856 y(where)j(the)g(k)m(eystrok)m(es)
i(are)e(most)h(similar)f(to)h(Emacs.)40 b(This)29 b(v)-5
b(ariable)30 b(can)1110 2966 y(b)s(e)g(set)h(to)g(either)g(`)p
Ft(emacs)p Fu(')e(or)h(`)p Ft(vi)p Fu('.)630 3112 y Ft
(emacs-mode-string)1110 3221 y Fu(If)j(the)h Fr(sho)m(w-mo)s
(de-in-prompt)h Fu(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f
(is)h(dis-)1110 3331 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)
g(last)h(line)f(of)h(the)f(primary)f(prompt)g(when)1110
3440 y(emacs)g(editing)h(mo)s(de)e(is)h(activ)m(e.)40
b(The)21 b(v)-5 b(alue)22 b(is)g(expanded)f(lik)m(e)h(a)h(k)m(ey)f
(bind-)1110 3550 y(ing,)27 b(so)f(the)f(standard)g(set)h(of)f(meta-)i
(and)e(con)m(trol)i(pre\014xes)d(and)h(bac)m(kslash)1110
3660 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5 b(ailable.)41
b(Use)25 b(the)f(`)p Ft(\\1)p Fu(')f(and)h(`)p Ft(\\2)p
Fu(')g(escap)s(es)g(to)g(b)s(egin)1110 3769 y(and)37
b(end)g(sequences)h(of)f(non-prin)m(ting)h(c)m(haracters,)j(whic)m(h)c
(can)h(b)s(e)f(used)1110 3879 y(to)h(em)m(b)s(ed)f(a)g(terminal)h(con)m
(trol)h(sequence)f(in)m(to)g(the)f(mo)s(de)g(string.)61
b(The)1110 3988 y(default)31 b(is)f(`)p Ft(@)p Fu('.)630
4134 y Ft(enable-active-region)1110 4244 y Fu(The)46
b Fr(p)s(oin)m(t)j Fu(is)e(the)g(curren)m(t)f(cursor)g(p)s(osition,)52
b(and)46 b Fr(mark)52 b Fu(refers)46 b(to)i(a)1110 4354
@@ -17262,125 +17266,129 @@ Fr(brac)m(k)m(eted)h(paste)e(mo)s(de)5 b Fu(;)40 b(it)1110
847 y(prev)m(en)m(ts)30 b(Readline)h(from)e(executing)i(an)m(y)f
(editing)h(commands)e(b)s(ound)f(to)1110 956 y(k)m(ey)j(sequences)g
(app)s(earing)f(in)g(the)g(pasted)h(text.)42 b(The)29
b(default)i(is)f(`)p Ft(On)p Fu('.)630 1129 y Ft(enable-keypad)1110
1238 y Fu(When)23 b(set)h(to)g(`)p Ft(on)p Fu(',)h(Readline)f(will)g
b(default)i(is)f(`)p Ft(On)p Fu('.)630 1113 y Ft(enable-keypad)1110
1223 y Fu(When)23 b(set)h(to)g(`)p Ft(on)p Fu(',)h(Readline)f(will)g
(try)f(to)h(enable)g(the)f(application)i(k)m(eypad)1110
1348 y(when)h(it)h(is)f(called.)41 b(Some)27 b(systems)f(need)h(this)f
(to)h(enable)g(the)g(arro)m(w)g(k)m(eys.)1110 1457 y(The)j(default)g
(is)h(`)p Ft(off)p Fu('.)630 1630 y Ft(enable-meta-key)1110
1739 y Fu(When)40 b(set)g(to)g(`)p Ft(on)p Fu(',)j(Readline)d(will)g
1332 y(when)h(it)h(is)f(called.)41 b(Some)27 b(systems)f(need)h(this)f
(to)h(enable)g(the)g(arro)m(w)g(k)m(eys.)1110 1442 y(The)j(default)g
(is)h(`)p Ft(off)p Fu('.)630 1598 y Ft(enable-meta-key)1110
1708 y Fu(When)40 b(set)g(to)g(`)p Ft(on)p Fu(',)j(Readline)d(will)g
(try)g(to)g(enable)g(an)m(y)g(meta)h(mo)s(di\014er)1110
1849 y(k)m(ey)i(the)e(terminal)i(claims)f(to)h(supp)s(ort)d(when)h(it)h
(is)g(called.)76 b(On)41 b(man)m(y)1110 1958 y(terminals,)c(the)e(meta)
1817 y(k)m(ey)i(the)e(terminal)i(claims)f(to)h(supp)s(ort)d(when)h(it)h
(is)g(called.)76 b(On)41 b(man)m(y)1110 1927 y(terminals,)c(the)e(meta)
h(k)m(ey)g(is)f(used)g(to)h(send)e(eigh)m(t-bit)j(c)m(haracters.)56
b(The)1110 2068 y(default)31 b(is)f(`)p Ft(on)p Fu('.)630
2240 y Ft(expand-tilde)1110 2350 y Fu(If)d(set)h(to)h(`)p
b(The)1110 2037 y(default)31 b(is)f(`)p Ft(on)p Fu('.)630
2193 y Ft(expand-tilde)1110 2303 y Fu(If)d(set)h(to)h(`)p
Ft(on)p Fu(',)f(tilde)g(expansion)g(is)f(p)s(erformed)f(when)h
(Readline)h(attempts)1110 2459 y(w)m(ord)i(completion.)42
b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)630 2632
y Ft(history-preserve-point)1110 2741 y Fu(If)41 b(set)h(to)h(`)p
(Readline)h(attempts)1110 2412 y(w)m(ord)i(completion.)42
b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)630 2569
y Ft(history-preserve-point)1110 2679 y Fu(If)41 b(set)h(to)h(`)p
Ft(on)p Fu(',)i(the)c(history)h(co)s(de)g(attempts)h(to)f(place)h(the)f
(p)s(oin)m(t)f(\(the)1110 2851 y(curren)m(t)35 b(cursor)g(p)s
(p)s(oin)m(t)f(\(the)1110 2788 y(curren)m(t)35 b(cursor)g(p)s
(osition\))g(at)h(the)g(same)f(lo)s(cation)i(on)e(eac)m(h)h(history)g
(line)1110 2960 y(retriev)m(ed)h(with)f Ft(previous-history)c
(line)1110 2898 y(retriev)m(ed)h(with)f Ft(previous-history)c
Fu(or)37 b Ft(next-history)p Fu(.)55 b(The)36 b(default)1110
3070 y(is)30 b(`)p Ft(off)p Fu('.)630 3242 y Ft(history-size)1110
3352 y Fu(Set)39 b(the)g(maxim)m(um)g(n)m(um)m(b)s(er)f(of)h(history)g
(en)m(tries)h(sa)m(v)m(ed)g(in)f(the)g(history)1110 3461
3007 y(is)30 b(`)p Ft(off)p Fu('.)630 3164 y Ft(history-size)1110
3273 y Fu(Set)39 b(the)g(maxim)m(um)g(n)m(um)m(b)s(er)f(of)h(history)g
(en)m(tries)h(sa)m(v)m(ed)g(in)f(the)g(history)1110 3383
y(list.)51 b(If)34 b(set)g(to)h(zero,)g(an)m(y)f(existing)h(history)f
(en)m(tries)g(are)g(deleted)h(and)e(no)1110 3571 y(new)e(en)m(tries)i
(en)m(tries)g(are)g(deleted)h(and)e(no)1110 3493 y(new)e(en)m(tries)i
(are)f(sa)m(v)m(ed.)46 b(If)31 b(set)h(to)h(a)f(v)-5
b(alue)32 b(less)g(than)f(zero,)i(the)f(n)m(um)m(b)s(er)1110
3680 y(of)f(history)f(en)m(tries)h(is)g(not)g(limited.)42
3602 y(of)f(history)f(en)m(tries)h(is)g(not)g(limited.)42
b(By)30 b(default,)h(the)g(n)m(um)m(b)s(er)e(of)i(history)1110
3790 y(en)m(tries)j(is)f(not)g(limited.)49 b(If)32 b(an)h(attempt)h(is)
f(made)g(to)h(set)f Fr(history-size)39 b Fu(to)1110 3900
3712 y(en)m(tries)j(is)f(not)g(limited.)49 b(If)32 b(an)h(attempt)h(is)
f(made)g(to)h(set)f Fr(history-size)39 b Fu(to)1110 3821
y(a)34 b(non-n)m(umeric)f(v)-5 b(alue,)34 b(the)g(maxim)m(um)f(n)m(um)m
(b)s(er)f(of)h(history)h(en)m(tries)g(will)1110 4009
y(b)s(e)c(set)h(to)g(500.)630 4181 y Ft(horizontal-scroll-mode)1110
4291 y Fu(This)k(v)-5 b(ariable)37 b(can)f(b)s(e)f(set)h(to)h(either)f
(b)s(er)f(of)h(history)h(en)m(tries)g(will)1110 3931
y(b)s(e)c(set)h(to)g(500.)630 4088 y Ft(horizontal-scroll-mode)1110
4197 y Fu(This)k(v)-5 b(ariable)37 b(can)f(b)s(e)f(set)h(to)h(either)f
(`)p Ft(on)p Fu(')g(or)g(`)p Ft(off)p Fu('.)57 b(Setting)36
b(it)g(to)h(`)p Ft(on)p Fu(')1110 4401 y(means)26 b(that)h(the)f(text)h
b(it)g(to)h(`)p Ft(on)p Fu(')1110 4307 y(means)26 b(that)h(the)f(text)h
(of)g(the)f(lines)g(b)s(eing)g(edited)h(will)f(scroll)h(horizon)m
(tally)1110 4510 y(on)32 b(a)g(single)g(screen)g(line)g(when)e(they)i
(are)g(longer)h(than)e(the)h(width)f(of)h(the)1110 4620
(tally)1110 4416 y(on)32 b(a)g(single)g(screen)g(line)g(when)e(they)i
(are)g(longer)h(than)e(the)h(width)f(of)h(the)1110 4526
y(screen,)c(instead)g(of)f(wrapping)f(on)m(to)i(a)g(new)e(screen)i
(line.)40 b(This)26 b(v)-5 b(ariable)28 b(is)1110 4729
(line.)40 b(This)26 b(v)-5 b(ariable)28 b(is)1110 4635
y(automatically)k(set)e(to)g(`)p Ft(on)p Fu(')f(for)g(terminals)g(of)h
(heigh)m(t)g(1.)41 b(By)29 b(default,)h(this)1110 4839
(heigh)m(t)g(1.)41 b(By)29 b(default,)h(this)1110 4745
y(v)-5 b(ariable)31 b(is)g(set)f(to)i(`)p Ft(off)p Fu('.)630
5011 y Ft(input-meta)1110 5121 y Fu(If)f(set)g(to)h(`)p
4902 y Ft(input-meta)1110 5011 y Fu(If)f(set)g(to)h(`)p
Ft(on)p Fu(',)g(Readline)g(will)f(enable)h(eigh)m(t-bit)h(input)d(\(it)
i(will)f(not)h(clear)1110 5230 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h
i(will)f(not)h(clear)1110 5121 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h
(c)m(haracters)h(it)f(reads\),)j(regardless)c(of)h(what)g(the)1110
5340 y(terminal)k(claims)h(it)f(can)g(supp)s(ort.)79
5230 y(terminal)k(claims)h(it)f(can)g(supp)s(ort.)79
b(The)44 b(default)g(v)-5 b(alue)44 b(is)g(`)p Ft(off)p
Fu(',)j(but)p eop end
Fu(',)j(but)1110 5340 y(Readline)24 b(will)h(set)f(it)g(to)h(`)p
Ft(on)p Fu(')e(if)h(the)g(lo)s(cale)i(con)m(tains)f(eigh)m(t-bit)g(c)m
(haracters.)p eop end
%%Page: 125 131
TeXDict begin 125 130 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(125)1110 299 y(Readline)24
b(will)h(set)f(it)g(to)h(`)p Ft(on)p Fu(')e(if)h(the)g(lo)s(cale)i(con)
m(tains)f(eigh)m(t-bit)g(c)m(haracters.)1110 408 y(The)30
b(name)g Ft(meta-flag)e Fu(is)j(a)f(synon)m(ym)g(for)g(this)h(v)-5
b(ariable.)630 581 y Ft(isearch-terminators)1110 690
y Fu(The)51 b(string)h(of)g(c)m(haracters)h(that)f(should)e(terminate)j
(an)f(incremen)m(tal)1110 800 y(searc)m(h)25 b(without)g(subsequen)m
(tly)g(executing)h(the)f(c)m(haracter)h(as)f(a)g(command)1110
909 y(\(see)38 b(Section)g(8.2.5)h([Searc)m(hing],)h(page)e(119\).)62
b(If)37 b(this)g(v)-5 b(ariable)38 b(has)f(not)1110 1019
y(b)s(een)e(giv)m(en)h(a)g(v)-5 b(alue,)37 b(the)f(c)m(haracters)h
Ft(ESC)d Fu(and)h Fj(C-J)g Fu(will)h(terminate)g(an)1110
1129 y(incremen)m(tal)c(searc)m(h.)630 1301 y Ft(keymap)192
b Fu(Sets)64 b(Readline's)i(idea)f(of)f(the)h(curren)m(t)f(k)m(eymap)h
(for)f(k)m(ey)h(binding)1110 1410 y(commands.)71 b(Built-in)41
b Ft(keymap)e Fu(names)h(are)h Ft(emacs)p Fu(,)h Ft(emacs-standard)p
Fu(,)1110 1520 y Ft(emacs-meta)p Fu(,)99 b Ft(emacs-ctlx)p
Fu(,)f Ft(vi)p Fu(,)j Ft(vi-move)p Fu(,)f Ft(vi-command)p
Fu(,)f(and)1110 1630 y Ft(vi-insert)p Fu(.)81 b Ft(vi)44
b Fu(is)h(equiv)-5 b(alen)m(t)46 b(to)g Ft(vi-command)c
Fu(\()p Ft(vi-move)h Fu(is)i(also)h(a)1110 1739 y(synon)m(ym\);)41
b Ft(emacs)c Fu(is)h(equiv)-5 b(alen)m(t)39 b(to)f Ft(emacs-standard)p
Fu(.)59 b(Applications)1110 1849 y(ma)m(y)32 b(add)e(additional)i
b(Command)29 b(Line)i(Editing)2062 b(125)1110 299 y(The)29
b(name)g Ft(meta-flag)e Fu(is)i(a)h(synon)m(ym)f(for)g(this)g(v)-5
b(ariable.)42 b(This)28 b(v)-5 b(ariable)1110 408 y(is)35
b(dep)s(enden)m(t)f(on)h(the)g Ft(LC_CTYPE)e Fu(lo)s(cale)k(category)-8
b(,)39 b(and)34 b(ma)m(y)i(c)m(hange)g(if)1110 518 y(the)31
b(lo)s(cale)h(is)e(c)m(hanged.)630 675 y Ft(isearch-terminators)1110
784 y Fu(The)51 b(string)h(of)g(c)m(haracters)h(that)f(should)e
(terminate)j(an)f(incremen)m(tal)1110 894 y(searc)m(h)25
b(without)g(subsequen)m(tly)g(executing)h(the)f(c)m(haracter)h(as)f(a)g
(command)1110 1003 y(\(see)38 b(Section)g(8.2.5)h([Searc)m(hing],)h
(page)e(119\).)62 b(If)37 b(this)g(v)-5 b(ariable)38
b(has)f(not)1110 1113 y(b)s(een)e(giv)m(en)h(a)g(v)-5
b(alue,)37 b(the)f(c)m(haracters)h Ft(ESC)d Fu(and)h
Fj(C-J)g Fu(will)h(terminate)g(an)1110 1223 y(incremen)m(tal)c(searc)m
(h.)630 1379 y Ft(keymap)192 b Fu(Sets)64 b(Readline's)i(idea)f(of)f
(the)h(curren)m(t)f(k)m(eymap)h(for)f(k)m(ey)h(binding)1110
1489 y(commands.)71 b(Built-in)41 b Ft(keymap)e Fu(names)h(are)h
Ft(emacs)p Fu(,)h Ft(emacs-standard)p Fu(,)1110 1598
y Ft(emacs-meta)p Fu(,)99 b Ft(emacs-ctlx)p Fu(,)f Ft(vi)p
Fu(,)j Ft(vi-move)p Fu(,)f Ft(vi-command)p Fu(,)f(and)1110
1708 y Ft(vi-insert)p Fu(.)81 b Ft(vi)44 b Fu(is)h(equiv)-5
b(alen)m(t)46 b(to)g Ft(vi-command)c Fu(\()p Ft(vi-move)h
Fu(is)i(also)h(a)1110 1817 y(synon)m(ym\);)41 b Ft(emacs)c
Fu(is)h(equiv)-5 b(alen)m(t)39 b(to)f Ft(emacs-standard)p
Fu(.)59 b(Applications)1110 1927 y(ma)m(y)32 b(add)e(additional)i
(names.)43 b(The)30 b(default)h(v)-5 b(alue)32 b(is)f
Ft(emacs)p Fu(.)41 b(The)30 b(v)-5 b(alue)1110 1958 y(of)31
Ft(emacs)p Fu(.)41 b(The)30 b(v)-5 b(alue)1110 2037 y(of)31
b(the)f Ft(editing-mode)d Fu(v)-5 b(ariable)31 b(also)h(a\013ects)f
(the)g(default)g(k)m(eymap.)630 2131 y Ft(keyseq-timeout)1110
2240 y Fu(Sp)s(eci\014es)25 b(the)g(duration)g(Readline)h(will)g(w)m
(ait)g(for)g(a)f(c)m(haracter)i(when)e(read-)1110 2350
(the)g(default)g(k)m(eymap.)630 2193 y Ft(keyseq-timeout)1110
2303 y Fu(Sp)s(eci\014es)25 b(the)g(duration)g(Readline)h(will)g(w)m
(ait)g(for)g(a)f(c)m(haracter)i(when)e(read-)1110 2412
y(ing)30 b(an)g(am)m(biguous)g(k)m(ey)h(sequence)f(\(one)g(that)h(can)f
(form)g(a)g(complete)h(k)m(ey)1110 2459 y(sequence)j(using)e(the)i
(form)g(a)g(complete)h(k)m(ey)1110 2522 y(sequence)j(using)e(the)i
(input)e(read)h(so)g(far,)h(or)g(can)f(tak)m(e)i(additional)f(input)
1110 2569 y(to)g(complete)g(a)f(longer)h(k)m(ey)f(sequence\).)49
1110 2632 y(to)g(complete)g(a)f(longer)h(k)m(ey)f(sequence\).)49
b(If)33 b(no)f(input)g(is)h(receiv)m(ed)h(within)1110
2679 y(the)43 b(timeout,)48 b(Readline)43 b(will)g(use)g(the)g(shorter)
g(but)f(complete)j(k)m(ey)e(se-)1110 2788 y(quence.)c(Readline)26
2741 y(the)43 b(timeout,)48 b(Readline)43 b(will)g(use)g(the)g(shorter)
g(but)f(complete)j(k)m(ey)e(se-)1110 2851 y(quence.)c(Readline)26
b(uses)f(this)h(v)-5 b(alue)26 b(to)g(determine)g(whether)f(or)g(not)h
(input)1110 2898 y(is)31 b(a)m(v)-5 b(ailable)33 b(on)d(the)h(curren)m
(input)1110 2960 y(is)31 b(a)m(v)-5 b(ailable)33 b(on)d(the)h(curren)m
(t)f(input)g(source)h(\()p Ft(rl_instream)d Fu(b)m(y)i(default\).)1110
3007 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h
3070 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h
(milliseconds,)j(so)d(a)h(v)-5 b(alue)26 b(of)f(1000)i(means)e(that)
1110 3117 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g
1110 3180 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g
(additional)i(input.)37 b(If)22 b(this)g(v)-5 b(ariable)23
b(is)1110 3226 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f
b(is)1110 3289 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f
(equal)i(to)f(zero,)i(or)e(to)g(a)h(non-n)m(umeric)e(v)-5
b(alue,)1110 3336 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h
b(alue,)1110 3399 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h
(k)m(ey)g(is)f(pressed)g(to)h(decide)f(whic)m(h)g(k)m(ey)1110
3446 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5
b(alue)31 b(is)g Ft(500)p Fu(.)630 3618 y Ft(mark-directories)1110
3727 y Fu(If)38 b(set)g(to)h(`)p Ft(on)p Fu(',)i(completed)e(directory)
3508 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5
b(alue)31 b(is)g Ft(500)p Fu(.)630 3665 y Ft(mark-directories)1110
3774 y Fu(If)38 b(set)g(to)h(`)p Ft(on)p Fu(',)i(completed)e(directory)
f(names)g(ha)m(v)m(e)i(a)e(slash)g(app)s(ended.)1110
3837 y(The)30 b(default)g(is)h(`)p Ft(on)p Fu('.)630
4009 y Ft(mark-modified-lines)1110 4119 y Fu(This)k(v)-5
3884 y(The)30 b(default)g(is)h(`)p Ft(on)p Fu('.)630
4041 y Ft(mark-modified-lines)1110 4150 y Fu(This)k(v)-5
b(ariable,)38 b(when)d(set)h(to)h(`)p Ft(on)p Fu(',)g(causes)g
(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 4228 y(terisk)f(\(`)p
(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 4260 y(terisk)f(\(`)p
Ft(*)p Fu('\))h(at)f(the)g(start)g(of)g(history)g(lines)g(whic)m(h)f
(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 4338 y(This)d(v)-5
(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 4369 y(This)d(v)-5
b(ariable)31 b(is)f(`)p Ft(off)p Fu(')g(b)m(y)g(default.)630
4510 y Ft(mark-symlinked-directori)o(es)1110 4620 y Fu(If)59
4526 y Ft(mark-symlinked-directori)o(es)1110 4635 y Fu(If)59
b(set)h(to)g(`)p Ft(on)p Fu(',)67 b(completed)60 b(names)f(whic)m(h)g
(are)h(sym)m(b)s(olic)g(links)f(to)1110 4729 y(directories)71
(are)h(sym)m(b)s(olic)g(links)f(to)1110 4745 y(directories)71
b(ha)m(v)m(e)f(a)g(slash)f(app)s(ended)f(\(sub)5 b(ject)70
b(to)g(the)g(v)-5 b(alue)70 b(of)1110 4839 y Ft(mark-directories)p
b(to)g(the)g(v)-5 b(alue)70 b(of)1110 4855 y Ft(mark-directories)p
Fu(\).)37 b(The)30 b(default)g(is)g(`)p Ft(off)p Fu('.)630
5011 y Ft(match-hidden-files)1110 5121 y Fu(This)21 b(v)-5
b(ariable,)25 b(when)d(set)g(to)h(`)p Ft(on)p Fu(',)h(causes)f
@@ -17395,331 +17403,333 @@ TeXDict begin 126 131 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(126)1110 299 y(the)34
b(user)g(in)g(the)g(\014lename)g(to)h(b)s(e)f(completed.)53
b(This)33 b(v)-5 b(ariable)35 b(is)f(`)p Ft(on)p Fu(')g(b)m(y)1110
408 y(default.)630 555 y Ft(menu-complete-display-pr)o(efix)1110
664 y Fu(If)f(set)h(to)g(`)p Ft(on)p Fu(',)h(men)m(u)e(completion)i
408 y(default.)630 587 y Ft(menu-complete-display-pr)o(efix)1110
696 y Fu(If)f(set)h(to)g(`)p Ft(on)p Fu(',)h(men)m(u)e(completion)i
(displa)m(ys)e(the)h(common)g(pre\014x)e(of)i(the)1110
774 y(list)k(of)g(p)s(ossible)f(completions)i(\(whic)m(h)e(ma)m(y)h(b)s
(e)f(empt)m(y\))i(b)s(efore)e(cycling)1110 883 y(through)30
806 y(list)k(of)g(p)s(ossible)f(completions)i(\(whic)m(h)e(ma)m(y)h(b)s
(e)f(empt)m(y\))i(b)s(efore)e(cycling)1110 915 y(through)30
b(the)g(list.)42 b(The)29 b(default)i(is)f(`)p Ft(off)p
Fu('.)630 1029 y Ft(output-meta)1110 1139 y Fu(If)35
Fu('.)630 1093 y Ft(output-meta)1110 1203 y Fu(If)35
b(set)h(to)g(`)p Ft(on)p Fu(',)h(Readline)f(will)g(displa)m(y)f(c)m
(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 1249 y(set)h(directly)g
(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 1313 y(set)h(directly)g
(rather)f(than)g(as)h(a)g(meta-pre\014xed)f(escap)s(e)h(sequence.)59
b(The)1110 1358 y(default)26 b(is)f(`)p Ft(off)p Fu(',)i(but)e
b(The)1110 1422 y(default)26 b(is)f(`)p Ft(off)p Fu(',)i(but)e
(Readline)h(will)g(set)g(it)g(to)h(`)p Ft(on)p Fu(')e(if)h(the)f(lo)s
(cale)j(con)m(tains)1110 1468 y(eigh)m(t-bit)k(c)m(haracters.)630
1614 y Ft(page-completions)1110 1724 y Fu(If)h(set)i(to)f(`)p
Ft(on)p Fu(',)h(Readline)g(uses)e(an)h(in)m(ternal)h
(cale)j(con)m(tains)1110 1532 y(eigh)m(t-bit)38 b(c)m(haracters.)61
b(This)36 b(v)-5 b(ariable)37 b(is)g(dep)s(enden)m(t)e(on)h(the)h
Ft(LC_CTYPE)1110 1641 y Fu(lo)s(cale)32 b(category)-8
b(,)33 b(and)d(ma)m(y)h(c)m(hange)g(if)g(the)f(lo)s(cale)i(is)f(c)m
(hanged.)630 1819 y Ft(page-completions)1110 1929 y Fu(If)i(set)i(to)f
(`)p Ft(on)p Fu(',)h(Readline)g(uses)e(an)h(in)m(ternal)h
Ft(more)p Fu(-lik)m(e)f(pager)g(to)h(displa)m(y)1110
1833 y(a)e(screenful)f(of)g(p)s(ossible)g(completions)i(at)f(a)g(time.)
2039 y(a)e(screenful)f(of)g(p)s(ossible)g(completions)i(at)f(a)g(time.)
47 b(This)31 b(v)-5 b(ariable)34 b(is)e(`)p Ft(on)p Fu(')1110
1943 y(b)m(y)e(default.)630 2089 y Ft(print-completions-horizo)o(ntal)o
(ly)1110 2198 y Fu(If)23 b(set)i(to)g(`)p Ft(on)p Fu(',)g(Readline)g
2148 y(b)m(y)e(default.)630 2326 y Ft(print-completions-horizo)o(ntal)o
(ly)1110 2436 y Fu(If)23 b(set)i(to)g(`)p Ft(on)p Fu(',)g(Readline)g
(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes)h(sorted)1110
2308 y(horizon)m(tally)45 b(in)e(alphab)s(etical)i(order,)i(rather)c
(than)g(do)m(wn)g(the)h(screen.)1110 2418 y(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 2564 y Ft(revert-all-at-newline)1110
2673 y Fu(If)e(set)h(to)g(`)p Ft(on)p Fu(',)g(Readline)g(will)g(undo)f
2545 y(horizon)m(tally)45 b(in)e(alphab)s(etical)i(order,)i(rather)c
(than)g(do)m(wn)g(the)h(screen.)1110 2655 y(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 2833 y Ft(revert-all-at-newline)1110
2943 y Fu(If)e(set)h(to)g(`)p Ft(on)p Fu(',)g(Readline)g(will)g(undo)f
(all)h(c)m(hanges)h(to)f(history)g(lines)f(b)s(efore)1110
2783 y(returning)f(when)f Ft(accept-line)f Fu(is)j(executed.)41
b(By)29 b(default,)g(history)g(lines)1110 2892 y(ma)m(y)42
3052 y(returning)f(when)f Ft(accept-line)f Fu(is)j(executed.)41
b(By)29 b(default,)g(history)g(lines)1110 3162 y(ma)m(y)42
b(b)s(e)g(mo)s(di\014ed)e(and)h(retain)i(individual)e(undo)g(lists)h
(across)g(calls)h(to)1110 3002 y Ft(readline)p Fu(.)38
b(The)30 b(default)h(is)f(`)p Ft(off)p Fu('.)630 3148
y Ft(show-all-if-ambiguous)1110 3258 y Fu(This)f(alters)i(the)f
(across)g(calls)h(to)1110 3271 y Ft(readline)p Fu(.)38
b(The)30 b(default)h(is)f(`)p Ft(off)p Fu('.)630 3450
y Ft(show-all-if-ambiguous)1110 3559 y Fu(This)f(alters)i(the)f
(default)g(b)s(eha)m(vior)g(of)g(the)h(completion)g(functions.)40
b(If)29 b(set)1110 3367 y(to)f(`)p Ft(on)p Fu(',)g(w)m(ords)f(whic)m(h)
b(If)29 b(set)1110 3669 y(to)f(`)p Ft(on)p Fu(',)g(w)m(ords)f(whic)m(h)
g(ha)m(v)m(e)i(more)f(than)f(one)h(p)s(ossible)f(completion)h(cause)
1110 3477 y(the)39 b(matc)m(hes)h(to)g(b)s(e)e(listed)h(immediately)i
(instead)e(of)g(ringing)g(the)g(b)s(ell.)1110 3587 y(The)30
1110 3778 y(the)39 b(matc)m(hes)h(to)g(b)s(e)e(listed)h(immediately)i
(instead)e(of)g(ringing)g(the)g(b)s(ell.)1110 3888 y(The)30
b(default)g(v)-5 b(alue)31 b(is)g(`)p Ft(off)p Fu('.)630
3733 y Ft(show-all-if-unmodified)1110 3842 y Fu(This)38
4066 y Ft(show-all-if-unmodified)1110 4176 y Fu(This)38
b(alters)h(the)g(default)g(b)s(eha)m(vior)g(of)f(the)h(completion)h
(functions)e(in)h(a)1110 3952 y(fashion)25 b(similar)h(to)g
(functions)e(in)h(a)1110 4285 y(fashion)25 b(similar)h(to)g
Fr(sho)m(w-all-if-am)m(biguous)p Fu(.)41 b(If)25 b(set)h(to)h(`)p
Ft(on)p Fu(',)f(w)m(ords)f(whic)m(h)1110 4061 y(ha)m(v)m(e)32
Ft(on)p Fu(',)f(w)m(ords)f(whic)m(h)1110 4395 y(ha)m(v)m(e)32
b(more)f(than)f(one)i(p)s(ossible)e(completion)i(without)f(an)m(y)g(p)s
(ossible)f(par-)1110 4171 y(tial)43 b(completion)h(\(the)f(p)s(ossible)
f(completions)h(don't)f(share)g(a)h(common)1110 4281
(ossible)f(par-)1110 4504 y(tial)43 b(completion)h(\(the)f(p)s(ossible)
f(completions)h(don't)f(share)g(a)h(common)1110 4614
y(pre\014x\))30 b(cause)g(the)h(matc)m(hes)g(to)g(b)s(e)f(listed)g
(immediately)i(instead)e(of)h(ring-)1110 4390 y(ing)g(the)f(b)s(ell.)41
(immediately)i(instead)e(of)h(ring-)1110 4724 y(ing)g(the)f(b)s(ell.)41
b(The)30 b(default)g(v)-5 b(alue)31 b(is)f(`)p Ft(off)p
Fu('.)630 4536 y Ft(show-mode-in-prompt)1110 4646 y Fu(If)24
Fu('.)630 4902 y Ft(show-mode-in-prompt)1110 5011 y Fu(If)24
b(set)h(to)g(`)p Ft(on)p Fu(',)g(add)f(a)h(string)f(to)h(the)f(b)s
(eginning)g(of)g(the)h(prompt)e(indicating)1110 4756
(eginning)g(of)g(the)h(prompt)e(indicating)1110 5121
y(the)33 b(editing)h(mo)s(de:)46 b(emacs,)35 b(vi)e(command,)h(or)f(vi)
h(insertion.)49 b(The)32 b(mo)s(de)1110 4865 y(strings)45
h(insertion.)49 b(The)32 b(mo)s(de)1110 5230 y(strings)45
b(are)h(user-settable)g(\(e.g.,)51 b Fr(emacs-mo)s(de-string)8
b Fu(\).)87 b(The)45 b(default)1110 4975 y(v)-5 b(alue)31
b(is)f(`)p Ft(off)p Fu('.)630 5121 y Ft(skip-completed-text)1110
5230 y Fu(If)i(set)i(to)f(`)p Ft(on)p Fu(',)h(this)f(alters)g(the)g
(default)g(completion)h(b)s(eha)m(vior)f(when)f(in-)1110
5340 y(serting)d(a)h(single)g(matc)m(h)f(in)m(to)h(the)g(line.)40
b(It's)30 b(only)f(activ)m(e)i(when)d(p)s(erform-)p eop
end
b Fu(\).)87 b(The)45 b(default)1110 5340 y(v)-5 b(alue)31
b(is)f(`)p Ft(off)p Fu('.)p eop end
%%Page: 127 133
TeXDict begin 127 132 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(127)1110 299 y(ing)35
b(completion)h(in)e(the)h(middle)f(of)h(a)f(w)m(ord.)53
b(If)35 b(enabled,)g(readline)g(do)s(es)1110 408 y(not)41
b(Command)29 b(Line)i(Editing)2062 b(127)630 299 y Ft
(skip-completed-text)1110 408 y Fu(If)32 b(set)i(to)f(`)p
Ft(on)p Fu(',)h(this)f(alters)g(the)g(default)g(completion)h(b)s(eha)m
(vior)f(when)f(in-)1110 518 y(serting)d(a)h(single)g(matc)m(h)f(in)m
(to)h(the)g(line.)40 b(It's)30 b(only)f(activ)m(e)i(when)d(p)s(erform-)
1110 628 y(ing)35 b(completion)h(in)e(the)h(middle)f(of)h(a)f(w)m(ord.)
53 b(If)35 b(enabled,)g(readline)g(do)s(es)1110 737 y(not)41
b(insert)f(c)m(haracters)i(from)e(the)h(completion)h(that)f(matc)m(h)g
(c)m(haracters)1110 518 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f(b)
(c)m(haracters)1110 847 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f(b)
s(eing)g(completed,)k(so)d(p)s(ortions)f(of)h(the)g(w)m(ord)1110
628 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45
956 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45
b(F)-8 b(or)32 b(instance,)h(if)f(this)f(is)h(en-)1110
737 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g
(after)h(the)g(`)p Ft(e)p Fu(')f(in)1110 847 y(`)p Ft(Makefile)p
1066 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g
(after)h(the)g(`)p Ft(e)p Fu(')f(in)1110 1176 y(`)p Ft(Makefile)p
Fu(')c(will)i(result)f(in)g(`)p Ft(Makefile)p Fu(')f(rather)h(than)h(`)
p Ft(Makefilefile)p Fu(',)1110 956 y(assuming)d(there)g(is)h(a)f
p Ft(Makefilefile)p Fu(',)1110 1285 y(assuming)d(there)g(is)h(a)f
(single)h(p)s(ossible)f(completion.)56 b(The)35 b(default)g(v)-5
b(alue)1110 1066 y(is)30 b(`)p Ft(off)p Fu('.)630 1215
y Ft(vi-cmd-mode-string)1110 1325 y Fu(If)j(the)h Fr(sho)m(w-mo)s
b(alue)1110 1395 y(is)30 b(`)p Ft(off)p Fu('.)630 1548
y Ft(vi-cmd-mode-string)1110 1658 y Fu(If)j(the)h Fr(sho)m(w-mo)s
(de-in-prompt)h Fu(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f
(is)h(dis-)1110 1435 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)
(is)h(dis-)1110 1767 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)
g(last)h(line)f(of)h(the)f(primary)f(prompt)g(when)1110
1544 y(vi)32 b(editing)h(mo)s(de)f(is)g(activ)m(e)j(and)c(in)h(command)
1877 y(vi)32 b(editing)h(mo)s(de)f(is)g(activ)m(e)j(and)c(in)h(command)
g(mo)s(de.)46 b(The)31 b(v)-5 b(alue)33 b(is)f(ex-)1110
1654 y(panded)26 b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f
1987 y(panded)26 b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f
(standard)f(set)h(of)g(meta-)h(and)e(con)m(trol)1110
1763 y(pre\014xes)34 b(and)g(bac)m(kslash)i(escap)s(e)g(sequences)f(is)
2096 y(pre\014xes)34 b(and)g(bac)m(kslash)i(escap)s(e)g(sequences)f(is)
g(a)m(v)-5 b(ailable.)57 b(Use)35 b(the)g(`)p Ft(\\1)p
Fu(')1110 1873 y(and)23 b(`)p Ft(\\2)p Fu(')h(escap)s(es)h(to)f(b)s
Fu(')1110 2206 y(and)23 b(`)p Ft(\\2)p Fu(')h(escap)s(es)h(to)f(b)s
(egin)g(and)f(end)g(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110
1983 y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a)
h(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 2092
2315 y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a)
h(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 2425
y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p
Ft(\(cmd\))p Fu('.)630 2242 y Ft(vi-ins-mode-string)1110
2351 y Fu(If)j(the)h Fr(sho)m(w-mo)s(de-in-prompt)h Fu(v)-5
Ft(\(cmd\))p Fu('.)630 2578 y Ft(vi-ins-mode-string)1110
2688 y Fu(If)j(the)h Fr(sho)m(w-mo)s(de-in-prompt)h Fu(v)-5
b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110
2461 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f
(of)h(the)f(primary)f(prompt)g(when)1110 2570 y(vi)35
2798 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f
(of)h(the)f(primary)f(prompt)g(when)1110 2907 y(vi)35
b(editing)h(mo)s(de)e(is)i(activ)m(e)h(and)d(in)h(insertion)g(mo)s(de.)
54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 2680 y(panded)26
54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 3017 y(panded)26
b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f(standard)f(set)h(of)g
(meta-)h(and)e(con)m(trol)1110 2790 y(pre\014xes)34 b(and)g(bac)m
(meta-)h(and)e(con)m(trol)1110 3126 y(pre\014xes)34 b(and)g(bac)m
(kslash)i(escap)s(e)g(sequences)f(is)g(a)m(v)-5 b(ailable.)57
b(Use)35 b(the)g(`)p Ft(\\1)p Fu(')1110 2899 y(and)23
b(Use)35 b(the)g(`)p Ft(\\1)p Fu(')1110 3236 y(and)23
b(`)p Ft(\\2)p Fu(')h(escap)s(es)h(to)f(b)s(egin)g(and)f(end)g
(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 3009
(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 3345
y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a)h
(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 3118
(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 3455
y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p
Ft(\(ins\))p Fu('.)630 3268 y Ft(visible-stats)1110 3377
Ft(\(ins\))p Fu('.)630 3608 y Ft(visible-stats)1110 3718
y Fu(If)h(set)i(to)f(`)p Ft(on)p Fu(',)h(a)f(c)m(haracter)i(denoting)e
(a)g(\014le's)g(t)m(yp)s(e)g(is)g(app)s(ended)e(to)j(the)1110
3487 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42
b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)150 3636
y(Key)f(Bindings)630 3746 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h
3828 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42
b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)150 3981
y(Key)f(Bindings)630 4091 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h
(k)m(ey)g(bindings)e(in)h(the)g(init)g(\014le)g(is)g(simple.)75
b(First)43 b(y)m(ou)630 3856 y(need)27 b(to)i(\014nd)d(the)i(name)f(of)
b(First)43 b(y)m(ou)630 4200 y(need)27 b(to)i(\014nd)d(the)i(name)f(of)
h(the)g(command)f(that)i(y)m(ou)f(w)m(an)m(t)g(to)g(c)m(hange.)41
b(The)27 b(follo)m(wing)630 3965 y(sections)37 b(con)m(tain)g(tables)g
b(The)27 b(follo)m(wing)630 4310 y(sections)37 b(con)m(tain)g(tables)g
(of)f(the)g(command)f(name,)j(the)e(default)g(k)m(eybinding,)h(if)f(an)
m(y)-8 b(,)630 4075 y(and)30 b(a)h(short)f(description)g(of)h(what)f
(the)g(command)h(do)s(es.)630 4204 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g
m(y)-8 b(,)630 4419 y(and)30 b(a)h(short)f(description)g(of)h(what)f
(the)g(command)h(do)s(es.)630 4551 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g
(name)g(of)g(the)g(command,)h(simply)f(place)h(on)e(a)i(line)f(in)g
(the)g(init)630 4314 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m
(the)g(init)630 4661 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m
(ou)g(wish)f(to)h(bind)f(the)h(command)f(to,)i(a)f(colon,)i(and)d(then)
630 4423 y(the)f(name)h(of)f(the)g(command.)46 b(There)32
630 4770 y(the)f(name)h(of)f(the)g(command.)46 b(There)32
b(can)g(b)s(e)g(no)g(space)g(b)s(et)m(w)m(een)h(the)f(k)m(ey)h(name)g
(and)630 4533 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m
(and)630 4880 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m
(terpreted)g(as)g(part)f(of)h(the)g(k)m(ey)h(name.)72
b(The)40 b(name)h(of)630 4643 y(the)35 b(k)m(ey)g(can)g(b)s(e)f
b(The)40 b(name)h(of)630 4989 y(the)35 b(k)m(ey)g(can)g(b)s(e)f
(expressed)f(in)i(di\013eren)m(t)g(w)m(a)m(ys,)h(dep)s(ending)d(on)h
(what)h(y)m(ou)g(\014nd)e(most)630 4752 y(comfortable.)630
4882 y(In)i(addition)h(to)h(command)f(names,)i(readline)e(allo)m(ws)h
(what)h(y)m(ou)g(\014nd)e(most)630 5099 y(comfortable.)630
5230 y(In)i(addition)h(to)h(command)f(names,)i(readline)e(allo)m(ws)h
(k)m(eys)g(to)g(b)s(e)e(b)s(ound)f(to)j(a)f(string)630
4991 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g
(\(a)h Fr(macro)5 b Fu(\).)630 5121 y(The)42 b Ft(bind)30
b(-p)42 b Fu(command)h(displa)m(ys)g(Readline)g(function)g(names)g(and)
f(bindings)g(in)h(a)630 5230 y(format)37 b(that)h(can)f(put)f(directly)
i(in)m(to)g(an)f(initialization)j(\014le.)60 b(See)38
b(Section)f(4.2)i([Bash)630 5340 y(Builtins],)31 b(page)g(55.)p
eop end
5340 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g
(\(a)h Fr(macro)5 b Fu(\).)p eop end
%%Page: 128 134
TeXDict begin 128 133 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(128)630 299 y Fr(k)m(eyname)5
b Fu(:)42 b Fr(function-name)35 b Fu(or)c Fr(macro)1110
408 y(k)m(eyname)k Fu(is)29 b(the)f(name)h(of)g(a)g(k)m(ey)h(sp)s
b(Command)29 b(Line)i(Editing)2062 b(128)630 299 y(The)42
b Ft(bind)30 b(-p)42 b Fu(command)h(displa)m(ys)g(Readline)g(function)g
(names)g(and)f(bindings)g(in)h(a)630 408 y(format)28
b(that)h(can)f(b)s(e)f(put)g(directly)i(in)m(to)f(an)g(initialization)j
(\014le.)40 b(See)28 b(Section)h(4.2)g([Bash)630 518
y(Builtins],)i(page)g(55.)630 673 y Fr(k)m(eyname)5 b
Fu(:)42 b Fr(function-name)35 b Fu(or)c Fr(macro)1110
783 y(k)m(eyname)k Fu(is)29 b(the)f(name)h(of)g(a)g(k)m(ey)h(sp)s
(elled)e(out)h(in)g(English.)39 b(F)-8 b(or)30 b(example:)1350
543 y Ft(Control-u:)45 b(universal-argument)1350 652
y(Meta-Rubout:)f(backward-kill-word)1350 762 y(Control-o:)h(">)i
(output")1110 896 y Fu(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112
915 y Ft(Control-u:)45 b(universal-argument)1350 1024
y(Meta-Rubout:)f(backward-kill-word)1350 1134 y(Control-o:)h(">)i
(output")1110 1266 y Fu(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112
b Fj(C-u)94 b Fu(is)g(b)s(ound)f(to)i(the)f(function)1110
1006 y Ft(universal-argument)p Fu(,)124 b Fj(M-DEL)107
b Fu(is)i(b)s(ound)e(to)j(the)f(function)1110 1115 y
1376 y Ft(universal-argument)p Fu(,)124 b Fj(M-DEL)107
b Fu(is)i(b)s(ound)e(to)j(the)f(function)1110 1485 y
Ft(backward-kill-word)p Fu(,)75 b(and)69 b Fj(C-o)g Fu(is)h(b)s(ound)e
(to)j(run)d(the)i(macro)1110 1225 y(expressed)45 b(on)h(the)g(righ)m(t)
(to)j(run)d(the)i(macro)1110 1595 y(expressed)45 b(on)h(the)g(righ)m(t)
g(hand)e(side)i(\(that)h(is,)i(to)e(insert)e(the)h(text)h(`)p
Ft(>)1110 1335 y(output)p Fu(')29 b(in)m(to)i(the)g(line\).)1110
1469 y(A)62 b(n)m(um)m(b)s(er)e(of)i(sym)m(b)s(olic)h(c)m(haracter)g
(names)f(are)g(recognized)h(while)1110 1579 y(pro)s(cessing)40
Ft(>)1110 1705 y(output)p Fu(')29 b(in)m(to)i(the)g(line\).)1110
1837 y(A)62 b(n)m(um)m(b)s(er)e(of)i(sym)m(b)s(olic)h(c)m(haracter)g
(names)f(are)g(recognized)h(while)1110 1946 y(pro)s(cessing)40
b(this)f(k)m(ey)i(binding)e(syn)m(tax:)60 b Fr(DEL)p
Fu(,)42 b Fr(ESC)p Fu(,)g Fr(ESCAPE)p Fu(,)f Fr(LFD)p
Fu(,)1110 1688 y Fr(NEWLINE)p Fu(,)31 b Fr(RET)p Fu(,)f
Fu(,)1110 2056 y Fr(NEWLINE)p Fu(,)31 b Fr(RET)p Fu(,)f
Fr(RETURN)p Fu(,)g Fr(R)m(UBOUT)p Fu(,)h Fr(SP)-8 b(A)m(CE)p
Fu(,)31 b Fr(SPC)p Fu(,)e(and)h Fr(T)-8 b(AB)p Fu(.)630
1847 y Ft(")p Fr(k)m(eyseq)r Ft(")p Fu(:)41 b Fr(function-name)36
b Fu(or)30 b Fr(macro)1110 1957 y(k)m(eyseq)k Fu(di\013ers)d(from)f
2211 y Ft(")p Fr(k)m(eyseq)r Ft(")p Fu(:)41 b Fr(function-name)36
b Fu(or)30 b Fr(macro)1110 2321 y(k)m(eyseq)k Fu(di\013ers)d(from)f
Fr(k)m(eyname)37 b Fu(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f
(denoting)g(an)g(en-)1110 2066 y(tire)j(k)m(ey)h(sequence)f(can)g(b)s
(denoting)g(an)g(en-)1110 2430 y(tire)j(k)m(ey)h(sequence)f(can)g(b)s
(e)f(sp)s(eci\014ed,)h(b)m(y)f(placing)i(the)f(k)m(ey)g(sequence)g(in)
1110 2176 y(double)29 b(quotes.)41 b(Some)29 b Fm(gnu)h
1110 2540 y(double)29 b(quotes.)41 b(Some)29 b Fm(gnu)h
Fu(Emacs)f(st)m(yle)i(k)m(ey)f(escap)s(es)g(can)g(b)s(e)f(used,)g(as)
1110 2286 y(in)k(the)h(follo)m(wing)i(example,)f(but)e(the)h(sp)s
(ecial)h(c)m(haracter)g(names)f(are)g(not)1110 2395 y(recognized.)1350
2530 y Ft("\\C-u":)46 b(universal-argument)1350 2639
y("\\C-x\\C-r":)f(re-read-init-file)1350 2749 y("\\e[11~":)g("Function)
h(Key)g(1")1110 2883 y Fu(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74
1110 2649 y(in)k(the)h(follo)m(wing)i(example,)f(but)e(the)h(sp)s
(ecial)h(c)m(haracter)g(names)f(are)g(not)1110 2759 y(recognized.)1350
2891 y Ft("\\C-u":)46 b(universal-argument)1350 3001
y("\\C-x\\C-r":)f(re-read-init-file)1350 3110 y("\\e[11~":)g("Function)
h(Key)g(1")1110 3243 y Fu(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74
b Fj(C-u)64 b Fu(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110
2993 y Ft(universal-argument)39 b Fu(\(just)k(as)h(it)g(w)m(as)g(in)g
(the)f(\014rst)g(example\),)49 b(`)p Fj(C-x)1110 3102
3352 y Ft(universal-argument)39 b Fu(\(just)k(as)h(it)g(w)m(as)g(in)g
(the)f(\014rst)g(example\),)49 b(`)p Fj(C-x)1110 3462
y(C-r)p Fu(')30 b(is)g(b)s(ound)e(to)j(the)g(function)f
Ft(re-read-init-file)p Fu(,)c(and)j(`)p Ft(ESC)h([)g(1)g(1)1110
3212 y(~)p Fu(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p
Ft(Function)e(Key)g(1)p Fu('.)630 3371 y(The)g(follo)m(wing)i
3571 y(~)p Fu(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p
Ft(Function)e(Key)g(1)p Fu('.)630 3726 y(The)g(follo)m(wing)i
Fm(gnu)f Fu(Emacs)g(st)m(yle)h(escap)s(e)f(sequences)g(are)g(a)m(v)-5
b(ailable)32 b(when)d(sp)s(ecifying)630 3480 y(k)m(ey)i(sequences:)630
3640 y Fj(\\C-)336 b Fu(con)m(trol)32 b(pre\014x)630
3799 y Fj(\\M-)336 b Fu(meta)31 b(pre\014x)630 3958 y
b(ailable)32 b(when)d(sp)s(ecifying)630 3836 y(k)m(ey)i(sequences:)630
3991 y Fj(\\C-)336 b Fu(con)m(trol)32 b(pre\014x)630
4146 y Fj(\\M-)336 b Fu(meta)31 b(pre\014x)630 4301 y
Fj(\\e)384 b Fu(an)30 b(escap)s(e)h(c)m(haracter)630
4117 y Fj(\\\\)384 b Fu(bac)m(kslash)630 4276 y Fj(\\)p
4456 y Fj(\\\\)384 b Fu(bac)m(kslash)630 4611 y Fj(\\)p
Ft(")g(")p Fu(,)30 b(a)h(double)f(quotation)i(mark)630
4435 y Fj(\\')384 b Ft(')p Fu(,)30 b(a)h(single)g(quote)g(or)f(ap)s
(ostrophe)630 4594 y(In)d(addition)h(to)g(the)g Fm(gnu)f
4766 y Fj(\\')384 b Ft(')p Fu(,)30 b(a)h(single)g(quote)g(or)f(ap)s
(ostrophe)630 4921 y(In)d(addition)h(to)g(the)g Fm(gnu)f
Fu(Emacs)h(st)m(yle)h(escap)s(e)f(sequences,)h(a)f(second)f(set)h(of)g
(bac)m(kslash)630 4704 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630
4863 y Ft(\\a)384 b Fu(alert)31 b(\(b)s(ell\))630 5022
y Ft(\\b)384 b Fu(bac)m(kspace)630 5181 y Ft(\\d)g Fu(delete)630
5340 y Ft(\\f)g Fu(form)30 b(feed)p eop end
(bac)m(kslash)630 5030 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630
5185 y Ft(\\a)384 b Fu(alert)31 b(\(b)s(ell\))630 5340
y Ft(\\b)384 b Fu(bac)m(kspace)p eop end
%%Page: 129 135
TeXDict begin 129 134 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(129)630 299 y Ft(\\n)384
b Fu(newline)630 459 y Ft(\\r)g Fu(carriage)32 b(return)630
619 y Ft(\\t)384 b Fu(horizon)m(tal)32 b(tab)630 779
y Ft(\\v)384 b Fu(v)m(ertical)32 b(tab)630 939 y Ft(\\)p
Fj(nnn)288 b Fu(the)35 b(eigh)m(t-bit)h(c)m(haracter)g(whose)e(v)-5
b(alue)35 b(is)g(the)f(o)s(ctal)i(v)-5 b(alue)35 b Fr(nnn)e
Fu(\(one)i(to)1110 1049 y(three)c(digits\))630 1209 y
Ft(\\x)p Fj(HH)288 b Fu(the)38 b(eigh)m(t-bit)i(c)m(haracter)g(whose)e
(v)-5 b(alue)39 b(is)f(the)h(hexadecimal)g(v)-5 b(alue)39
b Fr(HH)1110 1318 y Fu(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))630
1478 y(When)37 b(en)m(tering)h(the)g(text)g(of)g(a)g(macro,)i(single)e
(or)f(double)g(quotes)h(m)m(ust)f(b)s(e)g(used)f(to)630
1588 y(indicate)23 b(a)e(macro)h(de\014nition.)38 b(Unquoted)21
b(text)i(is)e(assumed)g(to)h(b)s(e)f(a)h(function)f(name.)38
b(In)630 1697 y(the)22 b(macro)f(b)s(o)s(dy)-8 b(,)23
b(the)e(bac)m(kslash)h(escap)s(es)g(describ)s(ed)e(ab)s(o)m(v)m(e)j
(are)e(expanded.)37 b(Bac)m(kslash)630 1807 y(will)j(quote)h(an)m(y)f
(other)g(c)m(haracter)i(in)d(the)i(macro)f(text,)k(including)39
b(Command)29 b(Line)i(Editing)2062 b(129)630 299 y Ft(\\d)384
b Fu(delete)630 460 y Ft(\\f)g Fu(form)30 b(feed)630
620 y Ft(\\n)384 b Fu(newline)630 781 y Ft(\\r)g Fu(carriage)32
b(return)630 941 y Ft(\\t)384 b Fu(horizon)m(tal)32 b(tab)630
1102 y Ft(\\v)384 b Fu(v)m(ertical)32 b(tab)630 1263
y Ft(\\)p Fj(nnn)288 b Fu(the)35 b(eigh)m(t-bit)h(c)m(haracter)g(whose)
e(v)-5 b(alue)35 b(is)g(the)f(o)s(ctal)i(v)-5 b(alue)35
b Fr(nnn)e Fu(\(one)i(to)1110 1372 y(three)c(digits\))630
1533 y Ft(\\x)p Fj(HH)288 b Fu(the)38 b(eigh)m(t-bit)i(c)m(haracter)g
(whose)e(v)-5 b(alue)39 b(is)f(the)h(hexadecimal)g(v)-5
b(alue)39 b Fr(HH)1110 1643 y Fu(\(one)31 b(or)f(t)m(w)m(o)i(hex)e
(digits\))630 1803 y(When)37 b(en)m(tering)h(the)g(text)g(of)g(a)g
(macro,)i(single)e(or)f(double)g(quotes)h(m)m(ust)f(b)s(e)g(used)f(to)
630 1913 y(indicate)23 b(a)e(macro)h(de\014nition.)38
b(Unquoted)21 b(text)i(is)e(assumed)g(to)h(b)s(e)f(a)h(function)f
(name.)38 b(In)630 2022 y(the)22 b(macro)f(b)s(o)s(dy)-8
b(,)23 b(the)e(bac)m(kslash)h(escap)s(es)g(describ)s(ed)e(ab)s(o)m(v)m
(e)j(are)e(expanded.)37 b(Bac)m(kslash)630 2132 y(will)j(quote)h(an)m
(y)f(other)g(c)m(haracter)i(in)d(the)i(macro)f(text,)k(including)39
b(`)p Ft(")p Fu(')h(and)g(`)p Ft(')p Fu('.)69 b(F)-8
b(or)630 1917 y(example,)28 b(the)e(follo)m(wing)h(binding)d(will)i
b(or)630 2242 y(example,)28 b(the)e(follo)m(wing)h(binding)d(will)i
(mak)m(e)h(`)p Fj(C-x)j Ft(\\)p Fu(')c(insert)f(a)h(single)h(`)p
Ft(\\)p Fu(')f(in)m(to)g(the)g(line:)870 2051 y Ft("\\C-x\\\\":)45
b("\\\\")150 2251 y Fk(8.3.2)63 b(Conditional)41 b(Init)g(Constructs)
150 2398 y Fu(Readline)c(implemen)m(ts)g(a)h(facilit)m(y)g(similar)f
Ft(\\)p Fu(')f(in)m(to)g(the)g(line:)870 2377 y Ft("\\C-x\\\\":)45
b("\\\\")150 2577 y Fk(8.3.2)63 b(Conditional)41 b(Init)g(Constructs)
150 2724 y Fu(Readline)c(implemen)m(ts)g(a)h(facilit)m(y)g(similar)f
(in)g(spirit)f(to)i(the)f(conditional)h(compilation)g(features)f(of)150
2508 y(the)31 b(C)f(prepro)s(cessor)g(whic)m(h)g(allo)m(ws)i(k)m(ey)g
2834 y(the)31 b(C)f(prepro)s(cessor)g(whic)m(h)g(allo)m(ws)i(k)m(ey)g
(bindings)d(and)h(v)-5 b(ariable)32 b(settings)f(to)h(b)s(e)e(p)s
(erformed)f(as)i(the)150 2617 y(result)f(of)h(tests.)41
(erformed)f(as)i(the)150 2943 y(result)f(of)h(tests.)41
b(There)30 b(are)h(four)f(parser)f(directiv)m(es)j(used.)150
2778 y Ft($if)336 b Fu(The)31 b Ft($if)f Fu(construct)i(allo)m(ws)h
3105 y Ft($if)336 b Fu(The)31 b Ft($if)f Fu(construct)i(allo)m(ws)h
(bindings)d(to)i(b)s(e)e(made)i(based)f(on)g(the)g(editing)h(mo)s(de,)g
(the)630 2887 y(terminal)37 b(b)s(eing)f(used,)h(or)f(the)h
(the)630 3214 y(terminal)37 b(b)s(eing)f(used,)h(or)f(the)h
(application)g(using)f(Readline.)59 b(The)36 b(text)h(of)f(the)h(test,)
630 2997 y(after)30 b(an)m(y)g(comparison)g(op)s(erator,)g(extends)f
630 3324 y(after)30 b(an)m(y)g(comparison)g(op)s(erator,)g(extends)f
(to)h(the)g(end)f(of)h(the)f(line;)i(unless)e(otherwise)630
3106 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i
(it.)630 3267 y Ft(mode)288 b Fu(The)30 b Ft(mode=)e
3433 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i
(it.)630 3594 y Ft(mode)288 b Fu(The)30 b Ft(mode=)e
Fu(form)i(of)g(the)h Ft($if)e Fu(directiv)m(e)j(is)e(used)f(to)i(test)g
(whether)e(Read-)1110 3376 y(line)44 b(is)f(in)g Ft(emacs)f
(whether)e(Read-)1110 3704 y(line)44 b(is)f(in)g Ft(emacs)f
Fu(or)h Ft(vi)g Fu(mo)s(de.)79 b(This)42 b(ma)m(y)i(b)s(e)e(used)h(in)g
(conjunction)1110 3486 y(with)c(the)h(`)p Ft(set)29 b(keymap)p
(conjunction)1110 3813 y(with)c(the)h(`)p Ft(set)29 b(keymap)p
Fu(')38 b(command,)k(for)d(instance,)j(to)e(set)g(bindings)e(in)1110
3595 y(the)32 b Ft(emacs-standard)c Fu(and)j Ft(emacs-ctlx)d
Fu(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 3705 y(starting)f(out)g
(in)f Ft(emacs)f Fu(mo)s(de.)630 3865 y Ft(term)288 b
3923 y(the)32 b Ft(emacs-standard)c Fu(and)j Ft(emacs-ctlx)d
Fu(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 4032 y(starting)f(out)g
(in)f Ft(emacs)f Fu(mo)s(de.)630 4193 y Ft(term)288 b
Fu(The)26 b Ft(term=)g Fu(form)g(ma)m(y)i(b)s(e)e(used)g(to)i(include)f
(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 3974 y(ings,)38
(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 4303 y(ings,)38
b(p)s(erhaps)c(to)j(bind)e(the)h(k)m(ey)h(sequences)f(output)g(b)m(y)g
(the)g(terminal's)1110 4084 y(function)24 b(k)m(eys.)39
(the)g(terminal's)1110 4412 y(function)24 b(k)m(eys.)39
b(The)23 b(w)m(ord)h(on)f(the)i(righ)m(t)f(side)g(of)g(the)g(`)p
Ft(=)p Fu(')g(is)g(tested)h(against)1110 4194 y(b)s(oth)k(the)h(full)g
Ft(=)p Fu(')g(is)g(tested)h(against)1110 4522 y(b)s(oth)k(the)h(full)g
(name)g(of)g(the)g(terminal)h(and)e(the)i(p)s(ortion)e(of)h(the)g
(terminal)1110 4303 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p
(terminal)1110 4631 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p
Ft(-)p Fu('.)50 b(This)33 b(allo)m(ws)i Ft(sun)e Fu(to)h(matc)m(h)g(b)s
(oth)f Ft(sun)g Fu(and)1110 4413 y Ft(sun-cmd)p Fu(,)c(for)h(instance.)
630 4573 y Ft(version)144 b Fu(The)44 b Ft(version)f
(oth)f Ft(sun)g Fu(and)1110 4741 y Ft(sun-cmd)p Fu(,)c(for)h(instance.)
630 4902 y Ft(version)144 b Fu(The)44 b Ft(version)f
Fu(test)i(ma)m(y)h(b)s(e)e(used)f(to)j(p)s(erform)d(comparisons)i
(against)1110 4682 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74
(against)1110 5011 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74
b(The)42 b Ft(version)d Fu(expands)i(to)h(the)g(curren)m(t)1110
4792 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h
5121 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h
(op)s(erators)f(includes)f(`)p Ft(=)p Fu(')h(\(and)1110
4902 y(`)p Ft(==)p Fu('\),)33 b(`)p Ft(!=)p Fu(',)f(`)p
5230 y(`)p Ft(==)p Fu('\),)33 b(`)p Ft(!=)p Fu(',)f(`)p
Ft(<=)p Fu(',)h(`)p Ft(>=)p Fu(',)f(`)p Ft(<)p Fu(',)h(and)e(`)p
Ft(>)p Fu('.)46 b(The)31 b(v)m(ersion)i(n)m(um)m(b)s(er)d(supplied)h
(on)1110 5011 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g
(consists)h(of)f(a)g(ma)5 b(jor)35 b(v)m(ersion)f(n)m(um)m(b)s(er,)1110
5121 y(an)45 b(optional)i(decimal)f(p)s(oin)m(t,)k(and)44
b(an)i(optional)g(minor)f(v)m(ersion)h(\(e.g.,)1110 5230
y(`)p Ft(7.1)p Fu('\).)40 b(If)27 b(the)h(minor)f(v)m(ersion)h(is)g
(omitted,)h(it)f(is)g(assumed)f(to)h(b)s(e)f(`)p Ft(0)p
Fu('.)40 b(The)1110 5340 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated)
g(from)g(the)h(string)f Ft(version)f Fu(and)h(from)g(the)p
(on)1110 5340 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g
(consists)h(of)f(a)g(ma)5 b(jor)35 b(v)m(ersion)f(n)m(um)m(b)s(er,)p
eop end
%%Page: 130 136
TeXDict begin 130 135 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(130)1110 299 y(v)m(ersion)39
b(Command)29 b(Line)i(Editing)2062 b(130)1110 299 y(an)45
b(optional)i(decimal)f(p)s(oin)m(t,)k(and)44 b(an)i(optional)g(minor)f
(v)m(ersion)h(\(e.g.,)1110 408 y(`)p Ft(7.1)p Fu('\).)40
b(If)27 b(the)h(minor)f(v)m(ersion)h(is)g(omitted,)h(it)f(is)g(assumed)
f(to)h(b)s(e)f(`)p Ft(0)p Fu('.)40 b(The)1110 518 y(op)s(erator)34
b(ma)m(y)g(b)s(e)f(separated)g(from)g(the)h(string)f
Ft(version)f Fu(and)h(from)g(the)1110 628 y(v)m(ersion)39
b(n)m(um)m(b)s(er)f(argumen)m(t)h(b)m(y)f(whitespace.)67
b(The)38 b(follo)m(wing)i(example)1110 408 y(sets)31
b(The)38 b(follo)m(wing)i(example)1110 737 y(sets)31
b(a)g(v)-5 b(ariable)31 b(if)f(the)h(Readline)g(v)m(ersion)f(b)s(eing)g
(used)g(is)g(7.0)i(or)e(new)m(er:)1350 543 y Ft($if)47
b(version)f(>=)h(7.0)1350 653 y(set)g(show-mode-in-prompt)42
b(on)1350 762 y($endif)630 922 y(application)1110 1031
(used)g(is)g(7.0)i(or)e(new)m(er:)1350 872 y Ft($if)47
b(version)f(>=)h(7.0)1350 981 y(set)g(show-mode-in-prompt)42
b(on)1350 1091 y($endif)630 1250 y(application)1110 1360
y Fu(The)21 b Fr(application)j Fu(construct)e(is)g(used)f(to)i(include)
f(application-sp)s(eci\014c)h(set-)1110 1141 y(tings.)39
f(application-sp)s(eci\014c)h(set-)1110 1469 y(tings.)39
b(Eac)m(h)26 b(program)e(using)g(the)h(Readline)g(library)g(sets)g(the)
g Fr(application)1110 1250 y(name)p Fu(,)g(and)e(y)m(ou)g(can)h(test)g
g Fr(application)1110 1579 y(name)p Fu(,)g(and)e(y)m(ou)g(can)h(test)g
(for)f(a)g(particular)h(v)-5 b(alue.)39 b(This)22 b(could)h(b)s(e)g
(used)f(to)1110 1360 y(bind)32 b(k)m(ey)h(sequences)g(to)h(functions)e
(used)f(to)1110 1689 y(bind)32 b(k)m(ey)h(sequences)g(to)h(functions)e
(useful)g(for)h(a)g(sp)s(eci\014c)f(program.)48 b(F)-8
b(or)1110 1469 y(instance,)35 b(the)e(follo)m(wing)h(command)f(adds)f
(a)i(k)m(ey)f(sequence)h(that)f(quotes)1110 1579 y(the)e(curren)m(t)f
(or)g(previous)g(w)m(ord)g(in)g(Bash:)1350 1714 y Ft($if)47
b(Bash)1350 1823 y(#)g(Quote)g(the)g(current)f(or)h(previous)e(word)
1350 1933 y("\\C-xq":)h("\\eb\\"\\ef\\"")1350 2042 y($endif)630
2202 y(variable)96 b Fu(The)33 b Fr(v)-5 b(ariable)39
b(or)1110 1798 y(instance,)35 b(the)e(follo)m(wing)h(command)f(adds)f
(a)i(k)m(ey)f(sequence)h(that)f(quotes)1110 1908 y(the)e(curren)m(t)f
(or)g(previous)g(w)m(ord)g(in)g(Bash:)1350 2042 y Ft($if)47
b(Bash)1350 2152 y(#)g(Quote)g(the)g(current)f(or)h(previous)e(word)
1350 2262 y("\\C-xq":)h("\\eb\\"\\ef\\"")1350 2371 y($endif)630
2531 y(variable)96 b Fu(The)33 b Fr(v)-5 b(ariable)39
b Fu(construct)33 b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g
(Readline)1110 2311 y(v)-5 b(ariables)32 b(and)f(v)-5
(Readline)1110 2640 y(v)-5 b(ariables)32 b(and)f(v)-5
b(alues.)45 b(The)32 b(p)s(ermitted)f(comparison)h(op)s(erators)f(are)i
(`)p Ft(=)p Fu(',)1110 2421 y(`)p Ft(==)p Fu(',)49 b(and)44
(`)p Ft(=)p Fu(',)1110 2750 y(`)p Ft(==)p Fu(',)49 b(and)44
b(`)p Ft(!=)p Fu('.)85 b(The)44 b(v)-5 b(ariable)46 b(name)f(m)m(ust)g
(b)s(e)g(separated)g(from)g(the)1110 2531 y(comparison)25
(b)s(e)g(separated)g(from)g(the)1110 2859 y(comparison)25
b(op)s(erator)g(b)m(y)g(whitespace;)j(the)d(op)s(erator)g(ma)m(y)g(b)s
(e)f(separated)1110 2640 y(from)33 b(the)h(v)-5 b(alue)35
(e)f(separated)1110 2969 y(from)33 b(the)h(v)-5 b(alue)35
b(on)f(the)g(righ)m(t)g(hand)f(side)h(b)m(y)f(whitespace.)52
b(Both)35 b(string)1110 2750 y(and)i(b)s(o)s(olean)g(v)-5
b(Both)35 b(string)1110 3078 y(and)i(b)s(o)s(olean)g(v)-5
b(ariables)38 b(ma)m(y)h(b)s(e)d(tested.)63 b(Bo)s(olean)39
b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 2859 y(tested)46
b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 3188 y(tested)46
b(against)g(the)f(v)-5 b(alues)46 b Fr(on)f Fu(and)f
Fr(o\013)p Fu(.)85 b(The)45 b(follo)m(wing)h(example)g(is)1110
2969 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Ft(mode=emacs)e
Fu(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 3103 y
Ft($if)47 b(editing-mode)d(==)k(emacs)1350 3213 y(set)f
(show-mode-in-prompt)42 b(on)1350 3323 y($endif)150 3482
3298 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Ft(mode=emacs)e
Fu(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 3432 y
Ft($if)47 b(editing-mode)d(==)k(emacs)1350 3542 y(set)f
(show-mode-in-prompt)42 b(on)1350 3651 y($endif)150 3811
y($endif)192 b Fu(This)29 b(command,)i(as)f(seen)h(in)f(the)g(previous)
g(example,)h(terminates)g(an)g Ft($if)e Fu(command.)150
3641 y Ft($else)240 b Fu(Commands)29 b(in)h(this)h(branc)m(h)e(of)i
3970 y Ft($else)240 b Fu(Commands)29 b(in)h(this)h(branc)m(h)e(of)i
(the)f Ft($if)g Fu(directiv)m(e)i(are)f(executed)g(if)f(the)h(test)g
(fails.)150 3801 y Ft($include)96 b Fu(This)43 b(directiv)m(e)i(tak)m
(fails.)150 4130 y Ft($include)96 b Fu(This)43 b(directiv)m(e)i(tak)m
(es)g(a)e(single)i(\014lename)e(as)h(an)f(argumen)m(t)h(and)f(reads)g
(commands)630 3910 y(and)38 b(bindings)f(from)h(that)i(\014le.)65
(commands)630 4239 y(and)38 b(bindings)f(from)h(that)i(\014le.)65
b(F)-8 b(or)39 b(example,)j(the)d(follo)m(wing)h(directiv)m(e)g(reads)e
(from)630 4020 y Ft(/etc/inputrc)p Fu(:)870 4154 y Ft($include)46
b(/etc/inputrc)150 4354 y Fk(8.3.3)63 b(Sample)41 b(Init)g(File)150
4501 y Fu(Here)27 b(is)f(an)h(example)g(of)f(an)h Fr(inputrc)k
(from)630 4349 y Ft(/etc/inputrc)p Fu(:)870 4483 y Ft($include)46
b(/etc/inputrc)150 4682 y Fk(8.3.3)63 b(Sample)41 b(Init)g(File)150
4829 y Fu(Here)27 b(is)f(an)h(example)g(of)f(an)h Fr(inputrc)k
Fu(\014le.)39 b(This)26 b(illustrates)h(k)m(ey)h(binding,)e(v)-5
b(ariable)27 b(assignmen)m(t,)i(and)150 4610 y(conditional)j(syn)m
b(ariable)27 b(assignmen)m(t,)i(and)150 4939 y(conditional)j(syn)m
(tax.)p eop end
%%Page: 131 137
TeXDict begin 131 136 bop 150 -116 a Fu(Chapter)30 b(8:)41
@@ -21989,7 +21999,7 @@ g(:)h(:)f(:)g(:)g(:)g(:)23 b Fb(89)150 3025 y Fe(show-all-if-ambiguous)
(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37
b Fb(126)2025 260 y Fe(skip-completed-text)26 b Fc(:)13
b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g
(:)h(:)f(:)g(:)g(:)g(:)37 b Fb(126)2025 347 y Fe(SRANDOM)22
(:)h(:)f(:)g(:)g(:)g(:)37 b Fb(127)2025 347 y Fe(SRANDOM)22
b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g
(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)
g(:)g(:)h(:)f(:)g(:)35 b Fb(89)2021 673 y Fs(T)2025 803
doc/bashref.vr
+1 -1
View File
@@ -167,7 +167,7 @@
\entry{show-all-if-ambiguous}{126}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{126}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{126}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{126}{\code {skip-completed-text}}
\entry{skip-completed-text}{127}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{127}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{127}{\code {vi-ins-mode-string}}
\entry{visible-stats}{127}{\code {visible-stats}}
doc/bashref.vrs
+1 -1
View File
@@ -183,7 +183,7 @@
\entry{\code {show-all-if-ambiguous}}{126}
\entry{\code {show-all-if-unmodified}}{126}
\entry{\code {show-mode-in-prompt}}{126}
\entry{\code {skip-completed-text}}{126}
\entry{\code {skip-completed-text}}{127}
\entry{\code {SRANDOM}}{89}
\initial {T}
\entry{\code {TEXTDOMAIN}}{8}
doc/builtins.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Fri Jul 29 09:05:33 2022
%%CreationDate: Fri Aug 12 11:28:42 2022
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Fri Jul 29 09:05:33 2022
%%CreationDate: Fri Aug 12 11:28:42 2022
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 4
examples/loadables/cut.c
+3 -1
View File
@@ -417,7 +417,9 @@ cutfile (v, list, ops)
while ((n = zgetline (fd, &line, &llen, '\n', unbuffered_read)) != -1)
{
QUIT;
cutline (v, line, ops); /* can modify line */
if (line[n] == '\n')
line[n] = '\0'; /* cutline expects no newline terminator */
cutline (v, line, ops); /* can modify line */
}
if (fd > 0)
close (fd);
lib/readline/doc/readline.3
+8 -2
View File
@@ -6,9 +6,9 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Fri Mar 11 10:14:10 EST 2022
.\" Last Change: Fri Aug 12 11:12:23 EDT 2022
.\"
.TH READLINE 3 "2022 March 11" "GNU Readline 8.2"
.TH READLINE 3 "2022 August 12" "GNU Readline 8.2"
.\"
.\" File Name macro. This used to be `.PN', for Path Name,
.\" but Sun doesn't seem to like that very much.
@@ -445,6 +445,8 @@ by stripping the eighth bit and prefixing it with an
escape character (in effect, using escape as the \fImeta prefix\fP).
The default is \fIOn\fP, but readline will set it to \fIOff\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B disable\-completion (Off)
If set to \fBOn\fP, readline will inhibit word completion. Completion
@@ -538,6 +540,8 @@ regardless of what the terminal claims it can support. The name
is a synonym for this variable.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B isearch\-terminators (``C\-[ C\-J'')
The string of characters that should terminate an incremental
@@ -601,6 +605,8 @@ eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
may change if the locale is changed.
.TP
.B page\-completions (On)
If set to \fBOn\fP, readline uses an internal \fImore\fP-like pager
lib/readline/doc/rluser.texi
+8 -1
View File
@@ -536,9 +536,12 @@ The default limit is @code{100}.
If set to @samp{on}, Readline will convert characters with the
eighth bit set to an @sc{ascii} key sequence by stripping the eighth
bit and prefixing an @key{ESC} character, converting them to a
meta-prefixed key sequence. The default value is @samp{on}, but
meta-prefixed key sequence.
The default value is @samp{on}, but
will be set to @samp{off} if the locale is one that contains
eight-bit characters.
This variable is dependent on the @code{LC_CTYPE} locale category, and
may change if the locale is changed.
@item disable-completion
@vindex disable-completion
@@ -649,6 +652,8 @@ regardless of what the terminal claims it can support. The
default value is @samp{off}, but Readline will set it to @samp{on} if the
locale contains eight-bit characters.
The name @code{meta-flag} is a synonym for this variable.
This variable is dependent on the @code{LC_CTYPE} locale category, and
may change if the locale is changed.
@item isearch-terminators
@vindex isearch-terminators
@@ -731,6 +736,8 @@ eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is @samp{off}, but Readline will set it to @samp{on} if the
locale contains eight-bit characters.
This variable is dependent on the @code{LC_CTYPE} locale category, and
may change if the locale is changed.
@item page-completions
@vindex page-completions
lib/readline/doc/version.texi
+3 -3
View File
@@ -5,7 +5,7 @@ Copyright (C) 1988-2022 Free Software Foundation, Inc.
@set EDITION 8.2
@set VERSION 8.2
@set UPDATED 11 March 2022
@set UPDATED-MONTH March 2022
@set UPDATED 12 August 2022
@set UPDATED-MONTH August 2022
@set LASTCHANGE Fri Mar 11 10:13:51 EST 2022
@set LASTCHANGE Fri Aug 12 11:10:50 EDT 2022
lib/readline/nls.c
+69 -16
View File
@@ -57,6 +57,9 @@
static int utf8locale (char *);
#define RL_DEFAULT_LOCALE "C"
static char *_rl_current_locale = 0;
#if !defined (HAVE_SETLOCALE)
/* A list of legal values for the LANG or LC_CTYPE environment variables.
If a locale name in this list is the value for the LC_ALL, LC_CTYPE,
@@ -132,50 +135,61 @@ _rl_init_locale (void)
that doesn't return anything, we set lspec to the empty string to
force the subsequent call to setlocale() to define the `native'
environment. */
#if defined (HAVE_SETLOCALE)
if (lspec == 0 || *lspec == 0)
lspec = setlocale (LC_CTYPE, (char *)NULL);
if (lspec == 0)
lspec = "";
ret = setlocale (LC_CTYPE, lspec); /* ok, since it does not change locale */
#else
ret = (lspec == 0 || *lspec == 0) ? RL_DEFAULT_LOCALE : lspec;
#endif
_rl_utf8locale = (ret && *ret) ? utf8locale (ret) : 0;
_rl_current_locale = savestring (ret);
return ret;
}
/* Check for LC_ALL, LC_CTYPE, and LANG and use the first with a value
to decide the defaults for 8-bit character input and output. Returns
1 if we set eight-bit mode. */
int
_rl_init_eightbit (void)
{
/* If we have setlocale(3), just check the current LC_CTYPE category
value, and go into eight-bit mode if it's not C or POSIX. */
value (passed as LOCALESTR), and go into eight-bit mode if it's not "C"
or "POSIX". If FORCE is non-zero, we reset the locale variables to values
appropriate for the C locale if the locale is "C" or "POSIX". FORCE is 0
when this is called from _rl_init_eightbit, since we're modifying the
default initial values and don't need to change anything else. If we
don't have setlocale(3), we check the codeset portion of LOCALESTR against
a set of known values and go into eight-bit mode if it matches one of those.
Returns 1 if we set eight-bit (multibyte) mode. */
static int
_rl_set_localevars (char *localestr, int force)
{
#if defined (HAVE_SETLOCALE)
char *lspec, *t;
t = _rl_init_locale (); /* returns static pointer */
if (t && *t && (t[0] != 'C' || t[1]) && (STREQ (t, "POSIX") == 0))
if (localestr && *localestr && (localestr[0] != 'C' || localestr[1]) && (STREQ (localestr, "POSIX") == 0))
{
_rl_meta_flag = 1;
_rl_convert_meta_chars_to_ascii = 0;
_rl_output_meta_chars = 1;
return (1);
}
else if (force)
{
/* Default "C" locale settings. */
_rl_meta_flag = 0;
_rl_convert_meta_chars_to_ascii = 1;
_rl_output_meta_chars = 0;
return (0);
}
else
return (0);
#else /* !HAVE_SETLOCALE */
char *lspec, *t;
char *t;
int i;
/* We don't have setlocale. Finesse it. Check the environment for the
appropriate variables and set eight-bit mode if they have the right
values. */
lspec = _rl_get_locale_var ("LC_CTYPE");
if (lspec == 0 || (t = normalize_codeset (lspec)) == 0)
if (localestr == 0 || (t = normalize_codeset (localestr)) == 0)
return (0);
for (i = 0; t && legal_lang_values[i]; i++)
if (STREQ (t, legal_lang_values[i]))
@@ -186,6 +200,14 @@ _rl_init_eightbit (void)
break;
}
if (force && legal_lang_values[i] == 0) /* didn't find it */
{
/* Default "C" locale settings. */
_rl_meta_flag = 0;
_rl_convert_meta_chars_to_ascii = 1;
_rl_output_meta_chars = 0;
}
_rl_utf8locale = *t ? STREQ (t, "utf8") : 0;
xfree (t);
@@ -193,6 +215,21 @@ _rl_init_eightbit (void)
#endif /* !HAVE_SETLOCALE */
}
/* Check for LC_ALL, LC_CTYPE, and LANG and use the first with a value
to decide the defaults for 8-bit character input and output. Returns
1 if we set eight-bit mode. */
int
_rl_init_eightbit (void)
{
char *t, *ol;
ol = _rl_current_locale;
t = _rl_init_locale (); /* resets _rl_current_locale, returns static pointer */
xfree (ol);
return (_rl_set_localevars (t, 0));
}
#if !defined (HAVE_SETLOCALE)
static char *
normalize_codeset (char *codeset)
@@ -289,3 +326,19 @@ find_codeset (char *name, size_t *lenp)
return result;
}
void
_rl_reset_locale (void)
{
char *ol, *nl;
/* This should not be NULL; _rl_init_eightbit sets it on the first call to
readline() or rl_initialize(). */
ol = _rl_current_locale;
nl = _rl_init_locale (); /* resets _rl_current_locale */
if ((ol == 0 && nl) || (ol && nl && (STREQ (ol, nl) == 0)))
(void)_rl_set_localevars (nl, 1);
xfree (ol);
}
lib/readline/readline.c
+1 -1
View File
@@ -1186,7 +1186,7 @@ rl_initialize (void)
RL_SETSTATE(RL_STATE_INITIALIZED);
}
else
(void)_rl_init_locale (); /* check current locale */
_rl_reset_locale (); /* check current locale and set locale variables */
/* Initialize the current line information. */
_rl_init_line_state ();
lib/readline/rlprivate.h
+1
View File
@@ -364,6 +364,7 @@ extern void _rl_revert_all_lines (void);
/* nls.c */
extern char *_rl_init_locale (void);
extern int _rl_init_eightbit (void);
extern void _rl_reset_locale (void);
/* parens.c */
extern void _rl_enable_paren_matching (int);