diff options
| author | Chet Ramey <chet.ramey@case.edu> | 2022-08-26 11:13:33 -0400 |
|---|---|---|
| committer | Chet Ramey <chet.ramey@case.edu> | 2022-08-26 11:13:33 -0400 |
| commit | 9b911311282118e89d55031b5e67e616fb9290bf (patch) | |
| tree | 2291a9bbd1c7d1a7e75e869e498dadf2bfa5787c | |
| parent | bddf1aa4da6e800af5a78d8127c307a52df95c36 (diff) | |
| download | readline-8.2-rc3.tar.gz | |
Readline-8.2-rc3 releasereadline-8.2-rc3
| -rw-r--r-- | CHANGELOG | 2 | ||||
| -rw-r--r-- | CHANGES | 14 | ||||
| -rw-r--r-- | CHANGES-8.2 | 4 | ||||
| -rw-r--r-- | NEWS | 8 | ||||
| -rw-r--r-- | NEWS-8.2 | 4 | ||||
| -rw-r--r-- | README | 2 | ||||
| -rw-r--r-- | doc/history.dvi | bin | 72256 -> 72244 bytes | |||
| -rw-r--r-- | doc/history.html | 2 | ||||
| -rw-r--r-- | doc/history.info | 46 | ||||
| -rw-r--r-- | doc/history.pdf | bin | 204492 -> 204492 bytes | |||
| -rw-r--r-- | doc/history.ps | 42 | ||||
| -rw-r--r-- | doc/readline.0 | 513 | ||||
| -rw-r--r-- | doc/readline.3 | 10 | ||||
| -rw-r--r-- | doc/readline.dvi | bin | 332628 -> 333076 bytes | |||
| -rw-r--r-- | doc/readline.html | 13 | ||||
| -rw-r--r-- | doc/readline.info | 180 | ||||
| -rw-r--r-- | doc/readline.pdf | bin | 406250 -> 406423 bytes | |||
| -rw-r--r-- | doc/readline.ps | 672 | ||||
| -rw-r--r-- | doc/readline_3.ps | 1750 | ||||
| -rw-r--r-- | doc/rltech.texi | 2 | ||||
| -rw-r--r-- | doc/rluser.texi | 11 | ||||
| -rw-r--r-- | doc/rluserman.dvi | bin | 118316 -> 118764 bytes | |||
| -rw-r--r-- | doc/rluserman.html | 11 | ||||
| -rw-r--r-- | doc/rluserman.info | 64 | ||||
| -rw-r--r-- | doc/rluserman.pdf | bin | 236784 -> 236967 bytes | |||
| -rw-r--r-- | doc/rluserman.ps | 662 | ||||
| -rw-r--r-- | doc/version.texi | 6 | ||||
| -rw-r--r-- | examples/rlptytest.c | 2 | ||||
| -rw-r--r-- | nls.c | 85 | ||||
| -rw-r--r-- | readline.c | 2 | ||||
| -rw-r--r-- | rlprivate.h | 1 |
31 files changed, 2125 insertions, 1983 deletions
@@ -1410,7 +1410,7 @@ INSTALL 8/17/2021 --------- -confiugre.ac +configure.ac - use `:+' when testing the value of $GCC, since autoconf seems to set it to the empty string if gcc isn't the compiler. Reported by Osipov, Michael (LDA IT PLM) <michael.osipov@siemens.com> @@ -103,6 +103,10 @@ l. There is a new configuration option: --with-shared-termcap-library, which forces linking the shared readline library with the shared termcap (or curses/ncurses/termlib) library so applications don't have to do it. +m. Readline now checks for changes to locale settings (LC_ALL/LC_CTYPE/LANG) + each time it is called, and modifies the appropriate locale-specific display + and key binding variables when the locale changes. + ------------------------------------------------------------------------------- This document details the changes between this version, readline-8.1, and the previous version, readline-8.0. @@ -482,7 +486,7 @@ jj. Fixed a bug that caused mode strings to be displayed incorrectly if the 2. New Features in Readline -a. The history truncation code now uses the same error recovery mechansim as +a. The history truncation code now uses the same error recovery mechanism as the history writing code, and restores the old version of the history file on error. The error recovery mechanism handles symlinked history files. @@ -813,7 +817,7 @@ d. New bindable function: skip-csi-sequence. Can be used as a default to to bind all keys. e. New application-settable function: rl_filename_rewrite_hook. Can be used - to rewite or modify filenames read from the file system before they are + to rewrite or modify filenames read from the file system before they are compared to the word to be completed. f. New bindable variable: skip-completed-text, active when completing in the @@ -875,7 +879,7 @@ l. Fixed a bug in the code that buffers characters received very quickly in succession which caused characters to be dropped. m. Fixed a bug that caused readline to reference uninitialized data structures - if it received a SIGWINCH before completing initialzation. + if it received a SIGWINCH before completing initialization. n. Fixed a bug that caused the vi-mode `last command' to be set incorrectly and therefore unrepeatable. @@ -1213,7 +1217,7 @@ w. The history search functions now perform better bounds checking on the history list. x. Change to history expansion functions to treat `^' as equivalent to word - one, as the documention states. + one, as the documentation states. y. Some changes to the display code to improve display and redisplay of multibyte characters. @@ -1474,7 +1478,7 @@ f. The incremental search code remembers the last search string and uses h. New bindable variable `history-preserve-point'. If set, the history code attempts to place the user at the same location on each history - line retrived with previous-history or next-history. + line retrieved with previous-history or next-history. ------------------------------------------------------------------------------- This document details the changes between this version, readline-4.2, diff --git a/CHANGES-8.2 b/CHANGES-8.2 index cace80a..e192516 100644 --- a/CHANGES-8.2 +++ b/CHANGES-8.2 @@ -102,3 +102,7 @@ k. New readline state (RL_STATE_EOF) and application-visible variable l. There is a new configuration option: --with-shared-termcap-library, which forces linking the shared readline library with the shared termcap (or curses/ncurses/termlib) library so applications don't have to do it. + +m. Readline now checks for changes to locale settings (LC_ALL/LC_CTYPE/LANG) + each time it is called, and modifies the appropriate locale-specific display + and key binding variables when the locale changes. @@ -50,6 +50,10 @@ l. There is a new configuration option: --with-shared-termcap-library, which forces linking the shared readline library with the shared termcap (or curses/ncurses/termlib) library so applications don't have to do it. +m. Readline now checks for changes to locale settings (LC_ALL/LC_CTYPE/LANG) + each time it is called, and modifies the appropriate locale-specific display + and key binding variables when the locale changes. + ------------------------------------------------------------------------------- This is a terse description of the new features added to readline-8.1 since the release of readline-8.0. @@ -142,7 +146,7 @@ the release of readline-6.3. New Features in Readline -a. The history truncation code now uses the same error recovery mechansim as +a. The history truncation code now uses the same error recovery mechanism as the history writing code, and restores the old version of the history file on error. The error recovery mechanism handles symlinked history files. @@ -313,7 +317,7 @@ d. New bindable function: skip-csi-sequence. Can be used as a default to to bind all keys. e. New application-settable function: rl_filename_rewrite_hook. Can be used - to rewite or modify filenames read from the file system before they are + to rewrite or modify filenames read from the file system before they are compared to the word to be completed. f. New bindable variable: skip-completed-text, active when completing in the @@ -49,3 +49,7 @@ k. New readline state (RL_STATE_EOF) and application-visible variable l. There is a new configuration option: --with-shared-termcap-library, which forces linking the shared readline library with the shared termcap (or curses/ncurses/termlib) library so applications don't have to do it. + +m. Readline now checks for changes to locale settings (LC_ALL/LC_CTYPE/LANG) + each time it is called, and modifies the appropriate locale-specific display + and key binding variables when the locale changes. @@ -10,7 +10,7 @@ additional functions to maintain a list of previously-entered command lines, to recall and perhaps reedit those lines, and perform csh-like history expansion on previous commands. -The history facilites are also placed into a separate library, the +The history facilities are also placed into a separate library, the History library, as part of the build process. The History library may be used without Readline in applications which desire its capabilities. diff --git a/doc/history.dvi b/doc/history.dvi Binary files differindex c3435a1..6846ebb 100644 --- a/doc/history.dvi +++ b/doc/history.dvi diff --git a/doc/history.html b/doc/history.html index 28b5fd0..16c8dba 100644 --- a/doc/history.html +++ b/doc/history.html @@ -4,7 +4,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This document describes the GNU History library -(version 8.2, 11 March 2022), +(version 8.2, 12 August 2022), a programming tool that provides a consistent user interface for recalling lines of previously typed input. diff --git a/doc/history.info b/doc/history.info index f1e7d4a..3d36b9c 100644 --- a/doc/history.info +++ b/doc/history.info @@ -1,7 +1,7 @@ This is history.info, produced by makeinfo version 6.8 from history.texi. -This document describes the GNU History library (version 8.2, 11 March +This document describes the GNU History library (version 8.2, 12 August 2022), a programming tool that provides a consistent user interface for recalling lines of previously typed input. @@ -1395,28 +1395,28 @@ Appendix C Function and Variable Index Tag Table: -Node: Top846 -Node: Using History Interactively1491 -Node: History Interaction1999 -Node: Event Designators3897 -Node: Word Designators5171 -Node: Modifiers6931 -Node: Programming with GNU History8476 -Node: Introduction to History9220 -Node: History Storage10898 -Node: History Functions12033 -Node: Initializing History and State Management13022 -Node: History List Management13834 -Node: Information About the History List16128 -Node: Moving Around the History List17742 -Node: Searching the History List18835 -Node: Managing the History File20760 -Node: History Expansion22580 -Node: History Variables24509 -Node: History Programming Example28489 -Node: GNU Free Documentation License31166 -Node: Concept Index56338 -Node: Function and Variable Index57043 +Node: Top847 +Node: Using History Interactively1492 +Node: History Interaction2000 +Node: Event Designators3898 +Node: Word Designators5172 +Node: Modifiers6932 +Node: Programming with GNU History8477 +Node: Introduction to History9221 +Node: History Storage10899 +Node: History Functions12034 +Node: Initializing History and State Management13023 +Node: History List Management13835 +Node: Information About the History List16129 +Node: Moving Around the History List17743 +Node: Searching the History List18836 +Node: Managing the History File20761 +Node: History Expansion22581 +Node: History Variables24510 +Node: History Programming Example28490 +Node: GNU Free Documentation License31167 +Node: Concept Index56339 +Node: Function and Variable Index57044 End Tag Table diff --git a/doc/history.pdf b/doc/history.pdf Binary files differindex a86cd5c..e2302be 100644 --- a/doc/history.pdf +++ b/doc/history.pdf diff --git a/doc/history.ps b/doc/history.ps index cfb37c1..af290a9 100644 --- a/doc/history.ps +++ b/doc/history.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 -%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software +%%Creator: dvips(k) 2022.1 (TeX Live 2022) Copyright 2022 Radical Eye Software %%Title: history.dvi -%%CreationDate: Fri Apr 8 19:52:34 2022 +%%CreationDate: Fri Aug 19 18:34:36 2022 %%Pages: 24 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o history.ps history.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2022.04.08:1552 +%DVIPSSource: TeX output 2022.08.19:1434 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -5241,28 +5241,28 @@ ifelse %%Page: 1 1 TeXDict begin 1 0 bop 150 1318 a Fr(GNU)65 b(History)h(Library)p 150 1418 3600 34 v 1920 1515 a Fq(Edition)31 b(8.2,)h(for)e -Fp(History)e(Library)h Fq(V)-8 b(ersion)31 b(8.2.)3285 -1623 y(Marc)m(h)g(2022)150 4927 y Fo(Chet)45 b(Ramey)-11 +Fp(History)e(Library)h Fq(V)-8 b(ersion)31 b(8.2.)3252 +1623 y(August)f(2022)150 4927 y Fo(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F) -11 b(oundation)p 150 5141 3600 17 v eop end %%Page: 2 2 -TeXDict begin 2 1 bop 150 4413 a Fq(This)25 b(do)s(cumen)m(t)g(describ) -s(es)g(the)g(GNU)h(History)h(library)e(\(v)m(ersion)h(8.2,)i(11)e(Marc) -m(h)g(2022\),)j(a)d(program-)150 4523 y(ming)38 b(to)s(ol)h(that)f(pro) -m(vides)g(a)g(consisten)m(t)i(user)d(in)m(terface)i(for)f(recalling)h -(lines)g(of)f(previously)f(t)m(yp)s(ed)150 4633 y(input.)150 -4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767 y Fn(\015)30 -b Fq(1988{2022)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8 -b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h -(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s -(cumen)m(t)f(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8 -b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26 -b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 5121 y(published)43 -b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8 -b(oundation;)53 b(with)44 b(no)g(In)m(v)-5 b(arian)m(t)46 -b(Sections,)j(no)390 5230 y(F)-8 b(ron)m(t-Co)m(v)m(er)31 -b(T)-8 b(exts,)30 b(and)f(no)f(Bac)m(k-Co)m(v)m(er)k(T)-8 +TeXDict begin 2 1 bop 150 4413 a Fq(This)22 b(do)s(cumen)m(t)h(describ) +s(es)f(the)h(GNU)g(History)h(library)e(\(v)m(ersion)i(8.2,)i(12)d +(August)g(2022\),)k(a)c(program-)150 4523 y(ming)38 b(to)s(ol)h(that)f +(pro)m(vides)g(a)g(consisten)m(t)i(user)d(in)m(terface)i(for)f +(recalling)h(lines)g(of)f(previously)f(t)m(yp)s(ed)150 +4633 y(input.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 +4767 y Fn(\015)30 b Fq(1988{2022)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h +(F)-8 b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 +b(is)f(gran)m(ted)h(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s +(dify)e(this)i(do)s(cumen)m(t)f(under)f(the)390 5011 +y(terms)25 b(of)h(the)f(GNU)h(F)-8 b(ree)27 b(Do)s(cumen)m(tation)g +(License,)g(V)-8 b(ersion)26 b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion) +390 5121 y(published)43 b(b)m(y)h(the)h(F)-8 b(ree)46 +b(Soft)m(w)m(are)g(F)-8 b(oundation;)53 b(with)44 b(no)g(In)m(v)-5 +b(arian)m(t)46 b(Sections,)j(no)390 5230 y(F)-8 b(ron)m(t-Co)m(v)m(er) +31 b(T)-8 b(exts,)30 b(and)f(no)f(Bac)m(k-Co)m(v)m(er)k(T)-8 b(exts.)41 b(A)29 b(cop)m(y)h(of)f(the)g(license)h(is)f(included)390 5340 y(in)h(the)h(section)g(en)m(titled)h(\\GNU)f(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License".)p eop end diff --git a/doc/readline.0 b/doc/readline.0 index f96ec72..0a0a194 100644 --- a/doc/readline.0 +++ b/doc/readline.0 @@ -258,7 +258,9 @@ READLINE(3) Library Functions Manual READLINE(3) bit set to an ASCII key sequence by stripping the eighth bit and prefixing it with an escape character (in effect, using escape as the [4mmeta[24m [4mprefix[24m). The default is [4mOn[24m, but readline will set - it to [4mOff[24m if the locale contains eight-bit characters. + it to [4mOff[24m if the locale contains eight-bit characters. This + variable is dependent on the [1mLC_CTYPE [22mlocale category, and may + change if the locale is changed. [1mdisable-completion (Off)[0m If set to [1mOn[22m, readline will inhibit word completion. Completion characters will be inserted into the line as if they had been @@ -332,159 +334,162 @@ READLINE(3) Library Functions Manual READLINE(3) gardless of what the terminal claims it can support. The name [1mmeta-flag [22mis a synonym for this variable. The default is [4mOff[24m, but readline will set it to [4mOn[24m if the locale contains eight-bit - characters. + characters. This variable is dependent on the [1mLC_CTYPE [22mlocale + category, and may change if the locale is changed. [1misearch-terminators (``C-[ C-J'')[0m - The string of characters that should terminate an incremental - search without subsequently executing the character as a com- - mand. If this variable has not been given a value, the charac- + The string of characters that should terminate an incremental + search without subsequently executing the character as a com- + mand. If this variable has not been given a value, the charac- ters [4mESC[24m and [4mC-J[24m will terminate an incremental search. [1mkeymap (emacs)[0m - Set the current readline keymap. The set of legal keymap names - is [4memacs,[24m [4memacs-standard,[24m [4memacs-meta,[24m [4memacs-ctlx,[24m [4mvi,[24m [4mvi-move,[0m - [4mvi-command[24m, and [4mvi-insert[24m. [4mvi[24m is equivalent to [4mvi-command[24m; - [4memacs[24m is equivalent to [4memacs-standard[24m. The default value is - [4memacs[24m. The value of [1mediting-mode [22malso affects the default + Set the current readline keymap. The set of legal keymap names + is [4memacs,[24m [4memacs-standard,[24m [4memacs-meta,[24m [4memacs-ctlx,[24m [4mvi,[24m [4mvi-move,[0m + [4mvi-command[24m, and [4mvi-insert[24m. [4mvi[24m is equivalent to [4mvi-command[24m; + [4memacs[24m is equivalent to [4memacs-standard[24m. The default value is + [4memacs[24m. The value of [1mediting-mode [22malso affects the default keymap. [1mkeyseq-timeout (500)[0m - Specifies the duration [4mreadline[24m will wait for a character when - reading an ambiguous key sequence (one that can form a complete + Specifies the duration [4mreadline[24m will wait for a character when + reading an ambiguous key sequence (one that can form a complete key sequence using the input read so far, or can take additional - input to complete a longer key sequence). If no input is re- - ceived within the timeout, [4mreadline[24m will use the shorter but - complete key sequence. The value is specified in milliseconds, - so a value of 1000 means that [4mreadline[24m will wait one second for - additional input. If this variable is set to a value less than - or equal to zero, or to a non-numeric value, [4mreadline[24m will wait - until another key is pressed to decide which key sequence to + input to complete a longer key sequence). If no input is re- + ceived within the timeout, [4mreadline[24m will use the shorter but + complete key sequence. The value is specified in milliseconds, + so a value of 1000 means that [4mreadline[24m will wait one second for + additional input. If this variable is set to a value less than + or equal to zero, or to a non-numeric value, [4mreadline[24m will wait + until another key is pressed to decide which key sequence to complete. [1mmark-directories (On)[0m If set to [1mOn[22m, completed directory names have a slash appended. [1mmark-modified-lines (Off)[0m - If set to [1mOn[22m, history lines that have been modified are dis- + If set to [1mOn[22m, history lines that have been modified are dis- played with a preceding asterisk ([1m*[22m). [1mmark-symlinked-directories (Off)[0m If set to [1mOn[22m, completed names which are symbolic links to direc- - tories have a slash appended (subject to the value of [1mmark-di-[0m + tories have a slash appended (subject to the value of [1mmark-di-[0m [1mrectories[22m). [1mmatch-hidden-files (On)[0m - This variable, when set to [1mOn[22m, causes readline to match files - whose names begin with a `.' (hidden files) when performing - filename completion. If set to [1mOff[22m, the leading `.' must be + This variable, when set to [1mOn[22m, causes readline to match files + whose names begin with a `.' (hidden files) when performing + filename completion. If set to [1mOff[22m, the leading `.' must be supplied by the user in the filename to be completed. [1mmenu-complete-display-prefix (Off)[0m - If set to [1mOn[22m, menu completion displays the common prefix of the + If set to [1mOn[22m, menu completion displays the common prefix of the list of possible completions (which may be empty) before cycling through the list. [1moutput-meta (Off)[0m - If set to [1mOn[22m, readline will display characters with the eighth + If set to [1mOn[22m, readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is [4mOff[24m, but readline will set it to [4mOn[24m if the locale - contains eight-bit characters. + contains eight-bit characters. This variable is dependent on + the [1mLC_CTYPE [22mlocale category, and may change if the locale is + changed. [1mpage-completions (On)[0m - If set to [1mOn[22m, readline uses an internal [4mmore[24m-like pager to dis- + If set to [1mOn[22m, readline uses an internal [4mmore[24m-like pager to dis- play a screenful of possible completions at a time. [1mprint-completions-horizontally (Off)[0m - If set to [1mOn[22m, readline will display completions with matches - sorted horizontally in alphabetical order, rather than down the + If set to [1mOn[22m, readline will display completions with matches + sorted horizontally in alphabetical order, rather than down the screen. [1mrevert-all-at-newline (Off)[0m - If set to [1mOn[22m, readline will undo all changes to history lines + If set to [1mOn[22m, readline will undo all changes to history lines before returning when [1maccept-line [22mis executed. By default, his- - tory lines may be modified and retain individual undo lists + tory lines may be modified and retain individual undo lists across calls to [1mreadline[22m. [1mshow-all-if-ambiguous (Off)[0m - This alters the default behavior of the completion functions. + This alters the default behavior of the completion functions. If set to [1mOn[22m, words which have more than one possible completion - cause the matches to be listed immediately instead of ringing + cause the matches to be listed immediately instead of ringing the bell. [1mshow-all-if-unmodified (Off)[0m - This alters the default behavior of the completion functions in + This alters the default behavior of the completion functions in a fashion similar to [1mshow-all-if-ambiguous[22m. If set to [1mOn[22m, words - which have more than one possible completion without any possi- - ble partial completion (the possible completions don't share a - common prefix) cause the matches to be listed immediately in- + which have more than one possible completion without any possi- + ble partial completion (the possible completions don't share a + common prefix) cause the matches to be listed immediately in- stead of ringing the bell. [1mshow-mode-in-prompt (Off)[0m - If set to [1mOn[22m, add a string to the beginning of the prompt indi- - cating the editing mode: emacs, vi command, or vi insertion. + If set to [1mOn[22m, add a string to the beginning of the prompt indi- + cating the editing mode: emacs, vi command, or vi insertion. The mode strings are user-settable (e.g., [4memacs-mode-string[24m). [1mskip-completed-text (Off)[0m - If set to [1mOn[22m, this alters the default completion behavior when - inserting a single match into the line. It's only active when - performing completion in the middle of a word. If enabled, - readline does not insert characters from the completion that - match characters after point in the word being completed, so + If set to [1mOn[22m, this alters the default completion behavior when + inserting a single match into the line. It's only active when + performing completion in the middle of a word. If enabled, + readline does not insert characters from the completion that + match characters after point in the word being completed, so portions of the word following the cursor are not duplicated. [1mvi-cmd-mode-string ((cmd))[0m - If the [4mshow-mode-in-prompt[24m variable is enabled, this string is + If the [4mshow-mode-in-prompt[24m variable is enabled, this string is displayed immediately before the last line of the primary prompt - when vi editing mode is active and in command mode. The value + when vi editing mode is active and in command mode. The value is expanded like a key binding, so the standard set of meta- and - control prefixes and backslash escape sequences is available. - Use the \1 and \2 escapes to begin and end sequences of non- - printing characters, which can be used to embed a terminal con- + control prefixes and backslash escape sequences is available. + Use the \1 and \2 escapes to begin and end sequences of non- + printing characters, which can be used to embed a terminal con- trol sequence into the mode string. [1mvi-ins-mode-string ((ins))[0m - If the [4mshow-mode-in-prompt[24m variable is enabled, this string is + If the [4mshow-mode-in-prompt[24m variable is enabled, this string is displayed immediately before the last line of the primary prompt when vi editing mode is active and in insertion mode. The value is expanded like a key binding, so the standard set of meta- and - control prefixes and backslash escape sequences is available. - Use the \1 and \2 escapes to begin and end sequences of non- - printing characters, which can be used to embed a terminal con- + control prefixes and backslash escape sequences is available. + Use the \1 and \2 escapes to begin and end sequences of non- + printing characters, which can be used to embed a terminal con- trol sequence into the mode string. [1mvisible-stats (Off)[0m - If set to [1mOn[22m, a character denoting a file's type as reported by - [4mstat[24m(2) is appended to the filename when listing possible com- + If set to [1mOn[22m, a character denoting a file's type as reported by + [4mstat[24m(2) is appended to the filename when listing possible com- pletions. [1mConditional Constructs[0m - Readline implements a facility similar in spirit to the conditional - compilation features of the C preprocessor which allows key bindings - and variable settings to be performed as the result of tests. There + Readline implements a facility similar in spirit to the conditional + compilation features of the C preprocessor which allows key bindings + and variable settings to be performed as the result of tests. There are four parser directives used. - [1m$if [22mThe [1m$if [22mconstruct allows bindings to be made based on the edit- - ing mode, the terminal being used, or the application using - readline. The text of the test, after any comparison operator, + [1m$if [22mThe [1m$if [22mconstruct allows bindings to be made based on the edit- + ing mode, the terminal being used, or the application using + readline. The text of the test, after any comparison operator, extends to the end of the line; unless otherwise noted, no char- acters are required to isolate it. - [1mmode [22mThe [1mmode= [22mform of the [1m$if [22mdirective is used to test - whether readline is in emacs or vi mode. This may be - used in conjunction with the [1mset keymap [22mcommand, for in- - stance, to set bindings in the [4memacs-standard[24m and [4memacs-[0m - [4mctlx[24m keymaps only if readline is starting out in emacs + [1mmode [22mThe [1mmode= [22mform of the [1m$if [22mdirective is used to test + whether readline is in emacs or vi mode. This may be + used in conjunction with the [1mset keymap [22mcommand, for in- + stance, to set bindings in the [4memacs-standard[24m and [4memacs-[0m + [4mctlx[24m keymaps only if readline is starting out in emacs mode. - [1mterm [22mThe [1mterm= [22mform may be used to include terminal-specific + [1mterm [22mThe [1mterm= [22mform may be used to include terminal-specific key bindings, perhaps to bind the key sequences output by the terminal's function keys. The word on the right side - of the [1m= [22mis tested against the full name of the terminal - and the portion of the terminal name before the first [1m-[22m. - This allows [4msun[24m to match both [4msun[24m and [4msun-cmd[24m, for in- + of the [1m= [22mis tested against the full name of the terminal + and the portion of the terminal name before the first [1m-[22m. + This allows [4msun[24m to match both [4msun[24m and [4msun-cmd[24m, for in- stance. [1mversion[0m - The [1mversion [22mtest may be used to perform comparisons - against specific readline versions. The [1mversion [22mexpands - to the current readline version. The set of comparison - operators includes [1m=[22m, (and [1m==[22m), [1m!=[22m, [1m<=[22m, [1m>=[22m, [1m<[22m, and [1m>[22m. - The version number supplied on the right side of the op- - erator consists of a major version number, an optional + The [1mversion [22mtest may be used to perform comparisons + against specific readline versions. The [1mversion [22mexpands + to the current readline version. The set of comparison + operators includes [1m=[22m, (and [1m==[22m), [1m!=[22m, [1m<=[22m, [1m>=[22m, [1m<[22m, and [1m>[22m. + The version number supplied on the right side of the op- + erator consists of a major version number, an optional decimal point, and an optional minor version (e.g., [1m7.1[22m). - If the minor version is omitted, it is assumed to be [1m0[22m. + If the minor version is omitted, it is assumed to be [1m0[22m. The operator may be separated from the string [1mversion [22mand from the version number argument by whitespace. [1mapplication[0m The [1mapplication [22mconstruct is used to include application- - specific settings. Each program using the readline li- - brary sets the [4mapplication[24m [4mname[24m, and an initialization + specific settings. Each program using the readline li- + brary sets the [4mapplication[24m [4mname[24m, and an initialization file can test for a particular value. This could be used - to bind key sequences to functions useful for a specific - program. For instance, the following command adds a key - sequence that quotes the current or previous word in + to bind key sequences to functions useful for a specific + program. For instance, the following command adds a key + sequence that quotes the current or previous word in [1mbash[22m: [1m$if [22mBash @@ -494,12 +499,12 @@ READLINE(3) Library Functions Manual READLINE(3) [4mvariable[0m The [4mvariable[24m construct provides simple equality tests for - readline variables and values. The permitted comparison - operators are [4m=[24m, [4m==[24m, and [4m!=[24m. The variable name must be + readline variables and values. The permitted comparison + operators are [4m=[24m, [4m==[24m, and [4m!=[24m. The variable name must be separated from the comparison operator by whitespace; the - operator may be separated from the value on the right - hand side by whitespace. Both string and boolean vari- - ables may be tested. Boolean variables must be tested + operator may be separated from the value on the right + hand side by whitespace. Both string and boolean vari- + ables may be tested. Boolean variables must be tested against the values [4mon[24m and [4moff[24m. [1m$endif [22mThis command, as seen in the previous example, terminates an [1m$if[0m @@ -509,52 +514,52 @@ READLINE(3) Library Functions Manual READLINE(3) test fails. [1m$include[0m - This directive takes a single filename as an argument and reads - commands and bindings from that file. For example, the follow- + This directive takes a single filename as an argument and reads + commands and bindings from that file. For example, the follow- ing directive would read [4m/etc/inputrc[24m: [1m$include [4m[22m/etc/inputrc[0m [1mSEARCHING[0m - Readline provides commands for searching through the command history - for lines containing a specified string. There are two search modes: + Readline provides commands for searching through the command history + for lines containing a specified string. There are two search modes: [4mincremental[24m and [4mnon-incremental[24m. - Incremental searches begin before the user has finished typing the - search string. As each character of the search string is typed, read- + Incremental searches begin before the user has finished typing the + search string. As each character of the search string is typed, read- line displays the next entry from the history matching the string typed - so far. An incremental search requires only as many characters as - needed to find the desired history entry. To search backward in the + so far. An incremental search requires only as many characters as + needed to find the desired history entry. To search backward in the history for a particular string, type [1mC-r[22m. Typing [1mC-s [22msearches forward - through the history. The characters present in the value of the - [1misearch-terminators [22mvariable are used to terminate an incremental - search. If that variable has not been assigned a value the [4mEscape[24m and + through the history. The characters present in the value of the + [1misearch-terminators [22mvariable are used to terminate an incremental + search. If that variable has not been assigned a value the [4mEscape[24m and [1mC-J [22mcharacters will terminate an incremental search. [1mC-G [22mwill abort an - incremental search and restore the original line. When the search is - terminated, the history entry containing the search string becomes the + incremental search and restore the original line. When the search is + terminated, the history entry containing the search string becomes the current line. - To find other matching entries in the history list, type [1mC-s [22mor [1mC-r [22mas - appropriate. This will search backward or forward in the history for - the next line matching the search string typed so far. Any other key + To find other matching entries in the history list, type [1mC-s [22mor [1mC-r [22mas + appropriate. This will search backward or forward in the history for + the next line matching the search string typed so far. Any other key sequence bound to a readline command will terminate the search and exe- - cute that command. For instance, a newline will terminate the search - and accept the line, thereby executing the command from the history + cute that command. For instance, a newline will terminate the search + and accept the line, thereby executing the command from the history list. A movement command will terminate the search, make the last line found the current line, and begin editing. - Non-incremental searches read the entire search string before starting - to search for matching history lines. The search string may be typed + Non-incremental searches read the entire search string before starting + to search for matching history lines. The search string may be typed by the user or be part of the contents of the current line. [1mEDITING COMMANDS[0m - The following is a list of the names of the commands and the default + The following is a list of the names of the commands and the default key sequences to which they are bound. Command names without an accom- panying key sequence are unbound by default. In the following descriptions, [4mpoint[24m refers to the current cursor posi- - tion, and [4mmark[24m refers to a cursor position saved by the [1mset-mark [22mcom- - mand. The text between the point and mark is referred to as the [4mre-[0m + tion, and [4mmark[24m refers to a cursor position saved by the [1mset-mark [22mcom- + mand. The text between the point and mark is referred to as the [4mre-[0m [4mgion[24m. [1mCommands for Moving[0m @@ -570,27 +575,27 @@ READLINE(3) Library Functions Manual READLINE(3) Move forward to the end of the next word. Words are composed of alphanumeric characters (letters and digits). [1mbackward-word (M-b)[0m - Move back to the start of the current or previous word. Words + Move back to the start of the current or previous word. Words are composed of alphanumeric characters (letters and digits). [1mprevious-screen-line[0m - Attempt to move point to the same physical screen column on the - previous physical screen line. This will not have the desired - effect if the current Readline line does not take up more than - one physical line or if point is not greater than the length of + Attempt to move point to the same physical screen column on the + previous physical screen line. This will not have the desired + effect if the current Readline line does not take up more than + one physical line or if point is not greater than the length of the prompt plus the screen width. [1mnext-screen-line[0m - Attempt to move point to the same physical screen column on the + Attempt to move point to the same physical screen column on the next physical screen line. This will not have the desired effect - if the current Readline line does not take up more than one - physical line or if the length of the current Readline line is + if the current Readline line does not take up more than one + physical line or if the length of the current Readline line is not greater than the length of the prompt plus the screen width. [1mclear-display (M-C-l)[0m - Clear the screen and, if possible, the terminal's scrollback - buffer, then redraw the current line, leaving the current line + Clear the screen and, if possible, the terminal's scrollback + buffer, then redraw the current line, leaving the current line at the top of the screen. [1mclear-screen (C-l)[0m Clear the screen, then redraw the current line, leaving the cur- - rent line at the top of the screen. With an argument, refresh + rent line at the top of the screen. With an argument, refresh the current line without clearing the screen. [1mredraw-current-line[0m Refresh the current line. @@ -599,100 +604,100 @@ READLINE(3) Library Functions Manual READLINE(3) [1maccept-line (Newline, Return)[0m Accept the line regardless of where the cursor is. If this line is non-empty, it may be added to the history list for future re- - call with [1madd_history()[22m. If the line is a modified history + call with [1madd_history()[22m. If the line is a modified history line, the history line is restored to its original state. [1mprevious-history (C-p)[0m Fetch the previous command from the history list, moving back in the list. [1mnext-history (C-n)[0m - Fetch the next command from the history list, moving forward in + Fetch the next command from the history list, moving forward in the list. [1mbeginning-of-history (M-<)[0m Move to the first line in the history. [1mend-of-history (M->)[0m - Move to the end of the input history, i.e., the line currently + Move to the end of the input history, i.e., the line currently being entered. [1moperate-and-get-next (C-o)[0m Accept the current line for return to the calling application as - if a newline had been entered, and fetch the next line relative + if a newline had been entered, and fetch the next line relative to the current line from the history for editing. A numeric ar- - gument, if supplied, specifies the history entry to use instead + gument, if supplied, specifies the history entry to use instead of the current line. [1mfetch-history[0m - With a numeric argument, fetch that entry from the history list + With a numeric argument, fetch that entry from the history list and make it the current line. Without an argument, move back to the first entry in the history list. [1mreverse-search-history (C-r)[0m - Search backward starting at the current line and moving `up' - through the history as necessary. This is an incremental + Search backward starting at the current line and moving `up' + through the history as necessary. This is an incremental search. [1mforward-search-history (C-s)[0m - Search forward starting at the current line and moving `down' - through the history as necessary. This is an incremental + Search forward starting at the current line and moving `down' + through the history as necessary. This is an incremental search. [1mnon-incremental-reverse-search-history (M-p)[0m Search backward through the history starting at the current line - using a non-incremental search for a string supplied by the + using a non-incremental search for a string supplied by the user. [1mnon-incremental-forward-search-history (M-n)[0m - Search forward through the history using a non-incremental + Search forward through the history using a non-incremental search for a string supplied by the user. [1mhistory-search-backward[0m Search backward through the history for the string of characters between the start of the current line and the current cursor po- - sition (the [4mpoint[24m). The search string must match at the begin- + sition (the [4mpoint[24m). The search string must match at the begin- ning of a history line. This is a non-incremental search. [1mhistory-search-forward[0m - Search forward through the history for the string of characters + Search forward through the history for the string of characters between the start of the current line and the point. The search string must match at the beginning of a history line. This is a non-incremental search. [1mhistory-substring-search-backward[0m Search backward through the history for the string of characters between the start of the current line and the current cursor po- - sition (the [4mpoint[24m). The search string may match anywhere in a + sition (the [4mpoint[24m). The search string may match anywhere in a history line. This is a non-incremental search. [1mhistory-substring-search-forward[0m - Search forward through the history for the string of characters + Search forward through the history for the string of characters between the start of the current line and the point. The search - string may match anywhere in a history line. This is a non-in- + string may match anywhere in a history line. This is a non-in- cremental search. [1myank-nth-arg (M-C-y)[0m - Insert the first argument to the previous command (usually the + Insert the first argument to the previous command (usually the second word on the previous line) at point. With an argument [4mn[24m, - insert the [4mn[24mth word from the previous command (the words in the - previous command begin with word 0). A negative argument in- - serts the [4mn[24mth word from the end of the previous command. Once - the argument [4mn[24m is computed, the argument is extracted as if the + insert the [4mn[24mth word from the previous command (the words in the + previous command begin with word 0). A negative argument in- + serts the [4mn[24mth word from the end of the previous command. Once + the argument [4mn[24m is computed, the argument is extracted as if the "![4mn[24m" history expansion had been specified. [1myank-last-arg (M-., M-_)[0m - Insert the last argument to the previous command (the last word + Insert the last argument to the previous command (the last word of the previous history entry). With a numeric argument, behave - exactly like [1myank-nth-arg[22m. Successive calls to [1myank-last-arg[0m - move back through the history list, inserting the last word (or - the word specified by the argument to the first call) of each + exactly like [1myank-nth-arg[22m. Successive calls to [1myank-last-arg[0m + move back through the history list, inserting the last word (or + the word specified by the argument to the first call) of each line in turn. Any numeric argument supplied to these successive - calls determines the direction to move through the history. A - negative argument switches the direction through the history + calls determines the direction to move through the history. A + negative argument switches the direction through the history (back or forward). The history expansion facilities are used to - extract the last argument, as if the "!$" history expansion had + extract the last argument, as if the "!$" history expansion had been specified. [1mCommands for Changing Text[0m [4mend-of-file[24m [1m(usually C-d)[0m - The character indicating end-of-file as set, for example, by - ``stty''. If this character is read when there are no charac- - ters on the line, and point is at the beginning of the line, + The character indicating end-of-file as set, for example, by + ``stty''. If this character is read when there are no charac- + ters on the line, and point is at the beginning of the line, Readline interprets it as the end of input and returns [1mEOF[22m. [1mdelete-char (C-d)[0m Delete the character at point. If this function is bound to the same character as the tty [1mEOF [22mcharacter, as [1mC-d [22mcommonly is, see above for the effects. [1mbackward-delete-char (Rubout)[0m - Delete the character behind the cursor. When given a numeric + Delete the character behind the cursor. When given a numeric argument, save the deleted text on the kill ring. [1mforward-backward-delete-char[0m - Delete the character under the cursor, unless the cursor is at + Delete the character under the cursor, unless the cursor is at the end of the line, in which case the character behind the cur- sor is deleted. [1mquoted-insert (C-q, C-v)[0m @@ -703,32 +708,32 @@ READLINE(3) Library Functions Manual READLINE(3) [1mself-insert (a, b, A, 1, !, ...)[0m Insert the character typed. [1mtranspose-chars (C-t)[0m - Drag the character before point forward over the character at - point, moving point forward as well. If point is at the end of - the line, then this transposes the two characters before point. + Drag the character before point forward over the character at + point, moving point forward as well. If point is at the end of + the line, then this transposes the two characters before point. Negative arguments have no effect. [1mtranspose-words (M-t)[0m - Drag the word before point past the word after point, moving - point over that word as well. If point is at the end of the + Drag the word before point past the word after point, moving + point over that word as well. If point is at the end of the line, this transposes the last two words on the line. [1mupcase-word (M-u)[0m - Uppercase the current (or following) word. With a negative ar- + Uppercase the current (or following) word. With a negative ar- gument, uppercase the previous word, but do not move point. [1mdowncase-word (M-l)[0m - Lowercase the current (or following) word. With a negative ar- + Lowercase the current (or following) word. With a negative ar- gument, lowercase the previous word, but do not move point. [1mcapitalize-word (M-c)[0m Capitalize the current (or following) word. With a negative ar- gument, capitalize the previous word, but do not move point. [1moverwrite-mode[0m - Toggle overwrite mode. With an explicit positive numeric argu- + Toggle overwrite mode. With an explicit positive numeric argu- ment, switches to overwrite mode. With an explicit non-positive numeric argument, switches to insert mode. This command affects - only [1memacs [22mmode; [1mvi [22mmode does overwrite differently. Each call + only [1memacs [22mmode; [1mvi [22mmode does overwrite differently. Each call to [4mreadline()[24m starts in insert mode. In overwrite mode, charac- - ters bound to [1mself-insert [22mreplace the text at point rather than - pushing the text to the right. Characters bound to [1mback-[0m - [1mward-delete-char [22mreplace the character before point with a + ters bound to [1mself-insert [22mreplace the text at point rather than + pushing the text to the right. Characters bound to [1mback-[0m + [1mward-delete-char [22mreplace the character before point with a space. By default, this command is unbound. [1mKilling and Yanking[0m @@ -737,123 +742,123 @@ READLINE(3) Library Functions Manual READLINE(3) [1mbackward-kill-line (C-x Rubout)[0m Kill backward to the beginning of the line. [1munix-line-discard (C-u)[0m - Kill backward from point to the beginning of the line. The + Kill backward from point to the beginning of the line. The killed text is saved on the kill-ring. [1mkill-whole-line[0m - Kill all characters on the current line, no matter where point + Kill all characters on the current line, no matter where point is. [1mkill-word (M-d)[0m - Kill from point the end of the current word, or if between - words, to the end of the next word. Word boundaries are the + Kill from point the end of the current word, or if between + words, to the end of the next word. Word boundaries are the same as those used by [1mforward-word[22m. [1mbackward-kill-word (M-Rubout)[0m - Kill the word behind point. Word boundaries are the same as + Kill the word behind point. Word boundaries are the same as those used by [1mbackward-word[22m. [1munix-word-rubout (C-w)[0m - Kill the word behind point, using white space as a word bound- + Kill the word behind point, using white space as a word bound- ary. The killed text is saved on the kill-ring. [1munix-filename-rubout[0m - Kill the word behind point, using white space and the slash - character as the word boundaries. The killed text is saved on + Kill the word behind point, using white space and the slash + character as the word boundaries. The killed text is saved on the kill-ring. [1mdelete-horizontal-space (M-\)[0m Delete all spaces and tabs around point. [1mkill-region[0m - Kill the text between the point and [4mmark[24m (saved cursor posi- + Kill the text between the point and [4mmark[24m (saved cursor posi- tion). This text is referred to as the [4mregion[24m. [1mcopy-region-as-kill[0m Copy the text in the region to the kill buffer. [1mcopy-backward-word[0m - Copy the word before point to the kill buffer. The word bound- + Copy the word before point to the kill buffer. The word bound- aries are the same as [1mbackward-word[22m. [1mcopy-forward-word[0m - Copy the word following point to the kill buffer. The word + Copy the word following point to the kill buffer. The word boundaries are the same as [1mforward-word[22m. [1myank (C-y)[0m Yank the top of the kill ring into the buffer at point. [1myank-pop (M-y)[0m - Rotate the kill ring, and yank the new top. Only works follow- + Rotate the kill ring, and yank the new top. Only works follow- ing [1myank [22mor [1myank-pop[22m. [1mNumeric Arguments[0m [1mdigit-argument (M-0, M-1, ..., M--)[0m - Add this digit to the argument already accumulating, or start a + Add this digit to the argument already accumulating, or start a new argument. M-- starts a negative argument. [1muniversal-argument[0m - This is another way to specify an argument. If this command is - followed by one or more digits, optionally with a leading minus - sign, those digits define the argument. If the command is fol- + This is another way to specify an argument. If this command is + followed by one or more digits, optionally with a leading minus + sign, those digits define the argument. If the command is fol- lowed by digits, executing [1muniversal-argument [22magain ends the nu- meric argument, but is otherwise ignored. As a special case, if this command is immediately followed by a character that is nei- ther a digit or minus sign, the argument count for the next com- - mand is multiplied by four. The argument count is initially - one, so executing this function the first time makes the argu- + mand is multiplied by four. The argument count is initially + one, so executing this function the first time makes the argu- ment count four, a second time makes the argument count sixteen, and so on. [1mCompleting[0m [1mcomplete (TAB)[0m Attempt to perform completion on the text before point. The ac- - tual completion performed is application-specific. [1mBash[22m, for - instance, attempts completion treating the text as a variable - (if the text begins with [1m$[22m), username (if the text begins with - [1m~[22m), hostname (if the text begins with [1m@[22m), or command (including - aliases and functions) in turn. If none of these produces a - match, filename completion is attempted. [1mGdb[22m, on the other - hand, allows completion of program functions and variables, and + tual completion performed is application-specific. [1mBash[22m, for + instance, attempts completion treating the text as a variable + (if the text begins with [1m$[22m), username (if the text begins with + [1m~[22m), hostname (if the text begins with [1m@[22m), or command (including + aliases and functions) in turn. If none of these produces a + match, filename completion is attempted. [1mGdb[22m, on the other + hand, allows completion of program functions and variables, and only attempts filename completion under certain circumstances. [1mpossible-completions (M-?)[0m - List the possible completions of the text before point. When + List the possible completions of the text before point. When displaying completions, readline sets the number of columns used - for display to the value of [1mcompletion-display-width[22m, the value - of the environment variable [1mCOLUMNS[22m, or the screen width, in + for display to the value of [1mcompletion-display-width[22m, the value + of the environment variable [1mCOLUMNS[22m, or the screen width, in that order. [1minsert-completions (M-*)[0m - Insert all completions of the text before point that would have + Insert all completions of the text before point that would have been generated by [1mpossible-completions[22m. [1mmenu-complete[0m - Similar to [1mcomplete[22m, but replaces the word to be completed with - a single match from the list of possible completions. Repeated - execution of [1mmenu-complete [22msteps through the list of possible - completions, inserting each match in turn. At the end of the + Similar to [1mcomplete[22m, but replaces the word to be completed with + a single match from the list of possible completions. Repeated + execution of [1mmenu-complete [22msteps through the list of possible + completions, inserting each match in turn. At the end of the list of completions, the bell is rung (subject to the setting of [1mbell-style[22m) and the original text is restored. An argument of [4mn[0m moves [4mn[24m positions forward in the list of matches; a negative ar- gument may be used to move backward through the list. This com- mand is intended to be bound to [1mTAB[22m, but is unbound by default. [1mmenu-complete-backward[0m - Identical to [1mmenu-complete[22m, but moves backward through the list - of possible completions, as if [1mmenu-complete [22mhad been given a + Identical to [1mmenu-complete[22m, but moves backward through the list + of possible completions, as if [1mmenu-complete [22mhad been given a negative argument. This command is unbound by default. [1mdelete-char-or-list[0m - Deletes the character under the cursor if not at the beginning - or end of the line (like [1mdelete-char[22m). If at the end of the + Deletes the character under the cursor if not at the beginning + or end of the line (like [1mdelete-char[22m). If at the end of the line, behaves identically to [1mpossible-completions[22m. [1mKeyboard Macros[0m [1mstart-kbd-macro (C-x ()[0m - Begin saving the characters typed into the current keyboard + Begin saving the characters typed into the current keyboard macro. [1mend-kbd-macro (C-x ))[0m Stop saving the characters typed into the current keyboard macro and store the definition. [1mcall-last-kbd-macro (C-x e)[0m - Re-execute the last keyboard macro defined, by making the char- + Re-execute the last keyboard macro defined, by making the char- acters in the macro appear as if typed at the keyboard. [1mprint-last-kbd-macro ()[0m - Print the last keyboard macro defined in a format suitable for + Print the last keyboard macro defined in a format suitable for the [4minputrc[24m file. [1mMiscellaneous[0m [1mre-read-init-file (C-x C-r)[0m - Read in the contents of the [4minputrc[24m file, and incorporate any + Read in the contents of the [4minputrc[24m file, and incorporate any bindings or variable assignments found there. [1mabort (C-g)[0m - Abort the current editing command and ring the terminal's bell + Abort the current editing command and ring the terminal's bell (subject to the setting of [1mbell-style[22m). [1mdo-lowercase-version (M-A, M-B, M-[4m[22mx[24m[1m, ...)[0m - If the metafied character [4mx[24m is uppercase, run the command that + If the metafied character [4mx[24m is uppercase, run the command that is bound to the corresponding metafied lowercase character. The behavior is undefined if [4mx[24m is already lowercase. [1mprefix-meta (ESC)[0m @@ -861,80 +866,80 @@ READLINE(3) Library Functions Manual READLINE(3) [1mundo (C-_, C-x C-u)[0m Incremental undo, separately remembered for each line. [1mrevert-line (M-r)[0m - Undo all changes made to this line. This is like executing the - [1mundo [22mcommand enough times to return the line to its initial + Undo all changes made to this line. This is like executing the + [1mundo [22mcommand enough times to return the line to its initial state. [1mtilde-expand (M-&)[0m Perform tilde expansion on the current word. [1mset-mark (C-@, M-<space>)[0m - Set the mark to the point. If a numeric argument is supplied, + Set the mark to the point. If a numeric argument is supplied, the mark is set to that position. [1mexchange-point-and-mark (C-x C-x)[0m - Swap the point with the mark. The current cursor position is - set to the saved position, and the old cursor position is saved + Swap the point with the mark. The current cursor position is + set to the saved position, and the old cursor position is saved as the mark. [1mcharacter-search (C-])[0m A character is read and point is moved to the next occurrence of - that character. A negative count searches for previous occur- + that character. A negative count searches for previous occur- rences. [1mcharacter-search-backward (M-C-])[0m - A character is read and point is moved to the previous occur- - rence of that character. A negative count searches for subse- + A character is read and point is moved to the previous occur- + rence of that character. A negative count searches for subse- quent occurrences. [1mskip-csi-sequence[0m - Read enough characters to consume a multi-key sequence such as - those defined for keys like Home and End. Such sequences begin + Read enough characters to consume a multi-key sequence such as + those defined for keys like Home and End. Such sequences begin with a Control Sequence Indicator (CSI), usually ESC-[. If this - sequence is bound to "\[", keys producing such sequences will - have no effect unless explicitly bound to a readline command, - instead of inserting stray characters into the editing buffer. + sequence is bound to "\[", keys producing such sequences will + have no effect unless explicitly bound to a readline command, + instead of inserting stray characters into the editing buffer. This is unbound by default, but usually bound to ESC-[. [1minsert-comment (M-#)[0m - Without a numeric argument, the value of the readline [1mcom-[0m - [1mment-begin [22mvariable is inserted at the beginning of the current + Without a numeric argument, the value of the readline [1mcom-[0m + [1mment-begin [22mvariable is inserted at the beginning of the current line. If a numeric argument is supplied, this command acts as a - toggle: if the characters at the beginning of the line do not - match the value of [1mcomment-begin[22m, the value is inserted, other- + toggle: if the characters at the beginning of the line do not + match the value of [1mcomment-begin[22m, the value is inserted, other- wise the characters in [1mcomment-begin [22mare deleted from the begin- - ning of the line. In either case, the line is accepted as if a - newline had been typed. The default value of [1mcomment-begin[0m - makes the current line a shell comment. If a numeric argument + ning of the line. In either case, the line is accepted as if a + newline had been typed. The default value of [1mcomment-begin[0m + makes the current line a shell comment. If a numeric argument causes the comment character to be removed, the line will be ex- ecuted by the shell. [1mdump-functions[0m - Print all of the functions and their key bindings to the read- + Print all of the functions and their key bindings to the read- line output stream. If a numeric argument is supplied, the out- - put is formatted in such a way that it can be made part of an + put is formatted in such a way that it can be made part of an [4minputrc[24m file. [1mdump-variables[0m - Print all of the settable variables and their values to the - readline output stream. If a numeric argument is supplied, the + Print all of the settable variables and their values to the + readline output stream. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an [4minputrc[24m file. [1mdump-macros[0m - Print all of the readline key sequences bound to macros and the - strings they output. If a numeric argument is supplied, the + Print all of the readline key sequences bound to macros and the + strings they output. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an [4minputrc[24m file. [1memacs-editing-mode (C-e)[0m - When in [1mvi [22mcommand mode, this causes a switch to [1memacs [22mediting + When in [1mvi [22mcommand mode, this causes a switch to [1memacs [22mediting mode. [1mvi-editing-mode (M-C-j)[0m - When in [1memacs [22mediting mode, this causes a switch to [1mvi [22mediting + When in [1memacs [22mediting mode, this causes a switch to [1mvi [22mediting mode. [1mDEFAULT KEY BINDINGS[0m - The following is a list of the default emacs and vi bindings. Charac- - ters with the eighth bit set are written as M-<character>, and are re- - ferred to as [4mmetafied[24m characters. The printable ASCII characters not - mentioned in the list of emacs standard bindings are bound to the - [1mself-insert [22mfunction, which just inserts the given character into the + The following is a list of the default emacs and vi bindings. Charac- + ters with the eighth bit set are written as M-<character>, and are re- + ferred to as [4mmetafied[24m characters. The printable ASCII characters not + mentioned in the list of emacs standard bindings are bound to the + [1mself-insert [22mfunction, which just inserts the given character into the input line. In vi insertion mode, all characters not specifically men- tioned are bound to [1mself-insert[22m. Characters assigned to signal genera- tion by [4mstty[24m(1) or the terminal driver, such as C-Z or C-C, retain that - function. Upper and lower case metafied characters are bound to the - same function in the emacs mode meta keymap. The remaining characters - are unbound, which causes readline to ring the bell (subject to the + function. Upper and lower case metafied characters are bound to the + same function in the emacs mode meta keymap. The remaining characters + are unbound, which causes readline to ring the bell (subject to the setting of the [1mbell-style [22mvariable). [1mEmacs Mode[0m @@ -1149,14 +1154,14 @@ READLINE(3) Library Functions Manual READLINE(3) chet.ramey@case.edu [1mBUG REPORTS[0m - If you find a bug in [1mreadline, [22myou should report it. But first, you - should make sure that it really is a bug, and that it appears in the + If you find a bug in [1mreadline, [22myou should report it. But first, you + should make sure that it really is a bug, and that it appears in the latest version of the [1mreadline [22mlibrary that you have. - Once you have determined that a bug actually exists, mail a bug report - to [4mbug-readline[24m@[4mgnu.org[24m. If you have a fix, you are welcome to mail - that as well! Suggestions and `philosophical' bug reports may be - mailed to [4mbug-readline[24m@[4mgnu.org[24m or posted to the Usenet newsgroup + Once you have determined that a bug actually exists, mail a bug report + to [4mbug-readline[24m@[4mgnu.org[24m. If you have a fix, you are welcome to mail + that as well! Suggestions and `philosophical' bug reports may be + mailed to [4mbug-readline[24m@[4mgnu.org[24m or posted to the Usenet newsgroup [1mgnu.bash.bug[22m. Comments and bug reports concerning this manual page should be directed @@ -1167,4 +1172,4 @@ READLINE(3) Library Functions Manual READLINE(3) -GNU Readline 8.2 2022 March 11 READLINE(3) +GNU Readline 8.2 2022 August 12 READLINE(3) diff --git a/doc/readline.3 b/doc/readline.3 index 912718d..0e8629b 100644 --- a/doc/readline.3 +++ b/doc/readline.3 @@ -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 diff --git a/doc/readline.dvi b/doc/readline.dvi Binary files differindex 2ed9b57..865793f 100644 --- a/doc/readline.dvi +++ b/doc/readline.dvi diff --git a/doc/readline.html b/doc/readline.html index f96335d..de0675a 100644 --- a/doc/readline.html +++ b/doc/readline.html @@ -4,7 +4,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual describes the GNU Readline Library -(version 8.2, 11 March 2022), a library which aids in the +(version 8.2, 12 August 2022), a library which aids in the consistency of user interface across discrete programs which provide a command line interface. @@ -682,9 +682,12 @@ The default limit is <code>100</code>. <dd><p>If set to ‘<samp>on</samp>’, 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 ‘<samp>on</samp>’, but +meta-prefixed key sequence. +The default value is ‘<samp>on</samp>’, but will be set to ‘<samp>off</samp>’ 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'> ¶</a></span></dt> @@ -796,6 +799,8 @@ regardless of what the terminal claims it can support. The default value is ‘<samp>off</samp>’, but Readline will set it to ‘<samp>on</samp>’ 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'> ¶</a></span></dt> @@ -880,6 +885,8 @@ eighth bit set directly rather than as a meta-prefixed escape sequence. The default is ‘<samp>off</samp>’, but Readline will set it to ‘<samp>on</samp>’ 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'> ¶</a></span></dt> @@ -3431,7 +3438,7 @@ Returns the old timeout value. <dt id="index-rl_005fset_005ftimeout"><span class="category">Function: </span><span><em>int</em> <strong>rl_set_timeout</strong> <em>(unsigned int secs, unsigned int usecs)</em><a href='#index-rl_005fset_005ftimeout' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Set a timeout for subsequent calls to <code>readline()</code>. If Readline does not read a complete line, or the number of characters specified by -<code>rl_num_chars_to_read</code>, before the duration specfied by <var>secs</var> +<code>rl_num_chars_to_read</code>, before the duration specified by <var>secs</var> (in seconds) and <var>usecs</var> (microseconds), it returns and sets <code>RL_STATE_TIMEOUT</code> in <code>rl_readline_state</code>. Passing 0 for <code>secs</code> and <code>usecs</code> cancels any previously set diff --git a/doc/readline.info b/doc/readline.info index d4cbc22..1efb066 100644 --- a/doc/readline.info +++ b/doc/readline.info @@ -1,6 +1,6 @@ This is readline.info, produced by makeinfo version 6.8 from rlman.texi. -This manual describes the GNU Readline Library (version 8.2, 11 March +This manual describes the GNU Readline Library (version 8.2, 12 August 2022), a library which aids in the consistency of user interface across discrete programs which provide a command line interface. @@ -469,7 +469,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. @@ -564,7 +566,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 @@ -629,7 +633,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 @@ -2650,7 +2656,7 @@ File: readline.info, Node: Character Input, Next: Terminal Management, Prev: -- Function: int rl_set_timeout (unsigned int secs, unsigned int usecs) Set a timeout for subsequent calls to 'readline()'. If Readline does not read a complete line, or the number of characters - specified by 'rl_num_chars_to_read', before the duration specfied + specified by 'rl_num_chars_to_read', before the duration specified by SECS (in seconds) and USECS (microseconds), it returns and sets 'RL_STATE_TIMEOUT' in 'rl_readline_state'. Passing 0 for 'secs' and 'usecs' cancels any previously set timeout; the convenience @@ -4796,7 +4802,7 @@ Function and Variable Index (line 48) * digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6) * disable-completion: Readline Init File Syntax. - (line 143) + (line 145) * do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands. (line 14) * downcase-word (M-l): Commands For Text. (line 65) @@ -4807,19 +4813,19 @@ Function and Variable Index * dump-variables (): Miscellaneous Commands. (line 76) * echo-control-characters: Readline Init File Syntax. - (line 148) + (line 150) * editing-mode: Readline Init File Syntax. - (line 153) + (line 155) * emacs-editing-mode (C-e): Miscellaneous Commands. (line 88) * emacs-mode-string: Readline Init File Syntax. - (line 159) + (line 161) * enable-active-region: Readline Init File Syntax. - (line 169) + (line 171) * enable-bracketed-paste: Readline Init File Syntax. - (line 182) + (line 184) * enable-keypad: Readline Init File Syntax. - (line 191) + (line 193) * end-kbd-macro (C-x )): Keyboard Macros. (line 9) * end-of-file (usually C-d): Commands For Text. (line 6) * end-of-history (M->): Commands For History. @@ -4828,7 +4834,7 @@ Function and Variable Index * exchange-point-and-mark (C-x C-x): Miscellaneous Commands. (line 37) * expand-tilde: Readline Init File Syntax. - (line 202) + (line 204) * fetch-history (): Commands For History. (line 102) * forward-backward-delete-char (): Commands For Text. (line 21) @@ -4837,29 +4843,29 @@ Function and Variable Index (line 32) * forward-word (M-f): Commands For Moving. (line 18) * history-preserve-point: Readline Init File Syntax. - (line 206) + (line 208) * history-search-backward (): Commands For History. (line 56) * history-search-forward (): Commands For History. (line 50) * history-size: Readline Init File Syntax. - (line 212) + (line 214) * history-substring-search-backward (): Commands For History. (line 68) * history-substring-search-forward (): Commands For History. (line 62) * horizontal-scroll-mode: Readline Init File Syntax. - (line 221) + (line 223) * input-meta: Readline Init File Syntax. - (line 230) + (line 232) * insert-comment (M-#): Miscellaneous Commands. (line 61) * insert-completions (M-*): Commands For Completion. (line 18) * isearch-terminators: Readline Init File Syntax. - (line 238) + (line 242) * keymap: Readline Init File Syntax. - (line 245) + (line 249) * kill-line (C-k): Commands For Killing. (line 6) * kill-region (): Commands For Killing. @@ -4869,19 +4875,19 @@ Function and Variable Index * kill-word (M-d): Commands For Killing. (line 23) * mark-modified-lines: Readline Init File Syntax. - (line 275) + (line 279) * mark-symlinked-directories: Readline Init File Syntax. - (line 280) + (line 284) * match-hidden-files: Readline Init File Syntax. - (line 285) + (line 289) * menu-complete (): Commands For Completion. (line 22) * menu-complete-backward (): Commands For Completion. (line 34) * menu-complete-display-prefix: Readline Init File Syntax. - (line 292) + (line 296) * meta-flag: Readline Init File Syntax. - (line 230) + (line 232) * next-history (C-n): Commands For History. (line 16) * next-screen-line (): Commands For Moving. (line 33) @@ -4892,10 +4898,10 @@ Function and Variable Index * operate-and-get-next (C-o): Commands For History. (line 95) * output-meta: Readline Init File Syntax. - (line 297) + (line 301) * overwrite-mode (): Commands For Text. (line 73) * page-completions: Readline Init File Syntax. - (line 303) + (line 309) * possible-completions (M-?): Commands For Completion. (line 11) * prefix-meta (<ESC>): Miscellaneous Commands. @@ -4912,7 +4918,7 @@ Function and Variable Index * reverse-search-history (C-r): Commands For History. (line 26) * revert-all-at-newline: Readline Init File Syntax. - (line 313) + (line 319) * revert-line (M-r): Miscellaneous Commands. (line 26) * rl_activate_mark: Miscellaneous Functions. @@ -5205,13 +5211,13 @@ Function and Variable Index * shell-transpose-words (M-C-t): Commands For Killing. (line 32) * show-all-if-ambiguous: Readline Init File Syntax. - (line 319) -* show-all-if-unmodified: Readline Init File Syntax. (line 325) +* show-all-if-unmodified: Readline Init File Syntax. + (line 331) * show-mode-in-prompt: Readline Init File Syntax. - (line 334) -* skip-completed-text: Readline Init File Syntax. (line 340) +* skip-completed-text: Readline Init File Syntax. + (line 346) * skip-csi-sequence (): Miscellaneous Commands. (line 52) * start-kbd-macro (C-x (): Keyboard Macros. (line 6) @@ -5231,13 +5237,13 @@ Function and Variable Index (line 39) * upcase-word (M-u): Commands For Text. (line 61) * vi-cmd-mode-string: Readline Init File Syntax. - (line 353) + (line 359) * vi-editing-mode (M-C-j): Miscellaneous Commands. (line 92) * vi-ins-mode-string: Readline Init File Syntax. - (line 364) + (line 370) * visible-stats: Readline Init File Syntax. - (line 375) + (line 381) * yank (C-y): Commands For Killing. (line 70) * yank-last-arg (M-. or M-_): Commands For History. @@ -5250,59 +5256,59 @@ Function and Variable Index Tag Table: -Node: Top862 -Node: Command Line Editing1587 -Node: Introduction and Notation2239 -Node: Readline Interaction3863 -Node: Readline Bare Essentials5055 -Node: Readline Movement Commands6839 -Node: Readline Killing Commands7800 -Node: Readline Arguments9719 -Node: Searching10764 -Node: Readline Init File12917 -Node: Readline Init File Syntax14073 -Node: Conditional Init Constructs36992 -Node: Sample Init File41189 -Node: Bindable Readline Commands44314 -Node: Commands For Moving45369 -Node: Commands For History47128 -Node: Commands For Text52092 -Node: Commands For Killing55795 -Node: Numeric Arguments58509 -Node: Commands For Completion59649 -Node: Keyboard Macros61618 -Node: Miscellaneous Commands62306 -Node: Readline vi Mode66228 -Node: Programming with GNU Readline68045 -Node: Basic Behavior69031 -Node: Custom Functions72714 -Node: Readline Typedefs74197 -Node: Function Writing75831 -Node: Readline Variables77145 -Node: Readline Convenience Functions90820 -Node: Function Naming91892 -Node: Keymaps93154 -Node: Binding Keys96233 -Node: Associating Function Names and Bindings100781 -Node: Allowing Undoing104011 -Node: Redisplay106561 -Node: Modifying Text110620 -Node: Character Input111867 -Node: Terminal Management114947 -Node: Utility Functions116770 -Node: Miscellaneous Functions120098 -Node: Alternate Interface123517 -Node: A Readline Example126259 -Node: Alternate Interface Example128198 -Node: Readline Signal Handling131730 -Node: Custom Completers140983 -Node: How Completing Works141703 -Node: Completion Functions145010 -Node: Completion Variables148584 -Node: A Short Completion Example164390 -Node: GNU Free Documentation License177227 -Node: Concept Index202401 -Node: Function and Variable Index203922 +Node: Top863 +Node: Command Line Editing1588 +Node: Introduction and Notation2240 +Node: Readline Interaction3864 +Node: Readline Bare Essentials5056 +Node: Readline Movement Commands6840 +Node: Readline Killing Commands7801 +Node: Readline Arguments9720 +Node: Searching10765 +Node: Readline Init File12918 +Node: Readline Init File Syntax14074 +Node: Conditional Init Constructs37365 +Node: Sample Init File41562 +Node: Bindable Readline Commands44687 +Node: Commands For Moving45742 +Node: Commands For History47501 +Node: Commands For Text52465 +Node: Commands For Killing56168 +Node: Numeric Arguments58882 +Node: Commands For Completion60022 +Node: Keyboard Macros61991 +Node: Miscellaneous Commands62679 +Node: Readline vi Mode66601 +Node: Programming with GNU Readline68418 +Node: Basic Behavior69404 +Node: Custom Functions73087 +Node: Readline Typedefs74570 +Node: Function Writing76204 +Node: Readline Variables77518 +Node: Readline Convenience Functions91193 +Node: Function Naming92265 +Node: Keymaps93527 +Node: Binding Keys96606 +Node: Associating Function Names and Bindings101154 +Node: Allowing Undoing104384 +Node: Redisplay106934 +Node: Modifying Text110993 +Node: Character Input112240 +Node: Terminal Management115321 +Node: Utility Functions117144 +Node: Miscellaneous Functions120472 +Node: Alternate Interface123891 +Node: A Readline Example126633 +Node: Alternate Interface Example128572 +Node: Readline Signal Handling132104 +Node: Custom Completers141357 +Node: How Completing Works142077 +Node: Completion Functions145384 +Node: Completion Variables148958 +Node: A Short Completion Example164764 +Node: GNU Free Documentation License177601 +Node: Concept Index202775 +Node: Function and Variable Index204296 End Tag Table diff --git a/doc/readline.pdf b/doc/readline.pdf Binary files differindex 445eb26..2303f2b 100644 --- a/doc/readline.pdf +++ b/doc/readline.pdf diff --git a/doc/readline.ps b/doc/readline.ps index 94230d0..9ea64e7 100644 --- a/doc/readline.ps +++ b/doc/readline.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 2022.1 (TeX Live 2022) Copyright 2022 Radical Eye Software %%Title: readline.dvi -%%CreationDate: Tue Jun 14 14:48:25 2022 +%%CreationDate: Fri Aug 19 18:34:36 2022 %%Pages: 86 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o readline.ps readline.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2022.06.14:1048 +%DVIPSSource: TeX output 2022.08.19:1434 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -6684,15 +6684,15 @@ ifelse %%Page: 1 1 TeXDict begin 1 0 bop 150 1318 a Fu(GNU)65 b(Readline)g(Library)p 150 1418 3600 34 v 1873 1515 a Ft(Edition)30 b(8.2,)i(for)e -Fs(Readline)e(Library)h Ft(V)-8 b(ersion)31 b(8.2.)3285 -1623 y(Marc)m(h)g(2022)150 4927 y Fr(Chet)45 b(Ramey)-11 +Fs(Readline)e(Library)h Ft(V)-8 b(ersion)31 b(8.2.)3252 +1623 y(August)f(2022)150 4927 y Fr(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F) -11 b(oundation)p 150 5141 3600 17 v eop end %%Page: 2 2 -TeXDict begin 2 1 bop 150 4413 a Ft(This)33 b(man)m(ual)i(describ)s(es) -f(the)g(GNU)h(Readline)g(Library)e(\(v)m(ersion)i(8.2,)i(11)e(Marc)m(h) -g(2022\),)j(a)c(library)150 4523 y(whic)m(h)39 b(aids)g(in)g(the)g +TeXDict begin 2 1 bop 150 4413 a Ft(This)31 b(man)m(ual)h(describ)s(es) +f(the)h(GNU)h(Readline)f(Library)f(\(v)m(ersion)i(8.2,)g(12)g(August)f +(2022\),)i(a)e(library)150 4523 y(whic)m(h)39 b(aids)g(in)g(the)g (consistency)h(of)g(user)e(in)m(terface)j(across)f(discrete)g(programs) e(whic)m(h)h(pro)m(vide)h(a)150 4633 y(command)30 b(line)h(in)m (terface.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 @@ -7284,64 +7284,67 @@ g(p)s(ossible)f(completions)h(using)f(di\013eren)m(t)1110 b(The)38 b(color)j(de\014nitions)d(are)i(tak)m(en)1110 628 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g Fs(LS_COLORS)d Ft(en)m(vironmen)m(t)j(v)-5 b(ariable.)40 b(The)24 b(default)1110 -737 y(is)30 b(`)p Fs(off)p Ft('.)630 941 y Fs(comment-begin)1110 -1050 y Ft(The)62 b(string)g(to)h(insert)f(at)h(the)g(b)s(eginning)e(of) -h(the)h(line)f(when)g(the)1110 1160 y Fs(insert-comment)26 +737 y(is)30 b(`)p Fs(off)p Ft('.)630 925 y Fs(comment-begin)1110 +1035 y Ft(The)62 b(string)g(to)h(insert)f(at)h(the)g(b)s(eginning)e(of) +h(the)h(line)f(when)g(the)1110 1144 y Fs(insert-comment)26 b Ft(command)31 b(is)f(executed.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)f Fs("#")p Ft(.)630 1363 y Fs(completion-display-width) -1110 1473 y Ft(The)41 b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used) -g(to)h(displa)m(y)g(p)s(ossible)f(matc)m(hes)1110 1583 +b(alue)31 b(is)f Fs("#")p Ft(.)630 1332 y Fs(completion-display-width) +1110 1442 y Ft(The)41 b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used) +g(to)h(displa)m(y)g(p)s(ossible)f(matc)m(hes)1110 1551 y(when)28 b(p)s(erforming)g(completion.)41 b(The)29 b(v)-5 b(alue)29 b(is)g(ignored)g(if)g(it)h(is)f(less)g(than)1110 -1692 y(0)e(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39 +1661 y(0)e(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39 b(A)26 b(v)-5 b(alue)27 b(of)f(0)h(will)f(cause)1110 -1802 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e +1771 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e (line.)41 b(The)30 b(default)h(v)-5 b(alue)31 b(is)f(-1.)630 -2005 y Fs(completion-ignore-case)1110 2115 y Ft(If)d(set)h(to)g(`)p +1958 y Fs(completion-ignore-case)1110 2068 y Ft(If)d(set)h(to)g(`)p Fs(on)p Ft(',)g(Readline)g(p)s(erforms)e(\014lename)h(matc)m(hing)i -(and)e(completion)1110 2225 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) +(and)e(completion)1110 2178 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) 40 b(The)30 b(default)h(v)-5 b(alue)30 b(is)h(`)p Fs(off)p -Ft('.)630 2428 y Fs(completion-map-case)1110 2538 y Ft(If)22 +Ft('.)630 2365 y Fs(completion-map-case)1110 2475 y Ft(If)22 b(set)g(to)h(`)p Fs(on)p Ft(',)h(and)e Fj(completion-ignore-case)31 -b Ft(is)22 b(enabled,)i(Readline)f(treats)1110 2647 y(h)m(yphens)29 +b Ft(is)22 b(enabled,)i(Readline)f(treats)1110 2585 y(h)m(yphens)29 b(\(`)p Fs(-)p Ft('\))j(and)e(underscores)g(\(`)p Fs(_)p Ft('\))i(as)f(equiv)-5 b(alen)m(t)32 b(when)e(p)s(erforming)1110 -2757 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f -(completion.)85 b(The)44 b(default)1110 2866 y(v)-5 b(alue)31 -b(is)f(`)p Fs(off)p Ft('.)630 3070 y Fs(completion-prefix-displa)o -(y-le)o(ngth)1110 3180 y Ft(The)h(length)g(in)g(c)m(haracters)i(of)f +2694 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f +(completion.)85 b(The)44 b(default)1110 2804 y(v)-5 b(alue)31 +b(is)f(`)p Fs(off)p Ft('.)630 2992 y Fs(completion-prefix-displa)o +(y-le)o(ngth)1110 3101 y Ft(The)h(length)g(in)g(c)m(haracters)i(of)f (the)f(common)h(pre\014x)e(of)h(a)h(list)g(of)f(p)s(ossible)1110 -3289 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s -(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3399 +3211 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s +(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3320 y(v)-5 b(alue)26 b(greater)h(than)e(zero,)j(common)e(pre\014xes)e -(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3508 +(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3430 y(replaced)k(with)f(an)g(ellipsis)h(when)e(displa)m(ying)i(p)s(ossible) -f(completions.)630 3712 y Fs(completion-query-items)1110 -3821 y Ft(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h -(that)g(determines)f(when)f(the)i(user)1110 3931 y(is)43 +f(completions.)630 3618 y Fs(completion-query-items)1110 +3727 y Ft(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h +(that)g(determines)f(when)f(the)i(user)1110 3837 y(is)43 b(ask)m(ed)g(whether)f(the)g(list)h(of)g(p)s(ossibilities)g(should)f(b) -s(e)g(displa)m(y)m(ed.)77 b(If)1110 4041 y(the)29 b(n)m(um)m(b)s(er)f +s(e)g(displa)m(y)m(ed.)77 b(If)1110 3947 y(the)29 b(n)m(um)m(b)s(er)f (of)h(p)s(ossible)g(completions)h(is)f(greater)h(than)f(or)g(equal)g -(to)h(this)1110 4150 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g +(to)h(this)1110 4056 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g (whether)f(or)h(not)g(the)g(user)f(wishes)g(to)i(view)1110 -4260 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 +4166 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 b(This)31 b(v)-5 b(ariable)33 b(m)m(ust)e(b)s(e)g(set)1110 -4369 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g +4275 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g (equal)g(to)h(zero.)76 b(A)42 b(zero)g(v)-5 b(alue)1110 -4479 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46 +4385 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 -4589 y(zero.)g(The)29 b(default)i(limit)g(is)g Fs(100)p -Ft(.)630 4792 y Fs(convert-meta)1110 4902 y Ft(If)22 +4495 y(zero.)g(The)29 b(default)i(limit)g(is)g Fs(100)p +Ft(.)630 4682 y Fs(convert-meta)1110 4792 y Ft(If)22 b(set)g(to)h(`)p Fs(on)p Ft(',)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 -5011 y(to)33 b(an)e Fm(asci)r(i)h Ft(k)m(ey)h(sequence)f(b)m(y)g +4902 y(to)33 b(an)e Fm(asci)r(i)h Ft(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 -5121 y(an)24 b Fs(ESC)g Ft(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 5230 +5011 y(an)24 b Fs(ESC)g Ft(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 5121 y(The)i(default)h(v)-5 b(alue)28 b(is)f(`)p Fs(on)p Ft(',)i(but)d(will) i(b)s(e)f(set)h(to)g(`)p Fs(off)p Ft(')g(if)f(the)h(lo)s(cale)h(is)f -(one)1110 5340 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)p -eop end +(one)1110 5230 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 +5340 y Fs(LC_CTYPE)26 b Ft(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.)p eop end %%Page: 7 11 TeXDict begin 7 10 bop 150 -116 a Ft(Chapter)30 b(1:)41 b(Command)29 b(Line)i(Editing)2153 b(7)630 299 y Fs(disable-completion) @@ -7468,406 +7471,411 @@ i(will)f(not)h(clear)1110 3821 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h b(The)44 b(default)g(v)-5 b(alue)44 b(is)g(`)p Fs(off)p Ft(',)j(but)1110 4041 y(Readline)24 b(will)h(set)f(it)g(to)h(`)p Fs(on)p Ft(')e(if)h(the)g(lo)s(cale)i(con)m(tains)f(eigh)m(t-bit)g(c)m -(haracters.)1110 4150 y(The)30 b(name)g Fs(meta-flag)e -Ft(is)j(a)f(synon)m(ym)g(for)g(this)h(v)-5 b(ariable.)630 -4307 y Fs(isearch-terminators)1110 4416 y Ft(The)51 b(string)h(of)g(c)m -(haracters)h(that)f(should)e(terminate)j(an)f(incremen)m(tal)1110 -4526 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 4635 y(\(see)45 b(Section)h(1.2.5)g -([Searc)m(hing],)j(page)d(3\).)84 b(If)44 b(this)g(v)-5 -b(ariable)45 b(has)g(not)1110 4745 y(b)s(een)35 b(giv)m(en)h(a)g(v)-5 -b(alue,)37 b(the)f(c)m(haracters)h Fs(ESC)d Ft(and)h -Fl(C-J)g Ft(will)h(terminate)g(an)1110 4855 y(incremen)m(tal)c(searc)m -(h.)630 5011 y Fs(keymap)192 b Ft(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 -5121 y(commands.)71 b(Built-in)41 b Fs(keymap)e Ft(names)h(are)h -Fs(emacs)p Ft(,)h Fs(emacs-standard)p Ft(,)1110 5230 -y Fs(emacs-meta)p Ft(,)99 b Fs(emacs-ctlx)p Ft(,)f Fs(vi)p -Ft(,)j Fs(vi-move)p Ft(,)f Fs(vi-command)p Ft(,)f(and)1110 -5340 y Fs(vi-insert)p Ft(.)81 b Fs(vi)44 b Ft(is)h(equiv)-5 -b(alen)m(t)46 b(to)g Fs(vi-command)c Ft(\()p Fs(vi-move)h -Ft(is)i(also)h(a)p eop end +(haracters.)1110 4150 y(The)k(name)g Fs(meta-flag)e Ft(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 4260 y(is)35 b(dep)s(enden)m(t)f(on)h(the)g +Fs(LC_CTYPE)e Ft(lo)s(cale)k(category)-8 b(,)39 b(and)34 +b(ma)m(y)i(c)m(hange)g(if)1110 4369 y(the)31 b(lo)s(cale)h(is)e(c)m +(hanged.)630 4526 y Fs(isearch-terminators)1110 4635 +y Ft(The)51 b(string)h(of)g(c)m(haracters)h(that)f(should)e(terminate)j +(an)f(incremen)m(tal)1110 4745 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 +4855 y(\(see)45 b(Section)h(1.2.5)g([Searc)m(hing],)j(page)d(3\).)84 +b(If)44 b(this)g(v)-5 b(ariable)45 b(has)g(not)1110 4964 +y(b)s(een)35 b(giv)m(en)h(a)g(v)-5 b(alue,)37 b(the)f(c)m(haracters)h +Fs(ESC)d Ft(and)h Fl(C-J)g Ft(will)h(terminate)g(an)1110 +5074 y(incremen)m(tal)c(searc)m(h.)630 5230 y Fs(keymap)192 +b Ft(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 5340 y(commands.)71 b(Built-in)41 +b Fs(keymap)e Ft(names)h(are)h Fs(emacs)p Ft(,)h Fs(emacs-standard)p +Ft(,)p eop end %%Page: 9 13 TeXDict begin 9 12 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y(synon)m(ym\);)41 -b Fs(emacs)c Ft(is)h(equiv)-5 b(alen)m(t)39 b(to)f Fs(emacs-standard)p -Ft(.)59 b(Applications)1110 408 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 -Fs(emacs)p Ft(.)41 b(The)30 b(v)-5 b(alue)1110 518 y(of)31 -b(the)f Fs(editing-mode)d Ft(v)-5 b(ariable)31 b(also)h(a\013ects)f -(the)g(default)g(k)m(eymap.)630 706 y Fs(keyseq-timeout)1110 -816 y Ft(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 925 -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 1035 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 1144 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 -1254 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 1363 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 1473 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 Fs(rl_instream)d Ft(b)m(y)i(default\).)1110 -1583 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h +b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y Fs(emacs-meta)p +Ft(,)99 b Fs(emacs-ctlx)p Ft(,)f Fs(vi)p Ft(,)j Fs(vi-move)p +Ft(,)f Fs(vi-command)p Ft(,)f(and)1110 408 y Fs(vi-insert)p +Ft(.)81 b Fs(vi)44 b Ft(is)h(equiv)-5 b(alen)m(t)46 b(to)g +Fs(vi-command)c Ft(\()p Fs(vi-move)h Ft(is)i(also)h(a)1110 +518 y(synon)m(ym\);)41 b Fs(emacs)c Ft(is)h(equiv)-5 +b(alen)m(t)39 b(to)f Fs(emacs-standard)p Ft(.)59 b(Applications)1110 +628 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 Fs(emacs)p Ft(.)41 +b(The)30 b(v)-5 b(alue)1110 737 y(of)31 b(the)f Fs(editing-mode)d +Ft(v)-5 b(ariable)31 b(also)h(a\013ects)f(the)g(default)g(k)m(eymap.) +630 909 y Fs(keyseq-timeout)1110 1019 y Ft(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 1129 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 +1238 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 1348 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 1457 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 +1567 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 1677 +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 Fs(rl_instream)d Ft(b)m(y)i(default\).)1110 +1786 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 1692 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g +1110 1896 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 1802 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f +b(is)1110 2005 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 1911 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h +b(alue,)1110 2115 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 -2021 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)g Fs(500)p Ft(.)630 2209 y Fs(mark-directories)1110 -2318 y Ft(If)38 b(set)g(to)h(`)p Fs(on)p Ft(',)i(completed)e(directory) +2225 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 +b(alue)31 b(is)g Fs(500)p Ft(.)630 2397 y Fs(mark-directories)1110 +2506 y Ft(If)38 b(set)g(to)h(`)p Fs(on)p Ft(',)i(completed)e(directory) f(names)g(ha)m(v)m(e)i(a)e(slash)g(app)s(ended.)1110 -2428 y(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 -2616 y Fs(mark-modified-lines)1110 2725 y Ft(This)k(v)-5 +2616 y(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 +2788 y Fs(mark-modified-lines)1110 2898 y Ft(This)k(v)-5 b(ariable,)38 b(when)d(set)h(to)h(`)p Fs(on)p Ft(',)g(causes)g -(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 2835 y(terisk)f(\(`)p +(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 3007 y(terisk)f(\(`)p Fs(*)p Ft('\))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 2945 y(This)d(v)-5 +(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 3117 y(This)d(v)-5 b(ariable)31 b(is)f(`)p Fs(off)p Ft(')g(b)m(y)g(default.)630 -3133 y Fs(mark-symlinked-directori)o(es)1110 3242 y Ft(If)59 +3289 y Fs(mark-symlinked-directori)o(es)1110 3399 y Ft(If)59 b(set)h(to)g(`)p Fs(on)p Ft(',)67 b(completed)60 b(names)f(whic)m(h)g -(are)h(sym)m(b)s(olic)g(links)f(to)1110 3352 y(directories)71 +(are)h(sym)m(b)s(olic)g(links)f(to)1110 3508 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 3461 y Fs(mark-directories)p +b(to)g(the)g(v)-5 b(alue)70 b(of)1110 3618 y Fs(mark-directories)p Ft(\).)37 b(The)30 b(default)g(is)g(`)p Fs(off)p Ft('.)630 -3649 y Fs(match-hidden-files)1110 3759 y Ft(This)21 b(v)-5 +3790 y Fs(match-hidden-files)1110 3900 y Ft(This)21 b(v)-5 b(ariable,)25 b(when)d(set)g(to)h(`)p Fs(on)p Ft(',)h(causes)f -(Readline)g(to)g(matc)m(h)g(\014les)f(whose)1110 3868 +(Readline)g(to)g(matc)m(h)g(\014les)f(whose)1110 4009 y(names)44 b(b)s(egin)g(with)g(a)g(`)p Fs(.)p Ft(')g(\(hidden)f -(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 3978 +(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 4119 y(completion.)75 b(If)41 b(set)g(to)h(`)p Fs(off)p Ft(',)i(the)e (leading)g(`)p Fs(.)p Ft(')f(m)m(ust)g(b)s(e)g(supplied)f(b)m(y)1110 -4088 y(the)34 b(user)g(in)g(the)g(\014lename)g(to)h(b)s(e)f(completed.) +4228 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 Fs(on)p Ft(')g(b)m(y)1110 -4197 y(default.)630 4385 y Fs(menu-complete-display-pr)o(efix)1110 -4495 y Ft(If)f(set)h(to)g(`)p Fs(on)p Ft(',)h(men)m(u)e(completion)i +4338 y(default.)630 4510 y Fs(menu-complete-display-pr)o(efix)1110 +4620 y Ft(If)f(set)h(to)g(`)p Fs(on)p Ft(',)h(men)m(u)e(completion)i (displa)m(ys)e(the)h(common)g(pre\014x)e(of)i(the)1110 -4604 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 4714 y(through)30 +4729 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 4839 y(through)30 b(the)g(list.)42 b(The)29 b(default)i(is)f(`)p Fs(off)p -Ft('.)630 4902 y Fs(output-meta)1110 5011 y Ft(If)35 +Ft('.)630 5011 y Fs(output-meta)1110 5121 y Ft(If)35 b(set)h(to)g(`)p Fs(on)p Ft(',)h(Readline)f(will)g(displa)m(y)f(c)m -(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 5121 y(set)h(directly)g +(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 5230 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 5230 y(default)26 b(is)f(`)p Fs(off)p Ft(',)i(but)e +b(The)1110 5340 y(default)26 b(is)f(`)p Fs(off)p Ft(',)i(but)e (Readline)h(will)g(set)g(it)g(to)h(`)p Fs(on)p Ft(')e(if)h(the)f(lo)s -(cale)j(con)m(tains)1110 5340 y(eigh)m(t-bit)k(c)m(haracters.)p -eop end +(cale)j(con)m(tains)p eop end %%Page: 10 14 TeXDict begin 10 13 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(10)630 299 y Fs(page-completions) -1110 408 y Ft(If)33 b(set)i(to)f(`)p Fs(on)p Ft(',)h(Readline)g(uses)e -(an)h(in)m(ternal)h Fs(more)p Ft(-lik)m(e)f(pager)g(to)h(displa)m(y) -1110 518 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 Fs(on)p -Ft(')1110 628 y(b)m(y)e(default.)630 784 y Fs(print-completions-horizo) -o(ntal)o(ly)1110 894 y Ft(If)23 b(set)i(to)g(`)p Fs(on)p -Ft(',)g(Readline)g(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes) -h(sorted)1110 1003 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 -1113 y(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 -1270 y Fs(revert-all-at-newline)1110 1379 y Ft(If)e(set)h(to)g(`)p -Fs(on)p Ft(',)g(Readline)g(will)g(undo)f(all)h(c)m(hanges)h(to)f -(history)g(lines)f(b)s(efore)1110 1489 y(returning)f(when)f -Fs(accept-line)f Ft(is)j(executed.)41 b(By)29 b(default,)g(history)g -(lines)1110 1598 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 -1708 y Fs(readline)p Ft(.)38 b(The)30 b(default)h(is)f(`)p -Fs(off)p Ft('.)630 1864 y Fs(show-all-if-ambiguous)1110 -1974 y Ft(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 2084 y(to)f(`)p -Fs(on)p Ft(',)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 2193 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 2303 y(The)30 b(default)g(v)-5 -b(alue)31 b(is)g(`)p Fs(off)p Ft('.)630 2459 y Fs -(show-all-if-unmodified)1110 2569 y Ft(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 2679 y(fashion)25 b(similar)h(to)g Fj(sho)m(w-all-if-am)m(biguous) -p Ft(.)41 b(If)25 b(set)h(to)h(`)p Fs(on)p Ft(',)f(w)m(ords)f(whic)m(h) -1110 2788 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 -2898 y(tial)43 b(completion)h(\(the)f(p)s(ossible)f(completions)h -(don't)f(share)g(a)h(common)1110 3007 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 3117 y(ing)g(the)f(b)s(ell.)41 +b(Command)29 b(Line)i(Editing)2107 b(10)1110 299 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 Fs(LC_CTYPE)1110 408 y Ft(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 581 y Fs(page-completions)1110 +690 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(Readline)g(uses)e(an)h(in) +m(ternal)h Fs(more)p Ft(-lik)m(e)f(pager)g(to)h(displa)m(y)1110 +800 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 Fs(on)p Ft(')1110 +909 y(b)m(y)e(default.)630 1082 y Fs(print-completions-horizo)o(ntal)o +(ly)1110 1191 y Ft(If)23 b(set)i(to)g(`)p Fs(on)p Ft(',)g(Readline)g +(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes)h(sorted)1110 +1301 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 1410 y(The)30 b(default)g(is)h(`)p +Fs(off)p Ft('.)630 1583 y Fs(revert-all-at-newline)1110 +1692 y Ft(If)e(set)h(to)g(`)p Fs(on)p Ft(',)g(Readline)g(will)g(undo)f +(all)h(c)m(hanges)h(to)f(history)g(lines)f(b)s(efore)1110 +1802 y(returning)f(when)f Fs(accept-line)f Ft(is)j(executed.)41 +b(By)29 b(default,)g(history)g(lines)1110 1911 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 2021 y Fs(readline)p Ft(.)38 +b(The)30 b(default)h(is)f(`)p Fs(off)p Ft('.)630 2193 +y Fs(show-all-if-ambiguous)1110 2303 y Ft(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 2412 y(to)f(`)p Fs(on)p Ft(',)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 2522 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 2632 y(The)30 +b(default)g(v)-5 b(alue)31 b(is)g(`)p Fs(off)p Ft('.)630 +2804 y Fs(show-all-if-unmodified)1110 2913 y Ft(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 3023 y(fashion)25 b(similar)h(to)g +Fj(sho)m(w-all-if-am)m(biguous)p Ft(.)41 b(If)25 b(set)h(to)h(`)p +Fs(on)p Ft(',)f(w)m(ords)f(whic)m(h)1110 3133 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 3242 y(tial)43 b(completion)h(\(the)f(p)s(ossible) +f(completions)h(don't)f(share)g(a)h(common)1110 3352 +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 3461 y(ing)g(the)f(b)s(ell.)41 b(The)30 b(default)g(v)-5 b(alue)31 b(is)f(`)p Fs(off)p -Ft('.)630 3273 y Fs(show-mode-in-prompt)1110 3383 y Ft(If)24 +Ft('.)630 3634 y Fs(show-mode-in-prompt)1110 3743 y Ft(If)24 b(set)h(to)g(`)p Fs(on)p Ft(',)g(add)f(a)h(string)f(to)h(the)f(b)s -(eginning)g(of)g(the)h(prompt)e(indicating)1110 3493 +(eginning)g(of)g(the)h(prompt)e(indicating)1110 3853 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 3602 y(strings)45 +h(insertion.)49 b(The)32 b(mo)s(de)1110 3962 y(strings)45 b(are)h(user-settable)g(\(e.g.,)51 b Fj(emacs-mo)s(de-string)8 -b Ft(\).)87 b(The)45 b(default)1110 3712 y(v)-5 b(alue)31 -b(is)f(`)p Fs(off)p Ft('.)630 3868 y Fs(skip-completed-text)1110 -3978 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(this)f(alters)g(the)g +b Ft(\).)87 b(The)45 b(default)1110 4072 y(v)-5 b(alue)31 +b(is)f(`)p Fs(off)p Ft('.)630 4244 y Fs(skip-completed-text)1110 +4354 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(this)f(alters)g(the)g (default)g(completion)h(b)s(eha)m(vior)f(when)f(in-)1110 -4088 y(serting)d(a)h(single)g(matc)m(h)f(in)m(to)h(the)g(line.)40 +4463 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 -4197 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 4307 y(not)41 +4573 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 4682 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 4416 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f +(c)m(haracters)1110 4792 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 -4526 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45 +4902 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 -4635 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g -(after)h(the)g(`)p Fs(e)p Ft(')f(in)1110 4745 y(`)p Fs(Makefile)p +5011 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g +(after)h(the)g(`)p Fs(e)p Ft(')f(in)1110 5121 y(`)p Fs(Makefile)p Ft(')c(will)i(result)f(in)g(`)p Fs(Makefile)p Ft(')f(rather)h(than)h(`) -p Fs(Makefilefile)p Ft(',)1110 4855 y(assuming)d(there)g(is)h(a)f +p Fs(Makefilefile)p Ft(',)1110 5230 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 4964 y(is)30 b(`)p Fs(off)p Ft('.)630 5121 -y Fs(vi-cmd-mode-string)1110 5230 y Ft(If)j(the)h Fj(sho)m(w-mo)s -(de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f -(is)h(dis-)1110 5340 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)p -eop end +b(alue)1110 5340 y(is)30 b(`)p Fs(off)p Ft('.)p eop end %%Page: 11 15 TeXDict begin 11 14 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(11)1110 299 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 408 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 518 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 Fs(\\1)p Ft(')1110 628 y(and)23 -b(`)p Fs(\\2)p Ft(')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 737 -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 847 +b(Command)29 b(Line)i(Editing)2107 b(11)630 299 y Fs +(vi-cmd-mode-string)1110 408 y Ft(If)33 b(the)h Fj(sho)m(w-mo)s +(de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f +(is)h(dis-)1110 518 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 +628 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 +737 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 +847 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 Fs(\\1)p +Ft(')1110 956 y(and)23 b(`)p Fs(\\2)p Ft(')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 +1066 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 1176 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fs(\(cmd\))p Ft('.)630 1007 y Fs(vi-ins-mode-string)1110 -1117 y Ft(If)j(the)h Fj(sho)m(w-mo)s(de-in-prompt)h Ft(v)-5 +Fs(\(cmd\))p Ft('.)630 1340 y Fs(vi-ins-mode-string)1110 +1450 y Ft(If)j(the)h Fj(sho)m(w-mo)s(de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110 -1226 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 1336 y(vi)35 +1559 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 1669 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 1445 y(panded)26 +54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 1778 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 1555 y(pre\014xes)34 b(and)g(bac)m +(meta-)h(and)e(con)m(trol)1110 1888 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 Fs(\\1)p Ft(')1110 1665 y(and)23 +b(Use)35 b(the)g(`)p Fs(\\1)p Ft(')1110 1998 y(and)23 b(`)p Fs(\\2)p Ft(')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 1774 +(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 2107 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 1884 +(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 2217 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fs(\(ins\))p Ft('.)630 2044 y Fs(visible-stats)1110 2153 +Fs(\(ins\))p Ft('.)630 2381 y Fs(visible-stats)1110 2491 y Ft(If)h(set)i(to)f(`)p Fs(on)p Ft(',)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 -2263 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 -b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)150 2423 -y(Key)f(Bindings)630 2533 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h +2600 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 +b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)150 2765 +y(Key)f(Bindings)630 2874 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 2642 y(need)27 b(to)i(\014nd)d(the)i(name)f(of) +b(First)43 b(y)m(ou)630 2984 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 2752 y(sections)37 b(con)m(tain)g(tables)g +b(The)27 b(follo)m(wing)630 3093 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 2862 y(and)30 b(a)h(short)f(description)g(of)h(what)f -(the)g(command)h(do)s(es.)630 2996 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g +m(y)-8 b(,)630 3203 y(and)30 b(a)h(short)f(description)g(of)h(what)f +(the)g(command)h(do)s(es.)630 3340 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 3106 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m +(the)g(init)630 3450 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 3216 y(the)f(name)h(of)f(the)g(command.)46 b(There)32 +630 3559 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 3325 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m +(and)630 3669 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 3435 y(the)35 b(k)m(ey)g(can)g(b)s(e)f +b(The)40 b(name)h(of)630 3778 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 3544 y(comfortable.)630 -3679 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 3888 y(comfortable.)630 +4025 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 -3789 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g -(\(a)h Fj(macro)5 b Ft(\).)630 3949 y Fj(k)m(eyname)g +4134 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g +(\(a)h Fj(macro)5 b Ft(\).)630 4299 y Fj(k)m(eyname)g Ft(:)42 b Fj(function-name)35 b Ft(or)c Fj(macro)1110 -4059 y(k)m(eyname)k Ft(is)29 b(the)f(name)h(of)g(a)g(k)m(ey)h(sp)s +4408 y(k)m(eyname)k Ft(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 -4194 y Fs(Control-u:)45 b(universal-argument)1350 4303 -y(Meta-Rubout:)f(backward-kill-word)1350 4413 y(Control-o:)h(">)i -(output")1110 4548 y Ft(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112 +4545 y Fs(Control-u:)45 b(universal-argument)1350 4655 +y(Meta-Rubout:)f(backward-kill-word)1350 4765 y(Control-o:)h(">)i +(output")1110 4902 y Ft(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112 b Fl(C-u)94 b Ft(is)g(b)s(ound)f(to)i(the)f(function)1110 -4657 y Fs(universal-argument)p Ft(,)124 b Fl(M-DEL)107 -b Ft(is)i(b)s(ound)e(to)j(the)f(function)1110 4767 y +5011 y Fs(universal-argument)p Ft(,)124 b Fl(M-DEL)107 +b Ft(is)i(b)s(ound)e(to)j(the)f(function)1110 5121 y Fs(backward-kill-word)p Ft(,)75 b(and)69 b Fl(C-o)g Ft(is)h(b)s(ound)e -(to)j(run)d(the)i(macro)1110 4876 y(expressed)45 b(on)h(the)g(righ)m(t) +(to)j(run)d(the)i(macro)1110 5230 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 -Fs(>)1110 4986 y(output)p Ft(')29 b(in)m(to)i(the)g(line\).)1110 -5121 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 5230 y(pro)s(cessing)40 -b(this)f(k)m(ey)i(binding)e(syn)m(tax:)60 b Fj(DEL)p -Ft(,)42 b Fj(ESC)p Ft(,)g Fj(ESCAPE)p Ft(,)f Fj(LFD)p -Ft(,)1110 5340 y Fj(NEWLINE)p Ft(,)31 b Fj(RET)p Ft(,)f -Fj(RETURN)p Ft(,)g Fj(R)m(UBOUT)p Ft(,)h Fj(SP)-8 b(A)m(CE)p -Ft(,)31 b Fj(SPC)p Ft(,)e(and)h Fj(T)-8 b(AB)p Ft(.)p +Fs(>)1110 5340 y(output)p Ft(')29 b(in)m(to)i(the)g(line\).)p eop end %%Page: 12 16 TeXDict begin 12 15 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(12)630 299 y Fs(")p -Fj(k)m(eyseq)r Fs(")p Ft(:)41 b Fj(function-name)36 b -Ft(or)30 b Fj(macro)1110 408 y(k)m(eyseq)k Ft(di\013ers)d(from)f -Fj(k)m(eyname)37 b Ft(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f -(denoting)g(an)g(en-)1110 518 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 -628 y(double)29 b(quotes.)41 b(Some)29 b Fm(gnu)h Ft(Emacs)f(st)m(yle)i -(k)m(ey)f(escap)s(es)g(can)g(b)s(e)f(used,)g(as)1110 -737 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 847 y(recognized.)1350 -981 y Fs("\\C-u":)46 b(universal-argument)1350 1091 y("\\C-x\\C-r":)f -(re-read-init-file)1350 1200 y("\\e[11~":)g("Function)h(Key)g(1")1110 -1334 y Ft(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 -b Fl(C-u)64 b Ft(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 -1444 y Fs(universal-argument)39 b Ft(\(just)k(as)h(it)g(w)m(as)g(in)g -(the)f(\014rst)g(example\),)49 b(`)p Fl(C-x)1110 1554 +b(Command)29 b(Line)i(Editing)2107 b(12)1110 299 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 408 y(pro)s(cessing)40 b(this)f(k)m(ey)i +(binding)e(syn)m(tax:)60 b Fj(DEL)p Ft(,)42 b Fj(ESC)p +Ft(,)g Fj(ESCAPE)p Ft(,)f Fj(LFD)p Ft(,)1110 518 y Fj(NEWLINE)p +Ft(,)31 b Fj(RET)p Ft(,)f Fj(RETURN)p Ft(,)g Fj(R)m(UBOUT)p +Ft(,)h Fj(SP)-8 b(A)m(CE)p Ft(,)31 b Fj(SPC)p Ft(,)e(and)h +Fj(T)-8 b(AB)p Ft(.)630 677 y Fs(")p Fj(k)m(eyseq)r Fs(")p +Ft(:)41 b Fj(function-name)36 b Ft(or)30 b Fj(macro)1110 +787 y(k)m(eyseq)k Ft(di\013ers)d(from)f Fj(k)m(eyname)37 +b Ft(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f(denoting)g(an)g(en-)1110 +896 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 1006 y(double)29 +b(quotes.)41 b(Some)29 b Fm(gnu)h Ft(Emacs)f(st)m(yle)i(k)m(ey)f(escap) +s(es)g(can)g(b)s(e)f(used,)g(as)1110 1115 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 1225 y(recognized.)1350 1359 y Fs("\\C-u":)46 b +(universal-argument)1350 1469 y("\\C-x\\C-r":)f(re-read-init-file)1350 +1578 y("\\e[11~":)g("Function)h(Key)g(1")1110 1713 y +Ft(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 b Fl(C-u)64 +b Ft(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 +1822 y Fs(universal-argument)39 b Ft(\(just)k(as)h(it)g(w)m(as)g(in)g +(the)f(\014rst)g(example\),)49 b(`)p Fl(C-x)1110 1932 y(C-r)p Ft(')30 b(is)g(b)s(ound)e(to)j(the)g(function)f Fs(re-read-init-file)p Ft(,)c(and)j(`)p Fs(ESC)h([)g(1)g(1)1110 -1663 y(~)p Ft(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p -Fs(Function)e(Key)g(1)p Ft('.)630 1822 y(The)g(follo)m(wing)i +2041 y(~)p Ft(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p +Fs(Function)e(Key)g(1)p Ft('.)630 2200 y(The)g(follo)m(wing)i Fm(gnu)f Ft(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 1932 y(k)m(ey)i(sequences:)630 -2091 y Fl(\\C-)336 b Ft(con)m(trol)32 b(pre\014x)630 -2250 y Fl(\\M-)336 b Ft(meta)31 b(pre\014x)630 2408 y +b(ailable)32 b(when)d(sp)s(ecifying)630 2310 y(k)m(ey)i(sequences:)630 +2469 y Fl(\\C-)336 b Ft(con)m(trol)32 b(pre\014x)630 +2628 y Fl(\\M-)336 b Ft(meta)31 b(pre\014x)630 2787 y Fl(\\e)384 b Ft(an)30 b(escap)s(e)h(c)m(haracter)630 -2567 y Fl(\\\\)384 b Ft(bac)m(kslash)630 2726 y Fl(\\)p +2945 y Fl(\\\\)384 b Ft(bac)m(kslash)630 3104 y Fl(\\)p Fs(")g(")p Ft(,)30 b(a)h(double)f(quotation)i(mark)630 -2885 y Fl(\\')384 b Fs(')p Ft(,)30 b(a)h(single)g(quote)g(or)f(ap)s -(ostrophe)630 3044 y(In)d(addition)h(to)g(the)g Fm(gnu)f +3263 y Fl(\\')384 b Fs(')p Ft(,)30 b(a)h(single)g(quote)g(or)f(ap)s +(ostrophe)630 3422 y(In)d(addition)h(to)g(the)g Fm(gnu)f Ft(Emacs)h(st)m(yle)h(escap)s(e)f(sequences,)h(a)f(second)f(set)h(of)g -(bac)m(kslash)630 3154 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 -3313 y Fs(\\a)384 b Ft(alert)31 b(\(b)s(ell\))630 3471 -y Fs(\\b)384 b Ft(bac)m(kspace)630 3630 y Fs(\\d)g Ft(delete)630 -3789 y Fs(\\f)g Ft(form)30 b(feed)630 3948 y Fs(\\n)384 -b Ft(newline)630 4107 y Fs(\\r)g Ft(carriage)32 b(return)630 -4266 y Fs(\\t)384 b Ft(horizon)m(tal)32 b(tab)630 4425 -y Fs(\\v)384 b Ft(v)m(ertical)32 b(tab)630 4584 y Fs(\\)p +(bac)m(kslash)630 3532 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 +3691 y Fs(\\a)384 b Ft(alert)31 b(\(b)s(ell\))630 3850 +y Fs(\\b)384 b Ft(bac)m(kspace)630 4008 y Fs(\\d)g Ft(delete)630 +4167 y Fs(\\f)g Ft(form)30 b(feed)630 4326 y Fs(\\n)384 +b Ft(newline)630 4485 y Fs(\\r)g Ft(carriage)32 b(return)630 +4644 y Fs(\\t)384 b Ft(horizon)m(tal)32 b(tab)630 4803 +y Fs(\\v)384 b Ft(v)m(ertical)32 b(tab)630 4962 y Fs(\\)p Fl(nnn)288 b Ft(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 Fj(nnn)e -Ft(\(one)i(to)1110 4693 y(three)c(digits\))630 4852 y +Ft(\(one)i(to)1110 5071 y(three)c(digits\))630 5230 y Fs(\\x)p Fl(HH)288 b Ft(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 Fj(HH)1110 4962 y Ft(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))630 -5121 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 -5230 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 5340 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)p eop end +b Fj(HH)1110 5340 y Ft(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))p +eop end %%Page: 13 17 TeXDict begin 13 16 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(13)630 299 y(will)40 -b(quote)h(an)m(y)f(other)g(c)m(haracter)i(in)d(the)i(macro)f(text,)k -(including)39 b(`)p Fs(")p Ft(')h(and)g(`)p Fs(')p Ft('.)69 -b(F)-8 b(or)630 408 y(example,)28 b(the)e(follo)m(wing)h(binding)d -(will)i(mak)m(e)h(`)p Fl(C-x)j Fs(\\)p Ft(')c(insert)f(a)h(single)h(`)p -Fs(\\)p Ft(')f(in)m(to)g(the)g(line:)870 542 y Fs("\\C-x\\\\":)45 -b("\\\\")150 740 y Fi(1.3.2)63 b(Conditional)41 b(Init)g(Constructs)150 -887 y Ft(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 -996 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 1106 y(result)f(of)h(tests.)41 -b(There)30 b(are)h(four)f(parser)f(directiv)m(es)j(used.)150 -1264 y Fs($if)336 b Ft(The)31 b Fs($if)f Ft(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 1373 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 1483 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 -1592 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i -(it.)630 1750 y Fs(mode)288 b Ft(The)30 b Fs(mode=)e +b(Command)29 b(Line)i(Editing)2107 b(13)630 299 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 408 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 518 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 +628 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 Fs(")p Ft(')h(and)g(`)p Fs(')p +Ft('.)69 b(F)-8 b(or)630 737 y(example,)28 b(the)e(follo)m(wing)h +(binding)d(will)i(mak)m(e)h(`)p Fl(C-x)j Fs(\\)p Ft(')c(insert)f(a)h +(single)h(`)p Fs(\\)p Ft(')f(in)m(to)g(the)g(line:)870 +873 y Fs("\\C-x\\\\":)45 b("\\\\")150 1073 y Fi(1.3.2)63 +b(Conditional)41 b(Init)g(Constructs)150 1220 y Ft(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 1330 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 1440 y(result)f(of)h(tests.)41 b(There)30 b(are)h(four)f(parser)f +(directiv)m(es)j(used.)150 1601 y Fs($if)336 b Ft(The)31 +b Fs($if)f Ft(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 1711 +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 +1821 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 +1930 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i +(it.)630 2091 y Fs(mode)288 b Ft(The)30 b Fs(mode=)e Ft(form)i(of)g(the)h Fs($if)e Ft(directiv)m(e)j(is)e(used)f(to)i(test)g -(whether)e(Read-)1110 1860 y(line)44 b(is)f(in)g Fs(emacs)f +(whether)e(Read-)1110 2201 y(line)44 b(is)f(in)g Fs(emacs)f Ft(or)h Fs(vi)g Ft(mo)s(de.)79 b(This)42 b(ma)m(y)i(b)s(e)e(used)h(in)g -(conjunction)1110 1969 y(with)c(the)h(`)p Fs(set)29 b(keymap)p +(conjunction)1110 2311 y(with)c(the)h(`)p Fs(set)29 b(keymap)p Ft(')38 b(command,)k(for)d(instance,)j(to)e(set)g(bindings)e(in)1110 -2079 y(the)32 b Fs(emacs-standard)c Ft(and)j Fs(emacs-ctlx)d -Ft(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 2188 y(starting)f(out)g -(in)f Fs(emacs)f Ft(mo)s(de.)630 2346 y Fs(term)288 b +2420 y(the)32 b Fs(emacs-standard)c Ft(and)j Fs(emacs-ctlx)d +Ft(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 2530 y(starting)f(out)g +(in)f Fs(emacs)f Ft(mo)s(de.)630 2691 y Fs(term)288 b Ft(The)26 b Fs(term=)g Ft(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 2456 y(ings,)38 +(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 2800 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 2565 y(function)24 b(k)m(eys.)39 +(the)g(terminal's)1110 2910 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 -Fs(=)p Ft(')g(is)g(tested)h(against)1110 2675 y(b)s(oth)k(the)h(full)g +Fs(=)p Ft(')g(is)g(tested)h(against)1110 3020 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 2785 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p +(terminal)1110 3129 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p Fs(-)p Ft('.)50 b(This)33 b(allo)m(ws)i Fs(sun)e Ft(to)h(matc)m(h)g(b)s -(oth)f Fs(sun)g Ft(and)1110 2894 y Fs(sun-cmd)p Ft(,)c(for)h(instance.) -630 3052 y Fs(version)144 b Ft(The)44 b Fs(version)f +(oth)f Fs(sun)g Ft(and)1110 3239 y Fs(sun-cmd)p Ft(,)c(for)h(instance.) +630 3400 y Fs(version)144 b Ft(The)44 b Fs(version)f Ft(test)i(ma)m(y)h(b)s(e)e(used)f(to)j(p)s(erform)d(comparisons)i -(against)1110 3161 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 +(against)1110 3509 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 b(The)42 b Fs(version)d Ft(expands)i(to)h(the)g(curren)m(t)1110 -3271 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h +3619 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 Fs(=)p Ft(')h(\(and)1110 -3381 y(`)p Fs(==)p Ft('\),)33 b(`)p Fs(!=)p Ft(',)f(`)p +3729 y(`)p Fs(==)p Ft('\),)33 b(`)p Fs(!=)p Ft(',)f(`)p Fs(<=)p Ft(',)h(`)p Fs(>=)p Ft(',)f(`)p Fs(<)p Ft(',)h(and)e(`)p Fs(>)p Ft('.)46 b(The)31 b(v)m(ersion)i(n)m(um)m(b)s(er)d(supplied)h -(on)1110 3490 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g +(on)1110 3838 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 -3600 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 3709 +3948 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 4057 y(`)p Fs(7.1)p Ft('\).)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 Fs(0)p -Ft('.)40 b(The)1110 3819 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) +Ft('.)40 b(The)1110 4167 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) g(from)g(the)h(string)f Fs(version)f Ft(and)h(from)g(the)1110 -3929 y(v)m(ersion)39 b(n)m(um)m(b)s(er)f(argumen)m(t)h(b)m(y)f +4276 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 -4038 y(sets)31 b(a)g(v)-5 b(ariable)31 b(if)f(the)h(Readline)g(v)m +4386 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 -4172 y Fs($if)47 b(version)f(>=)h(7.0)1350 4281 y(set)g -(show-mode-in-prompt)42 b(on)1350 4391 y($endif)630 4549 -y(application)1110 4658 y Ft(The)21 b Fj(application)j +4521 y Fs($if)47 b(version)f(>=)h(7.0)1350 4631 y(set)g +(show-mode-in-prompt)42 b(on)1350 4741 y($endif)630 4902 +y(application)1110 5011 y Ft(The)21 b Fj(application)j Ft(construct)e(is)g(used)f(to)i(include)f(application-sp)s(eci\014c)h -(set-)1110 4768 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h +(set-)1110 5121 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h (Readline)g(library)g(sets)g(the)g Fj(application)1110 -4878 y(name)p Ft(,)g(and)e(y)m(ou)g(can)h(test)g(for)f(a)g(particular)h +5230 y(name)p Ft(,)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 -4987 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 5097 -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 5206 y(the)e(curren)m(t)f(or)g(previous) -g(w)m(ord)g(in)g(Bash:)1350 5340 y Fs($if)47 b(Bash)p -eop end +5340 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)p eop end %%Page: 14 18 TeXDict begin 14 17 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(14)1350 299 y Fs(#)47 -b(Quote)g(the)g(current)f(or)h(previous)e(word)1350 408 -y("\\C-xq":)h("\\eb\\"\\ef\\"")1350 518 y($endif)630 -677 y(variable)96 b Ft(The)33 b Fj(v)-5 b(ariable)39 -b Ft(construct)33 b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g -(Readline)1110 787 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 Fs(=)p Ft(',)1110 897 y(`)p Fs(==)p Ft(',)49 b(and)44 +b(Command)29 b(Line)i(Editing)2107 b(14)1110 299 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 408 y(the)e(curren)m(t)f(or)g(previous)g(w)m(ord)g(in)g +(Bash:)1350 543 y Fs($if)47 b(Bash)1350 653 y(#)g(Quote)g(the)g +(current)f(or)h(previous)e(word)1350 762 y("\\C-xq":)h +("\\eb\\"\\ef\\"")1350 872 y($endif)630 1031 y(variable)96 +b Ft(The)33 b Fj(v)-5 b(ariable)39 b Ft(construct)33 +b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g(Readline)1110 +1141 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 +Fs(=)p Ft(',)1110 1250 y(`)p Fs(==)p Ft(',)49 b(and)44 b(`)p Fs(!=)p Ft('.)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 1006 y(comparison)25 +(b)s(e)g(separated)g(from)g(the)1110 1360 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 1116 y(from)33 b(the)h(v)-5 b(alue)35 +(e)f(separated)1110 1469 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 1225 y(and)i(b)s(o)s(olean)g(v)-5 +b(Both)35 b(string)1110 1579 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 1335 y(tested)46 +b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 1689 y(tested)46 b(against)g(the)f(v)-5 b(alues)46 b Fj(on)f Ft(and)f Fj(o\013)p Ft(.)85 b(The)45 b(follo)m(wing)h(example)g(is)1110 -1445 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fs(mode=emacs)e -Ft(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 1579 y -Fs($if)47 b(editing-mode)d(==)k(emacs)1350 1689 y(set)f -(show-mode-in-prompt)42 b(on)1350 1798 y($endif)150 1958 +1798 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fs(mode=emacs)e +Ft(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 1933 y +Fs($if)47 b(editing-mode)d(==)k(emacs)1350 2042 y(set)f +(show-mode-in-prompt)42 b(on)1350 2152 y($endif)150 2311 y($endif)192 b Ft(This)29 b(command,)i(as)f(seen)h(in)f(the)g(previous) g(example,)h(terminates)g(an)g Fs($if)e Ft(command.)150 -2117 y Fs($else)240 b Ft(Commands)29 b(in)h(this)h(branc)m(h)e(of)i +2471 y Fs($else)240 b Ft(Commands)29 b(in)h(this)h(branc)m(h)e(of)i (the)f Fs($if)g Ft(directiv)m(e)i(are)f(executed)g(if)f(the)h(test)g -(fails.)150 2276 y Fs($include)96 b Ft(This)43 b(directiv)m(e)i(tak)m +(fails.)150 2630 y Fs($include)96 b Ft(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 2386 y(and)38 b(bindings)f(from)h(that)i(\014le.)65 +(commands)630 2740 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 2496 y Fs(/etc/inputrc)p Ft(:)870 2630 y Fs($include)46 -b(/etc/inputrc)150 2829 y Fi(1.3.3)63 b(Sample)41 b(Init)g(File)150 -2976 y Ft(Here)27 b(is)f(an)h(example)g(of)f(an)h Fj(inputrc)k +(from)630 2849 y Fs(/etc/inputrc)p Ft(:)870 2984 y Fs($include)46 +b(/etc/inputrc)150 3183 y Fi(1.3.3)63 b(Sample)41 b(Init)g(File)150 +3330 y Ft(Here)27 b(is)f(an)h(example)g(of)f(an)h Fj(inputrc)k Ft(\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 3086 y(conditional)j(syn)m +b(ariable)27 b(assignmen)m(t,)i(and)150 3440 y(conditional)j(syn)m (tax.)p eop end %%Page: 15 19 TeXDict begin 15 18 bop 150 -116 a Ft(Chapter)30 b(1:)41 @@ -9704,9 +9712,9 @@ Fg(\))390 3914 y Ft(Set)f(a)g(timeout)h(for)f(subsequen)m(t)f(calls)j (to)e Fs(readline\(\))p Ft(.)43 b(If)31 b(Readline)i(do)s(es)f(not)g (read)g(a)g(com-)390 4024 y(plete)37 b(line,)h(or)e(the)g(n)m(um)m(b)s (er)f(of)h(c)m(haracters)i(sp)s(eci\014ed)d(b)m(y)h Fs -(rl_num_chars_to_read)p Ft(,)c(b)s(efore)390 4133 y(the)k(duration)e -(sp)s(ec\014ed)h(b)m(y)g Fj(secs)40 b Ft(\(in)35 b(seconds\))h(and)e -Fj(usecs)40 b Ft(\(microseconds\),)e(it)d(returns)g(and)390 +(rl_num_chars_to_read)p Ft(,)c(b)s(efore)390 4133 y(the)h(duration)g +(sp)s(eci\014ed)g(b)m(y)g Fj(secs)38 b Ft(\(in)33 b(seconds\))h(and)e +Fj(usecs)37 b Ft(\(microseconds\),)f(it)d(returns)g(and)390 4243 y(sets)22 b Fs(RL_STATE_TIMEOUT)17 b Ft(in)k Fs(rl_readline_state) p Ft(.)33 b(P)m(assing)22 b(0)g(for)f Fs(secs)g Ft(and)g Fs(usecs)f Ft(cancels)390 4352 y(an)m(y)k(previously)f(set)h(timeout;)j @@ -12618,7 +12626,7 @@ Fa(:)13 b(:)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(:)34 b Fb(20)2021 4562 y Fr(V)2025 4683 y Fb(vi-cmd-mo)r(de-string)18 b Fa(:)13 b(:)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(:)33 b Fb(10)2025 +(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)33 b Fb(11)2025 4772 y Fe(vi-editing-mode)c(\(M-C-j\))22 b Fa(:)13 b(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 b Fb(25)2025 4861 y(vi-ins-mo)r(de-string)8 b Fa(:)13 diff --git a/doc/readline_3.ps b/doc/readline_3.ps index 842b4e0..361cfef 100644 --- a/doc/readline_3.ps +++ b/doc/readline_3.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Fri Apr 8 15:52:34 2022 +%%CreationDate: Fri Aug 19 14:34:37 2022 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -344,8 +344,8 @@ le is read, and the k)108 616.8 R 1.459 -.15(ey b)-.1 H 1.159 (re).15 G(xample, placing)-2.65 E(M\255Control\255u: uni)144 698.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(or)108 710.4 Q (C\255Meta\255u: uni)144 722.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument) --.18 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(1)198.45 E 0 Cg -EP +-.18 E(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(1)197.055 E 0 +Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -441,7 +441,7 @@ tes should be used to indicate a macro de\214nition.)-.15 F .089 (Unquoted te)108 720 R .089(xt is assumed to be a function name.)-.15 F .09(In the macro body)5.089 F 2.59(,t)-.65 G .09 (he backslash escapes described abo)-2.59 F -.15(ve)-.15 G -(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(2)198.45 E 0 Cg EP +(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(2)197.055 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -563,7 +563,7 @@ F0 .062(The string that is inserted in)144 696 R F1(vi)2.562 E F0 .062 (command is e)2.562 F -.15(xe)-.15 G 2.562(cuted. This).15 F(com-)2.562 E(mand is bound to)144 708 Q F1(M\255#)2.5 E F0(in emacs mode and to)2.5 E F1(#)2.5 E F0(in vi command mode.)2.5 E(GNU Readline 8.2)72 768 Q -(2022 March 11)128.74 E(3)198.45 E 0 Cg EP +(2022 August 12)127.345 E(3)197.055 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -616,1150 +616,1162 @@ ghth bit and pre\214xing it with an escape character \(in ef)144 336 R -.37 E F0 3.003(\). The)B(def)3.003 E .503(ault is)-.1 F F2(On)3.003 E F0 3.003(,b)C .503(ut readline will set it to)-3.203 F F2(Of)3.003 E(f) -.18 E F0 .502(if the locale contains eight-bit char)3.003 F(-)-.2 E -(acters.)144 360 Q F1(disable\255completion \(Off\))108 372 Q F0 .038 -(If set to)144 384 R F1(On)2.538 E F0 2.538(,r)C .038 -(eadline will inhibit w)-2.538 F .038(ord completion.)-.1 F .038 +3.049(acters. This)144 360 R -.25(va)3.049 G .549 +(riable is dependent on the).25 F F1(LC_CTYPE)3.049 E F0 .549 +(locale cate)3.049 F(gory)-.15 E 3.049(,a)-.65 G .55 +(nd may change if the lo-)-3.049 F(cale is changed.)144 372 Q F1 +(disable\255completion \(Off\))108 384 Q F0 .038(If set to)144 396 R F1 +(On)2.538 E F0 2.538(,r)C .038(eadline will inhibit w)-2.538 F .038 +(ord completion.)-.1 F .038 (Completion characters will be inserted into the)5.038 F(line as if the) -144 396 Q 2.5(yh)-.15 G(ad been mapped to)-2.5 E F1(self-insert)2.5 E F0 -(.)A F1(echo\255contr)108 408 Q(ol\255characters \(On\))-.18 E F0 1.211 -(When set to)144 420 R F1(On)3.711 E F0 3.711(,o)C 3.711(no)-3.711 G -1.211(perating systems that indicate the)-3.711 F 3.711(ys)-.15 G 1.21 +144 408 Q 2.5(yh)-.15 G(ad been mapped to)-2.5 E F1(self-insert)2.5 E F0 +(.)A F1(echo\255contr)108 420 Q(ol\255characters \(On\))-.18 E F0 1.21 +(When set to)144 432 R F1(On)3.71 E F0 3.71(,o)C 3.71(no)-3.71 G 1.211 +(perating systems that indicate the)-3.71 F 3.711(ys)-.15 G 1.211 (upport it, readline echoes a character)-3.711 F -(corresponding to a signal generated from the k)144 432 Q -.15(ey)-.1 G -(board.).15 E F1(editing\255mode \(emacs\))108 444 Q F0 .141 -(Controls whether readline be)144 456 R .141(gins with a set of k)-.15 F -.441 -.15(ey b)-.1 H .141(indings similar to).15 F F2(Emacs)2.642 E F0 -(or)2.642 E F2(vi)2.642 E F0(.)A F1(editing\255mode)5.142 E F0 -(can be set to either)144 468 Q F1(emacs)2.5 E F0(or)2.5 E F1(vi)2.5 E -F0(.)A F1(emacs\255mode\255string \(@\))108 480 Q F0 .518(If the)144 492 -R F2(show\255mode\255in\255pr)3.018 E(ompt)-.45 E F0 -.25(va)3.018 G -.517(riable is enabled, this string is displayed immediately before the) +(corresponding to a signal generated from the k)144 444 Q -.15(ey)-.1 G +(board.).15 E F1(editing\255mode \(emacs\))108 456 Q F0 .142 +(Controls whether readline be)144 468 R .141(gins with a set of k)-.15 F +.441 -.15(ey b)-.1 H .141(indings similar to).15 F F2(Emacs)2.641 E F0 +(or)2.641 E F2(vi)2.641 E F0(.)A F1(editing\255mode)5.141 E F0 +(can be set to either)144 480 Q F1(emacs)2.5 E F0(or)2.5 E F1(vi)2.5 E +F0(.)A F1(emacs\255mode\255string \(@\))108 492 Q F0 .517(If the)144 504 +R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0 -.25(va)3.017 G +.518(riable is enabled, this string is displayed immediately before the) .25 F .622 -(last line of the primary prompt when emacs editing mode is acti)144 504 -R -.15(ve)-.25 G 5.622(.T).15 G .622(he v)-5.622 F .622(alue is e)-.25 F -.622(xpanded lik)-.15 F 3.122(ea)-.1 G -.1(ke)144 516 S 3.34(yb)-.05 G -.839(inding, so the standard set of meta- and control pre\214x)-3.34 F -.839(es and backslash escape sequences is)-.15 F -.2(av)144 528 S 2.798 +(last line of the primary prompt when emacs editing mode is acti)144 516 +R -.15(ve)-.25 G 5.622(.T).15 G .622(he v)-5.622 F .621(alue is e)-.25 F +.621(xpanded lik)-.15 F 3.121(ea)-.1 G -.1(ke)144 528 S 3.339(yb)-.05 G +.839(inding, so the standard set of meta- and control pre\214x)-3.339 F +.84(es and backslash escape sequences is)-.15 F -.2(av)144 540 S 2.798 (ailable. Use)-.05 F .298(the \\1 and \\2 escapes to be)2.798 F .298 (gin and end sequences of non-printing characters, which)-.15 F (can be used to embed a terminal control sequence into the mode string.) -144 540 Q F1(enable\255acti)108 552 Q -.1(ve)-.1 G<ad72>.1 E -(egion \(On\))-.18 E F0(The)144 564 Q F2(point)3.246 E F0 .746 -(is the current cursor position, and)3.246 F F2(mark)3.246 E F0 .746 +144 552 Q F1(enable\255acti)108 564 Q -.1(ve)-.1 G<ad72>.1 E +(egion \(On\))-.18 E F0(The)144 576 Q F2(point)3.245 E F0 .746 +(is the current cursor position, and)3.245 F F2(mark)3.246 E F0 .746 (refers to a sa)3.246 F -.15(ve)-.2 G 3.246(dc).15 G .746 -(ursor position.)-3.246 F .745(The te)5.746 F .745(xt be-)-.15 F .344 -(tween the point and mark is referred to as the)144 576 R F2 -.37(re) +(ursor position.)-3.246 F .746(The te)5.746 F .746(xt be-)-.15 F .344 +(tween the point and mark is referred to as the)144 588 R F2 -.37(re) 2.844 G(gion)-.03 E F0 5.344(.W)C .344(hen this v)-5.344 F .344 -(ariable is set to)-.25 F F2(On)2.845 E F0 2.845(,r)C .345(eadline al-) --2.845 F(lo)144 588 Q .098(ws certain commands to designate the re)-.25 +(ariable is set to)-.25 F F2(On)2.844 E F0 2.844(,r)C .344(eadline al-) +-2.844 F(lo)144 600 Q .098(ws certain commands to designate the re)-.25 F .098(gion as)-.15 F F2(active)2.598 E F0 5.098(.W)C .098(hen the re) -5.098 F .098(gion is acti)-.15 F -.15(ve)-.25 G 2.598(,r).15 G .098 -(eadline high-)-2.598 F .97(lights the te)144 600 R .97(xt in the re) --.15 F .971(gion using the v)-.15 F .971(alue of the)-.25 F F1(acti) -3.471 E -.1(ve)-.1 G<ad72>.1 E(egion\255start\255color)-.18 E F0 3.471 -(,w)C .971(hich def)-3.471 F .971(aults to)-.1 F .485 -(the string that enables the terminal')144 612 R 2.985(ss)-.55 G .485 +(eadline high-)-2.598 F .971(lights the te)144 612 R .971(xt in the re) +-.15 F .971(gion using the v)-.15 F .971(alue of the)-.25 F F1(acti)3.47 +E -.1(ve)-.1 G<ad72>.1 E(egion\255start\255color)-.18 E F0 3.47(,w)C .97 +(hich def)-3.47 F .97(aults to)-.1 F .484 +(the string that enables the terminal')144 624 R 2.985(ss)-.55 G .485 (tandout mode.)-2.985 F .485(The acti)5.485 F .785 -.15(ve r)-.25 H -.15 -(eg).15 G .484(ion sho).15 F .484(ws the te)-.25 F .484(xt inserted by) --.15 F(brack)144 624 Q(eted-paste and an)-.1 E 2.5(ym)-.15 G(atching te) +(eg).15 G .485(ion sho).15 F .485(ws the te)-.25 F .485(xt inserted by) +-.15 F(brack)144 636 Q(eted-paste and an)-.1 E 2.5(ym)-.15 G(atching te) -2.5 E(xt found by incremental and non-incremental history searches.) --.15 E F1(enable\255brack)108 636 Q(eted\255paste \(On\))-.1 E F0 .84 -(When set to)144 648 R F1(On)3.34 E F0 3.34(,r)C .841(eadline con\214gu\ -res the terminal to insert each paste into the editing b)-3.34 F(uf)-.2 -E .841(fer as a)-.25 F .799(single string of characters, instead of tre\ -ating each character as if it had been read from the k)144 660 R -.15 -(ey)-.1 G(-).15 E 3.158(board. This)144 672 R(pre)3.158 E -.15(ve)-.25 G -.658(nts readline from e).15 F -.15(xe)-.15 G .658(cuting an).15 F 3.158 -(ye)-.15 G .659(diting commands bound to k)-3.158 F .959 -.15(ey s)-.1 H -.659(equences ap-).15 F(pearing in the pasted te)144 684 Q(xt.)-.15 E F1 -(enable\255k)108 696 Q(eypad \(Off\))-.1 E F0 .893(When set to)144 708 R -F1(On)3.393 E F0 3.393(,r)C .893 -(eadline will try to enable the application k)-3.393 F -.15(ey)-.1 G -.893(pad when it is called.).15 F .892(Some sys-)5.893 F -(tems need this to enable the arro)144 720 Q 2.5(wk)-.25 G -.15(ey)-2.6 -G(s.).15 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(4)198.45 E 0 -Cg EP +-.15 E F1(enable\255brack)108 648 Q(eted\255paste \(On\))-.1 E F0 .841 +(When set to)144 660 R F1(On)3.341 E F0 3.341(,r)C .841(eadline con\214\ +gures the terminal to insert each paste into the editing b)-3.341 F(uf) +-.2 E .84(fer as a)-.25 F .799(single string of characters, instead of \ +treating each character as if it had been read from the k)144 672 R -.15 +(ey)-.1 G(-).15 E 3.159(board. This)144 684 R(pre)3.159 E -.15(ve)-.25 G +.659(nts readline from e).15 F -.15(xe)-.15 G .659(cuting an).15 F 3.158 +(ye)-.15 G .658(diting commands bound to k)-3.158 F .958 -.15(ey s)-.1 H +.658(equences ap-).15 F(pearing in the pasted te)144 696 Q(xt.)-.15 E +(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(4)197.055 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R (Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(enable\255meta\255k)108 84 Q(ey \(On\))-.1 E F0 .64(When set to)144 96 -R F1(On)3.14 E F0 3.14(,r)C .64(eadline will try to enable an)-3.14 F -3.14(ym)-.15 G .64(eta modi\214er k)-3.14 F .94 -.15(ey t)-.1 H .64 -(he terminal claims to support).15 F(when it is called.)144 108 Q +(enable\255k)108 84 Q(eypad \(Off\))-.1 E F0 .892(When set to)144 96 R +F1(On)3.393 E F0 3.393(,r)C .893 +(eadline will try to enable the application k)-3.393 F -.15(ey)-.1 G +.893(pad when it is called.).15 F .893(Some sys-)5.893 F +(tems need this to enable the arro)144 108 Q 2.5(wk)-.25 G -.15(ey)-2.6 +G(s.).15 E F1(enable\255meta\255k)108 120 Q(ey \(On\))-.1 E F0 .64 +(When set to)144 132 R F1(On)3.14 E F0 3.14(,r)C .64 +(eadline will try to enable an)-3.14 F 3.14(ym)-.15 G .64 +(eta modi\214er k)-3.14 F .94 -.15(ey t)-.1 H .64 +(he terminal claims to support).15 F(when it is called.)144 144 Q (On man)5 E 2.5(yt)-.15 G(erminals, the meta k)-2.5 E .3 -.15(ey i)-.1 H 2.5(su).15 G(sed to send eight-bit characters.)-2.5 E F1 -(expand\255tilde \(Off\))108 120 Q F0(If set to)144 132 Q F1(On)2.5 E F0 +(expand\255tilde \(Off\))108 156 Q F0(If set to)144 168 Q F1(On)2.5 E F0 2.5(,t)C(ilde e)-2.5 E(xpansion is performed when readline attempts w) --.15 E(ord completion.)-.1 E F1(history\255pr)108 144 Q(eser)-.18 E -.1 -(ve)-.1 G(\255point \(Off\)).1 E F0 .553(If set to)144 156 R F1(On)3.052 +-.15 E(ord completion.)-.1 E F1(history\255pr)108 180 Q(eser)-.18 E -.1 +(ve)-.1 G(\255point \(Off\)).1 E F0 .552(If set to)144 192 R F1(On)3.052 E F0 3.052(,t)C .552(he history code attempts to place point at the sam\ -e location on each history line re-)-3.052 F(trie)144 168 Q -.15(ve)-.25 +e location on each history line re-)-3.052 F(trie)144 204 Q -.15(ve)-.25 G 2.5(dw).15 G(ith)-2.5 E F1(pr)2.5 E -.15(ev)-.18 G(ious-history).15 E F0(or)2.5 E F1(next-history)2.5 E F0(.)A F1(history\255size \(unset\)) -108 180 Q F0 .948(Set the maximum number of history entries sa)144 192 R +108 216 Q F0 .949(Set the maximum number of history entries sa)144 228 R -.15(ve)-.2 G 3.448(di).15 G 3.448(nt)-3.448 G .948(he history list.) --3.448 F .949(If set to zero, an)5.948 F 3.449(ye)-.15 G(xisting)-3.599 -E .483(history entries are deleted and no ne)144 204 R 2.983(we)-.25 G -.483(ntries are sa)-2.983 F -.15(ve)-.2 G 2.983(d. If).15 F .482 -(set to a v)2.983 F .482(alue less than zero, the num-)-.25 F .355 -(ber of history entries is not limited.)144 216 R .355(By def)5.355 F -.356(ault, the number of history entries is not limited.)-.1 F .356 -(If an)5.356 F .821(attempt is made to set)144 228 R/F2 10 -/Times-Italic@0 SF(history\255size)3.321 E F0 .821(to a non-numeric v) -3.321 F .82(alue, the maximum number of history en-)-.25 F -(tries will be set to 500.)144 240 Q F1(horizontal\255scr)108 252 Q -(oll\255mode \(Off\))-.18 E F0 .448(When set to)144 264 R F1(On)2.948 E -F0 2.948(,m)C(ak)-2.948 E .448 -(es readline use a single line for display)-.1 F 2.948(,s)-.65 G .449 +-3.448 F .948(If set to zero, an)5.948 F 3.448(ye)-.15 G(xisting)-3.598 +E .482(history entries are deleted and no ne)144 240 R 2.982(we)-.25 G +.483(ntries are sa)-2.982 F -.15(ve)-.2 G 2.983(d. If).15 F .483 +(set to a v)2.983 F .483(alue less than zero, the num-)-.25 F .356 +(ber of history entries is not limited.)144 252 R .356(By def)5.356 F +.355(ault, the number of history entries is not limited.)-.1 F .355 +(If an)5.355 F .82(attempt is made to set)144 264 R/F2 10/Times-Italic@0 +SF(history\255size)3.32 E F0 .821(to a non-numeric v)3.321 F .821 +(alue, the maximum number of history en-)-.25 F +(tries will be set to 500.)144 276 Q F1(horizontal\255scr)108 288 Q +(oll\255mode \(Off\))-.18 E F0 .449(When set to)144 300 R F1(On)2.949 E +F0 2.949(,m)C(ak)-2.949 E .448 +(es readline use a single line for display)-.1 F 2.948(,s)-.65 G .448 (crolling the input horizontally on a)-2.948 F 1.194(single screen line\ when it becomes longer than the screen width rather than wrapping to a\ - ne)144 276 R(w)-.25 E 2.5(line. This)144 288 R + ne)144 312 R(w)-.25 E 2.5(line. This)144 324 R (setting is automatically enabled for terminals of height 1.)2.5 E F1 -(input\255meta \(Off\))108 300 Q F0 .367(If set to)144 312 R F1(On)2.867 +(input\255meta \(Off\))108 336 Q F0 .367(If set to)144 348 R F1(On)2.867 E F0 2.867(,r)C .367(eadline will enable eight-bit input \(that is, it \ -will not clear the eighth bit in the char)-2.867 F(-)-.2 E .957 -(acters it reads\), re)144 324 R -.05(ga)-.15 G .956 -(rdless of what the terminal claims it can support.).05 F .956(The name) -5.956 F F1(meta\255\215ag)3.456 E F0 .956(is a)3.456 F(synon)144 336 Q +will not clear the eighth bit in the char)-2.867 F(-)-.2 E .956 +(acters it reads\), re)144 360 R -.05(ga)-.15 G .956 +(rdless of what the terminal claims it can support.).05 F .957(The name) +5.956 F F1(meta\255\215ag)3.457 E F0 .957(is a)3.457 F(synon)144 372 Q .77(ym for this v)-.15 F 3.27(ariable. The)-.25 F(def)3.27 E .77 (ault is)-.1 F F2(Of)3.27 E(f)-.18 E F0 3.27(,b)C .77 (ut readline will set it to)-3.47 F F2(On)3.27 E F0 .77 -(if the locale contains)3.27 F(eight-bit characters.)144 348 Q F1(isear) -108 360 Q(ch\255terminators \(`)-.18 E(`C\255[ C\255J')-.63 E('\))-.63 E -F0 .439(The string of characters that should terminate an incremental s\ -earch without subsequently e)144 372 R -.15(xe)-.15 G(cut-).15 E .934 -(ing the character as a command.)144 384 R .935(If this v)5.935 F .935 -(ariable has not been gi)-.25 F -.15(ve)-.25 G 3.435(nav).15 G .935 -(alue, the characters)-3.685 F F2(ESC)3.435 E F0(and)144 396 Q F2 +(if the locale contains)3.27 F 1.866(eight-bit characters.)144 384 R +1.866(This v)6.866 F 1.867(ariable is dependent on the)-.25 F F1 +(LC_CTYPE)4.367 E F0 1.867(locale cate)4.367 F(gory)-.15 E 4.367(,a)-.65 +G 1.867(nd may)-4.367 F(change if the locale is changed.)144 396 Q F1 +(isear)108 408 Q(ch\255terminators \(`)-.18 E(`C\255[ C\255J')-.63 E +('\))-.63 E F0 .439(The string of characters that should terminate an i\ +ncremental search without subsequently e)144 420 R -.15(xe)-.15 G(cut-) +.15 E .934(ing the character as a command.)144 432 R .935(If this v) +5.935 F .935(ariable has not been gi)-.25 F -.15(ve)-.25 G 3.435(nav).15 +G .935(alue, the characters)-3.685 F F2(ESC)3.435 E F0(and)144 444 Q F2 (C\255J)2.5 E F0(will terminate an incremental search.)2.5 E F1 -.1(ke) -108 408 S(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144 -420 R -.15(ey)-.1 G 4.823(map. The).15 F 2.323(set of le)4.823 F -.05 +108 456 S(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144 +468 R -.15(ey)-.1 G 4.823(map. The).15 F 2.323(set of le)4.823 F -.05 (ga)-.15 G 4.823(lk).05 G -.15(ey)-4.923 G 2.323(map names is).15 F F2 2.323(emacs, emacs-standar)4.823 F(d,)-.37 E .781 -(emacs-meta, emacs-ctlx, vi, vi-mo)144 432 R(ve)-.1 E 3.282(,v)-.1 G +(emacs-meta, emacs-ctlx, vi, vi-mo)144 480 R(ve)-.1 E 3.282(,v)-.1 G (i-command)-3.282 E F0 3.282(,a)C(nd)-3.282 E F2(vi-insert)3.572 E F0(.) .68 E F2(vi)5.782 E F0 .782(is equi)3.282 F -.25(va)-.25 G .782(lent to) -.25 F F2(vi-command)3.282 E F0(;)A F2(emacs)144 444 Q F0 .683(is equi) +.25 F F2(vi-command)3.282 E F0(;)A F2(emacs)144 492 Q F0 .683(is equi) 3.183 F -.25(va)-.25 G .683(lent to).25 F F2(emacs-standar)3.183 E(d) -.37 E F0 5.682(.T)C .682(he def)-5.682 F .682(ault v)-.1 F .682 (alue is)-.25 F F2(emacs)3.372 E F0 5.682(.T).27 G .682(he v)-5.682 F -.682(alue of)-.25 F F1(editing\255mode)3.182 E F0(also af)144 456 Q +.682(alue of)-.25 F F1(editing\255mode)3.182 E F0(also af)144 504 Q (fects the def)-.25 E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F1 -.1(ke) -108 468 S(yseq\255timeout \(500\)).1 E F0 .367(Speci\214es the duration) -144 480 R F2 -.37(re)2.867 G(adline).37 E F0 .367(will w)2.867 F .367 +108 516 S(yseq\255timeout \(500\)).1 E F0 .367(Speci\214es the duration) +144 528 R F2 -.37(re)2.867 G(adline).37 E F0 .367(will w)2.867 F .367 (ait for a character when reading an ambiguous k)-.1 F .668 -.15(ey s) --.1 H(equence).15 E .525(\(one that can form a complete k)144 492 R .825 +-.1 H(equence).15 E .525(\(one that can form a complete k)144 540 R .825 -.15(ey s)-.1 H .524(equence using the input read so f).15 F(ar)-.1 E 3.024(,o)-.4 G 3.024(rc)-3.024 G .524(an tak)-3.024 F 3.024(ea)-.1 G -.524(dditional in-)-3.024 F .806(put to complete a longer k)144 504 R +.524(dditional in-)-3.024 F .806(put to complete a longer k)144 552 R 1.106 -.15(ey s)-.1 H 3.306(equence\). If).15 F .806(no input is recei) 3.306 F -.15(ve)-.25 G 3.306(dw).15 G .807(ithin the timeout,)-3.306 F F2 -.37(re)3.307 G(adline).37 E F0(will)3.307 E .907(use the shorter b) -144 516 R .907(ut complete k)-.2 F 1.207 -.15(ey s)-.1 H 3.407 +144 564 R .907(ut complete k)-.2 F 1.207 -.15(ey s)-.1 H 3.407 (equence. The).15 F -.25(va)3.407 G .907 (lue is speci\214ed in milliseconds, so a v).25 F .906(alue of)-.25 F -.05(1000 means that)144 528 R F2 -.37(re)2.55 G(adline).37 E F0 .05 +.05(1000 means that)144 576 R F2 -.37(re)2.55 G(adline).37 E F0 .05 (will w)2.55 F .05(ait one second for additional input.)-.1 F .05 (If this v)5.05 F .05(ariable is set to a v)-.25 F(alue)-.25 E .051 -(less than or equal to zero, or to a non-numeric v)144 540 R(alue,)-.25 +(less than or equal to zero, or to a non-numeric v)144 588 R(alue,)-.25 E F2 -.37(re)2.551 G(adline).37 E F0 .051(will w)2.551 F .051 (ait until another k)-.1 F .351 -.15(ey i)-.1 H 2.551(sp).15 G(ressed) --2.551 E(to decide which k)144 552 Q .3 -.15(ey s)-.1 H -(equence to complete.).15 E F1(mark\255dir)108 564 Q(ectories \(On\)) --.18 E F0(If set to)144 576 Q F1(On)2.5 E F0 2.5(,c)C +-2.551 E(to decide which k)144 600 Q .3 -.15(ey s)-.1 H +(equence to complete.).15 E F1(mark\255dir)108 612 Q(ectories \(On\)) +-.18 E F0(If set to)144 624 Q F1(On)2.5 E F0 2.5(,c)C (ompleted directory names ha)-2.5 E .3 -.15(ve a s)-.2 H(lash appended.) -.15 E F1(mark\255modi\214ed\255lines \(Off\))108 588 Q F0(If set to)144 -600 Q F1(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b) +.15 E F1(mark\255modi\214ed\255lines \(Off\))108 636 Q F0(If set to)144 +648 Q F1(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b) -.2 H(een modi\214ed are displayed with a preceding asterisk \().15 E F1 -(*)A F0(\).)A F1(mark\255symlink)108 612 Q(ed\255dir)-.1 E -(ectories \(Off\))-.18 E F0 .175(If set to)144 624 R F1(On)2.675 E F0 +(*)A F0(\).)A F1(mark\255symlink)108 660 Q(ed\255dir)-.1 E +(ectories \(Off\))-.18 E F0 .175(If set to)144 672 R F1(On)2.675 E F0 2.675(,c)C .175 (ompleted names which are symbolic links to directories ha)-2.675 F .475 --.15(ve a s)-.2 H .175(lash appended \(sub-).15 F(ject to the v)144 636 +-.15(ve a s)-.2 H .175(lash appended \(sub-).15 F(ject to the v)144 684 Q(alue of)-.25 E F1(mark\255dir)2.5 E(ectories)-.18 E F0(\).)A F1 -(match\255hidden\255\214les \(On\))108 648 Q F0 .193(This v)144 660 R +(match\255hidden\255\214les \(On\))108 696 Q F0 .193(This v)144 708 R .193(ariable, when set to)-.25 F F1(On)2.693 E F0 2.693(,c)C .192 (auses readline to match \214les whose names be)-2.693 F .192 (gin with a `.)-.15 F 2.692('\()-.7 G(hidden)-2.692 E .456 -(\214les\) when performing \214lename completion.)144 672 R .456 +(\214les\) when performing \214lename completion.)144 720 R .456 (If set to)5.456 F F1(Off)2.956 E F0 2.956(,t)C .456(he leading `.) -2.956 F 2.956('m)-.7 G .457(ust be supplied by the)-2.956 F -(user in the \214lename to be completed.)144 684 Q F1 -(menu\255complete\255display\255pr)108 696 Q(e\214x \(Off\))-.18 E F0 -1.586(If set to)144 708 R F1(On)4.086 E F0 4.086(,m)C 1.585(enu complet\ -ion displays the common pre\214x of the list of possible completions) --4.086 F(\(which may be empty\) before c)144 720 Q -(ycling through the list.)-.15 E(GNU Readline 8.2)72 768 Q -(2022 March 11)128.74 E(5)198.45 E 0 Cg EP +(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(5)197.055 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(output\255meta \(Off\))108 84 Q F0 .506(If set to)144 96 R F1(On)3.006 -E F0 3.006(,r)C .507(eadline will display characters with the eighth bi\ -t set directly rather than as a meta-)-3.006 F(pre\214x)144 108 Q .885 -(ed escape sequence.)-.15 F .884(The def)5.884 F .884(ault is)-.1 F/F2 -10/Times-Italic@0 SF(Of)3.384 E(f)-.18 E F0 3.384(,b)C .884 -(ut readline will set it to)-3.584 F F2(On)3.384 E F0 .884 -(if the locale contains)3.384 F(eight-bit characters.)144 120 Q F1 -(page\255completions \(On\))108 132 Q F0 .808(If set to)144 144 R F1(On) +(Functions Manual)2.5 E(READLINE\(3\))119.855 E +(user in the \214lename to be completed.)144 84 Q/F1 10/Times-Bold@0 SF +(menu\255complete\255display\255pr)108 96 Q(e\214x \(Off\))-.18 E F0 +1.586(If set to)144 108 R F1(On)4.086 E F0 4.086(,m)C 1.585(enu complet\ +ion displays the common pre\214x of the list of possible completions) +-4.086 F(\(which may be empty\) before c)144 120 Q +(ycling through the list.)-.15 E F1(output\255meta \(Off\))108 132 Q F0 +.506(If set to)144 144 R F1(On)3.006 E F0 3.006(,r)C .507(eadline will \ +display characters with the eighth bit set directly rather than as a me\ +ta-)-3.006 F(pre\214x)144 156 Q .885(ed escape sequence.)-.15 F .884 +(The def)5.884 F .884(ault is)-.1 F/F2 10/Times-Italic@0 SF(Of)3.384 E +(f)-.18 E F0 3.384(,b)C .884(ut readline will set it to)-3.584 F F2(On) +3.384 E F0 .884(if the locale contains)3.384 F 1.866 +(eight-bit characters.)144 168 R 1.866(This v)6.866 F 1.867 +(ariable is dependent on the)-.25 F F1(LC_CTYPE)4.367 E F0 1.867 +(locale cate)4.367 F(gory)-.15 E 4.367(,a)-.65 G 1.867(nd may)-4.367 F +(change if the locale is changed.)144 180 Q F1 +(page\255completions \(On\))108 192 Q F0 .809(If set to)144 204 R F1(On) 3.308 E F0 3.308(,r)C .808(eadline uses an internal)-3.308 F F2(mor) 3.308 E(e)-.37 E F0(-lik)A 3.308(ep)-.1 G .808 (ager to display a screenful of possible comple-)-3.308 F -(tions at a time.)144 156 Q F1 -(print\255completions\255horizontally \(Off\))108 168 Q F0 .228 -(If set to)144 180 R F1(On)2.727 E F0 2.727(,r)C .227(eadline will disp\ +(tions at a time.)144 216 Q F1 +(print\255completions\255horizontally \(Off\))108 228 Q F0 .227 +(If set to)144 240 R F1(On)2.727 E F0 2.727(,r)C .227(eadline will disp\ lay completions with matches sorted horizontally in alphabetical or) --2.727 F(-)-.2 E(der)144 192 Q 2.5(,r)-.4 G(ather than do)-2.5 E -(wn the screen.)-.25 E F1 -2.29 -.18(re v)108 204 T -(ert\255all\255at\255newline \(Off\)).08 E F0 .698(If set to)144 216 R -F1(On)3.198 E F0 3.198(,r)C .699 +-2.727 F(-)-.2 E(der)144 252 Q 2.5(,r)-.4 G(ather than do)-2.5 E +(wn the screen.)-.25 E F1 -2.29 -.18(re v)108 264 T +(ert\255all\255at\255newline \(Off\)).08 E F0 .699(If set to)144 276 R +F1(On)3.199 E F0 3.199(,r)C .699 (eadline will undo all changes to history lines before returning when) --3.198 F F1(accept\255line)3.199 E F0(is)3.199 E -.15(exe)144 228 S +-3.199 F F1(accept\255line)3.198 E F0(is)3.198 E -.15(exe)144 288 S 2.686(cuted. By).15 F(def)2.686 E .186 (ault, history lines may be modi\214ed and retain indi)-.1 F .186 -(vidual undo lists across calls to)-.25 F F1 -.18(re)144 240 S(adline) -.18 E F0(.)A F1(sho)108 252 Q(w\255all\255if\255ambiguous \(Off\))-.1 E -F0 .303(This alters the def)144 264 R .303(ault beha)-.1 F .304 +(vidual undo lists across calls to)-.25 F F1 -.18(re)144 300 S(adline) +.18 E F0(.)A F1(sho)108 312 Q(w\255all\255if\255ambiguous \(Off\))-.1 E +F0 .304(This alters the def)144 324 R .304(ault beha)-.1 F .304 (vior of the completion functions.)-.2 F .304(If set to)5.304 F F1(On) -2.804 E F0 2.804(,w)C .304(ords which ha)-2.904 F .604 -.15(ve m)-.2 H +2.804 E F0 2.803(,w)C .303(ords which ha)-2.903 F .603 -.15(ve m)-.2 H (ore).15 E 1.264(than one possible completion cause the matches to be l\ -isted immediately instead of ringing the)144 276 R(bell.)144 288 Q F1 -(sho)108 300 Q(w\255all\255if\255unmodi\214ed \(Off\))-.1 E F0 5.345 -(This alters the def)144 312 R 5.345(ault beha)-.1 F 5.345 -(vior of the completion functions in a f)-.2 F 5.346(ashion similar to) --.1 F F1(sho)144 324 Q(w\255all\255if\255ambiguous)-.1 E F0 6.691(.I)C -4.191(fs)-6.691 G 1.691(et to)-4.191 F F1(On)4.191 E F0 4.191(,w)C 1.691 +isted immediately instead of ringing the)144 336 R(bell.)144 348 Q F1 +(sho)108 360 Q(w\255all\255if\255unmodi\214ed \(Off\))-.1 E F0 5.346 +(This alters the def)144 372 R 5.346(ault beha)-.1 F 5.345 +(vior of the completion functions in a f)-.2 F 5.345(ashion similar to) +-.1 F F1(sho)144 384 Q(w\255all\255if\255ambiguous)-.1 E F0 6.69(.I)C +4.19(fs)-6.69 G 1.691(et to)-4.19 F F1(On)4.191 E F0 4.191(,w)C 1.691 (ords which ha)-4.291 F 1.991 -.15(ve m)-.2 H 1.691 -(ore than one possible completion).15 F 1.039(without an)144 336 R 3.539 +(ore than one possible completion).15 F 1.04(without an)144 396 R 3.54 (yp)-.15 G 1.039 -(ossible partial completion \(the possible completions don')-3.539 F -3.539(ts)-.18 G 1.04(hare a common pre\214x\))-3.539 F(cause the matche\ -s to be listed immediately instead of ringing the bell.)144 348 Q F1 -(sho)108 360 Q(w\255mode\255in\255pr)-.1 E(ompt \(Off\))-.18 E F0 1.022 -(If set to)144 372 R F1(On)3.522 E F0 3.522(,a)C 1.022 -(dd a string to the be)-3.522 F 1.021 +(ossible partial completion \(the possible completions don')-3.54 F +3.539(ts)-.18 G 1.039(hare a common pre\214x\))-3.539 F(cause the match\ +es to be listed immediately instead of ringing the bell.)144 408 Q F1 +(sho)108 420 Q(w\255mode\255in\255pr)-.1 E(ompt \(Off\))-.18 E F0 1.021 +(If set to)144 432 R F1(On)3.521 E F0 3.521(,a)C 1.022 +(dd a string to the be)-3.521 F 1.022 (ginning of the prompt indicating the editing mode: emacs, vi)-.15 F -(command, or vi insertion.)144 384 Q(The mode strings are user)5 E +(command, or vi insertion.)144 444 Q(The mode strings are user)5 E (-settable \(e.g.,)-.2 E F2(emacs\255mode\255string)2.5 E F0(\).)A F1 -(skip\255completed\255text \(Off\))108 396 Q F0 .094(If set to)144 408 R -F1(On)2.594 E F0 2.594(,t)C .095(his alters the def)-2.594 F .095 -(ault completion beha)-.1 F .095 -(vior when inserting a single match into the line.)-.2 F(It')144 420 Q -2.546(so)-.55 G .046(nly acti)-2.546 F .346 -.15(ve w)-.25 H .046 -(hen performing completion in the middle of a w).15 F 2.545(ord. If)-.1 -F .045(enabled, readline does not)2.545 F 1.394(insert characters from \ -the completion that match characters after point in the w)144 432 R -1.395(ord being com-)-.1 F(pleted, so portions of the w)144 444 Q +(skip\255completed\255text \(Off\))108 456 Q F0 .095(If set to)144 468 R +F1(On)2.595 E F0 2.595(,t)C .095(his alters the def)-2.595 F .095 +(ault completion beha)-.1 F .094 +(vior when inserting a single match into the line.)-.2 F(It')144 480 Q +2.545(so)-.55 G .045(nly acti)-2.545 F .345 -.15(ve w)-.25 H .046 +(hen performing completion in the middle of a w).15 F 2.546(ord. If)-.1 +F .046(enabled, readline does not)2.546 F 1.394(insert characters from \ +the completion that match characters after point in the w)144 492 R +1.394(ord being com-)-.1 F(pleted, so portions of the w)144 504 Q (ord follo)-.1 E(wing the cursor are not duplicated.)-.25 E F1 -(vi\255cmd\255mode\255string \(\(cmd\)\))108 456 Q F0 .518(If the)144 -468 R F2(show\255mode\255in\255pr)3.018 E(ompt)-.45 E F0 -.25(va)3.018 G -.517(riable is enabled, this string is displayed immediately before the) +(vi\255cmd\255mode\255string \(\(cmd\)\))108 516 Q F0 .517(If the)144 +528 R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0 -.25(va)3.017 G +.518(riable is enabled, this string is displayed immediately before the) .25 F .475(last line of the primary prompt when vi editing mode is acti) -144 480 R .775 -.15(ve a)-.25 H .476(nd in command mode.).15 F .476 -(The v)5.476 F(alue)-.25 E .33(is e)144 492 R .33(xpanded lik)-.15 F +144 540 R .775 -.15(ve a)-.25 H .475(nd in command mode.).15 F .475 +(The v)5.475 F(alue)-.25 E .33(is e)144 552 R .33(xpanded lik)-.15 F 2.83(eak)-.1 G .63 -.15(ey b)-2.93 H .33 (inding, so the standard set of meta- and control pre\214x).15 F .33 -(es and backslash es-)-.15 F .244(cape sequences is a)144 504 R -.25(va) --.2 G 2.744(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.744 F -.245(gin and end sequences of non-printing)-.15 F(characters, which can\ +(es and backslash es-)-.15 F .245(cape sequences is a)144 564 R -.25(va) +-.2 G 2.745(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.745 F +.244(gin and end sequences of non-printing)-.15 F(characters, which can\ be used to embed a terminal control sequence into the mode string.)144 -516 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 528 Q F0 .518 -(If the)144 540 R F2(show\255mode\255in\255pr)3.018 E(ompt)-.45 E F0 --.25(va)3.018 G .517 +576 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 588 Q F0 .517 +(If the)144 600 R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0 +-.25(va)3.017 G .518 (riable is enabled, this string is displayed immediately before the).25 F .186(last line of the primary prompt when vi editing mode is acti)144 -552 R .486 -.15(ve a)-.25 H .186(nd in insertion mode.).15 F .187(The v) -5.186 F .187(alue is)-.25 F -.15(ex)144 564 S .924(panded lik).15 F -3.424(eak)-.1 G 1.224 -.15(ey b)-3.524 H .924 -(inding, so the standard set of meta- and control pre\214x).15 F .923 -(es and backslash es-)-.15 F .244(cape sequences is a)144 576 R -.25(va) --.2 G 2.744(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.744 F -.245(gin and end sequences of non-printing)-.15 F(characters, which can\ +612 R .486 -.15(ve a)-.25 H .186(nd in insertion mode.).15 F .186(The v) +5.186 F .186(alue is)-.25 F -.15(ex)144 624 S .923(panded lik).15 F +3.423(eak)-.1 G 1.223 -.15(ey b)-3.523 H .924 +(inding, so the standard set of meta- and control pre\214x).15 F .924 +(es and backslash es-)-.15 F .245(cape sequences is a)144 636 R -.25(va) +-.2 G 2.745(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.745 F +.244(gin and end sequences of non-printing)-.15 F(characters, which can\ be used to embed a terminal control sequence into the mode string.)144 -588 Q F1(visible\255stats \(Off\))108 600 Q F0 .847(If set to)144 612 R +648 Q F1(visible\255stats \(Off\))108 660 Q F0 .846(If set to)144 672 R F1(On)3.346 E F0 3.346(,ac)C .846(haracter denoting a \214le')-3.346 F 3.346(st)-.55 G .846(ype as reported by)-3.346 F F2(stat)3.346 E F0 .846 (\(2\) is appended to the \214lename)B -(when listing possible completions.)144 624 Q F1(Conditional Constructs) -87 640.8 Q F0 .05(Readline implements a f)108 652.8 R .05(acility simil\ +(when listing possible completions.)144 684 Q F1(Conditional Constructs) +87 700.8 Q F0 .05(Readline implements a f)108 712.8 R .05(acility simil\ ar in spirit to the conditional compilation features of the C preproces\ -sor)-.1 F .097(which allo)108 664.8 R .097(ws k)-.25 F .396 -.15(ey b) +sor)-.1 F .096(which allo)108 724.8 R .096(ws k)-.25 F .396 -.15(ey b) -.1 H .096(indings and v).15 F .096 -(ariable settings to be performed as the result of tests.)-.25 F .096 -(There are four parser)5.096 F(directi)108 676.8 Q -.15(ve)-.25 G 2.5 -(su).15 G(sed.)-2.5 E F1($if)108 693.6 Q F0(The)144 693.6 Q F1($if)2.962 -E F0 .462(construct allo)2.962 F .463(ws bindings to be made based on t\ -he editing mode, the terminal being used,)-.25 F .962 -(or the application using readline.)144 705.6 R .961(The te)5.962 F .961 -(xt of the test, after an)-.15 F 3.461(yc)-.15 G .961 -(omparison operator)-3.461 F 3.461(,e)-.4 G .961(xtends to)-3.611 F(the\ - end of the line; unless otherwise noted, no characters are required to\ - isolate it.)144 717.6 Q(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 -E(6)198.45 E 0 Cg EP +(ariable settings to be performed as the result of tests.)-.25 F .097 +(There are four parser)5.096 F(GNU Readline 8.2)72 768 Q(2022 August 12) +127.345 E(6)197.055 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(mode)144 84 Q F0(The)180 84 Q F1(mode=)3.711 E F0 1.211(form of the) -3.711 F F1($if)3.711 E F0(directi)3.711 E 1.511 -.15(ve i)-.25 H 3.711 -(su).15 G 1.211(sed to test whether readline is in emacs or vi)-3.711 F -3.065(mode. This)180 96 R .565(may be used in conjunction with the)3.065 -F F1 .565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to) -3.065 F .029(set bindings in the)180 108 R/F2 10/Times-Italic@0 SF +(Functions Manual)2.5 E(READLINE\(3\))119.855 E(directi)108 84 Q -.15 +(ve)-.25 G 2.5(su).15 G(sed.)-2.5 E/F1 10/Times-Bold@0 SF($if)108 100.8 +Q F0(The)144 100.8 Q F1($if)2.963 E F0 .463(construct allo)2.963 F .462 +(ws bindings to be made based on the editing mode, the terminal being u\ +sed,)-.25 F .961(or the application using readline.)144 112.8 R .961 +(The te)5.961 F .961(xt of the test, after an)-.15 F 3.462(yc)-.15 G +.962(omparison operator)-3.462 F 3.462(,e)-.4 G .962(xtends to)-3.612 F +(the end of the line; unless otherwise noted, no characters are require\ +d to isolate it.)144 124.8 Q F1(mode)144 141.6 Q F0(The)180 141.6 Q F1 +(mode=)3.712 E F0 1.212(form of the)3.712 F F1($if)3.711 E F0(directi) +3.711 E 1.511 -.15(ve i)-.25 H 3.711(su).15 G 1.211 +(sed to test whether readline is in emacs or vi)-3.711 F 3.065 +(mode. This)180 153.6 R .565(may be used in conjunction with the)3.065 F +F1 .565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to) +3.065 F .03(set bindings in the)180 165.6 R/F2 10/Times-Italic@0 SF (emacs-standar)2.529 E(d)-.37 E F0(and)2.529 E F2(emacs-ctlx)2.529 E F0 -.1(ke)2.529 G .029(ymaps only if readline is starting out)-.05 F -(in emacs mode.)180 120 Q F1(term)144 136.8 Q F0(The)180 136.8 Q F1 -(term=)3.197 E F0 .696 -(form may be used to include terminal-speci\214c k)3.197 F .996 -.15 -(ey b)-.1 H .696(indings, perhaps to bind).15 F .654(the k)180 148.8 R +(in emacs mode.)180 177.6 Q F1(term)144 194.4 Q F0(The)180 194.4 Q F1 +(term=)3.196 E F0 .696 +(form may be used to include terminal-speci\214c k)3.196 F .996 -.15 +(ey b)-.1 H .697(indings, perhaps to bind).15 F .654(the k)180 206.4 R .954 -.15(ey s)-.1 H .654(equences output by the terminal').15 F 3.154 (sf)-.55 G .654(unction k)-3.154 F -.15(ey)-.1 G 3.154(s. The).15 F -.1 -(wo)3.154 G .654(rd on the right side of).1 F(the)180 160.8 Q F1(=)3.004 -E F0 .504(is tested ag)3.004 F .503(ainst the full name of the terminal\ +(wo)3.154 G .654(rd on the right side of).1 F(the)180 218.4 Q F1(=)3.003 +E F0 .503(is tested ag)3.003 F .504(ainst the full name of the terminal\ and the portion of the terminal name)-.05 F(before the \214rst)180 -172.8 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.84 E F0 +230.4 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.84 E F0 (to match both)2.74 E F2(sun)2.84 E F0(and)2.74 E F2(sun\255cmd)2.84 E -F0 2.5(,f).77 G(or instance.)-2.5 E F1 -.1(ve)144 189.6 S(rsion).1 E F0 -(The)180 201.6 Q F1 -.1(ve)3.108 G(rsion).1 E F0 .608 -(test may be used to perform comparisons ag)3.108 F .609 -(ainst speci\214c readline v)-.05 F(ersions.)-.15 E(The)180 213.6 Q F1 --.1(ve)2.772 G(rsion).1 E F0 -.15(ex)2.772 G .272 -(pands to the current readline v).15 F 2.771(ersion. The)-.15 F .271 -(set of comparison operators in-)2.771 F(cludes)180 225.6 Q F1(=)3.063 E -F0 3.063(,\()C(and)-3.063 E F1(==)3.063 E F0(\),)A F1(!=)3.063 E F0(,)A -F1(<=)3.063 E F0(,)A F1(>=)3.063 E F0(,)A F1(<)3.063 E F0 3.063(,a)C(nd) --3.063 E F1(>)3.064 E F0 5.564(.T)C .564(he v)-5.564 F .564 +F0 2.5(,f).77 G(or instance.)-2.5 E F1 -.1(ve)144 247.2 S(rsion).1 E F0 +(The)180 259.2 Q F1 -.1(ve)3.109 G(rsion).1 E F0 .608 +(test may be used to perform comparisons ag)3.109 F .608 +(ainst speci\214c readline v)-.05 F(ersions.)-.15 E(The)180 271.2 Q F1 +-.1(ve)2.771 G(rsion).1 E F0 -.15(ex)2.771 G .271 +(pands to the current readline v).15 F 2.772(ersion. The)-.15 F .272 +(set of comparison operators in-)2.772 F(cludes)180 283.2 Q F1(=)3.064 E +F0 3.064(,\()C(and)-3.064 E F1(==)3.064 E F0(\),)A F1(!=)3.064 E F0(,)A +F1(<=)3.064 E F0(,)A F1(>=)3.064 E F0(,)A F1(<)3.064 E F0 3.064(,a)C(nd) +-3.064 E F1(>)3.064 E F0 5.563(.T)C .563(he v)-5.563 F .563 (ersion number supplied on the right side)-.15 F .318 -(of the operator consists of a major v)180 237.6 R .318(ersion number) +(of the operator consists of a major v)180 295.2 R .318(ersion number) -.15 F 2.818(,a)-.4 G 2.818(no)-2.818 G .318 -(ptional decimal point, and an op-)-2.818 F .1(tional minor v)180 249.6 -R .1(ersion \(e.g.,)-.15 F F1(7.1)2.6 E F0 .1(\). If the minor v)B .101 -(ersion is omitted, it is assumed to be)-.15 F F1(0)2.601 E F0 5.101(.T) -C(he)-5.101 E .06(operator may be separated from the string)180 261.6 R -F1 -.1(ve)2.56 G(rsion).1 E F0 .06(and from the v)2.56 F .06 -(ersion number ar)-.15 F(gument)-.18 E(by whitespace.)180 273.6 Q F1 -(application)144 290.4 Q F0(The)180 302.4 Q F1(application)3.003 E F0 -.503(construct is used to include application-speci\214c settings.)3.003 -F .503(Each program)5.503 F .114(using the readline library sets the)180 -314.4 R F2 .114(application name)2.614 F F0 2.614(,a)C .114 -(nd an initialization \214le can test for a)-2.614 F .5(particular v)180 -326.4 R 3(alue. This)-.25 F .501(could be used to bind k)3 F .801 -.15 -(ey s)-.1 H .501(equences to functions useful for a spe-).15 F .397 -(ci\214c program.)180 338.4 R -.15(Fo)5.397 G 2.896(ri).15 G .396 +(ptional decimal point, and an op-)-2.818 F .101(tional minor v)180 +307.2 R .101(ersion \(e.g.,)-.15 F F1(7.1)2.601 E F0 .101 +(\). If the minor v)B .1(ersion is omitted, it is assumed to be)-.15 F +F1(0)2.6 E F0 5.1(.T)C(he)-5.1 E .06 +(operator may be separated from the string)180 319.2 R F1 -.1(ve)2.56 G +(rsion).1 E F0 .06(and from the v)2.56 F .06(ersion number ar)-.15 F +(gument)-.18 E(by whitespace.)180 331.2 Q F1(application)144 348 Q F0 +(The)180 360 Q F1(application)3.003 E F0 .503 +(construct is used to include application-speci\214c settings.)3.003 F +.503(Each program)5.503 F .114(using the readline library sets the)180 +372 R F2 .114(application name)2.614 F F0 2.614(,a)C .114 +(nd an initialization \214le can test for a)-2.614 F .501(particular v) +180 384 R 3.001(alue. This)-.25 F .501(could be used to bind k)3.001 F +.801 -.15(ey s)-.1 H .5(equences to functions useful for a spe-).15 F +.396(ci\214c program.)180 396 R -.15(Fo)5.396 G 2.896(ri).15 G .396 (nstance, the follo)-2.896 F .396(wing command adds a k)-.25 F .696 -.15 -(ey s)-.1 H .396(equence that quotes the).15 F(current or pre)180 350.4 -Q(vious w)-.25 E(ord in)-.1 E F1(bash)2.5 E F0(:)A F1($if)180 374.4 Q F0 -(Bash)2.5 E 2.5(#Q)180 386.4 S(uote the current or pre)-2.5 E(vious w) --.25 E(ord)-.1 E("\\C-xq": "\\eb\\"\\ef\\"")180 398.4 Q F1($endif)180 -410.4 Q F2(variable)144 427.2 Q F0(The)180 439.2 Q F2(variable)3.776 E -F0 1.276(construct pro)3.776 F 1.276 -(vides simple equality tests for readline v)-.15 F 1.277(ariables and v) --.25 F(alues.)-.25 E .08(The permitted comparison operators are)180 -451.2 R F2(=)2.579 E F0(,)A F2(==)2.579 E F0 2.579(,a)C(nd)-2.579 E F2 -(!=)2.579 E F0 5.079(.T)C .079(he v)-5.079 F .079 -(ariable name must be sepa-)-.25 F .98(rated from the comparison operat\ -or by whitespace; the operator may be separated from)180 463.2 R .13 -(the v)180 475.2 R .13(alue on the right hand side by whitespace.)-.25 F -.129(Both string and boolean v)5.129 F .129(ariables may be)-.25 F -(tested. Boolean v)180 487.2 Q(ariables must be tested ag)-.25 E +(ey s)-.1 H .397(equence that quotes the).15 F(current or pre)180 408 Q +(vious w)-.25 E(ord in)-.1 E F1(bash)2.5 E F0(:)A F1($if)180 432 Q F0 +(Bash)2.5 E 2.5(#Q)180 444 S(uote the current or pre)-2.5 E(vious w)-.25 +E(ord)-.1 E("\\C-xq": "\\eb\\"\\ef\\"")180 456 Q F1($endif)180 468 Q F2 +(variable)144 484.8 Q F0(The)180 496.8 Q F2(variable)3.777 E F0 1.277 +(construct pro)3.777 F 1.276(vides simple equality tests for readline v) +-.15 F 1.276(ariables and v)-.25 F(alues.)-.25 E .079 +(The permitted comparison operators are)180 508.8 R F2(=)2.579 E F0(,)A +F2(==)2.579 E F0 2.579(,a)C(nd)-2.579 E F2(!=)2.579 E F0 5.079(.T)C .079 +(he v)-5.079 F .08(ariable name must be sepa-)-.25 F .98(rated from the\ + comparison operator by whitespace; the operator may be separated from) +180 520.8 R .129(the v)180 532.8 R .129 +(alue on the right hand side by whitespace.)-.25 F .13 +(Both string and boolean v)5.129 F .13(ariables may be)-.25 F +(tested. Boolean v)180 544.8 Q(ariables must be tested ag)-.25 E (ainst the v)-.05 E(alues)-.25 E F2(on)2.5 E F0(and)2.5 E F2(of)2.5 E(f) --.18 E F0(.)A F1($endif)108 504 Q F0(This command, as seen in the pre) -144 504 Q(vious e)-.25 E(xample, terminates an)-.15 E F1($if)2.5 E F0 -(command.)2.5 E F1($else)108 520.8 Q F0(Commands in this branch of the) -144 520.8 Q F1($if)2.5 E F0(directi)2.5 E .3 -.15(ve a)-.25 H(re e).15 E +-.18 E F0(.)A F1($endif)108 561.6 Q F0(This command, as seen in the pre) +144 561.6 Q(vious e)-.25 E(xample, terminates an)-.15 E F1($if)2.5 E F0 +(command.)2.5 E F1($else)108 578.4 Q F0(Commands in this branch of the) +144 578.4 Q F1($if)2.5 E F0(directi)2.5 E .3 -.15(ve a)-.25 H(re e).15 E -.15(xe)-.15 G(cuted if the test f).15 E(ails.)-.1 E F1($include)108 -537.6 Q F0 .356(This directi)144 549.6 R .656 -.15(ve t)-.25 H(ak).15 E -.356(es a single \214lename as an ar)-.1 F .357 +595.2 Q F0 .357(This directi)144 607.2 R .657 -.15(ve t)-.25 H(ak).15 E +.357(es a single \214lename as an ar)-.1 F .356 (gument and reads commands and bindings from that)-.18 F 2.5(\214le. F) -144 561.6 R(or e)-.15 E(xample, the follo)-.15 E(wing directi)-.25 E .3 +144 619.2 R(or e)-.15 E(xample, the follo)-.15 E(wing directi)-.25 E .3 -.15(ve w)-.25 H(ould read).05 E F2(/etc/inputr)2.5 E(c)-.37 E F0(:)A F1 -($include)144 585.6 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95 -/Times-Bold@0 SF(SEARCHING)72 602.4 Q F0 1.004(Readline pro)108 614.4 R +($include)144 643.2 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95 +/Times-Bold@0 SF(SEARCHING)72 660 Q F0 1.003(Readline pro)108 672 R 1.003(vides commands for searching through the command history for line\ -s containing a speci\214ed)-.15 F 2.5(string. There)108 626.4 R(are tw) -2.5 E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.51 E(emental)-.37 E F0 -(and)3.01 E F2(non-incr)2.86 E(emental)-.37 E F0(.).51 E .697 -(Incremental searches be)108 643.2 R .697 +s containing a speci\214ed)-.15 F 2.5(string. There)108 684 R(are tw)2.5 +E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.51 E(emental)-.37 E F0(and) +3.01 E F2(non-incr)2.86 E(emental)-.37 E F0(.).51 E .698 +(Incremental searches be)108 700.8 R .698 (gin before the user has \214nished typing the search string.)-.15 F -.698(As each character of the)5.698 F .113 -(search string is typed, readline displays the ne)108 655.2 R .112 +.697(As each character of the)5.697 F .112 +(search string is typed, readline displays the ne)108 712.8 R .112 (xt entry from the history matching the string typed so f)-.15 F(ar)-.1 -E 5.112(.A)-.55 G(n)-5.112 E .544 -(incremental search requires only as man)108 667.2 R 3.044(yc)-.15 G -.544(haracters as needed to \214nd the desired history entry)-3.044 F -5.545(.T)-.65 G 3.045(os)-6.345 G(earch)-3.045 E(backw)108 679.2 Q .181 -(ard in the history for a particular string, type)-.1 F F1(C\255r)2.681 -E F0 5.181(.T)C(yping)-5.981 E F1(C\255s)2.68 E F0 .18(searches forw) -2.68 F .18(ard through the history)-.1 F(.)-.65 E .354 -(The characters present in the v)108 691.2 R .354(alue of the)-.25 F F1 -(isear)2.854 E(ch-terminators)-.18 E F0 -.25(va)2.854 G .354 -(riable are used to terminate an incremen-).25 F .6(tal search.)108 -703.2 R .6(If that v)5.6 F .6(ariable has not been assigned a v)-.25 F -.6(alue the)-.25 F F2(Escape)3.1 E F0(and)3.1 E F1(C\255J)3.1 E F0 .6 -(characters will terminate an)3.1 F .122(incremental search.)108 715.2 R -F1(C\255G)5.122 E F0 .122 -(will abort an incremental search and restore the original line.)2.622 F -.123(When the search is)5.123 F(terminated, the history entry containin\ -g the search string becomes the current line.)108 727.2 Q -(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(7)198.45 E 0 Cg EP +E 5.113(.A)-.55 G(n)-5.113 E .545 +(incremental search requires only as man)108 724.8 R 3.045(yc)-.15 G +.544(haracters as needed to \214nd the desired history entry)-3.045 F +5.544(.T)-.65 G 3.044(os)-6.344 G(earch)-3.044 E(GNU Readline 8.2)72 768 +Q(2022 August 12)127.345 E(7)197.055 E 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.407 -.8(To \214)108 84 -T .806(nd other matching entries in the history list, type).8 F/F1 10 -/Times-Bold@0 SF(C\255s)3.306 E F0(or)3.306 E F1(C\255r)3.306 E F0 .806 -(as appropriate.)3.306 F .806(This will search back-)5.806 F -.1(wa)108 -96 S .535(rd or forw).1 F .535(ard in the history for the ne)-.1 F .536 -(xt line matching the search string typed so f)-.15 F(ar)-.1 E 5.536(.A) --.55 G .836 -.15(ny o)-5.536 H .536(ther k).15 F .836 -.15(ey s)-.1 H -(e-).15 E .385 +(Functions Manual)2.5 E(READLINE\(3\))119.855 E(backw)108 84 Q .18 +(ard in the history for a particular string, type)-.1 F/F1 10 +/Times-Bold@0 SF(C\255r)2.681 E F0 5.181(.T)C(yping)-5.981 E F1(C\255s) +2.681 E F0 .181(searches forw)2.681 F .181(ard through the history)-.1 F +(.)-.65 E .354(The characters present in the v)108 96 R .354 +(alue of the)-.25 F F1(isear)2.854 E(ch-terminators)-.18 E F0 -.25(va) +2.854 G .354(riable are used to terminate an incremen-).25 F .6 +(tal search.)108 108 R .6(If that v)5.6 F .6 +(ariable has not been assigned a v)-.25 F .6(alue the)-.25 F/F2 10 +/Times-Italic@0 SF(Escape)3.1 E F0(and)3.1 E F1(C\255J)3.1 E F0 .6 +(characters will terminate an)3.1 F .123(incremental search.)108 120 R +F1(C\255G)5.123 E F0 .123 +(will abort an incremental search and restore the original line.)2.623 F +.122(When the search is)5.122 F(terminated, the history entry containin\ +g the search string becomes the current line.)108 132 Q 2.406 -.8 +(To \214)108 148.8 T .806 +(nd other matching entries in the history list, type).8 F F1(C\255s) +3.306 E F0(or)3.306 E F1(C\255r)3.306 E F0 .806(as appropriate.)3.306 F +.807(This will search back-)5.806 F -.1(wa)108 160.8 S .536(rd or forw) +.1 F .536(ard in the history for the ne)-.1 F .535 +(xt line matching the search string typed so f)-.15 F(ar)-.1 E 5.535(.A) +-.55 G .835 -.15(ny o)-5.535 H .535(ther k).15 F .835 -.15(ey s)-.1 H +(e-).15 E .384 (quence bound to a readline command will terminate the search and e)108 -108 R -.15(xe)-.15 G .384(cute that command.).15 F -.15(Fo)5.384 G 2.884 -(ri).15 G .384(nstance, a)-2.884 F(ne)108 120 Q .337 +172.8 R -.15(xe)-.15 G .385(cute that command.).15 F -.15(Fo)5.385 G +2.885(ri).15 G .385(nstance, a)-2.885 F(ne)108 184.8 Q .338 (wline will terminate the search and accept the line, thereby e)-.25 F --.15(xe)-.15 G .338(cuting the command from the history list.).15 F -2.998(Am)108 132 S -.15(ove)-2.998 G .497 +-.15(xe)-.15 G .337(cuting the command from the history list.).15 F +2.997(Am)108 196.8 S -.15(ove)-2.997 G .497 (ment command will terminate the search, mak).15 F 2.997(et)-.1 G .497 -(he last line found the current line, and be)-2.997 F .497(gin edit-) --.15 F(ing.)108 144 Q .567(Non-incremental searches read the entire sea\ -rch string before starting to search for matching history lines.)108 -160.8 R(The search string may be typed by the user or be part of the co\ -ntents of the current line.)108 172.8 Q/F2 10.95/Times-Bold@0 SF -(EDITING COMMANDS)72 189.6 Q F0 1.392(The follo)108 201.6 R 1.391 +(he last line found the current line, and be)-2.997 F .498(gin edit-) +-.15 F(ing.)108 208.8 Q .567(Non-incremental searches read the entire s\ +earch string before starting to search for matching history lines.)108 +225.6 R(The search string may be typed by the user or be part of the co\ +ntents of the current line.)108 237.6 Q/F3 10.95/Times-Bold@0 SF +(EDITING COMMANDS)72 254.4 Q F0 1.391(The follo)108 266.4 R 1.391 (wing is a list of the names of the commands and the def)-.25 F 1.391 (ault k)-.1 F 1.691 -.15(ey s)-.1 H 1.391(equences to which the).15 F -3.891(ya)-.15 G(re)-3.891 E 2.5(bound. Command)108 213.6 R +3.892(ya)-.15 G(re)-3.892 E 2.5(bound. Command)108 278.4 R (names without an accompan)2.5 E(ying k)-.15 E .3 -.15(ey s)-.1 H -(equence are unbound by def).15 E(ault.)-.1 E .054(In the follo)108 -230.4 R .054(wing descriptions,)-.25 F/F3 10/Times-Italic@0 SF(point) -2.554 E F0 .055(refers to the current cursor position, and)2.554 F F3 -(mark)2.555 E F0 .055(refers to a cursor position)2.555 F(sa)108 242.4 Q --.15(ve)-.2 G 2.5(db).15 G 2.5(yt)-2.5 G(he)-2.5 E F1(set\255mark)2.5 E -F0 2.5(command. The)2.5 F(te)2.5 E -(xt between the point and mark is referred to as the)-.15 E F3 -.37(re) -2.5 G(gion)-.03 E F0(.)A F1(Commands f)87 259.2 Q(or Mo)-.25 E(ving)-.1 -E(beginning\255of\255line \(C\255a\))108 271.2 Q F0(Mo)144 283.2 Q .3 --.15(ve t)-.15 H 2.5(ot).15 G(he start of the current line.)-2.5 E F1 -(end\255of\255line \(C\255e\))108 295.2 Q F0(Mo)144 307.2 Q .3 -.15 -(ve t)-.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108 -319.2 S(rward\255char \(C\255f\)).25 E F0(Mo)144 331.2 Q .3 -.15(ve f) --.15 H(orw).15 E(ard a character)-.1 E(.)-.55 E F1 -(backward\255char \(C\255b\))108 343.2 Q F0(Mo)144 355.2 Q .3 -.15(ve b) --.15 H(ack a character).15 E(.)-.55 E F1 -.25(fo)108 367.2 S(rward\255w) -.25 E(ord \(M\255f\))-.1 E F0(Mo)144 379.2 Q .823 -.15(ve f)-.15 H(orw) -.15 E .523(ard to the end of the ne)-.1 F .523(xt w)-.15 F 3.023(ord. W) --.1 F .522(ords are composed of alphanumeric characters \(let-)-.8 F -(ters and digits\).)144 391.2 Q F1(backward\255w)108 403.2 Q -(ord \(M\255b\))-.1 E F0(Mo)144 415.2 Q 1.71 -.15(ve b)-.15 H 1.41 +(equence are unbound by def).15 E(ault.)-.1 E .055(In the follo)108 +295.2 R .055(wing descriptions,)-.25 F F2(point)2.555 E F0 .055 +(refers to the current cursor position, and)2.555 F F2(mark)2.555 E F0 +.054(refers to a cursor position)2.554 F(sa)108 307.2 Q -.15(ve)-.2 G +2.5(db).15 G 2.5(yt)-2.5 G(he)-2.5 E F1(set\255mark)2.5 E F0 2.5 +(command. The)2.5 F(te)2.5 E +(xt between the point and mark is referred to as the)-.15 E F2 -.37(re) +2.5 G(gion)-.03 E F0(.)A F1(Commands f)87 324 Q(or Mo)-.25 E(ving)-.1 E +(beginning\255of\255line \(C\255a\))108 336 Q F0(Mo)144 348 Q .3 -.15 +(ve t)-.15 H 2.5(ot).15 G(he start of the current line.)-2.5 E F1 +(end\255of\255line \(C\255e\))108 360 Q F0(Mo)144 372 Q .3 -.15(ve t) +-.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108 384 S +(rward\255char \(C\255f\)).25 E F0(Mo)144 396 Q .3 -.15(ve f)-.15 H(orw) +.15 E(ard a character)-.1 E(.)-.55 E F1(backward\255char \(C\255b\))108 +408 Q F0(Mo)144 420 Q .3 -.15(ve b)-.15 H(ack a character).15 E(.)-.55 E +F1 -.25(fo)108 432 S(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 444 +Q .822 -.15(ve f)-.15 H(orw).15 E .522(ard to the end of the ne)-.1 F +.523(xt w)-.15 F 3.023(ord. W)-.1 F .523 +(ords are composed of alphanumeric characters \(let-)-.8 F +(ters and digits\).)144 456 Q F1(backward\255w)108 468 Q(ord \(M\255b\)) +-.1 E F0(Mo)144 480 Q 1.71 -.15(ve b)-.15 H 1.41 (ack to the start of the current or pre).15 F 1.41(vious w)-.25 F 3.91 (ord. W)-.1 F 1.41(ords are composed of alphanumeric)-.8 F -(characters \(letters and digits\).)144 427.2 Q F1(pr)108 439.2 Q -.15 -(ev)-.18 G(ious\255scr).15 E(een\255line)-.18 E F0 .891(Attempt to mo) -144 451.2 R 1.191 -.15(ve p)-.15 H .891(oint to the same ph).15 F .891 -(ysical screen column on the pre)-.05 F .89(vious ph)-.25 F .89 -(ysical screen line.)-.05 F .87(This will not ha)144 463.2 R 1.17 -.15 +(characters \(letters and digits\).)144 492 Q F1(pr)108 504 Q -.15(ev) +-.18 G(ious\255scr).15 E(een\255line)-.18 E F0 .89(Attempt to mo)144 516 +R 1.19 -.15(ve p)-.15 H .89(oint to the same ph).15 F .891 +(ysical screen column on the pre)-.05 F .891(vious ph)-.25 F .891 +(ysical screen line.)-.05 F .87(This will not ha)144 528 R 1.17 -.15 (ve t)-.2 H .87(he desired ef).15 F .87 (fect if the current Readline line does not tak)-.25 F 3.37(eu)-.1 G -3.37(pm)-3.37 G .87(ore than one)-3.37 F(ph)144 475.2 Q(ysical line or \ -if point is not greater than the length of the prompt plus the screen w\ -idth.)-.05 E F1(next\255scr)108 487.2 Q(een\255line)-.18 E F0 .638 -(Attempt to mo)144 499.2 R .938 -.15(ve p)-.15 H .638 -(oint to the same ph).15 F .637(ysical screen column on the ne)-.05 F -.637(xt ph)-.15 F .637(ysical screen line. This)-.05 F .008(will not ha) -144 511.2 R .309 -.15(ve t)-.2 H .009(he desired ef).15 F .009 +3.37(pm)-3.37 G .87(ore than one)-3.37 F(ph)144 540 Q(ysical line or if\ + point is not greater than the length of the prompt plus the screen wid\ +th.)-.05 E F1(next\255scr)108 552 Q(een\255line)-.18 E F0 .637 +(Attempt to mo)144 564 R .937 -.15(ve p)-.15 H .637(oint to the same ph) +.15 F .638(ysical screen column on the ne)-.05 F .638(xt ph)-.15 F .638 +(ysical screen line. This)-.05 F .009(will not ha)144 576 R .309 -.15 +(ve t)-.2 H .009(he desired ef).15 F .009 (fect if the current Readline line does not tak)-.25 F 2.509(eu)-.1 G -2.509(pm)-2.509 G .009(ore than one ph)-2.509 F(ysical)-.05 E .772(line\ +2.509(pm)-2.509 G .008(ore than one ph)-2.509 F(ysical)-.05 E .772(line\ or if the length of the current Readline line is not greater than the \ -length of the prompt plus)144 523.2 R(the screen width.)144 535.2 Q F1 -(clear\255display \(M\255C\255l\))108 547.2 Q F0 1.498 -(Clear the screen and, if possible, the terminal')144 559.2 R 3.999(ss) --.55 G 1.499(crollback b)-3.999 F(uf)-.2 E(fer)-.25 E 3.999(,t)-.4 G -1.499(hen redra)-3.999 F 3.999(wt)-.15 G 1.499(he current line,)-3.999 F -(lea)144 571.2 Q(ving the current line at the top of the screen.)-.2 E -F1(clear\255scr)108 583.2 Q(een \(C\255l\))-.18 E F0 1.36 -(Clear the screen, then redra)144 595.2 R 3.86(wt)-.15 G 1.36 +length of the prompt plus)144 588 R(the screen width.)144 600 Q F1 +(clear\255display \(M\255C\255l\))108 612 Q F0 1.499 +(Clear the screen and, if possible, the terminal')144 624 R 3.999(ss) +-.55 G 1.498(crollback b)-3.999 F(uf)-.2 E(fer)-.25 E 3.998(,t)-.4 G +1.498(hen redra)-3.998 F 3.998(wt)-.15 G 1.498(he current line,)-3.998 F +(lea)144 636 Q(ving the current line at the top of the screen.)-.2 E F1 +(clear\255scr)108 648 Q(een \(C\255l\))-.18 E F0 1.36 +(Clear the screen, then redra)144 660 R 3.86(wt)-.15 G 1.36 (he current line, lea)-3.86 F 1.36 -(ving the current line at the top of the screen.)-.2 F -.4(Wi)144 607.2 -S(th an ar).4 E +(ving the current line at the top of the screen.)-.2 F -.4(Wi)144 672 S +(th an ar).4 E (gument, refresh the current line without clearing the screen.)-.18 E F1 --.18(re)108 619.2 S(draw\255curr).18 E(ent\255line)-.18 E F0 -(Refresh the current line.)144 631.2 Q F1(Commands f)87 648 Q -(or Manipulating the History)-.25 E(accept\255line \(Newline, Retur)108 -660 Q(n\))-.15 E F0 .364(Accept the line re)144 672 R -.05(ga)-.15 G -.364(rdless of where the cursor is.).05 F .364 -(If this line is non-empty)5.364 F 2.864(,i)-.65 G 2.864(tm)-2.864 G -.365(ay be added to the)-2.864 F .741 -(history list for future recall with)144 684 R F1(add_history\(\))3.241 -E F0 5.741(.I)C 3.241(ft)-5.741 G .74 -(he line is a modi\214ed history line, the history)-3.241 F -(line is restored to its original state.)144 696 Q(GNU Readline 8.2)72 -768 Q(2022 March 11)128.74 E(8)198.45 E 0 Cg EP +-.18(re)108 684 S(draw\255curr).18 E(ent\255line)-.18 E F0 +(Refresh the current line.)144 696 Q(GNU Readline 8.2)72 768 Q +(2022 August 12)127.345 E(8)197.055 E 0 Cg EP %%Page: 9 9 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R (Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(pr)108 84 Q -.15(ev)-.18 G(ious\255history \(C\255p\)).15 E F0 -(Fetch the pre)144 96 Q(vious command from the history list, mo)-.25 E -(ving back in the list.)-.15 E F1(next\255history \(C\255n\))108 108 Q -F0(Fetch the ne)144 120 Q(xt command from the history list, mo)-.15 E -(ving forw)-.15 E(ard in the list.)-.1 E F1 -(beginning\255of\255history \(M\255<\))108 132 Q F0(Mo)144 144 Q .3 -.15 -(ve t)-.15 H 2.5(ot).15 G(he \214rst line in the history)-2.5 E(.)-.65 E -F1(end\255of\255history \(M\255>\))108 156 Q F0(Mo)144 168 Q .3 -.15 -(ve t)-.15 H 2.5(ot).15 G(he end of the input history)-2.5 E 2.5(,i)-.65 -G(.e., the line currently being entered.)-2.5 E F1 -(operate\255and\255get\255next \(C\255o\))108 180 Q F0 .733(Accept the \ -current line for return to the calling application as if a ne)144 192 R -.733(wline had been entered, and)-.25 F .368(fetch the ne)144 204 R .367 +(Commands f)87 84 Q(or Manipulating the History)-.25 E +(accept\255line \(Newline, Retur)108 96 Q(n\))-.15 E F0 .365 +(Accept the line re)144 108 R -.05(ga)-.15 G .364 +(rdless of where the cursor is.).05 F .364(If this line is non-empty) +5.364 F 2.864(,i)-.65 G 2.864(tm)-2.864 G .364(ay be added to the)-2.864 +F .74(history list for future recall with)144 120 R F1(add_history\(\)) +3.24 E F0 5.741(.I)C 3.241(ft)-5.741 G .741 +(he line is a modi\214ed history line, the history)-3.241 F +(line is restored to its original state.)144 132 Q F1(pr)108 144 Q -.15 +(ev)-.18 G(ious\255history \(C\255p\)).15 E F0(Fetch the pre)144 156 Q +(vious command from the history list, mo)-.25 E(ving back in the list.) +-.15 E F1(next\255history \(C\255n\))108 168 Q F0(Fetch the ne)144 180 Q +(xt command from the history list, mo)-.15 E(ving forw)-.15 E +(ard in the list.)-.1 E F1(beginning\255of\255history \(M\255<\))108 192 +Q F0(Mo)144 204 Q .3 -.15(ve t)-.15 H 2.5(ot).15 G +(he \214rst line in the history)-2.5 E(.)-.65 E F1 +(end\255of\255history \(M\255>\))108 216 Q F0(Mo)144 228 Q .3 -.15(ve t) +-.15 H 2.5(ot).15 G(he end of the input history)-2.5 E 2.5(,i)-.65 G +(.e., the line currently being entered.)-2.5 E F1 +(operate\255and\255get\255next \(C\255o\))108 240 Q F0 .733(Accept the \ +current line for return to the calling application as if a ne)144 252 R +.733(wline had been entered, and)-.25 F .367(fetch the ne)144 264 R .367 (xt line relati)-.15 F .667 -.15(ve t)-.25 H 2.867(ot).15 G .367 (he current line from the history for editing.)-2.867 F 2.867(An)5.367 G -.367(umeric ar)-2.867 F .367(gument, if)-.18 F(supplied, speci\214es th\ -e history entry to use instead of the current line.)144 216 Q F1 -(fetch\255history)108 228 Q F0 -.4(Wi)144 240 S .256(th a numeric ar).4 -F .256(gument, fetch that entry from the history list and mak)-.18 F -2.757(ei)-.1 G 2.757(tt)-2.757 G .257(he current line.)-2.757 F -.4(Wi) -5.257 G(th-).4 E(out an ar)144 252 Q(gument, mo)-.18 E .3 -.15(ve b)-.15 +.367(umeric ar)-2.867 F .368(gument, if)-.18 F(supplied, speci\214es th\ +e history entry to use instead of the current line.)144 276 Q F1 +(fetch\255history)108 288 Q F0 -.4(Wi)144 300 S .257(th a numeric ar).4 +F .257(gument, fetch that entry from the history list and mak)-.18 F +2.756(ei)-.1 G 2.756(tt)-2.756 G .256(he current line.)-2.756 F -.4(Wi) +5.256 G(th-).4 E(out an ar)144 312 Q(gument, mo)-.18 E .3 -.15(ve b)-.15 H(ack to the \214rst entry in the history list.).15 E F1 -2.29 -.18 -(re v)108 264 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0 -1.471(Search backw)144 276 R 1.471 -(ard starting at the current line and mo)-.1 F 1.47 +(re v)108 324 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0 +1.47(Search backw)144 336 R 1.471 +(ard starting at the current line and mo)-.1 F 1.471 (ving `up' through the history as necessary)-.15 F(.)-.65 E -(This is an incremental search.)144 288 Q F1 -.25(fo)108 300 S -(rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.131 -(Search forw)144 312 R 1.131(ard starting at the current line and mo)-.1 -F 1.132(ving `do)-.15 F 1.132(wn' through the history as necessary)-.25 -F(.)-.65 E(This is an incremental search.)144 324 Q F1(non\255incr)108 -336 Q(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H(rse\255sear).15 E -(ch\255history \(M\255p\))-.18 E F0 .165(Search backw)144 348 R .164(ar\ +(This is an incremental search.)144 348 Q F1 -.25(fo)108 360 S +(rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.132 +(Search forw)144 372 R 1.132(ard starting at the current line and mo)-.1 +F 1.131(ving `do)-.15 F 1.131(wn' through the history as necessary)-.25 +F(.)-.65 E(This is an incremental search.)144 384 Q F1(non\255incr)108 +396 Q(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H(rse\255sear).15 E +(ch\255history \(M\255p\))-.18 E F0 .164(Search backw)144 408 R .164(ar\ d through the history starting at the current line using a non-incremen\ -tal search for)-.1 F 2.5(as)144 360 S(tring supplied by the user)-2.5 E -(.)-.55 E F1(non\255incr)108 372 Q(emental\255f)-.18 E(orward\255sear) --.25 E(ch\255history \(M\255n\))-.18 E F0 1.353(Search forw)144 384 R +tal search for)-.1 F 2.5(as)144 420 S(tring supplied by the user)-2.5 E +(.)-.55 E F1(non\255incr)108 432 Q(emental\255f)-.18 E(orward\255sear) +-.25 E(ch\255history \(M\255n\))-.18 E F0 1.354(Search forw)144 444 R 1.354(ard through the history using a non-incremental search for a stri\ -ng supplied by the)-.1 F(user)144 396 Q(.)-.55 E F1(history\255sear)108 -408 Q(ch\255backward)-.18 E F0 .951(Search backw)144 420 R .951(ard thr\ -ough the history for the string of characters between the start of the \ -current)-.1 F .12(line and the current cursor position \(the)144 432 R -/F2 10/Times-Italic@0 SF(point)2.62 E F0 2.62(\). The)B .12 +ng supplied by the)-.1 F(user)144 456 Q(.)-.55 E F1(history\255sear)108 +468 Q(ch\255backward)-.18 E F0 .95(Search backw)144 480 R .951(ard thro\ +ugh the history for the string of characters between the start of the c\ +urrent)-.1 F .12(line and the current cursor position \(the)144 492 R/F2 +10/Times-Italic@0 SF(point)2.62 E F0 2.62(\). The)B .12 (search string must match at the be)2.62 F .12(ginning of a)-.15 F -(history line.)144 444 Q(This is a non-incremental search.)5 E F1 -(history\255sear)108 456 Q(ch\255f)-.18 E(orward)-.25 E F0 .249 -(Search forw)144 468 R .249(ard through the history for the string of c\ -haracters between the start of the current line)-.1 F .035 -(and the point.)144 480 R .035(The search string must match at the be) -5.035 F .036(ginning of a history line.)-.15 F .036 -(This is a non-incre-)5.036 F(mental search.)144 492 Q F1 -(history\255substring\255sear)108 504 Q(ch\255backward)-.18 E F0 .951 -(Search backw)144 516 R .951(ard through the history for the string of \ +(history line.)144 504 Q(This is a non-incremental search.)5 E F1 +(history\255sear)108 516 Q(ch\255f)-.18 E(orward)-.25 E F0 .248 +(Search forw)144 528 R .249(ard through the history for the string of c\ +haracters between the start of the current line)-.1 F .036 +(and the point.)144 540 R .036(The search string must match at the be) +5.036 F .035(ginning of a history line.)-.15 F .035 +(This is a non-incre-)5.035 F(mental search.)144 552 Q F1 +(history\255substring\255sear)108 564 Q(ch\255backward)-.18 E F0 .95 +(Search backw)144 576 R .951(ard through the history for the string of \ characters between the start of the current)-.1 F .007 -(line and the current cursor position \(the)144 528 R F2(point)2.507 E -F0 2.507(\). The)B .007(search string may match an)2.507 F .007 -(ywhere in a history)-.15 F 2.5(line. This)144 540 R +(line and the current cursor position \(the)144 588 R F2(point)2.507 E +F0 2.507(\). The)B .007(search string may match an)2.507 F .006 +(ywhere in a history)-.15 F 2.5(line. This)144 600 R (is a non-incremental search.)2.5 E F1(history\255substring\255sear)108 -552 Q(ch\255f)-.18 E(orward)-.25 E F0 .249(Search forw)144 564 R .249(a\ +612 Q(ch\255f)-.18 E(orward)-.25 E F0 .248(Search forw)144 624 R .249(a\ rd through the history for the string of characters between the start o\ -f the current line)-.1 F .318(and the point.)144 576 R .319 -(The search string may match an)5.318 F .319(ywhere in a history line.) --.15 F .319(This is a non-incremental)5.319 F(search.)144 588 Q F1 -(yank\255nth\255ar)108 600 Q 2.5(g\()-.1 G<4dad43ad7929>-2.5 E F0 .622 -(Insert the \214rst ar)144 612 R .622(gument to the pre)-.18 F .622 +f the current line)-.1 F .319(and the point.)144 636 R .319 +(The search string may match an)5.319 F .319(ywhere in a history line.) +-.15 F .318(This is a non-incremental)5.318 F(search.)144 648 Q F1 +(yank\255nth\255ar)108 660 Q 2.5(g\()-.1 G<4dad43ad7929>-2.5 E F0 .622 +(Insert the \214rst ar)144 672 R .622(gument to the pre)-.18 F .622 (vious command \(usually the second w)-.25 F .622(ord on the pre)-.1 F -.622(vious line\))-.25 F .772(at point.)144 624 R -.4(Wi)5.773 G .773 +.622(vious line\))-.25 F .773(at point.)144 684 R -.4(Wi)5.773 G .773 (th an ar).4 F(gument)-.18 E F2(n)3.633 E F0 3.273(,i).24 G .773 (nsert the)-3.273 F F2(n)3.273 E F0 .773(th w)B .773(ord from the pre) -.1 F .773(vious command \(the w)-.25 F .773(ords in the)-.1 F(pre)144 -636 Q .292(vious command be)-.25 F .292(gin with w)-.15 F .291(ord 0\).) +696 Q .291(vious command be)-.25 F .291(gin with w)-.15 F .291(ord 0\).) -.1 F 2.791(An)5.291 G -2.25 -.15(eg a)-2.791 H(ti).15 E .591 -.15(ve a) -.25 H -.18(rg).15 G .291(ument inserts the).18 F F2(n)2.791 E F0 .291 -(th w)B .291(ord from the end of)-.1 F .281(the pre)144 648 R .281 -(vious command.)-.25 F .281(Once the ar)5.281 F(gument)-.18 E F2(n)2.781 -E F0 .281(is computed, the ar)2.781 F .281(gument is e)-.18 F .282 -(xtracted as if the "!)-.15 F F2(n)A F0(")A(history e)144 660 Q -(xpansion had been speci\214ed.)-.15 E F1(yank\255last\255ar)108 672 Q -2.5(g\()-.1 G -1.667(M\255. ,)-2.5 F -1.667(M\255_ \))2.5 F F0 1.308 -(Insert the last ar)144 684 R 1.308(gument to the pre)-.18 F 1.307 -(vious command \(the last w)-.25 F 1.307(ord of the pre)-.1 F 1.307 -(vious history entry\).)-.25 F -.4(Wi)144 696 S .203(th a numeric ar).4 -F .203(gument, beha)-.18 F .504 -.15(ve ex)-.2 H .204(actly lik).15 F(e) --.1 E F1(yank\255nth\255ar)2.704 E(g)-.1 E F0 5.204(.S)C(uccessi)-5.204 -E .504 -.15(ve c)-.25 H .204(alls to).15 F F1(yank\255last\255ar)2.704 E -(g)-.1 E F0(mo)144 708 Q .807 -.15(ve b)-.15 H .507 -(ack through the history list, inserting the last w).15 F .507 -(ord \(or the w)-.1 F .507(ord speci\214ed by the ar)-.1 F(gument)-.18 E -1.396(to the \214rst call\) of each line in turn.)144 720 R(An)6.396 E -3.896(yn)-.15 G 1.396(umeric ar)-3.896 F 1.397 -(gument supplied to these successi)-.18 F 1.697 -.15(ve c)-.25 H(alls) -.15 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(9)198.45 E 0 Cg -EP +(th w)B .292(ord from the end of)-.1 F .282(the pre)144 708 R .282 +(vious command.)-.25 F .282(Once the ar)5.282 F(gument)-.18 E F2(n)2.781 +E F0 .281(is computed, the ar)2.781 F .281(gument is e)-.18 F .281 +(xtracted as if the "!)-.15 F F2(n)A F0(")A(history e)144 720 Q +(xpansion had been speci\214ed.)-.15 E(GNU Readline 8.2)72 768 Q +(2022 August 12)127.345 E(9)197.055 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E .492 -(determines the direction to mo)144 84 R .792 -.15(ve t)-.15 H .492 -(hrough the history).15 F 5.491(.A)-.65 G(ne)-2.5 E -.05(ga)-.15 G(ti) -.05 E .791 -.15(ve a)-.25 H -.18(rg).15 G .491 +(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF +(yank\255last\255ar)108 84 Q 2.5(g\()-.1 G -1.667(M\255. ,)-2.5 F -1.667 +(M\255_ \))2.5 F F0 1.307(Insert the last ar)144 96 R 1.307 +(gument to the pre)-.18 F 1.307(vious command \(the last w)-.25 F 1.308 +(ord of the pre)-.1 F 1.308(vious history entry\).)-.25 F -.4(Wi)144 108 +S .204(th a numeric ar).4 F .204(gument, beha)-.18 F .504 -.15(ve ex)-.2 +H .204(actly lik).15 F(e)-.1 E F1(yank\255nth\255ar)2.704 E(g)-.1 E F0 +5.203(.S)C(uccessi)-5.203 E .503 -.15(ve c)-.25 H .203(alls to).15 F F1 +(yank\255last\255ar)2.703 E(g)-.1 E F0(mo)144 120 Q .806 -.15(ve b)-.15 +H .507(ack through the history list, inserting the last w).15 F .507 +(ord \(or the w)-.1 F .507(ord speci\214ed by the ar)-.1 F(gument)-.18 E +.416(to the \214rst call\) of each line in turn.)144 132 R(An)5.416 E +2.916(yn)-.15 G .416(umeric ar)-2.916 F .416 +(gument supplied to these successi)-.18 F .715 -.15(ve c)-.25 H .415 +(alls de-).15 F 1.217(termines the direction to mo)144 144 R 1.518 -.15 +(ve t)-.15 H 1.218(hrough the history).15 F 6.218(.A)-.65 G(ne)-2.5 E +-.05(ga)-.15 G(ti).05 E 1.518 -.15(ve a)-.25 H -.18(rg).15 G 1.218 (ument switches the direction).18 F .494 -(through the history \(back or forw)144 96 R 2.994(ard\). The)-.1 F .494 -(history e)2.994 F .494(xpansion f)-.15 F .494(acilities are used to e) --.1 F .494(xtract the last)-.15 F(ar)144 108 Q +(through the history \(back or forw)144 156 R 2.994(ard\). The)-.1 F +.494(history e)2.994 F .494(xpansion f)-.15 F .494 +(acilities are used to e)-.1 F .494(xtract the last)-.15 F(ar)144 168 Q (gument, as if the "!$" history e)-.18 E(xpansion had been speci\214ed.) --.15 E/F1 10/Times-Bold@0 SF(Commands f)87 124.8 Q(or Changing T)-.25 E -(ext)-.92 E/F2 10/Times-Italic@0 SF(end\255of\255\214le)108 136.8 Q F1 -(\(usually C\255d\))2.5 E F0 .799 -(The character indicating end-of-\214le as set, for e)144 148.8 R .799 -(xample, by)-.15 F/F3 10/Courier@0 SF(stty)3.299 E F0 5.799(.I)C 3.298 -(ft)-5.799 G .798(his character is read when)-3.298 F .592 -(there are no characters on the line, and point is at the be)144 160.8 R -.593(ginning of the line, Readline interprets it)-.15 F -(as the end of input and returns)144 172.8 Q/F4 9/Times-Bold@0 SF(EOF) -2.5 E/F5 9/Times-Roman@0 SF(.)A F1(delete\255char \(C\255d\))108 184.8 Q -F0 .442(Delete the character at point.)144 196.8 R .442 -(If this function is bound to the same character as the tty)5.442 F F1 -(EOF)2.941 E F0(char)2.941 E(-)-.2 E(acter)144 208.8 Q 2.5(,a)-.4 G(s) +-.15 E F1(Commands f)87 184.8 Q(or Changing T)-.25 E(ext)-.92 E/F2 10 +/Times-Italic@0 SF(end\255of\255\214le)108 196.8 Q F1 +(\(usually C\255d\))2.5 E F0 .798 +(The character indicating end-of-\214le as set, for e)144 208.8 R .799 +(xample, by)-.15 F/F3 10/Courier@0 SF(stty)3.299 E F0 5.799(.I)C 3.299 +(ft)-5.799 G .799(his character is read when)-3.299 F .592 +(there are no characters on the line, and point is at the be)144 220.8 R +.592(ginning of the line, Readline interprets it)-.15 F +(as the end of input and returns)144 232.8 Q/F4 9/Times-Bold@0 SF(EOF) +2.5 E/F5 9/Times-Roman@0 SF(.)A F1(delete\255char \(C\255d\))108 244.8 Q +F0 .441(Delete the character at point.)144 256.8 R .442 +(If this function is bound to the same character as the tty)5.441 F F1 +(EOF)2.942 E F0(char)2.942 E(-)-.2 E(acter)144 268.8 Q 2.5(,a)-.4 G(s) -2.5 E F1(C\255d)2.5 E F0(commonly is, see abo)2.5 E .3 -.15(ve f)-.15 H (or the ef).15 E(fects.)-.25 E F1(backward\255delete\255char \(Rubout\)) -108 220.8 Q F0 .552(Delete the character behind the cursor)144 232.8 R +108 280.8 Q F0 .553(Delete the character behind the cursor)144 292.8 R 5.553(.W)-.55 G .553(hen gi)-5.553 F -.15(ve)-.25 G 3.053(nan).15 G .553 -(umeric ar)-3.053 F .553(gument, sa)-.18 F .853 -.15(ve t)-.2 H .553 -(he deleted te).15 F .553(xt on)-.15 F(the kill ring.)144 244.8 Q F1 --.25(fo)108 256.8 S(rward\255backward\255delete\255char).25 E F0 .474 -(Delete the character under the cursor)144 268.8 R 2.974(,u)-.4 G .474 -(nless the cursor is at the end of the line, in which case the)-2.974 F -(character behind the cursor is deleted.)144 280.8 Q F1 -(quoted\255insert \(C\255q, C\255v\))108 292.8 Q F0 1.228(Add the ne)144 -304.8 R 1.228(xt character that you type to the line v)-.15 F 3.728 -(erbatim. This)-.15 F 1.228(is ho)3.728 F 3.729(wt)-.25 G 3.729(oi) --3.729 G 1.229(nsert characters lik)-3.729 F(e)-.1 E F1(C\255q)144 316.8 +(umeric ar)-3.053 F .552(gument, sa)-.18 F .852 -.15(ve t)-.2 H .552 +(he deleted te).15 F .552(xt on)-.15 F(the kill ring.)144 304.8 Q F1 +-.25(fo)108 316.8 S(rward\255backward\255delete\255char).25 E F0 .473 +(Delete the character under the cursor)144 328.8 R 2.973(,u)-.4 G .474 +(nless the cursor is at the end of the line, in which case the)-2.973 F +(character behind the cursor is deleted.)144 340.8 Q F1 +(quoted\255insert \(C\255q, C\255v\))108 352.8 Q F0 1.229(Add the ne)144 +364.8 R 1.228(xt character that you type to the line v)-.15 F 3.728 +(erbatim. This)-.15 F 1.228(is ho)3.728 F 3.728(wt)-.25 G 3.728(oi) +-3.728 G 1.228(nsert characters lik)-3.728 F(e)-.1 E F1(C\255q)144 376.8 Q F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108 -328.8 Q(AB\))-.9 E F0(Insert a tab character)144 340.8 Q(.)-.55 E F1 -(self\255insert \(a, b, A, 1, !, ...\))108 352.8 Q F0 -(Insert the character typed.)144 364.8 Q F1 -(transpose\255chars \(C\255t\))108 376.8 Q F0 .322 -(Drag the character before point forw)144 388.8 R .321(ard o)-.1 F -.15 -(ve)-.15 G 2.821(rt).15 G .321(he character at point, mo)-2.821 F .321 -(ving point forw)-.15 F .321(ard as well.)-.1 F .372 +388.8 Q(AB\))-.9 E F0(Insert a tab character)144 400.8 Q(.)-.55 E F1 +(self\255insert \(a, b, A, 1, !, ...\))108 412.8 Q F0 +(Insert the character typed.)144 424.8 Q F1 +(transpose\255chars \(C\255t\))108 436.8 Q F0 .321 +(Drag the character before point forw)144 448.8 R .321(ard o)-.1 F -.15 +(ve)-.15 G 2.821(rt).15 G .321(he character at point, mo)-2.821 F .322 +(ving point forw)-.15 F .322(ard as well.)-.1 F .372 (If point is at the end of the line, then this transposes the tw)144 -400.8 R 2.872(oc)-.1 G .373(haracters before point.)-2.872 F(Ne)5.373 E --.05(ga)-.15 G(ti).05 E .673 -.15(ve a)-.25 H -.2(r-).15 G(guments ha) -144 412.8 Q .3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1 -(transpose\255w)108 424.8 Q(ords \(M\255t\))-.1 E F0 .024(Drag the w)144 -436.8 R .024(ord before point past the w)-.1 F .023(ord after point, mo) --.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.523(rt).15 G .023(hat w) --2.523 F .023(ord as well.)-.1 F .023(If point)5.023 F -(is at the end of the line, this transposes the last tw)144 448.8 Q 2.5 -(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 460.8 Q -(ord \(M\255u\))-.1 E F0 1.698(Uppercase the current \(or follo)144 -472.8 R 1.698(wing\) w)-.25 F 4.198(ord. W)-.1 F 1.698(ith a ne)-.4 F --.05(ga)-.15 G(ti).05 E 1.999 -.15(ve a)-.25 H -.18(rg).15 G 1.699 -(ument, uppercase the pre).18 F(vious)-.25 E -.1(wo)144 484.8 S(rd, b).1 -E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 496.8 Q -(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 508.8 Q 1.648 -(wercase the current \(or follo)-.25 F 1.648(wing\) w)-.25 F 4.148 -(ord. W)-.1 F 1.647(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E 1.947 -.15 -(ve a)-.25 H -.18(rg).15 G 1.647(ument, lo).18 F 1.647(wercase the pre) --.25 F(vious)-.25 E -.1(wo)144 520.8 S(rd, b).1 E(ut do not mo)-.2 E .3 --.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 532.8 Q -(ord \(M\255c\))-.1 E F0 1.974(Capitalize the current \(or follo)144 -544.8 R 1.974(wing\) w)-.25 F 4.474(ord. W)-.1 F 1.974(ith a ne)-.4 F --.05(ga)-.15 G(ti).05 E 2.274 -.15(ve a)-.25 H -.18(rg).15 G 1.975 -(ument, capitalize the pre).18 F(vious)-.25 E -.1(wo)144 556.8 S(rd, b) +460.8 R 2.872(oc)-.1 G .372(haracters before point.)-2.872 F(Ne)5.372 E +-.05(ga)-.15 G(ti).05 E .672 -.15(ve a)-.25 H -.2(r-).15 G(guments ha) +144 472.8 Q .3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1 +(transpose\255w)108 484.8 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144 +496.8 R .023(ord before point past the w)-.1 F .023(ord after point, mo) +-.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.524(rt).15 G .024(hat w) +-2.524 F .024(ord as well.)-.1 F .024(If point)5.024 F +(is at the end of the line, this transposes the last tw)144 508.8 Q 2.5 +(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 520.8 Q +(ord \(M\255u\))-.1 E F0 1.699(Uppercase the current \(or follo)144 +532.8 R 1.698(wing\) w)-.25 F 4.198(ord. W)-.1 F 1.698(ith a ne)-.4 F +-.05(ga)-.15 G(ti).05 E 1.998 -.15(ve a)-.25 H -.18(rg).15 G 1.698 +(ument, uppercase the pre).18 F(vious)-.25 E -.1(wo)144 544.8 S(rd, b).1 +E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 556.8 Q +(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 568.8 Q 1.647 +(wercase the current \(or follo)-.25 F 1.647(wing\) w)-.25 F 4.147 +(ord. W)-.1 F 1.648(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E 1.948 -.15 +(ve a)-.25 H -.18(rg).15 G 1.648(ument, lo).18 F 1.648(wercase the pre) +-.25 F(vious)-.25 E -.1(wo)144 580.8 S(rd, b).1 E(ut do not mo)-.2 E .3 +-.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 592.8 Q +(ord \(M\255c\))-.1 E F0 1.975(Capitalize the current \(or follo)144 +604.8 R 1.974(wing\) w)-.25 F 4.474(ord. W)-.1 F 1.974(ith a ne)-.4 F +-.05(ga)-.15 G(ti).05 E 2.274 -.15(ve a)-.25 H -.18(rg).15 G 1.974 +(ument, capitalize the pre).18 F(vious)-.25 E -.1(wo)144 616.8 S(rd, b) .1 E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1 -.1(ove)108 -568.8 S(rwrite\255mode).1 E F0 -.8(To)144 580.8 S .438(ggle o).8 F -.15 -(ve)-.15 G .438(rwrite mode.).15 F -.4(Wi)5.438 G .438(th an e).4 F .438 -(xplicit positi)-.15 F .737 -.15(ve n)-.25 H .437(umeric ar).15 F .437 -(gument, switches to o)-.18 F -.15(ve)-.15 G .437(rwrite mode.).15 F -.4 -(Wi)144 592.8 S .78(th an e).4 F .781(xplicit non-positi)-.15 F 1.081 +628.8 S(rwrite\255mode).1 E F0 -.8(To)144 640.8 S .437(ggle o).8 F -.15 +(ve)-.15 G .437(rwrite mode.).15 F -.4(Wi)5.437 G .437(th an e).4 F .437 +(xplicit positi)-.15 F .738 -.15(ve n)-.25 H .438(umeric ar).15 F .438 +(gument, switches to o)-.18 F -.15(ve)-.15 G .438(rwrite mode.).15 F -.4 +(Wi)144 652.8 S .781(th an e).4 F .781(xplicit non-positi)-.15 F 1.081 -.15(ve n)-.25 H .781(umeric ar).15 F .781 -(gument, switches to insert mode.)-.18 F .781(This command af)5.781 F -(fects)-.25 E(only)144 604.8 Q F1(emacs)4.395 E F0(mode;)4.395 E F1(vi) -4.395 E F0 1.894(mode does o)4.395 F -.15(ve)-.15 G 1.894(rwrite dif).15 +(gument, switches to insert mode.)-.18 F .78(This command af)5.781 F +(fects)-.25 E(only)144 664.8 Q F1(emacs)4.394 E F0(mode;)4.394 E F1(vi) +4.394 E F0 1.894(mode does o)4.394 F -.15(ve)-.15 G 1.894(rwrite dif).15 F(ferently)-.25 E 6.894(.E)-.65 G 1.894(ach call to)-6.894 F F2 -.37(re) -4.394 G(adline\(\)).37 E F0 1.894(starts in insert)4.394 F 3.968 -(mode. In)144 616.8 R -.15(ove)3.968 G 1.468 +4.395 G(adline\(\)).37 E F0 1.895(starts in insert)4.395 F 3.969 +(mode. In)144 676.8 R -.15(ove)3.969 G 1.469 (rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E F0 -1.469(replace the te)3.969 F 1.469(xt at point rather than)-.15 F .958 -(pushing the te)144 628.8 R .958(xt to the right.)-.15 F .957 -(Characters bound to)5.958 F F1(backward\255delete\255char)3.457 E F0 -.957(replace the character)3.457 F(before point with a space.)144 640.8 -Q(By def)5 E(ault, this command is unbound.)-.1 E F1(Killing and Y)87 -657.6 Q(anking)-.85 E(kill\255line \(C\255k\))108 669.6 Q F0 -(Kill the te)144 681.6 Q(xt from point to the end of the line.)-.15 E F1 -(backward\255kill\255line \(C\255x Rubout\))108 693.6 Q F0(Kill backw) -144 705.6 Q(ard to the be)-.1 E(ginning of the line.)-.15 E -(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(10)193.45 E 0 Cg EP +1.468(replace the te)3.969 F 1.468(xt at point rather than)-.15 F .957 +(pushing the te)144 688.8 R .957(xt to the right.)-.15 F .958 +(Characters bound to)5.957 F F1(backward\255delete\255char)3.458 E F0 +.958(replace the character)3.458 F(before point with a space.)144 700.8 +Q(By def)5 E(ault, this command is unbound.)-.1 E(GNU Readline 8.2)72 +768 Q(2022 August 12)127.345 E(10)192.055 E 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R (Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(unix\255line\255discard \(C\255u\))108 84 Q F0(Kill backw)144 96 Q +(Killing and Y)87 84 Q(anking)-.85 E(kill\255line \(C\255k\))108 96 Q F0 +(Kill the te)144 108 Q(xt from point to the end of the line.)-.15 E F1 +(backward\255kill\255line \(C\255x Rubout\))108 120 Q F0(Kill backw)144 +132 Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1 +(unix\255line\255discard \(C\255u\))108 144 Q F0(Kill backw)144 156 Q (ard from point to the be)-.1 E(ginning of the line.)-.15 E (The killed te)5 E(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt) --2.5 G(he kill-ring.)-2.5 E F1(kill\255whole\255line)108 108 Q F0 +-2.5 G(he kill-ring.)-2.5 E F1(kill\255whole\255line)108 168 Q F0 (Kill all characters on the current line, no matter where point is.)144 -120 Q F1(kill\255w)108 132 Q(ord \(M\255d\))-.1 E F0 1.308 -(Kill from point the end of the current w)144 144 R 1.308 -(ord, or if between w)-.1 F 1.308(ords, to the end of the ne)-.1 F 1.308 -(xt w)-.15 F(ord.)-.1 E -.8(Wo)144 156 S +180 Q F1(kill\255w)108 192 Q(ord \(M\255d\))-.1 E F0 1.308 +(Kill from point the end of the current w)144 204 R 1.308 +(ord, or if between w)-.1 F 1.308(ords, to the end of the ne)-.1 F 1.307 +(xt w)-.15 F(ord.)-.1 E -.8(Wo)144 216 S (rd boundaries are the same as those used by).8 E F1 -.25(fo)2.5 G -(rward\255w).25 E(ord)-.1 E F0(.)A F1(backward\255kill\255w)108 168 Q -(ord \(M\255Rubout\))-.1 E F0(Kill the w)144 180 Q(ord behind point.)-.1 +(rward\255w).25 E(ord)-.1 E F0(.)A F1(backward\255kill\255w)108 228 Q +(ord \(M\255Rubout\))-.1 E F0(Kill the w)144 240 Q(ord behind point.)-.1 E -.8(Wo)5 G(rd boundaries are the same as those used by).8 E F1 -(backward\255w)2.5 E(ord)-.1 E F0(.)A F1(unix\255w)108 192 Q -(ord\255rubout \(C\255w\))-.1 E F0 .365(Kill the w)144 204 R .365 -(ord behind point, using white space as a w)-.1 F .364(ord boundary)-.1 -F 5.364(.T)-.65 G .364(he killed te)-5.364 F .364(xt is sa)-.15 F -.15 -(ve)-.2 G 2.864(do).15 G 2.864(nt)-2.864 G(he)-2.864 E(kill-ring.)144 -216 Q F1(unix\255\214lename\255rubout)108 228 Q F0 .166(Kill the w)144 -240 R .166 +(backward\255w)2.5 E(ord)-.1 E F0(.)A F1(unix\255w)108 252 Q +(ord\255rubout \(C\255w\))-.1 E F0 .364(Kill the w)144 264 R .364 +(ord behind point, using white space as a w)-.1 F .365(ord boundary)-.1 +F 5.365(.T)-.65 G .365(he killed te)-5.365 F .365(xt is sa)-.15 F -.15 +(ve)-.2 G 2.865(do).15 G 2.865(nt)-2.865 G(he)-2.865 E(kill-ring.)144 +276 Q F1(unix\255\214lename\255rubout)108 288 Q F0 .167(Kill the w)144 +300 R .166 (ord behind point, using white space and the slash character as the w) --.1 F .167(ord boundaries.)-.1 F(The)5.167 E(killed te)144 252 Q +-.1 F .166(ord boundaries.)-.1 F(The)5.166 E(killed te)144 312 Q (xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)-2.5 G(he kill-ring.) --2.5 E F1(delete\255horizontal\255space \(M\255\\\))108 264 Q F0 -(Delete all spaces and tabs around point.)144 276 Q F1(kill\255r)108 288 -Q(egion)-.18 E F0 .302(Kill the te)144 300 R .301 +-2.5 E F1(delete\255horizontal\255space \(M\255\\\))108 324 Q F0 +(Delete all spaces and tabs around point.)144 336 Q F1(kill\255r)108 348 +Q(egion)-.18 E F0 .301(Kill the te)144 360 R .301 (xt between the point and)-.15 F/F2 10/Times-Italic@0 SF(mark)2.801 E F0 (\(sa)2.801 E -.15(ve)-.2 G 2.801(dc).15 G .301(ursor position\).)-2.801 F .301(This te)5.301 F .301(xt is referred to as the)-.15 F F2 -.37(re) -2.801 G(-).37 E(gion)144 312 Q F0(.)A F1(copy\255r)108 324 Q -(egion\255as\255kill)-.18 E F0(Cop)144 336 Q 2.5(yt)-.1 G(he te)-2.5 E +2.802 G(-).37 E(gion)144 372 Q F0(.)A F1(copy\255r)108 384 Q +(egion\255as\255kill)-.18 E F0(Cop)144 396 Q 2.5(yt)-.1 G(he te)-2.5 E (xt in the re)-.15 E(gion to the kill b)-.15 E(uf)-.2 E(fer)-.25 E(.) --.55 E F1(copy\255backward\255w)108 348 Q(ord)-.1 E F0(Cop)144 360 Q 4.8 -(yt)-.1 G 2.3(he w)-4.8 F 2.3(ord before point to the kill b)-.1 F(uf) --.2 E(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.301 -(ord boundaries are the same as)-.1 F F1(back-)4.801 E(ward\255w)144 372 -Q(ord)-.1 E F0(.)A F1(copy\255f)108 384 Q(orward\255w)-.25 E(ord)-.1 E -F0(Cop)144 396 Q 4.508(yt)-.1 G 2.008(he w)-4.508 F 2.008(ord follo)-.1 -F 2.008(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 E 7.007(.T) --.55 G 2.007(he w)-7.007 F 2.007(ord boundaries are the same as)-.1 F F1 --.25(fo)4.507 G -.37(r-).25 G(ward\255w)144 408 Q(ord)-.1 E F0(.)A F1 -(yank \(C\255y\))108 420 Q F0 -1(Ya)144 432 S +-.55 E F1(copy\255backward\255w)108 408 Q(ord)-.1 E F0(Cop)144 420 Q +4.801(yt)-.1 G 2.301(he w)-4.801 F 2.301(ord before point to the kill b) +-.1 F(uf)-.2 E(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.3 +(ord boundaries are the same as)-.1 F F1(back-)4.8 E(ward\255w)144 432 Q +(ord)-.1 E F0(.)A F1(copy\255f)108 444 Q(orward\255w)-.25 E(ord)-.1 E F0 +(Cop)144 456 Q 4.507(yt)-.1 G 2.007(he w)-4.507 F 2.007(ord follo)-.1 F +2.007(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 E 7.008(.T)-.55 +G 2.008(he w)-7.008 F 2.008(ord boundaries are the same as)-.1 F F1 -.25 +(fo)4.508 G -.37(r-).25 G(ward\255w)144 468 Q(ord)-.1 E F0(.)A F1 +(yank \(C\255y\))108 480 Q F0 -1(Ya)144 492 S (nk the top of the kill ring into the b)1 E(uf)-.2 E(fer at point.)-.25 -E F1(yank\255pop \(M\255y\))108 444 Q F0 -(Rotate the kill ring, and yank the ne)144 456 Q 2.5(wt)-.25 G 2.5 +E F1(yank\255pop \(M\255y\))108 504 Q F0 +(Rotate the kill ring, and yank the ne)144 516 Q 2.5(wt)-.25 G 2.5 (op. Only)-2.5 F -.1(wo)2.5 G(rks follo).1 E(wing)-.25 E F1(yank)2.5 E -F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 472.8 Q -(guments)-.1 E(digit\255ar)108 484.8 Q +F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 532.8 Q +(guments)-.1 E(digit\255ar)108 544.8 Q (gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .367 -(Add this digit to the ar)144 496.8 R .367 +(Add this digit to the ar)144 556.8 R .367 (gument already accumulating, or start a ne)-.18 F 2.867(wa)-.25 G -.18 -(rg)-2.867 G 2.867(ument. M\255\255).18 F .367(starts a ne)2.867 F -.05 -(ga)-.15 G(-).05 E(ti)144 508.8 Q .3 -.15(ve a)-.25 H -.18(rg).15 G -(ument.).18 E F1(uni)108 520.8 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 -E F0 .779(This is another w)144 532.8 R .779(ay to specify an ar)-.1 F -3.279(gument. If)-.18 F .779(this command is follo)3.279 F .778 +(rg)-2.867 G 2.867(ument. M\255\255).18 F .366(starts a ne)2.867 F -.05 +(ga)-.15 G(-).05 E(ti)144 568.8 Q .3 -.15(ve a)-.25 H -.18(rg).15 G +(ument.).18 E F1(uni)108 580.8 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 +E F0 .778(This is another w)144 592.8 R .779(ay to specify an ar)-.1 F +3.279(gument. If)-.18 F .779(this command is follo)3.279 F .779 (wed by one or more digits,)-.25 F 1.376 (optionally with a leading minus sign, those digits de\214ne the ar)144 -544.8 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 -556.8 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni) +604.8 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 +616.8 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni) 3.67 E -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0(ag)3.67 E 1.17 (ain ends the numeric ar)-.05 F 1.17(gument, b)-.18 F 1.17(ut is other) --.2 F(-)-.2 E .898(wise ignored.)144 568.8 R .898 -(As a special case, if this command is immediately follo)5.898 F .898 +-.2 F(-)-.2 E .899(wise ignored.)144 628.8 R .898 +(As a special case, if this command is immediately follo)5.899 F .898 (wed by a character that is)-.25 F .243 -(neither a digit or minus sign, the ar)144 580.8 R .243 +(neither a digit or minus sign, the ar)144 640.8 R .243 (gument count for the ne)-.18 F .243(xt command is multiplied by four) --.15 F 5.242(.T)-.55 G(he)-5.242 E(ar)144 592.8 Q .378 +-.15 F 5.243(.T)-.55 G(he)-5.243 E(ar)144 652.8 Q .378 (gument count is initially one, so e)-.18 F -.15(xe)-.15 G .378 (cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F -.378(gument count)-.18 F(four)144 604.8 Q 2.5(,as)-.4 G(econd time mak) +.378(gument count)-.18 F(four)144 664.8 Q 2.5(,as)-.4 G(econd time mak) -2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1 -(Completing)87 621.6 Q(complete \(T)108 633.6 Q(AB\))-.9 E F0 .682 -(Attempt to perform completion on the te)144 645.6 R .681 -(xt before point.)-.15 F .681(The actual completion performed is ap-) -5.681 F(plication-speci\214c.)144 657.6 Q F1(Bash)6.243 E F0 3.743(,f)C -1.244(or instance, attempts completion treating the te)-3.743 F 1.244 -(xt as a v)-.15 F 1.244(ariable \(if the)-.25 F(te)144 669.6 Q .657 -(xt be)-.15 F .657(gins with)-.15 F F1($)3.156 E F0 .656 +(Completing)87 681.6 Q(complete \(T)108 693.6 Q(AB\))-.9 E F0 .681 +(Attempt to perform completion on the te)144 705.6 R .681 +(xt before point.)-.15 F .682(The actual completion performed is ap-) +5.682 F(plication-speci\214c.)144 717.6 Q F1(Bash)6.244 E F0 3.744(,f)C +1.244(or instance, attempts completion treating the te)-3.744 F 1.244 +(xt as a v)-.15 F 1.243(ariable \(if the)-.25 F(te)144 729.6 Q .656 +(xt be)-.15 F .656(gins with)-.15 F F1($)3.156 E F0 .656 (\), username \(if the te)B .656(xt be)-.15 F .656(gins with)-.15 F F1 (~)3.156 E F0 .656(\), hostname \(if the te)B .656(xt be)-.15 F .656 -(gins with)-.15 F F1(@)3.156 E F0 .656(\), or)B .929 -(command \(including aliases and functions\) in turn.)144 681.6 R .93 -(If none of these produces a match, \214lename)5.929 F 1.274 -(completion is attempted.)144 693.6 R F1(Gdb)6.273 E F0 3.773(,o)C 3.773 -(nt)-3.773 G 1.273(he other hand, allo)-3.773 F 1.273 -(ws completion of program functions and)-.25 F -.25(va)144 705.6 S(riab\ -les, and only attempts \214lename completion under certain circumstance\ -s.).25 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(11)193.45 E 0 -Cg EP +(gins with)-.15 F F1(@)3.157 E F0 .657(\), or)B(GNU Readline 8.2)72 768 +Q(2022 August 12)127.345 E(11)192.055 E 0 Cg EP %%Page: 12 12 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(possible\255completions \(M\255?\))108 84 Q F0 .261 -(List the possible completions of the te)144 96 R .262(xt before point.) --.15 F .262(When displaying completions, readline sets)5.262 F 1.002 -(the number of columns used for display to the v)144 108 R 1.002 -(alue of)-.25 F F1(completion-display-width)3.502 E F0 3.502(,t)C 1.002 -(he v)-3.502 F 1.002(alue of)-.25 F(the en)144 120 Q(vironment v)-.4 E +(Functions Manual)2.5 E(READLINE\(3\))119.855 E .93 +(command \(including aliases and functions\) in turn.)144 84 R .929 +(If none of these produces a match, \214lename)5.929 F 1.273 +(completion is attempted.)144 96 R/F1 10/Times-Bold@0 SF(Gdb)6.273 E F0 +3.773(,o)C 3.773(nt)-3.773 G 1.273(he other hand, allo)-3.773 F 1.273 +(ws completion of program functions and)-.25 F -.25(va)144 108 S(riable\ +s, and only attempts \214lename completion under certain circumstances.) +.25 E F1(possible\255completions \(M\255?\))108 120 Q F0 .262 +(List the possible completions of the te)144 132 R .262 +(xt before point.)-.15 F .261 +(When displaying completions, readline sets)5.261 F 1.002 +(the number of columns used for display to the v)144 144 R 1.002 +(alue of)-.25 F F1(completion-display-width)3.502 E F0 3.502(,t)C 1.003 +(he v)-3.502 F 1.003(alue of)-.25 F(the en)144 156 Q(vironment v)-.4 E (ariable)-.25 E/F2 9/Times-Bold@0 SF(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF (,)A F0(or the screen width, in that order)2.25 E(.)-.55 E F1 -(insert\255completions \(M\255*\))108 132 Q F0 .783 -(Insert all completions of the te)144 144 R .783(xt before point that w) +(insert\255completions \(M\255*\))108 168 Q F0 .783 +(Insert all completions of the te)144 180 R .783(xt before point that w) -.15 F .783(ould ha)-.1 F 1.083 -.15(ve b)-.2 H .783(een generated by) -.15 F F1(possible\255com-)3.283 E(pletions)144 156 Q F0(.)A F1 -(menu\255complete)108 168 Q F0 .929(Similar to)144 180 R F1(complete) -3.429 E F0 3.429(,b)C .929(ut replaces the w)-3.629 F .929 -(ord to be completed with a single match from the list of)-.1 F 1.193 -(possible completions.)144 192 R 1.193(Repeated e)6.193 F -.15(xe)-.15 G -1.193(cution of).15 F F1(menu\255complete)3.694 E F0 1.194 -(steps through the list of possible)3.694 F .829 -(completions, inserting each match in turn.)144 204 R .828 +.15 F F1(possible\255com-)3.282 E(pletions)144 192 Q F0(.)A F1 +(menu\255complete)108 204 Q F0 .928(Similar to)144 216 R F1(complete) +3.428 E F0 3.428(,b)C .929(ut replaces the w)-3.628 F .929 +(ord to be completed with a single match from the list of)-.1 F 1.194 +(possible completions.)144 228 R 1.194(Repeated e)6.194 F -.15(xe)-.15 G +1.194(cution of).15 F F1(menu\255complete)3.694 E F0 1.193 +(steps through the list of possible)3.694 F .828 +(completions, inserting each match in turn.)144 240 R .828 (At the end of the list of completions, the bell is rung)5.828 F .727 -(\(subject to the setting of)144 216 R F1(bell\255style)3.227 E F0 3.227 +(\(subject to the setting of)144 252 R F1(bell\255style)3.227 E F0 3.227 (\)a)C .727(nd the original te)-3.227 F .727(xt is restored.)-.15 F .727 (An ar)5.727 F .727(gument of)-.18 F/F4 10/Times-Italic@0 SF(n)3.227 E -F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F4(n)3.228 E F0 1.73 -(positions forw)144 228 R 1.73(ard in the list of matches; a ne)-.1 F +F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F4(n)3.227 E F0 1.73 +(positions forw)144 264 R 1.73(ard in the list of matches; a ne)-.1 F -.05(ga)-.15 G(ti).05 E 2.03 -.15(ve a)-.25 H -.18(rg).15 G 1.73 (ument may be used to mo).18 F 2.03 -.15(ve b)-.15 H(ackw).15 E(ard)-.1 -E(through the list.)144 240 Q(This command is intended to be bound to)5 +E(through the list.)144 276 Q(This command is intended to be bound to)5 E F1 -.9(TA)2.5 G(B).9 E F0 2.5(,b)C(ut is unbound by def)-2.7 E(ault.) --.1 E F1(menu\255complete\255backward)108 252 Q F0 .82(Identical to)144 -264 R F1(menu\255complete)3.32 E F0 3.32(,b)C .82(ut mo)-3.52 F -.15(ve) +-.1 E F1(menu\255complete\255backward)108 288 Q F0 .82(Identical to)144 +300 R F1(menu\255complete)3.32 E F0 3.32(,b)C .82(ut mo)-3.52 F -.15(ve) -.15 G 3.32(sb).15 G(ackw)-3.32 E .82 (ard through the list of possible completions, as if)-.1 F F1 -(menu\255complete)144 276 Q F0(had been gi)2.5 E -.15(ve)-.25 G 2.5(nan) +(menu\255complete)144 312 Q F0(had been gi)2.5 E -.15(ve)-.25 G 2.5(nan) .15 G -2.25 -.15(eg a)-2.5 H(ti).15 E .3 -.15(ve a)-.25 H -.18(rg).15 G 2.5(ument. This).18 F(command is unbound by def)2.5 E(ault.)-.1 E F1 -(delete\255char\255or\255list)108 288 Q F0 .374 -(Deletes the character under the cursor if not at the be)144 300 R .373 -(ginning or end of the line \(lik)-.15 F(e)-.1 E F1(delete-char)2.873 E -F0(\).)A(If at the end of the line, beha)144 312 Q -.15(ve)-.2 G 2.5(si) +(delete\255char\255or\255list)108 324 Q F0 .373 +(Deletes the character under the cursor if not at the be)144 336 R .374 +(ginning or end of the line \(lik)-.15 F(e)-.1 E F1(delete-char)2.874 E +F0(\).)A(If at the end of the line, beha)144 348 Q -.15(ve)-.2 G 2.5(si) .15 G(dentically to)-2.5 E F1(possible-completions)2.5 E F0(.)A F1 -.25 -(Ke)87 328.8 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)108 -340.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 352.8 Q +(Ke)87 364.8 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)108 +376.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 388.8 Q (gin sa)-.15 E(ving the characters typed into the current k)-.2 E -.15 -(ey)-.1 G(board macro.).15 E F1(end\255kbd\255macr)108 364.8 Q 2.5(o\() --.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 376.8 Q +(ey)-.1 G(board macro.).15 E F1(end\255kbd\255macr)108 400.8 Q 2.5(o\() +-.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 412.8 Q (ving the characters typed into the current k)-.2 E -.15(ey)-.1 G (board macro and store the de\214nition.).15 E F1 -(call\255last\255kbd\255macr)108 388.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5 -E F0(Re-e)144 400.8 Q -.15(xe)-.15 G .999(cute the last k).15 F -.15(ey) --.1 G .999(board macro de\214ned, by making the characters in the macro\ - appear as if).15 F(typed at the k)144 412.8 Q -.15(ey)-.1 G(board.).15 -E F1(print\255last\255kbd\255macr)108 424.8 Q 2.5(o\()-.18 G(\))-2.5 E -F0(Print the last k)144 436.8 Q -.15(ey)-.1 G +(call\255last\255kbd\255macr)108 424.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5 +E F0(Re-e)144 436.8 Q -.15(xe)-.15 G 1(cute the last k).15 F -.15(ey)-.1 +G .999(board macro de\214ned, by making the characters in the macro app\ +ear as if).15 F(typed at the k)144 448.8 Q -.15(ey)-.1 G(board.).15 E F1 +(print\255last\255kbd\255macr)108 460.8 Q 2.5(o\()-.18 G(\))-2.5 E F0 +(Print the last k)144 472.8 Q -.15(ey)-.1 G (board macro de\214ned in a format suitable for the).15 E F4(inputr)2.5 -E(c)-.37 E F0(\214le.)2.5 E F1(Miscellaneous)87 453.6 Q -.18(re)108 -465.6 S<ad72>.18 E(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0 -1.777(Read in the contents of the)144 477.6 R F4(inputr)4.277 E(c)-.37 E -F0 1.776(\214le, and incorporate an)4.276 F 4.276(yb)-.15 G 1.776 -(indings or v)-4.276 F 1.776(ariable assignments)-.25 F(found there.)144 -489.6 Q F1(abort \(C\255g\))108 501.6 Q F0 3.248 -(Abort the current editing command and ring the terminal')144 513.6 R -5.749(sb)-.55 G 3.249(ell \(subject to the setting of)-5.749 F F1 -(bell\255style)144 525.6 Q F0(\).)A F1(do\255lo)108 537.6 Q(wer)-.1 E +E(c)-.37 E F0(\214le.)2.5 E F1(Miscellaneous)87 489.6 Q -.18(re)108 +501.6 S<ad72>.18 E(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0 +1.776(Read in the contents of the)144 513.6 R F4(inputr)4.276 E(c)-.37 E +F0 1.777(\214le, and incorporate an)4.276 F 4.277(yb)-.15 G 1.777 +(indings or v)-4.277 F 1.777(ariable assignments)-.25 F(found there.)144 +525.6 Q F1(abort \(C\255g\))108 537.6 Q F0 3.249 +(Abort the current editing command and ring the terminal')144 549.6 R +5.748(sb)-.55 G 3.248(ell \(subject to the setting of)-5.748 F F1 +(bell\255style)144 561.6 Q F0(\).)A F1(do\255lo)108 573.6 Q(wer)-.1 E (case\255v)-.18 E(ersion \(M\255A, M\255B, M\255)-.1 E F4(x)A F1 2.5(,.) -C(..\))-2.5 E F0 1.739(If the meta\214ed character)144 549.6 R F4(x) -4.239 E F0 1.739 -(is uppercase, run the command that is bound to the corresponding)4.239 -F(meta\214ed lo)144 561.6 Q(wercase character)-.25 E 5(.T)-.55 G +C(..\))-2.5 E F0 1.738(If the meta\214ed character)144 585.6 R F4(x) +4.238 E F0 1.739 +(is uppercase, run the command that is bound to the corresponding)4.238 +F(meta\214ed lo)144 597.6 Q(wercase character)-.25 E 5(.T)-.55 G (he beha)-5 E(vior is unde\214ned if)-.2 E F4(x)2.5 E F0(is already lo) -2.5 E(wercase.)-.25 E F1(pr)108 573.6 Q(e\214x\255meta \(ESC\))-.18 E F0 -(Metafy the ne)144 585.6 Q(xt character typed.)-.15 E F2(ESC)5 E F1(f) +2.5 E(wercase.)-.25 E F1(pr)108 609.6 Q(e\214x\255meta \(ESC\))-.18 E F0 +(Metafy the ne)144 621.6 Q(xt character typed.)-.15 E F2(ESC)5 E F1(f) 2.25 E F0(is equi)2.5 E -.25(va)-.25 G(lent to).25 E F1(Meta\255f)2.5 E -F0(.)A F1(undo \(C\255_, C\255x C\255u\))108 597.6 Q F0 -(Incremental undo, separately remembered for each line.)144 609.6 Q F1 --2.29 -.18(re v)108 621.6 T(ert\255line \(M\255r\)).08 E F0 .23 -(Undo all changes made to this line.)144 633.6 R .231(This is lik)5.23 F -2.731(ee)-.1 G -.15(xe)-2.881 G .231(cuting the).15 F F1(undo)2.731 E F0 -.231(command enough times to re-)2.731 F -(turn the line to its initial state.)144 645.6 Q F1 -(tilde\255expand \(M\255&\))108 657.6 Q F0(Perform tilde e)144 669.6 Q -(xpansion on the current w)-.15 E(ord.)-.1 E F1 -(set\255mark \(C\255@, M\255<space>\))108 681.6 Q F0 -(Set the mark to the point.)144 693.6 Q(If a numeric ar)5 E -(gument is supplied, the mark is set to that position.)-.18 E F1 -(exchange\255point\255and\255mark \(C\255x C\255x\))108 705.6 Q F0(Sw) -144 717.6 Q .283(ap the point with the mark.)-.1 F .283 -(The current cursor position is set to the sa)5.283 F -.15(ve)-.2 G -2.782(dp).15 G .282(osition, and the old)-2.782 F(cursor position is sa) -144 729.6 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E -(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(12)193.45 E 0 Cg EP +F0(.)A F1(undo \(C\255_, C\255x C\255u\))108 633.6 Q F0 +(Incremental undo, separately remembered for each line.)144 645.6 Q F1 +-2.29 -.18(re v)108 657.6 T(ert\255line \(M\255r\)).08 E F0 .231 +(Undo all changes made to this line.)144 669.6 R .231(This is lik)5.231 +F 2.731(ee)-.1 G -.15(xe)-2.881 G .23(cuting the).15 F F1(undo)2.73 E F0 +.23(command enough times to re-)2.73 F +(turn the line to its initial state.)144 681.6 Q F1 +(tilde\255expand \(M\255&\))108 693.6 Q F0(Perform tilde e)144 705.6 Q +(xpansion on the current w)-.15 E(ord.)-.1 E(GNU Readline 8.2)72 768 Q +(2022 August 12)127.345 E(12)192.055 E 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R (Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF -(character\255sear)108 84 Q(ch \(C\255]\))-.18 E F0 3.035(Ac)144 96 S -.535(haracter is read and point is mo)-3.035 F -.15(ve)-.15 G 3.035(dt) +(set\255mark \(C\255@, M\255<space>\))108 84 Q F0 +(Set the mark to the point.)144 96 Q(If a numeric ar)5 E +(gument is supplied, the mark is set to that position.)-.18 E F1 +(exchange\255point\255and\255mark \(C\255x C\255x\))108 108 Q F0(Sw)144 +120 Q .282(ap the point with the mark.)-.1 F .283 +(The current cursor position is set to the sa)5.283 F -.15(ve)-.2 G +2.783(dp).15 G .283(osition, and the old)-2.783 F(cursor position is sa) +144 132 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E F1 +(character\255sear)108 144 Q(ch \(C\255]\))-.18 E F0 3.036(Ac)144 156 S +.536(haracter is read and point is mo)-3.036 F -.15(ve)-.15 G 3.035(dt) .15 G 3.035(ot)-3.035 G .535(he ne)-3.035 F .535 -(xt occurrence of that character)-.15 F 5.536(.A)-.55 G(ne)-2.5 E -.05 -(ga)-.15 G(ti).05 E .836 -.15(ve c)-.25 H(ount).15 E(searches for pre) -144 108 Q(vious occurrences.)-.25 E F1(character\255sear)108 120 Q -(ch\255backward \(M\255C\255]\))-.18 E F0 3.544(Ac)144 132 S 1.044 -(haracter is read and point is mo)-3.544 F -.15(ve)-.15 G 3.544(dt).15 G +(xt occurrence of that character)-.15 F 5.535(.A)-.55 G(ne)-2.5 E -.05 +(ga)-.15 G(ti).05 E .835 -.15(ve c)-.25 H(ount).15 E(searches for pre) +144 168 Q(vious occurrences.)-.25 E F1(character\255sear)108 180 Q +(ch\255backward \(M\255C\255]\))-.18 E F0 3.543(Ac)144 192 S 1.043 +(haracter is read and point is mo)-3.543 F -.15(ve)-.15 G 3.544(dt).15 G 3.544(ot)-3.544 G 1.044(he pre)-3.544 F 1.044 -(vious occurrence of that character)-.25 F 6.043(.A)-.55 G(ne)-2.5 E +(vious occurrence of that character)-.25 F 6.044(.A)-.55 G(ne)-2.5 E -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G -(count searches for subsequent occurrences.)144 144 Q F1 -(skip\255csi\255sequence)108 156 Q F0 1.826 -(Read enough characters to consume a multi-k)144 168 R 2.126 -.15(ey s) --.1 H 1.827(equence such as those de\214ned for k).15 F -.15(ey)-.1 G -4.327(sl).15 G(ik)-4.327 E(e)-.1 E .791(Home and End.)144 180 R .791 -(Such sequences be)5.791 F .791 +(count searches for subsequent occurrences.)144 204 Q F1 +(skip\255csi\255sequence)108 216 Q F0 1.827 +(Read enough characters to consume a multi-k)144 228 R 2.126 -.15(ey s) +-.1 H 1.826(equence such as those de\214ned for k).15 F -.15(ey)-.1 G +4.326(sl).15 G(ik)-4.326 E(e)-.1 E .79(Home and End.)144 240 R .791 +(Such sequences be)5.79 F .791 (gin with a Control Sequence Indicator \(CSI\), usually ESC\255[.)-.15 F -.331(If this sequence is bound to "\\[", k)144 192 R -.15(ey)-.1 G 2.831 -(sp).15 G .331(roducing such sequences will ha)-2.831 F .632 -.15(ve n) --.2 H 2.832(oe).15 G -.25(ff)-2.832 G .332(ect unless e).25 F(xplic-) +.332(If this sequence is bound to "\\[", k)144 252 R -.15(ey)-.1 G 2.831 +(sp).15 G .331(roducing such sequences will ha)-2.831 F .631 -.15(ve n) +-.2 H 2.831(oe).15 G -.25(ff)-2.831 G .331(ect unless e).25 F(xplic-) -.15 E .026(itly bound to a readline command, instead of inserting stra\ -y characters into the editing b)144 204 R(uf)-.2 E(fer)-.25 E 5.026(.T) --.55 G(his)-5.026 E(is unbound by def)144 216 Q(ault, b)-.1 E +y characters into the editing b)144 264 R(uf)-.2 E(fer)-.25 E 5.026(.T) +-.55 G(his)-5.026 E(is unbound by def)144 276 Q(ault, b)-.1 E (ut usually bound to ESC\255[.)-.2 E F1(insert\255comment \(M\255#\))108 -228 Q F0 -.4(Wi)144 240 S .48(thout a numeric ar).4 F .48(gument, the v) --.18 F .481(alue of the readline)-.25 F F1(comment\255begin)2.981 E F0 --.25(va)2.981 G .481(riable is inserted at the).25 F(be)144 252 Q .245 -(ginning of the current line.)-.15 F .245(If a numeric ar)5.245 F .244 -(gument is supplied, this command acts as a toggle: if)-.18 F .321 -(the characters at the be)144 264 R .321 +288 Q F0 -.4(Wi)144 300 S .481(thout a numeric ar).4 F .481 +(gument, the v)-.18 F .481(alue of the readline)-.25 F F1 +(comment\255begin)2.981 E F0 -.25(va)2.981 G .48 +(riable is inserted at the).25 F(be)144 312 Q .244 +(ginning of the current line.)-.15 F .245(If a numeric ar)5.244 F .245 +(gument is supplied, this command acts as a toggle: if)-.18 F .322 +(the characters at the be)144 324 R .321 (ginning of the line do not match the v)-.15 F .321(alue of)-.25 F F1 -(comment\255begin)2.821 E F0 2.822(,t)C .322(he v)-2.822 F .322(alue is) --.25 F 1.014(inserted, otherwise the characters in)144 276 R F1 -(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.013 -(ginning of the line.)-.15 F 1.468 -(In either case, the line is accepted as if a ne)144 288 R 1.468 -(wline had been typed.)-.25 F 1.469(The def)6.469 F 1.469(ault v)-.1 F -1.469(alue of)-.25 F F1(com-)3.969 E(ment\255begin)144 300 Q F0(mak) -2.983 E .483(es the current line a shell comment.)-.1 F .483 -(If a numeric ar)5.483 F .482(gument causes the comment)-.18 F -(character to be remo)144 312 Q -.15(ve)-.15 G(d, the line will be e).15 -E -.15(xe)-.15 G(cuted by the shell.).15 E F1(dump\255functions)108 324 -Q F0 .626(Print all of the functions and their k)144 336 R .926 -.15 -(ey b)-.1 H .627(indings to the readline output stream.).15 F .627 -(If a numeric ar)5.627 F(gu-)-.18 E -(ment is supplied, the output is formatted in such a w)144 348 Q +(comment\255begin)2.821 E F0 2.821(,t)C .321(he v)-2.821 F .321(alue is) +-.25 F 1.013(inserted, otherwise the characters in)144 336 R F1 +(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.014 +(ginning of the line.)-.15 F 1.469 +(In either case, the line is accepted as if a ne)144 348 R 1.468 +(wline had been typed.)-.25 F 1.468(The def)6.468 F 1.468(ault v)-.1 F +1.468(alue of)-.25 F F1(com-)3.968 E(ment\255begin)144 360 Q F0(mak) +2.982 E .483(es the current line a shell comment.)-.1 F .483 +(If a numeric ar)5.483 F .483(gument causes the comment)-.18 F +(character to be remo)144 372 Q -.15(ve)-.15 G(d, the line will be e).15 +E -.15(xe)-.15 G(cuted by the shell.).15 E F1(dump\255functions)108 384 +Q F0 .627(Print all of the functions and their k)144 396 R .927 -.15 +(ey b)-.1 H .626(indings to the readline output stream.).15 F .626 +(If a numeric ar)5.626 F(gu-)-.18 E +(ment is supplied, the output is formatted in such a w)144 408 Q (ay that it can be made part of an)-.1 E/F2 10/Times-Italic@0 SF(inputr) -2.5 E(c)-.37 E F0(\214le.)2.5 E F1(dump\255v)108 360 Q(ariables)-.1 E F0 -.283(Print all of the settable v)144 372 R .283(ariables and their v) +2.5 E(c)-.37 E F0(\214le.)2.5 E F1(dump\255v)108 420 Q(ariables)-.1 E F0 +.283(Print all of the settable v)144 432 R .283(ariables and their v) -.25 F .283(alues to the readline output stream.)-.25 F .283 (If a numeric ar)5.283 F(gu-)-.18 E -(ment is supplied, the output is formatted in such a w)144 384 Q +(ment is supplied, the output is formatted in such a w)144 444 Q (ay that it can be made part of an)-.1 E F2(inputr)2.5 E(c)-.37 E F0 -(\214le.)2.5 E F1(dump\255macr)108 396 Q(os)-.18 E F0 .592 -(Print all of the readline k)144 408 R .892 -.15(ey s)-.1 H .592 -(equences bound to macros and the strings the).15 F 3.093(yo)-.15 G -3.093(utput. If)-3.093 F 3.093(an)3.093 G(umeric)-3.093 E(ar)144 420 Q +(\214le.)2.5 E F1(dump\255macr)108 456 Q(os)-.18 E F0 .593 +(Print all of the readline k)144 468 R .893 -.15(ey s)-.1 H .592 +(equences bound to macros and the strings the).15 F 3.092(yo)-.15 G +3.092(utput. If)-3.092 F 3.092(an)3.092 G(umeric)-3.092 E(ar)144 480 Q .528(gument is supplied, the output is formatted in such a w)-.18 F .528 -(ay that it can be made part of an)-.1 F F2(inputr)3.027 E(c)-.37 E F0 -(\214le.)144 432 Q F1(emacs\255editing\255mode \(C\255e\))108 444 Q F0 -(When in)144 456 Q F1(vi)2.5 E F0(command mode, this causes a switch to) +(ay that it can be made part of an)-.1 F F2(inputr)3.028 E(c)-.37 E F0 +(\214le.)144 492 Q F1(emacs\255editing\255mode \(C\255e\))108 504 Q F0 +(When in)144 516 Q F1(vi)2.5 E F0(command mode, this causes a switch to) 2.5 E F1(emacs)2.5 E F0(editing mode.)2.5 E F1 -(vi\255editing\255mode \(M\255C\255j\))108 468 Q F0(When in)144 480 Q F1 +(vi\255editing\255mode \(M\255C\255j\))108 528 Q F0(When in)144 540 Q F1 (emacs)2.5 E F0(editing mode, this causes a switch to)2.5 E F1(vi)2.5 E -F0(editing mode.)2.5 E/F3 10.95/Times-Bold@0 SF(DEF)72 496.8 Q -.548(AU) --.986 G 2.014 -1.007(LT K).548 H(EY BINDINGS)1.007 E F0 .064(The follo) -108 508.8 R .064(wing is a list of the def)-.25 F .064 -(ault emacs and vi bindings.)-.1 F .065 -(Characters with the eighth bit set are written as)5.065 F .527 -(M\255<character>, and are referred to as)108 520.8 R F2(meta\214ed) +F0(editing mode.)2.5 E/F3 10.95/Times-Bold@0 SF(DEF)72 556.8 Q -.548(AU) +-.986 G 2.014 -1.007(LT K).548 H(EY BINDINGS)1.007 E F0 .065(The follo) +108 568.8 R .065(wing is a list of the def)-.25 F .065 +(ault emacs and vi bindings.)-.1 F .064 +(Characters with the eighth bit set are written as)5.064 F .527 +(M\255<character>, and are referred to as)108 580.8 R F2(meta\214ed) 3.407 E F0 3.027(characters. The)3.797 F .527 -(printable ASCII characters not mentioned)3.027 F 1.115 -(in the list of emacs standard bindings are bound to the)108 532.8 R F1 -(self\255insert)3.615 E F0 1.116(function, which just inserts the gi) +(printable ASCII characters not mentioned)3.027 F 1.116 +(in the list of emacs standard bindings are bound to the)108 592.8 R F1 +(self\255insert)3.615 E F0 1.115(function, which just inserts the gi) 3.615 F -.15(ve)-.25 G(n).15 E .945(character into the input line.)108 -544.8 R .945(In vi insertion mode, all characters not speci\214cally me\ -ntioned are bound to)5.945 F F1(self\255insert)108 556.8 Q F0 5.337(.C)C -.337(haracters assigned to signal generation by)-5.337 F F2(stty)3.177 E -F0 .338(\(1\) or the terminal dri).32 F -.15(ve)-.25 G 1.138 -.4(r, s) -.15 H .338(uch as C-Z or C-C,).4 F .188(retain that function.)108 568.8 -R .188(Upper and lo)5.188 F .188(wer case meta\214ed characters are bou\ -nd to the same function in the emacs)-.25 F .304(mode meta k)108 580.8 R --.15(ey)-.1 G 2.804(map. The).15 F .305(remaining characters are unboun\ -d, which causes readline to ring the bell \(subject)2.804 F -(to the setting of the)108 592.8 Q F1(bell\255style)2.5 E F0 -.25(va)2.5 -G(riable\).).25 E F1(Emacs Mode)87 609.6 Q F0(Emacs Standard bindings) -151.2 621.6 Q 2.5("C-@" set-mark)151.2 645.6 R 2.5("C-A" be)151.2 657.6 -R(ginning-of-line)-.15 E 2.5("C-B" backw)151.2 669.6 R(ard-char)-.1 E -2.5("C-D" delete-char)151.2 681.6 R 2.5("C-E" end-of-line)151.2 693.6 R -2.5("C-F" forw)151.2 705.6 R(ard-char)-.1 E 2.5("C-G" abort)151.2 717.6 -R 2.5("C-H" backw)151.2 729.6 R(ard-delete-char)-.1 E(GNU Readline 8.2) -72 768 Q(2022 March 11)128.74 E(13)193.45 E 0 Cg EP +604.8 R .945(In vi insertion mode, all characters not speci\214cally me\ +ntioned are bound to)5.945 F F1(self\255insert)108 616.8 Q F0 5.338(.C)C +.338(haracters assigned to signal generation by)-5.338 F F2(stty)3.178 E +F0 .337(\(1\) or the terminal dri).32 F -.15(ve)-.25 G 1.137 -.4(r, s) +.15 H .337(uch as C-Z or C-C,).4 F .187(retain that function.)108 628.8 +R .187(Upper and lo)5.187 F .188(wer case meta\214ed characters are bou\ +nd to the same function in the emacs)-.25 F .305(mode meta k)108 640.8 R +-.15(ey)-.1 G 2.805(map. The).15 F .305(remaining characters are unboun\ +d, which causes readline to ring the bell \(subject)2.805 F +(to the setting of the)108 652.8 Q F1(bell\255style)2.5 E F0 -.25(va)2.5 +G(riable\).).25 E F1(Emacs Mode)87 669.6 Q F0(Emacs Standard bindings) +151.2 681.6 Q 2.5("C-@" set-mark)151.2 705.6 R 2.5("C-A" be)151.2 717.6 +R(ginning-of-line)-.15 E 2.5("C-B" backw)151.2 729.6 R(ard-char)-.1 E +(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(13)192.055 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-I" complete)151.2 -84 R 2.5("C-J" accept-line)151.2 96 R 2.5("C-K" kill-line)151.2 108 R -2.5("C-L" clear)151.2 120 R(-screen)-.2 E 2.5("C-M" accept-line)151.2 -132 R 2.5("C-N" ne)151.2 144 R(xt-history)-.15 E 2.5("C-P" pre)151.2 156 -R(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 168 R 2.5("C-R" re) -151.2 180 R -.15(ve)-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2 -192 R(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 204 R 2.5 -("C-U" unix-line-discard)151.2 216 R 2.5("C-V" quoted-insert)151.2 228 R -2.5("C-W" unix-w)151.2 240 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 252 R -2.5("C-]" character)151.2 264 R(-search)-.2 E 2.5("C-_" undo)151.2 276 R -3.333("")151.2 288 S(to "/")-.833 E(self-insert)5 E 2.5("0" to)151.2 300 -R 2.5("9" self-insert)2.5 F 2.5(":" to)151.2 312 R 2.5("~" self-insert) -2.5 F 2.5("C-?" backw)151.2 324 R(ard-delete-char)-.1 E -(Emacs Meta bindings)151.2 340.8 Q 2.5("M-C-G" abort)151.2 364.8 R 2.5 -("M-C-H" backw)151.2 376.8 R(ard-kill-w)-.1 E(ord)-.1 E 2.5 -("M-C-I" tab-insert)151.2 388.8 R 2.5("M-C-J" vi-editing-mode)151.2 -400.8 R 2.5("M-C-L" clear)151.2 412.8 R(-display)-.2 E 2.5 -("M-C-M" vi-editing-mode)151.2 424.8 R 2.5("M-C-R" re)151.2 436.8 R -.15 -(ve)-.25 G(rt-line).15 E 2.5("M-C-Y" yank-nth-ar)151.2 448.8 R(g)-.18 E -2.5("M-C-[" complete)151.2 460.8 R 2.5("M-C-]" character)151.2 472.8 R -(-search-backw)-.2 E(ard)-.1 E 2.5("M-space" set-mark)151.2 484.8 R 2.5 -("M-#" insert-comment)151.2 496.8 R 2.5("M-&" tilde-e)151.2 508.8 R -(xpand)-.15 E 2.5("M-*" insert-completions)151.2 520.8 R 2.5 -("M--" digit-ar)151.2 532.8 R(gument)-.18 E 2.5("M-." yank-last-ar)151.2 -544.8 R(g)-.18 E 2.5("M-0" digit-ar)151.2 556.8 R(gument)-.18 E 2.5 -("M-1" digit-ar)151.2 568.8 R(gument)-.18 E 2.5("M-2" digit-ar)151.2 -580.8 R(gument)-.18 E 2.5("M-3" digit-ar)151.2 592.8 R(gument)-.18 E 2.5 -("M-4" digit-ar)151.2 604.8 R(gument)-.18 E 2.5("M-5" digit-ar)151.2 -616.8 R(gument)-.18 E 2.5("M-6" digit-ar)151.2 628.8 R(gument)-.18 E 2.5 -("M-7" digit-ar)151.2 640.8 R(gument)-.18 E 2.5("M-8" digit-ar)151.2 -652.8 R(gument)-.18 E 2.5("M-9" digit-ar)151.2 664.8 R(gument)-.18 E 2.5 -("M-<" be)151.2 676.8 R(ginning-of-history)-.15 E 2.5 -("M-=" possible-completions)151.2 688.8 R 2.5("M->" end-of-history)151.2 -700.8 R 2.5("M-?" possible-completions)151.2 712.8 R 2.5("M-B" backw) -151.2 724.8 R(ard-w)-.1 E(ord)-.1 E(GNU Readline 8.2)72 768 Q -(2022 March 11)128.74 E(14)193.45 E 0 Cg EP +(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-D" delete-char) +151.2 84 R 2.5("C-E" end-of-line)151.2 96 R 2.5("C-F" forw)151.2 108 R +(ard-char)-.1 E 2.5("C-G" abort)151.2 120 R 2.5("C-H" backw)151.2 132 R +(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 144 R 2.5 +("C-J" accept-line)151.2 156 R 2.5("C-K" kill-line)151.2 168 R 2.5 +("C-L" clear)151.2 180 R(-screen)-.2 E 2.5("C-M" accept-line)151.2 192 R +2.5("C-N" ne)151.2 204 R(xt-history)-.15 E 2.5("C-P" pre)151.2 216 R +(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 228 R 2.5("C-R" re) +151.2 240 R -.15(ve)-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2 +252 R(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 264 R 2.5 +("C-U" unix-line-discard)151.2 276 R 2.5("C-V" quoted-insert)151.2 288 R +2.5("C-W" unix-w)151.2 300 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 312 R +2.5("C-]" character)151.2 324 R(-search)-.2 E 2.5("C-_" undo)151.2 336 R +3.333("")151.2 348 S(to "/")-.833 E(self-insert)5 E 2.5("0" to)151.2 360 +R 2.5("9" self-insert)2.5 F 2.5(":" to)151.2 372 R 2.5("~" self-insert) +2.5 F 2.5("C-?" backw)151.2 384 R(ard-delete-char)-.1 E +(Emacs Meta bindings)151.2 400.8 Q 2.5("M-C-G" abort)151.2 424.8 R 2.5 +("M-C-H" backw)151.2 436.8 R(ard-kill-w)-.1 E(ord)-.1 E 2.5 +("M-C-I" tab-insert)151.2 448.8 R 2.5("M-C-J" vi-editing-mode)151.2 +460.8 R 2.5("M-C-L" clear)151.2 472.8 R(-display)-.2 E 2.5 +("M-C-M" vi-editing-mode)151.2 484.8 R 2.5("M-C-R" re)151.2 496.8 R -.15 +(ve)-.25 G(rt-line).15 E 2.5("M-C-Y" yank-nth-ar)151.2 508.8 R(g)-.18 E +2.5("M-C-[" complete)151.2 520.8 R 2.5("M-C-]" character)151.2 532.8 R +(-search-backw)-.2 E(ard)-.1 E 2.5("M-space" set-mark)151.2 544.8 R 2.5 +("M-#" insert-comment)151.2 556.8 R 2.5("M-&" tilde-e)151.2 568.8 R +(xpand)-.15 E 2.5("M-*" insert-completions)151.2 580.8 R 2.5 +("M--" digit-ar)151.2 592.8 R(gument)-.18 E 2.5("M-." yank-last-ar)151.2 +604.8 R(g)-.18 E 2.5("M-0" digit-ar)151.2 616.8 R(gument)-.18 E 2.5 +("M-1" digit-ar)151.2 628.8 R(gument)-.18 E 2.5("M-2" digit-ar)151.2 +640.8 R(gument)-.18 E 2.5("M-3" digit-ar)151.2 652.8 R(gument)-.18 E 2.5 +("M-4" digit-ar)151.2 664.8 R(gument)-.18 E 2.5("M-5" digit-ar)151.2 +676.8 R(gument)-.18 E 2.5("M-6" digit-ar)151.2 688.8 R(gument)-.18 E 2.5 +("M-7" digit-ar)151.2 700.8 R(gument)-.18 E 2.5("M-8" digit-ar)151.2 +712.8 R(gument)-.18 E 2.5("M-9" digit-ar)151.2 724.8 R(gument)-.18 E +(GNU Readline 8.2)72 768 Q(2022 August 12)127.345 E(14)192.055 E 0 Cg EP %%Page: 15 15 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("M-C" capitalize-w) -151.2 84 R(ord)-.1 E 2.5("M-D" kill-w)151.2 96 R(ord)-.1 E 2.5 -("M-F" forw)151.2 108 R(ard-w)-.1 E(ord)-.1 E 2.5("M-L" do)151.2 120 R -(wncase-w)-.25 E(ord)-.1 E 2.5("M-N" non-incremental-forw)151.2 132 R -(ard-search-history)-.1 E 2.5("M-P" non-incremental-re)151.2 144 R -.15 -(ve)-.25 G(rse-search-history).15 E 2.5("M-R" re)151.2 156 R -.15(ve) --.25 G(rt-line).15 E 2.5("M-T" transpose-w)151.2 168 R(ords)-.1 E 2.5 -("M-U" upcase-w)151.2 180 R(ord)-.1 E 2.5("M-Y" yank-pop)151.2 192 R 2.5 -("M-\\" delete-horizontal-space)151.2 204 R 2.5("M-~" tilde-e)151.2 216 -R(xpand)-.15 E 2.5("M-C-?" backw)151.2 228 R(ard-kill-w)-.1 E(ord)-.1 E -2.5("M-_" yank-last-ar)151.2 240 R(g)-.18 E(Emacs Control-X bindings) -151.2 256.8 Q 2.5("C-XC-G" abort)151.2 280.8 R 2.5 -("C-XC-R" re-read-init-\214le)151.2 292.8 R 2.5("C-XC-U" undo)151.2 -304.8 R 2.5("C-XC-X" e)151.2 316.8 R(xchange-point-and-mark)-.15 E 2.5 -("C-X\(" start-kbd-macro)151.2 328.8 R 2.5("C-X\)" end-kbd-macro)151.2 -340.8 R 2.5("C-XE" call-last-kbd-macro)151.2 352.8 R 2.5("C-XC-?" backw) -151.2 364.8 R(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF -(VI Mode bindings)87 393.6 Q F0(VI Insert Mode functions)151.2 405.6 Q -2.5("C-D" vi-eof-maybe)151.2 429.6 R 2.5("C-H" backw)151.2 441.6 R -(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 453.6 R 2.5 -("C-J" accept-line)151.2 465.6 R 2.5("C-M" accept-line)151.2 477.6 R 2.5 -("C-R" re)151.2 489.6 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 -("C-S" forw)151.2 501.6 R(ard-search-history)-.1 E 2.5 -("C-T" transpose-chars)151.2 513.6 R 2.5("C-U" unix-line-discard)151.2 -525.6 R 2.5("C-V" quoted-insert)151.2 537.6 R 2.5("C-W" unix-w)151.2 -549.6 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 561.6 R 2.5("C-[" vi-mo) -151.2 573.6 R -.15(ve)-.15 G(ment-mode).15 E 2.5("C-_" undo)151.2 585.6 -R 3.333("")151.2 597.6 S(to "~")-.833 E(self-insert)5 E 2.5("C-?" backw) -151.2 609.6 R(ard-delete-char)-.1 E(VI Command Mode functions)151.2 -626.4 Q 2.5("C-D" vi-eof-maybe)151.2 650.4 R 2.5 -("C-E" emacs-editing-mode)151.2 662.4 R 2.5("C-G" abort)151.2 674.4 R -2.5("C-H" backw)151.2 686.4 R(ard-char)-.1 E 2.5("C-J" accept-line)151.2 -698.4 R 2.5("C-K" kill-line)151.2 710.4 R 2.5("C-L" clear)151.2 722.4 R -(-screen)-.2 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(15) -193.45 E 0 Cg EP +(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("M-<" be)151.2 84 R +(ginning-of-history)-.15 E 2.5("M-=" possible-completions)151.2 96 R 2.5 +("M->" end-of-history)151.2 108 R 2.5("M-?" possible-completions)151.2 +120 R 2.5("M-B" backw)151.2 132 R(ard-w)-.1 E(ord)-.1 E 2.5 +("M-C" capitalize-w)151.2 144 R(ord)-.1 E 2.5("M-D" kill-w)151.2 156 R +(ord)-.1 E 2.5("M-F" forw)151.2 168 R(ard-w)-.1 E(ord)-.1 E 2.5 +("M-L" do)151.2 180 R(wncase-w)-.25 E(ord)-.1 E 2.5 +("M-N" non-incremental-forw)151.2 192 R(ard-search-history)-.1 E 2.5 +("M-P" non-incremental-re)151.2 204 R -.15(ve)-.25 G(rse-search-history) +.15 E 2.5("M-R" re)151.2 216 R -.15(ve)-.25 G(rt-line).15 E 2.5 +("M-T" transpose-w)151.2 228 R(ords)-.1 E 2.5("M-U" upcase-w)151.2 240 R +(ord)-.1 E 2.5("M-Y" yank-pop)151.2 252 R 2.5 +("M-\\" delete-horizontal-space)151.2 264 R 2.5("M-~" tilde-e)151.2 276 +R(xpand)-.15 E 2.5("M-C-?" backw)151.2 288 R(ard-kill-w)-.1 E(ord)-.1 E +2.5("M-_" yank-last-ar)151.2 300 R(g)-.18 E(Emacs Control-X bindings) +151.2 316.8 Q 2.5("C-XC-G" abort)151.2 340.8 R 2.5 +("C-XC-R" re-read-init-\214le)151.2 352.8 R 2.5("C-XC-U" undo)151.2 +364.8 R 2.5("C-XC-X" e)151.2 376.8 R(xchange-point-and-mark)-.15 E 2.5 +("C-X\(" start-kbd-macro)151.2 388.8 R 2.5("C-X\)" end-kbd-macro)151.2 +400.8 R 2.5("C-XE" call-last-kbd-macro)151.2 412.8 R 2.5("C-XC-?" backw) +151.2 424.8 R(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF +(VI Mode bindings)87 453.6 Q F0(VI Insert Mode functions)151.2 465.6 Q +2.5("C-D" vi-eof-maybe)151.2 489.6 R 2.5("C-H" backw)151.2 501.6 R +(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 513.6 R 2.5 +("C-J" accept-line)151.2 525.6 R 2.5("C-M" accept-line)151.2 537.6 R 2.5 +("C-R" re)151.2 549.6 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 +("C-S" forw)151.2 561.6 R(ard-search-history)-.1 E 2.5 +("C-T" transpose-chars)151.2 573.6 R 2.5("C-U" unix-line-discard)151.2 +585.6 R 2.5("C-V" quoted-insert)151.2 597.6 R 2.5("C-W" unix-w)151.2 +609.6 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 621.6 R 2.5("C-[" vi-mo) +151.2 633.6 R -.15(ve)-.15 G(ment-mode).15 E 2.5("C-_" undo)151.2 645.6 +R 3.333("")151.2 657.6 S(to "~")-.833 E(self-insert)5 E 2.5("C-?" backw) +151.2 669.6 R(ard-delete-char)-.1 E(VI Command Mode functions)151.2 +686.4 Q 2.5("C-D" vi-eof-maybe)151.2 710.4 R 2.5 +("C-E" emacs-editing-mode)151.2 722.4 R(GNU Readline 8.2)72 768 Q +(2022 August 12)127.345 E(15)192.055 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-M" accept-line) -151.2 84 R 2.5("C-N" ne)151.2 96 R(xt-history)-.15 E 2.5("C-P" pre)151.2 -108 R(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 120 R 2.5 -("C-R" re)151.2 132 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 -("C-S" forw)151.2 144 R(ard-search-history)-.1 E 2.5 -("C-T" transpose-chars)151.2 156 R 2.5("C-U" unix-line-discard)151.2 168 -R 2.5("C-V" quoted-insert)151.2 180 R 2.5("C-W" unix-w)151.2 192 R -(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 204 R 2.5("C-_" vi-undo)151.2 216 -R -4.166 3.333("" f)151.2 228 T(orw)-3.333 E(ard-char)-.1 E 2.5 -("#" insert-comment)151.2 240 R 2.5("$" end-of-line)151.2 252 R 2.5 -("%" vi-match)151.2 264 R 2.5("&" vi-tilde-e)151.2 276 R(xpand)-.15 E -2.5("*" vi-complete)151.2 288 R 2.5("+" ne)151.2 300 R(xt-history)-.15 E -2.5("," vi-char)151.2 312 R(-search)-.2 E 2.5("-" pre)151.2 324 R -(vious-history)-.25 E 2.5("." vi-redo)151.2 336 R 2.5("/" vi-search) -151.2 348 R 2.5("0" be)151.2 360 R(ginning-of-line)-.15 E("1" to "9") -151.2 372 Q(vi-ar)5 E(g-digit)-.18 E 2.5(";" vi-char)151.2 384 R -(-search)-.2 E 2.5("=" vi-complete)151.2 396 R 2.5("?" vi-search)151.2 -408 R 2.5("A" vi-append-eol)151.2 420 R 2.5("B" vi-pre)151.2 432 R(v-w) --.25 E(ord)-.1 E 2.5("C" vi-change-to)151.2 444 R 2.5("D" vi-delete-to) -151.2 456 R 2.5("E" vi-end-w)151.2 468 R(ord)-.1 E 2.5("F" vi-char)151.2 -480 R(-search)-.2 E 2.5("G" vi-fetch-history)151.2 492 R 2.5 -("I" vi-insert-be)151.2 504 R(g)-.15 E 2.5("N" vi-search-ag)151.2 516 R -(ain)-.05 E 2.5("P" vi-put)151.2 528 R 2.5("R" vi-replace)151.2 540 R -2.5("S" vi-subst)151.2 552 R 2.5("T" vi-char)151.2 564 R(-search)-.2 E -2.5("U" re)151.2 576 R -.15(ve)-.25 G(rt-line).15 E 2.5("W" vi-ne)151.2 -588 R(xt-w)-.15 E(ord)-.1 E 2.5("X" backw)151.2 600 R(ard-delete-char) --.1 E 2.5("Y" vi-yank-to)151.2 612 R 2.5("\\" vi-complete)151.2 624 R -2.5("^" vi-\214rst-print)151.2 636 R 2.5("_" vi-yank-ar)151.2 648 R(g) --.18 E 2.5("`" vi-goto-mark)151.2 660 R 2.5("a" vi-append-mode)151.2 672 -R 2.5("b" vi-pre)151.2 684 R(v-w)-.25 E(ord)-.1 E 2.5("c" vi-change-to) -151.2 696 R 2.5("d" vi-delete-to)151.2 708 R 2.5("e" vi-end-w)151.2 720 -R(ord)-.1 E(GNU Readline 8.2)72 768 Q(2022 March 11)128.74 E(16)193.45 E -0 Cg EP +(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-G" abort)151.2 84 +R 2.5("C-H" backw)151.2 96 R(ard-char)-.1 E 2.5("C-J" accept-line)151.2 +108 R 2.5("C-K" kill-line)151.2 120 R 2.5("C-L" clear)151.2 132 R +(-screen)-.2 E 2.5("C-M" accept-line)151.2 144 R 2.5("C-N" ne)151.2 156 +R(xt-history)-.15 E 2.5("C-P" pre)151.2 168 R(vious-history)-.25 E 2.5 +("C-Q" quoted-insert)151.2 180 R 2.5("C-R" re)151.2 192 R -.15(ve)-.25 G +(rse-search-history).15 E 2.5("C-S" forw)151.2 204 R(ard-search-history) +-.1 E 2.5("C-T" transpose-chars)151.2 216 R 2.5("C-U" unix-line-discard) +151.2 228 R 2.5("C-V" quoted-insert)151.2 240 R 2.5("C-W" unix-w)151.2 +252 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 264 R 2.5("C-_" vi-undo) +151.2 276 R -4.166 3.333("" f)151.2 288 T(orw)-3.333 E(ard-char)-.1 E +2.5("#" insert-comment)151.2 300 R 2.5("$" end-of-line)151.2 312 R 2.5 +("%" vi-match)151.2 324 R 2.5("&" vi-tilde-e)151.2 336 R(xpand)-.15 E +2.5("*" vi-complete)151.2 348 R 2.5("+" ne)151.2 360 R(xt-history)-.15 E +2.5("," vi-char)151.2 372 R(-search)-.2 E 2.5("-" pre)151.2 384 R +(vious-history)-.25 E 2.5("." vi-redo)151.2 396 R 2.5("/" vi-search) +151.2 408 R 2.5("0" be)151.2 420 R(ginning-of-line)-.15 E("1" to "9") +151.2 432 Q(vi-ar)5 E(g-digit)-.18 E 2.5(";" vi-char)151.2 444 R +(-search)-.2 E 2.5("=" vi-complete)151.2 456 R 2.5("?" vi-search)151.2 +468 R 2.5("A" vi-append-eol)151.2 480 R 2.5("B" vi-pre)151.2 492 R(v-w) +-.25 E(ord)-.1 E 2.5("C" vi-change-to)151.2 504 R 2.5("D" vi-delete-to) +151.2 516 R 2.5("E" vi-end-w)151.2 528 R(ord)-.1 E 2.5("F" vi-char)151.2 +540 R(-search)-.2 E 2.5("G" vi-fetch-history)151.2 552 R 2.5 +("I" vi-insert-be)151.2 564 R(g)-.15 E 2.5("N" vi-search-ag)151.2 576 R +(ain)-.05 E 2.5("P" vi-put)151.2 588 R 2.5("R" vi-replace)151.2 600 R +2.5("S" vi-subst)151.2 612 R 2.5("T" vi-char)151.2 624 R(-search)-.2 E +2.5("U" re)151.2 636 R -.15(ve)-.25 G(rt-line).15 E 2.5("W" vi-ne)151.2 +648 R(xt-w)-.15 E(ord)-.1 E 2.5("X" backw)151.2 660 R(ard-delete-char) +-.1 E 2.5("Y" vi-yank-to)151.2 672 R 2.5("\\" vi-complete)151.2 684 R +2.5("^" vi-\214rst-print)151.2 696 R 2.5("_" vi-yank-ar)151.2 708 R(g) +-.18 E 2.5("`" vi-goto-mark)151.2 720 R(GNU Readline 8.2)72 768 Q +(2022 August 12)127.345 E(16)192.055 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R -(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("f" vi-char)151.2 84 -R(-search)-.2 E 2.5("h" backw)151.2 96 R(ard-char)-.1 E 2.5 -("i" vi-insertion-mode)151.2 108 R 2.5("j" ne)151.2 120 R(xt-history) --.15 E 2.5("k" pre)151.2 132 R(v-history)-.25 E 2.5("l" forw)151.2 144 R -(ard-char)-.1 E 2.5("m" vi-set-mark)151.2 156 R 2.5("n" vi-search-ag) -151.2 168 R(ain)-.05 E 2.5("p" vi-put)151.2 180 R 2.5 -("r" vi-change-char)151.2 192 R 2.5("s" vi-subst)151.2 204 R 2.5 -("t" vi-char)151.2 216 R(-search)-.2 E 2.5("u" vi-undo)151.2 228 R 2.5 -("w" vi-ne)151.2 240 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2 252 -R 2.5("y" vi-yank-to)151.2 264 R 2.5("|" vi-column)151.2 276 R 2.5 -("~" vi-change-case)151.2 288 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 -304.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 316.8 Q(ary) +(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("a" vi-append-mode) +151.2 84 R 2.5("b" vi-pre)151.2 96 R(v-w)-.25 E(ord)-.1 E 2.5 +("c" vi-change-to)151.2 108 R 2.5("d" vi-delete-to)151.2 120 R 2.5 +("e" vi-end-w)151.2 132 R(ord)-.1 E 2.5("f" vi-char)151.2 144 R(-search) +-.2 E 2.5("h" backw)151.2 156 R(ard-char)-.1 E 2.5 +("i" vi-insertion-mode)151.2 168 R 2.5("j" ne)151.2 180 R(xt-history) +-.15 E 2.5("k" pre)151.2 192 R(v-history)-.25 E 2.5("l" forw)151.2 204 R +(ard-char)-.1 E 2.5("m" vi-set-mark)151.2 216 R 2.5("n" vi-search-ag) +151.2 228 R(ain)-.05 E 2.5("p" vi-put)151.2 240 R 2.5 +("r" vi-change-char)151.2 252 R 2.5("s" vi-subst)151.2 264 R 2.5 +("t" vi-char)151.2 276 R(-search)-.2 E 2.5("u" vi-undo)151.2 288 R 2.5 +("w" vi-ne)151.2 300 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2 312 +R 2.5("y" vi-yank-to)151.2 324 R 2.5("|" vi-column)151.2 336 R 2.5 +("~" vi-change-case)151.2 348 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 +364.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 376.8 Q(ary) -.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F2 -(The Gnu History Libr)108 328.8 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E -(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 340.8 Q F0(\(1\))A F1 -(FILES)72 357.6 Q F2(~/.inputr)109.666 369.6 Q(c)-.37 E F0(Indi)144 -381.6 Q(vidual)-.25 E/F3 10/Times-Bold@0 SF -.18(re)2.5 G(adline).18 E -F0(initialization \214le)2.5 E F1 -.548(AU)72 398.4 S(THORS).548 E F0 -(Brian F)108 410.4 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E -(bfox@gnu.or)108 422.4 Q(g)-.18 E(Chet Rame)108 439.2 Q 1.3 -.65(y, C) +(The Gnu History Libr)108 388.8 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E +(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 400.8 Q F0(\(1\))A F1 +(FILES)72 417.6 Q F2(~/.inputr)109.666 429.6 Q(c)-.37 E F0(Indi)144 +441.6 Q(vidual)-.25 E/F3 10/Times-Bold@0 SF -.18(re)2.5 G(adline).18 E +F0(initialization \214le)2.5 E F1 -.548(AU)72 458.4 S(THORS).548 E F0 +(Brian F)108 470.4 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E +(bfox@gnu.or)108 482.4 Q(g)-.18 E(Chet Rame)108 499.2 Q 1.3 -.65(y, C) -.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve) --.25 G(rsity).15 E(chet.rame)108 451.2 Q(y@case.edu)-.15 E F1 -.11(BU)72 -468 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .691(If you \214nd a b) -108 480 R .691(ug in)-.2 F F3 -.18(re)3.191 G(adline,).18 E F0 .691 -(you should report it.)3.191 F .69(But \214rst, you should mak)5.69 F -3.19(es)-.1 G .69(ure that it really is a b)-3.19 F(ug,)-.2 E -(and that it appears in the latest v)108 492 Q(ersion of the)-.15 E F3 +-.25 G(rsity).15 E(chet.rame)108 511.2 Q(y@case.edu)-.15 E F1 -.11(BU)72 +528 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .69(If you \214nd a b) +108 540 R .69(ug in)-.2 F F3 -.18(re)3.19 G(adline,).18 E F0 .69 +(you should report it.)3.19 F .691(But \214rst, you should mak)5.69 F +3.191(es)-.1 G .691(ure that it really is a b)-3.191 F(ug,)-.2 E +(and that it appears in the latest v)108 552 Q(ersion of the)-.15 E F3 -.18(re)2.5 G(adline).18 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.) -.15 E .704(Once you ha)108 508.8 R 1.004 -.15(ve d)-.2 H .704 +.15 E .705(Once you ha)108 568.8 R 1.005 -.15(ve d)-.2 H .705 (etermined that a b).15 F .704(ug actually e)-.2 F .704(xists, mail a b) --.15 F .705(ug report to)-.2 F F2 -.2(bu)3.205 G(g\255r).2 E(eadline) --.37 E F0(@)A F2(gnu.or)A(g)-.37 E F0 5.705(.I)C 3.205(fy)-5.705 G(ou) --3.205 E(ha)108 520.8 Q 1.81 -.15(ve a \214)-.2 H 1.51 -(x, you are welcome to mail that as well!).15 F 1.509 -(Suggestions and `philosophical' b)6.509 F 1.509(ug reports may be)-.2 F -(mailed to)108 532.8 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2 +-.15 F .704(ug report to)-.2 F F2 -.2(bu)3.204 G(g\255r).2 E(eadline) +-.37 E F0(@)A F2(gnu.or)A(g)-.37 E F0 5.704(.I)C 3.204(fy)-5.704 G(ou) +-3.204 E(ha)108 580.8 Q 1.809 -.15(ve a \214)-.2 H 1.509 +(x, you are welcome to mail that as well!).15 F 1.51 +(Suggestions and `philosophical' b)6.51 F 1.51(ug reports may be)-.2 F +(mailed to)108 592.8 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2 (gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F3 -(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 549.6 Q +(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 609.6 Q (ug reports concerning this manual page should be directed to)-.2 E F2 -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E -F1 -.11(BU)72 566.4 S(GS).11 E F0(It')108 578.4 Q 2.5(st)-.55 G +F1 -.11(BU)72 626.4 S(GS).11 E F0(It')108 638.4 Q 2.5(st)-.55 G (oo big and too slo)-2.5 E -.65(w.)-.25 G(GNU Readline 8.2)72 768 Q -(2022 March 11)128.74 E(17)193.45 E 0 Cg EP +(2022 August 12)127.345 E(17)192.055 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/rltech.texi b/doc/rltech.texi index fe64a42..95a57b6 100644 --- a/doc/rltech.texi +++ b/doc/rltech.texi @@ -1184,7 +1184,7 @@ Returns the old timeout value. @deftypefun int rl_set_timeout (unsigned int secs, unsigned int usecs) Set a timeout for subsequent calls to @code{readline()}. If Readline does not read a complete line, or the number of characters specified by -@code{rl_num_chars_to_read}, before the duration specfied by @var{secs} +@code{rl_num_chars_to_read}, before the duration specified by @var{secs} (in seconds) and @var{usecs} (microseconds), it returns and sets @code{RL_STATE_TIMEOUT} in @code{rl_readline_state}. Passing 0 for @code{secs} and @code{usecs} cancels any previously set diff --git a/doc/rluser.texi b/doc/rluser.texi index 4a4cee4..fbe503e 100644 --- a/doc/rluser.texi +++ b/doc/rluser.texi @@ -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 @@ -845,7 +852,7 @@ to a string that is inserted when the key is pressed (a @var{macro}). @ifset BashFeatures The @w{@code{bind -p}} 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. @xref{Bash Builtins}. @end ifset diff --git a/doc/rluserman.dvi b/doc/rluserman.dvi Binary files differindex 0136595..1d9a734 100644 --- a/doc/rluserman.dvi +++ b/doc/rluserman.dvi diff --git a/doc/rluserman.html b/doc/rluserman.html index 1323303..4d54100 100644 --- a/doc/rluserman.html +++ b/doc/rluserman.html @@ -4,7 +4,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual describes the end user interface of the GNU Readline Library -(version 8.2, 11 March 2022), a library which aids in the +(version 8.2, 12 August 2022), a library which aids in the consistency of user interface across discrete programs which provide a command line interface. @@ -644,9 +644,12 @@ The default limit is <code>100</code>. <dd><p>If set to ‘<samp>on</samp>’, 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 ‘<samp>on</samp>’, but +meta-prefixed key sequence. +The default value is ‘<samp>on</samp>’, but will be set to ‘<samp>off</samp>’ 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'> ¶</a></span></dt> @@ -758,6 +761,8 @@ regardless of what the terminal claims it can support. The default value is ‘<samp>off</samp>’, but Readline will set it to ‘<samp>on</samp>’ 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'> ¶</a></span></dt> @@ -842,6 +847,8 @@ eighth bit set directly rather than as a meta-prefixed escape sequence. The default is ‘<samp>off</samp>’, but Readline will set it to ‘<samp>on</samp>’ 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'> ¶</a></span></dt> diff --git a/doc/rluserman.info b/doc/rluserman.info index 953890b..e13bd99 100644 --- a/doc/rluserman.info +++ b/doc/rluserman.info @@ -2,8 +2,8 @@ This is rluserman.info, produced by makeinfo version 6.8 from rluserman.texi. This manual describes the end user interface of the GNU Readline Library -(version 8.2, 11 March 2022), a library which aids in the consistency of -user interface across discrete programs which provide a command line +(version 8.2, 12 August 2022), a library which aids in the consistency +of user interface across discrete programs which provide a command line interface. Copyright (C) 1988-2022 Free Software Foundation, Inc. @@ -467,7 +467,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. @@ -562,7 +564,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 @@ -627,7 +631,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 @@ -2047,30 +2053,30 @@ their use in free software. Tag Table: -Node: Top905 -Node: Command Line Editing1427 -Node: Introduction and Notation2081 -Node: Readline Interaction3706 -Node: Readline Bare Essentials4899 -Node: Readline Movement Commands6684 -Node: Readline Killing Commands7646 -Node: Readline Arguments9566 -Node: Searching10612 -Node: Readline Init File12766 -Node: Readline Init File Syntax13923 -Node: Conditional Init Constructs36843 -Node: Sample Init File41041 -Node: Bindable Readline Commands44167 -Node: Commands For Moving45223 -Node: Commands For History46983 -Node: Commands For Text51948 -Node: Commands For Killing55652 -Node: Numeric Arguments58367 -Node: Commands For Completion59508 -Node: Keyboard Macros61478 -Node: Miscellaneous Commands62167 -Node: Readline vi Mode66090 -Node: GNU Free Documentation License67004 +Node: Top906 +Node: Command Line Editing1428 +Node: Introduction and Notation2082 +Node: Readline Interaction3707 +Node: Readline Bare Essentials4900 +Node: Readline Movement Commands6685 +Node: Readline Killing Commands7647 +Node: Readline Arguments9567 +Node: Searching10613 +Node: Readline Init File12767 +Node: Readline Init File Syntax13924 +Node: Conditional Init Constructs37216 +Node: Sample Init File41414 +Node: Bindable Readline Commands44540 +Node: Commands For Moving45596 +Node: Commands For History47356 +Node: Commands For Text52321 +Node: Commands For Killing56025 +Node: Numeric Arguments58740 +Node: Commands For Completion59881 +Node: Keyboard Macros61851 +Node: Miscellaneous Commands62540 +Node: Readline vi Mode66463 +Node: GNU Free Documentation License67377 End Tag Table diff --git a/doc/rluserman.pdf b/doc/rluserman.pdf Binary files differindex ec31b59..6b0f5fa 100644 --- a/doc/rluserman.pdf +++ b/doc/rluserman.pdf diff --git a/doc/rluserman.ps b/doc/rluserman.ps index 4256a5a..b9741c9 100644 --- a/doc/rluserman.ps +++ b/doc/rluserman.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 2022.1 (TeX Live 2022) Copyright 2022 Radical Eye Software %%Title: rluserman.dvi -%%CreationDate: Tue Jun 14 14:48:26 2022 +%%CreationDate: Fri Aug 19 18:34:37 2022 %%Pages: 36 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o rluserman.ps rluserman.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2022.06.14:1048 +%DVIPSSource: TeX output 2022.08.19:1434 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -5213,7 +5213,7 @@ ifelse TeXDict begin 1 0 bop 150 1318 a Fp(GNU)65 b(Readline)g(Library)g(User) g(In)-5 b(terface)p 150 1418 3600 34 v 1873 1515 a Fo(Edition)30 b(8.2,)i(for)e Fn(Readline)e(Library)h Fo(V)-8 b(ersion)31 -b(8.2.)3285 1623 y(Marc)m(h)g(2022)150 4927 y Fm(Chet)45 +b(8.2.)3252 1623 y(August)f(2022)150 4927 y Fm(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l (ersit)l(y)150 5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11 b(oundation)p 150 5141 @@ -5221,9 +5221,9 @@ b(ree)45 b(Soft)l(w)l(are)h(F)-11 b(oundation)p 150 5141 %%Page: 2 2 TeXDict begin 2 1 bop 150 4413 a Fo(This)38 b(man)m(ual)h(describ)s(es) f(the)h(end)f(user)g(in)m(terface)i(of)f(the)g(GNU)g(Readline)g -(Library)f(\(v)m(ersion)i(8.2,)150 4523 y(11)g(Marc)m(h)g(2022\),)k(a) -39 b(library)g(whic)m(h)g(aids)g(in)g(the)g(consistency)h(of)f(user)g -(in)m(terface)i(across)e(discrete)150 4633 y(programs)30 +(Library)f(\(v)m(ersion)i(8.2,)150 4523 y(12)e(August)e(2022\),)41 +b(a)c(library)g(whic)m(h)f(aids)h(in)g(the)g(consistency)g(of)g(user)f +(in)m(terface)j(across)e(discrete)150 4633 y(programs)30 b(whic)m(h)g(pro)m(vide)h(a)f(command)g(line)h(in)m(terface.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767 y Fl(\015)f Fo(1988{2022)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8 @@ -5715,64 +5715,67 @@ g(p)s(ossible)f(completions)h(using)f(di\013eren)m(t)1110 b(The)38 b(color)j(de\014nitions)d(are)i(tak)m(en)1110 628 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g Fn(LS_COLORS)d Fo(en)m(vironmen)m(t)j(v)-5 b(ariable.)40 b(The)24 b(default)1110 -737 y(is)30 b(`)p Fn(off)p Fo('.)630 941 y Fn(comment-begin)1110 -1050 y Fo(The)62 b(string)g(to)h(insert)f(at)h(the)g(b)s(eginning)e(of) -h(the)h(line)f(when)g(the)1110 1160 y Fn(insert-comment)26 +737 y(is)30 b(`)p Fn(off)p Fo('.)630 925 y Fn(comment-begin)1110 +1035 y Fo(The)62 b(string)g(to)h(insert)f(at)h(the)g(b)s(eginning)e(of) +h(the)h(line)f(when)g(the)1110 1144 y Fn(insert-comment)26 b Fo(command)31 b(is)f(executed.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)f Fn("#")p Fo(.)630 1363 y Fn(completion-display-width) -1110 1473 y Fo(The)41 b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used) -g(to)h(displa)m(y)g(p)s(ossible)f(matc)m(hes)1110 1583 +b(alue)31 b(is)f Fn("#")p Fo(.)630 1332 y Fn(completion-display-width) +1110 1442 y Fo(The)41 b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used) +g(to)h(displa)m(y)g(p)s(ossible)f(matc)m(hes)1110 1551 y(when)28 b(p)s(erforming)g(completion.)41 b(The)29 b(v)-5 b(alue)29 b(is)g(ignored)g(if)g(it)h(is)f(less)g(than)1110 -1692 y(0)e(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39 +1661 y(0)e(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39 b(A)26 b(v)-5 b(alue)27 b(of)f(0)h(will)f(cause)1110 -1802 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e +1771 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e (line.)41 b(The)30 b(default)h(v)-5 b(alue)31 b(is)f(-1.)630 -2005 y Fn(completion-ignore-case)1110 2115 y Fo(If)d(set)h(to)g(`)p +1958 y Fn(completion-ignore-case)1110 2068 y Fo(If)d(set)h(to)g(`)p Fn(on)p Fo(',)g(Readline)g(p)s(erforms)e(\014lename)h(matc)m(hing)i -(and)e(completion)1110 2225 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) +(and)e(completion)1110 2178 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) 40 b(The)30 b(default)h(v)-5 b(alue)30 b(is)h(`)p Fn(off)p -Fo('.)630 2428 y Fn(completion-map-case)1110 2538 y Fo(If)22 +Fo('.)630 2365 y Fn(completion-map-case)1110 2475 y Fo(If)22 b(set)g(to)h(`)p Fn(on)p Fo(',)h(and)e Fe(completion-ignore-case)31 -b Fo(is)22 b(enabled,)i(Readline)f(treats)1110 2647 y(h)m(yphens)29 +b Fo(is)22 b(enabled,)i(Readline)f(treats)1110 2585 y(h)m(yphens)29 b(\(`)p Fn(-)p Fo('\))j(and)e(underscores)g(\(`)p Fn(_)p Fo('\))i(as)f(equiv)-5 b(alen)m(t)32 b(when)e(p)s(erforming)1110 -2757 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f -(completion.)85 b(The)44 b(default)1110 2866 y(v)-5 b(alue)31 -b(is)f(`)p Fn(off)p Fo('.)630 3070 y Fn(completion-prefix-displa)o -(y-le)o(ngth)1110 3180 y Fo(The)h(length)g(in)g(c)m(haracters)i(of)f +2694 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f +(completion.)85 b(The)44 b(default)1110 2804 y(v)-5 b(alue)31 +b(is)f(`)p Fn(off)p Fo('.)630 2992 y Fn(completion-prefix-displa)o +(y-le)o(ngth)1110 3101 y Fo(The)h(length)g(in)g(c)m(haracters)i(of)f (the)f(common)h(pre\014x)e(of)h(a)h(list)g(of)f(p)s(ossible)1110 -3289 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s -(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3399 +3211 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s +(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3320 y(v)-5 b(alue)26 b(greater)h(than)e(zero,)j(common)e(pre\014xes)e -(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3508 +(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3430 y(replaced)k(with)f(an)g(ellipsis)h(when)e(displa)m(ying)i(p)s(ossible) -f(completions.)630 3712 y Fn(completion-query-items)1110 -3821 y Fo(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h -(that)g(determines)f(when)f(the)i(user)1110 3931 y(is)43 +f(completions.)630 3618 y Fn(completion-query-items)1110 +3727 y Fo(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h +(that)g(determines)f(when)f(the)i(user)1110 3837 y(is)43 b(ask)m(ed)g(whether)f(the)g(list)h(of)g(p)s(ossibilities)g(should)f(b) -s(e)g(displa)m(y)m(ed.)77 b(If)1110 4041 y(the)29 b(n)m(um)m(b)s(er)f +s(e)g(displa)m(y)m(ed.)77 b(If)1110 3947 y(the)29 b(n)m(um)m(b)s(er)f (of)h(p)s(ossible)g(completions)h(is)f(greater)h(than)f(or)g(equal)g -(to)h(this)1110 4150 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g +(to)h(this)1110 4056 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g (whether)f(or)h(not)g(the)g(user)f(wishes)g(to)i(view)1110 -4260 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 +4166 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 b(This)31 b(v)-5 b(ariable)33 b(m)m(ust)e(b)s(e)g(set)1110 -4369 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g +4275 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g (equal)g(to)h(zero.)76 b(A)42 b(zero)g(v)-5 b(alue)1110 -4479 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46 +4385 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 -4589 y(zero.)g(The)29 b(default)i(limit)g(is)g Fn(100)p -Fo(.)630 4792 y Fn(convert-meta)1110 4902 y Fo(If)22 +4495 y(zero.)g(The)29 b(default)i(limit)g(is)g Fn(100)p +Fo(.)630 4682 y Fn(convert-meta)1110 4792 y Fo(If)22 b(set)g(to)h(`)p Fn(on)p Fo(',)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 -5011 y(to)33 b(an)e Fh(asci)r(i)h Fo(k)m(ey)h(sequence)f(b)m(y)g +4902 y(to)33 b(an)e Fh(asci)r(i)h Fo(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 -5121 y(an)24 b Fn(ESC)g Fo(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 5230 +5011 y(an)24 b Fn(ESC)g Fo(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 5121 y(The)i(default)h(v)-5 b(alue)28 b(is)f(`)p Fn(on)p Fo(',)i(but)d(will) i(b)s(e)f(set)h(to)g(`)p Fn(off)p Fo(')g(if)f(the)h(lo)s(cale)h(is)f -(one)1110 5340 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)p -eop end +(one)1110 5230 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 +5340 y Fn(LC_CTYPE)26 b Fo(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.)p eop end %%Page: 7 10 TeXDict begin 7 9 bop 150 -116 a Fo(Chapter)30 b(1:)41 b(Command)29 b(Line)i(Editing)2153 b(7)630 299 y Fn(disable-completion) @@ -5899,406 +5902,411 @@ i(will)f(not)h(clear)1110 3821 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h b(The)44 b(default)g(v)-5 b(alue)44 b(is)g(`)p Fn(off)p Fo(',)j(but)1110 4041 y(Readline)24 b(will)h(set)f(it)g(to)h(`)p Fn(on)p Fo(')e(if)h(the)g(lo)s(cale)i(con)m(tains)f(eigh)m(t-bit)g(c)m -(haracters.)1110 4150 y(The)30 b(name)g Fn(meta-flag)e -Fo(is)j(a)f(synon)m(ym)g(for)g(this)h(v)-5 b(ariable.)630 -4307 y Fn(isearch-terminators)1110 4416 y Fo(The)51 b(string)h(of)g(c)m -(haracters)h(that)f(should)e(terminate)j(an)f(incremen)m(tal)1110 -4526 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 4635 y(\(see)45 b(Section)h(1.2.5)g -([Searc)m(hing],)j(page)d(3\).)84 b(If)44 b(this)g(v)-5 -b(ariable)45 b(has)g(not)1110 4745 y(b)s(een)35 b(giv)m(en)h(a)g(v)-5 -b(alue,)37 b(the)f(c)m(haracters)h Fn(ESC)d Fo(and)h -Fg(C-J)g Fo(will)h(terminate)g(an)1110 4855 y(incremen)m(tal)c(searc)m -(h.)630 5011 y Fn(keymap)192 b Fo(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 -5121 y(commands.)71 b(Built-in)41 b Fn(keymap)e Fo(names)h(are)h -Fn(emacs)p Fo(,)h Fn(emacs-standard)p Fo(,)1110 5230 -y Fn(emacs-meta)p Fo(,)99 b Fn(emacs-ctlx)p Fo(,)f Fn(vi)p -Fo(,)j Fn(vi-move)p Fo(,)f Fn(vi-command)p Fo(,)f(and)1110 -5340 y Fn(vi-insert)p Fo(.)81 b Fn(vi)44 b Fo(is)h(equiv)-5 -b(alen)m(t)46 b(to)g Fn(vi-command)c Fo(\()p Fn(vi-move)h -Fo(is)i(also)h(a)p eop end +(haracters.)1110 4150 y(The)k(name)g Fn(meta-flag)e Fo(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 4260 y(is)35 b(dep)s(enden)m(t)f(on)h(the)g +Fn(LC_CTYPE)e Fo(lo)s(cale)k(category)-8 b(,)39 b(and)34 +b(ma)m(y)i(c)m(hange)g(if)1110 4369 y(the)31 b(lo)s(cale)h(is)e(c)m +(hanged.)630 4526 y Fn(isearch-terminators)1110 4635 +y Fo(The)51 b(string)h(of)g(c)m(haracters)h(that)f(should)e(terminate)j +(an)f(incremen)m(tal)1110 4745 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 +4855 y(\(see)45 b(Section)h(1.2.5)g([Searc)m(hing],)j(page)d(3\).)84 +b(If)44 b(this)g(v)-5 b(ariable)45 b(has)g(not)1110 4964 +y(b)s(een)35 b(giv)m(en)h(a)g(v)-5 b(alue,)37 b(the)f(c)m(haracters)h +Fn(ESC)d Fo(and)h Fg(C-J)g Fo(will)h(terminate)g(an)1110 +5074 y(incremen)m(tal)c(searc)m(h.)630 5230 y Fn(keymap)192 +b Fo(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 5340 y(commands.)71 b(Built-in)41 +b Fn(keymap)e Fo(names)h(are)h Fn(emacs)p Fo(,)h Fn(emacs-standard)p +Fo(,)p eop end %%Page: 9 12 TeXDict begin 9 11 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y(synon)m(ym\);)41 -b Fn(emacs)c Fo(is)h(equiv)-5 b(alen)m(t)39 b(to)f Fn(emacs-standard)p -Fo(.)59 b(Applications)1110 408 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 -Fn(emacs)p Fo(.)41 b(The)30 b(v)-5 b(alue)1110 518 y(of)31 -b(the)f Fn(editing-mode)d Fo(v)-5 b(ariable)31 b(also)h(a\013ects)f -(the)g(default)g(k)m(eymap.)630 706 y Fn(keyseq-timeout)1110 -816 y Fo(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 925 -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 1035 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 1144 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 -1254 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 1363 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 1473 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 Fn(rl_instream)d Fo(b)m(y)i(default\).)1110 -1583 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h +b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y Fn(emacs-meta)p +Fo(,)99 b Fn(emacs-ctlx)p Fo(,)f Fn(vi)p Fo(,)j Fn(vi-move)p +Fo(,)f Fn(vi-command)p Fo(,)f(and)1110 408 y Fn(vi-insert)p +Fo(.)81 b Fn(vi)44 b Fo(is)h(equiv)-5 b(alen)m(t)46 b(to)g +Fn(vi-command)c Fo(\()p Fn(vi-move)h Fo(is)i(also)h(a)1110 +518 y(synon)m(ym\);)41 b Fn(emacs)c Fo(is)h(equiv)-5 +b(alen)m(t)39 b(to)f Fn(emacs-standard)p Fo(.)59 b(Applications)1110 +628 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 Fn(emacs)p Fo(.)41 +b(The)30 b(v)-5 b(alue)1110 737 y(of)31 b(the)f Fn(editing-mode)d +Fo(v)-5 b(ariable)31 b(also)h(a\013ects)f(the)g(default)g(k)m(eymap.) +630 909 y Fn(keyseq-timeout)1110 1019 y Fo(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 1129 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 +1238 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 1348 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 1457 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 +1567 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 1677 +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 Fn(rl_instream)d Fo(b)m(y)i(default\).)1110 +1786 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 1692 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g +1110 1896 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 1802 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f +b(is)1110 2005 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 1911 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h +b(alue,)1110 2115 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 -2021 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)g Fn(500)p Fo(.)630 2209 y Fn(mark-directories)1110 -2318 y Fo(If)38 b(set)g(to)h(`)p Fn(on)p Fo(',)i(completed)e(directory) +2225 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 +b(alue)31 b(is)g Fn(500)p Fo(.)630 2397 y Fn(mark-directories)1110 +2506 y Fo(If)38 b(set)g(to)h(`)p Fn(on)p Fo(',)i(completed)e(directory) f(names)g(ha)m(v)m(e)i(a)e(slash)g(app)s(ended.)1110 -2428 y(The)30 b(default)g(is)h(`)p Fn(on)p Fo('.)630 -2616 y Fn(mark-modified-lines)1110 2725 y Fo(This)k(v)-5 +2616 y(The)30 b(default)g(is)h(`)p Fn(on)p Fo('.)630 +2788 y Fn(mark-modified-lines)1110 2898 y Fo(This)k(v)-5 b(ariable,)38 b(when)d(set)h(to)h(`)p Fn(on)p Fo(',)g(causes)g -(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 2835 y(terisk)f(\(`)p +(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 3007 y(terisk)f(\(`)p Fn(*)p Fo('\))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 2945 y(This)d(v)-5 +(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 3117 y(This)d(v)-5 b(ariable)31 b(is)f(`)p Fn(off)p Fo(')g(b)m(y)g(default.)630 -3133 y Fn(mark-symlinked-directori)o(es)1110 3242 y Fo(If)59 +3289 y Fn(mark-symlinked-directori)o(es)1110 3399 y Fo(If)59 b(set)h(to)g(`)p Fn(on)p Fo(',)67 b(completed)60 b(names)f(whic)m(h)g -(are)h(sym)m(b)s(olic)g(links)f(to)1110 3352 y(directories)71 +(are)h(sym)m(b)s(olic)g(links)f(to)1110 3508 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 3461 y Fn(mark-directories)p +b(to)g(the)g(v)-5 b(alue)70 b(of)1110 3618 y Fn(mark-directories)p Fo(\).)37 b(The)30 b(default)g(is)g(`)p Fn(off)p Fo('.)630 -3649 y Fn(match-hidden-files)1110 3759 y Fo(This)21 b(v)-5 +3790 y Fn(match-hidden-files)1110 3900 y Fo(This)21 b(v)-5 b(ariable,)25 b(when)d(set)g(to)h(`)p Fn(on)p Fo(',)h(causes)f -(Readline)g(to)g(matc)m(h)g(\014les)f(whose)1110 3868 +(Readline)g(to)g(matc)m(h)g(\014les)f(whose)1110 4009 y(names)44 b(b)s(egin)g(with)g(a)g(`)p Fn(.)p Fo(')g(\(hidden)f -(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 3978 +(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 4119 y(completion.)75 b(If)41 b(set)g(to)h(`)p Fn(off)p Fo(',)i(the)e (leading)g(`)p Fn(.)p Fo(')f(m)m(ust)g(b)s(e)g(supplied)f(b)m(y)1110 -4088 y(the)34 b(user)g(in)g(the)g(\014lename)g(to)h(b)s(e)f(completed.) +4228 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 Fn(on)p Fo(')g(b)m(y)1110 -4197 y(default.)630 4385 y Fn(menu-complete-display-pr)o(efix)1110 -4495 y Fo(If)f(set)h(to)g(`)p Fn(on)p Fo(',)h(men)m(u)e(completion)i +4338 y(default.)630 4510 y Fn(menu-complete-display-pr)o(efix)1110 +4620 y Fo(If)f(set)h(to)g(`)p Fn(on)p Fo(',)h(men)m(u)e(completion)i (displa)m(ys)e(the)h(common)g(pre\014x)e(of)i(the)1110 -4604 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 4714 y(through)30 +4729 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 4839 y(through)30 b(the)g(list.)42 b(The)29 b(default)i(is)f(`)p Fn(off)p -Fo('.)630 4902 y Fn(output-meta)1110 5011 y Fo(If)35 +Fo('.)630 5011 y Fn(output-meta)1110 5121 y Fo(If)35 b(set)h(to)g(`)p Fn(on)p Fo(',)h(Readline)f(will)g(displa)m(y)f(c)m -(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 5121 y(set)h(directly)g +(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 5230 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 5230 y(default)26 b(is)f(`)p Fn(off)p Fo(',)i(but)e +b(The)1110 5340 y(default)26 b(is)f(`)p Fn(off)p Fo(',)i(but)e (Readline)h(will)g(set)g(it)g(to)h(`)p Fn(on)p Fo(')e(if)h(the)f(lo)s -(cale)j(con)m(tains)1110 5340 y(eigh)m(t-bit)k(c)m(haracters.)p -eop end +(cale)j(con)m(tains)p eop end %%Page: 10 13 TeXDict begin 10 12 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(10)630 299 y Fn(page-completions) -1110 408 y Fo(If)33 b(set)i(to)f(`)p Fn(on)p Fo(',)h(Readline)g(uses)e -(an)h(in)m(ternal)h Fn(more)p Fo(-lik)m(e)f(pager)g(to)h(displa)m(y) -1110 518 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 Fn(on)p -Fo(')1110 628 y(b)m(y)e(default.)630 784 y Fn(print-completions-horizo) -o(ntal)o(ly)1110 894 y Fo(If)23 b(set)i(to)g(`)p Fn(on)p -Fo(',)g(Readline)g(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes) -h(sorted)1110 1003 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 -1113 y(The)30 b(default)g(is)h(`)p Fn(off)p Fo('.)630 -1270 y Fn(revert-all-at-newline)1110 1379 y Fo(If)e(set)h(to)g(`)p -Fn(on)p Fo(',)g(Readline)g(will)g(undo)f(all)h(c)m(hanges)h(to)f -(history)g(lines)f(b)s(efore)1110 1489 y(returning)f(when)f -Fn(accept-line)f Fo(is)j(executed.)41 b(By)29 b(default,)g(history)g -(lines)1110 1598 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 -1708 y Fn(readline)p Fo(.)38 b(The)30 b(default)h(is)f(`)p -Fn(off)p Fo('.)630 1864 y Fn(show-all-if-ambiguous)1110 -1974 y Fo(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 2084 y(to)f(`)p -Fn(on)p Fo(',)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 2193 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 2303 y(The)30 b(default)g(v)-5 -b(alue)31 b(is)g(`)p Fn(off)p Fo('.)630 2459 y Fn -(show-all-if-unmodified)1110 2569 y Fo(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 2679 y(fashion)25 b(similar)h(to)g Fe(sho)m(w-all-if-am)m(biguous) -p Fo(.)41 b(If)25 b(set)h(to)h(`)p Fn(on)p Fo(',)f(w)m(ords)f(whic)m(h) -1110 2788 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 -2898 y(tial)43 b(completion)h(\(the)f(p)s(ossible)f(completions)h -(don't)f(share)g(a)h(common)1110 3007 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 3117 y(ing)g(the)f(b)s(ell.)41 +b(Command)29 b(Line)i(Editing)2107 b(10)1110 299 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 Fn(LC_CTYPE)1110 408 y Fo(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 581 y Fn(page-completions)1110 +690 y Fo(If)i(set)i(to)f(`)p Fn(on)p Fo(',)h(Readline)g(uses)e(an)h(in) +m(ternal)h Fn(more)p Fo(-lik)m(e)f(pager)g(to)h(displa)m(y)1110 +800 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 Fn(on)p Fo(')1110 +909 y(b)m(y)e(default.)630 1082 y Fn(print-completions-horizo)o(ntal)o +(ly)1110 1191 y Fo(If)23 b(set)i(to)g(`)p Fn(on)p Fo(',)g(Readline)g +(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes)h(sorted)1110 +1301 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 1410 y(The)30 b(default)g(is)h(`)p +Fn(off)p Fo('.)630 1583 y Fn(revert-all-at-newline)1110 +1692 y Fo(If)e(set)h(to)g(`)p Fn(on)p Fo(',)g(Readline)g(will)g(undo)f +(all)h(c)m(hanges)h(to)f(history)g(lines)f(b)s(efore)1110 +1802 y(returning)f(when)f Fn(accept-line)f Fo(is)j(executed.)41 +b(By)29 b(default,)g(history)g(lines)1110 1911 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 2021 y Fn(readline)p Fo(.)38 +b(The)30 b(default)h(is)f(`)p Fn(off)p Fo('.)630 2193 +y Fn(show-all-if-ambiguous)1110 2303 y Fo(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 2412 y(to)f(`)p Fn(on)p Fo(',)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 2522 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 2632 y(The)30 +b(default)g(v)-5 b(alue)31 b(is)g(`)p Fn(off)p Fo('.)630 +2804 y Fn(show-all-if-unmodified)1110 2913 y Fo(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 3023 y(fashion)25 b(similar)h(to)g +Fe(sho)m(w-all-if-am)m(biguous)p Fo(.)41 b(If)25 b(set)h(to)h(`)p +Fn(on)p Fo(',)f(w)m(ords)f(whic)m(h)1110 3133 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 3242 y(tial)43 b(completion)h(\(the)f(p)s(ossible) +f(completions)h(don't)f(share)g(a)h(common)1110 3352 +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 3461 y(ing)g(the)f(b)s(ell.)41 b(The)30 b(default)g(v)-5 b(alue)31 b(is)f(`)p Fn(off)p -Fo('.)630 3273 y Fn(show-mode-in-prompt)1110 3383 y Fo(If)24 +Fo('.)630 3634 y Fn(show-mode-in-prompt)1110 3743 y Fo(If)24 b(set)h(to)g(`)p Fn(on)p Fo(',)g(add)f(a)h(string)f(to)h(the)f(b)s -(eginning)g(of)g(the)h(prompt)e(indicating)1110 3493 +(eginning)g(of)g(the)h(prompt)e(indicating)1110 3853 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 3602 y(strings)45 +h(insertion.)49 b(The)32 b(mo)s(de)1110 3962 y(strings)45 b(are)h(user-settable)g(\(e.g.,)51 b Fe(emacs-mo)s(de-string)8 -b Fo(\).)87 b(The)45 b(default)1110 3712 y(v)-5 b(alue)31 -b(is)f(`)p Fn(off)p Fo('.)630 3868 y Fn(skip-completed-text)1110 -3978 y Fo(If)i(set)i(to)f(`)p Fn(on)p Fo(',)h(this)f(alters)g(the)g +b Fo(\).)87 b(The)45 b(default)1110 4072 y(v)-5 b(alue)31 +b(is)f(`)p Fn(off)p Fo('.)630 4244 y Fn(skip-completed-text)1110 +4354 y Fo(If)i(set)i(to)f(`)p Fn(on)p Fo(',)h(this)f(alters)g(the)g (default)g(completion)h(b)s(eha)m(vior)f(when)f(in-)1110 -4088 y(serting)d(a)h(single)g(matc)m(h)f(in)m(to)h(the)g(line.)40 +4463 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 -4197 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 4307 y(not)41 +4573 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 4682 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 4416 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f +(c)m(haracters)1110 4792 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 -4526 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45 +4902 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 -4635 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g -(after)h(the)g(`)p Fn(e)p Fo(')f(in)1110 4745 y(`)p Fn(Makefile)p +5011 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g +(after)h(the)g(`)p Fn(e)p Fo(')f(in)1110 5121 y(`)p Fn(Makefile)p Fo(')c(will)i(result)f(in)g(`)p Fn(Makefile)p Fo(')f(rather)h(than)h(`) -p Fn(Makefilefile)p Fo(',)1110 4855 y(assuming)d(there)g(is)h(a)f +p Fn(Makefilefile)p Fo(',)1110 5230 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 4964 y(is)30 b(`)p Fn(off)p Fo('.)630 5121 -y Fn(vi-cmd-mode-string)1110 5230 y Fo(If)j(the)h Fe(sho)m(w-mo)s -(de-in-prompt)h Fo(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f -(is)h(dis-)1110 5340 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)p -eop end +b(alue)1110 5340 y(is)30 b(`)p Fn(off)p Fo('.)p eop end %%Page: 11 14 TeXDict begin 11 13 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(11)1110 299 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 408 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 518 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 Fn(\\1)p Fo(')1110 628 y(and)23 -b(`)p Fn(\\2)p Fo(')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 737 -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 847 +b(Command)29 b(Line)i(Editing)2107 b(11)630 299 y Fn +(vi-cmd-mode-string)1110 408 y Fo(If)33 b(the)h Fe(sho)m(w-mo)s +(de-in-prompt)h Fo(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f +(is)h(dis-)1110 518 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 +628 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 +737 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 +847 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 Fn(\\1)p +Fo(')1110 956 y(and)23 b(`)p Fn(\\2)p Fo(')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 +1066 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 1176 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fn(\(cmd\))p Fo('.)630 1007 y Fn(vi-ins-mode-string)1110 -1117 y Fo(If)j(the)h Fe(sho)m(w-mo)s(de-in-prompt)h Fo(v)-5 +Fn(\(cmd\))p Fo('.)630 1340 y Fn(vi-ins-mode-string)1110 +1450 y Fo(If)j(the)h Fe(sho)m(w-mo)s(de-in-prompt)h Fo(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110 -1226 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 1336 y(vi)35 +1559 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 1669 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 1445 y(panded)26 +54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 1778 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 1555 y(pre\014xes)34 b(and)g(bac)m +(meta-)h(and)e(con)m(trol)1110 1888 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 Fn(\\1)p Fo(')1110 1665 y(and)23 +b(Use)35 b(the)g(`)p Fn(\\1)p Fo(')1110 1998 y(and)23 b(`)p Fn(\\2)p Fo(')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 1774 +(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 2107 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 1884 +(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 2217 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fn(\(ins\))p Fo('.)630 2044 y Fn(visible-stats)1110 2153 +Fn(\(ins\))p Fo('.)630 2381 y Fn(visible-stats)1110 2491 y Fo(If)h(set)i(to)f(`)p Fn(on)p Fo(',)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 -2263 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 -b(The)30 b(default)g(is)h(`)p Fn(off)p Fo('.)150 2423 -y(Key)f(Bindings)630 2533 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h +2600 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 +b(The)30 b(default)g(is)h(`)p Fn(off)p Fo('.)150 2765 +y(Key)f(Bindings)630 2874 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 2642 y(need)27 b(to)i(\014nd)d(the)i(name)f(of) +b(First)43 b(y)m(ou)630 2984 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 2752 y(sections)37 b(con)m(tain)g(tables)g +b(The)27 b(follo)m(wing)630 3093 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 2862 y(and)30 b(a)h(short)f(description)g(of)h(what)f -(the)g(command)h(do)s(es.)630 2996 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g +m(y)-8 b(,)630 3203 y(and)30 b(a)h(short)f(description)g(of)h(what)f +(the)g(command)h(do)s(es.)630 3340 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 3106 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m +(the)g(init)630 3450 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 3216 y(the)f(name)h(of)f(the)g(command.)46 b(There)32 +630 3559 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 3325 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m +(and)630 3669 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 3435 y(the)35 b(k)m(ey)g(can)g(b)s(e)f +b(The)40 b(name)h(of)630 3778 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 3544 y(comfortable.)630 -3679 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 3888 y(comfortable.)630 +4025 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 -3789 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g -(\(a)h Fe(macro)5 b Fo(\).)630 3949 y Fe(k)m(eyname)g +4134 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g +(\(a)h Fe(macro)5 b Fo(\).)630 4299 y Fe(k)m(eyname)g Fo(:)42 b Fe(function-name)35 b Fo(or)c Fe(macro)1110 -4059 y(k)m(eyname)k Fo(is)29 b(the)f(name)h(of)g(a)g(k)m(ey)h(sp)s +4408 y(k)m(eyname)k Fo(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 -4194 y Fn(Control-u:)45 b(universal-argument)1350 4303 -y(Meta-Rubout:)f(backward-kill-word)1350 4413 y(Control-o:)h(">)i -(output")1110 4548 y Fo(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112 +4545 y Fn(Control-u:)45 b(universal-argument)1350 4655 +y(Meta-Rubout:)f(backward-kill-word)1350 4765 y(Control-o:)h(">)i +(output")1110 4902 y Fo(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112 b Fg(C-u)94 b Fo(is)g(b)s(ound)f(to)i(the)f(function)1110 -4657 y Fn(universal-argument)p Fo(,)124 b Fg(M-DEL)107 -b Fo(is)i(b)s(ound)e(to)j(the)f(function)1110 4767 y +5011 y Fn(universal-argument)p Fo(,)124 b Fg(M-DEL)107 +b Fo(is)i(b)s(ound)e(to)j(the)f(function)1110 5121 y Fn(backward-kill-word)p Fo(,)75 b(and)69 b Fg(C-o)g Fo(is)h(b)s(ound)e -(to)j(run)d(the)i(macro)1110 4876 y(expressed)45 b(on)h(the)g(righ)m(t) +(to)j(run)d(the)i(macro)1110 5230 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 -Fn(>)1110 4986 y(output)p Fo(')29 b(in)m(to)i(the)g(line\).)1110 -5121 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 5230 y(pro)s(cessing)40 -b(this)f(k)m(ey)i(binding)e(syn)m(tax:)60 b Fe(DEL)p -Fo(,)42 b Fe(ESC)p Fo(,)g Fe(ESCAPE)p Fo(,)f Fe(LFD)p -Fo(,)1110 5340 y Fe(NEWLINE)p Fo(,)31 b Fe(RET)p Fo(,)f -Fe(RETURN)p Fo(,)g Fe(R)m(UBOUT)p Fo(,)h Fe(SP)-8 b(A)m(CE)p -Fo(,)31 b Fe(SPC)p Fo(,)e(and)h Fe(T)-8 b(AB)p Fo(.)p +Fn(>)1110 5340 y(output)p Fo(')29 b(in)m(to)i(the)g(line\).)p eop end %%Page: 12 15 TeXDict begin 12 14 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(12)630 299 y Fn(")p -Fe(k)m(eyseq)r Fn(")p Fo(:)41 b Fe(function-name)36 b -Fo(or)30 b Fe(macro)1110 408 y(k)m(eyseq)k Fo(di\013ers)d(from)f -Fe(k)m(eyname)37 b Fo(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f -(denoting)g(an)g(en-)1110 518 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 -628 y(double)29 b(quotes.)41 b(Some)29 b Fh(gnu)h Fo(Emacs)f(st)m(yle)i -(k)m(ey)f(escap)s(es)g(can)g(b)s(e)f(used,)g(as)1110 -737 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 847 y(recognized.)1350 -981 y Fn("\\C-u":)46 b(universal-argument)1350 1091 y("\\C-x\\C-r":)f -(re-read-init-file)1350 1200 y("\\e[11~":)g("Function)h(Key)g(1")1110 -1334 y Fo(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 -b Fg(C-u)64 b Fo(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 -1444 y Fn(universal-argument)39 b Fo(\(just)k(as)h(it)g(w)m(as)g(in)g -(the)f(\014rst)g(example\),)49 b(`)p Fg(C-x)1110 1554 +b(Command)29 b(Line)i(Editing)2107 b(12)1110 299 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 408 y(pro)s(cessing)40 b(this)f(k)m(ey)i +(binding)e(syn)m(tax:)60 b Fe(DEL)p Fo(,)42 b Fe(ESC)p +Fo(,)g Fe(ESCAPE)p Fo(,)f Fe(LFD)p Fo(,)1110 518 y Fe(NEWLINE)p +Fo(,)31 b Fe(RET)p Fo(,)f Fe(RETURN)p Fo(,)g Fe(R)m(UBOUT)p +Fo(,)h Fe(SP)-8 b(A)m(CE)p Fo(,)31 b Fe(SPC)p Fo(,)e(and)h +Fe(T)-8 b(AB)p Fo(.)630 677 y Fn(")p Fe(k)m(eyseq)r Fn(")p +Fo(:)41 b Fe(function-name)36 b Fo(or)30 b Fe(macro)1110 +787 y(k)m(eyseq)k Fo(di\013ers)d(from)f Fe(k)m(eyname)37 +b Fo(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f(denoting)g(an)g(en-)1110 +896 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 1006 y(double)29 +b(quotes.)41 b(Some)29 b Fh(gnu)h Fo(Emacs)f(st)m(yle)i(k)m(ey)f(escap) +s(es)g(can)g(b)s(e)f(used,)g(as)1110 1115 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 1225 y(recognized.)1350 1359 y Fn("\\C-u":)46 b +(universal-argument)1350 1469 y("\\C-x\\C-r":)f(re-read-init-file)1350 +1578 y("\\e[11~":)g("Function)h(Key)g(1")1110 1713 y +Fo(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 b Fg(C-u)64 +b Fo(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 +1822 y Fn(universal-argument)39 b Fo(\(just)k(as)h(it)g(w)m(as)g(in)g +(the)f(\014rst)g(example\),)49 b(`)p Fg(C-x)1110 1932 y(C-r)p Fo(')30 b(is)g(b)s(ound)e(to)j(the)g(function)f Fn(re-read-init-file)p Fo(,)c(and)j(`)p Fn(ESC)h([)g(1)g(1)1110 -1663 y(~)p Fo(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p -Fn(Function)e(Key)g(1)p Fo('.)630 1822 y(The)g(follo)m(wing)i +2041 y(~)p Fo(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p +Fn(Function)e(Key)g(1)p Fo('.)630 2200 y(The)g(follo)m(wing)i Fh(gnu)f Fo(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 1932 y(k)m(ey)i(sequences:)630 -2091 y Fg(\\C-)336 b Fo(con)m(trol)32 b(pre\014x)630 -2250 y Fg(\\M-)336 b Fo(meta)31 b(pre\014x)630 2408 y +b(ailable)32 b(when)d(sp)s(ecifying)630 2310 y(k)m(ey)i(sequences:)630 +2469 y Fg(\\C-)336 b Fo(con)m(trol)32 b(pre\014x)630 +2628 y Fg(\\M-)336 b Fo(meta)31 b(pre\014x)630 2787 y Fg(\\e)384 b Fo(an)30 b(escap)s(e)h(c)m(haracter)630 -2567 y Fg(\\\\)384 b Fo(bac)m(kslash)630 2726 y Fg(\\)p +2945 y Fg(\\\\)384 b Fo(bac)m(kslash)630 3104 y Fg(\\)p Fn(")g(")p Fo(,)30 b(a)h(double)f(quotation)i(mark)630 -2885 y Fg(\\')384 b Fn(')p Fo(,)30 b(a)h(single)g(quote)g(or)f(ap)s -(ostrophe)630 3044 y(In)d(addition)h(to)g(the)g Fh(gnu)f +3263 y Fg(\\')384 b Fn(')p Fo(,)30 b(a)h(single)g(quote)g(or)f(ap)s +(ostrophe)630 3422 y(In)d(addition)h(to)g(the)g Fh(gnu)f Fo(Emacs)h(st)m(yle)h(escap)s(e)f(sequences,)h(a)f(second)f(set)h(of)g -(bac)m(kslash)630 3154 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 -3313 y Fn(\\a)384 b Fo(alert)31 b(\(b)s(ell\))630 3471 -y Fn(\\b)384 b Fo(bac)m(kspace)630 3630 y Fn(\\d)g Fo(delete)630 -3789 y Fn(\\f)g Fo(form)30 b(feed)630 3948 y Fn(\\n)384 -b Fo(newline)630 4107 y Fn(\\r)g Fo(carriage)32 b(return)630 -4266 y Fn(\\t)384 b Fo(horizon)m(tal)32 b(tab)630 4425 -y Fn(\\v)384 b Fo(v)m(ertical)32 b(tab)630 4584 y Fn(\\)p +(bac)m(kslash)630 3532 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 +3691 y Fn(\\a)384 b Fo(alert)31 b(\(b)s(ell\))630 3850 +y Fn(\\b)384 b Fo(bac)m(kspace)630 4008 y Fn(\\d)g Fo(delete)630 +4167 y Fn(\\f)g Fo(form)30 b(feed)630 4326 y Fn(\\n)384 +b Fo(newline)630 4485 y Fn(\\r)g Fo(carriage)32 b(return)630 +4644 y Fn(\\t)384 b Fo(horizon)m(tal)32 b(tab)630 4803 +y Fn(\\v)384 b Fo(v)m(ertical)32 b(tab)630 4962 y Fn(\\)p Fg(nnn)288 b Fo(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 Fe(nnn)e -Fo(\(one)i(to)1110 4693 y(three)c(digits\))630 4852 y +Fo(\(one)i(to)1110 5071 y(three)c(digits\))630 5230 y Fn(\\x)p Fg(HH)288 b Fo(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 Fe(HH)1110 4962 y Fo(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))630 -5121 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 -5230 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 5340 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)p eop end +b Fe(HH)1110 5340 y Fo(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))p +eop end %%Page: 13 16 TeXDict begin 13 15 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(13)630 299 y(will)40 -b(quote)h(an)m(y)f(other)g(c)m(haracter)i(in)d(the)i(macro)f(text,)k -(including)39 b(`)p Fn(")p Fo(')h(and)g(`)p Fn(')p Fo('.)69 -b(F)-8 b(or)630 408 y(example,)28 b(the)e(follo)m(wing)h(binding)d -(will)i(mak)m(e)h(`)p Fg(C-x)j Fn(\\)p Fo(')c(insert)f(a)h(single)h(`)p -Fn(\\)p Fo(')f(in)m(to)g(the)g(line:)870 542 y Fn("\\C-x\\\\":)45 -b("\\\\")150 740 y Fd(1.3.2)63 b(Conditional)41 b(Init)g(Constructs)150 -887 y Fo(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 -996 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 1106 y(result)f(of)h(tests.)41 -b(There)30 b(are)h(four)f(parser)f(directiv)m(es)j(used.)150 -1264 y Fn($if)336 b Fo(The)31 b Fn($if)f Fo(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 1373 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 1483 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 -1592 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i -(it.)630 1750 y Fn(mode)288 b Fo(The)30 b Fn(mode=)e +b(Command)29 b(Line)i(Editing)2107 b(13)630 299 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 408 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 518 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 +628 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 Fn(")p Fo(')h(and)g(`)p Fn(')p +Fo('.)69 b(F)-8 b(or)630 737 y(example,)28 b(the)e(follo)m(wing)h +(binding)d(will)i(mak)m(e)h(`)p Fg(C-x)j Fn(\\)p Fo(')c(insert)f(a)h +(single)h(`)p Fn(\\)p Fo(')f(in)m(to)g(the)g(line:)870 +873 y Fn("\\C-x\\\\":)45 b("\\\\")150 1073 y Fd(1.3.2)63 +b(Conditional)41 b(Init)g(Constructs)150 1220 y Fo(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 1330 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 1440 y(result)f(of)h(tests.)41 b(There)30 b(are)h(four)f(parser)f +(directiv)m(es)j(used.)150 1601 y Fn($if)336 b Fo(The)31 +b Fn($if)f Fo(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 1711 +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 +1821 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 +1930 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i +(it.)630 2091 y Fn(mode)288 b Fo(The)30 b Fn(mode=)e Fo(form)i(of)g(the)h Fn($if)e Fo(directiv)m(e)j(is)e(used)f(to)i(test)g -(whether)e(Read-)1110 1860 y(line)44 b(is)f(in)g Fn(emacs)f +(whether)e(Read-)1110 2201 y(line)44 b(is)f(in)g Fn(emacs)f Fo(or)h Fn(vi)g Fo(mo)s(de.)79 b(This)42 b(ma)m(y)i(b)s(e)e(used)h(in)g -(conjunction)1110 1969 y(with)c(the)h(`)p Fn(set)29 b(keymap)p +(conjunction)1110 2311 y(with)c(the)h(`)p Fn(set)29 b(keymap)p Fo(')38 b(command,)k(for)d(instance,)j(to)e(set)g(bindings)e(in)1110 -2079 y(the)32 b Fn(emacs-standard)c Fo(and)j Fn(emacs-ctlx)d -Fo(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 2188 y(starting)f(out)g -(in)f Fn(emacs)f Fo(mo)s(de.)630 2346 y Fn(term)288 b +2420 y(the)32 b Fn(emacs-standard)c Fo(and)j Fn(emacs-ctlx)d +Fo(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 2530 y(starting)f(out)g +(in)f Fn(emacs)f Fo(mo)s(de.)630 2691 y Fn(term)288 b Fo(The)26 b Fn(term=)g Fo(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 2456 y(ings,)38 +(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 2800 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 2565 y(function)24 b(k)m(eys.)39 +(the)g(terminal's)1110 2910 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 -Fn(=)p Fo(')g(is)g(tested)h(against)1110 2675 y(b)s(oth)k(the)h(full)g +Fn(=)p Fo(')g(is)g(tested)h(against)1110 3020 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 2785 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p +(terminal)1110 3129 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p Fn(-)p Fo('.)50 b(This)33 b(allo)m(ws)i Fn(sun)e Fo(to)h(matc)m(h)g(b)s -(oth)f Fn(sun)g Fo(and)1110 2894 y Fn(sun-cmd)p Fo(,)c(for)h(instance.) -630 3052 y Fn(version)144 b Fo(The)44 b Fn(version)f +(oth)f Fn(sun)g Fo(and)1110 3239 y Fn(sun-cmd)p Fo(,)c(for)h(instance.) +630 3400 y Fn(version)144 b Fo(The)44 b Fn(version)f Fo(test)i(ma)m(y)h(b)s(e)e(used)f(to)j(p)s(erform)d(comparisons)i -(against)1110 3161 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 +(against)1110 3509 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 b(The)42 b Fn(version)d Fo(expands)i(to)h(the)g(curren)m(t)1110 -3271 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h +3619 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 Fn(=)p Fo(')h(\(and)1110 -3381 y(`)p Fn(==)p Fo('\),)33 b(`)p Fn(!=)p Fo(',)f(`)p +3729 y(`)p Fn(==)p Fo('\),)33 b(`)p Fn(!=)p Fo(',)f(`)p Fn(<=)p Fo(',)h(`)p Fn(>=)p Fo(',)f(`)p Fn(<)p Fo(',)h(and)e(`)p Fn(>)p Fo('.)46 b(The)31 b(v)m(ersion)i(n)m(um)m(b)s(er)d(supplied)h -(on)1110 3490 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g +(on)1110 3838 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 -3600 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 3709 +3948 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 4057 y(`)p Fn(7.1)p Fo('\).)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 Fn(0)p -Fo('.)40 b(The)1110 3819 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) +Fo('.)40 b(The)1110 4167 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) g(from)g(the)h(string)f Fn(version)f Fo(and)h(from)g(the)1110 -3929 y(v)m(ersion)39 b(n)m(um)m(b)s(er)f(argumen)m(t)h(b)m(y)f +4276 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 -4038 y(sets)31 b(a)g(v)-5 b(ariable)31 b(if)f(the)h(Readline)g(v)m +4386 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 -4172 y Fn($if)47 b(version)f(>=)h(7.0)1350 4281 y(set)g -(show-mode-in-prompt)42 b(on)1350 4391 y($endif)630 4549 -y(application)1110 4658 y Fo(The)21 b Fe(application)j +4521 y Fn($if)47 b(version)f(>=)h(7.0)1350 4631 y(set)g +(show-mode-in-prompt)42 b(on)1350 4741 y($endif)630 4902 +y(application)1110 5011 y Fo(The)21 b Fe(application)j Fo(construct)e(is)g(used)f(to)i(include)f(application-sp)s(eci\014c)h -(set-)1110 4768 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h +(set-)1110 5121 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h (Readline)g(library)g(sets)g(the)g Fe(application)1110 -4878 y(name)p Fo(,)g(and)e(y)m(ou)g(can)h(test)g(for)f(a)g(particular)h +5230 y(name)p Fo(,)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 -4987 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 5097 -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 5206 y(the)e(curren)m(t)f(or)g(previous) -g(w)m(ord)g(in)g(Bash:)1350 5340 y Fn($if)47 b(Bash)p -eop end +5340 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)p eop end %%Page: 14 17 TeXDict begin 14 16 bop 150 -116 a Fo(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(14)1350 299 y Fn(#)47 -b(Quote)g(the)g(current)f(or)h(previous)e(word)1350 408 -y("\\C-xq":)h("\\eb\\"\\ef\\"")1350 518 y($endif)630 -677 y(variable)96 b Fo(The)33 b Fe(v)-5 b(ariable)39 -b Fo(construct)33 b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g -(Readline)1110 787 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 Fn(=)p Fo(',)1110 897 y(`)p Fn(==)p Fo(',)49 b(and)44 +b(Command)29 b(Line)i(Editing)2107 b(14)1110 299 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 408 y(the)e(curren)m(t)f(or)g(previous)g(w)m(ord)g(in)g +(Bash:)1350 543 y Fn($if)47 b(Bash)1350 653 y(#)g(Quote)g(the)g +(current)f(or)h(previous)e(word)1350 762 y("\\C-xq":)h +("\\eb\\"\\ef\\"")1350 872 y($endif)630 1031 y(variable)96 +b Fo(The)33 b Fe(v)-5 b(ariable)39 b Fo(construct)33 +b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g(Readline)1110 +1141 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 +Fn(=)p Fo(',)1110 1250 y(`)p Fn(==)p Fo(',)49 b(and)44 b(`)p Fn(!=)p Fo('.)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 1006 y(comparison)25 +(b)s(e)g(separated)g(from)g(the)1110 1360 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 1116 y(from)33 b(the)h(v)-5 b(alue)35 +(e)f(separated)1110 1469 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 1225 y(and)i(b)s(o)s(olean)g(v)-5 +b(Both)35 b(string)1110 1579 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 1335 y(tested)46 +b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 1689 y(tested)46 b(against)g(the)f(v)-5 b(alues)46 b Fe(on)f Fo(and)f Fe(o\013)p Fo(.)85 b(The)45 b(follo)m(wing)h(example)g(is)1110 -1445 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fn(mode=emacs)e -Fo(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 1579 y -Fn($if)47 b(editing-mode)d(==)k(emacs)1350 1689 y(set)f -(show-mode-in-prompt)42 b(on)1350 1798 y($endif)150 1958 +1798 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fn(mode=emacs)e +Fo(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 1933 y +Fn($if)47 b(editing-mode)d(==)k(emacs)1350 2042 y(set)f +(show-mode-in-prompt)42 b(on)1350 2152 y($endif)150 2311 y($endif)192 b Fo(This)29 b(command,)i(as)f(seen)h(in)f(the)g(previous) g(example,)h(terminates)g(an)g Fn($if)e Fo(command.)150 -2117 y Fn($else)240 b Fo(Commands)29 b(in)h(this)h(branc)m(h)e(of)i +2471 y Fn($else)240 b Fo(Commands)29 b(in)h(this)h(branc)m(h)e(of)i (the)f Fn($if)g Fo(directiv)m(e)i(are)f(executed)g(if)f(the)h(test)g -(fails.)150 2276 y Fn($include)96 b Fo(This)43 b(directiv)m(e)i(tak)m +(fails.)150 2630 y Fn($include)96 b Fo(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 2386 y(and)38 b(bindings)f(from)h(that)i(\014le.)65 +(commands)630 2740 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 2496 y Fn(/etc/inputrc)p Fo(:)870 2630 y Fn($include)46 -b(/etc/inputrc)150 2829 y Fd(1.3.3)63 b(Sample)41 b(Init)g(File)150 -2976 y Fo(Here)27 b(is)f(an)h(example)g(of)f(an)h Fe(inputrc)k +(from)630 2849 y Fn(/etc/inputrc)p Fo(:)870 2984 y Fn($include)46 +b(/etc/inputrc)150 3183 y Fd(1.3.3)63 b(Sample)41 b(Init)g(File)150 +3330 y Fo(Here)27 b(is)f(an)h(example)g(of)f(an)h Fe(inputrc)k Fo(\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 3086 y(conditional)j(syn)m +b(ariable)27 b(assignmen)m(t,)i(and)150 3440 y(conditional)j(syn)m (tax.)p eop end %%Page: 15 18 TeXDict begin 15 17 bop 150 -116 a Fo(Chapter)30 b(1:)41 diff --git a/doc/version.texi b/doc/version.texi index cd3f8d8..65a8457 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -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 diff --git a/examples/rlptytest.c b/examples/rlptytest.c index 0008dd1..d170f62 100644 --- a/examples/rlptytest.c +++ b/examples/rlptytest.c @@ -224,7 +224,7 @@ static enum { RESET, TCBREAK } ttystate = RESET; * * fd - The file descriptor of the terminal * - * Returns: 0 on sucess, -1 on error + * Returns: 0 on success, -1 on error */ int tty_cbreak(int fd){ struct termios buf; @@ -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); +} @@ -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 (); diff --git a/rlprivate.h b/rlprivate.h index 24ceb3a..d87d07a 100644 --- a/rlprivate.h +++ b/rlprivate.h @@ -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); |