diff options
| author | Chet Ramey <chet.ramey@case.edu> | 2022-09-23 09:56:28 -0400 |
|---|---|---|
| committer | Chet Ramey <chet.ramey@case.edu> | 2022-09-23 09:56:28 -0400 |
| commit | b723395f39abb16665783e762e17ab283d64214b (patch) | |
| tree | 063e3d292715d7d15defb36f9b2a68055f79a784 | |
| parent | a175d6b5557c6f62c6b0811ea05c735e06a35cb0 (diff) | |
| download | readline-b723395f39abb16665783e762e17ab283d64214b.tar.gz | |
updates for release
| -rw-r--r-- | CHANGELOG | 2 | ||||
| -rw-r--r-- | CHANGES | 18 | ||||
| -rw-r--r-- | NEWS | 8 | ||||
| -rw-r--r-- | README | 2 | ||||
| -rwxr-xr-x | configure | 4 | ||||
| -rw-r--r-- | configure.ac | 4 | ||||
| -rw-r--r-- | doc/history.0 | 2 | ||||
| -rw-r--r-- | doc/history.3 | 2 | ||||
| -rw-r--r-- | doc/history.dvi | bin | 72256 -> 72280 bytes | |||
| -rw-r--r-- | doc/history.html | 4 | ||||
| -rw-r--r-- | doc/history.info | 52 | ||||
| -rw-r--r-- | doc/history.pdf | bin | 204492 -> 204504 bytes | |||
| -rw-r--r-- | doc/history.ps | 43 | ||||
| -rw-r--r-- | doc/history_3.ps | 8 | ||||
| -rw-r--r-- | doc/hsuser.texi | 10 | ||||
| -rw-r--r-- | doc/readline.0 | 519 | ||||
| -rw-r--r-- | doc/readline.3 | 22 | ||||
| -rw-r--r-- | doc/readline.dvi | bin | 332440 -> 333112 bytes | |||
| -rw-r--r-- | doc/readline.html | 62 | ||||
| -rw-r--r-- | doc/readline.info | 241 | ||||
| -rw-r--r-- | doc/readline.pdf | bin | 405951 -> 406480 bytes | |||
| -rw-r--r-- | doc/readline.ps | 1524 | ||||
| -rw-r--r-- | doc/readline_3.ps | 1769 | ||||
| -rw-r--r-- | doc/rltech.texi | 28 | ||||
| -rw-r--r-- | doc/rluser.texi | 34 | ||||
| -rw-r--r-- | doc/rluserman.dvi | bin | 118316 -> 118796 bytes | |||
| -rw-r--r-- | doc/rluserman.html | 31 | ||||
| -rw-r--r-- | doc/rluserman.info | 95 | ||||
| -rw-r--r-- | doc/rluserman.pdf | bin | 236784 -> 237019 bytes | |||
| -rw-r--r-- | doc/rluserman.ps | 834 | ||||
| -rw-r--r-- | doc/version.texi | 6 | ||||
| -rw-r--r-- | examples/rl-callbacktest.c | 4 | ||||
| -rw-r--r-- | examples/rlcat.c | 2 | ||||
| -rw-r--r-- | examples/rlptytest.c | 2 | ||||
| -rw-r--r-- | history.c | 2 | ||||
| -rw-r--r-- | isearch.c | 3 | ||||
| -rw-r--r-- | kill.c | 12 | ||||
| -rw-r--r-- | nls.c | 85 | ||||
| -rw-r--r-- | readline.c | 2 | ||||
| -rw-r--r-- | rlprivate.h | 1 | ||||
| -rw-r--r-- | support/mkdist | 8 |
41 files changed, 2811 insertions, 2634 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> @@ -54,6 +54,10 @@ p. Fixed an issue with multi-line prompt strings that have one or more q. Fixed an issue that caused a history line's undo list to be cleared when it should not have been. +r. When replacing a history entry, make sure the existing entry has a non-NULL + timestamp before copying it; it may have been added by the application, not + the history library. + 2. New Features in Readline a. There is now an HS_HISTORY_VERSION containing the version number of the @@ -103,6 +107,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 +490,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 +821,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 +883,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 +1221,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 +1482,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, @@ -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 @@ -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. @@ -1,5 +1,5 @@ #! /bin/sh -# From configure.ac for Readline 8.2, version 2.96. +# From configure.ac for Readline 8.2, version 2.97. # Guess values for system-dependent variables and create Makefiles. # Generated by GNU Autoconf 2.71 for readline 8.2. # @@ -1406,7 +1406,7 @@ Optional Packages: --without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no) --with-curses use the curses library instead of the termcap library - --enable-shared-termcap-library + --with-shared-termcap-library link the readline shared library against the termcap/curses shared library [[default=NO]] diff --git a/configure.ac b/configure.ac index 0a83d5b..15501fa 100644 --- a/configure.ac +++ b/configure.ac @@ -20,7 +20,7 @@ dnl Process this file with autoconf to produce a configure script. # You should have received a copy of the GNU General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. -AC_REVISION([for Readline 8.2, version 2.96]) +AC_REVISION([for Readline 8.2, version 2.97]) AC_INIT(readline, 8.2, bug-readline@gnu.org) @@ -43,7 +43,7 @@ opt_shared_termcap_lib=no dnl arguments to configure AC_ARG_WITH(curses, AS_HELP_STRING([--with-curses], [use the curses library instead of the termcap library]), opt_curses=$withval) -AC_ARG_WITH(shared-termcap-library, AS_HELP_STRING([--enable-shared-termcap-library], [link the readline shared library against the termcap/curses shared library [[default=NO]]]), opt_shared_termcap_lib=$withval) +AC_ARG_WITH(shared-termcap-library, AS_HELP_STRING([--with-shared-termcap-library], [link the readline shared library against the termcap/curses shared library [[default=NO]]]), opt_shared_termcap_lib=$withval) if test "$opt_curses" = "yes"; then prefer_curses=yes diff --git a/doc/history.0 b/doc/history.0 index 3c1a794..2bf3b1a 100644 --- a/doc/history.0 +++ b/doc/history.0 @@ -144,7 +144,7 @@ HISTORY(3) Library Functions Manual HISTORY(3) commands. The basic history manipulation commands are identical to the history substitution provided by [1mbash[22m. - The programmer can also use the Readline library, which includes some + The programmer can also use the readline library, which includes some history manipulation by default, and has the added advantage of command line editing. diff --git a/doc/history.3 b/doc/history.3 index df6cd37..06419cf 100644 --- a/doc/history.3 +++ b/doc/history.3 @@ -291,7 +291,7 @@ in new commands. The basic history manipulation commands are identical to the history substitution provided by \fBbash\fP. .PP -The programmer can also use the Readline library, which +The programmer can also use the readline library, which includes some history manipulation by default, and has the added advantage of command line editing. .PP diff --git a/doc/history.dvi b/doc/history.dvi Binary files differindex c3435a1..bf33fe4 100644 --- a/doc/history.dvi +++ b/doc/history.dvi diff --git a/doc/history.html b/doc/history.html index 28b5fd0..3c258f4 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, 19 September 2022), a programming tool that provides a consistent user interface for recalling lines of previously typed input. @@ -377,7 +377,7 @@ substituted, or, if no previous history substitutions took place, the last <var>string</var> in a !?<var>string</var><code>[?]</code> search. -If <var>new</var> is is null, each matching <var>old</var> is deleted. +If <var>new</var> is null, each matching <var>old</var> is deleted. The final delimiter is optional if it is the last character on the input line. </p> diff --git a/doc/history.info b/doc/history.info index f1e7d4a..a6799c3 100644 --- a/doc/history.info +++ b/doc/history.info @@ -1,9 +1,9 @@ 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 -2022), a programming tool that provides a consistent user interface for -recalling lines of previously typed input. +This document describes the GNU History library (version 8.2, 19 +September 2022), a programming tool that provides a consistent user +interface for recalling lines of previously typed input. Copyright (C) 1988-2022 Free Software Foundation, Inc. @@ -230,7 +230,7 @@ or edit, the word or words selected from the history event. '&' appears in NEW, it is replaced by OLD. A single backslash will quote the '&'. If OLD is null, it is set to the last OLD substituted, or, if no previous history substitutions took place, - the last STRING in a !?STRING'[?]' search. If NEW is is null, each + the last STRING in a !?STRING'[?]' search. If NEW is null, each matching OLD is deleted. The final delimiter is optional if it is the last character on the input line. @@ -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: Top850 +Node: Using History Interactively1495 +Node: History Interaction2003 +Node: Event Designators3901 +Node: Word Designators5175 +Node: Modifiers6935 +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..0732585 100644 --- a/doc/history.pdf +++ b/doc/history.pdf diff --git a/doc/history.ps b/doc/history.ps index cfb37c1..3776eab 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: Tue Sep 20 14:17:06 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.09.20:1017 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -5241,22 +5241,23 @@ 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.)3118 +1623 y(Septem)m(b)s(er)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 +TeXDict begin 2 1 bop 150 4413 a Fq(This)43 b(do)s(cumen)m(t)g(describ) +s(es)g(the)h(GNU)g(History)h(library)e(\(v)m(ersion)h(8.2,)49 +b(19)44 b(Septem)m(b)s(er)f(2022\),)50 b(a)150 4523 y(programming)32 +b(to)s(ol)h(that)f(pro)m(vides)g(a)h(consisten)m(t)g(user)e(in)m +(terface)j(for)d(recalling)j(lines)e(of)g(previously)150 +4633 y(t)m(yp)s(ed)e(input.)150 4767 y(Cop)m(yrigh)m(t)602 +4764 y(c)577 4767 y Fn(\015)g 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 @@ -5436,12 +5437,12 @@ Fq(.)k(A)31 b(single)g(bac)m(kslash)g(will)g(quote)g(the)g(`)p Fp(&)p Fq('.)41 b(If)31 b Fk(old)j Fq(is)c(n)m(ull,)h(it)g(is)g(set)g (to)g(the)g(last)g Fk(old)630 1484 y Fq(substituted,)j(or,)g(if)f(no)g (previous)g(history)g(substitutions)g(to)s(ok)h(place,)h(the)e(last)h -Fk(string)630 1594 y Fq(in)j(a)g(!?)p Fk(string)8 b Fp([?])37 -b Fq(searc)m(h.)61 b(If)37 b Fk(new)45 b Fq(is)37 b(is)g(n)m(ull,)i -(eac)m(h)f(matc)m(hing)h Fk(old)h Fq(is)e(deleted.)61 -b(The)630 1704 y(\014nal)30 b(delimiter)h(is)g(optional)g(if)f(it)h(is) -g(the)f(last)i(c)m(haracter)f(on)g(the)f(input)g(line.)150 -1863 y Fp(&)432 b Fq(Rep)s(eat)31 b(the)f(previous)g(substitution.)150 +Fk(string)630 1594 y Fq(in)d(a)g(!?)p Fk(string)8 b Fp([?])30 +b Fq(searc)m(h.)44 b(If)31 b Fk(new)38 b Fq(is)31 b(n)m(ull,)h(eac)m(h) +g(matc)m(hing)g Fk(old)j Fq(is)c(deleted.)44 b(The)30 +b(\014nal)630 1704 y(delimiter)h(is)g(optional)g(if)f(it)h(is)g(the)f +(last)h(c)m(haracter)h(on)f(the)f(input)g(line.)150 1863 +y Fp(&)432 b Fq(Rep)s(eat)31 b(the)f(previous)g(substitution.)150 2022 y Fp(g)150 2132 y(a)432 b Fq(Cause)38 b(c)m(hanges)i(to)f(b)s(e)f (applied)h(o)m(v)m(er)h(the)f(en)m(tire)g(ev)m(en)m(t)h(line.)66 b(Used)39 b(in)f(conjunction)630 2242 y(with)30 b(`)p diff --git a/doc/history_3.ps b/doc/history_3.ps index 1f2b083..4440b3f 100644 --- a/doc/history_3.ps +++ b/doc/history_3.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Mon Oct 12 10:59:26 2020 +%%CreationDate: Fri Sep 23 09:52:37 2022 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -439,9 +439,9 @@ R .059(ace with a)-.1 F .918(set of well-kno)108 604.8 R .917 (vious lines and using that te)-.25 F .917(xt in ne)-.15 F 3.417(wc)-.25 G(om-)-3.417 E 4.183(mands. The)108 616.8 R 1.684(basic history manipul\ ation commands are identical to the history substitution pro)4.183 F -1.684(vided by)-.15 F F1(bash)108 628.8 Q F0(.)A .915 -(The programmer can also use the Readline library)108 645.6 R 3.415(,w) --.65 G .915(hich includes some history manipulation by def)-3.415 F +1.684(vided by)-.15 F F1(bash)108 628.8 Q F0(.)A 1.154 +(The programmer can also use the readline library)108 645.6 R 3.654(,w) +-.65 G 1.153(hich includes some history manipulation by def)-3.654 F (ault,)-.1 E(and has the added adv)108 657.6 Q (antage of command line editing.)-.25 E .39(Before declaring an)108 674.4 R 2.89(yf)-.15 G .39(unctions using an)-2.89 F 2.89(yf)-.15 G .39 diff --git a/doc/hsuser.texi b/doc/hsuser.texi index 99351e3..9081baf 100644 --- a/doc/hsuser.texi +++ b/doc/hsuser.texi @@ -246,10 +246,10 @@ the history list as a single entry. @end table -When any of the @option{-w}, @option{-r}, @option{-a}, or @option{-n} options is -used, if @var{filename} -is given, then it is used as the history file. If not, then -the value of the @env{HISTFILE} variable is used. +If a @var{filename} argument is supplied +when any of the @option{-w}, @option{-r}, @option{-a}, or @option{-n} options +is used, Bash uses @var{filename} as the history file. +If not, then the value of the @env{HISTFILE} variable is used. The return value is 0 unless an invalid option is encountered, an error occurs while reading or writing the history file, an invalid @@ -513,7 +513,7 @@ substituted, or, if no previous history substitutions took place, the last @var{string} in a !?@var{string}@code{[?]} search. -If @var{new} is is null, each matching @var{old} is deleted. +If @var{new} is null, each matching @var{old} is deleted. The final delimiter is optional if it is the last character on the input line. diff --git a/doc/readline.0 b/doc/readline.0 index f96ec72..b7c45a7 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, - Readline interprets it as the end of input and returns [1mEOF[22m. + 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- - rences. + that character. A negative argument searches for previous oc- + currences. [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- - quent occurrences. + A character is read and point is moved to the previous occur- + rence of that character. A negative argument searches for sub- + sequent 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 September 19 READLINE(3) diff --git a/doc/readline.3 b/doc/readline.3 index 912718d..77ef02a 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: Mon Sep 19 11:11:22 EDT 2022 .\" -.TH READLINE 3 "2022 March 11" "GNU Readline 8.2" +.TH READLINE 3 "2022 September 19" "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 @@ -844,14 +850,14 @@ composed of alphanumeric characters (letters and digits). .B previous\-screen\-line 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 +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. .TP .B next\-screen\-line 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 not greater than the length of the prompt +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. .TP .B clear\-display (M\-C\-l) @@ -984,7 +990,7 @@ The character indicating end-of-file as set, for example, by .if t \f(CWstty\fP. .if n ``stty''. If this character is read when there are no characters -on the line, and point is at the beginning of the line, Readline +on the line, and point is at the beginning of the line, readline interprets it as the end of input and returns .SM .BR EOF . @@ -1253,11 +1259,11 @@ the saved position, and the old cursor position is saved as the mark. .TP .B character\-search (C\-]) A character is read and point is moved to the next occurrence of that -character. A negative count searches for previous occurrences. +character. A negative argument searches for previous occurrences. .TP .B character\-search\-backward (M\-C\-]) A character is read and point is moved to the previous occurrence of that -character. A negative count searches for subsequent occurrences. +character. A negative argument searches for subsequent occurrences. .TP .B skip\-csi\-sequence Read enough characters to consume a multi-key sequence such as those diff --git a/doc/readline.dvi b/doc/readline.dvi Binary files differindex a0a9957..7296d40 100644 --- a/doc/readline.dvi +++ b/doc/readline.dvi diff --git a/doc/readline.html b/doc/readline.html index 8389ea2..1002f4f 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, 19 September 2022), a library which aids in the consistency of user interface across discrete programs which provide a command line interface. @@ -300,7 +300,7 @@ empty line. </p></dd> </dl> -<p>(Depending on your configuration, the <tt class="key">Backspace</tt> key be set to +<p>(Depending on your configuration, the <tt class="key">Backspace</tt> key might be set to delete the character to the left of the cursor and the <tt class="key">DEL</tt> key set to delete the character underneath the cursor, like <kbd>C-d</kbd>, rather than the character to the left of the cursor.) @@ -386,7 +386,7 @@ Word boundaries are the same as those used by <kbd>M-f</kbd>. </p> </dd> <dt><span><kbd>M-<span class="key">DEL</span></kbd></span></dt> -<dd><p>Kill from the cursor the start of the current word, or, if between +<dd><p>Kill from the cursor to the start of the current word, or, if between words, to the start of the previous word. Word boundaries are the same as those used by <kbd>M-b</kbd>. </p> @@ -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> @@ -695,7 +698,7 @@ been mapped to <code>self-insert</code>. The default is ‘<samp>off</samp> </dd> <dt id='index-echo_002dcontrol_002dcharacters'><span><code>echo-control-characters</code><a href='#index-echo_002dcontrol_002dcharacters' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to ‘<samp>on</samp>’, on operating systems that indicate they support it, -readline echoes a character corresponding to a signal generated from the +Readline echoes a character corresponding to a signal generated from the keyboard. The default is ‘<samp>on</samp>’. </p> </dd> @@ -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> @@ -898,7 +905,7 @@ The default is ‘<samp>off</samp>’. <dd><p>If set to ‘<samp>on</samp>’, Readline will undo all changes to history lines before returning when <code>accept-line</code> is executed. By default, history lines may be modified and retain individual undo lists across -calls to <code>readline</code>. The default is ‘<samp>off</samp>’. +calls to <code>readline()</code>. The default is ‘<samp>off</samp>’. </p> </dd> <dt id='index-show_002dall_002dif_002dambiguous'><span><code>show-all-if-ambiguous</code><a href='#index-show_002dall_002dif_002dambiguous' class='copiable-anchor'> ¶</a></span></dt> @@ -930,7 +937,7 @@ The default value is ‘<samp>off</samp>’. <dt id='index-skip_002dcompleted_002dtext'><span><code>skip-completed-text</code><a href='#index-skip_002dcompleted_002dtext' class='copiable-anchor'> ¶</a></span></dt> <dd><p>If set to ‘<samp>on</samp>’, 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 +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. @@ -992,7 +999,7 @@ interpreted as part of the key name. The name of the key can be expressed in different ways, depending on what you find most comfortable. </p> -<p>In addition to command names, readline allows keys to be bound +<p>In addition to command names, Readline allows keys to be bound to a string that is inserted when the key is pressed (a <var>macro</var>). </p> @@ -1916,7 +1923,7 @@ in the macro appear as if typed at the keyboard. </p> </dd> <dt id='index-print_002dlast_002dkbd_002dmacro-_0028_0029'><span><code>print-last-kbd-macro ()</code><a href='#index-print_002dlast_002dkbd_002dmacro-_0028_0029' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Print the last keboard macro defined in a format suitable for the +<dd><p>Print the last keyboard macro defined in a format suitable for the <var>inputrc</var> file. </p> </dd> @@ -1979,12 +1986,12 @@ the saved position, and the old cursor position is saved as the mark. </dd> <dt id='index-character_002dsearch-_0028C_002d_005d_0029'><span><code>character-search (C-])</code><a href='#index-character_002dsearch-_0028C_002d_005d_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>A character is read and point is moved to the next occurrence of that -character. A negative count searches for previous occurrences. +character. A negative argument searches for previous occurrences. </p> </dd> <dt id='index-character_002dsearch_002dbackward-_0028M_002dC_002d_005d_0029'><span><code>character-search-backward (M-C-])</code><a href='#index-character_002dsearch_002dbackward-_0028M_002dC_002d_005d_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>A character is read and point is moved to the previous occurrence -of that character. A negative count searches for subsequent +of that character. A negative argument searches for subsequent occurrences. </p> </dd> @@ -1993,7 +2000,7 @@ occurrences. defined for keys like Home and End. Such sequences begin with a Control Sequence Indicator (CSI), usually ESC-[. If this sequence is bound to "\e[", keys producing such sequences will have no effect -unless explicitly bound to a readline command, instead of inserting +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-[. </p> @@ -2465,7 +2472,7 @@ value 0x0402. <dl class="def"> <dt id="index-rl_005fgnu_005freadline_005fp"><span class="category">Variable: </span><span><em>int</em> <strong>rl_gnu_readline_p</strong><a href='#index-rl_005fgnu_005freadline_005fp' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Always set to 1, denoting that this is <small>GNU</small> readline rather than some +<dd><p>Always set to 1, denoting that this is <small>GNU</small> Readline rather than some emulation. </p></dd></dl> @@ -2604,7 +2611,7 @@ By default, this is set to <code>rl_deprep_terminal</code> <dl class="def"> <dt id="index-rl_005fexecuting_005fkeymap"><span class="category">Variable: </span><span><em>Keymap</em> <strong>rl_executing_keymap</strong><a href='#index-rl_005fexecuting_005fkeymap' class='copiable-anchor'> ¶</a></span></dt> <dd><p>This variable is set to the keymap (see <a href="#Keymaps">Selecting a Keymap</a>) in which the -currently executing readline function was found. +currently executing Readline function was found. </p></dd></dl> <dl class="def"> @@ -3104,7 +3111,7 @@ invoke <var>function</var> in the keymap <var>map</var>. <dl class="def"> <dt id="index-rl_005ffunction_005fdumper"><span class="category">Function: </span><span><em>void</em> <strong>rl_function_dumper</strong> <em>(int readable)</em><a href='#index-rl_005ffunction_005fdumper' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Print the readline function names and the key sequences currently +<dd><p>Print the Readline function names and the key sequences currently bound to them to <code>rl_outstream</code>. If <var>readable</var> is non-zero, the list is formatted in such a way that it can be made part of an <code>inputrc</code> file and re-read. @@ -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 @@ -3648,7 +3655,7 @@ that it can be made part of an <code>inputrc</code> file and re-read. <dl class="def"> <dt id="index-rl_005fvariable_005fbind"><span class="category">Function: </span><span><em>int</em> <strong>rl_variable_bind</strong> <em>(const char *variable, const char *value)</em><a href='#index-rl_005fvariable_005fbind' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Make the Readline variable <var>variable</var> have <var>value</var>. -This behaves as if the readline command +This behaves as if the Readline command ‘<samp>set <var>variable</var> <var>value</var></samp>’ had been executed in an <code>inputrc</code> file (see <a href="#Readline-Init-File-Syntax">Readline Init File Syntax</a>). </p></dd></dl> @@ -3661,7 +3668,7 @@ For boolean variables, this string is either ‘<samp>on</samp>’ or &l <dl class="def"> <dt id="index-rl_005fvariable_005fdumper"><span class="category">Function: </span><span><em>void</em> <strong>rl_variable_dumper</strong> <em>(int readable)</em><a href='#index-rl_005fvariable_005fdumper' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Print the readline variable names and their current values +<dd><p>Print the Readline variable names and their current values to <code>rl_outstream</code>. If <var>readable</var> is non-zero, the list is formatted in such a way that it can be made part of an <code>inputrc</code> file and re-read. @@ -3696,7 +3703,7 @@ Readline saves in the history list. <dd><p>Enable an <em>active</em> mark. When this is enabled, the text between point and mark (the <var>region</var>) is displayed in the terminal’s standout mode (a <var>face</var>). -This is called by various readline functions that set the mark and insert +This is called by various Readline functions that set the mark and insert text, and is available for applications to call. </p></dd></dl> @@ -3707,10 +3714,10 @@ text, and is available for applications to call. <dl class="def"> <dt id="index-rl_005fkeep_005fmark_005factive"><span class="category">Function: </span><span><em>void</em> <strong>rl_keep_mark_active</strong> <em>(void)</em><a href='#index-rl_005fkeep_005fmark_005factive' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Indicate that the mark should remain active when the current readline function -completes and after redisplay occurs. +<dd><p>Indicate that the mark should remain active when the current Readline +function completes and after redisplay occurs. In most cases, the mark remains active for only the duration of a single -bindable readline function. +bindable Readline function. </p></dd></dl> <dl class="def"> @@ -3730,13 +3737,13 @@ Next: <a href="#A-Readline-Example" accesskey="n" rel="next">A Readline Example< <p>An alternate interface is available to plain <code>readline()</code>. Some applications need to interleave keyboard I/O with file, device, or window system I/O, typically by using a main loop to <code>select()</code> -on various file descriptors. To accommodate this need, readline can +on various file descriptors. To accommodate this need, Readline can also be invoked as a ‘callback’ function from an event loop. There are functions available to make this easy. </p> <dl class="def"> <dt id="index-rl_005fcallback_005fhandler_005finstall"><span class="category">Function: </span><span><em>void</em> <strong>rl_callback_handler_install</strong> <em>(const char *prompt, rl_vcpfunc_t *lhandler)</em><a href='#index-rl_005fcallback_005fhandler_005finstall' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Set up the terminal for readline I/O and display the initial +<dd><p>Set up the terminal for Readline I/O and display the initial expanded value of <var>prompt</var>. Save the value of <var>lhandler</var> to use as a handler function to call when a complete line of input has been entered. @@ -4153,7 +4160,7 @@ a <code>SIGWINCH</code>. <dl class="def"> <dt id="index-rl_005fecho_005fsignal_005fchar"><span class="category">Function: </span><span><em>void</em> <strong>rl_echo_signal_char</strong> <em>(int sig)</em><a href='#index-rl_005fecho_005fsignal_005fchar' class='copiable-anchor'> ¶</a></span></dt> <dd><p>If an application wishes to install its own signal handlers, but still -have readline display characters that generate signals, calling this +have Readline display characters that generate signals, calling this function with <var>sig</var> set to <code>SIGINT</code>, <code>SIGQUIT</code>, or <code>SIGTSTP</code> will display the character generating that signal. </p></dd></dl> @@ -4606,7 +4613,7 @@ shell variables and hostnames. <dl class="def"> <dt id="index-rl_005fcompletion_005fquery_005fitems"><span class="category">Variable: </span><span><em>int</em> <strong>rl_completion_query_items</strong><a href='#index-rl_005fcompletion_005fquery_005fitems' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Up to this many items will be displayed in response to a -possible-completions call. After that, readline asks the user for +possible-completions call. After that, Readline asks the user for confirmation before displaying them. The default value is 100. A negative value indicates that Readline should never ask for confirmation. @@ -4780,6 +4787,7 @@ history list. #include <fcntl.h> #include <stdio.h> #include <errno.h> +#include <locale.h> #if defined (HAVE_STRING_H) # include <string.h> @@ -4860,6 +4868,8 @@ main (argc, argv) { char *line, *s; + setlocale (LC_ALL, ""); + progname = argv[0]; initialize_readline (); /* Bind our completer. */ diff --git a/doc/readline.info b/doc/readline.info index 73b6a97..4ea6b8c 100644 --- a/doc/readline.info +++ b/doc/readline.info @@ -1,8 +1,9 @@ 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 -2022), a library which aids in the consistency of user interface across -discrete programs which provide a command line interface. +This manual describes the GNU Readline Library (version 8.2, 19 +September 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. @@ -155,9 +156,9 @@ Printing characters Undo the last editing command. You can undo all the way back to an empty line. -(Depending on your configuration, the <Backspace> key be set to delete -the character to the left of the cursor and the <DEL> key set to delete -the character underneath the cursor, like 'C-d', rather than the +(Depending on your configuration, the <Backspace> key might be set to +delete the character to the left of the cursor and the <DEL> key set to +delete the character underneath the cursor, like 'C-d', rather than the character to the left of the cursor.) @@ -219,9 +220,9 @@ available to be yanked back later, when you are typing another line. as those used by 'M-f'. 'M-<DEL>' - Kill from the cursor the start of the current word, or, if between - words, to the start of the previous word. Word boundaries are the - same as those used by 'M-b'. + Kill from the cursor to the start of the current word, or, if + between words, to the start of the previous word. Word boundaries + are the same as those used by 'M-b'. 'C-w' Kill from the cursor to the previous whitespace. This is different @@ -469,7 +470,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. @@ -478,7 +481,7 @@ Variable Settings 'echo-control-characters' When set to 'on', on operating systems that indicate they - support it, readline echoes a character corresponding to a + support it, Readline echoes a character corresponding to a signal generated from the keyboard. The default is 'on'. 'editing-mode' @@ -564,7 +567,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 +634,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 @@ -645,7 +652,8 @@ Variable Settings If set to 'on', Readline will undo all changes to history lines before returning when 'accept-line' is executed. By default, history lines may be modified and retain individual - undo lists across calls to 'readline'. The default is 'off'. + undo lists across calls to 'readline()'. The default is + 'off'. 'show-all-if-ambiguous' This alters the default behavior of the completion functions. @@ -672,7 +680,7 @@ Variable Settings If set to 'on', 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 + 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. For instance, if this is enabled, attempting @@ -722,7 +730,7 @@ Key Bindings part of the key name. The name of the key can be expressed in different ways, depending on what you find most comfortable. - In addition to command names, readline allows keys to be bound to a + In addition to command names, Readline allows keys to be bound to a string that is inserted when the key is pressed (a MACRO). KEYNAME: FUNCTION-NAME or MACRO @@ -1444,7 +1452,7 @@ File: readline.info, Node: Keyboard Macros, Next: Miscellaneous Commands, Pre characters in the macro appear as if typed at the keyboard. 'print-last-kbd-macro ()' - Print the last keboard macro defined in a format suitable for the + Print the last keyboard macro defined in a format suitable for the INPUTRC file. @@ -1491,12 +1499,12 @@ File: readline.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up: 'character-search (C-])' A character is read and point is moved to the next occurrence of - that character. A negative count searches for previous + that character. A negative argument searches for previous occurrences. 'character-search-backward (M-C-])' A character is read and point is moved to the previous occurrence - of that character. A negative count searches for subsequent + of that character. A negative argument searches for subsequent occurrences. 'skip-csi-sequence ()' @@ -1504,7 +1512,7 @@ File: readline.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up: 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 "\e[", keys producing such sequences will have - no effect unless explicitly bound to a readline command, instead of + 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-[. @@ -1917,7 +1925,7 @@ These variables are available to function writers. value 0x0402. -- Variable: int rl_gnu_readline_p - Always set to 1, denoting that this is GNU readline rather than + Always set to 1, denoting that this is GNU Readline rather than some emulation. -- Variable: const char * rl_terminal_name @@ -2020,7 +2028,7 @@ These variables are available to function writers. -- Variable: Keymap rl_executing_keymap This variable is set to the keymap (*note Keymaps::) in which the - currently executing readline function was found. + currently executing Readline function was found. -- Variable: Keymap rl_binding_keymap This variable is set to the keymap (*note Keymaps::) in which the @@ -2409,7 +2417,7 @@ associate a new function name with an arbitrary function. invoke FUNCTION in the keymap MAP. -- Function: void rl_function_dumper (int readable) - Print the readline function names and the key sequences currently + Print the Readline function names and the key sequences currently bound to them to 'rl_outstream'. If READABLE is non-zero, the list is formatted in such a way that it can be made part of an 'inputrc' file and re-read. @@ -2650,7 +2658,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 @@ -2807,7 +2815,7 @@ File: readline.info, Node: Miscellaneous Functions, Next: Alternate Interface, -- Function: int rl_variable_bind (const char *variable, const char *value) Make the Readline variable VARIABLE have VALUE. This behaves as if - the readline command 'set VARIABLE VALUE' had been executed in an + the Readline command 'set VARIABLE VALUE' had been executed in an 'inputrc' file (*note Readline Init File Syntax::). -- Function: char * rl_variable_value (const char *variable) @@ -2816,7 +2824,7 @@ File: readline.info, Node: Miscellaneous Functions, Next: Alternate Interface, 'off'. -- Function: void rl_variable_dumper (int readable) - Print the readline variable names and their current values to + Print the Readline variable names and their current values to 'rl_outstream'. If READABLE is non-zero, the list is formatted in such a way that it can be made part of an 'inputrc' file and re-read. @@ -2843,7 +2851,7 @@ File: readline.info, Node: Miscellaneous Functions, Next: Alternate Interface, -- Function: void rl_activate_mark (void) Enable an _active_ mark. When this is enabled, the text between point and mark (the REGION) is displayed in the terminal's standout - mode (a FACE). This is called by various readline functions that + mode (a FACE). This is called by various Readline functions that set the mark and insert text, and is available for applications to call. @@ -2852,9 +2860,9 @@ File: readline.info, Node: Miscellaneous Functions, Next: Alternate Interface, -- Function: void rl_keep_mark_active (void) Indicate that the mark should remain active when the current - readline function completes and after redisplay occurs. In most + Readline function completes and after redisplay occurs. In most cases, the mark remains active for only the duration of a single - bindable readline function. + bindable Readline function. -- Function: int rl_mark_active_p (void) Return a non-zero value if the mark is currently active; zero @@ -2869,13 +2877,13 @@ File: readline.info, Node: Alternate Interface, Next: A Readline Example, Pre An alternate interface is available to plain 'readline()'. Some applications need to interleave keyboard I/O with file, device, or window system I/O, typically by using a main loop to 'select()' on -various file descriptors. To accommodate this need, readline can also +various file descriptors. To accommodate this need, Readline can also be invoked as a 'callback' function from an event loop. There are functions available to make this easy. -- Function: void rl_callback_handler_install (const char *prompt, rl_vcpfunc_t *lhandler) - Set up the terminal for readline I/O and display the initial + Set up the terminal for Readline I/O and display the initial expanded value of PROMPT. Save the value of LHANDLER to use as a handler function to call when a complete line of input has been entered. The handler function receives the text of the line as an @@ -3245,7 +3253,7 @@ to update its idea of the terminal size when it receives a 'SIGWINCH'. -- Function: void rl_echo_signal_char (int sig) If an application wishes to install its own signal handlers, but - still have readline display characters that generate signals, + still have Readline display characters that generate signals, calling this function with SIG set to 'SIGINT', 'SIGQUIT', or 'SIGTSTP' will display the character generating that signal. @@ -3617,7 +3625,7 @@ File: readline.info, Node: Completion Variables, Next: A Short Completion Exam -- Variable: int rl_completion_query_items Up to this many items will be displayed in response to a - possible-completions call. After that, readline asks the user for + possible-completions call. After that, Readline asks the user for confirmation before displaying them. The default value is 100. A negative value indicates that Readline should never ask for confirmation. @@ -3759,6 +3767,7 @@ command names, line editing features, and access to the history list. #include <fcntl.h> #include <stdio.h> #include <errno.h> + #include <locale.h> #if defined (HAVE_STRING_H) # include <string.h> @@ -3839,6 +3848,8 @@ command names, line editing features, and access to the history list. { char *line, *s; + setlocale (LC_ALL, ""); + progname = argv[0]; initialize_readline (); /* Bind our completer. */ @@ -4793,7 +4804,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) @@ -4804,19 +4815,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. @@ -4825,7 +4836,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) @@ -4834,29 +4845,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. @@ -4866,19 +4877,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) @@ -4889,10 +4900,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. @@ -4909,7 +4920,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. @@ -5202,13 +5213,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) + (line 326) * show-all-if-unmodified: Readline Init File Syntax. - (line 325) + (line 332) * show-mode-in-prompt: Readline Init File Syntax. - (line 334) + (line 341) * skip-completed-text: Readline Init File Syntax. - (line 340) + (line 347) * skip-csi-sequence (): Miscellaneous Commands. (line 52) * start-kbd-macro (C-x (): Keyboard Macros. (line 6) @@ -5228,13 +5239,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 360) * vi-editing-mode (M-C-j): Miscellaneous Commands. (line 92) * vi-ins-mode-string: Readline Init File Syntax. - (line 364) + (line 371) * visible-stats: Readline Init File Syntax. - (line 375) + (line 382) * yank (C-y): Commands For Killing. (line 70) * yank-last-arg (M-. or M-_): Commands For History. @@ -5247,59 +5258,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 License177170 -Node: Concept Index202344 -Node: Function and Variable Index203865 +Node: Top866 +Node: Command Line Editing1591 +Node: Introduction and Notation2243 +Node: Readline Interaction3867 +Node: Readline Bare Essentials5059 +Node: Readline Movement Commands6849 +Node: Readline Killing Commands7810 +Node: Readline Arguments9732 +Node: Searching10777 +Node: Readline Init File12930 +Node: Readline Init File Syntax14086 +Node: Conditional Init Constructs37389 +Node: Sample Init File41586 +Node: Bindable Readline Commands44711 +Node: Commands For Moving45766 +Node: Commands For History47525 +Node: Commands For Text52489 +Node: Commands For Killing56192 +Node: Numeric Arguments58906 +Node: Commands For Completion60046 +Node: Keyboard Macros62015 +Node: Miscellaneous Commands62704 +Node: Readline vi Mode66632 +Node: Programming with GNU Readline68449 +Node: Basic Behavior69435 +Node: Custom Functions73118 +Node: Readline Typedefs74601 +Node: Function Writing76235 +Node: Readline Variables77549 +Node: Readline Convenience Functions91224 +Node: Function Naming92296 +Node: Keymaps93558 +Node: Binding Keys96637 +Node: Associating Function Names and Bindings101185 +Node: Allowing Undoing104415 +Node: Redisplay106965 +Node: Modifying Text111024 +Node: Character Input112271 +Node: Terminal Management115352 +Node: Utility Functions117175 +Node: Miscellaneous Functions120503 +Node: Alternate Interface123922 +Node: A Readline Example126664 +Node: Alternate Interface Example128603 +Node: Readline Signal Handling132135 +Node: Custom Completers141388 +Node: How Completing Works142108 +Node: Completion Functions145415 +Node: Completion Variables148989 +Node: A Short Completion Example164795 +Node: GNU Free Documentation License177632 +Node: Concept Index202806 +Node: Function and Variable Index204327 End Tag Table diff --git a/doc/readline.pdf b/doc/readline.pdf Binary files differindex 1c2b843..b0925cd 100644 --- a/doc/readline.pdf +++ b/doc/readline.pdf diff --git a/doc/readline.ps b/doc/readline.ps index 00d1f5b..011e8cb 100644 --- a/doc/readline.ps +++ b/doc/readline.ps @@ -1,8 +1,8 @@ %!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: readline.dvi -%%CreationDate: Fri Apr 8 19:52:34 2022 -%%Pages: 85 +%%CreationDate: Tue Sep 20 14:17:05 2022 +%%Pages: 86 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 %%DocumentFonts: CMBX12 CMR10 CMTT10 CMSY10 CMMI12 CMMI10 CMCSC10 @@ -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.04.08:1552 +%DVIPSSource: TeX output 2022.09.20:1017 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -6654,21 +6654,21 @@ rf /Fp 135[85 117 1[90 63 64 66 1[90 81 90 134 45 2[45 rf /Fr 134[71 71 97 71 75 52 53 55 1[75 67 75 112 37 2[37 75 67 41 61 75 60 75 65 7[102 1[139 102 103 94 75 100 101 92 101 105 128 81 105 1[50 105 106 85 88 103 -97 96 102 6[37 67 67 67 67 67 67 67 67 67 2[37 1[37 44[{}57 -119.552 /CMBX12 rf /Fs 129[48 48 48 48 48 48 48 48 48 +97 96 102 6[37 67 67 67 67 67 67 67 67 67 67 1[37 1[37 +44[{}58 119.552 /CMBX12 rf /Fs 129[48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 -48 48 48 48 48 48 48 1[48 48 48 48 48 48 48 48 48 48 -48 48 48 48 48 48 1[48 48 1[48 48 48 48 48 48 48 48 48 -48 48 48 48 48 48 48 48 48 48 48 48 33[{}91 90.9091 /CMTT10 -rf /Ft 131[91 45 40 48 48 66 48 51 35 36 36 48 51 45 -51 76 25 48 28 25 51 45 28 40 51 40 51 45 25 2[25 45 -25 56 68 68 93 68 68 66 51 67 71 62 71 68 83 57 71 47 -33 68 71 59 62 69 66 64 68 71 4[25 25 45 45 45 45 45 -45 45 45 45 45 45 25 30 25 2[35 35 25 2[45 1[45 19[76 -51 51 53 11[{}84 90.9091 /CMR10 rf /Fu 134[102 6[79 3[108 -1[54 2[54 3[88 108 1[108 94 11[149 2[144 3[151 1[116 -4[152 71[{}14 172.154 /CMBX12 rf end +48 48 48 48 48 48 48 48 48 48 1[48 48 48 48 48 48 48 +48 48 48 48 48 48 48 48 48 1[48 48 1[48 48 48 48 48 48 +48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 33[{}91 +90.9091 /CMTT10 rf /Ft 131[91 45 40 48 48 66 48 51 35 +36 36 48 51 45 51 76 25 48 28 25 51 45 28 40 51 40 51 +45 25 2[25 45 25 56 68 68 93 68 68 66 51 67 71 62 71 +68 83 57 71 47 33 68 71 59 62 69 66 64 68 71 4[25 25 +45 45 45 45 45 45 45 45 45 45 45 25 30 25 2[35 35 25 +2[45 1[45 19[76 51 51 53 11[{}84 90.9091 /CMR10 rf /Fu +134[102 6[79 3[108 1[54 2[54 3[88 108 1[108 94 11[149 +2[144 3[151 1[116 4[152 71[{}14 172.154 /CMBX12 rf end %%EndProlog %%BeginSetup %%Feature: *Resolution 600dpi @@ -6684,28 +6684,29 @@ 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.)3118 +1623 y(Septem)m(b)s(er)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 -(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 -4767 y Fq(\015)f Ft(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 Ft(This)21 b(man)m(ual)g(describ)s(es) +g(the)g(GNU)h(Readline)g(Library)f(\(v)m(ersion)h(8.2,)i(19)e(Septem)m +(b)s(er)f(2022\),)26 b(a)21 b(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 4767 y Fq(\015)f Ft(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 @@ -6877,12 +6878,12 @@ b Fn(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:) h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)28 b Ft(60)150 991 y Fr(App)t(endix)44 b(A)119 b(GNU)39 b(F)-11 b(ree)38 b(Do)t(cumen)l(tation)i(License)25 b Fo(:)20 -b(:)32 b Fr(69)150 1269 y(Concept)45 b(Index)36 b Fo(:)19 +b(:)32 b Fr(70)150 1269 y(Concept)45 b(Index)36 b Fo(:)19 b(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f (:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:) -h(:)49 b Fr(77)150 1548 y(F)-11 b(unction)44 b(and)h(V)-11 +h(:)49 b Fr(78)150 1548 y(F)-11 b(unction)44 b(and)h(V)-11 b(ariable)45 b(Index)20 b Fo(:)g(:)f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:) -f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)33 b Fr(78)p +f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)33 b Fr(79)p eop end %%Page: 1 5 TeXDict begin 1 4 bop 3705 -116 a Ft(1)150 299 y Fp(1)80 @@ -6990,33 +6991,33 @@ m(haracter)i(to)f(the)g(left)g(of)f(the)h(cursor.)150 (cursor.)150 1596 y Fl(C-_)e Ft(or)i Fl(C-x)e(C-u)630 1706 y Ft(Undo)k(the)h(last)g(editing)g(command.)50 b(Y)-8 b(ou)34 b(can)f(undo)g(all)h(the)f(w)m(a)m(y)i(bac)m(k)f(to)g(an)g -(empt)m(y)630 1815 y(line.)150 1977 y(\(Dep)s(ending)29 -b(on)h(y)m(our)f(con\014guration,)i(the)e Fs(Backspace)e -Ft(k)m(ey)k(b)s(e)d(set)j(to)f(delete)h(the)e(c)m(haracter)i(to)g(the) -150 2087 y(left)37 b(of)f(the)h(cursor)e(and)h(the)g -Fs(DEL)g Ft(k)m(ey)h(set)f(to)h(delete)h(the)e(c)m(haracter)i -(underneath)d(the)h(cursor,)i(lik)m(e)150 2196 y Fl(C-d)p -Ft(,)30 b(rather)g(than)g(the)h(c)m(haracter)h(to)f(the)f(left)h(of)g -(the)f(cursor.\))150 2398 y Fi(1.2.2)63 b(Readline)40 -b(Mo)m(v)m(emen)m(t)h(Commands)150 2545 y Ft(The)27 b(ab)s(o)m(v)m(e)i -(table)g(describ)s(es)e(the)g(most)i(basic)f(k)m(eystrok)m(es)h(that)f -(y)m(ou)g(need)g(in)f(order)g(to)i(do)e(editing)i(of)150 -2654 y(the)k(input)f(line.)49 b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m -(enience,)j(man)m(y)d(other)g(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g -(in)h(addition)150 2764 y(to)j Fl(C-b)p Ft(,)f Fl(C-f)p -Ft(,)g Fl(C-d)p Ft(,)h(and)e Fs(DEL)p Ft(.)54 b(Here)35 -b(are)g(some)h(commands)e(for)h(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h -(the)150 2873 y(line.)150 3035 y Fl(C-a)336 b Ft(Mo)m(v)m(e)32 -b(to)g(the)e(start)h(of)g(the)f(line.)150 3197 y Fl(C-e)336 -b Ft(Mo)m(v)m(e)32 b(to)g(the)e(end)g(of)g(the)h(line.)150 -3358 y Fl(M-f)336 b Ft(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f -(where)g(a)h(w)m(ord)f(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.) -150 3519 y Fl(M-b)336 b Ft(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m -(ord.)150 3680 y Fl(C-l)336 b Ft(Clear)31 b(the)f(screen,)h(reprin)m -(ting)f(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275 -3843 y(Notice)c(ho)m(w)f Fl(C-f)e Ft(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m -(haracter,)j(while)d Fl(M-f)e Ft(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m -(ord.)39 b(It)24 b(is)h(a)g(lo)s(ose)150 3952 y(con)m(v)m(en)m(tion)32 +(empt)m(y)630 1815 y(line.)150 1977 y(\(Dep)s(ending)c(on)g(y)m(our)g +(con\014guration,)h(the)f Fs(Backspace)d Ft(k)m(ey)k(migh)m(t)g(b)s(e)e +(set)i(to)g(delete)g(the)f(c)m(haracter)150 2087 y(to)h(the)f(left)h +(of)f(the)g(cursor)f(and)h(the)g Fs(DEL)f Ft(k)m(ey)i(set)g(to)f +(delete)i(the)e(c)m(haracter)h(underneath)e(the)h(cursor,)150 +2196 y(lik)m(e)i Fl(C-d)p Ft(,)d(rather)i(than)f(the)g(c)m(haracter)i +(to)f(the)g(left)g(of)g(the)f(cursor.\))150 2398 y Fi(1.2.2)63 +b(Readline)40 b(Mo)m(v)m(emen)m(t)h(Commands)150 2545 +y Ft(The)27 b(ab)s(o)m(v)m(e)i(table)g(describ)s(es)e(the)g(most)i +(basic)f(k)m(eystrok)m(es)h(that)f(y)m(ou)g(need)g(in)f(order)g(to)i +(do)e(editing)i(of)150 2654 y(the)k(input)f(line.)49 +b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m(enience,)j(man)m(y)d(other)g +(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g(in)h(addition)150 +2764 y(to)j Fl(C-b)p Ft(,)f Fl(C-f)p Ft(,)g Fl(C-d)p +Ft(,)h(and)e Fs(DEL)p Ft(.)54 b(Here)35 b(are)g(some)h(commands)e(for)h +(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h(the)150 2873 +y(line.)150 3035 y Fl(C-a)336 b Ft(Mo)m(v)m(e)32 b(to)g(the)e(start)h +(of)g(the)f(line.)150 3197 y Fl(C-e)336 b Ft(Mo)m(v)m(e)32 +b(to)g(the)e(end)g(of)g(the)h(line.)150 3358 y Fl(M-f)336 +b Ft(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f(where)g(a)h(w)m(ord)f +(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.)150 +3519 y Fl(M-b)336 b Ft(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m(ord.) +150 3680 y Fl(C-l)336 b Ft(Clear)31 b(the)f(screen,)h(reprin)m(ting)f +(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275 3843 y(Notice)c(ho)m(w)f +Fl(C-f)e Ft(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m(haracter,)j(while)d +Fl(M-f)e Ft(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m(ord.)39 +b(It)24 b(is)h(a)g(lo)s(ose)150 3952 y(con)m(v)m(en)m(tion)32 b(that)f(con)m(trol)g(k)m(eystrok)m(es)h(op)s(erate)e(on)g(c)m (haracters)h(while)f(meta)h(k)m(eystrok)m(es)h(op)s(erate)e(on)150 4062 y(w)m(ords.)150 4263 y Fi(1.2.3)63 b(Readline)40 @@ -7051,14 +7052,14 @@ b(is)h(the)f(list)h(of)g(commands)f(for)g(killing)h(text.)150 (of)h(the)f(curren)m(t)g(w)m(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m (ords,)g(to)g(the)630 723 y(end)j(of)g(the)h(next)f(w)m(ord.)41 b(W)-8 b(ord)30 b(b)s(oundaries)f(are)i(the)g(same)f(as)h(those)g(used) -f(b)m(y)g Fl(M-f)p Ft(.)150 881 y Fl(M-DEL)240 b Ft(Kill)31 -b(from)f(the)h(cursor)f(the)g(start)h(of)g(the)g(curren)m(t)f(w)m(ord,) -h(or,)f(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)i(the)630 -991 y(start)39 b(of)f(the)h(previous)f(w)m(ord.)64 b(W)-8 -b(ord)39 b(b)s(oundaries)e(are)i(the)f(same)h(as)g(those)f(used)g(b)m -(y)630 1100 y Fl(M-b)p Ft(.)150 1258 y Fl(C-w)336 b Ft(Kill)35 -b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.)55 -b(This)34 b(is)h(di\013eren)m(t)h(than)e Fl(M-DEL)630 +f(b)m(y)g Fl(M-f)p Ft(.)150 881 y Fl(M-DEL)240 b Ft(Kill)34 +b(from)f(the)g(cursor)g(to)h(the)g(start)g(of)g(the)f(curren)m(t)g(w)m +(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m(ords,)g(to)630 +991 y(the)28 b(start)g(of)g(the)g(previous)f(w)m(ord.)39 +b(W)-8 b(ord)28 b(b)s(oundaries)e(are)i(the)g(same)g(as)g(those)g(used) +f(b)m(y)630 1100 y Fl(M-b)p Ft(.)150 1258 y Fl(C-w)336 +b Ft(Kill)35 b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.) +55 b(This)34 b(is)h(di\013eren)m(t)h(than)e Fl(M-DEL)630 1367 y Ft(b)s(ecause)c(the)h(w)m(ord)f(b)s(oundaries)f(di\013er.)275 1525 y(Here)42 b(is)f(ho)m(w)h(to)g Fj(y)m(ank)47 b Ft(the)42 b(text)g(bac)m(k)h(in)m(to)f(the)g(line.)74 b(Y)-8 b(anking)43 @@ -7284,64 +7285,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) @@ -7353,8 +7357,8 @@ b(Command)29 b(Line)i(Editing)2153 b(7)630 299 y Fs(disable-completion) Fs(off)p Ft('.)630 774 y Fs(echo-control-characters)1110 883 y Ft(When)f(set)h(to)g(`)p Fs(on)p Ft(',)f(on)g(op)s(erating)h (systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 993 -y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m(haracter)h(corresp)s(onding)d -(to)j(a)f(signal)g(generated)1110 1103 y(from)e(the)g(k)m(eyb)s(oard.) +y(it,)e(Readline)g(ec)m(ho)s(es)g(a)f(c)m(haracter)i(corresp)s(onding)d +(to)i(a)f(signal)h(generated)1110 1103 y(from)h(the)g(k)m(eyb)s(oard.) 41 b(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 1249 y Fs(editing-mode)1110 1358 y Ft(The)d Fs(editing-mode)e Ft(v)-5 b(ariable)29 b(con)m(trols)h(whic)m(h)e(default)h(set)h(of)e(k) @@ -7468,406 +7472,410 @@ 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)g(is)h(`)p Fs(off)p Ft('.)630 2193 +y Fs(show-all-if-ambiguous)1110 2303 y Ft(This)e(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)k(completion)i(in)e(the)g(middle)g(of)g(a)h(w)m(ord.)46 +b(If)32 b(enabled,)g(Readline)h(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 -(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 -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 -(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 -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 -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) -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 -eop end +(what)h(y)m(ou)g(\014nd)e(most)630 3888 y(comfortable.)630 +4025 y(In)g(addition)h(to)g(command)g(names,)g(Readline)g(allo)m(ws)h +(k)m(eys)g(to)f(b)s(e)f(b)s(ound)f(to)i(a)g(string)630 +4134 y(that)d(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 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 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 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 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 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 @@ -8371,23 +8379,24 @@ y(de\014nition.)150 3413 y Fs(call-last-kbd-macro)c(\(C-x)k(e\))630 (de\014ned,)f(b)m(y)h(making)f(the)g(c)m(haracters)i(in)e(the)630 3632 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m(eyb)s (oard.)150 3788 y Fs(print-last-kbd-macro)25 b(\(\))630 -3897 y Ft(Prin)m(t)30 b(the)h(last)g(k)m(eb)s(oard)f(macro)h(de\014ned) -e(in)i(a)f(format)h(suitable)g(for)f(the)h Fj(inputrc)k -Ft(\014le.)150 4092 y Fi(1.4.8)63 b(Some)41 b(Miscellaneous)i(Commands) -150 4262 y Fs(re-read-init-file)26 b(\(C-x)j(C-r\))630 -4372 y Ft(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of)f(the)g -Fj(inputrc)27 b Ft(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h(bindings)d -(or)i(v)-5 b(ariable)630 4481 y(assignmen)m(ts)31 b(found)e(there.)150 -4637 y Fs(abort)g(\(C-g\))630 4746 y Ft(Ab)s(ort)d(the)h(curren)m(t)f -(editing)h(command)f(and)g(ring)h(the)f(terminal's)h(b)s(ell)g(\(sub)5 -b(ject)26 b(to)i(the)630 4856 y(setting)j(of)g Fs(bell-style)p -Ft(\).)150 5011 y Fs(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p -Fl(x)p Fs(,)g(...)o(\))630 5121 y Ft(If)35 b(the)g(meta\014ed)g(c)m -(haracter)i Fj(x)k Ft(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g -(that)g(is)g(b)s(ound)e(to)630 5230 y(the)g(corresp)s(onding)f -(meta\014ed)h(lo)m(w)m(er)i(case)f(c)m(haracter.)50 b(The)32 -b(b)s(eha)m(vior)h(is)g(unde\014ned)e(if)630 5340 y Fj(x)37 -b Ft(is)30 b(already)h(lo)m(w)m(er)h(case.)p eop end +3897 y Ft(Prin)m(t)30 b(the)g(last)h(k)m(eyb)s(oard)f(macro)h +(de\014ned)e(in)h(a)g(format)h(suitable)g(for)f(the)g +Fj(inputrc)35 b Ft(\014le.)150 4092 y Fi(1.4.8)63 b(Some)41 +b(Miscellaneous)i(Commands)150 4262 y Fs(re-read-init-file)26 +b(\(C-x)j(C-r\))630 4372 y Ft(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of) +f(the)g Fj(inputrc)27 b Ft(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h +(bindings)d(or)i(v)-5 b(ariable)630 4481 y(assignmen)m(ts)31 +b(found)e(there.)150 4637 y Fs(abort)g(\(C-g\))630 4746 +y Ft(Ab)s(ort)d(the)h(curren)m(t)f(editing)h(command)f(and)g(ring)h +(the)f(terminal's)h(b)s(ell)g(\(sub)5 b(ject)26 b(to)i(the)630 +4856 y(setting)j(of)g Fs(bell-style)p Ft(\).)150 5011 +y Fs(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p Fl(x)p +Fs(,)g(...)o(\))630 5121 y Ft(If)35 b(the)g(meta\014ed)g(c)m(haracter)i +Fj(x)k Ft(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g(that)g(is)g +(b)s(ound)e(to)630 5230 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w) +m(er)i(case)f(c)m(haracter.)50 b(The)32 b(b)s(eha)m(vior)h(is)g +(unde\014ned)e(if)630 5340 y Fj(x)37 b Ft(is)30 b(already)h(lo)m(w)m +(er)h(case.)p eop end %%Page: 24 28 TeXDict begin 24 27 bop 150 -116 a Ft(Chapter)30 b(1:)41 b(Command)29 b(Line)i(Editing)2107 b(24)150 299 y Fs(prefix-meta)27 @@ -8414,21 +8423,21 @@ g(the)g(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f 2513 y Fs(character-search)26 b(\(C-]\))630 2622 y Ft(A)f(c)m(haracter) h(is)f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g (o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 2732 y(A)30 -b(negativ)m(e)j(coun)m(t)e(searc)m(hes)g(for)f(previous)g(o)s +b(negativ)m(e)j(argumen)m(t)e(searc)m(hes)g(for)f(previous)g(o)s (ccurrences.)150 2918 y Fs(character-search-backwar)o(d)24 b(\(M-C-]\))630 3028 y Ft(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s (oin)m(t)h(is)g(mo)m(v)m(ed)h(to)f(the)g(previous)f(o)s(ccurrence)h(of) -g(that)630 3137 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(coun)m(t)f -(searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)150 +g(that)630 3137 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(argumen)m(t)f +(searc)m(hes)g(for)g(subsequen)m(t)e(o)s(ccurrences.)150 3324 y Fs(skip-csi-sequence)d(\(\))630 3433 y Ft(Read)i(enough)f(c)m (haracters)h(to)g(consume)f(a)h(m)m(ulti-k)m(ey)h(sequence)f(suc)m(h)f (as)g(those)h(de\014ned)630 3543 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g (and)f(End.)60 b(Suc)m(h)37 b(sequences)g(b)s(egin)g(with)g(a)h(Con)m (trol)g(Sequence)630 3652 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 b(If)36 b(this)g(sequence)h(is)g(b)s(ound)d(to)k Fs("\\)p -Ft(e[)p Fs(")p Ft(,)g(k)m(eys)f(pro-)630 3762 y(ducing)31 -b(suc)m(h)h(sequences)g(will)h(ha)m(v)m(e)g(no)f(e\013ect)h(unless)e -(explicitly)j(b)s(ound)c(to)i(a)h(readline)630 3871 y(command,)f +Ft(e[)p Fs(")p Ft(,)g(k)m(eys)f(pro-)630 3762 y(ducing)29 +b(suc)m(h)g(sequences)g(will)h(ha)m(v)m(e)h(no)e(e\013ect)i(unless)d +(explicitly)j(b)s(ound)d(to)i(a)f(Readline)630 3871 y(command,)j (instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g(in)m(to)g(the)f (editing)h(bu\013er.)44 b(This)31 b(is)630 3981 y(un)m(b)s(ound)d(b)m (y)i(default,)h(but)f(usually)g(b)s(ound)e(to)j(ESC-[.)150 @@ -8820,7 +8829,7 @@ b(F)-8 b(or)38 b(example,)i(for)d(Readline-4.2,)k Fs -5 b(alue)31 b(0x0402.)3371 4268 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_gnu_readline_p)390 4378 y Ft(Alw)m(a)m(ys)32 b(set)f(to)g(1,)g(denoting)f(that)h(this)g(is)f Fm(gnu)g -Ft(readline)h(rather)f(than)g(some)h(em)m(ulation.)3371 +Ft(Readline)h(rather)f(than)h(some)f(em)m(ulation.)3371 4585 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g (rl_terminal_name)390 4695 y Ft(The)28 b(terminal)g(t)m(yp)s(e,)h(used) e(for)h(initialization.)43 b(If)28 b(not)g(set)h(b)m(y)e(the)i @@ -8958,8 +8967,8 @@ b(erminal)30 b(Managemen)m(t],)j(page)e(43\).)3371 3017 y([V)-8 b(ariable])-3598 b Fh(Keymap)54 b(rl_executing_keymap)390 3126 y Ft(This)35 b(v)-5 b(ariable)37 b(is)f(set)g(to)h(the)f(k)m (eymap)h(\(see)g(Section)f(2.4.2)i([Keymaps],)g(page)e(35\))i(in)d -(whic)m(h)390 3236 y(the)c(curren)m(tly)f(executing)i(readline)e -(function)g(w)m(as)h(found.)3371 3422 y([V)-8 b(ariable])-3598 +(whic)m(h)390 3236 y(the)c(curren)m(tly)f(executing)i(Readline)f +(function)f(w)m(as)g(found.)3371 3422 y([V)-8 b(ariable])-3598 b Fh(Keymap)54 b(rl_binding_keymap)390 3532 y Ft(This)35 b(v)-5 b(ariable)37 b(is)f(set)g(to)h(the)f(k)m(eymap)h(\(see)g (Section)f(2.4.2)i([Keymaps],)g(page)e(35\))i(in)d(whic)m(h)390 @@ -9405,13 +9414,13 @@ b(Keymap)g(map)p Fg(\))390 4388 y Ft(Return)c(an)i(arra)m(y)f(of)h m(v)m(ok)m(e)h Fj(function)e Ft(in)390 4497 y(the)g(k)m(eymap)f Fj(map)p Ft(.)3350 4699 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_function_dumper)c Fg(\()p Ff(in)m(t)34 b(readable)p -Fg(\))390 4809 y Ft(Prin)m(t)29 b(the)h(readline)f(function)g(names)g -(and)g(the)g(k)m(ey)h(sequences)g(curren)m(tly)f(b)s(ound)e(to)j(them)f -(to)390 4919 y Fs(rl_outstream)p Ft(.)36 b(If)27 b Fj(readable)33 -b Ft(is)28 b(non-zero,)h(the)e(list)i(is)e(formatted)h(in)f(suc)m(h)g -(a)h(w)m(a)m(y)h(that)f(it)g(can)390 5028 y(b)s(e)i(made)g(part)g(of)h -(an)f Fs(inputrc)f Ft(\014le)h(and)g(re-read.)3350 5230 -y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_list_funmap_names)d +Fg(\))390 4809 y Ft(Prin)m(t)i(the)g(Readline)g(function)g(names)f(and) +g(the)h(k)m(ey)h(sequences)f(curren)m(tly)g(b)s(ound)d(to)k(them)390 +4919 y(to)32 b Fs(rl_outstream)p Ft(.)40 b(If)31 b Fj(readable)36 +b Ft(is)c(non-zero,)g(the)f(list)h(is)f(formatted)h(in)f(suc)m(h)g(a)g +(w)m(a)m(y)i(that)e(it)390 5028 y(can)g(b)s(e)e(made)i(part)f(of)h(an)f +Fs(inputrc)e Ft(\014le)j(and)e(re-read.)3350 5230 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_list_funmap_names)d Fg(\()p Ff(v)m(oid)p Fg(\))390 5340 y Ft(Prin)m(t)30 b(the)h(names)f(of)h(all)g(bindable)f(Readline)h(functions)f(to)h Fs(rl_outstream)p Ft(.)p eop end @@ -9704,9 +9713,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 @@ -9902,32 +9911,32 @@ b Ft(is)c(non-zero,)g(the)f(list)h(is)f(formatted)h(in)f(suc)m(h)g(a)g Fs(inputrc)e Ft(\014le)j(and)e(re-read.)3350 1603 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_variable_bind)e Fg(\()p Ff(const)34 b(c)m(har)f(*v)-6 b(ariable,)33 b(const)h(c)m(har)f(*v)-6 -b(alue)p Fg(\))390 1713 y Ft(Mak)m(e)31 b(the)e(Readline)g(v)-5 -b(ariable)30 b Fj(v)-5 b(ariable)35 b Ft(ha)m(v)m(e)30 -b Fj(v)-5 b(alue)p Ft(.)41 b(This)28 b(b)s(eha)m(v)m(es)h(as)h(if)f -(the)g(readline)g(com-)390 1822 y(mand)h(`)p Fs(set)g -Fl(variable)e(value)p Ft(')h(had)h(b)s(een)h(executed)g(in)g(an)f -Fs(inputrc)f Ft(\014le)i(\(see)h(Section)f(1.3.1)390 -1932 y([Readline)g(Init)f(File)i(Syn)m(tax],)f(page)g(4\).)3350 -2106 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_variable_value)f -Fg(\()p Ff(const)34 b(c)m(har)g(*v)-6 b(ariable)p Fg(\))390 -2215 y Ft(Return)28 b(a)i(string)f(represen)m(ting)h(the)f(v)-5 -b(alue)30 b(of)f(the)h(Readline)g(v)-5 b(ariable)30 b -Fj(v)-5 b(ariable)p Ft(.)41 b(F)-8 b(or)30 b(b)s(o)s(olean)390 -2325 y(v)-5 b(ariables,)31 b(this)g(string)f(is)g(either)h(`)p -Fs(on)p Ft(')f(or)h(`)p Fs(off)p Ft('.)3350 2499 y([F)-8 -b(unction])-3599 b Fh(void)54 b(rl_variable_dumper)c -Fg(\()p Ff(in)m(t)34 b(readable)p Fg(\))390 2608 y Ft(Prin)m(t)29 -b(the)f(readline)h(v)-5 b(ariable)30 b(names)e(and)g(their)h(curren)m -(t)f(v)-5 b(alues)29 b(to)h Fs(rl_outstream)p Ft(.)37 -b(If)28 b Fj(read-)390 2718 y(able)40 b Ft(is)34 b(non-zero,)i(the)e -(list)g(is)g(formatted)h(in)f(suc)m(h)g(a)g(w)m(a)m(y)h(that)g(it)f -(can)g(b)s(e)g(made)g(part)g(of)g(an)390 2827 y Fs(inputrc)28 -b Ft(\014le)j(and)f(re-read.)3350 3001 y([F)-8 b(unction])-3599 -b Fh(int)53 b(rl_set_paren_blink_ti)q(meou)q(t)f Fg(\()p -Ff(in)m(t)33 b(u)p Fg(\))390 3111 y Ft(Set)25 b(the)h(time)f(in)m(terv) --5 b(al)27 b(\(in)e(microseconds\))h(that)g(Readline)f(w)m(aits)h(when) -e(sho)m(wing)i(a)f(balancing)390 3220 y(c)m(haracter)32 +b(alue)p Fg(\))390 1713 y Ft(Mak)m(e)28 b(the)f(Readline)g(v)-5 +b(ariable)27 b Fj(v)-5 b(ariable)32 b Ft(ha)m(v)m(e)c +Fj(v)-5 b(alue)p Ft(.)40 b(This)25 b(b)s(eha)m(v)m(es)i(as)g(if)f(the)h +(Readline)g(com-)390 1822 y(mand)j(`)p Fs(set)g Fl(variable)e(value)p +Ft(')h(had)h(b)s(een)h(executed)g(in)g(an)f Fs(inputrc)f +Ft(\014le)i(\(see)h(Section)f(1.3.1)390 1932 y([Readline)g(Init)f(File) +i(Syn)m(tax],)f(page)g(4\).)3350 2106 y([F)-8 b(unction])-3599 +b Fh(char)54 b(*)e(rl_variable_value)f Fg(\()p Ff(const)34 +b(c)m(har)g(*v)-6 b(ariable)p Fg(\))390 2215 y Ft(Return)28 +b(a)i(string)f(represen)m(ting)h(the)f(v)-5 b(alue)30 +b(of)f(the)h(Readline)g(v)-5 b(ariable)30 b Fj(v)-5 b(ariable)p +Ft(.)41 b(F)-8 b(or)30 b(b)s(o)s(olean)390 2325 y(v)-5 +b(ariables,)31 b(this)g(string)f(is)g(either)h(`)p Fs(on)p +Ft(')f(or)h(`)p Fs(off)p Ft('.)3350 2499 y([F)-8 b(unction])-3599 +b Fh(void)54 b(rl_variable_dumper)c Fg(\()p Ff(in)m(t)34 +b(readable)p Fg(\))390 2608 y Ft(Prin)m(t)44 b(the)h(Readline)g(v)-5 +b(ariable)45 b(names)f(and)g(their)g(curren)m(t)g(v)-5 +b(alues)45 b(to)g Fs(rl_outstream)p Ft(.)79 b(If)390 +2718 y Fj(readable)37 b Ft(is)32 b(non-zero,)h(the)e(list)i(is)e +(formatted)h(in)g(suc)m(h)f(a)h(w)m(a)m(y)h(that)f(it)g(can)g(b)s(e)f +(made)g(part)h(of)390 2827 y(an)e Fs(inputrc)f Ft(\014le)h(and)g +(re-read.)3350 3001 y([F)-8 b(unction])-3599 b Fh(int)53 +b(rl_set_paren_blink_ti)q(meou)q(t)f Fg(\()p Ff(in)m(t)33 +b(u)p Fg(\))390 3111 y Ft(Set)25 b(the)h(time)f(in)m(terv)-5 +b(al)27 b(\(in)e(microseconds\))h(that)g(Readline)f(w)m(aits)h(when)e +(sho)m(wing)i(a)f(balancing)390 3220 y(c)m(haracter)32 b(when)d Fs(blink-matching-paren)c Ft(has)30 b(b)s(een)g(enabled.)3350 3394 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_get_termcap)e Fg(\()p Ff(const)34 b(c)m(har)g(*cap)p Fg(\))390 3504 @@ -9955,9 +9964,9 @@ b(this)f(is)h(enabled,)g(the)g(text)h(b)s(et)m(w)m(een)f(p)s(oin)m(t)g (and)f(mark)g(\(the)390 4837 y Fj(region)p Ft(\))c(is)f(displa)m(y)m (ed)h(in)f(the)g(terminal's)h(standout)f(mo)s(de)f(\(a)i Fj(face)5 b Ft(\).)40 b(This)24 b(is)g(called)h(b)m(y)f(v)-5 -b(arious)390 4947 y(readline)30 b(functions)f(that)i(set)f(the)g(mark)g -(and)f(insert)h(text,)h(and)e(is)h(a)m(v)-5 b(ailable)32 -b(for)e(applications)390 5057 y(to)h(call.)3350 5230 +b(arious)390 4947 y(Readline)28 b(functions)f(that)h(set)g(the)f(mark)g +(and)g(insert)g(text,)j(and)c(is)i(a)m(v)-5 b(ailable)30 +b(for)d(applications)390 5057 y(to)k(call.)3350 5230 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_deactivate_mark)c Fg(\()p Ff(v)m(oid)p Fg(\))390 5340 y Ft(T)-8 b(urn)29 b(o\013)i(the)f(activ)m(e)j(mark.)p eop end @@ -9965,12 +9974,12 @@ b(o\013)i(the)f(activ)m(e)j(mark.)p eop end TeXDict begin 46 49 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(46)3350 299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_keep_mark_active)d -Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Indicate)28 b(that)g(the)g -(mark)f(should)f(remain)h(activ)m(e)j(when)d(the)g(curren)m(t)g -(readline)h(function)f(com-)390 518 y(pletes)h(and)f(after)h(redispla)m -(y)f(o)s(ccurs.)40 b(In)27 b(most)g(cases,)i(the)f(mark)f(remains)g -(activ)m(e)j(for)d(only)h(the)390 628 y(duration)i(of)g(a)h(single)g -(bindable)f(readline)h(function.)3350 799 y([F)-8 b(unction])-3599 +Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Indicate)45 b(that)g(the)g +(mark)f(should)g(remain)g(activ)m(e)j(when)c(the)i(curren)m(t)f +(Readline)h(function)390 518 y(completes)28 b(and)e(after)h(redispla)m +(y)g(o)s(ccurs.)40 b(In)26 b(most)h(cases,)h(the)f(mark)g(remains)f +(activ)m(e)j(for)e(only)390 628 y(the)k(duration)f(of)g(a)h(single)g +(bindable)f(Readline)h(function.)3350 799 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_mark_active_p)e Fg(\()p Ff(v)m(oid)p Fg(\))390 909 y Ft(Return)30 b(a)g(non-zero)h(v)-5 b(alue)31 b(if)f(the)h(mark)f(is)h(curren)m(tly)f(activ)m(e;)j(zero)e(otherwise.) @@ -9980,18 +9989,18 @@ b(ailable)24 b(to)e(plain)g Fs(readline\(\))p Ft(.)35 b(Some)21 b(applications)i(need)f(to)g(in)m(terlea)m(v)m(e)150 1356 y(k)m(eyb)s(oard)35 b(I/O)h(with)f(\014le,)i(device,)h(or)e(windo) m(w)f(system)g(I/O,)h(t)m(ypically)i(b)m(y)d(using)g(a)h(main)g(lo)s -(op)f(to)150 1466 y Fs(select\(\))42 b Ft(on)i(v)-5 b(arious)45 -b(\014le)f(descriptors.)83 b(T)-8 b(o)45 b(accommo)s(date)h(this)e -(need,)k(readline)d(can)f(also)i(b)s(e)150 1576 y(in)m(v)m(ok)m(ed)33 +(op)f(to)150 1466 y Fs(select\(\))40 b Ft(on)i(v)-5 b(arious)42 +b(\014le)g(descriptors.)76 b(T)-8 b(o)43 b(accommo)s(date)h(this)e +(need,)j(Readline)e(can)f(also)i(b)s(e)150 1576 y(in)m(v)m(ok)m(ed)33 b(as)e(a)h(`callbac)m(k')h(function)e(from)g(an)g(ev)m(en)m(t)h(lo)s (op.)44 b(There)30 b(are)i(functions)f(a)m(v)-5 b(ailable)33 b(to)f(mak)m(e)150 1685 y(this)e(easy)-8 b(.)3350 1857 y([F)g(unction])-3599 b Fh(void)54 b(rl_callback_handler_inst)q(all)e Fg(\()p Ff(const)34 b(c)m(har)g(*prompt,)565 1966 y(rl)p 639 1966 30 5 v 44 w(v)m(cpfunc)p 1016 1966 V 45 w(t)f(*lhandler)p -Fg(\))390 2076 y Ft(Set)25 b(up)f(the)h(terminal)g(for)f(readline)i -(I/O)e(and)g(displa)m(y)h(the)g(initial)h(expanded)e(v)-5 -b(alue)26 b(of)f Fj(prompt)p Ft(.)390 2186 y(Sa)m(v)m(e)34 +Fg(\))390 2076 y Ft(Set)23 b(up)e(the)i(terminal)g(for)f(Readline)h +(I/O)g(and)f(displa)m(y)h(the)f(initial)i(expanded)e(v)-5 +b(alue)23 b(of)g Fj(prompt)p Ft(.)390 2186 y(Sa)m(v)m(e)34 b(the)f(v)-5 b(alue)33 b(of)g Fj(lhandler)39 b Ft(to)34 b(use)e(as)h(a)g(handler)f(function)h(to)g(call)h(when)e(a)h(complete)i (line)390 2295 y(of)h(input)f(has)g(b)s(een)g(en)m(tered.)57 @@ -10363,9 +10372,9 @@ b Ft(to)28 b(force)g(Readline)f(to)h(up)s(date)f(its)g(idea)h(of)f(the) g(terminal)150 4820 y(size)k(when)f(it)h(receiv)m(es)h(a)e Fs(SIGWINCH)p Ft(.)3350 5011 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_echo_signal_char)d Fg(\()p Ff(in)m(t)33 -b(sig)p Fg(\))390 5121 y Ft(If)43 b(an)g(application)i(wishes)e(to)i -(install)f(its)g(o)m(wn)f(signal)i(handlers,)h(but)c(still)j(ha)m(v)m -(e)g(readline)390 5230 y(displa)m(y)31 b(c)m(haracters)h(that)f +b(sig)p Fg(\))390 5121 y Ft(If)41 b(an)g(application)h(wishes)f(to)h +(install)g(its)f(o)m(wn)g(signal)h(handlers,)h(but)e(still)h(ha)m(v)m +(e)g(Readline)390 5230 y(displa)m(y)31 b(c)m(haracters)h(that)f (generate)h(signals,)f(calling)h(this)e(function)g(with)g Fj(sig)39 b Ft(set)31 b(to)g Fs(SIGINT)p Ft(,)390 5340 y Fs(SIGQUIT)p Ft(,)e(or)h Fs(SIGTSTP)e Ft(will)j(displa)m(y)g(the)f(c) @@ -10866,12 +10875,12 @@ b(ariable)28 b(to)h Fs(")p Ft($@)p Fs(")e Ft(so)h(that)g(it)h(can)390 3943 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_query_i)q (tems)390 4052 y Ft(Up)36 b(to)h(this)f(man)m(y)g(items)h(will)f(b)s(e) g(displa)m(y)m(ed)h(in)e(resp)s(onse)h(to)h(a)f(p)s -(ossible-completions)h(call.)390 4162 y(After)e(that,)i(readline)e -(asks)g(the)g(user)f(for)h(con\014rmation)g(b)s(efore)f(displa)m(ying)h -(them.)54 b(The)35 b(de-)390 4271 y(fault)42 b(v)-5 b(alue)43 -b(is)f(100.)77 b(A)42 b(negativ)m(e)i(v)-5 b(alue)42 -b(indicates)h(that)g(Readline)g(should)e(nev)m(er)h(ask)g(for)390 -4381 y(con\014rmation.)3371 4573 y([V)-8 b(ariable])-3598 +(ossible-completions)h(call.)390 4162 y(After)44 b(that,)49 +b(Readline)c(asks)f(the)h(user)e(for)h(con\014rmation)h(b)s(efore)e +(displa)m(ying)i(them.)82 b(The)390 4271 y(default)36 +b(v)-5 b(alue)37 b(is)f(100.)58 b(A)36 b(negativ)m(e)i(v)-5 +b(alue)37 b(indicates)g(that)f(Readline)h(should)e(nev)m(er)h(ask)g +(for)390 4381 y(con\014rmation.)3371 4573 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_append_)q(char)q(act)q(er)390 4682 y Ft(When)33 b(a)h(single)f(completion)i(alternativ)m(e)h(matc)m (hes)e(at)g(the)f(end)g(of)g(the)h(command)f(line,)h(this)390 @@ -11039,275 +11048,280 @@ b(<sys/file.h>)390 1258 y(#endif)390 1345 y(#include)h(<sys/stat.h>)390 1519 y(#ifdef)g(HAVE_UNISTD_H)390 1606 y(#)79 b(include)40 b(<unistd.h>)390 1694 y(#endif)390 1868 y(#include)h(<fcntl.h>)390 1955 y(#include)g(<stdio.h>)390 2042 y(#include)g(<errno.h>)390 -2217 y(#if)f(defined)h(\(HAVE_STRING_H\))390 2304 y(#)79 -b(include)40 b(<string.h>)390 2391 y(#else)g(/*)g(!HAVE_STRING_H)i(*/) -390 2478 y(#)79 b(include)40 b(<strings.h>)390 2565 y(#endif)h(/*)e -(!HAVE_STRING_H)k(*/)390 2740 y(#ifdef)e(HAVE_STDLIB_H)390 -2827 y(#)79 b(include)40 b(<stdlib.h>)390 2914 y(#endif)390 -3088 y(#include)h(<time.h>)390 3263 y(#include)g(<readline/readline.h>) -390 3350 y(#include)g(<readline/history.h>)390 3524 y(extern)g(char)f -(*xmalloc)h(PARAMS\(\(size_t\)\);)390 3699 y(/*)f(The)g(names)g(of)g +2130 y(#include)g(<locale.h>)390 2304 y(#if)f(defined)h +(\(HAVE_STRING_H\))390 2391 y(#)79 b(include)40 b(<string.h>)390 +2478 y(#else)g(/*)g(!HAVE_STRING_H)i(*/)390 2565 y(#)79 +b(include)40 b(<strings.h>)390 2653 y(#endif)h(/*)e(!HAVE_STRING_H)k +(*/)390 2827 y(#ifdef)e(HAVE_STDLIB_H)390 2914 y(#)79 +b(include)40 b(<stdlib.h>)390 3001 y(#endif)390 3176 +y(#include)h(<time.h>)390 3350 y(#include)g(<readline/readline.h>)390 +3437 y(#include)g(<readline/history.h>)390 3611 y(extern)g(char)f +(*xmalloc)h(PARAMS\(\(size_t\)\);)390 3786 y(/*)f(The)g(names)g(of)g (functions)h(that)f(actually)h(do)f(the)g(manipulation.)i(*/)390 -3786 y(int)e(com_list)h(PARAMS\(\(char)h(*\)\);)390 3873 -y(int)e(com_view)h(PARAMS\(\(char)h(*\)\);)390 3960 y(int)e(com_rename) -h(PARAMS\(\(char)h(*\)\);)390 4047 y(int)e(com_stat)h(PARAMS\(\(char)h -(*\)\);)390 4134 y(int)e(com_pwd)h(PARAMS\(\(char)h(*\)\);)390 -4222 y(int)e(com_delete)h(PARAMS\(\(char)h(*\)\);)390 -4309 y(int)e(com_help)h(PARAMS\(\(char)h(*\)\);)390 4396 -y(int)e(com_cd)g(PARAMS\(\(char)i(*\)\);)390 4483 y(int)e(com_quit)h -(PARAMS\(\(char)h(*\)\);)390 4658 y(/*)e(A)f(structure)i(which)g +3873 y(int)e(com_list)h(PARAMS\(\(char)h(*\)\);)390 3960 +y(int)e(com_view)h(PARAMS\(\(char)h(*\)\);)390 4047 y(int)e(com_rename) +h(PARAMS\(\(char)h(*\)\);)390 4134 y(int)e(com_stat)h(PARAMS\(\(char)h +(*\)\);)390 4222 y(int)e(com_pwd)h(PARAMS\(\(char)h(*\)\);)390 +4309 y(int)e(com_delete)h(PARAMS\(\(char)h(*\)\);)390 +4396 y(int)e(com_help)h(PARAMS\(\(char)h(*\)\);)390 4483 +y(int)e(com_cd)g(PARAMS\(\(char)i(*\)\);)390 4570 y(int)e(com_quit)h +(PARAMS\(\(char)h(*\)\);)390 4745 y(/*)e(A)f(structure)i(which)g (contains)g(information)h(on)d(the)h(commands)h(this)f(program)508 -4745 y(can)g(understand.)h(*/)390 4919 y(typedef)g(struct)f({)468 -5006 y(char)h(*name;)f(/*)g(User)g(printable)h(name)f(of)g(the)g -(function.)h(*/)468 5093 y(rl_icpfunc_t)h(*func;)f(/*)f(Function)h(to)e -(call)i(to)e(do)h(the)g(job.)g(*/)468 5181 y(char)h(*doc;)f(/*)g -(Documentation)i(for)e(this)g(function.)80 b(*/)390 5268 -y(})39 b(COMMAND;)p eop end +4832 y(can)g(understand.)h(*/)390 5006 y(typedef)g(struct)f({)468 +5093 y(char)h(*name;)f(/*)g(User)g(printable)h(name)f(of)g(the)g +(function.)h(*/)468 5181 y(rl_icpfunc_t)h(*func;)f(/*)f(Function)h(to)e +(call)i(to)e(do)h(the)g(job.)g(*/)468 5268 y(char)h(*doc;)f(/*)g +(Documentation)i(for)e(this)g(function.)80 b(*/)p eop +end %%Page: 62 66 TeXDict begin 62 65 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(62)390 -386 y Fe(COMMAND)41 b(commands[])g(=)f({)468 473 y({)g("cd",)g(com_cd,) -h("Change)g(to)f(directory)h(DIR")f(},)468 560 y({)g("delete",)h -(com_delete,)h("Delete)f(FILE")f(},)468 648 y({)g("help",)h(com_help,)g -("Display)g(this)f(text")h(},)468 735 y({)f("?",)g(com_help,)h -("Synonym)g(for)f(`help'")h(},)468 822 y({)f("list",)h(com_list,)g -("List)f(files)h(in)e(DIR")i(},)468 909 y({)f("ls",)g(com_list,)i -("Synonym)f(for)f(`list'")g(},)468 996 y({)g("pwd",)g(com_pwd,)i -("Print)e(the)g(current)h(working)g(directory")g(},)468 -1083 y({)f("quit",)h(com_quit,)g("Quit)f(using)h(Fileman")g(},)468 -1171 y({)f("rename",)h(com_rename,)h("Rename)f(FILE)f(to)g(NEWNAME")h -(},)468 1258 y({)f("stat",)h(com_stat,)g("Print)g(out)f(statistics)h -(on)f(FILE")g(},)468 1345 y({)g("view",)h(com_view,)g("View)f(the)g -(contents)h(of)f(FILE")g(},)468 1432 y({)g(\(char)g(*\)NULL,)h -(\(rl_icpfunc_t)h(*\)NULL,)f(\(char)f(*\)NULL)h(})390 -1519 y(};)390 1694 y(/*)f(Forward)g(declarations.)j(*/)390 -1781 y(char)d(*stripwhite)i(\(\);)390 1868 y(COMMAND)f(*find_command)h -(\(\);)390 2042 y(/*)e(The)g(name)g(of)f(this)i(program,)g(as)e(taken)i -(from)f(argv[0].)h(*/)390 2130 y(char)f(*progname;)390 -2304 y(/*)g(When)g(non-zero,)h(this)f(global)h(means)f(the)g(user)g(is) -g(done)g(using)g(this)h(program.)g(*/)390 2391 y(int)f(done;)390 -2565 y(char)g(*)390 2653 y(dupstr)h(\(s\))586 2740 y(char)f(*s;)390 -2827 y({)468 2914 y(char)h(*r;)468 3088 y(r)f(=)f(xmalloc)i(\(strlen)g -(\(s\))f(+)f(1\);)468 3176 y(strcpy)i(\(r,)f(s\);)468 -3263 y(return)h(\(r\);)390 3350 y(})390 3524 y(main)f(\(argc,)h(argv\)) -586 3611 y(int)f(argc;)586 3699 y(char)g(**argv;)390 -3786 y({)468 3873 y(char)h(*line,)f(*s;)468 4047 y(progname)h(=)f -(argv[0];)468 4222 y(initialize_readline)k(\(\);)c(/*)g(Bind)g(our)g -(completer.)h(*/)468 4396 y(/*)f(Loop)g(reading)h(and)f(executing)h -(lines)g(until)f(the)g(user)g(quits.)h(*/)468 4483 y(for)f(\()g(;)f -(done)h(==)g(0;)g(\))547 4570 y({)625 4658 y(line)g(=)g(readline)h -(\("FileMan:)h("\);)625 4832 y(if)e(\(!line\))704 4919 -y(break;)625 5093 y(/*)g(Remove)h(leading)f(and)g(trailing)h -(whitespace)h(from)e(the)g(line.)743 5181 y(Then,)g(if)g(there)g(is)g -(anything)h(left,)g(add)e(it)h(to)g(the)g(history)h(list)743 -5268 y(and)f(execute)h(it.)f(*/)p eop end +299 y Fe(})39 b(COMMAND;)390 473 y(COMMAND)i(commands[])g(=)f({)468 +560 y({)g("cd",)g(com_cd,)h("Change)g(to)f(directory)h(DIR")f(},)468 +648 y({)g("delete",)h(com_delete,)h("Delete)f(FILE")f(},)468 +735 y({)g("help",)h(com_help,)g("Display)g(this)f(text")h(},)468 +822 y({)f("?",)g(com_help,)h("Synonym)g(for)f(`help'")h(},)468 +909 y({)f("list",)h(com_list,)g("List)f(files)h(in)e(DIR")i(},)468 +996 y({)f("ls",)g(com_list,)i("Synonym)f(for)f(`list'")g(},)468 +1083 y({)g("pwd",)g(com_pwd,)i("Print)e(the)g(current)h(working)g +(directory")g(},)468 1171 y({)f("quit",)h(com_quit,)g("Quit)f(using)h +(Fileman")g(},)468 1258 y({)f("rename",)h(com_rename,)h("Rename)f(FILE) +f(to)g(NEWNAME")h(},)468 1345 y({)f("stat",)h(com_stat,)g("Print)g(out) +f(statistics)h(on)f(FILE")g(},)468 1432 y({)g("view",)h(com_view,)g +("View)f(the)g(contents)h(of)f(FILE")g(},)468 1519 y({)g(\(char)g +(*\)NULL,)h(\(rl_icpfunc_t)h(*\)NULL,)f(\(char)f(*\)NULL)h(})390 +1606 y(};)390 1781 y(/*)f(Forward)g(declarations.)j(*/)390 +1868 y(char)d(*stripwhite)i(\(\);)390 1955 y(COMMAND)f(*find_command)h +(\(\);)390 2130 y(/*)e(The)g(name)g(of)f(this)i(program,)g(as)e(taken)i +(from)f(argv[0].)h(*/)390 2217 y(char)f(*progname;)390 +2391 y(/*)g(When)g(non-zero,)h(this)f(global)h(means)f(the)g(user)g(is) +g(done)g(using)g(this)h(program.)g(*/)390 2478 y(int)f(done;)390 +2653 y(char)g(*)390 2740 y(dupstr)h(\(s\))586 2827 y(char)f(*s;)390 +2914 y({)468 3001 y(char)h(*r;)468 3176 y(r)f(=)f(xmalloc)i(\(strlen)g +(\(s\))f(+)f(1\);)468 3263 y(strcpy)i(\(r,)f(s\);)468 +3350 y(return)h(\(r\);)390 3437 y(})390 3611 y(main)f(\(argc,)h(argv\)) +586 3699 y(int)f(argc;)586 3786 y(char)g(**argv;)390 +3873 y({)468 3960 y(char)h(*line,)f(*s;)468 4134 y(setlocale)i +(\(LC_ALL,)f(""\);)468 4309 y(progname)g(=)f(argv[0];)468 +4483 y(initialize_readline)k(\(\);)c(/*)g(Bind)g(our)g(completer.)h(*/) +468 4658 y(/*)f(Loop)g(reading)h(and)f(executing)h(lines)g(until)f(the) +g(user)g(quits.)h(*/)468 4745 y(for)f(\()g(;)f(done)h(==)g(0;)g(\))547 +4832 y({)625 4919 y(line)g(=)g(readline)h(\("FileMan:)h("\);)625 +5093 y(if)e(\(!line\))704 5181 y(break;)p eop end %%Page: 63 67 TeXDict begin 63 66 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(63)625 -299 y Fe(s)40 b(=)f(stripwhite)j(\(line\);)625 473 y(if)e(\(*s\))704 -560 y({)782 648 y(add_history)i(\(s\);)782 735 y(execute_line)g(\(s\);) -704 822 y(})625 996 y(free)e(\(line\);)547 1083 y(})468 -1171 y(exit)h(\(0\);)390 1258 y(})390 1432 y(/*)f(Execute)g(a)g -(command)h(line.)f(*/)390 1519 y(int)390 1606 y(execute_line)i -(\(line\))586 1694 y(char)e(*line;)390 1781 y({)468 1868 -y(register)h(int)f(i;)468 1955 y(COMMAND)h(*command;)468 -2042 y(char)g(*word;)468 2217 y(/*)f(Isolate)h(the)f(command)h(word.)f -(*/)468 2304 y(i)g(=)f(0;)468 2391 y(while)i(\(line[i])g(&&)f -(whitespace)h(\(line[i]\)\))547 2478 y(i++;)468 2565 -y(word)g(=)e(line)h(+)g(i;)468 2740 y(while)h(\(line[i])g(&&)f -(!whitespace)h(\(line[i]\)\))547 2827 y(i++;)468 3001 -y(if)f(\(line[i]\))547 3088 y(line[i++])h(=)f('\\0';)468 -3263 y(command)h(=)f(find_command)i(\(word\);)468 3437 -y(if)e(\(!command\))547 3524 y({)625 3611 y(fprintf)h(\(stderr,)g +299 y Fe(/*)40 b(Remove)h(leading)f(and)g(trailing)h(whitespace)h(from) +e(the)g(line.)743 386 y(Then,)g(if)g(there)g(is)g(anything)h(left,)g +(add)e(it)h(to)g(the)g(history)h(list)743 473 y(and)f(execute)h(it.)f +(*/)625 560 y(s)g(=)f(stripwhite)j(\(line\);)625 735 +y(if)e(\(*s\))704 822 y({)782 909 y(add_history)i(\(s\);)782 +996 y(execute_line)g(\(s\);)704 1083 y(})625 1258 y(free)e(\(line\);) +547 1345 y(})468 1432 y(exit)h(\(0\);)390 1519 y(})390 +1694 y(/*)f(Execute)g(a)g(command)h(line.)f(*/)390 1781 +y(int)390 1868 y(execute_line)i(\(line\))586 1955 y(char)e(*line;)390 +2042 y({)468 2130 y(register)h(int)f(i;)468 2217 y(COMMAND)h(*command;) +468 2304 y(char)g(*word;)468 2478 y(/*)f(Isolate)h(the)f(command)h +(word.)f(*/)468 2565 y(i)g(=)f(0;)468 2653 y(while)i(\(line[i])g(&&)f +(whitespace)h(\(line[i]\)\))547 2740 y(i++;)468 2827 +y(word)g(=)e(line)h(+)g(i;)468 3001 y(while)h(\(line[i])g(&&)f +(!whitespace)h(\(line[i]\)\))547 3088 y(i++;)468 3263 +y(if)f(\(line[i]\))547 3350 y(line[i++])h(=)f('\\0';)468 +3524 y(command)h(=)f(find_command)i(\(word\);)468 3699 +y(if)e(\(!command\))547 3786 y({)625 3873 y(fprintf)h(\(stderr,)g ("\045s:)f(No)g(such)g(command)h(for)f(FileMan.\\n",)i(word\);)625 -3699 y(return)f(\(-1\);)547 3786 y(})468 3960 y(/*)f(Get)g(argument)h -(to)f(command,)h(if)f(any.)g(*/)468 4047 y(while)h(\(whitespace)h -(\(line[i]\)\))547 4134 y(i++;)468 4309 y(word)f(=)e(line)h(+)g(i;)468 -4483 y(/*)g(Call)g(the)g(function.)h(*/)468 4570 y(return)g -(\(\(*\(command->func\)\))j(\(word\)\);)390 4658 y(})390 -4832 y(/*)c(Look)g(up)f(NAME)i(as)e(the)h(name)g(of)g(a)g(command,)h -(and)e(return)i(a)f(pointer)g(to)g(that)508 4919 y(command.)80 +3960 y(return)f(\(-1\);)547 4047 y(})468 4222 y(/*)f(Get)g(argument)h +(to)f(command,)h(if)f(any.)g(*/)468 4309 y(while)h(\(whitespace)h +(\(line[i]\)\))547 4396 y(i++;)468 4570 y(word)f(=)e(line)h(+)g(i;)468 +4745 y(/*)g(Call)g(the)g(function.)h(*/)468 4832 y(return)g +(\(\(*\(command->func\)\))j(\(word\)\);)390 4919 y(})390 +5093 y(/*)c(Look)g(up)f(NAME)i(as)e(the)h(name)g(of)g(a)g(command,)h +(and)e(return)i(a)f(pointer)g(to)g(that)508 5181 y(command.)80 b(Return)41 b(a)e(NULL)h(pointer)h(if)f(NAME)g(isn't)g(a)g(command)g -(name.)h(*/)390 5006 y(COMMAND)g(*)390 5093 y(find_command)h(\(name\)) -586 5181 y(char)e(*name;)390 5268 y({)p eop end +(name.)h(*/)390 5268 y(COMMAND)g(*)p eop end %%Page: 64 68 TeXDict begin 64 67 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(64)468 -299 y Fe(register)41 b(int)f(i;)468 473 y(for)g(\(i)g(=)f(0;)h -(commands[i].name;)j(i++\))547 560 y(if)d(\(strcmp)g(\(name,)h -(commands[i].name\))i(==)d(0\))625 648 y(return)h(\(&commands[i]\);)468 -822 y(return)g(\(\(COMMAND)g(*\)NULL\);)390 909 y(})390 -1083 y(/*)f(Strip)g(whitespace)i(from)e(the)g(start)g(and)g(end)g(of)f -(STRING.)81 b(Return)40 b(a)g(pointer)508 1171 y(into)g(STRING.)h(*/) -390 1258 y(char)f(*)390 1345 y(stripwhite)h(\(string\))586 -1432 y(char)f(*string;)390 1519 y({)468 1606 y(register)h(char)g(*s,)f -(*t;)468 1781 y(for)g(\(s)g(=)f(string;)i(whitespace)h(\(*s\);)e(s++\)) -547 1868 y(;)468 2042 y(if)g(\(*s)g(==)g(0\))547 2130 -y(return)g(\(s\);)468 2304 y(t)g(=)f(s)h(+)f(strlen)i(\(s\))f(-)f(1;) -468 2391 y(while)i(\(t)e(>)h(s)f(&&)h(whitespace)i(\(*t\)\))547 -2478 y(t--;)468 2565 y(*++t)f(=)e('\\0';)468 2740 y(return)i(s;)390 -2827 y(})390 3001 y(/*)f(******************************)q(*****)q(****) +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(64)390 +299 y Fe(find_command)42 b(\(name\))586 386 y(char)e(*name;)390 +473 y({)468 560 y(register)h(int)f(i;)468 735 y(for)g(\(i)g(=)f(0;)h +(commands[i].name;)j(i++\))547 822 y(if)d(\(strcmp)g(\(name,)h +(commands[i].name\))i(==)d(0\))625 909 y(return)h(\(&commands[i]\);)468 +1083 y(return)g(\(\(COMMAND)g(*\)NULL\);)390 1171 y(})390 +1345 y(/*)f(Strip)g(whitespace)i(from)e(the)g(start)g(and)g(end)g(of)f +(STRING.)81 b(Return)40 b(a)g(pointer)508 1432 y(into)g(STRING.)h(*/) +390 1519 y(char)f(*)390 1606 y(stripwhite)h(\(string\))586 +1694 y(char)f(*string;)390 1781 y({)468 1868 y(register)h(char)g(*s,)f +(*t;)468 2042 y(for)g(\(s)g(=)f(string;)i(whitespace)h(\(*s\);)e(s++\)) +547 2130 y(;)468 2304 y(if)g(\(*s)g(==)g(0\))547 2391 +y(return)g(\(s\);)468 2565 y(t)g(=)f(s)h(+)f(strlen)i(\(s\))f(-)f(1;) +468 2653 y(while)i(\(t)e(>)h(s)f(&&)h(whitespace)i(\(*t\)\))547 +2740 y(t--;)468 2827 y(*++t)f(=)e('\\0';)468 3001 y(return)i(s;)390 +3088 y(})390 3263 y(/*)f(******************************)q(*****)q(****) q(*****)q(****)q(****)q(*****)q(****)q(***)45 b(*/)390 -3088 y(/*)2589 b(*/)390 3176 y(/*)707 b(Interface)41 -b(to)f(Readline)h(Completion)629 b(*/)390 3263 y(/*)2589 -b(*/)390 3350 y(/*)40 b(******************************)q(*****)q(****)q +3350 y(/*)2589 b(*/)390 3437 y(/*)707 b(Interface)41 +b(to)f(Readline)h(Completion)629 b(*/)390 3524 y(/*)2589 +b(*/)390 3611 y(/*)40 b(******************************)q(*****)q(****)q (*****)q(****)q(****)q(*****)q(****)q(***)45 b(*/)390 -3524 y(char)40 b(*command_generator)j(PARAMS\(\(const)g(char)d(*,)f -(int\)\);)390 3611 y(char)h(**fileman_completion)k(PARAMS\(\(const)e -(char)e(*,)g(int,)g(int\)\);)390 3786 y(/*)g(Tell)g(the)g(GNU)g +3786 y(char)40 b(*command_generator)j(PARAMS\(\(const)g(char)d(*,)f +(int\)\);)390 3873 y(char)h(**fileman_completion)k(PARAMS\(\(const)e +(char)e(*,)g(int,)g(int\)\);)390 4047 y(/*)g(Tell)g(the)g(GNU)g (Readline)h(library)g(how)e(to)h(complete.)81 b(We)39 -b(want)h(to)g(try)g(to)g(complete)508 3873 y(on)f(command)i(names)g(if) +b(want)h(to)g(try)g(to)g(complete)508 4134 y(on)f(command)i(names)g(if) e(this)h(is)g(the)g(first)g(word)g(in)g(the)g(line,)g(or)g(on)g -(filenames)508 3960 y(if)f(not.)h(*/)390 4047 y(initialize_readline)k -(\(\))390 4134 y({)468 4222 y(/*)c(Allow)g(conditional)i(parsing)f(of)f -(the)g(~/.inputrc)h(file.)g(*/)468 4309 y(rl_readline_name)i(=)d -("FileMan";)468 4483 y(/*)g(Tell)g(the)g(completer)h(that)g(we)e(want)h -(a)g(crack)g(first.)h(*/)468 4570 y(rl_attempted_completion_fun)q(ctio) -q(n)k(=)39 b(fileman_completion;)390 4658 y(})390 4832 +(filenames)508 4222 y(if)f(not.)h(*/)390 4309 y(initialize_readline)k +(\(\))390 4396 y({)468 4483 y(/*)c(Allow)g(conditional)i(parsing)f(of)f +(the)g(~/.inputrc)h(file.)g(*/)468 4570 y(rl_readline_name)i(=)d +("FileMan";)468 4745 y(/*)g(Tell)g(the)g(completer)h(that)g(we)e(want)h +(a)g(crack)g(first.)h(*/)468 4832 y(rl_attempted_completion_fun)q(ctio) +q(n)k(=)39 b(fileman_completion;)390 4919 y(})390 5093 y(/*)h(Attempt)g(to)g(complete)h(on)f(the)g(contents)h(of)f(TEXT.)79 -b(START)41 b(and)e(END)h(bound)h(the)508 4919 y(region)f(of)g +b(START)41 b(and)e(END)h(bound)h(the)508 5181 y(region)f(of)g (rl_line_buffer)i(that)f(contains)g(the)e(word)i(to)e(complete.)81 -b(TEXT)40 b(is)508 5006 y(the)g(word)g(to)f(complete.)81 -b(We)40 b(can)g(use)f(the)h(entire)h(contents)g(of)f(rl_line_buffer)508 -5093 y(in)f(case)h(we)g(want)g(to)g(do)g(some)g(simple)g(parsing.)81 -b(Return)40 b(the)g(array)h(of)e(matches,)508 5181 y(or)g(NULL)h(if)g -(there)h(aren't)f(any.)g(*/)390 5268 y(char)g(**)p eop -end +b(TEXT)40 b(is)508 5268 y(the)g(word)g(to)f(complete.)81 +b(We)40 b(can)g(use)f(the)h(entire)h(contents)g(of)f(rl_line_buffer)p +eop end %%Page: 65 69 TeXDict begin 65 68 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(65)390 -299 y Fe(fileman_completion)43 b(\(text,)e(start,)g(end\))586 -386 y(const)f(char)h(*text;)586 473 y(int)f(start,)h(end;)390 -560 y({)468 648 y(char)g(**matches;)468 822 y(matches)g(=)f(\(char)g -(**\)NULL;)468 996 y(/*)g(If)g(this)g(word)g(is)g(at)f(the)h(start)h +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(65)508 +299 y Fe(in)39 b(case)h(we)g(want)g(to)g(do)g(some)g(simple)g(parsing.) +81 b(Return)40 b(the)g(array)h(of)e(matches,)508 386 +y(or)g(NULL)h(if)g(there)h(aren't)f(any.)g(*/)390 473 +y(char)g(**)390 560 y(fileman_completion)j(\(text,)e(start,)g(end\))586 +648 y(const)f(char)h(*text;)586 735 y(int)f(start,)h(end;)390 +822 y({)468 909 y(char)g(**matches;)468 1083 y(matches)g(=)f(\(char)g +(**\)NULL;)468 1258 y(/*)g(If)g(this)g(word)g(is)g(at)f(the)h(start)h (of)e(the)h(line,)h(then)f(it)g(is)f(a)h(command)586 -1083 y(to)g(complete.)80 b(Otherwise)42 b(it)d(is)h(the)g(name)g(of)g -(a)f(file)h(in)g(the)g(current)586 1171 y(directory.)i(*/)468 -1258 y(if)e(\(start)h(==)e(0\))547 1345 y(matches)i(=)e +1345 y(to)g(complete.)80 b(Otherwise)42 b(it)d(is)h(the)g(name)g(of)g +(a)f(file)h(in)g(the)g(current)586 1432 y(directory.)i(*/)468 +1519 y(if)e(\(start)h(==)e(0\))547 1606 y(matches)i(=)e (rl_completion_matches)44 b(\(text,)d(command_generator\);)468 -1519 y(return)g(\(matches\);)390 1606 y(})390 1781 y(/*)f(Generator)h +1781 y(return)g(\(matches\);)390 1868 y(})390 2042 y(/*)f(Generator)h (function)g(for)f(command)h(completion.)81 b(STATE)40 -b(lets)g(us)g(know)g(whether)508 1868 y(to)f(start)i(from)f(scratch;)h +b(lets)g(us)g(know)g(whether)508 2130 y(to)f(start)i(from)f(scratch;)h (without)g(any)f(state)g(\(i.e.)g(STATE)h(==)e(0\),)h(then)g(we)508 -1955 y(start)g(at)g(the)g(top)g(of)f(the)h(list.)h(*/)390 -2042 y(char)f(*)390 2130 y(command_generator)j(\(text,)e(state\))586 -2217 y(const)f(char)h(*text;)586 2304 y(int)f(state;)390 -2391 y({)468 2478 y(static)h(int)f(list_index,)i(len;)468 -2565 y(char)f(*name;)468 2740 y(/*)f(If)g(this)g(is)g(a)f(new)h(word)g +2217 y(start)g(at)g(the)g(top)g(of)f(the)h(list.)h(*/)390 +2304 y(char)f(*)390 2391 y(command_generator)j(\(text,)e(state\))586 +2478 y(const)f(char)h(*text;)586 2565 y(int)f(state;)390 +2653 y({)468 2740 y(static)h(int)f(list_index,)i(len;)468 +2827 y(char)f(*name;)468 3001 y(/*)f(If)g(this)g(is)g(a)f(new)h(word)g (to)g(complete,)h(initialize)h(now.)79 b(This)40 b(includes)586 -2827 y(saving)h(the)f(length)g(of)g(TEXT)g(for)g(efficiency,)i(and)e -(initializing)i(the)d(index)586 2914 y(variable)i(to)f(0.)g(*/)468 -3001 y(if)g(\(!state\))547 3088 y({)625 3176 y(list_index)i(=)d(0;)625 -3263 y(len)h(=)g(strlen)g(\(text\);)547 3350 y(})468 -3524 y(/*)g(Return)h(the)f(next)g(name)g(which)g(partially)i(matches)e -(from)h(the)e(command)i(list.)g(*/)468 3611 y(while)g(\(name)f(=)g -(commands[list_index].name\))547 3699 y({)625 3786 y(list_index++;)625 -3960 y(if)g(\(strncmp)h(\(name,)g(text,)f(len\))g(==)g(0\))704 -4047 y(return)g(\(dupstr\(name\)\);)547 4134 y(})468 -4309 y(/*)g(If)g(no)f(names)i(matched,)g(then)f(return)h(NULL.)f(*/)468 -4396 y(return)h(\(\(char)g(*\)NULL\);)390 4483 y(})390 -4658 y(/*)f(******************************)q(*****)q(****)q(*****)q -(****)q(****)q(*****)q(****)q(***)45 b(*/)390 4745 y(/*)2589 -b(*/)390 4832 y(/*)903 b(FileMan)41 b(Commands)1060 b(*/)390 -4919 y(/*)2589 b(*/)390 5006 y(/*)40 b(******************************)q +3088 y(saving)h(the)f(length)g(of)g(TEXT)g(for)g(efficiency,)i(and)e +(initializing)i(the)d(index)586 3176 y(variable)i(to)f(0.)g(*/)468 +3263 y(if)g(\(!state\))547 3350 y({)625 3437 y(list_index)i(=)d(0;)625 +3524 y(len)h(=)g(strlen)g(\(text\);)547 3611 y(})468 +3786 y(/*)g(Return)h(the)f(next)g(name)g(which)g(partially)i(matches)e +(from)h(the)e(command)i(list.)g(*/)468 3873 y(while)g(\(name)f(=)g +(commands[list_index].name\))547 3960 y({)625 4047 y(list_index++;)625 +4222 y(if)g(\(strncmp)h(\(name,)g(text,)f(len\))g(==)g(0\))704 +4309 y(return)g(\(dupstr\(name\)\);)547 4396 y(})468 +4570 y(/*)g(If)g(no)f(names)i(matched,)g(then)f(return)h(NULL.)f(*/)468 +4658 y(return)h(\(\(char)g(*\)NULL\);)390 4745 y(})390 +4919 y(/*)f(******************************)q(*****)q(****)q(*****)q +(****)q(****)q(*****)q(****)q(***)45 b(*/)390 5006 y(/*)2589 +b(*/)390 5093 y(/*)903 b(FileMan)41 b(Commands)1060 b(*/)390 +5181 y(/*)2589 b(*/)390 5268 y(/*)40 b(******************************)q (*****)q(****)q(*****)q(****)q(****)q(*****)q(****)q(***)45 -b(*/)390 5181 y(/*)40 b(String)g(to)g(pass)g(to)g(system)g(\(\).)80 -b(This)40 b(is)f(for)h(the)g(LIST,)h(VIEW)f(and)g(RENAME)508 -5268 y(commands.)h(*/)p eop end +b(*/)p eop end %%Page: 66 70 TeXDict begin 66 69 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(66)390 -299 y Fe(static)41 b(char)f(syscom[1024];)390 473 y(/*)g(List)g(the)g -(file\(s\))h(named)f(in)g(arg.)g(*/)390 560 y(com_list)h(\(arg\))586 -648 y(char)f(*arg;)390 735 y({)468 822 y(if)g(\(!arg\))547 -909 y(arg)g(=)f("";)468 1083 y(sprintf)i(\(syscom,)g("ls)f(-FClg)h -(\045s",)f(arg\);)468 1171 y(return)h(\(system)g(\(syscom\)\);)390 -1258 y(})390 1432 y(com_view)g(\(arg\))586 1519 y(char)f(*arg;)390 -1606 y({)468 1694 y(if)g(\(!valid_argument)j(\("view",)e(arg\)\))547 -1781 y(return)f(1;)390 1955 y(#if)g(defined)h(\(__MSDOS__\))468 -2042 y(/*)f(more.com)h(doesn't)g(grok)f(slashes)h(in)f(pathnames)h(*/) -468 2130 y(sprintf)g(\(syscom,)g("less)g(\045s",)f(arg\);)390 -2217 y(#else)468 2304 y(sprintf)h(\(syscom,)g("more)g(\045s",)f(arg\);) -390 2391 y(#endif)468 2478 y(return)h(\(system)g(\(syscom\)\);)390 -2565 y(})390 2740 y(com_rename)g(\(arg\))586 2827 y(char)f(*arg;)390 -2914 y({)468 3001 y(too_dangerous)j(\("rename"\);)468 -3088 y(return)e(\(1\);)390 3176 y(})390 3350 y(com_stat)g(\(arg\))586 -3437 y(char)f(*arg;)390 3524 y({)468 3611 y(struct)h(stat)f(finfo;)468 -3786 y(if)g(\(!valid_argument)j(\("stat",)e(arg\)\))547 -3873 y(return)f(\(1\);)468 4047 y(if)g(\(stat)g(\(arg,)h(&finfo\))g(==) -e(-1\))547 4134 y({)625 4222 y(perror)i(\(arg\);)625 -4309 y(return)g(\(1\);)547 4396 y(})468 4570 y(printf)g(\("Statistics)h -(for)e(`\045s':\\n",)h(arg\);)468 4745 y(printf)g(\("\045s)f(has)g +386 y Fe(/*)40 b(String)g(to)g(pass)g(to)g(system)g(\(\).)80 +b(This)40 b(is)f(for)h(the)g(LIST,)h(VIEW)f(and)g(RENAME)508 +473 y(commands.)h(*/)390 560 y(static)g(char)f(syscom[1024];)390 +735 y(/*)g(List)g(the)g(file\(s\))h(named)f(in)g(arg.)g(*/)390 +822 y(com_list)h(\(arg\))586 909 y(char)f(*arg;)390 996 +y({)468 1083 y(if)g(\(!arg\))547 1171 y(arg)g(=)f("";)468 +1345 y(sprintf)i(\(syscom,)g("ls)f(-FClg)h(\045s",)f(arg\);)468 +1432 y(return)h(\(system)g(\(syscom\)\);)390 1519 y(})390 +1694 y(com_view)g(\(arg\))586 1781 y(char)f(*arg;)390 +1868 y({)468 1955 y(if)g(\(!valid_argument)j(\("view",)e(arg\)\))547 +2042 y(return)f(1;)390 2217 y(#if)g(defined)h(\(__MSDOS__\))468 +2304 y(/*)f(more.com)h(doesn't)g(grok)f(slashes)h(in)f(pathnames)h(*/) +468 2391 y(sprintf)g(\(syscom,)g("less)g(\045s",)f(arg\);)390 +2478 y(#else)468 2565 y(sprintf)h(\(syscom,)g("more)g(\045s",)f(arg\);) +390 2653 y(#endif)468 2740 y(return)h(\(system)g(\(syscom\)\);)390 +2827 y(})390 3001 y(com_rename)g(\(arg\))586 3088 y(char)f(*arg;)390 +3176 y({)468 3263 y(too_dangerous)j(\("rename"\);)468 +3350 y(return)e(\(1\);)390 3437 y(})390 3611 y(com_stat)g(\(arg\))586 +3699 y(char)f(*arg;)390 3786 y({)468 3873 y(struct)h(stat)f(finfo;)468 +4047 y(if)g(\(!valid_argument)j(\("stat",)e(arg\)\))547 +4134 y(return)f(\(1\);)468 4309 y(if)g(\(stat)g(\(arg,)h(&finfo\))g(==) +e(-1\))547 4396 y({)625 4483 y(perror)i(\(arg\);)625 +4570 y(return)g(\(1\);)547 4658 y(})468 4832 y(printf)g(\("Statistics)h +(for)e(`\045s':\\n",)h(arg\);)468 5006 y(printf)g(\("\045s)f(has)g (\045d)g(link\045s,)h(and)f(is)f(\045d)h(byte\045s)g(in)g(length.\\n",) -468 4832 y(arg,)782 4919 y(finfo.st_nlink,)782 5006 y(\(finfo.st_nlink) -j(==)d(1\))f(?)h("")f(:)h("s",)782 5093 y(finfo.st_size,)782 -5181 y(\(finfo.st_size)j(==)c(1\))h(?)g("")f(:)h("s"\);)468 -5268 y(printf)h(\("Inode)g(Last)f(Change)h(at:)f(\045s",)g(ctime)g -(\(&finfo.st_ctime\)\);)p eop end +468 5093 y(arg,)782 5181 y(finfo.st_nlink,)782 5268 y(\(finfo.st_nlink) +j(==)d(1\))f(?)h("")f(:)h("s",)p eop end %%Page: 67 71 TeXDict begin 67 70 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(67)468 -299 y Fe(printf)41 b(\(")236 b(Last)40 b(access)h(at:)f(\045s",)g -(ctime)g(\(&finfo.st_atime\)\);)468 386 y(printf)h(\(")157 -b(Last)41 b(modified)g(at:)f(\045s",)g(ctime)g(\(&finfo.st_mtime\)\);) -468 473 y(return)h(\(0\);)390 560 y(})390 735 y(com_delete)g(\(arg\)) -586 822 y(char)f(*arg;)390 909 y({)468 996 y(too_dangerous)j -(\("delete"\);)468 1083 y(return)e(\(1\);)390 1171 y(})390 -1345 y(/*)f(Print)g(out)g(help)g(for)g(ARG,)g(or)g(for)g(all)g(of)f -(the)h(commands)h(if)f(ARG)g(is)508 1432 y(not)g(present.)h(*/)390 -1519 y(com_help)g(\(arg\))586 1606 y(char)f(*arg;)390 -1694 y({)468 1781 y(register)h(int)f(i;)468 1868 y(int)g(printed)h(=)f -(0;)468 2042 y(for)g(\(i)g(=)f(0;)h(commands[i].name;)j(i++\))547 -2130 y({)625 2217 y(if)d(\(!*arg)h(||)e(\(strcmp)i(\(arg,)g -(commands[i].name\))i(==)c(0\)\))704 2304 y({)782 2391 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(67)782 +299 y Fe(finfo.st_size,)782 386 y(\(finfo.st_size)43 +b(==)c(1\))h(?)g("")f(:)h("s"\);)468 473 y(printf)h(\("Inode)g(Last)f +(Change)h(at:)f(\045s",)g(ctime)g(\(&finfo.st_ctime\)\);)468 +560 y(printf)h(\(")236 b(Last)40 b(access)h(at:)f(\045s",)g(ctime)g +(\(&finfo.st_atime\)\);)468 648 y(printf)h(\(")157 b(Last)41 +b(modified)g(at:)f(\045s",)g(ctime)g(\(&finfo.st_mtime\)\);)468 +735 y(return)h(\(0\);)390 822 y(})390 996 y(com_delete)g(\(arg\))586 +1083 y(char)f(*arg;)390 1171 y({)468 1258 y(too_dangerous)j +(\("delete"\);)468 1345 y(return)e(\(1\);)390 1432 y(})390 +1606 y(/*)f(Print)g(out)g(help)g(for)g(ARG,)g(or)g(for)g(all)g(of)f +(the)h(commands)h(if)f(ARG)g(is)508 1694 y(not)g(present.)h(*/)390 +1781 y(com_help)g(\(arg\))586 1868 y(char)f(*arg;)390 +1955 y({)468 2042 y(register)h(int)f(i;)468 2130 y(int)g(printed)h(=)f +(0;)468 2304 y(for)g(\(i)g(=)f(0;)h(commands[i].name;)j(i++\))547 +2391 y({)625 2478 y(if)d(\(!*arg)h(||)e(\(strcmp)i(\(arg,)g +(commands[i].name\))i(==)c(0\)\))704 2565 y({)782 2653 y(printf)i(\("\045s\\t\\t\045s.\\n",)i(commands[i].name,)g -(commands[i].doc\);)782 2478 y(printed++;)704 2565 y(})547 -2653 y(})468 2827 y(if)d(\(!printed\))547 2914 y({)625 -3001 y(printf)h(\("No)f(commands)h(match)g(`\045s'.)79 -b(Possibilities)42 b(are:\\n",)f(arg\);)625 3176 y(for)f(\(i)g(=)f(0;)h -(commands[i].name;)j(i++\))704 3263 y({)782 3350 y(/*)d(Print)g(in)g -(six)g(columns.)h(*/)782 3437 y(if)f(\(printed)h(==)f(6\))861 -3524 y({)939 3611 y(printed)h(=)e(0;)939 3699 y(printf)i(\("\\n"\);)861 -3786 y(})782 3960 y(printf)g(\("\045s\\t",)g(commands[i].name\);)782 -4047 y(printed++;)704 4134 y(})625 4309 y(if)f(\(printed\))704 -4396 y(printf)g(\("\\n"\);)547 4483 y(})468 4570 y(return)h(\(0\);)390 -4658 y(})390 4832 y(/*)f(Change)g(to)g(the)g(directory)h(ARG.)f(*/)390 -4919 y(com_cd)h(\(arg\))586 5006 y(char)f(*arg;)390 5093 -y({)468 5181 y(if)g(\(chdir)h(\(arg\))f(==)g(-1\))547 -5268 y({)p eop end +(commands[i].doc\);)782 2740 y(printed++;)704 2827 y(})547 +2914 y(})468 3088 y(if)d(\(!printed\))547 3176 y({)625 +3263 y(printf)h(\("No)f(commands)h(match)g(`\045s'.)79 +b(Possibilities)42 b(are:\\n",)f(arg\);)625 3437 y(for)f(\(i)g(=)f(0;)h +(commands[i].name;)j(i++\))704 3524 y({)782 3611 y(/*)d(Print)g(in)g +(six)g(columns.)h(*/)782 3699 y(if)f(\(printed)h(==)f(6\))861 +3786 y({)939 3873 y(printed)h(=)e(0;)939 3960 y(printf)i(\("\\n"\);)861 +4047 y(})782 4222 y(printf)g(\("\045s\\t",)g(commands[i].name\);)782 +4309 y(printed++;)704 4396 y(})625 4570 y(if)f(\(printed\))704 +4658 y(printf)g(\("\\n"\);)547 4745 y(})468 4832 y(return)h(\(0\);)390 +4919 y(})390 5093 y(/*)f(Change)g(to)g(the)g(directory)h(ARG.)f(*/)390 +5181 y(com_cd)h(\(arg\))586 5268 y(char)f(*arg;)p eop +end %%Page: 68 72 TeXDict begin 68 71 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(68)625 -299 y Fe(perror)41 b(\(arg\);)625 386 y(return)g(1;)547 -473 y(})468 648 y(com_pwd)g(\(""\);)468 735 y(return)g(\(0\);)390 -822 y(})390 996 y(/*)f(Print)g(out)g(the)g(current)h(working)g -(directory.)g(*/)390 1083 y(com_pwd)g(\(ignore\))586 -1171 y(char)f(*ignore;)390 1258 y({)468 1345 y(char)h(dir[1024],)g(*s;) -468 1519 y(s)f(=)f(getcwd)i(\(dir,)f(sizeof\(dir\))i(-)e(1\);)468 -1606 y(if)g(\(s)g(==)f(0\))547 1694 y({)625 1781 y(printf)i(\("Error)g -(getting)g(pwd:)f(\045s\\n",)g(dir\);)625 1868 y(return)h(1;)547 -1955 y(})468 2130 y(printf)g(\("Current)g(directory)h(is)d(\045s\\n",)i -(dir\);)468 2217 y(return)g(0;)390 2304 y(})390 2478 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(68)390 +299 y Fe({)468 386 y(if)40 b(\(chdir)h(\(arg\))f(==)g(-1\))547 +473 y({)625 560 y(perror)h(\(arg\);)625 648 y(return)g(1;)547 +735 y(})468 909 y(com_pwd)g(\(""\);)468 996 y(return)g(\(0\);)390 +1083 y(})390 1258 y(/*)f(Print)g(out)g(the)g(current)h(working)g +(directory.)g(*/)390 1345 y(com_pwd)g(\(ignore\))586 +1432 y(char)f(*ignore;)390 1519 y({)468 1606 y(char)h(dir[1024],)g(*s;) +468 1781 y(s)f(=)f(getcwd)i(\(dir,)f(sizeof\(dir\))i(-)e(1\);)468 +1868 y(if)g(\(s)g(==)f(0\))547 1955 y({)625 2042 y(printf)i(\("Error)g +(getting)g(pwd:)f(\045s\\n",)g(dir\);)625 2130 y(return)h(1;)547 +2217 y(})468 2391 y(printf)g(\("Current)g(directory)h(is)d(\045s\\n",)i +(dir\);)468 2478 y(return)g(0;)390 2565 y(})390 2740 y(/*)f(The)g(user)g(wishes)g(to)g(quit)g(using)h(this)f(program.)80 -b(Just)40 b(set)g(DONE)g(non-zero.)h(*/)390 2565 y(com_quit)g(\(arg\)) -586 2653 y(char)f(*arg;)390 2740 y({)468 2827 y(done)h(=)e(1;)468 -2914 y(return)i(\(0\);)390 3001 y(})390 3176 y(/*)f(Function)h(which)f +b(Just)40 b(set)g(DONE)g(non-zero.)h(*/)390 2827 y(com_quit)g(\(arg\)) +586 2914 y(char)f(*arg;)390 3001 y({)468 3088 y(done)h(=)e(1;)468 +3176 y(return)i(\(0\);)390 3263 y(})390 3437 y(/*)f(Function)h(which)f (tells)g(you)g(that)h(you)e(can't)i(do)e(this.)i(*/)390 -3263 y(too_dangerous)h(\(caller\))586 3350 y(char)e(*caller;)390 -3437 y({)468 3524 y(fprintf)h(\(stderr,)821 3611 y("\045s:)g(Too)f +3524 y(too_dangerous)h(\(caller\))586 3611 y(char)e(*caller;)390 +3699 y({)468 3786 y(fprintf)h(\(stderr,)821 3873 y("\045s:)g(Too)f (dangerous)h(for)f(me)f(to)h(distribute.)81 b(Write)40 -b(it)g(yourself.\\n",)821 3699 y(caller\);)390 3786 y(})390 -3960 y(/*)g(Return)g(non-zero)h(if)f(ARG)g(is)g(a)f(valid)h(argument)h -(for)f(CALLER,)h(else)f(print)508 4047 y(an)f(error)i(message)g(and)e -(return)i(zero.)f(*/)390 4134 y(int)390 4222 y(valid_argument)i -(\(caller,)f(arg\))586 4309 y(char)f(*caller,)h(*arg;)390 -4396 y({)468 4483 y(if)f(\(!arg)g(||)g(!*arg\))547 4570 -y({)625 4658 y(fprintf)h(\(stderr,)g("\045s:)f(Argument)h -(required.\\n",)i(caller\);)625 4745 y(return)e(\(0\);)547 -4832 y(})468 5006 y(return)g(\(1\);)390 5093 y(})p eop -end +b(it)g(yourself.\\n",)821 3960 y(caller\);)390 4047 y(})390 +4222 y(/*)g(Return)g(non-zero)h(if)f(ARG)g(is)g(a)f(valid)h(argument)h +(for)f(CALLER,)h(else)f(print)508 4309 y(an)f(error)i(message)g(and)e +(return)i(zero.)f(*/)390 4396 y(int)390 4483 y(valid_argument)i +(\(caller,)f(arg\))586 4570 y(char)f(*caller,)h(*arg;)390 +4658 y({)468 4745 y(if)f(\(!arg)g(||)g(!*arg\))547 4832 +y({)625 4919 y(fprintf)h(\(stderr,)g("\045s:)f(Argument)h +(required.\\n",)i(caller\);)625 5006 y(return)e(\(0\);)547 +5093 y(})468 5268 y(return)g(\(1\);)p eop end %%Page: 69 73 -TeXDict begin 69 72 bop 3659 -116 a Ft(69)150 299 y Fp(App)t(endix)52 +TeXDict begin 69 72 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(69)390 +299 y Fe(})p eop end +%%Page: 70 74 +TeXDict begin 70 73 bop 3659 -116 a Ft(70)150 299 y Fp(App)t(endix)52 b(A)81 b(GNU)54 b(F)-13 b(ree)53 b(Do)t(cumen)l(tation)e(License)1359 502 y Ft(V)-8 b(ersion)31 b(1.3,)g(3)g(No)m(v)m(em)m(b)s(er)h(2008)390 635 y(Cop)m(yrigh)m(t)842 632 y(c)817 635 y Fq(\015)e @@ -11388,10 +11402,10 @@ b(\\In)m(v)-5 b(arian)m(t)27 b(Sections")g(are)f(certain)g(Secondary)g 5340 y(b)s(eing)e(those)h(of)g(In)m(v)-5 b(arian)m(t)27 b(Sections,)i(in)d(the)h(notice)h(that)f(sa)m(ys)g(that)g(the)g(Do)s (cumen)m(t)g(is)g(released)p eop end -%%Page: 70 74 -TeXDict begin 70 73 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 71 75 +TeXDict begin 71 74 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(70)330 299 y(under)26 b(this)i(License.)40 b(If)27 +b(71)330 299 y(under)26 b(this)i(License.)40 b(If)27 b(a)h(section)h(do)s(es)f(not)f(\014t)h(the)g(ab)s(o)m(v)m(e)h (de\014nition)e(of)h(Secondary)f(then)h(it)g(is)330 408 y(not)k(allo)m(w)m(ed)i(to)e(b)s(e)g(designated)g(as)g(In)m(v)-5 @@ -11482,10 +11496,10 @@ b(Disclaimers)f(are)g(considered)e(to)330 4970 y(b)s(e)k(included)g(b)m b(Disclaimers)f(ma)m(y)g(ha)m(v)m(e)g(is)f(v)m(oid)g(and)f(has)h(no)330 5189 y(e\013ect)32 b(on)e(the)h(meaning)f(of)h(this)f(License.)199 5340 y(2.)61 b(VERBA)-8 b(TIM)31 b(COPYING)p eop end -%%Page: 71 75 -TeXDict begin 71 74 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 72 76 +TeXDict begin 72 75 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(71)330 299 y(Y)-8 b(ou)39 b(ma)m(y)f(cop)m(y)h(and)e(distribute)h +b(72)330 299 y(Y)-8 b(ou)39 b(ma)m(y)f(cop)m(y)h(and)e(distribute)h (the)g(Do)s(cumen)m(t)h(in)f(an)m(y)g(medium,)h(either)g(commercially)h (or)330 408 y(noncommercially)-8 b(,)48 b(pro)m(vided)42 b(that)h(this)f(License,)47 b(the)42 b(cop)m(yrigh)m(t)i(notices,)j @@ -11575,10 +11589,10 @@ b(in)f(the)h(Title)h(P)m(age)g(\(and)f(on)f(the)h(co)m(v)m(ers,)i(if)e 5340 y(Do)s(cumen)m(t,)j(and)d(from)g(those)i(of)f(previous)f(v)m (ersions)h(\(whic)m(h)g(should,)g(if)g(there)g(w)m(ere)g(an)m(y)-8 b(,)p eop end -%%Page: 72 76 -TeXDict begin 72 75 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 73 77 +TeXDict begin 73 76 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(72)510 299 y(b)s(e)31 b(listed)h(in)f(the)g(History)h(section)g(of)g +b(73)510 299 y(b)s(e)31 b(listed)h(in)f(the)g(History)h(section)g(of)g (the)f(Do)s(cumen)m(t\).)45 b(Y)-8 b(ou)32 b(ma)m(y)g(use)f(the)g(same) h(title)h(as)510 408 y(a)e(previous)f(v)m(ersion)g(if)h(the)f(original) i(publisher)d(of)h(that)h(v)m(ersion)g(giv)m(es)h(p)s(ermission.)360 @@ -11657,10 +11671,10 @@ b(arran)m(t)m(y)32 b(Disclaimers.)330 5121 y(If)h(the)g(Mo)s(di\014ed)g (designate)h(some)e(or)h(all)g(of)f(these)h(sections)h(as)e(in)m(v)-5 b(arian)m(t.)48 b(T)-8 b(o)33 b(do)f(this,)h(add)f(their)p eop end -%%Page: 73 77 -TeXDict begin 73 76 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 74 78 +TeXDict begin 74 77 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(73)330 299 y(titles)37 b(to)f(the)f(list)h(of)g(In)m(v)-5 +b(74)330 299 y(titles)37 b(to)f(the)f(list)h(of)g(In)m(v)-5 b(arian)m(t)36 b(Sections)g(in)f(the)h(Mo)s(di\014ed)f(V)-8 b(ersion's)36 b(license)g(notice.)57 b(These)330 408 y(titles)32 b(m)m(ust)e(b)s(e)g(distinct)h(from)e(an)m(y)i(other)g @@ -11745,10 +11759,10 @@ b(ma)m(y)g(extract)h(a)f(single)g(do)s(cumen)m(t)f(from)g(suc)m(h)g(a)h 5230 y(do)s(cumen)m(t,)d(and)f(follo)m(w)i(this)e(License)h(in)g(all)g (other)g(resp)s(ects)f(regarding)h(v)m(erbatim)g(cop)m(ying)h(of)330 5340 y(that)d(do)s(cumen)m(t.)p eop end -%%Page: 74 78 -TeXDict begin 74 77 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 75 79 +TeXDict begin 75 78 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(74)199 299 y(7.)61 b(A)m(GGREGA)-8 b(TION)32 b(WITH)e(INDEPENDENT)h +b(75)199 299 y(7.)61 b(A)m(GGREGA)-8 b(TION)32 b(WITH)e(INDEPENDENT)h (W)m(ORKS)330 441 y(A)d(compilation)i(of)e(the)g(Do)s(cumen)m(t)h(or)f (its)g(deriv)-5 b(ativ)m(es)30 b(with)d(other)i(separate)g(and)e(indep) s(enden)m(t)330 551 y(do)s(cumen)m(ts)33 b(or)g(w)m(orks,)h(in)f(or)h @@ -11833,10 +11847,10 @@ b(ha)m(v)m(e)h(receiv)m(ed)h(copies)e(or)h(righ)m(ts)f(from)g(y)m(ou)g (reinstated,)i(receipt)f(of)f(a)g(cop)m(y)h(of)f(some)h(or)f(all)h(of)f (the)330 5340 y(same)31 b(material)h(do)s(es)e(not)g(giv)m(e)i(y)m(ou)f (an)m(y)g(righ)m(ts)f(to)i(use)e(it.)p eop end -%%Page: 75 79 -TeXDict begin 75 78 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 76 80 +TeXDict begin 76 79 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(75)154 299 y(10.)61 b(FUTURE)30 b(REVISIONS)f(OF)i(THIS)e(LICENSE)330 +b(76)154 299 y(10.)61 b(FUTURE)30 b(REVISIONS)f(OF)i(THIS)e(LICENSE)330 433 y(The)41 b(F)-8 b(ree)43 b(Soft)m(w)m(are)f(F)-8 b(oundation)43 b(ma)m(y)f(publish)e(new,)k(revised)d(v)m(ersions)h(of)g (the)g(GNU)g(F)-8 b(ree)330 543 y(Do)s(cumen)m(tation)34 @@ -11900,10 +11914,10 @@ f(of)g(that)330 2944 y(license)31 b(published)e(b)m(y)h(that)h(same)g g(under)330 3895 y(CC-BY-SA)30 b(on)g(the)h(same)f(site)h(at)g(an)m(y)g (time)g(b)s(efore)e(August)h(1,)h(2009,)h(pro)m(vided)e(the)g(MMC)h(is) 330 4005 y(eligible)h(for)e(relicensing.)p eop end -%%Page: 76 80 -TeXDict begin 76 79 bop 150 -116 a Ft(App)s(endix)29 +%%Page: 77 81 +TeXDict begin 77 80 bop 150 -116 a Ft(App)s(endix)29 b(A:)h(GNU)h(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License)1603 -b(76)150 299 y Fr(ADDENDUM:)45 b(Ho)l(w)h(to)f(use)g(this)h(License)f +b(77)150 299 y Fr(ADDENDUM:)45 b(Ho)l(w)h(to)f(use)g(this)h(License)f (for)g(y)l(our)g(do)t(cumen)l(ts)150 458 y Ft(T)-8 b(o)35 b(use)f(this)h(License)g(in)f(a)h(do)s(cumen)m(t)g(y)m(ou)f(ha)m(v)m(e) i(written,)g(include)f(a)f(cop)m(y)i(of)f(the)f(License)h(in)g(the)150 @@ -11938,9 +11952,9 @@ y(If)23 b(y)m(our)h(do)s(cumen)m(t)f(con)m(tains)i(non)m(trivial)g b(as)g(the)g(GNU)150 2331 y(General)31 b(Public)f(License,)i(to)f(p)s (ermit)e(their)i(use)f(in)g(free)g(soft)m(w)m(are.)p eop end -%%Page: 77 81 -TeXDict begin 77 80 bop 150 -116 a Ft(Concept)31 b(Index)2927 -b(77)150 100 y Fp(Concept)52 b(Index)146 434 y Fr(A)150 +%%Page: 78 82 +TeXDict begin 78 81 bop 150 -116 a Ft(Concept)31 b(Index)2927 +b(78)150 100 y Fp(Concept)52 b(Index)146 434 y Fr(A)150 550 y Fb(application-sp)r(eci\014c)27 b(completion)f(functions)e Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)37 b Fb(53)146 796 y Fr(C)150 913 y Fb(command)26 b(editing)6 b Fa(:)14 b(:)f(:)g(:)g(:)g(:) @@ -11973,8 +11987,8 @@ b(readline)11 b Fa(:)j(:)f(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g b Fa(:)12 b(:)h(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:) f(:)g(:)32 b Fb(2)p eop end -%%Page: 78 82 -TeXDict begin 78 81 bop 3659 -116 a Ft(78)150 299 y Fp(F)-13 +%%Page: 79 83 +TeXDict begin 79 82 bop 3659 -116 a Ft(79)150 299 y Fp(F)-13 b(unction)52 b(and)h(V)-13 b(ariable)53 b(Index)p 156 740 41 6 v 150 860 a Fe(_rl_digit_p)10 b Fa(:)16 b(:)d(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) @@ -12172,9 +12186,9 @@ b Fb(23)2025 5328 y(isearc)n(h-terminators)9 b Fa(:)14 b(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)24 b Fb(8)p eop end -%%Page: 79 83 -TeXDict begin 79 82 bop 150 -116 a Ft(F)-8 b(unction)31 -b(and)f(V)-8 b(ariable)32 b(Index)2370 b(79)146 294 y +%%Page: 80 84 +TeXDict begin 80 83 bop 150 -116 a Ft(F)-8 b(unction)31 +b(and)f(V)-8 b(ariable)32 b(Index)2370 b(80)146 294 y Fr(K)150 423 y Fb(k)n(eymap)14 b Fa(:)e(:)h(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)29 @@ -12381,9 +12395,9 @@ g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g b Fb(43)2025 5128 y Fe(rl_free_keymap)23 b Fa(:)13 b(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)34 b Fb(35)p eop end -%%Page: 80 84 -TeXDict begin 80 83 bop 150 -116 a Ft(F)-8 b(unction)31 -b(and)f(V)-8 b(ariable)32 b(Index)2370 b(80)150 260 y +%%Page: 81 85 +TeXDict begin 81 84 bop 150 -116 a Ft(F)-8 b(unction)31 +b(and)f(V)-8 b(ariable)32 b(Index)2370 b(81)150 260 y Fe(rl_free_line_state)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(52)150 348 y Fe(rl_free_undo_list)12 b Fa(:)17 b(:)c(:)g(:)h(:)f @@ -12613,7 +12627,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 @@ -12622,9 +12636,9 @@ b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g 4948 y(visible-stats)11 b Fa(:)j(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)26 b Fb(11)p eop end -%%Page: 81 85 -TeXDict begin 81 84 bop 150 -116 a Ft(F)-8 b(unction)31 -b(and)f(V)-8 b(ariable)32 b(Index)2370 b(81)146 294 y +%%Page: 82 86 +TeXDict begin 82 85 bop 150 -116 a Ft(F)-8 b(unction)31 +b(and)f(V)-8 b(ariable)32 b(Index)2370 b(82)146 294 y Fr(Y)150 410 y Fe(yank)27 b(\(C-y\))20 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 b diff --git a/doc/readline_3.ps b/doc/readline_3.ps index 842b4e0..91d94ef 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: Tue Sep 20 10:17:06 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 September 19)120.405 E(1)190.115 E +0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -441,7 +441,8 @@ 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 September 19)120.405 E(2)190.115 E 0 Cg +EP %%Page: 3 3 %%BeginPageSetup BP @@ -563,7 +564,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 September 19)120.405 E(3)190.115 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -616,1150 +617,1166 @@ 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 September 19)120.405 E(4)190.115 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 September 19)120.405 E(5)190.115 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 September 19)120.405 E(6)190.115 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 September 19)120.405 E(7)190.115 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 -(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 -(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\ - 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 +(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 1.056(This will not ha)144 528 R 1.356 -.15 +(ve t)-.2 H 1.056(he desired ef).15 F 1.056 +(fect if the current readline line does not tak)-.25 F 3.555(eu)-.1 G +3.555(pm)-3.555 G 1.055(ore than one)-3.555 F(ph)144 540 Q(ysical line \ +or if point is not greater than the length of the prompt plus the scree\ +n width.)-.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 .195(will not ha)144 576 R .495 -.15 +(ve t)-.2 H .195(he desired ef).15 F .194 +(fect if the current readline line does not tak)-.25 F 2.694(eu)-.1 G +2.694(pm)-2.694 G .194(ore than one ph)-2.694 F(ysical)-.05 E .164(line\ + or if the length of the current readline line is not greater than the \ +length of the prompt plus the)144 588 R(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 September 19)120.405 E(8)190.115 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 September 19)120.405 E(9)190.115 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 .167 +(there are no characters on the line, and point is at the be)144 220.8 R +.167(ginning of the line, readline interprets it as)-.15 F +(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 September 19)120.405 E(10)185.115 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 September 19)120.405 E(11)185.115 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 September 19)120.405 E(12)185.115 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) -.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 -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 --.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 +(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.112(Ac)144 156 S +.612(haracter is read and point is mo)-3.112 F -.15(ve)-.15 G 3.112(dt) +.15 G 3.112(ot)-3.112 G .612(he ne)-3.112 F .612 +(xt occurrence of that character)-.15 F 5.611(.A)-.55 G(ne)-2.5 E -.05 +(ga)-.15 G(ti).05 E .911 -.15(ve a)-.25 H -.18(rg).15 G(u-).18 E +(ment searches for pre)144 168 Q(vious occurrences.)-.25 E F1 +(character\255sear)108 180 Q(ch\255backward \(M\255C\255]\))-.18 E F0 +2.694(Ac)144 192 S .194(haracter is read and point is mo)-2.694 F -.15 +(ve)-.15 G 2.694(dt).15 G 2.694(ot)-2.694 G .194(he pre)-2.694 F .194 +(vious occurrence of that character)-.25 F 5.194(.A)-.55 G(ne)-2.499 E +-.05(ga)-.15 G(ti).05 E .495 -.15(ve a)-.25 H -.2(r-).15 G +(gument 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 September 19)120.405 E(13)185.115 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 September 19)120.405 E(14)185.115 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 September 19)120.405 E(15)185.115 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 September 19)120.405 E(16)185.115 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 September 19)120.405 E(17)185.115 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/rltech.texi b/doc/rltech.texi index fe64a42..a93f77d 100644 --- a/doc/rltech.texi +++ b/doc/rltech.texi @@ -393,7 +393,7 @@ value 0x0402. @end deftypevar @deftypevar {int} rl_gnu_readline_p -Always set to 1, denoting that this is @sc{gnu} readline rather than some +Always set to 1, denoting that this is @sc{gnu} Readline rather than some emulation. @end deftypevar @@ -515,7 +515,7 @@ By default, this is set to @code{rl_deprep_terminal} @deftypevar {Keymap} rl_executing_keymap This variable is set to the keymap (@pxref{Keymaps}) in which the -currently executing readline function was found. +currently executing Readline function was found. @end deftypevar @deftypevar {Keymap} rl_binding_keymap @@ -916,7 +916,7 @@ invoke @var{function} in the keymap @var{map}. @end deftypefun @deftypefun void rl_function_dumper (int readable) -Print the readline function names and the key sequences currently +Print the Readline function names and the key sequences currently bound to them to @code{rl_outstream}. If @var{readable} is non-zero, the list is formatted in such a way that it can be made part of an @code{inputrc} file and re-read. @@ -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 @@ -1358,7 +1358,7 @@ that it can be made part of an @code{inputrc} file and re-read. @deftypefun int rl_variable_bind (const char *variable, const char *value) Make the Readline variable @var{variable} have @var{value}. -This behaves as if the readline command +This behaves as if the Readline command @samp{set @var{variable} @var{value}} had been executed in an @code{inputrc} file (@pxref{Readline Init File Syntax}). @end deftypefun @@ -1369,7 +1369,7 @@ For boolean variables, this string is either @samp{on} or @samp{off}. @end deftypefun @deftypefun void rl_variable_dumper (int readable) -Print the readline variable names and their current values +Print the Readline variable names and their current values to @code{rl_outstream}. If @var{readable} is non-zero, the list is formatted in such a way that it can be made part of an @code{inputrc} file and re-read. @@ -1400,7 +1400,7 @@ Readline saves in the history list. Enable an @emph{active} mark. When this is enabled, the text between point and mark (the @var{region}) is displayed in the terminal's standout mode (a @var{face}). -This is called by various readline functions that set the mark and insert +This is called by various Readline functions that set the mark and insert text, and is available for applications to call. @end deftypefun @@ -1409,10 +1409,10 @@ Turn off the active mark. @end deftypefun @deftypefun {void} rl_keep_mark_active (void) -Indicate that the mark should remain active when the current readline function -completes and after redisplay occurs. +Indicate that the mark should remain active when the current Readline +function completes and after redisplay occurs. In most cases, the mark remains active for only the duration of a single -bindable readline function. +bindable Readline function. @end deftypefun @deftypefun {int} rl_mark_active_p (void) @@ -1425,12 +1425,12 @@ Return a non-zero value if the mark is currently active; zero otherwise. An alternate interface is available to plain @code{readline()}. Some applications need to interleave keyboard I/O with file, device, or window system I/O, typically by using a main loop to @code{select()} -on various file descriptors. To accommodate this need, readline can +on various file descriptors. To accommodate this need, Readline can also be invoked as a `callback' function from an event loop. There are functions available to make this easy. @deftypefun void rl_callback_handler_install (const char *prompt, rl_vcpfunc_t *lhandler) -Set up the terminal for readline I/O and display the initial +Set up the terminal for Readline I/O and display the initial expanded value of @var{prompt}. Save the value of @var{lhandler} to use as a handler function to call when a complete line of input has been entered. @@ -1815,7 +1815,7 @@ a @code{SIGWINCH}. @deftypefun void rl_echo_signal_char (int sig) If an application wishes to install its own signal handlers, but still -have readline display characters that generate signals, calling this +have Readline display characters that generate signals, calling this function with @var{sig} set to @code{SIGINT}, @code{SIGQUIT}, or @code{SIGTSTP} will display the character generating that signal. @end deftypefun @@ -2213,7 +2213,7 @@ shell variables and hostnames. @deftypevar int rl_completion_query_items Up to this many items will be displayed in response to a -possible-completions call. After that, readline asks the user for +possible-completions call. After that, Readline asks the user for confirmation before displaying them. The default value is 100. A negative value indicates that Readline should never ask for confirmation. diff --git a/doc/rluser.texi b/doc/rluser.texi index 0921d24..cbcbb45 100644 --- a/doc/rluser.texi +++ b/doc/rluser.texi @@ -179,7 +179,7 @@ empty line. @end table @noindent -(Depending on your configuration, the @key{Backspace} key be set to +(Depending on your configuration, the @key{Backspace} key might be set to delete the character to the left of the cursor and the @key{DEL} key set to delete the character underneath the cursor, like @kbd{C-d}, rather than the character to the left of the cursor.) @@ -246,7 +246,7 @@ words, to the end of the next word. Word boundaries are the same as those used by @kbd{M-f}. @item M-@key{DEL} -Kill from the cursor the start of the current word, or, if between +Kill from the cursor to the start of the current word, or, if between words, to the start of the previous word. Word boundaries are the same as those used by @kbd{M-b}. @@ -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 @@ -549,7 +552,7 @@ been mapped to @code{self-insert}. The default is @samp{off}. @item echo-control-characters @vindex echo-control-characters When set to @samp{on}, on operating systems that indicate they support it, -readline echoes a character corresponding to a signal generated from the +Readline echoes a character corresponding to a signal generated from the keyboard. The default is @samp{on}. @item editing-mode @@ -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 @@ -748,7 +755,7 @@ The default is @samp{off}. If set to @samp{on}, Readline will undo all changes to history lines before returning when @code{accept-line} is executed. By default, history lines may be modified and retain individual undo lists across -calls to @code{readline}. The default is @samp{off}. +calls to @code{readline()}. The default is @samp{off}. @item show-all-if-ambiguous @vindex show-all-if-ambiguous @@ -780,7 +787,7 @@ The default value is @samp{off}. @vindex skip-completed-text If set to @samp{on}, 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 +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. @@ -840,12 +847,12 @@ interpreted as part of the key name. The name of the key can be expressed in different ways, depending on what you find most comfortable. -In addition to command names, readline allows keys to be bound +In addition to command names, Readline allows keys to be bound 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 @@ -1721,7 +1728,7 @@ Re-execute the last keyboard macro defined, by making the characters in the macro appear as if typed at the keyboard. @item print-last-kbd-macro () -Print the last keboard macro defined in a format suitable for the +Print the last keyboard macro defined in a format suitable for the @var{inputrc} file. @end ftable @@ -1774,11 +1781,11 @@ the saved position, and the old cursor position is saved as the mark. @item character-search (C-]) A character is read and point is moved to the next occurrence of that -character. A negative count searches for previous occurrences. +character. A negative argument searches for previous occurrences. @item character-search-backward (M-C-]) A character is read and point is moved to the previous occurrence -of that character. A negative count searches for subsequent +of that character. A negative argument searches for subsequent occurrences. @item skip-csi-sequence () @@ -1786,7 +1793,7 @@ 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 "\e[", keys producing such sequences will have no effect -unless explicitly bound to a readline command, instead of inserting +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-[. @@ -2282,6 +2289,7 @@ Names of all shell variables. May also be specified as @option{-v}. @item -C @var{command} @var{command} is executed in a subshell environment, and its output is used as the possible completions. +Arguments are passed as with the @option{-F} option. @item -F @var{function} The shell function @var{function} is executed in the current shell @@ -2459,7 +2467,7 @@ via @var{CDPATH}: Readline can't tell those completions are directories). The @option{-o nospace} option tells Readline to not append a space character to the directory name, in case we want to append to it. The @option{-o bashdefault} option brings in the rest of the "Bash default" -completions -- possible completion that Bash adds to the default Readline +completions -- possible completions that Bash adds to the default Readline set. These include things like command name completion, variable completion for words beginning with @samp{$} or @samp{$@{}, completions containing pathname expansion patterns (@pxref{Filename Expansion}), and so on. diff --git a/doc/rluserman.dvi b/doc/rluserman.dvi Binary files differindex 2664534..e9c9e54 100644 --- a/doc/rluserman.dvi +++ b/doc/rluserman.dvi diff --git a/doc/rluserman.html b/doc/rluserman.html index 1323303..b594615 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, 19 September 2022), a library which aids in the consistency of user interface across discrete programs which provide a command line interface. @@ -262,7 +262,7 @@ empty line. </p></dd> </dl> -<p>(Depending on your configuration, the <tt class="key">Backspace</tt> key be set to +<p>(Depending on your configuration, the <tt class="key">Backspace</tt> key might be set to delete the character to the left of the cursor and the <tt class="key">DEL</tt> key set to delete the character underneath the cursor, like <kbd>C-d</kbd>, rather than the character to the left of the cursor.) @@ -348,7 +348,7 @@ Word boundaries are the same as those used by <kbd>M-f</kbd>. </p> </dd> <dt><span><kbd>M-<span class="key">DEL</span></kbd></span></dt> -<dd><p>Kill from the cursor the start of the current word, or, if between +<dd><p>Kill from the cursor to the start of the current word, or, if between words, to the start of the previous word. Word boundaries are the same as those used by <kbd>M-b</kbd>. </p> @@ -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> @@ -657,7 +660,7 @@ been mapped to <code>self-insert</code>. The default is ‘<samp>off</samp> </dd> <dt id='index-echo_002dcontrol_002dcharacters'><span><code>echo-control-characters</code><a href='#index-echo_002dcontrol_002dcharacters' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to ‘<samp>on</samp>’, on operating systems that indicate they support it, -readline echoes a character corresponding to a signal generated from the +Readline echoes a character corresponding to a signal generated from the keyboard. The default is ‘<samp>on</samp>’. </p> </dd> @@ -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> @@ -860,7 +867,7 @@ The default is ‘<samp>off</samp>’. <dd><p>If set to ‘<samp>on</samp>’, Readline will undo all changes to history lines before returning when <code>accept-line</code> is executed. By default, history lines may be modified and retain individual undo lists across -calls to <code>readline</code>. The default is ‘<samp>off</samp>’. +calls to <code>readline()</code>. The default is ‘<samp>off</samp>’. </p> </dd> <dt id='index-show_002dall_002dif_002dambiguous'><span><code>show-all-if-ambiguous</code><a href='#index-show_002dall_002dif_002dambiguous' class='copiable-anchor'> ¶</a></span></dt> @@ -892,7 +899,7 @@ The default value is ‘<samp>off</samp>’. <dt id='index-skip_002dcompleted_002dtext'><span><code>skip-completed-text</code><a href='#index-skip_002dcompleted_002dtext' class='copiable-anchor'> ¶</a></span></dt> <dd><p>If set to ‘<samp>on</samp>’, 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 +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. @@ -954,7 +961,7 @@ interpreted as part of the key name. The name of the key can be expressed in different ways, depending on what you find most comfortable. </p> -<p>In addition to command names, readline allows keys to be bound +<p>In addition to command names, Readline allows keys to be bound to a string that is inserted when the key is pressed (a <var>macro</var>). </p> @@ -1878,7 +1885,7 @@ in the macro appear as if typed at the keyboard. </p> </dd> <dt id='index-print_002dlast_002dkbd_002dmacro-_0028_0029'><span><code>print-last-kbd-macro ()</code><a href='#index-print_002dlast_002dkbd_002dmacro-_0028_0029' class='copiable-anchor'> ¶</a></span></dt> -<dd><p>Print the last keboard macro defined in a format suitable for the +<dd><p>Print the last keyboard macro defined in a format suitable for the <var>inputrc</var> file. </p> </dd> @@ -1941,12 +1948,12 @@ the saved position, and the old cursor position is saved as the mark. </dd> <dt id='index-character_002dsearch-_0028C_002d_005d_0029'><span><code>character-search (C-])</code><a href='#index-character_002dsearch-_0028C_002d_005d_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>A character is read and point is moved to the next occurrence of that -character. A negative count searches for previous occurrences. +character. A negative argument searches for previous occurrences. </p> </dd> <dt id='index-character_002dsearch_002dbackward-_0028M_002dC_002d_005d_0029'><span><code>character-search-backward (M-C-])</code><a href='#index-character_002dsearch_002dbackward-_0028M_002dC_002d_005d_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>A character is read and point is moved to the previous occurrence -of that character. A negative count searches for subsequent +of that character. A negative argument searches for subsequent occurrences. </p> </dd> @@ -1955,7 +1962,7 @@ occurrences. defined for keys like Home and End. Such sequences begin with a Control Sequence Indicator (CSI), usually ESC-[. If this sequence is bound to "\e[", keys producing such sequences will have no effect -unless explicitly bound to a readline command, instead of inserting +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-[. </p> diff --git a/doc/rluserman.info b/doc/rluserman.info index 953890b..6bf1b4f 100644 --- a/doc/rluserman.info +++ b/doc/rluserman.info @@ -2,9 +2,9 @@ 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 -interface. +(version 8.2, 19 September 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. @@ -153,9 +153,9 @@ Printing characters Undo the last editing command. You can undo all the way back to an empty line. -(Depending on your configuration, the <Backspace> key be set to delete -the character to the left of the cursor and the <DEL> key set to delete -the character underneath the cursor, like 'C-d', rather than the +(Depending on your configuration, the <Backspace> key might be set to +delete the character to the left of the cursor and the <DEL> key set to +delete the character underneath the cursor, like 'C-d', rather than the character to the left of the cursor.) @@ -217,9 +217,9 @@ available to be yanked back later, when you are typing another line. as those used by 'M-f'. 'M-<DEL>' - Kill from the cursor the start of the current word, or, if between - words, to the start of the previous word. Word boundaries are the - same as those used by 'M-b'. + Kill from the cursor to the start of the current word, or, if + between words, to the start of the previous word. Word boundaries + are the same as those used by 'M-b'. 'C-w' Kill from the cursor to the previous whitespace. This is different @@ -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. @@ -476,7 +478,7 @@ Variable Settings 'echo-control-characters' When set to 'on', on operating systems that indicate they - support it, readline echoes a character corresponding to a + support it, Readline echoes a character corresponding to a signal generated from the keyboard. The default is 'on'. 'editing-mode' @@ -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 @@ -643,7 +649,8 @@ Variable Settings If set to 'on', Readline will undo all changes to history lines before returning when 'accept-line' is executed. By default, history lines may be modified and retain individual - undo lists across calls to 'readline'. The default is 'off'. + undo lists across calls to 'readline()'. The default is + 'off'. 'show-all-if-ambiguous' This alters the default behavior of the completion functions. @@ -670,7 +677,7 @@ Variable Settings If set to 'on', 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 + 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. For instance, if this is enabled, attempting @@ -720,7 +727,7 @@ Key Bindings part of the key name. The name of the key can be expressed in different ways, depending on what you find most comfortable. - In addition to command names, readline allows keys to be bound to a + In addition to command names, Readline allows keys to be bound to a string that is inserted when the key is pressed (a MACRO). KEYNAME: FUNCTION-NAME or MACRO @@ -1442,7 +1449,7 @@ File: rluserman.info, Node: Keyboard Macros, Next: Miscellaneous Commands, Pr characters in the macro appear as if typed at the keyboard. 'print-last-kbd-macro ()' - Print the last keboard macro defined in a format suitable for the + Print the last keyboard macro defined in a format suitable for the INPUTRC file. @@ -1489,12 +1496,12 @@ File: rluserman.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up 'character-search (C-])' A character is read and point is moved to the next occurrence of - that character. A negative count searches for previous + that character. A negative argument searches for previous occurrences. 'character-search-backward (M-C-])' A character is read and point is moved to the previous occurrence - of that character. A negative count searches for subsequent + of that character. A negative argument searches for subsequent occurrences. 'skip-csi-sequence ()' @@ -1502,7 +1509,7 @@ File: rluserman.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up 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 "\e[", keys producing such sequences will have - no effect unless explicitly bound to a readline command, instead of + 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-[. @@ -2047,30 +2054,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: Top909 +Node: Command Line Editing1431 +Node: Introduction and Notation2085 +Node: Readline Interaction3710 +Node: Readline Bare Essentials4903 +Node: Readline Movement Commands6694 +Node: Readline Killing Commands7656 +Node: Readline Arguments9579 +Node: Searching10625 +Node: Readline Init File12779 +Node: Readline Init File Syntax13936 +Node: Conditional Init Constructs37240 +Node: Sample Init File41438 +Node: Bindable Readline Commands44564 +Node: Commands For Moving45620 +Node: Commands For History47380 +Node: Commands For Text52345 +Node: Commands For Killing56049 +Node: Numeric Arguments58764 +Node: Commands For Completion59905 +Node: Keyboard Macros61875 +Node: Miscellaneous Commands62565 +Node: Readline vi Mode66494 +Node: GNU Free Documentation License67408 End Tag Table diff --git a/doc/rluserman.pdf b/doc/rluserman.pdf Binary files differindex 5183306..3d2ae7e 100644 --- a/doc/rluserman.pdf +++ b/doc/rluserman.pdf diff --git a/doc/rluserman.ps b/doc/rluserman.ps index 39f67fb..db4f27b 100644 --- a/doc/rluserman.ps +++ b/doc/rluserman.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: rluserman.dvi -%%CreationDate: Fri Apr 8 19:52:34 2022 +%%CreationDate: Tue Sep 20 14:17:06 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.04.08:1552 +%DVIPSSource: TeX output 2022.09.20:1017 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -5213,29 +5213,29 @@ 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(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 +b(8.2.)3118 1623 y(Septem)m(b)s(er)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 3600 17 v eop end %%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 -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 -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 Fo(This)29 b(man)m(ual)g(describ)s(es) +g(the)h(end)e(user)h(in)m(terface)i(of)f(the)f(GNU)h(Readline)g +(Library)f(\(v)m(ersion)h(8.2,)h(19)150 4523 y(Septem)m(b)s(er)36 +b(2022\),)k(a)d(library)f(whic)m(h)g(aids)g(in)g(the)h(consistency)g +(of)g(user)e(in)m(terface)j(across)f(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 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 @@ -5421,33 +5421,33 @@ m(haracter)i(to)f(the)g(left)g(of)f(the)h(cursor.)150 (cursor.)150 1596 y Fg(C-_)e Fo(or)i Fg(C-x)e(C-u)630 1706 y Fo(Undo)k(the)h(last)g(editing)g(command.)50 b(Y)-8 b(ou)34 b(can)f(undo)g(all)h(the)f(w)m(a)m(y)i(bac)m(k)f(to)g(an)g -(empt)m(y)630 1815 y(line.)150 1977 y(\(Dep)s(ending)29 -b(on)h(y)m(our)f(con\014guration,)i(the)e Fn(Backspace)e -Fo(k)m(ey)k(b)s(e)d(set)j(to)f(delete)h(the)e(c)m(haracter)i(to)g(the) -150 2087 y(left)37 b(of)f(the)h(cursor)e(and)h(the)g -Fn(DEL)g Fo(k)m(ey)h(set)f(to)h(delete)h(the)e(c)m(haracter)i -(underneath)d(the)h(cursor,)i(lik)m(e)150 2196 y Fg(C-d)p -Fo(,)30 b(rather)g(than)g(the)h(c)m(haracter)h(to)f(the)f(left)h(of)g -(the)f(cursor.\))150 2398 y Fd(1.2.2)63 b(Readline)40 -b(Mo)m(v)m(emen)m(t)h(Commands)150 2545 y Fo(The)27 b(ab)s(o)m(v)m(e)i -(table)g(describ)s(es)e(the)g(most)i(basic)f(k)m(eystrok)m(es)h(that)f -(y)m(ou)g(need)g(in)f(order)g(to)i(do)e(editing)i(of)150 -2654 y(the)k(input)f(line.)49 b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m -(enience,)j(man)m(y)d(other)g(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g -(in)h(addition)150 2764 y(to)j Fg(C-b)p Fo(,)f Fg(C-f)p -Fo(,)g Fg(C-d)p Fo(,)h(and)e Fn(DEL)p Fo(.)54 b(Here)35 -b(are)g(some)h(commands)e(for)h(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h -(the)150 2873 y(line.)150 3035 y Fg(C-a)336 b Fo(Mo)m(v)m(e)32 -b(to)g(the)e(start)h(of)g(the)f(line.)150 3197 y Fg(C-e)336 -b Fo(Mo)m(v)m(e)32 b(to)g(the)e(end)g(of)g(the)h(line.)150 -3358 y Fg(M-f)336 b Fo(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f -(where)g(a)h(w)m(ord)f(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.) -150 3519 y Fg(M-b)336 b Fo(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m -(ord.)150 3680 y Fg(C-l)336 b Fo(Clear)31 b(the)f(screen,)h(reprin)m -(ting)f(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275 -3843 y(Notice)c(ho)m(w)f Fg(C-f)e Fo(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m -(haracter,)j(while)d Fg(M-f)e Fo(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m -(ord.)39 b(It)24 b(is)h(a)g(lo)s(ose)150 3952 y(con)m(v)m(en)m(tion)32 +(empt)m(y)630 1815 y(line.)150 1977 y(\(Dep)s(ending)c(on)g(y)m(our)g +(con\014guration,)h(the)f Fn(Backspace)d Fo(k)m(ey)k(migh)m(t)g(b)s(e)e +(set)i(to)g(delete)g(the)f(c)m(haracter)150 2087 y(to)h(the)f(left)h +(of)f(the)g(cursor)f(and)h(the)g Fn(DEL)f Fo(k)m(ey)i(set)g(to)f +(delete)i(the)e(c)m(haracter)h(underneath)e(the)h(cursor,)150 +2196 y(lik)m(e)i Fg(C-d)p Fo(,)d(rather)i(than)f(the)g(c)m(haracter)i +(to)f(the)g(left)g(of)g(the)f(cursor.\))150 2398 y Fd(1.2.2)63 +b(Readline)40 b(Mo)m(v)m(emen)m(t)h(Commands)150 2545 +y Fo(The)27 b(ab)s(o)m(v)m(e)i(table)g(describ)s(es)e(the)g(most)i +(basic)f(k)m(eystrok)m(es)h(that)f(y)m(ou)g(need)g(in)f(order)g(to)i +(do)e(editing)i(of)150 2654 y(the)k(input)f(line.)49 +b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m(enience,)j(man)m(y)d(other)g +(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g(in)h(addition)150 +2764 y(to)j Fg(C-b)p Fo(,)f Fg(C-f)p Fo(,)g Fg(C-d)p +Fo(,)h(and)e Fn(DEL)p Fo(.)54 b(Here)35 b(are)g(some)h(commands)e(for)h +(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h(the)150 2873 +y(line.)150 3035 y Fg(C-a)336 b Fo(Mo)m(v)m(e)32 b(to)g(the)e(start)h +(of)g(the)f(line.)150 3197 y Fg(C-e)336 b Fo(Mo)m(v)m(e)32 +b(to)g(the)e(end)g(of)g(the)h(line.)150 3358 y Fg(M-f)336 +b Fo(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f(where)g(a)h(w)m(ord)f +(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.)150 +3519 y Fg(M-b)336 b Fo(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m(ord.) +150 3680 y Fg(C-l)336 b Fo(Clear)31 b(the)f(screen,)h(reprin)m(ting)f +(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275 3843 y(Notice)c(ho)m(w)f +Fg(C-f)e Fo(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m(haracter,)j(while)d +Fg(M-f)e Fo(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m(ord.)39 +b(It)24 b(is)h(a)g(lo)s(ose)150 3952 y(con)m(v)m(en)m(tion)32 b(that)f(con)m(trol)g(k)m(eystrok)m(es)h(op)s(erate)e(on)g(c)m (haracters)h(while)f(meta)h(k)m(eystrok)m(es)h(op)s(erate)e(on)150 4062 y(w)m(ords.)150 4263 y Fd(1.2.3)63 b(Readline)40 @@ -5482,14 +5482,14 @@ b(is)h(the)f(list)h(of)g(commands)f(for)g(killing)h(text.)150 (of)h(the)f(curren)m(t)g(w)m(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m (ords,)g(to)g(the)630 723 y(end)j(of)g(the)h(next)f(w)m(ord.)41 b(W)-8 b(ord)30 b(b)s(oundaries)f(are)i(the)g(same)f(as)h(those)g(used) -f(b)m(y)g Fg(M-f)p Fo(.)150 881 y Fg(M-DEL)240 b Fo(Kill)31 -b(from)f(the)h(cursor)f(the)g(start)h(of)g(the)g(curren)m(t)f(w)m(ord,) -h(or,)f(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)i(the)630 -991 y(start)39 b(of)f(the)h(previous)f(w)m(ord.)64 b(W)-8 -b(ord)39 b(b)s(oundaries)e(are)i(the)f(same)h(as)g(those)f(used)g(b)m -(y)630 1100 y Fg(M-b)p Fo(.)150 1258 y Fg(C-w)336 b Fo(Kill)35 -b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.)55 -b(This)34 b(is)h(di\013eren)m(t)h(than)e Fg(M-DEL)630 +f(b)m(y)g Fg(M-f)p Fo(.)150 881 y Fg(M-DEL)240 b Fo(Kill)34 +b(from)f(the)g(cursor)g(to)h(the)g(start)g(of)g(the)f(curren)m(t)g(w)m +(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m(ords,)g(to)630 +991 y(the)28 b(start)g(of)g(the)g(previous)f(w)m(ord.)39 +b(W)-8 b(ord)28 b(b)s(oundaries)e(are)i(the)g(same)g(as)g(those)g(used) +f(b)m(y)630 1100 y Fg(M-b)p Fo(.)150 1258 y Fg(C-w)336 +b Fo(Kill)35 b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.) +55 b(This)34 b(is)h(di\013eren)m(t)h(than)e Fg(M-DEL)630 1367 y Fo(b)s(ecause)c(the)h(w)m(ord)f(b)s(oundaries)f(di\013er.)275 1525 y(Here)42 b(is)f(ho)m(w)h(to)g Fe(y)m(ank)47 b Fo(the)42 b(text)g(bac)m(k)h(in)m(to)f(the)g(line.)74 b(Y)-8 b(anking)43 @@ -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) @@ -5784,8 +5787,8 @@ b(Command)29 b(Line)i(Editing)2153 b(7)630 299 y Fn(disable-completion) Fn(off)p Fo('.)630 774 y Fn(echo-control-characters)1110 883 y Fo(When)f(set)h(to)g(`)p Fn(on)p Fo(',)f(on)g(op)s(erating)h (systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 993 -y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m(haracter)h(corresp)s(onding)d -(to)j(a)f(signal)g(generated)1110 1103 y(from)e(the)g(k)m(eyb)s(oard.) +y(it,)e(Readline)g(ec)m(ho)s(es)g(a)f(c)m(haracter)i(corresp)s(onding)d +(to)i(a)f(signal)h(generated)1110 1103 y(from)h(the)g(k)m(eyb)s(oard.) 41 b(The)30 b(default)g(is)h(`)p Fn(on)p Fo('.)630 1249 y Fn(editing-mode)1110 1358 y Fo(The)d Fn(editing-mode)e Fo(v)-5 b(ariable)29 b(con)m(trols)h(whic)m(h)e(default)h(set)h(of)e(k) @@ -5899,406 +5902,410 @@ 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)g(is)h(`)p Fn(off)p Fo('.)630 2193 +y Fn(show-all-if-ambiguous)1110 2303 y Fo(This)e(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)k(completion)i(in)e(the)g(middle)g(of)g(a)h(w)m(ord.)46 +b(If)32 b(enabled,)g(Readline)h(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 -(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 -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 -(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 -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 -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) -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 -eop end +(what)h(y)m(ou)g(\014nd)e(most)630 3888 y(comfortable.)630 +4025 y(In)g(addition)h(to)g(command)g(names,)g(Readline)g(allo)m(ws)h +(k)m(eys)g(to)f(b)s(e)f(b)s(ound)f(to)i(a)g(string)630 +4134 y(that)d(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 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 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 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 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 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 @@ -6802,23 +6809,24 @@ y(de\014nition.)150 3413 y Fn(call-last-kbd-macro)c(\(C-x)k(e\))630 (de\014ned,)f(b)m(y)h(making)f(the)g(c)m(haracters)i(in)e(the)630 3632 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m(eyb)s (oard.)150 3788 y Fn(print-last-kbd-macro)25 b(\(\))630 -3897 y Fo(Prin)m(t)30 b(the)h(last)g(k)m(eb)s(oard)f(macro)h(de\014ned) -e(in)i(a)f(format)h(suitable)g(for)f(the)h Fe(inputrc)k -Fo(\014le.)150 4092 y Fd(1.4.8)63 b(Some)41 b(Miscellaneous)i(Commands) -150 4262 y Fn(re-read-init-file)26 b(\(C-x)j(C-r\))630 -4372 y Fo(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of)f(the)g -Fe(inputrc)27 b Fo(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h(bindings)d -(or)i(v)-5 b(ariable)630 4481 y(assignmen)m(ts)31 b(found)e(there.)150 -4637 y Fn(abort)g(\(C-g\))630 4746 y Fo(Ab)s(ort)d(the)h(curren)m(t)f -(editing)h(command)f(and)g(ring)h(the)f(terminal's)h(b)s(ell)g(\(sub)5 -b(ject)26 b(to)i(the)630 4856 y(setting)j(of)g Fn(bell-style)p -Fo(\).)150 5011 y Fn(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p -Fg(x)p Fn(,)g(...)o(\))630 5121 y Fo(If)35 b(the)g(meta\014ed)g(c)m -(haracter)i Fe(x)k Fo(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g -(that)g(is)g(b)s(ound)e(to)630 5230 y(the)g(corresp)s(onding)f -(meta\014ed)h(lo)m(w)m(er)i(case)f(c)m(haracter.)50 b(The)32 -b(b)s(eha)m(vior)h(is)g(unde\014ned)e(if)630 5340 y Fe(x)37 -b Fo(is)30 b(already)h(lo)m(w)m(er)h(case.)p eop end +3897 y Fo(Prin)m(t)30 b(the)g(last)h(k)m(eyb)s(oard)f(macro)h +(de\014ned)e(in)h(a)g(format)h(suitable)g(for)f(the)g +Fe(inputrc)35 b Fo(\014le.)150 4092 y Fd(1.4.8)63 b(Some)41 +b(Miscellaneous)i(Commands)150 4262 y Fn(re-read-init-file)26 +b(\(C-x)j(C-r\))630 4372 y Fo(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of) +f(the)g Fe(inputrc)27 b Fo(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h +(bindings)d(or)i(v)-5 b(ariable)630 4481 y(assignmen)m(ts)31 +b(found)e(there.)150 4637 y Fn(abort)g(\(C-g\))630 4746 +y Fo(Ab)s(ort)d(the)h(curren)m(t)f(editing)h(command)f(and)g(ring)h +(the)f(terminal's)h(b)s(ell)g(\(sub)5 b(ject)26 b(to)i(the)630 +4856 y(setting)j(of)g Fn(bell-style)p Fo(\).)150 5011 +y Fn(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p Fg(x)p +Fn(,)g(...)o(\))630 5121 y Fo(If)35 b(the)g(meta\014ed)g(c)m(haracter)i +Fe(x)k Fo(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g(that)g(is)g +(b)s(ound)e(to)630 5230 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w) +m(er)i(case)f(c)m(haracter.)50 b(The)32 b(b)s(eha)m(vior)h(is)g +(unde\014ned)e(if)630 5340 y Fe(x)37 b Fo(is)30 b(already)h(lo)m(w)m +(er)h(case.)p eop end %%Page: 24 27 TeXDict begin 24 26 bop 150 -116 a Fo(Chapter)30 b(1:)41 b(Command)29 b(Line)i(Editing)2107 b(24)150 299 y Fn(prefix-meta)27 @@ -6845,21 +6853,21 @@ g(the)g(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f 2513 y Fn(character-search)26 b(\(C-]\))630 2622 y Fo(A)f(c)m(haracter) h(is)f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g (o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 2732 y(A)30 -b(negativ)m(e)j(coun)m(t)e(searc)m(hes)g(for)f(previous)g(o)s +b(negativ)m(e)j(argumen)m(t)e(searc)m(hes)g(for)f(previous)g(o)s (ccurrences.)150 2918 y Fn(character-search-backwar)o(d)24 b(\(M-C-]\))630 3028 y Fo(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s (oin)m(t)h(is)g(mo)m(v)m(ed)h(to)f(the)g(previous)f(o)s(ccurrence)h(of) -g(that)630 3137 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(coun)m(t)f -(searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)150 +g(that)630 3137 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(argumen)m(t)f +(searc)m(hes)g(for)g(subsequen)m(t)e(o)s(ccurrences.)150 3324 y Fn(skip-csi-sequence)d(\(\))630 3433 y Fo(Read)i(enough)f(c)m (haracters)h(to)g(consume)f(a)h(m)m(ulti-k)m(ey)h(sequence)f(suc)m(h)f (as)g(those)h(de\014ned)630 3543 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g (and)f(End.)60 b(Suc)m(h)37 b(sequences)g(b)s(egin)g(with)g(a)h(Con)m (trol)g(Sequence)630 3652 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 b(If)36 b(this)g(sequence)h(is)g(b)s(ound)d(to)k Fn("\\)p -Fo(e[)p Fn(")p Fo(,)g(k)m(eys)f(pro-)630 3762 y(ducing)31 -b(suc)m(h)h(sequences)g(will)h(ha)m(v)m(e)g(no)f(e\013ect)h(unless)e -(explicitly)j(b)s(ound)c(to)i(a)h(readline)630 3871 y(command,)f +Fo(e[)p Fn(")p Fo(,)g(k)m(eys)f(pro-)630 3762 y(ducing)29 +b(suc)m(h)g(sequences)g(will)h(ha)m(v)m(e)h(no)e(e\013ect)i(unless)d +(explicitly)j(b)s(ound)d(to)i(a)f(Readline)630 3871 y(command,)j (instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g(in)m(to)g(the)f (editing)h(bu\013er.)44 b(This)31 b(is)630 3981 y(un)m(b)s(ound)d(b)m (y)i(default,)h(but)f(usually)g(b)s(ound)e(to)j(ESC-[.)150 diff --git a/doc/version.texi b/doc/version.texi index cd3f8d8..d310273 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 19 September 2022 +@set UPDATED-MONTH September 2022 -@set LASTCHANGE Fri Mar 11 10:13:51 EST 2022 +@set LASTCHANGE Mon Sep 19 11:15:16 EDT 2022 diff --git a/examples/rl-callbacktest.c b/examples/rl-callbacktest.c index 4373398..7febacd 100644 --- a/examples/rl-callbacktest.c +++ b/examples/rl-callbacktest.c @@ -12,9 +12,7 @@ #include <errno.h> #include <stdio.h> -#ifdef HAVE_LOCALE_H -# include <locale.h> -#endif +#include <locale.h> /* Standard readline include files. */ #if defined (READLINE_LIBRARY) diff --git a/examples/rlcat.c b/examples/rlcat.c index aabe0ca..f1b0362 100644 --- a/examples/rlcat.c +++ b/examples/rlcat.c @@ -84,7 +84,7 @@ main (argc, argv) int opt, Vflag, Nflag; #ifdef HAVE_SETLOCALE - setlocale (LC_ALL, ""): + setlocale (LC_ALL, ""); #endif progname = strrchr(argv[0], '/'); 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; @@ -397,7 +397,7 @@ replace_history_entry (int which, const char *line, histdata_t data) temp->line = savestring (line); temp->data = data; - temp->timestamp = savestring (old_value->timestamp); + temp->timestamp = old_value->timestamp ? savestring (old_value->timestamp) : 0; the_history[which] = temp; return (old_value); @@ -194,7 +194,10 @@ rl_display_search (char *search_string, int flags, int where) rl_message ("%s", message); xfree (message); +#if 0 + /* rl_message calls this */ (*rl_redisplay_function) (); +#endif } static _rl_search_cxt * @@ -559,7 +559,7 @@ rl_yank_pop (int count, int key) int rl_vi_yank_pop (int count, int key) { - int l, n; + int l, n, origpoint; if (((rl_last_func != rl_vi_yank_pop) && (rl_last_func != rl_vi_put)) || !rl_kill_ring) @@ -569,11 +569,21 @@ rl_vi_yank_pop (int count, int key) } l = strlen (rl_kill_ring[rl_kill_index]); +#if 0 /* TAG:readline-8.3 8/29/2022 matteopaolini1995@gmail.com */ + origpoint = rl_point; + n = rl_point - l + 1; +#else n = rl_point - l; +#endif if (n >= 0 && STREQN (rl_line_buffer + n, rl_kill_ring[rl_kill_index], l)) { +#if 0 /* TAG:readline-8.3 */ + rl_delete_text (n, n + l); /* remember vi cursor positioning */ + rl_point = origpoint - l; +#else rl_delete_text (n, rl_point); rl_point = n; +#endif rl_kill_index--; if (rl_kill_index < 0) rl_kill_index = rl_kill_ring_length - 1; @@ -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); diff --git a/support/mkdist b/support/mkdist index 13c790f..463bdc1 100644 --- a/support/mkdist +++ b/support/mkdist @@ -78,7 +78,7 @@ fi dirmode=755 filmode=644 -while read fname type mode +while read fname type mode rest do [ -z "$fname" ] && continue @@ -92,9 +92,15 @@ do F) cp $SRCDIR/$fname $newdir/$fname ;; s) ln -s $mode $newdir/$fname ; mode= ;; # symlink l) ln $mode $newdir/$fname ; mode= ;; # hard link + c) cp $SRCDIR/$mode $newdir/$fname ; mode=$filmode ;; # copy to new name *) echo "unknown file type $type" 1>&2 ;; esac + # allow trailing comments + case "$mode" in + \#*) mode= ;; + esac + if [ -n "$mode" ]; then chmod $mode $newdir/$fname elif [ "$type" = "f" ]; then |