diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/Makefile.in | 15 | ||||
| -rw-r--r-- | doc/hist.texinfo | 4 | ||||
| -rw-r--r-- | doc/history.0 | 222 | ||||
| -rw-r--r-- | doc/history.3 | 11 | ||||
| -rw-r--r-- | doc/history.dvi | bin | 48812 -> 48868 bytes | |||
| -rw-r--r-- | doc/history.html | 11 | ||||
| -rw-r--r-- | doc/history.info | 29 | ||||
| -rw-r--r-- | doc/history.ps | 101 | ||||
| -rw-r--r-- | doc/history_3.ps | 40 | ||||
| -rw-r--r-- | doc/hstech.texinfo | 7 | ||||
| -rw-r--r-- | doc/hsuser.texinfo | 2 | ||||
| -rw-r--r-- | doc/manvers.texinfo | 14 | ||||
| -rw-r--r-- | doc/readline.0 | 439 | ||||
| -rw-r--r-- | doc/readline.3 | 44 | ||||
| -rw-r--r-- | doc/readline.dvi | bin | 228484 -> 235920 bytes | |||
| -rw-r--r-- | doc/readline.html | 1513 | ||||
| -rw-r--r-- | doc/readline.info | 324 | ||||
| -rw-r--r-- | doc/readline.ps | 4943 | ||||
| -rw-r--r-- | doc/readline_3.ps | 1059 | ||||
| -rw-r--r-- | doc/rlman.texinfo | 4 | ||||
| -rw-r--r-- | doc/rltech.texinfo | 173 | ||||
| -rw-r--r-- | doc/rluser.texinfo | 116 | ||||
| -rw-r--r-- | doc/rluserman.dvi | bin | 60460 -> 62592 bytes | |||
| -rw-r--r-- | doc/rluserman.html | 383 | ||||
| -rw-r--r-- | doc/rluserman.info | 97 | ||||
| -rw-r--r-- | doc/rluserman.ps | 1026 | ||||
| -rw-r--r-- | doc/rluserman.texinfo | 4 |
27 files changed, 5554 insertions, 5027 deletions
diff --git a/doc/Makefile.in b/doc/Makefile.in index 78a83de..8a85ae1 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -118,10 +118,12 @@ history.ps: history.dvi $(RM) $@ $(DVIPS) history.dvi +# +# This leaves readline.html and rlman.html -- rlman.html is for www.gnu.org +# readline.html: ${RLSRC} $(TEXI2HTML) -menu -monolithic -I $(TEXINPUTDIR) $(srcdir)/rlman.texinfo sed -e 's:rlman.html:readline.html:g' rlman.html > readline.html - $(RM) rlman.html rluserman.html: ${RLSRC} $(TEXI2HTML) -menu -monolithic -I $(TEXINPUTDIR) $(srcdir)/rluserman.texinfo @@ -151,13 +153,18 @@ history_3.ps: history.3 clean: $(RM) *.aux *.cp *.fn *.ky *.log *.pg *.toc *.tp *.vr *.cps *.pgs \ - *.fns *.kys *.tps *.vrs *.bt *.bts *.o core + *.fns *.kys *.tps *.vrs *.bt *.bts *.o core *.core -distclean: clean +mostlyclean: clean + +distclean: clean maybe-clean $(RM) $(INTERMEDIATE_OBJ) $(RM) Makefile -mostlyclean: clean +maybe-clean: + -if test "X$(topdir)" != "X$(BUILD_DIR)"; then \ + $(RM) $(DIST_DOCS); \ + fi maintainer-clean: clean $(RM) $(DIST_DOCS) diff --git a/doc/hist.texinfo b/doc/hist.texinfo index 90ace3c..63ceb16 100644 --- a/doc/hist.texinfo +++ b/doc/hist.texinfo @@ -18,7 +18,7 @@ This document describes the GNU History library, a programming tool that provides a consistent user interface for recalling lines of previously typed input. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -73,7 +73,7 @@ except that this permission notice may be stated in a translation approved by the Free Software Foundation. @vskip 0pt plus 1filll -Copyright @copyright{} 1988-2001 Free Software Foundation, Inc. +Copyright @copyright{} 1988-2002 Free Software Foundation, Inc. @end titlepage @ifinfo diff --git a/doc/history.0 b/doc/history.0 index 5c0037d..324c363 100644 --- a/doc/history.0 +++ b/doc/history.0 @@ -8,7 +8,7 @@ NNAAMMEE history - GNU History Library CCOOPPYYRRIIGGHHTT - The GNU History Library is Copyright (C) 1989-2001 by the + The GNU History Library is Copyright (C) 1989-2002 by the Free Software Foundation, Inc. DDEESSCCRRIIPPTTIIOONN @@ -61,7 +61,7 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN -GNU History 4.2 2001 Mar 6 1 +GNU History 4.3 2002 January 31 1 @@ -127,7 +127,7 @@ HISTORY(3) HISTORY(3) -GNU History 4.2 2001 Mar 6 2 +GNU History 4.3 2002 January 31 2 @@ -193,7 +193,7 @@ PPRROOGGRRAAMMMMIINNGG WWIITTHH HHIISSTTOORRYY FFUUNNC -GNU History 4.2 2001 Mar 6 3 +GNU History 4.3 2002 January 31 3 @@ -259,7 +259,7 @@ HHiissttoorryy FFuunnccttiioonnss -GNU History 4.2 2001 Mar 6 4 +GNU History 4.3 2002 January 31 4 @@ -299,33 +299,33 @@ HISTORY(3) HISTORY(3) entries. _i_n_t uunnssttiiffllee__hhiissttoorryy (_v_o_i_d) - Stop stifling the history. This returns the previous - amount the history was stifled. The value is positive if - the history was stifled, negative if it wasn't. + Stop stifling the history. This returns the previously- + set maximum number of history entries (as set by ssttii-- + ffllee__hhiissttoorryy(())). history was stifled. The value is posi- + tive if the history was stifled, negative if it wasn't. _i_n_t hhiissttoorryy__iiss__ssttiifflleedd (_v_o_i_d) - Returns non-zero if the history is stifled, zero if it is + Returns non-zero if the history is stifled, zero if it is not. IInnffoorrmmaattiioonn AAbboouutt tthhee HHiissttoorryy LLiisstt - These functions return information about the entire his- + These functions return information about the entire his- tory list or individual list entries. _H_I_S_T___E_N_T_R_Y _*_* hhiissttoorryy__lliisstt (_v_o_i_d) - Return a NNUULLLL terminated array of _H_I_S_T___E_N_T_R_Y _* which is - the current input history. Element 0 of this list is the + Return a NNUULLLL terminated array of _H_I_S_T___E_N_T_R_Y _* which is + the current input history. Element 0 of this list is the beginning of time. If there is no history, return NNUULLLL. _i_n_t wwhheerree__hhiissttoorryy (_v_o_i_d) Returns the offset of the current history element. _H_I_S_T___E_N_T_R_Y _* ccuurrrreenntt__hhiissttoorryy (_v_o_i_d) - Return the history entry at the current position, as -GNU History 4.2 2001 Mar 6 5 +GNU History 4.3 2002 January 31 5 @@ -334,7 +334,8 @@ GNU History 4.2 2001 Mar 6 5 HISTORY(3) HISTORY(3) - determined by wwhheerree__hhiissttoorryy(()). If there is no entry + Return the history entry at the current position, as + determined by wwhheerree__hhiissttoorryy(()). If there is no entry there, return a NNUULLLL pointer. _H_I_S_T___E_N_T_R_Y _* hhiissttoorryy__ggeett (_i_n_t _o_f_f_s_e_t) @@ -343,18 +344,18 @@ HISTORY(3) HISTORY(3) greater than the history length, return a NNUULLLL pointer. _i_n_t hhiissttoorryy__ttoottaall__bbyytteess (_v_o_i_d) - Return the number of bytes that the primary history - entries are using. This function returns the sum of the + Return the number of bytes that the primary history + entries are using. This function returns the sum of the lengths of all the lines in the history. MMoovviinngg AArroouunndd tthhee HHiissttoorryy LLiisstt - These functions allow the current index into the history + These functions allow the current index into the history list to be set or changed. _i_n_t hhiissttoorryy__sseett__ppooss (_i_n_t _p_o_s) - Set the current history offset to _p_o_s, an absolute index - into the list. Returns 1 on success, 0 if _p_o_s is less + Set the current history offset to _p_o_s, an absolute index + into the list. Returns 1 on success, 0 if _p_o_s is less than zero or greater than the number of history entries. _H_I_S_T___E_N_T_R_Y _* pprreevviioouuss__hhiissttoorryy (_v_o_i_d) @@ -363,35 +364,34 @@ HISTORY(3) HISTORY(3) previous entry, return a NNUULLLL pointer. _H_I_S_T___E_N_T_R_Y _* nneexxtt__hhiissttoorryy (_v_o_i_d) - Move the current history offset forward to the next his- - tory entry, and return the a pointer to that entry. If + Move the current history offset forward to the next his- + tory entry, and return the a pointer to that entry. If there is no next entry, return a NNUULLLL pointer. SSeeaarrcchhiinngg tthhee HHiissttoorryy LLiisstt - These functions allow searching of the history list for - entries containing a specific string. Searching may be - performed both forward and backward from the current his- - tory position. The search may be _a_n_c_h_o_r_e_d, meaning that - the string must match at the beginning of the history + These functions allow searching of the history list for + entries containing a specific string. Searching may be + performed both forward and backward from the current his- + tory position. The search may be _a_n_c_h_o_r_e_d, meaning that + the string must match at the beginning of the history entry. _i_n_t hhiissttoorryy__sseeaarrcchh (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g_, _i_n_t _d_i_r_e_c_t_i_o_n) - Search the history for _s_t_r_i_n_g, starting at the current - history offset. If _d_i_r_e_c_t_i_o_n is less than 0, then the + Search the history for _s_t_r_i_n_g, starting at the current + history offset. If _d_i_r_e_c_t_i_o_n is less than 0, then the search is through previous entries, otherwise through sub- - sequent entries. If _s_t_r_i_n_g is found, then the current - history index is set to that history entry, and the value - returned is the offset in the line of the entry where + sequent entries. If _s_t_r_i_n_g is found, then the current + history index is set to that history entry, and the value + returned is the offset in the line of the entry where _s_t_r_i_n_g was found. Otherwise, nothing is changed, and a -1 is returned. - _i_n_t hhiissttoorryy__sseeaarrcchh__pprreeffiixx (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g_, _i_n_t - _d_i_r_e_c_t_i_o_n) + _i_n_t hhiissttoorryy__sseeaarrcchh__pprreeffiixx (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g_, _i_n_t -GNU History 4.2 2001 Mar 6 6 +GNU History 4.3 2002 January 31 6 @@ -400,47 +400,48 @@ GNU History 4.2 2001 Mar 6 6 HISTORY(3) HISTORY(3) - Search the history for _s_t_r_i_n_g, starting at the current - history offset. The search is anchored: matching lines + _d_i_r_e_c_t_i_o_n) + Search the history for _s_t_r_i_n_g, starting at the current + history offset. The search is anchored: matching lines must begin with _s_t_r_i_n_g. If _d_i_r_e_c_t_i_o_n is less than 0, then - the search is through previous entries, otherwise through - subsequent entries. If _s_t_r_i_n_g is found, then the current - history index is set to that entry, and the return value + the search is through previous entries, otherwise through + subsequent entries. If _s_t_r_i_n_g is found, then the current + history index is set to that entry, and the return value is 0. Otherwise, nothing is changed, and a -1 is returned. _i_n_t hhiissttoorryy__sseeaarrcchh__ppooss (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g_, _i_n_t _d_i_r_e_c_t_i_o_n_, _i_n_t _p_o_s) Search for _s_t_r_i_n_g in the history list, starting at _p_o_s, an - absolute index into the list. If _d_i_r_e_c_t_i_o_n is negative, - the search proceeds backward from _p_o_s, otherwise forward. - Returns the absolute index of the history element where + absolute index into the list. If _d_i_r_e_c_t_i_o_n is negative, + the search proceeds backward from _p_o_s, otherwise forward. + Returns the absolute index of the history element where _s_t_r_i_n_g was found, or -1 otherwise. MMaannaaggiinngg tthhee HHiissttoorryy FFiillee The History library can read the history from and write it - to a file. This section documents the functions for man- + to a file. This section documents the functions for man- aging a history file. _i_n_t rreeaadd__hhiissttoorryy (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e) - Add the contents of _f_i_l_e_n_a_m_e to the history list, a line - at a time. If _f_i_l_e_n_a_m_e is NNUULLLL, then read from _~_/_._h_i_s_- + Add the contents of _f_i_l_e_n_a_m_e to the history list, a line + at a time. If _f_i_l_e_n_a_m_e is NNUULLLL, then read from _~_/_._h_i_s_- _t_o_r_y. Returns 0 if successful, or eerrrrnnoo if not. - _i_n_t rreeaadd__hhiissttoorryy__rraannggee (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e_, _i_n_t _f_r_o_m_, + _i_n_t rreeaadd__hhiissttoorryy__rraannggee (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e_, _i_n_t _f_r_o_m_, _i_n_t _t_o) - Read a range of lines from _f_i_l_e_n_a_m_e, adding them to the - history list. Start reading at line _f_r_o_m and end at _t_o. - If _f_r_o_m is zero, start at the beginning. If _t_o is less - than _f_r_o_m, then read until the end of the file. If _f_i_l_e_- - _n_a_m_e is NNUULLLL, then read from _~_/_._h_i_s_t_o_r_y. Returns 0 if + Read a range of lines from _f_i_l_e_n_a_m_e, adding them to the + history list. Start reading at line _f_r_o_m and end at _t_o. + If _f_r_o_m is zero, start at the beginning. If _t_o is less + than _f_r_o_m, then read until the end of the file. If _f_i_l_e_- + _n_a_m_e is NNUULLLL, then read from _~_/_._h_i_s_t_o_r_y. Returns 0 if successful, or eerrrrnnoo if not. _i_n_t wwrriittee__hhiissttoorryy (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e) - Write the current history to _f_i_l_e_n_a_m_e, overwriting _f_i_l_e_- - _n_a_m_e if necessary. If _f_i_l_e_n_a_m_e is NNUULLLL, then write the - history list to _~_/_._h_i_s_t_o_r_y. Returns 0 on success, or + Write the current history to _f_i_l_e_n_a_m_e, overwriting _f_i_l_e_- + _n_a_m_e if necessary. If _f_i_l_e_n_a_m_e is NNUULLLL, then write the + history list to _~_/_._h_i_s_t_o_r_y. Returns 0 on success, or eerrrrnnoo on a read or write error. @@ -449,15 +450,14 @@ HISTORY(3) HISTORY(3) If _f_i_l_e_n_a_m_e is NNUULLLL, then append to _~_/_._h_i_s_t_o_r_y. Returns 0 on success, or eerrrrnnoo on a read or write error. - _i_n_t hhiissttoorryy__ttrruunnccaattee__ffiillee (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e_, _i_n_t + _i_n_t hhiissttoorryy__ttrruunnccaattee__ffiillee (_c_o_n_s_t _c_h_a_r _*_f_i_l_e_n_a_m_e_, _i_n_t _n_l_i_n_e_s) - Truncate the history file _f_i_l_e_n_a_m_e, leaving only the last - _n_l_i_n_e_s lines. If _f_i_l_e_n_a_m_e is NNUULLLL, then _~_/_._h_i_s_t_o_r_y is - truncated. Returns 0 on success, or eerrrrnnoo on failure. + Truncate the history file _f_i_l_e_n_a_m_e, leaving only the last + _n_l_i_n_e_s lines. If _f_i_l_e_n_a_m_e is NNUULLLL, then _~_/_._h_i_s_t_o_r_y is -GNU History 4.2 2001 Mar 6 7 +GNU History 4.3 2002 January 31 7 @@ -466,64 +466,64 @@ GNU History 4.2 2001 Mar 6 7 HISTORY(3) HISTORY(3) + truncated. Returns 0 on success, or eerrrrnnoo on failure. + + HHiissttoorryy EExxppaannssiioonn These functions implement history expansion. _i_n_t hhiissttoorryy__eexxppaanndd (_c_h_a_r _*_s_t_r_i_n_g_, _c_h_a_r _*_*_o_u_t_p_u_t) - Expand _s_t_r_i_n_g, placing the result into _o_u_t_p_u_t, a pointer + Expand _s_t_r_i_n_g, placing the result into _o_u_t_p_u_t, a pointer to a string. Returns: 0 If no expansions took place (or, if the only change in the text was the removal of escape - characters preceding the history expansion + characters preceding the history expansion character); 1 if expansions did take place; -1 if there was an error in expansion; - 2 if the returned line should be displayed, + 2 if the returned line should be displayed, but not executed, as with the ::pp modifier. - If an error ocurred in expansion, then _o_u_t_p_u_t contains a + If an error ocurred in expansion, then _o_u_t_p_u_t contains a descriptive error message. _c_h_a_r _* ggeett__hhiissttoorryy__eevveenntt (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g_, _i_n_t _*_c_i_n_d_e_x_, _i_n_t _q_c_h_a_r) - Returns the text of the history event beginning at _s_t_r_i_n_g - + _*_c_i_n_d_e_x. _*_c_i_n_d_e_x is modified to point to after the - event specifier. At function entry, _c_i_n_d_e_x points to the - index into _s_t_r_i_n_g where the history event specification - begins. _q_c_h_a_r is a character that is allowed to end the - event specification in addition to the ``normal'' termi- + Returns the text of the history event beginning at _s_t_r_i_n_g + + _*_c_i_n_d_e_x. _*_c_i_n_d_e_x is modified to point to after the + event specifier. At function entry, _c_i_n_d_e_x points to the + index into _s_t_r_i_n_g where the history event specification + begins. _q_c_h_a_r is a character that is allowed to end the + event specification in addition to the ``normal'' termi- nating characters. _c_h_a_r _*_* hhiissttoorryy__ttookkeenniizzee (_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g) - Return an array of tokens parsed out of _s_t_r_i_n_g, much as - the shell might. The tokens are split on the characters + Return an array of tokens parsed out of _s_t_r_i_n_g, much as + the shell might. The tokens are split on the characters in the hhiissttoorryy__wwoorrdd__ddeelliimmiitteerrss variable, and shell quoting conventions are obeyed. - _c_h_a_r _* hhiissttoorryy__aarrgg__eexxttrraacctt (_i_n_t _f_i_r_s_t_, _i_n_t _l_a_s_t_, _c_o_n_s_t + _c_h_a_r _* hhiissttoorryy__aarrgg__eexxttrraacctt (_i_n_t _f_i_r_s_t_, _i_n_t _l_a_s_t_, _c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g) - Extract a string segment consisting of the _f_i_r_s_t through - _l_a_s_t arguments present in _s_t_r_i_n_g. Arguments are split + Extract a string segment consisting of the _f_i_r_s_t through + _l_a_s_t arguments present in _s_t_r_i_n_g. Arguments are split using hhiissttoorryy__ttookkeenniizzee(()). HHiissttoorryy VVaarriiaabblleess - This section describes the externally-visible variables + This section describes the externally-visible variables exported by the GNU History Library. _i_n_t hhiissttoorryy__bbaassee The logical offset of the first entry in the history list. _i_n_t hhiissttoorryy__lleennggtthh - The number of entries currently stored in the history + The number of entries currently stored in the history list. - _i_n_t hhiissttoorryy__mmaaxx__eennttrriieess - The maximum number of history entries. This must be - changed using ssttiiffllee__hhiissttoorryy(()). -GNU History 4.2 2001 Mar 6 8 +GNU History 4.3 2002 January 31 8 @@ -532,20 +532,24 @@ GNU History 4.2 2001 Mar 6 8 HISTORY(3) HISTORY(3) + _i_n_t hhiissttoorryy__mmaaxx__eennttrriieess + The maximum number of history entries. This must be + changed using ssttiiffllee__hhiissttoorryy(()). + _c_h_a_r hhiissttoorryy__eexxppaannssiioonn__cchhaarr The character that introduces a history event. The - default is !!. Setting this to 0 inhibits history expan- + default is !!. Setting this to 0 inhibits history expan- sion. _c_h_a_r hhiissttoorryy__ssuubbsstt__cchhaarr - The character that invokes word substitution if found at + The character that invokes word substitution if found at the start of a line. The default is ^^. _c_h_a_r hhiissttoorryy__ccoommmmeenntt__cchhaarr - During tokenization, if this character is seen as the - first character of a word, then it and all subsequent - characters up to a newline are ignored, suppressing his- - tory expansion for the remainder of the line. This is + During tokenization, if this character is seen as the + first character of a word, then it and all subsequent + characters up to a newline are ignored, suppressing his- + tory expansion for the remainder of the line. This is disabled by default. _c_h_a_r _* hhiissttoorryy__wwoorrdd__ddeelliimmiitteerrss @@ -553,27 +557,27 @@ HISTORY(3) HISTORY(3) eenniizzee(()). The default value is "" \\tt\\nn(())<<>>;;&&||"". _c_h_a_r _* hhiissttoorryy__nnoo__eexxppaanndd__cchhaarrss - The list of characters which inhibit history expansion if - found immediately following hhiissttoorryy__eexxppaannssiioonn__cchhaarr. The + The list of characters which inhibit history expansion if + found immediately following hhiissttoorryy__eexxppaannssiioonn__cchhaarr. The default is space, tab, newline, \\rr, and ==. _c_h_a_r _* hhiissttoorryy__sseeaarrcchh__ddeelliimmiitteerr__cchhaarrss The list of additional characters which can delimit a his- - tory search string, in addition to space, tab, _: and _? in + tory search string, in addition to space, tab, _: and _? in the case of a substring search. The default is empty. _i_n_t hhiissttoorryy__qquuootteess__iinnhhiibbiitt__eexxppaannssiioonn - If non-zero, single-quoted words are not scanned for the + If non-zero, single-quoted words are not scanned for the history expansion character. The default value is 0. _r_l___l_i_n_e_b_u_f___f_u_n_c___t _* hhiissttoorryy__iinnhhiibbiitt__eexxppaannssiioonn__ffuunnccttiioonn This should be set to the address of a function that takes - two arguments: a cchhaarr ** (_s_t_r_i_n_g) and an iinntt index into + two arguments: a cchhaarr ** (_s_t_r_i_n_g) and an iinntt index into that string (_i). It should return a non-zero value if the history expansion starting at _s_t_r_i_n_g_[_i_] should not be per- - formed; zero if the expansion should be done. It is - intended for use by applications like bbaasshh that use the - history expansion character for additional purposes. By + formed; zero if the expansion should be done. It is + intended for use by applications like bbaasshh that use the + history expansion character for additional purposes. By default, this variable is set to NNUULLLL. FFIILLEESS @@ -581,15 +585,11 @@ FFIILLEESS Default filename for reading and writing saved his- tory -SSEEEE AALLSSOO - _T_h_e _G_n_u _R_e_a_d_l_i_n_e _L_i_b_r_a_r_y, Brian Fox and Chet Ramey - _T_h_e _G_n_u _H_i_s_t_o_r_y _L_i_b_r_a_r_y, Brian Fox and Chet Ramey - _b_a_s_h(1) -GNU History 4.2 2001 Mar 6 9 +GNU History 4.3 2002 January 31 9 @@ -598,6 +598,10 @@ GNU History 4.2 2001 Mar 6 9 HISTORY(3) HISTORY(3) +SSEEEE AALLSSOO + _T_h_e _G_n_u _R_e_a_d_l_i_n_e _L_i_b_r_a_r_y, Brian Fox and Chet Ramey + _T_h_e _G_n_u _H_i_s_t_o_r_y _L_i_b_r_a_r_y, Brian Fox and Chet Ramey + _b_a_s_h(1) _r_e_a_d_l_i_n_e(3) AAUUTTHHOORRSS @@ -608,19 +612,19 @@ AAUUTTHHOORRSS chet@ins.CWRU.Edu BBUUGG RREEPPOORRTTSS - If you find a bug in the hhiissttoorryy library, you should + If you find a bug in the hhiissttoorryy library, you 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 hhiissttoorryy library that you have. - Once you have determined that a bug actually exists, mail - a bug report to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g. If you have a fix, - you are welcome to mail that as well! Suggestions and - `philosophical' bug reports may be mailed to _b_u_g_-_r_e_a_d_- + Once you have determined that a bug actually exists, mail + a bug report to _b_u_g_-_r_e_a_d_l_i_n_e@_g_n_u_._o_r_g. If you have a fix, + you are welcome to mail that as well! Suggestions and + `philosophical' bug reports may be mailed to _b_u_g_-_r_e_a_d_- _l_i_n_e@_g_n_u_._o_r_g or posted to the Usenet newsgroup ggnnuu..bbaasshh..bbuugg. - Comments and bug reports concerning this manual page + Comments and bug reports concerning this manual page should be directed to _c_h_e_t_@_i_n_s_._C_W_R_U_._E_d_u. @@ -651,10 +655,6 @@ BBUUGG RREEPPOORRTTSS - - - - -GNU History 4.2 2001 Mar 6 10 +GNU History 4.3 2002 January 31 10 diff --git a/doc/history.3 b/doc/history.3 index 93702b4..ed0cb9f 100644 --- a/doc/history.3 +++ b/doc/history.3 @@ -6,9 +6,9 @@ .\" Case Western Reserve University .\" chet@ins.CWRU.Edu .\" -.\" Last Change: Tue Mar 6 12:50:54 EST 2001 +.\" Last Change: Thu Jan 31 16:08:07 EST 2002 .\" -.TH HISTORY 3 "2001 Mar 6" "GNU History 4.2" +.TH HISTORY 3 "2002 January 31" "GNU History 4.3" .\" .\" File Name macro. This used to be `.PN', for Path Name, .\" but Sun doesn't seem to like that very much. @@ -40,8 +40,8 @@ .SH NAME history \- GNU History Library .SH COPYRIGHT -.if t The GNU History Library is Copyright \(co 1989-2001 by the Free Software Foundation, Inc. -.if n The GNU History Library is Copyright (C) 1989-2001 by the Free Software Foundation, Inc. +.if t The GNU History Library is Copyright \(co 1989-2002 by the Free Software Foundation, Inc. +.if n The GNU History Library is Copyright (C) 1989-2002 by the Free Software Foundation, Inc. .SH DESCRIPTION Many programs read input from the user a line at a time. The GNU History library is able to keep track of those lines, associate arbitrary @@ -362,7 +362,8 @@ Clear the history list by deleting all the entries. Stifle the history list, remembering only the last \fImax\fP entries. .Fn1 int unstifle_history "void" -Stop stifling the history. This returns the previous amount the +Stop stifling the history. This returns the previously-set +maximum number of history entries (as set by \fBstifle_history()\fP). history was stifled. The value is positive if the history was stifled, negative if it wasn't. diff --git a/doc/history.dvi b/doc/history.dvi Binary files differindex 93fc211..bf7444e 100644 --- a/doc/history.dvi +++ b/doc/history.dvi diff --git a/doc/history.html b/doc/history.html index 9155c16..5afe15b 100644 --- a/doc/history.html +++ b/doc/history.html @@ -1,6 +1,6 @@ <HTML> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<!-- Created on October, 9 2001 by texi2html 1.64 --> +<!-- Created on June, 27 2002 by texi2html 1.64 --> <!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> @@ -644,8 +644,9 @@ of an invalid <VAR>which</VAR>, a <CODE>NULL</CODE> pointer is returned. <A NAME="IDX10"></A> <DL> <DT><U>Function:</U> int <B>unstifle_history</B> <I>(void)</I> -<DD>Stop stifling the history. This returns the previous amount the -history was stifled. The value is positive if the history was +<DD>Stop stifling the history. This returns the previously-set +maximum number of history entries (as set by <CODE>stifle_history()</CODE>). +The value is positive if the history was stifled, negative if it wasn't. </DL> </P><P> @@ -1468,7 +1469,7 @@ main (argc, argv) <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="history.html#SEC_About"> ? </A>]</TD> </TR></TABLE> <H1>About this document</H1> -This document was generated by <I>Chet Ramey</I> on <I>October, 9 2001</I> +This document was generated by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> <P></P> @@ -1630,7 +1631,7 @@ the following structure: <BR> <FONT SIZE="-1"> This document was generated -by <I>Chet Ramey</I> on <I>October, 9 2001</I> +by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> diff --git a/doc/history.info b/doc/history.info index 143fba4..98c0002 100644 --- a/doc/history.info +++ b/doc/history.info @@ -1,4 +1,4 @@ -This is history.info, produced by makeinfo version 4.0 from +This is history.info, produced by makeinfo version 4.1 from /usr/homes/chet/src/bash/readline-src/doc/hist.texinfo. INFO-DIR-SECTION Libraries @@ -10,7 +10,7 @@ END-INFO-DIR-ENTRY that provides a consistent user interface for recalling lines of previously typed input. - Copyright (C) 1988-2001 Free Software Foundation, Inc. + Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice pare @@ -400,9 +400,10 @@ parameters managing the list itself. Stifle the history list, remembering only the last MAX entries. - Function: int unstifle_history (void) - Stop stifling the history. This returns the previous amount the - history was stifled. The value is positive if the history was - stifled, negative if it wasn't. + Stop stifling the history. This returns the previously-set + maximum number of history entries (as set by `stifle_history()'). + The value is positive if the history was stifled, negative if it + wasn't. - Function: int history_is_stifled (void) Returns non-zero if the history is stifled, zero if it is not. @@ -826,14 +827,14 @@ Node: History Storage9746 Node: History Functions10857 Node: Initializing History and State Management11841 Node: History List Management12641 -Node: Information About the History List14191 -Node: Moving Around the History List15547 -Node: Searching the History List16536 -Node: Managing the History File18454 -Node: History Expansion20260 -Node: History Variables22155 -Node: History Programming Example24722 -Node: Concept Index27444 -Node: Function and Variable Index27930 +Node: Information About the History List14235 +Node: Moving Around the History List15591 +Node: Searching the History List16580 +Node: Managing the History File18498 +Node: History Expansion20304 +Node: History Variables22199 +Node: History Programming Example24766 +Node: Concept Index27488 +Node: Function and Variable Index27974 End Tag Table diff --git a/doc/history.ps b/doc/history.ps index df01396..a35bcf4 100644 --- a/doc/history.ps +++ b/doc/history.ps @@ -8,7 +8,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 300 -t letter -o history.ps history.dvi %DVIPSParameters: dpi=300, compressed -%DVIPSSource: TeX output 2001.10.09:1508 +%DVIPSSource: TeX output 2002.06.27:1354 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -820,12 +820,12 @@ letter %%EndSetup %%Page: 1 1 1 0 bop 75 659 a Fq(GNU)33 b(History)f(Library)p 75 709 -1800 17 v 915 757 a Fp(Edition)16 b(4.2a,)e(for)g Fo(History)g(Library) -h Fp(V)l(ersion)h(4.2a.)1608 811 y(Octob)q(er)g(2001)75 -2467 y Fn(Brian)23 b(F)-6 b(o)n(x,)23 b(F)-6 b(ree)23 -b(Soft)n(w)n(are)f(F)-6 b(oundation)75 2534 y(Chet)22 -b(Ramey)-6 b(,)23 b(Case)e(W)-6 b(estern)23 b(Reserv)n(e)f(Univ)n -(ersit)n(y)p 75 2570 1800 9 v eop +1800 17 v 960 757 a Fp(Edition)16 b(4.3,)e(for)h Fo(History)f(Library)g +Fp(V)l(ersion)i(4.3.)1643 811 y(Marc)o(h)e(2002)75 2467 +y Fn(Brian)23 b(F)-6 b(o)n(x,)23 b(F)-6 b(ree)23 b(Soft)n(w)n(are)f(F) +-6 b(oundation)75 2534 y(Chet)22 b(Ramey)-6 b(,)23 b(Case)e(W)-6 +b(estern)23 b(Reserv)n(e)f(Univ)n(ersit)n(y)p 75 2570 +1800 9 v eop %%Page: 2 2 2 1 bop 75 217 a Fp(This)21 b(do)q(cumen)o(t)g(describ)q(es)h(the)f (GNU)f(History)g(library)l(,)j(a)d(programming)g(to)q(ol)g(that)g(pro)o @@ -850,7 +850,7 @@ g(lan-)75 869 y(guage,)e(under)h(the)f(ab)q(o)o(v)o(e)g(conditions)i (ermission)g(notice)75 924 y(ma)o(y)f(b)q(e)i(stated)f(in)h(a)f (translation)g(appro)o(v)o(ed)g(b)o(y)g(the)g(F)l(ree)h(Soft)o(w)o(are) d(F)l(oundation.)75 2661 y(Cop)o(yrigh)o(t)301 2660 y(c)289 -2661 y Fm(\015)h Fp(1988-2001)f(F)l(ree)i(Soft)o(w)o(are)f(F)l +2661 y Fm(\015)h Fp(1988-2002)f(F)l(ree)i(Soft)o(w)o(are)f(F)l (oundation,)h(Inc.)p eop %%Page: 1 3 1 2 bop 75 -58 a Fp(Chapter)15 b(1:)k(Using)d(History)f(In)o(teractiv)o @@ -1124,65 +1124,66 @@ y Fp(Clear)15 b(the)h(history)f(list)h(b)o(y)f(deleting)i(all)f(the)f b Fg(sti\015e)p 320 149 18 3 v 21 w(history)j Ff(\()p Fo(int)14 b(max)p Ff(\))195 204 y Fp(Sti\015e)i(the)f(history)h(list,)f (remem)o(b)q(ering)h(only)g(the)f(last)g Fj(max)j Fp(en)o(tries.)1762 -307 y(F)l(unction)-1861 b Fh(int)20 b Fg(unsti\015e)p -358 307 V 21 w(history)i Ff(\()p Fo(void)p Ff(\))195 -361 y Fp(Stop)c(sti\015ing)i(the)e(history)l(.)29 b(This)19 -b(returns)f(the)h(previous)g(amoun)o(t)e(the)i(history)f(w)o(as)f -(sti\015ed.)195 416 y(The)e(v)m(alue)i(is)f(p)q(ositiv)o(e)g(if)f(the)h -(history)f(w)o(as)f(sti\015ed,)i(negativ)o(e)f(if)h(it)f(w)o(asn't.) -1762 518 y(F)l(unction)-1861 b Fh(int)20 b Fg(history)p -351 518 V 20 w(is)p 409 518 V 21 w(sti\015ed)k Ff(\()p -Fo(void)p Ff(\))195 573 y Fp(Returns)15 b(non-zero)g(if)h(the)f +302 y(F)l(unction)-1861 b Fh(int)20 b Fg(unsti\015e)p +358 302 V 21 w(history)i Ff(\()p Fo(void)p Ff(\))195 +357 y Fp(Stop)14 b(sti\015ing)g(the)g(history)l(.)20 +b(This)14 b(returns)f(the)h(previously-set)h(maxim)o(um)f(n)o(um)o(b)q +(er)g(of)f(history)195 411 y(en)o(tries)h(\(as)e(set)i(b)o(y)f +Fo(stifle_history\(\))p Fp(\).)k(The)c(v)m(alue)i(is)f(p)q(ositiv)o(e)g +(if)g(the)g(history)f(w)o(as)f(sti\015ed,)195 466 y(negativ)o(e)j(if)h +(it)f(w)o(asn't.)1762 564 y(F)l(unction)-1861 b Fh(int)20 +b Fg(history)p 351 564 V 20 w(is)p 409 564 V 21 w(sti\015ed)k +Ff(\()p Fo(void)p Ff(\))195 619 y Fp(Returns)15 b(non-zero)g(if)h(the)f (history)g(is)h(sti\015ed,)g(zero)f(if)g(it)h(is)g(not.)75 -676 y Fi(2.3.3)30 b(Information)19 b(Ab)r(out)i(the)f(History)h(List) -137 770 y Fp(These)13 b(functions)h(return)f(information)g(ab)q(out)f +719 y Fi(2.3.3)30 b(Information)19 b(Ab)r(out)i(the)f(History)h(List) +137 811 y Fp(These)13 b(functions)h(return)f(information)g(ab)q(out)f (the)h(en)o(tire)h(history)e(list)i(or)e(individual)k(list)e(en)o -(tries.)1762 872 y(F)l(unction)-1861 b Fh(HIST_ENTRY)21 -b(**)e Fg(history)p 605 872 V 21 w(list)24 b Ff(\()p -Fo(void)p Ff(\))195 927 y Fp(Return)15 b(a)g Fo(NULL)f +(tries.)1762 909 y(F)l(unction)-1861 b Fh(HIST_ENTRY)21 +b(**)e Fg(history)p 605 909 V 21 w(list)24 b Ff(\()p +Fo(void)p Ff(\))195 964 y Fp(Return)15 b(a)g Fo(NULL)f Fp(terminated)i(arra)o(y)e(of)h Fo(HIST_ENTRY)f(*)h Fp(whic)o(h)h(is)f -(the)h(curren)o(t)f(input)h(history)l(.)195 982 y(Elemen)o(t)g(0)f(of)f -(this)i(list)g(is)g(the)f(b)q(eginning)i(of)e(time.)20 +(the)h(curren)o(t)f(input)h(history)l(.)195 1018 y(Elemen)o(t)g(0)f(of) +f(this)i(list)g(is)g(the)f(b)q(eginning)i(of)e(time.)20 b(If)c(there)f(is)h(no)f(history)l(,)g(return)g Fo(NULL)p -Fp(.)1762 1084 y(F)l(unction)-1861 b Fh(int)20 b Fg(where)p -325 1084 V 20 w(history)j Ff(\()p Fo(void)p Ff(\))195 -1139 y Fp(Returns)15 b(the)g(o\013set)f(of)h(the)g(curren)o(t)g -(history)g(elemen)o(t.)1762 1241 y(F)l(unction)-1861 -b Fh(HIST_ENTRY)21 b(*)e Fg(curren)n(t)p 587 1241 V 21 -w(history)k Ff(\()p Fo(void)p Ff(\))195 1296 y Fp(Return)12 +Fp(.)1762 1116 y(F)l(unction)-1861 b Fh(int)20 b Fg(where)p +325 1116 V 20 w(history)j Ff(\()p Fo(void)p Ff(\))195 +1171 y Fp(Returns)15 b(the)g(o\013set)f(of)h(the)g(curren)o(t)g +(history)g(elemen)o(t.)1762 1268 y(F)l(unction)-1861 +b Fh(HIST_ENTRY)21 b(*)e Fg(curren)n(t)p 587 1268 V 21 +w(history)k Ff(\()p Fo(void)p Ff(\))195 1323 y Fp(Return)12 b(the)h(history)f(en)o(try)g(at)g(the)g(curren)o(t)h(p)q(osition,)g(as) f(determined)i(b)o(y)e Fo(where_history\(\))p Fp(.)195 -1350 y(If)j(there)h(is)f(no)h(en)o(try)e(there,)h(return)g(a)g -Fo(NULL)g Fp(p)q(oin)o(ter.)1762 1453 y(F)l(unction)-1861 -b Fh(HIST_ENTRY)21 b(*)e Fg(history)p 579 1453 V 21 w(get)j -Ff(\()p Fo(int)15 b(offset)p Ff(\))195 1508 y Fp(Return)20 +1378 y(If)j(there)h(is)f(no)h(en)o(try)e(there,)h(return)g(a)g +Fo(NULL)g Fp(p)q(oin)o(ter.)1762 1475 y(F)l(unction)-1861 +b Fh(HIST_ENTRY)21 b(*)e Fg(history)p 579 1475 V 21 w(get)j +Ff(\()p Fo(int)15 b(offset)p Ff(\))195 1530 y Fp(Return)20 b(the)h(history)g(en)o(try)f(at)h(p)q(osition)g Fj(o\013set)p Fp(,)g(starting)f(from)g Fo(history_base)f Fp(\(see)i(Sec-)195 -1562 y(tion)15 b(2.4)f([History)g(V)l(ariables],)h(page)g(10\).)j(If)d +1585 y(tion)15 b(2.4)f([History)g(V)l(ariables],)h(page)g(10\).)j(If)d (there)g(is)g(no)g(en)o(try)f(there,)h(or)f(if)h Fj(o\013set)g -Fp(is)g(greater)195 1617 y(than)g(the)g(history)g(length,)h(return)f(a) -g Fo(NULL)g Fp(p)q(oin)o(ter.)1762 1719 y(F)l(unction)-1861 -b Fh(int)20 b Fg(history)p 351 1719 V 20 w(total)p 487 -1719 V 22 w(b)n(ytes)j Ff(\()p Fo(void)p Ff(\))195 1774 +Fp(is)g(greater)195 1640 y(than)g(the)g(history)g(length,)h(return)f(a) +g Fo(NULL)g Fp(p)q(oin)o(ter.)1762 1737 y(F)l(unction)-1861 +b Fh(int)20 b Fg(history)p 351 1737 V 20 w(total)p 487 +1737 V 22 w(b)n(ytes)j Ff(\()p Fo(void)p Ff(\))195 1792 y Fp(Return)13 b(the)h(n)o(um)o(b)q(er)g(of)g(b)o(ytes)f(that)g(the)h (primary)g(history)g(en)o(tries)g(are)g(using.)20 b(This)14 -b(function)195 1829 y(returns)h(the)g(sum)h(of)e(the)i(lengths)f(of)g -(all)h(the)g(lines)g(in)g(the)g(history)l(.)75 1932 y +b(function)195 1847 y(returns)h(the)g(sum)h(of)e(the)i(lengths)f(of)g +(all)h(the)g(lines)g(in)g(the)g(history)l(.)75 1947 y Fi(2.3.4)30 b(Mo)n(ving)21 b(Around)f(the)h(History)g(List)137 -2026 y Fp(These)16 b(functions)g(allo)o(w)f(the)g(curren)o(t)h(index)g +2040 y Fp(These)16 b(functions)g(allo)o(w)f(the)g(curren)o(t)h(index)g (in)o(to)f(the)h(history)f(list)h(to)e(b)q(e)i(set)f(or)g(c)o(hanged.) -1762 2128 y(F)l(unction)-1861 b Fh(int)20 b Fg(history)p -351 2128 V 20 w(set)p 442 2128 V 21 w(p)r(os)h Ff(\()p -Fo(int)15 b(pos)p Ff(\))195 2183 y Fp(Set)j(the)h(curren)o(t)f(history) +1762 2137 y(F)l(unction)-1861 b Fh(int)20 b Fg(history)p +351 2137 V 20 w(set)p 442 2137 V 21 w(p)r(os)h Ff(\()p +Fo(int)15 b(pos)p Ff(\))195 2192 y Fp(Set)j(the)h(curren)o(t)f(history) g(o\013set)g(to)f Fj(p)q(os)p Fp(,)i(an)f(absolute)h(index)h(in)o(to)e -(the)g(list.)30 b(Returns)18 b(1)g(on)195 2237 y(success,)d(0)g(if)h +(the)g(list.)30 b(Returns)18 b(1)g(on)195 2247 y(success,)d(0)g(if)h Fj(p)q(os)h Fp(is)f(less)g(than)f(zero)g(or)g(greater)f(than)h(the)g(n) -o(um)o(b)q(er)h(of)e(history)i(en)o(tries.)1762 2340 +o(um)o(b)q(er)h(of)e(history)i(en)o(tries.)1762 2344 y(F)l(unction)-1861 b Fh(HIST_ENTRY)21 b(*)e Fg(previous)p -615 2340 V 20 w(history)k Ff(\()p Fo(void)p Ff(\))195 -2394 y Fp(Bac)o(k)14 b(up)h(the)g(curren)o(t)f(history)g(o\013set)g(to) +615 2344 V 20 w(history)k Ff(\()p Fo(void)p Ff(\))195 +2399 y Fp(Bac)o(k)14 b(up)h(the)g(curren)o(t)f(history)g(o\013set)g(to) f(the)i(previous)g(history)f(en)o(try)l(,)g(and)h(return)f(a)g(p)q(oin) -o(ter)195 2449 y(to)h(that)f(en)o(try)l(.)20 b(If)15 +o(ter)195 2454 y(to)h(that)f(en)o(try)l(.)20 b(If)15 b(there)g(is)h(no)f(previous)h(en)o(try)l(,)f(return)g(a)g Fo(NULL)g Fp(p)q(oin)o(ter.)1762 2552 y(F)l(unction)-1861 b Fh(HIST_ENTRY)21 b(*)e Fg(next)p 514 2552 V 21 w(history)k diff --git a/doc/history_3.ps b/doc/history_3.ps index 3aae637..f5231a5 100644 --- a/doc/history_3.ps +++ b/doc/history_3.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.16.1 -%%CreationDate: Mon Apr 16 10:53:07 2001 +%%CreationDate: Mon Mar 18 10:17:27 2002 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -208,7 +208,7 @@ BP (OR)-.18 E(Y\(3\))-.65 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME) .219 E F0(history \255 GNU History Library)108 96 Q F1(COPYRIGHT)72 112.8 Q F0(The GNU History Library is Cop)108 124.8 Q -(yright \251 1989-2001 by the Free Softw)-.1 E(are F)-.1 E +(yright \251 1989-2002 by the Free Softw)-.1 E(are F)-.1 E (oundation, Inc.)-.15 E F1(DESCRIPTION)72 141.6 Q F0(Man)108 153.6 Q 2.81(yp)-.15 G .31(rograms read input from the user a line at a time.) -2.81 F .309(The GNU History library is able to k)5.309 F .309 @@ -296,8 +296,8 @@ E F2($)108 684 Q F0(The last ar)31 E(gument.)-.18 E F2(%)108 696 Q F0 (The w)26 E(ord matched by the most recent `?)-.1 E F3(string)A F0 (?' search.)A F3(x)108 708 Q F2<ad>A F3(y)A F0 2.5(Ar)21.42 G(ange of w) -2.5 E(ords; `\255)-.1 E F3(y)A F0 2.5('a)C(bbre)-2.5 E(viates `0\255) --.25 E F3(y)A F0('.)A(GNU History 4.2)72 768 Q(2001 Mar 6)141.51 E(1) -205.67 E EP +-.25 E F3(y)A F0('.)A(GNU History 4.3)72 768 Q(2002 January 31)131.79 E +(1)195.95 E EP %%Page: 2 2 %%BeginPageSetup BP @@ -400,8 +400,8 @@ F0(The history list is an array of history entries.)108 655.2 Q 2.5(Ah)5 G(istory entry is declared as follo)-2.5 E(ws:)-.25 E F2(typedef void *) 108 672 Q F1(histdata_t;)2.5 E F0(typedef struct _hist_entry {)108 688.8 Q(char *line;)113 700.8 Q(histdata_t data;)113 712.8 Q 2.5(}H)108 724.8 -S(IST_ENTR)-2.5 E -.92(Y;)-.65 G(GNU History 4.2)72 768 Q(2001 Mar 6) -141.51 E(2)205.67 E EP +S(IST_ENTR)-2.5 E -.92(Y;)-.65 G(GNU History 4.3)72 768 Q +(2002 January 31)131.79 E(2)195.95 E EP %%Page: 3 3 %%BeginPageSetup BP @@ -470,14 +470,16 @@ E(h)-.15 E F0(ha)2.868 E -.15(ve)-.2 G F1(line)3.018 E F0(and)2.868 E F1 (void)108 669.6 Q F2(sti\215e_history)2.5 E F0(\()4.166 E F1(int max)A F0(\))1.666 E(Sti\215e the history list, remembering only the last)108 681.6 Q F1(max)2.5 E F0(entries.)2.5 E F1(int)108 705.6 Q F2 -(unsti\215e_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E .655 -(Stop sti\215ing the history)108 717.6 R 5.656(.T)-.65 G .656 -(his returns the pre)-5.656 F .656(vious amount the history w)-.25 F -.656(as sti\215ed.)-.1 F .656(The v)5.656 F .656(alue is positi)-.25 F -.956 -.15(ve i)-.25 H(f).15 E(the history w)108 729.6 Q +(unsti\215e_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E .46 +(Stop sti\215ing the history)108 717.6 R 5.46(.T)-.65 G .46 +(his returns the pre)-5.46 F .46 +(viously-set maximum number of history entries \(as set by)-.25 F F2 +(sti-)2.96 E(\215e_history\(\))108 729.6 Q F0 2.5(\). history)B -.1(wa) +2.5 G 2.5(ss).1 G 2.5(ti\215ed. The)-2.5 F -.25(va)2.5 G(lue is positi) +.25 E .3 -.15(ve i)-.25 H 2.5(ft).15 G(he history w)-2.5 E (as sti\215ed, ne)-.1 E -.05(ga)-.15 G(ti).05 E .3 -.15(ve i)-.25 H 2.5 -(fi).15 G 2.5(tw)-2.5 G(asn')-2.6 E(t.)-.18 E(GNU History 4.2)72 768 Q -(2001 Mar 6)141.51 E(3)205.67 E EP +(fi).15 G 2.5(tw)-2.5 G(asn')-2.6 E(t.)-.18 E(GNU History 4.3)72 768 Q +(2002 January 31)131.79 E(3)195.95 E EP %%Page: 4 4 %%BeginPageSetup BP @@ -566,7 +568,7 @@ A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\)) 1.666 E .684(Search the history for)108 722.4 R F1(string)3.183 E F0 3.183(,s)C .683(tarting at the current history of)-3.183 F 3.183 (fset. The)-.25 F .683(search is anchored: matching lines)3.183 F -(GNU History 4.2)72 768 Q(2001 Mar 6)141.51 E(4)205.67 E EP +(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(4)195.95 E EP %%Page: 5 5 %%BeginPageSetup BP @@ -675,8 +677,8 @@ E(har)-.15 E F0 .527(is a character that is allo)3.027 F .527 (nt speci\214cation in addition to the `).15 F(`normal')-.74 E(')-.74 E (terminating characters.)108 705.6 Q F1 -.15(ch)108 729.6 S(ar **).15 E F2(history_tok)2.5 E(enize)-.1 E F0(\()4.166 E F1(const c)A(har *string) --.15 E F0(\))1.666 E(GNU History 4.2)72 768 Q(2001 Mar 6)141.51 E(5) -205.67 E EP +-.15 E F0(\))1.666 E(GNU History 4.3)72 768 Q(2002 January 31)131.79 E +(5)195.95 E EP %%Page: 6 6 %%BeginPageSetup BP @@ -756,8 +758,8 @@ F2(history_inhibit_expansion_function)2.5 E F0 .347 (ault, this v)-.1 E(ariable is set to)-.25 E F2(NULL)2.5 E F0(.)A/F3 10.95/Times-Bold@0 SF(FILES)72 693.6 Q F1(~/.history)109.666 705.6 Q F0 (Def)144 717.6 Q(ault \214lename for reading and writing sa)-.1 E -.15 -(ve)-.2 G 2.5(dh).15 G(istory)-2.5 E(GNU History 4.2)72 768 Q -(2001 Mar 6)141.51 E(6)205.67 E EP +(ve)-.2 G 2.5(dh).15 G(istory)-2.5 E(GNU History 4.3)72 768 Q +(2002 January 31)131.79 E(6)195.95 E EP %%Page: 7 7 %%BeginPageSetup BP @@ -792,7 +794,7 @@ F2(gnu.or)A(g)-.37 E F0 5.705(.I)C 3.205(fy)-5.705 G(ou)-3.205 E(ha)108 (gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 300 Q (ug reports concerning this manual page should be directed to)-.2 E F2 -.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E -(GNU History 4.2)72 768 Q(2001 Mar 6)141.51 E(7)205.67 E EP +(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(7)195.95 E EP %%Trailer end %%EOF diff --git a/doc/hstech.texinfo b/doc/hstech.texinfo index 003721a..9494446 100644 --- a/doc/hstech.texinfo +++ b/doc/hstech.texinfo @@ -1,7 +1,7 @@ @ignore This file documents the user interface to the GNU History library. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Authored by Brian Fox and Chet Ramey. Permission is granted to make and distribute verbatim copies of this manual @@ -188,8 +188,9 @@ Stifle the history list, remembering only the last @var{max} entries. @end deftypefun @deftypefun int unstifle_history (void) -Stop stifling the history. This returns the previous amount the -history was stifled. The value is positive if the history was +Stop stifling the history. This returns the previously-set +maximum number of history entries (as set by @code{stifle_history()}). +The value is positive if the history was stifled, negative if it wasn't. @end deftypefun diff --git a/doc/hsuser.texinfo b/doc/hsuser.texinfo index 6926b26..418bfa8 100644 --- a/doc/hsuser.texinfo +++ b/doc/hsuser.texinfo @@ -1,7 +1,7 @@ @ignore This file documents the user interface to the GNU History library. -Copyright (C) 1988-1999 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Authored by Brian Fox and Chet Ramey. Permission is granted to make and distribute verbatim copies of this manual diff --git a/doc/manvers.texinfo b/doc/manvers.texinfo index 859afc1..1206cf0 100644 --- a/doc/manvers.texinfo +++ b/doc/manvers.texinfo @@ -1,6 +1,10 @@ -@set EDITION 4.2a -@set VERSION 4.2a -@set UPDATED 2001 October 9 -@set UPDATE-MONTH October 2001 +@ignore +Copyright (C) 1988-2002 Free Software Foundation, Inc. +@end ignore -@set LASTCHANGE Tue Oct 9 15:03:34 EDT 2001 +@set EDITION 4.3 +@set VERSION 4.3 +@set UPDATED 2002 March 4 +@set UPDATE-MONTH March 2002 + +@set LASTCHANGE Mon Mar 4 12:00:16 EST 2002 diff --git a/doc/readline.0 b/doc/readline.0 index af2efae..87beeac 100644 --- a/doc/readline.0 +++ b/doc/readline.0 @@ -1,9 +1,7 @@ - - - READLINE(3) READLINE(3) + NNAAMMEE readline - get a line from a user with editing @@ -16,7 +14,7 @@ SSYYNNOOPPSSIISS rreeaaddlliinnee (_c_o_n_s_t _c_h_a_r _*_p_r_o_m_p_t); CCOOPPYYRRIIGGHHTT - Readline is Copyright (C) 1989-2001 by the Free Software + Readline is Copyright (C) 1989-2002 by the Free Software Foundation, Inc. DDEESSCCRRIIPPTTIIOONN @@ -58,18 +56,6 @@ NNOOTTAATTIIOONN normally act as a repeat count. Sometimes, however, it is the sign of the argument that is significant. Passing a negative argument to a command that acts in the forward - - - -GNU Readline 4.2a 2001 October 9 1 - - - - - -READLINE(3) READLINE(3) - - direction (e.g., kkiillll--lliinnee) causes that command to act in a backward direction. Commands whose behavior with argu- ments deviates from this are noted. @@ -125,17 +111,6 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE _n_a_m_e is the name of a key spelled out in English. For example: - - -GNU Readline 4.2a 2001 October 9 2 - - - - - -READLINE(3) READLINE(3) - - Control-u: universal-argument Meta-Rubout: backward-kill-word Control-o: "> output" @@ -189,21 +164,9 @@ READLINE(3) READLINE(3) When entering the text of a macro, single or double quotes should be used to indicate a macro definition. Unquoted text is assumed to be a function name. In the macro body, - the backslash escapes described above are expanded. - - - -GNU Readline 4.2a 2001 October 9 3 - - - - - -READLINE(3) READLINE(3) - - - Backslash will quote any other character in the macro - text, including " and '. + the backslash escapes described above are expanded. Back- + slash will quote any other character in the macro text, + including " and '. BBaasshh allows the current readline key bindings to be dis- played or modified with the bbiinndd builtin command. The @@ -255,19 +218,6 @@ READLINE(3) READLINE(3) stripping the eighth bit and prefixing it with an escape character (in effect, using escape as the _m_e_t_a _p_r_e_f_i_x). - - - - -GNU Readline 4.2a 2001 October 9 4 - - - - - -READLINE(3) READLINE(3) - - ddiissaabbllee--ccoommpplleettiioonn ((OOffff)) If set to OOnn, readline will inhibit word comple- tion. Completion characters will be inserted into @@ -318,28 +268,24 @@ READLINE(3) READLINE(3) mmaarrkk--mmooddiiffiieedd--lliinneess ((OOffff)) If set to OOnn, history lines that have been modified are displayed with a preceding asterisk (**). + mmaarrkk--ssyymmlliinnkkeedd--ddiirreeccttoorriieess ((OOffff)) + If set to OOnn, completed names which are symbolic + links to directories have a slash appended (subject + to the value of mmaarrkk--ddiirreeccttoorriieess). mmaattcchh--hhiiddddeenn--ffiilleess ((OOnn)) This variable, when set to OOnn, causes readline to match files whose names begin with a `.' (hidden files) when performing filename completion, unless - - - -GNU Readline 4.2a 2001 October 9 5 - - - - - -READLINE(3) READLINE(3) - - the leading `.' is supplied by the user in the filename to be completed. oouuttppuutt--mmeettaa ((OOffff)) If set to OOnn, readline will display characters with the eighth bit set directly rather than as a meta- prefixed escape sequence. + ppaaggee--ccoommpplleettiioonnss ((OOnn)) + If set to OOnn, readline uses an internal _m_o_r_e-like + pager to display a screenful of possible comple- + tions at a time. pprriinntt--ccoommpplleettiioonnss--hhoorriizzoonnttaallllyy ((OOffff)) If set to OOnn, readline will display completions with matches sorted horizontally in alphabetical @@ -387,26 +333,14 @@ READLINE(3) READLINE(3) aapppplliiccaattiioonn The aapppplliiccaattiioonn construct is used to include application-specific settings. Each program - using the readline library sets the - - - -GNU Readline 4.2a 2001 October 9 6 - - - - - -READLINE(3) READLINE(3) - - - _a_p_p_l_i_c_a_t_i_o_n _n_a_m_e, 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 Bash: + using the readline library sets the _a_p_p_l_i_c_a_- + _t_i_o_n _n_a_m_e, and an initialization file can + test for a particular value. This could be + used to bind key sequences to functions use- + ful for a specific program. For instance, + the following command adds a key sequence + that quotes the current or previous word in + Bash: $$iiff Bash # Quote the current or previous word @@ -453,23 +387,11 @@ SSEEAARRCCHHIINNGG CC--ss or CC--rr as 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 - - - -GNU Readline 4.2a 2001 October 9 7 - - - - - -READLINE(3) READLINE(3) - - - execute that command. For instance, a newline will termi- - nate 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 + 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 com- + mand from the history list. A movement command will ter- + minate the search, make the last line found the current line, and begin editing. Non-incremental searches read the entire search string @@ -519,19 +441,6 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS history list for future recall with aadddd__hhiissttoorryy(()). If the line is a modified history line, the history line is restored to its original state. - - - - -GNU Readline 4.2a 2001 October 9 8 - - - - - -READLINE(3) READLINE(3) - - pprreevviioouuss--hhiissttoorryy ((CC--pp)) Fetch the previous command from the history list, moving back in the list. @@ -585,19 +494,6 @@ READLINE(3) READLINE(3) each line in turn. CCoommmmaannddss ffoorr CChhaannggiinngg TTeexxtt - - - - -GNU Readline 4.2a 2001 October 9 9 - - - - - -READLINE(3) READLINE(3) - - ddeelleettee--cchhaarr ((CC--dd)) Delete the character at point. If point is at the beginning of the line, there are no characters in @@ -642,6 +538,18 @@ READLINE(3) READLINE(3) Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move point. + oovveerrwwrriittee--mmooddee + Toggle overwrite mode. With an explicit positive + numeric argument, switches to overwrite mode. With + an explicit non-positive numeric argument, switches + to insert mode. This command affects only eemmaaccss + mode; vvii mode does overwrite differently. Each + call to _r_e_a_d_l_i_n_e_(_) starts in insert mode. In over- + write mode, characters bound to sseellff--iinnsseerrtt replace + the text at point rather than pushing the text to + the right. Characters bound to bbaacckk-- + wwaarrdd--ddeelleettee--cchhaarr replace the character before point + with a space. By default, this command is unbound. KKiilllliinngg aanndd YYaannkkiinngg kkiillll--lliinnee ((CC--kk)) @@ -649,41 +557,28 @@ READLINE(3) READLINE(3) bbaacckkwwaarrdd--kkiillll--lliinnee ((CC--xx RRuubboouutt)) Kill backward to the beginning of the line. uunniixx--lliinnee--ddiissccaarrdd ((CC--uu)) - Kill backward from point to the beginning of the + Kill backward from point to the beginning of the line. The killed text is saved on the kill-ring. - - - - -GNU Readline 4.2a 2001 October 9 10 - - - - - -READLINE(3) READLINE(3) - - kkiillll--wwhhoollee--lliinnee - Kill all characters on the current line, no matter + Kill all characters on the current line, no matter where point is. kkiillll--wwoorrdd ((MM--dd)) - 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 ffoorr-- + 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 ffoorr-- wwaarrdd--wwoorrdd. bbaacckkwwaarrdd--kkiillll--wwoorrdd ((MM--RRuubboouutt)) - Kill the word behind point. Word boundaries are + Kill the word behind point. Word boundaries are the same as those used by bbaacckkwwaarrdd--wwoorrdd. uunniixx--wwoorrdd--rruubboouutt ((CC--ww)) - Kill the word behind point, using white space as a - word boundary. The killed text is saved on the + Kill the word behind point, using white space as a + word boundary. The killed text is saved on the kill-ring. ddeelleettee--hhoorriizzoonnttaall--ssppaaccee ((MM--\\)) Delete all spaces and tabs around point. kkiillll--rreeggiioonn - Kill the text between the point and _m_a_r_k (saved - cursor position). This text is referred to as the + Kill the text between the point and _m_a_r_k (saved + cursor position). This text is referred to as the _r_e_g_i_o_n. ccooppyy--rreeggiioonn--aass--kkiillll Copy the text in the region to the kill buffer. @@ -691,177 +586,150 @@ READLINE(3) READLINE(3) Copy the word before point to the kill buffer. The word boundaries are the same as bbaacckkwwaarrdd--wwoorrdd. ccooppyy--ffoorrwwaarrdd--wwoorrdd - Copy the word following point to the kill buffer. + Copy the word following point to the kill buffer. The word boundaries are the same as ffoorrwwaarrdd--wwoorrdd. yyaannkk ((CC--yy)) - Yank the top of the kill ring into the buffer at + Yank the top of the kill ring into the buffer at point. yyaannkk--ppoopp ((MM--yy)) - Rotate the kill ring, and yank the new top. Only + Rotate the kill ring, and yank the new top. Only works following yyaannkk or yyaannkk--ppoopp. NNuummeerriicc AArrgguummeennttss ddiiggiitt--aarrgguummeenntt ((MM--00,, MM--11,, ......,, MM----)) - Add this digit to the argument already accumulat- - ing, or start a new argument. M-- starts a nega- + Add this digit to the argument already accumulat- + ing, or start a new argument. M-- starts a nega- tive argument. uunniivveerrssaall--aarrgguummeenntt - 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 + 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 followed by digits, executing uunniivveerrssaall--aarrgguummeenntt again ends the - numeric argument, but is otherwise ignored. As a - special case, if this command is immediately fol- - lowed by a character that is neither a digit or + numeric argument, but is otherwise ignored. As a + special case, if this command is immediately fol- + lowed by a character that is neither a digit or minus sign, the argument count for the next command - is multiplied by four. The argument count is ini- - tially one, so executing this function the first - time makes the argument count four, a second time - - - -GNU Readline 4.2a 2001 October 9 11 - - - - - -READLINE(3) READLINE(3) - - + is multiplied by four. The argument count is ini- + tially one, so executing this function the first + time makes the argument count four, a second time makes the argument count sixteen, and so on. CCoommpplleettiinngg ccoommpplleettee ((TTAABB)) - Attempt to perform completion on the text before + Attempt to perform completion on the text before point. The actual completion performed is applica- - tion-specific. BBaasshh, for instance, attempts com- - pletion treating the text as a variable (if the - text begins with $$), username (if the text begins - with ~~), hostname (if the text begins with @@), or - command (including aliases and functions) in turn. + tion-specific. BBaasshh, for instance, attempts com- + pletion treating the text as a variable (if the + text begins with $$), username (if the text begins + with ~~), hostname (if the text begins with @@), or + command (including aliases and functions) in turn. If none of these produces a match, filename comple- - tion is attempted. GGddbb, on the other hand, allows - completion of program functions and variables, and - only attempts filename completion under certain + tion is attempted. GGddbb, on the other hand, allows + completion of program functions and variables, and + only attempts filename completion under certain circumstances. ppoossssiibbllee--ccoommpplleettiioonnss ((MM--??)) - List the possible completions of the text before + List the possible completions of the text before point. iinnsseerrtt--ccoommpplleettiioonnss ((MM--**)) - Insert all completions of the text before point - that would have been generated by ppoossssiibbllee--ccoommppllee-- + Insert all completions of the text before point + that would have been generated by ppoossssiibbllee--ccoommppllee-- ttiioonnss. mmeennuu--ccoommpplleettee - Similar to ccoommpplleettee, but replaces the word to be + Similar to ccoommpplleettee, but replaces the word to be completed with a single match from the list of pos- sible completions. Repeated execution of mmeennuu--ccoomm-- - pplleettee steps through the list of possible comple- + pplleettee steps through the list of possible comple- tions, inserting each match in turn. At the end of - the list of completions, the bell is rung (subject - to the setting of Bbell-style)) aanndd tthhee oorriiggiinnaall - tteexxtt iiss rreessttoorreedd.. AAnn aarrgguummeenntt ooff _n mmoovveess _n ppoossii-- - ttiioonnss ffoorrwwaarrdd iinn tthhee lliisstt ooff mmaattcchheess;; aa nneeggaattiivvee - aarrgguummeenntt mmaayy bbee uusseedd ttoo mmoovvee bbaacckkwwaarrdd tthhrroouugghh tthhee - lliisstt.. TThhiiss ccoommmmaanndd iiss iinntteennddeedd ttoo bbee bboouunndd ttoo TTAABB,, - bbuutt iiss uunnbboouunndd bbyy ddeeffaauulltt.. + the list of completions, the bell is rung (subject + to the setting of 00aanndd tthhee oorriiggiinnaall tteexxtt iiss + rreessttoorreedd.. AAnn aarrgguummeenntt ooff _n mmoovveess _n ppoossiittiioonnss ffoorr-- + wwaarrdd iinn tthhee lliisstt ooff mmaattcchheess;; aa nneeggaattiivvee aarrgguummeenntt + mmaayy bbee uusseedd ttoo mmoovvee bbaacckkwwaarrdd tthhrroouugghh tthhee lliisstt.. + TThhiiss ccoommmmaanndd iiss iinntteennddeedd ttoo bbee bboouunndd ttoo TTAABB,, bbuutt iiss + uunnbboouunndd bbyy ddeeffaauulltt.. ddeelleettee--cchhaarr--oorr--lliisstt - Deletes the character under the cursor if not at - the beginning or end of the line (like ddeelleettee-- - cchhaarr). If at the end of the line, behaves identi- + Deletes the character under the cursor if not at + the beginning or end of the line (like ddeelleettee-- + cchhaarr). If at the end of the line, behaves identi- cally to ppoossssiibbllee--ccoommpplleettiioonnss. KKeeyybbooaarrdd MMaaccrrooss ssttaarrtt--kkbbdd--mmaaccrroo ((CC--xx (()) - Begin saving the characters typed into the current + Begin saving the characters typed into the current keyboard macro. eenndd--kkbbdd--mmaaccrroo ((CC--xx )))) - Stop saving the characters typed into the current + Stop saving the characters typed into the current keyboard macro and store the definition. ccaallll--llaasstt--kkbbdd--mmaaccrroo ((CC--xx ee)) Re-execute the last keyboard macro defined, by mak- - ing the characters in the macro appear as if typed + ing the characters in the macro appear as if typed at the keyboard. - - - -GNU Readline 4.2a 2001 October 9 12 - - - - - -READLINE(3) READLINE(3) - - MMiisscceellllaanneeoouuss rree--rreeaadd--iinniitt--ffiillee ((CC--xx CC--rr)) - Read in the contents of the _i_n_p_u_t_r_c file, and - incorporate any bindings or variable assignments + Read in the contents of the _i_n_p_u_t_r_c file, and + incorporate any bindings or variable assignments found there. aabboorrtt ((CC--gg)) Abort the current editing command and ring the ter- minal's bell (subject to the setting of bbeellll--ssttyyllee). ddoo--uuppppeerrccaassee--vveerrssiioonn ((MM--aa,, MM--bb,, MM--_x,, ......)) - If the metafied character _x is lowercase, run the - command that is bound to the corresponding upper- + If the metafied character _x is lowercase, run the + command that is bound to the corresponding upper- case character. pprreeffiixx--mmeettaa ((EESSCC)) - Metafy the next character typed. EESSCC ff is equiva- + Metafy the next character typed. EESSCC ff is equiva- lent to MMeettaa--ff. uunnddoo ((CC--__,, CC--xx CC--uu)) - Incremental undo, separately remembered for each + Incremental undo, separately remembered for each line. rreevveerrtt--lliinnee ((MM--rr)) - Undo all changes made to this line. This is like - executing the uunnddoo command enough times to return + Undo all changes made to this line. This is like + executing the uunnddoo command enough times to return the line to its initial state. ttiillddee--eexxppaanndd ((MM--&&)) Perform tilde expansion on the current word. sseett--mmaarrkk ((CC--@@,, MM--<<ssppaaccee>>)) - Set the mark to the point. If a numeric argument + Set the mark to the point. If a numeric argument is supplied, the mark is set to that position. eexxcchhaannggee--ppooiinntt--aanndd--mmaarrkk ((CC--xx CC--xx)) - Swap the point with the mark. The current cursor - position is set to the saved position, and the old + 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. cchhaarraacctteerr--sseeaarrcchh ((CC--]])) - A character is read and point is moved to the next - occurrence of that character. A negative count + A character is read and point is moved to the next + occurrence of that character. A negative count searches for previous occurrences. cchhaarraacctteerr--sseeaarrcchh--bbaacckkwwaarrdd ((MM--CC--]])) - A character is read and point is moved to the pre- - vious occurrence of that character. A negative + A character is read and point is moved to the pre- + vious occurrence of that character. A negative count searches for subsequent occurrences. iinnsseerrtt--ccoommmmeenntt ((MM--##)) - The value of the readline ccoommmmeenntt--bbeeggiinn variable is - inserted at the beginning of the current line, and - the line is accepted as if a newline had been - typed. The default value of ccoommmmeenntt--bbeeggiinn makes - the current line a shell comment. + Without a numeric argument, the value of the read- + line ccoommmmeenntt--bbeeggiinn variable is inserted at the + beginning of the current line. If a numeric argu- + ment is supplied, this command acts as a toggle: + if the characters at the beginning of the line do + not match the value of ccoommmmeenntt--bbeeggiinn, the value is + inserted, otherwise the characters in ccoommmmeenntt--bbeeggiinn + are deleted from the beginning of the line. In + either case, the line is accepted as if a newline + had been typed. The default value of ccoommmmeenntt--bbeeggiinn + makes the current line a shell comment. If a + numeric argument causes the comment character to be + removed, the line will be executed by the shell. dduummpp--ffuunnccttiioonnss - Print all of the functions and their key bindings - to the readline output stream. If a numeric argu- - ment is supplied, the output is formatted in such a - way that it can be made part of an _i_n_p_u_t_r_c file. + Print all of the functions and their key bindings + 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 _i_n_p_u_t_r_c + file. dduummpp--vvaarriiaabblleess Print all of the settable variables and their val- ues to the readline output stream. If a numeric - - - -GNU Readline 4.2a 2001 October 9 13 - - - - - -READLINE(3) READLINE(3) - - argument is supplied, the output is formatted in such a way that it can be made part of an _i_n_p_u_t_r_c file. @@ -872,7 +740,7 @@ READLINE(3) READLINE(3) such a way that it can be made part of an _i_n_p_u_t_r_c file. eemmaaccss--eeddiittiinngg--mmooddee ((CC--ee)) - When in vvii editing mode, this causes a switch to + When in vvii command mode, this causes a switch to eemmaaccss editing mode. vvii--eeddiittiinngg--mmooddee ((MM--CC--jj)) When in eemmaaccss editing mode, this causes a switch to @@ -916,18 +784,6 @@ DDEEFFAAUULLTT KKEEYY BBIINNDDIINNGGSS "C-Q" quoted-insert "C-R" reverse-search-history "C-S" forward-search-history - - - -GNU Readline 4.2a 2001 October 9 14 - - - - - -READLINE(3) READLINE(3) - - "C-T" transpose-chars "C-U" unix-line-discard "C-V" quoted-insert @@ -982,18 +838,6 @@ READLINE(3) READLINE(3) "M-T" transpose-words "M-U" upcase-word "M-Y" yank-pop - - - -GNU Readline 4.2a 2001 October 9 15 - - - - - -READLINE(3) READLINE(3) - - "M-\" delete-horizontal-space "M-~" tilde-expand "M-C-?" backward-kill-word @@ -1048,18 +892,6 @@ READLINE(3) READLINE(3) "C-S" forward-search-history "C-T" transpose-chars "C-U" unix-line-discard - - - -GNU Readline 4.2a 2001 October 9 16 - - - - - -READLINE(3) READLINE(3) - - "C-V" quoted-insert "C-W" unix-word-rubout "C-Y" yank @@ -1114,18 +946,6 @@ READLINE(3) READLINE(3) "l" forward-char "m" vi-set-mark "n" vi-search-again - - - -GNU Readline 4.2a 2001 October 9 17 - - - - - -READLINE(3) READLINE(3) - - "p" vi-put "r" vi-change-char "s" vi-subst @@ -1174,15 +994,4 @@ BBUUGGSS - - - - - - - - - -GNU Readline 4.2a 2001 October 9 18 - - +GNU Readline 4.3 2002 January 22 READLINE(3) diff --git a/doc/readline.3 b/doc/readline.3 index 41cc20c..afd6ba2 100644 --- a/doc/readline.3 +++ b/doc/readline.3 @@ -6,9 +6,9 @@ .\" Case Western Reserve University .\" chet@ins.CWRU.Edu .\" -.\" Last Change: Tue Oct 9 15:06:03 EDT 2001 +.\" Last Change: Tue Jan 22 09:18:25 EST 2002 .\" -.TH READLINE 3 "2001 October 9" "GNU Readline 4.2a" +.TH READLINE 3 "2002 January 22" "GNU Readline 4.3" .\" .\" File Name macro. This used to be `.PN', for Path Name, .\" but Sun doesn't seem to like that very much. @@ -34,8 +34,8 @@ readline \- get a line from a user with editing \fBreadline\fP (\fIconst char *prompt\fP); .fi .SH COPYRIGHT -.if n Readline is Copyright (C) 1989\-2001 by the Free Software Foundation, Inc. -.if t Readline is Copyright \(co 1989\-2001 by the Free Software Foundation, Inc. +.if n Readline is Copyright (C) 1989\-2002 by the Free Software Foundation, Inc. +.if t Readline is Copyright \(co 1989\-2002 by the Free Software Foundation, Inc. .SH DESCRIPTION .LP .B readline @@ -434,6 +434,11 @@ appended. If set to \fBOn\fP, history lines that have been modified are displayed with a preceding asterisk (\fB*\fP). .TP +.B mark\-symlinked\-directories (Off) +If set to \fBOn\fP, completed names which are symbolic links to directories +have a slash appended (subject to the value of +\fBmark\-directories\fP). +.TP .B match\-hidden\-files (On) This variable, when set to \fBOn\fP, causes readline to match files whose names begin with a `.' (hidden files) when performing filename @@ -445,6 +450,10 @@ If set to \fBOn\fP, readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. .TP +.B page\-completions (On) +If set to \fBOn\fP, readline uses an internal \fImore\fP-like pager +to display a screenful of possible completions at a time. +.TP .B print\-completions\-horizontally (Off) If set to \fBOn\fP, readline will display completions with matches sorted horizontally in alphabetical order, rather than down the screen. @@ -735,6 +744,17 @@ lowercase the previous word, but do not move point. .B capitalize\-word (M\-c) Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move point. +.TP +.B overwrite\-mode +Toggle overwrite mode. With an explicit positive numeric argument, +switches to overwrite mode. With an explicit non-positive numeric +argument, switches to insert mode. This command affects only +\fBemacs\fP mode; \fBvi\fP mode does overwrite differently. +Each call to \fIreadline()\fP starts in insert mode. +In overwrite mode, characters bound to \fBself\-insert\fP replace +the text at point rather than pushing the text to the right. +Characters bound to \fBbackward\-delete\-char\fP replace the character +before point with a space. By default, this command is unbound. .PD .SS Killing and Yanking .PP @@ -930,12 +950,20 @@ A character is read and point is moved to the previous occurrence of that character. A negative count searches for subsequent occurrences. .TP .B insert\-comment (M\-#) -The value of the readline +Without a numeric argument, the value of the readline .B comment\-begin -variable is inserted at the beginning of the current line, and the line -is accepted as if a newline had been typed. The default value of +variable 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 \fBcomment\-begin\fP, the value is inserted, otherwise +the characters in \fBcomment-begin\fP are deleted from the beginning of +the line. +In either case, the line is accepted as if a newline had been typed. +The default value of .B comment\-begin makes the current line a shell comment. +If a numeric argument causes the comment character to be removed, the line +will be executed by the shell. .TP .B dump\-functions Print all of the functions and their key bindings to the @@ -958,7 +986,7 @@ of an \fIinputrc\fP file. .B emacs\-editing\-mode (C\-e) When in .B vi -editing mode, this causes a switch to +command mode, this causes a switch to .B emacs editing mode. .TP diff --git a/doc/readline.dvi b/doc/readline.dvi Binary files differindex 6c4cb4f..3c1c30f 100644 --- a/doc/readline.dvi +++ b/doc/readline.dvi diff --git a/doc/readline.html b/doc/readline.html index 82a5a7c..42485f5 100644 --- a/doc/readline.html +++ b/doc/readline.html @@ -1,6 +1,6 @@ <HTML> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<!-- Created on October, 9 2001 by texi2html 1.64 --> +<!-- Created on June, 27 2002 by texi2html 1.64 --> <!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> @@ -704,8 +704,16 @@ asterisk (<SAMP>`*'</SAMP>) at the start of history lines which have been modifi This variable is <SAMP>`off'</SAMP> by default. <P> -<DT><CODE>match-hidden-files</CODE> +<DT><CODE>mark-symlinked-directories</CODE> <DD><A NAME="IDX20"></A> +If set to <SAMP>`on'</SAMP>, completed names which are symbolic links +to directories have a slash appended (subject to the value of +<CODE>mark-directories</CODE>). +The default is <SAMP>`off'</SAMP>. +<P> + +<DT><CODE>match-hidden-files</CODE> +<DD><A NAME="IDX21"></A> This variable, when set to <SAMP>`on'</SAMP>, causes Readline to match files whose names begin with a <SAMP>`.'</SAMP> (hidden files) when performing filename completion, unless the leading <SAMP>`.'</SAMP> is @@ -714,12 +722,19 @@ This variable is <SAMP>`on'</SAMP> by default. <P> <DT><CODE>output-meta</CODE> -<DD><A NAME="IDX21"></A> +<DD><A NAME="IDX22"></A> If set to <SAMP>`on'</SAMP>, Readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is <SAMP>`off'</SAMP>. <P> +<DT><CODE>page-completions</CODE> +<DD><A NAME="IDX23"></A> +If set to <SAMP>`on'</SAMP>, Readline uses an internal <CODE>more</CODE>-like pager +to display a screenful of possible completions at a time. +This variable is <SAMP>`on'</SAMP> by default. +<P> + <DT><CODE>print-completions-horizontally</CODE> <DD>If set to <SAMP>`on'</SAMP>, Readline will display completions with matches sorted horizontally in alphabetical order, rather than down the screen. @@ -727,7 +742,7 @@ The default is <SAMP>`off'</SAMP>. <P> <DT><CODE>show-all-if-ambiguous</CODE> -<DD><A NAME="IDX22"></A> +<DD><A NAME="IDX24"></A> This alters the default behavior of the completion functions. If set to <SAMP>`on'</SAMP>, words which have more than one possible completion cause the @@ -736,7 +751,7 @@ The default value is <SAMP>`off'</SAMP>. <P> <DT><CODE>visible-stats</CODE> -<DD><A NAME="IDX23"></A> +<DD><A NAME="IDX25"></A> If set to <SAMP>`on'</SAMP>, a character denoting a file's type is appended to the filename when listing possible completions. The default is <SAMP>`off'</SAMP>. @@ -992,14 +1007,14 @@ binding, variable assignment, and conditional syntax. </P><P> <TABLE><tr><td> </td><td class=example><pre># This file controls the behaviour of line input editing for -# programs that use the Gnu Readline library. Existing programs -# include FTP, Bash, and Gdb. +# programs that use the GNU Readline library. Existing +# programs include FTP, Bash, and GDB. # # You can re-read the inputrc file with C-x C-r. # Lines beginning with '#' are comments. # -# First, include any systemwide bindings and variable assignments from -# /etc/Inputrc +# First, include any systemwide bindings and variable +# assignments from /etc/Inputrc $include /etc/Inputrc # @@ -1051,10 +1066,12 @@ TAB: complete $if Bash # edit the path "\C-xp": "PATH=${PATH}\e\C-e\C-a\ef\C-f" -# prepare to type a quoted word -- insert open and close double quotes +# prepare to type a quoted word -- +# insert open and close double quotes # and move to just after the open quote "\C-x\"": "\"\"\C-b" -# insert a backslash (testing backslash escapes in sequences and macros) +# insert a backslash (testing backslash escapes +# in sequences and macros) "\C-x\\": "\\" # Quote the current or previous word "\C-xq": "\eb\"\ef\"" @@ -1070,16 +1087,16 @@ set bell-style visible # don't strip characters to 7 bits when reading set input-meta on -# allow iso-latin1 characters to be inserted rather than converted to -# prefix-meta sequences +# allow iso-latin1 characters to be inserted rather +# than converted to prefix-meta sequences set convert-meta off -# display characters with the eighth bit set directly rather than -# as meta-prefixed characters +# display characters with the eighth bit set directly +# rather than as meta-prefixed characters set output-meta on -# if there are more than 150 possible completions for a word, ask the -# user if he wants to see all of them +# if there are more than 150 possible completions for +# a word, ask the user if he wants to see all of them set completion-query-items 150 # For FTP @@ -1148,54 +1165,54 @@ The text between the point and mark is referred to as the <EM>region</EM>. <H3> 1.4.1 Commands For Moving </H3> <!--docid::SEC14::--> <DL COMPACT> -<A NAME="IDX24"></A> +<A NAME="IDX26"></A> <DT><CODE>beginning-of-line (C-a)</CODE> -<DD><A NAME="IDX25"></A> +<DD><A NAME="IDX27"></A> Move to the start of the current line. <P> -<A NAME="IDX26"></A> +<A NAME="IDX28"></A> <DT><CODE>end-of-line (C-e)</CODE> -<DD><A NAME="IDX27"></A> +<DD><A NAME="IDX29"></A> Move to the end of the line. <P> -<A NAME="IDX28"></A> +<A NAME="IDX30"></A> <DT><CODE>forward-char (C-f)</CODE> -<DD><A NAME="IDX29"></A> +<DD><A NAME="IDX31"></A> Move forward a character. <P> -<A NAME="IDX30"></A> +<A NAME="IDX32"></A> <DT><CODE>backward-char (C-b)</CODE> -<DD><A NAME="IDX31"></A> +<DD><A NAME="IDX33"></A> Move back a character. <P> -<A NAME="IDX32"></A> +<A NAME="IDX34"></A> <DT><CODE>forward-word (M-f)</CODE> -<DD><A NAME="IDX33"></A> +<DD><A NAME="IDX35"></A> Move forward to the end of the next word. Words are composed of letters and digits. <P> -<A NAME="IDX34"></A> +<A NAME="IDX36"></A> <DT><CODE>backward-word (M-b)</CODE> -<DD><A NAME="IDX35"></A> +<DD><A NAME="IDX37"></A> Move back to the start of the current or previous word. Words are composed of letters and digits. <P> -<A NAME="IDX36"></A> +<A NAME="IDX38"></A> <DT><CODE>clear-screen (C-l)</CODE> -<DD><A NAME="IDX37"></A> +<DD><A NAME="IDX39"></A> Clear the screen and redraw the current line, leaving the current line at the top of the screen. <P> -<A NAME="IDX38"></A> +<A NAME="IDX40"></A> <DT><CODE>redraw-current-line ()</CODE> -<DD><A NAME="IDX39"></A> +<DD><A NAME="IDX41"></A> Refresh the current line. By default, this is unbound. <P> @@ -1221,9 +1238,9 @@ Refresh the current line. By default, this is unbound. <P> <DL COMPACT> -<A NAME="IDX40"></A> +<A NAME="IDX42"></A> <DT><CODE>accept-line (Newline or Return)</CODE> -<DD><A NAME="IDX41"></A> +<DD><A NAME="IDX43"></A> 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 recall with @@ -1232,81 +1249,81 @@ If this line is a modified history line, the history line is restored to its original state. <P> -<A NAME="IDX42"></A> +<A NAME="IDX44"></A> <DT><CODE>previous-history (C-p)</CODE> -<DD><A NAME="IDX43"></A> +<DD><A NAME="IDX45"></A> Move `back' through the history list, fetching the previous command. <P> -<A NAME="IDX44"></A> +<A NAME="IDX46"></A> <DT><CODE>next-history (C-n)</CODE> -<DD><A NAME="IDX45"></A> +<DD><A NAME="IDX47"></A> Move `forward' through the history list, fetching the next command. <P> -<A NAME="IDX46"></A> +<A NAME="IDX48"></A> <DT><CODE>beginning-of-history (M-<)</CODE> -<DD><A NAME="IDX47"></A> +<DD><A NAME="IDX49"></A> Move to the first line in the history. <P> -<A NAME="IDX48"></A> +<A NAME="IDX50"></A> <DT><CODE>end-of-history (M->)</CODE> -<DD><A NAME="IDX49"></A> +<DD><A NAME="IDX51"></A> Move to the end of the input history, i.e., the line currently being entered. <P> -<A NAME="IDX50"></A> +<A NAME="IDX52"></A> <DT><CODE>reverse-search-history (C-r)</CODE> -<DD><A NAME="IDX51"></A> +<DD><A NAME="IDX53"></A> Search backward starting at the current line and moving `up' through the history as necessary. This is an incremental search. <P> -<A NAME="IDX52"></A> +<A NAME="IDX54"></A> <DT><CODE>forward-search-history (C-s)</CODE> -<DD><A NAME="IDX53"></A> +<DD><A NAME="IDX55"></A> Search forward starting at the current line and moving `down' through the the history as necessary. This is an incremental search. <P> -<A NAME="IDX54"></A> +<A NAME="IDX56"></A> <DT><CODE>non-incremental-reverse-search-history (M-p)</CODE> -<DD><A NAME="IDX55"></A> +<DD><A NAME="IDX57"></A> Search backward starting at the current line and moving `up' through the history as necessary using a non-incremental search for a string supplied by the user. <P> -<A NAME="IDX56"></A> +<A NAME="IDX58"></A> <DT><CODE>non-incremental-forward-search-history (M-n)</CODE> -<DD><A NAME="IDX57"></A> +<DD><A NAME="IDX59"></A> Search forward starting at the current line and moving `down' through the the history as necessary using a non-incremental search for a string supplied by the user. <P> -<A NAME="IDX58"></A> +<A NAME="IDX60"></A> <DT><CODE>history-search-forward ()</CODE> -<DD><A NAME="IDX59"></A> +<DD><A NAME="IDX61"></A> Search forward through the history for the string of characters between the start of the current line and the point. This is a non-incremental search. By default, this command is unbound. <P> -<A NAME="IDX60"></A> +<A NAME="IDX62"></A> <DT><CODE>history-search-backward ()</CODE> -<DD><A NAME="IDX61"></A> +<DD><A NAME="IDX63"></A> Search backward through the history for the string of characters between the start of the current line and the point. This is a non-incremental search. By default, this command is unbound. <P> -<A NAME="IDX62"></A> +<A NAME="IDX64"></A> <DT><CODE>yank-nth-arg (M-C-y)</CODE> -<DD><A NAME="IDX63"></A> +<DD><A NAME="IDX65"></A> Insert the first argument to the previous command (usually the second word on the previous line) at point. With an argument <VAR>n</VAR>, @@ -1315,9 +1332,9 @@ in the previous command begin with word 0). A negative argument inserts the <VAR>n</VAR>th word from the end of the previous command. <P> -<A NAME="IDX64"></A> +<A NAME="IDX66"></A> <DT><CODE>yank-last-arg (M-. or M-_)</CODE> -<DD><A NAME="IDX65"></A> +<DD><A NAME="IDX67"></A> Insert last argument to the previous command (the last word of the previous history entry). With an argument, behave exactly like <CODE>yank-nth-arg</CODE>. @@ -1347,52 +1364,52 @@ list, inserting the last argument of each line in turn. <P> <DL COMPACT> -<A NAME="IDX66"></A> +<A NAME="IDX68"></A> <DT><CODE>delete-char (C-d)</CODE> -<DD><A NAME="IDX67"></A> +<DD><A NAME="IDX69"></A> Delete the character at point. If point is at the beginning of the line, there are no characters in the line, and the last character typed was not bound to <CODE>delete-char</CODE>, then return EOF. <P> -<A NAME="IDX68"></A> +<A NAME="IDX70"></A> <DT><CODE>backward-delete-char (Rubout)</CODE> -<DD><A NAME="IDX69"></A> +<DD><A NAME="IDX71"></A> Delete the character behind the cursor. A numeric argument means to kill the characters instead of deleting them. <P> -<A NAME="IDX70"></A> +<A NAME="IDX72"></A> <DT><CODE>forward-backward-delete-char ()</CODE> -<DD><A NAME="IDX71"></A> +<DD><A NAME="IDX73"></A> Delete the character under the cursor, unless the cursor is at the end of the line, in which case the character behind the cursor is deleted. By default, this is not bound to a key. <P> -<A NAME="IDX72"></A> +<A NAME="IDX74"></A> <DT><CODE>quoted-insert (C-q or C-v)</CODE> -<DD><A NAME="IDX73"></A> +<DD><A NAME="IDX75"></A> Add the next character typed to the line verbatim. This is how to insert key sequences like <KBD>C-q</KBD>, for example. <P> -<A NAME="IDX74"></A> +<A NAME="IDX76"></A> <DT><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE> -<DD><A NAME="IDX75"></A> +<DD><A NAME="IDX77"></A> Insert a tab character. <P> -<A NAME="IDX76"></A> +<A NAME="IDX78"></A> <DT><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE> -<DD><A NAME="IDX77"></A> +<DD><A NAME="IDX79"></A> Insert yourself. <P> -<A NAME="IDX78"></A> +<A NAME="IDX80"></A> <DT><CODE>transpose-chars (C-t)</CODE> -<DD><A NAME="IDX79"></A> +<DD><A NAME="IDX81"></A> Drag the character before the cursor forward over the character at the cursor, moving the cursor forward as well. If the insertion point @@ -1401,36 +1418,55 @@ transposes the last two characters of the line. Negative arguments have no effect. <P> -<A NAME="IDX80"></A> +<A NAME="IDX82"></A> <DT><CODE>transpose-words (M-t)</CODE> -<DD><A NAME="IDX81"></A> +<DD><A NAME="IDX83"></A> Drag the word before point past the word after point, moving point past that word as well. If the insertion point is at the end of the line, this transposes the last two words on the line. <P> -<A NAME="IDX82"></A> +<A NAME="IDX84"></A> <DT><CODE>upcase-word (M-u)</CODE> -<DD><A NAME="IDX83"></A> +<DD><A NAME="IDX85"></A> Uppercase the current (or following) word. With a negative argument, uppercase the previous word, but do not move the cursor. <P> -<A NAME="IDX84"></A> +<A NAME="IDX86"></A> <DT><CODE>downcase-word (M-l)</CODE> -<DD><A NAME="IDX85"></A> +<DD><A NAME="IDX87"></A> Lowercase the current (or following) word. With a negative argument, lowercase the previous word, but do not move the cursor. <P> -<A NAME="IDX86"></A> +<A NAME="IDX88"></A> <DT><CODE>capitalize-word (M-c)</CODE> -<DD><A NAME="IDX87"></A> +<DD><A NAME="IDX89"></A> Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move the cursor. <P> +<A NAME="IDX90"></A> +<DT><CODE>overwrite-mode ()</CODE> +<DD><A NAME="IDX91"></A> +Toggle overwrite mode. With an explicit positive numeric argument, +switches to overwrite mode. With an explicit non-positive numeric +argument, switches to insert mode. This command affects only +<CODE>emacs</CODE> mode; <CODE>vi</CODE> mode does overwrite differently. +Each call to <CODE>readline()</CODE> starts in insert mode. +<P> + +In overwrite mode, characters bound to <CODE>self-insert</CODE> replace +the text at point rather than pushing the text to the right. +Characters bound to <CODE>backward-delete-char</CODE> replace the character +before point with a space. +</P><P> + +By default, this command is unbound. +</P><P> + </DL> <P> @@ -1454,98 +1490,98 @@ capitalize the previous word, but do not move the cursor. <DL COMPACT> -<A NAME="IDX88"></A> +<A NAME="IDX92"></A> <DT><CODE>kill-line (C-k)</CODE> -<DD><A NAME="IDX89"></A> +<DD><A NAME="IDX93"></A> Kill the text from point to the end of the line. <P> -<A NAME="IDX90"></A> +<A NAME="IDX94"></A> <DT><CODE>backward-kill-line (C-x Rubout)</CODE> -<DD><A NAME="IDX91"></A> +<DD><A NAME="IDX95"></A> Kill backward to the beginning of the line. <P> -<A NAME="IDX92"></A> +<A NAME="IDX96"></A> <DT><CODE>unix-line-discard (C-u)</CODE> -<DD><A NAME="IDX93"></A> +<DD><A NAME="IDX97"></A> Kill backward from the cursor to the beginning of the current line. <P> -<A NAME="IDX94"></A> +<A NAME="IDX98"></A> <DT><CODE>kill-whole-line ()</CODE> -<DD><A NAME="IDX95"></A> +<DD><A NAME="IDX99"></A> Kill all characters on the current line, no matter where point is. By default, this is unbound. <P> -<A NAME="IDX96"></A> +<A NAME="IDX100"></A> <DT><CODE>kill-word (M-d)</CODE> -<DD><A NAME="IDX97"></A> +<DD><A NAME="IDX101"></A> Kill from point to the end of the current word, or if between words, to the end of the next word. Word boundaries are the same as <CODE>forward-word</CODE>. <P> -<A NAME="IDX98"></A> +<A NAME="IDX102"></A> <DT><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE> -<DD><A NAME="IDX99"></A> +<DD><A NAME="IDX103"></A> Kill the word behind point. Word boundaries are the same as <CODE>backward-word</CODE>. <P> -<A NAME="IDX100"></A> +<A NAME="IDX104"></A> <DT><CODE>unix-word-rubout (C-w)</CODE> -<DD><A NAME="IDX101"></A> +<DD><A NAME="IDX105"></A> Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. <P> -<A NAME="IDX102"></A> +<A NAME="IDX106"></A> <DT><CODE>delete-horizontal-space ()</CODE> -<DD><A NAME="IDX103"></A> +<DD><A NAME="IDX107"></A> Delete all spaces and tabs around point. By default, this is unbound. <P> -<A NAME="IDX104"></A> +<A NAME="IDX108"></A> <DT><CODE>kill-region ()</CODE> -<DD><A NAME="IDX105"></A> +<DD><A NAME="IDX109"></A> Kill the text in the current region. By default, this command is unbound. <P> -<A NAME="IDX106"></A> +<A NAME="IDX110"></A> <DT><CODE>copy-region-as-kill ()</CODE> -<DD><A NAME="IDX107"></A> +<DD><A NAME="IDX111"></A> Copy the text in the region to the kill buffer, so it can be yanked right away. By default, this command is unbound. <P> -<A NAME="IDX108"></A> +<A NAME="IDX112"></A> <DT><CODE>copy-backward-word ()</CODE> -<DD><A NAME="IDX109"></A> +<DD><A NAME="IDX113"></A> Copy the word before point to the kill buffer. The word boundaries are the same as <CODE>backward-word</CODE>. By default, this command is unbound. <P> -<A NAME="IDX110"></A> +<A NAME="IDX114"></A> <DT><CODE>copy-forward-word ()</CODE> -<DD><A NAME="IDX111"></A> +<DD><A NAME="IDX115"></A> Copy the word following point to the kill buffer. The word boundaries are the same as <CODE>forward-word</CODE>. By default, this command is unbound. <P> -<A NAME="IDX112"></A> +<A NAME="IDX116"></A> <DT><CODE>yank (C-y)</CODE> -<DD><A NAME="IDX113"></A> +<DD><A NAME="IDX117"></A> Yank the top of the kill ring into the buffer at point. <P> -<A NAME="IDX114"></A> +<A NAME="IDX118"></A> <DT><CODE>yank-pop (M-y)</CODE> -<DD><A NAME="IDX115"></A> +<DD><A NAME="IDX119"></A> Rotate the kill-ring, and yank the new top. You can only do this if the prior command is <CODE>yank</CODE> or <CODE>yank-pop</CODE>. </DL> @@ -1569,16 +1605,16 @@ the prior command is <CODE>yank</CODE> or <CODE>yank-pop</CODE>. <!--docid::SEC18::--> <DL COMPACT> -<A NAME="IDX116"></A> +<A NAME="IDX120"></A> <DT><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE> -<DD><A NAME="IDX117"></A> +<DD><A NAME="IDX121"></A> Add this digit to the argument already accumulating, or start a new argument. <KBD>M--</KBD> starts a negative argument. <P> -<A NAME="IDX118"></A> +<A NAME="IDX122"></A> <DT><CODE>universal-argument ()</CODE> -<DD><A NAME="IDX119"></A> +<DD><A NAME="IDX123"></A> 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. @@ -1613,30 +1649,30 @@ By default, this is not bound to a key. <P> <DL COMPACT> -<A NAME="IDX120"></A> +<A NAME="IDX124"></A> <DT><CODE>complete (<KBD>TAB</KBD>)</CODE> -<DD><A NAME="IDX121"></A> +<DD><A NAME="IDX125"></A> Attempt to perform completion on the text before point. The actual completion performed is application-specific. The default is filename completion. <P> -<A NAME="IDX122"></A> +<A NAME="IDX126"></A> <DT><CODE>possible-completions (M-?)</CODE> -<DD><A NAME="IDX123"></A> +<DD><A NAME="IDX127"></A> List the possible completions of the text before point. <P> -<A NAME="IDX124"></A> +<A NAME="IDX128"></A> <DT><CODE>insert-completions (M-*)</CODE> -<DD><A NAME="IDX125"></A> +<DD><A NAME="IDX129"></A> Insert all completions of the text before point that would have been generated by <CODE>possible-completions</CODE>. <P> -<A NAME="IDX126"></A> +<A NAME="IDX130"></A> <DT><CODE>menu-complete ()</CODE> -<DD><A NAME="IDX127"></A> +<DD><A NAME="IDX131"></A> Similar to <CODE>complete</CODE>, but replaces the word to be completed with a single match from the list of possible completions. Repeated execution of <CODE>menu-complete</CODE> steps through the list @@ -1651,9 +1687,9 @@ This command is intended to be bound to <KBD>TAB</KBD>, but is unbound by default. <P> -<A NAME="IDX128"></A> +<A NAME="IDX132"></A> <DT><CODE>delete-char-or-list ()</CODE> -<DD><A NAME="IDX129"></A> +<DD><A NAME="IDX133"></A> Deletes the character under the cursor if not at the beginning or end of the line (like <CODE>delete-char</CODE>). If at the end of the line, behaves identically to @@ -1682,22 +1718,22 @@ This command is unbound by default. <!--docid::SEC20::--> <DL COMPACT> -<A NAME="IDX130"></A> +<A NAME="IDX134"></A> <DT><CODE>start-kbd-macro (C-x ()</CODE> -<DD><A NAME="IDX131"></A> +<DD><A NAME="IDX135"></A> Begin saving the characters typed into the current keyboard macro. <P> -<A NAME="IDX132"></A> +<A NAME="IDX136"></A> <DT><CODE>end-kbd-macro (C-x ))</CODE> -<DD><A NAME="IDX133"></A> +<DD><A NAME="IDX137"></A> Stop saving the characters typed into the current keyboard macro and save the definition. <P> -<A NAME="IDX134"></A> +<A NAME="IDX138"></A> <DT><CODE>call-last-kbd-macro (C-x e)</CODE> -<DD><A NAME="IDX135"></A> +<DD><A NAME="IDX139"></A> Re-execute the last keyboard macro defined, by making the characters in the macro appear as if typed at the keyboard. <P> @@ -1723,119 +1759,138 @@ in the macro appear as if typed at the keyboard. <!--docid::SEC21::--> <DL COMPACT> -<A NAME="IDX136"></A> +<A NAME="IDX140"></A> <DT><CODE>re-read-init-file (C-x C-r)</CODE> -<DD><A NAME="IDX137"></A> +<DD><A NAME="IDX141"></A> Read in the contents of the <VAR>inputrc</VAR> file, and incorporate any bindings or variable assignments found there. <P> -<A NAME="IDX138"></A> +<A NAME="IDX142"></A> <DT><CODE>abort (C-g)</CODE> -<DD><A NAME="IDX139"></A> +<DD><A NAME="IDX143"></A> Abort the current editing command and ring the terminal's bell (subject to the setting of <CODE>bell-style</CODE>). <P> -<A NAME="IDX140"></A> +<A NAME="IDX144"></A> <DT><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE> -<DD><A NAME="IDX141"></A> +<DD><A NAME="IDX145"></A> If the metafied character <VAR>x</VAR> is lowercase, run the command that is bound to the corresponding uppercase character. <P> -<A NAME="IDX142"></A> +<A NAME="IDX146"></A> <DT><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE> -<DD><A NAME="IDX143"></A> +<DD><A NAME="IDX147"></A> Metafy the next character typed. This is for keyboards without a meta key. Typing <SAMP>`<KBD>ESC</KBD> f'</SAMP> is equivalent to typing <KBD>M-f</KBD>. <P> -<A NAME="IDX144"></A> +<A NAME="IDX148"></A> <DT><CODE>undo (C-_ or C-x C-u)</CODE> -<DD><A NAME="IDX145"></A> +<DD><A NAME="IDX149"></A> Incremental undo, separately remembered for each line. <P> -<A NAME="IDX146"></A> +<A NAME="IDX150"></A> <DT><CODE>revert-line (M-r)</CODE> -<DD><A NAME="IDX147"></A> +<DD><A NAME="IDX151"></A> Undo all changes made to this line. This is like executing the <CODE>undo</CODE> command enough times to get back to the beginning. <P> -<A NAME="IDX148"></A> +<A NAME="IDX152"></A> <DT><CODE>tilde-expand (M-~)</CODE> -<DD><A NAME="IDX149"></A> +<DD><A NAME="IDX153"></A> Perform tilde expansion on the current word. <P> -<A NAME="IDX150"></A> +<A NAME="IDX154"></A> <DT><CODE>set-mark (C-@)</CODE> -<DD><A NAME="IDX151"></A> +<DD><A NAME="IDX155"></A> Set the mark to the point. If a numeric argument is supplied, the mark is set to that position. <P> -<A NAME="IDX152"></A> +<A NAME="IDX156"></A> <DT><CODE>exchange-point-and-mark (C-x C-x)</CODE> -<DD><A NAME="IDX153"></A> +<DD><A NAME="IDX157"></A> 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. <P> -<A NAME="IDX154"></A> +<A NAME="IDX158"></A> <DT><CODE>character-search (C-])</CODE> -<DD><A NAME="IDX155"></A> +<DD><A NAME="IDX159"></A> A character is read and point is moved to the next occurrence of that character. A negative count searches for previous occurrences. <P> -<A NAME="IDX156"></A> +<A NAME="IDX160"></A> <DT><CODE>character-search-backward (M-C-])</CODE> -<DD><A NAME="IDX157"></A> +<DD><A NAME="IDX161"></A> A character is read and point is moved to the previous occurrence of that character. A negative count searches for subsequent occurrences. <P> -<A NAME="IDX158"></A> +<A NAME="IDX162"></A> <DT><CODE>insert-comment (M-#)</CODE> -<DD><A NAME="IDX159"></A> -The value of the <CODE>comment-begin</CODE> -variable is inserted at the beginning of the current line, -and the line is accepted as if a newline had been typed. +<DD><A NAME="IDX163"></A> +Without a numeric argument, the value of the <CODE>comment-begin</CODE> +variable 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 <CODE>comment-begin</CODE>, the value is inserted, otherwise +the characters in <CODE>comment-begin</CODE> are deleted from the beginning of +the line. +In either case, the line is accepted as if a newline had been typed. <P> -<A NAME="IDX160"></A> +<A NAME="IDX164"></A> <DT><CODE>dump-functions ()</CODE> -<DD><A NAME="IDX161"></A> +<DD><A NAME="IDX165"></A> Print all of the functions and their key bindings 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> -<A NAME="IDX162"></A> +<A NAME="IDX166"></A> <DT><CODE>dump-variables ()</CODE> -<DD><A NAME="IDX163"></A> +<DD><A NAME="IDX167"></A> 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> -<A NAME="IDX164"></A> +<A NAME="IDX168"></A> <DT><CODE>dump-macros ()</CODE> -<DD><A NAME="IDX165"></A> +<DD><A NAME="IDX169"></A> 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> +<A NAME="IDX170"></A> +<DT><CODE>emacs-editing-mode (C-e)</CODE> +<DD><A NAME="IDX171"></A> +When in <CODE>vi</CODE> command mode, this causes a switch to <CODE>emacs</CODE> +editing mode. +<P> + +<A NAME="IDX172"></A> +<DT><CODE>vi-editing-mode (M-C-j)</CODE> +<DD><A NAME="IDX173"></A> +When in <CODE>emacs</CODE> editing mode, this causes a switch to <CODE>vi</CODE> +editing mode. +<P> + </DL> <P> @@ -1882,7 +1937,7 @@ in the consitency of user interface across discrete programs that need to provide a command line interface. </P><P> -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. </P><P> Permission is granted to make and distribute verbatim copies of @@ -1966,8 +2021,8 @@ the simplest way possible, perhaps to replace calls in your code to <CODE>gets()</CODE> or <CODE>fgets()</CODE>. </P><P> -<A NAME="IDX166"></A> -<A NAME="IDX167"></A> +<A NAME="IDX174"></A> +<A NAME="IDX175"></A> </P><P> The function <CODE>readline()</CODE> prints a prompt <VAR>prompt</VAR> @@ -2013,12 +2068,13 @@ function, and has the advantage of no static buffer to overflow: <TABLE><tr><td> </td><td class=example><pre>/* A static variable for holding the line. */ static char *line_read = (char *)NULL; -/* Read a string, and return a pointer to it. Returns NULL on EOF. */ +/* Read a string, and return a pointer to it. + Returns NULL on EOF. */ char * rl_gets () { - /* If the buffer has already been allocated, return the memory - to the free pool. */ + /* If the buffer has already been allocated, + return the memory to the free pool. */ if (line_read) { free (line_read); @@ -2028,7 +2084,8 @@ rl_gets () /* Get a line from the user. */ line_read = readline (""); - /* If the line has any text in it, save it on the history. */ + /* If the line has any text in it, + save it on the history. */ if (line_read && *line_read) add_history (line_read); @@ -2236,7 +2293,7 @@ variables that describe the current state of the line read so far. The calling sequence for a command <CODE>foo</CODE> looks like </P><P> -<TABLE><tr><td> </td><td class=example><pre><CODE>foo (int count, int key)</CODE> +<TABLE><tr><td> </td><td class=example><pre><CODE>int foo (int count, int key)</CODE> </pre></td></tr></table></P><P> where <VAR>count</VAR> is the numeric argument (or 1 if defaulted) and @@ -2254,6 +2311,10 @@ At the very least, it should be aware that it can be passed a negative argument. </P><P> +A command function should return 0 if its action completes successfully, +and a non-zero value if some error occurs. +</P><P> + <A NAME="Readline Variables"></A> <HR SIZE="6"> <A NAME="SEC28"></A> @@ -2275,7 +2336,7 @@ negative argument. These variables are available to function writers. </P><P> -<A NAME="IDX168"></A> +<A NAME="IDX176"></A> <DL> <DT><U>Variable:</U> char * <B>rl_line_buffer</B> <DD>This is the line gathered so far. You are welcome to modify the @@ -2285,7 +2346,7 @@ the memory allocated to <CODE>rl_line_buffer</CODE>. </DL> </P><P> -<A NAME="IDX169"></A> +<A NAME="IDX177"></A> <DL> <DT><U>Variable:</U> int <B>rl_point</B> <DD>The offset of the current cursor position in <CODE>rl_line_buffer</CODE> @@ -2293,7 +2354,7 @@ the memory allocated to <CODE>rl_line_buffer</CODE>. </DL> </P><P> -<A NAME="IDX170"></A> +<A NAME="IDX178"></A> <DL> <DT><U>Variable:</U> int <B>rl_end</B> <DD>The number of characters present in <CODE>rl_line_buffer</CODE>. When @@ -2302,7 +2363,7 @@ the memory allocated to <CODE>rl_line_buffer</CODE>. </DL> </P><P> -<A NAME="IDX171"></A> +<A NAME="IDX179"></A> <DL> <DT><U>Variable:</U> int <B>rl_mark</B> <DD>The <VAR>mark</VAR> (saved position) in the current line. If set, the mark @@ -2310,7 +2371,7 @@ and point define a <EM>region</EM>. </DL> </P><P> -<A NAME="IDX172"></A> +<A NAME="IDX180"></A> <DL> <DT><U>Variable:</U> int <B>rl_done</B> <DD>Setting this to a non-zero value causes Readline to return the current @@ -2318,7 +2379,7 @@ line immediately. </DL> </P><P> -<A NAME="IDX173"></A> +<A NAME="IDX181"></A> <DL> <DT><U>Variable:</U> int <B>rl_num_chars_to_read</B> <DD>Setting this to a positive value before calling <CODE>readline()</CODE> causes @@ -2327,7 +2388,7 @@ than reading up to a character bound to <CODE>accept-line</CODE>. </DL> </P><P> -<A NAME="IDX174"></A> +<A NAME="IDX182"></A> <DL> <DT><U>Variable:</U> int <B>rl_pending_input</B> <DD>Setting this to a value makes it the next keystroke read. This is a @@ -2335,7 +2396,7 @@ way to stuff a single character into the input stream. </DL> </P><P> -<A NAME="IDX175"></A> +<A NAME="IDX183"></A> <DL> <DT><U>Variable:</U> int <B>rl_dispatching</B> <DD>Set to a non-zero value if a function is being called from a key binding; @@ -2344,7 +2405,7 @@ they were called directly or by Readline's dispatching mechanism. </DL> </P><P> -<A NAME="IDX176"></A> +<A NAME="IDX184"></A> <DL> <DT><U>Variable:</U> int <B>rl_erase_empty_line</B> <DD>Setting this to a non-zero value causes Readline to completely erase @@ -2354,7 +2415,7 @@ the beginning of the newly-blank line. </DL> </P><P> -<A NAME="IDX177"></A> +<A NAME="IDX185"></A> <DL> <DT><U>Variable:</U> char * <B>rl_prompt</B> <DD>The prompt Readline uses. This is set from the argument to @@ -2364,7 +2425,7 @@ be used to modify the prompt string after calling <CODE>readline()</CODE>. </DL> </P><P> -<A NAME="IDX178"></A> +<A NAME="IDX186"></A> <DL> <DT><U>Variable:</U> int <B>rl_already_prompted</B> <DD>If an application wishes to display the prompt itself, rather than have @@ -2377,14 +2438,14 @@ never sets it. </DL> </P><P> -<A NAME="IDX179"></A> +<A NAME="IDX187"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_library_version</B> <DD>The version number of this revision of the library. </DL> </P><P> -<A NAME="IDX180"></A> +<A NAME="IDX188"></A> <DL> <DT><U>Variable:</U> int <B>rl_readline_version</B> <DD>An integer encoding the current version of the library. The encoding is @@ -2395,7 +2456,7 @@ value 0x0402. </DL> </P><P> -<A NAME="IDX181"></A> +<A NAME="IDX189"></A> <DL> <DT><U>Variable:</U> int <B>rl_gnu_readline_p</B> <DD>Always set to 1, denoting that this is GNU readline rather than some @@ -2403,7 +2464,7 @@ emulation. </DL> </P><P> -<A NAME="IDX182"></A> +<A NAME="IDX190"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_terminal_name</B> <DD>The terminal type, used for initialization. If not set by the application, @@ -2412,7 +2473,7 @@ the first time it is called. </DL> </P><P> -<A NAME="IDX183"></A> +<A NAME="IDX191"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_readline_name</B> <DD>This variable is set to a unique name by each application using Readline. @@ -2421,21 +2482,23 @@ The value allows conditional parsing of the inputrc file </DL> </P><P> -<A NAME="IDX184"></A> +<A NAME="IDX192"></A> <DL> <DT><U>Variable:</U> FILE * <B>rl_instream</B> <DD>The stdio stream from which Readline reads input. +If <CODE>NULL</CODE>, Readline defaults to <VAR>stdin</VAR>. </DL> </P><P> -<A NAME="IDX185"></A> +<A NAME="IDX193"></A> <DL> <DT><U>Variable:</U> FILE * <B>rl_outstream</B> <DD>The stdio stream to which Readline performs output. +If <CODE>NULL</CODE>, Readline defaults to <VAR>stdout</VAR>. </DL> </P><P> -<A NAME="IDX186"></A> +<A NAME="IDX194"></A> <DL> <DT><U>Variable:</U> rl_command_func_t * <B>rl_last_func</B> <DD>The address of the last command function Readline executed. May be used to @@ -2444,7 +2507,7 @@ example. </DL> </P><P> -<A NAME="IDX187"></A> +<A NAME="IDX195"></A> <DL> <DT><U>Variable:</U> rl_hook_func_t * <B>rl_startup_hook</B> <DD>If non-zero, this is the address of a function to call just @@ -2452,7 +2515,7 @@ before <CODE>readline</CODE> prints the first prompt. </DL> </P><P> -<A NAME="IDX188"></A> +<A NAME="IDX196"></A> <DL> <DT><U>Variable:</U> rl_hook_func_t * <B>rl_pre_input_hook</B> <DD>If non-zero, this is the address of a function to call after @@ -2461,7 +2524,7 @@ starts reading input characters. </DL> </P><P> -<A NAME="IDX189"></A> +<A NAME="IDX197"></A> <DL> <DT><U>Variable:</U> rl_hook_func_t * <B>rl_event_hook</B> <DD>If non-zero, this is the address of a function to call periodically @@ -2471,7 +2534,7 @@ is no keyboard input. </DL> </P><P> -<A NAME="IDX190"></A> +<A NAME="IDX198"></A> <DL> <DT><U>Variable:</U> rl_getc_func_t * <B>rl_getc_function</B> <DD>If non-zero, Readline will call indirectly through this pointer @@ -2481,7 +2544,7 @@ to get a character from the input stream. By default, it is set to </DL> </P><P> -<A NAME="IDX191"></A> +<A NAME="IDX199"></A> <DL> <DT><U>Variable:</U> rl_voidfunc_t * <B>rl_redisplay_function</B> <DD>If non-zero, Readline will call indirectly through this pointer @@ -2491,7 +2554,7 @@ redisplay function (see section <A HREF="readline.html#SEC35">2.4.6 Redisplay</A </DL> </P><P> -<A NAME="IDX192"></A> +<A NAME="IDX200"></A> <DL> <DT><U>Variable:</U> rl_vintfunc_t * <B>rl_prep_term_function</B> <DD>If non-zero, Readline will call indirectly through this pointer @@ -2502,7 +2565,7 @@ By default, this is set to <CODE>rl_prep_terminal</CODE> </DL> </P><P> -<A NAME="IDX193"></A> +<A NAME="IDX201"></A> <DL> <DT><U>Variable:</U> rl_voidfunc_t * <B>rl_deprep_term_function</B> <DD>If non-zero, Readline will call indirectly through this pointer @@ -2513,7 +2576,7 @@ By default, this is set to <CODE>rl_deprep_terminal</CODE> </DL> </P><P> -<A NAME="IDX194"></A> +<A NAME="IDX202"></A> <DL> <DT><U>Variable:</U> Keymap <B>rl_executing_keymap</B> <DD>This variable is set to the keymap (see section <A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A>) in which the @@ -2521,7 +2584,7 @@ currently executing readline function was found. </DL> </P><P> -<A NAME="IDX195"></A> +<A NAME="IDX203"></A> <DL> <DT><U>Variable:</U> Keymap <B>rl_binding_keymap</B> <DD>This variable is set to the keymap (see section <A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A>) in which the @@ -2529,14 +2592,14 @@ last key binding occurred. </DL> </P><P> -<A NAME="IDX196"></A> +<A NAME="IDX204"></A> <DL> <DT><U>Variable:</U> char * <B>rl_executing_macro</B> <DD>This variable is set to the text of any currently-executing macro. </DL> </P><P> -<A NAME="IDX197"></A> +<A NAME="IDX205"></A> <DL> <DT><U>Variable:</U> int <B>rl_readline_state</B> <DD>A variable with bit values that encapsulate the current Readline state. @@ -2592,7 +2655,7 @@ and is about to return the line to the caller. </DL> </P><P> -<A NAME="IDX198"></A> +<A NAME="IDX206"></A> <DL> <DT><U>Variable:</U> int <B>rl_explicit_arg</B> <DD>Set to a non-zero value if an explicit numeric argument was specified by @@ -2600,7 +2663,7 @@ the user. Only valid in a bindable command function. </DL> </P><P> -<A NAME="IDX199"></A> +<A NAME="IDX207"></A> <DL> <DT><U>Variable:</U> int <B>rl_numeric_arg</B> <DD>Set to the value of any numeric argument explicitly specified by the user @@ -2609,7 +2672,7 @@ command function. </DL> </P><P> -<A NAME="IDX200"></A> +<A NAME="IDX208"></A> <DL> <DT><U>Variable:</U> int <B>rl_editing_mode</B> <DD>Set to a value denoting Readline's current editing mode. A value of @@ -2687,7 +2750,7 @@ programmer, should bind the functions you write to descriptive names as well. Readline provides a function for doing that: </P><P> -<A NAME="IDX201"></A> +<A NAME="IDX209"></A> <DL> <DT><U>Function:</U> int <B>rl_add_defun</B> <I>(const char *name, rl_command_func_t *function, int key)</I> <DD>Add <VAR>name</VAR> to the list of named functions. Make <VAR>function</VAR> be @@ -2727,7 +2790,7 @@ get run. You can make your own keymaps, copy existing keymaps, and tell Readline which keymap to use. </P><P> -<A NAME="IDX202"></A> +<A NAME="IDX210"></A> <DL> <DT><U>Function:</U> Keymap <B>rl_make_bare_keymap</B> <I>(void)</I> <DD>Returns a new, empty keymap. The space for the keymap is allocated with @@ -2736,14 +2799,14 @@ Readline which keymap to use. </DL> </P><P> -<A NAME="IDX203"></A> +<A NAME="IDX211"></A> <DL> <DT><U>Function:</U> Keymap <B>rl_copy_keymap</B> <I>(Keymap map)</I> <DD>Return a new keymap which is a copy of <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX204"></A> +<A NAME="IDX212"></A> <DL> <DT><U>Function:</U> Keymap <B>rl_make_keymap</B> <I>(void)</I> <DD>Return a new keymap with the printing characters bound to rl_insert, @@ -2752,7 +2815,7 @@ the Meta digits bound to produce numeric arguments. </DL> </P><P> -<A NAME="IDX205"></A> +<A NAME="IDX213"></A> <DL> <DT><U>Function:</U> void <B>rl_discard_keymap</B> <I>(Keymap keymap)</I> <DD>Free the storage associated with <VAR>keymap</VAR>. @@ -2763,21 +2826,21 @@ Readline has several internal keymaps. These functions allow you to change which keymap is active. </P><P> -<A NAME="IDX206"></A> +<A NAME="IDX214"></A> <DL> <DT><U>Function:</U> Keymap <B>rl_get_keymap</B> <I>(void)</I> <DD>Returns the currently active keymap. </DL> </P><P> -<A NAME="IDX207"></A> +<A NAME="IDX215"></A> <DL> <DT><U>Function:</U> void <B>rl_set_keymap</B> <I>(Keymap keymap)</I> <DD>Makes <VAR>keymap</VAR> the currently active keymap. </DL> </P><P> -<A NAME="IDX208"></A> +<A NAME="IDX216"></A> <DL> <DT><U>Function:</U> Keymap <B>rl_get_keymap_by_name</B> <I>(const char *name)</I> <DD>Return the keymap matching <VAR>name</VAR>. <VAR>name</VAR> is one which would @@ -2785,7 +2848,7 @@ be supplied in a <CODE>set keymap</CODE> inputrc line (see section <A HREF="read </DL> </P><P> -<A NAME="IDX209"></A> +<A NAME="IDX217"></A> <DL> <DT><U>Function:</U> char * <B>rl_get_keymap_name</B> <I>(Keymap keymap)</I> <DD>Return the name matching <VAR>keymap</VAR>. <VAR>name</VAR> is one which would @@ -2830,7 +2893,7 @@ initialization function assigned to the <CODE>rl_startup_hook</CODE> variable These functions manage key bindings. </P><P> -<A NAME="IDX210"></A> +<A NAME="IDX218"></A> <DL> <DT><U>Function:</U> int <B>rl_bind_key</B> <I>(int key, rl_command_func_t *function)</I> <DD>Binds <VAR>key</VAR> to <VAR>function</VAR> in the currently active keymap. @@ -2838,7 +2901,7 @@ Returns non-zero in the case of an invalid <VAR>key</VAR>. </DL> </P><P> -<A NAME="IDX211"></A> +<A NAME="IDX219"></A> <DL> <DT><U>Function:</U> int <B>rl_bind_key_in_map</B> <I>(int key, rl_command_func_t *function, Keymap map)</I> <DD>Bind <VAR>key</VAR> to <VAR>function</VAR> in <VAR>map</VAR>. Returns non-zero in the case @@ -2846,7 +2909,7 @@ of an invalid <VAR>key</VAR>. </DL> </P><P> -<A NAME="IDX212"></A> +<A NAME="IDX220"></A> <DL> <DT><U>Function:</U> int <B>rl_unbind_key</B> <I>(int key)</I> <DD>Bind <VAR>key</VAR> to the null function in the currently active keymap. @@ -2854,7 +2917,7 @@ Returns non-zero in case of error. </DL> </P><P> -<A NAME="IDX213"></A> +<A NAME="IDX221"></A> <DL> <DT><U>Function:</U> int <B>rl_unbind_key_in_map</B> <I>(int key, Keymap map)</I> <DD>Bind <VAR>key</VAR> to the null function in <VAR>map</VAR>. @@ -2862,21 +2925,21 @@ Returns non-zero in case of error. </DL> </P><P> -<A NAME="IDX214"></A> +<A NAME="IDX222"></A> <DL> <DT><U>Function:</U> int <B>rl_unbind_function_in_map</B> <I>(rl_command_func_t *function, Keymap map)</I> <DD>Unbind all keys that execute <VAR>function</VAR> in <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX215"></A> +<A NAME="IDX223"></A> <DL> <DT><U>Function:</U> int <B>rl_unbind_command_in_map</B> <I>(const char *command, Keymap map)</I> <DD>Unbind all keys that are bound to <VAR>command</VAR> in <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX216"></A> +<A NAME="IDX224"></A> <DL> <DT><U>Function:</U> int <B>rl_set_key</B> <I>(const char *keyseq, rl_command_func_t *function, Keymap map)</I> <DD>Bind the key sequence represented by the string <VAR>keyseq</VAR> to the function @@ -2885,7 +2948,7 @@ necessary. The initial keymap in which to do bindings is <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX217"></A> +<A NAME="IDX225"></A> <DL> <DT><U>Function:</U> int <B>rl_generic_bind</B> <I>(int type, const char *keyseq, char *data, Keymap map)</I> <DD>Bind the key sequence represented by the string <VAR>keyseq</VAR> to the arbitrary @@ -2896,7 +2959,7 @@ necessary. The initial keymap in which to do bindings is <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX218"></A> +<A NAME="IDX226"></A> <DL> <DT><U>Function:</U> int <B>rl_parse_and_bind</B> <I>(char *line)</I> <DD>Parse <VAR>line</VAR> as if it had been read from the <CODE>inputrc</CODE> file and @@ -2905,7 +2968,7 @@ perform any key bindings and variable assignments found </DL> </P><P> -<A NAME="IDX219"></A> +<A NAME="IDX227"></A> <DL> <DT><U>Function:</U> int <B>rl_read_init_file</B> <I>(const char *filename)</I> <DD>Read keybindings and variable assignments from <VAR>filename</VAR> @@ -2936,14 +2999,14 @@ and the functions invoked by a particular key sequence. You may also associate a new function name with an arbitrary function. </P><P> -<A NAME="IDX220"></A> +<A NAME="IDX228"></A> <DL> <DT><U>Function:</U> rl_command_func_t * <B>rl_named_function</B> <I>(const char *name)</I> <DD>Return the function with name <VAR>name</VAR>. </DL> </P><P> -<A NAME="IDX221"></A> +<A NAME="IDX229"></A> <DL> <DT><U>Function:</U> rl_command_func_t * <B>rl_function_of_keyseq</B> <I>(const char *keyseq, Keymap map, int *type)</I> <DD>Return the function invoked by <VAR>keyseq</VAR> in keymap <VAR>map</VAR>. @@ -2953,7 +3016,7 @@ it points to (one of <CODE>ISFUNC</CODE>, <CODE>ISKMAP</CODE>, or <CODE>ISMACR</ </DL> </P><P> -<A NAME="IDX222"></A> +<A NAME="IDX230"></A> <DL> <DT><U>Function:</U> char ** <B>rl_invoking_keyseqs</B> <I>(rl_command_func_t *function)</I> <DD>Return an array of strings representing the key sequences used to @@ -2961,7 +3024,7 @@ invoke <VAR>function</VAR> in the current keymap. </DL> </P><P> -<A NAME="IDX223"></A> +<A NAME="IDX231"></A> <DL> <DT><U>Function:</U> char ** <B>rl_invoking_keyseqs_in_map</B> <I>(rl_command_func_t *function, Keymap map)</I> <DD>Return an array of strings representing the key sequences used to @@ -2969,7 +3032,7 @@ invoke <VAR>function</VAR> in the keymap <VAR>map</VAR>. </DL> </P><P> -<A NAME="IDX224"></A> +<A NAME="IDX232"></A> <DL> <DT><U>Function:</U> void <B>rl_function_dumper</B> <I>(int readable)</I> <DD>Print the readline function names and the key sequences currently @@ -2979,14 +3042,14 @@ the list is formatted in such a way that it can be made part of an </DL> </P><P> -<A NAME="IDX225"></A> +<A NAME="IDX233"></A> <DL> <DT><U>Function:</U> void <B>rl_list_funmap_names</B> <I>(void)</I> <DD>Print the names of all bindable Readline functions to <CODE>rl_outstream</CODE>. </DL> </P><P> -<A NAME="IDX226"></A> +<A NAME="IDX234"></A> <DL> <DT><U>Function:</U> const char ** <B>rl_funmap_names</B> <I>(void)</I> <DD>Return a NULL terminated array of known function names. The array is @@ -2995,7 +3058,7 @@ should <CODE>free()</CODE> the array when you are done, but not the pointers. </DL> </P><P> -<A NAME="IDX227"></A> +<A NAME="IDX235"></A> <DL> <DT><U>Function:</U> int <B>rl_add_funmap_entry</B> <I>(const char *name, rl_command_func_t *function)</I> <DD>Add <VAR>name</VAR> to the list of bindable Readline command names, and make @@ -3040,8 +3103,8 @@ This is done with <CODE>rl_begin_undo_group()</CODE> and The types of events that can be undone are: </P><P> -<TABLE><tr><td> </td><td class=example><pre>enum undo_code { UNDO_DELETE, UNDO_INSERT, UNDO_BEGIN, UNDO_END }; -</pre></td></tr></table></P><P> +<TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>enum undo_code { UNDO_DELETE, UNDO_INSERT, UNDO_BEGIN, UNDO_END }; +</FONT></pre></td></tr></table></P><P> Notice that <CODE>UNDO_DELETE</CODE> means to insert some text, and <CODE>UNDO_INSERT</CODE> means to delete some text. That is, the undo code @@ -3050,7 +3113,7 @@ tells what to undo, not how to undo it. <CODE>UNDO_BEGIN</CODE> and <CODE>rl_end_undo_group()</CODE>. </P><P> -<A NAME="IDX228"></A> +<A NAME="IDX236"></A> <DL> <DT><U>Function:</U> int <B>rl_begin_undo_group</B> <I>(void)</I> <DD>Begins saving undo information in a group construct. The undo @@ -3060,7 +3123,7 @@ information usually comes from calls to <CODE>rl_insert_text()</CODE> and </DL> </P><P> -<A NAME="IDX229"></A> +<A NAME="IDX237"></A> <DL> <DT><U>Function:</U> int <B>rl_end_undo_group</B> <I>(void)</I> <DD>Closes the current undo group started with <CODE>rl_begin_undo_group @@ -3069,7 +3132,7 @@ for each call to <CODE>rl_begin_undo_group()</CODE>. </DL> </P><P> -<A NAME="IDX230"></A> +<A NAME="IDX238"></A> <DL> <DT><U>Function:</U> void <B>rl_add_undo</B> <I>(enum undo_code what, int start, int end, char *text)</I> <DD>Remember how to undo an event (according to <VAR>what</VAR>). The affected @@ -3077,14 +3140,14 @@ text runs from <VAR>start</VAR> to <VAR>end</VAR>, and encompasses <VAR>text</VA </DL> </P><P> -<A NAME="IDX231"></A> +<A NAME="IDX239"></A> <DL> <DT><U>Function:</U> void <B>rl_free_undo_list</B> <I>(void)</I> <DD>Free the existing undo list. </DL> </P><P> -<A NAME="IDX232"></A> +<A NAME="IDX240"></A> <DL> <DT><U>Function:</U> int <B>rl_do_undo</B> <I>(void)</I> <DD>Undo the first thing on the undo list. Returns <CODE>0</CODE> if there was @@ -3098,7 +3161,7 @@ once, just before you modify the text. You must supply the indices of the text range that you are going to modify. </P><P> -<A NAME="IDX233"></A> +<A NAME="IDX241"></A> <DL> <DT><U>Function:</U> int <B>rl_modifying</B> <I>(int start, int end)</I> <DD>Tell Readline to save the text between <VAR>start</VAR> and <VAR>end</VAR> as a @@ -3125,7 +3188,7 @@ that text. <!--docid::SEC35::--> <P> -<A NAME="IDX234"></A> +<A NAME="IDX242"></A> <DL> <DT><U>Function:</U> void <B>rl_redisplay</B> <I>(void)</I> <DD>Change what's displayed on the screen to reflect the current contents @@ -3133,7 +3196,7 @@ of <CODE>rl_line_buffer</CODE>. </DL> </P><P> -<A NAME="IDX235"></A> +<A NAME="IDX243"></A> <DL> <DT><U>Function:</U> int <B>rl_forced_update_display</B> <I>(void)</I> <DD>Force the line to be updated and redisplayed, whether or not @@ -3141,7 +3204,7 @@ Readline thinks the screen display is correct. </DL> </P><P> -<A NAME="IDX236"></A> +<A NAME="IDX244"></A> <DL> <DT><U>Function:</U> int <B>rl_on_new_line</B> <I>(void)</I> <DD>Tell the update functions that we have moved onto a new (empty) line, @@ -3149,7 +3212,7 @@ usually after ouputting a newline. </DL> </P><P> -<A NAME="IDX237"></A> +<A NAME="IDX245"></A> <DL> <DT><U>Function:</U> int <B>rl_on_new_line_with_prompt</B> <I>(void)</I> <DD>Tell the update functions that we have moved onto a new line, with @@ -3161,7 +3224,7 @@ It should be used after setting <VAR>rl_already_prompted</VAR>. </DL> </P><P> -<A NAME="IDX238"></A> +<A NAME="IDX246"></A> <DL> <DT><U>Function:</U> int <B>rl_reset_line_state</B> <I>(void)</I> <DD>Reset the display state to a clean state and redisplay the current line @@ -3169,14 +3232,14 @@ starting on a new line. </DL> </P><P> -<A NAME="IDX239"></A> +<A NAME="IDX247"></A> <DL> <DT><U>Function:</U> int <B>rl_crlf</B> <I>(void)</I> <DD>Move the cursor to the start of the next screen line. </DL> </P><P> -<A NAME="IDX240"></A> +<A NAME="IDX248"></A> <DL> <DT><U>Function:</U> int <B>rl_show_char</B> <I>(int c)</I> <DD>Display character <VAR>c</VAR> on <CODE>rl_outstream</CODE>. @@ -3187,7 +3250,7 @@ redisplay. </DL> </P><P> -<A NAME="IDX241"></A> +<A NAME="IDX249"></A> <DL> <DT><U>Function:</U> int <B>rl_message</B> <I>(const char *, <small>...</small>)</I> <DD>The arguments are a format string as would be supplied to <CODE>printf</CODE>, @@ -3198,14 +3261,14 @@ is also used to display numeric arguments and search strings. </DL> </P><P> -<A NAME="IDX242"></A> +<A NAME="IDX250"></A> <DL> <DT><U>Function:</U> int <B>rl_clear_message</B> <I>(void)</I> <DD>Clear the message in the echo area. </DL> </P><P> -<A NAME="IDX243"></A> +<A NAME="IDX251"></A> <DL> <DT><U>Function:</U> void <B>rl_save_prompt</B> <I>(void)</I> <DD>Save the local Readline prompt display state in preparation for @@ -3213,7 +3276,7 @@ displaying a new message in the message area with <CODE>rl_message()</CODE>. </DL> </P><P> -<A NAME="IDX244"></A> +<A NAME="IDX252"></A> <DL> <DT><U>Function:</U> void <B>rl_restore_prompt</B> <I>(void)</I> <DD>Restore the local Readline prompt display state saved by the most @@ -3221,7 +3284,7 @@ recent call to <CODE>rl_save_prompt</CODE>. </DL> </P><P> -<A NAME="IDX245"></A> +<A NAME="IDX253"></A> <DL> <DT><U>Function:</U> int <B>rl_expand_prompt</B> <I>(char *prompt)</I> <DD>Expand any special character sequences in <VAR>prompt</VAR> and set up the @@ -3234,7 +3297,7 @@ It returns the number of visible characters on the last line of the </DL> </P><P> -<A NAME="IDX246"></A> +<A NAME="IDX254"></A> <DL> <DT><U>Function:</U> int <B>rl_set_prompt</B> <I>(const char *prompt)</I> <DD>Make Readline use <VAR>prompt</VAR> for subsequent redisplay. This calls @@ -3261,21 +3324,23 @@ to the result. <!--docid::SEC36::--> <P> -<A NAME="IDX247"></A> +<A NAME="IDX255"></A> <DL> <DT><U>Function:</U> int <B>rl_insert_text</B> <I>(const char *text)</I> <DD>Insert <VAR>text</VAR> into the line at the current cursor position. +Returns the number of characters inserted. </DL> </P><P> -<A NAME="IDX248"></A> +<A NAME="IDX256"></A> <DL> <DT><U>Function:</U> int <B>rl_delete_text</B> <I>(int start, int end)</I> <DD>Delete the text between <VAR>start</VAR> and <VAR>end</VAR> in the current line. +Returns the number of characters deleted. </DL> </P><P> -<A NAME="IDX249"></A> +<A NAME="IDX257"></A> <DL> <DT><U>Function:</U> char * <B>rl_copy_text</B> <I>(int start, int end)</I> <DD>Return a copy of the text between <VAR>start</VAR> and <VAR>end</VAR> in @@ -3283,7 +3348,7 @@ the current line. </DL> </P><P> -<A NAME="IDX250"></A> +<A NAME="IDX258"></A> <DL> <DT><U>Function:</U> int <B>rl_kill_text</B> <I>(int start, int end)</I> <DD>Copy the text between <VAR>start</VAR> and <VAR>end</VAR> in the current line @@ -3295,7 +3360,7 @@ not a kill, a new kill ring slot is used. </DL> </P><P> -<A NAME="IDX251"></A> +<A NAME="IDX259"></A> <DL> <DT><U>Function:</U> int <B>rl_push_macro_input</B> <I>(char *macro)</I> <DD>Cause <VAR>macro</VAR> to be inserted into the line, as if it had been invoked @@ -3322,7 +3387,7 @@ by a key bound to a macro. Not especially useful; use <!--docid::SEC37::--> <P> -<A NAME="IDX252"></A> +<A NAME="IDX260"></A> <DL> <DT><U>Function:</U> int <B>rl_read_key</B> <I>(void)</I> <DD>Return the next character available from Readline's current input stream. @@ -3334,7 +3399,7 @@ the <CODE>rl_event_hook</CODE> variable. </DL> </P><P> -<A NAME="IDX253"></A> +<A NAME="IDX261"></A> <DL> <DT><U>Function:</U> int <B>rl_getc</B> <I>(FILE *stream)</I> <DD>Return the next character available from <VAR>stream</VAR>, which is assumed to @@ -3342,16 +3407,18 @@ be the keyboard. </DL> </P><P> -<A NAME="IDX254"></A> +<A NAME="IDX262"></A> <DL> <DT><U>Function:</U> int <B>rl_stuff_char</B> <I>(int c)</I> <DD>Insert <VAR>c</VAR> into the Readline input stream. It will be "read" before Readline attempts to read characters from the terminal with -<CODE>rl_read_key()</CODE>. +<CODE>rl_read_key()</CODE>. Up to 512 characters may be pushed back. +<CODE>rl_stuff_char</CODE> returns 1 if the character was successfully inserted; +0 otherwise. </DL> </P><P> -<A NAME="IDX255"></A> +<A NAME="IDX263"></A> <DL> <DT><U>Function:</U> int <B>rl_execute_next</B> <I>(int c)</I> <DD>Make <VAR>c</VAR> be the next command to be executed when <CODE>rl_read_key()</CODE> @@ -3359,7 +3426,7 @@ is called. This sets <VAR>rl_pending_input</VAR>. </DL> </P><P> -<A NAME="IDX256"></A> +<A NAME="IDX264"></A> <DL> <DT><U>Function:</U> int <B>rl_clear_pending_input</B> <I>(void)</I> <DD>Unset <VAR>rl_pending_input</VAR>, effectively negating the effect of any @@ -3368,7 +3435,7 @@ pending input has not already been read with <CODE>rl_read_key()</CODE>. </DL> </P><P> -<A NAME="IDX257"></A> +<A NAME="IDX265"></A> <DL> <DT><U>Function:</U> int <B>rl_set_keyboard_input_timeout</B> <I>(int u)</I> <DD>While waiting for keyboard input in <CODE>rl_read_key()</CODE>, Readline will @@ -3396,7 +3463,7 @@ one-tenth of a second. Returns the old timeout value. <!--docid::SEC38::--> <P> -<A NAME="IDX258"></A> +<A NAME="IDX266"></A> <DL> <DT><U>Function:</U> void <B>rl_prep_terminal</B> <I>(int meta_flag)</I> <DD>Modify the terminal settings for Readline's use, so <CODE>readline()</CODE> @@ -3406,7 +3473,7 @@ read eight-bit input. </DL> </P><P> -<A NAME="IDX259"></A> +<A NAME="IDX267"></A> <DL> <DT><U>Function:</U> void <B>rl_deprep_terminal</B> <I>(void)</I> <DD>Undo the effects of <CODE>rl_prep_terminal()</CODE>, leaving the terminal in @@ -3415,7 +3482,7 @@ the state in which it was before the most recent call to </DL> </P><P> -<A NAME="IDX260"></A> +<A NAME="IDX268"></A> <DL> <DT><U>Function:</U> void <B>rl_tty_set_default_bindings</B> <I>(Keymap kmap)</I> <DD>Read the operating system's terminal editing characters (as would be displayed @@ -3424,7 +3491,7 @@ in <VAR>kmap</VAR>. </DL> </P><P> -<A NAME="IDX261"></A> +<A NAME="IDX269"></A> <DL> <DT><U>Function:</U> int <B>rl_reset_terminal</B> <I>(const char *terminal_name)</I> <DD>Reinitialize Readline's idea of the terminal settings using @@ -3452,7 +3519,17 @@ environment variable is used. <!--docid::SEC39::--> <P> -<A NAME="IDX262"></A> +<A NAME="IDX270"></A> +<DL> +<DT><U>Function:</U> void <B>rl_replace_line</B> <I>(const char *text, int clear_undo)</I> +<DD>Replace the contents of <CODE>rl_line_buffer</CODE> with <VAR>text</VAR>. +The point and mark are preserved, if possible. +If <VAR>clear_undo</VAR> is non-zero, the undo list associated with the +current line is cleared. +</DL> +</P><P> + +<A NAME="IDX271"></A> <DL> <DT><U>Function:</U> int <B>rl_extend_line_buffer</B> <I>(int len)</I> <DD>Ensure that <CODE>rl_line_buffer</CODE> has enough space to hold <VAR>len</VAR> @@ -3460,7 +3537,7 @@ characters, possibly reallocating it if necessary. </DL> </P><P> -<A NAME="IDX263"></A> +<A NAME="IDX272"></A> <DL> <DT><U>Function:</U> int <B>rl_initialize</B> <I>(void)</I> <DD>Initialize or re-initialize Readline's internal state. @@ -3469,21 +3546,21 @@ reading any input. </DL> </P><P> -<A NAME="IDX264"></A> +<A NAME="IDX273"></A> <DL> <DT><U>Function:</U> int <B>rl_ding</B> <I>(void)</I> <DD>Ring the terminal bell, obeying the setting of <CODE>bell-style</CODE>. </DL> </P><P> -<A NAME="IDX265"></A> +<A NAME="IDX274"></A> <DL> <DT><U>Function:</U> int <B>rl_alphabetic</B> <I>(int c)</I> <DD>Return 1 if <VAR>c</VAR> is an alphabetic character. </DL> </P><P> -<A NAME="IDX266"></A> +<A NAME="IDX275"></A> <DL> <DT><U>Function:</U> void <B>rl_display_match_list</B> <I>(char **matches, int len, int max)</I> <DD>A convenience function for displaying a list of strings in @@ -3500,28 +3577,28 @@ The following are implemented as macros, defined in <CODE>chardefs.h</CODE>. Applications should refrain from using them. </P><P> -<A NAME="IDX267"></A> +<A NAME="IDX276"></A> <DL> <DT><U>Function:</U> int <B>_rl_uppercase_p</B> <I>(int c)</I> <DD>Return 1 if <VAR>c</VAR> is an uppercase alphabetic character. </DL> </P><P> -<A NAME="IDX268"></A> +<A NAME="IDX277"></A> <DL> <DT><U>Function:</U> int <B>_rl_lowercase_p</B> <I>(int c)</I> <DD>Return 1 if <VAR>c</VAR> is a lowercase alphabetic character. </DL> </P><P> -<A NAME="IDX269"></A> +<A NAME="IDX278"></A> <DL> <DT><U>Function:</U> int <B>_rl_digit_p</B> <I>(int c)</I> <DD>Return 1 if <VAR>c</VAR> is a numeric character. </DL> </P><P> -<A NAME="IDX270"></A> +<A NAME="IDX279"></A> <DL> <DT><U>Function:</U> int <B>_rl_to_upper</B> <I>(int c)</I> <DD>If <VAR>c</VAR> is a lowercase alphabetic character, return the corresponding @@ -3529,7 +3606,7 @@ uppercase character. </DL> </P><P> -<A NAME="IDX271"></A> +<A NAME="IDX280"></A> <DL> <DT><U>Function:</U> int <B>_rl_to_lower</B> <I>(int c)</I> <DD>If <VAR>c</VAR> is an uppercase alphabetic character, return the corresponding @@ -3537,7 +3614,7 @@ lowercase character. </DL> </P><P> -<A NAME="IDX272"></A> +<A NAME="IDX281"></A> <DL> <DT><U>Function:</U> int <B>_rl_digit_value</B> <I>(int c)</I> <DD>If <VAR>c</VAR> is a number, return the value it represents. @@ -3562,7 +3639,7 @@ lowercase character. <!--docid::SEC40::--> <P> -<A NAME="IDX273"></A> +<A NAME="IDX282"></A> <DL> <DT><U>Function:</U> int <B>rl_macro_bind</B> <I>(const char *keyseq, const char *macro, Keymap map)</I> <DD>Bind the key sequence <VAR>keyseq</VAR> to invoke the macro <VAR>macro</VAR>. @@ -3572,7 +3649,7 @@ use <CODE>rl_generic_bind()</CODE> instead. </DL> </P><P> -<A NAME="IDX274"></A> +<A NAME="IDX283"></A> <DL> <DT><U>Function:</U> void <B>rl_macro_dumper</B> <I>(int readable)</I> <DD>Print the key sequences bound to macros and their values, using @@ -3582,7 +3659,7 @@ that it can be made part of an <CODE>inputrc</CODE> file and re-read. </DL> </P><P> -<A NAME="IDX275"></A> +<A NAME="IDX284"></A> <DL> <DT><U>Function:</U> int <B>rl_variable_bind</B> <I>(const char *variable, const char *value)</I> <DD>Make the Readline variable <VAR>variable</VAR> have <VAR>value</VAR>. @@ -3592,7 +3669,7 @@ file (see section <A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax< </DL> </P><P> -<A NAME="IDX276"></A> +<A NAME="IDX285"></A> <DL> <DT><U>Function:</U> void <B>rl_variable_dumper</B> <I>(int readable)</I> <DD>Print the readline variable names and their current values @@ -3602,7 +3679,7 @@ that it can be made part of an <CODE>inputrc</CODE> file and re-read. </DL> </P><P> -<A NAME="IDX277"></A> +<A NAME="IDX286"></A> <DL> <DT><U>Function:</U> int <B>rl_set_paren_blink_timeout</B> <I>(int u)</I> <DD>Set the time interval (in microseconds) that Readline waits when showing @@ -3610,7 +3687,7 @@ a balancing character when <CODE>blink-matching-paren</CODE> has been enabled. </DL> </P><P> -<A NAME="IDX278"></A> +<A NAME="IDX287"></A> <DL> <DT><U>Function:</U> char * <B>rl_get_termcap</B> <I>(const char *cap)</I> <DD>Retrieve the string value of the termcap capability <VAR>cap</VAR>. @@ -3648,7 +3725,7 @@ also be invoked as a `callback' function from an event loop. There are functions available to make this easy. </P><P> -<A NAME="IDX279"></A> +<A NAME="IDX288"></A> <DL> <DT><U>Function:</U> void <B>rl_callback_handler_install</B> <I>(const char *prompt, rl_vcpfunc_t *lhandler)</I> <DD>Set up the terminal for readline I/O and display the initial @@ -3658,24 +3735,34 @@ The function takes the text of the line as an argument. </DL> </P><P> -<A NAME="IDX280"></A> +<A NAME="IDX289"></A> <DL> <DT><U>Function:</U> void <B>rl_callback_read_char</B> <I>(void)</I> <DD>Whenever an application determines that keyboard input is available, it should call <CODE>rl_callback_read_char()</CODE>, which will read the next -character from the current input source. If that character completes the -line, <CODE>rl_callback_read_char</CODE> will invoke the <VAR>lhandler</VAR> -function saved by <CODE>rl_callback_handler_install</CODE> to process the -line. <CODE>EOF</CODE> is indicated by calling <VAR>lhandler</VAR> with a +character from the current input source. +If that character completes the line, <CODE>rl_callback_read_char</CODE> will +invoke the <VAR>lhandler</VAR> function saved by <CODE>rl_callback_handler_install</CODE> +to process the line. +Before calling the <VAR>lhandler</VAR> function, the terminal settings are +reset to the values they had before calling +<CODE>rl_callback_handler_install</CODE>. +If the <VAR>lhandler</VAR> function returns, +the terminal settings are modified for Readline's use again. +<CODE>EOF</CODE> is indicated by calling <VAR>lhandler</VAR> with a <CODE>NULL</CODE> line. </DL> </P><P> -<A NAME="IDX281"></A> +<A NAME="IDX290"></A> <DL> <DT><U>Function:</U> void <B>rl_callback_handler_remove</B> <I>(void)</I> <DD>Restore the terminal to its initial state and remove the line handler. This may be called from within a callback as well as independently. +If the <VAR>lhandler</VAR> installed by <CODE>rl_callback_handler_install</CODE> +does not exit the program, either this function or the function referred +to by the value of <CODE>rl_deprep_term_function</CODE> should be called before +the program exits to reset the terminal settings. </DL> </P><P> @@ -3744,8 +3831,8 @@ invert_case_line (count, key) end = temp; } - /* Tell readline that we are modifying the line, so it will save - the undo information. */ + /* Tell readline that we are modifying the line, + so it will save the undo information. */ rl_modifying (start, end); for (i = start; i != end; i++) @@ -3825,7 +3912,7 @@ values of these variables only when calling <CODE>readline()</CODE>, not in a signal handler, so Readline's internal signal state is not corrupted. </P><P> -<A NAME="IDX282"></A> +<A NAME="IDX291"></A> <DL> <DT><U>Variable:</U> int <B>rl_catch_signals</B> <DD>If this variable is non-zero, Readline will install signal handlers for @@ -3837,7 +3924,7 @@ The default value of <CODE>rl_catch_signals</CODE> is 1. </DL> </P><P> -<A NAME="IDX283"></A> +<A NAME="IDX292"></A> <DL> <DT><U>Variable:</U> int <B>rl_catch_sigwinch</B> <DD>If this variable is non-zero, Readline will install a signal handler for @@ -3855,7 +3942,7 @@ Readline provides convenience functions to do the necessary terminal and internal state cleanup upon receipt of a signal. </P><P> -<A NAME="IDX284"></A> +<A NAME="IDX293"></A> <DL> <DT><U>Function:</U> void <B>rl_cleanup_after_signal</B> <I>(void)</I> <DD>This function will reset the state of the terminal to what it was before @@ -3865,7 +3952,7 @@ all signals, depending on the values of <CODE>rl_catch_signals</CODE> and </DL> </P><P> -<A NAME="IDX285"></A> +<A NAME="IDX294"></A> <DL> <DT><U>Function:</U> void <B>rl_free_line_state</B> <I>(void)</I> <DD>This will free any partial state associated with the current input line @@ -3877,7 +3964,7 @@ current input line. </DL> </P><P> -<A NAME="IDX286"></A> +<A NAME="IDX295"></A> <DL> <DT><U>Function:</U> void <B>rl_reset_after_signal</B> <I>(void)</I> <DD>This will reinitialize the terminal and reinstall any Readline signal @@ -3892,14 +3979,14 @@ Readline to update its idea of the terminal size when a <CODE>SIGWINCH</CODE> is received. </P><P> -<A NAME="IDX287"></A> +<A NAME="IDX296"></A> <DL> <DT><U>Function:</U> void <B>rl_resize_terminal</B> <I>(void)</I> <DD>Update Readline's internal screen size by reading values from the kernel. </DL> </P><P> -<A NAME="IDX288"></A> +<A NAME="IDX297"></A> <DL> <DT><U>Function:</U> void <B>rl_set_screen_size</B> <I>(int rows, int cols)</I> <DD>Set Readline's idea of the terminal size to <VAR>rows</VAR> rows and @@ -3912,7 +3999,7 @@ is still interested in the screen dimensions, Readline's idea of the screen size may be queried. </P><P> -<A NAME="IDX289"></A> +<A NAME="IDX298"></A> <DL> <DT><U>Function:</U> void <B>rl_get_screen_size</B> <I>(int *rows, int *cols)</I> <DD>Return Readline's idea of the terminal's size in the @@ -3923,7 +4010,7 @@ variables pointed to by the arguments. The following functions install and remove Readline's signal handlers. </P><P> -<A NAME="IDX290"></A> +<A NAME="IDX299"></A> <DL> <DT><U>Function:</U> int <B>rl_set_signals</B> <I>(void)</I> <DD>Install Readline's signal handler for <CODE>SIGINT</CODE>, <CODE>SIGQUIT</CODE>, @@ -3933,7 +4020,7 @@ The following functions install and remove Readline's signal handlers. </DL> </P><P> -<A NAME="IDX291"></A> +<A NAME="IDX300"></A> <DL> <DT><U>Function:</U> int <B>rl_clear_signals</B> <I>(void)</I> <DD>Remove all of the Readline signal handlers installed by @@ -4044,7 +4131,7 @@ frees the strings when it has finished with them. </OL> <P> -<A NAME="IDX292"></A> +<A NAME="IDX301"></A> <DL> <DT><U>Function:</U> int <B>rl_complete</B> <I>(int ignore, int invoking_key)</I> <DD>Complete the word at or before point. You have supplied the function @@ -4053,7 +4140,7 @@ that does the initial simple matching selection algorithm (see </DL> </P><P> -<A NAME="IDX293"></A> +<A NAME="IDX302"></A> <DL> <DT><U>Variable:</U> rl_compentry_func_t * <B>rl_completion_entry_function</B> <DD>This is a pointer to the generator function for @@ -4086,7 +4173,7 @@ Here is the complete list of callable completion functions present in Readline. </P><P> -<A NAME="IDX294"></A> +<A NAME="IDX303"></A> <DL> <DT><U>Function:</U> int <B>rl_complete_internal</B> <I>(int what_to_do)</I> <DD>Complete the word at or before point. <VAR>what_to_do</VAR> says what to do @@ -4098,7 +4185,7 @@ performing partial completion. </DL> </P><P> -<A NAME="IDX295"></A> +<A NAME="IDX304"></A> <DL> <DT><U>Function:</U> int <B>rl_complete</B> <I>(int ignore, int invoking_key)</I> <DD>Complete the word at or before point. You have supplied the function @@ -4110,7 +4197,7 @@ argument depending on <VAR>invoking_key</VAR>. </DL> </P><P> -<A NAME="IDX296"></A> +<A NAME="IDX305"></A> <DL> <DT><U>Function:</U> int <B>rl_possible_completions</B> <I>(int count, int invoking_key)</I> <DD>List the possible completions. See description of <CODE>rl_complete @@ -4119,7 +4206,7 @@ argument depending on <VAR>invoking_key</VAR>. </DL> </P><P> -<A NAME="IDX297"></A> +<A NAME="IDX306"></A> <DL> <DT><U>Function:</U> int <B>rl_insert_completions</B> <I>(int count, int invoking_key)</I> <DD>Insert the list of possible completions into the line, deleting the @@ -4128,7 +4215,18 @@ This calls <CODE>rl_complete_internal()</CODE> with an argument of <SAMP>`*'</SA </DL> </P><P> -<A NAME="IDX298"></A> +<A NAME="IDX307"></A> +<DL> +<DT><U>Function:</U> int <B>rl_completion_mode</B> <I>(rl_command_func_t *cfunc)</I> +<DD>Returns the apppriate value to pass to <CODE>rl_complete_internal()</CODE> +depending on whether <VAR>cfunc</VAR> was called twice in succession and +the value of the <CODE>show-all-if-ambiguous</CODE> variable. +Application-specific completion functions may use this function to present +the same interface as <CODE>rl_complete()</CODE>. +</DL> +</P><P> + +<A NAME="IDX308"></A> <DL> <DT><U>Function:</U> char ** <B>rl_completion_matches</B> <I>(const char *text, rl_compentry_func_t *entry_func)</I> <DD>Returns an array of strings which is a list of completions for @@ -4146,7 +4244,7 @@ when there are no more matches. </DL> </P><P> -<A NAME="IDX299"></A> +<A NAME="IDX309"></A> <DL> <DT><U>Function:</U> char * <B>rl_filename_completion_function</B> <I>(const char *text, int state)</I> <DD>A generator function for filename completion in the general case. @@ -4157,7 +4255,7 @@ Readline functions). </DL> </P><P> -<A NAME="IDX300"></A> +<A NAME="IDX310"></A> <DL> <DT><U>Function:</U> char * <B>rl_username_completion_function</B> <I>(const char *text, int state)</I> <DD>A completion generator for usernames. <VAR>text</VAR> contains a partial @@ -4185,7 +4283,7 @@ for subsequent calls. <!--docid::SEC47::--> <P> -<A NAME="IDX301"></A> +<A NAME="IDX311"></A> <DL> <DT><U>Variable:</U> rl_compentry_func_t * <B>rl_completion_entry_function</B> <DD>A pointer to the generator function for <CODE>rl_completion_matches()</CODE>. @@ -4194,7 +4292,7 @@ filename completer. </DL> </P><P> -<A NAME="IDX302"></A> +<A NAME="IDX312"></A> <DL> <DT><U>Variable:</U> rl_completion_func_t * <B>rl_attempted_completion_function</B> <DD>A pointer to an alternative function to create matches. @@ -4211,7 +4309,7 @@ completion even if this function returns no matches. </DL> </P><P> -<A NAME="IDX303"></A> +<A NAME="IDX313"></A> <DL> <DT><U>Variable:</U> rl_quote_func_t * <B>rl_filename_quoting_function</B> <DD>A pointer to a function that will quote a filename in an @@ -4228,7 +4326,7 @@ to reset this character. </DL> </P><P> -<A NAME="IDX304"></A> +<A NAME="IDX314"></A> <DL> <DT><U>Variable:</U> rl_dequote_func_t * <B>rl_filename_dequoting_function</B> <DD>A pointer to a function that will remove application-specific quoting @@ -4241,7 +4339,7 @@ that delimits the filename (usually <SAMP>`''</SAMP> or <SAMP>`"'</SAMP>). If </DL> </P><P> -<A NAME="IDX305"></A> +<A NAME="IDX315"></A> <DL> <DT><U>Variable:</U> rl_linebuf_func_t * <B>rl_char_is_quoted_p</B> <DD>A pointer to a function to call that determines whether or not a specific @@ -4254,16 +4352,53 @@ used to break words for the completer. </DL> </P><P> -<A NAME="IDX306"></A> +<A NAME="IDX316"></A> <DL> -<DT><U>Variable:</U> int <B>rl_completion_query_items</B> -<DD>Up to this many items will be displayed in response to a -possible-completions call. After that, we ask the user if she is sure -she wants to see them all. The default value is 100. +<DT><U>Variable:</U> rl_compignore_func_t * <B>rl_ignore_some_completions_function</B> +<DD>This function, if defined, is called by the completer when real filename +completion is done, after all the matching names have been generated. +It is passed a <CODE>NULL</CODE> terminated array of matches. +The first element (<CODE>matches[0]</CODE>) is the +maximal substring common to all matches. This function can +re-arrange the list of matches as required, but each element deleted +from the array must be freed. </DL> </P><P> -<A NAME="IDX307"></A> +<A NAME="IDX317"></A> +<DL> +<DT><U>Variable:</U> rl_icppfunc_t * <B>rl_directory_completion_hook</B> +<DD>This function, if defined, is allowed to modify the directory portion +of filenames Readline completes. It is called with the address of a +string (the current directory name) as an argument, and may modify that string. +If the string is replaced with a new string, the old value should be freed. +Any modified directory name should have a trailing slash. +The modified value will be displayed as part of the completion, replacing +the directory portion of the pathname the user typed. +It returns an integer that should be non-zero if the function modifies +its directory argument. +It could be used to expand symbolic links or shell variables in pathnames. +</DL> +</P><P> + +<A NAME="IDX318"></A> +<DL> +<DT><U>Variable:</U> rl_compdisp_func_t * <B>rl_completion_display_matches_hook</B> +<DD>If non-zero, then this is the address of a function to call when +completing a word would normally display the list of possible matches. +This function is called in lieu of Readline displaying the list. +It takes three arguments: +(<CODE>char **</CODE><VAR>matches</VAR>, <CODE>int</CODE> <VAR>num_matches</VAR>, <CODE>int</CODE> <VAR>max_length</VAR>) +where <VAR>matches</VAR> is the array of matching strings, +<VAR>num_matches</VAR> is the number of strings in that array, and +<VAR>max_length</VAR> is the length of the longest string in that array. +Readline provides a convenience function, <CODE>rl_display_match_list</CODE>, +that takes care of doing the display to Readline's output stream. That +function may be called from this hook. +</DL> +</P><P> + +<A NAME="IDX319"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_basic_word_break_characters</B> <DD>The basic list of characters that signal a break between words for the @@ -4273,14 +4408,14 @@ which break words for completion in Bash: </DL> </P><P> -<A NAME="IDX308"></A> +<A NAME="IDX320"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_basic_quote_characters</B> <DD>A list of quote characters which can cause a word break. </DL> </P><P> -<A NAME="IDX309"></A> +<A NAME="IDX321"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_completer_word_break_characters</B> <DD>The list of characters that signal a break between words for @@ -4289,7 +4424,7 @@ which break words for completion in Bash: </DL> </P><P> -<A NAME="IDX310"></A> +<A NAME="IDX322"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_completer_quote_characters</B> <DD>A list of characters which can be used to quote a substring of the line. @@ -4299,7 +4434,7 @@ unless they also appear within this list. </DL> </P><P> -<A NAME="IDX311"></A> +<A NAME="IDX323"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_filename_quote_characters</B> <DD>A list of characters that cause a filename to be quoted by the completer @@ -4307,7 +4442,7 @@ when they appear in a completed filename. The default is the null string. </DL> </P><P> -<A NAME="IDX312"></A> +<A NAME="IDX324"></A> <DL> <DT><U>Variable:</U> const char * <B>rl_special_prefixes</B> <DD>The list of characters that are word break characters, but should be @@ -4318,7 +4453,16 @@ shell variables and hostnames. </DL> </P><P> -<A NAME="IDX313"></A> +<A NAME="IDX325"></A> +<DL> +<DT><U>Variable:</U> int <B>rl_completion_query_items</B> +<DD>Up to this many items will be displayed in response to a +possible-completions call. After that, we ask the user if she is sure +she wants to see them all. The default value is 100. +</DL> +</P><P> + +<A NAME="IDX326"></A> <DL> <DT><U>Variable:</U> int <B>rl_completion_append_character</B> <DD>When a single completion alternative matches at the end of the command @@ -4331,7 +4475,31 @@ an application-specific command line syntax specification. </DL> </P><P> -<A NAME="IDX314"></A> +<A NAME="IDX327"></A> +<DL> +<DT><U>Variable:</U> int <B>rl_completion_suppress_append</B> +<DD>If non-zero, <VAR>rl_completion_append_character</VAR> is not appended to +matches at the end of the command line, as described above. It is +set to 0 before any application-specific completion function is called. +</DL> +</P><P> + +<A NAME="IDX328"></A> +<DL> +<DT><U>Variable:</U> int <B>rl_completion_mark_symlink_dirs</B> +<DD>If non-zero, a slash will be appended to completed filenames that are +symbolic links to directory names, subject to the value of the +user-settable <VAR>mark-directories</VAR> variable. +This variable exists so that application completion functions can +override the user's global preference (set via the +<VAR>mark-symlinked-directories</VAR> Readline variable) if appropriate. +This variable is set to the user's preference before any +application completion function is called, so unless that function +modifies the value, the user's preferences are honored. +</DL> +</P><P> + +<A NAME="IDX329"></A> <DL> <DT><U>Variable:</U> int <B>rl_ignore_completion_duplicates</B> <DD>If non-zero, then duplicates in the matches are removed. @@ -4339,7 +4507,7 @@ The default is 1. </DL> </P><P> -<A NAME="IDX315"></A> +<A NAME="IDX330"></A> <DL> <DT><U>Variable:</U> int <B>rl_filename_completion_desired</B> <DD>Non-zero means that the results of the matches are to be treated as @@ -4352,7 +4520,7 @@ is set to a non-zero value. </DL> </P><P> -<A NAME="IDX316"></A> +<A NAME="IDX331"></A> <DL> <DT><U>Variable:</U> int <B>rl_filename_quoting_desired</B> <DD>Non-zero means that the results of the matches are to be quoted using @@ -4365,7 +4533,7 @@ by <CODE>rl_filename_quoting_function</CODE>. </DL> </P><P> -<A NAME="IDX317"></A> +<A NAME="IDX332"></A> <DL> <DT><U>Variable:</U> int <B>rl_attempted_completion_over</B> <DD>If an application-specific completion function assigned to @@ -4376,7 +4544,7 @@ It should be set only by an application's completion function. </DL> </P><P> -<A NAME="IDX318"></A> +<A NAME="IDX333"></A> <DL> <DT><U>Variable:</U> int <B>rl_completion_type</B> <DD>Set to a character describing the type of completion Readline is currently @@ -4385,7 +4553,7 @@ attempting; see the description of <CODE>rl_complete_internal()</CODE> </DL> </P><P> -<A NAME="IDX319"></A> +<A NAME="IDX334"></A> <DL> <DT><U>Variable:</U> int <B>rl_inhibit_completion</B> <DD>If this variable is non-zero, completion is inhibited. The completion @@ -4393,52 +4561,6 @@ character will be inserted as any other bound to <CODE>self-insert</CODE>. </DL> </P><P> -<A NAME="IDX320"></A> -<DL> -<DT><U>Variable:</U> rl_compignore_func_t * <B>rl_ignore_some_completions_function</B> -<DD>This function, if defined, is called by the completer when real filename -completion is done, after all the matching names have been generated. -It is passed a <CODE>NULL</CODE> terminated array of matches. -The first element (<CODE>matches[0]</CODE>) is the -maximal substring common to all matches. This function can -re-arrange the list of matches as required, but each element deleted -from the array must be freed. -</DL> -</P><P> - -<A NAME="IDX321"></A> -<DL> -<DT><U>Variable:</U> rl_icppfunc_t * <B>rl_directory_completion_hook</B> -<DD>This function, if defined, is allowed to modify the directory portion -of filenames Readline completes. It is called with the address of a -string (the current directory name) as an argument, and may modify that string. -If the string is replaced with a new string, the old value should be freed. -Any modified directory name should have a trailing slash. -The modified value will be displayed as part of the completion, replacing -the directory portion of the pathname the user typed. -It returns an integer that should be non-zero if the function modifies -its directory argument. -It could be used to expand symbolic links or shell variables in pathnames. -</DL> -</P><P> - -<A NAME="IDX322"></A> -<DL> -<DT><U>Variable:</U> rl_compdisp_func_t * <B>rl_completion_display_matches_hook</B> -<DD>If non-zero, then this is the address of a function to call when -completing a word would normally display the list of possible matches. -This function is called in lieu of Readline displaying the list. -It takes three arguments: -(<CODE>char **</CODE><VAR>matches</VAR>, <CODE>int</CODE> <VAR>num_matches</VAR>, <CODE>int</CODE> <VAR>max_length</VAR>) -where <VAR>matches</VAR> is the array of matching strings, -<VAR>num_matches</VAR> is the number of strings in that array, and -<VAR>max_length</VAR> is the length of the longest string in that array. -Readline provides a convenience function, <CODE>rl_display_match_list</CODE>, -that takes care of doing the display to Readline's output stream. That -function may be called from this hook. -</DL> -</P><P> - <A NAME="A Short Completion Example"></A> <HR SIZE="6"> <A NAME="SEC48"></A> @@ -4880,12 +5002,13 @@ too_dangerous (caller) char *caller; { fprintf (stderr, - "%s: Too dangerous for me to distribute. Write it yourself.\n", + "%s: Too dangerous for me to distribute.\n" caller); + fprintf (stderr, "Write it yourself.\n"); } -/* Return non-zero if ARG is a valid argument for CALLER, else print - an error message and return zero. */ +/* Return non-zero if ARG is a valid argument for CALLER, + else print an error message and return zero. */ int valid_argument (caller, arg) char *caller, *arg; @@ -4954,7 +5077,7 @@ valid_argument (caller, arg) <TR><TD></TD><TD valign=top><A HREF="readline.html#SEC4">notation, readline</A></TD><TD valign=top><A HREF="readline.html#SEC4">1.2.1 Readline Bare Essentials</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="cp_R"></A>R</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX167">readline, function</A></TD><TD valign=top><A HREF="readline.html#SEC24">2.1 Basic Behavior</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX175">readline, function</A></TD><TD valign=top><A HREF="readline.html#SEC24">2.1 Basic Behavior</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="cp_V"></A>V</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX4">variables, readline</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> @@ -5044,363 +5167,375 @@ valid_argument (caller, arg) <TR><TD></TD><TH ALIGN=LEFT>Index Entry</TH><TH ALIGN=LEFT> Section</TH></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn__"></A>_</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX269"><CODE>_rl_digit_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX272"><CODE>_rl_digit_value</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX268"><CODE>_rl_lowercase_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX271"><CODE>_rl_to_lower</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX270"><CODE>_rl_to_upper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX267"><CODE>_rl_uppercase_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX278"><CODE>_rl_digit_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX281"><CODE>_rl_digit_value</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX277"><CODE>_rl_lowercase_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX280"><CODE>_rl_to_lower</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX279"><CODE>_rl_to_upper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX276"><CODE>_rl_uppercase_p</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_A"></A>A</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX138"><CODE>abort (C-g)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX139"><CODE>abort (C-g)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX40"><CODE>accept-line (Newline or Return)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX41"><CODE>accept-line (Newline or Return)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX142"><CODE>abort (C-g)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX143"><CODE>abort (C-g)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX42"><CODE>accept-line (Newline or Return)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX43"><CODE>accept-line (Newline or Return)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_B"></A>B</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX30"><CODE>backward-char (C-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX31"><CODE>backward-char (C-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX68"><CODE>backward-delete-char (Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX69"><CODE>backward-delete-char (Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX90"><CODE>backward-kill-line (C-x Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX91"><CODE>backward-kill-line (C-x Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX98"><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX99"><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX34"><CODE>backward-word (M-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX35"><CODE>backward-word (M-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX46"><CODE>beginning-of-history (M-&#60;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX47"><CODE>beginning-of-history (M-&#60;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX24"><CODE>beginning-of-line (C-a)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX25"><CODE>beginning-of-line (C-a)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX32"><CODE>backward-char (C-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX33"><CODE>backward-char (C-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX70"><CODE>backward-delete-char (Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX71"><CODE>backward-delete-char (Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX94"><CODE>backward-kill-line (C-x Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX95"><CODE>backward-kill-line (C-x Rubout)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX102"><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX103"><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX36"><CODE>backward-word (M-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX37"><CODE>backward-word (M-b)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX48"><CODE>beginning-of-history (M-&#60;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX49"><CODE>beginning-of-history (M-&#60;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX26"><CODE>beginning-of-line (C-a)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX27"><CODE>beginning-of-line (C-a)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX5">bell-style</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_C"></A>C</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX134"><CODE>call-last-kbd-macro (C-x e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX135"><CODE>call-last-kbd-macro (C-x e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX86"><CODE>capitalize-word (M-c)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX87"><CODE>capitalize-word (M-c)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX154"><CODE>character-search (C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX155"><CODE>character-search (C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX156"><CODE>character-search-backward (M-C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX157"><CODE>character-search-backward (M-C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX36"><CODE>clear-screen (C-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX37"><CODE>clear-screen (C-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX138"><CODE>call-last-kbd-macro (C-x e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX139"><CODE>call-last-kbd-macro (C-x e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX88"><CODE>capitalize-word (M-c)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX89"><CODE>capitalize-word (M-c)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX158"><CODE>character-search (C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX159"><CODE>character-search (C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX160"><CODE>character-search-backward (M-C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX161"><CODE>character-search-backward (M-C-])</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX38"><CODE>clear-screen (C-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX39"><CODE>clear-screen (C-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX6">comment-begin</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX120"><CODE>complete (<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX121"><CODE>complete (<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX124"><CODE>complete (<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX125"><CODE>complete (<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX7">completion-query-items</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX8">convert-meta</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX108"><CODE>copy-backward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX109"><CODE>copy-backward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX110"><CODE>copy-forward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX111"><CODE>copy-forward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX106"><CODE>copy-region-as-kill ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX107"><CODE>copy-region-as-kill ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX112"><CODE>copy-backward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX113"><CODE>copy-backward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX114"><CODE>copy-forward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX115"><CODE>copy-forward-word ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX110"><CODE>copy-region-as-kill ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX111"><CODE>copy-region-as-kill ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_D"></A>D</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX66"><CODE>delete-char (C-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX67"><CODE>delete-char (C-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX128"><CODE>delete-char-or-list ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX129"><CODE>delete-char-or-list ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX102"><CODE>delete-horizontal-space ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX103"><CODE>delete-horizontal-space ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX116"><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX117"><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX68"><CODE>delete-char (C-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX69"><CODE>delete-char (C-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX132"><CODE>delete-char-or-list ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX133"><CODE>delete-char-or-list ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX106"><CODE>delete-horizontal-space ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX107"><CODE>delete-horizontal-space ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX120"><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX121"><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX9">disable-completion</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX140"><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX141"><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX84"><CODE>downcase-word (M-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX85"><CODE>downcase-word (M-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX160"><CODE>dump-functions ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX161"><CODE>dump-functions ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX164"><CODE>dump-macros ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX165"><CODE>dump-macros ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX162"><CODE>dump-variables ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX163"><CODE>dump-variables ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX144"><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX145"><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX86"><CODE>downcase-word (M-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX87"><CODE>downcase-word (M-l)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX164"><CODE>dump-functions ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX165"><CODE>dump-functions ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX168"><CODE>dump-macros ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX169"><CODE>dump-macros ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX166"><CODE>dump-variables ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX167"><CODE>dump-variables ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_E"></A>E</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX10">editing-mode</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX170"><CODE>emacs-editing-mode (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX171"><CODE>emacs-editing-mode (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX11">enable-keypad</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX132"><CODE>end-kbd-macro (C-x ))</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX133"><CODE>end-kbd-macro (C-x ))</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX48"><CODE>end-of-history (M-&#62;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX49"><CODE>end-of-history (M-&#62;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX26"><CODE>end-of-line (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX27"><CODE>end-of-line (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX152"><CODE>exchange-point-and-mark (C-x C-x)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX153"><CODE>exchange-point-and-mark (C-x C-x)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX136"><CODE>end-kbd-macro (C-x ))</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX137"><CODE>end-kbd-macro (C-x ))</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX50"><CODE>end-of-history (M-&#62;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX51"><CODE>end-of-history (M-&#62;)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX28"><CODE>end-of-line (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX29"><CODE>end-of-line (C-e)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX156"><CODE>exchange-point-and-mark (C-x C-x)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX157"><CODE>exchange-point-and-mark (C-x C-x)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX12">expand-tilde</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_F"></A>F</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX70"><CODE>forward-backward-delete-char ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX71"><CODE>forward-backward-delete-char ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX28"><CODE>forward-char (C-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX29"><CODE>forward-char (C-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX52"><CODE>forward-search-history (C-s)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX53"><CODE>forward-search-history (C-s)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX32"><CODE>forward-word (M-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX33"><CODE>forward-word (M-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX72"><CODE>forward-backward-delete-char ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX73"><CODE>forward-backward-delete-char ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX30"><CODE>forward-char (C-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX31"><CODE>forward-char (C-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX54"><CODE>forward-search-history (C-s)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX55"><CODE>forward-search-history (C-s)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX34"><CODE>forward-word (M-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX35"><CODE>forward-word (M-f)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_H"></A>H</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX13">history-preserve-point</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX60"><CODE>history-search-backward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX61"><CODE>history-search-backward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX58"><CODE>history-search-forward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX59"><CODE>history-search-forward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX62"><CODE>history-search-backward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX63"><CODE>history-search-backward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX60"><CODE>history-search-forward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX61"><CODE>history-search-forward ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX14">horizontal-scroll-mode</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_I"></A>I</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX15">input-meta</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX158"><CODE>insert-comment (M-#)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX159"><CODE>insert-comment (M-#)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX124"><CODE>insert-completions (M-*)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX125"><CODE>insert-completions (M-*)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX162"><CODE>insert-comment (M-#)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX163"><CODE>insert-comment (M-#)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX128"><CODE>insert-completions (M-*)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX129"><CODE>insert-completions (M-*)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX17">isearch-terminators</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_K"></A>K</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX18">keymap</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX88"><CODE>kill-line (C-k)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX89"><CODE>kill-line (C-k)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX104"><CODE>kill-region ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX105"><CODE>kill-region ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX94"><CODE>kill-whole-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX95"><CODE>kill-whole-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX96"><CODE>kill-word (M-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX97"><CODE>kill-word (M-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX92"><CODE>kill-line (C-k)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX93"><CODE>kill-line (C-k)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX108"><CODE>kill-region ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX109"><CODE>kill-region ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX98"><CODE>kill-whole-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX99"><CODE>kill-whole-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX100"><CODE>kill-word (M-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX101"><CODE>kill-word (M-d)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_M"></A>M</TH><TD></TD><TD></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX19">mark-modified-lines</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX20">match-hidden-files</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX126"><CODE>menu-complete ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX127"><CODE>menu-complete ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX20">mark-symlinked-directories</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX21">match-hidden-files</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX130"><CODE>menu-complete ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX131"><CODE>menu-complete ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> <TR><TD></TD><TD valign=top><A HREF="readline.html#IDX16">meta-flag</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_N"></A>N</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX44"><CODE>next-history (C-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX45"><CODE>next-history (C-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX56"><CODE>non-incremental-forward-search-history (M-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX57"><CODE>non-incremental-forward-search-history (M-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX54"><CODE>non-incremental-reverse-search-history (M-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX55"><CODE>non-incremental-reverse-search-history (M-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX46"><CODE>next-history (C-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX47"><CODE>next-history (C-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX58"><CODE>non-incremental-forward-search-history (M-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX59"><CODE>non-incremental-forward-search-history (M-n)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX56"><CODE>non-incremental-reverse-search-history (M-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX57"><CODE>non-incremental-reverse-search-history (M-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_O"></A>O</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX21">output-meta</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX22">output-meta</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX90"><CODE>overwrite-mode ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX91"><CODE>overwrite-mode ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_P"></A>P</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX122"><CODE>possible-completions (M-?)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX123"><CODE>possible-completions (M-?)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX142"><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX143"><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX42"><CODE>previous-history (C-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX43"><CODE>previous-history (C-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX23">page-completions</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX126"><CODE>possible-completions (M-?)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX127"><CODE>possible-completions (M-?)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC19">1.4.6 Letting Readline Type For You</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX146"><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX147"><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX44"><CODE>previous-history (C-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX45"><CODE>previous-history (C-p)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_Q"></A>Q</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX72"><CODE>quoted-insert (C-q or C-v)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX73"><CODE>quoted-insert (C-q or C-v)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX74"><CODE>quoted-insert (C-q or C-v)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX75"><CODE>quoted-insert (C-q or C-v)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_R"></A>R</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX136"><CODE>re-read-init-file (C-x C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX137"><CODE>re-read-init-file (C-x C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX166"><CODE>readline</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC24">2.1 Basic Behavior</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX38"><CODE>redraw-current-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX39"><CODE>redraw-current-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX50"><CODE>reverse-search-history (C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX51"><CODE>reverse-search-history (C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX146"><CODE>revert-line (M-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX147"><CODE>revert-line (M-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX201"><CODE>rl_add_defun</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC30">2.4.1 Naming a Function</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX227"><CODE>rl_add_funmap_entry</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX230"><CODE>rl_add_undo</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX265"><CODE>rl_alphabetic</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX178">rl_already_prompted</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX302">rl_attempted_completion_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX317">rl_attempted_completion_over</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX308">rl_basic_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX307">rl_basic_word_break_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX228"><CODE>rl_begin_undo_group</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX210"><CODE>rl_bind_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX211"><CODE>rl_bind_key_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX195">rl_binding_keymap</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX279"><CODE>rl_callback_handler_install</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX281"><CODE>rl_callback_handler_remove</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX280"><CODE>rl_callback_read_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX282">rl_catch_signals</A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX283">rl_catch_sigwinch</A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX305">rl_char_is_quoted_p</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX284"><CODE>rl_cleanup_after_signal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX242"><CODE>rl_clear_message</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX256"><CODE>rl_clear_pending_input</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX291"><CODE>rl_clear_signals</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX292"><CODE>rl_complete</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC45">2.6.1 How Completing Works</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX295"><CODE>rl_complete</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX294"><CODE>rl_complete_internal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX310">rl_completer_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX309">rl_completer_word_break_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX313">rl_completion_append_character</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX322">rl_completion_display_matches_hook</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX293">rl_completion_entry_function</A></TD><TD valign=top><A HREF="readline.html#SEC45">2.6.1 How Completing Works</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX301">rl_completion_entry_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX298"><CODE>rl_completion_matches</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX306">rl_completion_query_items</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX318">rl_completion_type</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX203"><CODE>rl_copy_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX249"><CODE>rl_copy_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX239"><CODE>rl_crlf</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX248"><CODE>rl_delete_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX193">rl_deprep_term_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX259"><CODE>rl_deprep_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX264"><CODE>rl_ding</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX321">rl_directory_completion_hook</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX205"><CODE>rl_discard_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX175">rl_dispatching</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX266"><CODE>rl_display_match_list</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX232"><CODE>rl_do_undo</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX172">rl_done</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX200">rl_editing_mode</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX170">rl_end</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX229"><CODE>rl_end_undo_group</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX176">rl_erase_empty_line</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX189">rl_event_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX255"><CODE>rl_execute_next</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX194">rl_executing_keymap</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX196">rl_executing_macro</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX245"><CODE>rl_expand_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX198">rl_explicit_arg</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX262"><CODE>rl_extend_line_buffer</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX315">rl_filename_completion_desired</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX299"><CODE>rl_filename_completion_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX304">rl_filename_dequoting_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX311">rl_filename_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX316">rl_filename_quoting_desired</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX303">rl_filename_quoting_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX235"><CODE>rl_forced_update_display</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX285"><CODE>rl_free_line_state</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX231"><CODE>rl_free_undo_list</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX224"><CODE>rl_function_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX221"><CODE>rl_function_of_keyseq</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX226"><CODE>rl_funmap_names</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX217"><CODE>rl_generic_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX206"><CODE>rl_get_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX208"><CODE>rl_get_keymap_by_name</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX209"><CODE>rl_get_keymap_name</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX289"><CODE>rl_get_screen_size</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX278"><CODE>rl_get_termcap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX253"><CODE>rl_getc</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX190">rl_getc_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX181">rl_gnu_readline_p</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX314">rl_ignore_completion_duplicates</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX320">rl_ignore_some_completions_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX319">rl_inhibit_completion</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX263"><CODE>rl_initialize</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX297"><CODE>rl_insert_completions</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX247"><CODE>rl_insert_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX184">rl_instream</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX222"><CODE>rl_invoking_keyseqs</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX223"><CODE>rl_invoking_keyseqs_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX250"><CODE>rl_kill_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX186">rl_last_func</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX179">rl_library_version</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX168">rl_line_buffer</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX225"><CODE>rl_list_funmap_names</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX273"><CODE>rl_macro_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX274"><CODE>rl_macro_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX202"><CODE>rl_make_bare_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX204"><CODE>rl_make_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX171">rl_mark</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX241"><CODE>rl_message</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX233"><CODE>rl_modifying</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX220"><CODE>rl_named_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX173">rl_num_chars_to_read</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX199">rl_numeric_arg</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX236"><CODE>rl_on_new_line</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX237"><CODE>rl_on_new_line_with_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX185">rl_outstream</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX218"><CODE>rl_parse_and_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX174">rl_pending_input</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX169">rl_point</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX296"><CODE>rl_possible_completions</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX188">rl_pre_input_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX192">rl_prep_term_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX258"><CODE>rl_prep_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX177">rl_prompt</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX251"><CODE>rl_push_macro_input</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX219"><CODE>rl_read_init_file</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX252"><CODE>rl_read_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX183">rl_readline_name</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX197">rl_readline_state</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX180">rl_readline_version</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX234"><CODE>rl_redisplay</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX191">rl_redisplay_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX286"><CODE>rl_reset_after_signal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX238"><CODE>rl_reset_line_state</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX261"><CODE>rl_reset_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX287"><CODE>rl_resize_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX244"><CODE>rl_restore_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX243"><CODE>rl_save_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX216"><CODE>rl_set_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX257"><CODE>rl_set_keyboard_input_timeout</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX207"><CODE>rl_set_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX277"><CODE>rl_set_paren_blink_timeout</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX246"><CODE>rl_set_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX288"><CODE>rl_set_screen_size</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX290"><CODE>rl_set_signals</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX240"><CODE>rl_show_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX312">rl_special_prefixes</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX187">rl_startup_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX254"><CODE>rl_stuff_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX182">rl_terminal_name</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX260"><CODE>rl_tty_set_default_bindings</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX215"><CODE>rl_unbind_command_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX214"><CODE>rl_unbind_function_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX212"><CODE>rl_unbind_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX213"><CODE>rl_unbind_key_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX300"><CODE>rl_username_completion_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX275"><CODE>rl_variable_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX276"><CODE>rl_variable_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX140"><CODE>re-read-init-file (C-x C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX141"><CODE>re-read-init-file (C-x C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX174"><CODE>readline</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC24">2.1 Basic Behavior</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX40"><CODE>redraw-current-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX41"><CODE>redraw-current-line ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC14">1.4.1 Commands For Moving</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX52"><CODE>reverse-search-history (C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX53"><CODE>reverse-search-history (C-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX150"><CODE>revert-line (M-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX151"><CODE>revert-line (M-r)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX209"><CODE>rl_add_defun</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC30">2.4.1 Naming a Function</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX235"><CODE>rl_add_funmap_entry</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX238"><CODE>rl_add_undo</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX274"><CODE>rl_alphabetic</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX186">rl_already_prompted</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX312">rl_attempted_completion_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX332">rl_attempted_completion_over</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX320">rl_basic_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX319">rl_basic_word_break_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX236"><CODE>rl_begin_undo_group</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX218"><CODE>rl_bind_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX219"><CODE>rl_bind_key_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX203">rl_binding_keymap</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX288"><CODE>rl_callback_handler_install</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX290"><CODE>rl_callback_handler_remove</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX289"><CODE>rl_callback_read_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC41">2.4.12 Alternate Interface</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX291">rl_catch_signals</A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX292">rl_catch_sigwinch</A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX315">rl_char_is_quoted_p</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX293"><CODE>rl_cleanup_after_signal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX250"><CODE>rl_clear_message</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX264"><CODE>rl_clear_pending_input</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX300"><CODE>rl_clear_signals</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX301"><CODE>rl_complete</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC45">2.6.1 How Completing Works</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX304"><CODE>rl_complete</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX303"><CODE>rl_complete_internal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX322">rl_completer_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX321">rl_completer_word_break_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX326">rl_completion_append_character</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX318">rl_completion_display_matches_hook</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX302">rl_completion_entry_function</A></TD><TD valign=top><A HREF="readline.html#SEC45">2.6.1 How Completing Works</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX311">rl_completion_entry_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX328">rl_completion_mark_symlink_dirs</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX308"><CODE>rl_completion_matches</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX307"><CODE>rl_completion_mode</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX325">rl_completion_query_items</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX327">rl_completion_suppress_append</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX333">rl_completion_type</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX211"><CODE>rl_copy_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX257"><CODE>rl_copy_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX247"><CODE>rl_crlf</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX256"><CODE>rl_delete_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX201">rl_deprep_term_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX267"><CODE>rl_deprep_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX273"><CODE>rl_ding</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX317">rl_directory_completion_hook</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX213"><CODE>rl_discard_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX183">rl_dispatching</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX275"><CODE>rl_display_match_list</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX240"><CODE>rl_do_undo</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX180">rl_done</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX208">rl_editing_mode</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX178">rl_end</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX237"><CODE>rl_end_undo_group</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX184">rl_erase_empty_line</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX197">rl_event_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX263"><CODE>rl_execute_next</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX202">rl_executing_keymap</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX204">rl_executing_macro</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX253"><CODE>rl_expand_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX206">rl_explicit_arg</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX271"><CODE>rl_extend_line_buffer</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX330">rl_filename_completion_desired</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX309"><CODE>rl_filename_completion_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX314">rl_filename_dequoting_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX323">rl_filename_quote_characters</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX331">rl_filename_quoting_desired</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX313">rl_filename_quoting_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX243"><CODE>rl_forced_update_display</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX294"><CODE>rl_free_line_state</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX239"><CODE>rl_free_undo_list</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX232"><CODE>rl_function_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX229"><CODE>rl_function_of_keyseq</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX234"><CODE>rl_funmap_names</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX225"><CODE>rl_generic_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX214"><CODE>rl_get_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX216"><CODE>rl_get_keymap_by_name</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX217"><CODE>rl_get_keymap_name</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX298"><CODE>rl_get_screen_size</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX287"><CODE>rl_get_termcap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX261"><CODE>rl_getc</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX198">rl_getc_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX189">rl_gnu_readline_p</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX329">rl_ignore_completion_duplicates</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX316">rl_ignore_some_completions_function</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX334">rl_inhibit_completion</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX272"><CODE>rl_initialize</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX306"><CODE>rl_insert_completions</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX255"><CODE>rl_insert_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX192">rl_instream</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX230"><CODE>rl_invoking_keyseqs</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX231"><CODE>rl_invoking_keyseqs_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX258"><CODE>rl_kill_text</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX194">rl_last_func</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX187">rl_library_version</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX176">rl_line_buffer</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX233"><CODE>rl_list_funmap_names</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX282"><CODE>rl_macro_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX283"><CODE>rl_macro_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX210"><CODE>rl_make_bare_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX212"><CODE>rl_make_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX179">rl_mark</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX249"><CODE>rl_message</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX241"><CODE>rl_modifying</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC34">2.4.5 Allowing Undoing</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX228"><CODE>rl_named_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC33">2.4.4 Associating Function Names and Bindings</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX181">rl_num_chars_to_read</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX207">rl_numeric_arg</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX244"><CODE>rl_on_new_line</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX245"><CODE>rl_on_new_line_with_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX193">rl_outstream</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX226"><CODE>rl_parse_and_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX182">rl_pending_input</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX177">rl_point</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX305"><CODE>rl_possible_completions</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX196">rl_pre_input_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX200">rl_prep_term_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX266"><CODE>rl_prep_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX185">rl_prompt</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX259"><CODE>rl_push_macro_input</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC36">2.4.7 Modifying Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX227"><CODE>rl_read_init_file</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX260"><CODE>rl_read_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX191">rl_readline_name</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX205">rl_readline_state</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX188">rl_readline_version</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX242"><CODE>rl_redisplay</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX199">rl_redisplay_function</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX270"><CODE>rl_replace_line</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC39">2.4.10 Utility Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX295"><CODE>rl_reset_after_signal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX246"><CODE>rl_reset_line_state</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX269"><CODE>rl_reset_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX296"><CODE>rl_resize_terminal</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX252"><CODE>rl_restore_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX251"><CODE>rl_save_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX224"><CODE>rl_set_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX265"><CODE>rl_set_keyboard_input_timeout</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX215"><CODE>rl_set_keymap</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC31">2.4.2 Selecting a Keymap</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX286"><CODE>rl_set_paren_blink_timeout</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX254"><CODE>rl_set_prompt</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX297"><CODE>rl_set_screen_size</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX299"><CODE>rl_set_signals</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC43">2.5 Readline Signal Handling</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX248"><CODE>rl_show_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC35">2.4.6 Redisplay</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX324">rl_special_prefixes</A></TD><TD valign=top><A HREF="readline.html#SEC47">2.6.3 Completion Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX195">rl_startup_hook</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX262"><CODE>rl_stuff_char</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC37">2.4.8 Character Input</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX190">rl_terminal_name</A></TD><TD valign=top><A HREF="readline.html#SEC28">2.3 Readline Variables</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX268"><CODE>rl_tty_set_default_bindings</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC38">2.4.9 Terminal Management</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX223"><CODE>rl_unbind_command_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX222"><CODE>rl_unbind_function_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX220"><CODE>rl_unbind_key</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX221"><CODE>rl_unbind_key_in_map</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC32">2.4.3 Binding Keys</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX310"><CODE>rl_username_completion_function</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC46">2.6.2 Completion Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX284"><CODE>rl_variable_bind</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX285"><CODE>rl_variable_dumper</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC40">2.4.11 Miscellaneous Functions</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_S"></A>S</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX76"><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX77"><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX150"><CODE>set-mark (C-@)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX151"><CODE>set-mark (C-@)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX22">show-all-if-ambiguous</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX130"><CODE>start-kbd-macro (C-x ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX131"><CODE>start-kbd-macro (C-x ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX78"><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX79"><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX154"><CODE>set-mark (C-@)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX155"><CODE>set-mark (C-@)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX24">show-all-if-ambiguous</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX134"><CODE>start-kbd-macro (C-x ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX135"><CODE>start-kbd-macro (C-x ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC20">1.4.7 Keyboard Macros</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_T"></A>T</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX74"><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX75"><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX148"><CODE>tilde-expand (M-~)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX149"><CODE>tilde-expand (M-~)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX78"><CODE>transpose-chars (C-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX79"><CODE>transpose-chars (C-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX80"><CODE>transpose-words (M-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX81"><CODE>transpose-words (M-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX76"><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX77"><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX152"><CODE>tilde-expand (M-~)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX153"><CODE>tilde-expand (M-~)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX80"><CODE>transpose-chars (C-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX81"><CODE>transpose-chars (C-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX82"><CODE>transpose-words (M-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX83"><CODE>transpose-words (M-t)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_U"></A>U</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX144"><CODE>undo (C-_ or C-x C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX145"><CODE>undo (C-_ or C-x C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX118"><CODE>universal-argument ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX119"><CODE>universal-argument ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX92"><CODE>unix-line-discard (C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX93"><CODE>unix-line-discard (C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX100"><CODE>unix-word-rubout (C-w)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX101"><CODE>unix-word-rubout (C-w)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX82"><CODE>upcase-word (M-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX83"><CODE>upcase-word (M-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX148"><CODE>undo (C-_ or C-x C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX149"><CODE>undo (C-_ or C-x C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX122"><CODE>universal-argument ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX123"><CODE>universal-argument ()</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX96"><CODE>unix-line-discard (C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX97"><CODE>unix-line-discard (C-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX104"><CODE>unix-word-rubout (C-w)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX105"><CODE>unix-word-rubout (C-w)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX84"><CODE>upcase-word (M-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX85"><CODE>upcase-word (M-u)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC16">1.4.3 Commands For Changing Text</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_V"></A>V</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX23">visible-stats</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX172"><CODE>vi-editing-mode (M-C-j)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX173"><CODE>vi-editing-mode (M-C-j)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX25">visible-stats</A></TD><TD valign=top><A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> <TR><TH><A NAME="fn_Y"></A>Y</TH><TD></TD><TD></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX112"><CODE>yank (C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX113"><CODE>yank (C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX64"><CODE>yank-last-arg (M-. or M-_)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX65"><CODE>yank-last-arg (M-. or M-_)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX62"><CODE>yank-nth-arg (M-C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX63"><CODE>yank-nth-arg (M-C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX114"><CODE>yank-pop (M-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> -<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX115"><CODE>yank-pop (M-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX116"><CODE>yank (C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX117"><CODE>yank (C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX66"><CODE>yank-last-arg (M-. or M-_)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX67"><CODE>yank-last-arg (M-. or M-_)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX64"><CODE>yank-nth-arg (M-C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX65"><CODE>yank-nth-arg (M-C-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX118"><CODE>yank-pop (M-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> +<TR><TD></TD><TD valign=top><A HREF="readline.html#IDX119"><CODE>yank-pop (M-y)</CODE></A></TD><TD valign=top><A HREF="readline.html#SEC17">1.4.4 Killing And Yanking</A></TD></TR> <TR><TD COLSPAN=3> <HR></TD></TR> </TABLE><P></P><table><tr><th valign=top>Jump to: </th><td><A HREF="readline.html#fn__" style="text-decoration:none"><b>_</b></A> @@ -5603,7 +5738,7 @@ valid_argument (caller, arg) <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="readline.html#SEC_About"> ? </A>]</TD> </TR></TABLE> <H1>About this document</H1> -This document was generated by <I>Chet Ramey</I> on <I>October, 9 2001</I> +This document was generated by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> <P></P> @@ -5765,7 +5900,7 @@ the following structure: <BR> <FONT SIZE="-1"> This document was generated -by <I>Chet Ramey</I> on <I>October, 9 2001</I> +by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> diff --git a/doc/readline.info b/doc/readline.info index 8853f1c..57dbdfa 100644 --- a/doc/readline.info +++ b/doc/readline.info @@ -1,4 +1,4 @@ -This is readline.info, produced by makeinfo version 4.0 from +This is readline.info, produced by makeinfo version 4.1 from /usr/homes/chet/src/bash/readline-src/doc/rlman.texinfo. INFO-DIR-SECTION Libraries @@ -10,7 +10,7 @@ END-INFO-DIR-ENTRY aids in the consistency of user interface across discrete programs that need to provide a command line interface. - Copyright (C) 1988-2001 Free Software Foundation, Inc. + Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice pare @@ -470,6 +470,11 @@ Variable Settings asterisk (`*') at the start of history lines which have been modified. This variable is `off' by default. + `mark-symlinked-directories' + If set to `on', completed names which are symbolic links to + directories have a slash appended (subject to the value of + `mark-directories'). The default is `off'. + `match-hidden-files' This variable, when set to `on', causes Readline to match files whose names begin with a `.' (hidden files) when @@ -482,6 +487,11 @@ Variable Settings eighth bit set directly rather than as a meta-prefixed escape sequence. The default is `off'. + `page-completions' + If set to `on', Readline uses an internal `more'-like pager + to display a screenful of possible completions at a time. + This variable is `on' by default. + `print-completions-horizontally' If set to `on', Readline will display completions with matches sorted horizontally in alphabetical order, rather than down @@ -684,14 +694,14 @@ binding, variable assignment, and conditional syntax. # This file controls the behaviour of line input editing for - # programs that use the Gnu Readline library. Existing programs - # include FTP, Bash, and Gdb. + # programs that use the GNU Readline library. Existing + # programs include FTP, Bash, and GDB. # # You can re-read the inputrc file with C-x C-r. # Lines beginning with '#' are comments. # - # First, include any systemwide bindings and variable assignments from - # /etc/Inputrc + # First, include any systemwide bindings and variable + # assignments from /etc/Inputrc $include /etc/Inputrc # @@ -743,10 +753,12 @@ binding, variable assignment, and conditional syntax. $if Bash # edit the path "\C-xp": "PATH=${PATH}\e\C-e\C-a\ef\C-f" - # prepare to type a quoted word -- insert open and close double quotes + # prepare to type a quoted word -- + # insert open and close double quotes # and move to just after the open quote "\C-x\"": "\"\"\C-b" - # insert a backslash (testing backslash escapes in sequences and macros) + # insert a backslash (testing backslash escapes + # in sequences and macros) "\C-x\\": "\\" # Quote the current or previous word "\C-xq": "\eb\"\ef\"" @@ -762,16 +774,16 @@ binding, variable assignment, and conditional syntax. # don't strip characters to 7 bits when reading set input-meta on - # allow iso-latin1 characters to be inserted rather than converted to - # prefix-meta sequences + # allow iso-latin1 characters to be inserted rather + # than converted to prefix-meta sequences set convert-meta off - # display characters with the eighth bit set directly rather than - # as meta-prefixed characters + # display characters with the eighth bit set directly + # rather than as meta-prefixed characters set output-meta on - # if there are more than 150 possible completions for a word, ask the - # user if he wants to see all of them + # if there are more than 150 possible completions for + # a word, ask the user if he wants to see all of them set completion-query-items 150 # For FTP @@ -962,6 +974,20 @@ Commands For Changing Text Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move the cursor. +`overwrite-mode ()' + Toggle overwrite mode. With an explicit positive numeric argument, + switches to overwrite mode. With an explicit non-positive numeric + argument, switches to insert mode. This command affects only + `emacs' mode; `vi' mode does overwrite differently. Each call to + `readline()' starts in insert mode. + + In overwrite mode, characters bound to `self-insert' replace the + text at point rather than pushing the text to the right. + Characters bound to `backward-delete-char' replace the character + before point with a space. + + By default, this command is unbound. + File: readline.info, Node: Commands For Killing, Next: Numeric Arguments, Prev: Commands For Text, Up: Bindable Readline Commands @@ -1151,9 +1177,14 @@ Some Miscellaneous Commands occurrences. `insert-comment (M-#)' - The value of the `comment-begin' variable is inserted at the - beginning of the current line, and the line is accepted as if a - newline had been typed. + Without a numeric argument, the value of the `comment-begin' + variable 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 `comment-begin', the value is inserted, otherwise the + characters in `comment-begin' are deleted from the beginning of + the line. In either case, the line is accepted as if a newline + had been typed. `dump-functions ()' Print all of the functions and their key bindings to the Readline @@ -1173,6 +1204,14 @@ Some Miscellaneous Commands output is formatted in such a way that it can be made part of an INPUTRC file. This command is unbound by default. +`emacs-editing-mode (C-e)' + When in `vi' command mode, this causes a switch to `emacs' editing + mode. + +`vi-editing-mode (M-C-j)' + When in `emacs' editing mode, this causes a switch to `vi' editing + mode. + File: readline.info, Node: Readline vi Mode, Prev: Bindable Readline Commands, Up: Command Line Editing @@ -1199,7 +1238,7 @@ the standard `vi' movement keys, move to previous history lines with aiding in the consitency of user interface across discrete programs that need to provide a command line interface. - Copyright (C) 1988-2001 Free Software Foundation, Inc. + Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice pare @@ -1286,12 +1325,13 @@ function, and has the advantage of no static buffer to overflow: /* A static variable for holding the line. */ static char *line_read = (char *)NULL; - /* Read a string, and return a pointer to it. Returns NULL on EOF. */ + /* Read a string, and return a pointer to it. + Returns NULL on EOF. */ char * rl_gets () { - /* If the buffer has already been allocated, return the memory - to the free pool. */ + /* If the buffer has already been allocated, + return the memory to the free pool. */ if (line_read) { free (line_read); @@ -1301,7 +1341,8 @@ function, and has the advantage of no static buffer to overflow: /* Get a line from the user. */ line_read = readline (""); - /* If the line has any text in it, save it on the history. */ + /* If the line has any text in it, + save it on the history. */ if (line_read && *line_read) add_history (line_read); @@ -1439,7 +1480,7 @@ variables that describe the current state of the line read so far. The calling sequence for a command `foo' looks like - `foo (int count, int key)' + `int foo (int count, int key)' where COUNT is the numeric argument (or 1 if defaulted) and KEY is the key that invoked this function. @@ -1453,6 +1494,9 @@ repeat count, it should be able to do something useful with both negative and positive arguments. At the very least, it should be aware that it can be passed a negative argument. + A command function should return 0 if its action completes +successfully, and a non-zero value if some error occurs. + File: readline.info, Node: Readline Variables, Next: Readline Convenience Functions, Prev: Custom Functions, Up: Programming with GNU Readline @@ -1545,10 +1589,12 @@ Readline Variables (*note Conditional Init Constructs::). - Variable: FILE * rl_instream - The stdio stream from which Readline reads input. + The stdio stream from which Readline reads input. If `NULL', + Readline defaults to STDIN. - Variable: FILE * rl_outstream - The stdio stream to which Readline performs output. + The stdio stream to which Readline performs output. If `NULL', + Readline defaults to STDOUT. - Variable: rl_command_func_t * rl_last_func The address of the last command function Readline executed. May @@ -2050,10 +2096,12 @@ Modifying Text -------------- - Function: int rl_insert_text (const char *text) - Insert TEXT into the line at the current cursor position. + Insert TEXT into the line at the current cursor position. Returns + the number of characters inserted. - Function: int rl_delete_text (int start, int end) Delete the text between START and END in the current line. + Returns the number of characters deleted. - Function: char * rl_copy_text (int start, int end) Return a copy of the text between START and END in the current @@ -2092,7 +2140,9 @@ Character Input - Function: int rl_stuff_char (int c) Insert C into the Readline input stream. It will be "read" before Readline attempts to read characters from the terminal with - `rl_read_key()'. + `rl_read_key()'. Up to 512 characters may be pushed back. + `rl_stuff_char' returns 1 if the character was successfully + inserted; 0 otherwise. - Function: int rl_execute_next (int c) Make C be the next command to be executed when `rl_read_key()' is @@ -2143,6 +2193,11 @@ File: readline.info, Node: Utility Functions, Next: Miscellaneous Functions, Utility Functions ----------------- + - Function: void rl_replace_line (const char *text, int clear_undo) + Replace the contents of `rl_line_buffer' with TEXT. The point and + mark are preserved, if possible. If CLEAR_UNDO is non-zero, the + undo list associated with the current line is cleared. + - Function: int rl_extend_line_buffer (int len) Ensure that `rl_line_buffer' has enough space to hold LEN characters, possibly reallocating it if necessary. @@ -2261,13 +2316,20 @@ functions available to make this easy. read the next character from the current input source. If that character completes the line, `rl_callback_read_char' will invoke the LHANDLER function saved by `rl_callback_handler_install' to - process the line. `EOF' is indicated by calling LHANDLER with a - `NULL' line. + process the line. Before calling the LHANDLER function, the + terminal settings are reset to the values they had before calling + `rl_callback_handler_install'. If the LHANDLER function returns, + the terminal settings are modified for Readline's use again. + `EOF' is indicated by calling LHANDLER with a `NULL' line. - Function: void rl_callback_handler_remove (void) Restore the terminal to its initial state and remove the line handler. This may be called from within a callback as well as - independently. + independently. If the LHANDLER installed by + `rl_callback_handler_install' does not exit the program, either + this function or the function referred to by the value of + `rl_deprep_term_function' should be called before the program + exits to reset the terminal settings. File: readline.info, Node: A Readline Example, Prev: Alternate Interface, Up: Readline Convenience Functions @@ -2321,8 +2383,8 @@ changed. end = temp; } - /* Tell readline that we are modifying the line, so it will save - the undo information. */ + /* Tell readline that we are modifying the line, + so it will save the undo information. */ rl_modifying (start, end); for (i = start; i != end; i++) @@ -2565,6 +2627,13 @@ Readline. partially-completed word. See description of `rl_complete()'. This calls `rl_complete_internal()' with an argument of `*'. + - Function: int rl_completion_mode (rl_command_func_t *cfunc) + Returns the apppriate value to pass to `rl_complete_internal()' + depending on whether CFUNC was called twice in succession and the + value of the `show-all-if-ambiguous' variable. + Application-specific completion functions may use this function to + present the same interface as `rl_complete()'. + - Function: char ** rl_completion_matches (const char *text, rl_compentry_func_t *entry_func) Returns an array of strings which is a list of completions for @@ -2648,10 +2717,39 @@ Completion Variables `rl_completer_word_break_characters' should be used to break words for the completer. - - Variable: int rl_completion_query_items - Up to this many items will be displayed in response to a - possible-completions call. After that, we ask the user if she is - sure she wants to see them all. The default value is 100. + - Variable: rl_compignore_func_t * rl_ignore_some_completions_function + This function, if defined, is called by the completer when real + filename completion is done, after all the matching names have + been generated. It is passed a `NULL' terminated array of matches. + The first element (`matches[0]') is the maximal substring common + to all matches. This function can re-arrange the list of matches + as required, but each element deleted from the array must be freed. + + - Variable: rl_icppfunc_t * rl_directory_completion_hook + This function, if defined, is allowed to modify the directory + portion of filenames Readline completes. It is called with the + address of a string (the current directory name) as an argument, + and may modify that string. If the string is replaced with a new + string, the old value should be freed. Any modified directory + name should have a trailing slash. The modified value will be + displayed as part of the completion, replacing the directory + portion of the pathname the user typed. It returns an integer + that should be non-zero if the function modifies its directory + argument. It could be used to expand symbolic links or shell + variables in pathnames. + + - Variable: rl_compdisp_func_t * rl_completion_display_matches_hook + If non-zero, then this is the address of a function to call when + completing a word would normally display the list of possible + matches. This function is called in lieu of Readline displaying + the list. It takes three arguments: (`char **'MATCHES, `int' + NUM_MATCHES, `int' MAX_LENGTH) where MATCHES is the array of + matching strings, NUM_MATCHES is the number of strings in that + array, and MAX_LENGTH is the length of the longest string in that + array. Readline provides a convenience function, + `rl_display_match_list', that takes care of doing the display to + Readline's output stream. That function may be called from this + hook. - Variable: const char * rl_basic_word_break_characters The basic list of characters that signal a break between words for @@ -2685,6 +2783,11 @@ Completion Variables do. For instance, Bash sets this variable to "$@" so that it can complete shell variables and hostnames. + - Variable: int rl_completion_query_items + Up to this many items will be displayed in response to a + possible-completions call. After that, we ask the user if she is + sure she wants to see them all. The default value is 100. + - Variable: int rl_completion_append_character When a single completion alternative matches at the end of the command line, this character is appended to the inserted @@ -2694,6 +2797,23 @@ Completion Variables to provide the "most sensible word separator character" according to an application-specific command line syntax specification. + - Variable: int rl_completion_suppress_append + If non-zero, RL_COMPLETION_APPEND_CHARACTER is not appended to + matches at the end of the command line, as described above. It is + set to 0 before any application-specific completion function is + called. + + - Variable: int rl_completion_mark_symlink_dirs + If non-zero, a slash will be appended to completed filenames that + are symbolic links to directory names, subject to the value of the + user-settable MARK-DIRECTORIES variable. This variable exists so + that application completion functions can override the user's + global preference (set via the MARK-SYMLINKED-DIRECTORIES Readline + variable) if appropriate. This variable is set to the user's + preference before any application completion function is called, + so unless that function modifies the value, the user's preferences + are honored. + - Variable: int rl_ignore_completion_duplicates If non-zero, then duplicates in the matches are removed. The default is 1. @@ -2734,40 +2854,6 @@ Completion Variables completion character will be inserted as any other bound to `self-insert'. - - Variable: rl_compignore_func_t * rl_ignore_some_completions_function - This function, if defined, is called by the completer when real - filename completion is done, after all the matching names have - been generated. It is passed a `NULL' terminated array of matches. - The first element (`matches[0]') is the maximal substring common - to all matches. This function can re-arrange the list of matches - as required, but each element deleted from the array must be freed. - - - Variable: rl_icppfunc_t * rl_directory_completion_hook - This function, if defined, is allowed to modify the directory - portion of filenames Readline completes. It is called with the - address of a string (the current directory name) as an argument, - and may modify that string. If the string is replaced with a new - string, the old value should be freed. Any modified directory - name should have a trailing slash. The modified value will be - displayed as part of the completion, replacing the directory - portion of the pathname the user typed. It returns an integer - that should be non-zero if the function modifies its directory - argument. It could be used to expand symbolic links or shell - variables in pathnames. - - - Variable: rl_compdisp_func_t * rl_completion_display_matches_hook - If non-zero, then this is the address of a function to call when - completing a word would normally display the list of possible - matches. This function is called in lieu of Readline displaying - the list. It takes three arguments: (`char **'MATCHES, `int' - NUM_MATCHES, `int' MAX_LENGTH) where MATCHES is the array of - matching strings, NUM_MATCHES is the number of strings in that - array, and MAX_LENGTH is the length of the longest string in that - array. Readline provides a convenience function, - `rl_display_match_list', that takes care of doing the display to - Readline's output stream. That function may be called from this - hook. - File: readline.info, Node: A Short Completion Example, Prev: Completion Variables, Up: Custom Completers @@ -3195,12 +3281,13 @@ command names, line editing features, and access to the history list. char *caller; { fprintf (stderr, - "%s: Too dangerous for me to distribute. Write it yourself.\n", + "%s: Too dangerous for me to distribute.\n" caller); + fprintf (stderr, "Write it yourself.\n"); } - /* Return non-zero if ARG is a valid argument for CALLER, else print - an error message and return zero. */ + /* Return non-zero if ARG is a valid argument for CALLER, + else print an error message and return zero. */ int valid_argument (caller, arg) char *caller, *arg; @@ -3304,6 +3391,7 @@ Function and Variable Index * kill-whole-line (): Commands For Killing. * kill-word (M-d): Commands For Killing. * mark-modified-lines: Readline Init File Syntax. +* mark-symlinked-directories: Readline Init File Syntax. * match-hidden-files: Readline Init File Syntax. * menu-complete (): Commands For Completion. * meta-flag: Readline Init File Syntax. @@ -3311,6 +3399,8 @@ Function and Variable Index * non-incremental-forward-search-history (M-n): Commands For History. * non-incremental-reverse-search-history (M-p): Commands For History. * output-meta: Readline Init File Syntax. +* overwrite-mode (): Commands For Text. +* page-completions: Readline Init File Syntax. * possible-completions (M-?): Commands For Completion. * prefix-meta (<ESC>): Miscellaneous Commands. * previous-history (C-p): Commands For History. @@ -3343,8 +3433,8 @@ Function and Variable Index * rl_clear_message: Redisplay. * rl_clear_pending_input: Character Input. * rl_clear_signals: Readline Signal Handling. -* rl_complete <1>: Completion Functions. -* rl_complete: How Completing Works. +* rl_complete <1>: How Completing Works. +* rl_complete: Completion Functions. * rl_complete_internal: Completion Functions. * rl_completer_quote_characters: Completion Variables. * rl_completer_word_break_characters: Completion Variables. @@ -3352,8 +3442,11 @@ Function and Variable Index * rl_completion_display_matches_hook: Completion Variables. * rl_completion_entry_function <1>: Completion Variables. * rl_completion_entry_function: How Completing Works. +* rl_completion_mark_symlink_dirs: Completion Variables. * rl_completion_matches: Completion Functions. +* rl_completion_mode: Completion Functions. * rl_completion_query_items: Completion Variables. +* rl_completion_suppress_append: Completion Variables. * rl_completion_type: Completion Variables. * rl_copy_keymap: Keymaps. * rl_copy_text: Modifying Text. @@ -3443,6 +3536,7 @@ Function and Variable Index * rl_readline_version: Readline Variables. * rl_redisplay: Redisplay. * rl_redisplay_function: Readline Variables. +* rl_replace_line: Utility Functions. * rl_reset_after_signal: Readline Signal Handling. * rl_reset_line_state: Redisplay. * rl_reset_terminal: Terminal Management. @@ -3500,45 +3594,45 @@ Node: Readline Arguments9866 Node: Searching10902 Node: Readline Init File13045 Node: Readline Init File Syntax14106 -Node: Conditional Init Constructs24556 -Node: Sample Init File27081 -Node: Bindable Readline Commands30251 -Node: Commands For Moving31301 -Node: Commands For History32150 -Node: Commands For Text35008 -Node: Commands For Killing37099 -Node: Numeric Arguments39050 -Node: Commands For Completion40178 -Node: Keyboard Macros41710 -Node: Miscellaneous Commands42269 -Node: Readline vi Mode45062 -Node: Programming with GNU Readline46880 -Node: Basic Behavior47848 -Node: Custom Functions51261 -Node: Readline Typedefs52739 -Node: Function Writing54368 -Node: Readline Variables55452 -Node: Readline Convenience Functions64784 -Node: Function Naming65766 -Node: Keymaps67018 -Node: Binding Keys68774 -Node: Associating Function Names and Bindings71700 -Node: Allowing Undoing73945 -Node: Redisplay76480 -Node: Modifying Text79551 -Node: Character Input80684 -Node: Terminal Management82329 -Node: Utility Functions83504 -Node: Miscellaneous Functions85571 -Node: Alternate Interface87635 -Node: A Readline Example89258 -Node: Readline Signal Handling91195 -Node: Custom Completers96798 -Node: How Completing Works97513 -Node: Completion Functions100511 -Node: Completion Variables103515 -Node: A Short Completion Example112886 -Node: Concept Index125411 -Node: Function and Variable Index126233 +Node: Conditional Init Constructs24989 +Node: Sample Init File27514 +Node: Bindable Readline Commands30698 +Node: Commands For Moving31748 +Node: Commands For History32597 +Node: Commands For Text35455 +Node: Commands For Killing38169 +Node: Numeric Arguments40120 +Node: Commands For Completion41248 +Node: Keyboard Macros42780 +Node: Miscellaneous Commands43339 +Node: Readline vi Mode46688 +Node: Programming with GNU Readline48506 +Node: Basic Behavior49474 +Node: Custom Functions52904 +Node: Readline Typedefs54382 +Node: Function Writing56011 +Node: Readline Variables57219 +Node: Readline Convenience Functions66642 +Node: Function Naming67624 +Node: Keymaps68876 +Node: Binding Keys70632 +Node: Associating Function Names and Bindings73558 +Node: Allowing Undoing75803 +Node: Redisplay78338 +Node: Modifying Text81409 +Node: Character Input82638 +Node: Terminal Management84418 +Node: Utility Functions85593 +Node: Miscellaneous Functions87932 +Node: Alternate Interface89996 +Node: A Readline Example92141 +Node: Readline Signal Handling94078 +Node: Custom Completers99681 +Node: How Completing Works100396 +Node: Completion Functions103394 +Node: Completion Variables106778 +Node: A Short Completion Example117049 +Node: Concept Index129602 +Node: Function and Variable Index130424 End Tag Table diff --git a/doc/readline.ps b/doc/readline.ps index 00827ed..21ca2ca 100644 --- a/doc/readline.ps +++ b/doc/readline.ps @@ -1,14 +1,14 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.86 Copyright 1999 Radical Eye Software %%Title: readline.dvi -%%Pages: 64 +%%Pages: 66 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 %%EndComments %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 300 -t letter -o readline.ps readline.dvi %DVIPSParameters: dpi=300, compressed -%DVIPSSource: TeX output 2001.10.09:1508 +%DVIPSSource: TeX output 2002.06.27:1354 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -84,8 +84,8 @@ D<134013E0EA01C01203120F123D12111201EA0380A6EA0700A6120EEAFFE0A20B177B96 14>I<381F81F813C1380FC3E0EA0EC213C6A213CE13CC381CCDC013DD13D9A213F1A238 38E3801303A53870070038FC0FC0A215177F9614>77 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fd cmtt9 9 46 -/Fd 46 127 df<126012F0AD12601200A4126012F0A212600417789614>33 +%DVIPSBitmapFont: Fd cmtt9 9 47 +/Fd 47 127 df<126012F0AD12601200A4126012F0A212600417789614>33 D<EA071CA5B51280A27E380E3800A7387FFF80B5FCA2381C7000A511177F9614>35 D<EA01801203EA06005A121C121812385AA35AA91270A37E1218121C120C7EEA03801201 091D799914>40 D<128012C01260123012381218121C120EA31207A9120EA3121C121812 @@ -117,24 +117,25 @@ EAFFFEA2EAE00012601270EA380EEA1C1EEA0FFCEA03F00F107E8F14>I<13FCEA01FEEA 383B38301800EA701CA3EA3018EA3838EA3FF0EA37C00070C7FCA2EA3FF86C7E487EEA70 0F38E00380A438700700EA3C1EEA1FFCEA07F011197F8F14>I<12FCA2121CA51378EA1D FEEA1F86EA1E07121CAA38FF8FE0A21317809614>I<1206120FA21206C7FCA4B4FCA212 -07ACEAFFF8A20D187C9714>I<12FCA2121CA5EBFF80A2EB1C005B5B5BEA1DC0EA1FE0A2 -EA1E70EA1C38133C131C7F38FF1F80A21117809614>107 D<EAFF80A21203B3EAFFFEA2 -0F177E9614>I<EAFB8EEAFFDF383CF380A2EA38E3AA38FEFBE013791310808F14>I<EAFC -78EAFDFEEA1F86EA1E07121CAA38FF8FE0A21310808F14>I<EA07C0EA1FF0EA3C78EA70 -1CA2EAE00EA6EA701CEA783CEA3C78EA1FF0EA07C00F107E8F14>I<EAFCF8EAFDFEEA1F -07EA1E03001C1380EB01C0A6EB0380001E1300EA1F0EEA1DFCEA1CF890C7FCA6B47EA212 -18808F14>I<EA03E7EA0FF7EA1C1FEA300F1270487EA6EA700F1230EA1C3FEA0FF7EA07 -C7EA0007A6EB3FE0A213187F8F14>I<EAFE1FEB7F80EA0EE3380F810090C7FCA2120EA8 -EAFFF0A211107F8F14>I<EA0FD8EA3FF8EA603812C0A2EAF000EA7F80EA3FF0EA07F8EA -001CEA600612E012F0EAF81CEAFFF8EACFE00F107E8F14>I<1206120EA4EA7FFC12FFEA -0E00A8130EA3131CEA07F8EA01F00F157F9414>I<EAFC3FA2EA1C07AB131F380FFFE0EA -03E71310808F14>I<38FE3F80A2383C1E00EA1C1CA36C5AA3EA0630EA0770A36C5AA311 -107F8F14>I<38FE3F80A238700700EA380EA3EA39CEA3EA1B6C121AA3EA1E7CA2EA0E38 -11107F8F14>I<EA7E3FA2EA1E3CEA0E78EA07705B12036C5A12037FEA0770EA0E781338 -487E38FE3F80A211107F8F14>I<38FE3F80A2381C0E005BA2120E5BA212071330A2EA03 -70A25B1201A25BA3485A12730077C7FC127E123C11187F8F14>I<EA3FFF5AEA700E131C -1338EA007013E0EA01C0EA0380EA0700120EEA1C0712381270B5FCA210107F8F14>I<EA -1C10EA3F38EAE7E0EA41C00D047D9614>126 D E +07ACEAFFF8A20D187C9714>I<136013F0A213601300A4EA1FF0A2EA0070B2EA40E0EAE0 +C0EA7F80EA3F000C207E9714>I<12FCA2121CA5EBFF80A2EB1C005B5B5BEA1DC0EA1FE0 +A2EA1E70EA1C38133C131C7F38FF1F80A21117809614>I<EAFF80A21203B3EAFFFEA20F +177E9614>I<EAFB8EEAFFDF383CF380A2EA38E3AA38FEFBE013791310808F14>I<EAFC78 +EAFDFEEA1F86EA1E07121CAA38FF8FE0A21310808F14>I<EA07C0EA1FF0EA3C78EA701C +A2EAE00EA6EA701CEA783CEA3C78EA1FF0EA07C00F107E8F14>I<EAFCF8EAFDFEEA1F07 +EA1E03001C1380EB01C0A6EB0380001E1300EA1F0EEA1DFCEA1CF890C7FCA6B47EA21218 +808F14>I<EA03E7EA0FF7EA1C1FEA300F1270487EA6EA700F1230EA1C3FEA0FF7EA07C7 +EA0007A6EB3FE0A213187F8F14>I<EAFE1FEB7F80EA0EE3380F810090C7FCA2120EA8EA +FFF0A211107F8F14>I<EA0FD8EA3FF8EA603812C0A2EAF000EA7F80EA3FF0EA07F8EA00 +1CEA600612E012F0EAF81CEAFFF8EACFE00F107E8F14>I<1206120EA4EA7FFC12FFEA0E +00A8130EA3131CEA07F8EA01F00F157F9414>I<EAFC3FA2EA1C07AB131F380FFFE0EA03 +E71310808F14>I<38FE3F80A2383C1E00EA1C1CA36C5AA3EA0630EA0770A36C5AA31110 +7F8F14>I<38FE3F80A238700700EA380EA3EA39CEA3EA1B6C121AA3EA1E7CA2EA0E3811 +107F8F14>I<EA7E3FA2EA1E3CEA0E78EA07705B12036C5A12037FEA0770EA0E78133848 +7E38FE3F80A211107F8F14>I<38FE3F80A2381C0E005BA2120E5BA212071330A2EA0370 +A25B1201A25BA3485A12730077C7FC127E123C11187F8F14>I<EA3FFF5AEA700E131C13 +38EA007013E0EA01C0EA0380EA0700120EEA1C0712381270B5FCA210107F8F14>I<EA1C +10EA3F38EAE7E0EA41C00D047D9614>126 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fe cmti9 9 1 /Fe 1 47 df<1230127812F0126005047C830C>46 D E @@ -1130,9 +1131,9 @@ letter %%EndSetup %%Page: 1 1 1 0 bop 75 659 a Fv(GNU)33 b(Readline)h(Library)p 75 -709 1800 17 v 891 757 a Fu(Edition)16 b(4.2a,)e(for)g -Ft(Readline)g(Library)h Fu(V)l(ersion)h(4.2a.)1608 811 -y(Octob)q(er)g(2001)75 2467 y Fs(Brian)23 b(F)-6 b(o)n(x,)23 +709 1800 17 v 936 757 a Fu(Edition)17 b(4.3,)c(for)i +Ft(Readline)f(Library)g Fu(V)l(ersion)i(4.3.)1643 811 +y(Marc)o(h)e(2002)75 2467 y Fs(Brian)23 b(F)-6 b(o)n(x,)23 b(F)-6 b(ree)23 b(Soft)n(w)n(are)f(F)-6 b(oundation)75 2534 y(Chet)22 b(Ramey)-6 b(,)23 b(Case)e(W)-6 b(estern)23 b(Reserv)n(e)f(Univ)n(ersit)n(y)p 75 2570 1800 9 v eop @@ -1161,7 +1162,7 @@ g(lan-)75 869 y(guage,)e(under)h(the)f(ab)q(o)o(v)o(e)g(conditions)i (ermission)g(notice)75 924 y(ma)o(y)f(b)q(e)i(stated)f(in)h(a)f (translation)g(appro)o(v)o(ed)g(b)o(y)g(the)g(F)l(ree)h(Soft)o(w)o(are) d(F)l(oundation.)75 2661 y(Cop)o(yrigh)o(t)301 2660 y(c)289 -2661 y Fr(\015)h Fu(1988-2001)f(F)l(ree)i(Soft)o(w)o(are)f(F)l +2661 y Fr(\015)h Fu(1988-2002)f(F)l(ree)i(Soft)o(w)o(are)f(F)l (oundation,)h(Inc.)p eop %%Page: 1 3 1 2 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 @@ -1489,7 +1490,7 @@ b(lines)g(are)75 1886 y(ignored.)36 b(Lines)22 b(b)q(eginning)h(with)d (a)h(`)p Ft(#)p Fu(')e(are)h(commen)o(ts.)35 b(Lines)22 b(b)q(eginning)h(with)e(a)f(`)p Ft($)p Fu(')f(indicate)75 1941 y(conditional)c(constructs)f(\(see)g(Section)g(1.3.2)f -([Conditional)h(Init)h(Constructs],)e(page)h(8\).)k(Other)c(lines)75 +([Conditional)h(Init)h(Constructs],)e(page)h(9\).)k(Other)c(lines)75 1996 y(denote)h(v)m(ariable)i(settings)e(and)h(k)o(ey)f(bindings.)75 2073 y(V)l(ariable)h(Settings)315 2128 y(Y)l(ou)k(can)h(mo)q(dify)g (the)f(run-time)h(b)q(eha)o(vior)g(of)e(Readline)j(b)o(y)e(altering)h @@ -1616,211 +1617,224 @@ y Ft(mark-modified-lines)555 1766 y Fu(This)j(v)m(ariable,)g(when)g (an)f(as-)555 1821 y(terisk)f(\(`)p Ft(*)p Fu('\))e(at)i(the)f(start)g (of)h(history)f(lines)j(whic)o(h)e(ha)o(v)o(e)g(b)q(een)h(mo)q (di\014ed.)555 1875 y(This)e(v)m(ariable)g(is)g(`)p Ft(off)p -Fu(')e(b)o(y)h(default.)315 1958 y Ft(match-hidden-files)555 -2012 y Fu(This)d(v)m(ariable,)h(when)e(set)g(to)g(`)p -Ft(on)p Fu(',)f(causes)h(Readline)i(to)d(matc)o(h)h(\014les)h(whose)555 -2067 y(names)22 b(b)q(egin)h(with)g(a)e(`)p Ft(.)p Fu(')h(\(hidden)h -(\014les\))g(when)f(p)q(erforming)h(\014lename)555 2122 -y(completion,)g(unless)f(the)f(leading)h(`)p Ft(.)p Fu(')e(is)h -(supplied)i(b)o(y)e(the)f(user)h(in)h(the)555 2177 y(\014lename)16 -b(to)f(b)q(e)h(completed.)21 b(This)15 b(v)m(ariable)i(is)f(`)p -Ft(on)p Fu(')e(b)o(y)h(default.)315 2259 y Ft(output-meta)555 -2314 y Fu(If)j(set)f(to)g(`)p Ft(on)p Fu(',)g(Readline)i(will)h(displa) -o(y)f(c)o(haracters)d(with)j(the)e(eigh)o(th)h(bit)555 -2369 y(set)g(directly)i(rather)d(than)h(as)g(a)g(meta-pre\014xed)h -(escap)q(e)g(sequence.)30 b(The)555 2423 y(default)16 -b(is)f(`)p Ft(off)p Fu('.)315 2506 y Ft(print-completions-horizont)o -(ally)555 2560 y Fu(If)d(set)g(to)f(`)p Ft(on)p Fu(',)h(Readline)h -(will)g(displa)o(y)h(completions)f(with)f(matc)o(hes)f(sorted)555 -2615 y(horizon)o(tally)23 b(in)f(alphab)q(etical)i(order,)f(rather)e -(than)g(do)o(wn)h(the)g(screen.)555 2670 y(The)15 b(default)h(is)g(`)p -Ft(off)p Fu('.)p eop +Fu(')e(b)o(y)h(default.)315 1958 y Ft(mark-symlinked-directories)555 +2012 y Fu(If)23 b(set)f(to)f(`)p Ft(on)p Fu(',)i(completed)g(names)g +(whic)o(h)g(are)f(sym)o(b)q(olic)i(links)f(to)f(di-)555 +2067 y(rectories)h(ha)o(v)o(e)g(a)g(slash)g(app)q(ended)i(\(sub)s(ject) +e(to)f(the)i(v)m(alue)g(of)f Ft(mark-)555 2122 y(directories)p +Fu(\).)18 b(The)d(default)h(is)g(`)p Ft(off)p Fu('.)315 +2204 y Ft(match-hidden-files)555 2259 y Fu(This)c(v)m(ariable,)h(when)e +(set)g(to)g(`)p Ft(on)p Fu(',)f(causes)h(Readline)i(to)d(matc)o(h)h +(\014les)h(whose)555 2314 y(names)22 b(b)q(egin)h(with)g(a)e(`)p +Ft(.)p Fu(')h(\(hidden)h(\014les\))g(when)f(p)q(erforming)h(\014lename) +555 2369 y(completion,)g(unless)f(the)f(leading)h(`)p +Ft(.)p Fu(')e(is)h(supplied)i(b)o(y)e(the)f(user)h(in)h(the)555 +2423 y(\014lename)16 b(to)f(b)q(e)h(completed.)21 b(This)15 +b(v)m(ariable)i(is)f(`)p Ft(on)p Fu(')e(b)o(y)h(default.)315 +2506 y Ft(output-meta)555 2560 y Fu(If)j(set)f(to)g(`)p +Ft(on)p Fu(',)g(Readline)i(will)h(displa)o(y)f(c)o(haracters)d(with)j +(the)e(eigh)o(th)h(bit)555 2615 y(set)g(directly)i(rather)d(than)h(as)g +(a)g(meta-pre\014xed)h(escap)q(e)g(sequence.)30 b(The)555 +2670 y(default)16 b(is)f(`)p Ft(off)p Fu('.)p eop %%Page: 7 9 7 8 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 -b(7)315 149 y Ft(show-all-if-ambiguous)555 204 y Fu(This)16 -b(alters)e(the)i(default)f(b)q(eha)o(vior)h(of)e(the)h(completion)h -(functions.)21 b(If)15 b(set)555 259 y(to)e(`)p Ft(on)p -Fu(',)g(w)o(ords)g(whic)o(h)h(ha)o(v)o(e)g(more)f(than)g(one)h(p)q -(ossible)i(completion)f(cause)555 314 y(the)20 b(matc)o(hes)f(to)f(b)q -(e)j(listed)f(immediately)h(instead)f(of)f(ringing)i(the)e(b)q(ell.)555 -369 y(The)c(default)h(v)m(alue)h(is)e(`)p Ft(off)p Fu('.)315 -448 y Ft(visible-stats)555 502 y Fu(If)h(set)g(to)f(`)p +b(7)315 149 y Ft(page-completions)555 204 y Fu(If)17 +b(set)g(to)f(`)p Ft(on)p Fu(',)g(Readline)i(uses)g(an)e(in)o(ternal)i +Ft(more)p Fu(-lik)o(e)g(pager)f(to)f(displa)o(y)555 259 +y(a)g(screenful)h(of)f(p)q(ossible)i(completions)f(at)f(a)g(time.)23 +b(This)17 b(v)m(ariable)g(is)g(`)p Ft(on)p Fu(')555 314 +y(b)o(y)e(default.)315 395 y Ft(print-completions-horizont)o(ally)555 +450 y Fu(If)d(set)g(to)f(`)p Ft(on)p Fu(',)h(Readline)h(will)g(displa)o +(y)h(completions)f(with)f(matc)o(hes)f(sorted)555 505 +y(horizon)o(tally)23 b(in)f(alphab)q(etical)i(order,)f(rather)e(than)g +(do)o(wn)h(the)g(screen.)555 560 y(The)15 b(default)h(is)g(`)p +Ft(off)p Fu('.)315 641 y Ft(show-all-if-ambiguous)555 +696 y Fu(This)g(alters)e(the)i(default)f(b)q(eha)o(vior)h(of)e(the)h +(completion)h(functions.)21 b(If)15 b(set)555 751 y(to)e(`)p +Ft(on)p Fu(',)g(w)o(ords)g(whic)o(h)h(ha)o(v)o(e)g(more)f(than)g(one)h +(p)q(ossible)i(completion)f(cause)555 806 y(the)20 b(matc)o(hes)f(to)f +(b)q(e)j(listed)f(immediately)h(instead)f(of)f(ringing)i(the)e(b)q +(ell.)555 861 y(The)c(default)h(v)m(alue)h(is)e(`)p Ft(off)p +Fu('.)315 942 y Ft(visible-stats)555 997 y Fu(If)h(set)g(to)f(`)p Ft(on)p Fu(',)g(a)h(c)o(haracter)f(denoting)h(a)g(\014le's)h(t)o(yp)q -(e)f(is)g(app)q(ended)i(to)d(the)555 557 y(\014lename)h(when)g(listing) -h(p)q(ossible)g(completions.)j(The)c(default)g(is)f(`)p -Ft(off)p Fu('.)75 636 y(Key)h(Bindings)315 691 y(The)21 +(e)f(is)g(app)q(ended)i(to)d(the)555 1052 y(\014lename)h(when)g +(listing)h(p)q(ossible)g(completions.)j(The)c(default)g(is)f(`)p +Ft(off)p Fu('.)75 1133 y(Key)h(Bindings)315 1188 y(The)21 b(syn)o(tax)f(for)h(con)o(trolling)h(k)o(ey)f(bindings)h(in)g(the)f (init)h(\014le)g(is)g(simple.)39 b(First)20 b(y)o(ou)315 -746 y(need)15 b(to)e(\014nd)h(the)g(name)g(of)g(the)f(command)h(that)f +1243 y(need)15 b(to)e(\014nd)h(the)g(name)g(of)g(the)f(command)h(that)f (y)o(ou)h(w)o(an)o(t)f(to)g(c)o(hange.)19 b(The)14 b(follo)o(wing)315 -801 y(sections)k(con)o(tain)h(tables)f(of)f(the)h(command)g(name,)g +1298 y(sections)k(con)o(tain)h(tables)f(of)f(the)h(command)g(name,)g (the)g(default)h(k)o(eybinding,)h(if)e(an)o(y)l(,)315 -855 y(and)d(a)g(short)g(description)i(of)d(what)h(the)g(command)g(do)q -(es.)315 922 y(Once)k(y)o(ou)f(kno)o(w)f(the)h(name)g(of)g(the)g +1353 y(and)d(a)g(short)g(description)i(of)d(what)h(the)g(command)g(do)q +(es.)315 1421 y(Once)k(y)o(ou)f(kno)o(w)f(the)h(name)g(of)g(the)g (command,)g(simply)h(place)g(on)f(a)f(line)j(in)f(the)f(init)315 -977 y(\014le)g(the)f(name)g(of)f(the)h(k)o(ey)g(y)o(ou)f(wish)i(to)e +1476 y(\014le)g(the)f(name)g(of)f(the)h(k)o(ey)g(y)o(ou)f(wish)i(to)e (bind)i(the)f(command)g(to,)f(a)g(colon,)i(and)f(then)315 -1032 y(the)f(name)g(of)g(the)g(command.)22 b(The)16 b(name)g(of)g(the)g +1530 y(the)f(name)g(of)g(the)g(command.)22 b(The)16 b(name)g(of)g(the)g (k)o(ey)f(can)i(b)q(e)f(expressed)h(in)g(di\013eren)o(t)315 -1087 y(w)o(a)o(ys,)d(dep)q(ending)j(on)e(what)g(y)o(ou)g(\014nd)h(most) -e(comfortable.)315 1154 y(In)19 b(addition)g(to)e(command)h(names,)g +1585 y(w)o(a)o(ys,)d(dep)q(ending)j(on)e(what)g(y)o(ou)g(\014nd)h(most) +e(comfortable.)315 1653 y(In)19 b(addition)g(to)e(command)h(names,)g (readline)i(allo)o(ws)e(k)o(eys)g(to)f(b)q(e)i(b)q(ound)g(to)e(a)h -(string)315 1208 y(that)c(is)i(inserted)g(when)g(the)f(k)o(ey)g(is)h -(pressed)g(\(a)e Fk(macro)r Fu(\).)315 1288 y Fk(k)o(eyname)s -Fu(:)19 b Fk(function-name)g Fu(or)c Fk(macro)555 1342 +(string)315 1708 y(that)c(is)i(inserted)g(when)g(the)f(k)o(ey)g(is)h +(pressed)g(\(a)e Fk(macro)r Fu(\).)315 1790 y Fk(k)o(eyname)s +Fu(:)19 b Fk(function-name)g Fu(or)c Fk(macro)555 1845 y(k)o(eyname)i Fu(is)e(the)f(name)h(of)f(a)g(k)o(ey)g(sp)q(elled)j(out) -d(in)h(English.)21 b(F)l(or)13 b(example:)675 1406 y -Ft(Control-u:)22 b(universal-argument)675 1458 y(Meta-Rubout:)g -(backward-kill-word)675 1510 y(Control-o:)g(">)i(output")555 -1577 y Fu(In)c(the)f(ab)q(o)o(v)o(e)g(example,)i Fo(C-u)e +d(in)h(English.)21 b(F)l(or)13 b(example:)675 1910 y +Ft(Control-u:)22 b(universal-argument)675 1962 y(Meta-Rubout:)g +(backward-kill-word)675 2014 y(Control-o:)g(">)i(output")555 +2082 y Fu(In)c(the)f(ab)q(o)o(v)o(e)g(example,)i Fo(C-u)e Fu(is)h(b)q(ound)g(to)f(the)g(function)h Ft(universal-)555 -1632 y(argument)p Fu(,)e Fo(M-DEL)h Fu(is)g(b)q(ound)h(to)e(the)h -(function)h Ft(backward-kill-word)p Fu(,)555 1687 y(and)g +2137 y(argument)p Fu(,)e Fo(M-DEL)h Fu(is)g(b)q(ound)h(to)e(the)h +(function)h Ft(backward-kill-word)p Fu(,)555 2191 y(and)g Fo(C-o)f Fu(is)h(b)q(ound)g(to)f(run)h(the)f(macro)g(expressed)h(on)g -(the)f(righ)o(t)h(hand)555 1741 y(side)c(\(that)e(is,)i(to)e(insert)i +(the)f(righ)o(t)h(hand)555 2246 y(side)c(\(that)e(is,)i(to)e(insert)i (the)f(text)g(`)p Ft(>)f(output)p Fu(')g(in)o(to)i(the)f(line\).)555 -1808 y(A)k(n)o(um)o(b)q(er)f(of)g(sym)o(b)q(olic)i(c)o(haracter)e -(names)g(are)g(recognized)i(while)g(pro-)555 1863 y(cessing)13 +2314 y(A)k(n)o(um)o(b)q(er)f(of)g(sym)o(b)q(olic)i(c)o(haracter)e +(names)g(are)g(recognized)i(while)g(pro-)555 2369 y(cessing)13 b(this)f(k)o(ey)g(binding)h(syn)o(tax:)18 b Fk(DEL)p Fu(,)11 b Fk(ESC)p Fu(,)h Fk(ESCAPE)p Fu(,)f Fk(LFD)p -Fu(,)g Fk(NEW-)555 1918 y(LINE)p Fu(,)16 b Fk(RET)p Fu(,)e +Fu(,)g Fk(NEW-)555 2424 y(LINE)p Fu(,)16 b Fk(RET)p Fu(,)e Fk(RETURN)p Fu(,)f Fk(R)o(UBOUT)p Fu(,)i Fk(SP)l(A)o(CE)p -Fu(,)g Fk(SPC)p Fu(,)f(and)i Fk(T)l(AB)p Fu(.)315 1997 +Fu(,)g Fk(SPC)p Fu(,)f(and)i Fk(T)l(AB)p Fu(.)315 2506 y Ft(")p Fk(k)o(eyseq)q Ft(")p Fu(:)k Fk(function-name)e -Fu(or)d Fk(macro)555 2052 y(k)o(eyseq)i Fu(di\013ers)e(from)g +Fu(or)d Fk(macro)555 2560 y(k)o(eyseq)i Fu(di\013ers)e(from)g Fk(k)o(eyname)j Fu(ab)q(o)o(v)o(e)d(in)i(that)d(strings)i(denoting)g -(an)f(en-)555 2107 y(tire)i(k)o(ey)g(sequence)h(can)f(b)q(e)g(sp)q +(an)f(en-)555 2615 y(tire)i(k)o(ey)g(sequence)h(can)f(b)q(e)g(sp)q (eci\014ed,)i(b)o(y)e(placing)h(the)f(k)o(ey)g(sequence)h(in)555 -2161 y(double)e(quotes.)j(Some)c Fp(gnu)g Fu(Emacs)f(st)o(yle)h(k)o(ey) -g(escap)q(es)g(can)g(b)q(e)g(used,)g(as)555 2216 y(in)j(the)f(follo)o -(wing)g(example,)h(but)f(the)g(sp)q(ecial)i(c)o(haracter)d(names)h(are) -f(not)555 2271 y(recognized.)675 2335 y Ft("\\C-u":)23 -b(universal-argument)675 2387 y("\\C-x\\C-r":)f(re-read-init-file)675 -2439 y("\\e[11~":)h("Function)f(Key)i(1")555 2506 y Fu(In)33 -b(the)f(ab)q(o)o(v)o(e)g(example,)37 b Fo(C-u)32 b Fu(is)h(again)f(b)q -(ound)h(to)f(the)g(function)555 2560 y Ft(universal-argument)19 -b Fu(\(just)j(as)f(it)h(w)o(as)f(in)i(the)f(\014rst)f(example\),)j(`)p -Fo(C-x)555 2615 y(C-r)p Fu(')c(is)h(b)q(ound)g(to)f(the)h(function)g -Ft(re-read-init-file)p Fu(,)f(and)g(`)1731 2613 y Fn(h)p -1743 2587 70 2 v 1743 2615 a Fm(ESC)p 1743 2623 V 1810 -2613 a Fn(i)15 b(h)p 1852 2587 10 2 v 1852 2615 a Fm([)p -1852 2623 V 1860 2613 a Fn(i)555 2668 y(h)p 567 2642 -18 2 v 567 2670 a Fm(1)p 567 2678 V 583 2668 a Fn(i)g(h)p -625 2642 V 625 2670 a Fm(1)p 625 2678 V 640 2668 a Fn(i)g(h)p -683 2642 24 2 v 683 2670 a Ft(~)p 683 2678 V 704 2668 -a Fn(i)719 2670 y Fu(')g(is)h(b)q(ound)g(to)e(insert)i(the)f(text)g(`)p -Ft(Function)f(Key)g(1)p Fu('.)p eop +2670 y(double)e(quotes.)j(Some)c Fp(gnu)g Fu(Emacs)f(st)o(yle)h(k)o(ey) +g(escap)q(es)g(can)g(b)q(e)g(used,)g(as)p eop %%Page: 8 10 -8 9 bop 75 -58 a Fu(8)1322 b(GNU)15 b(Readline)h(Library)315 -149 y(The)f(follo)o(wing)h Fp(gnu)e Fu(Emacs)h(st)o(yle)g(escap)q(e)h +8 9 bop 75 -58 a Fu(8)1322 b(GNU)15 b(Readline)h(Library)555 +149 y(in)i(the)f(follo)o(wing)g(example,)h(but)f(the)g(sp)q(ecial)i(c)o +(haracter)d(names)h(are)f(not)555 204 y(recognized.)675 +270 y Ft("\\C-u":)23 b(universal-argument)675 322 y("\\C-x\\C-r":)f +(re-read-init-file)675 373 y("\\e[11~":)h("Function)f(Key)i(1")555 +442 y Fu(In)33 b(the)f(ab)q(o)o(v)o(e)g(example,)37 b +Fo(C-u)32 b Fu(is)h(again)f(b)q(ound)h(to)f(the)g(function)555 +497 y Ft(universal-argument)19 b Fu(\(just)j(as)f(it)h(w)o(as)f(in)i +(the)f(\014rst)f(example\),)j(`)p Fo(C-x)555 551 y(C-r)p +Fu(')c(is)h(b)q(ound)g(to)f(the)h(function)g Ft(re-read-init-file)p +Fu(,)f(and)g(`)1731 549 y Fn(h)p 1743 523 70 2 v 1743 +551 a Fm(ESC)p 1743 559 V 1810 549 a Fn(i)15 b(h)p 1852 +523 10 2 v 1852 551 a Fm([)p 1852 560 V 1860 549 a Fn(i)555 +604 y(h)p 567 578 18 2 v 567 606 a Fm(1)p 567 614 V 583 +604 a Fn(i)g(h)p 625 578 V 625 606 a Fm(1)p 625 614 V +640 604 a Fn(i)g(h)p 683 578 24 2 v 683 606 a Ft(~)p +683 614 V 704 604 a Fn(i)719 606 y Fu(')g(is)h(b)q(ound)g(to)e(insert)i +(the)f(text)g(`)p Ft(Function)f(Key)g(1)p Fu('.)315 688 +y(The)h(follo)o(wing)h Fp(gnu)e Fu(Emacs)h(st)o(yle)g(escap)q(e)h (sequences)g(are)e(a)o(v)m(ailable)j(when)e(sp)q(ecifying)315 -204 y(k)o(ey)g(sequences:)315 287 y Fo(\\C-)168 b Fu(con)o(trol)15 -b(pre\014x)315 370 y Fo(\\M-)168 b Fu(meta)15 b(pre\014x)315 -453 y Fo(\\e)192 b Fu(an)15 b(escap)q(e)h(c)o(haracter)315 -536 y Fo(\\\\)192 b Fu(bac)o(kslash)315 619 y Fo(\\)p -Ft(")555 617 y Fn(h)p 567 591 24 2 v 567 619 a Ft(")p -567 627 V 589 617 a Fn(i)604 619 y Fu(,)15 b(a)f(double)j(quotation)e -(mark)315 702 y Fo(\\')555 700 y Fn(h)p 567 674 10 2 -v 567 702 a Fm(')p 567 710 V 575 700 a Fn(i)590 702 y -Fu(,)g(a)f(single)j(quote)e(or)g(ap)q(ostrophe)315 785 -y(In)f(addition)h(to)f(the)f Fp(gnu)h Fu(Emacs)g(st)o(yle)f(escap)q(e)i -(sequences,)g(a)e(second)i(set)e(of)h(bac)o(kslash)315 -840 y(escap)q(es)i(is)g(a)o(v)m(ailable:)315 923 y Ft(\\a)192 -b Fu(alert)15 b(\(b)q(ell\))315 1006 y Ft(\\b)192 b Fu(bac)o(kspace)315 -1089 y Ft(\\d)g Fu(delete)315 1172 y Ft(\\f)g Fu(form)14 -b(feed)315 1255 y Ft(\\n)192 b Fu(newline)315 1338 y -Ft(\\r)g Fu(carriage)15 b(return)315 1421 y Ft(\\t)192 -b Fu(horizon)o(tal)16 b(tab)315 1504 y Ft(\\v)192 b Fu(v)o(ertical)16 -b(tab)315 1587 y Ft(\\)p Fk(nnn)141 b Fu(the)17 b(eigh)o(t-bit)h(c)o -(haracter)f(whose)g(v)m(alue)i(is)e(the)h(o)q(ctal)f(v)m(alue)i -Fk(nnn)f Fu(\(one)f(to)555 1642 y(three)e(digits\))315 -1725 y Ft(\\x)p Fk(HH)124 b Fu(the)20 b(eigh)o(t-bit)g(c)o(haracter)f -(whose)h(v)m(alue)h(is)f(the)g(hexadecimal)h(v)m(alue)g -Fk(HH)555 1780 y Fu(\(one)15 b(or)g(t)o(w)o(o)f(hex)h(digits\))315 -1863 y(When)k(en)o(tering)g(the)g(text)f(of)g(a)h(macro,)f(single)i(or) -e(double)i(quotes)f(m)o(ust)f(b)q(e)h(used)h(to)315 1917 -y(indicate)12 b(a)f(macro)f(de\014nition.)20 b(Unquoted)11 -b(text)f(is)i(assumed)e(to)h(b)q(e)g(a)f(function)i(name.)18 -b(In)315 1972 y(the)11 b(macro)f(b)q(o)q(dy)l(,)i(the)f(bac)o(kslash)g -(escap)q(es)g(describ)q(ed)i(ab)q(o)o(v)o(e)d(are)g(expanded.)20 -b(Bac)o(kslash)315 2027 y(will)i(quote)d(an)o(y)h(other)g(c)o(haracter) -f(in)i(the)f(macro)f(text,)h(including)j(`)p Ft(")p Fu(')c(and)h(`)p -Ft(')p Fu('.)34 b(F)l(or)315 2082 y(example,)14 b(the)f(follo)o(wing)g -(binding)i(will)g(mak)o(e)d(`)p Fo(C-x)i Ft(\\)p Fu(')f(insert)g(a)g -(single)h(`)p Ft(\\)p Fu(')e(in)o(to)h(the)g(line:)435 -2148 y Ft("\\C-x\\\\":)23 b("\\\\")75 2267 y Fj(1.3.2)30 -b(Conditional)20 b(Init)g(Constructs)137 2366 y Fu(Readline)f(implemen) -o(ts)g(a)f(facilit)o(y)g(similar)h(in)g(spirit)f(to)f(the)h -(conditional)h(compilation)g(features)75 2421 y(of)e(the)g(C)g(prepro)q -(cessor)g(whic)o(h)i(allo)o(ws)e(k)o(ey)g(bindings)i(and)f(v)m(ariable) -g(settings)f(to)g(b)q(e)h(p)q(erformed)f(as)75 2476 y(the)e(result)h -(of)f(tests.)k(There)c(are)g(four)g(parser)g(directiv)o(es)h(used.)75 -2560 y Ft($if)168 b Fu(The)16 b Ft($if)f Fu(construct)g(allo)o(ws)h -(bindings)i(to)d(b)q(e)h(made)g(based)g(on)f(the)h(editing)h(mo)q(de,)f -(the)315 2615 y(terminal)k(b)q(eing)g(used,)g(or)f(the)g(application)i -(using)e(Readline.)33 b(The)19 b(text)g(of)f(the)i(test)315 -2670 y(extends)c(to)e(the)h(end)h(of)f(the)g(line;)i(no)e(c)o -(haracters)f(are)h(required)i(to)d(isolate)i(it.)p eop +743 y(k)o(ey)g(sequences:)315 825 y Fo(\\C-)168 b Fu(con)o(trol)15 +b(pre\014x)315 907 y Fo(\\M-)168 b Fu(meta)15 b(pre\014x)315 +989 y Fo(\\e)192 b Fu(an)15 b(escap)q(e)h(c)o(haracter)315 +1071 y Fo(\\\\)192 b Fu(bac)o(kslash)315 1152 y Fo(\\)p +Ft(")555 1150 y Fn(h)p 567 1124 V 567 1152 a Ft(")p 567 +1160 V 589 1150 a Fn(i)604 1152 y Fu(,)15 b(a)f(double)j(quotation)e +(mark)315 1234 y Fo(\\')555 1232 y Fn(h)p 567 1206 10 +2 v 567 1234 a Fm(')p 567 1242 V 575 1232 a Fn(i)590 +1234 y Fu(,)g(a)f(single)j(quote)e(or)g(ap)q(ostrophe)315 +1316 y(In)f(addition)h(to)f(the)f Fp(gnu)h Fu(Emacs)g(st)o(yle)f(escap) +q(e)i(sequences,)g(a)e(second)i(set)e(of)h(bac)o(kslash)315 +1371 y(escap)q(es)i(is)g(a)o(v)m(ailable:)315 1453 y +Ft(\\a)192 b Fu(alert)15 b(\(b)q(ell\))315 1535 y Ft(\\b)192 +b Fu(bac)o(kspace)315 1617 y Ft(\\d)g Fu(delete)315 1699 +y Ft(\\f)g Fu(form)14 b(feed)315 1781 y Ft(\\n)192 b +Fu(newline)315 1862 y Ft(\\r)g Fu(carriage)15 b(return)315 +1944 y Ft(\\t)192 b Fu(horizon)o(tal)16 b(tab)315 2026 +y Ft(\\v)192 b Fu(v)o(ertical)16 b(tab)315 2108 y Ft(\\)p +Fk(nnn)141 b Fu(the)17 b(eigh)o(t-bit)h(c)o(haracter)f(whose)g(v)m +(alue)i(is)e(the)h(o)q(ctal)f(v)m(alue)i Fk(nnn)f Fu(\(one)f(to)555 +2163 y(three)e(digits\))315 2245 y Ft(\\x)p Fk(HH)124 +b Fu(the)20 b(eigh)o(t-bit)g(c)o(haracter)f(whose)h(v)m(alue)h(is)f +(the)g(hexadecimal)h(v)m(alue)g Fk(HH)555 2300 y Fu(\(one)15 +b(or)g(t)o(w)o(o)f(hex)h(digits\))315 2382 y(When)k(en)o(tering)g(the)g +(text)f(of)g(a)h(macro,)f(single)i(or)e(double)i(quotes)f(m)o(ust)f(b)q +(e)h(used)h(to)315 2436 y(indicate)12 b(a)f(macro)f(de\014nition.)20 +b(Unquoted)11 b(text)f(is)i(assumed)e(to)h(b)q(e)g(a)f(function)i +(name.)18 b(In)315 2491 y(the)11 b(macro)f(b)q(o)q(dy)l(,)i(the)f(bac)o +(kslash)g(escap)q(es)g(describ)q(ed)i(ab)q(o)o(v)o(e)d(are)g(expanded.) +20 b(Bac)o(kslash)315 2546 y(will)i(quote)d(an)o(y)h(other)g(c)o +(haracter)f(in)i(the)f(macro)f(text,)h(including)j(`)p +Ft(")p Fu(')c(and)h(`)p Ft(')p Fu('.)34 b(F)l(or)315 +2601 y(example,)14 b(the)f(follo)o(wing)g(binding)i(will)g(mak)o(e)d(`) +p Fo(C-x)i Ft(\\)p Fu(')f(insert)g(a)g(single)h(`)p Ft(\\)p +Fu(')e(in)o(to)h(the)g(line:)435 2666 y Ft("\\C-x\\\\":)23 +b("\\\\")p eop %%Page: 9 11 9 10 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 -b(9)315 149 y Ft(mode)144 b Fu(The)11 b Ft(mode=)e Fu(form)h(of)g(the)h -Ft($if)f Fu(directiv)o(e)h(is)g(used)g(to)f(test)g(whether)h(Readline) -555 204 y(is)k(in)h Ft(emacs)e Fu(or)g Ft(vi)g Fu(mo)q(de.)20 +b(9)75 149 y Fj(1.3.2)30 b(Conditional)20 b(Init)g(Constructs)137 +246 y Fu(Readline)f(implemen)o(ts)g(a)f(facilit)o(y)g(similar)h(in)g +(spirit)f(to)f(the)h(conditional)h(compilation)g(features)75 +301 y(of)e(the)g(C)g(prepro)q(cessor)g(whic)o(h)i(allo)o(ws)e(k)o(ey)g +(bindings)i(and)f(v)m(ariable)g(settings)f(to)g(b)q(e)h(p)q(erformed)f +(as)75 355 y(the)e(result)h(of)f(tests.)k(There)c(are)g(four)g(parser)g +(directiv)o(es)h(used.)75 435 y Ft($if)168 b Fu(The)16 +b Ft($if)f Fu(construct)g(allo)o(ws)h(bindings)i(to)d(b)q(e)h(made)g +(based)g(on)f(the)h(editing)h(mo)q(de,)f(the)315 490 +y(terminal)k(b)q(eing)g(used,)g(or)f(the)g(application)i(using)e +(Readline.)33 b(The)19 b(text)g(of)f(the)i(test)315 545 +y(extends)c(to)e(the)h(end)h(of)f(the)g(line;)i(no)e(c)o(haracters)f +(are)h(required)i(to)d(isolate)i(it.)315 624 y Ft(mode)144 +b Fu(The)11 b Ft(mode=)e Fu(form)h(of)g(the)h Ft($if)f +Fu(directiv)o(e)h(is)g(used)g(to)f(test)g(whether)h(Readline)555 +679 y(is)k(in)h Ft(emacs)e Fu(or)g Ft(vi)g Fu(mo)q(de.)20 b(This)c(ma)o(y)e(b)q(e)h(used)g(in)h(conjunction)g(with)f(the)555 -259 y(`)p Ft(set)f(keymap)p Fu(')f(command,)g(for)h(instance,)g(to)f -(set)h(bindings)h(in)g(the)f Ft(emacs-)555 314 y(standard)d +734 y(`)p Ft(set)f(keymap)p Fu(')f(command,)g(for)h(instance,)g(to)f +(set)h(bindings)h(in)g(the)f Ft(emacs-)555 789 y(standard)d Fu(and)i Ft(emacs-ctlx)e Fu(k)o(eymaps)h(only)i(if)f(Readline)g(is)g -(starting)f(out)555 369 y(in)k Ft(emacs)f Fu(mo)q(de.)315 -448 y Ft(term)144 b Fu(The)14 b Ft(term=)e Fu(form)h(ma)o(y)g(b)q(e)h +(starting)f(out)555 844 y(in)k Ft(emacs)f Fu(mo)q(de.)315 +923 y Ft(term)144 b Fu(The)14 b Ft(term=)e Fu(form)h(ma)o(y)g(b)q(e)h (used)g(to)f(include)j(terminal-sp)q(eci\014c)g(k)o(ey)d(bind-)555 -503 y(ings,)19 b(p)q(erhaps)g(to)e(bind)i(the)g(k)o(ey)e(sequences)j -(output)e(b)o(y)g(the)g(terminal's)555 558 y(function)13 +978 y(ings,)19 b(p)q(erhaps)g(to)e(bind)i(the)g(k)o(ey)e(sequences)j +(output)e(b)o(y)g(the)g(terminal's)555 1033 y(function)13 b(k)o(eys.)18 b(The)13 b(w)o(ord)e(on)h(the)g(righ)o(t)g(side)g(of)g -(the)g(`)p Ft(=)p Fu(')f(is)h(tested)g(against)555 613 +(the)g(`)p Ft(=)p Fu(')f(is)h(tested)g(against)555 1088 y(b)q(oth)j(the)g(full)i(name)e(of)f(the)h(terminal)h(and)f(the)g(p)q -(ortion)h(of)e(the)h(terminal)555 667 y(name)i(b)q(efore)g(the)g +(ortion)h(of)e(the)h(terminal)555 1142 y(name)i(b)q(efore)g(the)g (\014rst)f(`)p Ft(-)p Fu('.)24 b(This)17 b(allo)o(ws)g Ft(sun)f Fu(to)g(matc)o(h)h(b)q(oth)f Ft(sun)h Fu(and)555 -722 y Ft(sun-cmd)p Fu(,)d(for)g(instance.)315 802 y Ft(application)555 -857 y Fu(The)d Fk(application)i Fu(construct)e(is)g(used)h(to)e -(include)j(application-sp)q(eci)q(\014c)h(set-)555 912 -y(tings.)19 b(Eac)o(h)12 b(program)f(using)j(the)e(Readline)i(library)f -(sets)f(the)g Fk(application)555 966 y(name)p Fu(,)g(and)g(y)o(ou)f -(can)h(test)f(for)g(a)g(particular)h(v)m(alue.)20 b(This)12 -b(could)h(b)q(e)f(used)h(to)555 1021 y(bind)18 b(k)o(ey)e(sequences)i -(to)d(functions)j(useful)f(for)f(a)g(sp)q(eci\014c)i(program.)23 -b(F)l(or)555 1076 y(instance,)17 b(the)g(follo)o(wing)g(command)g(adds) -f(a)g(k)o(ey)h(sequence)g(that)f(quotes)555 1131 y(the)f(curren)o(t)g -(or)g(previous)h(w)o(ord)e(in)j(Bash:)675 1195 y Ft($if)23 -b(Bash)675 1247 y(#)h(Quote)f(the)g(current)g(or)h(previous)f(word)675 -1299 y("\\C-xq":)g("\\eb\\"\\ef\\"")675 1351 y($endif)75 -1430 y($endif)96 b Fu(This)16 b(command,)e(as)h(seen)h(in)g(the)f -(previous)h(example,)g(terminates)f(an)g Ft($if)f Fu(command.)75 -1510 y Ft($else)120 b Fu(Commands)15 b(in)h(this)f(branc)o(h)h(of)e -(the)i Ft($if)e Fu(directiv)o(e)j(are)e(executed)h(if)g(the)f(test)g -(fails.)75 1590 y Ft($include)48 b Fu(This)22 b(directiv)o(e)h(tak)o -(es)e(a)h(single)h(\014lename)g(as)e(an)h(argumen)o(t)f(and)h(reads)f -(commands)315 1645 y(and)e(bindings)j(from)c(that)h(\014le.)33 +1197 y Ft(sun-cmd)p Fu(,)d(for)g(instance.)315 1277 y +Ft(application)555 1332 y Fu(The)d Fk(application)i Fu(construct)e(is)g +(used)h(to)e(include)j(application-sp)q(eci)q(\014c)h(set-)555 +1386 y(tings.)19 b(Eac)o(h)12 b(program)f(using)j(the)e(Readline)i +(library)f(sets)f(the)g Fk(application)555 1441 y(name)p +Fu(,)g(and)g(y)o(ou)f(can)h(test)f(for)g(a)g(particular)h(v)m(alue.)20 +b(This)12 b(could)h(b)q(e)f(used)h(to)555 1496 y(bind)18 +b(k)o(ey)e(sequences)i(to)d(functions)j(useful)f(for)f(a)g(sp)q +(eci\014c)i(program.)23 b(F)l(or)555 1551 y(instance,)17 +b(the)g(follo)o(wing)g(command)g(adds)f(a)g(k)o(ey)h(sequence)g(that)f +(quotes)555 1606 y(the)f(curren)o(t)g(or)g(previous)h(w)o(ord)e(in)j +(Bash:)675 1670 y Ft($if)23 b(Bash)675 1722 y(#)h(Quote)f(the)g +(current)g(or)h(previous)f(word)675 1774 y("\\C-xq":)g +("\\eb\\"\\ef\\"")675 1826 y($endif)75 1905 y($endif)96 +b Fu(This)16 b(command,)e(as)h(seen)h(in)g(the)f(previous)h(example,)g +(terminates)f(an)g Ft($if)f Fu(command.)75 1985 y Ft($else)120 +b Fu(Commands)15 b(in)h(this)f(branc)o(h)h(of)e(the)i +Ft($if)e Fu(directiv)o(e)j(are)e(executed)h(if)g(the)f(test)g(fails.)75 +2065 y Ft($include)48 b Fu(This)22 b(directiv)o(e)h(tak)o(es)e(a)h +(single)h(\014lename)g(as)e(an)h(argumen)o(t)f(and)h(reads)f(commands) +315 2120 y(and)e(bindings)j(from)c(that)h(\014le.)33 b(F)l(or)19 b(example,)i(the)e(follo)o(wing)h(directiv)o(e)h(reads)e -(from)315 1699 y(`)p Ft(/etc/inputrc)p Fu(':)435 1764 -y Ft($include)k(/etc/inputrc)75 1876 y Fj(1.3.3)30 b(Sample)20 -b(Init)h(File)137 1972 y Fu(Here)16 b(is)g(an)f(example)h(of)f(an)g +(from)315 2174 y(`)p Ft(/etc/inputrc)p Fu(':)435 2239 +y Ft($include)k(/etc/inputrc)75 2351 y Fj(1.3.3)30 b(Sample)20 +b(Init)h(File)137 2447 y Fu(Here)16 b(is)g(an)f(example)h(of)f(an)g Fk(inputrc)k Fu(\014le.)i(This)16 b(illustrates)g(k)o(ey)f(binding,)i -(v)m(ariable)f(assignmen)o(t,)75 2027 y(and)f(conditional)i(syn)o(tax.) +(v)m(ariable)f(assignmen)o(t,)75 2502 y(and)f(conditional)i(syn)o(tax.) p eop %%Page: 10 12 10 11 bop 75 -58 a Fu(10)1299 b(GNU)15 b(Readline)h(Library)195 201 y Ft(#)24 b(This)f(file)g(controls)g(the)h(behaviour)e(of)i(line)f -(input)g(editing)g(for)195 253 y(#)h(programs)e(that)i(use)f(the)h(Gnu) -f(Readline)g(library.)47 b(Existing)22 b(programs)195 -305 y(#)i(include)f(FTP,)g(Bash,)g(and)h(Gdb.)195 357 -y(#)195 409 y(#)g(You)f(can)h(re-read)f(the)g(inputrc)g(file)g(with)h -(C-x)f(C-r.)195 461 y(#)h(Lines)f(beginning)g(with)g('#')g(are)h -(comments.)195 513 y(#)195 565 y(#)g(First,)f(include)g(any)g -(systemwide)g(bindings)f(and)i(variable)f(assignments)f(from)195 -616 y(#)i(/etc/Inputrc)195 668 y($include)f(/etc/Inputrc)195 -772 y(#)195 824 y(#)h(Set)f(various)g(bindings)g(for)g(emacs)g(mode.) -195 928 y(set)g(editing-mode)g(emacs)195 1032 y($if)g(mode=emacs)195 +(input)g(editing)g(for)195 253 y(#)h(programs)e(that)i(use)f(the)h(GNU) +f(Readline)g(library.)47 b(Existing)195 305 y(#)24 b(programs)e +(include)h(FTP,)h(Bash,)f(and)g(GDB.)195 357 y(#)195 +409 y(#)h(You)f(can)h(re-read)f(the)g(inputrc)g(file)g(with)h(C-x)f +(C-r.)195 461 y(#)h(Lines)f(beginning)g(with)g('#')g(are)h(comments.) +195 513 y(#)195 565 y(#)g(First,)f(include)g(any)g(systemwide)g +(bindings)f(and)i(variable)195 616 y(#)g(assignments)e(from)h +(/etc/Inputrc)195 668 y($include)g(/etc/Inputrc)195 772 +y(#)195 824 y(#)h(Set)f(various)g(bindings)g(for)g(emacs)g(mode.)195 +928 y(set)g(editing-mode)g(emacs)195 1032 y($if)g(mode=emacs)195 1135 y(Meta-Control-h:)46 b(backward-kill-word)21 b(Text)i(after)h(the) f(function)g(name)g(is)h(ignored)p 1986 1145 21 38 v 195 1239 a(#)195 1291 y(#)g(Arrow)f(keys)g(in)h(keypad)f(mode)195 @@ -1848,407 +1862,442 @@ b(11)195 201 y Ft(C-q:)23 b(quoted-insert)195 305 y($endif)195 (are)h(convenient)e(for)h(shell)h(interaction)195 616 y($if)f(Bash)195 668 y(#)h(edit)f(the)g(path)195 720 y("\\C-xp":)g("PATH=${PATH}\\e\\C-e\\C-a\\)o(ef\\C-f")195 -772 y(#)h(prepare)f(to)g(type)h(a)f(quoted)g(word)h(--)f(insert)g(open) -h(and)f(close)g(double)g(quotes)195 824 y(#)h(and)f(move)g(to)h(just)f -(after)h(the)f(open)g(quote)195 876 y("\\C-x\\"":)g("\\"\\"\\C-b")195 -928 y(#)h(insert)f(a)g(backslash)g(\(testing)g(backslash)g(escapes)f -(in)i(sequences)f(and)g(macros\))195 980 y("\\C-x\\\\":)g("\\\\")195 -1032 y(#)h(Quote)f(the)g(current)g(or)h(previous)f(word)195 -1083 y("\\C-xq":)g("\\eb\\"\\ef\\"")195 1135 y(#)h(Add)f(a)h(binding)f -(to)g(refresh)g(the)h(line,)f(which)g(is)h(unbound)195 -1187 y("\\C-xr":)f(redraw-current-line)195 1239 y(#)h(Edit)f(variable)g -(on)g(current)g(line.)195 1291 y("\\M-\\C-v":)f -("\\C-a\\C-k$\\C-y\\M-\\C-e\\C-a\\C-y=)o(")195 1343 y($endif)195 -1447 y(#)i(use)f(a)h(visible)f(bell)g(if)h(one)f(is)h(available)195 -1499 y(set)f(bell-style)g(visible)195 1602 y(#)h(don't)f(strip)g -(characters)g(to)g(7)h(bits)f(when)h(reading)195 1654 -y(set)f(input-meta)g(on)195 1758 y(#)h(allow)f(iso-latin1)f(characters) -h(to)g(be)h(inserted)f(rather)g(than)g(converted)g(to)195 -1810 y(#)h(prefix-meta)e(sequences)195 1862 y(set)h(convert-meta)g(off) -195 1966 y(#)h(display)f(characters)f(with)h(the)h(eighth)f(bit)g(set)h -(directly)f(rather)g(than)195 2017 y(#)h(as)f(meta-prefixed)f -(characters)195 2069 y(set)h(output-meta)g(on)195 2173 -y(#)h(if)f(there)g(are)h(more)f(than)h(150)f(possible)g(completions)f -(for)i(a)f(word,)h(ask)f(the)195 2225 y(#)h(user)f(if)h(he)f(wants)g -(to)h(see)f(all)h(of)f(them)195 2277 y(set)g(completion-query-items)e -(150)195 2381 y(#)j(For)f(FTP)195 2433 y($if)g(Ftp)195 -2484 y("\\C-xg":)g("get)g(\\M-?")195 2536 y("\\C-xt":)g("put)g(\\M-?") -195 2588 y("\\M-.":)g(yank-last-arg)195 2640 y($endif)p -eop +772 y(#)h(prepare)f(to)g(type)h(a)f(quoted)g(word)h(--)195 +824 y(#)g(insert)f(open)g(and)h(close)f(double)g(quotes)195 +876 y(#)h(and)f(move)g(to)h(just)f(after)h(the)f(open)g(quote)195 +928 y("\\C-x\\"":)g("\\"\\"\\C-b")195 980 y(#)h(insert)f(a)g(backslash) +g(\(testing)g(backslash)g(escapes)195 1032 y(#)h(in)f(sequences)g(and)g +(macros\))195 1083 y("\\C-x\\\\":)g("\\\\")195 1135 y(#)h(Quote)f(the)g +(current)g(or)h(previous)f(word)195 1187 y("\\C-xq":)g +("\\eb\\"\\ef\\"")195 1239 y(#)h(Add)f(a)h(binding)f(to)g(refresh)g +(the)h(line,)f(which)g(is)h(unbound)195 1291 y("\\C-xr":)f +(redraw-current-line)195 1343 y(#)h(Edit)f(variable)g(on)g(current)g +(line.)195 1395 y("\\M-\\C-v":)f("\\C-a\\C-k$\\C-y\\M-\\C-e\\C-a\\C-y=) +o(")195 1447 y($endif)195 1550 y(#)i(use)f(a)h(visible)f(bell)g(if)h +(one)f(is)h(available)195 1602 y(set)f(bell-style)g(visible)195 +1706 y(#)h(don't)f(strip)g(characters)g(to)g(7)h(bits)f(when)h(reading) +195 1758 y(set)f(input-meta)g(on)195 1862 y(#)h(allow)f(iso-latin1)f +(characters)h(to)g(be)h(inserted)f(rather)195 1914 y(#)h(than)f +(converted)g(to)g(prefix-meta)g(sequences)195 1966 y(set)g +(convert-meta)g(off)195 2069 y(#)h(display)f(characters)f(with)h(the)h +(eighth)f(bit)g(set)h(directly)195 2121 y(#)g(rather)f(than)g(as)h +(meta-prefixed)e(characters)195 2173 y(set)h(output-meta)g(on)195 +2277 y(#)h(if)f(there)g(are)h(more)f(than)h(150)f(possible)g +(completions)f(for)195 2329 y(#)i(a)f(word,)h(ask)f(the)h(user)f(if)g +(he)h(wants)f(to)h(see)f(all)h(of)f(them)195 2381 y(set)g +(completion-query-items)e(150)195 2484 y(#)j(For)f(FTP)195 +2536 y($if)g(Ftp)195 2588 y("\\C-xg":)g("get)g(\\M-?")195 +2640 y("\\C-xt":)g("put)g(\\M-?")p eop %%Page: 12 14 -12 13 bop 75 -58 a Fu(12)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fs(1.4)33 b(Bindable)24 b(Readline)f(Commands)137 -247 y Fu(This)17 b(section)f(describ)q(es)h(Readline)g(commands)f(that) +12 13 bop 75 -58 a Fu(12)1299 b(GNU)15 b(Readline)h(Library)195 +149 y Ft("\\M-.":)23 b(yank-last-arg)195 201 y($endif)75 +329 y Fs(1.4)33 b(Bindable)24 b(Readline)f(Commands)137 +425 y Fu(This)17 b(section)f(describ)q(es)h(Readline)g(commands)f(that) e(ma)o(y)h(b)q(e)i(b)q(ound)f(to)f(k)o(ey)h(sequences.)22 -b(Com-)75 301 y(mand)15 b(names)g(without)h(an)f(accompan)o(ying)g(k)o +b(Com-)75 480 y(mand)15 b(names)g(without)h(an)f(accompan)o(ying)g(k)o (ey)g(sequence)i(are)e(un)o(b)q(ound)h(b)o(y)f(default.)137 -369 y(In)f(the)f(follo)o(wing)h(descriptions,)h Fk(p)q(oin)o(t)f +547 y(In)f(the)f(follo)o(wing)h(descriptions,)h Fk(p)q(oin)o(t)f Fu(refers)f(to)g(the)g(curren)o(t)g(cursor)f(p)q(osition,)j(and)e -Fk(mark)i Fu(refers)75 424 y(to)k(a)g(cursor)g(p)q(osition)h(sa)o(v)o +Fk(mark)i Fu(refers)75 601 y(to)k(a)g(cursor)g(p)q(osition)h(sa)o(v)o (ed)f(b)o(y)h(the)f Ft(set-mark)g Fu(command.)32 b(The)20 b(text)f(b)q(et)o(w)o(een)g(the)h(p)q(oin)o(t)g(and)75 -479 y(mark)15 b(is)g(referred)h(to)e(as)h(the)g Fk(region)p -Fu(.)75 593 y Fj(1.4.1)30 b(Commands)21 b(F)-5 b(or)19 -b(Mo)n(ving)75 716 y Ft(beginning-of-line)13 b(\(C-a\))315 -771 y Fu(Mo)o(v)o(e)h(to)h(the)g(start)f(of)h(the)g(curren)o(t)g(line.) -75 864 y Ft(end-of-line)f(\(C-e\))315 919 y Fu(Mo)o(v)o(e)g(to)h(the)g -(end)h(of)f(the)g(line.)75 1012 y Ft(forward-char)f(\(C-f\))315 -1067 y Fu(Mo)o(v)o(e)g(forw)o(ard)g(a)h(c)o(haracter.)75 -1160 y Ft(backward-char)e(\(C-b\))315 1215 y Fu(Mo)o(v)o(e)h(bac)o(k)h -(a)g(c)o(haracter.)75 1309 y Ft(forward-word)f(\(M-f\))315 -1363 y Fu(Mo)o(v)o(e)g(forw)o(ard)g(to)g(the)i(end)g(of)e(the)h(next)h +656 y(mark)15 b(is)g(referred)h(to)e(as)h(the)g Fk(region)p +Fu(.)75 767 y Fj(1.4.1)30 b(Commands)21 b(F)-5 b(or)19 +b(Mo)n(ving)75 888 y Ft(beginning-of-line)13 b(\(C-a\))315 +942 y Fu(Mo)o(v)o(e)h(to)h(the)g(start)f(of)h(the)g(curren)o(t)g(line.) +75 1034 y Ft(end-of-line)f(\(C-e\))315 1088 y Fu(Mo)o(v)o(e)g(to)h(the) +g(end)h(of)f(the)g(line.)75 1179 y Ft(forward-char)f(\(C-f\))315 +1234 y Fu(Mo)o(v)o(e)g(forw)o(ard)g(a)h(c)o(haracter.)75 +1325 y Ft(backward-char)e(\(C-b\))315 1380 y Fu(Mo)o(v)o(e)h(bac)o(k)h +(a)g(c)o(haracter.)75 1471 y Ft(forward-word)f(\(M-f\))315 +1526 y Fu(Mo)o(v)o(e)g(forw)o(ard)g(to)g(the)i(end)g(of)e(the)h(next)h (w)o(ord.)j(W)l(ords)c(are)f(comp)q(osed)i(of)f(letters)g(and)315 -1418 y(digits.)75 1512 y Ft(backward-word)e(\(M-b\))315 -1566 y Fu(Mo)o(v)o(e)j(bac)o(k)g(to)h(the)f(start)g(of)g(the)h(curren)o +1581 y(digits.)75 1672 y Ft(backward-word)e(\(M-b\))315 +1727 y Fu(Mo)o(v)o(e)j(bac)o(k)g(to)h(the)f(start)g(of)g(the)h(curren)o (t)g(or)f(previous)i(w)o(ord.)24 b(W)l(ords)16 b(are)h(comp)q(osed)315 -1621 y(of)e(letters)g(and)g(digits.)75 1715 y Ft(clear-screen)f -(\(C-l\))315 1769 y Fu(Clear)f(the)h(screen)g(and)f(redra)o(w)g(the)g +1782 y(of)e(letters)g(and)g(digits.)75 1873 y Ft(clear-screen)f +(\(C-l\))315 1928 y Fu(Clear)f(the)h(screen)g(and)f(redra)o(w)g(the)g (curren)o(t)g(line,)i(lea)o(ving)g(the)e(curren)o(t)g(line)i(at)e(the)g -(top)315 1824 y(of)i(the)g(screen.)75 1918 y Ft(redraw-current-line)e -(\(\))315 1972 y Fu(Refresh)i(the)g(curren)o(t)g(line.)22 -b(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 2086 +(top)315 1982 y(of)i(the)g(screen.)75 2074 y Ft(redraw-current-line)e +(\(\))315 2128 y Fu(Refresh)i(the)g(curren)o(t)g(line.)22 +b(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 2239 y Fj(1.4.2)30 b(Commands)21 b(F)-5 b(or)19 b(Manipulating)i(The)f -(History)75 2209 y Ft(accept-line)14 b(\(Newline)g(or)h(Return\))315 -2264 y Fu(Accept)j(the)g(line)h(regardless)f(of)f(where)h(the)g(cursor) +(History)75 2360 y Ft(accept-line)14 b(\(Newline)g(or)h(Return\))315 +2414 y Fu(Accept)j(the)g(line)h(regardless)f(of)f(where)h(the)g(cursor) f(is.)27 b(If)18 b(this)g(line)h(is)g(non-empt)o(y)l(,)f(it)315 -2319 y(ma)o(y)d(b)q(e)i(added)f(to)g(the)g(history)g(list)g(for)g +2469 y(ma)o(y)d(b)q(e)i(added)f(to)g(the)g(history)g(list)g(for)g (future)g(recall)h(with)f Ft(add_history\(\))p Fu(.)k(If)d(this)315 -2374 y(line)g(is)f(a)e(mo)q(di\014ed)j(history)e(line,)i(the)e(history) +2524 y(line)g(is)f(a)e(mo)q(di\014ed)j(history)e(line,)i(the)e(history) g(line)i(is)f(restored)e(to)h(its)g(original)i(state.)75 -2467 y Ft(previous-history)c(\(C-p\))315 2522 y Fu(Mo)o(v)o(e)h(`bac)o +2615 y Ft(previous-history)c(\(C-p\))315 2670 y Fu(Mo)o(v)o(e)h(`bac)o (k')h(through)f(the)i(history)f(list,)g(fetc)o(hing)h(the)f(previous)h -(command.)75 2615 y Ft(next-history)e(\(C-n\))315 2670 -y Fu(Mo)o(v)o(e)g(`forw)o(ard')f(through)i(the)h(history)f(list,)g -(fetc)o(hing)h(the)f(next)h(command.)p eop +(command.)p eop %%Page: 13 15 13 14 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(13)75 149 y Ft(beginning-of-history)12 b(\(M-<\))315 -204 y Fu(Mo)o(v)o(e)i(to)h(the)g(\014rst)g(line)i(in)f(the)f(history)l -(.)75 307 y Ft(end-of-history)e(\(M->\))315 362 y Fu(Mo)o(v)o(e)h(to)h -(the)g(end)h(of)f(the)g(input)h(history)l(,)f(i.e.,)g(the)g(line)i -(curren)o(tly)f(b)q(eing)g(en)o(tered.)75 466 y Ft -(reverse-search-history)c(\(C-r\))315 520 y Fu(Searc)o(h)k(bac)o(kw)o -(ard)e(starting)h(at)g(the)h(curren)o(t)f(line)j(and)d(mo)o(ving)h -(`up')f(through)g(the)h(his-)315 575 y(tory)e(as)h(necessary)l(.)20 -b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 678 -y Ft(forward-search-history)c(\(C-s\))315 733 y Fu(Searc)o(h)j(forw)o +b(13)75 149 y Ft(next-history)14 b(\(C-n\))315 204 y +Fu(Mo)o(v)o(e)g(`forw)o(ard')f(through)i(the)h(history)f(list,)g(fetc)o +(hing)h(the)f(next)h(command.)75 307 y Ft(beginning-of-history)c +(\(M-<\))315 362 y Fu(Mo)o(v)o(e)i(to)h(the)g(\014rst)g(line)i(in)f +(the)f(history)l(.)75 465 y Ft(end-of-history)e(\(M->\))315 +520 y Fu(Mo)o(v)o(e)h(to)h(the)g(end)h(of)f(the)g(input)h(history)l(,)f +(i.e.,)g(the)g(line)i(curren)o(tly)f(b)q(eing)g(en)o(tered.)75 +624 y Ft(reverse-search-history)c(\(C-r\))315 678 y Fu(Searc)o(h)k(bac) +o(kw)o(ard)e(starting)h(at)g(the)h(curren)o(t)f(line)j(and)d(mo)o(ving) +h(`up')f(through)g(the)h(his-)315 733 y(tory)e(as)h(necessary)l(.)20 +b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 836 +y Ft(forward-search-history)c(\(C-s\))315 891 y Fu(Searc)o(h)j(forw)o (ard)e(starting)h(at)h(the)f(curren)o(t)h(line)h(and)f(mo)o(ving)g(`do) -o(wn')f(through)g(the)h(the)315 788 y(history)g(as)g(necessary)l(.)20 -b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 891 +o(wn')f(through)g(the)h(the)315 946 y(history)g(as)g(necessary)l(.)20 +b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 1049 y Ft(non-incremental-reverse-se)o(arch-hi)o(story)c(\(M-p\))315 -946 y Fu(Searc)o(h)k(bac)o(kw)o(ard)e(starting)h(at)g(the)h(curren)o(t) -f(line)j(and)d(mo)o(ving)h(`up')f(through)g(the)h(his-)315 -1001 y(tory)h(as)h(necessary)g(using)h(a)e(non-incremen)o(tal)j(searc)o -(h)e(for)f(a)h(string)g(supplied)i(b)o(y)e(the)315 1056 -y(user.)75 1159 y Ft(non-incremental-forward-se)o(arch-hi)o(story)12 -b(\(M-n\))315 1214 y Fu(Searc)o(h)j(forw)o(ard)e(starting)h(at)h(the)f +1104 y Fu(Searc)o(h)k(bac)o(kw)o(ard)e(starting)h(at)g(the)h(curren)o +(t)f(line)j(and)d(mo)o(ving)h(`up')f(through)g(the)h(his-)315 +1159 y(tory)h(as)h(necessary)g(using)h(a)e(non-incremen)o(tal)j(searc)o +(h)e(for)f(a)h(string)g(supplied)i(b)o(y)e(the)315 1214 +y(user.)75 1317 y Ft(non-incremental-forward-se)o(arch-hi)o(story)12 +b(\(M-n\))315 1372 y Fu(Searc)o(h)j(forw)o(ard)e(starting)h(at)h(the)f (curren)o(t)h(line)h(and)f(mo)o(ving)g(`do)o(wn')f(through)g(the)h(the) -315 1268 y(history)e(as)g(necessary)h(using)g(a)f(non-incremen)o(tal)i +315 1426 y(history)e(as)g(necessary)h(using)g(a)f(non-incremen)o(tal)i (searc)o(h)e(for)g(a)g(string)g(supplied)j(b)o(y)d(the)315 -1323 y(user.)75 1427 y Ft(history-search-forward)f(\(\))315 -1481 y Fu(Searc)o(h)21 b(forw)o(ard)e(through)i(the)f(history)h(for)f +1481 y(user.)75 1584 y Ft(history-search-forward)f(\(\))315 +1639 y Fu(Searc)o(h)21 b(forw)o(ard)e(through)i(the)f(history)h(for)f (the)h(string)g(of)f(c)o(haracters)g(b)q(et)o(w)o(een)h(the)315 -1536 y(start)16 b(of)h(the)h(curren)o(t)g(line)h(and)e(the)h(p)q(oin)o +1694 y(start)16 b(of)h(the)h(curren)o(t)g(line)h(and)e(the)h(p)q(oin)o (t.)28 b(This)18 b(is)g(a)f(non-incremen)o(tal)i(searc)o(h.)27 -b(By)315 1591 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 -1694 y Ft(history-search-backward)c(\(\))315 1749 y Fu(Searc)o(h)18 +b(By)315 1749 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 +1852 y Ft(history-search-backward)c(\(\))315 1907 y Fu(Searc)o(h)18 b(bac)o(kw)o(ard)e(through)h(the)h(history)f(for)g(the)g(string)h(of)f -(c)o(haracters)f(b)q(et)o(w)o(een)i(the)315 1804 y(start)e(of)h(the)h +(c)o(haracters)f(b)q(et)o(w)o(een)i(the)315 1962 y(start)e(of)h(the)h (curren)o(t)g(line)h(and)e(the)h(p)q(oin)o(t.)28 b(This)18 b(is)g(a)f(non-incremen)o(tal)i(searc)o(h.)27 b(By)315 -1859 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 -1962 y Ft(yank-nth-arg)e(\(M-C-y\))315 2017 y Fu(Insert)f(the)g +2016 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 +2120 y Ft(yank-nth-arg)e(\(M-C-y\))315 2174 y Fu(Insert)f(the)g (\014rst)g(argumen)o(t)f(to)g(the)i(previous)f(command)g(\(usually)h -(the)f(second)h(w)o(ord)e(on)315 2071 y(the)j(previous)h(line\))g(at)e +(the)f(second)h(w)o(ord)e(on)315 2229 y(the)j(previous)h(line\))g(at)e (p)q(oin)o(t.)21 b(With)15 b(an)g(argumen)o(t)f Fk(n)p Fu(,)h(insert)g(the)g Fk(n)p Fu(th)g(w)o(ord)g(from)f(the)315 -2126 y(previous)g(command)g(\(the)f(w)o(ords)f(in)j(the)e(previous)i +2284 y(previous)g(command)g(\(the)f(w)o(ords)f(in)j(the)e(previous)i (command)e(b)q(egin)i(with)e(w)o(ord)g(0\).)19 b(A)315 -2181 y(negativ)o(e)13 b(argumen)o(t)f(inserts)h(the)g +2339 y(negativ)o(e)13 b(argumen)o(t)f(inserts)h(the)g Fk(n)p Fu(th)g(w)o(ord)f(from)g(the)h(end)h(of)e(the)h(previous)g -(command.)75 2284 y Ft(yank-last-arg)g(\(M-.)i(or)g(M-_\))315 -2339 y Fu(Insert)j(last)f(argumen)o(t)g(to)g(the)g(previous)i(command)e -(\(the)g(last)h(w)o(ord)f(of)g(the)g(previous)315 2394 +(command.)75 2442 y Ft(yank-last-arg)g(\(M-.)i(or)g(M-_\))315 +2497 y Fu(Insert)j(last)f(argumen)o(t)g(to)g(the)g(previous)i(command)e +(\(the)g(last)h(w)o(ord)f(of)g(the)g(previous)315 2552 y(history)e(en)o(try\).)20 b(With)15 b(an)g(argumen)o(t,)g(b)q(eha)o(v) o(e)g(exactly)h(lik)o(e)g Ft(yank-nth-arg)p Fu(.)j(Succes-)315 -2449 y(siv)o(e)f(calls)g(to)f Ft(yank-last-arg)e Fu(mo)o(v)o(e)i(bac)o +2606 y(siv)o(e)f(calls)g(to)f Ft(yank-last-arg)e Fu(mo)o(v)o(e)i(bac)o (k)g(through)g(the)g(history)g(list,)i(inserting)f(the)315 -2503 y(last)d(argumen)o(t)g(of)f(eac)o(h)i(line)g(in)g(turn.)75 -2630 y Fj(1.4.3)30 b(Commands)21 b(F)-5 b(or)19 b(Changing)i(T)-5 -b(ext)p eop +2661 y(last)d(argumen)o(t)g(of)f(eac)o(h)i(line)g(in)g(turn.)p +eop %%Page: 14 16 14 15 bop 75 -58 a Fu(14)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Ft(delete-char)e(\(C-d\))315 204 y Fu(Delete)20 -b(the)g(c)o(haracter)e(at)h(p)q(oin)o(t.)33 b(If)20 b(p)q(oin)o(t)g(is) -g(at)e(the)i(b)q(eginning)i(of)d(the)g(line,)j(there)315 -259 y(are)c(no)h(c)o(haracters)e(in)j(the)e(line,)j(and)e(the)f(last)h -(c)o(haracter)e(t)o(yp)q(ed)i(w)o(as)f(not)g(b)q(ound)i(to)315 -314 y Ft(delete-char)p Fu(,)13 b(then)j(return)f Fp(eof)p -Fu(.)75 401 y Ft(backward-delete-char)d(\(Rubout\))315 -456 y Fu(Delete)k(the)f(c)o(haracter)f(b)q(ehind)j(the)f(cursor.)j(A)c +149 y Fj(1.4.3)30 b(Commands)21 b(F)-5 b(or)19 b(Changing)i(T)-5 +b(ext)75 286 y Ft(delete-char)14 b(\(C-d\))315 341 y +Fu(Delete)20 b(the)g(c)o(haracter)e(at)h(p)q(oin)o(t.)33 +b(If)20 b(p)q(oin)o(t)g(is)g(at)e(the)i(b)q(eginning)i(of)d(the)g +(line,)j(there)315 396 y(are)c(no)h(c)o(haracters)e(in)j(the)e(line,)j +(and)e(the)f(last)h(c)o(haracter)e(t)o(yp)q(ed)i(w)o(as)f(not)g(b)q +(ound)i(to)315 450 y Ft(delete-char)p Fu(,)13 b(then)j(return)f +Fp(eof)p Fu(.)75 552 y Ft(backward-delete-char)d(\(Rubout\))315 +607 y Fu(Delete)k(the)f(c)o(haracter)f(b)q(ehind)j(the)f(cursor.)j(A)c (n)o(umeric)h(argumen)o(t)e(means)i(to)e(kill)j(the)315 -511 y(c)o(haracters)d(instead)i(of)f(deleting)i(them.)75 -598 y Ft(forward-backward-delete-ch)o(ar)12 b(\(\))315 -653 y Fu(Delete)20 b(the)f(c)o(haracter)f(under)i(the)f(cursor,)h +661 y(c)o(haracters)d(instead)i(of)f(deleting)i(them.)75 +763 y Ft(forward-backward-delete-ch)o(ar)12 b(\(\))315 +818 y Fu(Delete)20 b(the)f(c)o(haracter)f(under)i(the)f(cursor,)h (unless)g(the)f(cursor)g(is)h(at)e(the)h(end)h(of)f(the)315 -707 y(line,)e(in)g(whic)o(h)g(case)e(the)h(c)o(haracter)g(b)q(ehind)h +872 y(line,)e(in)g(whic)o(h)g(case)e(the)h(c)o(haracter)g(b)q(ehind)h (the)f(cursor)g(is)g(deleted.)23 b(By)16 b(default,)h(this)315 -762 y(is)f(not)f(b)q(ound)h(to)e(a)h(k)o(ey)l(.)75 850 -y Ft(quoted-insert)e(\(C-q)i(or)g(C-v\))315 904 y Fu(Add)j(the)f(next)g -(c)o(haracter)g(t)o(yp)q(ed)g(to)f(the)i(line)g(v)o(erbatim.)26 -b(This)18 b(is)f(ho)o(w)g(to)g(insert)g(k)o(ey)315 959 +927 y(is)f(not)f(b)q(ound)h(to)e(a)h(k)o(ey)l(.)75 1029 +y Ft(quoted-insert)e(\(C-q)i(or)g(C-v\))315 1083 y Fu(Add)j(the)f(next) +g(c)o(haracter)g(t)o(yp)q(ed)g(to)f(the)i(line)g(v)o(erbatim.)26 +b(This)18 b(is)f(ho)o(w)g(to)g(insert)g(k)o(ey)315 1138 y(sequences)f(lik)o(e)h Fo(C-q)p Fu(,)d(for)h(example.)75 -1046 y Ft(tab-insert)f(\(M-)401 1044 y Fn(h)p 412 1018 -74 2 v 412 1046 a Fm(T)m(AB)p 412 1054 V 484 1044 a Fn(i)499 -1046 y Ft(\))315 1101 y Fu(Insert)h(a)g(tab)g(c)o(haracter.)75 -1188 y Ft(self-insert)f(\(a,)g(b,)h(A,)g(1,)g(!,)g(...)o(\))315 -1243 y Fu(Insert)g(y)o(ourself.)75 1330 y Ft(transpose-chars)e(\(C-t\)) -315 1385 y Fu(Drag)i(the)h(c)o(haracter)f(b)q(efore)h(the)h(cursor)e +1240 y Ft(tab-insert)f(\(M-)401 1238 y Fn(h)p 412 1212 +74 2 v 412 1240 a Fm(T)m(AB)p 412 1247 V 484 1238 a Fn(i)499 +1240 y Ft(\))315 1294 y Fu(Insert)h(a)g(tab)g(c)o(haracter.)75 +1396 y Ft(self-insert)f(\(a,)g(b,)h(A,)g(1,)g(!,)g(...)o(\))315 +1451 y Fu(Insert)g(y)o(ourself.)75 1552 y Ft(transpose-chars)e(\(C-t\)) +315 1607 y Fu(Drag)i(the)h(c)o(haracter)f(b)q(efore)h(the)h(cursor)e (forw)o(ard)g(o)o(v)o(er)g(the)h(c)o(haracter)f(at)h(the)g(cursor,)315 -1440 y(mo)o(ving)i(the)f(cursor)h(forw)o(ard)e(as)i(w)o(ell.)28 +1662 y(mo)o(ving)i(the)f(cursor)h(forw)o(ard)e(as)i(w)o(ell.)28 b(If)18 b(the)g(insertion)h(p)q(oin)o(t)f(is)g(at)f(the)h(end)h(of)e -(the)315 1495 y(line,)c(then)e(this)h(transp)q(oses)e(the)h(last)g(t)o +(the)315 1716 y(line,)c(then)e(this)h(transp)q(oses)e(the)h(last)g(t)o (w)o(o)f(c)o(haracters)g(of)h(the)g(line.)20 b(Negativ)o(e)11 -b(argumen)o(ts)315 1550 y(ha)o(v)o(e)k(no)g(e\013ect.)75 -1637 y Ft(transpose-words)e(\(M-t\))315 1692 y Fu(Drag)i(the)h(w)o(ord) +b(argumen)o(ts)315 1771 y(ha)o(v)o(e)k(no)g(e\013ect.)75 +1873 y Ft(transpose-words)e(\(M-t\))315 1927 y Fu(Drag)i(the)h(w)o(ord) g(b)q(efore)g(p)q(oin)o(t)h(past)f(the)g(w)o(ord)f(after)h(p)q(oin)o -(t,)g(mo)o(ving)g(p)q(oin)o(t)h(past)f(that)315 1746 +(t,)g(mo)o(ving)g(p)q(oin)o(t)h(past)f(that)315 1982 y(w)o(ord)d(as)h(w)o(ell.)21 b(If)14 b(the)g(insertion)i(p)q(oin)o(t)e (is)h(at)f(the)g(end)h(of)e(the)i(line,)g(this)g(transp)q(oses)f(the) -315 1801 y(last)h(t)o(w)o(o)f(w)o(ords)g(on)i(the)f(line.)75 -1888 y Ft(upcase-word)f(\(M-u\))315 1943 y Fu(Upp)q(ercase)j(the)f +315 2037 y(last)h(t)o(w)o(o)f(w)o(ords)g(on)i(the)f(line.)75 +2138 y Ft(upcase-word)f(\(M-u\))315 2193 y Fu(Upp)q(ercase)j(the)f (curren)o(t)g(\(or)f(follo)o(wing\))h(w)o(ord.)22 b(With)16 -b(a)g(negativ)o(e)g(argumen)o(t,)f(upp)q(er-)315 1998 +b(a)g(negativ)o(e)g(argumen)o(t,)f(upp)q(er-)315 2248 y(case)g(the)g(previous)h(w)o(ord,)f(but)g(do)g(not)g(mo)o(v)o(e)f(the) -i(cursor.)75 2085 y Ft(downcase-word)d(\(M-l\))315 2140 +i(cursor.)75 2349 y Ft(downcase-word)d(\(M-l\))315 2404 y Fu(Lo)o(w)o(ercase)d(the)h(curren)o(t)g(\(or)f(follo)o(wing\))h(w)o (ord.)17 b(With)11 b(a)g(negativ)o(e)g(argumen)o(t,)f(lo)o(w)o(ercase) -315 2195 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f -(the)h(cursor.)75 2282 y Ft(capitalize-word)e(\(M-c\))315 -2337 y Fu(Capitalize)f(the)f(curren)o(t)f(\(or)g(follo)o(wing\))h(w)o +315 2459 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f +(the)h(cursor.)75 2560 y Ft(capitalize-word)e(\(M-c\))315 +2615 y Fu(Capitalize)f(the)f(curren)o(t)f(\(or)g(follo)o(wing\))h(w)o (ord.)18 b(With)11 b(a)f(negativ)o(e)h(argumen)o(t,)f(capitalize)315 -2392 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f -(the)h(cursor.)75 2499 y Fj(1.4.4)30 b(Killing)20 b(And)h(Y)-5 -b(anking)75 2615 y Ft(kill-line)14 b(\(C-k\))315 2670 -y Fu(Kill)j(the)f(text)e(from)h(p)q(oin)o(t)h(to)e(the)h(end)h(of)f -(the)g(line.)p eop +2670 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f +(the)h(cursor.)p eop %%Page: 15 17 15 16 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(15)75 149 y Ft(backward-kill-line)13 b(\(C-x)h(Rubout\))315 -204 y Fu(Kill)j(bac)o(kw)o(ard)e(to)f(the)i(b)q(eginning)h(of)e(the)g -(line.)75 295 y Ft(unix-line-discard)e(\(C-u\))315 349 +b(15)75 149 y Ft(overwrite-mode)13 b(\(\))315 204 y Fu(T)l(oggle)j(o)o +(v)o(erwrite)g(mo)q(de.)24 b(With)17 b(an)f(explicit)j(p)q(ositiv)o(e)f +(n)o(umeric)f(argumen)o(t,)f(switc)o(hes)315 259 y(to)10 +b(o)o(v)o(erwrite)g(mo)q(de.)19 b(With)11 b(an)g(explicit)i(non-p)q +(ositiv)o(e)f(n)o(umeric)g(argumen)o(t,)e(switc)o(hes)i(to)315 +314 y(insert)k(mo)q(de.)k(This)c(command)f(a\013ects)g(only)h +Ft(emacs)e Fu(mo)q(de;)h Ft(vi)g Fu(mo)q(de)h(do)q(es)g(o)o(v)o +(erwrite)315 369 y(di\013eren)o(tly)l(.)21 b(Eac)o(h)15 +b(call)h(to)f Ft(readline\(\))f Fu(starts)f(in)k(insert)e(mo)q(de.)315 +436 y(In)g(o)o(v)o(erwrite)f(mo)q(de,)h(c)o(haracters)f(b)q(ound)h(to)f +Ft(self-insert)f Fu(replace)j(the)e(text)h(at)e(p)q(oin)o(t)315 +491 y(rather)20 b(than)h(pushing)h(the)f(text)f(to)g(the)h(righ)o(t.)36 +b(Characters)20 b(b)q(ound)i(to)e Ft(backward-)315 546 +y(delete-char)14 b Fu(replace)i(the)f(c)o(haracter)g(b)q(efore)g(p)q +(oin)o(t)h(with)f(a)g(space.)315 614 y(By)g(default,)h(this)f(command)g +(is)h(un)o(b)q(ound.)75 729 y Fj(1.4.4)30 b(Killing)20 +b(And)h(Y)-5 b(anking)75 853 y Ft(kill-line)14 b(\(C-k\))315 +908 y Fu(Kill)j(the)f(text)e(from)h(p)q(oin)o(t)h(to)e(the)h(end)h(of)f +(the)g(line.)75 1002 y Ft(backward-kill-line)e(\(C-x)h(Rubout\))315 +1057 y Fu(Kill)j(bac)o(kw)o(ard)e(to)f(the)i(b)q(eginning)h(of)e(the)g +(line.)75 1151 y Ft(unix-line-discard)e(\(C-u\))315 1205 y Fu(Kill)k(bac)o(kw)o(ard)e(from)f(the)i(cursor)e(to)h(the)g(b)q -(eginning)j(of)c(the)i(curren)o(t)f(line.)75 440 y Ft(kill-whole-line)e -(\(\))315 495 y Fu(Kill)20 b(all)g(c)o(haracters)d(on)h(the)h(curren)o -(t)f(line,)i(no)e(matter)g(where)g(p)q(oin)o(t)h(is.)29 -b(By)19 b(default,)315 549 y(this)d(is)f(un)o(b)q(ound.)75 -640 y Ft(kill-word)f(\(M-d\))315 695 y Fu(Kill)j(from)d(p)q(oin)o(t)h +(eginning)j(of)c(the)i(curren)o(t)f(line.)75 1299 y Ft(kill-whole-line) +e(\(\))315 1354 y Fu(Kill)20 b(all)g(c)o(haracters)d(on)h(the)h(curren) +o(t)f(line,)i(no)e(matter)g(where)g(p)q(oin)o(t)h(is.)29 +b(By)19 b(default,)315 1409 y(this)d(is)f(un)o(b)q(ound.)75 +1503 y Ft(kill-word)f(\(M-d\))315 1558 y Fu(Kill)j(from)d(p)q(oin)o(t)h (to)f(the)h(end)g(of)f(the)h(curren)o(t)g(w)o(ord,)e(or)i(if)g(b)q(et)o -(w)o(een)g(w)o(ords,)e(to)i(the)f(end)315 750 y(of)h(the)g(next)g(w)o +(w)o(een)g(w)o(ords,)e(to)i(the)f(end)315 1613 y(of)h(the)g(next)g(w)o (ord.)20 b(W)l(ord)14 b(b)q(oundaries)j(are)e(the)g(same)g(as)g -Ft(forward-word)p Fu(.)75 840 y Ft(backward-kill-word)e(\(M-)592 -838 y Fn(h)p 603 812 73 2 v 603 840 a Fm(DEL)p 603 848 -V 674 838 a Fn(i)689 840 y Ft(\))315 895 y Fu(Kill)k(the)d(w)o(ord)g(b) -q(ehind)i(p)q(oin)o(t.)21 b(W)l(ord)14 b(b)q(oundaries)h(are)f(the)h -(same)f(as)g Ft(backward-word)p Fu(.)75 985 y Ft(unix-word-rubout)f -(\(C-w\))315 1040 y Fu(Kill)18 b(the)e(w)o(ord)f(b)q(ehind)j(p)q(oin)o -(t,)e(using)h(white)f(space)g(as)g(a)f(w)o(ord)g(b)q(oundary)l(.)23 -b(The)16 b(killed)315 1095 y(text)f(is)g(sa)o(v)o(ed)g(on)g(the)h -(kill-ring.)75 1185 y Ft(delete-horizontal-space)c(\(\))315 -1240 y Fu(Delete)k(all)g(spaces)f(and)h(tabs)e(around)i(p)q(oin)o(t.)k -(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 1330 -y Ft(kill-region)e(\(\))315 1385 y Fu(Kill)j(the)f(text)e(in)i(the)g -(curren)o(t)f(region.)20 b(By)15 b(default,)h(this)f(command)g(is)h(un) -o(b)q(ound.)75 1476 y Ft(copy-region-as-kill)d(\(\))315 -1530 y Fu(Cop)o(y)j(the)i(text)e(in)i(the)f(region)g(to)g(the)g(kill)h +Ft(forward-word)p Fu(.)75 1707 y Ft(backward-kill-word)e(\(M-)592 +1705 y Fn(h)p 603 1679 73 2 v 603 1707 a Fm(DEL)p 603 +1714 V 674 1705 a Fn(i)689 1707 y Ft(\))315 1761 y Fu(Kill)k(the)d(w)o +(ord)g(b)q(ehind)i(p)q(oin)o(t.)21 b(W)l(ord)14 b(b)q(oundaries)h(are)f +(the)h(same)f(as)g Ft(backward-word)p Fu(.)75 1855 y +Ft(unix-word-rubout)f(\(C-w\))315 1910 y Fu(Kill)18 b(the)e(w)o(ord)f +(b)q(ehind)j(p)q(oin)o(t,)e(using)h(white)f(space)g(as)g(a)f(w)o(ord)g +(b)q(oundary)l(.)23 b(The)16 b(killed)315 1965 y(text)f(is)g(sa)o(v)o +(ed)g(on)g(the)h(kill-ring.)75 2059 y Ft(delete-horizontal-space)c +(\(\))315 2114 y Fu(Delete)k(all)g(spaces)f(and)h(tabs)e(around)i(p)q +(oin)o(t.)k(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 +2208 y Ft(kill-region)e(\(\))315 2263 y Fu(Kill)j(the)f(text)e(in)i +(the)g(curren)o(t)f(region.)20 b(By)15 b(default,)h(this)f(command)g +(is)h(un)o(b)q(ound.)75 2357 y Ft(copy-region-as-kill)d(\(\))315 +2412 y Fu(Cop)o(y)j(the)i(text)e(in)i(the)f(region)g(to)g(the)g(kill)h (bu\013er,)f(so)g(it)g(can)g(b)q(e)h(y)o(ank)o(ed)f(righ)o(t)g(a)o(w)o -(a)o(y)l(.)315 1585 y(By)e(default,)h(this)f(command)g(is)h(un)o(b)q -(ound.)75 1676 y Ft(copy-backward-word)d(\(\))315 1730 +(a)o(y)l(.)315 2466 y(By)e(default,)h(this)f(command)g(is)h(un)o(b)q +(ound.)75 2560 y Ft(copy-backward-word)d(\(\))315 2615 y Fu(Cop)o(y)19 b(the)g(w)o(ord)g(b)q(efore)g(p)q(oin)o(t)h(to)e(the)i (kill)h(bu\013er.)32 b(The)19 b(w)o(ord)g(b)q(oundaries)h(are)f(the)315 -1785 y(same)c(as)g Ft(backward-word)p Fu(.)j(By)d(default,)g(this)h -(command)f(is)h(un)o(b)q(ound.)75 1876 y Ft(copy-forward-word)d(\(\)) -315 1930 y Fu(Cop)o(y)i(the)h(w)o(ord)e(follo)o(wing)j(p)q(oin)o(t)f -(to)f(the)g(kill)j(bu\013er.)i(The)c(w)o(ord)f(b)q(oundaries)i(are)e -(the)315 1985 y(same)g(as)g Ft(forward-word)p Fu(.)j(By)d(default,)h -(this)f(command)g(is)h(un)o(b)q(ound.)75 2076 y Ft(yank)f(\(C-y\))315 -2131 y Fu(Y)l(ank)g(the)h(top)f(of)f(the)i(kill)h(ring)e(in)o(to)g(the) -h(bu\013er)f(at)f(p)q(oin)o(t.)75 2221 y Ft(yank-pop)g(\(M-y\))315 -2276 y Fu(Rotate)i(the)h(kill-ring,)j(and)d(y)o(ank)g(the)h(new)f(top.) -26 b(Y)l(ou)17 b(can)h(only)g(do)f(this)h(if)f(the)h(prior)315 -2331 y(command)d(is)h Ft(yank)e Fu(or)h Ft(yank-pop)p -Fu(.)75 2441 y Fj(1.4.5)30 b(Sp)r(ecifying)20 b(Numeric)h(Argumen)n(ts) -75 2560 y Ft(digit-argument)13 b(\()p Fo(M-0)p Ft(,)i -Fo(M-1)p Ft(,)f(...)h Fo(M--)p Ft(\))315 2615 y Fu(Add)f(this)g(digit)g -(to)f(the)h(argumen)o(t)e(already)i(accum)o(ulating,)g(or)f(start)f(a)h -(new)h(argumen)o(t.)315 2670 y Fo(M--)h Fu(starts)f(a)h(negativ)o(e)g -(argumen)o(t.)p eop +2670 y(same)c(as)g Ft(backward-word)p Fu(.)j(By)d(default,)g(this)h +(command)f(is)h(un)o(b)q(ound.)p eop %%Page: 16 18 16 17 bop 75 -58 a Fu(16)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Ft(universal-argument)d(\(\))315 204 y Fu(This)g(is)h(another)e +149 y Ft(copy-forward-word)d(\(\))315 204 y Fu(Cop)o(y)i(the)h(w)o(ord) +e(follo)o(wing)j(p)q(oin)o(t)f(to)f(the)g(kill)j(bu\013er.)i(The)c(w)o +(ord)f(b)q(oundaries)i(are)e(the)315 259 y(same)g(as)g +Ft(forward-word)p Fu(.)j(By)d(default,)h(this)f(command)g(is)h(un)o(b)q +(ound.)75 342 y Ft(yank)f(\(C-y\))315 397 y Fu(Y)l(ank)g(the)h(top)f +(of)f(the)i(kill)h(ring)e(in)o(to)g(the)h(bu\013er)f(at)f(p)q(oin)o(t.) +75 481 y Ft(yank-pop)g(\(M-y\))315 535 y Fu(Rotate)i(the)h(kill-ring,)j +(and)d(y)o(ank)g(the)h(new)f(top.)26 b(Y)l(ou)17 b(can)h(only)g(do)f +(this)h(if)f(the)h(prior)315 590 y(command)d(is)h Ft(yank)e +Fu(or)h Ft(yank-pop)p Fu(.)75 693 y Fj(1.4.5)30 b(Sp)r(ecifying)20 +b(Numeric)h(Argumen)n(ts)75 806 y Ft(digit-argument)13 +b(\()p Fo(M-0)p Ft(,)i Fo(M-1)p Ft(,)f(...)h Fo(M--)p +Ft(\))315 861 y Fu(Add)f(this)g(digit)g(to)f(the)h(argumen)o(t)e +(already)i(accum)o(ulating,)g(or)f(start)f(a)h(new)h(argumen)o(t.)315 +915 y Fo(M--)h Fu(starts)f(a)h(negativ)o(e)g(argumen)o(t.)75 +999 y Ft(universal-argument)e(\(\))315 1054 y Fu(This)g(is)h(another)e (w)o(a)o(y)g(to)g(sp)q(ecify)i(an)f(argumen)o(t.)18 b(If)13 b(this)g(command)g(is)g(follo)o(w)o(ed)g(b)o(y)g(one)315 -259 y(or)h(more)h(digits,)g(optionally)h(with)f(a)g(leading)h(min)o(us) -f(sign,)g(those)g(digits)g(de\014ne)h(the)f(ar-)315 314 -y(gumen)o(t.)k(If)c(the)g(command)f(is)h(follo)o(w)o(ed)g(b)o(y)g -(digits,)g(executing)g Ft(universal-argument)315 369 +1108 y(or)h(more)h(digits,)g(optionally)h(with)f(a)g(leading)h(min)o +(us)f(sign,)g(those)g(digits)g(de\014ne)h(the)f(ar-)315 +1163 y(gumen)o(t.)k(If)c(the)g(command)f(is)h(follo)o(w)o(ed)g(b)o(y)g +(digits,)g(executing)g Ft(universal-argument)315 1218 y Fu(again)h(ends)g(the)g(n)o(umeric)h(argumen)o(t,)e(but)h(is)h (otherwise)f(ignored.)22 b(As)16 b(a)g(sp)q(ecial)h(case,)315 -423 y(if)g(this)g(command)f(is)h(immediately)h(follo)o(w)o(ed)f(b)o(y)f -(a)g(c)o(haracter)g(that)g(is)h(neither)g(a)f(digit)315 -478 y(or)d(min)o(us)i(sign,)f(the)g(argumen)o(t)g(coun)o(t)f(for)h(the) -g(next)g(command)g(is)g(m)o(ultiplied)j(b)o(y)d(four.)315 -533 y(The)19 b(argumen)o(t)f(coun)o(t)g(is)h(initially)j(one,)d(so)f +1273 y(if)g(this)g(command)f(is)h(immediately)h(follo)o(w)o(ed)f(b)o(y) +f(a)g(c)o(haracter)g(that)g(is)h(neither)g(a)f(digit)315 +1328 y(or)d(min)o(us)i(sign,)f(the)g(argumen)o(t)g(coun)o(t)f(for)h +(the)g(next)g(command)g(is)g(m)o(ultiplied)j(b)o(y)d(four.)315 +1382 y(The)19 b(argumen)o(t)f(coun)o(t)g(is)h(initially)j(one,)d(so)f (executing)i(this)f(function)h(the)e(\014rst)h(time)315 -588 y(mak)o(es)c(the)h(argumen)o(t)f(coun)o(t)h(four,)f(a)h(second)g +1437 y(mak)o(es)c(the)h(argumen)o(t)f(coun)o(t)h(four,)f(a)h(second)g (time)g(mak)o(es)g(the)g(argumen)o(t)f(coun)o(t)g(six-)315 -643 y(teen,)g(and)g(so)g(on.)20 b(By)15 b(default,)h(this)f(is)h(not)f -(b)q(ound)h(to)f(a)g(k)o(ey)l(.)75 762 y Fj(1.4.6)30 +1492 y(teen,)g(and)g(so)g(on.)20 b(By)15 b(default,)h(this)f(is)h(not)f +(b)q(ound)h(to)f(a)g(k)o(ey)l(.)75 1595 y Fj(1.4.6)30 b(Letting)20 b(Readline)g(T)n(yp)r(e)h(F)-5 b(or)19 b(Y)-5 -b(ou)75 892 y Ft(complete)14 b(\()305 890 y Fn(h)p 317 -864 74 2 v 317 892 a Fm(T)m(AB)p 317 900 V 389 890 a -Fn(i)404 892 y Ft(\))315 947 y Fu(A)o(ttempt)c(to)h(p)q(erform)g -(completion)i(on)e(the)g(text)g(b)q(efore)h(p)q(oin)o(t.)19 -b(The)11 b(actual)h(completion)315 1002 y(p)q(erformed)j(is)h +b(ou)75 1708 y Ft(complete)14 b(\()305 1706 y Fn(h)p +317 1680 74 2 v 317 1708 a Fm(T)m(AB)p 317 1715 V 389 +1706 a Fn(i)404 1708 y Ft(\))315 1762 y Fu(A)o(ttempt)c(to)h(p)q +(erform)g(completion)i(on)e(the)g(text)g(b)q(efore)h(p)q(oin)o(t.)19 +b(The)11 b(actual)h(completion)315 1817 y(p)q(erformed)j(is)h (application-sp)q(eci\014)q(c.)23 b(The)15 b(default)h(is)g(\014lename) -g(completion.)75 1099 y Ft(possible-completions)c(\(M-?\))315 -1154 y Fu(List)k(the)f(p)q(ossible)i(completions)f(of)f(the)g(text)g(b) -q(efore)h(p)q(oin)o(t.)75 1251 y Ft(insert-completions)d(\(M-*\))315 -1306 y Fu(Insert)j(all)g(completions)g(of)f(the)g(text)g(b)q(efore)h(p) +g(completion.)75 1901 y Ft(possible-completions)c(\(M-?\))315 +1955 y Fu(List)k(the)f(p)q(ossible)i(completions)f(of)f(the)g(text)g(b) +q(efore)h(p)q(oin)o(t.)75 2039 y Ft(insert-completions)d(\(M-*\))315 +2093 y Fu(Insert)j(all)g(completions)g(of)f(the)g(text)g(b)q(efore)h(p) q(oin)o(t)f(that)g(w)o(ould)h(ha)o(v)o(e)f(b)q(een)h(generated)315 -1361 y(b)o(y)f Ft(possible-completions)p Fu(.)75 1458 -y Ft(menu-complete)e(\(\))315 1513 y Fu(Similar)g(to)f +2148 y(b)o(y)f Ft(possible-completions)p Fu(.)75 2232 +y Ft(menu-complete)e(\(\))315 2286 y Fu(Similar)g(to)f Ft(complete)p Fu(,)f(but)h(replaces)h(the)f(w)o(ord)f(to)g(b)q(e)i -(completed)f(with)h(a)e(single)j(matc)o(h)315 1568 y(from)k(the)h(list) +(completed)f(with)h(a)e(single)j(matc)o(h)315 2341 y(from)k(the)h(list) h(of)e(p)q(ossible)j(completions.)32 b(Rep)q(eated)19 -b(execution)h(of)f Ft(menu-complete)315 1623 y Fu(steps)h(through)g +b(execution)h(of)f Ft(menu-complete)315 2396 y Fu(steps)h(through)g (the)g(list)h(of)f(p)q(ossible)i(completions,)g(inserting)f(eac)o(h)f -(matc)o(h)f(in)i(turn.)315 1678 y(A)o(t)d(the)g(end)h(of)f(the)h(list)g +(matc)o(h)f(in)i(turn.)315 2451 y(A)o(t)d(the)g(end)h(of)f(the)h(list)g (of)f(completions,)i(the)e(b)q(ell)j(is)d(rung)h(\(sub)s(ject)f(to)f -(the)i(setting)315 1732 y(of)f Ft(bell-style)p Fu(\))e(and)i(the)g +(the)i(setting)315 2506 y(of)f Ft(bell-style)p Fu(\))e(and)i(the)g (original)h(text)f(is)g(restored.)28 b(An)19 b(argumen)o(t)e(of)g -Fk(n)i Fu(mo)o(v)o(es)e Fk(n)315 1787 y Fu(p)q(ositions)h(forw)o(ard)e +Fk(n)i Fu(mo)o(v)o(es)e Fk(n)315 2560 y Fu(p)q(ositions)h(forw)o(ard)e (in)j(the)e(list)h(of)f(matc)o(hes;)h(a)f(negativ)o(e)g(argumen)o(t)g -(ma)o(y)g(b)q(e)h(used)g(to)315 1842 y(mo)o(v)o(e)g(bac)o(kw)o(ard)h +(ma)o(y)g(b)q(e)h(used)g(to)315 2615 y(mo)o(v)o(e)g(bac)o(kw)o(ard)h (through)g(the)g(list.)32 b(This)20 b(command)f(is)h(in)o(tended)g(to)f -(b)q(e)h(b)q(ound)g(to)315 1895 y Fn(h)p 327 1869 V 327 -1897 a Fm(T)m(AB)p 327 1905 V 399 1895 a Fn(i)414 1897 -y Fu(,)15 b(but)g(is)h(un)o(b)q(ound)g(b)o(y)f(default.)75 -1994 y Ft(delete-char-or-list)e(\(\))315 2049 y Fu(Deletes)h(the)f(c)o -(haracter)g(under)h(the)g(cursor)f(if)h(not)f(at)g(the)g(b)q(eginning)j -(or)d(end)h(of)f(the)g(line)315 2104 y(\(lik)o(e)i Ft(delete-char)p -Fu(\).)j(If)d(at)f(the)h(end)g(of)f(the)g(line,)i(b)q(eha)o(v)o(es)f -(iden)o(tically)i(to)d Ft(possible-)315 2159 y(completions)p -Fu(.)k(This)e(command)f(is)h(un)o(b)q(ound)g(b)o(y)f(default.)75 -2278 y Fj(1.4.7)30 b(Keyb)r(oard)20 b(Macros)75 2408 -y Ft(start-kbd-macro)13 b(\(C-x)i(\(\))315 2463 y Fu(Begin)h(sa)o(ving) -f(the)h(c)o(haracters)e(t)o(yp)q(ed)i(in)o(to)f(the)g(curren)o(t)g(k)o -(eyb)q(oard)g(macro.)75 2560 y Ft(end-kbd-macro)e(\(C-x)i(\)\))315 -2615 y Fu(Stop)f(sa)o(ving)f(the)h(c)o(haracters)f(t)o(yp)q(ed)h(in)o -(to)f(the)h(curren)o(t)g(k)o(eyb)q(oard)f(macro)g(and)h(sa)o(v)o(e)f -(the)315 2670 y(de\014nition.)p eop +(b)q(e)h(b)q(ound)g(to)315 2668 y Fn(h)p 327 2642 V 327 +2670 a Fm(T)m(AB)p 327 2678 V 399 2668 a Fn(i)414 2670 +y Fu(,)15 b(but)g(is)h(un)o(b)q(ound)g(b)o(y)f(default.)p +eop %%Page: 17 19 17 18 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(17)75 149 y Ft(call-last-kbd-macro)13 b(\(C-x)h(e\))315 -204 y Fu(Re-execute)k(the)g(last)f(k)o(eyb)q(oard)h(macro)f(de\014ned,) -i(b)o(y)e(making)h(the)g(c)o(haracters)e(in)j(the)315 -259 y(macro)14 b(app)q(ear)i(as)f(if)g(t)o(yp)q(ed)h(at)e(the)i(k)o -(eyb)q(oard.)75 368 y Fj(1.4.8)30 b(Some)20 b(Miscellaneous)h(Commands) -75 486 y Ft(re-read-init-file)13 b(\(C-x)h(C-r\))315 -541 y Fu(Read)d(in)g(the)g(con)o(ten)o(ts)g(of)f(the)h -Fk(inputrc)k Fu(\014le,)d(and)g(incorp)q(orate)f(an)o(y)f(bindings)j -(or)e(v)m(ariable)315 596 y(assignmen)o(ts)k(found)h(there.)75 -684 y Ft(abort)e(\(C-g\))315 739 y Fu(Ab)q(ort)f(the)g(curren)o(t)h +b(17)75 149 y Ft(delete-char-or-list)13 b(\(\))315 204 +y Fu(Deletes)h(the)f(c)o(haracter)g(under)h(the)g(cursor)f(if)h(not)f +(at)g(the)g(b)q(eginning)j(or)d(end)h(of)f(the)g(line)315 +259 y(\(lik)o(e)i Ft(delete-char)p Fu(\).)j(If)d(at)f(the)h(end)g(of)f +(the)g(line,)i(b)q(eha)o(v)o(es)f(iden)o(tically)i(to)d +Ft(possible-)315 314 y(completions)p Fu(.)k(This)e(command)f(is)h(un)o +(b)q(ound)g(b)o(y)f(default.)75 428 y Fj(1.4.7)30 b(Keyb)r(oard)20 +b(Macros)75 551 y Ft(start-kbd-macro)13 b(\(C-x)i(\(\))315 +606 y Fu(Begin)h(sa)o(ving)f(the)h(c)o(haracters)e(t)o(yp)q(ed)i(in)o +(to)f(the)g(curren)o(t)g(k)o(eyb)q(oard)g(macro.)75 699 +y Ft(end-kbd-macro)e(\(C-x)i(\)\))315 754 y Fu(Stop)f(sa)o(ving)f(the)h +(c)o(haracters)f(t)o(yp)q(ed)h(in)o(to)f(the)h(curren)o(t)g(k)o(eyb)q +(oard)f(macro)g(and)h(sa)o(v)o(e)f(the)315 809 y(de\014nition.)75 +902 y Ft(call-last-kbd-macro)g(\(C-x)h(e\))315 957 y +Fu(Re-execute)k(the)g(last)f(k)o(eyb)q(oard)h(macro)f(de\014ned,)i(b)o +(y)e(making)h(the)g(c)o(haracters)e(in)j(the)315 1012 +y(macro)14 b(app)q(ear)i(as)f(if)g(t)o(yp)q(ed)h(at)e(the)i(k)o(eyb)q +(oard.)75 1126 y Fj(1.4.8)30 b(Some)20 b(Miscellaneous)h(Commands)75 +1249 y Ft(re-read-init-file)13 b(\(C-x)h(C-r\))315 1304 +y Fu(Read)d(in)g(the)g(con)o(ten)o(ts)g(of)f(the)h Fk(inputrc)k +Fu(\014le,)d(and)g(incorp)q(orate)f(an)o(y)f(bindings)j(or)e(v)m +(ariable)315 1358 y(assignmen)o(ts)k(found)h(there.)75 +1452 y Ft(abort)e(\(C-g\))315 1507 y Fu(Ab)q(ort)f(the)g(curren)o(t)h (editing)g(command)f(and)h(ring)f(the)h(terminal's)f(b)q(ell)i(\(sub)s -(ject)e(to)g(the)315 794 y(setting)i(of)g Ft(bell-style)p -Fu(\).)75 883 y Ft(do-uppercase-version)d(\(M-a,)j(M-b,)f(M-)p -Fk(x)p Ft(,)h(...\))315 938 y Fu(If)f(the)g(meta\014ed)g(c)o(haracter)f -Fk(x)k Fu(is)d(lo)o(w)o(ercase,)g(run)g(the)g(command)f(that)h(is)g(b)q -(ound)h(to)e(the)315 993 y(corresp)q(onding)j(upp)q(ercase)g(c)o -(haracter.)75 1082 y Ft(prefix-meta)e(\()377 1080 y Fn(h)p -389 1054 70 2 v 389 1082 a Fm(ESC)p 389 1089 V 456 1080 -a Fn(i)471 1082 y Ft(\))315 1136 y Fu(Metafy)k(the)h(next)g(c)o +(ject)e(to)g(the)315 1561 y(setting)i(of)g Ft(bell-style)p +Fu(\).)75 1655 y Ft(do-uppercase-version)d(\(M-a,)j(M-b,)f(M-)p +Fk(x)p Ft(,)h(...\))315 1710 y Fu(If)f(the)g(meta\014ed)g(c)o(haracter) +f Fk(x)k Fu(is)d(lo)o(w)o(ercase,)g(run)g(the)g(command)f(that)h(is)g +(b)q(ound)h(to)e(the)315 1764 y(corresp)q(onding)j(upp)q(ercase)g(c)o +(haracter.)75 1858 y Ft(prefix-meta)e(\()377 1856 y Fn(h)p +389 1830 70 2 v 389 1858 a Fm(ESC)p 389 1866 V 456 1856 +a Fn(i)471 1858 y Ft(\))315 1913 y Fu(Metafy)k(the)h(next)g(c)o (haracter)f(t)o(yp)q(ed.)30 b(This)20 b(is)f(for)f(k)o(eyb)q(oards)h -(without)g(a)f(meta)g(k)o(ey)l(.)315 1191 y(T)o(yping)e(`)485 -1189 y Fn(h)p 496 1163 V 496 1191 a Fm(ESC)p 496 1199 -V 563 1189 a Fn(i)593 1191 y Ft(f)p Fu(')f(is)h(equiv)m(alen)o(t)h(to)d -(t)o(yping)i Fo(M-f)p Fu(.)75 1280 y Ft(undo)f(\(C-_)f(or)h(C-x)g -(C-u\))315 1335 y Fu(Incremen)o(tal)h(undo,)f(separately)h(remem)o(b)q -(ered)g(for)e(eac)o(h)h(line.)75 1424 y Ft(revert-line)f(\(M-r\))315 -1479 y Fu(Undo)j(all)g(c)o(hanges)g(made)f(to)g(this)h(line.)26 +(without)g(a)f(meta)g(k)o(ey)l(.)315 1968 y(T)o(yping)e(`)485 +1966 y Fn(h)p 496 1939 V 496 1968 a Fm(ESC)p 496 1975 +V 563 1966 a Fn(i)593 1968 y Ft(f)p Fu(')f(is)h(equiv)m(alen)o(t)h(to)d +(t)o(yping)i Fo(M-f)p Fu(.)75 2061 y Ft(undo)f(\(C-_)f(or)h(C-x)g +(C-u\))315 2116 y Fu(Incremen)o(tal)h(undo,)f(separately)h(remem)o(b)q +(ered)g(for)e(eac)o(h)h(line.)75 2209 y Ft(revert-line)f(\(M-r\))315 +2264 y Fu(Undo)j(all)g(c)o(hanges)g(made)f(to)g(this)h(line.)26 b(This)17 b(is)g(lik)o(e)h(executing)f(the)g Ft(undo)f -Fu(command)315 1533 y(enough)g(times)f(to)g(get)f(bac)o(k)h(to)g(the)g -(b)q(eginning.)75 1622 y Ft(tilde-expand)f(\(M-~\))315 -1677 y Fu(P)o(erform)g(tilde)j(expansion)f(on)f(the)g(curren)o(t)g(w)o -(ord.)75 1766 y Ft(set-mark)f(\(C-@\))315 1821 y Fu(Set)i(the)h(mark)f +Fu(command)315 2319 y(enough)g(times)f(to)g(get)f(bac)o(k)h(to)g(the)g +(b)q(eginning.)75 2412 y Ft(tilde-expand)f(\(M-~\))315 +2467 y Fu(P)o(erform)g(tilde)j(expansion)f(on)f(the)g(curren)o(t)g(w)o +(ord.)75 2560 y Ft(set-mark)f(\(C-@\))315 2615 y Fu(Set)i(the)h(mark)f (to)f(the)i(p)q(oin)o(t.)24 b(If)17 b(a)f(n)o(umeric)h(argumen)o(t)f -(is)g(supplied,)j(the)e(mark)e(is)i(set)315 1876 y(to)e(that)f(p)q -(osition.)75 1965 y Ft(exchange-point-and-mark)e(\(C-x)j(C-x\))315 -2020 y Fu(Sw)o(ap)g(the)h(p)q(oin)o(t)g(with)g(the)g(mark.)k(The)c -(curren)o(t)f(cursor)h(p)q(osition)g(is)g(set)g(to)f(the)g(sa)o(v)o(ed) -315 2074 y(p)q(osition,)h(and)f(the)h(old)f(cursor)g(p)q(osition)h(is)g -(sa)o(v)o(ed)f(as)g(the)g(mark.)75 2163 y Ft(character-search)e -(\(C-]\))315 2218 y Fu(A)f(c)o(haracter)g(is)h(read)g(and)f(p)q(oin)o -(t)h(is)g(mo)o(v)o(ed)f(to)g(the)g(next)h(o)q(ccurrence)g(of)f(that)g -(c)o(haracter.)315 2273 y(A)j(negativ)o(e)h(coun)o(t)f(searc)o(hes)g -(for)f(previous)i(o)q(ccurrences.)75 2362 y Ft -(character-search-backward)c(\(M-C-]\))315 2417 y Fu(A)22 -b(c)o(haracter)g(is)h(read)f(and)h(p)q(oin)o(t)g(is)g(mo)o(v)o(ed)f(to) -g(the)g(previous)h(o)q(ccurrence)h(of)e(that)315 2471 -y(c)o(haracter.)d(A)c(negativ)o(e)h(coun)o(t)f(searc)o(hes)g(for)f -(subsequen)o(t)i(o)q(ccurrences.)75 2560 y Ft(insert-comment)d(\(M-#\)) -315 2615 y Fu(The)19 b(v)m(alue)i(of)e(the)g Ft(comment-begin)e -Fu(v)m(ariable)k(is)f(inserted)g(at)e(the)i(b)q(eginning)h(of)e(the)315 -2670 y(curren)o(t)c(line,)i(and)e(the)g(line)i(is)f(accepted)g(as)e(if) -i(a)f(newline)i(had)f(b)q(een)g(t)o(yp)q(ed.)p eop +(is)g(supplied,)j(the)e(mark)e(is)i(set)315 2670 y(to)e(that)f(p)q +(osition.)p eop %%Page: 18 20 18 19 bop 75 -58 a Fu(18)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Ft(dump-functions)d(\(\))315 204 y Fu(Prin)o(t)g(all)h(of)f(the)g +149 y Ft(exchange-point-and-mark)c(\(C-x)j(C-x\))315 +204 y Fu(Sw)o(ap)g(the)h(p)q(oin)o(t)g(with)g(the)g(mark.)k(The)c +(curren)o(t)f(cursor)h(p)q(osition)g(is)g(set)g(to)f(the)g(sa)o(v)o(ed) +315 259 y(p)q(osition,)h(and)f(the)h(old)f(cursor)g(p)q(osition)h(is)g +(sa)o(v)o(ed)f(as)g(the)g(mark.)75 347 y Ft(character-search)e(\(C-]\)) +315 402 y Fu(A)f(c)o(haracter)g(is)h(read)g(and)f(p)q(oin)o(t)h(is)g +(mo)o(v)o(ed)f(to)g(the)g(next)h(o)q(ccurrence)g(of)f(that)g(c)o +(haracter.)315 456 y(A)j(negativ)o(e)h(coun)o(t)f(searc)o(hes)g(for)f +(previous)i(o)q(ccurrences.)75 544 y Ft(character-search-backward)c +(\(M-C-]\))315 599 y Fu(A)22 b(c)o(haracter)g(is)h(read)f(and)h(p)q +(oin)o(t)g(is)g(mo)o(v)o(ed)f(to)g(the)g(previous)h(o)q(ccurrence)h(of) +e(that)315 654 y(c)o(haracter.)d(A)c(negativ)o(e)h(coun)o(t)f(searc)o +(hes)g(for)f(subsequen)o(t)i(o)q(ccurrences.)75 741 y +Ft(insert-comment)d(\(M-#\))315 796 y Fu(Without)18 b(a)f(n)o(umeric)i +(argumen)o(t,)e(the)h(v)m(alue)h(of)f(the)f Ft(comment-begin)f +Fu(v)m(ariable)k(is)e(in-)315 851 y(serted)e(at)f(the)h(b)q(eginning)i +(of)d(the)h(curren)o(t)g(line.)23 b(If)16 b(a)g(n)o(umeric)h(argumen)o +(t)e(is)h(supplied,)315 906 y(this)j(command)f(acts)g(as)f(a)h(toggle:) +26 b(if)19 b(the)f(c)o(haracters)g(at)f(the)i(b)q(eginning)h(of)e(the)g +(line)315 960 y(do)d(not)g(matc)o(h)g(the)g(v)m(alue)i(of)e +Ft(comment-begin)p Fu(,)e(the)i(v)m(alue)i(is)f(inserted,)f(otherwise)h +(the)315 1015 y(c)o(haracters)j(in)i Ft(comment-begin)d +Fu(are)i(deleted)i(from)d(the)h(b)q(eginning)i(of)e(the)g(line.)36 +b(In)315 1070 y(either)16 b(case,)f(the)g(line)i(is)f(accepted)f(as)g +(if)h(a)f(newline)i(had)e(b)q(een)i(t)o(yp)q(ed.)75 1158 +y Ft(dump-functions)c(\(\))315 1213 y Fu(Prin)o(t)g(all)h(of)f(the)g (functions)h(and)g(their)g(k)o(ey)f(bindings)i(to)d(the)i(Readline)g -(output)f(stream.)315 259 y(If)j(a)g(n)o(umeric)g(argumen)o(t)f(is)i +(output)f(stream.)315 1267 y(If)j(a)g(n)o(umeric)g(argumen)o(t)f(is)i (supplied,)h(the)e(output)f(is)i(formatted)d(in)j(suc)o(h)f(a)g(w)o(a)o -(y)f(that)315 314 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g +(y)f(that)315 1322 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fk(inputrc)k Fu(\014le.)i(This)16 b(command)f(is)h(un)o(b)q(ound)g(b)o -(y)f(default.)75 406 y Ft(dump-variables)e(\(\))315 461 -y Fu(Prin)o(t)e(all)g(of)f(the)h(settable)g(v)m(ariables)h(and)f(their) -g(v)m(alues)h(to)e(the)h(Readline)h(output)e(stream.)315 -516 y(If)16 b(a)g(n)o(umeric)g(argumen)o(t)f(is)i(supplied,)h(the)e +(y)f(default.)75 1410 y Ft(dump-variables)e(\(\))315 +1465 y Fu(Prin)o(t)e(all)g(of)f(the)h(settable)g(v)m(ariables)h(and)f +(their)g(v)m(alues)h(to)e(the)h(Readline)h(output)e(stream.)315 +1519 y(If)16 b(a)g(n)o(umeric)g(argumen)o(t)f(is)i(supplied,)h(the)e (output)f(is)i(formatted)d(in)j(suc)o(h)f(a)g(w)o(a)o(y)f(that)315 -570 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fk(inputrc)k +1574 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fk(inputrc)k Fu(\014le.)i(This)16 b(command)f(is)h(un)o(b)q(ound)g(b)o(y)f(default.) -75 663 y Ft(dump-macros)f(\(\))315 717 y Fu(Prin)o(t)j(all)h(of)e(the)h -(Readline)h(k)o(ey)f(sequences)h(b)q(ound)g(to)e(macros)g(and)h(the)g -(strings)g(they)315 772 y(output.)26 b(If)18 b(a)f(n)o(umeric)h +75 1662 y Ft(dump-macros)f(\(\))315 1717 y Fu(Prin)o(t)j(all)h(of)e +(the)h(Readline)h(k)o(ey)f(sequences)h(b)q(ound)g(to)e(macros)g(and)h +(the)g(strings)g(they)315 1771 y(output.)26 b(If)18 b(a)f(n)o(umeric)h (argumen)o(t)f(is)h(supplied,)i(the)d(output)g(is)h(formatted)e(in)j -(suc)o(h)e(a)315 827 y(w)o(a)o(y)d(that)g(it)i(can)f(b)q(e)g(made)g +(suc)o(h)e(a)315 1826 y(w)o(a)o(y)d(that)g(it)i(can)f(b)q(e)g(made)g (part)g(of)f(an)h Fk(inputrc)k Fu(\014le.)i(This)15 b(command)g(is)h -(un)o(b)q(ound)g(b)o(y)315 882 y(default.)75 1010 y Fs(1.5)33 -b(Readline)23 b(vi)h(Mo)r(de)137 1107 y Fu(While)13 b(the)f(Readline)i -(library)e(do)q(es)g(not)g(ha)o(v)o(e)f(a)h(full)h(set)f(of)f -Ft(vi)g Fu(editing)j(functions,)f(it)f(do)q(es)g(con)o(tain)75 -1161 y(enough)17 b(to)g(allo)o(w)g(simple)h(editing)h(of)d(the)i(line.) -27 b(The)17 b(Readline)h Ft(vi)f Fu(mo)q(de)g(b)q(eha)o(v)o(es)g(as)g -(sp)q(eci\014ed)i(in)75 1216 y(the)c Fp(posix)g Fu(1003.2)f(standard.) -137 1284 y(In)h(order)g(to)f(switc)o(h)g(in)o(teractiv)o(ely)i(b)q(et)o -(w)o(een)f Ft(emacs)e Fu(and)i Ft(vi)f Fu(editing)i(mo)q(des,)f(use)f -(the)h(command)75 1338 y Fo(M-C-j)j Fu(\(b)q(ound)i(to)e -(emacs-editing-mo)q(de)j(when)e(in)h Ft(vi)f Fu(mo)q(de)g(and)g(to)f -(vi-editing-mo)q(de)k(in)e Ft(emacs)75 1393 y Fu(mo)q(de\).)g(The)15 -b(Readline)i(default)f(is)f Ft(emacs)g Fu(mo)q(de.)137 -1460 y(When)h(y)o(ou)e(en)o(ter)h(a)g(line)i(in)e Ft(vi)g -Fu(mo)q(de,)g(y)o(ou)g(are)f(already)i(placed)g(in)g(`insertion')f(mo)q -(de,)g(as)g(if)g(y)o(ou)75 1515 y(had)e(t)o(yp)q(ed)h(an)f(`)p -Ft(i)p Fu('.)18 b(Pressing)608 1513 y Fn(h)p 620 1487 -70 2 v 620 1515 a Fm(ESC)p 620 1523 V 687 1513 a Fn(i)715 -1515 y Fu(switc)o(hes)13 b(y)o(ou)g(in)o(to)g(`command')f(mo)q(de,)i -(where)f(y)o(ou)g(can)g(edit)h(the)75 1570 y(text)i(of)h(the)g(line)h -(with)g(the)f(standard)f Ft(vi)h Fu(mo)o(v)o(emen)o(t)f(k)o(eys,)g(mo)o -(v)o(e)g(to)h(previous)g(history)g(lines)i(with)75 1625 -y(`)p Ft(k)p Fu(')14 b(and)i(subsequen)o(t)f(lines)i(with)f(`)p -Ft(j)p Fu(',)e(and)h(so)g(forth.)p eop +(un)o(b)q(ound)g(b)o(y)315 1881 y(default.)75 1969 y +Ft(emacs-editing-mode)d(\(C-e\))315 2024 y Fu(When)j(in)g +Ft(vi)e Fu(command)i(mo)q(de,)f(this)g(causes)h(a)f(switc)o(h)g(to)g +Ft(emacs)f Fu(editing)j(mo)q(de.)75 2111 y Ft(vi-editing-mode)c +(\(M-C-j\))315 2166 y Fu(When)j(in)g Ft(emacs)e Fu(editing)j(mo)q(de,)e +(this)g(causes)h(a)f(switc)o(h)g(to)g Ft(vi)f Fu(editing)j(mo)q(de.)75 +2290 y Fs(1.5)33 b(Readline)23 b(vi)h(Mo)r(de)137 2385 +y Fu(While)13 b(the)f(Readline)i(library)e(do)q(es)g(not)g(ha)o(v)o(e)f +(a)h(full)h(set)f(of)f Ft(vi)g Fu(editing)j(functions,)f(it)f(do)q(es)g +(con)o(tain)75 2440 y(enough)17 b(to)g(allo)o(w)g(simple)h(editing)h +(of)d(the)i(line.)27 b(The)17 b(Readline)h Ft(vi)f Fu(mo)q(de)g(b)q +(eha)o(v)o(es)g(as)g(sp)q(eci\014ed)i(in)75 2495 y(the)c +Fp(posix)g Fu(1003.2)f(standard.)137 2560 y(In)h(order)g(to)f(switc)o +(h)g(in)o(teractiv)o(ely)i(b)q(et)o(w)o(een)f Ft(emacs)e +Fu(and)i Ft(vi)f Fu(editing)i(mo)q(des,)f(use)f(the)h(command)75 +2615 y Fo(M-C-j)j Fu(\(b)q(ound)i(to)e(emacs-editing-mo)q(de)j(when)e +(in)h Ft(vi)f Fu(mo)q(de)g(and)g(to)f(vi-editing-mo)q(de)k(in)e +Ft(emacs)75 2670 y Fu(mo)q(de\).)g(The)15 b(Readline)i(default)f(is)f +Ft(emacs)g Fu(mo)q(de.)p eop %%Page: 19 21 -19 20 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(19)75 149 y Fq(2)41 b(Programming)28 +19 20 bop 75 -58 a Fu(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 +b(19)137 149 y(When)16 b(y)o(ou)e(en)o(ter)h(a)g(line)i(in)e +Ft(vi)g Fu(mo)q(de,)g(y)o(ou)g(are)f(already)i(placed)g(in)g +(`insertion')f(mo)q(de,)g(as)g(if)g(y)o(ou)75 204 y(had)e(t)o(yp)q(ed)h +(an)f(`)p Ft(i)p Fu('.)18 b(Pressing)608 202 y Fn(h)p +620 176 70 2 v 620 204 a Fm(ESC)p 620 212 V 687 202 a +Fn(i)715 204 y Fu(switc)o(hes)13 b(y)o(ou)g(in)o(to)g(`command')f(mo)q +(de,)i(where)f(y)o(ou)g(can)g(edit)h(the)75 259 y(text)i(of)h(the)g +(line)h(with)g(the)f(standard)f Ft(vi)h Fu(mo)o(v)o(emen)o(t)f(k)o +(eys,)g(mo)o(v)o(e)g(to)h(previous)g(history)g(lines)i(with)75 +314 y(`)p Ft(k)p Fu(')14 b(and)i(subsequen)o(t)f(lines)i(with)f(`)p +Ft(j)p Fu(',)e(and)h(so)g(forth.)p eop +%%Page: 20 22 +20 21 bop 75 -58 a Fu(20)1299 b(GNU)15 b(Readline)h(Library)p +eop +%%Page: 21 23 +21 22 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(21)75 149 y Fq(2)41 b(Programming)28 b(with)e(GNU)i(Readline)137 267 y Fu(This)18 b(c)o(hapter)f(describ)q (es)h(the)f(in)o(terface)g(b)q(et)o(w)o(een)h(the)f Fp(gnu)g Fu(Readline)h(Library)f(and)g(other)g(pro-)75 322 y(grams.)h(If)11 @@ -2305,1784 +2354,1855 @@ Fu(library)i(function,)g(and)f(has)g(the)h(adv)m(an)o(tage)e(of)h(no)g y Ft(/*)24 b(A)f(static)g(variable)g(for)h(holding)e(the)i(line.)f(*/) 195 2099 y(static)g(char)g(*line_read)g(=)h(\(char)f(*\)NULL;)195 2203 y(/*)h(Read)f(a)h(string,)f(and)g(return)g(a)h(pointer)f(to)g(it.) -48 b(Returns)22 b(NULL)i(on)f(EOF.)h(*/)195 2255 y(char)f(*)195 -2307 y(rl_gets)g(\(\))195 2359 y({)243 2411 y(/*)g(If)h(the)f(buffer)g -(has)h(already)f(been)g(allocated,)g(return)g(the)g(memory)314 -2462 y(to)h(the)f(free)h(pool.)f(*/)243 2514 y(if)g(\(line_read\))290 -2566 y({)338 2618 y(free)g(\(line_read\);)338 2670 y(line_read)g(=)h -(\(char)f(*\)NULL;)p eop -%%Page: 20 22 -20 21 bop 75 -58 a Fu(20)1299 b(GNU)15 b(Readline)h(Library)290 -149 y Ft(})243 253 y(/*)23 b(Get)h(a)f(line)h(from)f(the)h(user.)f(*/) -243 305 y(line_read)f(=)i(readline)f(\(""\);)243 409 -y(/*)g(If)h(the)f(line)h(has)f(any)h(text)f(in)g(it,)h(save)f(it)h(on)f -(the)h(history.)f(*/)243 461 y(if)g(\(line_read)g(&&)g(*line_read\))290 -513 y(add_history)g(\(line_read\);)243 616 y(return)g(\(line_read\);) -195 668 y(})137 735 y Fu(This)13 b(function)f(giv)o(es)h(the)e(user)h -(the)g(default)h(b)q(eha)o(viour)g(of)1169 733 y Fn(h)p -1181 707 74 2 v 1181 735 a Fm(T)m(AB)p 1181 743 V 1253 -733 a Fn(i)1280 735 y Fu(completion:)19 b(completion)13 -b(on)f(\014le)75 790 y(names.)20 b(If)c(y)o(ou)f(do)g(not)g(w)o(an)o(t) +267 2255 y(Returns)f(NULL)i(on)f(EOF.)h(*/)195 2307 y(char)f(*)195 +2359 y(rl_gets)g(\(\))195 2411 y({)243 2462 y(/*)g(If)h(the)f(buffer)g +(has)h(already)f(been)g(allocated,)314 2514 y(return)g(the)h(memory)f +(to)g(the)h(free)f(pool.)g(*/)243 2566 y(if)g(\(line_read\))290 +2618 y({)338 2670 y(free)g(\(line_read\);)p eop +%%Page: 22 24 +22 23 bop 75 -58 a Fu(22)1299 b(GNU)15 b(Readline)h(Library)338 +149 y Ft(line_read)23 b(=)h(\(char)f(*\)NULL;)290 201 +y(})243 305 y(/*)g(Get)h(a)f(line)h(from)f(the)h(user.)f(*/)243 +357 y(line_read)f(=)i(readline)f(\(""\);)243 461 y(/*)g(If)h(the)f +(line)h(has)f(any)h(text)f(in)g(it,)314 513 y(save)h(it)f(on)h(the)f +(history.)g(*/)243 565 y(if)g(\(line_read)g(&&)g(*line_read\))290 +616 y(add_history)g(\(line_read\);)243 720 y(return)g(\(line_read\);) +195 772 y(})137 848 y Fu(This)13 b(function)f(giv)o(es)h(the)e(user)h +(the)g(default)h(b)q(eha)o(viour)g(of)1169 846 y Fn(h)p +1181 820 74 2 v 1181 848 a Fm(T)m(AB)p 1181 856 V 1253 +846 a Fn(i)1280 848 y Fu(completion:)19 b(completion)13 +b(on)f(\014le)75 903 y(names.)20 b(If)c(y)o(ou)f(do)g(not)g(w)o(an)o(t) f(Readline)j(to)d(complete)j(on)e(\014lenames,)h(y)o(ou)f(can)g(c)o -(hange)h(the)f(binding)75 845 y(of)g(the)205 843 y Fn(h)p -217 817 V 217 845 a Fm(T)m(AB)p 217 853 V 289 843 a Fn(i)319 -845 y Fu(k)o(ey)g(with)h Ft(rl_bind_key\(\))p Fu(.)195 -909 y Ft(int)23 b(rl_bind_key)g(\(int)g Fk(k)o(ey)p Ft(,)h -(rl_command_func_t)d(*)p Fk(function)p Ft(\);)137 976 -y(rl_bind_key\(\))15 b Fu(tak)o(es)h(t)o(w)o(o)g(argumen)o(ts:)22 +(hange)h(the)f(binding)75 958 y(of)g(the)205 956 y Fn(h)p +217 930 V 217 958 a Fm(T)m(AB)p 217 965 V 289 956 a Fn(i)319 +958 y Fu(k)o(ey)g(with)h Ft(rl_bind_key\(\))p Fu(.)195 +1031 y Ft(int)23 b(rl_bind_key)g(\(int)g Fk(k)o(ey)p +Ft(,)h(rl_command_func_t)d(*)p Fk(function)p Ft(\);)137 +1107 y(rl_bind_key\(\))15 b Fu(tak)o(es)h(t)o(w)o(o)g(argumen)o(ts:)22 b Fk(k)o(ey)e Fu(is)e(the)e(c)o(haracter)g(that)g(y)o(ou)h(w)o(an)o(t)f -(to)g(bind,)i(and)75 1031 y Fk(function)h Fu(is)f(the)g(address)g(of)g +(to)g(bind,)i(and)75 1161 y Fk(function)h Fu(is)f(the)g(address)g(of)g (the)g(function)g(to)g(call)h(when)f Fk(k)o(ey)k Fu(is)c(pressed.)29 -b(Binding)1628 1029 y Fn(h)p 1641 1003 V 1641 1031 a -Fm(T)m(AB)p 1641 1038 V 1712 1029 a Fn(i)1745 1031 y -Fu(to)17 b Ft(rl_)75 1085 y(insert\(\))f Fu(mak)o(es)422 -1083 y Fn(h)p 434 1057 V 434 1085 a Fm(T)m(AB)p 434 1093 -V 506 1083 a Fn(i)539 1085 y Fu(insert)i(itself.)28 b +b(Binding)1628 1159 y Fn(h)p 1641 1133 V 1641 1161 a +Fm(T)m(AB)p 1641 1169 V 1712 1159 a Fn(i)1745 1161 y +Fu(to)17 b Ft(rl_)75 1216 y(insert\(\))f Fu(mak)o(es)422 +1214 y Fn(h)p 434 1188 V 434 1216 a Fm(T)m(AB)p 434 1224 +V 506 1214 a Fn(i)539 1216 y Fu(insert)i(itself.)28 b Ft(rl_bind_key\(\))15 b Fu(returns)j(non-zero)g(if)g -Fk(k)o(ey)j Fu(is)d(not)f(a)g(v)m(alid)75 1140 y(ASCI)q(I)f(c)o +Fk(k)o(ey)j Fu(is)d(not)f(a)g(v)m(alid)75 1271 y(ASCI)q(I)f(c)o (haracter)f(co)q(de)h(\(b)q(et)o(w)o(een)f(0)g(and)g(255\).)137 -1207 y(Th)o(us,)g(to)g(disable)h(the)g(default)703 1205 -y Fn(h)p 716 1179 V 716 1207 a Fm(T)m(AB)p 716 1215 V -787 1205 a Fn(i)817 1207 y Fu(b)q(eha)o(vior,)g(the)f(follo)o(wing)h -(su\016ces:)195 1271 y Ft(rl_bind_key)22 b(\('\\t',)h(rl_insert\);)137 -1338 y Fu(This)14 b(co)q(de)g(should)g(b)q(e)g(executed)g(once)g(at)e +1347 y(Th)o(us,)g(to)g(disable)h(the)g(default)703 1345 +y Fn(h)p 716 1319 V 716 1347 a Fm(T)m(AB)p 716 1354 V +787 1345 a Fn(i)817 1347 y Fu(b)q(eha)o(vior,)g(the)f(follo)o(wing)h +(su\016ces:)195 1420 y Ft(rl_bind_key)22 b(\('\\t',)h(rl_insert\);)137 +1496 y Fu(This)14 b(co)q(de)g(should)g(b)q(e)g(executed)g(once)g(at)e (the)h(start)f(of)h(y)o(our)g(program;)f(y)o(ou)h(migh)o(t)g(write)g(a) -g(func-)75 1393 y(tion)k(called)h Ft(initialize_readline\(\))13 +g(func-)75 1551 y(tion)k(called)h Ft(initialize_readline\(\))13 b Fu(whic)o(h)k(p)q(erforms)f(this)h(and)g(other)f(desired)h -(initializations,)75 1448 y(suc)o(h)f(as)e(installing)k(custom)c +(initializations,)75 1605 y(suc)o(h)f(as)e(installing)k(custom)c (completers)i(\(see)f(Section)h(2.6)f([Custom)f(Completers],)g(page)h -(39\).)75 1575 y Fs(2.2)33 b(Custom)21 b(F)-6 b(unctions)137 -1671 y Fu(Readline)14 b(pro)o(vides)f(man)o(y)e(functions)i(for)f +(41\).)75 1756 y Fs(2.2)33 b(Custom)21 b(F)-6 b(unctions)137 +1861 y Fu(Readline)14 b(pro)o(vides)f(man)o(y)e(functions)i(for)f (manipulating)i(the)e(text)g(of)g(the)g(line,)i(but)e(it)h(isn't)f(p)q -(ossi-)75 1726 y(ble)i(to)f(an)o(ticipate)h(the)f(needs)h(of)f(all)h +(ossi-)75 1915 y(ble)i(to)f(an)o(ticipate)h(the)f(needs)h(of)f(all)h (programs.)k(This)13 b(section)h(describ)q(es)h(the)e(v)m(arious)h -(functions)g(and)75 1781 y(v)m(ariables)g(de\014ned)h(within)f(the)f +(functions)g(and)75 1970 y(v)m(ariables)g(de\014ned)h(within)f(the)f (Readline)i(library)e(whic)o(h)h(allo)o(w)g(a)e(user)h(program)f(to)h -(add)g(customized)75 1836 y(functionalit)o(y)j(to)f(Readline.)137 -1903 y(Before)j(declaring)i(an)o(y)e(functions)h(that)f(customize)g +(add)g(customized)75 2025 y(functionalit)o(y)j(to)f(Readline.)137 +2101 y(Before)j(declaring)i(an)o(y)e(functions)h(that)f(customize)g (Readline's)h(b)q(eha)o(vior,)h(or)d(using)i(an)o(y)f(func-)75 -1958 y(tionalit)o(y)23 b(Readline)h(pro)o(vides)g(in)f(other)g(co)q +2156 y(tionalit)o(y)23 b(Readline)h(pro)o(vides)g(in)f(other)g(co)q (de,)h(an)f(application)i(writer)d(should)i(include)h(the)e(\014le)75 -2012 y Ft(<readline/readline.h>)14 b Fu(in)j(an)o(y)g(\014le)h(that)e +2211 y Ft(<readline/readline.h>)14 b Fu(in)j(an)o(y)g(\014le)h(that)e (uses)h(Readline's)g(features.)24 b(Since)19 b(some)d(of)g(the)h -(de\014-)75 2067 y(nitions)g(in)f Ft(readline.h)e Fu(use)i(the)g +(de\014-)75 2265 y(nitions)g(in)f Ft(readline.h)e Fu(use)i(the)g Ft(stdio)f Fu(library)l(,)h(the)g(\014le)g Ft(<stdio.h>)f -Fu(should)h(b)q(e)g(included)j(b)q(efore)75 2122 y Ft(readline.h)p -Fu(.)137 2189 y Ft(readline.h)14 b Fu(de\014nes)i(a)f(C)h(prepro)q +Fu(should)h(b)q(e)g(included)j(b)q(efore)75 2320 y Ft(readline.h)p +Fu(.)137 2396 y Ft(readline.h)14 b Fu(de\014nes)i(a)f(C)h(prepro)q (cessor)f(v)m(ariable)i(that)d(should)i(b)q(e)g(treated)f(as)g(an)g(in) -o(teger,)g Ft(RL_)75 2244 y(READLINE_VERSION)p Fu(,)9 +o(teger,)g Ft(RL_)75 2451 y(READLINE_VERSION)p Fu(,)9 b(whic)o(h)j(ma)o(y)f(b)q(e)g(used)h(to)e(conditionally)k(compile)e -(application)h(co)q(de)f(dep)q(ending)75 2298 y(on)17 +(application)h(co)q(de)f(dep)q(ending)75 2506 y(on)17 b(the)h(installed)h(Readline)g(v)o(ersion.)27 b(The)18 b(v)m(alue)h(is)f(a)f(hexadecimal)i(enco)q(ding)g(of)e(the)h(ma)s(jor)e -(and)75 2353 y(minor)h(v)o(ersion)h(n)o(um)o(b)q(ers)f(of)g(the)g +(and)75 2560 y(minor)h(v)o(ersion)h(n)o(um)o(b)q(ers)f(of)g(the)g (library)l(,)h(of)f(the)g(form)f(0x)p Fk(MMmm)p Fu(.)25 b Fk(MM)c Fu(is)c(the)h(t)o(w)o(o-digit)e(ma)s(jor)75 -2408 y(v)o(ersion)f(n)o(um)o(b)q(er;)f Fk(mm)h Fu(is)g(the)f(t)o(w)o +2615 y(v)o(ersion)f(n)o(um)o(b)q(er;)f Fk(mm)h Fu(is)g(the)f(t)o(w)o (o-digit)g(minor)h(v)o(ersion)g(n)o(um)o(b)q(er.)20 b(F)l(or)14 -b(Readline)h(4.2,)f(for)f(example,)75 2463 y(the)i(v)m(alue)i(of)d +b(Readline)h(4.2,)f(for)f(example,)75 2670 y(the)i(v)m(alue)i(of)d Ft(RL_READLINE_VERSION)f Fu(w)o(ould)j(b)q(e)f Ft(0x0402)p -Fu(.)75 2574 y Fj(2.2.1)30 b(Readline)20 b(T)n(yp)r(edefs)137 -2670 y Fu(F)l(or)15 b(readabilt)o(y)l(,)g(w)o(e)g(declare)i(a)d(n)o(um) -o(b)q(er)i(of)f(new)g(ob)s(ject)g(t)o(yp)q(es,)g(all)h(p)q(oin)o(ters)f -(to)g(functions.)p eop -%%Page: 21 23 -21 22 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(21)137 149 y(The)18 b(reason)g(for)f(declaring)i(these) -f(new)g(t)o(yp)q(es)g(is)h(to)e(mak)o(e)g(it)h(easier)h(to)e(write)h -(co)q(de)g(describing)75 204 y(p)q(oin)o(ters)e(to)e(C)h(functions)h -(with)g(appropriately)f(protot)o(yp)q(ed)g(argumen)o(ts)g(and)g(return) -g(v)m(alues.)137 271 y(F)l(or)j(instance,)i(sa)o(y)e(w)o(e)g(w)o(an)o -(t)f(to)h(declare)h(a)f(v)m(ariable)i Fk(func)i Fu(as)c(a)g(p)q(oin)o -(ter)h(to)f(a)g(function)h(whic)o(h)75 326 y(tak)o(es)12 -b(t)o(w)o(o)g Ft(int)g Fu(argumen)o(ts)g(and)h(returns)g(an)g -Ft(int)f Fu(\(this)h(is)g(the)g(t)o(yp)q(e)g(of)g(all)g(of)g(the)g -(Readline)h(bindable)75 381 y(functions\).)20 b(Instead)c(of)f(the)g -(classic)h(C)f(declaration)137 447 y Ft(int)g(\(*func\)\(\);)75 -514 y Fu(or)g(the)g(ANSI-C)h(st)o(yle)f(declaration)137 -581 y Ft(int)g(\(*func\)\(int,)f(int\);)75 647 y Fu(w)o(e)h(ma)o(y)f -(write)137 714 y Ft(rl_command_func_t)f(*func;)137 781 -y Fu(The)j(full)g(list)g(of)f(function)h(p)q(oin)o(ter)g(t)o(yp)q(es)f -(a)o(v)m(ailable)i(is)75 859 y Ft(typedef)d(int)h(rl_command_func_t)e -(\(int,)h(int\);)75 926 y(typedef)g(char)h(*rl_compentry_func_t)d -(\(const)j(char)f(*,)h(int\);)75 993 y(typedef)f(char)h -(**rl_completion_func_t)d(\(const)i(char)h(*,)g(int,)f(int\);)75 -1059 y(typedef)g(char)h(*rl_quote_func_t)e(\(char)h(*,)h(int,)g(char)f -(*\);)75 1126 y(typedef)g(char)h(*rl_dequote_func_t)d(\(char)j(*,)g -(int\);)75 1193 y(typedef)f(int)h(rl_compignore_func_t)d(\(char)j -(**\);)75 1259 y(typedef)f(void)h(rl_compdisp_func_t)d(\(char)j(**,)g -(int,)f(int\);)75 1326 y(typedef)g(int)h(rl_hook_func_t)e(\(void\);)75 -1393 y(typedef)h(int)h(rl_getc_func_t)e(\(FILE)i(*\);)75 -1459 y(typedef)f(int)h(rl_linebuf_func_t)e(\(char)h(*,)h(int\);)75 -1526 y(typedef)f(int)h(rl_intfunc_t)e(\(int\);)75 1593 -y(#define)h(rl_ivoidfunc_t)f(rl_hook_func_t)75 1659 y(typedef)h(int)h -(rl_icpfunc_t)e(\(char)i(*\);)75 1726 y(typedef)f(int)h(rl_icppfunc_t)e -(\(char)i(**\);)75 1793 y(typedef)f(void)h(rl_voidfunc_t)e(\(void\);)75 -1859 y(typedef)h(void)h(rl_vintfunc_t)e(\(int\);)75 1926 -y(typedef)h(void)h(rl_vcpfunc_t)e(\(char)i(*\);)75 1993 +Fu(.)p eop +%%Page: 23 25 +23 24 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(23)75 149 y Fj(2.2.1)30 b(Readline)20 +b(T)n(yp)r(edefs)137 251 y Fu(F)l(or)15 b(readabilt)o(y)l(,)g(w)o(e)g +(declare)i(a)d(n)o(um)o(b)q(er)i(of)f(new)g(ob)s(ject)g(t)o(yp)q(es,)g +(all)h(p)q(oin)o(ters)f(to)g(functions.)137 324 y(The)j(reason)g(for)f +(declaring)i(these)f(new)g(t)o(yp)q(es)g(is)h(to)e(mak)o(e)g(it)h +(easier)h(to)e(write)h(co)q(de)g(describing)75 379 y(p)q(oin)o(ters)e +(to)e(C)h(functions)h(with)g(appropriately)f(protot)o(yp)q(ed)g +(argumen)o(ts)g(and)g(return)g(v)m(alues.)137 452 y(F)l(or)j(instance,) +i(sa)o(y)e(w)o(e)g(w)o(an)o(t)f(to)h(declare)h(a)f(v)m(ariable)i +Fk(func)i Fu(as)c(a)g(p)q(oin)o(ter)h(to)f(a)g(function)h(whic)o(h)75 +507 y(tak)o(es)12 b(t)o(w)o(o)g Ft(int)g Fu(argumen)o(ts)g(and)h +(returns)g(an)g Ft(int)f Fu(\(this)h(is)g(the)g(t)o(yp)q(e)g(of)g(all)g +(of)g(the)g(Readline)h(bindable)75 561 y(functions\).)20 +b(Instead)c(of)f(the)g(classic)h(C)f(declaration)137 +634 y Ft(int)g(\(*func\)\(\);)75 707 y Fu(or)g(the)g(ANSI-C)h(st)o(yle) +f(declaration)137 780 y Ft(int)g(\(*func\)\(int,)f(int\);)75 +853 y Fu(w)o(e)h(ma)o(y)f(write)137 926 y Ft(rl_command_func_t)f +(*func;)137 999 y Fu(The)j(full)g(list)g(of)f(function)h(p)q(oin)o(ter) +g(t)o(yp)q(es)f(a)o(v)m(ailable)i(is)75 1087 y Ft(typedef)d(int)h +(rl_command_func_t)e(\(int,)h(int\);)75 1157 y(typedef)g(char)h +(*rl_compentry_func_t)d(\(const)j(char)f(*,)h(int\);)75 +1227 y(typedef)f(char)h(**rl_completion_func_t)d(\(const)i(char)h(*,)g +(int,)f(int\);)75 1297 y(typedef)g(char)h(*rl_quote_func_t)e(\(char)h +(*,)h(int,)g(char)f(*\);)75 1367 y(typedef)g(char)h(*rl_dequote_func_t) +d(\(char)j(*,)g(int\);)75 1437 y(typedef)f(int)h(rl_compignore_func_t)d +(\(char)j(**\);)75 1507 y(typedef)f(void)h(rl_compdisp_func_t)d(\(char) +j(**,)g(int,)f(int\);)75 1577 y(typedef)g(int)h(rl_hook_func_t)e +(\(void\);)75 1647 y(typedef)h(int)h(rl_getc_func_t)e(\(FILE)i(*\);)75 +1717 y(typedef)f(int)h(rl_linebuf_func_t)e(\(char)h(*,)h(int\);)75 +1787 y(typedef)f(int)h(rl_intfunc_t)e(\(int\);)75 1857 +y(#define)h(rl_ivoidfunc_t)f(rl_hook_func_t)75 1927 y(typedef)h(int)h +(rl_icpfunc_t)e(\(char)i(*\);)75 1997 y(typedef)f(int)h(rl_icppfunc_t)e +(\(char)i(**\);)75 2067 y(typedef)f(void)h(rl_voidfunc_t)e(\(void\);)75 +2137 y(typedef)h(void)h(rl_vintfunc_t)e(\(int\);)75 2208 +y(typedef)h(void)h(rl_vcpfunc_t)e(\(char)i(*\);)75 2278 y(typedef)f(void)h(rl_vcppfunc_t)e(\(char)i(**\);)75 -2091 y Fj(2.2.2)30 b(W)-5 b(riting)20 b(a)h(New)f(F)-5 -b(unction)137 2187 y Fu(In)17 b(order)f(to)f(write)h(new)h(functions)g +2386 y Fj(2.2.2)30 b(W)-5 b(riting)20 b(a)h(New)f(F)-5 +b(unction)137 2488 y Fu(In)17 b(order)f(to)f(write)h(new)h(functions)g (for)e(Readline,)i(y)o(ou)f(need)h(to)e(kno)o(w)h(the)g(calling)i(con)o -(v)o(en)o(tions)75 2242 y(for)g(k)o(eyb)q(oard-in)o(v)o(ok)o(ed)h +(v)o(en)o(tions)75 2542 y(for)g(k)o(eyb)q(oard-in)o(v)o(ok)o(ed)h (functions,)g(and)g(the)f(names)h(of)f(the)g(v)m(ariables)i(that)d -(describ)q(e)k(the)d(curren)o(t)75 2297 y(state)c(of)h(the)g(line)i -(read)e(so)g(far.)137 2363 y(The)h(calling)h(sequence)f(for)f(a)f -(command)i Ft(foo)e Fu(lo)q(oks)i(lik)o(e)195 2427 y -Ft(foo)23 b(\(int)h(count,)f(int)g(key\))75 2494 y Fu(where)18 -b Fk(coun)o(t)h Fu(is)f(the)g(n)o(umeric)h(argumen)o(t)e(\(or)h(1)f(if) -i(defaulted\))f(and)g Fk(k)o(ey)k Fu(is)d(the)f(k)o(ey)g(that)f(in)o(v) -o(ok)o(ed)75 2549 y(this)f(function.)137 2615 y(It)c(is)g(completely)h -(up)f(to)f(the)g(function)i(as)e(to)g(what)g(should)h(b)q(e)g(done)g -(with)g(the)g(n)o(umeric)g(argumen)o(t.)75 2670 y(Some)20 -b(functions)h(use)f(it)g(as)g(a)g(rep)q(eat)g(coun)o(t,)g(some)g(as)g -(a)f(\015ag,)i(and)f(others)g(to)f(c)o(ho)q(ose)h(alternate)p +(describ)q(e)k(the)d(curren)o(t)75 2597 y(state)c(of)h(the)g(line)i +(read)e(so)g(far.)137 2670 y(The)h(calling)h(sequence)f(for)f(a)f +(command)i Ft(foo)e Fu(lo)q(oks)i(lik)o(e)p eop +%%Page: 24 26 +24 25 bop 75 -58 a Fu(24)1299 b(GNU)15 b(Readline)h(Library)195 +149 y Ft(int)23 b(foo)h(\(int)f(count,)g(int)h(key\))75 +221 y Fu(where)18 b Fk(coun)o(t)h Fu(is)f(the)g(n)o(umeric)h(argumen)o +(t)e(\(or)h(1)f(if)i(defaulted\))f(and)g Fk(k)o(ey)k +Fu(is)d(the)f(k)o(ey)g(that)f(in)o(v)o(ok)o(ed)75 276 +y(this)f(function.)137 348 y(It)c(is)g(completely)h(up)f(to)f(the)g +(function)i(as)e(to)g(what)g(should)h(b)q(e)g(done)g(with)g(the)g(n)o +(umeric)g(argumen)o(t.)75 403 y(Some)20 b(functions)h(use)f(it)g(as)g +(a)g(rep)q(eat)g(coun)o(t,)g(some)g(as)g(a)f(\015ag,)i(and)f(others)g +(to)f(c)o(ho)q(ose)h(alternate)75 457 y(b)q(eha)o(vior)i(\(refreshing)g +(the)g(curren)o(t)f(line)j(as)d(opp)q(osed)h(to)f(refreshing)i(the)e +(screen,)j(for)d(example\).)75 512 y(Some)c(c)o(ho)q(ose)f(to)g(ignore) +h(it.)24 b(In)18 b(general,)f(if)g(a)f(function)h(uses)g(the)g(n)o +(umeric)h(argumen)o(t)d(as)i(a)f(rep)q(eat)75 567 y(coun)o(t,)e(it)g +(should)h(b)q(e)f(able)h(to)e(do)h(something)h(useful)g(with)f(b)q(oth) +g(negativ)o(e)g(and)g(p)q(ositiv)o(e)h(argumen)o(ts.)75 +622 y(A)o(t)g(the)g(v)o(ery)g(least,)g(it)g(should)h(b)q(e)g(a)o(w)o +(are)e(that)h(it)g(can)g(b)q(e)h(passed)g(a)f(negativ)o(e)g(argumen)o +(t.)137 693 y(A)f(command)g(function)h(should)g(return)e(0)h(if)g(its)g +(action)h(completes)f(successfully)l(,)i(and)e(a)g(non-zero)75 +748 y(v)m(alue)i(if)g(some)f(error)f(o)q(ccurs.)75 888 +y Fs(2.3)33 b(Readline)23 b(V)-6 b(ariables)137 989 y +Fu(These)16 b(v)m(ariables)g(are)f(a)o(v)m(ailable)i(to)e(function)h +(writers.)1773 1120 y(V)l(ariable)-1861 b Fi(char)20 +b(*)f Fh(rl)p 286 1120 18 3 v 21 w(line)p 395 1120 V +23 w(bu\013er)195 1174 y Fu(This)d(is)g(the)g(line)h(gathered)f(so)f +(far.)20 b(Y)l(ou)c(are)f(w)o(elcome)h(to)f(mo)q(dify)h(the)g(con)o +(ten)o(ts)f(of)g(the)h(line,)195 1229 y(but)i(see)g(Section)h(2.4.5)d +([Allo)o(wing)i(Undoing],)h(page)e(32.)27 b(The)18 b(function)h +Ft(rl_extend_line_)195 1284 y(buffer)14 b Fu(is)i(a)o(v)m(ailable)h(to) +d(increase)j(the)e(memory)f(allo)q(cated)j(to)d Ft(rl_line_buffer)p +Fu(.)1773 1414 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p +215 1414 V 21 w(p)r(oin)n(t)195 1469 y Fu(The)15 b(o\013set)g(of)f(the) +i(curren)o(t)f(cursor)g(p)q(osition)h(in)g Ft(rl_line_buffer)d +Fu(\(the)i Fl(p)n(oint)t Fu(\).)1773 1600 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1600 V 21 w(end)195 1655 y +Fu(The)14 b(n)o(um)o(b)q(er)g(of)g(c)o(haracters)f(presen)o(t)h(in)h +Ft(rl_line_buffer)p Fu(.)i(When)e Ft(rl_point)e Fu(is)h(at)f(the)h(end) +195 1709 y(of)h(the)g(line,)i Ft(rl_point)d Fu(and)h +Ft(rl_end)f Fu(are)h(equal.)1773 1840 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1840 V 21 w(mark)195 1895 y +Fu(The)f Fk(mark)h Fu(\(sa)o(v)o(ed)e(p)q(osition\))h(in)g(the)g +(curren)o(t)f(line.)31 b(If)19 b(set,)g(the)f(mark)g(and)h(p)q(oin)o(t) +g(de\014ne)g(a)195 1950 y Fl(r)n(e)n(gion)p Fu(.)1773 +2080 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 2080 +V 21 w(done)195 2135 y Fu(Setting)11 b(this)g(to)g(a)f(non-zero)h(v)m +(alue)h(causes)f(Readline)h(to)f(return)f(the)h(curren)o(t)g(line)h +(immediately)l(.)1773 2265 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 2265 V 21 w(n)n(um)p 347 2265 V 19 w(c)n(hars)p +496 2265 V 20 w(to)p 567 2265 V 21 w(read)195 2320 y +Fu(Setting)d(this)g(to)f(a)g(p)q(ositiv)o(e)h(v)m(alue)h(b)q(efore)f +(calling)h Ft(readline\(\))d Fu(causes)h(Readline)i(to)e(return)195 +2375 y(after)h(accepting)i(that)e(man)o(y)g(c)o(haracters,)h(rather)f +(than)h(reading)g(up)g(to)f(a)h(c)o(haracter)f(b)q(ound)195 +2430 y(to)e Ft(accept-line)p Fu(.)1773 2560 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 2560 V 21 w(p)r(ending)p 436 +2560 V 20 w(input)195 2615 y Fu(Setting)13 b(this)g(to)f(a)g(v)m(alue)i +(mak)o(es)e(it)h(the)f(next)h(k)o(eystrok)o(e)f(read.)19 +b(This)13 b(is)g(a)f(w)o(a)o(y)g(to)f(stu\013)h(a)h(single)195 +2670 y(c)o(haracter)h(in)o(to)i(the)f(input)h(stream.)p eop -%%Page: 22 24 -22 23 bop 75 -58 a Fu(22)1299 b(GNU)15 b(Readline)h(Library)75 -149 y(b)q(eha)o(vior)22 b(\(refreshing)g(the)g(curren)o(t)f(line)j(as)d -(opp)q(osed)h(to)f(refreshing)i(the)e(screen,)j(for)d(example\).)75 -204 y(Some)c(c)o(ho)q(ose)f(to)g(ignore)h(it.)24 b(In)18 -b(general,)f(if)g(a)f(function)h(uses)g(the)g(n)o(umeric)h(argumen)o(t) -d(as)i(a)f(rep)q(eat)75 259 y(coun)o(t,)e(it)g(should)h(b)q(e)f(able)h -(to)e(do)h(something)h(useful)g(with)f(b)q(oth)g(negativ)o(e)g(and)g(p) -q(ositiv)o(e)h(argumen)o(ts.)75 314 y(A)o(t)g(the)g(v)o(ery)g(least,)g -(it)g(should)h(b)q(e)g(a)o(w)o(are)e(that)h(it)g(can)g(b)q(e)h(passed)g -(a)f(negativ)o(e)g(argumen)o(t.)75 438 y Fs(2.3)33 b(Readline)23 -b(V)-6 b(ariables)137 533 y Fu(These)16 b(v)m(ariables)g(are)f(a)o(v)m -(ailable)i(to)e(function)h(writers.)1773 642 y(V)l(ariable)-1861 -b Fi(char)20 b(*)f Fh(rl)p 286 642 18 3 v 21 w(line)p -395 642 V 23 w(bu\013er)195 697 y Fu(This)d(is)g(the)g(line)h(gathered) -f(so)f(far.)20 b(Y)l(ou)c(are)f(w)o(elcome)h(to)f(mo)q(dify)h(the)g -(con)o(ten)o(ts)f(of)g(the)h(line,)195 752 y(but)i(see)g(Section)h -(2.4.5)d([Allo)o(wing)i(Undoing],)h(page)e(29.)27 b(The)18 -b(function)h Ft(rl_extend_line_)195 807 y(buffer)14 b -Fu(is)i(a)o(v)m(ailable)h(to)d(increase)j(the)e(memory)f(allo)q(cated)j -(to)d Ft(rl_line_buffer)p Fu(.)1773 916 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 916 V 21 w(p)r(oin)n(t)195 -971 y Fu(The)15 b(o\013set)g(of)f(the)i(curren)o(t)f(cursor)g(p)q -(osition)h(in)g Ft(rl_line_buffer)d Fu(\(the)i Fl(p)n(oint)t -Fu(\).)1773 1081 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p -215 1081 V 21 w(end)195 1136 y Fu(The)14 b(n)o(um)o(b)q(er)g(of)g(c)o -(haracters)f(presen)o(t)h(in)h Ft(rl_line_buffer)p Fu(.)i(When)e -Ft(rl_point)e Fu(is)h(at)f(the)h(end)195 1190 y(of)h(the)g(line,)i -Ft(rl_point)d Fu(and)h Ft(rl_end)f Fu(are)h(equal.)1773 -1300 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1300 -V 21 w(mark)195 1355 y Fu(The)f Fk(mark)h Fu(\(sa)o(v)o(ed)e(p)q -(osition\))h(in)g(the)g(curren)o(t)f(line.)31 b(If)19 -b(set,)g(the)f(mark)g(and)h(p)q(oin)o(t)g(de\014ne)g(a)195 -1410 y Fl(r)n(e)n(gion)p Fu(.)1773 1519 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 1519 V 21 w(done)195 1574 y -Fu(Setting)11 b(this)g(to)g(a)f(non-zero)h(v)m(alue)h(causes)f -(Readline)h(to)f(return)f(the)h(curren)o(t)g(line)h(immediately)l(.) -1773 1684 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 -1684 V 21 w(n)n(um)p 347 1684 V 19 w(c)n(hars)p 496 1684 -V 20 w(to)p 567 1684 V 21 w(read)195 1738 y Fu(Setting)d(this)g(to)f(a) -g(p)q(ositiv)o(e)h(v)m(alue)h(b)q(efore)f(calling)h Ft(readline\(\))d -Fu(causes)h(Readline)i(to)e(return)195 1793 y(after)h(accepting)i(that) -e(man)o(y)g(c)o(haracters,)h(rather)f(than)h(reading)g(up)g(to)f(a)h(c) -o(haracter)f(b)q(ound)195 1848 y(to)e Ft(accept-line)p -Fu(.)1773 1958 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p -215 1958 V 21 w(p)r(ending)p 436 1958 V 20 w(input)195 -2012 y Fu(Setting)13 b(this)g(to)f(a)g(v)m(alue)i(mak)o(es)e(it)h(the)f -(next)h(k)o(eystrok)o(e)f(read.)19 b(This)13 b(is)g(a)f(w)o(a)o(y)g(to) -f(stu\013)h(a)h(single)195 2067 y(c)o(haracter)h(in)o(to)i(the)f(input) -h(stream.)1773 2177 y(V)l(ariable)-1861 b Fi(int)20 b -Fh(rl)p 215 2177 V 21 w(dispatc)n(hing)195 2232 y Fu(Set)12 -b(to)g(a)f(non-zero)i(v)m(alue)g(if)g(a)f(function)h(is)f(b)q(eing)i -(called)f(from)f(a)f(k)o(ey)h(binding;)j(zero)d(otherwise.)195 -2286 y(Application)20 b(functions)e(can)g(test)g(this)g(to)f(disco)o(v) -o(er)h(whether)g(they)g(w)o(ere)g(called)h(directly)g(or)195 -2341 y(b)o(y)c(Readline's)h(dispatc)o(hing)h(mec)o(hanism.)1773 -2451 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 2451 -V 21 w(erase)p 363 2451 V 20 w(empt)n(y)p 540 2451 V -20 w(line)195 2506 y Fu(Setting)j(this)h(to)e(a)h(non-zero)g(v)m(alue)h +%%Page: 25 27 +25 26 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(25)1773 149 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 149 18 3 v 21 w(dispatc)n(hing)195 204 +y Fu(Set)12 b(to)g(a)f(non-zero)i(v)m(alue)g(if)g(a)f(function)h(is)f +(b)q(eing)i(called)f(from)f(a)f(k)o(ey)h(binding;)j(zero)d(otherwise.) +195 259 y(Application)20 b(functions)e(can)g(test)g(this)g(to)f(disco)o +(v)o(er)h(whether)g(they)g(w)o(ere)g(called)h(directly)g(or)195 +314 y(b)o(y)c(Readline's)h(dispatc)o(hing)h(mec)o(hanism.)1773 +423 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 423 +V 21 w(erase)p 363 423 V 20 w(empt)n(y)p 540 423 V 20 +w(line)195 478 y Fu(Setting)j(this)h(to)e(a)h(non-zero)g(v)m(alue)h (causes)f(Readline)i(to)d(completely)i(erase)f(the)g(curren)o(t)195 -2560 y(line,)g(including)h(an)o(y)c(prompt,)h(an)o(y)g(time)g(a)f +533 y(line,)g(including)h(an)o(y)c(prompt,)h(an)o(y)g(time)g(a)f (newline)j(is)e(t)o(yp)q(ed)g(as)f(the)h(only)g(c)o(haracter)f(on)195 -2615 y(an)e(otherwise-empt)o(y)g(line.)31 b(The)18 b(cursor)g(is)h(mo)o +588 y(an)e(otherwise-empt)o(y)g(line.)31 b(The)18 b(cursor)g(is)h(mo)o (v)o(ed)e(to)h(the)g(b)q(eginning)i(of)e(the)g(newly-blank)195 -2670 y(line.)p eop -%%Page: 23 25 -23 24 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(23)1773 149 y(V)l(ariable)-1861 b Fi(char)20 -b(*)f Fh(rl)p 286 149 18 3 v 21 w(prompt)195 204 y Fu(The)13 +643 y(line.)1773 752 y(V)l(ariable)-1861 b Fi(char)20 +b(*)f Fh(rl)p 286 752 V 21 w(prompt)195 807 y Fu(The)13 b(prompt)g(Readline)h(uses.)20 b(This)13 b(is)h(set)f(from)f(the)h (argumen)o(t)g(to)f Ft(readline\(\))p Fu(,)g(and)h(should)195 -259 y(not)g(b)q(e)h(assigned)g(to)f(directly)l(.)21 b(The)14 +862 y(not)g(b)q(e)h(assigned)g(to)f(directly)l(.)21 b(The)14 b Ft(rl_set_prompt\(\))d Fu(function)j(\(see)g(Section)g(2.4.6)e -([Redis-)195 314 y(pla)o(y],)j(page)g(30\))f(ma)o(y)h(b)q(e)g(used)h +([Redis-)195 917 y(pla)o(y],)j(page)g(33\))f(ma)o(y)h(b)q(e)g(used)h (to)f(mo)q(dify)h(the)f(prompt)g(string)g(after)f(calling)j -Ft(readline\(\))p Fu(.)1773 429 y(V)l(ariable)-1861 b -Fi(int)20 b Fh(rl)p 215 429 V 21 w(already)p 419 429 -V 21 w(prompted)195 484 y Fu(If)e(an)g(application)i(wishes)f(to)f +Ft(readline\(\))p Fu(.)1773 1026 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1026 V 21 w(already)p 419 1026 +V 21 w(prompted)195 1081 y Fu(If)e(an)g(application)i(wishes)f(to)f (displa)o(y)h(the)f(prompt)g(itself,)h(rather)f(than)g(ha)o(v)o(e)g -(Readline)h(do)195 538 y(it)e(the)f(\014rst)g(time)h +(Readline)h(do)195 1136 y(it)e(the)f(\014rst)g(time)h Ft(readline\(\))e Fu(is)i(called,)h(it)e(should)i(set)e(this)h(v)m -(ariable)g(to)f(a)g(non-zero)h(v)m(alue)195 593 y(after)h(displa)o +(ariable)g(to)f(a)g(non-zero)h(v)m(alue)195 1191 y(after)h(displa)o (ying)j(the)e(prompt.)31 b(The)19 b(prompt)g(m)o(ust)f(also)h(b)q(e)h -(passed)f(as)f(the)h(argumen)o(t)g(to)195 648 y Ft(readline\(\))c +(passed)f(as)f(the)h(argumen)o(t)g(to)195 1245 y Ft(readline\(\))c Fu(so)h(the)h(redispla)o(y)g(functions)h(can)e(up)q(date)h(the)g (displa)o(y)h(prop)q(erly)l(.)24 b(The)17 b(calling)195 -703 y(application)g(is)f(resp)q(onsible)h(for)d(managing)h(the)h(v)m -(alue;)g(Readline)g(nev)o(er)g(sets)e(it.)1773 818 y(V)l(ariable)-1861 -b Fi(const)20 b(char)g(*)f Fh(rl)p 436 818 V 21 w(library)p -625 818 V 21 w(v)n(ersion)195 873 y Fu(The)c(v)o(ersion)h(n)o(um)o(b)q -(er)f(of)g(this)h(revision)g(of)f(the)g(library)l(.)1773 -988 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 988 -V 21 w(readline)p 434 988 V 22 w(v)n(ersion)195 1043 +1300 y(application)g(is)f(resp)q(onsible)h(for)d(managing)h(the)h(v)m +(alue;)g(Readline)g(nev)o(er)g(sets)e(it.)1773 1410 y(V)l(ariable)-1861 +b Fi(const)20 b(char)g(*)f Fh(rl)p 436 1410 V 21 w(library)p +625 1410 V 21 w(v)n(ersion)195 1465 y Fu(The)c(v)o(ersion)h(n)o(um)o(b) +q(er)f(of)g(this)h(revision)g(of)f(the)g(library)l(.)1773 +1574 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1574 +V 21 w(readline)p 434 1574 V 22 w(v)n(ersion)195 1629 y Fu(An)d(in)o(teger)h(enco)q(ding)g(the)f(curren)o(t)g(v)o(ersion)g (of)g(the)g(library)l(.)27 b(The)17 b(enco)q(ding)h(is)g(of)f(the)g -(form)195 1097 y(0x)p Fk(MMmm)p Fu(,)g(where)i Fk(MM)j +(form)195 1684 y(0x)p Fk(MMmm)p Fu(,)g(where)i Fk(MM)j Fu(is)d(the)f(t)o(w)o(o-digit)g(ma)s(jor)f(v)o(ersion)i(n)o(um)o(b)q -(er,)g(and)f Fk(mm)g Fu(is)h(the)f(t)o(w)o(o-)195 1152 +(er,)g(and)f Fk(mm)g Fu(is)h(the)f(t)o(w)o(o-)195 1738 y(digit)i(minor)e(v)o(ersion)h(n)o(um)o(b)q(er.)31 b(F)l(or)18 b(example,)i(for)e(Readline-4.2,)i Ft(rl_readline_version)195 -1207 y Fu(w)o(ould)c(ha)o(v)o(e)e(the)i(v)m(alue)g(0x0402.)1773 -1322 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1322 -V 21 w(gn)n(u)p 327 1322 V 20 w(readline)p 545 1322 V -22 w(p)195 1377 y Fu(Alw)o(a)o(ys)15 b(set)g(to)f(1,)h(denoting)h(that) +1793 y Fu(w)o(ould)c(ha)o(v)o(e)e(the)i(v)m(alue)g(0x0402.)1773 +1903 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1903 +V 21 w(gn)n(u)p 327 1903 V 20 w(readline)p 545 1903 V +22 w(p)195 1958 y Fu(Alw)o(a)o(ys)15 b(set)g(to)f(1,)h(denoting)h(that) e(this)i(is)g Fp(gnu)f Fu(readline)h(rather)f(than)g(some)g(em)o -(ulation.)1773 1492 y(V)l(ariable)-1861 b Fi(const)20 -b(char)g(*)f Fh(rl)p 436 1492 V 21 w(terminal)p 668 1492 -V 21 w(name)195 1547 y Fu(The)14 b(terminal)h(t)o(yp)q(e,)f(used)h(for) +(ulation.)1773 2067 y(V)l(ariable)-1861 b Fi(const)20 +b(char)g(*)f Fh(rl)p 436 2067 V 21 w(terminal)p 668 2067 +V 21 w(name)195 2122 y Fu(The)14 b(terminal)h(t)o(yp)q(e,)f(used)h(for) e(initialization.)23 b(If)14 b(not)f(set)h(b)o(y)g(the)g(application,)i -(Readline)f(sets)195 1601 y(this)h(to)e(the)h(v)m(alue)i(of)e(the)g +(Readline)f(sets)195 2177 y(this)h(to)e(the)h(v)m(alue)i(of)e(the)g Ft(TERM)g Fu(en)o(vironmen)o(t)g(v)m(ariable)i(the)e(\014rst)g(time)g -(it)h(is)f(called.)1773 1717 y(V)l(ariable)-1861 b Fi(const)20 -b(char)g(*)f Fh(rl)p 436 1717 V 21 w(readline)p 655 1717 -V 22 w(name)195 1771 y Fu(This)d(v)m(ariable)h(is)f(set)g(to)f(a)g +(it)h(is)f(called.)1773 2286 y(V)l(ariable)-1861 b Fi(const)20 +b(char)g(*)f Fh(rl)p 436 2286 V 21 w(readline)p 655 2286 +V 22 w(name)195 2341 y Fu(This)d(v)m(ariable)h(is)f(set)g(to)f(a)g (unique)i(name)f(b)o(y)f(eac)o(h)h(application)h(using)f(Readline.)23 -b(The)16 b(v)m(alue)195 1826 y(allo)o(ws)e(conditional)i(parsing)e(of)g +b(The)16 b(v)m(alue)195 2396 y(allo)o(ws)e(conditional)i(parsing)e(of)g (the)g(inputrc)h(\014le)g(\(see)f(Section)h(1.3.2)d([Conditional)j -(Init)g(Con-)195 1881 y(structs],)f(page)h(8\).)1773 -1996 y(V)l(ariable)-1861 b Fi(FILE)20 b(*)f Fh(rl)p 286 -1996 V 21 w(instream)195 2051 y Fu(The)c(stdio)h(stream)e(from)h(whic)o -(h)h(Readline)g(reads)f(input.)1773 2166 y(V)l(ariable)-1861 -b Fi(FILE)20 b(*)f Fh(rl)p 286 2166 V 21 w(outstream)195 -2221 y Fu(The)c(stdio)h(stream)e(to)h(whic)o(h)h(Readline)g(p)q -(erforms)f(output.)1773 2336 y(V)l(ariable)-1861 b Fi -(rl_command_func_t)22 b(*)d Fh(rl)p 626 2336 V 21 w(last)p -735 2336 V 21 w(func)195 2391 y Fu(The)f(address)f(of)g(the)g(last)h -(command)f(function)h(Readline)h(executed.)27 b(Ma)o(y)17 -b(b)q(e)h(used)g(to)f(test)195 2445 y(whether)e(or)g(not)g(a)g -(function)h(is)f(b)q(eing)i(executed)f(t)o(wice)g(in)g(succession,)g -(for)e(example.)1773 2560 y(V)l(ariable)-1861 b Fi(rl_hook_func_t)21 -b(*)e Fh(rl)p 547 2560 V 22 w(startup)p 752 2560 V 19 -w(ho)r(ok)195 2615 y Fu(If)e(non-zero,)h(this)g(is)f(the)h(address)f -(of)f(a)h(function)h(to)f(call)h(just)f(b)q(efore)g Ft(readline)f -Fu(prin)o(ts)i(the)195 2670 y(\014rst)d(prompt.)p eop -%%Page: 24 26 -24 25 bop 75 -58 a Fu(24)1299 b(GNU)15 b(Readline)h(Library)1773 -149 y(V)l(ariable)-1861 b Fi(rl_hook_func_t)21 b(*)e -Fh(rl)p 547 149 18 3 v 22 w(pre)p 651 149 V 20 w(input)p -804 149 V 21 w(ho)r(ok)195 204 y Fu(If)f(non-zero,)g(this)g(is)h(the)f +(Init)g(Con-)195 2451 y(structs],)f(page)h(9\).)1773 +2560 y(V)l(ariable)-1861 b Fi(FILE)20 b(*)f Fh(rl)p 286 +2560 V 21 w(instream)195 2615 y Fu(The)i(stdio)f(stream)g(from)g(whic)o +(h)h(Readline)h(reads)e(input.)37 b(If)21 b Ft(NULL)p +Fu(,)g(Readline)h(defaults)f(to)195 2670 y Fk(stdin)p +Fu(.)p eop +%%Page: 26 28 +26 27 bop 75 -58 a Fu(26)1299 b(GNU)15 b(Readline)h(Library)1773 +149 y(V)l(ariable)-1861 b Fi(FILE)20 b(*)f Fh(rl)p 286 +149 18 3 v 21 w(outstream)195 204 y Fu(The)e(stdio)h(stream)e(to)h +(whic)o(h)h(Readline)g(p)q(erforms)f(output.)26 b(If)18 +b Ft(NULL)p Fu(,)e(Readline)j(defaults)f(to)195 259 y +Fk(stdout)p Fu(.)1773 381 y(V)l(ariable)-1861 b Fi(rl_command_func_t)22 +b(*)d Fh(rl)p 626 381 V 21 w(last)p 735 381 V 21 w(func)195 +436 y Fu(The)f(address)f(of)g(the)g(last)h(command)f(function)h +(Readline)h(executed.)27 b(Ma)o(y)17 b(b)q(e)h(used)g(to)f(test)195 +490 y(whether)e(or)g(not)g(a)g(function)h(is)f(b)q(eing)i(executed)f(t) +o(wice)g(in)g(succession,)g(for)e(example.)1773 612 y(V)l(ariable)-1861 +b Fi(rl_hook_func_t)21 b(*)e Fh(rl)p 547 612 V 22 w(startup)p +752 612 V 19 w(ho)r(ok)195 667 y Fu(If)e(non-zero,)h(this)g(is)f(the)h +(address)f(of)f(a)h(function)h(to)f(call)h(just)f(b)q(efore)g +Ft(readline)f Fu(prin)o(ts)i(the)195 722 y(\014rst)d(prompt.)1773 +844 y(V)l(ariable)-1861 b Fi(rl_hook_func_t)21 b(*)e +Fh(rl)p 547 844 V 22 w(pre)p 651 844 V 20 w(input)p 804 +844 V 21 w(ho)r(ok)195 898 y Fu(If)f(non-zero,)g(this)g(is)h(the)f (address)f(of)h(a)f(function)i(to)e(call)i(after)e(the)h(\014rst)f -(prompt)g(has)h(b)q(een)195 259 y(prin)o(ted)e(and)f(just)g(b)q(efore)h +(prompt)g(has)h(b)q(een)195 953 y(prin)o(ted)e(and)f(just)g(b)q(efore)h Ft(readline)e Fu(starts)g(reading)h(input)i(c)o(haracters.)1773 -375 y(V)l(ariable)-1861 b Fi(rl_hook_func_t)21 b(*)e -Fh(rl)p 547 375 V 22 w(ev)n(en)n(t)p 701 375 V 22 w(ho)r(ok)195 -430 y Fu(If)i(non-zero,)g(this)g(is)g(the)f(address)g(of)g(a)g +1075 y(V)l(ariable)-1861 b Fi(rl_hook_func_t)21 b(*)e +Fh(rl)p 547 1075 V 22 w(ev)n(en)n(t)p 701 1075 V 22 w(ho)r(ok)195 +1130 y Fu(If)i(non-zero,)g(this)g(is)g(the)f(address)g(of)g(a)g (function)h(to)f(call)i(p)q(erio)q(dically)h(when)e(Readline)g(is)195 -484 y(w)o(aiting)15 b(for)f(terminal)h(input.)21 b(By)14 +1184 y(w)o(aiting)15 b(for)f(terminal)h(input.)21 b(By)14 b(default,)h(this)g(will)i(b)q(e)e(called)h(at)e(most)g(ten)g(times)h -(a)f(second)195 539 y(if)i(there)f(is)h(no)f(k)o(eyb)q(oard)g(input.) -1773 655 y(V)l(ariable)-1861 b Fi(rl_getc_func_t)21 b(*)e -Fh(rl)p 547 655 V 22 w(getc)p 671 655 V 21 w(function)195 -710 y Fu(If)c(non-zero,)h(Readline)g(will)h(call)f(indirectly)i +(a)f(second)195 1239 y(if)i(there)f(is)h(no)f(k)o(eyb)q(oard)g(input.) +1773 1361 y(V)l(ariable)-1861 b Fi(rl_getc_func_t)21 +b(*)e Fh(rl)p 547 1361 V 22 w(getc)p 671 1361 V 21 w(function)195 +1416 y Fu(If)c(non-zero,)h(Readline)g(will)h(call)f(indirectly)i (through)d(this)g(p)q(oin)o(ter)h(to)f(get)f(a)h(c)o(haracter)g(from) -195 764 y(the)k(input)i(stream.)31 b(By)19 b(default,)h(it)g(is)g(set)f -(to)f Ft(rl_getc)p Fu(,)h(the)g(default)h(Readline)h(c)o(haracter)195 -819 y(input)16 b(function)g(\(see)f(Section)h(2.4.8)e([Character)g -(Input],)h(page)g(32\).)1773 935 y(V)l(ariable)-1861 -b Fi(rl_voidfunc_t)21 b(*)e Fh(rl)p 521 935 V 21 w(redispla)n(y)p -765 935 V 22 w(function)195 990 y Fu(If)f(non-zero,)h(Readline)g(will)h -(call)f(indirectly)h(through)e(this)g(p)q(oin)o(ter)h(to)e(up)q(date)i -(the)f(displa)o(y)195 1044 y(with)c(the)f(curren)o(t)h(con)o(ten)o(ts)f -(of)g(the)g(editing)i(bu\013er.)k(By)14 b(default,)g(it)g(is)g(set)f -(to)g Ft(rl_redisplay)p Fu(,)195 1099 y(the)i(default)h(Readline)h -(redispla)o(y)f(function)g(\(see)f(Section)h(2.4.6)e([Redispla)o(y],)h -(page)g(30\).)1773 1215 y(V)l(ariable)-1861 b Fi(rl_vintfunc_t)21 -b(*)e Fh(rl)p 521 1215 V 21 w(prep)p 656 1215 V 21 w(term)p -798 1215 V 19 w(function)195 1270 y Fu(If)12 b(non-zero,)h(Readline)g -(will)h(call)f(indirectly)h(through)e(this)g(p)q(oin)o(ter)h(to)e -(initialize)k(the)e(terminal.)195 1324 y(The)19 b(function)g(tak)o(es)f -(a)g(single)i(argumen)o(t,)e(an)h Ft(int)f Fu(\015ag)g(that)g(sa)o(ys)g -(whether)g(or)h(not)f(to)g(use)195 1379 y(eigh)o(t-bit)g(c)o -(haracters.)25 b(By)17 b(default,)h(this)f(is)h(set)e(to)h -Ft(rl_prep_terminal)e Fu(\(see)i(Section)h(2.4.9)195 -1434 y([T)l(erminal)e(Managemen)o(t],)d(page)i(33\).)1773 -1550 y(V)l(ariable)-1861 b Fi(rl_voidfunc_t)21 b(*)e -Fh(rl)p 521 1550 V 21 w(deprep)p 714 1550 V 21 w(term)p -856 1550 V 19 w(function)195 1605 y Fu(If)g(non-zero,)g(Readline)g +195 1471 y(the)k(input)i(stream.)31 b(By)19 b(default,)h(it)g(is)g(set) +f(to)f Ft(rl_getc)p Fu(,)h(the)g(default)h(Readline)h(c)o(haracter)195 +1525 y(input)16 b(function)g(\(see)f(Section)h(2.4.8)e([Character)g +(Input],)h(page)g(34\).)1773 1647 y(V)l(ariable)-1861 +b Fi(rl_voidfunc_t)21 b(*)e Fh(rl)p 521 1647 V 21 w(redispla)n(y)p +765 1647 V 22 w(function)195 1702 y Fu(If)f(non-zero,)h(Readline)g +(will)h(call)f(indirectly)h(through)e(this)g(p)q(oin)o(ter)h(to)e(up)q +(date)i(the)f(displa)o(y)195 1757 y(with)c(the)f(curren)o(t)h(con)o +(ten)o(ts)f(of)g(the)g(editing)i(bu\013er.)k(By)14 b(default,)g(it)g +(is)g(set)f(to)g Ft(rl_redisplay)p Fu(,)195 1812 y(the)i(default)h +(Readline)h(redispla)o(y)f(function)g(\(see)f(Section)h(2.4.6)e +([Redispla)o(y],)h(page)g(33\).)1773 1933 y(V)l(ariable)-1861 +b Fi(rl_vintfunc_t)21 b(*)e Fh(rl)p 521 1933 V 21 w(prep)p +656 1933 V 21 w(term)p 798 1933 V 19 w(function)195 1988 +y Fu(If)12 b(non-zero,)h(Readline)g(will)h(call)f(indirectly)h(through) +e(this)g(p)q(oin)o(ter)h(to)e(initialize)k(the)e(terminal.)195 +2043 y(The)19 b(function)g(tak)o(es)f(a)g(single)i(argumen)o(t,)e(an)h +Ft(int)f Fu(\015ag)g(that)g(sa)o(ys)g(whether)g(or)h(not)f(to)g(use)195 +2098 y(eigh)o(t-bit)g(c)o(haracters.)25 b(By)17 b(default,)h(this)f(is) +h(set)e(to)h Ft(rl_prep_terminal)e Fu(\(see)i(Section)h(2.4.9)195 +2152 y([T)l(erminal)e(Managemen)o(t],)d(page)i(35\).)1773 +2274 y(V)l(ariable)-1861 b Fi(rl_voidfunc_t)21 b(*)e +Fh(rl)p 521 2274 V 21 w(deprep)p 714 2274 V 21 w(term)p +856 2274 V 19 w(function)195 2329 y Fu(If)g(non-zero,)g(Readline)g (will)h(call)g(indirectly)g(through)e(this)h(p)q(oin)o(ter)f(to)g -(reset)g(the)h(terminal.)195 1659 y(This)f(function)g(should)h(undo)f +(reset)g(the)h(terminal.)195 2384 y(This)f(function)g(should)h(undo)f (the)f(e\013ects)h(of)f Ft(rl_prep_term_function)p Fu(.)24 -b(By)17 b(default,)i(this)195 1714 y(is)d(set)f(to)f +b(By)17 b(default,)i(this)195 2439 y(is)d(set)f(to)f Ft(rl_deprep_terminal)f Fu(\(see)i(Section)h(2.4.9)e([T)l(erminal)i -(Managemen)o(t],)d(page)i(33\).)1773 1830 y(V)l(ariable)-1861 -b Fi(Keymap)20 b Fh(rl)p 293 1830 V 21 w(executing)p -551 1830 V 22 w(k)n(eymap)195 1885 y Fu(This)f(v)m(ariable)g(is)f(set)g +(Managemen)o(t],)d(page)i(35\).)1773 2560 y(V)l(ariable)-1861 +b Fi(Keymap)20 b Fh(rl)p 293 2560 V 21 w(executing)p +551 2560 V 22 w(k)n(eymap)195 2615 y Fu(This)f(v)m(ariable)g(is)f(set)g (to)g(the)g(k)o(eymap)f(\(see)h(Section)h(2.4.2)e([Keymaps],)g(page)h -(26\))f(in)i(whic)o(h)195 1939 y(the)c(curren)o(tly)h(executing)g -(readline)h(function)f(w)o(as)f(found.)1773 2055 y(V)l(ariable)-1861 -b Fi(Keymap)20 b Fh(rl)p 293 2055 V 21 w(binding)p 501 -2055 V 22 w(k)n(eymap)195 2110 y Fu(This)f(v)m(ariable)g(is)f(set)g(to) -g(the)g(k)o(eymap)f(\(see)h(Section)h(2.4.2)e([Keymaps],)g(page)h(26\)) -f(in)i(whic)o(h)195 2165 y(the)c(last)g(k)o(ey)g(binding)j(o)q -(ccurred.)1773 2280 y(V)l(ariable)-1861 b Fi(char)20 -b(*)f Fh(rl)p 286 2280 V 21 w(executing)p 544 2280 V -22 w(macro)195 2335 y Fu(This)d(v)m(ariable)g(is)g(set)f(to)g(the)g -(text)g(of)f(an)o(y)h(curren)o(tly-executing)i(macro.)1773 -2451 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 2451 -V 21 w(readline)p 434 2451 V 22 w(state)195 2506 y Fu(A)d(v)m(ariable)i -(with)e(bit)h(v)m(alues)h(that)d(encapsulate)i(the)g(curren)o(t)f -(Readline)h(state.)25 b(A)18 b(bit)f(is)h(set)195 2560 -y(with)h(the)g Ft(RL_SETSTATE)f Fu(macro,)h(and)g(unset)g(with)g(the)g -Ft(RL_UNSETSTATE)e Fu(macro.)31 b(Use)19 b(the)195 2615 -y Ft(RL_ISSTATE)e Fu(macro)h(to)g(test)g(whether)h(a)f(particular)i -(state)d(bit)j(is)f(set.)30 b(Curren)o(t)18 b(state)g(bits)195 -2670 y(include:)p eop -%%Page: 25 27 -25 26 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(25)195 149 y Ft(RL_STATE_NONE)435 204 -y Fu(Readline)16 b(has)g(not)e(y)o(et)h(b)q(een)h(called,)h(nor)e(has)g -(it)g(b)q(egun)h(to)f(in)o(tialize.)195 277 y Ft(RL_STATE_INITIALIZING) -435 332 y Fu(Readline)h(is)g(initializi)q(ng)i(its)d(in)o(ternal)h -(data)f(structures.)195 405 y Ft(RL_STATE_INITIALIZED)435 -460 y Fu(Readline)h(has)g(completed)g(its)f(initialization.)195 -533 y Ft(RL_STATE_TERMPREPPED)435 588 y Fu(Readline)h(has)e(mo)q -(di\014ed)i(the)e(terminal)h(mo)q(des)g(to)e(do)i(its)f(o)o(wn)g(input) -h(and)g(redis-)435 643 y(pla)o(y)l(.)195 716 y Ft(RL_STATE_READCMD)435 -770 y Fu(Readline)h(is)g(reading)g(a)f(command)g(from)f(the)i(k)o(eyb)q -(oard.)195 844 y Ft(RL_STATE_METANEXT)435 898 y Fu(Readline)g(is)g +(29\))f(in)i(whic)o(h)195 2670 y(the)c(curren)o(tly)h(executing)g +(readline)h(function)f(w)o(as)f(found.)p eop +%%Page: 27 29 +27 28 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(27)1773 149 y(V)l(ariable)-1861 b Fi(Keymap)20 +b Fh(rl)p 293 149 18 3 v 21 w(binding)p 501 149 V 22 +w(k)n(eymap)195 204 y Fu(This)f(v)m(ariable)g(is)f(set)g(to)g(the)g(k)o +(eymap)f(\(see)h(Section)h(2.4.2)e([Keymaps],)g(page)h(29\))f(in)i +(whic)o(h)195 259 y(the)c(last)g(k)o(ey)g(binding)j(o)q(ccurred.)1773 +383 y(V)l(ariable)-1861 b Fi(char)20 b(*)f Fh(rl)p 286 +383 V 21 w(executing)p 544 383 V 22 w(macro)195 438 y +Fu(This)d(v)m(ariable)g(is)g(set)f(to)g(the)g(text)g(of)f(an)o(y)h +(curren)o(tly-executing)i(macro.)1773 562 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 562 V 21 w(readline)p 434 562 +V 22 w(state)195 617 y Fu(A)d(v)m(ariable)i(with)e(bit)h(v)m(alues)h +(that)d(encapsulate)i(the)g(curren)o(t)f(Readline)h(state.)25 +b(A)18 b(bit)f(is)h(set)195 671 y(with)h(the)g Ft(RL_SETSTATE)f +Fu(macro,)h(and)g(unset)g(with)g(the)g Ft(RL_UNSETSTATE)e +Fu(macro.)31 b(Use)19 b(the)195 726 y Ft(RL_ISSTATE)e +Fu(macro)h(to)g(test)g(whether)h(a)f(particular)i(state)d(bit)j(is)f +(set.)30 b(Curren)o(t)18 b(state)g(bits)195 781 y(include:)195 +864 y Ft(RL_STATE_NONE)435 919 y Fu(Readline)e(has)g(not)e(y)o(et)h(b)q +(een)h(called,)h(nor)e(has)g(it)g(b)q(egun)h(to)f(in)o(tialize.)195 +1001 y Ft(RL_STATE_INITIALIZING)435 1056 y Fu(Readline)h(is)g +(initializi)q(ng)i(its)d(in)o(ternal)h(data)f(structures.)195 +1138 y Ft(RL_STATE_INITIALIZED)435 1192 y Fu(Readline)h(has)g +(completed)g(its)f(initialization.)195 1274 y Ft(RL_STATE_TERMPREPPED) +435 1329 y Fu(Readline)h(has)e(mo)q(di\014ed)i(the)e(terminal)h(mo)q +(des)g(to)e(do)i(its)f(o)o(wn)g(input)h(and)g(redis-)435 +1384 y(pla)o(y)l(.)195 1466 y Ft(RL_STATE_READCMD)435 +1521 y Fu(Readline)h(is)g(reading)g(a)f(command)g(from)f(the)i(k)o(eyb) +q(oard.)195 1603 y Ft(RL_STATE_METANEXT)435 1658 y Fu(Readline)g(is)g (reading)g(more)f(input)h(after)e(reading)i(the)f(meta-pre\014x)h(c)o -(haracter.)195 971 y Ft(RL_STATE_DISPATCHING)435 1026 +(haracter.)195 1740 y Ft(RL_STATE_DISPATCHING)435 1794 y Fu(Readline)g(is)g(dispatc)o(hing)h(to)d(a)h(command.)195 -1099 y Ft(RL_STATE_MOREINPUT)435 1154 y Fu(Readline)h(is)g(reading)g +1876 y Ft(RL_STATE_MOREINPUT)435 1931 y Fu(Readline)h(is)g(reading)g (more)f(input)h(while)h(executing)f(an)f(editing)i(command.)195 -1227 y Ft(RL_STATE_ISEARCH)435 1282 y Fu(Readline)f(is)g(p)q(erforming) -g(an)f(incremen)o(tal)h(history)f(searc)o(h.)195 1355 -y Ft(RL_STATE_NSEARCH)435 1410 y Fu(Readline)h(is)g(p)q(erforming)g(a)f -(non-incremen)o(tal)h(history)g(searc)o(h.)195 1483 y -Ft(RL_STATE_SEARCH)435 1538 y Fu(Readline)11 b(is)g(searc)o(hing)g(bac) +2013 y Ft(RL_STATE_ISEARCH)435 2068 y Fu(Readline)f(is)g(p)q(erforming) +g(an)f(incremen)o(tal)h(history)f(searc)o(h.)195 2150 +y Ft(RL_STATE_NSEARCH)435 2205 y Fu(Readline)h(is)g(p)q(erforming)g(a)f +(non-incremen)o(tal)h(history)g(searc)o(h.)195 2287 y +Ft(RL_STATE_SEARCH)435 2342 y Fu(Readline)11 b(is)g(searc)o(hing)g(bac) o(kw)o(ard)e(or)h(forw)o(ard)f(through)h(the)g(history)g(for)f(a)h -(string.)195 1611 y Ft(RL_STATE_NUMERICARG)435 1665 y +(string.)195 2424 y Ft(RL_STATE_NUMERICARG)435 2478 y Fu(Readline)16 b(is)g(reading)g(a)f(n)o(umeric)h(argumen)o(t.)195 -1738 y Ft(RL_STATE_MACROINPUT)435 1793 y Fu(Readline)d(is)g(curren)o +2560 y Ft(RL_STATE_MACROINPUT)435 2615 y Fu(Readline)d(is)g(curren)o (tly)g(getting)f(its)g(input)h(from)e(a)h(previously-de\014ned)j(k)o -(eyb)q(oard)435 1848 y(macro.)195 1921 y Ft(RL_STATE_MACRODEF)435 -1976 y Fu(Readline)h(is)g(curren)o(tly)g(reading)g(c)o(haracters)e -(de\014ning)j(a)e(k)o(eyb)q(oard)g(macro.)195 2049 y -Ft(RL_STATE_OVERWRITE)435 2104 y Fu(Readline)h(is)g(in)g(o)o(v)o -(erwrite)f(mo)q(de.)195 2177 y Ft(RL_STATE_COMPLETING)435 -2232 y Fu(Readline)h(is)g(p)q(erforming)g(w)o(ord)e(completion.)195 -2305 y Ft(RL_STATE_SIGHANDLER)435 2359 y Fu(Readline)i(is)g(curren)o -(tly)g(executing)g(the)f(readline)i(signal)f(handler.)195 -2433 y Ft(RL_STATE_UNDOING)435 2487 y Fu(Readline)g(is)g(p)q(erforming) -g(an)f(undo.)195 2560 y Ft(RL_STATE_DONE)435 2615 y Fu(Readline)g(has)f +(eyb)q(oard)435 2670 y(macro.)p eop +%%Page: 28 30 +28 29 bop 75 -58 a Fu(28)1299 b(GNU)15 b(Readline)h(Library)195 +149 y Ft(RL_STATE_MACRODEF)435 204 y Fu(Readline)g(is)g(curren)o(tly)g +(reading)g(c)o(haracters)e(de\014ning)j(a)e(k)o(eyb)q(oard)g(macro.)195 +286 y Ft(RL_STATE_OVERWRITE)435 341 y Fu(Readline)h(is)g(in)g(o)o(v)o +(erwrite)f(mo)q(de.)195 423 y Ft(RL_STATE_COMPLETING)435 +478 y Fu(Readline)h(is)g(p)q(erforming)g(w)o(ord)e(completion.)195 +560 y Ft(RL_STATE_SIGHANDLER)435 615 y Fu(Readline)i(is)g(curren)o(tly) +g(executing)g(the)f(readline)i(signal)f(handler.)195 +697 y Ft(RL_STATE_UNDOING)435 752 y Fu(Readline)g(is)g(p)q(erforming)g +(an)f(undo.)195 834 y Ft(RL_STATE_DONE)435 889 y Fu(Readline)g(has)f (read)g(a)f(k)o(ey)h(sequence)h(b)q(ound)g(to)e Ft(accept-line)f -Fu(and)i(is)h(ab)q(out)f(to)435 2670 y(return)h(the)g(line)i(to)e(the)g -(caller.)p eop -%%Page: 26 28 -26 27 bop 75 -58 a Fu(26)1299 b(GNU)15 b(Readline)h(Library)1773 -149 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 149 -18 3 v 21 w(explicit)p 417 149 V 24 w(arg)195 204 y Fu(Set)f(to)g(a)g -(non-zero)h(v)m(alue)h(if)e(an)h(explicit)h(n)o(umeric)g(argumen)o(t)d -(w)o(as)h(sp)q(eci\014ed)i(b)o(y)f(the)f(user.)195 259 -y(Only)d(v)m(alid)h(in)f(a)f(bindable)i(command)f(function.)1773 -374 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 374 -V 21 w(n)n(umeric)p 437 374 V 20 w(arg)195 429 y Fu(Set)j(to)f(the)g(v) -m(alue)i(of)f(an)o(y)f(n)o(umeric)h(argumen)o(t)f(explicitly)k(sp)q -(eci\014ed)f(b)o(y)d(the)h(user)g(b)q(efore)195 484 y(executing)14 -b(the)f(curren)o(t)g(Readline)h(function.)20 b(Only)14 -b(v)m(alid)h(in)f(a)f(bindable)i(command)d(function.)1773 -599 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 599 -V 21 w(editing)p 407 599 V 22 w(mo)r(de)195 654 y Fu(Set)13 -b(to)f(a)g(v)m(alue)i(denoting)f(Readline's)g(curren)o(t)g(editing)h -(mo)q(de.)19 b(A)12 b(v)m(alue)i(of)e Fk(1)k Fu(means)d(Readline)195 -709 y(is)j(curren)o(tly)f(in)h(emacs)g(mo)q(de;)f Fk(0)j -Fu(means)d(that)g(vi)h(mo)q(de)f(is)h(activ)o(e.)75 837 +Fu(and)i(is)h(ab)q(out)f(to)435 944 y(return)h(the)g(line)i(to)e(the)g +(caller.)1773 1068 y(V)l(ariable)-1861 b Fi(int)20 b +Fh(rl)p 215 1068 18 3 v 21 w(explicit)p 417 1068 V 24 +w(arg)195 1123 y Fu(Set)f(to)g(a)g(non-zero)h(v)m(alue)h(if)e(an)h +(explicit)h(n)o(umeric)g(argumen)o(t)d(w)o(as)h(sp)q(eci\014ed)i(b)o(y) +f(the)f(user.)195 1178 y(Only)d(v)m(alid)h(in)f(a)f(bindable)i(command) +f(function.)1773 1302 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 1302 V 21 w(n)n(umeric)p 437 1302 V 20 +w(arg)195 1357 y Fu(Set)j(to)f(the)g(v)m(alue)i(of)f(an)o(y)f(n)o +(umeric)h(argumen)o(t)f(explicitly)k(sp)q(eci\014ed)f(b)o(y)d(the)h +(user)g(b)q(efore)195 1412 y(executing)14 b(the)f(curren)o(t)g +(Readline)h(function.)20 b(Only)14 b(v)m(alid)h(in)f(a)f(bindable)i +(command)d(function.)1773 1536 y(V)l(ariable)-1861 b +Fi(int)20 b Fh(rl)p 215 1536 V 21 w(editing)p 407 1536 +V 22 w(mo)r(de)195 1591 y Fu(Set)13 b(to)f(a)g(v)m(alue)i(denoting)f +(Readline's)g(curren)o(t)g(editing)h(mo)q(de.)19 b(A)12 +b(v)m(alue)i(of)e Fk(1)k Fu(means)d(Readline)195 1646 +y(is)j(curren)o(tly)f(in)h(emacs)g(mo)q(de;)f Fk(0)j +Fu(means)d(that)g(vi)h(mo)q(de)f(is)h(activ)o(e.)75 1781 y Fs(2.4)33 b(Readline)23 b(Con)n(v)n(enience)g(F)-6 -b(unctions)75 977 y Fj(2.4.1)30 b(Naming)20 b(a)g(F)-5 -b(unction)137 1073 y Fu(The)20 b(user)g(can)g(dynamically)i(c)o(hange)e +b(unctions)75 1927 y Fj(2.4.1)30 b(Naming)20 b(a)g(F)-5 +b(unction)137 2025 y Fu(The)20 b(user)g(can)g(dynamically)i(c)o(hange)e (the)g(bindings)i(of)d(k)o(eys)h(while)h(using)g(Readline.)35 -b(This)20 b(is)75 1128 y(done)f(b)o(y)f(represen)o(ting)h(the)g +b(This)20 b(is)75 2080 y(done)f(b)o(y)f(represen)o(ting)h(the)g (function)g(with)g(a)f(descriptiv)o(e)i(name.)29 b(The)19 -b(user)f(is)h(able)h(to)d(t)o(yp)q(e)i(the)75 1182 y(descriptiv)o(e)e +b(user)f(is)h(able)h(to)d(t)o(yp)q(e)i(the)75 2135 y(descriptiv)o(e)e (name)e(when)h(referring)f(to)g(the)g(function.)21 b(Th)o(us,)14 b(in)i(an)f(init)i(\014le,)f(one)f(migh)o(t)g(\014nd)195 -1246 y Ft(Meta-Rubout:)46 b(backward-kill-word)137 1313 -y Fu(This)21 b(binds)g(the)f(k)o(eystrok)o(e)661 1311 -y Fn(h)p 673 1285 209 2 v 673 1313 a Fm(Meta-Rub)q(out)p -673 1321 V 879 1311 a Fn(i)914 1313 y Fu(to)g(the)g(function)g -Fl(descriptively)k Fu(named)c Ft(backward-)75 1368 y(kill-word)p +2202 y Ft(Meta-Rubout:)46 b(backward-kill-word)137 2272 +y Fu(This)21 b(binds)g(the)f(k)o(eystrok)o(e)661 2270 +y Fn(h)p 673 2244 209 2 v 673 2272 a Fm(Meta-Rub)q(out)p +673 2279 V 879 2270 a Fn(i)914 2272 y Fu(to)g(the)g(function)g +Fl(descriptively)k Fu(named)c Ft(backward-)75 2326 y(kill-word)p Fu(.)29 b(Y)l(ou,)19 b(as)f(the)h(programmer,)f(should)i(bind)f(the)g (functions)h(y)o(ou)e(write)h(to)e(descriptiv)o(e)75 -1423 y(names)e(as)g(w)o(ell.)21 b(Readline)16 b(pro)o(vides)g(a)f -(function)h(for)e(doing)i(that:)1762 1538 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1538 18 3 v 21 w(add)p 328 -1538 V 20 w(defun)i Fg(\()p Ft(const)14 b(char)h(*name,)f -(rl_command_func_t)283 1593 y(*function,)f(int)i(key)p -Fg(\))195 1648 y Fu(Add)j Fk(name)i Fu(to)d(the)h(list)h(of)e(named)h +2381 y(names)e(as)g(w)o(ell.)21 b(Readline)16 b(pro)o(vides)g(a)f +(function)h(for)e(doing)i(that:)1762 2506 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 2506 18 3 v 21 w(add)p 328 +2506 V 20 w(defun)i Fg(\()p Ft(const)14 b(char)h(*name,)f +(rl_command_func_t)283 2560 y(*function,)f(int)i(key)p +Fg(\))195 2615 y Fu(Add)j Fk(name)i Fu(to)d(the)h(list)h(of)e(named)h (functions.)28 b(Mak)o(e)17 b Fk(function)h Fu(b)q(e)g(the)g(function)h -(that)d(gets)195 1703 y(called.)21 b(If)16 b Fk(k)o(ey)j +(that)d(gets)195 2670 y(called.)21 b(If)16 b Fk(k)o(ey)j Fu(is)d(not)e(-1,)h(then)h(bind)g(it)g(to)e Fk(function)i -Fu(using)g Ft(rl_bind_key\(\))p Fu(.)137 1794 y(Using)g(this)f -(function)h(alone)g(is)f(su\016cien)o(t)h(for)f(most)f(applications.)21 -b(It)15 b(is)h(the)f(recommended)h(w)o(a)o(y)75 1849 -y(to)d(add)h(a)f(few)g(functions)h(to)f(the)h(default)g(functions)g -(that)f(Readline)i(has)e(built)i(in.)20 b(If)14 b(y)o(ou)f(need)h(to)f -(do)75 1903 y(something)k(other)g(than)f(adding)i(a)e(function)i(to)e +Fu(using)g Ft(rl_bind_key\(\))p Fu(.)p eop +%%Page: 29 31 +29 30 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(29)137 149 y(Using)16 b(this)f(function)h(alone)g(is)f +(su\016cien)o(t)h(for)f(most)f(applications.)21 b(It)15 +b(is)h(the)f(recommended)h(w)o(a)o(y)75 204 y(to)d(add)h(a)f(few)g +(functions)h(to)f(the)h(default)g(functions)g(that)f(Readline)i(has)e +(built)i(in.)20 b(If)14 b(y)o(ou)f(need)h(to)f(do)75 +259 y(something)k(other)g(than)f(adding)i(a)e(function)i(to)e (Readline,)i(y)o(ou)f(ma)o(y)f(need)i(to)e(use)h(the)g(underlying)75 -1958 y(functions)f(describ)q(ed)h(b)q(elo)o(w.)75 2069 -y Fj(2.4.2)30 b(Selecting)20 b(a)h(Keymap)137 2165 y -Fu(Key)16 b(bindings)i(tak)o(e)c(place)j(on)e(a)g Fk(k)o(eymap)p +314 y(functions)f(describ)q(ed)h(b)q(elo)o(w.)75 442 +y Fj(2.4.2)30 b(Selecting)20 b(a)h(Keymap)137 546 y Fu(Key)16 +b(bindings)i(tak)o(e)c(place)j(on)e(a)g Fk(k)o(eymap)p Fu(.)21 b(The)15 b(k)o(eymap)h(is)f(the)h(asso)q(ciation)g(b)q(et)o(w)o -(een)g(the)f(k)o(eys)75 2220 y(that)f(the)g(user)g(t)o(yp)q(es)g(and)h +(een)g(the)f(k)o(eys)75 601 y(that)f(the)g(user)g(t)o(yp)q(es)g(and)h (the)f(functions)h(that)f(get)g(run.)19 b(Y)l(ou)c(can)f(mak)o(e)g(y)o -(our)g(o)o(wn)f(k)o(eymaps,)h(cop)o(y)75 2275 y(existing)i(k)o(eymaps,) -f(and)g(tell)h(Readline)h(whic)o(h)f(k)o(eymap)f(to)f(use.)1762 -2390 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 -2390 V 21 w(mak)n(e)p 445 2390 V 20 w(bare)p 575 2390 -V 20 w(k)n(eymap)j Fg(\()p Ft(void)p Fg(\))195 2445 y +(our)g(o)o(wn)f(k)o(eymaps,)h(cop)o(y)75 656 y(existing)i(k)o(eymaps,)f +(and)g(tell)h(Readline)h(whic)o(h)f(k)o(eymap)f(to)f(use.)1762 +797 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 +797 18 3 v 21 w(mak)n(e)p 445 797 V 20 w(bare)p 575 797 +V 20 w(k)n(eymap)j Fg(\()p Ft(void)p Fg(\))195 851 y Fu(Returns)12 b(a)f(new,)i(empt)o(y)f(k)o(eymap.)18 b(The)13 b(space)f(for)f(the)i(k)o(eymap)e(is)i(allo)q(cated)g(with)f -Ft(malloc\(\))p Fu(;)195 2500 y(the)j(caller)i(should)f(free)f(it)h(b)o +Ft(malloc\(\))p Fu(;)195 906 y(the)j(caller)i(should)f(free)f(it)h(b)o (y)f(calling)i Ft(rl_discard_keymap\(\))12 b Fu(when)k(done.)1762 -2615 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 -2615 V 21 w(cop)n(y)p 428 2615 V 21 w(k)n(eymap)j Fg(\()p -Ft(Keymap)14 b(map)p Fg(\))195 2670 y Fu(Return)h(a)g(new)g(k)o(eymap)g -(whic)o(h)h(is)g(a)f(cop)o(y)g(of)g Fk(map)p Fu(.)p eop -%%Page: 27 29 -27 28 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(27)1762 149 y(F)l(unction)-1861 b Fi(Keymap)20 -b Fh(rl)p 293 149 18 3 v 21 w(mak)n(e)p 445 149 V 20 -w(k)n(eymap)j Fg(\()p Ft(void)p Fg(\))195 204 y Fu(Return)16 -b(a)f(new)i(k)o(eymap)e(with)i(the)f(prin)o(ting)h(c)o(haracters)e(b)q -(ound)i(to)e(rl)p 1457 204 14 2 v 17 w(insert,)h(the)g(lo)o(w)o(ercase) -195 259 y(Meta)11 b(c)o(haracters)f(b)q(ound)i(to)f(run)h(their)f -(equiv)m(alen)o(ts,)j(and)d(the)h(Meta)e(digits)i(b)q(ound)g(to)f(pro)q -(duce)195 314 y(n)o(umeric)16 b(argumen)o(ts.)1762 437 -y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 437 18 -3 v 21 w(discard)p 441 437 V 21 w(k)n(eymap)i Fg(\()p -Ft(Keymap)14 b(keymap)p Fg(\))195 492 y Fu(F)l(ree)h(the)h(storage)d -(asso)q(ciated)j(with)f Fk(k)o(eymap)p Fu(.)137 589 y(Readline)24 -b(has)f(sev)o(eral)g(in)o(ternal)g(k)o(eymaps.)42 b(These)23 -b(functions)g(allo)o(w)g(y)o(ou)f(to)g(c)o(hange)h(whic)o(h)75 -643 y(k)o(eymap)15 b(is)h(activ)o(e.)1762 767 y(F)l(unction)-1861 -b Fi(Keymap)20 b Fh(rl)p 293 767 V 21 w(get)p 391 767 -V 21 w(k)n(eymap)i Fg(\()p Ft(void)p Fg(\))195 822 y -Fu(Returns)15 b(the)g(curren)o(tly)h(activ)o(e)f(k)o(eymap.)1762 -945 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 945 -V 21 w(set)p 333 945 V 21 w(k)n(eymap)i Fg(\()p Ft(Keymap)14 -b(keymap)p Fg(\))195 1000 y Fu(Mak)o(es)g Fk(k)o(eymap)j -Fu(the)e(curren)o(tly)h(activ)o(e)f(k)o(eymap.)1762 1124 -y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 1124 -V 21 w(get)p 391 1124 V 21 w(k)n(eymap)p 605 1124 V 20 -w(b)n(y)p 685 1124 V 21 w(name)i Fg(\()p Ft(const)14 -b(char)g(*name)p Fg(\))195 1178 y Fu(Return)i(the)h(k)o(eymap)f(matc)o +1047 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 +1047 V 21 w(cop)n(y)p 428 1047 V 21 w(k)n(eymap)j Fg(\()p +Ft(Keymap)14 b(map)p Fg(\))195 1102 y Fu(Return)h(a)g(new)g(k)o(eymap)g +(whic)o(h)h(is)g(a)f(cop)o(y)g(of)g Fk(map)p Fu(.)1762 +1243 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 +1243 V 21 w(mak)n(e)p 445 1243 V 20 w(k)n(eymap)j Fg(\()p +Ft(void)p Fg(\))195 1298 y Fu(Return)16 b(a)f(new)i(k)o(eymap)e(with)i +(the)f(prin)o(ting)h(c)o(haracters)e(b)q(ound)i(to)e(rl)p +1457 1298 14 2 v 17 w(insert,)h(the)g(lo)o(w)o(ercase)195 +1353 y(Meta)11 b(c)o(haracters)f(b)q(ound)i(to)f(run)h(their)f(equiv)m +(alen)o(ts,)j(and)d(the)h(Meta)e(digits)i(b)q(ound)g(to)f(pro)q(duce) +195 1407 y(n)o(umeric)16 b(argumen)o(ts.)1762 1548 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 1548 18 3 v 21 w(discard)p +441 1548 V 21 w(k)n(eymap)i Fg(\()p Ft(Keymap)14 b(keymap)p +Fg(\))195 1603 y Fu(F)l(ree)h(the)h(storage)d(asso)q(ciated)j(with)f +Fk(k)o(eymap)p Fu(.)137 1711 y(Readline)24 b(has)f(sev)o(eral)g(in)o +(ternal)g(k)o(eymaps.)42 b(These)23 b(functions)g(allo)o(w)g(y)o(ou)f +(to)g(c)o(hange)h(whic)o(h)75 1766 y(k)o(eymap)15 b(is)h(activ)o(e.) +1762 1907 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p +293 1907 V 21 w(get)p 391 1907 V 21 w(k)n(eymap)i Fg(\()p +Ft(void)p Fg(\))195 1962 y Fu(Returns)15 b(the)g(curren)o(tly)h(activ)o +(e)f(k)o(eymap.)1762 2103 y(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 2103 V 21 w(set)p 333 2103 V 21 w(k)n(eymap)i +Fg(\()p Ft(Keymap)14 b(keymap)p Fg(\))195 2158 y Fu(Mak)o(es)g +Fk(k)o(eymap)j Fu(the)e(curren)o(tly)h(activ)o(e)f(k)o(eymap.)1762 +2298 y(F)l(unction)-1861 b Fi(Keymap)20 b Fh(rl)p 293 +2298 V 21 w(get)p 391 2298 V 21 w(k)n(eymap)p 605 2298 +V 20 w(b)n(y)p 685 2298 V 21 w(name)i Fg(\()p Ft(const)14 +b(char)g(*name)p Fg(\))195 2353 y Fu(Return)i(the)h(k)o(eymap)f(matc)o (hing)h Fk(name)p Fu(.)24 b Fk(name)19 b Fu(is)e(one)g(whic)o(h)g(w)o -(ould)g(b)q(e)h(supplied)h(in)e(a)f Ft(set)195 1233 y(keymap)e +(ould)g(b)q(e)h(supplied)h(in)e(a)f Ft(set)195 2408 y(keymap)e Fu(inputrc)j(line)f(\(see)g(Section)g(1.3)e([Readline)i(Init)g(File],)g -(page)f(4\).)1762 1357 y(F)l(unction)-1861 b Fi(char)20 -b(*)f Fh(rl)p 286 1357 V 21 w(get)p 384 1357 V 21 w(k)n(eymap)p -598 1357 V 20 w(name)i Fg(\()p Ft(Keymap)14 b(keymap)p -Fg(\))195 1412 y Fu(Return)i(the)h(name)g(matc)o(hing)f +(page)f(4\).)1762 2549 y(F)l(unction)-1861 b Fi(char)20 +b(*)f Fh(rl)p 286 2549 V 21 w(get)p 384 2549 V 21 w(k)n(eymap)p +598 2549 V 20 w(name)i Fg(\()p Ft(Keymap)14 b(keymap)p +Fg(\))195 2604 y Fu(Return)i(the)h(name)g(matc)o(hing)f Fk(k)o(eymap)p Fu(.)24 b Fk(name)19 b Fu(is)e(one)g(whic)o(h)g(w)o -(ould)g(b)q(e)h(supplied)h(in)e(a)f Ft(set)195 1466 y(keymap)e +(ould)g(b)q(e)h(supplied)h(in)e(a)f Ft(set)195 2659 y(keymap)e Fu(inputrc)j(line)f(\(see)g(Section)g(1.3)e([Readline)i(Init)g(File],)g -(page)f(4\).)75 1583 y Fj(2.4.3)30 b(Binding)20 b(Keys)137 -1681 y Fu(Key)13 b(sequences)g(are)e(asso)q(ciate)h(with)h(functions)f -(through)g(the)g(k)o(eymap.)19 b(Readline)13 b(has)f(sev)o(eral)g(in-) -75 1736 y(ternal)j(k)o(eymaps:)k Ft(emacs_standard_keymap)p +(page)f(4\).)p eop +%%Page: 30 32 +30 31 bop 75 -58 a Fu(30)1299 b(GNU)15 b(Readline)h(Library)75 +149 y Fj(2.4.3)30 b(Binding)20 b(Keys)137 244 y Fu(Key)13 +b(sequences)g(are)e(asso)q(ciate)h(with)h(functions)f(through)g(the)g +(k)o(eymap.)19 b(Readline)13 b(has)f(sev)o(eral)g(in-)75 +299 y(ternal)j(k)o(eymaps:)k Ft(emacs_standard_keymap)p Fu(,)11 b Ft(emacs_meta_keymap)p Fu(,)h Ft(emacs_ctlx_keymap)p -Fu(,)g Ft(vi_)75 1791 y(movement_keymap)p Fu(,)20 b(and)i +Fu(,)g Ft(vi_)75 354 y(movement_keymap)p Fu(,)20 b(and)i Ft(vi_insertion_keymap)p Fu(.)35 b Ft(emacs_standard_keymap)18 -b Fu(is)k(the)f(default,)75 1846 y(and)15 b(the)h(examples)g(in)g(this) -f(man)o(ual)h(assume)f(that.)137 1915 y(Since)h Ft(readline\(\))c +b Fu(is)k(the)f(default,)75 408 y(and)15 b(the)h(examples)g(in)g(this)f +(man)o(ual)h(assume)f(that.)137 474 y(Since)h Ft(readline\(\))c Fu(installs)j(a)f(set)f(of)h(default)g(k)o(ey)g(bindings)h(the)f -(\014rst)g(time)g(it)g(is)g(called,)i(there)d(is)75 1970 +(\014rst)g(time)g(it)g(is)g(called,)i(there)d(is)75 529 y(alw)o(a)o(ys)j(the)g(danger)g(that)g(a)g(custom)g(binding)i (installed)g(b)q(efore)f(the)f(\014rst)g(call)i(to)d -Ft(readline\(\))g Fu(will)75 2025 y(b)q(e)f(o)o(v)o(erridden.)19 +Ft(readline\(\))g Fu(will)75 584 y(b)q(e)f(o)o(v)o(erridden.)19 b(An)13 b(alternate)g(mec)o(hanism)h(is)f(to)f(install)i(custom)f(k)o -(ey)g(bindings)h(in)g(an)f(initialization)75 2079 y(function)19 +(ey)g(bindings)h(in)g(an)f(initialization)75 638 y(function)19 b(assigned)h(to)d(the)i Ft(rl_startup_hook)e Fu(v)m(ariable)j(\(see)e -(Section)h(2.3)f([Readline)i(V)l(ariables],)75 2134 y(page)15 -b(22\).)137 2204 y(These)h(functions)g(manage)e(k)o(ey)i(bindings.)1762 -2327 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2327 -V 21 w(bind)p 347 2327 V 21 w(k)n(ey)k Fg(\()p Ft(int)14 -b(key,)h(rl_command_func_t)d(*function)p Fg(\))195 2382 +(Section)h(2.3)f([Readline)i(V)l(ariables],)75 693 y(page)15 +b(24\).)137 759 y(These)h(functions)g(manage)e(k)o(ey)i(bindings.)1762 +868 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 868 +18 3 v 21 w(bind)p 347 868 V 21 w(k)n(ey)k Fg(\()p Ft(int)14 +b(key,)h(rl_command_func_t)d(*function)p Fg(\))195 922 y Fu(Binds)18 b Fk(k)o(ey)i Fu(to)c Fk(function)h Fu(in)h(the)e(curren) o(tly)h(activ)o(e)g(k)o(eymap.)23 b(Returns)16 b(non-zero)h(in)g(the)g -(case)195 2437 y(of)e(an)g(in)o(v)m(alid)i Fk(k)o(ey)p -Fu(.)1762 2560 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 2560 V 21 w(bind)p 347 2560 V 21 w(k)n(ey)p 452 2560 -V 21 w(in)p 520 2560 V 22 w(map)h Fg(\()p Ft(int)14 b(key,)h -(rl_command_func_t)e(*function,)283 2615 y(Keymap)h(map)p -Fg(\))195 2670 y Fu(Bind)i Fk(k)o(ey)j Fu(to)c Fk(function)h +(case)195 977 y(of)e(an)g(in)o(v)m(alid)i Fk(k)o(ey)p +Fu(.)1762 1086 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 1086 V 21 w(bind)p 347 1086 V 21 w(k)n(ey)p 452 1086 +V 21 w(in)p 520 1086 V 22 w(map)h Fg(\()p Ft(int)14 b(key,)h +(rl_command_func_t)e(*function,)283 1141 y(Keymap)h(map)p +Fg(\))195 1196 y Fu(Bind)i Fk(k)o(ey)j Fu(to)c Fk(function)h Fu(in)g Fk(map)p Fu(.)k(Returns)14 b(non-zero)i(in)g(the)f(case)g(of)g -(an)g(in)o(v)m(alid)j Fk(k)o(ey)p Fu(.)p eop -%%Page: 28 30 -28 29 bop 75 -58 a Fu(28)1299 b(GNU)15 b(Readline)h(Library)1762 -149 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 149 -18 3 v 21 w(un)n(bind)p 409 149 V 21 w(k)n(ey)k Fg(\()p -Ft(int)14 b(key)p Fg(\))195 204 y Fu(Bind)19 b Fk(k)o(ey)j -Fu(to)c(the)g(n)o(ull)i(function)f(in)g(the)f(curren)o(tly)g(activ)o(e) -h(k)o(eymap.)28 b(Returns)18 b(non-zero)g(in)195 259 -y(case)d(of)g(error.)1762 395 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 395 V 21 w(un)n(bind)p 409 395 V 21 w(k)n(ey)p -514 395 V 21 w(in)p 582 395 V 22 w(map)h Fg(\()p Ft(int)14 -b(key,)h(Keymap)f(map)p Fg(\))195 450 y Fu(Bind)i Fk(k)o(ey)j -Fu(to)c(the)g(n)o(ull)i(function)f(in)g Fk(map)p Fu(.)k(Returns)14 -b(non-zero)i(in)g(case)f(of)g(error.)1762 586 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 586 V 21 w(un)n(bind)p 409 -586 V 21 w(function)p 635 586 V 21 w(in)p 703 586 V 21 -w(map)h Fg(\()p Ft(rl_command_func_t)13 b(*function,)283 -641 y(Keymap)h(map)p Fg(\))195 695 y Fu(Un)o(bind)j(all)f(k)o(eys)f -(that)f(execute)i Fk(function)g Fu(in)g Fk(map)p Fu(.)1762 -831 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 831 -V 21 w(un)n(bind)p 409 831 V 21 w(command)p 674 831 V -17 w(in)p 738 831 V 22 w(map)h Fg(\()p Ft(const)14 b(char)h(*command,)f -(Keymap)283 886 y(map)p Fg(\))195 941 y Fu(Un)o(bind)j(all)f(k)o(eys)f -(that)f(are)h(b)q(ound)h(to)f Fk(command)i Fu(in)f Fk(map)p -Fu(.)1762 1077 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 1077 V 21 w(set)p 307 1077 V 20 w(k)n(ey)k Fg(\()p +(an)g(in)o(v)m(alid)j Fk(k)o(ey)p Fu(.)1762 1304 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1304 V 21 w(un)n(bind)p 409 +1304 V 21 w(k)n(ey)k Fg(\()p Ft(int)14 b(key)p Fg(\))195 +1359 y Fu(Bind)19 b Fk(k)o(ey)j Fu(to)c(the)g(n)o(ull)i(function)f(in)g +(the)f(curren)o(tly)g(activ)o(e)h(k)o(eymap.)28 b(Returns)18 +b(non-zero)g(in)195 1414 y(case)d(of)g(error.)1762 1523 +y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1523 V +21 w(un)n(bind)p 409 1523 V 21 w(k)n(ey)p 514 1523 V +21 w(in)p 582 1523 V 22 w(map)h Fg(\()p Ft(int)14 b(key,)h(Keymap)f +(map)p Fg(\))195 1577 y Fu(Bind)i Fk(k)o(ey)j Fu(to)c(the)g(n)o(ull)i +(function)f(in)g Fk(map)p Fu(.)k(Returns)14 b(non-zero)i(in)g(case)f +(of)g(error.)1762 1686 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 1686 V 21 w(un)n(bind)p 409 1686 V 21 w(function)p +635 1686 V 21 w(in)p 703 1686 V 21 w(map)h Fg(\()p Ft +(rl_command_func_t)13 b(*function,)283 1741 y(Keymap)h(map)p +Fg(\))195 1796 y Fu(Un)o(bind)j(all)f(k)o(eys)f(that)f(execute)i +Fk(function)g Fu(in)g Fk(map)p Fu(.)1762 1905 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1905 V 21 w(un)n(bind)p 409 +1905 V 21 w(command)p 674 1905 V 17 w(in)p 738 1905 V +22 w(map)h Fg(\()p Ft(const)14 b(char)h(*command,)f(Keymap)283 +1959 y(map)p Fg(\))195 2014 y Fu(Un)o(bind)j(all)f(k)o(eys)f(that)f +(are)h(b)q(ound)h(to)f Fk(command)i Fu(in)f Fk(map)p +Fu(.)1762 2123 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 2123 V 21 w(set)p 307 2123 V 20 w(k)n(ey)k Fg(\()p Ft(const)14 b(char)h(*keyseq,)f(rl_command_func_t)f(*function,)283 -1132 y(Keymap)h(map)p Fg(\))195 1186 y Fu(Bind)g(the)e(k)o(ey)h +2178 y(Keymap)h(map)p Fg(\))195 2232 y Fu(Bind)g(the)e(k)o(ey)h (sequence)h(represen)o(ted)f(b)o(y)f(the)h(string)f Fk(k)o(eyseq)i Fu(to)e(the)g(function)i Fk(function)p Fu(.)19 b(This)195 -1241 y(mak)o(es)13 b(new)g(k)o(eymaps)g(as)f(necessary)l(.)20 +2287 y(mak)o(es)13 b(new)g(k)o(eymaps)g(as)f(necessary)l(.)20 b(The)13 b(initial)j(k)o(eymap)c(in)i(whic)o(h)g(to)f(do)g(bindings)i -(is)f Fk(map)p Fu(.)1762 1377 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 1377 V 21 w(generic)p 413 1377 V 21 w(bind)j +(is)f Fk(map)p Fu(.)1762 2396 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 2396 V 21 w(generic)p 413 2396 V 21 w(bind)j Fg(\()p Ft(int)15 b(type,)f(const)h(char)f(*keyseq,)g(char)h(*data,)283 -1432 y(Keymap)f(map)p Fg(\))195 1487 y Fu(Bind)h(the)e(k)o(ey)h +2451 y(Keymap)f(map)p Fg(\))195 2506 y Fu(Bind)h(the)e(k)o(ey)h (sequence)h(represen)o(ted)e(b)o(y)h(the)g(string)f Fk(k)o(eyseq)i Fu(to)d(the)i(arbitrary)f(p)q(oin)o(ter)h Fk(data)p Fu(.)195 -1542 y Fk(t)o(yp)q(e)j Fu(sa)o(ys)c(what)h(kind)h(of)f(data)g(is)g(p)q +2560 y Fk(t)o(yp)q(e)j Fu(sa)o(ys)c(what)h(kind)h(of)f(data)g(is)g(p)q (oin)o(ted)i(to)d(b)o(y)h Fk(data)p Fu(;)g(this)h(can)f(b)q(e)h(a)f -(function)h(\()p Ft(ISFUNC)p Fu(\),)d(a)195 1596 y(macro)i(\()p +(function)h(\()p Ft(ISFUNC)p Fu(\),)d(a)195 2615 y(macro)i(\()p Ft(ISMACR)p Fu(\),)f(or)h(a)h(k)o(eymap)f(\()p Ft(ISKMAP)p Fu(\).)k(This)e(mak)o(es)e(new)h(k)o(eymaps)f(as)h(necessary)l(.)20 -b(The)195 1651 y(initial)d(k)o(eymap)e(in)h(whic)o(h)g(to)f(do)g -(bindings)i(is)f Fk(map)p Fu(.)1762 1787 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1787 V 21 w(parse)p 369 1787 -V 19 w(and)p 480 1787 V 21 w(bind)j Fg(\()p Ft(char)14 -b(*line)p Fg(\))195 1842 y Fu(P)o(arse)g Fk(line)19 b -Fu(as)14 b(if)h(it)g(had)g(b)q(een)h(read)f(from)f(the)g -Ft(inputrc)g Fu(\014le)i(and)f(p)q(erform)f(an)o(y)h(k)o(ey)f(bindings) -195 1897 y(and)h(v)m(ariable)i(assignmen)o(ts)e(found)h(\(see)f -(Section)h(1.3)e([Readline)i(Init)g(File],)g(page)f(4\).)1762 -2033 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2033 -V 21 w(read)p 346 2033 V 20 w(init)p 450 2033 V 22 w(\014le)k -Fg(\()p Ft(const)14 b(char)h(*filename)p Fg(\))195 2088 -y Fu(Read)g(k)o(eybindings)j(and)e(v)m(ariable)h(assignmen)o(ts)f(from) -f Fk(\014lename)k Fu(\(see)d(Section)g(1.3)f([Readline)195 -2142 y(Init)h(File],)g(page)f(4\).)75 2267 y Fj(2.4.4)30 -b(Asso)r(ciating)20 b(F)-5 b(unction)20 b(Names)h(and)f(Bindings)137 -2370 y Fu(These)11 b(functions)h(allo)o(w)e(y)o(ou)h(to)f(\014nd)h(out) -f(what)g(k)o(eys)h(in)o(v)o(ok)o(e)f(named)h(functions)h(and)e(the)h -(functions)75 2424 y(in)o(v)o(ok)o(ed)j(b)o(y)g(a)f(particular)h(k)o -(ey)g(sequence.)21 b(Y)l(ou)14 b(ma)o(y)f(also)g(asso)q(ciate)h(a)g -(new)g(function)g(name)g(with)g(an)75 2479 y(arbitrary)h(function.)1762 -2615 y(F)l(unction)-1861 b Fi(rl_command_func_t)22 b(*)d -Fh(rl)p 626 2615 V 21 w(named)p 814 2615 V 19 w(function)k -Fg(\()p Ft(const)14 b(char)h(*name)p Fg(\))195 2670 y -Fu(Return)g(the)g(function)h(with)g(name)f Fk(name)p -Fu(.)p eop -%%Page: 29 31 -29 30 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(29)1762 149 y(F)l(unction)-1861 b Fi(rl_command_func_t) -22 b(*)d Fh(rl)p 626 149 18 3 v 21 w(function)p 852 149 -V 21 w(of)p 920 149 V 20 w(k)n(eyseq)24 b Fg(\()p Ft(const)14 -b(char)283 204 y(*keyseq,)g(Keymap)g(map,)h(int)f(*type)p -Fg(\))195 259 y Fu(Return)i(the)g(function)h(in)o(v)o(ok)o(ed)g(b)o(y)f -Fk(k)o(eyseq)h Fu(in)g(k)o(eymap)f Fk(map)p Fu(.)23 b(If)17 -b Fk(map)g Fu(is)g Ft(NULL)p Fu(,)f(the)g(curren)o(t)195 -314 y(k)o(eymap)i(is)h(used.)31 b(If)18 b Fk(t)o(yp)q(e)j +b(The)195 2670 y(initial)d(k)o(eymap)e(in)h(whic)o(h)g(to)f(do)g +(bindings)i(is)f Fk(map)p Fu(.)p eop +%%Page: 31 33 +31 32 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(31)1762 149 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 149 18 3 v 21 w(parse)p 369 149 V 19 w(and)p +480 149 V 21 w(bind)j Fg(\()p Ft(char)14 b(*line)p Fg(\))195 +204 y Fu(P)o(arse)g Fk(line)19 b Fu(as)14 b(if)h(it)g(had)g(b)q(een)h +(read)f(from)f(the)g Ft(inputrc)g Fu(\014le)i(and)f(p)q(erform)f(an)o +(y)h(k)o(ey)f(bindings)195 259 y(and)h(v)m(ariable)i(assignmen)o(ts)e +(found)h(\(see)f(Section)h(1.3)e([Readline)i(Init)g(File],)g(page)f +(4\).)1762 359 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 359 V 21 w(read)p 346 359 V 20 w(init)p 450 359 V +22 w(\014le)k Fg(\()p Ft(const)14 b(char)h(*filename)p +Fg(\))195 414 y Fu(Read)g(k)o(eybindings)j(and)e(v)m(ariable)h +(assignmen)o(ts)f(from)f Fk(\014lename)k Fu(\(see)d(Section)g(1.3)f +([Readline)195 469 y(Init)h(File],)g(page)f(4\).)75 571 +y Fj(2.4.4)30 b(Asso)r(ciating)20 b(F)-5 b(unction)20 +b(Names)h(and)f(Bindings)137 664 y Fu(These)11 b(functions)h(allo)o(w)e +(y)o(ou)h(to)f(\014nd)h(out)f(what)g(k)o(eys)h(in)o(v)o(ok)o(e)f(named) +h(functions)h(and)e(the)h(functions)75 718 y(in)o(v)o(ok)o(ed)j(b)o(y)g +(a)f(particular)h(k)o(ey)g(sequence.)21 b(Y)l(ou)14 b(ma)o(y)f(also)g +(asso)q(ciate)h(a)g(new)g(function)g(name)g(with)g(an)75 +773 y(arbitrary)h(function.)1762 873 y(F)l(unction)-1861 +b Fi(rl_command_func_t)22 b(*)d Fh(rl)p 626 873 V 21 +w(named)p 814 873 V 19 w(function)k Fg(\()p Ft(const)14 +b(char)h(*name)p Fg(\))195 928 y Fu(Return)g(the)g(function)h(with)g +(name)f Fk(name)p Fu(.)1762 1028 y(F)l(unction)-1861 +b Fi(rl_command_func_t)22 b(*)d Fh(rl)p 626 1028 V 21 +w(function)p 852 1028 V 21 w(of)p 920 1028 V 20 w(k)n(eyseq)24 +b Fg(\()p Ft(const)14 b(char)283 1083 y(*keyseq,)g(Keymap)g(map,)h(int) +f(*type)p Fg(\))195 1138 y Fu(Return)i(the)g(function)h(in)o(v)o(ok)o +(ed)g(b)o(y)f Fk(k)o(eyseq)h Fu(in)g(k)o(eymap)f Fk(map)p +Fu(.)23 b(If)17 b Fk(map)g Fu(is)g Ft(NULL)p Fu(,)f(the)g(curren)o(t) +195 1193 y(k)o(eymap)i(is)h(used.)31 b(If)18 b Fk(t)o(yp)q(e)j Fu(is)e(not)g Ft(NULL)p Fu(,)f(the)g(t)o(yp)q(e)h(of)f(the)h(ob)s(ject) -f(is)h(returned)g(in)g(the)f Ft(int)195 369 y Fu(v)m(ariable)f(it)e(p)q -(oin)o(ts)h(to)e(\(one)h(of)g Ft(ISFUNC)p Fu(,)f Ft(ISKMAP)p -Fu(,)g(or)h Ft(ISMACR)p Fu(\).)1762 474 y(F)l(unction)-1861 -b Fi(char)20 b(**)f Fh(rl)p 312 474 V 21 w(in)n(v)n(oking)p -541 474 V 23 w(k)n(eyseqs)k Fg(\()p Ft(rl_command_func_t)13 -b(*function)p Fg(\))195 528 y Fu(Return)i(an)h(arra)o(y)e(of)h(strings) -h(represen)o(ting)g(the)g(k)o(ey)f(sequences)i(used)f(to)f(in)o(v)o(ok) -o(e)h Fk(function)g Fu(in)195 583 y(the)f(curren)o(t)g(k)o(eymap.)1762 -688 y(F)l(unction)-1861 b Fi(char)20 b(**)f Fh(rl)p 312 -688 V 21 w(in)n(v)n(oking)p 541 688 V 23 w(k)n(eyseqs)p -750 688 V 21 w(in)p 818 688 V 22 w(map)i Fg(\()p Ft(rl_command_func_t) -283 743 y(*function,)13 b(Keymap)i(map)p Fg(\))195 798 -y Fu(Return)g(an)h(arra)o(y)e(of)h(strings)h(represen)o(ting)g(the)g(k) -o(ey)f(sequences)i(used)f(to)f(in)o(v)o(ok)o(e)h Fk(function)g -Fu(in)195 853 y(the)f(k)o(eymap)g Fk(map)p Fu(.)1762 -958 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 958 -V 21 w(function)p 467 958 V 21 w(dump)r(er)g Fg(\()p -Ft(int)15 b(readable)p Fg(\))195 1013 y Fu(Prin)o(t)g(the)f(readline)j -(function)e(names)g(and)f(the)h(k)o(ey)g(sequences)g(curren)o(tly)g(b)q -(ound)h(to)e(them)h(to)195 1067 y Ft(rl_outstream)p Fu(.)j(If)c -Fk(readable)j Fu(is)d(non-zero,)g(the)g(list)g(is)h(formatted)d(in)j -(suc)o(h)f(a)f(w)o(a)o(y)g(that)g(it)h(can)195 1122 y(b)q(e)i(made)f -(part)g(of)f(an)i Ft(inputrc)e Fu(\014le)i(and)f(re-read.)1762 -1227 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1227 -V 21 w(list)p 337 1227 V 22 w(funmap)p 550 1227 V 18 -w(names)h Fg(\()p Ft(void)p Fg(\))195 1282 y Fu(Prin)o(t)15 -b(the)g(names)h(of)e(all)j(bindable)g(Readline)f(functions)g(to)f -Ft(rl_outstream)p Fu(.)1762 1387 y(F)l(unction)-1861 -b Fi(const)20 b(char)g(**)f Fh(rl)p 462 1387 V 21 w(funmap)p -674 1387 V 18 w(names)i Fg(\()p Ft(void)p Fg(\))195 1442 +f(is)h(returned)g(in)g(the)f Ft(int)195 1247 y Fu(v)m(ariable)f(it)e(p) +q(oin)o(ts)h(to)e(\(one)h(of)g Ft(ISFUNC)p Fu(,)f Ft(ISKMAP)p +Fu(,)g(or)h Ft(ISMACR)p Fu(\).)1762 1347 y(F)l(unction)-1861 +b Fi(char)20 b(**)f Fh(rl)p 312 1347 V 21 w(in)n(v)n(oking)p +541 1347 V 23 w(k)n(eyseqs)k Fg(\()p Ft(rl_command_func_t)13 +b(*function)p Fg(\))195 1402 y Fu(Return)i(an)h(arra)o(y)e(of)h +(strings)h(represen)o(ting)g(the)g(k)o(ey)f(sequences)i(used)f(to)f(in) +o(v)o(ok)o(e)h Fk(function)g Fu(in)195 1457 y(the)f(curren)o(t)g(k)o +(eymap.)1762 1557 y(F)l(unction)-1861 b Fi(char)20 b(**)f +Fh(rl)p 312 1557 V 21 w(in)n(v)n(oking)p 541 1557 V 23 +w(k)n(eyseqs)p 750 1557 V 21 w(in)p 818 1557 V 22 w(map)i +Fg(\()p Ft(rl_command_func_t)283 1612 y(*function,)13 +b(Keymap)i(map)p Fg(\))195 1667 y Fu(Return)g(an)h(arra)o(y)e(of)h +(strings)h(represen)o(ting)g(the)g(k)o(ey)f(sequences)i(used)f(to)f(in) +o(v)o(ok)o(e)h Fk(function)g Fu(in)195 1722 y(the)f(k)o(eymap)g +Fk(map)p Fu(.)1762 1822 y(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 1822 V 21 w(function)p 467 1822 V 21 w(dump)r(er)g +Fg(\()p Ft(int)15 b(readable)p Fg(\))195 1876 y Fu(Prin)o(t)g(the)f +(readline)j(function)e(names)g(and)f(the)h(k)o(ey)g(sequences)g(curren) +o(tly)g(b)q(ound)h(to)e(them)h(to)195 1931 y Ft(rl_outstream)p +Fu(.)j(If)c Fk(readable)j Fu(is)d(non-zero,)g(the)g(list)g(is)h +(formatted)d(in)j(suc)o(h)f(a)f(w)o(a)o(y)g(that)g(it)h(can)195 +1986 y(b)q(e)i(made)f(part)g(of)f(an)i Ft(inputrc)e Fu(\014le)i(and)f +(re-read.)1762 2086 y(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 2086 V 21 w(list)p 337 2086 V 22 w(funmap)p +550 2086 V 18 w(names)h Fg(\()p Ft(void)p Fg(\))195 2141 +y Fu(Prin)o(t)15 b(the)g(names)h(of)e(all)j(bindable)g(Readline)f +(functions)g(to)f Ft(rl_outstream)p Fu(.)1762 2241 y(F)l(unction)-1861 +b Fi(const)20 b(char)g(**)f Fh(rl)p 462 2241 V 21 w(funmap)p +674 2241 V 18 w(names)i Fg(\()p Ft(void)p Fg(\))195 2296 y Fu(Return)13 b(a)f(NULL)i(terminated)g(arra)o(y)d(of)i(kno)o(wn)g (function)g(names.)20 b(The)13 b(arra)o(y)f(is)h(sorted.)19 -b(The)195 1497 y(arra)o(y)11 b(itself)j(is)f(allo)q(cated,)h(but)f(not) +b(The)195 2351 y(arra)o(y)11 b(itself)j(is)f(allo)q(cated,)h(but)f(not) f(the)h(strings)f(inside.)21 b(Y)l(ou)13 b(should)h Ft(free\(\))d -Fu(the)i(arra)o(y)e(when)195 1552 y(y)o(ou)k(are)g(done,)g(but)g(not)g -(the)g(p)q(oin)o(ters.)1762 1657 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1657 V 21 w(add)p 328 1657 -V 20 w(funmap)p 539 1657 V 18 w(en)n(try)j Fg(\()p Ft(const)14 -b(char)h(*name,)f(rl_command_func_t)283 1711 y(*function)p -Fg(\))195 1766 y Fu(Add)j Fk(name)i Fu(to)d(the)g(list)h(of)f(bindable) +Fu(the)i(arra)o(y)e(when)195 2405 y(y)o(ou)k(are)g(done,)g(but)g(not)g +(the)g(p)q(oin)o(ters.)1762 2506 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 2506 V 21 w(add)p 328 2506 +V 20 w(funmap)p 539 2506 V 18 w(en)n(try)j Fg(\()p Ft(const)14 +b(char)h(*name,)f(rl_command_func_t)283 2560 y(*function)p +Fg(\))195 2615 y Fu(Add)j Fk(name)i Fu(to)d(the)g(list)h(of)f(bindable) j(Readline)f(command)e(names,)g(and)h(mak)o(e)f Fk(function)h -Fu(the)195 1821 y(function)f(to)f(b)q(e)g(called)i(when)f -Fk(name)i Fu(is)d(in)o(v)o(ok)o(ed.)75 1926 y Fj(2.4.5)30 -b(Allo)n(wing)21 b(Undoing)137 2020 y Fu(Supp)q(orting)14 -b(the)g(undo)f(command)g(is)h(a)f(painless)h(thing,)g(and)f(mak)o(es)g -(y)o(our)f(functions)i(m)o(uc)o(h)f(more)75 2075 y(useful.)21 -b(It)15 b(is)h(certainly)g(easy)f(to)g(try)f(something)i(if)f(y)o(ou)g -(kno)o(w)g(y)o(ou)g(can)g(undo)h(it.)137 2140 y(If)21 -b(y)o(our)f(function)h(simply)h(inserts)f(text)e(once,)j(or)e(deletes)h -(text)f(once,)i(and)f(uses)f Ft(rl_insert_)75 2194 y(text\(\))13 -b Fu(or)h Ft(rl_delete_text\(\))d Fu(to)j(do)f(it,)h(then)h(undoing)g -(is)f(already)g(done)h(for)e(y)o(ou)h(automatically)l(.)137 -2259 y(If)d(y)o(ou)f(do)g(m)o(ultiple)i(insertions)f(or)f(m)o(ultiple)i -(deletions,)g(or)e(an)o(y)g(com)o(bination)h(of)f(these)g(op)q -(erations,)75 2314 y(y)o(ou)19 b(should)h(group)e(them)h(together)g(in) +Fu(the)195 2670 y(function)f(to)f(b)q(e)g(called)i(when)f +Fk(name)i Fu(is)d(in)o(v)o(ok)o(ed.)p eop +%%Page: 32 34 +32 33 bop 75 -58 a Fu(32)1299 b(GNU)15 b(Readline)h(Library)75 +149 y Fj(2.4.5)30 b(Allo)n(wing)21 b(Undoing)137 251 +y Fu(Supp)q(orting)14 b(the)g(undo)f(command)g(is)h(a)f(painless)h +(thing,)g(and)f(mak)o(es)g(y)o(our)f(functions)i(m)o(uc)o(h)f(more)75 +306 y(useful.)21 b(It)15 b(is)h(certainly)g(easy)f(to)g(try)f +(something)i(if)f(y)o(ou)g(kno)o(w)g(y)o(ou)g(can)g(undo)h(it.)137 +378 y(If)21 b(y)o(our)f(function)h(simply)h(inserts)f(text)e(once,)j +(or)e(deletes)h(text)f(once,)i(and)f(uses)f Ft(rl_insert_)75 +433 y(text\(\))13 b Fu(or)h Ft(rl_delete_text\(\))d Fu(to)j(do)f(it,)h +(then)h(undoing)g(is)f(already)g(done)h(for)e(y)o(ou)h(automatically)l +(.)137 506 y(If)d(y)o(ou)f(do)g(m)o(ultiple)i(insertions)f(or)f(m)o +(ultiple)i(deletions,)g(or)e(an)o(y)g(com)o(bination)h(of)f(these)g(op) +q(erations,)75 560 y(y)o(ou)19 b(should)h(group)e(them)h(together)g(in) o(to)g(one)g(op)q(eration.)31 b(This)20 b(is)f(done)h(with)f -Ft(rl_begin_undo_)75 2369 y(group\(\))14 b Fu(and)i Ft -(rl_end_undo_group\(\))p Fu(.)137 2434 y(The)g(t)o(yp)q(es)f(of)g(ev)o -(en)o(ts)g(that)f(can)h(b)q(e)h(undone)g(are:)195 2496 +Ft(rl_begin_undo_)75 615 y(group\(\))14 b Fu(and)i Ft +(rl_end_undo_group\(\))p Fu(.)137 688 y(The)g(t)o(yp)q(es)f(of)g(ev)o +(en)o(ts)g(that)f(can)h(b)q(e)h(undone)g(are:)195 757 y Ft(enum)23 b(undo_code)g({)h(UNDO_DELETE,)e(UNDO_INSERT,)g -(UNDO_BEGIN,)g(UNDO_END)h(};)137 2560 y Fu(Notice)16 -b(that)e Ft(UNDO_DELETE)g Fu(means)h(to)g(insert)g(some)g(text,)f(and)i -Ft(UNDO_INSERT)d Fu(means)i(to)g(delete)75 2615 y(some)e(text.)19 +(UNDO_BEGIN,)g(UNDO_END)h(};)137 830 y Fu(Notice)16 b(that)e +Ft(UNDO_DELETE)g Fu(means)h(to)g(insert)g(some)g(text,)f(and)i +Ft(UNDO_INSERT)d Fu(means)i(to)g(delete)75 885 y(some)e(text.)19 b(That)14 b(is,)g(the)g(undo)g(co)q(de)g(tells)h(what)e(to)h(undo,)g (not)f(ho)o(w)g(to)g(undo)i(it.)k Ft(UNDO_BEGIN)13 b -Fu(and)75 2670 y Ft(UNDO_END)h Fu(are)h(tags)f(added)i(b)o(y)f +Fu(and)75 939 y Ft(UNDO_END)h Fu(are)h(tags)f(added)i(b)o(y)f Ft(rl_begin_undo_group\(\))d Fu(and)k Ft(rl_end_undo_group\(\))p -Fu(.)p eop -%%Page: 30 32 -30 31 bop 75 -58 a Fu(30)1299 b(GNU)15 b(Readline)h(Library)1762 -149 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 149 -18 3 v 21 w(b)r(egin)p 372 149 V 20 w(undo)p 517 149 -V 20 w(group)h Fg(\()p Ft(void)p Fg(\))195 204 y Fu(Begins)16 -b(sa)o(ving)g(undo)g(information)f(in)i(a)e(group)g(construct.)20 -b(The)c(undo)g(information)g(usually)195 259 y(comes)21 -b(from)f(calls)i(to)e Ft(rl_insert_text\(\))e Fu(and)j -Ft(rl_delete_text\(\))p Fu(,)f(but)h(could)g(b)q(e)h(the)195 -314 y(result)16 b(of)e(calls)j(to)d Ft(rl_add_undo\(\))p -Fu(.)1762 418 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 418 V 21 w(end)p 326 418 V 20 w(undo)p 471 418 V -20 w(group)h Fg(\()p Ft(void)p Fg(\))195 472 y Fu(Closes)15 +Fu(.)1762 1072 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 1072 18 3 v 21 w(b)r(egin)p 372 1072 V 20 w(undo)p +517 1072 V 20 w(group)h Fg(\()p Ft(void)p Fg(\))195 1127 +y Fu(Begins)16 b(sa)o(ving)g(undo)g(information)f(in)i(a)e(group)g +(construct.)20 b(The)c(undo)g(information)g(usually)195 +1182 y(comes)21 b(from)f(calls)i(to)e Ft(rl_insert_text\(\))e +Fu(and)j Ft(rl_delete_text\(\))p Fu(,)f(but)h(could)g(b)q(e)h(the)195 +1237 y(result)16 b(of)e(calls)j(to)d Ft(rl_add_undo\(\))p +Fu(.)1762 1370 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 1370 V 21 w(end)p 326 1370 V 20 w(undo)p 471 1370 +V 20 w(group)h Fg(\()p Ft(void)p Fg(\))195 1424 y Fu(Closes)15 b(the)f(curren)o(t)h(undo)g(group)f(started)g(with)g Ft(rl_begin_undo_group)f(\(\))p Fu(.)19 b(There)c(should)195 -527 y(b)q(e)h(one)f(call)i(to)d Ft(rl_end_undo_group\(\))f +1479 y(b)q(e)h(one)f(call)i(to)d Ft(rl_end_undo_group\(\))f Fu(for)h(eac)o(h)h(call)i(to)d Ft(rl_begin_undo_group\(\))p -Fu(.)1762 631 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p -241 631 V 21 w(add)p 354 631 V 20 w(undo)i Fg(\()p Ft(enum)14 -b(undo_code)g(what,)g(int)h(start,)g(int)f(end,)h(char)283 -686 y(*text)p Fg(\))195 740 y Fu(Remem)o(b)q(er)i(ho)o(w)f(to)h(undo)g -(an)g(ev)o(en)o(t)g(\(according)g(to)g Fk(what)q Fu(\).)24 -b(The)17 b(a\013ected)g(text)f(runs)i(from)195 795 y +Fu(.)1762 1612 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p +241 1612 V 21 w(add)p 354 1612 V 20 w(undo)i Fg(\()p +Ft(enum)14 b(undo_code)g(what,)g(int)h(start,)g(int)f(end,)h(char)283 +1667 y(*text)p Fg(\))195 1722 y Fu(Remem)o(b)q(er)i(ho)o(w)f(to)h(undo) +g(an)g(ev)o(en)o(t)g(\(according)g(to)g Fk(what)q Fu(\).)24 +b(The)17 b(a\013ected)g(text)f(runs)i(from)195 1776 y Fk(start)d Fu(to)g Fk(end)p Fu(,)g(and)g(encompasses)h -Fk(text)p Fu(.)1762 899 y(F)l(unction)-1861 b Fi(void)20 -b Fh(rl)p 241 899 V 21 w(free)p 356 899 V 20 w(undo)p -501 899 V 20 w(list)k Fg(\()p Ft(void)p Fg(\))195 954 +Fk(text)p Fu(.)1762 1909 y(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 1909 V 21 w(free)p 356 1909 V 20 w(undo)p +501 1909 V 20 w(list)k Fg(\()p Ft(void)p Fg(\))195 1964 y Fu(F)l(ree)15 b(the)h(existing)g(undo)f(list.)1762 -1057 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1057 -V 21 w(do)p 297 1057 V 20 w(undo)i Fg(\()p Ft(void)p -Fg(\))195 1112 y Fu(Undo)12 b(the)f(\014rst)g(thing)h(on)g(the)f(undo)h +2097 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2097 +V 21 w(do)p 297 2097 V 20 w(undo)i Fg(\()p Ft(void)p +Fg(\))195 2152 y Fu(Undo)12 b(the)f(\014rst)g(thing)h(on)g(the)f(undo)h (list.)19 b(Returns)11 b Ft(0)h Fu(if)g(there)f(w)o(as)g(nothing)h(to)e -(undo,)j(non-zero)195 1167 y(if)j(something)f(w)o(as)f(undone.)137 -1251 y(Finally)l(,)j(if)f(y)o(ou)f(neither)i(insert)f(nor)f(delete)i +(undo,)j(non-zero)195 2206 y(if)j(something)f(w)o(as)f(undone.)137 +2309 y(Finally)l(,)j(if)f(y)o(ou)f(neither)i(insert)f(nor)f(delete)i (text,)e(but)g(directly)i(mo)q(dify)f(the)g(existing)g(text)g(\(e.g.,) -75 1306 y(c)o(hange)j(its)h(case\),)g(call)g Ft(rl_modifying\(\))e +75 2364 y(c)o(hange)j(its)h(case\),)g(call)g Ft(rl_modifying\(\))e Fu(once,)i(just)f(b)q(efore)h(y)o(ou)f(mo)q(dify)h(the)f(text.)32 -b(Y)l(ou)20 b(m)o(ust)75 1361 y(supply)c(the)g(indices)h(of)e(the)g +b(Y)l(ou)20 b(m)o(ust)75 2419 y(supply)c(the)g(indices)h(of)e(the)g (text)g(range)g(that)f(y)o(ou)h(are)g(going)g(to)g(mo)q(dify)l(.)1762 -1464 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1464 +2552 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2552 V 21 w(mo)r(difying)h Fg(\()p Ft(int)15 b(start,)f(int)h(end)p -Fg(\))195 1519 y Fu(T)l(ell)22 b(Readline)f(to)e(sa)o(v)o(e)h(the)g +Fg(\))195 2606 y Fu(T)l(ell)22 b(Readline)f(to)e(sa)o(v)o(e)h(the)g (text)g(b)q(et)o(w)o(een)g Fk(start)g Fu(and)g Fk(end)j Fu(as)c(a)h(single)h(undo)g(unit.)35 b(It)20 b(is)195 -1574 y(assumed)15 b(that)g(y)o(ou)g(will)i(subsequen)o(tly)f(mo)q(dify) -g(that)e(text.)75 1678 y Fj(2.4.6)30 b(Redispla)n(y)1762 -1811 y Fu(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 -1811 V 21 w(redispla)n(y)k Fg(\()p Ft(void)p Fg(\))195 -1866 y Fu(Change)19 b(what's)f(displa)o(y)o(ed)i(on)f(the)g(screen)g -(to)f(re\015ect)i(the)f(curren)o(t)f(con)o(ten)o(ts)h(of)f -Ft(rl_line_)195 1920 y(buffer)p Fu(.)1762 2024 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2024 V 21 w(forced)p 390 2024 -V 20 w(up)r(date)p 584 2024 V 20 w(displa)n(y)k Fg(\()p -Ft(void)p Fg(\))195 2079 y Fu(F)l(orce)c(the)g(line)h(to)e(b)q(e)i(up)q +2661 y(assumed)15 b(that)g(y)o(ou)g(will)i(subsequen)o(tly)f(mo)q(dify) +g(that)e(text.)p eop +%%Page: 33 35 +33 34 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(33)75 149 y Fj(2.4.6)30 b(Redispla)n(y)1762 +302 y Fu(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 +302 18 3 v 21 w(redispla)n(y)k Fg(\()p Ft(void)p Fg(\))195 +356 y Fu(Change)19 b(what's)f(displa)o(y)o(ed)i(on)f(the)g(screen)g(to) +f(re\015ect)i(the)f(curren)o(t)f(con)o(ten)o(ts)h(of)f +Ft(rl_line_)195 411 y(buffer)p Fu(.)1762 534 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 534 V 21 w(forced)p 390 534 +V 20 w(up)r(date)p 584 534 V 20 w(displa)n(y)k Fg(\()p +Ft(void)p Fg(\))195 589 y Fu(F)l(orce)c(the)g(line)h(to)e(b)q(e)i(up)q (dated)f(and)g(redispla)o(y)o(ed,)i(whether)e(or)g(not)f(Readline)i -(thinks)g(the)195 2134 y(screen)16 b(displa)o(y)g(is)g(correct.)1762 -2238 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2238 -V 21 w(on)p 297 2238 V 20 w(new)p 416 2238 V 21 w(line)k -Fg(\()p Ft(void)p Fg(\))195 2292 y Fu(T)l(ell)16 b(the)f(up)q(date)h +(thinks)g(the)195 644 y(screen)16 b(displa)o(y)g(is)g(correct.)1762 +767 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 767 +V 21 w(on)p 297 767 V 20 w(new)p 416 767 V 21 w(line)k +Fg(\()p Ft(void)p Fg(\))195 822 y Fu(T)l(ell)16 b(the)f(up)q(date)h (functions)g(that)e(w)o(e)g(ha)o(v)o(e)h(mo)o(v)o(ed)f(on)o(to)g(a)h -(new)g(\(empt)o(y\))f(line,)i(usually)h(after)195 2347 -y(ouputting)f(a)e(newline.)1762 2451 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2451 V 21 w(on)p 297 2451 V -20 w(new)p 416 2451 V 21 w(line)p 525 2451 V 22 w(with)p -657 2451 V 22 w(prompt)h Fg(\()p Ft(void)p Fg(\))195 -2506 y Fu(T)l(ell)14 b(the)e(up)q(date)h(functions)g(that)f(w)o(e)g(ha) +(new)g(\(empt)o(y\))f(line,)i(usually)h(after)195 877 +y(ouputting)f(a)e(newline.)1762 1000 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1000 V 21 w(on)p 297 1000 V +20 w(new)p 416 1000 V 21 w(line)p 525 1000 V 22 w(with)p +657 1000 V 22 w(prompt)h Fg(\()p Ft(void)p Fg(\))195 +1055 y Fu(T)l(ell)14 b(the)e(up)q(date)h(functions)g(that)f(w)o(e)g(ha) o(v)o(e)g(mo)o(v)o(ed)f(on)o(to)h(a)g(new)g(line,)i(with)f -Fk(rl)p 1556 2506 14 2 v 17 w(prompt)g Fu(already)195 -2560 y(displa)o(y)o(ed.)21 b(This)15 b(could)g(b)q(e)g(used)g(b)o(y)f +Fk(rl)p 1556 1055 14 2 v 17 w(prompt)g Fu(already)195 +1109 y(displa)o(y)o(ed.)21 b(This)15 b(could)g(b)q(e)g(used)g(b)o(y)f (applications)i(that)e(w)o(an)o(t)f(to)h(output)g(the)g(prompt)g -(string)195 2615 y(themselv)o(es,)g(but)g(still)h(need)g(Readline)g(to) +(string)195 1164 y(themselv)o(es,)g(but)g(still)h(need)g(Readline)g(to) e(kno)o(w)g(the)h(prompt)f(string)h(length)g(for)f(redispla)o(y)l(.)21 -b(It)195 2670 y(should)16 b(b)q(e)g(used)g(after)e(setting)i -Fk(rl)p 795 2670 V 16 w(already)p 956 2670 V 17 w(prompted)p -Fu(.)p eop -%%Page: 31 33 -31 32 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(31)1762 149 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 149 18 3 v 21 w(reset)p 357 149 V 20 w(line)p -465 149 V 23 w(state)j Fg(\()p Ft(void)p Fg(\))195 204 +b(It)195 1219 y(should)16 b(b)q(e)g(used)g(after)e(setting)i +Fk(rl)p 795 1219 V 16 w(already)p 956 1219 V 17 w(prompted)p +Fu(.)1762 1342 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 1342 18 3 v 21 w(reset)p 357 1342 V 20 w(line)p 465 +1342 V 23 w(state)j Fg(\()p Ft(void)p Fg(\))195 1397 y Fu(Reset)17 b(the)g(displa)o(y)i(state)d(to)h(a)g(clean)h(state)f (and)g(redispla)o(y)i(the)e(curren)o(t)g(line)i(starting)e(on)g(a)195 -259 y(new)e(line.)1762 383 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 383 V 21 w(crlf)j Fg(\()p Ft(void)p Fg(\))195 -438 y Fu(Mo)o(v)o(e)14 b(the)h(cursor)g(to)g(the)g(start)f(of)h(the)g -(next)g(screen)h(line.)1762 562 y(F)l(unction)-1861 b -Fi(int)20 b Fh(rl)p 215 562 V 21 w(sho)n(w)p 359 562 -V 20 w(c)n(har)j Fg(\()p Ft(int)14 b(c)p Fg(\))195 616 +1452 y(new)e(line.)1762 1575 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 1575 V 21 w(crlf)j Fg(\()p Ft(void)p Fg(\))195 +1630 y Fu(Mo)o(v)o(e)14 b(the)h(cursor)g(to)g(the)g(start)f(of)h(the)g +(next)g(screen)h(line.)1762 1753 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1753 V 21 w(sho)n(w)p 359 1753 +V 20 w(c)n(har)j Fg(\()p Ft(int)14 b(c)p Fg(\))195 1807 y Fu(Displa)o(y)j(c)o(haracter)e Fk(c)20 b Fu(on)c Ft(rl_outstream)p Fu(.)21 b(If)c(Readline)g(has)f(not)g(b)q(een)i(set)e(to)f(displa)o(y)j -(meta)195 671 y(c)o(haracters)12 b(directly)l(,)j(this)e(will)i(con)o +(meta)195 1862 y(c)o(haracters)12 b(directly)l(,)j(this)e(will)i(con)o (v)o(ert)d(meta)h(c)o(haracters)f(to)g(a)h(meta-pre\014xed)g(k)o(ey)g -(sequence.)195 726 y(This)j(is)f(in)o(tended)i(for)e(use)g(b)o(y)g +(sequence.)195 1917 y(This)j(is)f(in)o(tended)i(for)e(use)g(b)o(y)g (applications)i(whic)o(h)f(wish)g(to)f(do)g(their)g(o)o(wn)g(redispla)o -(y)l(.)1762 850 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 850 V 21 w(message)g Fg(\()p Ft(const)14 b(char)h(*,)g(...)p -Fg(\))195 905 y Fu(The)c(argumen)o(ts)e(are)h(a)g(format)f(string)h(as) -g(w)o(ould)h(b)q(e)g(supplied)i(to)c Ft(printf)p Fu(,)h(p)q(ossibly)i -(con)o(taining)195 959 y(con)o(v)o(ersion)22 b(sp)q(eci\014cations)i -(suc)o(h)f(as)e(`)p Ft(\045d)p Fu(',)i(and)f(an)o(y)g(additional)h -(argumen)o(ts)e(necessary)i(to)195 1014 y(satisfy)d(the)h(con)o(v)o -(ersion)g(sp)q(eci\014cations.)38 b(The)21 b(resulting)h(string)e(is)i -(displa)o(y)o(ed)g(in)f(the)g Fk(ec)o(ho)195 1069 y(area)p -Fu(.)e(The)d(ec)o(ho)f(area)g(is)g(also)g(used)h(to)f(displa)o(y)h(n)o -(umeric)g(argumen)o(ts)f(and)g(searc)o(h)g(strings.)1762 -1193 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1193 -V 21 w(clear)p 354 1193 V 21 w(message)h Fg(\()p Ft(void)p -Fg(\))195 1248 y Fu(Clear)15 b(the)h(message)e(in)i(the)g(ec)o(ho)f -(area.)1762 1371 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p -241 1371 V 21 w(sa)n(v)n(e)p 365 1371 V 21 w(prompt)h -Fg(\()p Ft(void)p Fg(\))195 1426 y Fu(Sa)o(v)o(e)g(the)h(lo)q(cal)g -(Readline)h(prompt)e(displa)o(y)i(state)e(in)h(preparation)f(for)g -(displa)o(ying)j(a)d(new)195 1481 y(message)15 b(in)h(the)f(message)g -(area)f(with)i Ft(rl_message\(\))p Fu(.)1762 1605 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 1605 V 21 w(restore)p 436 -1605 V 20 w(prompt)g Fg(\()p Ft(void)p Fg(\))195 1660 -y Fu(Restore)g(the)i(lo)q(cal)g(Readline)h(prompt)e(displa)o(y)h(state) -f(sa)o(v)o(ed)g(b)o(y)g(the)g(most)g(recen)o(t)g(call)i(to)195 -1714 y Ft(rl_save_prompt)p Fu(.)1762 1838 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1838 V 21 w(expand)p 416 1838 -V 20 w(prompt)h Fg(\()p Ft(char)14 b(*prompt)p Fg(\))195 -1893 y Fu(Expand)22 b(an)o(y)f(sp)q(ecial)i(c)o(haracter)e(sequences)h -(in)g Fk(prompt)g Fu(and)g(set)f(up)h(the)f(lo)q(cal)i(Readline)195 -1948 y(prompt)17 b(redispla)o(y)i(v)m(ariables.)30 b(This)18 +(y)l(.)1762 2040 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 2040 V 21 w(message)g Fg(\()p Ft(const)14 b(char)h(*,)g(...)p +Fg(\))195 2095 y Fu(The)c(argumen)o(ts)e(are)h(a)g(format)f(string)h +(as)g(w)o(ould)h(b)q(e)g(supplied)i(to)c Ft(printf)p +Fu(,)h(p)q(ossibly)i(con)o(taining)195 2150 y(con)o(v)o(ersion)22 +b(sp)q(eci\014cations)i(suc)o(h)f(as)e(`)p Ft(\045d)p +Fu(',)i(and)f(an)o(y)g(additional)h(argumen)o(ts)e(necessary)i(to)195 +2205 y(satisfy)d(the)h(con)o(v)o(ersion)g(sp)q(eci\014cations.)38 +b(The)21 b(resulting)h(string)e(is)i(displa)o(y)o(ed)g(in)f(the)g +Fk(ec)o(ho)195 2259 y(area)p Fu(.)e(The)d(ec)o(ho)f(area)g(is)g(also)g +(used)h(to)f(displa)o(y)h(n)o(umeric)g(argumen)o(ts)f(and)g(searc)o(h)g +(strings.)1762 2382 y(F)l(unction)-1861 b Fi(int)20 b +Fh(rl)p 215 2382 V 21 w(clear)p 354 2382 V 21 w(message)h +Fg(\()p Ft(void)p Fg(\))195 2437 y Fu(Clear)15 b(the)h(message)e(in)i +(the)g(ec)o(ho)f(area.)1762 2560 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 2560 V 21 w(sa)n(v)n(e)p 365 +2560 V 21 w(prompt)h Fg(\()p Ft(void)p Fg(\))195 2615 +y Fu(Sa)o(v)o(e)g(the)h(lo)q(cal)g(Readline)h(prompt)e(displa)o(y)i +(state)e(in)h(preparation)f(for)g(displa)o(ying)j(a)d(new)195 +2670 y(message)15 b(in)h(the)f(message)g(area)f(with)i +Ft(rl_message\(\))p Fu(.)p eop +%%Page: 34 36 +34 35 bop 75 -58 a Fu(34)1299 b(GNU)15 b(Readline)h(Library)1762 +149 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 149 +18 3 v 21 w(restore)p 436 149 V 20 w(prompt)g Fg(\()p +Ft(void)p Fg(\))195 204 y Fu(Restore)g(the)i(lo)q(cal)g(Readline)h +(prompt)e(displa)o(y)h(state)f(sa)o(v)o(ed)g(b)o(y)g(the)g(most)g +(recen)o(t)g(call)i(to)195 259 y Ft(rl_save_prompt)p +Fu(.)1762 369 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 369 V 21 w(expand)p 416 369 V 20 w(prompt)h Fg(\()p +Ft(char)14 b(*prompt)p Fg(\))195 423 y Fu(Expand)22 b(an)o(y)f(sp)q +(ecial)i(c)o(haracter)e(sequences)h(in)g Fk(prompt)g +Fu(and)g(set)f(up)h(the)f(lo)q(cal)i(Readline)195 478 +y(prompt)17 b(redispla)o(y)i(v)m(ariables.)30 b(This)18 b(function)h(is)f(called)i(b)o(y)e Ft(readline\(\))p -Fu(.)26 b(It)18 b(ma)o(y)f(also)h(b)q(e)195 2003 y(called)12 +Fu(.)26 b(It)18 b(ma)o(y)f(also)h(b)q(e)195 533 y(called)12 b(to)e(expand)h(the)g(primary)g(prompt)f(if)h(the)f Ft -(rl_on_new_line_with_prompt\(\))d Fu(function)195 2057 +(rl_on_new_line_with_prompt\(\))d Fu(function)195 588 y(or)12 b Ft(rl_already_prompted)e Fu(v)m(ariable)k(is)g(used.)19 b(It)13 b(returns)g(the)f(n)o(um)o(b)q(er)i(of)e(visible)j(c)o -(haracters)195 2112 y(on)g(the)g(last)h(line)g(of)f(the)g(\(p)q -(ossibly)i(m)o(ulti-line\))g(prompt.)1762 2236 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2236 V 21 w(set)p 307 2236 -V 20 w(prompt)h Fg(\()p Ft(const)14 b(char)h(*prompt)p -Fg(\))195 2291 y Fu(Mak)o(e)e(Readline)i(use)e Fk(prompt)h +(haracters)195 643 y(on)g(the)g(last)h(line)g(of)f(the)g(\(p)q(ossibly) +i(m)o(ulti-line\))g(prompt.)1762 752 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 752 V 21 w(set)p 307 752 V +20 w(prompt)h Fg(\()p Ft(const)14 b(char)h(*prompt)p +Fg(\))195 807 y Fu(Mak)o(e)e(Readline)i(use)e Fk(prompt)h Fu(for)f(subsequen)o(t)h(redispla)o(y)l(.)21 b(This)14 -b(calls)g Ft(rl_expand_prompt\(\))195 2346 y Fu(to)h(expand)g(the)h +b(calls)g Ft(rl_expand_prompt\(\))195 862 y Fu(to)h(expand)g(the)h (prompt)e(and)i(sets)f Ft(rl_prompt)f Fu(to)g(the)h(result.)75 -2462 y Fj(2.4.7)30 b(Mo)r(difying)20 b(T)-5 b(ext)1762 -2615 y Fu(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 -2615 V 21 w(insert)p 378 2615 V 21 w(text)k Fg(\()p Ft(const)14 -b(char)g(*text)p Fg(\))195 2670 y Fu(Insert)h Fk(text)h -Fu(in)o(to)f(the)h(line)g(at)f(the)g(curren)o(t)g(cursor)g(p)q -(osition.)p eop -%%Page: 32 34 -32 33 bop 75 -58 a Fu(32)1299 b(GNU)15 b(Readline)h(Library)1762 -149 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 149 -18 3 v 21 w(delete)p 383 149 V 22 w(text)k Fg(\()p Ft(int)14 -b(start,)h(int)f(end)p Fg(\))195 204 y Fu(Delete)i(the)f(text)g(b)q(et) -o(w)o(een)g Fk(start)g Fu(and)h Fk(end)h Fu(in)f(the)g(curren)o(t)f -(line.)1762 321 y(F)l(unction)-1861 b Fi(char)20 b(*)f -Fh(rl)p 286 321 V 21 w(cop)n(y)p 421 321 V 21 w(text)24 -b Fg(\()p Ft(int)14 b(start,)h(int)g(end)p Fg(\))195 -376 y Fu(Return)g(a)g(cop)o(y)g(of)g(the)g(text)f(b)q(et)o(w)o(een)i -Fk(start)f Fu(and)g Fk(end)j Fu(in)e(the)f(curren)o(t)g(line.)1762 -494 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 494 -V 21 w(kill)p 311 494 V 23 w(text)k Fg(\()p Ft(int)14 -b(start,)h(int)g(end)p Fg(\))195 548 y Fu(Cop)o(y)i(the)g(text)f(b)q -(et)o(w)o(een)i Fk(start)f Fu(and)g Fk(end)i Fu(in)f(the)f(curren)o(t)g -(line)i(to)e(the)g(kill)i(ring,)e(app)q(ending)195 603 -y(or)f(prep)q(ending)k(to)c(the)h(last)g(kill)i(if)e(the)g(last)g -(command)g(w)o(as)f(a)h(kill)i(command.)25 b(The)17 b(text)f(is)195 -658 y(deleted.)26 b(If)17 b Fk(start)g Fu(is)g(less)g(than)g -Fk(end)p Fu(,)g(the)g(text)g(is)g(app)q(ended,)h(otherwise)f(prep)q -(ended.)27 b(If)17 b(the)195 713 y(last)e(command)g(w)o(as)g(not)f(a)h -(kill,)i(a)e(new)g(kill)i(ring)f(slot)f(is)h(used.)1762 -830 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 830 -V 21 w(push)p 355 830 V 19 w(macro)p 529 830 V 19 w(input)k -Fg(\()p Ft(char)14 b(*macro)p Fg(\))195 885 y Fu(Cause)g -Fk(macro)i Fu(to)d(b)q(e)i(inserted)g(in)o(to)f(the)g(line,)i(as)e(if)g -(it)h(had)f(b)q(een)h(in)o(v)o(ok)o(ed)g(b)o(y)f(a)g(k)o(ey)g(b)q(ound) -h(to)195 940 y(a)g(macro.)k(Not)c(esp)q(ecially)i(useful;)f(use)g -Ft(rl_insert_text\(\))d Fu(instead.)75 1052 y Fj(2.4.8)30 -b(Character)21 b(Input)1762 1198 y Fu(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1198 V 21 w(read)p 346 1198 -V 20 w(k)n(ey)k Fg(\()p Ft(void)p Fg(\))195 1253 y Fu(Return)14 +970 y Fj(2.4.7)30 b(Mo)r(difying)20 b(T)-5 b(ext)1762 +1108 y Fu(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 +1108 V 21 w(insert)p 378 1108 V 21 w(text)k Fg(\()p Ft(const)14 +b(char)g(*text)p Fg(\))195 1163 y Fu(Insert)i Fk(text)g +Fu(in)o(to)g(the)g(line)h(at)f(the)g(curren)o(t)f(cursor)h(p)q +(osition.)22 b(Returns)16 b(the)g(n)o(um)o(b)q(er)g(of)f(c)o(har-)195 +1218 y(acters)g(inserted.)1762 1328 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1328 V 21 w(delete)p 383 1328 +V 22 w(text)k Fg(\()p Ft(int)14 b(start,)h(int)f(end)p +Fg(\))195 1382 y Fu(Delete)19 b(the)g(text)g(b)q(et)o(w)o(een)g +Fk(start)g Fu(and)g Fk(end)i Fu(in)f(the)f(curren)o(t)f(line.)33 +b(Returns)18 b(the)h(n)o(um)o(b)q(er)g(of)195 1437 y(c)o(haracters)14 +b(deleted.)1762 1547 y(F)l(unction)-1861 b Fi(char)20 +b(*)f Fh(rl)p 286 1547 V 21 w(cop)n(y)p 421 1547 V 21 +w(text)24 b Fg(\()p Ft(int)14 b(start,)h(int)g(end)p +Fg(\))195 1602 y Fu(Return)g(a)g(cop)o(y)g(of)g(the)g(text)f(b)q(et)o +(w)o(een)i Fk(start)f Fu(and)g Fk(end)j Fu(in)e(the)f(curren)o(t)g +(line.)1762 1711 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 1711 V 21 w(kill)p 311 1711 V 23 w(text)k Fg(\()p +Ft(int)14 b(start,)h(int)g(end)p Fg(\))195 1766 y Fu(Cop)o(y)i(the)g +(text)f(b)q(et)o(w)o(een)i Fk(start)f Fu(and)g Fk(end)i +Fu(in)f(the)f(curren)o(t)g(line)i(to)e(the)g(kill)i(ring,)e(app)q +(ending)195 1821 y(or)f(prep)q(ending)k(to)c(the)h(last)g(kill)i(if)e +(the)g(last)g(command)g(w)o(as)f(a)h(kill)i(command.)25 +b(The)17 b(text)f(is)195 1876 y(deleted.)26 b(If)17 b +Fk(start)g Fu(is)g(less)g(than)g Fk(end)p Fu(,)g(the)g(text)g(is)g(app) +q(ended,)h(otherwise)f(prep)q(ended.)27 b(If)17 b(the)195 +1930 y(last)e(command)g(w)o(as)g(not)f(a)h(kill,)i(a)e(new)g(kill)i +(ring)f(slot)f(is)h(used.)1762 2040 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 2040 V 21 w(push)p 355 2040 +V 19 w(macro)p 529 2040 V 19 w(input)k Fg(\()p Ft(char)14 +b(*macro)p Fg(\))195 2095 y Fu(Cause)g Fk(macro)i Fu(to)d(b)q(e)i +(inserted)g(in)o(to)f(the)g(line,)i(as)e(if)g(it)h(had)f(b)q(een)h(in)o +(v)o(ok)o(ed)g(b)o(y)f(a)g(k)o(ey)g(b)q(ound)h(to)195 +2150 y(a)g(macro.)k(Not)c(esp)q(ecially)i(useful;)f(use)g +Ft(rl_insert_text\(\))d Fu(instead.)75 2257 y Fj(2.4.8)30 +b(Character)21 b(Input)1762 2396 y Fu(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 2396 V 21 w(read)p 346 2396 +V 20 w(k)n(ey)k Fg(\()p Ft(void)p Fg(\))195 2451 y Fu(Return)14 b(the)h(next)g(c)o(haracter)f(a)o(v)m(ailable)i(from)e(Readline's)i -(curren)o(t)f(input)g(stream.)k(This)d(han-)195 1308 +(curren)o(t)f(input)g(stream.)k(This)d(han-)195 2506 y(dles)f(input)g(inserted)f(in)o(to)g(the)g(input)h(stream)e(via)h -Fk(rl)p 1117 1308 14 2 v 17 w(p)q(ending)p 1290 1308 +Fk(rl)p 1117 2506 14 2 v 17 w(p)q(ending)p 1290 2506 V 18 w(input)i Fu(\(see)e(Section)h(2.3)e([Read-)195 -1363 y(line)21 b(V)l(ariables],)g(page)f(22\))f(and)h +2560 y(line)21 b(V)l(ariables],)g(page)f(24\))f(and)h Ft(rl_stuff_char\(\))p Fu(,)e(macros,)h(and)h(c)o(haracters)f(read)h -(from)195 1417 y(the)d(k)o(eyb)q(oard.)25 b(While)19 +(from)195 2615 y(the)d(k)o(eyb)q(oard.)25 b(While)19 b(w)o(aiting)e(for)f(input,)j(this)e(function)h(will)h(call)f(an)o(y)e -(function)i(assigned)195 1472 y(to)d(the)g Ft(rl_event_hook)e -Fu(v)m(ariable.)1762 1589 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 1589 18 3 v 21 w(getc)j Fg(\()p Ft(FILE)14 -b(*stream)p Fg(\))195 1644 y Fu(Return)c(the)h(next)g(c)o(haracter)f(a) -o(v)m(ailable)i(from)e Fk(stream)p Fu(,)g(whic)o(h)i(is)f(assumed)f(to) -g(b)q(e)i(the)e(k)o(eyb)q(oard.)1762 1761 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1761 V 21 w(stu\013)p 346 1761 -V 20 w(c)n(har)j Fg(\()p Ft(int)15 b(c)p Fg(\))195 1816 +(function)i(assigned)195 2670 y(to)d(the)g Ft(rl_event_hook)e +Fu(v)m(ariable.)p eop +%%Page: 35 37 +35 36 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(35)1762 149 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 149 18 3 v 21 w(getc)j Fg(\()p Ft(FILE)14 +b(*stream)p Fg(\))195 204 y Fu(Return)c(the)h(next)g(c)o(haracter)f(a)o +(v)m(ailable)i(from)e Fk(stream)p Fu(,)g(whic)o(h)i(is)f(assumed)f(to)g +(b)q(e)i(the)e(k)o(eyb)q(oard.)1762 342 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 342 V 21 w(stu\013)p 346 342 +V 20 w(c)n(har)j Fg(\()p Ft(int)15 b(c)p Fg(\))195 397 y Fu(Insert)i Fk(c)i Fu(in)o(to)d(the)h(Readline)h(input)f(stream.)23 b(It)16 b(will)i(b)q(e)f Ft(")p Fu(read)p Ft(")g Fu(b)q(efore)f -(Readline)i(attempts)195 1871 y(to)d(read)g(c)o(haracters)f(from)h(the) -g(terminal)h(with)f Ft(rl_read_key\(\))p Fu(.)1762 1988 -y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1988 V -21 w(execute)p 423 1988 V 22 w(next)j Fg(\()p Ft(int)15 -b(c)p Fg(\))195 2043 y Fu(Mak)o(e)i Fk(c)k Fu(b)q(e)d(the)g(next)g +(Readline)i(attempts)195 452 y(to)13 b(read)g(c)o(haracters)g(from)f +(the)i(terminal)g(with)g Ft(rl_read_key\(\))p Fu(.)j(Up)d(to)f(512)f(c) +o(haracters)h(ma)o(y)195 507 y(b)q(e)j(pushed)g(bac)o(k.)k +Ft(rl_stuff_char)14 b Fu(returns)h(1)g(if)h(the)f(c)o(haracter)g(w)o +(as)f(successfully)j(inserted;)195 562 y(0)e(otherwise.)1762 +700 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 700 +V 21 w(execute)p 423 700 V 22 w(next)j Fg(\()p Ft(int)15 +b(c)p Fg(\))195 754 y Fu(Mak)o(e)i Fk(c)k Fu(b)q(e)d(the)g(next)g (command)g(to)f(b)q(e)i(executed)f(when)h Ft(rl_read_key\(\))d -Fu(is)i(called.)29 b(This)195 2098 y(sets)15 b Fk(rl)p -317 2098 14 2 v 17 w(p)q(ending)p 490 2098 V 18 w(input)p -Fu(.)1762 2215 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 2215 18 3 v 21 w(clear)p 354 2215 V 21 w(p)r(ending)p -575 2215 V 21 w(input)j Fg(\()p Ft(void)p Fg(\))195 2270 -y Fu(Unset)f Fk(rl)p 365 2270 14 2 v 16 w(p)q(ending)p -537 2270 V 19 w(input)p Fu(,)h(e\013ectiv)o(ely)g(negating)e(the)h +Fu(is)i(called.)29 b(This)195 809 y(sets)15 b Fk(rl)p +317 809 14 2 v 17 w(p)q(ending)p 490 809 V 18 w(input)p +Fu(.)1762 947 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 947 18 3 v 21 w(clear)p 354 947 V 21 w(p)r(ending)p +575 947 V 21 w(input)j Fg(\()p Ft(void)p Fg(\))195 1002 +y Fu(Unset)f Fk(rl)p 365 1002 14 2 v 16 w(p)q(ending)p +537 1002 V 19 w(input)p Fu(,)h(e\013ectiv)o(ely)g(negating)e(the)h (e\013ect)f(of)g(an)o(y)h(previous)g(call)h(to)d Ft(rl_)195 -2325 y(execute_next\(\))p Fu(.)29 b(This)19 b(w)o(orks)f(only)h(if)h +1057 y(execute_next\(\))p Fu(.)29 b(This)19 b(w)o(orks)f(only)h(if)h (the)e(p)q(ending)j(input)f(has)f(not)f(already)h(b)q(een)h(read)195 -2380 y(with)c Ft(rl_read_key\(\))p Fu(.)1762 2497 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2497 18 3 v 21 w(set)p 307 -2497 V 20 w(k)n(eyb)r(oard)p 558 2497 V 21 w(input)p -712 2497 V 21 w(timeout)i Fg(\()p Ft(int)15 b(u)p Fg(\))195 -2552 y Fu(While)21 b(w)o(aiting)g(for)e(k)o(eyb)q(oard)h(input)h(in)g +1112 y(with)c Ft(rl_read_key\(\))p Fu(.)1762 1250 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1250 18 3 v 21 w(set)p 307 +1250 V 20 w(k)n(eyb)r(oard)p 558 1250 V 21 w(input)p +712 1250 V 21 w(timeout)i Fg(\()p Ft(int)15 b(u)p Fg(\))195 +1305 y Fu(While)21 b(w)o(aiting)g(for)e(k)o(eyb)q(oard)h(input)h(in)g Ft(rl_read_key\(\))p Fu(,)e(Readline)i(will)h(w)o(ait)e(for)f -Fk(u)h Fu(mi-)195 2606 y(croseconds)h(for)e(input)j(b)q(efore)f +Fk(u)h Fu(mi-)195 1360 y(croseconds)h(for)e(input)j(b)q(efore)f (calling)h(an)o(y)e(function)h(assigned)g(to)f Ft(rl_event_hook)p -Fu(.)34 b(The)195 2661 y(default)16 b(w)o(aiting)f(p)q(erio)q(d)i(is)e +Fu(.)34 b(The)195 1414 y(default)16 b(w)o(aiting)f(p)q(erio)q(d)i(is)e (one-ten)o(th)h(of)e(a)h(second.)21 b(Returns)14 b(the)i(old)f(timeout) -h(v)m(alue.)p eop -%%Page: 33 35 -33 34 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(33)75 149 y Fj(2.4.9)30 b(T)-5 b(erminal)20 -b(Managemen)n(t)1762 290 y Fu(F)l(unction)-1861 b Fi(void)20 -b Fh(rl)p 241 290 18 3 v 21 w(prep)p 376 290 V 20 w(terminal)j -Fg(\()p Ft(int)14 b(meta_flag)p Fg(\))195 345 y Fu(Mo)q(dify)22 +h(v)m(alue.)75 1540 y Fj(2.4.9)30 b(T)-5 b(erminal)20 +b(Managemen)n(t)1762 1708 y Fu(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 1708 V 21 w(prep)p 376 1708 V 20 w(terminal)j +Fg(\()p Ft(int)14 b(meta_flag)p Fg(\))195 1762 y Fu(Mo)q(dify)22 b(the)f(terminal)h(settings)f(for)g(Readline's)h(use,)h(so)d -Ft(readline\(\))g Fu(can)i(read)f(a)g(single)195 400 +Ft(readline\(\))g Fu(can)i(read)f(a)g(single)195 1817 y(c)o(haracter)15 b(at)g(a)g(time)i(from)d(the)i(k)o(eyb)q(oard.)22 -b(The)16 b Fk(meta)p 1192 400 14 2 v 15 w(\015ag)k Fu(argumen)o(t)15 -b(should)h(b)q(e)h(non-zero)195 454 y(if)f(Readline)g(should)g(read)f -(eigh)o(t-bit)i(input.)1762 566 y(F)l(unction)-1861 b -Fi(void)20 b Fh(rl)p 241 566 18 3 v 21 w(deprep)p 434 -566 V 20 w(terminal)j Fg(\()p Ft(void)p Fg(\))195 621 -y Fu(Undo)16 b(the)g(e\013ects)f(of)h Ft(rl_prep_terminal\(\))p +b(The)16 b Fk(meta)p 1192 1817 14 2 v 15 w(\015ag)k Fu(argumen)o(t)15 +b(should)h(b)q(e)h(non-zero)195 1872 y(if)f(Readline)g(should)g(read)f +(eigh)o(t-bit)i(input.)1762 2010 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 2010 18 3 v 21 w(deprep)p +434 2010 V 20 w(terminal)j Fg(\()p Ft(void)p Fg(\))195 +2065 y Fu(Undo)16 b(the)g(e\013ects)f(of)h Ft(rl_prep_terminal\(\))p Fu(,)d(lea)o(ving)k(the)e(terminal)i(in)g(the)e(state)g(in)i(whic)o(h) -195 676 y(it)e(w)o(as)g(b)q(efore)g(the)h(most)e(recen)o(t)h(call)i(to) -d Ft(rl_prep_terminal\(\))p Fu(.)1762 787 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 787 V 21 w(tt)n(y)p 334 787 -V 22 w(set)p 427 787 V 20 w(default)p 620 787 V 21 w(bindings)k -Fg(\()p Ft(Keymap)14 b(kmap)p Fg(\))195 842 y Fu(Read)k(the)h(op)q -(erating)f(system's)g(terminal)h(editing)h(c)o(haracters)e(\(as)f(w)o -(ould)i(b)q(e)g(displa)o(y)o(ed)h(b)o(y)195 897 y Ft(stty)p -Fu(\))14 b(to)h(their)h(Readline)g(equiv)m(alen)o(ts.)22 -b(The)15 b(bindings)i(are)e(p)q(erformed)g(in)h Fk(kmap)p -Fu(.)1762 1008 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 1008 V 21 w(reset)p 357 1008 V 20 w(terminal)j Fg(\()p -Ft(const)15 b(char)f(*terminal_name)p Fg(\))195 1063 +195 2120 y(it)e(w)o(as)g(b)q(efore)g(the)h(most)e(recen)o(t)h(call)i +(to)d Ft(rl_prep_terminal\(\))p Fu(.)1762 2258 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 2258 V 21 w(tt)n(y)p 334 2258 +V 22 w(set)p 427 2258 V 20 w(default)p 620 2258 V 21 +w(bindings)k Fg(\()p Ft(Keymap)14 b(kmap)p Fg(\))195 +2313 y Fu(Read)k(the)h(op)q(erating)f(system's)g(terminal)h(editing)h +(c)o(haracters)e(\(as)f(w)o(ould)i(b)q(e)g(displa)o(y)o(ed)h(b)o(y)195 +2367 y Ft(stty)p Fu(\))14 b(to)h(their)h(Readline)g(equiv)m(alen)o(ts.) +22 b(The)15 b(bindings)i(are)e(p)q(erformed)g(in)h Fk(kmap)p +Fu(.)1762 2506 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 2506 V 21 w(reset)p 357 2506 V 20 w(terminal)j Fg(\()p +Ft(const)15 b(char)f(*terminal_name)p Fg(\))195 2560 y Fu(Reinitialize)h(Readline's)e(idea)g(of)f(the)g(terminal)h(settings) -g(using)g Fk(terminal)p 1491 1063 14 2 v 17 w(name)h -Fu(as)e(the)h(termi-)195 1118 y(nal)k(t)o(yp)q(e)f(\(e.g.,)f -Ft(vt100)p Fu(\).)21 b(If)c Fk(terminal)p 878 1118 V +g(using)g Fk(terminal)p 1491 2560 14 2 v 17 w(name)h +Fu(as)e(the)h(termi-)195 2615 y(nal)k(t)o(yp)q(e)f(\(e.g.,)f +Ft(vt100)p Fu(\).)21 b(If)c Fk(terminal)p 878 2615 V 17 w(name)i Fu(is)d Ft(NULL)p Fu(,)g(the)g(v)m(alue)h(of)f(the)g -Ft(TERM)g Fu(en)o(vironmen)o(t)195 1173 y(v)m(ariable)h(is)e(used.)75 -1282 y Fj(2.4.10)29 b(Utilit)n(y)22 b(F)-5 b(unctions)1762 -1422 y Fu(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 -1422 18 3 v 21 w(extend)p 404 1422 V 21 w(line)p 513 -1422 V 22 w(bu\013er)j Fg(\()p Ft(int)15 b(len)p Fg(\))195 -1477 y Fu(Ensure)g(that)g Ft(rl_line_buffer)e Fu(has)i(enough)g(space)h -(to)e(hold)i Fk(len)g Fu(c)o(haracters,)e(p)q(ossibly)i(real-)195 -1532 y(lo)q(cating)g(it)f(if)h(necessary)l(.)1762 1644 -y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1644 V -21 w(initiali)q(z)q(e)26 b Fg(\()p Ft(void)p Fg(\))195 -1698 y Fu(Initialize)21 b(or)d(re-initialize)k(Readline's)d(in)o -(ternal)h(state.)28 b(It's)18 b(not)g(strictly)h(necessary)g(to)f(call) -195 1753 y(this;)d Ft(readline\(\))f Fu(calls)i(it)g(b)q(efore)f -(reading)h(an)o(y)f(input.)1762 1865 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1865 V 21 w(ding)j Fg(\()p -Ft(void)p Fg(\))195 1920 y Fu(Ring)15 b(the)g(terminal)h(b)q(ell,)h(ob) -q(eying)f(the)g(setting)f(of)g Ft(bell-style)p Fu(.)1762 -2031 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2031 -V 21 w(alphab)r(etic)k Fg(\()p Ft(int)14 b(c)p Fg(\))195 -2086 y Fu(Return)h(1)g(if)g Fk(c)j Fu(is)e(an)f(alphab)q(etic)i(c)o -(haracter.)1762 2198 y(F)l(unction)-1861 b Fi(void)20 -b Fh(rl)p 241 2198 V 21 w(displa)n(y)p 435 2198 V 22 -w(matc)n(h)p 611 2198 V 20 w(list)25 b Fg(\()p Ft(char)14 -b(**matches,)g(int)g(len,)h(int)g(max)p Fg(\))195 2252 -y Fu(A)i(con)o(v)o(enience)i(function)f(for)f(displa)o(ying)i(a)e(list) -h(of)e(strings)h(in)i(columnar)e(format)f(on)h(Read-)195 -2307 y(line's)h(output)f(stream.)23 b Ft(matches)16 b -Fu(is)h(the)g(list)h(of)e(strings,)h(in)g(argv)f(format,)g(suc)o(h)h -(as)f(a)h(list)g(of)195 2362 y(completion)c(matc)o(hes.)19 +Ft(TERM)g Fu(en)o(vironmen)o(t)195 2670 y(v)m(ariable)h(is)e(used.)p +eop +%%Page: 36 38 +36 37 bop 75 -58 a Fu(36)1299 b(GNU)15 b(Readline)h(Library)75 +149 y Fj(2.4.10)29 b(Utilit)n(y)22 b(F)-5 b(unctions)1762 +287 y Fu(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 +287 18 3 v 21 w(replace)p 438 287 V 22 w(line)k Fg(\()p +Ft(const)14 b(char)h(*text,)f(int)h(clear_undo)p Fg(\))195 +342 y Fu(Replace)20 b(the)g(con)o(ten)o(ts)f(of)g Ft(rl_line_buffer)f +Fu(with)i Fk(text)p Fu(.)33 b(The)20 b(p)q(oin)o(t)g(and)g(mark)f(are)h +(pre-)195 397 y(serv)o(ed,)13 b(if)h(p)q(ossible.)21 +b(If)13 b Fk(clear)p 712 397 14 2 v 17 w(undo)j Fu(is)d(non-zero,)h +(the)f(undo)g(list)h(asso)q(ciated)g(with)f(the)g(curren)o(t)195 +452 y(line)k(is)f(cleared.)1762 561 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 561 18 3 v 21 w(extend)p 404 +561 V 21 w(line)p 513 561 V 22 w(bu\013er)j Fg(\()p Ft(int)15 +b(len)p Fg(\))195 616 y Fu(Ensure)g(that)g Ft(rl_line_buffer)e +Fu(has)i(enough)g(space)h(to)e(hold)i Fk(len)g Fu(c)o(haracters,)e(p)q +(ossibly)i(real-)195 670 y(lo)q(cating)g(it)f(if)h(necessary)l(.)1762 +779 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 779 +V 21 w(initiali)q(z)q(e)26 b Fg(\()p Ft(void)p Fg(\))195 +834 y Fu(Initialize)21 b(or)d(re-initialize)k(Readline's)d(in)o(ternal) +h(state.)28 b(It's)18 b(not)g(strictly)h(necessary)g(to)f(call)195 +889 y(this;)d Ft(readline\(\))f Fu(calls)i(it)g(b)q(efore)f(reading)h +(an)o(y)f(input.)1762 998 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 998 V 21 w(ding)j Fg(\()p Ft(void)p Fg(\))195 +1053 y Fu(Ring)15 b(the)g(terminal)h(b)q(ell,)h(ob)q(eying)f(the)g +(setting)f(of)g Ft(bell-style)p Fu(.)1762 1162 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1162 V 21 w(alphab)r(etic)k +Fg(\()p Ft(int)14 b(c)p Fg(\))195 1217 y Fu(Return)h(1)g(if)g +Fk(c)j Fu(is)e(an)f(alphab)q(etic)i(c)o(haracter.)1762 +1325 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1325 +V 21 w(displa)n(y)p 435 1325 V 22 w(matc)n(h)p 611 1325 +V 20 w(list)25 b Fg(\()p Ft(char)14 b(**matches,)g(int)g(len,)h(int)g +(max)p Fg(\))195 1380 y Fu(A)i(con)o(v)o(enience)i(function)f(for)f +(displa)o(ying)i(a)e(list)h(of)e(strings)h(in)i(columnar)e(format)f(on) +h(Read-)195 1435 y(line's)h(output)f(stream.)23 b Ft(matches)16 +b Fu(is)h(the)g(list)h(of)e(strings,)h(in)g(argv)f(format,)g(suc)o(h)h +(as)f(a)h(list)g(of)195 1490 y(completion)c(matc)o(hes.)19 b Ft(len)11 b Fu(is)i(the)f(n)o(um)o(b)q(er)h(of)e(strings)h(in)h Ft(matches)p Fu(,)f(and)g Ft(max)g Fu(is)g(the)h(length)f(of)195 -2417 y(the)h(longest)g(string)g(in)h Ft(matches)p Fu(.)19 +1545 y(the)h(longest)g(string)g(in)h Ft(matches)p Fu(.)19 b(This)13 b(function)h(uses)f(the)h(setting)f(of)f Ft -(print-completions-)195 2472 y(horizontally)k Fu(to)i(select)h(ho)o(w)e +(print-completions-)195 1599 y(horizontally)k Fu(to)i(select)h(ho)o(w)e (the)i(matc)o(hes)e(are)h(displa)o(y)o(ed)h(\(see)g(Section)g(1.3.1)d -([Readline)195 2526 y(Init)g(File)g(Syn)o(tax],)e(page)h(4\).)137 -2615 y(The)i(follo)o(wing)f(are)g(implemen)o(ted)i(as)e(macros,)f +([Readline)195 1654 y(Init)g(File)g(Syn)o(tax],)e(page)h(4\).)137 +1742 y(The)i(follo)o(wing)f(are)g(implemen)o(ted)i(as)e(macros,)f (de\014ned)i(in)g Ft(chardefs.h)p Fu(.)k(Applications)d(should)75 -2670 y(refrain)d(from)g(using)h(them.)p eop -%%Page: 34 36 -34 35 bop 75 -58 a Fu(34)1299 b(GNU)15 b(Readline)h(Library)1762 -149 y(F)l(unction)-1861 b Fi(int)p 176 149 18 3 v 40 -w Fh(rl)p 235 149 V 21 w(upp)r(ercase)p 506 149 V 20 -w(p)23 b Fg(\()p Ft(int)14 b(c)p Fg(\))195 204 y Fu(Return)h(1)g(if)g -Fk(c)j Fu(is)e(an)f(upp)q(ercase)i(alphab)q(etic)f(c)o(haracter.)1762 -322 y(F)l(unction)-1861 b Fi(int)p 176 322 V 40 w Fh(rl)p -235 322 V 21 w(lo)n(w)n(ercase)p 489 322 V 23 w(p)22 -b Fg(\()p Ft(int)15 b(c)p Fg(\))195 376 y Fu(Return)g(1)g(if)g -Fk(c)j Fu(is)e(a)f(lo)o(w)o(ercase)g(alphab)q(etic)i(c)o(haracter.)1762 -494 y(F)l(unction)-1861 b Fi(int)p 176 494 V 40 w Fh(rl)p -235 494 V 21 w(digit)p 369 494 V 22 w(p)23 b Fg(\()p -Ft(int)14 b(c)p Fg(\))195 549 y Fu(Return)h(1)g(if)g -Fk(c)j Fu(is)e(a)f(n)o(umeric)h(c)o(haracter.)1762 666 -y(F)l(unction)-1861 b Fi(int)p 176 666 V 40 w Fh(rl)p -235 666 V 21 w(to)p 307 666 V 21 w(upp)r(er)21 b Fg(\()p -Ft(int)15 b(c)p Fg(\))195 721 y Fu(If)d Fk(c)j Fu(is)d(a)g(lo)o(w)o -(ercase)f(alphab)q(etic)j(c)o(haracter,)d(return)h(the)g(corresp)q -(onding)h(upp)q(ercase)g(c)o(haracter.)1762 838 y(F)l(unction)-1861 -b Fi(int)p 176 838 V 40 w Fh(rl)p 235 838 V 21 w(to)p -307 838 V 21 w(lo)n(w)n(er)24 b Fg(\()p Ft(int)15 b(c)p -Fg(\))195 893 y Fu(If)g Fk(c)i Fu(is)e(an)f(upp)q(ercase)i(alphab)q -(etic)g(c)o(haracter,)e(return)g(the)h(corresp)q(onding)g(lo)o(w)o -(ercase)f(c)o(harac-)195 948 y(ter.)1762 1065 y(F)l(unction)-1861 -b Fi(int)p 176 1065 V 40 w Fh(rl)p 235 1065 V 21 w(digit)p -369 1065 V 22 w(v)m(alue)24 b Fg(\()p Ft(int)15 b(c)p -Fg(\))195 1120 y Fu(If)g Fk(c)k Fu(is)c(a)g(n)o(um)o(b)q(er,)g(return)g -(the)h(v)m(alue)g(it)g(represen)o(ts.)75 1232 y Fj(2.4.11)29 -b(Miscellaneous)22 b(F)-5 b(unctions)1762 1379 y Fu(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1379 V 21 w(macro)p 391 1379 -V 19 w(bind)j Fg(\()p Ft(const)14 b(char)g(*keyseq,)h(const)f(char)h -(*macro,)283 1433 y(Keymap)f(map)p Fg(\))195 1488 y Fu(Bind)f(the)f(k)o -(ey)f(sequence)i Fk(k)o(eyseq)g Fu(to)e(in)o(v)o(ok)o(e)g(the)h(macro)f +1796 y(refrain)d(from)g(using)h(them.)1762 1905 y(F)l(unction)-1861 +b Fi(int)p 176 1905 V 40 w Fh(rl)p 235 1905 V 21 w(upp)r(ercase)p +506 1905 V 20 w(p)23 b Fg(\()p Ft(int)14 b(c)p Fg(\))195 +1960 y Fu(Return)h(1)g(if)g Fk(c)j Fu(is)e(an)f(upp)q(ercase)i(alphab)q +(etic)f(c)o(haracter.)1762 2069 y(F)l(unction)-1861 b +Fi(int)p 176 2069 V 40 w Fh(rl)p 235 2069 V 21 w(lo)n(w)n(ercase)p +489 2069 V 23 w(p)22 b Fg(\()p Ft(int)15 b(c)p Fg(\))195 +2124 y Fu(Return)g(1)g(if)g Fk(c)j Fu(is)e(a)f(lo)o(w)o(ercase)g +(alphab)q(etic)i(c)o(haracter.)1762 2233 y(F)l(unction)-1861 +b Fi(int)p 176 2233 V 40 w Fh(rl)p 235 2233 V 21 w(digit)p +369 2233 V 22 w(p)23 b Fg(\()p Ft(int)14 b(c)p Fg(\))195 +2288 y Fu(Return)h(1)g(if)g Fk(c)j Fu(is)e(a)f(n)o(umeric)h(c)o +(haracter.)1762 2397 y(F)l(unction)-1861 b Fi(int)p 176 +2397 V 40 w Fh(rl)p 235 2397 V 21 w(to)p 307 2397 V 21 +w(upp)r(er)21 b Fg(\()p Ft(int)15 b(c)p Fg(\))195 2451 +y Fu(If)d Fk(c)j Fu(is)d(a)g(lo)o(w)o(ercase)f(alphab)q(etic)j(c)o +(haracter,)d(return)h(the)g(corresp)q(onding)h(upp)q(ercase)g(c)o +(haracter.)1762 2560 y(F)l(unction)-1861 b Fi(int)p 176 +2560 V 40 w Fh(rl)p 235 2560 V 21 w(to)p 307 2560 V 21 +w(lo)n(w)n(er)24 b Fg(\()p Ft(int)15 b(c)p Fg(\))195 +2615 y Fu(If)g Fk(c)i Fu(is)e(an)f(upp)q(ercase)i(alphab)q(etic)g(c)o +(haracter,)e(return)g(the)h(corresp)q(onding)g(lo)o(w)o(ercase)f(c)o +(harac-)195 2670 y(ter.)p eop +%%Page: 37 39 +37 38 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(37)1762 149 y(F)l(unction)-1861 b Fi(int)p +176 149 18 3 v 40 w Fh(rl)p 235 149 V 21 w(digit)p 369 +149 V 22 w(v)m(alue)24 b Fg(\()p Ft(int)15 b(c)p Fg(\))195 +204 y Fu(If)g Fk(c)k Fu(is)c(a)g(n)o(um)o(b)q(er,)g(return)g(the)h(v)m +(alue)g(it)g(represen)o(ts.)75 325 y Fj(2.4.11)29 b(Miscellaneous)22 +b(F)-5 b(unctions)1762 484 y Fu(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 484 V 21 w(macro)p 391 484 V 19 w(bind)j +Fg(\()p Ft(const)14 b(char)g(*keyseq,)h(const)f(char)h(*macro,)283 +539 y(Keymap)f(map)p Fg(\))195 593 y Fu(Bind)f(the)f(k)o(ey)f(sequence) +i Fk(k)o(eyseq)g Fu(to)e(in)o(v)o(ok)o(e)g(the)h(macro)f Fk(macro)p Fu(.)18 b(The)12 b(binding)h(is)f(p)q(erformed)g(in)195 -1543 y Fk(map)p Fu(.)19 b(When)14 b Fk(k)o(eyseq)h Fu(is)f(in)o(v)o(ok) -o(ed,)g(the)g Fk(macro)i Fu(will)f(b)q(e)f(inserted)h(in)o(to)f(the)g -(line.)21 b(This)14 b(function)195 1598 y(is)i(deprecated;)f(use)h -Ft(rl_generic_bind\(\))d Fu(instead.)1762 1715 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 1715 V 21 w(macro)p 417 1715 +648 y Fk(map)p Fu(.)19 b(When)14 b Fk(k)o(eyseq)h Fu(is)f(in)o(v)o(ok)o +(ed,)g(the)g Fk(macro)i Fu(will)f(b)q(e)f(inserted)h(in)o(to)f(the)g +(line.)21 b(This)14 b(function)195 703 y(is)i(deprecated;)f(use)h +Ft(rl_generic_bind\(\))d Fu(instead.)1762 833 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 833 V 21 w(macro)p 417 833 V 19 w(dump)r(er)g Fg(\()p Ft(int)15 b(readable)p Fg(\))195 -1770 y Fu(Prin)o(t)f(the)f(k)o(ey)h(sequences)g(b)q(ound)h(to)e(macros) -g(and)g(their)h(v)m(alues,)h(using)f(the)g(curren)o(t)g(k)o(eymap,)195 -1825 y(to)h Ft(rl_outstream)p Fu(.)k(If)d Fk(readable)j +888 y Fu(Prin)o(t)f(the)f(k)o(ey)h(sequences)g(b)q(ound)h(to)e(macros)g +(and)g(their)h(v)m(alues,)h(using)f(the)g(curren)o(t)g(k)o(eymap,)195 +943 y(to)h Ft(rl_outstream)p Fu(.)k(If)d Fk(readable)j Fu(is)d(non-zero,)g(the)g(list)g(is)g(formatted)f(in)h(suc)o(h)g(a)f(w) -o(a)o(y)g(that)g(it)195 1880 y(can)g(b)q(e)h(made)f(part)g(of)g(an)g -Ft(inputrc)f Fu(\014le)i(and)g(re-read.)1762 1997 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1997 V 21 w(v)m(ariable)p 431 -1997 V 22 w(bind)j Fg(\()p Ft(const)14 b(char)g(*variable,)g(const)h -(char)f(*value)p Fg(\))195 2052 y Fu(Mak)o(e)22 b(the)g(Readline)i(v)m +o(a)o(y)g(that)g(it)195 997 y(can)g(b)q(e)h(made)f(part)g(of)g(an)g +Ft(inputrc)f Fu(\014le)i(and)g(re-read.)1762 1127 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1127 V 21 w(v)m(ariable)p 431 +1127 V 22 w(bind)j Fg(\()p Ft(const)14 b(char)g(*variable,)g(const)h +(char)f(*value)p Fg(\))195 1182 y Fu(Mak)o(e)22 b(the)g(Readline)i(v)m (ariable)g Fk(v)m(ariable)j Fu(ha)o(v)o(e)22 b Fk(v)m(alue)p Fu(.)43 b(This)23 b(b)q(eha)o(v)o(es)g(as)f(if)h(the)f(readline)195 -2106 y(command)12 b(`)p Ft(set)j Fk(v)m(ariable)k(v)m(alue)s +1237 y(command)12 b(`)p Ft(set)j Fk(v)m(ariable)k(v)m(alue)s Fu(')12 b(had)h(b)q(een)g(executed)h(in)f(an)f Ft(inputrc)g -Fu(\014le)h(\(see)f(Section)i(1.3.1)195 2161 y([Readline)i(Init)g(File) -h(Syn)o(tax],)d(page)h(4\).)1762 2279 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 2279 V 21 w(v)m(ariable)p -457 2279 V 22 w(dump)r(er)g Fg(\()p Ft(int)14 b(readable)p -Fg(\))195 2333 y Fu(Prin)o(t)g(the)h(readline)h(v)m(ariable)f(names)g +Fu(\014le)h(\(see)f(Section)i(1.3.1)195 1292 y([Readline)i(Init)g(File) +h(Syn)o(tax],)d(page)h(4\).)1762 1422 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 1422 V 21 w(v)m(ariable)p +457 1422 V 22 w(dump)r(er)g Fg(\()p Ft(int)14 b(readable)p +Fg(\))195 1476 y Fu(Prin)o(t)g(the)h(readline)h(v)m(ariable)f(names)g (and)f(their)h(curren)o(t)f(v)m(alues)i(to)d Ft(rl_outstream)p -Fu(.)18 b(If)d Fk(read-)195 2388 y(able)20 b Fu(is)e(non-zero,)f(the)g +Fu(.)18 b(If)d Fk(read-)195 1531 y(able)20 b Fu(is)e(non-zero,)f(the)g (list)h(is)g(formatted)e(in)h(suc)o(h)h(a)e(w)o(a)o(y)g(that)h(it)g -(can)g(b)q(e)h(made)f(part)f(of)h(an)195 2443 y Ft(inputrc)d -Fu(\014le)i(and)g(re-read.)1762 2560 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2560 V 21 w(set)p 307 2560 -V 20 w(paren)p 469 2560 V 20 w(blink)p 613 2560 V 23 -w(timeout)i Fg(\()p Ft(int)15 b(u)p Fg(\))195 2615 y +(can)g(b)q(e)h(made)f(part)f(of)h(an)195 1586 y Ft(inputrc)d +Fu(\014le)i(and)g(re-read.)1762 1716 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1716 V 21 w(set)p 307 1716 +V 20 w(paren)p 469 1716 V 20 w(blink)p 613 1716 V 23 +w(timeout)i Fg(\()p Ft(int)15 b(u)p Fg(\))195 1771 y Fu(Set)e(the)f(time)h(in)o(terv)m(al)h(\(in)f(microseconds\))g(that)f (Readline)i(w)o(aits)e(when)h(sho)o(wing)f(a)h(balancing)195 -2670 y(c)o(haracter)h(when)i Ft(blink-matching-paren)d -Fu(has)i(b)q(een)h(enabled.)p eop -%%Page: 35 37 -35 36 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(35)1762 149 y(F)l(unction)-1861 b Fi(char)20 -b(*)f Fh(rl)p 286 149 18 3 v 21 w(get)p 384 149 V 21 -w(termcap)j Fg(\()p Ft(const)14 b(char)g(*cap)p Fg(\))195 -204 y Fu(Retriev)o(e)f(the)h(string)f(v)m(alue)i(of)e(the)h(termcap)f -(capabilit)o(y)i Fk(cap)p Fu(.)k(Readline)c(fetc)o(hes)f(the)f(termcap) -195 259 y(en)o(try)j(for)h(the)f(curren)o(t)h(terminal)h(name)e(and)h -(uses)g(those)g(capabilities)i(to)d(mo)o(v)o(e)g(around)h(the)195 -314 y(screen)11 b(line)h(and)f(p)q(erform)f(other)g(terminal-sp)q -(eci\014c)k(op)q(erations,)d(lik)o(e)h(erasing)e(a)h(line.)20 -b(Readline)195 369 y(do)q(es)e(not)f(use)h(all)g(of)f(a)g(terminal's)h -(capabilities,)i(and)e(this)g(function)g(will)h(return)f(v)m(alues)h -(for)195 423 y(only)d(those)f(capabilities)i(Readline)g(uses.)75 -537 y Fj(2.4.12)29 b(Alternate)21 b(In)n(terface)137 -634 y Fu(An)i(alternate)f(in)o(terface)h(is)g(a)o(v)m(ailable)h(to)d +1826 y(c)o(haracter)h(when)i Ft(blink-matching-paren)d +Fu(has)i(b)q(een)h(enabled.)1762 1956 y(F)l(unction)-1861 +b Fi(char)20 b(*)f Fh(rl)p 286 1956 V 21 w(get)p 384 +1956 V 21 w(termcap)j Fg(\()p Ft(const)14 b(char)g(*cap)p +Fg(\))195 2010 y Fu(Retriev)o(e)f(the)h(string)f(v)m(alue)i(of)e(the)h +(termcap)f(capabilit)o(y)i Fk(cap)p Fu(.)k(Readline)c(fetc)o(hes)f(the) +f(termcap)195 2065 y(en)o(try)j(for)h(the)f(curren)o(t)h(terminal)h +(name)e(and)h(uses)g(those)g(capabilities)i(to)d(mo)o(v)o(e)g(around)h +(the)195 2120 y(screen)11 b(line)h(and)f(p)q(erform)f(other)g +(terminal-sp)q(eci\014c)k(op)q(erations,)d(lik)o(e)h(erasing)e(a)h +(line.)20 b(Readline)195 2175 y(do)q(es)e(not)f(use)h(all)g(of)f(a)g +(terminal's)h(capabilities,)i(and)e(this)g(function)g(will)h(return)f +(v)m(alues)h(for)195 2230 y(only)d(those)f(capabilities)i(Readline)g +(uses.)75 2350 y Fj(2.4.12)29 b(Alternate)21 b(In)n(terface)137 +2451 y Fu(An)i(alternate)f(in)o(terface)h(is)g(a)o(v)m(ailable)h(to)d (plain)j Ft(readline\(\))p Fu(.)40 b(Some)22 b(applications)i(need)g -(to)75 689 y(in)o(terlea)o(v)o(e)15 b(k)o(eyb)q(oard)f(I/O)h(with)g +(to)75 2506 y(in)o(terlea)o(v)o(e)15 b(k)o(eyb)q(oard)f(I/O)h(with)g (\014le,)h(device,)f(or)f(windo)o(w)h(system)f(I/O,)h(t)o(ypically)h(b) -o(y)e(using)h(a)g(main)75 744 y(lo)q(op)f(to)g Ft(select\(\))e +o(y)e(using)h(a)g(main)75 2560 y(lo)q(op)f(to)g Ft(select\(\))e Fu(on)i(v)m(arious)g(\014le)h(descriptors.)20 b(T)l(o)14 b(accomo)q(date)f(this)h(need,)h(readline)g(can)f(also)g(b)q(e)75 -799 y(in)o(v)o(ok)o(ed)i(as)f(a)g(`callbac)o(k')h(function)h(from)d(an) -i(ev)o(en)o(t)f(lo)q(op.)22 b(There)16 b(are)f(functions)h(a)o(v)m -(ailable)i(to)c(mak)o(e)75 853 y(this)i(easy)l(.)1762 -973 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 973 -V 21 w(callbac)n(k)p 458 973 V 23 w(handler)p 670 973 -V 21 w(install)25 b Fg(\()p Ft(const)14 b(char)h(*prompt,)283 -1028 y(rl_vcpfunc_t)e(*lhandler)p Fg(\))195 1082 y Fu(Set)f(up)h(the)g +2615 y(in)o(v)o(ok)o(ed)i(as)f(a)g(`callbac)o(k')h(function)h(from)d +(an)i(ev)o(en)o(t)f(lo)q(op.)22 b(There)16 b(are)f(functions)h(a)o(v)m +(ailable)i(to)c(mak)o(e)75 2670 y(this)i(easy)l(.)p eop +%%Page: 38 40 +38 39 bop 75 -58 a Fu(38)1299 b(GNU)15 b(Readline)h(Library)1762 +149 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 149 +18 3 v 21 w(callbac)n(k)p 458 149 V 23 w(handler)p 670 +149 V 21 w(install)25 b Fg(\()p Ft(const)14 b(char)h(*prompt,)283 +204 y(rl_vcpfunc_t)e(*lhandler)p Fg(\))195 259 y Fu(Set)f(up)h(the)g (terminal)g(for)f(readline)i(I/O)f(and)f(displa)o(y)i(the)e(initial)j -(expanded)e(v)m(alue)h(of)e Fk(prompt)p Fu(.)195 1137 +(expanded)e(v)m(alue)h(of)e Fk(prompt)p Fu(.)195 314 y(Sa)o(v)o(e)j(the)h(v)m(alue)h(of)f Fk(lhandler)21 b Fu(to)15 b(use)h(as)f(a)h(function)h(to)e(call)i(when)f(a)g(complete)g -(line)i(of)d(input)195 1192 y(has)g(b)q(een)h(en)o(tered.)21 +(line)i(of)d(input)195 369 y(has)g(b)q(een)h(en)o(tered.)21 b(The)15 b(function)h(tak)o(es)e(the)i(text)e(of)h(the)g(line)i(as)e -(an)g(argumen)o(t.)1762 1312 y(F)l(unction)-1861 b Fi(void)20 -b Fh(rl)p 241 1312 V 21 w(callbac)n(k)p 458 1312 V 23 -w(read)p 591 1312 V 20 w(c)n(har)j Fg(\()p Ft(void)p -Fg(\))195 1366 y Fu(Whenev)o(er)17 b(an)g(application)h(determines)g -(that)e(k)o(eyb)q(oard)h(input)h(is)f(a)o(v)m(ailable,)i(it)e(should)h -(call)195 1421 y Ft(rl_callback_read_char\(\))p Fu(,)8 -b(whic)o(h)k(will)g(read)f(the)g(next)g(c)o(haracter)f(from)g(the)h -(curren)o(t)g(input)195 1476 y(source.)20 b(If)14 b(that)f(c)o -(haracter)g(completes)i(the)f(line,)h Ft(rl_callback_read_char)c -Fu(will)16 b(in)o(v)o(ok)o(e)e(the)195 1531 y Fk(lhandler)21 -b Fu(function)c(sa)o(v)o(ed)e(b)o(y)h Ft(rl_callback_handler_install)d -Fu(to)i(pro)q(cess)h(the)g(line.)24 b Ft(EOF)195 1585 -y Fu(is)16 b(indicated)h(b)o(y)e(calling)i Fk(lhandler)j -Fu(with)15 b(a)g Ft(NULL)g Fu(line.)1762 1705 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 1705 V 21 w(callbac)n(k)p -458 1705 V 23 w(handler)p 670 1705 V 21 w(remo)n(v)n(e)i -Fg(\()p Ft(void)p Fg(\))195 1760 y Fu(Restore)c(the)g(terminal)i(to)d -(its)i(initial)i(state)d(and)g(remo)o(v)o(e)g(the)h(line)h(handler.)31 -b(This)19 b(ma)o(y)f(b)q(e)195 1815 y(called)f(from)d(within)j(a)e -(callbac)o(k)h(as)f(w)o(ell)h(as)f(indep)q(enden)o(tly)l(.)75 -1928 y Fj(2.4.13)29 b(A)21 b(Readline)g(Example)137 2025 -y Fu(Here)f(is)g(a)f(function)i(whic)o(h)f(c)o(hanges)f(lo)o(w)o +(an)g(argumen)o(t.)1762 480 y(F)l(unction)-1861 b Fi(void)20 +b Fh(rl)p 241 480 V 21 w(callbac)n(k)p 458 480 V 23 w(read)p +591 480 V 20 w(c)n(har)j Fg(\()p Ft(void)p Fg(\))195 +535 y Fu(Whenev)o(er)17 b(an)g(application)h(determines)g(that)e(k)o +(eyb)q(oard)h(input)h(is)f(a)o(v)m(ailable,)i(it)e(should)h(call)195 +590 y Ft(rl_callback_read_char\(\))p Fu(,)8 b(whic)o(h)k(will)g(read)f +(the)g(next)g(c)o(haracter)f(from)g(the)h(curren)o(t)g(input)195 +645 y(source.)38 b(If)21 b(that)g(c)o(haracter)f(completes)i(the)f +(line,)j Ft(rl_callback_read_char)18 b Fu(will)23 b(in)o(v)o(ok)o(e)195 +699 y(the)18 b Fk(lhandler)k Fu(function)d(sa)o(v)o(ed)e(b)o(y)h +Ft(rl_callback_handler_insta)o(ll)d Fu(to)i(pro)q(cess)h(the)g(line.) +195 754 y(Before)13 b(calling)i(the)f Fk(lhandler)k Fu(function,)c(the) +g(terminal)g(settings)f(are)g(reset)g(to)g(the)g(v)m(alues)i(they)195 +809 y(had)g(b)q(efore)g(calling)i Ft(rl_callback_handler_insta)o(ll)p +Fu(.)g(If)e(the)g Fk(lhandler)20 b Fu(function)15 b(returns,)195 +864 y(the)d(terminal)i(settings)e(are)g(mo)q(di\014ed)i(for)d +(Readline's)i(use)g(again.)19 b Ft(EOF)12 b Fu(is)h(indicated)h(b)o(y)e +(calling)195 919 y Fk(lhandler)20 b Fu(with)c(a)f Ft(NULL)f +Fu(line.)1762 1030 y(F)l(unction)-1861 b Fi(void)20 b +Fh(rl)p 241 1030 V 21 w(callbac)n(k)p 458 1030 V 23 w(handler)p +670 1030 V 21 w(remo)n(v)n(e)i Fg(\()p Ft(void)p Fg(\))195 +1085 y Fu(Restore)c(the)g(terminal)i(to)d(its)i(initial)i(state)d(and)g +(remo)o(v)o(e)g(the)h(line)h(handler.)31 b(This)19 b(ma)o(y)f(b)q(e)195 +1140 y(called)i(from)d(within)j(a)d(callbac)o(k)j(as)d(w)o(ell)i(as)f +(indep)q(enden)o(tly)m(.)31 b(If)19 b(the)f Fk(lhandler)23 +b Fu(installed)d(b)o(y)195 1195 y Ft(rl_callback_handler_instal)o(l)d +Fu(do)q(es)i(not)g(exit)h(the)g(program,)e(either)i(this)g(function)g +(or)195 1249 y(the)c(function)g(referred)g(to)f(b)o(y)h(the)g(v)m(alue) +h(of)e Ft(rl_deprep_term_function)d Fu(should)17 b(b)q(e)f(called)195 +1304 y(b)q(efore)f(the)h(program)e(exits)h(to)g(reset)g(the)g(terminal) +h(settings.)75 1413 y Fj(2.4.13)29 b(A)21 b(Readline)g(Example)137 +1508 y Fu(Here)f(is)g(a)f(function)i(whic)o(h)f(c)o(hanges)f(lo)o(w)o (ercase)h(c)o(haracters)e(to)h(their)h(upp)q(ercase)h(equiv)m(alen)o -(ts,)75 2080 y(and)e(upp)q(ercase)i(c)o(haracters)d(to)h(lo)o(w)o +(ts,)75 1563 y(and)e(upp)q(ercase)i(c)o(haracters)d(to)h(lo)o(w)o (ercase.)31 b(If)20 b(this)f(function)h(w)o(as)f(b)q(ound)h(to)f(`)p -Ft(M-c)p Fu(',)f(then)i(t)o(yping)75 2135 y(`)p Ft(M-c)p +Ft(M-c)p Fu(',)f(then)i(t)o(yping)75 1618 y(`)p Ft(M-c)p Fu(')12 b(w)o(ould)h(c)o(hange)h(the)f(case)g(of)g(the)g(c)o(haracter)g (under)g(p)q(oin)o(t.)20 b(T)o(yping)14 b(`)p Ft(M-1)g(0)h(M-c)p -Fu(')d(w)o(ould)i(c)o(hange)75 2190 y(the)h(case)g(of)g(the)h(follo)o +Fu(')d(w)o(ould)i(c)o(hange)75 1673 y(the)h(case)g(of)g(the)h(follo)o (wing)f(10)g(c)o(haracters,)f(lea)o(ving)i(the)f(cursor)g(on)g(the)h -(last)f(c)o(haracter)f(c)o(hanged.)195 2255 y Ft(/*)24 +(last)f(c)o(haracter)f(c)o(hanged.)195 1736 y Ft(/*)24 b(Invert)f(the)g(case)g(of)h(the)f(COUNT)h(following)e(characters.)h -(*/)195 2307 y(int)195 2359 y(invert_case_line)f(\(count,)h(key\))314 -2411 y(int)h(count,)f(key;)195 2462 y({)243 2514 y(register)f(int)i -(start,)f(end,)g(i;)243 2618 y(start)g(=)h(rl_point;)p -eop -%%Page: 36 38 -36 37 bop 75 -58 a Fu(36)1299 b(GNU)15 b(Readline)h(Library)243 -149 y Ft(if)23 b(\(rl_point)g(>=)h(rl_end\))290 201 y(return)f(\(0\);) -243 305 y(if)g(\(count)g(<)h(0\))290 357 y({)338 409 -y(direction)f(=)h(-1;)338 461 y(count)f(=)h(-count;)290 -513 y(})243 565 y(else)290 616 y(direction)f(=)h(1;)243 -720 y(/*)f(Find)h(the)f(end)h(of)f(the)h(range)f(to)g(modify.)g(*/)243 -772 y(end)g(=)h(start)f(+)h(\(count)f(*)h(direction\);)243 -876 y(/*)f(Force)g(it)h(to)g(be)f(within)g(range.)g(*/)243 -928 y(if)g(\(end)h(>)f(rl_end\))290 980 y(end)h(=)g(rl_end;)243 -1032 y(else)f(if)h(\(end)f(<)h(0\))290 1083 y(end)g(=)g(0;)243 -1187 y(if)f(\(start)g(==)h(end\))290 1239 y(return)f(\(0\);)243 -1343 y(if)g(\(start)g(>)h(end\))290 1395 y({)338 1447 -y(int)g(temp)f(=)h(start;)338 1499 y(start)f(=)h(end;)338 -1550 y(end)g(=)f(temp;)290 1602 y(})243 1706 y(/*)g(Tell)h(readline)e -(that)i(we)f(are)h(modifying)e(the)i(line,)f(so)h(it)f(will)h(save)314 -1758 y(the)g(undo)f(information.)f(*/)243 1810 y(rl_modifying)g -(\(start,)h(end\);)243 1914 y(for)g(\(i)h(=)f(start;)h(i)f(!=)h(end;)f -(i++\))290 1966 y({)338 2017 y(if)h(\(_rl_uppercase_p)d -(\(rl_line_buffer[i]\)\))386 2069 y(rl_line_buffer[i])g(=)j -(_rl_to_lower)e(\(rl_line_buffer[i]\);)338 2121 y(else)h(if)h -(\(_rl_lowercase_p)e(\(rl_line_buffer[i]\)\))386 2173 -y(rl_line_buffer[i])f(=)j(_rl_to_upper)e(\(rl_line_buffer[i]\);)290 -2225 y(})243 2277 y(/*)h(Move)h(point)f(to)g(on)h(top)f(of)h(the)f -(last)h(character)e(changed.)h(*/)243 2329 y(rl_point)f(=)i -(\(direction)f(==)g(1\))h(?)g(end)f(-)h(1)g(:)f(start;)243 -2381 y(return)g(\(0\);)195 2433 y(})p eop -%%Page: 37 39 -37 38 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(37)75 149 y Fs(2.5)33 b(Readline)23 b(Signal)h -(Handling)137 253 y Fu(Signals)e(are)f(async)o(hronous)f(ev)o(en)o(ts)h -(sen)o(t)f(to)h(a)f(pro)q(cess)h(b)o(y)g(the)g(Unix)h(k)o(ernel,)g -(sometimes)f(on)75 308 y(b)q(ehalf)g(of)e(another)h(pro)q(cess.)34 +(*/)195 1788 y(int)195 1840 y(invert_case_line)f(\(count,)h(key\))314 +1892 y(int)h(count,)f(key;)195 1944 y({)243 1995 y(register)f(int)i +(start,)f(end,)g(i;)243 2099 y(start)g(=)h(rl_point;)243 +2203 y(if)f(\(rl_point)g(>=)h(rl_end\))290 2255 y(return)f(\(0\);)243 +2359 y(if)g(\(count)g(<)h(0\))290 2411 y({)338 2462 y(direction)f(=)h +(-1;)338 2514 y(count)f(=)h(-count;)290 2566 y(})243 +2618 y(else)290 2670 y(direction)f(=)h(1;)p eop +%%Page: 39 41 +39 40 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(39)243 201 y Ft(/*)23 b(Find)h(the)f(end)h(of)f(the)h +(range)f(to)g(modify.)g(*/)243 253 y(end)g(=)h(start)f(+)h(\(count)f(*) +h(direction\);)243 357 y(/*)f(Force)g(it)h(to)g(be)f(within)g(range.)g +(*/)243 409 y(if)g(\(end)h(>)f(rl_end\))290 461 y(end)h(=)g(rl_end;)243 +513 y(else)f(if)h(\(end)f(<)h(0\))290 565 y(end)g(=)g(0;)243 +668 y(if)f(\(start)g(==)h(end\))290 720 y(return)f(\(0\);)243 +824 y(if)g(\(start)g(>)h(end\))290 876 y({)338 928 y(int)g(temp)f(=)h +(start;)338 980 y(start)f(=)h(end;)338 1032 y(end)g(=)f(temp;)290 +1083 y(})243 1187 y(/*)g(Tell)h(readline)e(that)i(we)f(are)h(modifying) +e(the)i(line,)314 1239 y(so)g(it)f(will)h(save)f(the)h(undo)f +(information.)f(*/)243 1291 y(rl_modifying)g(\(start,)h(end\);)243 +1395 y(for)g(\(i)h(=)f(start;)h(i)f(!=)h(end;)f(i++\))290 +1447 y({)338 1499 y(if)h(\(_rl_uppercase_p)d(\(rl_line_buffer[i]\)\)) +386 1550 y(rl_line_buffer[i])g(=)j(_rl_to_lower)e +(\(rl_line_buffer[i]\);)338 1602 y(else)h(if)h(\(_rl_lowercase_p)e +(\(rl_line_buffer[i]\)\))386 1654 y(rl_line_buffer[i])f(=)j +(_rl_to_upper)e(\(rl_line_buffer[i]\);)290 1706 y(})243 +1758 y(/*)h(Move)h(point)f(to)g(on)h(top)f(of)h(the)f(last)h(character) +e(changed.)h(*/)243 1810 y(rl_point)f(=)i(\(direction)f(==)g(1\))h(?)g +(end)f(-)h(1)g(:)f(start;)243 1862 y(return)g(\(0\);)195 +1914 y(})75 2057 y Fs(2.5)33 b(Readline)23 b(Signal)h(Handling)137 +2159 y Fu(Signals)e(are)f(async)o(hronous)f(ev)o(en)o(ts)h(sen)o(t)f +(to)h(a)f(pro)q(cess)h(b)o(y)g(the)g(Unix)h(k)o(ernel,)g(sometimes)f +(on)75 2213 y(b)q(ehalf)g(of)e(another)h(pro)q(cess.)34 b(They)20 b(are)g(in)o(tended)h(to)e(indicate)j(exceptional)f(ev)o(en)o -(ts,)f(lik)o(e)h(a)f(user)75 362 y(pressing)c(the)f(in)o(terrupt)g(k)o +(ts,)f(lik)o(e)h(a)f(user)75 2268 y(pressing)c(the)f(in)o(terrupt)g(k)o (ey)g(on)g(his)h(terminal,)f(or)g(a)f(net)o(w)o(ork)g(connection)i(b)q -(eing)g(brok)o(en.)k(There)15 b(is)75 417 y(a)e(class)g(of)g(signals)h +(eing)g(brok)o(en.)k(There)15 b(is)75 2323 y(a)e(class)g(of)g(signals)h (that)f(can)g(b)q(e)h(sen)o(t)f(to)f(the)i(pro)q(cess)f(curren)o(tly)h -(reading)f(input)i(from)d(the)h(k)o(eyb)q(oard.)75 472 +(reading)f(input)i(from)d(the)h(k)o(eyb)q(oard.)75 2378 y(Since)i(Readline)f(c)o(hanges)g(the)f(terminal)h(attributes)f(when)h (it)g(is)g(called,)h(it)e(needs)h(to)f(p)q(erform)g(sp)q(ecial)75 -527 y(pro)q(cessing)i(when)f(suc)o(h)g(a)g(signal)g(is)g(receiv)o(ed)h +2433 y(pro)q(cessing)i(when)f(suc)o(h)g(a)g(signal)g(is)g(receiv)o(ed)h (in)g(order)f(to)f(restore)g(the)h(terminal)g(to)f(a)h(sane)g(state,)e -(or)75 582 y(pro)o(vide)k(application)h(writers)e(with)g(functions)h -(to)f(do)g(so)g(man)o(ually)l(.)137 656 y(Readline)22 +(or)75 2487 y(pro)o(vide)k(application)h(writers)e(with)g(functions)h +(to)f(do)g(so)g(man)o(ually)l(.)137 2560 y(Readline)22 b(con)o(tains)e(an)g(in)o(ternal)h(signal)g(handler)g(that)f(is)h (installed)h(for)d(a)h(n)o(um)o(b)q(er)g(of)g(signals)75 -711 y(\()p Ft(SIGINT)p Fu(,)h Ft(SIGQUIT)p Fu(,)g Ft(SIGTERM)p +2615 y(\()p Ft(SIGINT)p Fu(,)h Ft(SIGQUIT)p Fu(,)g Ft(SIGTERM)p Fu(,)g Ft(SIGALRM)p Fu(,)g Ft(SIGTSTP)p Fu(,)g Ft(SIGTTIN)p Fu(,)h(and)f Ft(SIGTTOU)p Fu(\).)36 b(When)21 b(one)g(of)75 -766 y(these)16 b(signals)h(is)f(receiv)o(ed,)h(the)f(signal)h(handler)f -(will)i(reset)e(the)g(terminal)g(attributes)g(to)f(those)h(that)75 -820 y(w)o(ere)d(in)i(e\013ect)e(b)q(efore)h Ft(readline\(\))e +2670 y(these)16 b(signals)h(is)f(receiv)o(ed,)h(the)f(signal)h(handler) +f(will)i(reset)e(the)g(terminal)g(attributes)g(to)f(those)h(that)p +eop +%%Page: 40 42 +40 41 bop 75 -58 a Fu(40)1299 b(GNU)15 b(Readline)h(Library)75 +149 y(w)o(ere)d(in)i(e\013ect)e(b)q(efore)h Ft(readline\(\))e Fu(w)o(as)h(called,)i(reset)f(the)f(signal)i(handling)g(to)e(what)g(it) -h(w)o(as)f(b)q(efore)75 875 y Ft(readline\(\))21 b Fu(w)o(as)h(called,) +h(w)o(as)f(b)q(efore)75 204 y Ft(readline\(\))21 b Fu(w)o(as)h(called,) j(and)e(resend)g(the)g(signal)g(to)f(the)h(calling)h(application.)44 -b(If)23 b(and)f(when)75 930 y(the)17 b(calling)i(application's)f +b(If)23 b(and)f(when)75 259 y(the)17 b(calling)i(application's)f (signal)g(handler)g(returns,)f(Readline)h(will)h(reinitialize)h(the)d -(terminal)h(and)75 985 y(con)o(tin)o(ue)d(to)e(accept)i(input.)20 +(terminal)h(and)75 314 y(con)o(tin)o(ue)d(to)e(accept)i(input.)20 b(When)15 b(a)e Ft(SIGINT)h Fu(is)g(receiv)o(ed,)h(the)g(Readline)g -(signal)g(handler)g(p)q(erforms)75 1040 y(some)k(additional)i(w)o(ork,) -e(whic)o(h)h(will)h(cause)f(an)o(y)f(partially-en)o(tered)i(line)g(to)d -(b)q(e)i(ab)q(orted)g(\(see)f(the)75 1094 y(description)e(of)d -Ft(rl_free_line_state\(\))f Fu(b)q(elo)o(w\).)137 1169 +(signal)g(handler)g(p)q(erforms)75 369 y(some)k(additional)i(w)o(ork,)e +(whic)o(h)h(will)h(cause)f(an)o(y)f(partially-en)o(tered)i(line)g(to)d +(b)q(e)i(ab)q(orted)g(\(see)f(the)75 423 y(description)e(of)d +Ft(rl_free_line_state\(\))f Fu(b)q(elo)o(w\).)137 488 y(There)g(is)f(an)g(additional)i(Readline)g(signal)f(handler,)g(for)f Ft(SIGWINCH)p Fu(,)f(whic)o(h)i(the)f(k)o(ernel)h(sends)g(to)e(a)75 -1224 y(pro)q(cess)k(whenev)o(er)g(the)f(terminal's)h(size)g(c)o(hanges) -f(\(for)g(example,)h(if)g(a)f(user)h(resizes)g(an)f Ft(xterm)p -Fu(\).)19 b(The)75 1278 y(Readline)g Ft(SIGWINCH)e Fu(handler)i(up)q +543 y(pro)q(cess)k(whenev)o(er)g(the)f(terminal's)h(size)g(c)o(hanges)f +(\(for)g(example,)h(if)g(a)f(user)h(resizes)g(an)f Ft(xterm)p +Fu(\).)19 b(The)75 598 y(Readline)g Ft(SIGWINCH)e Fu(handler)i(up)q (dates)f(Readline's)h(in)o(ternal)f(screen)h(size)f(information,)h(and) -f(then)75 1333 y(calls)g(an)o(y)f Ft(SIGWINCH)e Fu(signal)j(handler)g +f(then)75 653 y(calls)g(an)o(y)f Ft(SIGWINCH)e Fu(signal)j(handler)g (the)f(calling)i(application)f(has)f(installed.)27 b(Readline)18 -b(calls)g(the)75 1388 y(application's)h Ft(SIGWINCH)d +b(calls)g(the)75 708 y(application's)h Ft(SIGWINCH)d Fu(signal)j(handler)f(without)g(resetting)g(the)f(terminal)i(to)e(its)g -(original)i(state.)75 1443 y(If)d(the)g(application's)h(signal)g +(original)i(state.)75 762 y(If)d(the)g(application's)h(signal)g (handler)g(do)q(es)g(more)e(than)h(up)q(date)h(its)f(idea)h(of)e(the)h -(terminal)h(size)g(and)75 1498 y(return)e(\(for)f(example,)h(a)f +(terminal)h(size)g(and)75 817 y(return)e(\(for)f(example,)h(a)f Ft(longjmp)g Fu(bac)o(k)h(to)f(a)h(main)g(pro)q(cessing)g(lo)q(op\),)g -(it)g Fl(must)20 b Fu(call)c Ft(rl_cleanup_)75 1552 y(after_signal\(\)) -d Fu(\(describ)q(ed)k(b)q(elo)o(w\),)e(to)g(restore)f(the)h(terminal)h -(state.)137 1627 y(Readline)g(pro)o(vides)f(t)o(w)o(o)e(v)m(ariables)i +(it)g Fl(must)20 b Fu(call)c Ft(rl_cleanup_)75 872 y(after_signal\(\))d +Fu(\(describ)q(ed)k(b)q(elo)o(w\),)e(to)g(restore)f(the)h(terminal)h +(state.)137 937 y(Readline)g(pro)o(vides)f(t)o(w)o(o)e(v)m(ariables)i (that)f(allo)o(w)g(application)i(writers)e(to)g(con)o(trol)g(whether)h -(or)e(not)75 1681 y(it)k(will)h(catc)o(h)e(certain)h(signals)h(and)f +(or)e(not)75 992 y(it)k(will)h(catc)o(h)e(certain)h(signals)h(and)f (act)f(on)g(them)h(when)g(they)f(are)h(receiv)o(ed.)25 -b(It)16 b(is)i(imp)q(ortan)o(t)e(that)75 1736 y(applications)k(c)o +b(It)16 b(is)i(imp)q(ortan)o(t)e(that)75 1047 y(applications)k(c)o (hange)e(the)h(v)m(alues)g(of)f(these)h(v)m(ariables)g(only)g(when)g -(calling)h Ft(readline\(\))p Fu(,)d(not)h(in)h(a)75 1791 +(calling)h Ft(readline\(\))p Fu(,)d(not)h(in)h(a)75 1101 y(signal)d(handler,)g(so)f(Readline's)h(in)o(ternal)g(signal)g(state)e -(is)i(not)f(corrupted.)1773 1930 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 1930 18 3 v 21 w(catc)n(h)p -366 1930 V 22 w(signals)195 1984 y Fu(If)15 b(this)g(v)m(ariable)g(is)g +(is)i(not)f(corrupted.)1773 1208 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1208 18 3 v 21 w(catc)n(h)p +366 1208 V 22 w(signals)195 1262 y Fu(If)15 b(this)g(v)m(ariable)g(is)g (non-zero,)g(Readline)h(will)g(install)f(signal)h(handlers)f(for)f -Ft(SIGINT)p Fu(,)f Ft(SIGQUIT)p Fu(,)195 2039 y Ft(SIGTERM)p +Ft(SIGINT)p Fu(,)f Ft(SIGQUIT)p Fu(,)195 1317 y Ft(SIGTERM)p Fu(,)h Ft(SIGALRM)p Fu(,)g Ft(SIGTSTP)p Fu(,)f Ft(SIGTTIN)p -Fu(,)h(and)i Ft(SIGTTOU)p Fu(.)195 2113 y(The)f(default)h(v)m(alue)h -(of)d Ft(rl_catch_signals)f Fu(is)j(1.)1773 2252 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 2252 V 21 w(catc)n(h)p 366 -2252 V 22 w(sigwinc)n(h)195 2307 y Fu(If)15 b(this)h(v)m(ariable)h(is)e +Fu(,)h(and)i Ft(SIGTTOU)p Fu(.)195 1382 y(The)f(default)h(v)m(alue)h +(of)d Ft(rl_catch_signals)f Fu(is)j(1.)1773 1488 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1488 V 21 w(catc)n(h)p 366 +1488 V 22 w(sigwinc)n(h)195 1543 y Fu(If)15 b(this)h(v)m(ariable)h(is)e (non-zero,)g(Readline)i(will)g(install)f(a)f(signal)h(handler)h(for)d -Ft(SIGWINCH)p Fu(.)195 2381 y(The)h(default)h(v)m(alue)h(of)d -Ft(rl_catch_sigwinch)f Fu(is)j(1.)137 2487 y(If)g(an)f(application)j +Ft(SIGWINCH)p Fu(.)195 1608 y(The)h(default)h(v)m(alue)h(of)d +Ft(rl_catch_sigwinch)f Fu(is)j(1.)137 1694 y(If)g(an)f(application)j (do)q(es)d(not)g(wish)i(to)d(ha)o(v)o(e)h(Readline)i(catc)o(h)f(an)o(y) -f(signals,)h(or)f(to)f(handle)j(signals)75 2542 y(other)i(than)g(those) +f(signals,)h(or)f(to)f(handle)j(signals)75 1749 y(other)i(than)g(those) g(Readline)i(catc)o(hes)e(\()p Ft(SIGHUP)p Fu(,)g(for)g(example\),)h -(Readline)h(pro)o(vides)e(con)o(v)o(enience)75 2597 y(functions)d(to)f +(Readline)h(pro)o(vides)e(con)o(v)o(enience)75 1804 y(functions)d(to)f (do)g(the)g(necessary)g(terminal)h(and)g(in)o(ternal)g(state)e(clean)o -(up)i(up)q(on)g(receipt)g(of)f(a)g(signal.)p eop -%%Page: 38 40 -38 39 bop 75 -58 a Fu(38)1299 b(GNU)15 b(Readline)h(Library)1762 -149 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 149 -18 3 v 21 w(clean)n(up)p 450 149 V 22 w(after)p 590 149 -V 20 w(signal)j Fg(\()p Ft(void)p Fg(\))195 204 y Fu(This)18 +(up)i(up)q(on)g(receipt)g(of)f(a)g(signal.)1762 1910 +y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1910 V +21 w(clean)n(up)p 450 1910 V 22 w(after)p 590 1910 V +20 w(signal)j Fg(\()p Ft(void)p Fg(\))195 1965 y Fu(This)18 b(function)f(will)i(reset)e(the)g(state)f(of)g(the)h(terminal)h(to)e (what)h(it)g(w)o(as)f(b)q(efore)h Ft(readline\(\))195 -259 y Fu(w)o(as)d(called,)i(and)f(remo)o(v)o(e)f(the)g(Readline)i +2019 y Fu(w)o(as)d(called,)i(and)f(remo)o(v)o(e)f(the)g(Readline)i (signal)g(handlers)g(for)e(all)h(signals,)g(dep)q(ending)i(on)e(the)195 -314 y(v)m(alues)h(of)f Ft(rl_catch_signals)e Fu(and)i -Ft(rl_catch_sigwinch)p Fu(.)1762 460 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 460 V 21 w(free)p 356 460 -V 20 w(line)p 464 460 V 23 w(state)j Fg(\()p Ft(void)p -Fg(\))195 515 y Fu(This)d(will)h(free)f(an)o(y)f(partial)h(state)f +2074 y(v)m(alues)h(of)f Ft(rl_catch_signals)e Fu(and)i +Ft(rl_catch_sigwinch)p Fu(.)1762 2180 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 2180 V 21 w(free)p 356 2180 +V 20 w(line)p 464 2180 V 23 w(state)j Fg(\()p Ft(void)p +Fg(\))195 2235 y Fu(This)d(will)h(free)f(an)o(y)f(partial)h(state)f (asso)q(ciated)h(with)g(the)g(curren)o(t)f(input)i(line)g(\(undo)f -(infor-)195 570 y(mation,)i(an)o(y)f(partial)h(history)f(en)o(try)l(,)h -(an)o(y)f(partially-en)o(tered)i(k)o(eyb)q(oard)e(macro,)h(and)f(an)o -(y)195 625 y(partially-en)o(tered)k(n)o(umeric)g(argumen)o(t\).)45 +(infor-)195 2290 y(mation,)i(an)o(y)f(partial)h(history)f(en)o(try)l(,) +h(an)o(y)f(partially-en)o(tered)i(k)o(eyb)q(oard)e(macro,)h(and)f(an)o +(y)195 2345 y(partially-en)o(tered)k(n)o(umeric)g(argumen)o(t\).)45 b(This)24 b(should)h(b)q(e)g(called)g(b)q(efore)g Ft(rl_cleanup_)195 -679 y(after_signal\(\))p Fu(.)36 b(The)22 b(Readline)h(signal)f +2399 y(after_signal\(\))p Fu(.)36 b(The)22 b(Readline)h(signal)f (handler)g(for)f Ft(SIGINT)f Fu(calls)j(this)e(to)g(ab)q(ort)g(the)195 -734 y(curren)o(t)15 b(input)h(line.)1762 881 y(F)l(unction)-1861 -b Fi(void)20 b Fh(rl)p 241 881 V 21 w(reset)p 383 881 -V 20 w(after)p 521 881 V 21 w(signal)j Fg(\()p Ft(void)p -Fg(\))195 935 y Fu(This)15 b(will)h(reinitialize)h(the)d(terminal)h +2454 y(curren)o(t)15 b(input)h(line.)1762 2560 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 2560 V 21 w(reset)p 383 2560 +V 20 w(after)p 521 2560 V 21 w(signal)j Fg(\()p Ft(void)p +Fg(\))195 2615 y Fu(This)15 b(will)h(reinitialize)h(the)d(terminal)h (and)g(reinstall)h(an)o(y)d(Readline)j(signal)f(handlers,)g(dep)q(end-) -195 990 y(ing)h(on)f(the)g(v)m(alues)i(of)d Ft(rl_catch_signals)f -Fu(and)j Ft(rl_catch_sigwinch)p Fu(.)137 1102 y(If)k(an)g(application)h -(do)q(es)f(not)g(wish)g(Readline)h(to)e(catc)o(h)g Ft(SIGWINCH)p -Fu(,)h(it)g(ma)o(y)f(call)h Ft(rl_resize_)75 1157 y(terminal\(\))12 -b Fu(or)h Ft(rl_set_screen_size\(\))e Fu(to)i(force)g(Readline)i(to)e -(up)q(date)h(its)g(idea)g(of)g(the)f(terminal)75 1211 -y(size)j(when)g(a)f Ft(SIGWINCH)f Fu(is)h(receiv)o(ed.)1762 -1358 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1358 -V 21 w(resize)p 401 1358 V 22 w(terminal)j Fg(\()p Ft(void)p -Fg(\))195 1413 y Fu(Up)q(date)16 b(Readline's)g(in)o(ternal)g(screen)f -(size)i(b)o(y)e(reading)g(v)m(alues)i(from)d(the)i(k)o(ernel.)1762 -1559 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1559 -V 21 w(set)p 333 1559 V 21 w(screen)p 510 1559 V 20 w(size)k -Fg(\()p Ft(int)15 b(rows,)f(int)h(cols)p Fg(\))195 1614 +195 2670 y(ing)h(on)f(the)g(v)m(alues)i(of)d Ft(rl_catch_signals)f +Fu(and)j Ft(rl_catch_sigwinch)p Fu(.)p eop +%%Page: 41 43 +41 42 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(41)137 149 y(If)20 b(an)g(application)h(do)q(es)f(not)g +(wish)g(Readline)h(to)e(catc)o(h)g Ft(SIGWINCH)p Fu(,)h(it)g(ma)o(y)f +(call)h Ft(rl_resize_)75 204 y(terminal\(\))12 b Fu(or)h +Ft(rl_set_screen_size\(\))e Fu(to)i(force)g(Readline)i(to)e(up)q(date)h +(its)g(idea)g(of)g(the)f(terminal)75 259 y(size)j(when)g(a)f +Ft(SIGWINCH)f Fu(is)h(receiv)o(ed.)1762 360 y(F)l(unction)-1861 +b Fi(void)20 b Fh(rl)p 241 360 18 3 v 21 w(resize)p 401 +360 V 22 w(terminal)j Fg(\()p Ft(void)p Fg(\))195 415 +y Fu(Up)q(date)16 b(Readline's)g(in)o(ternal)g(screen)f(size)i(b)o(y)e +(reading)g(v)m(alues)i(from)d(the)i(k)o(ernel.)1762 516 +y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 516 V +21 w(set)p 333 516 V 21 w(screen)p 510 516 V 20 w(size)k +Fg(\()p Ft(int)15 b(rows,)f(int)h(cols)p Fg(\))195 571 y Fu(Set)g(Readline's)h(idea)g(of)f(the)g(terminal)h(size)g(to)f Fk(ro)o(ws)h Fu(ro)o(ws)e(and)i Fk(cols)h Fu(columns.)137 -1725 y(If)g(an)g(application)h(do)q(es)f(not)f(w)o(an)o(t)g(to)g +653 y(If)g(an)g(application)h(do)q(es)f(not)f(w)o(an)o(t)g(to)g (install)i(a)f Ft(SIGWINCH)e Fu(handler,)j(but)f(is)g(still)h(in)o -(terested)f(in)75 1780 y(the)e(screen)h(dimensions,)g(Readline's)h -(idea)e(of)g(the)h(screen)f(size)h(ma)o(y)f(b)q(e)h(queried.)1762 -1927 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 1927 -V 21 w(get)p 339 1927 V 21 w(screen)p 516 1927 V 20 w(size)k +(terested)f(in)75 708 y(the)e(screen)h(dimensions,)g(Readline's)h(idea) +e(of)g(the)h(screen)f(size)h(ma)o(y)f(b)q(e)h(queried.)1762 +809 y(F)l(unction)-1861 b Fi(void)20 b Fh(rl)p 241 809 +V 21 w(get)p 339 809 V 21 w(screen)p 516 809 V 20 w(size)k Fg(\()p Ft(int)15 b(*rows,)f(int)h(*cols)p Fg(\))195 -1981 y Fu(Return)g(Readline's)h(idea)f(of)g(the)g(terminal's)g(size)h +864 y Fu(Return)g(Readline's)h(idea)f(of)g(the)g(terminal's)g(size)h (in)g(the)f(v)m(ariables)i(p)q(oin)o(ted)f(to)e(b)o(y)h(the)g(argu-)195 -2036 y(men)o(ts.)137 2148 y(The)h(follo)o(wing)g(functions)g(install)g +918 y(men)o(ts.)137 1001 y(The)h(follo)o(wing)g(functions)g(install)g (and)g(remo)o(v)o(e)e(Readline's)i(signal)g(handlers.)1762 -2294 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2294 -V 21 w(set)p 307 2294 V 20 w(signals)j Fg(\()p Ft(void)p -Fg(\))195 2349 y Fu(Install)c(Readline's)f(signal)h(handler)f(for)f +1102 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 1102 +V 21 w(set)p 307 1102 V 20 w(signals)j Fg(\()p Ft(void)p +Fg(\))195 1157 y Fu(Install)c(Readline's)f(signal)h(handler)f(for)f Ft(SIGINT)p Fu(,)g Ft(SIGQUIT)p Fu(,)g Ft(SIGTERM)p Fu(,)g -Ft(SIGALRM)p Fu(,)f Ft(SIGTSTP)p Fu(,)195 2404 y Ft(SIGTTIN)p +Ft(SIGALRM)p Fu(,)f Ft(SIGTSTP)p Fu(,)195 1211 y Ft(SIGTTIN)p Fu(,)11 b Ft(SIGTTOU)p Fu(,)g(and)h Ft(SIGWINCH)p Fu(,)e(dep)q(ending)k (on)e(the)f(v)m(alues)i(of)e Ft(rl_catch_signals)f Fu(and)195 -2459 y Ft(rl_catch_sigwinch)p Fu(.)1762 2605 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 2605 V 21 w(clear)p 354 2605 -V 21 w(signals)j Fg(\()p Ft(void)p Fg(\))195 2660 y Fu(Remo)o(v)o(e)14 +1266 y Ft(rl_catch_sigwinch)p Fu(.)1762 1367 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 1367 V 21 w(clear)p 354 1367 +V 21 w(signals)j Fg(\()p Ft(void)p Fg(\))195 1422 y Fu(Remo)o(v)o(e)14 b(all)i(of)f(the)g(Readline)i(signal)f(handlers)g(installed)h(b)o(y)e -Ft(rl_set_signals\(\))p Fu(.)p eop -%%Page: 39 41 -39 40 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(39)75 149 y Fs(2.6)33 b(Custom)21 b(Completers)137 -246 y Fu(T)o(ypically)l(,)e(a)d(program)f(that)h(reads)h(commands)f -(from)g(the)h(user)f(has)h(a)f(w)o(a)o(y)g(of)g(disam)o(biguating)75 -301 y(commands)i(and)f(data.)27 b(If)18 b(y)o(our)f(program)g(is)h(one) -g(of)f(these,)i(then)f(it)g(can)f(pro)o(vide)i(completion)g(for)75 -356 y(commands,)14 b(data,)g(or)g(b)q(oth.)20 b(The)15 -b(follo)o(wing)g(sections)g(describ)q(e)h(ho)o(w)e(y)o(our)g(program)g -(and)h(Readline)75 410 y(co)q(op)q(erate)g(to)g(pro)o(vide)g(this)h -(service.)75 523 y Fj(2.6.1)30 b(Ho)n(w)21 b(Completing)f(W)-5 -b(orks)137 620 y Fu(In)18 b(order)f(to)f(complete)i(some)f(text,)g(the) -g(full)i(list)e(of)g(p)q(ossible)i(completions)f(m)o(ust)f(b)q(e)h(a)o -(v)m(ailable.)75 675 y(That)e(is,)i(it)f(is)h(not)f(p)q(ossible)h(to)f +Ft(rl_set_signals\(\))p Fu(.)75 1541 y Fs(2.6)33 b(Custom)21 +b(Completers)137 1634 y Fu(T)o(ypically)l(,)e(a)d(program)f(that)h +(reads)h(commands)f(from)g(the)h(user)f(has)h(a)f(w)o(a)o(y)g(of)g +(disam)o(biguating)75 1689 y(commands)i(and)f(data.)27 +b(If)18 b(y)o(our)f(program)g(is)h(one)g(of)f(these,)i(then)f(it)g(can) +f(pro)o(vide)i(completion)g(for)75 1744 y(commands,)14 +b(data,)g(or)g(b)q(oth.)20 b(The)15 b(follo)o(wing)g(sections)g +(describ)q(e)h(ho)o(w)e(y)o(our)g(program)g(and)h(Readline)75 +1798 y(co)q(op)q(erate)g(to)g(pro)o(vide)g(this)h(service.)75 +1901 y Fj(2.6.1)30 b(Ho)n(w)21 b(Completing)f(W)-5 b(orks)137 +1994 y Fu(In)18 b(order)f(to)f(complete)i(some)f(text,)g(the)g(full)i +(list)e(of)g(p)q(ossible)i(completions)f(m)o(ust)f(b)q(e)h(a)o(v)m +(ailable.)75 2049 y(That)e(is,)i(it)f(is)h(not)f(p)q(ossible)h(to)f (accurately)g(expand)h(a)e(partial)i(w)o(ord)e(without)h(kno)o(wing)g -(all)h(of)f(the)75 729 y(p)q(ossible)i(w)o(ords)e(whic)o(h)h(mak)o(e)f +(all)h(of)f(the)75 2104 y(p)q(ossible)i(w)o(ords)e(whic)o(h)h(mak)o(e)f (sense)h(in)h(that)d(con)o(text.)26 b(The)18 b(Readline)h(library)f -(pro)o(vides)g(the)g(user)75 784 y(in)o(terface)f(to)f(completion,)i +(pro)o(vides)g(the)g(user)75 2158 y(in)o(terface)f(to)f(completion,)i (and)e(t)o(w)o(o)g(of)g(the)h(most)f(common)g(completion)i(functions:) -23 b(\014lename)18 b(and)75 839 y(username.)h(F)l(or)10 +23 b(\014lename)18 b(and)75 2213 y(username.)h(F)l(or)10 b(completing)i(other)e(t)o(yp)q(es)h(of)f(text,)h(y)o(ou)g(m)o(ust)f (write)h(y)o(our)f(o)o(wn)h(completion)g(function.)75 -894 y(This)16 b(section)g(describ)q(es)g(exactly)g(what)f(suc)o(h)g +2268 y(This)16 b(section)g(describ)q(es)g(exactly)g(what)f(suc)o(h)g (functions)h(m)o(ust)f(do,)f(and)i(pro)o(vides)f(an)h(example.)137 -961 y(There)g(are)f(three)g(ma)s(jor)f(functions)i(used)f(to)g(p)q -(erform)g(completion:)100 1029 y(1.)29 b(The)22 b(user-in)o(terface)g +2332 y(There)g(are)f(three)g(ma)s(jor)f(functions)i(used)f(to)g(p)q +(erform)g(completion:)100 2396 y(1.)29 b(The)22 b(user-in)o(terface)g (function)h Ft(rl_complete\(\))p Fu(.)37 b(This)22 b(function)h(is)f -(called)h(with)f(the)g(same)165 1084 y(argumen)o(ts)17 +(called)h(with)f(the)g(same)165 2451 y(argumen)o(ts)17 b(as)h(other)g(bindable)i(Readline)f(functions:)27 b -Fk(coun)o(t)19 b Fu(and)f Fk(in)o(v)o(oking)p 1556 1084 -14 2 v 17 w(k)o(ey)p Fu(.)28 b(It)19 b(isolates)165 1138 +Fk(coun)o(t)19 b Fu(and)f Fk(in)o(v)o(oking)p 1556 2451 +14 2 v 17 w(k)o(ey)p Fu(.)28 b(It)19 b(isolates)165 2506 y(the)g(w)o(ord)f(to)g(b)q(e)i(completed)f(and)g(calls)h Ft(rl_completion_matches\(\))c Fu(to)i(generate)g(a)h(list)g(of)165 -1193 y(p)q(ossible)e(completions.)22 b(It)16 b(then)g(either)g(lists)g +2560 y(p)q(ossible)e(completions.)22 b(It)16 b(then)g(either)g(lists)g (the)g(p)q(ossible)h(completions,)g(inserts)f(the)f(p)q(ossible)165 -1248 y(completions,)25 b(or)d(actually)i(p)q(erforms)e(the)g +2615 y(completions,)25 b(or)d(actually)i(p)q(erforms)e(the)g (completion,)k(dep)q(ending)e(on)f(whic)o(h)g(b)q(eha)o(vior)g(is)165 -1303 y(desired.)100 1370 y(2.)29 b(The)17 b(in)o(ternal)h(function)f -Ft(rl_completion_matches\(\))d Fu(uses)j(an)g(application-supplie)q(d)j -Fk(gener-)165 1425 y(ator)h Fu(function)e(to)f(generate)g(the)h(list)g +2670 y(desired.)p eop +%%Page: 42 44 +42 43 bop 75 -58 a Fu(42)1299 b(GNU)15 b(Readline)h(Library)100 +149 y(2.)29 b(The)17 b(in)o(ternal)h(function)f Ft +(rl_completion_matches\(\))d Fu(uses)j(an)g(application-supplie)q(d)j +Fk(gener-)165 204 y(ator)h Fu(function)e(to)f(generate)g(the)h(list)g (of)f(p)q(ossible)i(matc)o(hes,)f(and)f(then)h(returns)g(the)f(arra)o -(y)f(of)165 1480 y(these)j(matc)o(hes.)32 b(The)20 b(caller)g(should)h +(y)f(of)165 259 y(these)j(matc)o(hes.)32 b(The)20 b(caller)g(should)h (place)f(the)g(address)f(of)h(its)f(generator)g(function)h(in)g -Ft(rl_)165 1535 y(completion_entry_function)p Fu(.)100 -1602 y(3.)29 b(The)12 b(generator)e(function)i(is)g(called)h(rep)q +Ft(rl_)165 314 y(completion_entry_function)p Fu(.)100 +383 y(3.)29 b(The)12 b(generator)e(function)i(is)g(called)h(rep)q (eatedly)g(from)e Ft(rl_completion_matches\(\))p Fu(,)d(returning)165 -1657 y(a)16 b(string)g(eac)o(h)h(time.)24 b(The)17 b(argumen)o(ts)e(to) -h(the)g(generator)g(function)h(are)f Fk(text)h Fu(and)g -Fk(state)p Fu(.)22 b Fk(text)165 1712 y Fu(is)17 b(the)f(partial)g(w)o +438 y(a)16 b(string)g(eac)o(h)h(time.)24 b(The)17 b(argumen)o(ts)e(to)h +(the)g(generator)g(function)h(are)f Fk(text)h Fu(and)g +Fk(state)p Fu(.)22 b Fk(text)165 493 y Fu(is)17 b(the)f(partial)g(w)o (ord)f(to)h(b)q(e)h(completed.)23 b Fk(state)18 b Fu(is)e(zero)g(the)g -(\014rst)g(time)g(the)g(function)h(is)g(called,)165 1766 +(\014rst)g(time)g(the)g(function)h(is)g(called,)165 547 y(allo)o(wing)23 b(the)f(generator)f(to)g(p)q(erform)h(an)o(y)g (necessary)g(initialization,)k(and)c(a)g(p)q(ositiv)o(e)h(non-)165 -1821 y(zero)14 b(in)o(teger)h(for)f(eac)o(h)h(subsequen)o(t)g(call.)21 +602 y(zero)14 b(in)o(teger)h(for)f(eac)o(h)h(subsequen)o(t)g(call.)21 b(The)15 b(generator)e(function)j(returns)e Ft(\(char)h(*\)NULL)f -Fu(to)165 1876 y(inform)19 b Ft(rl_completion_matches\(\))d +Fu(to)165 657 y(inform)19 b Ft(rl_completion_matches\(\))d Fu(that)i(there)h(are)g(no)g(more)g(p)q(ossibilities)j(left.)32 -b(Usually)165 1931 y(the)19 b(generator)g(function)h(computes)g(the)f +b(Usually)165 712 y(the)19 b(generator)g(function)h(computes)g(the)f (list)h(of)f(p)q(ossible)i(completions)g(when)e Fk(state)j -Fu(is)d(zero,)165 1986 y(and)13 b(returns)g(them)f(one)h(at)f(a)h(time) -g(on)g(subsequen)o(t)g(calls.)20 b(Eac)o(h)13 b(string)f(the)h -(generator)f(function)165 2040 y(returns)k(as)f(a)h(matc)o(h)f(m)o(ust) -h(b)q(e)g(allo)q(cated)h(with)g Ft(malloc\(\))p Fu(;)d(Readline)k -(frees)e(the)g(strings)f(when)165 2095 y(it)g(has)h(\014nished)g(with)g -(them.)1762 2213 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p -215 2213 18 3 v 21 w(complete)j Fg(\()p Ft(int)14 b(ignore,)g(int)h -(invoking_key)p Fg(\))195 2268 y Fu(Complete)h(the)f(w)o(ord)g(at)f(or) +Fu(is)d(zero,)165 767 y(and)13 b(returns)g(them)f(one)h(at)f(a)h(time)g +(on)g(subsequen)o(t)g(calls.)20 b(Eac)o(h)13 b(string)f(the)h +(generator)f(function)165 821 y(returns)k(as)f(a)h(matc)o(h)f(m)o(ust)h +(b)q(e)g(allo)q(cated)h(with)g Ft(malloc\(\))p Fu(;)d(Readline)k(frees) +e(the)g(strings)f(when)165 876 y(it)g(has)h(\014nished)g(with)g(them.) +1762 1005 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 +1005 18 3 v 21 w(complete)j Fg(\()p Ft(int)14 b(ignore,)g(int)h +(invoking_key)p Fg(\))195 1059 y Fu(Complete)h(the)f(w)o(ord)g(at)f(or) h(b)q(efore)h(p)q(oin)o(t.)21 b(Y)l(ou)15 b(ha)o(v)o(e)g(supplied)j -(the)d(function)i(that)d(do)q(es)i(the)195 2323 y(initial)23 +(the)d(function)i(that)d(do)q(es)i(the)195 1114 y(initial)23 b(simple)f(matc)o(hing)e(selection)i(algorithm)f(\(see)f -Ft(rl_completion_matches\(\))p Fu(\).)33 b(The)195 2378 +Ft(rl_completion_matches\(\))p Fu(\).)33 b(The)195 1169 y(default)16 b(is)f(to)g(do)g(\014lename)h(completion.)1773 -2496 y(V)l(ariable)-1861 b Fi(rl_compentry_func_t)22 -b(*)d Fh(rl)p 678 2496 V 21 w(completion)p 973 2496 V -21 w(en)n(try)p 1126 2496 V 22 w(function)195 2550 y +1298 y(V)l(ariable)-1861 b Fi(rl_compentry_func_t)22 +b(*)d Fh(rl)p 678 1298 V 21 w(completion)p 973 1298 V +21 w(en)n(try)p 1126 1298 V 22 w(function)195 1352 y Fu(This)i(is)f(a)g(p)q(oin)o(ter)g(to)f(the)h(generator)g(function)g (for)g Ft(rl_completion_matches\(\))p Fu(.)31 b(If)20 -b(the)195 2605 y(v)m(alue)13 b(of)f Ft(rl_completion_entry_fun)o(ction) +b(the)195 1407 y(v)m(alue)13 b(of)f Ft(rl_completion_entry_fun)o(ction) d Fu(is)j Ft(NULL)f Fu(then)h(the)g(default)h(\014lename)g(generator) -195 2660 y(function,)j Ft(rl_filename_completion_f)o(unction)o(\(\))p -Fu(,)c(is)k(used.)p eop -%%Page: 40 42 -40 41 bop 75 -58 a Fu(40)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fj(2.6.2)30 b(Completion)20 b(F)-5 b(unctions)137 -244 y Fu(Here)16 b(is)f(the)h(complete)g(list)g(of)e(callable)k -(completion)e(functions)g(presen)o(t)f(in)h(Readline.)1762 -353 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 353 -18 3 v 21 w(complete)p 460 353 V 21 w(in)n(ternal)k Fg(\()p -Ft(int)15 b(what_to_do)p Fg(\))195 408 y Fu(Complete)k(the)g(w)o(ord)f -(at)g(or)g(b)q(efore)h(p)q(oin)o(t.)31 b Fk(what)p 1108 -408 14 2 v 16 w(to)p 1165 408 V 16 w(do)21 b Fu(sa)o(ys)d(what)g(to)g -(do)h(with)g(the)g(com-)195 463 y(pletion.)j(A)16 b(v)m(alue)h(of)e(`)p -Ft(?)p Fu(')g(means)g(list)i(the)e(p)q(ossible)j(completions.)k(`)p -Ft(TAB)p Fu(')14 b(means)i(do)f(standard)195 517 y(completion.)22 -b(`)p Ft(*)p Fu(')15 b(means)g(insert)h(all)h(of)e(the)h(p)q(ossible)h -(completions.)22 b(`)p Ft(!)p Fu(')15 b(means)g(to)g(displa)o(y)i(all) -195 572 y(of)g(the)g(p)q(ossible)i(completions,)f(if)g(there)f(is)h -(more)f(than)g(one,)g(as)g(w)o(ell)h(as)f(p)q(erforming)h(partial)195 -627 y(completion.)1762 736 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 736 18 3 v 21 w(complete)j Fg(\()p Ft(int)14 -b(ignore,)g(int)h(invoking_key)p Fg(\))195 791 y Fu(Complete)21 -b(the)g(w)o(ord)e(at)h(or)g(b)q(efore)h(p)q(oin)o(t.)37 -b(Y)l(ou)21 b(ha)o(v)o(e)f(supplied)j(the)d(function)i(that)e(do)q(es) -195 845 y(the)d(initial)h(simple)g(matc)o(hing)f(selection)h(algorithm) -e(\(see)g Ft(rl_completion_matches\(\))e Fu(and)195 900 -y Ft(rl_completion_entry_functi)o(on)p Fu(\).)25 b(The)18 +195 1462 y(function,)j Ft(rl_filename_completion_f)o(unction)o(\(\))p +Fu(,)c(is)k(used.)75 1582 y Fj(2.6.2)30 b(Completion)20 +b(F)-5 b(unctions)137 1682 y Fu(Here)16 b(is)f(the)h(complete)g(list)g +(of)e(callable)k(completion)e(functions)g(presen)o(t)f(in)h(Readline.) +1762 1810 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 +1810 V 21 w(complete)p 460 1810 V 21 w(in)n(ternal)k +Fg(\()p Ft(int)15 b(what_to_do)p Fg(\))195 1865 y Fu(Complete)k(the)g +(w)o(ord)f(at)g(or)g(b)q(efore)h(p)q(oin)o(t.)31 b Fk(what)p +1108 1865 14 2 v 16 w(to)p 1165 1865 V 16 w(do)21 b Fu(sa)o(ys)d(what)g +(to)g(do)h(with)g(the)g(com-)195 1920 y(pletion.)j(A)16 +b(v)m(alue)h(of)e(`)p Ft(?)p Fu(')g(means)g(list)i(the)e(p)q(ossible)j +(completions.)k(`)p Ft(TAB)p Fu(')14 b(means)i(do)f(standard)195 +1975 y(completion.)22 b(`)p Ft(*)p Fu(')15 b(means)g(insert)h(all)h(of) +e(the)h(p)q(ossible)h(completions.)22 b(`)p Ft(!)p Fu(')15 +b(means)g(to)g(displa)o(y)i(all)195 2029 y(of)g(the)g(p)q(ossible)i +(completions,)f(if)g(there)f(is)h(more)f(than)g(one,)g(as)g(w)o(ell)h +(as)f(p)q(erforming)h(partial)195 2084 y(completion.)1762 +2213 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p 215 2213 +18 3 v 21 w(complete)j Fg(\()p Ft(int)14 b(ignore,)g(int)h +(invoking_key)p Fg(\))195 2268 y Fu(Complete)21 b(the)g(w)o(ord)e(at)h +(or)g(b)q(efore)h(p)q(oin)o(t.)37 b(Y)l(ou)21 b(ha)o(v)o(e)f(supplied)j +(the)d(function)i(that)e(do)q(es)195 2322 y(the)d(initial)h(simple)g +(matc)o(hing)f(selection)h(algorithm)e(\(see)g Ft +(rl_completion_matches\(\))e Fu(and)195 2377 y Ft +(rl_completion_entry_functi)o(on)p Fu(\).)25 b(The)18 b(default)h(is)f(to)f(do)h(\014lename)h(completion.)29 -b(This)195 955 y(calls)16 b Ft(rl_complete_internal\(\))c +b(This)195 2432 y(calls)16 b Ft(rl_complete_internal\(\))c Fu(with)k(an)f(argumen)o(t)f(dep)q(ending)k(on)d Fk(in)o(v)o(oking)p -1657 955 14 2 v 17 w(k)o(ey)p Fu(.)1762 1064 y(F)l(unction)-1861 -b Fi(int)20 b Fh(rl)p 215 1064 18 3 v 21 w(p)r(ossible)p -433 1064 V 20 w(completions)j Fg(\()p Ft(int)15 b(count,)f(int)h -(invoking_key)p Fg(\))195 1119 y Fu(List)21 b(the)f(p)q(ossible)i +1657 2432 14 2 v 17 w(k)o(ey)p Fu(.)1762 2560 y(F)l(unction)-1861 +b Fi(int)20 b Fh(rl)p 215 2560 18 3 v 21 w(p)r(ossible)p +433 2560 V 20 w(completions)j Fg(\()p Ft(int)15 b(count,)f(int)h +(invoking_key)p Fg(\))195 2615 y Fu(List)21 b(the)f(p)q(ossible)i (completions.)36 b(See)21 b(description)h(of)e Ft(rl_complete)13 -b(\(\))p Fu(.)35 b(This)21 b(calls)g Ft(rl_)195 1174 +b(\(\))p Fu(.)35 b(This)21 b(calls)g Ft(rl_)195 2670 y(complete_internal\(\))13 b Fu(with)i(an)g(argumen)o(t)g(of)f(`)p -Ft(?)p Fu('.)1762 1282 y(F)l(unction)-1861 b Fi(int)20 -b Fh(rl)p 215 1282 V 21 w(insert)p 378 1282 V 21 w(completions)j +Ft(?)p Fu('.)p eop +%%Page: 43 45 +43 44 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(43)1762 149 y(F)l(unction)-1861 b Fi(int)20 +b Fh(rl)p 215 149 18 3 v 21 w(insert)p 378 149 V 21 w(completions)j Fg(\()p Ft(int)14 b(count,)g(int)h(invoking_key)p Fg(\))195 -1337 y Fu(Insert)i(the)g(list)h(of)e(p)q(ossible)j(completions)e(in)o +204 y Fu(Insert)i(the)g(list)h(of)e(p)q(ossible)j(completions)e(in)o (to)g(the)g(line,)i(deleting)f(the)f(partially-completed)195 -1392 y(w)o(ord.)k(See)c(description)g(of)e Ft(rl_complete\(\))p +259 y(w)o(ord.)k(See)c(description)g(of)e Ft(rl_complete\(\))p Fu(.)20 b(This)d(calls)g Ft(rl_complete_internal\(\))c -Fu(with)195 1447 y(an)i(argumen)o(t)g(of)f(`)p Ft(*)p -Fu('.)1762 1556 y(F)l(unction)-1861 b Fi(char)20 b(**)f -Fh(rl)p 312 1556 V 21 w(completion)p 607 1556 V 21 w(matc)n(hes)j -Fg(\()p Ft(const)15 b(char)f(*text,)283 1611 y(rl_compentry_func_t)e -(*entry_func)p Fg(\))195 1665 y Fu(Returns)18 b(an)h(arra)o(y)f(of)g -(strings)h(whic)o(h)h(is)g(a)e(list)i(of)e(completions)i(for)f -Fk(text)p Fu(.)30 b(If)19 b(there)g(are)g(no)195 1720 -y(completions,)f(returns)g Ft(NULL)p Fu(.)25 b(The)17 -b(\014rst)g(en)o(try)g(in)h(the)f(returned)h(arra)o(y)e(is)i(the)f -(substitution)195 1775 y(for)c Fk(text)p Fu(.)18 b(The)c(remaining)g -(en)o(tries)f(are)g(the)h(p)q(ossible)g(completions.)21 -b(The)13 b(arra)o(y)f(is)i(terminated)195 1830 y(with)i(a)e -Ft(NULL)h Fu(p)q(oin)o(ter.)195 1895 y Fk(en)o(try)p -302 1895 14 2 v 16 w(func)h Fu(is)e(a)f(function)h(of)e(t)o(w)o(o)g -(args,)g(and)i(returns)f(a)f Ft(char)j(*)p Fu(.)k(The)13 -b(\014rst)g(argumen)o(t)f(is)i Fk(text)p Fu(.)195 1950 -y(The)f(second)g(is)f(a)h(state)e(argumen)o(t;)h(it)h(is)g(zero)f(on)g -(the)h(\014rst)f(call,)i(and)e(non-zero)h(on)f(subsequen)o(t)195 -2005 y(calls.)20 b Fk(en)o(try)p 420 2005 V 16 w(func)15 -b Fu(returns)e(a)e Ft(NULL)h Fu(p)q(oin)o(ter)h(to)e(the)i(caller)g -(when)g(there)f(are)g(no)g(more)g(matc)o(hes.)1762 2114 -y(F)l(unction)-1861 b Fi(char)20 b(*)f Fh(rl)p 286 2114 -18 3 v 21 w(\014lename)p 515 2114 V 20 w(completion)p -809 2114 V 21 w(function)k Fg(\()p Ft(const)15 b(char)f(*text,)h(int) -283 2169 y(state)p Fg(\))195 2223 y Fu(A)e(generator)f(function)h(for)g +Fu(with)195 314 y(an)i(argumen)o(t)g(of)f(`)p Ft(*)p +Fu('.)1762 434 y(F)l(unction)-1861 b Fi(int)20 b Fh(rl)p +215 434 V 21 w(completion)p 510 434 V 21 w(mo)r(de)h +Fg(\()p Ft(rl_command_func_t)12 b(*cfunc)p Fg(\))195 +489 y Fu(Returns)25 b(the)g(apppriate)h(v)m(alue)g(to)f(pass)g(to)f +Ft(rl_complete_internal\(\))f Fu(dep)q(ending)k(on)195 +543 y(whether)22 b Fk(cfunc)j Fu(w)o(as)d(called)h(t)o(wice)f(in)h +(succession)g(and)f(the)g(v)m(alue)h(of)f(the)g Ft(show-all-if-)195 +598 y(ambiguous)14 b Fu(v)m(ariable.)21 b(Application-sp)q(ec)q(i\014c) +e(completion)d(functions)g(ma)o(y)f(use)g(this)h(function)195 +653 y(to)f(presen)o(t)g(the)g(same)g(in)o(terface)g(as)g +Ft(rl_complete\(\))p Fu(.)1762 773 y(F)l(unction)-1861 +b Fi(char)20 b(**)f Fh(rl)p 312 773 V 21 w(completion)p +607 773 V 21 w(matc)n(hes)j Fg(\()p Ft(const)15 b(char)f(*text,)283 +828 y(rl_compentry_func_t)e(*entry_func)p Fg(\))195 883 +y Fu(Returns)18 b(an)h(arra)o(y)f(of)g(strings)h(whic)o(h)h(is)g(a)e +(list)i(of)e(completions)i(for)f Fk(text)p Fu(.)30 b(If)19 +b(there)g(are)g(no)195 937 y(completions,)f(returns)g +Ft(NULL)p Fu(.)25 b(The)17 b(\014rst)g(en)o(try)g(in)h(the)f(returned)h +(arra)o(y)e(is)i(the)f(substitution)195 992 y(for)c Fk(text)p +Fu(.)18 b(The)c(remaining)g(en)o(tries)f(are)g(the)h(p)q(ossible)g +(completions.)21 b(The)13 b(arra)o(y)f(is)i(terminated)195 +1047 y(with)i(a)e Ft(NULL)h Fu(p)q(oin)o(ter.)195 1115 +y Fk(en)o(try)p 302 1115 14 2 v 16 w(func)h Fu(is)e(a)f(function)h(of)e +(t)o(w)o(o)g(args,)g(and)i(returns)f(a)f Ft(char)j(*)p +Fu(.)k(The)13 b(\014rst)g(argumen)o(t)f(is)i Fk(text)p +Fu(.)195 1170 y(The)f(second)g(is)f(a)h(state)e(argumen)o(t;)h(it)h(is) +g(zero)f(on)g(the)h(\014rst)f(call,)i(and)e(non-zero)h(on)f(subsequen)o +(t)195 1225 y(calls.)20 b Fk(en)o(try)p 420 1225 V 16 +w(func)15 b Fu(returns)e(a)e Ft(NULL)h Fu(p)q(oin)o(ter)h(to)e(the)i +(caller)g(when)g(there)f(are)g(no)g(more)g(matc)o(hes.)1762 +1345 y(F)l(unction)-1861 b Fi(char)20 b(*)f Fh(rl)p 286 +1345 18 3 v 21 w(\014lename)p 515 1345 V 20 w(completion)p +809 1345 V 21 w(function)k Fg(\()p Ft(const)15 b(char)f(*text,)h(int) +283 1400 y(state)p Fg(\))195 1454 y Fu(A)e(generator)f(function)h(for)g (\014lename)h(completion)f(in)h(the)f(general)g(case.)19 -b Fk(text)14 b Fu(is)f(a)g(partial)g(\014le-)195 2278 +b Fk(text)14 b Fu(is)f(a)g(partial)g(\014le-)195 1509 y(name.)20 b(The)15 b(Bash)f(source)h(is)g(a)g(useful)g(reference)h (for)e(writing)h(custom)f(completion)i(functions)195 -2333 y(\(the)f(Bash)g(completion)i(functions)e(call)i(this)e(and)h -(other)f(Readline)h(functions\).)1762 2442 y(F)l(unction)-1861 -b Fi(char)20 b(*)f Fh(rl)p 286 2442 V 21 w(username)p -547 2442 V 19 w(completion)p 840 2442 V 21 w(function)k -Fg(\()p Ft(const)14 b(char)g(*text,)283 2497 y(int)g(state)p -Fg(\))195 2552 y Fu(A)g(completion)i(generator)d(for)h(usernames.)19 +1564 y(\(the)f(Bash)g(completion)i(functions)e(call)i(this)e(and)h +(other)f(Readline)h(functions\).)1762 1684 y(F)l(unction)-1861 +b Fi(char)20 b(*)f Fh(rl)p 286 1684 V 21 w(username)p +547 1684 V 19 w(completion)p 840 1684 V 21 w(function)k +Fg(\()p Ft(const)14 b(char)g(*text,)283 1739 y(int)g(state)p +Fg(\))195 1794 y Fu(A)g(completion)i(generator)d(for)h(usernames.)19 b Fk(text)c Fu(con)o(tains)f(a)g(partial)h(username)f(preceded)i(b)o(y) -195 2606 y(a)f(random)g(c)o(haracter)f(\(usually)j(`)p +195 1848 y(a)f(random)g(c)o(haracter)f(\(usually)j(`)p Ft(~)p Fu('\).)i(As)c(with)g(all)i(completion)f(generators,)e -Fk(state)j Fu(is)f(zero)f(on)195 2661 y(the)g(\014rst)g(call)h(and)g -(non-zero)f(for)g(subsequen)o(t)h(calls.)p eop -%%Page: 41 43 -41 42 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(41)75 149 y Fj(2.6.3)30 b(Completion)20 -b(V)-5 b(ariables)1773 292 y Fu(V)l(ariable)-1861 b Fi -(rl_compentry_func_t)22 b(*)d Fh(rl)p 678 292 18 3 v -21 w(completion)p 973 292 V 21 w(en)n(try)p 1126 292 -V 22 w(function)195 347 y Fu(A)e(p)q(oin)o(ter)g(to)f(the)h(generator)f -(function)h(for)f Ft(rl_completion_matches\(\))p Fu(.)22 -b Ft(NULL)16 b Fu(means)h(to)195 402 y(use)f Ft +Fk(state)j Fu(is)f(zero)f(on)195 1903 y(the)g(\014rst)g(call)h(and)g +(non-zero)f(for)g(subsequen)o(t)h(calls.)75 2017 y Fj(2.6.3)30 +b(Completion)20 b(V)-5 b(ariables)1773 2166 y Fu(V)l(ariable)-1861 +b Fi(rl_compentry_func_t)22 b(*)d Fh(rl)p 678 2166 V +21 w(completion)p 973 2166 V 21 w(en)n(try)p 1126 2166 +V 22 w(function)195 2221 y Fu(A)e(p)q(oin)o(ter)g(to)f(the)h(generator) +f(function)h(for)f Ft(rl_completion_matches\(\))p Fu(.)22 +b Ft(NULL)16 b Fu(means)h(to)195 2276 y(use)f Ft (rl_filename_completion_)o(functio)o(n\(\))p Fu(,)c(the)j(default)h -(\014lename)g(completer.)1773 516 y(V)l(ariable)-1861 -b Fi(rl_completion_func_t)22 b(*)d Fh(rl)p 704 516 V -22 w(attempted)p 985 516 V 20 w(completion)p 1279 516 -V 21 w(function)195 571 y Fu(A)e(p)q(oin)o(ter)h(to)f(an)g(alternativ)o -(e)h(function)g(to)f(create)g(matc)o(hes.)26 b(The)18 -b(function)g(is)g(called)h(with)195 625 y Fk(text)p Fu(,)11 -b Fk(start)p Fu(,)g(and)h Fk(end)p Fu(.)19 b Fk(start)11 -b Fu(and)h Fk(end)i Fu(are)d(indices)i(in)g Ft(rl_line_buffer)c -Fu(de\014ning)k(the)f(b)q(ound-)195 680 y(aries)h(of)g -Fk(text)p Fu(,)f(whic)o(h)i(is)g(a)e(c)o(haracter)h(string.)19 -b(If)13 b(this)g(function)h(exists)g(and)f(returns)g -Ft(NULL)p Fu(,)f(or)g(if)195 735 y(this)f(v)m(ariable)i(is)e(set)g(to)f -Ft(NULL)p Fu(,)h(then)g Ft(rl_complete\(\))e Fu(will)k(call)f(the)f(v)m -(alue)h(of)f Ft(rl_completion_)195 790 y(entry_function)h +(\014lename)g(completer.)1773 2396 y(V)l(ariable)-1861 +b Fi(rl_completion_func_t)22 b(*)d Fh(rl)p 704 2396 V +22 w(attempted)p 985 2396 V 20 w(completion)p 1279 2396 +V 21 w(function)195 2451 y Fu(A)e(p)q(oin)o(ter)h(to)f(an)g(alternativ) +o(e)h(function)g(to)f(create)g(matc)o(hes.)26 b(The)18 +b(function)g(is)g(called)h(with)195 2506 y Fk(text)p +Fu(,)11 b Fk(start)p Fu(,)g(and)h Fk(end)p Fu(.)19 b +Fk(start)11 b Fu(and)h Fk(end)i Fu(are)d(indices)i(in)g +Ft(rl_line_buffer)c Fu(de\014ning)k(the)f(b)q(ound-)195 +2560 y(aries)h(of)g Fk(text)p Fu(,)f(whic)o(h)i(is)g(a)e(c)o(haracter)h +(string.)19 b(If)13 b(this)g(function)h(exists)g(and)f(returns)g +Ft(NULL)p Fu(,)f(or)g(if)195 2615 y(this)f(v)m(ariable)i(is)e(set)g(to) +f Ft(NULL)p Fu(,)h(then)g Ft(rl_complete\(\))e Fu(will)k(call)f(the)f +(v)m(alue)h(of)f Ft(rl_completion_)195 2670 y(entry_function)h Fu(to)i(generate)g(matc)o(hes,)f(otherwise)i(the)f(arra)o(y)f(of)h -(strings)g(returned)g(will)i(b)q(e)195 845 y(used.)j(If)12 -b(this)f(function)h(sets)f(the)g Ft(rl_attempted_completion_over)d -Fu(v)m(ariable)k(to)f(a)g(non-zero)195 899 y(v)m(alue,)18 -b(Readline)h(will)f(not)f(p)q(erform)f(its)i(default)f(completion)h(ev) -o(en)f(if)h(this)f(function)h(returns)195 954 y(no)d(matc)o(hes.)1773 -1068 y(V)l(ariable)-1861 b Fi(rl_quote_func_t)21 b(*)f -Fh(rl)p 574 1068 V 21 w(\014lename)p 803 1068 V 20 w(quoting)p -1012 1068 V 21 w(function)195 1123 y Fu(A)c(p)q(oin)o(ter)h(to)f(a)g -(function)h(that)e(will)j(quote)e(a)g(\014lename)i(in)f(an)f -(application-sp)q(eci\014)q(c)j(fashion.)195 1178 y(This)h(is)g(called) -i(if)e(\014lename)g(completion)h(is)f(b)q(eing)h(attempted)e(and)h(one) -g(of)f(the)h(c)o(haracters)195 1232 y(in)d Ft -(rl_filename_quote_characters)c Fu(app)q(ears)k(in)g(a)g(completed)g -(\014lename.)25 b(The)17 b(function)195 1287 y(is)i(called)i(with)e -Fk(text)p Fu(,)g Fk(matc)o(h)p 722 1287 14 2 v 16 w(t)o(yp)q(e)p -Fu(,)g(and)g Fk(quote)p 1059 1287 V 17 w(p)q(oin)o(ter)p -Fu(.)31 b(The)19 b Fk(text)h Fu(is)f(the)g(\014lename)h(to)e(b)q(e)195 -1342 y(quoted.)39 b(The)21 b Fk(matc)o(h)p 607 1342 V -16 w(t)o(yp)q(e)j Fu(is)e(either)g Ft(SINGLE_MATCH)p -Fu(,)f(if)h(there)f(is)h(only)g(one)g(completion)195 -1397 y(matc)o(h,)15 b(or)g Ft(MULT_MATCH)p Fu(.)20 b(Some)c(functions)g -(use)g(this)g(to)f(decide)j(whether)e(or)f(not)g(to)g(insert)h(a)195 -1452 y(closing)c(quote)e(c)o(haracter.)18 b(The)11 b -Fk(quote)p 877 1452 V 16 w(p)q(oin)o(ter)k Fu(is)c(a)f(p)q(oin)o(ter)i -(to)e(an)o(y)g(op)q(ening)i(quote)f(c)o(haracter)195 -1506 y(the)k(user)h(t)o(yp)q(ed.)k(Some)15 b(functions)h(c)o(ho)q(ose)f -(to)g(reset)g(this)g(c)o(haracter.)1773 1620 y(V)l(ariable)-1861 -b Fi(rl_dequote_func_t)22 b(*)d Fh(rl)p 626 1620 18 3 -v 21 w(\014lename)p 855 1620 V 20 w(dequoting)p 1122 -1620 V 21 w(function)195 1675 y Fu(A)c(p)q(oin)o(ter)g(to)f(a)h -(function)g(that)g(will)h(remo)o(v)o(e)e(application-sp)q(eci\014)q(c)k -(quoting)d(c)o(haracters)f(from)195 1730 y(a)i(\014lename)h(b)q(efore)g -(completion)g(is)g(attempted,)f(so)f(those)h(c)o(haracters)g(do)g(not)g -(in)o(terfere)h(with)195 1785 y(matc)o(hing)i(the)g(text)g(against)f -(names)h(in)h(the)f(\014lesystem.)33 b(It)19 b(is)g(called)i(with)e -Fk(text)p Fu(,)g(the)g(text)195 1839 y(of)i(the)g(w)o(ord)g(to)g(b)q(e) -h(dequoted,)h(and)e Fk(quote)p 1009 1839 14 2 v 17 w(c)o(har)p +(strings)g(returned)g(will)i(b)q(e)p eop +%%Page: 44 46 +44 45 bop 75 -58 a Fu(44)1299 b(GNU)15 b(Readline)h(Library)195 +149 y(used.)j(If)12 b(this)f(function)h(sets)f(the)g +Ft(rl_attempted_completion_over)d Fu(v)m(ariable)k(to)f(a)g(non-zero) +195 204 y(v)m(alue,)18 b(Readline)h(will)f(not)f(p)q(erform)f(its)i +(default)f(completion)h(ev)o(en)f(if)h(this)f(function)h(returns)195 +259 y(no)d(matc)o(hes.)1773 380 y(V)l(ariable)-1861 b +Fi(rl_quote_func_t)21 b(*)f Fh(rl)p 574 380 18 3 v 21 +w(\014lename)p 803 380 V 20 w(quoting)p 1012 380 V 21 +w(function)195 434 y Fu(A)c(p)q(oin)o(ter)h(to)f(a)g(function)h(that)e +(will)j(quote)e(a)g(\014lename)i(in)f(an)f(application-sp)q(eci\014)q +(c)j(fashion.)195 489 y(This)h(is)g(called)i(if)e(\014lename)g +(completion)h(is)f(b)q(eing)h(attempted)e(and)h(one)g(of)f(the)h(c)o +(haracters)195 544 y(in)d Ft(rl_filename_quote_characters)c +Fu(app)q(ears)k(in)g(a)g(completed)g(\014lename.)25 b(The)17 +b(function)195 599 y(is)i(called)i(with)e Fk(text)p Fu(,)g +Fk(matc)o(h)p 722 599 14 2 v 16 w(t)o(yp)q(e)p Fu(,)g(and)g +Fk(quote)p 1059 599 V 17 w(p)q(oin)o(ter)p Fu(.)31 b(The)19 +b Fk(text)h Fu(is)f(the)g(\014lename)h(to)e(b)q(e)195 +654 y(quoted.)39 b(The)21 b Fk(matc)o(h)p 607 654 V 16 +w(t)o(yp)q(e)j Fu(is)e(either)g Ft(SINGLE_MATCH)p Fu(,)f(if)h(there)f +(is)h(only)g(one)g(completion)195 708 y(matc)o(h,)15 +b(or)g Ft(MULT_MATCH)p Fu(.)20 b(Some)c(functions)g(use)g(this)g(to)f +(decide)j(whether)e(or)f(not)g(to)g(insert)h(a)195 763 +y(closing)c(quote)e(c)o(haracter.)18 b(The)11 b Fk(quote)p +877 763 V 16 w(p)q(oin)o(ter)k Fu(is)c(a)f(p)q(oin)o(ter)i(to)e(an)o(y) +g(op)q(ening)i(quote)f(c)o(haracter)195 818 y(the)k(user)h(t)o(yp)q +(ed.)k(Some)15 b(functions)h(c)o(ho)q(ose)f(to)g(reset)g(this)g(c)o +(haracter.)1773 938 y(V)l(ariable)-1861 b Fi(rl_dequote_func_t)22 +b(*)d Fh(rl)p 626 938 18 3 v 21 w(\014lename)p 855 938 +V 20 w(dequoting)p 1122 938 V 21 w(function)195 993 y +Fu(A)c(p)q(oin)o(ter)g(to)f(a)h(function)g(that)g(will)h(remo)o(v)o(e)e +(application-sp)q(eci\014)q(c)k(quoting)d(c)o(haracters)f(from)195 +1048 y(a)i(\014lename)h(b)q(efore)g(completion)g(is)g(attempted,)f(so)f +(those)h(c)o(haracters)g(do)g(not)g(in)o(terfere)h(with)195 +1103 y(matc)o(hing)i(the)g(text)g(against)f(names)h(in)h(the)f +(\014lesystem.)33 b(It)19 b(is)g(called)i(with)e Fk(text)p +Fu(,)g(the)g(text)195 1158 y(of)i(the)g(w)o(ord)g(to)g(b)q(e)h +(dequoted,)h(and)e Fk(quote)p 1009 1158 14 2 v 17 w(c)o(har)p Fu(,)h(whic)o(h)g(is)g(the)f(quoting)h(c)o(haracter)f(that)195 -1894 y(delimits)d(the)e(\014lename)i(\(usually)f(`)p +1212 y(delimits)d(the)e(\014lename)i(\(usually)f(`)p Ft(')p Fu(')f(or)f(`)p Ft(")p Fu('\).)22 b(If)17 b Fk(quote)p -1187 1894 V 16 w(c)o(har)i Fu(is)e(zero,)f(the)g(\014lename)i(w)o(as)d -(not)195 1949 y(in)h(an)f(em)o(b)q(edded)i(string.)1773 -2063 y(V)l(ariable)-1861 b Fi(rl_linebuf_func_t)22 b(*)d -Fh(rl)p 626 2063 18 3 v 21 w(c)n(har)p 754 2063 V 21 -w(is)p 813 2063 V 21 w(quoted)p 1005 2063 V 21 w(p)195 -2118 y Fu(A)f(p)q(oin)o(ter)h(to)f(a)g(function)h(to)f(call)i(that)d +1187 1212 V 16 w(c)o(har)i Fu(is)e(zero,)f(the)g(\014lename)i(w)o(as)d +(not)195 1267 y(in)h(an)f(em)o(b)q(edded)i(string.)1773 +1388 y(V)l(ariable)-1861 b Fi(rl_linebuf_func_t)22 b(*)d +Fh(rl)p 626 1388 18 3 v 21 w(c)n(har)p 754 1388 V 21 +w(is)p 813 1388 V 21 w(quoted)p 1005 1388 V 21 w(p)195 +1443 y Fu(A)f(p)q(oin)o(ter)h(to)f(a)g(function)h(to)f(call)i(that)d (determines)j(whether)e(or)g(not)g(a)g(sp)q(eci\014c)j(c)o(haracter)195 -2173 y(in)d(the)f(line)i(bu\013er)e(is)h(quoted,)g(according)f(to)g +1497 y(in)d(the)f(line)i(bu\013er)e(is)h(quoted,)g(according)f(to)g (whatev)o(er)f(quoting)i(mec)o(hanism)g(the)f(program)195 -2227 y(calling)d(Readline)g(uses.)19 b(The)13 b(function)g(is)g(called) +1552 y(calling)d(Readline)g(uses.)19 b(The)13 b(function)g(is)g(called) h(with)f(t)o(w)o(o)e(argumen)o(ts:)17 b Fk(text)p Fu(,)12 -b(the)h(text)f(of)g(the)195 2282 y(line,)17 b(and)e Fk(index)p +b(the)h(text)f(of)g(the)195 1607 y(line,)17 b(and)e Fk(index)p Fu(,)i(the)e(index)i(of)e(the)g(c)o(haracter)g(in)h(the)g(line.)22 -b(It)15 b(is)h(used)g(to)f(decide)i(whether)e(a)195 2337 +b(It)15 b(is)h(used)g(to)f(decide)i(whether)e(a)195 1662 y(c)o(haracter)f(found)i(in)g Ft(rl_completer_word_break_)o(charact)o -(ers)c Fu(should)k(b)q(e)g(used)g(to)e(break)195 2392 -y(w)o(ords)g(for)h(the)g(completer.)1773 2506 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 2506 V 21 w(completion)p 510 -2506 V 21 w(query)p 673 2506 V 21 w(items)195 2560 y -Fu(Up)e(to)g(this)g(man)o(y)g(items)g(will)i(b)q(e)f(displa)o(y)o(ed)g -(in)g(resp)q(onse)g(to)e(a)h(p)q(ossible-completions)j(call.)195 -2615 y(After)14 b(that,)f(w)o(e)h(ask)g(the)h(user)f(if)h(she)f(is)h -(sure)g(she)f(w)o(an)o(ts)f(to)h(see)h(them)f(all.)20 -b(The)15 b(default)g(v)m(alue)195 2670 y(is)h(100.)p -eop -%%Page: 42 44 -42 43 bop 75 -58 a Fu(42)1299 b(GNU)15 b(Readline)h(Library)1773 -149 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f Fh(rl)p -436 149 18 3 v 21 w(basic)p 580 149 V 21 w(w)n(ord)p -725 149 V 21 w(break)p 886 149 V 20 w(c)n(haracters)195 -204 y Fu(The)j(basic)h(list)g(of)f(c)o(haracters)f(that)g(signal)i(a)f -(break)g(b)q(et)o(w)o(een)g(w)o(ords)g(for)f(the)h(completer)195 -259 y(routine.)30 b(The)19 b(default)g(v)m(alue)h(of)e(this)h(v)m -(ariable)h(is)f(the)g(c)o(haracters)f(whic)o(h)h(break)g(w)o(ords)f -(for)195 314 y(completion)e(in)g(Bash:)k Ft(")15 b -(\\t\\n\\"\\\\'`@$><=;|&{\(")p Fu(.)1773 430 y(V)l(ariable)-1861 -b Fi(const)20 b(char)g(*)f Fh(rl)p 436 430 V 21 w(basic)p -580 430 V 21 w(quote)p 740 430 V 21 w(c)n(haracters)195 -485 y Fu(A)c(list)h(of)f(quote)g(c)o(haracters)f(whic)o(h)i(can)g -(cause)f(a)g(w)o(ord)g(break.)1773 601 y(V)l(ariable)-1861 -b Fi(const)20 b(char)g(*)f Fh(rl)p 436 601 V 21 w(completer)p -705 601 V 21 w(w)n(ord)p 850 601 V 20 w(break)p 1010 -601 V 20 w(c)n(haracters)195 656 y Fu(The)33 b(list)g(of)f(c)o -(haracters)g(that)f(signal)j(a)e(break)g(b)q(et)o(w)o(een)h(w)o(ords)f -(for)g Ft(rl_complete_)195 711 y(internal\(\))p Fu(.)18 -b(The)e(default)g(list)g(is)f(the)h(v)m(alue)g(of)f Ft -(rl_basic_word_break_chara)o(cters)p Fu(.)1773 828 y(V)l(ariable)-1861 -b Fi(const)20 b(char)g(*)f Fh(rl)p 436 828 V 21 w(completer)p -705 828 V 21 w(quote)p 865 828 V 20 w(c)n(haracters)195 -882 y Fu(A)e(list)h(of)e(c)o(haracters)g(whic)o(h)i(can)f(b)q(e)g(used) -h(to)e(quote)h(a)f(substring)h(of)g(the)g(line.)26 b(Completion)195 -937 y(o)q(ccurs)13 b(on)h(the)f(en)o(tire)g(substring,)h(and)f(within)i -(the)e(substring)g Ft(rl_completer_word_break_)195 992 -y(characters)j Fu(are)h(treated)g(as)h(an)o(y)f(other)g(c)o(haracter,)g -(unless)i(they)e(also)h(app)q(ear)g(within)h(this)195 -1047 y(list.)1773 1163 y(V)l(ariable)-1861 b Fi(const)20 -b(char)g(*)f Fh(rl)p 436 1163 V 21 w(\014lename)p 665 -1163 V 20 w(quote)p 824 1163 V 21 w(c)n(haracters)195 -1218 y Fu(A)e(list)h(of)e(c)o(haracters)g(that)g(cause)h(a)g -(\014lename)h(to)e(b)q(e)i(quoted)e(b)o(y)h(the)g(completer)h(when)f -(they)195 1273 y(app)q(ear)e(in)h(a)f(completed)h(\014lename.)21 -b(The)16 b(default)g(is)f(the)h(n)o(ull)g(string.)1773 -1389 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f Fh(rl)p -436 1389 V 21 w(sp)r(ecial)p 623 1389 V 22 w(pre\014xes)195 -1444 y Fu(The)14 b(list)h(of)e(c)o(haracters)g(that)g(are)h(w)o(ord)f -(break)h(c)o(haracters,)f(but)h(should)h(b)q(e)f(left)g(in)h -Fk(text)f Fu(when)195 1499 y(it)f(is)f(passed)h(to)f(the)g(completion)h -(function.)20 b(Programs)11 b(can)h(use)h(this)g(to)f(help)h(determine) -h(what)195 1554 y(kind)i(of)e(completing)i(to)e(do.)19 -b(F)l(or)14 b(instance,)i(Bash)e(sets)h(this)g(v)m(ariable)h(to)e -Ft(")p Fu($)p Ft(@")g Fu(so)g(that)g(it)h(can)195 1608 -y(complete)h(shell)h(v)m(ariables)f(and)g(hostnames.)1773 -1725 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1725 -V 21 w(completion)p 510 1725 V 21 w(app)r(end)p 715 1725 -V 19 w(c)n(haracter)195 1780 y Fu(When)d(a)f(single)i(completion)g -(alternativ)o(e)f(matc)o(hes)f(at)g(the)h(end)g(of)f(the)h(command)f -(line,)j(this)195 1834 y(c)o(haracter)10 b(is)h(app)q(ended)i(to)d(the) -g(inserted)i(completion)g(text.)18 b(The)11 b(default)g(is)g(a)g(space) -g(c)o(haracter)195 1889 y(\(`)j('\).)19 b(Setting)14 -b(this)f(to)g(the)g(n)o(ull)i(c)o(haracter)e(\(`)p Ft(\\0)p -Fu('\))e(prev)o(en)o(ts)i(an)o(ything)h(b)q(eing)h(app)q(ended)f(auto-) -195 1944 y(matically)l(.)21 b(This)15 b(can)f(b)q(e)h(c)o(hanged)g(in)g -(custom)f(completion)i(functions)f(to)f(pro)o(vide)h(the)f(\\most)195 -1999 y(sensible)i(w)o(ord)c(separator)h(c)o(haracter")f(according)i(to) -f(an)h(application-sp)q(eci\014c)j(command)c(line)195 -2054 y(syn)o(tax)h(sp)q(eci\014cation.)1773 2170 y(V)l(ariable)-1861 -b Fi(int)20 b Fh(rl)p 215 2170 V 21 w(ignore)p 391 2170 -V 20 w(completion)p 685 2170 V 21 w(duplicates)195 2225 -y Fu(If)15 b(non-zero,)h(then)f(duplicates)i(in)f(the)f(matc)o(hes)g -(are)g(remo)o(v)o(ed.)k(The)d(default)g(is)f(1.)1773 -2341 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 2341 -V 21 w(\014lename)p 444 2341 V 20 w(completion)p 738 -2341 V 21 w(desired)195 2396 y Fu(Non-zero)c(means)g(that)f(the)h -(results)g(of)g(the)g(matc)o(hes)f(are)h(to)f(b)q(e)i(treated)e(as)g -(\014lenames.)23 b(This)195 2451 y(is)14 b Fl(always)j -Fu(zero)c(on)g(en)o(try)l(,)g(and)h(can)f(only)h(b)q(e)g(c)o(hanged)f -(within)i(a)e(completion)h(en)o(try)f(generator)195 2506 -y(function.)38 b(If)21 b(it)g(is)g(set)g(to)f(a)g(non-zero)h(v)m(alue,) -i(directory)e(names)g(ha)o(v)o(e)g(a)f(slash)h(app)q(ended)195 -2560 y(and)d(Readline)h(attempts)d(to)h(quote)g(completed)i -(\014lenames)f(if)g(they)g(con)o(tain)g(an)o(y)f(c)o(haracters)195 -2615 y(in)f Ft(rl_filename_quote_character)o(s)d Fu(and)i -Ft(rl_filename_quoting_desired)d Fu(is)k(set)f(to)f(a)195 -2670 y(non-zero)h(v)m(alue.)p eop -%%Page: 43 45 -43 44 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(43)1773 149 y(V)l(ariable)-1861 b Fi(int)20 -b Fh(rl)p 215 149 18 3 v 21 w(\014lename)p 444 149 V -20 w(quoting)p 653 149 V 21 w(desired)195 204 y Fu(Non-zero)14 -b(means)g(that)f(the)i(results)f(of)g(the)g(matc)o(hes)f(are)h(to)f(b)q -(e)i(quoted)f(using)h(double)g(quotes)195 259 y(\(or)c(an)h -(application-sp)q(eci\014)q(c)j(quoting)d(mec)o(hanism\))g(if)h(the)f -(completed)h(\014lename)g(con)o(tains)f(an)o(y)195 314 -y(c)o(haracters)i(in)i Ft(rl_filename_quote_chars)p Fu(.)h(This)f(is)f -Fl(always)k Fu(non-zero)d(on)f(en)o(try)l(,)f(and)i(can)195 -369 y(only)c(b)q(e)g(c)o(hanged)g(within)h(a)f(completion)g(en)o(try)g -(generator)e(function.)20 b(The)12 b(quoting)g(is)g(e\013ected)195 -423 y(via)j(a)g(call)i(to)d(the)i(function)g(p)q(oin)o(ted)g(to)e(b)o -(y)h Ft(rl_filename_quoting_function)p Fu(.)1773 524 -y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 524 V 21 -w(attempted)p 495 524 V 20 w(completion)p 789 524 V 21 -w(o)n(v)n(er)195 579 y Fu(If)47 b(an)g(application-sp)q(eci\014)q(c)j -(completion)e(function)g(assigned)f(to)g Ft(rl_attempted_)195 -633 y(completion_function)24 b Fu(sets)i(this)h(v)m(ariable)h(to)e(a)g -(non-zero)h(v)m(alue,)j(Readline)e(will)g(not)195 688 -y(p)q(erform)15 b(its)g(default)g(\014lename)h(completion)g(ev)o(en)f -(if)g(the)g(application's)h(completion)g(function)195 -743 y(returns)f(no)g(matc)o(hes.)20 b(It)15 b(should)h(b)q(e)g(set)f -(only)h(b)o(y)f(an)g(application's)h(completion)h(function.)1773 -844 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 844 -V 21 w(completion)p 510 844 V 21 w(t)n(yp)r(e)195 898 -y Fu(Set)e(to)e(a)i(c)o(haracter)f(describing)i(the)e(t)o(yp)q(e)h(of)f -(completion)i(Readline)g(is)f(curren)o(tly)g(attempt-)195 -953 y(ing;)g(see)f(the)f(description)i(of)f Ft -(rl_complete_internal\(\))c Fu(\(see)k(Section)h(2.6.2)d([Completion) -195 1008 y(F)l(unctions],)g(page)g(40\))g(for)f(the)h(list)h(of)f(c)o -(haracters.)1773 1108 y(V)l(ariable)-1861 b Fi(int)20 -b Fh(rl)p 215 1108 V 21 w(inhibit)p 399 1108 V 23 w(completion)195 -1163 y Fu(If)14 b(this)h(v)m(ariable)g(is)g(non-zero,)f(completion)i -(is)e(inhibited.)22 b(The)15 b(completion)g(c)o(haracter)e(will)j(b)q -(e)195 1218 y(inserted)g(as)f(an)o(y)g(other)g(b)q(ound)h(to)e -Ft(self-insert)p Fu(.)1773 1318 y(V)l(ariable)-1861 b -Fi(rl_compignore_func_t)22 b(*)d Fh(rl)p 704 1318 V 22 -w(ignore)p 881 1318 V 20 w(some)p 1028 1318 V 19 w(completions)p -1344 1318 V 21 w(function)195 1373 y Fu(This)g(function,)i(if)e +(ers)c Fu(should)k(b)q(e)g(used)g(to)e(break)195 1717 +y(w)o(ords)g(for)h(the)g(completer.)1773 1837 y(V)l(ariable)-1861 +b Fi(rl_compignore_func_t)22 b(*)d Fh(rl)p 704 1837 V +22 w(ignore)p 881 1837 V 20 w(some)p 1028 1837 V 19 w(completions)p +1344 1837 V 21 w(function)195 1892 y Fu(This)g(function,)i(if)e (de\014ned,)i(is)e(called)h(b)o(y)f(the)g(completer)g(when)h(real)f -(\014lename)h(completion)195 1428 y(is)e(done,)f(after)f(all)i(the)f +(\014lename)h(completion)195 1947 y(is)e(done,)f(after)f(all)i(the)f (matc)o(hing)g(names)g(ha)o(v)o(e)g(b)q(een)h(generated.)25 -b(It)17 b(is)h(passed)f(a)g Ft(NULL)f Fu(ter-)195 1483 +b(It)17 b(is)h(passed)f(a)g Ft(NULL)f Fu(ter-)195 2001 y(minated)g(arra)o(y)e(of)h(matc)o(hes.)20 b(The)c(\014rst)f(elemen)o (t)h(\()p Ft(matches[0])p Fu(\))d(is)j(the)g(maximal)g(substring)195 -1538 y(common)e(to)g(all)h(matc)o(hes.)k(This)c(function)g(can)g +2056 y(common)e(to)g(all)h(matc)o(hes.)k(This)c(function)g(can)g (re-arrange)f(the)g(list)h(of)f(matc)o(hes)g(as)g(required,)195 -1592 y(but)h(eac)o(h)h(elemen)o(t)g(deleted)g(from)f(the)g(arra)o(y)f -(m)o(ust)g(b)q(e)i(freed.)1773 1693 y(V)l(ariable)-1861 -b Fi(rl_icppfunc_t)21 b(*)e Fh(rl)p 521 1693 V 21 w(directory)p -769 1693 V 22 w(completion)p 1065 1693 V 21 w(ho)r(ok)195 -1748 y Fu(This)k(function,)i(if)e(de\014ned,)j(is)d(allo)o(w)o(ed)g(to) +2111 y(but)h(eac)o(h)h(elemen)o(t)g(deleted)g(from)f(the)g(arra)o(y)f +(m)o(ust)g(b)q(e)i(freed.)1773 2232 y(V)l(ariable)-1861 +b Fi(rl_icppfunc_t)21 b(*)e Fh(rl)p 521 2232 V 21 w(directory)p +769 2232 V 22 w(completion)p 1065 2232 V 21 w(ho)r(ok)195 +2286 y Fu(This)k(function,)i(if)e(de\014ned,)j(is)d(allo)o(w)o(ed)g(to) f(mo)q(dify)h(the)g(directory)g(p)q(ortion)g(of)f(\014lenames)195 -1802 y(Readline)e(completes.)29 b(It)19 b(is)f(called)i(with)f(the)f +2341 y(Readline)e(completes.)29 b(It)19 b(is)f(called)i(with)f(the)f (address)h(of)e(a)h(string)h(\(the)f(curren)o(t)g(directory)195 -1857 y(name\))g(as)g(an)h(argumen)o(t,)f(and)h(ma)o(y)f(mo)q(dify)h +2396 y(name\))g(as)g(an)h(argumen)o(t,)f(and)h(ma)o(y)f(mo)q(dify)h (that)f(string.)30 b(If)19 b(the)f(string)h(is)g(replaced)h(with)195 -1912 y(a)g(new)g(string,)h(the)f(old)g(v)m(alue)h(should)g(b)q(e)g +2451 y(a)g(new)g(string,)h(the)f(old)g(v)m(alue)h(should)g(b)q(e)g (freed.)34 b(An)o(y)20 b(mo)q(di\014ed)i(directory)e(name)g(should)195 -1967 y(ha)o(v)o(e)14 b(a)g(trailing)i(slash.)k(The)15 +2506 y(ha)o(v)o(e)14 b(a)g(trailing)i(slash.)k(The)15 b(mo)q(di\014ed)h(v)m(alue)g(will)g(b)q(e)f(displa)o(y)o(ed)h(as)e -(part)g(of)h(the)f(completion,)195 2022 y(replacing)h(the)g(directory)f +(part)g(of)h(the)f(completion,)195 2560 y(replacing)h(the)g(directory)f (p)q(ortion)g(of)g(the)g(pathname)g(the)h(user)f(t)o(yp)q(ed.)20 -b(It)14 b(returns)g(an)g(in)o(teger)195 2076 y(that)i(should)h(b)q(e)g +b(It)14 b(returns)g(an)g(in)o(teger)195 2615 y(that)i(should)h(b)q(e)g (non-zero)g(if)g(the)g(function)g(mo)q(di\014es)h(its)e(directory)h -(argumen)o(t.)23 b(It)17 b(could)g(b)q(e)195 2131 y(used)f(to)e(expand) +(argumen)o(t.)23 b(It)17 b(could)g(b)q(e)195 2670 y(used)f(to)e(expand) i(sym)o(b)q(olic)h(links)f(or)f(shell)i(v)m(ariables)f(in)g(pathnames.) -1773 2232 y(V)l(ariable)-1861 b Fi(rl_compdisp_func_t)22 -b(*)d Fh(rl)p 652 2232 V 21 w(completion)p 947 2232 V -21 w(displa)n(y)p 1141 2232 V 22 w(matc)n(hes)p 1366 -2232 V 21 w(ho)r(ok)195 2286 y Fu(If)11 b(non-zero,)h(then)f(this)h(is) -f(the)g(address)g(of)g(a)g(function)g(to)g(call)h(when)f(completing)i -(a)d(w)o(ord)h(w)o(ould)195 2341 y(normally)h(displa)o(y)g(the)f(list)h -(of)f(p)q(ossible)h(matc)o(hes.)18 b(This)12 b(function)g(is)g(called)g -(in)g(lieu)h(of)e(Readline)195 2396 y(displa)o(ying)21 -b(the)d(list.)32 b(It)19 b(tak)o(es)f(three)h(argumen)o(ts:)26 -b(\()p Ft(char)14 b(**)p Fk(matc)o(hes)p Fu(,)19 b Ft(int)f -Fk(n)o(um)p 1688 2396 14 2 v 17 w(matc)o(hes)p Fu(,)195 -2451 y Ft(int)13 b Fk(max)p 368 2451 V 16 w(length)p -Fu(\))i(where)f Fk(matc)o(hes)h Fu(is)f(the)g(arra)o(y)f(of)g(matc)o -(hing)h(strings,)g Fk(n)o(um)p 1578 2451 V 16 w(matc)o(hes)i -Fu(is)e(the)195 2506 y(n)o(um)o(b)q(er)h(of)f(strings)h(in)h(that)e -(arra)o(y)l(,)f(and)i Fk(max)p 1012 2506 V 16 w(length)h -Fu(is)f(the)g(length)g(of)g(the)f(longest)h(string)g(in)195 -2560 y(that)e(arra)o(y)l(.)19 b(Readline)c(pro)o(vides)g(a)e(con)o(v)o -(enience)j(function,)f Ft(rl_display_match_list)p Fu(,)c(that)195 -2615 y(tak)o(es)17 b(care)g(of)g(doing)h(the)f(displa)o(y)i(to)d -(Readline's)j(output)e(stream.)26 b(That)16 b(function)j(ma)o(y)d(b)q -(e)195 2670 y(called)h(from)d(this)i(ho)q(ok.)p eop -%%Page: 44 46 -44 45 bop 75 -58 a Fu(44)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fj(2.6.4)30 b(A)21 b(Short)f(Completion)g(Example)137 -246 y Fu(Here)11 b(is)f(a)g(small)h(application)h(demonstrating)e(the)g -(use)h(of)e(the)i(GNU)f(Readline)h(library)l(.)19 b(It)11 -b(is)f(called)75 301 y Ft(fileman)p Fu(,)17 b(and)h(the)g(source)g(co)q -(de)g(resides)h(in)f(`)p Ft(examples/fileman.c)p Fu('.)25 -b(This)18 b(sample)g(application)75 355 y(pro)o(vides)c(completion)g -(of)e(command)h(names,)g(line)i(editing)g(features,)d(and)i(access)f -(to)f(the)h(history)h(list.)p eop +p eop %%Page: 45 47 45 46 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(45)195 149 y Ft(/*)24 b(fileman.c)e(--)i(A)g(tiny)f -(application)f(which)h(demonstrates)g(how)g(to)h(use)f(the)267 -201 y(GNU)g(Readline)g(library.)46 b(This)24 b(application)e -(interactively)g(allows)h(users)267 253 y(to)g(manipulate)g(files)g -(and)g(their)g(modes.)h(*/)195 357 y(#include)f(<stdio.h>)195 -409 y(#include)g(<sys/types.h>)195 461 y(#include)g(<sys/file.h>)195 -513 y(#include)g(<sys/stat.h>)195 565 y(#include)g(<sys/errno.h>)195 -668 y(#include)g(<readline/readline.h>)195 720 y(#include)g -(<readline/history.h>)195 824 y(extern)g(char)g(*xmalloc)g(\(\);)195 -928 y(/*)h(The)f(names)g(of)h(functions)e(that)i(actually)f(do)g(the)h -(manipulation.)e(*/)195 980 y(int)h(com_list)g(__P\(\(char)g(*\)\);)195 -1032 y(int)g(com_view)g(__P\(\(char)g(*\)\);)195 1083 -y(int)g(com_rename)g(__P\(\(char)g(*\)\);)195 1135 y(int)g(com_stat)g -(__P\(\(char)g(*\)\);)195 1187 y(int)g(com_pwd)g(__P\(\(char)g(*\)\);) -195 1239 y(int)g(com_delete)g(__P\(\(char)g(*\)\);)195 -1291 y(int)g(com_help)g(__P\(\(char)g(*\)\);)195 1343 -y(int)g(com_cd)g(__P\(\(char)g(*\)\);)195 1395 y(int)g(com_quit)g -(__P\(\(char)g(*\)\);)195 1499 y(/*)h(A)f(structure)g(which)g(contains) -g(information)f(on)i(the)f(commands)g(this)g(program)267 -1550 y(can)g(understand.)f(*/)195 1654 y(typedef)h(struct)g({)243 -1706 y(char)g(*name;)g(/*)h(User)f(printable)g(name)g(of)h(the)f -(function.)g(*/)243 1758 y(rl_icpfunc_t)f(*func;)h(/*)h(Function)e(to)i -(call)f(to)h(do)f(the)h(job.)f(*/)243 1810 y(char)g(*doc;)g(/*)h -(Documentation)e(for)h(this)h(function.)46 b(*/)195 1862 -y(})24 b(COMMAND;)195 1966 y(COMMAND)f(commands[])f(=)i({)243 -2017 y({)f("cd",)h(com_cd,)f("Change)f(to)i(directory)f(DIR")g(},)243 -2069 y({)g("delete",)g(com_delete,)f("Delete)h(FILE")h(},)243 -2121 y({)f("help",)g(com_help,)g("Display)g(this)g(text")g(},)243 -2173 y({)g("?",)h(com_help,)e("Synonym)h(for)h(`help'")f(},)243 -2225 y({)g("list",)g(com_list,)g("List)g(files)g(in)h(DIR")f(},)243 -2277 y({)g("ls",)h(com_list,)e("Synonym)h(for)g(`list'")g(},)243 -2329 y({)g("pwd",)g(com_pwd,)g("Print)g(the)h(current)f(working)g -(directory")f(},)243 2381 y({)h("quit",)g(com_quit,)g("Quit)g(using)g -(Fileman")g(},)243 2433 y({)g("rename",)g(com_rename,)f("Rename)h(FILE) -h(to)f(NEWNAME")g(},)243 2484 y({)g("stat",)g(com_stat,)g("Print)g(out) -g(statistics)g(on)h(FILE")f(},)243 2536 y({)g("view",)g(com_view,)g -("View)g(the)h(contents)e(of)i(FILE")f(},)243 2588 y({)g(\(char)h -(*\)NULL,)f(\(rl_icpfunc_t)f(*\)NULL,)h(\(char)g(*\)NULL)g(})195 -2640 y(};)p eop +(Readline)843 b(45)1773 149 y(V)l(ariable)-1861 b Fi +(rl_compdisp_func_t)22 b(*)d Fh(rl)p 652 149 18 3 v 21 +w(completion)p 947 149 V 21 w(displa)n(y)p 1141 149 V +22 w(matc)n(hes)p 1366 149 V 21 w(ho)r(ok)195 204 y Fu(If)11 +b(non-zero,)h(then)f(this)h(is)f(the)g(address)g(of)g(a)g(function)g +(to)g(call)h(when)f(completing)i(a)d(w)o(ord)h(w)o(ould)195 +259 y(normally)h(displa)o(y)g(the)f(list)h(of)f(p)q(ossible)h(matc)o +(hes.)18 b(This)12 b(function)g(is)g(called)g(in)g(lieu)h(of)e +(Readline)195 314 y(displa)o(ying)21 b(the)d(list.)32 +b(It)19 b(tak)o(es)f(three)h(argumen)o(ts:)26 b(\()p +Ft(char)14 b(**)p Fk(matc)o(hes)p Fu(,)19 b Ft(int)f +Fk(n)o(um)p 1688 314 14 2 v 17 w(matc)o(hes)p Fu(,)195 +369 y Ft(int)13 b Fk(max)p 368 369 V 16 w(length)p Fu(\))i(where)f +Fk(matc)o(hes)h Fu(is)f(the)g(arra)o(y)f(of)g(matc)o(hing)h(strings,)g +Fk(n)o(um)p 1578 369 V 16 w(matc)o(hes)i Fu(is)e(the)195 +423 y(n)o(um)o(b)q(er)h(of)f(strings)h(in)h(that)e(arra)o(y)l(,)f(and)i +Fk(max)p 1012 423 V 16 w(length)h Fu(is)f(the)g(length)g(of)g(the)f +(longest)h(string)g(in)195 478 y(that)e(arra)o(y)l(.)19 +b(Readline)c(pro)o(vides)g(a)e(con)o(v)o(enience)j(function,)f +Ft(rl_display_match_list)p Fu(,)c(that)195 533 y(tak)o(es)17 +b(care)g(of)g(doing)h(the)f(displa)o(y)i(to)d(Readline's)j(output)e +(stream.)26 b(That)16 b(function)j(ma)o(y)d(b)q(e)195 +588 y(called)h(from)d(this)i(ho)q(ok.)1773 704 y(V)l(ariable)-1861 +b Fi(const)20 b(char)g(*)f Fh(rl)p 436 704 18 3 v 21 +w(basic)p 580 704 V 21 w(w)n(ord)p 725 704 V 21 w(break)p +886 704 V 20 w(c)n(haracters)195 759 y Fu(The)j(basic)h(list)g(of)f(c)o +(haracters)f(that)g(signal)i(a)f(break)g(b)q(et)o(w)o(een)g(w)o(ords)g +(for)f(the)h(completer)195 814 y(routine.)30 b(The)19 +b(default)g(v)m(alue)h(of)e(this)h(v)m(ariable)h(is)f(the)g(c)o +(haracters)f(whic)o(h)h(break)g(w)o(ords)f(for)195 869 +y(completion)e(in)g(Bash:)k Ft(")15 b(\\t\\n\\"\\\\'`@$><=;|&{\(")p +Fu(.)1773 985 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f +Fh(rl)p 436 985 V 21 w(basic)p 580 985 V 21 w(quote)p +740 985 V 21 w(c)n(haracters)195 1040 y Fu(A)c(list)h(of)f(quote)g(c)o +(haracters)f(whic)o(h)i(can)g(cause)f(a)g(w)o(ord)g(break.)1773 +1156 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f Fh(rl)p +436 1156 V 21 w(completer)p 705 1156 V 21 w(w)n(ord)p +850 1156 V 20 w(break)p 1010 1156 V 20 w(c)n(haracters)195 +1211 y Fu(The)33 b(list)g(of)f(c)o(haracters)g(that)f(signal)j(a)e +(break)g(b)q(et)o(w)o(een)h(w)o(ords)f(for)g Ft(rl_complete_)195 +1266 y(internal\(\))p Fu(.)18 b(The)e(default)g(list)g(is)f(the)h(v)m +(alue)g(of)f Ft(rl_basic_word_break_chara)o(cters)p Fu(.)1773 +1382 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f Fh(rl)p +436 1382 V 21 w(completer)p 705 1382 V 21 w(quote)p 865 +1382 V 20 w(c)n(haracters)195 1437 y Fu(A)e(list)h(of)e(c)o(haracters)g +(whic)o(h)i(can)f(b)q(e)g(used)h(to)e(quote)h(a)f(substring)h(of)g(the) +g(line.)26 b(Completion)195 1492 y(o)q(ccurs)13 b(on)h(the)f(en)o(tire) +g(substring,)h(and)f(within)i(the)e(substring)g Ft +(rl_completer_word_break_)195 1547 y(characters)j Fu(are)h(treated)g +(as)h(an)o(y)f(other)g(c)o(haracter,)g(unless)i(they)e(also)h(app)q +(ear)g(within)h(this)195 1601 y(list.)1773 1718 y(V)l(ariable)-1861 +b Fi(const)20 b(char)g(*)f Fh(rl)p 436 1718 V 21 w(\014lename)p +665 1718 V 20 w(quote)p 824 1718 V 21 w(c)n(haracters)195 +1773 y Fu(A)e(list)h(of)e(c)o(haracters)g(that)g(cause)h(a)g +(\014lename)h(to)e(b)q(e)i(quoted)e(b)o(y)h(the)g(completer)h(when)f +(they)195 1828 y(app)q(ear)e(in)h(a)f(completed)h(\014lename.)21 +b(The)16 b(default)g(is)f(the)h(n)o(ull)g(string.)1773 +1944 y(V)l(ariable)-1861 b Fi(const)20 b(char)g(*)f Fh(rl)p +436 1944 V 21 w(sp)r(ecial)p 623 1944 V 22 w(pre\014xes)195 +1999 y Fu(The)14 b(list)h(of)e(c)o(haracters)g(that)g(are)h(w)o(ord)f +(break)h(c)o(haracters,)f(but)h(should)h(b)q(e)f(left)g(in)h +Fk(text)f Fu(when)195 2054 y(it)f(is)f(passed)h(to)f(the)g(completion)h +(function.)20 b(Programs)11 b(can)h(use)h(this)g(to)f(help)h(determine) +h(what)195 2108 y(kind)i(of)e(completing)i(to)e(do.)19 +b(F)l(or)14 b(instance,)i(Bash)e(sets)h(this)g(v)m(ariable)h(to)e +Ft(")p Fu($)p Ft(@")g Fu(so)g(that)g(it)h(can)195 2163 +y(complete)h(shell)h(v)m(ariables)f(and)g(hostnames.)1773 +2280 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 2280 +V 21 w(completion)p 510 2280 V 21 w(query)p 673 2280 +V 21 w(items)195 2334 y Fu(Up)e(to)g(this)g(man)o(y)g(items)g(will)i(b) +q(e)f(displa)o(y)o(ed)g(in)g(resp)q(onse)g(to)e(a)h(p)q +(ossible-completions)j(call.)195 2389 y(After)14 b(that,)f(w)o(e)h(ask) +g(the)h(user)f(if)h(she)f(is)h(sure)g(she)f(w)o(an)o(ts)f(to)h(see)h +(them)f(all.)20 b(The)15 b(default)g(v)m(alue)195 2444 +y(is)h(100.)1773 2560 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 2560 V 21 w(completion)p 510 2560 V 21 +w(app)r(end)p 715 2560 V 19 w(c)n(haracter)195 2615 y +Fu(When)d(a)f(single)i(completion)g(alternativ)o(e)f(matc)o(hes)f(at)g +(the)h(end)g(of)f(the)h(command)f(line,)j(this)195 2670 +y(c)o(haracter)10 b(is)h(app)q(ended)i(to)d(the)g(inserted)i +(completion)g(text.)18 b(The)11 b(default)g(is)g(a)g(space)g(c)o +(haracter)p eop %%Page: 46 48 46 47 bop 75 -58 a Fu(46)1299 b(GNU)15 b(Readline)h(Library)195 -201 y Ft(/*)24 b(Forward)e(declarations.)h(*/)195 253 -y(char)g(*stripwhite)g(\(\);)195 305 y(COMMAND)g(*find_command)f(\(\);) -195 409 y(/*)i(The)f(name)g(of)h(this)f(program,)g(as)h(taken)f(from)g -(argv[0].)g(*/)195 461 y(char)g(*progname;)195 565 y(/*)h(When)f -(non-zero,)g(this)g(means)g(the)g(user)h(is)f(done)h(using)f(this)g -(program.)g(*/)195 616 y(int)g(done;)195 720 y(char)g(*)195 -772 y(dupstr)g(\(s\))314 824 y(int)h(s;)195 876 y({)243 -928 y(char)f(*r;)243 1032 y(r)g(=)h(xmalloc)f(\(strlen)g(\(s\))g(+)h -(1\);)243 1083 y(strcpy)f(\(r,)g(s\);)243 1135 y(return)g(\(r\);)195 -1187 y(})195 1291 y(main)g(\(argc,)g(argv\))314 1343 -y(int)h(argc;)314 1395 y(char)g(**argv;)195 1447 y({)243 -1499 y(char)f(*line,)g(*s;)243 1602 y(progname)f(=)i(argv[0];)243 -1706 y(initialize_readline)d(\(\);)i(/*)h(Bind)f(our)h(completer.)e(*/) -243 1810 y(/*)h(Loop)h(reading)f(and)g(executing)g(lines)g(until)g(the) -g(user)h(quits.)f(*/)243 1862 y(for)g(\()h(;)g(done)f(==)h(0;)f(\))290 -1914 y({)338 1966 y(line)g(=)h(readline)f(\("FileMan:)f("\);)338 -2069 y(if)i(\(!line\))386 2121 y(break;)338 2225 y(/*)g(Remove)f -(leading)g(and)g(trailing)g(whitespace)f(from)i(the)f(line.)410 -2277 y(Then,)g(if)h(there)f(is)g(anything)g(left,)g(add)h(it)f(to)h -(the)f(history)g(list)410 2329 y(and)g(execute)g(it.)h(*/)338 -2381 y(s)g(=)g(stripwhite)e(\(line\);)338 2484 y(if)i(\(*s\))386 -2536 y({)434 2588 y(add_history)e(\(s\);)434 2640 y(execute_line)g -(\(s\);)p eop +149 y(\(`)e('\).)19 b(Setting)14 b(this)f(to)g(the)g(n)o(ull)i(c)o +(haracter)e(\(`)p Ft(\\0)p Fu('\))e(prev)o(en)o(ts)i(an)o(ything)h(b)q +(eing)h(app)q(ended)f(auto-)195 204 y(matically)l(.)21 +b(This)15 b(can)f(b)q(e)h(c)o(hanged)g(in)g(custom)f(completion)i +(functions)f(to)f(pro)o(vide)h(the)f(\\most)195 259 y(sensible)i(w)o +(ord)c(separator)h(c)o(haracter")f(according)i(to)f(an)h +(application-sp)q(eci\014c)j(command)c(line)195 314 y(syn)o(tax)h(sp)q +(eci\014cation.)1773 423 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 423 18 3 v 21 w(completion)p 510 423 V +21 w(suppress)p 746 423 V 19 w(app)r(end)195 478 y Fu(If)e(non-zero,)g +Fk(rl)p 476 478 14 2 v 17 w(completion)p 709 478 V 18 +w(app)q(end)p 871 478 V 17 w(c)o(haracter)i Fu(is)f(not)e(app)q(ended)i +(to)e(matc)o(hes)g(at)h(the)f(end)195 533 y(of)c(the)h(command)g(line,) +h(as)f(describ)q(ed)h(ab)q(o)o(v)o(e.)k(It)14 b(is)h(set)e(to)g(0)h(b)q +(efore)g(an)o(y)f(application-sp)q(eci)q(\014c)195 588 +y(completion)j(function)g(is)g(called.)1773 697 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 697 18 3 v 21 w(completion)p +510 697 V 21 w(mark)p 662 697 V 19 w(symlink)p 875 697 +V 21 w(dirs)195 752 y Fu(If)c(non-zero,)g(a)g(slash)g(will)i(b)q(e)e +(app)q(ended)i(to)d(completed)i(\014lenames)g(that)e(are)g(sym)o(b)q +(olic)j(links)195 807 y(to)11 b(directory)i(names,)f(sub)s(ject)g(to)f +(the)i(v)m(alue)g(of)f(the)g(user-settable)g Fk(mark-directories)j +Fu(v)m(ariable.)195 862 y(This)i(v)m(ariable)h(exists)f(so)g(that)e +(application)k(completion)f(functions)f(can)g(o)o(v)o(erride)g(the)f +(user's)195 917 y(global)f(preference)g(\(set)e(via)h(the)g +Fk(mark-symlink)o(ed-directories)k Fu(Readline)e(v)m(ariable\))f(if)f +(appro-)195 971 y(priate.)20 b(This)15 b(v)m(ariable)g(is)g(set)f(to)f +(the)i(user's)e(preference)j(b)q(efore)e(an)o(y)g(application)i +(completion)195 1026 y(function)j(is)g(called,)h(so)e(unless)h(that)f +(function)h(mo)q(di\014es)g(the)f(v)m(alue,)i(the)e(user's)g +(preferences)195 1081 y(are)d(honored.)1773 1191 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1191 V 21 w(ignore)p 391 1191 +V 20 w(completion)p 685 1191 V 21 w(duplicates)195 1245 +y Fu(If)15 b(non-zero,)h(then)f(duplicates)i(in)f(the)f(matc)o(hes)g +(are)g(remo)o(v)o(ed.)k(The)d(default)g(is)f(1.)1773 +1355 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p 215 1355 +V 21 w(\014lename)p 444 1355 V 20 w(completion)p 738 +1355 V 21 w(desired)195 1410 y Fu(Non-zero)c(means)g(that)f(the)h +(results)g(of)g(the)g(matc)o(hes)f(are)h(to)f(b)q(e)i(treated)e(as)g +(\014lenames.)23 b(This)195 1465 y(is)14 b Fl(always)j +Fu(zero)c(on)g(en)o(try)l(,)g(and)h(can)f(only)h(b)q(e)g(c)o(hanged)f +(within)i(a)e(completion)h(en)o(try)f(generator)195 1519 +y(function.)38 b(If)21 b(it)g(is)g(set)g(to)f(a)g(non-zero)h(v)m(alue,) +i(directory)e(names)g(ha)o(v)o(e)g(a)f(slash)h(app)q(ended)195 +1574 y(and)d(Readline)h(attempts)d(to)h(quote)g(completed)i +(\014lenames)f(if)g(they)g(con)o(tain)g(an)o(y)f(c)o(haracters)195 +1629 y(in)f Ft(rl_filename_quote_character)o(s)d Fu(and)i +Ft(rl_filename_quoting_desired)d Fu(is)k(set)f(to)f(a)195 +1684 y(non-zero)h(v)m(alue.)1773 1793 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 1793 V 21 w(\014lename)p 444 +1793 V 20 w(quoting)p 653 1793 V 21 w(desired)195 1848 +y Fu(Non-zero)14 b(means)g(that)f(the)i(results)f(of)g(the)g(matc)o +(hes)f(are)h(to)f(b)q(e)i(quoted)f(using)h(double)g(quotes)195 +1903 y(\(or)c(an)h(application-sp)q(eci\014)q(c)j(quoting)d(mec)o +(hanism\))g(if)h(the)f(completed)h(\014lename)g(con)o(tains)f(an)o(y) +195 1958 y(c)o(haracters)i(in)i Ft(rl_filename_quote_chars)p +Fu(.)h(This)f(is)f Fl(always)k Fu(non-zero)d(on)f(en)o(try)l(,)f(and)i +(can)195 2012 y(only)c(b)q(e)g(c)o(hanged)g(within)h(a)f(completion)g +(en)o(try)g(generator)e(function.)20 b(The)12 b(quoting)g(is)g +(e\013ected)195 2067 y(via)j(a)g(call)i(to)d(the)i(function)g(p)q(oin)o +(ted)g(to)e(b)o(y)h Ft(rl_filename_quoting_function)p +Fu(.)1773 2177 y(V)l(ariable)-1861 b Fi(int)20 b Fh(rl)p +215 2177 V 21 w(attempted)p 495 2177 V 20 w(completion)p +789 2177 V 21 w(o)n(v)n(er)195 2232 y Fu(If)47 b(an)g(application-sp)q +(eci\014)q(c)j(completion)e(function)g(assigned)f(to)g +Ft(rl_attempted_)195 2286 y(completion_function)24 b +Fu(sets)i(this)h(v)m(ariable)h(to)e(a)g(non-zero)h(v)m(alue,)j +(Readline)e(will)g(not)195 2341 y(p)q(erform)15 b(its)g(default)g +(\014lename)h(completion)g(ev)o(en)f(if)g(the)g(application's)h +(completion)g(function)195 2396 y(returns)f(no)g(matc)o(hes.)20 +b(It)15 b(should)h(b)q(e)g(set)f(only)h(b)o(y)f(an)g(application's)h +(completion)h(function.)1773 2506 y(V)l(ariable)-1861 +b Fi(int)20 b Fh(rl)p 215 2506 V 21 w(completion)p 510 +2506 V 21 w(t)n(yp)r(e)195 2560 y Fu(Set)e(to)e(a)i(c)o(haracter)f +(describing)i(the)e(t)o(yp)q(e)h(of)f(completion)i(Readline)g(is)f +(curren)o(tly)g(attempt-)195 2615 y(ing;)g(see)f(the)f(description)i +(of)f Ft(rl_complete_internal\(\))c Fu(\(see)k(Section)h(2.6.2)d +([Completion)195 2670 y(F)l(unctions],)g(page)g(42\))g(for)f(the)h +(list)h(of)f(c)o(haracters.)p eop %%Page: 47 49 47 48 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(47)386 149 y Ft(})338 253 y(free)23 b(\(line\);)290 -305 y(})243 357 y(exit)g(\(0\);)195 409 y(})195 513 y(/*)h(Execute)e(a) -i(command)f(line.)g(*/)195 565 y(int)195 616 y(execute_line)f(\(line\)) -314 668 y(char)i(*line;)195 720 y({)243 772 y(register)e(int)i(i;)243 +(Readline)843 b(47)1773 149 y(V)l(ariable)-1861 b Fi(int)20 +b Fh(rl)p 215 149 18 3 v 21 w(inhibit)p 399 149 V 23 +w(completion)195 204 y Fu(If)14 b(this)h(v)m(ariable)g(is)g(non-zero,)f +(completion)i(is)e(inhibited.)22 b(The)15 b(completion)g(c)o(haracter)e +(will)j(b)q(e)195 259 y(inserted)g(as)f(an)o(y)g(other)g(b)q(ound)h(to) +e Ft(self-insert)p Fu(.)75 371 y Fj(2.6.4)30 b(A)21 b(Short)f +(Completion)g(Example)137 467 y Fu(Here)11 b(is)f(a)g(small)h +(application)h(demonstrating)e(the)g(use)h(of)e(the)i(GNU)f(Readline)h +(library)l(.)19 b(It)11 b(is)f(called)75 522 y Ft(fileman)p +Fu(,)17 b(and)h(the)g(source)g(co)q(de)g(resides)h(in)f(`)p +Ft(examples/fileman.c)p Fu('.)25 b(This)18 b(sample)g(application)75 +577 y(pro)o(vides)c(completion)g(of)e(command)h(names,)g(line)i +(editing)g(features,)d(and)i(access)f(to)f(the)h(history)h(list.)p +eop +%%Page: 48 50 +48 49 bop 75 -58 a Fu(48)1299 b(GNU)15 b(Readline)h(Library)195 +149 y Ft(/*)24 b(fileman.c)e(--)i(A)g(tiny)f(application)f(which)h +(demonstrates)g(how)g(to)h(use)f(the)267 201 y(GNU)g(Readline)g +(library.)46 b(This)24 b(application)e(interactively)g(allows)h(users) +267 253 y(to)g(manipulate)g(files)g(and)g(their)g(modes.)h(*/)195 +357 y(#include)f(<stdio.h>)195 409 y(#include)g(<sys/types.h>)195 +461 y(#include)g(<sys/file.h>)195 513 y(#include)g(<sys/stat.h>)195 +565 y(#include)g(<sys/errno.h>)195 668 y(#include)g +(<readline/readline.h>)195 720 y(#include)g(<readline/history.h>)195 +824 y(extern)g(char)g(*xmalloc)g(\(\);)195 928 y(/*)h(The)f(names)g(of) +h(functions)e(that)i(actually)f(do)g(the)h(manipulation.)e(*/)195 +980 y(int)h(com_list)g(__P\(\(char)g(*\)\);)195 1032 +y(int)g(com_view)g(__P\(\(char)g(*\)\);)195 1083 y(int)g(com_rename)g +(__P\(\(char)g(*\)\);)195 1135 y(int)g(com_stat)g(__P\(\(char)g(*\)\);) +195 1187 y(int)g(com_pwd)g(__P\(\(char)g(*\)\);)195 1239 +y(int)g(com_delete)g(__P\(\(char)g(*\)\);)195 1291 y(int)g(com_help)g +(__P\(\(char)g(*\)\);)195 1343 y(int)g(com_cd)g(__P\(\(char)g(*\)\);) +195 1395 y(int)g(com_quit)g(__P\(\(char)g(*\)\);)195 +1499 y(/*)h(A)f(structure)g(which)g(contains)g(information)f(on)i(the)f +(commands)g(this)g(program)267 1550 y(can)g(understand.)f(*/)195 +1654 y(typedef)h(struct)g({)243 1706 y(char)g(*name;)g(/*)h(User)f +(printable)g(name)g(of)h(the)f(function.)g(*/)243 1758 +y(rl_icpfunc_t)f(*func;)h(/*)h(Function)e(to)i(call)f(to)h(do)f(the)h +(job.)f(*/)243 1810 y(char)g(*doc;)g(/*)h(Documentation)e(for)h(this)h +(function.)46 b(*/)195 1862 y(})24 b(COMMAND;)195 1966 +y(COMMAND)f(commands[])f(=)i({)243 2017 y({)f("cd",)h(com_cd,)f +("Change)f(to)i(directory)f(DIR")g(},)243 2069 y({)g("delete",)g +(com_delete,)f("Delete)h(FILE")h(},)243 2121 y({)f("help",)g(com_help,) +g("Display)g(this)g(text")g(},)243 2173 y({)g("?",)h(com_help,)e +("Synonym)h(for)h(`help'")f(},)243 2225 y({)g("list",)g(com_list,)g +("List)g(files)g(in)h(DIR")f(},)243 2277 y({)g("ls",)h(com_list,)e +("Synonym)h(for)g(`list'")g(},)243 2329 y({)g("pwd",)g(com_pwd,)g +("Print)g(the)h(current)f(working)g(directory")f(},)243 +2381 y({)h("quit",)g(com_quit,)g("Quit)g(using)g(Fileman")g(},)243 +2433 y({)g("rename",)g(com_rename,)f("Rename)h(FILE)h(to)f(NEWNAME")g +(},)243 2484 y({)g("stat",)g(com_stat,)g("Print)g(out)g(statistics)g +(on)h(FILE")f(},)243 2536 y({)g("view",)g(com_view,)g("View)g(the)h +(contents)e(of)i(FILE")f(},)243 2588 y({)g(\(char)h(*\)NULL,)f +(\(rl_icpfunc_t)f(*\)NULL,)h(\(char)g(*\)NULL)g(})195 +2640 y(};)p eop +%%Page: 49 51 +49 50 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(49)195 201 y Ft(/*)24 b(Forward)e(declarations.)h(*/) +195 253 y(char)g(*stripwhite)g(\(\);)195 305 y(COMMAND)g(*find_command) +f(\(\);)195 409 y(/*)i(The)f(name)g(of)h(this)f(program,)g(as)h(taken)f +(from)g(argv[0].)g(*/)195 461 y(char)g(*progname;)195 +565 y(/*)h(When)f(non-zero,)g(this)g(means)g(the)g(user)h(is)f(done)h +(using)f(this)g(program.)g(*/)195 616 y(int)g(done;)195 +720 y(char)g(*)195 772 y(dupstr)g(\(s\))314 824 y(int)h(s;)195 +876 y({)243 928 y(char)f(*r;)243 1032 y(r)g(=)h(xmalloc)f(\(strlen)g +(\(s\))g(+)h(1\);)243 1083 y(strcpy)f(\(r,)g(s\);)243 +1135 y(return)g(\(r\);)195 1187 y(})195 1291 y(main)g(\(argc,)g(argv\)) +314 1343 y(int)h(argc;)314 1395 y(char)g(**argv;)195 +1447 y({)243 1499 y(char)f(*line,)g(*s;)243 1602 y(progname)f(=)i +(argv[0];)243 1706 y(initialize_readline)d(\(\);)i(/*)h(Bind)f(our)h +(completer.)e(*/)243 1810 y(/*)h(Loop)h(reading)f(and)g(executing)g +(lines)g(until)g(the)g(user)h(quits.)f(*/)243 1862 y(for)g(\()h(;)g +(done)f(==)h(0;)f(\))290 1914 y({)338 1966 y(line)g(=)h(readline)f +(\("FileMan:)f("\);)338 2069 y(if)i(\(!line\))386 2121 +y(break;)338 2225 y(/*)g(Remove)f(leading)g(and)g(trailing)g +(whitespace)f(from)i(the)f(line.)410 2277 y(Then,)g(if)h(there)f(is)g +(anything)g(left,)g(add)h(it)f(to)h(the)f(history)g(list)410 +2329 y(and)g(execute)g(it.)h(*/)338 2381 y(s)g(=)g(stripwhite)e +(\(line\);)338 2484 y(if)i(\(*s\))386 2536 y({)434 2588 +y(add_history)e(\(s\);)434 2640 y(execute_line)g(\(s\);)p +eop +%%Page: 50 52 +50 51 bop 75 -58 a Fu(50)1299 b(GNU)15 b(Readline)h(Library)386 +149 y Ft(})338 253 y(free)23 b(\(line\);)290 305 y(})243 +357 y(exit)g(\(0\);)195 409 y(})195 513 y(/*)h(Execute)e(a)i(command)f +(line.)g(*/)195 565 y(int)195 616 y(execute_line)f(\(line\))314 +668 y(char)i(*line;)195 720 y({)243 772 y(register)e(int)i(i;)243 824 y(COMMAND)f(*command;)243 876 y(char)g(*word;)243 980 y(/*)g(Isolate)g(the)h(command)f(word.)g(*/)243 1032 y(i)g(=)h(0;)243 1083 y(while)f(\(line[i])g(&&)g(whitespace)g @@ -4101,21 +4221,22 @@ y(i)g(=)h(0;)243 1083 y(while)f(\(line[i])g(&&)g(whitespace)g (and)h(return)f(a)g(pointer)g(to)h(that)267 2588 y(command.)46 b(Return)23 b(a)h(NULL)f(pointer)g(if)h(NAME)f(isn't)g(a)h(command)f (name.)g(*/)195 2640 y(COMMAND)g(*)p eop -%%Page: 48 50 -48 49 bop 75 -58 a Fu(48)1299 b(GNU)15 b(Readline)h(Library)195 -149 y Ft(find_command)22 b(\(name\))314 201 y(char)i(*name;)195 -253 y({)243 305 y(register)e(int)i(i;)243 409 y(for)f(\(i)h(=)f(0;)h -(commands[i].name;)e(i++\))290 461 y(if)i(\(strcmp)f(\(name,)g -(commands[i].name\))f(==)h(0\))338 513 y(return)g(\(&commands[i]\);)243 -616 y(return)g(\(\(COMMAND)f(*\)NULL\);)195 668 y(})195 -772 y(/*)i(Strip)f(whitespace)f(from)i(the)f(start)g(and)h(end)f(of)h -(STRING.)46 b(Return)24 b(a)f(pointer)267 824 y(into)g(STRING.)g(*/)195 -876 y(char)g(*)195 928 y(stripwhite)f(\(string\))314 -980 y(char)i(*string;)195 1032 y({)243 1083 y(register)e(char)i(*s,)f -(*t;)243 1187 y(for)g(\(s)h(=)f(string;)g(whitespace)g(\(*s\);)g(s++\)) -290 1239 y(;)243 1343 y(if)g(\(*s)h(==)f(0\))290 1395 -y(return)g(\(s\);)243 1499 y(t)g(=)h(s)g(+)g(strlen)f(\(s\))g(-)h(1;) -243 1550 y(while)f(\(t)g(>)h(s)g(&&)g(whitespace)e(\(*t\)\))290 +%%Page: 51 53 +51 52 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(51)195 149 y Ft(find_command)22 b(\(name\))314 +201 y(char)i(*name;)195 253 y({)243 305 y(register)e(int)i(i;)243 +409 y(for)f(\(i)h(=)f(0;)h(commands[i].name;)e(i++\))290 +461 y(if)i(\(strcmp)f(\(name,)g(commands[i].name\))f(==)h(0\))338 +513 y(return)g(\(&commands[i]\);)243 616 y(return)g(\(\(COMMAND)f +(*\)NULL\);)195 668 y(})195 772 y(/*)i(Strip)f(whitespace)f(from)i(the) +f(start)g(and)h(end)f(of)h(STRING.)46 b(Return)24 b(a)f(pointer)267 +824 y(into)g(STRING.)g(*/)195 876 y(char)g(*)195 928 +y(stripwhite)f(\(string\))314 980 y(char)i(*string;)195 +1032 y({)243 1083 y(register)e(char)i(*s,)f(*t;)243 1187 +y(for)g(\(s)h(=)f(string;)g(whitespace)g(\(*s\);)g(s++\))290 +1239 y(;)243 1343 y(if)g(\(*s)h(==)f(0\))290 1395 y(return)g(\(s\);)243 +1499 y(t)g(=)h(s)g(+)g(strlen)f(\(s\))g(-)h(1;)243 1550 +y(while)f(\(t)g(>)h(s)g(&&)g(whitespace)e(\(*t\)\))290 1602 y(t--;)243 1654 y(*++t)h(=)h('\\0';)243 1758 y(return)f(s;)195 1810 y(})195 1914 y(/*)h(***********************)o(*******)o(********)o (*******)o(*******)o(********)o(****)d(*/)195 1966 y(/*)1575 @@ -4132,11 +4253,11 @@ y(complete)f(on)i(command)f(names)g(if)h(this)f(is)h(the)f(first)g (*/)195 2536 y(initialize_readline)d(\(\))195 2588 y({)243 2640 y(/*)i(Allow)g(conditional)g(parsing)g(of)g(the)h(~/.inputrc)e (file.)h(*/)p eop -%%Page: 49 51 -49 50 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(49)243 149 y Ft(rl_readline_name)21 b(=)j("FileMan";) -243 253 y(/*)f(Tell)h(the)f(completer)g(that)g(we)h(want)f(a)h(crack)f -(first.)g(*/)243 305 y(rl_attempted_completion_)o(functio)o(n)e(=)j +%%Page: 52 54 +52 53 bop 75 -58 a Fu(52)1299 b(GNU)15 b(Readline)h(Library)243 +149 y Ft(rl_readline_name)21 b(=)j("FileMan";)243 253 +y(/*)f(Tell)h(the)f(completer)g(that)g(we)h(want)f(a)h(crack)f(first.)g +(*/)243 305 y(rl_attempted_completion_)o(functio)o(n)e(=)j (fileman_completion;)195 357 y(})195 461 y(/*)g(Attempt)e(to)i (complete)f(on)g(the)h(contents)f(of)g(TEXT.)47 b(START)23 b(and)h(END)267 513 y(bound)f(the)g(region)g(of)h(rl_line_buffer)e @@ -4170,11 +4291,11 @@ y(includes)23 b(saving)g(the)h(length)f(of)g(TEXT)h(for)f(efficiency,)f 243 2381 y(if)g(\(!state\))290 2433 y({)338 2484 y(list_index)g(=)g(0;) 338 2536 y(len)h(=)f(strlen)g(\(text\);)290 2588 y(})p eop -%%Page: 50 52 -50 51 bop 75 -58 a Fu(50)1299 b(GNU)15 b(Readline)h(Library)243 -149 y Ft(/*)23 b(Return)g(the)h(next)f(name)g(which)h(partially)e -(matches)h(from)g(the)314 201 y(command)g(list.)g(*/)243 -253 y(while)g(\(name)g(=)h(commands[list_index].name)o(\))290 +%%Page: 53 55 +53 54 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(53)243 149 y Ft(/*)23 b(Return)g(the)h(next)f(name)g +(which)h(partially)e(matches)h(from)g(the)314 201 y(command)g(list.)g +(*/)243 253 y(while)g(\(name)g(=)h(commands[list_index].name)o(\))290 305 y({)338 357 y(list_index++;)338 461 y(if)g(\(strncmp)f(\(name,)g (text,)g(len\))g(==)h(0\))386 513 y(return)f(\(dupstr\(name\)\);)290 565 y(})243 668 y(/*)g(If)h(no)f(names)h(matched,)e(then)i(return)f @@ -4198,20 +4319,19 @@ b(This)24 b(is)f(for)h(the)f(LIST,)g(VIEW)h(and)f(RENAME)267 (arg\);)243 2329 y(return)g(\(system)g(\(syscom\)\);)195 2381 y(})195 2484 y(com_rename)f(\(arg\))314 2536 y(char)i(*arg;)195 2588 y({)243 2640 y(too_dangerous)e(\("rename"\);)p eop -%%Page: 51 53 -51 52 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(51)243 149 y Ft(return)23 b(\(1\);)195 -201 y(})195 305 y(com_stat)g(\(arg\))314 357 y(char)h(*arg;)195 -409 y({)243 461 y(struct)f(stat)g(finfo;)243 565 y(if)g -(\(!valid_argument)f(\("stat",)h(arg\)\))290 616 y(return)g(\(1\);)243 -720 y(if)g(\(stat)g(\(arg,)h(&finfo\))f(==)g(-1\))290 -772 y({)338 824 y(perror)g(\(arg\);)338 876 y(return)g(\(1\);)290 -928 y(})243 1032 y(printf)g(\("Statistics)f(for)h(`\045s':\\n",)g -(arg\);)243 1135 y(printf)g(\("\045s)g(has)h(\045d)f(link\045s,)g(and)g -(is)h(\045d)g(byte\045s)f(in)g(length.\\n",)g(arg,)434 -1187 y(finfo.st_nlink,)434 1239 y(\(finfo.st_nlink)e(==)j(1\))g(?)f("") -h(:)g("s",)434 1291 y(finfo.st_size,)434 1343 y(\(finfo.st_size)e(==)h -(1\))h(?)f("")h(:)g("s"\);)243 1395 y(printf)f(\("Inode)g(Last)g +%%Page: 54 56 +54 55 bop 75 -58 a Fu(54)1299 b(GNU)15 b(Readline)h(Library)243 +149 y Ft(return)23 b(\(1\);)195 201 y(})195 305 y(com_stat)g(\(arg\)) +314 357 y(char)h(*arg;)195 409 y({)243 461 y(struct)f(stat)g(finfo;)243 +565 y(if)g(\(!valid_argument)f(\("stat",)h(arg\)\))290 +616 y(return)g(\(1\);)243 720 y(if)g(\(stat)g(\(arg,)h(&finfo\))f(==)g +(-1\))290 772 y({)338 824 y(perror)g(\(arg\);)338 876 +y(return)g(\(1\);)290 928 y(})243 1032 y(printf)g(\("Statistics)f(for)h +(`\045s':\\n",)g(arg\);)243 1135 y(printf)g(\("\045s)g(has)h(\045d)f +(link\045s,)g(and)g(is)h(\045d)g(byte\045s)f(in)g(length.\\n",)g(arg,) +434 1187 y(finfo.st_nlink,)434 1239 y(\(finfo.st_nlink)e(==)j(1\))g(?)f +("")h(:)g("s",)434 1291 y(finfo.st_size,)434 1343 y(\(finfo.st_size)e +(==)h(1\))h(?)f("")h(:)g("s"\);)243 1395 y(printf)f(\("Inode)g(Last)g (Change)g(at:)g(\045s",)h(ctime)f(\(&finfo.st_ctime\)\);)243 1447 y(printf)g(\(")143 b(Last)23 b(access)g(at:)g(\045s",)h(ctime)f (\(&finfo.st_atime\)\);)243 1499 y(printf)g(\(")95 b(Last)23 @@ -4226,20 +4346,20 @@ b(modified)g(at:)g(\045s",)h(ctime)f(\(&finfo.st_mtime\)\);)243 (0;)243 2484 y(for)f(\(i)h(=)f(0;)h(commands[i].name;)e(i++\))290 2536 y({)338 2588 y(if)i(\(!*arg)f(||)g(\(strcmp)g(\(arg,)g (commands[i].name\))f(==)i(0\)\))386 2640 y({)p eop -%%Page: 52 54 -52 53 bop 75 -58 a Fu(52)1299 b(GNU)15 b(Readline)h(Library)434 -149 y Ft(printf)23 b(\("\045s\\t\\t\045s.\\n",)e(commands[i].name,)h -(commands[i].doc\);)434 201 y(printed++;)386 253 y(})290 -305 y(})243 409 y(if)h(\(!printed\))290 461 y({)338 513 -y(printf)g(\("No)h(commands)e(match)h(`\045s'.)48 b(Possibilties)22 -b(are:\\n",)h(arg\);)338 616 y(for)h(\(i)f(=)h(0;)g(commands[i].name;)d -(i++\))386 668 y({)434 720 y(/*)i(Print)g(in)h(six)f(columns.)g(*/)434 -772 y(if)g(\(printed)g(==)h(6\))481 824 y({)529 876 y(printed)f(=)h(0;) -529 928 y(printf)f(\("\\n"\);)481 980 y(})434 1083 y(printf)g -(\("\045s\\t",)f(commands[i].name\);)434 1135 y(printed++;)386 -1187 y(})338 1291 y(if)i(\(printed\))386 1343 y(printf)f(\("\\n"\);)290 -1395 y(})243 1447 y(return)g(\(0\);)195 1499 y(})195 -1602 y(/*)h(Change)f(to)g(the)h(directory)e(ARG.)i(*/)195 +%%Page: 55 57 +55 56 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g +(Readline)843 b(55)434 149 y Ft(printf)23 b(\("\045s\\t\\t\045s.\\n",)e +(commands[i].name,)h(commands[i].doc\);)434 201 y(printed++;)386 +253 y(})290 305 y(})243 409 y(if)h(\(!printed\))290 461 +y({)338 513 y(printf)g(\("No)h(commands)e(match)h(`\045s'.)48 +b(Possibilties)22 b(are:\\n",)h(arg\);)338 616 y(for)h(\(i)f(=)h(0;)g +(commands[i].name;)d(i++\))386 668 y({)434 720 y(/*)i(Print)g(in)h(six) +f(columns.)g(*/)434 772 y(if)g(\(printed)g(==)h(6\))481 +824 y({)529 876 y(printed)f(=)h(0;)529 928 y(printf)f(\("\\n"\);)481 +980 y(})434 1083 y(printf)g(\("\045s\\t",)f(commands[i].name\);)434 +1135 y(printed++;)386 1187 y(})338 1291 y(if)i(\(printed\))386 +1343 y(printf)f(\("\\n"\);)290 1395 y(})243 1447 y(return)g(\(0\);)195 +1499 y(})195 1602 y(/*)h(Change)f(to)g(the)h(directory)e(ARG.)i(*/)195 1654 y(com_cd)f(\(arg\))314 1706 y(char)h(*arg;)195 1758 y({)243 1810 y(if)f(\(chdir)g(\(arg\))h(==)f(-1\))290 1862 y({)338 1914 y(perror)g(\(arg\);)338 1966 y(return)g(1;)290 @@ -4249,35 +4369,32 @@ y({)243 1810 y(if)f(\(chdir)g(\(arg\))h(==)f(-1\))290 2433 y(char)h(*ignore;)195 2484 y({)243 2536 y(char)f(dir[1024],)g(*s;) 243 2640 y(s)g(=)h(getcwd)f(\(dir,)g(sizeof\(dir\))g(-)g(1\);)p eop -%%Page: 53 55 -53 54 bop 75 -58 a Fu(Chapter)15 b(2:)k(Programming)c(with)g(GNU)g -(Readline)843 b(53)243 149 y Ft(if)23 b(\(s)h(==)f(0\))290 -201 y({)338 253 y(printf)g(\("Error)g(getting)g(pwd:)g(\045s\\n",)g -(dir\);)338 305 y(return)g(1;)290 357 y(})243 461 y(printf)g -(\("Current)f(directory)h(is)h(\045s\\n",)f(dir\);)243 -513 y(return)g(0;)195 565 y(})195 668 y(/*)h(The)f(user)g(wishes)g(to)h -(quit)f(using)g(this)h(program.)46 b(Just)24 b(set)f(DONE)267 -720 y(non-zero.)f(*/)195 772 y(com_quit)h(\(arg\))314 -824 y(char)h(*arg;)195 876 y({)243 928 y(done)f(=)h(1;)243 -980 y(return)f(\(0\);)195 1032 y(})195 1135 y(/*)h(Function)e(which)i -(tells)f(you)g(that)g(you)h(can't)f(do)h(this.)f(*/)195 -1187 y(too_dangerous)f(\(caller\))314 1239 y(char)i(*caller;)195 -1291 y({)243 1343 y(fprintf)f(\(stderr,)457 1395 y("\045s:)h(Too)f -(dangerous)g(for)g(me)h(to)g(distribute.)46 b(Write)23 -b(it)h(yourself.\\n",)p 1987 1405 21 42 v 457 1447 a(caller\);)195 -1499 y(})195 1602 y(/*)g(Return)f(non-zero)f(if)i(ARG)f(is)h(a)g(valid) -f(argument)g(for)g(CALLER,)g(else)g(print)267 1654 y(an)g(error)g -(message)g(and)h(return)f(zero.)g(*/)195 1706 y(int)195 -1758 y(valid_argument)f(\(caller,)h(arg\))314 1810 y(char)h(*caller,)e -(*arg;)195 1862 y({)243 1914 y(if)h(\(!arg)g(||)h(!*arg\))290 -1966 y({)338 2017 y(fprintf)f(\(stderr,)g("\045s:)g(Argument)g -(required.\\n",)f(caller\);)338 2069 y(return)h(\(0\);)290 -2121 y(})243 2225 y(return)g(\(1\);)195 2277 y(})p eop -%%Page: 54 56 -54 55 bop 75 -58 a Fu(54)1299 b(GNU)15 b(Readline)h(Library)p -eop -%%Page: 55 57 -55 56 bop 75 -58 a Fu(Concept)15 b(Index)1466 b(55)75 +%%Page: 56 58 +56 57 bop 75 -58 a Fu(56)1299 b(GNU)15 b(Readline)h(Library)243 +149 y Ft(if)23 b(\(s)h(==)f(0\))290 201 y({)338 253 y(printf)g +(\("Error)g(getting)g(pwd:)g(\045s\\n",)g(dir\);)338 +305 y(return)g(1;)290 357 y(})243 461 y(printf)g(\("Current)f +(directory)h(is)h(\045s\\n",)f(dir\);)243 513 y(return)g(0;)195 +565 y(})195 668 y(/*)h(The)f(user)g(wishes)g(to)h(quit)f(using)g(this)h +(program.)46 b(Just)24 b(set)f(DONE)267 720 y(non-zero.)f(*/)195 +772 y(com_quit)h(\(arg\))314 824 y(char)h(*arg;)195 876 +y({)243 928 y(done)f(=)h(1;)243 980 y(return)f(\(0\);)195 +1032 y(})195 1135 y(/*)h(Function)e(which)i(tells)f(you)g(that)g(you)h +(can't)f(do)h(this.)f(*/)195 1187 y(too_dangerous)f(\(caller\))314 +1239 y(char)i(*caller;)195 1291 y({)243 1343 y(fprintf)f(\(stderr,)457 +1395 y("\045s:)h(Too)f(dangerous)g(for)g(me)h(to)g(distribute.\\n")457 +1447 y(caller\);)243 1499 y(fprintf)f(\(stderr,)f("Write)h(it)h +(yourself.\\n"\);)195 1550 y(})195 1654 y(/*)g(Return)f(non-zero)f(if)i +(ARG)f(is)h(a)g(valid)f(argument)g(for)g(CALLER,)267 +1706 y(else)g(print)g(an)h(error)f(message)g(and)g(return)g(zero.)g(*/) +195 1758 y(int)195 1810 y(valid_argument)f(\(caller,)h(arg\))314 +1862 y(char)h(*caller,)e(*arg;)195 1914 y({)243 1966 +y(if)h(\(!arg)g(||)h(!*arg\))290 2017 y({)338 2069 y(fprintf)f +(\(stderr,)g("\045s:)g(Argument)g(required.\\n",)f(caller\);)338 +2121 y(return)h(\(0\);)290 2173 y(})243 2277 y(return)g(\(1\);)195 +2329 y(})p eop +%%Page: 57 59 +57 58 bop 75 -58 a Fu(Concept)15 b(Index)1466 b(57)75 149 y Fq(Concept)27 b(Index)75 321 y Fs(C)75 382 y Ff(command)14 b(editing)e Fe(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)22 @@ -4300,35 +4417,35 @@ y Fs(N)1012 390 y Ff(notation,)15 b(readline)7 b Fe(.)h(.)e(.)g(.)g(.)g g(.)h(.)f(.)g(.)g(.)g(.)20 b Ff(1)1012 539 y Fs(R)1012 608 y Ff(readline,)15 b(function)8 b Fe(.)g(.)e(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)21 b Ff(19)1012 757 y Fs(V)1012 826 y Ff(v)n(ariables,)15 +f(.)g(.)21 b Ff(21)1012 757 y Fs(V)1012 826 y Ff(v)n(ariables,)15 b(readline)t Fe(.)9 b(.)d(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)17 b Ff(4)1012 976 y Fs(Y)1012 1044 y Ff(y)o(anking)e(text)t Fe(.)7 b(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)17 b Ff(2)p eop -%%Page: 56 58 -56 57 bop 75 -58 a Fu(56)1299 b(GNU)15 b(Readline)h(Library)p +%%Page: 58 60 +58 59 bop 75 -58 a Fu(58)1299 b(GNU)15 b(Readline)h(Library)p eop -%%Page: 57 59 -57 58 bop 75 -58 a Fu(F)l(unction)16 b(and)f(V)l(ariable)i(Index)1187 -b(57)75 149 y Fq(F)-7 b(unction)26 b(and)h(V)-7 b(ariable)26 +%%Page: 59 61 +59 60 bop 75 -58 a Fu(F)l(unction)16 b(and)f(V)l(ariable)i(Index)1187 +b(59)75 149 y Fq(F)-7 b(unction)26 b(and)h(V)-7 b(ariable)26 b(Index)p 79 307 21 3 v 75 369 a Fd(_rl_digit_)o(p)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 -b Ff(34)75 415 y Fd(_rl_digit_)o(va)o(lue)6 b Fe(.)t(.)g(.)g(.)g(.)g(.) +b Ff(36)75 415 y Fd(_rl_digit_)o(va)o(lue)6 b Fe(.)t(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)20 b Ff(34)75 462 y Fd(_rl_lowerc)o(as)o(e_p)6 +(.)g(.)h(.)f(.)g(.)20 b Ff(37)75 462 y Fd(_rl_lowerc)o(as)o(e_p)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)20 b Ff(34)75 +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)20 b Ff(36)75 508 y Fd(_rl_to_low)o(er)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)22 b Ff(34)75 554 y Fd(_rl_to_upp)o(er)6 +g(.)h(.)f(.)22 b Ff(36)75 554 y Fd(_rl_to_upp)o(er)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)22 -b Ff(34)75 600 y Fd(_rl_upperc)o(as)o(e_p)6 b Fe(.)t(.)g(.)g(.)g(.)g(.) +b Ff(36)75 600 y Fd(_rl_upperc)o(as)o(e_p)6 b Fe(.)t(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)20 b Ff(34)75 733 y Fs(A)75 794 y +(.)g(.)h(.)f(.)g(.)20 b Ff(36)75 733 y Fs(A)75 794 y Fd(abort)11 b(\(C-g\))5 b Fe(.)t(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)17 b Ff(17)75 841 y Fd(accept-lin)o(e)10 @@ -4359,10 +4476,10 @@ g(.)g(.)g(.)g(.)h(.)f(.)18 b Ff(17)75 1598 y Fd(capitalize)o(-w)o(ord)9 b(\(M-c\))d Fe(.)f(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)19 b Ff(14)75 1644 y Fd(character-)o(se) o(arc)o(h)10 b(\(C-]\))c Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)18 b Ff(17)75 +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)18 b Ff(18)75 1691 y Fd(character-)o(se)o(arc)o(h-)o(bac)o(kwa)o(rd)9 b(\(M-C-]\))e Fe(.)s(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)20 -b Ff(17)75 1737 y Fd(clear-scre)o(en)9 b(\(C-l\))g Fe(.)t(.)d(.)g(.)g +b Ff(18)75 1737 y Fd(clear-scre)o(en)9 b(\(C-l\))g Fe(.)t(.)d(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) g(.)h(.)f(.)21 b Ff(12)75 1783 y(commen)o(t-b)q(egin)9 b Fe(.)f(.)e(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) @@ -4380,7 +4497,7 @@ b Ff(5)75 1968 y Fd(copy-backw)o(ar)o(d-w)o(or)o(d)10 b(\(\))c Fe(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)19 b Ff(15)75 2014 y Fd(copy-forwa)o(rd)o (-wo)o(rd)9 b(\(\))e Fe(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(15)75 +(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(16)75 2060 y Fd(copy-regio)o(n-)o(as-)o(ki)o(ll)9 b(\(\))d Fe(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)18 b Ff(15)75 2193 y Fs(D)75 2255 y Fd(delete-cha)o(r)10 @@ -4388,11 +4505,11 @@ b(\(C-d\))d Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(14)75 2301 y Fd(delete-cha)o(r-)o(or-)o(li)o(st)9 b(\(\))d Fe(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)18 b Ff(16)75 2347 y Fd(delete-hor)o(iz)o(ont)o(al)o +(.)g(.)g(.)h(.)18 b Ff(17)75 2347 y Fd(delete-hor)o(iz)o(ont)o(al)o (-sp)o(ace)9 b(\(\))i Fe(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)25 b Ff(15)75 2393 y Fd(digit-argu)o(me)o(nt)9 b(\()p Fc(M-0)p Fd(,)i Fc(M-1)p Fd(,)h(...)f Fc(M--)p -Fd(\))c Fe(.)e(.)h(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(15)75 +Fd(\))c Fe(.)e(.)h(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(16)75 2439 y(disable-comple)q(tion)9 b Fe(.)g(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)21 b Ff(5)75 2486 y Fd(do-upperca)o(se)o(-ve)o(rs)o(ion)9 @@ -4409,518 +4526,538 @@ Fe(.)c(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)24 b Ff(18)1012 307 y Fd(dump-variab)o(le)o(s)10 b(\(\))e Fe(.)e(.)h(.)f(.)g(.)g(.)g(.) g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)23 b Ff(18)1012 457 y Fs(E)1012 525 y Ff(editing-mo)q(de)12 +(.)g(.)23 b Ff(18)1012 449 y Fs(E)1012 514 y Ff(editing-mo)q(de)12 b Fe(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)22 -b Ff(5)1012 575 y(enable-k)o(eypad)9 b Fe(.)g(.)d(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(5)1012 624 y Fd(end-kbd-mac)o(ro)9 -b(\(C-x)i(\)\))e Fe(.)e(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)23 b Ff(16)1012 673 -y Fd(end-of-hist)o(or)o(y)10 b(\(M->\))d Fe(.)t(.)f(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)20 -b Ff(13)1012 723 y Fd(end-of-line)9 b(\(C-e\))e Fe(.)f(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)23 b Ff(12)1012 772 y Fd(exchange-po)o(in)o(t-a)o(nd)o(-ma) -o(rk)9 b(\(C-x)j(C-x\))c Fe(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)24 -b Ff(17)1012 821 y(expand-tilde)6 b Fe(.)j(.)d(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)19 b Ff(5)1012 970 y -Fs(F)1012 1038 y Fd(forward-bac)o(kw)o(ard)o(-d)o(ele)o(te)o(-ch)o(ar)9 +b Ff(5)1012 562 y Fd(emacs-editi)o(ng)o(-mo)o(de)9 b(\(C-e\))t +Fe(.)c(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)18 b Ff(18)1012 610 y(enable-k)o(eypad)9 b Fe(.)g(.)d(.)h(.)f(.) +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(5)1012 +658 y Fd(end-kbd-mac)o(ro)9 b(\(C-x)i(\)\))e Fe(.)e(.)f(.)g(.)g(.)g(.)g +(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)23 +b Ff(17)1012 706 y Fd(end-of-hist)o(or)o(y)10 b(\(M->\))d +Fe(.)t(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)h(.)20 b Ff(13)1012 754 y Fd(end-of-line)9 +b(\(C-e\))e Fe(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)23 b Ff(12)1012 +802 y Fd(exchange-po)o(in)o(t-a)o(nd)o(-ma)o(rk)9 b(\(C-x)j(C-x\))c +Fe(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)24 b Ff(18)1012 +850 y(expand-tilde)6 b Fe(.)j(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)19 b Ff(5)1012 991 y Fs(F)1012 1056 +y Fd(forward-bac)o(kw)o(ard)o(-d)o(ele)o(te)o(-ch)o(ar)9 b(\(\))f Fe(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)22 -b Ff(14)1012 1088 y Fd(forward-cha)o(r)10 b(\(C-f\))f +b Ff(14)1012 1104 y Fd(forward-cha)o(r)10 b(\(C-f\))f Fe(.)s(.)e(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(12)1012 1137 y +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(12)1012 1152 y Fd(forward-sea)o(rc)o(h-h)o(is)o(tor)o(y)10 b(\(C-s\))e Fe(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)24 -b Ff(13)1012 1186 y Fd(forward-wor)o(d)10 b(\(M-f\))f +b Ff(13)1012 1200 y Fd(forward-wor)o(d)10 b(\(M-f\))f Fe(.)s(.)e(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(12)1012 1328 y -Fs(H)1012 1397 y Ff(history-preserv)o(e-p)q(oi)q(n)o(t)8 +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(12)1012 1334 y +Fs(H)1012 1400 y Ff(history-preserv)o(e-p)q(oi)q(n)o(t)8 b Fe(.)h(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)21 b Ff(5)1012 1446 y +f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)21 b Ff(5)1012 1448 y Fd(history-sea)o(rc)o(h-b)o(ac)o(kwa)o(rd)9 b(\(\))i Fe(.)c(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)25 b Ff(13)1012 1496 y Fd(history-sea)o(rc)o(h-f)o(or)o(war)o(d)10 b(\(\))s Fe(.)c(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)17 b Ff(13)1012 1545 y(horizon)o(tal-scrol)q(l-mo)r(de)6 +(.)g(.)g(.)17 b Ff(13)1012 1543 y(horizon)o(tal-scrol)q(l-mo)r(de)6 b Fe(.)j(.)d(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b Ff(6)1012 1687 y -Fs(I)1012 1755 y Ff(input-meta)8 b Fe(.)g(.)e(.)g(.)g(.)g(.)h(.)f(.)g +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b Ff(6)1012 1678 y +Fs(I)1012 1743 y Ff(input-meta)8 b Fe(.)g(.)e(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(6)1012 1805 +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(6)1012 1791 y Fd(insert-comm)o(en)o(t)10 b(\(M-#\))d Fe(.)t(.)f(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)20 -b Ff(17)1012 1854 y Fd(insert-comp)o(le)o(tio)o(ns)9 +b Ff(18)1012 1839 y Fd(insert-comp)o(le)o(tio)o(ns)9 b(\(M-*\))t Fe(.)c(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)18 b Ff(16)1012 1903 y(isearc)o(h-terminators)t +(.)g(.)g(.)g(.)g(.)18 b Ff(16)1012 1887 y(isearc)o(h-terminators)t Fe(.)8 b(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)16 b Ff(6)1012 -2046 y Fs(K)1012 2114 y Ff(k)o(eymap)9 b Fe(.)e(.)f(.)h(.)f(.)g(.)g(.)g +2021 y Fs(K)1012 2087 y Ff(k)o(eymap)9 b Fe(.)e(.)f(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 -b Ff(6)1012 2163 y Fd(kill-line)10 b(\(C-k\))f Fe(.)d(.)g(.)g(.)g(.)g +b Ff(6)1012 2135 y Fd(kill-line)10 b(\(C-k\))f Fe(.)d(.)g(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)24 b Ff(14)1012 2213 y Fd(kill-region)9 +g(.)g(.)h(.)f(.)g(.)24 b Ff(15)1012 2183 y Fd(kill-region)9 b(\(\))i Fe(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 -b Ff(15)1012 2262 y Fd(kill-whole-)o(li)o(ne)9 b(\(\))g +b Ff(15)1012 2231 y Fd(kill-whole-)o(li)o(ne)9 b(\(\))g Fe(.)c(.)i(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(15)1012 2311 y +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 b Ff(15)1012 2278 y Fd(kill-word)10 b(\(M-d\))f Fe(.)d(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -24 b Ff(15)1012 2454 y Fs(M)1012 2522 y Ff(mark-mo)q(di\014ed-li)q(nes) +24 b Ff(15)1012 2413 y Fs(M)1012 2478 y Ff(mark-mo)q(di\014ed-li)q(nes) 8 b Fe(.)h(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(6)1012 -2571 y(matc)o(h-hidden-\014l)q(es)14 b Fe(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)24 b Ff(6)1012 2621 y Fd(menu-comple)o(te)9 -b(\(\))g Fe(.)e(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(16)1012 -2670 y(meta-\015ag)t Fe(.)8 b(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)18 b Ff(6)p eop -%%Page: 58 60 -58 59 bop 75 -58 a Fu(58)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fs(N)75 212 y Fd(next-histo)o(ry)9 b(\(C-n\))g +2526 y(mark-symlink)o(ed-di)q(rectori)q(es)14 b Fe(.)6 +b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g +(.)h(.)23 b Ff(6)1012 2574 y(matc)o(h-hidden-\014l)q(es)14 +b Fe(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)24 b Ff(6)1012 +2622 y Fd(menu-comple)o(te)9 b(\(\))g Fe(.)e(.)f(.)g(.)g(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g +(.)h(.)23 b Ff(16)1012 2670 y(meta-\015ag)t Fe(.)8 b(.)e(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)18 +b Ff(6)p eop +%%Page: 60 62 +60 61 bop 75 -58 a Fu(60)1299 b(GNU)15 b(Readline)h(Library)75 +149 y Fs(N)75 210 y Fd(next-histo)o(ry)9 b(\(C-n\))g Fe(.)t(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)21 b Ff(12)75 258 y Fd(non-increm)o(en)o +(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)21 b Ff(13)75 256 y Fd(non-increm)o(en)o (tal)o(-f)o(orw)o(ard)o(-s)o(ear)o(ch)o(-hi)o(st)o(ory)9 -b(\(M-n\))159 304 y Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f +b(\(M-n\))159 302 y Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 b Ff(13)75 -350 y Fd(non-increm)o(en)o(tal)o(-r)o(eve)o(rse)o(-s)o(ear)o(ch)o(-hi)o -(st)o(ory)9 b(\(M-p\))159 396 y Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g +347 y Fd(non-increm)o(en)o(tal)o(-r)o(eve)o(rse)o(-s)o(ear)o(ch)o(-hi)o +(st)o(ory)9 b(\(M-p\))159 393 y Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 -b Ff(13)75 521 y Fs(O)75 583 y Ff(output-meta)5 b Fe(.)i(.)f(.)h(.)f(.) +b Ff(13)75 515 y Fs(O)75 576 y Ff(output-meta)5 b Fe(.)i(.)f(.)h(.)f(.) g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)18 b Ff(6)75 -716 y Fs(P)75 778 y Fd(possible-c)o(om)o(ple)o(ti)o(ons)9 +622 y Fd(overwrite-)o(mo)o(de)9 b(\(\))g Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) +g(.)22 b Ff(15)75 744 y Fs(P)75 805 y Ff(page-completions)14 +b Fe(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)23 +b Ff(7)75 851 y Fd(possible-c)o(om)o(ple)o(ti)o(ons)9 b(\(M-?\))h Fe(.)c(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)25 b Ff(16)75 824 y Fd(prefix-met)o(a)10 b(\()324 -822 y Fn(h)p 335 796 70 2 v 335 824 a Fm(ESC)p 335 832 -V 402 822 a Fn(i)417 824 y Fd(\))g Fe(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g +(.)g(.)25 b Ff(16)75 897 y Fd(prefix-met)o(a)10 b(\()324 +895 y Fn(h)p 335 868 70 2 v 335 897 a Fm(ESC)p 335 904 +V 402 895 a Fn(i)417 897 y Fd(\))g Fe(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)23 -b Ff(17)75 870 y Fd(previous-h)o(is)o(tor)o(y)10 b(\(C-p\))c +b Ff(17)75 942 y Fd(previous-h)o(is)o(tor)o(y)10 b(\(C-p\))c Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)18 b Ff(12)75 1004 y Fs(Q)75 1066 y Fd(quoted-ins)o(er)o +(.)g(.)g(.)h(.)18 b Ff(12)75 1072 y Fs(Q)75 1133 y Fd(quoted-ins)o(er)o (t)10 b(\(C-q)h(or)h(C-v\))c Fe(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(14)75 1199 y Fs(R)75 -1261 y Fd(re-read-in)o(it)o(-fi)o(le)9 b(\(C-x)i(C-r\))5 +(.)g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(14)75 1263 y Fs(R)75 +1323 y Fd(re-read-in)o(it)o(-fi)o(le)9 b(\(C-x)i(C-r\))5 b Fe(.)h(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)18 -b Ff(17)75 1307 y Fd(readline)s Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.) +b Ff(17)75 1369 y Fd(readline)s Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)16 b Ff(19)75 -1354 y Fd(redraw-cur)o(re)o(nt-)o(li)o(ne)9 b(\(\))d +(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)16 b Ff(21)75 +1415 y Fd(redraw-cur)o(re)o(nt-)o(li)o(ne)9 b(\(\))d Fe(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)18 b Ff(12)75 1400 y Fd(reverse-se)o(ar)o(ch-)o(hi)o +(.)g(.)g(.)h(.)18 b Ff(12)75 1461 y Fd(reverse-se)o(ar)o(ch-)o(hi)o (sto)o(ry)9 b(\(C-r\))g Fe(.)d(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)23 b Ff(13)75 1446 y Fd(revert-lin)o(e)10 +(.)f(.)g(.)23 b Ff(13)75 1506 y Fd(revert-lin)o(e)10 b(\(M-r\))d Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(17)75 -1493 y Fd(rl_add_def)o(un)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) +1552 y Fd(rl_add_def)o(un)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)22 b Ff(26)75 1539 y Fd(rl_add_fun)o(ma)o(p_e)o(nt)o(ry) +(.)g(.)h(.)f(.)22 b Ff(28)75 1598 y Fd(rl_add_fun)o(ma)o(p_e)o(nt)o(ry) t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(29)75 1585 y Fd(rl_add_und)o(o)7 +(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(31)75 1643 y Fd(rl_add_und)o(o)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 -b Ff(30)75 1632 y Fd(rl_alphabe)o(ti)o(c)9 b Fe(.)s(.)d(.)g(.)g(.)h(.)f +b Ff(32)75 1689 y Fd(rl_alphabe)o(ti)o(c)9 b Fe(.)s(.)d(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)22 b Ff(33)75 1678 y Fd(rl_already)o(_p)o(rom)o +h(.)f(.)g(.)g(.)g(.)g(.)22 b Ff(36)75 1735 y Fd(rl_already)o(_p)o(rom)o (pt)o(ed)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(23)75 -1724 y Fd(rl_attempt)o(ed)o(_co)o(mp)o(let)o(ion)o(_f)o(unc)o(ti)o(on)t -Fe(.)s(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)17 b Ff(41)75 -1771 y Fd(rl_attempt)o(ed)o(_co)o(mp)o(let)o(ion)o(_o)o(ver)6 +(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(25)75 +1781 y Fd(rl_attempt)o(ed)o(_co)o(mp)o(let)o(ion)o(_f)o(unc)o(ti)o(on)t +Fe(.)s(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)17 b Ff(43)75 +1826 y Fd(rl_attempt)o(ed)o(_co)o(mp)o(let)o(ion)o(_o)o(ver)6 b Fe(.)s(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 -b Ff(43)75 1817 y Fd(rl_basic_q)o(uo)o(te_)o(ch)o(ara)o(cte)o(rs)8 +b Ff(46)75 1872 y Fd(rl_basic_q)o(uo)o(te_)o(ch)o(ara)o(cte)o(rs)8 b Fe(.)t(.)e(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -22 b Ff(42)75 1863 y Fd(rl_basic_w)o(or)o(d_b)o(re)o(ak_)o(cha)o(ra)o +22 b Ff(45)75 1918 y Fd(rl_basic_w)o(or)o(d_b)o(re)o(ak_)o(cha)o(ra)o (cte)o(rs)5 b Fe(.)s(.)h(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)18 -b Ff(42)75 1910 y Fd(rl_begin_u)o(nd)o(o_g)o(ro)o(up)t +b Ff(45)75 1964 y Fd(rl_begin_u)o(nd)o(o_g)o(ro)o(up)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(30)75 1956 y Fd(rl_bind_ke)o(y)7 +g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(32)75 2009 y Fd(rl_bind_ke)o(y)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 -b Ff(27)75 2002 y Fd(rl_bind_ke)o(y_)o(in_)o(ma)o(p)5 +b Ff(30)75 2055 y Fd(rl_bind_ke)o(y_)o(in_)o(ma)o(p)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(27)75 2049 y +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(30)75 2101 y Fd(rl_binding)o(_k)o(eym)o(ap)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 -b Ff(24)75 2095 y Fd(rl_callbac)o(k_)o(han)o(dl)o(er_)o(ins)o(ta)o(ll)7 +b Ff(27)75 2146 y Fd(rl_callbac)o(k_)o(han)o(dl)o(er_)o(ins)o(ta)o(ll)7 b Fe(.)s(.)g(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)20 -b Ff(35)75 2141 y Fd(rl_callbac)o(k_)o(han)o(dl)o(er_)o(rem)o(ov)o(e)8 +b Ff(38)75 2192 y Fd(rl_callbac)o(k_)o(han)o(dl)o(er_)o(rem)o(ov)o(e)8 b Fe(.)t(.)e(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)21 -b Ff(35)75 2188 y Fd(rl_callbac)o(k_)o(rea)o(d_)o(cha)o(r)9 +b Ff(38)75 2238 y Fd(rl_callbac)o(k_)o(rea)o(d_)o(cha)o(r)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)25 b Ff(35)75 2234 y Fd(rl_catch_s)o(ig)o(nal)o(s)6 +f(.)g(.)g(.)g(.)25 b Ff(38)75 2284 y Fd(rl_catch_s)o(ig)o(nal)o(s)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(37)75 -2281 y Fd(rl_catch_s)o(ig)o(win)o(ch)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(40)75 +2329 y Fd(rl_catch_s)o(ig)o(win)o(ch)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)19 b Ff(37)75 2327 y Fd(rl_char_is)o(_q)o(uot)o(ed)o(_p)t +g(.)19 b Ff(40)75 2375 y Fd(rl_char_is)o(_q)o(uot)o(ed)o(_p)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(41)75 2373 y Fd(rl_cleanup)o(_a)o +g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(44)75 2421 y Fd(rl_cleanup)o(_a)o (fte)o(r_)o(sig)o(nal)7 b Fe(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(37)75 2420 y +h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(40)75 2467 y Fd(rl_clear_m)o(es)o(sag)o(e)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -19 b Ff(31)75 2466 y Fd(rl_clear_p)o(en)o(din)o(g_)o(inp)o(ut)8 +19 b Ff(33)75 2512 y Fd(rl_clear_p)o(en)o(din)o(g_)o(inp)o(ut)8 b Fe(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)24 b Ff(32)75 2512 y Fd(rl_clear_s)o(ig)o(nal)o(s)6 -b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(38)1012 -149 y Fd(rl_complete)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -20 b Ff(39,)13 b(40)1012 196 y Fd(rl_complete)o(_i)o(nte)o(rn)o(al)s +h(.)f(.)g(.)24 b Ff(35)1012 149 y Fd(rl_clear_si)o(gn)o(als)6 +b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(41)1012 +196 y Fd(rl_complete)6 b Fe(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) +g(.)g(.)g(.)24 b Ff(42)1012 242 y Fd(rl_complete)o(_i)o(nte)o(rn)o(al)s Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)17 b Ff(40)1012 242 y Fd(rl_complete)o(r_)o +g(.)g(.)g(.)h(.)f(.)g(.)17 b Ff(42)1012 288 y Fd(rl_complete)o(r_)o (quo)o(te)o(_ch)o(ar)o(act)o(ers)5 b Fe(.)t(.)h(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)20 b Ff(42)1012 288 y Fd(rl_complete)o(r_)o(wor)o +(.)g(.)g(.)g(.)g(.)20 b Ff(45)1012 335 y Fd(rl_complete)o(r_)o(wor)o (d_)o(bre)o(ak)o(_ch)o(ara)o(ct)o(ers)8 b Fe(.)e(.)g(.)g(.)h(.)f(.)g(.) -25 b Ff(42)1012 335 y Fd(rl_completi)o(on)o(_ap)o(pe)o(nd_)o(ch)o(ara)o +25 b Ff(45)1012 381 y Fd(rl_completi)o(on)o(_ap)o(pe)o(nd_)o(ch)o(ara)o (cte)o(r)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)19 -b Ff(42)1012 381 y Fd(rl_completi)o(on)o(_di)o(sp)o(lay)o(_m)o(atc)o +b Ff(45)1012 427 y Fd(rl_completi)o(on)o(_di)o(sp)o(lay)o(_m)o(atc)o (hes)o(_h)o(ook)8 b Fe(.)e(.)g(.)g(.)h(.)f(.)g(.)25 b -Ff(43)1012 427 y Fd(rl_completi)o(on)o(_en)o(tr)o(y_f)o(un)o(cti)o(on)s -Fe(.)s(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)17 b Ff(39,)c(41)1012 -474 y Fd(rl_completi)o(on)o(_ma)o(tc)o(hes)8 b Fe(.)f(.)f(.)g(.)g(.)g +Ff(45)1012 474 y Fd(rl_completi)o(on)o(_en)o(tr)o(y_f)o(un)o(cti)o(on)s +Fe(.)s(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)17 b Ff(42,)c(43)1012 +520 y Fd(rl_completi)o(on)o(_ma)o(rk)o(_sy)o(ml)o(ink)o(_di)o(rs)t +Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)18 b Ff(46)1012 +566 y Fd(rl_completi)o(on)o(_ma)o(tc)o(hes)8 b Fe(.)f(.)f(.)g(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)25 -b Ff(40)1012 520 y Fd(rl_completi)o(on)o(_qu)o(er)o(y_i)o(te)o(ms)9 -b Fe(.)s(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -23 b Ff(41)1012 566 y Fd(rl_completi)o(on)o(_ty)o(pe)t +b Ff(43)1012 613 y Fd(rl_completi)o(on)o(_mo)o(de)t Fe(.)t(.)6 +b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(43)1012 659 y Fd(rl_completi)o(on)o(_qu) +o(er)o(y_i)o(te)o(ms)9 b Fe(.)s(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)g(.)23 b Ff(45)1012 705 y Fd(rl_completi)o(on)o(_su) +o(pp)o(res)o(s_)o(app)o(end)5 b Fe(.)t(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g +(.)g(.)g(.)g(.)20 b Ff(46)1012 752 y Fd(rl_completi)o(on)o(_ty)o(pe)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(43)1012 613 y +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(46)1012 798 y Fd(rl_copy_key)o(ma)o(p)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)21 b Ff(26)1012 659 y Fd(rl_copy_tex)o(t)6 b Fe(.)g(.)h(.)f(.)g(.)g +h(.)21 b Ff(29)1012 844 y Fd(rl_copy_tex)o(t)6 b Fe(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(32)1012 705 y +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(34)1012 891 y Fd(rl_crlf)t Fe(.)t(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(31)1012 752 y Fd(rl_delete_t)o(ex)o(t)8 +f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(33)1012 937 y Fd(rl_delete_t)o(ex)o(t)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)21 b -Ff(32)1012 798 y Fd(rl_deprep_t)o(er)o(m_f)o(un)o(cti)o(on)7 +Ff(34)1012 983 y Fd(rl_deprep_t)o(er)o(m_f)o(un)o(cti)o(on)7 b Fe(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)24 b Ff(24)1012 844 y Fd(rl_deprep_t)o(er)o(min)o(al)t +g(.)g(.)24 b Ff(26)1012 1030 y Fd(rl_deprep_t)o(er)o(min)o(al)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(33)1012 891 y -Fd(rl_ding)t Fe(.)t(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(35)1012 1076 +y Fd(rl_ding)t Fe(.)t(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(33)1012 937 y Fd(rl_director)o(y_)o +f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(36)1012 1122 y Fd(rl_director)o(y_)o (com)o(pl)o(eti)o(on)o(_ho)o(ok)7 b Fe(.)s(.)f(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)20 b Ff(43)1012 983 y Fd(rl_discard_)o(ke)o(yma) -o(p)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)19 b Ff(27)1012 -1030 y Fd(rl_dispatch)o(in)o(g)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)h(.)20 b Ff(44)1012 1169 y Fd(rl_discard_)o(ke)o +(yma)o(p)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)19 b Ff(29)1012 +1215 y Fd(rl_dispatch)o(in)o(g)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)21 b Ff(22)1012 1076 y Fd(rl_display_)o(ma)o(tch)o(_l)o +g(.)g(.)h(.)21 b Ff(25)1012 1261 y Fd(rl_display_)o(ma)o(tch)o(_l)o (ist)8 b Fe(.)f(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)25 b Ff(33)1012 1122 y Fd(rl_do_undo)8 +(.)g(.)g(.)g(.)g(.)h(.)25 b Ff(36)1012 1308 y Fd(rl_do_undo)8 b Fe(.)e(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)24 -b Ff(30)1012 1169 y Fd(rl_done)t Fe(.)t(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g +b Ff(32)1012 1354 y Fd(rl_done)t Fe(.)t(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(22)1012 -1215 y Fd(rl_editing_)o(mo)o(de)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)17 b Ff(24)1012 +1400 y Fd(rl_editing_)o(mo)o(de)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)21 b Ff(26)1012 1261 y Fd(rl_end)5 b Fe(.)t(.)h(.)g(.)h(.)f(.)g +g(.)g(.)21 b Ff(28)1012 1447 y Fd(rl_end)5 b Fe(.)t(.)h(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)18 -b Ff(22)1012 1308 y Fd(rl_end_undo)o(_g)o(rou)o(p)6 b +b Ff(24)1012 1493 y Fd(rl_end_undo)o(_g)o(rou)o(p)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)19 b Ff(30)1012 1354 +(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)19 b Ff(32)1012 1539 y Fd(rl_erase_em)o(pt)o(y_l)o(in)o(e)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 -b Ff(22)1012 1400 y Fd(rl_event_ho)o(ok)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g +b Ff(25)1012 1586 y Fd(rl_event_ho)o(ok)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(24)1012 1447 y Fd(rl_execute_)o(ne)o +g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(26)1012 1632 y Fd(rl_execute_)o(ne)o (xt)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 -b Ff(32)1012 1493 y Fd(rl_executin)o(g_)o(key)o(ma)o(p)t +b Ff(35)1012 1678 y Fd(rl_executin)o(g_)o(key)o(ma)o(p)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 b Ff(24)1012 1539 y Fd(rl_executin)o(g_) +g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 b Ff(26)1012 1725 y Fd(rl_executin)o(g_) o(mac)o(ro)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(24)1012 -1586 y Fd(rl_expand_p)o(ro)o(mpt)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g +(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(27)1012 +1771 y Fd(rl_expand_p)o(ro)o(mpt)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)20 b Ff(31)1012 1632 y Fd(rl_explicit)o(_a)o(rg)7 +g(.)20 b Ff(34)1012 1817 y Fd(rl_explicit)o(_a)o(rg)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(26)1012 -1678 y Fd(rl_extend_l)o(in)o(e_b)o(uf)o(fer)8 b Fe(.)f(.)f(.)g(.)g(.)g +f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(28)1012 +1864 y Fd(rl_extend_l)o(in)o(e_b)o(uf)o(fer)8 b Fe(.)f(.)f(.)g(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)25 -b Ff(33)1012 1725 y Fd(rl_filename)o(_c)o(omp)o(le)o(tio)o(n_)o(des)o +b Ff(36)1012 1910 y Fd(rl_filename)o(_c)o(omp)o(le)o(tio)o(n_)o(des)o (ire)o(d)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)19 -b Ff(42)1012 1771 y Fd(rl_filename)o(_c)o(omp)o(le)o(tio)o(n_)o(fun)o +b Ff(46)1012 1956 y Fd(rl_filename)o(_c)o(omp)o(le)o(tio)o(n_)o(fun)o (cti)o(on)t Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)18 -b Ff(40)1012 1817 y Fd(rl_filename)o(_d)o(equ)o(ot)o(ing)o(_f)o(unc)o +b Ff(43)1012 2003 y Fd(rl_filename)o(_d)o(equ)o(ot)o(ing)o(_f)o(unc)o (tio)o(n)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)19 -b Ff(41)1012 1864 y Fd(rl_filename)o(_q)o(uot)o(e_)o(cha)o(ra)o(cte)o +b Ff(44)1012 2049 y Fd(rl_filename)o(_q)o(uot)o(e_)o(cha)o(ra)o(cte)o (rs)7 b Fe(.)s(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)20 -b Ff(42)1012 1910 y Fd(rl_filename)o(_q)o(uot)o(in)o(g_d)o(es)o(ire)o +b Ff(45)1012 2095 y Fd(rl_filename)o(_q)o(uot)o(in)o(g_d)o(es)o(ire)o (d)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)21 -b Ff(43)1012 1956 y Fd(rl_filename)o(_q)o(uot)o(in)o(g_f)o(un)o(cti)o +b Ff(46)1012 2142 y Fd(rl_filename)o(_q)o(uot)o(in)o(g_f)o(un)o(cti)o (on)7 b Fe(.)s(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)20 -b Ff(41)1012 2003 y Fd(rl_forced_u)o(pd)o(ate)o(_d)o(isp)o(la)o(y)7 +b Ff(44)1012 2188 y Fd(rl_forced_u)o(pd)o(ate)o(_d)o(isp)o(la)o(y)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)23 b Ff(30)1012 2049 y Fd(rl_free_lin)o(e_)o(sta)o(te)t +f(.)23 b Ff(33)1012 2234 y Fd(rl_free_lin)o(e_)o(sta)o(te)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(38)1012 2095 +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(40)1012 2281 y Fd(rl_free_und)o(o_)o(lis)o(t)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -19 b Ff(30)1012 2142 y Fd(rl_function)o(_d)o(ump)o(er)t +19 b Ff(32)1012 2327 y Fd(rl_function)o(_d)o(ump)o(er)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(29)1012 2188 +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(31)1012 2373 y Fd(rl_function)o(_o)o(f_k)o(ey)o(seq)8 b Fe(.)f(.)f(.)g(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)25 -b Ff(29)1012 2234 y Fd(rl_funmap_n)o(am)o(es)7 b Fe(.)s(.)f(.)g(.)h(.)f +b Ff(31)1012 2420 y Fd(rl_funmap_n)o(am)o(es)7 b Fe(.)s(.)f(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)21 b Ff(29)1012 2281 y Fd(rl_generic_)o(bi)o(nd)7 +h(.)f(.)g(.)g(.)g(.)21 b Ff(31)1012 2466 y Fd(rl_generic_)o(bi)o(nd)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(28)1012 -2327 y Fd(rl_get_keym)o(ap)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h +f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(30)1012 +2512 y Fd(rl_get_keym)o(ap)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)22 b Ff(27)1012 2373 y Fd(rl_get_keym)o(ap)o(_by)o(_n)o -(ame)8 b Fe(.)f(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)25 b Ff(27)1012 2420 y Fd(rl_get_keym)o(ap)o -(_na)o(me)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(27)1012 -2466 y Fd(rl_get_scre)o(en)o(_si)o(ze)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)19 b Ff(38)1012 2512 y Fd(rl_get_term)o(ca)o(p)8 b -Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)21 b Ff(35)p -eop -%%Page: 59 61 -59 60 bop 75 -58 a Fu(F)l(unction)16 b(and)f(V)l(ariable)i(Index)1187 -b(59)75 149 y Fd(rl_getc)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)17 b Ff(32)75 195 -y Fd(rl_getc_fu)o(nc)o(tio)o(n)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)19 b Ff(24)75 241 y Fd(rl_gnu_rea)o(dl)o(ine)o(_p)5 -b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b Ff(23)75 286 -y Fd(rl_ignore_)o(co)o(mpl)o(et)o(ion)o(_du)o(pl)o(ica)o(te)o(s)5 -b Fe(.)s(.)h(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)18 b Ff(42)75 -332 y Fd(rl_ignore_)o(so)o(me_)o(co)o(mpl)o(eti)o(on)o(s_f)o(un)o(cti)o -(on)7 b Fe(.)g(.)f(.)g(.)g(.)g(.)24 b Ff(43)75 378 y -Fd(rl_inhibit)o(_c)o(omp)o(le)o(tio)o(n)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 -b Ff(43)75 424 y Fd(rl_initial)o(iz)o(e)9 b Fe(.)s(.)d(.)g(.)g(.)h(.)f +h(.)f(.)g(.)22 b Ff(29)p eop +%%Page: 61 63 +61 62 bop 75 -58 a Fu(F)l(unction)16 b(and)f(V)l(ariable)i(Index)1187 +b(61)75 149 y Fd(rl_get_key)o(ma)o(p_b)o(y_)o(nam)o(e)9 +b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)25 b Ff(29)75 196 y Fd(rl_get_key)o(ma)o(p_n)o(am)o(e)5 +b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(29)75 242 y Fd(rl_get_scr)o(ee) +o(n_s)o(iz)o(e)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 +b Ff(41)75 288 y Fd(rl_get_ter)o(mc)o(ap)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)21 b Ff(37)75 335 y Fd(rl_getc)t +Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g +(.)g(.)g(.)17 b Ff(35)75 381 y Fd(rl_getc_fu)o(nc)o(tio)o(n)6 +b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(26)75 +427 y Fd(rl_gnu_rea)o(dl)o(ine)o(_p)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g +(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) +g(.)19 b Ff(25)75 474 y Fd(rl_ignore_)o(co)o(mpl)o(et)o(ion)o(_du)o(pl) +o(ica)o(te)o(s)5 b Fe(.)s(.)h(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)18 +b Ff(46)75 520 y Fd(rl_ignore_)o(so)o(me_)o(co)o(mpl)o(eti)o(on)o(s_f)o +(un)o(cti)o(on)7 b Fe(.)g(.)f(.)g(.)g(.)g(.)24 b Ff(44)75 +566 y Fd(rl_inhibit)o(_c)o(omp)o(le)o(tio)o(n)9 b Fe(.)d(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 +b Ff(47)75 613 y Fd(rl_initial)o(iz)o(e)9 b Fe(.)s(.)d(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)22 b Ff(33)75 469 y Fd(rl_insert_)o(co)o(mpl)o +h(.)f(.)g(.)g(.)g(.)g(.)22 b Ff(36)75 659 y Fd(rl_insert_)o(co)o(mpl)o (et)o(ion)o(s)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 b Ff(40)75 515 y Fd(rl_insert_)o(te) +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 b Ff(43)75 705 y Fd(rl_insert_)o(te) o(xt)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 -b Ff(31)75 561 y Fd(rl_instrea)o(m)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g +b Ff(34)75 752 y Fd(rl_instrea)o(m)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(23)75 606 y Fd(rl_invokin)o(g_)o +g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(25)75 798 y Fd(rl_invokin)o(g_)o (key)o(se)o(qs)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(29)75 -652 y Fd(rl_invokin)o(g_)o(key)o(se)o(qs_)o(in_)o(ma)o(p)8 +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(31)75 +844 y Fd(rl_invokin)o(g_)o(key)o(se)o(qs_)o(in_)o(ma)o(p)8 b Fe(.)t(.)e(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)21 -b Ff(29)75 698 y Fd(rl_kill_te)o(xt)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g +b Ff(31)75 891 y Fd(rl_kill_te)o(xt)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(32)75 743 y Fd(rl_last_fu)o(nc)6 +g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(34)75 937 y Fd(rl_last_fu)o(nc)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)22 -b Ff(23)75 789 y Fd(rl_library)o(_v)o(ers)o(io)o(n)5 +b Ff(26)75 983 y Fd(rl_library)o(_v)o(ers)o(io)o(n)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(23)75 835 y Fd(rl_line_bu)o(ff) -o(er)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 -b Ff(22)75 880 y Fd(rl_list_fu)o(nm)o(ap_)o(na)o(mes)s +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(25)75 1030 y +Fd(rl_line_bu)o(ff)o(er)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)21 b Ff(24)75 1076 y Fd(rl_list_fu)o(nm)o(ap_)o(na)o(mes)s Fe(.)s(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)16 b Ff(29)75 926 y Fd(rl_macro_b)o(in)o(d)9 +f(.)g(.)g(.)g(.)g(.)h(.)16 b Ff(31)75 1122 y Fd(rl_macro_b)o(in)o(d)9 b Fe(.)s(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)22 -b Ff(34)75 972 y Fd(rl_macro_d)o(um)o(per)6 b Fe(.)t(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)20 b Ff(34)75 1017 y Fd(rl_make_ba)o(re)o(_ke)o(ym)o -(ap)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(26)75 1063 +b Ff(37)75 1169 y Fd(rl_macro_d)o(um)o(per)6 b Fe(.)t(.)g(.)g(.)g(.)g +(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)h(.)f(.)g(.)20 b Ff(37)75 1215 y Fd(rl_make_ba)o(re)o(_ke)o(ym) +o(ap)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(29)75 1261 y Fd(rl_make_ke)o(ym)o(ap)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)21 b Ff(27)75 1109 y Fd(rl_mark)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g +(.)g(.)21 b Ff(29)75 1308 y Fd(rl_mark)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)17 -b Ff(22)75 1154 y Fd(rl_message)7 b Fe(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g +b Ff(24)75 1354 y Fd(rl_message)7 b Fe(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)24 b Ff(31)75 1200 y Fd(rl_modifyi)o(ng)6 +g(.)g(.)h(.)f(.)g(.)g(.)g(.)24 b Ff(33)75 1400 y Fd(rl_modifyi)o(ng)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)22 -b Ff(30)75 1246 y Fd(rl_named_f)o(un)o(cti)o(on)5 b Fe(.)s(.)i(.)f(.)g +b Ff(32)75 1447 y Fd(rl_named_f)o(un)o(cti)o(on)5 b Fe(.)s(.)i(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)19 b Ff(28)75 1291 y Fd(rl_num_cha)o(rs)o(_to)o(_r)o +g(.)g(.)g(.)g(.)19 b Ff(31)75 1493 y Fd(rl_num_cha)o(rs)o(_to)o(_r)o (ead)s Fe(.)s(.)6 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)16 b Ff(22)75 1337 y Fd(rl_numeric)o(_a) +(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)16 b Ff(24)75 1539 y Fd(rl_numeric)o(_a) o(rg)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)21 -b Ff(26)75 1383 y Fd(rl_on_new_)o(li)o(ne)8 b Fe(.)s(.)e(.)g(.)g(.)g(.) +b Ff(28)75 1586 y Fd(rl_on_new_)o(li)o(ne)8 b Fe(.)s(.)e(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(30)75 1428 y Fd(rl_on_new_)o(li)o(ne_)o +(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(33)75 1632 y Fd(rl_on_new_)o(li)o(ne_)o (wi)o(th_)o(pro)o(mp)o(t)8 b Fe(.)t(.)e(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)21 b Ff(30)75 1474 y Fd(rl_outstre)o(am)6 +(.)g(.)g(.)g(.)h(.)f(.)21 b Ff(33)75 1678 y Fd(rl_outstre)o(am)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)22 -b Ff(23)75 1520 y Fd(rl_parse_a)o(nd)o(_bi)o(nd)5 b Fe(.)s(.)i(.)f(.)g +b Ff(26)75 1725 y Fd(rl_parse_a)o(nd)o(_bi)o(nd)5 b Fe(.)s(.)i(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)19 b Ff(28)75 1565 y Fd(rl_pending)o(_i)o(npu)o(t)6 +g(.)g(.)g(.)g(.)19 b Ff(31)75 1771 y Fd(rl_pending)o(_i)o(npu)o(t)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(22)75 -1611 y Fd(rl_point)s Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(24)75 +1817 y Fd(rl_point)s Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)16 b Ff(22)75 1657 y Fd(rl_possibl)o(e_)o +g(.)g(.)g(.)g(.)h(.)f(.)g(.)16 b Ff(24)75 1864 y Fd(rl_possibl)o(e_)o (com)o(pl)o(eti)o(ons)7 b Fe(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(40)75 1702 y +h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(42)75 1910 y Fd(rl_pre_inp)o(ut)o(_ho)o(ok)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 -b Ff(24)75 1748 y Fd(rl_prep_te)o(rm)o(_fu)o(nc)o(tio)o(n)9 +b Ff(26)75 1956 y Fd(rl_prep_te)o(rm)o(_fu)o(nc)o(tio)o(n)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)25 b Ff(24)75 1794 y Fd(rl_prep_te)o(rm)o(ina)o(l)6 +f(.)g(.)g(.)g(.)25 b Ff(26)75 2003 y Fd(rl_prep_te)o(rm)o(ina)o(l)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(33)75 -1840 y Fd(rl_prompt)8 b Fe(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)19 b Ff(35)75 +2049 y Fd(rl_prompt)8 b Fe(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)24 b Ff(23)75 1885 y Fd(rl_push_ma)o(cr)o(o_i)o(np) +g(.)g(.)g(.)g(.)h(.)24 b Ff(25)75 2095 y Fd(rl_push_ma)o(cr)o(o_i)o(np) o(ut)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(32)75 1931 +(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(34)75 2142 y Fd(rl_read_in)o(it)o(_fi)o(le)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -19 b Ff(28)75 1977 y Fd(rl_read_ke)o(y)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g +19 b Ff(31)75 2188 y Fd(rl_read_ke)o(y)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(32)75 2022 y +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(34)75 2234 y Fd(rl_readlin)o(e_)o(nam)o(e)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -19 b Ff(23)75 2068 y Fd(rl_readlin)o(e_)o(sta)o(te)5 +19 b Ff(25)75 2281 y Fd(rl_readlin)o(e_)o(sta)o(te)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b Ff(24)75 2114 +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b Ff(27)75 2327 y Fd(rl_readlin)o(e_)o(ver)o(si)o(on)t Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 -b Ff(23)75 2159 y Fd(rl_redispl)o(ay)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g +b Ff(25)75 2373 y Fd(rl_redispl)o(ay)6 b Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(30)75 2205 y Fd(rl_redispl)o(ay)o(_fu)o +g(.)g(.)g(.)g(.)h(.)f(.)22 b Ff(33)75 2420 y Fd(rl_redispl)o(ay)o(_fu)o (nc)o(tio)o(n)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 b Ff(24)75 2251 y -Fd(rl_reset_a)o(ft)o(er_)o(si)o(gna)o(l)9 b Fe(.)d(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 -b Ff(38)75 2296 y Fd(rl_reset_l)o(in)o(e_s)o(ta)o(te)t -Fe(.)s(.)6 b(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)17 b Ff(31)75 2342 y Fd(rl_reset_t)o(er)o -(min)o(al)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 b -Ff(33)75 2388 y Fd(rl_resize_)o(te)o(rmi)o(na)o(l)5 b -Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)18 b Ff(38)75 2433 y Fd(rl_restore)o(_p) -o(rom)o(pt)5 b Fe(.)s(.)i(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 -b Ff(31)75 2479 y Fd(rl_save_pr)o(om)o(pt)8 b Fe(.)s(.)e(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)21 b Ff(31)75 2525 y Fd(rl_set_key)7 -b Fe(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)24 -b Ff(28)1012 149 y Fd(rl_set_keyb)o(oa)o(rd_)o(in)o(put)o(_t)o(ime)o +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 b Ff(26)75 2466 y +Fd(rl_replace)o(_l)o(ine)6 b Fe(.)t(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) +20 b Ff(36)75 2512 y Fd(rl_reset_a)o(ft)o(er_)o(si)o(gna)o(l)9 +b Fe(.)d(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)25 b Ff(40)1012 149 y Fd(rl_reset_li)o(ne)o(_st)o(at)o +(e)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 b Ff(33)1012 195 +y Fd(rl_reset_te)o(rm)o(ina)o(l)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) +19 b Ff(35)1012 241 y Fd(rl_resize_t)o(er)o(min)o(al)t +Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(41)1012 287 y +Fd(rl_restore_)o(pr)o(omp)o(t)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)19 +b Ff(34)1012 333 y Fd(rl_save_pro)o(mp)o(t)8 b Fe(.)s(.)e(.)h(.)f(.)g +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)g(.)h(.)21 b Ff(33)1012 379 y Fd(rl_set_key)8 +b Fe(.)e(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)24 +b Ff(30)1012 424 y Fd(rl_set_keyb)o(oa)o(rd_)o(in)o(put)o(_t)o(ime)o (out)5 b Fe(.)t(.)h(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)20 -b Ff(32)1012 195 y Fd(rl_set_keym)o(ap)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g +b Ff(35)1012 470 y Fd(rl_set_keym)o(ap)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g (.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(27)1012 241 y Fd(rl_set_pare)o(n_)o +g(.)g(.)g(.)h(.)f(.)g(.)22 b Ff(29)1012 516 y Fd(rl_set_pare)o(n_)o (bli)o(nk)o(_ti)o(me)o(out)7 b Fe(.)t(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)22 b Ff(34)1012 287 y Fd(rl_set_prom)o(pt)8 +(.)g(.)h(.)f(.)g(.)g(.)g(.)22 b Ff(37)1012 562 y Fd(rl_set_prom)o(pt)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)22 -b Ff(31)1012 333 y Fd(rl_set_scre)o(en)o(_si)o(ze)t Fe(.)t(.)6 +b Ff(34)1012 608 y Fd(rl_set_scre)o(en)o(_si)o(ze)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(38)1012 379 y Fd(rl_set_sign)o(al)o(s)8 +(.)g(.)g(.)g(.)g(.)g(.)19 b Ff(41)1012 654 y Fd(rl_set_sign)o(al)o(s)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)21 b -Ff(38)1012 426 y Fd(rl_show_cha)o(r)6 b Fe(.)g(.)h(.)f(.)g(.)g(.)g(.)g +Ff(41)1012 700 y Fd(rl_show_cha)o(r)6 b Fe(.)g(.)h(.)f(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(31)1012 472 y Fd(rl_special_)o(pr)o +g(.)g(.)h(.)f(.)g(.)g(.)23 b Ff(33)1012 745 y Fd(rl_special_)o(pr)o (efi)o(xe)o(s)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 b Ff(42)1012 -518 y Fd(rl_startup_)o(ho)o(ok)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g +h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)18 b Ff(45)1012 +791 y Fd(rl_startup_)o(ho)o(ok)7 b Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)21 b Ff(23)1012 564 y Fd(rl_stuff_ch)o(ar)8 b +g(.)g(.)21 b Ff(26)1012 837 y Fd(rl_stuff_ch)o(ar)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)22 -b Ff(32)1012 610 y Fd(rl_terminal)o(_n)o(ame)6 b Fe(.)s(.)g(.)g(.)g(.)h +b Ff(35)1012 883 y Fd(rl_terminal)o(_n)o(ame)6 b Fe(.)s(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)20 b Ff(23)1012 656 y Fd(rl_tty_set_)o(de)o(fau)o(lt)o +h(.)f(.)g(.)g(.)20 b Ff(25)1012 929 y Fd(rl_tty_set_)o(de)o(fau)o(lt)o (_bi)o(nd)o(ing)o(s)8 b Fe(.)s(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)21 b Ff(33)1012 702 y Fd(rl_unbind_c)o(om)o(man)o(d_)o +(.)h(.)f(.)g(.)21 b Ff(35)1012 975 y Fd(rl_unbind_c)o(om)o(man)o(d_)o (in_)o(ma)o(p)7 b Fe(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)23 b Ff(28)1012 748 y Fd(rl_unbind_f)o(un)o(cti)o +g(.)g(.)g(.)h(.)f(.)23 b Ff(30)1012 1020 y Fd(rl_unbind_f)o(un)o(cti)o (on)o(_in)o(_m)o(ap)9 b Fe(.)s(.)d(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)23 b Ff(28)1012 794 y Fd(rl_unbind_k)o(ey)8 +(.)g(.)g(.)g(.)g(.)g(.)23 b Ff(30)1012 1066 y Fd(rl_unbind_k)o(ey)8 b Fe(.)s(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)22 -b Ff(28)1012 840 y Fd(rl_unbind_k)o(ey)o(_in)o(_m)o(ap)s +b Ff(30)1012 1112 y Fd(rl_unbind_k)o(ey)o(_in)o(_m)o(ap)s Fe(.)t(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)17 b Ff(28)1012 886 y Fd(rl_username)o(_c)o +g(.)g(.)g(.)h(.)f(.)g(.)17 b Ff(30)1012 1158 y Fd(rl_username)o(_c)o (omp)o(le)o(tio)o(n_)o(fun)o(cti)o(on)t Fe(.)s(.)7 b(.)f(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)18 b Ff(40)1012 932 y Fd(rl_variable)o(_b)o(ind)6 +g(.)h(.)f(.)g(.)18 b Ff(43)1012 1204 y Fd(rl_variable)o(_b)o(ind)6 b Fe(.)s(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(34)1012 -978 y Fd(rl_variable)o(_d)o(ump)o(er)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -19 b Ff(34)1012 1109 y Fs(S)1012 1170 y Fd(self-insert)9 +h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)20 b Ff(37)1012 +1250 y Fd(rl_variable)o(_d)o(ump)o(er)t Fe(.)t(.)6 b(.)g(.)g(.)g(.)h(.) +f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g +(.)19 b Ff(37)1012 1380 y Fs(S)1012 1441 y Fd(self-insert)9 b(\(a,)j(b,)g(A,)g(1,)g(!,)g(...)o(\))6 b Fe(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 1216 y Fd(set-mark)10 +h(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 1487 y Fd(set-mark)10 b(\(C-@\))g Fe(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 -b Ff(17)1012 1262 y(sho)o(w-all-if-am)o(bigu)q(ous)14 +b Ff(17)1012 1533 y(sho)o(w-all-if-am)o(bigu)q(ous)14 b Fe(.)6 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(7)1012 1308 +(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)23 b Ff(7)1012 1579 y Fd(start-kbd-m)o(ac)o(ro)9 b(\(C-x)j(\(\))c Fe(.)d(.)i(.)f(.)g(.)g(.) g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)22 -b Ff(16)1012 1432 y Fs(T)1012 1494 y Fd(tab-insert)9 -b(\(M-)1281 1492 y Fn(h)p 1292 1466 74 2 v 1292 1494 -a Fm(T)m(AB)p 1292 1501 V 1364 1492 a Fn(i)1379 1494 +b Ff(17)1012 1701 y Fs(T)1012 1763 y Fd(tab-insert)9 +b(\(M-)1281 1761 y Fn(h)p 1292 1735 74 2 v 1292 1763 +a Fm(T)m(AB)p 1292 1770 V 1364 1761 a Fn(i)1379 1763 y Fd(\))e Fe(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)20 b Ff(14)1012 1540 +f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)20 b Ff(14)1012 1808 y Fd(tilde-expan)o(d)10 b(\(M-~\))f Fe(.)s(.)e(.)f(.)g(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)22 -b Ff(17)1012 1586 y Fd(transpose-c)o(ha)o(rs)9 b(\(C-t\))d +b Ff(17)1012 1854 y Fd(transpose-c)o(ha)o(rs)9 b(\(C-t\))d Fe(.)f(.)h(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 1632 y Fd(transpose-w)o(or)o(ds)9 +(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 1900 y Fd(transpose-w)o(or)o(ds)9 b(\(M-t\))d Fe(.)f(.)h(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 1763 y -Fs(U)1012 1825 y Fd(undo)12 b(\(C-_)f(or)h(C-x)g(C-u\))c +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 b Ff(14)1012 2030 y +Fs(U)1012 2092 y Fd(undo)12 b(\(C-_)f(or)h(C-x)g(C-u\))c Fe(.)t(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)21 b Ff(17)1012 1871 y Fd(universal-a)o(rg)o +(.)g(.)h(.)f(.)g(.)g(.)21 b Ff(17)1012 2137 y Fd(universal-a)o(rg)o (ume)o(nt)9 b(\(\))d Fe(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)20 b Ff(16)1012 -1917 y Fd(unix-line-d)o(is)o(car)o(d)10 b(\(C-u\))5 b +2183 y Fd(unix-line-d)o(is)o(car)o(d)10 b(\(C-u\))5 b Fe(.)t(.)h(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)18 b Ff(15)1012 1963 y Fd(unix-word-r)o(ub)o(out)9 +(.)h(.)f(.)18 b Ff(15)1012 2229 y Fd(unix-word-r)o(ub)o(out)9 b(\(C-w\))d Fe(.)t(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)19 b Ff(15)1012 2009 y Fd(upcase-word)9 +(.)g(.)g(.)g(.)h(.)f(.)g(.)19 b Ff(15)1012 2275 y Fd(upcase-word)9 b(\(M-u\))e Fe(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h (.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)23 b Ff(14)1012 -2140 y Fs(V)1012 2201 y Ff(visible-stats)14 b Fe(.)6 +2405 y Fs(V)1012 2466 y Fd(vi-editing-)o(mo)o(de)9 b(\(M-C-j\))c +Fe(.)t(.)h(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g +(.)h(.)f(.)18 b Ff(18)1012 2512 y(visible-stats)c Fe(.)6 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)24 -b Ff(7)1012 2325 y Fs(Y)1012 2387 y Fd(yank)12 b(\(C-y\))5 -b Fe(.)t(.)h(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)19 -b Ff(15)1012 2433 y Fd(yank-last-a)o(rg)9 b(\(M-.)i(or)h(M-_\))c -Fe(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 -b Ff(13)1012 2479 y Fd(yank-nth-ar)o(g)10 b(\(M-C-y\))d +b Ff(7)p eop +%%Page: 62 64 +62 63 bop 75 -58 a Fu(62)1299 b(GNU)15 b(Readline)h(Library)75 +149 y Fs(Y)75 242 y Fd(yank)11 b(\(C-y\))5 b Fe(.)g(.)h(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)18 b Ff(16)1012 +149 y Fd(yank-last-a)o(rg)9 b(\(M-.)i(or)h(M-_\))c Fe(.)f(.)f(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)23 +b Ff(13)1012 196 y Fd(yank-nth-ar)o(g)10 b(\(M-C-y\))d Fe(.)s(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)h(.)20 b Ff(13)1012 2525 y Fd(yank-pop)10 +(.)g(.)g(.)g(.)g(.)h(.)20 b Ff(13)1012 242 y Fd(yank-pop)10 b(\(M-y\))g Fe(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)25 -b Ff(15)p eop -%%Page: 60 62 -60 61 bop 75 -58 a Fu(60)1299 b(GNU)15 b(Readline)h(Library)p -eop -%%Page: -1 63 --1 62 bop 1862 -58 a Fu(i)75 149 y Fq(T)-7 b(able)27 +b Ff(16)p eop +%%Page: -1 65 +-1 64 bop 1862 -58 a Fu(i)75 149 y Fq(T)-7 b(able)27 b(of)f(Con)n(ten)n(ts)75 320 y Fs(1)67 b(Command)22 b(Line)i(Editing)d Fa(.)10 b(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)42 b Fs(1)224 389 y Fu(1.1)j(In)o(tro)q(duction)16 @@ -4949,7 +5086,7 @@ b(Init)g(File)h(Syn)o(tax)7 b Fl(.)g(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)21 b Fu(4)374 882 y(1.3.2)44 b(Conditional)16 b(Init)g(Constructs)5 b Fl(.)i(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)g(.)f(.)19 b Fu(8)374 937 y(1.3.3)44 b(Sample)16 +h(.)f(.)h(.)g(.)f(.)19 b Fu(9)374 937 y(1.3.3)44 b(Sample)16 b(Init)g(File)11 b Fl(.)e(.)e(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) h(.)f(.)26 b Fu(9)224 992 y(1.4)45 b(Bindable)17 b(Readline)g(Commands) @@ -4962,101 +5099,101 @@ b(Commands)14 b(F)l(or)h(Manipulating)i(The)e(History)9 b Fl(.)e(.)h(.)f(.)h(.)f(.)h(.)24 b Fu(12)374 1156 y(1.4.3)44 b(Commands)14 b(F)l(or)h(Changing)h(T)l(ext)e Fl(.)8 b(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)30 -b Fu(13)374 1211 y(1.4.4)44 b(Killing)18 b(And)e(Y)l(anking)9 +b Fu(14)374 1211 y(1.4.4)44 b(Killing)18 b(And)e(Y)l(anking)9 b Fl(.)e(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)24 b Fu(14)374 +h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)24 b Fu(15)374 1266 y(1.4.5)44 b(Sp)q(ecifying)17 b(Numeric)f(Argumen)o(ts)c Fl(.)c(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)27 -b Fu(15)374 1320 y(1.4.6)44 b(Letting)15 b(Readline)i(T)o(yp)q(e)e(F)l +b Fu(16)374 1320 y(1.4.6)44 b(Letting)15 b(Readline)i(T)o(yp)q(e)e(F)l (or)g(Y)l(ou)10 b Fl(.)d(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) h(.)f(.)h(.)f(.)25 b Fu(16)374 1375 y(1.4.7)44 b(Keyb)q(oard)15 b(Macros)6 b Fl(.)h(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)21 -b Fu(16)374 1430 y(1.4.8)44 b(Some)15 b(Miscellaneous)i(Commands)7 +b Fu(17)374 1430 y(1.4.8)44 b(Some)15 b(Miscellaneous)i(Commands)7 b Fl(.)g(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) 22 b Fu(17)224 1485 y(1.5)45 b(Readline)16 b(vi)g(Mo)q(de)e Fl(.)7 b(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)28 b Fu(18)75 1606 y Fs(2)67 b(Programming)23 b(with)g(GNU)f(Readline)12 b Fa(.)f(.)g(.)f(.)g(.)g(.)g(.)h(.)f(.)35 -b Fs(19)224 1675 y Fu(2.1)45 b(Basic)16 b(Beha)o(vior)8 +b Fs(21)224 1675 y Fu(2.1)45 b(Basic)16 b(Beha)o(vior)8 b Fl(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f -(.)h(.)f(.)h(.)f(.)h(.)f(.)23 b Fu(19)224 1729 y(2.2)45 +(.)h(.)f(.)h(.)f(.)h(.)f(.)23 b Fu(21)224 1729 y(2.2)45 b(Custom)14 b(F)l(unctions)7 b Fl(.)i(.)f(.)f(.)h(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) -f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)22 b Fu(20)374 +f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)22 b Fu(22)374 1784 y(2.2.1)44 b(Readline)16 b(T)o(yp)q(edefs)9 b Fl(.)g(.)e(.)h(.)f (.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) -f(.)h(.)f(.)h(.)g(.)f(.)h(.)24 b Fu(20)374 1839 y(2.2.2)44 +f(.)h(.)f(.)h(.)g(.)f(.)h(.)24 b Fu(23)374 1839 y(2.2.2)44 b(W)l(riting)16 b(a)e(New)i(F)l(unction)6 b Fl(.)i(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -21 b Fu(21)224 1894 y(2.3)45 b(Readline)16 b(V)l(ariables)g +21 b Fu(23)224 1894 y(2.3)45 b(Readline)16 b(V)l(ariables)g Fl(.)8 b(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g -(.)f(.)h(.)29 b Fu(22)224 1949 y(2.4)45 b(Readline)16 +(.)f(.)h(.)29 b Fu(24)224 1949 y(2.4)45 b(Readline)16 b(Con)o(v)o(enience)h(F)l(unctions)7 b Fl(.)i(.)e(.)h(.)f(.)h(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -23 b Fu(26)374 2003 y(2.4.1)44 b(Naming)15 b(a)g(F)l(unction)e +23 b Fu(28)374 2003 y(2.4.1)44 b(Naming)15 b(a)g(F)l(unction)e Fl(.)7 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)27 b Fu(26)374 +h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)27 b Fu(28)374 2058 y(2.4.2)44 b(Selecting)17 b(a)e(Keymap)6 b Fl(.)h(.)h(.)g(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)f(.)h(.)21 b Fu(26)374 2113 y(2.4.3)44 b(Binding)17 +h(.)f(.)h(.)f(.)h(.)21 b Fu(29)374 2113 y(2.4.3)44 b(Binding)17 b(Keys)5 b Fl(.)j(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) -h(.)f(.)20 b Fu(27)374 2168 y(2.4.4)44 b(Asso)q(ciating)16 +h(.)f(.)20 b Fu(30)374 2168 y(2.4.4)44 b(Asso)q(ciating)16 b(F)l(unction)g(Names)f(and)g(Bindings)8 b Fl(.)h(.)f(.)f(.)h(.)f(.)h -(.)23 b Fu(28)374 2222 y(2.4.5)44 b(Allo)o(wing)16 b(Undoing)f +(.)23 b Fu(31)374 2222 y(2.4.5)44 b(Allo)o(wing)16 b(Undoing)f Fl(.)8 b(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)29 b -Fu(29)374 2277 y(2.4.6)44 b(Redispla)o(y)10 b Fl(.)e(.)g(.)g(.)f(.)h(.) +Fu(32)374 2277 y(2.4.6)44 b(Redispla)o(y)10 b Fl(.)e(.)g(.)g(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)26 -b Fu(30)374 2332 y(2.4.7)44 b(Mo)q(difying)16 b(T)l(ext)7 +b Fu(33)374 2332 y(2.4.7)44 b(Mo)q(difying)16 b(T)l(ext)7 b Fl(.)g(.)g(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)22 -b Fu(31)374 2387 y(2.4.8)44 b(Character)14 b(Input)c +b Fu(34)374 2387 y(2.4.8)44 b(Character)14 b(Input)c Fl(.)f(.)e(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)25 -b Fu(32)374 2442 y(2.4.9)44 b(T)l(erminal)16 b(Managemen)o(t)11 +b Fu(34)374 2442 y(2.4.9)44 b(T)l(erminal)16 b(Managemen)o(t)11 b Fl(.)c(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) -h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(33)374 2496 y(2.4.10)43 +h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(35)374 2496 y(2.4.10)43 b(Utilit)o(y)17 b(F)l(unctions)c Fl(.)7 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) -f(.)h(.)f(.)28 b Fu(33)374 2551 y(2.4.11)43 b(Miscellaneous)18 +f(.)h(.)f(.)28 b Fu(36)374 2551 y(2.4.11)43 b(Miscellaneous)18 b(F)l(unctions)6 b Fl(.)i(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h -(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)21 b Fu(34)374 +(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)21 b Fu(37)374 2606 y(2.4.12)43 b(Alternate)16 b(In)o(terface)f Fl(.)7 b(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f -(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)30 b Fu(35)374 2661 +(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)30 b Fu(37)374 2661 y(2.4.13)43 b(A)16 b(Readline)g(Example)9 b Fl(.)f(.)f(.)h(.)f(.)h(.)g (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)24 b Fu(35)p eop -%%Page: -2 64 --2 63 bop 75 -58 a Fu(ii)1321 b(GNU)15 b(Readline)h(Library)224 +h(.)f(.)24 b Fu(38)p eop +%%Page: -2 66 +-2 65 bop 75 -58 a Fu(ii)1321 b(GNU)15 b(Readline)h(Library)224 42 y(2.5)45 b(Readline)16 b(Signal)h(Handling)12 b Fl(.)c(.)g(.)f(.)h (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) -f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(37)224 96 +f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(39)224 96 y(2.6)45 b(Custom)14 b(Completers)f Fl(.)8 b(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f -(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)28 b Fu(39)374 +(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)28 b Fu(41)374 151 y(2.6.1)44 b(Ho)o(w)14 b(Completing)i(W)l(orks)10 b Fl(.)d(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) -f(.)h(.)f(.)h(.)f(.)h(.)f(.)25 b Fu(39)374 206 y(2.6.2)44 +f(.)h(.)f(.)h(.)f(.)h(.)f(.)25 b Fu(41)374 206 y(2.6.2)44 b(Completion)16 b(F)l(unctions)6 b Fl(.)i(.)g(.)f(.)h(.)f(.)h(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) -21 b Fu(40)374 261 y(2.6.3)44 b(Completion)16 b(V)l(ariables)c +21 b Fu(42)374 261 y(2.6.3)44 b(Completion)16 b(V)l(ariables)c Fl(.)c(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f -(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(41)374 315 +(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)27 b Fu(43)374 315 y(2.6.4)44 b(A)15 b(Short)g(Completion)h(Example)5 b Fl(.)j(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h -(.)f(.)20 b Fu(44)75 437 y Fs(Concept)i(Index)10 b Fa(.)i(.)e(.)g(.)g +(.)f(.)20 b Fu(47)75 437 y Fs(Concept)i(Index)10 b Fa(.)i(.)e(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)33 b Fs(55)75 572 +g(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)33 b Fs(57)75 572 y(F)-6 b(unction)25 b(and)d(V)-6 b(ariable)24 b(Index)9 b Fa(.)i(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)32 b Fs(57)p eop +g(.)32 b Fs(59)p eop %%Trailer end userdict /end-hook known{end-hook}if diff --git a/doc/readline_3.ps b/doc/readline_3.ps index 4049272..7d20e17 100644 --- a/doc/readline_3.ps +++ b/doc/readline_3.ps @@ -1,17 +1,17 @@ %!PS-Adobe-3.0 -%%Creator: groff version 1.16.1 -%%CreationDate: Tue Oct 9 15:08:13 2001 +%%Creator: groff version 1.17.2 +%%CreationDate: Thu Jun 27 13:54:44 2002 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic %%+ font Courier -%%DocumentSuppliedResources: procset grops 1.16 1 +%%DocumentSuppliedResources: procset grops 1.17 2 %%Pages: 14 %%PageOrder: Ascend %%Orientation: Portrait %%EndComments %%BeginProlog -%%BeginResource: procset grops 1.16 1 +%%BeginResource: procset grops 1.17 2 /setpacking where{ pop currentpacking @@ -215,7 +215,7 @@ BP -.15(ch)108 165.6 S(ar *).15 E F2 -.18(re)108 177.6 S(adline).18 E F0 (\()2.5 E F3(const c)A(har *pr)-.15 E(ompt)-.45 E F0(\);)A F1(COPYRIGHT) 72 194.4 Q F0(Readline is Cop)108 206.4 Q -(yright \251 1989\2552001 by the Free Softw)-.1 E(are F)-.1 E +(yright \251 1989\2552002 by the Free Softw)-.1 E(are F)-.1 E (oundation, Inc.)-.15 E F1(DESCRIPTION)72 223.2 Q F2 -.18(re)108 235.2 S (adline).18 E F0 .088 (will read a line from the terminal and return it, using)2.588 F F2(pr) @@ -308,8 +308,8 @@ le is read, and the k)-5.359 F .658 -.15(ey b)-.1 H(ind-).15 E 1.083 (wn commands and bindings.)-.25 E -.15(Fo)108 669.6 S 2.5(re).15 G (xample, placing)-2.65 E(M\255Control\255u: uni)144 686.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(or)108 698.4 Q(C\255Meta\255u: uni)144 -710.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(GNU Readline 4.2a) -72 768 Q(2001 October 9)123.745 E(1)197.895 E EP +710.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(GNU Readline 4.3) +72 768 Q(2002 January 22)126.24 E(1)195.95 E EP %%Page: 2 2 %%BeginPageSetup BP @@ -402,8 +402,8 @@ o indicate a macro de\214nition.)-.15 F .089(Unquoted te)108 712.8 R 5.089 F 2.59(,t)-.65 G .09(he backslash escapes described abo)-2.59 F -.15(ve)-.15 G(are e)108 724.8 Q 2.5(xpanded. Backslash)-.15 F (will quote an)2.5 E 2.5(yo)-.15 G(ther character in the macro te)-2.5 E -(xt, including " and '.)-.15 E(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(2)197.895 E EP +(xt, including " and '.)-.15 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(2)195.95 E EP %%Page: 3 3 %%BeginPageSetup BP @@ -500,8 +500,8 @@ he eighth bit in the char)-2.867 F(-)-.2 E .956(acters it reads\), re) 144 691.2 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 703.2 Q -(ym for this v)-.15 E(ariable.)-.25 E(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(3)197.895 E EP +(ym for this v)-.15 E(ariable.)-.25 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(3)195.95 E EP %%Page: 4 4 %%BeginPageSetup BP @@ -534,724 +534,761 @@ G 3.435(nav).15 G .935(alue, the characters)-3.685 F/F2 10 216 Q F0(If set to)144 228 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(match\255hidden\255\214les \(On\))108 240 Q F0 .192(This v) -144 252 R .192(ariable, when set to)-.25 F F1(On)2.692 E F0 2.692(,c)C -.192(auses readline to match \214les whose names be)-2.692 F .193 -(gin with a `.)-.15 F 2.693('\()-.7 G(hidden)-2.693 E 1.024 +F0(\).)A F1(mark\255symlink)108 240 Q(ed\255dir)-.1 E(ectories \(Off\)) +-.18 E F0 .175(If set to)144 252 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 264 +Q(alue of)-.25 E F1(mark\255dir)2.5 E(ectories)-.18 E F0(\).)A F1 +(match\255hidden\255\214les \(On\))108 276 Q F0 .193(This v)144 288 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 1.023 (\214les\) when performing \214lename completion, unless the leading `.) -144 264 R 3.523('i)-.7 G 3.523(ss)-3.523 G 1.023 -(upplied by the user in the)-3.523 F(\214lename to be completed.)144 276 -Q F1(output\255meta \(Off\))108 288 Q F0 .506(If set to)144 300 R F1(On) -3.006 E F0 3.006(,r)C .507(eadline will display characters with the eig\ -hth bit set directly rather than as a meta-)-3.006 F(pre\214x)144 312 Q -(ed escape sequence.)-.15 E F1 -(print\255completions\255horizontally \(Off\))108 324 Q F0 1.319 -(If set to)144 336 R F1(On)3.819 E F0 3.819(,r)C 1.318(eadline will dis\ +144 300 R 3.523('i)-.7 G 3.523(ss)-3.523 G 1.024 +(upplied by the user in the)-3.523 F(\214lename to be completed.)144 312 +Q F1(output\255meta \(Off\))108 324 Q F0 .507(If set to)144 336 R F1(On) +3.007 E F0 3.007(,r)C .507(eadline will display characters with the eig\ +hth bit set directly rather than as a meta-)-3.007 F(pre\214x)144 348 Q +(ed escape sequence.)-.15 E F1(page\255completions \(On\))108 360 Q F0 +.808(If set to)144 372 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 384 Q F1 +(print\255completions\255horizontally \(Off\))108 396 Q F0 1.319 +(If set to)144 408 R F1(On)3.819 E F0 3.819(,r)C 1.318(eadline will dis\ play completions with matches sorted horizontally in alphabetical)-3.819 -F(order)144 348 Q 2.5(,r)-.4 G(ather than do)-2.5 E(wn the screen.)-.25 -E F1(sho)108 360 Q(w\255all\255if\255ambiguous \(Off\))-.1 E F0 .477 -(This alters the def)144 372 R .477(ault beha)-.1 F .477 +F(order)144 420 Q 2.5(,r)-.4 G(ather than do)-2.5 E(wn the screen.)-.25 +E F1(sho)108 432 Q(w\255all\255if\255ambiguous \(Off\))-.1 E F0 .477 +(This alters the def)144 444 R .477(ault beha)-.1 F .477 (vior of the completion functions.)-.2 F .478(If set to)5.478 F F1(on) 2.978 E F0 2.978(,w)C .478(ords which ha)-3.078 F .778 -.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 384 R(bell.)144 396 Q F1 -(visible\255stats \(Off\))108 408 Q F0 .846(If set to)144 420 R F1(On) +isted immediately instead of ringing the)144 456 R(bell.)144 468 Q F1 +(visible\255stats \(Off\))108 480 Q F0 .846(If set to)144 492 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 432 Q F1(Conditional Constructs) -87 448.8 Q F0 .05(Readline implements a f)108 460.8 R .05(acility simil\ +(when listing possible completions.)144 504 Q F1(Conditional Constructs) +87 520.8 Q F0 .05(Readline implements a f)108 532.8 R .05(acility simil\ ar in spirit to the conditional compilation features of the C preproces\ -sor)-.1 F .096(which allo)108 472.8 R .096(ws k)-.25 F .396 -.15(ey b) +sor)-.1 F .096(which allo)108 544.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 .097 -(There are four parser)5.096 F(directi)108 484.8 Q -.15(ve)-.25 G 2.5 -(su).15 G(sed.)-2.5 E F1($if)108 501.6 Q F0(The)24.89 E F1($if)2.963 E +(There are four parser)5.096 F(directi)108 556.8 Q -.15(ve)-.25 G 2.5 +(su).15 G(sed.)-2.5 E F1($if)108 573.6 Q F0(The)24.89 E 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 used,)-.25 F .477 -(or the application using readline.)144 513.6 R .477(The te)5.477 F .477 +(or the application using readline.)144 585.6 R .477(The te)5.477 F .477 (xt of the test e)-.15 F .477 (xtends to the end of the line; no characters)-.15 F -(are required to isolate it.)144 525.6 Q F1(mode)144 542.4 Q F0(The) +(are required to isolate it.)144 597.6 Q F1(mode)144 614.4 Q F0(The) 12.67 E 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 554.4 R .565(may be used in conjunction with the)3.065 F +(mode. This)180 626.4 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 566.4 R F2(emacs-standar)2.529 E(d) +3.065 F .03(set bindings in the)180 638.4 R F2(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 578.4 -Q F1(term)144 595.2 Q F0(The)15.46 E F1(term=)3.196 E F0 .696 +(ymaps only if readline is starting out)-.05 F(in emacs mode.)180 650.4 +Q F1(term)144 667.2 Q F0(The)15.46 E 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 607.2 R +(ey b)-.1 H .697(indings, perhaps to bind).15 F .654(the k)180 679.2 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 619.2 Q F1(=)3.003 +(wo)3.154 G .654(rd on the right side of).1 F(the)180 691.2 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 -631.2 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.5 E F0 +703.2 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.5 E F0 (to match both)2.5 E F2(sun)2.5 E F0(and)2.5 E F2(sun\255cmd)2.5 E F0 -2.5(,f).77 G(or instance.)-2.5 E F1(application)144 648 Q F0(The)180 660 -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 -672 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 684 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 696 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 .397(equence that quotes the).15 F(current or pre)180 708 Q -(vious w)-.25 E(ord in Bash:)-.1 E(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(4)197.895 E EP +2.5(,f).77 G(or instance.)-2.5 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(4)195.95 E EP %%Page: 5 5 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 -/Times-Bold@0 SF($if)180 84 Q F0(Bash)2.5 E 2.5(#Q)180 96 S +/Times-Bold@0 SF(application)144 84 Q F0(The)180 96 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 +108 R/F2 10/Times-Italic@0 SF .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 120 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 +132 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 .397 +(equence that quotes the).15 F(current or pre)180 144 Q(vious w)-.25 E +(ord in Bash:)-.1 E F1($if)180 168 Q F0(Bash)2.5 E 2.5(#Q)180 180 S (uote the current or pre)-2.5 E(vious w)-.25 E(ord)-.1 E -("\\C-xq": "\\eb\\"\\ef\\"")180 108 Q F1($endif)180 120 Q($endif)108 -136.8 Q F0(This command, as seen in the pre)9.33 E(vious e)-.25 E +("\\C-xq": "\\eb\\"\\ef\\"")180 192 Q F1($endif)180 204 Q($endif)108 +220.8 Q F0(This command, as seen in the pre)9.33 E(vious e)-.25 E (xample, terminates an)-.15 E F1($if)2.5 E F0(command.)2.5 E F1($else) -108 153.6 Q F0(Commands in this branch of the)15.45 E F1($if)2.5 E F0 +108 237.6 Q F0(Commands in this branch of the)15.45 E 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 170.4 Q F0 .357 -(This directi)144 182.4 R .657 -.15(ve t)-.25 H(ak).15 E .357 +(cuted if the test f).15 E(ails.)-.1 E F1($include)108 254.4 Q F0 .357 +(This directi)144 266.4 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 194.4 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 10/Times-Italic@0 SF(/etc/inputr)2.5 -E(c)-.37 E F0(:)A F1($include)144 218.4 Q F2(/etc/inputr)5.833 E(c)-.37 -E/F3 10.95/Times-Bold@0 SF(SEARCHING)72 235.2 Q F0 1.003(Readline pro) -108 247.2 R 1.003(vides commands for searching through the command hist\ -ory for lines containing a speci\214ed)-.15 F 2.5(string. There)108 -259.2 R(are tw)2.5 E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.5 E -(emental)-.37 E F0(and)2.5 E F2(non-incr)2.5 E(emental)-.37 E F0(.).51 E -.698(Incremental searches be)108 276 R .698 +144 278.4 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 302.4 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95 +/Times-Bold@0 SF(SEARCHING)72 319.2 Q F0 1.003(Readline pro)108 331.2 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 343.2 R(are tw) +2.5 E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.5 E(emental)-.37 E F0 +(and)2.5 E F2(non-incr)2.5 E(emental)-.37 E F0(.).51 E .698 +(Incremental searches be)108 360 R .698 (gin before the user has \214nished typing the search string.)-.15 F .697(As each character of the)5.697 F .112 -(search string is typed, readline displays the ne)108 288 R .112 +(search string is typed, readline displays the ne)108 372 R .112 (xt entry from the history matching the string typed so f)-.15 F(ar)-.1 E 5.113(.A)-.55 G(n)-5.113 E .545 -(incremental search requires only as man)108 300 R 3.045(yc)-.15 G .544 +(incremental search requires only as man)108 384 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(backw)108 312 Q .18 +(.T)-.65 G 3.044(os)-6.344 G(earch)-3.044 E(backw)108 396 Q .18 (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.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 324 R .354(alue of the)-.25 F F1 +(The characters present in the v)108 408 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 336 +(riable are used to terminate an incremen-).25 F .6(tal search.)108 420 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 .123(incremental search.)108 348 R +(characters will terminate an)3.1 F .123(incremental search.)108 432 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 360 Q 2.406 -.8 -(To \214)108 376.8 T .806 +g the search string becomes the current line.)108 444 Q 2.406 -.8 +(To \214)108 460.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 388.8 S 1.309(rd or forw) +.807(This will search back-)5.806 F -.1(wa)108 472.8 S 1.309(rd or forw) .1 F 1.309(ard in the history for the ne)-.1 F 1.309 (xt line matching the search string typed so f)-.15 F(ar)-.1 E 6.309(.A) -.55 G 1.609 -.15(ny o)-6.309 H 1.308(ther k).15 F -.15(ey)-.1 G .317 (sequence bound to a readline command will terminate the search and e) -108 400.8 R -.15(xe)-.15 G .318(cute that command.).15 F -.15(Fo)5.318 G -2.818(ri).15 G(nstance,)-2.818 E 3.481(an)108 412.8 S -.25(ew)-3.481 G +108 484.8 R -.15(xe)-.15 G .318(cute that command.).15 F -.15(Fo)5.318 G +2.818(ri).15 G(nstance,)-2.818 E 3.481(an)108 496.8 S -.25(ew)-3.481 G .981(line will terminate the search and accept the line, thereby e).25 F -.15(xe)-.15 G .98(cuting the command from the history).15 F 3.061 -(list. A)108 424.8 R(mo)3.061 E -.15(ve)-.15 G .562 +(list. A)108 508.8 R(mo)3.061 E -.15(ve)-.15 G .562 (ment command will terminate the search, mak).15 F 3.062(et)-.1 G .562 (he last line found the current line, and be)-3.062 F(gin)-.15 E -(editing.)108 436.8 Q .567(Non-incremental searches read the entire sea\ +(editing.)108 520.8 Q .567(Non-incremental searches read the entire sea\ rch string before starting to search for matching history lines.)108 -453.6 R(The search string may be typed by the user or be part of the co\ -ntents of the current line.)108 465.6 Q F3(EDITING COMMANDS)72 482.4 Q -F0 1.391(The follo)108 494.4 R 1.391 +537.6 R(The search string may be typed by the user or be part of the co\ +ntents of the current line.)108 549.6 Q F3(EDITING COMMANDS)72 566.4 Q +F0 1.391(The follo)108 578.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.892(ya)-.15 G(re)-3.892 E 2.5(bound. Command)108 506.4 R +3.892(ya)-.15 G(re)-3.892 E 2.5(bound. Command)108 590.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 .055(In the follo)108 -523.2 R .055(wing descriptions,)-.25 F F2(point)2.555 E F0 .055 +607.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 535.2 Q -.15(ve)-.2 G +.054(refers to a cursor position)2.554 F(sa)108 619.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 552 Q(or Mo)-.25 E(ving)-.1 E -(beginning\255of\255line \(C\255a\))108 564 Q F0(Mo)144 576 Q .3 -.15 +2.5 G(gion)-.03 E F0(.)A F1(Commands f)87 636 Q(or Mo)-.25 E(ving)-.1 E +(beginning\255of\255line \(C\255a\))108 648 Q F0(Mo)144 660 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 588 Q F0(Mo)144 600 Q .3 -.15(ve t) --.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108 612 S -(rward\255char \(C\255f\)).25 E F0(Mo)144 624 Q .3 -.15(ve f)-.15 H(orw) -.15 E(ard a character)-.1 E(.)-.55 E F1(backward\255char \(C\255b\))108 -636 Q F0(Mo)144 648 Q .3 -.15(ve b)-.15 H(ack a character).15 E(.)-.55 E -F1 -.25(fo)108 660 S(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 672 -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 684 Q F1(backward\255w)108 696 Q(ord \(M\255b\)) --.1 E F0(Mo)144 708 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 720 Q(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(5)197.895 E EP +(end\255of\255line \(C\255e\))108 672 Q F0(Mo)144 684 Q .3 -.15(ve t) +-.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108 696 S +(rward\255char \(C\255f\)).25 E F0(Mo)144 708 Q .3 -.15(ve f)-.15 H(orw) +.15 E(ard a character)-.1 E(.)-.55 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(5)195.95 E EP %%Page: 6 6 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 -/Times-Bold@0 SF(clear\255scr)108 84 Q(een \(C\255l\))-.18 E F0 .993 -(Clear the screen lea)144 96 R .993 +/Times-Bold@0 SF(backward\255char \(C\255b\))108 84 Q F0(Mo)144 96 Q .3 +-.15(ve b)-.15 H(ack a character).15 E(.)-.55 E F1 -.25(fo)108 108 S +(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 120 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 132 Q F1(backward\255w)108 144 Q(ord \(M\255b\)) +-.1 E F0(Mo)144 156 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 168 Q F1(clear\255scr)108 180 Q +(een \(C\255l\))-.18 E F0 .993(Clear the screen lea)144 192 R .993 (ving the current line at the top of the screen.)-.2 F -.4(Wi)5.993 G .993(th an ar).4 F .993(gument, refresh the)-.18 F -(current line without clearing the screen.)144 108 Q F1 -.18(re)108 120 +(current line without clearing the screen.)144 204 Q F1 -.18(re)108 216 S(draw\255curr).18 E(ent\255line)-.18 E F0(Refresh the current line.)144 -132 Q F1(Commands f)87 148.8 Q(or Manipulating the History)-.25 E -(accept\255line \(Newline, Retur)108 160.8 Q(n\))-.15 E F0 .365 -(Accept the line re)144 172.8 R -.05(ga)-.15 G .364 +228 Q F1(Commands f)87 244.8 Q(or Manipulating the History)-.25 E +(accept\255line \(Newline, Retur)108 256.8 Q(n\))-.15 E F0 .365 +(Accept the line re)144 268.8 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 184.8 R F1 +F .74(history list for future recall with)144 280.8 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 196.8 Q F1(pr)108 208.8 Q +(line is restored to its original state.)144 292.8 Q F1(pr)108 304.8 Q -.15(ev)-.18 G(ious\255history \(C\255p\)).15 E F0(Fetch the pre)144 -220.8 Q(vious command from the history list, mo)-.25 E -(ving back in the list.)-.15 E F1(next\255history \(C\255n\))108 232.8 Q -F0(Fetch the ne)144 244.8 Q(xt command from the history list, mo)-.15 E +316.8 Q(vious command from the history list, mo)-.25 E +(ving back in the list.)-.15 E F1(next\255history \(C\255n\))108 328.8 Q +F0(Fetch the ne)144 340.8 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 256.8 Q F0(Mo)144 268.8 Q .3 +(beginning\255of\255history \(M\255<\))108 352.8 Q F0(Mo)144 364.8 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 280.8 Q F0(Mo)144 292.8 Q +-.65 E F1(end\255of\255history \(M\255>\))108 376.8 Q F0(Mo)144 388.8 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 -2.29 -.18 -(re v)108 304.8 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0 -1.471(Search backw)144 316.8 R 1.471 +(re v)108 400.8 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0 +1.471(Search backw)144 412.8 R 1.471 (ard starting at the current line and mo)-.1 F 1.47 (ving `up' through the history as necessary)-.15 F(.)-.65 E -(This is an incremental search.)144 328.8 Q F1 -.25(fo)108 340.8 S +(This is an incremental search.)144 424.8 Q F1 -.25(fo)108 436.8 S (rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.131 -(Search forw)144 352.8 R 1.131(ard starting at the current line and mo) +(Search forw)144 448.8 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 364.8 Q F1 -(non\255incr)108 376.8 Q(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H +-.25 F(.)-.65 E(This is an incremental search.)144 460.8 Q F1 +(non\255incr)108 472.8 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 388.8 R .164(ard through the history starting at the current line u\ -sing a non-incremental search for)-.1 F 2.5(as)144 400.8 S -(tring supplied by the user)-2.5 E(.)-.55 E F1(non\255incr)108 412.8 Q +144 484.8 R .164(ard through the history starting at the current line u\ +sing a non-incremental search for)-.1 F 2.5(as)144 496.8 S +(tring supplied by the user)-2.5 E(.)-.55 E F1(non\255incr)108 508.8 Q (emental\255f)-.18 E(orward\255sear)-.25 E(ch\255history \(M\255n\))-.18 -E F0 1.353(Search forw)144 424.8 R 1.354(ard through the history using \ +E F0 1.353(Search forw)144 520.8 R 1.354(ard through the history using \ a non-incremental search for a string supplied by the)-.1 F(user)144 -436.8 Q(.)-.55 E F1(history\255sear)108 448.8 Q(ch\255f)-.18 E(orward) --.25 E F0 .249(Search forw)144 460.8 R .249(ard through the history for\ +532.8 Q(.)-.55 E F1(history\255sear)108 544.8 Q(ch\255f)-.18 E(orward) +-.25 E F0 .249(Search forw)144 556.8 R .249(ard through the history for\ the string of characters between the start of the current line)-.1 F -(and the current cursor position \(the)144 472.8 Q/F2 10/Times-Italic@0 +(and the current cursor position \(the)144 568.8 Q/F2 10/Times-Italic@0 SF(point)2.5 E F0 2.5(\). This)B(is a non-incremental search.)2.5 E F1 -(history\255sear)108 484.8 Q(ch\255backward)-.18 E F0 .95(Search backw) -144 496.8 R .951(ard through the history for the string of characters b\ -etween the start of the current)-.1 F(line and the point.)144 508.8 Q -(This is a non-incremental search.)5 E F1(yank\255nth\255ar)108 520.8 Q +(history\255sear)108 580.8 Q(ch\255backward)-.18 E F0 .95(Search backw) +144 592.8 R .951(ard through the history for the string of characters b\ +etween the start of the current)-.1 F(line and the point.)144 604.8 Q +(This is a non-incremental search.)5 E F1(yank\255nth\255ar)108 616.8 Q 2.5(g\()-.1 G<4dad43ad7929>-2.5 E F0 .622(Insert the \214rst ar)144 -532.8 R .622(gument to the pre)-.18 F .622 +628.8 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 .794(at point.)144 544.8 R -.4(Wi)5.794 G .794 +.622(vious line\))-.25 F .794(at point.)144 640.8 R -.4(Wi)5.794 G .794 (th an ar).4 F(gument)-.18 E F2(n)3.294 E F0 3.294(,i).24 G .794 (nsert the)-3.294 F F2(n)3.294 E F0 .794(th w)B .794(ord from the pre) -.1 F .794(vious command \(the w)-.25 F .795(ords in the)-.1 F(pre)144 -556.8 Q .292(vious command be)-.25 F .292(gin with w)-.15 F .291 +652.8 Q .292(vious command be)-.25 F .292(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(the pre)144 568.8 Q -(vious command.)-.25 E F1(yank\255last\255ar)108 580.8 Q 2.5(g\()-.1 G +F0 .291(th w)B .291(ord from the end of)-.1 F(the pre)144 664.8 Q +(vious command.)-.25 E F1(yank\255last\255ar)108 676.8 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 592.8 R 1.307(gument to the pre)-.18 F 1.307 +(Insert the last ar)144 688.8 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 604.8 S .736(th an ar).4 F +(vious history entry\).)-.25 F -.4(Wi)144 700.8 S .736(th an ar).4 F .736(gument, beha)-.18 F 1.036 -.15(ve ex)-.2 H .736(actly lik).15 F(e) -.1 E F1(yank\255nth\255ar)3.235 E(g)-.1 E F0 5.735(.S)C(uccessi)-5.735 E 1.035 -.15(ve c)-.25 H .735(alls to).15 F F1(yank\255last\255ar)3.235 E(g)-.1 E F0(mo)3.235 E -.15(ve)-.15 G -(back through the history list, inserting the last ar)144 616.8 Q -(gument of each line in turn.)-.18 E F1(Commands f)87 633.6 Q -(or Changing T)-.25 E(ext)-.92 E(delete\255char \(C\255d\))108 645.6 Q -F0 .357(Delete the character at point.)144 657.6 R .358 -(If point is at the be)5.358 F .358 -(ginning of the line, there are no characters in the)-.15 F -(line, and the last character typed w)144 669.6 Q(as not bound to)-.1 E -F1(delete\255char)2.5 E F0 2.5(,t)C(hen return)-2.5 E/F3 9/Times-Bold@0 -SF(EOF)2.5 E/F4 9/Times-Roman@0 SF(.)A F1 -(backward\255delete\255char \(Rubout\))108 681.6 Q F0 .553 -(Delete the character behind the cursor)144 693.6 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 -.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 705.6 Q(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(6)197.895 E EP +(back through the history list, inserting the last ar)144 712.8 Q +(gument of each line in turn.)-.18 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(6)195.95 E EP %%Page: 7 7 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 -/Times-Bold@0 SF -.25(fo)108 84 S(rward\255backward\255delete\255char) -.25 E F0 .473(Delete the character under the cursor)144 96 R 2.973(,u) --.4 G .474 +/Times-Bold@0 SF(Commands f)87 84 Q(or Changing T)-.25 E(ext)-.92 E +(delete\255char \(C\255d\))108 96 Q F0 .357 +(Delete the character at point.)144 108 R .358(If point is at the be) +5.358 F .358(ginning of the line, there are no characters in the)-.15 F +(line, and the last character typed w)144 120 Q(as not bound to)-.1 E F1 +(delete\255char)2.5 E F0 2.5(,t)C(hen return)-2.5 E/F2 9/Times-Bold@0 SF +(EOF)2.5 E/F3 9/Times-Roman@0 SF(.)A F1 +(backward\255delete\255char \(Rubout\))108 132 Q F0 .553 +(Delete the character behind the cursor)144 144 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 +.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 156 Q F1 -.25(fo)108 168 S +(rward\255backward\255delete\255char).25 E F0 .473 +(Delete the character under the cursor)144 180 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 108 Q F1 -(quoted\255insert \(C\255q, C\255v\))108 120 Q F0 1.229(Add the ne)144 -132 R 1.228(xt character that you type to the line v)-.15 F 3.728 +(character behind the cursor is deleted.)144 192 Q F1 +(quoted\255insert \(C\255q, C\255v\))108 204 Q F0 1.229(Add the ne)144 +216 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 144 Q -F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108 156 Q -(AB\))-.9 E F0(Insert a tab character)144 168 Q(.)-.55 E F1 -(self\255insert \(a, b, A, 1, !, ...\))108 180 Q F0 -(Insert the character typed.)144 192 Q F1(transpose\255chars \(C\255t\)) -108 204 Q F0 .321(Drag the character before point forw)144 216 R .321 +-3.728 G 1.228(nsert characters lik)-3.728 F(e)-.1 E F1(C\255q)144 228 Q +F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108 240 Q +(AB\))-.9 E F0(Insert a tab character)144 252 Q(.)-.55 E F1 +(self\255insert \(a, b, A, 1, !, ...\))108 264 Q F0 +(Insert the character typed.)144 276 Q F1(transpose\255chars \(C\255t\)) +108 288 Q F0 .321(Drag the character before point forw)144 300 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 1.182 -(If point is at the end of the line, then this transposes the tw)144 228 +(If point is at the end of the line, then this transposes the tw)144 312 R 3.682(oc)-.1 G 1.182(haracters before point.)-3.682 F(Ne)6.182 E -.05 -(ga)-.15 G(ti).05 E -.15(ve)-.25 G(ar)144 240 Q(guments ha)-.18 E .3 +(ga)-.15 G(ti).05 E -.15(ve)-.25 G(ar)144 324 Q(guments ha)-.18 E .3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1 -(transpose\255w)108 252 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144 -264 R .023(ord before point past the w)-.1 F .023(ord after point, mo) +(transpose\255w)108 336 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144 +348 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 276 Q 2.5 -(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 288 Q -(ord \(M\255u\))-.1 E F0 1.699(Uppercase the current \(or follo)144 300 +(is at the end of the line, this transposes the last tw)144 360 Q 2.5 +(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 372 Q +(ord \(M\255u\))-.1 E F0 1.699(Uppercase the current \(or follo)144 384 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 312 S(rd, b).1 E -(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 324 Q -(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 336 Q 1.647 +(ument, uppercase the pre).18 F(vious)-.25 E -.1(wo)144 396 S(rd, b).1 E +(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 408 Q +(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 420 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 348 S(rd, b).1 E(ut do not mo)-.2 E .3 --.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 360 Q -(ord \(M\255c\))-.1 E F0 1.975(Capitalize the current \(or follo)144 372 +-.25 F(vious)-.25 E -.1(wo)144 432 S(rd, b).1 E(ut do not mo)-.2 E .3 +-.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 444 Q +(ord \(M\255c\))-.1 E F0 1.975(Capitalize the current \(or follo)144 456 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 384 S(rd, b).1 -E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(Killing and Y)87 -400.8 Q(anking)-.85 E(kill\255line \(C\255k\))108 412.8 Q F0 -(Kill the te)144 424.8 Q(xt from point to the end of the line.)-.15 E F1 -(backward\255kill\255line \(C\255x Rubout\))108 436.8 Q F0(Kill backw) -144 448.8 Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1 -(unix\255line\255discard \(C\255u\))108 460.8 Q F0(Kill backw)144 472.8 +(ument, capitalize the pre).18 F(vious)-.25 E -.1(wo)144 468 S(rd, b).1 +E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1 -.1(ove)108 480 +S(rwrite\255mode).1 E F0 -.8(To)144 492 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 504 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 .78(This command af)5.781 F +(fects)-.25 E(only)144 516 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/F4 10 +/Times-Italic@0 SF -.37(re)4.395 G(adline\(\)).37 E F0 1.895 +(starts in insert)4.395 F 3.969(mode. In)144 528 R -.15(ove)3.969 G +1.469(rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E +F0 1.468(replace the te)3.969 F 1.468(xt at point rather than)-.15 F +.957(pushing the te)144 540 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 552 Q +(By def)5 E(ault, this command is unbound.)-.1 E F1(Killing and Y)87 +568.8 Q(anking)-.85 E(kill\255line \(C\255k\))108 580.8 Q F0 +(Kill the te)144 592.8 Q(xt from point to the end of the line.)-.15 E F1 +(backward\255kill\255line \(C\255x Rubout\))108 604.8 Q F0(Kill backw) +144 616.8 Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1 +(unix\255line\255discard \(C\255u\))108 628.8 Q F0(Kill backw)144 640.8 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 484.8 Q F0 +-2.5 G(he kill-ring.)-2.5 E F1(kill\255whole\255line)108 652.8 Q F0 (Kill all characters on the current line, no matter where point is.)144 -496.8 Q F1(kill\255w)108 508.8 Q(ord \(M\255d\))-.1 E F0 1.308 -(Kill from point the end of the current w)144 520.8 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 532.8 S +664.8 Q F1(kill\255w)108 676.8 Q(ord \(M\255d\))-.1 E F0 1.308 +(Kill from point the end of the current w)144 688.8 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 700.8 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 544.8 Q -(ord \(M\255Rubout\))-.1 E F0(Kill the w)144 556.8 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 568.8 Q -(ord\255rubout \(C\255w\))-.1 E F0 .365(Kill the w)144 580.8 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 -592.8 Q F1(delete\255horizontal\255space \(M\255\\\))108 604.8 Q F0 -(Delete all spaces and tabs around point.)144 616.8 Q F1(kill\255r)108 -628.8 Q(egion)-.18 E F0 1.13(Kill the te)144 640.8 R 1.13 -(xt between the point and)-.15 F/F2 10/Times-Italic@0 SF(mark)3.63 E F0 -(\(sa)3.63 E -.15(ve)-.2 G 3.63(dc).15 G 1.13(ursor position\).)-3.63 F -1.13(This te)6.13 F 1.13(xt is referred to as the)-.15 F F2 -.37(re)144 -652.8 S(gion)-.03 E F0(.)A F1(copy\255r)108 664.8 Q(egion\255as\255kill) --.18 E F0(Cop)144 676.8 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 688.8 Q(ord)-.1 E F0(Cop)144 700.8 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 712.8 -Q(ord)-.1 E F0(.)A(GNU Readline 4.2a)72 768 Q(2001 October 9)123.745 E -(7)197.895 E EP +(rward\255w).25 E(ord)-.1 E F0(.)A(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(7)195.95 E EP %%Page: 8 8 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 -/Times-Bold@0 SF(copy\255f)108 84 Q(orward\255w)-.25 E(ord)-.1 E F0(Cop) -144 96 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 108 Q(ord)-.1 E F0(.)A F1 -(yank \(C\255y\))108 120 Q F0 -1(Ya)144 132 S +/Times-Bold@0 SF(backward\255kill\255w)108 84 Q(ord \(M\255Rubout\))-.1 +E F0(Kill the w)144 96 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 108 Q(ord\255rubout \(C\255w\))-.1 E +F0 .364(Kill the w)144 120 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 +132 Q F1(delete\255horizontal\255space \(M\255\\\))108 144 Q F0 +(Delete all spaces and tabs around point.)144 156 Q F1(kill\255r)108 168 +Q(egion)-.18 E F0 1.13(Kill the te)144 180 R 1.13 +(xt between the point and)-.15 F/F2 10/Times-Italic@0 SF(mark)3.63 E F0 +(\(sa)3.63 E -.15(ve)-.2 G 3.63(dc).15 G 1.13(ursor position\).)-3.63 F +1.13(This te)6.13 F 1.13(xt is referred to as the)-.15 F F2 -.37(re)144 +192 S(gion)-.03 E F0(.)A F1(copy\255r)108 204 Q(egion\255as\255kill)-.18 +E F0(Cop)144 216 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 228 Q(ord)-.1 E F0(Cop)144 240 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 252 +Q(ord)-.1 E F0(.)A F1(copy\255f)108 264 Q(orward\255w)-.25 E(ord)-.1 E +F0(Cop)144 276 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 288 Q(ord)-.1 E F0(.)A F1 +(yank \(C\255y\))108 300 Q F0 -1(Ya)144 312 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 144 Q F0 -(Rotate the kill ring, and yank the ne)144 156 Q 2.5(wt)-.25 G 2.5 +E F1(yank\255pop \(M\255y\))108 324 Q F0 +(Rotate the kill ring, and yank the ne)144 336 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 172.8 Q -(guments)-.1 E(digit\255ar)108 184.8 Q -(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .642 -(Add this digit to the ar)144 196.8 R .641 +F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 352.8 Q +(guments)-.1 E(digit\255ar)108 364.8 Q +(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .641 +(Add this digit to the ar)144 376.8 R .641 (gument already accumulating, or start a ne)-.18 F 3.141(wa)-.25 G -.18 -(rg)-3.141 G 3.141(ument. M\255\255).18 F .641(starts a ne)3.141 F(g-) --.15 E(ati)144 208.8 Q .3 -.15(ve a)-.25 H -.18(rg).15 G(ument.).18 E F1 -(uni)108 220.8 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0 .778 -(This is another w)144 232.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 +(rg)-3.141 G 3.142(ument. M\255\255).18 F .642(starts a ne)3.142 F(g-) +-.15 E(ati)144 388.8 Q .3 -.15(ve a)-.25 H -.18(rg).15 G(ument.).18 E F1 +(uni)108 400.8 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0 .779 +(This is another w)144 412.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 (wed by one or more digits,)-.25 F 1.376 (optionally with a leading minus sign, those digits de\214ne the ar)144 -244.8 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 -256.8 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni) +424.8 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 +436.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 .899(wise ignored.)144 268.8 R .898 -(As a special case, if this command is immediately follo)5.899 F .898 +-.2 F(-)-.2 E .898(wise ignored.)144 448.8 R .898 +(As a special case, if this command is immediately follo)5.898 F .898 (wed by a character that is)-.25 F .243 -(neither a digit or minus sign, the ar)144 280.8 R .243 +(neither a digit or minus sign, the ar)144 460.8 R .243 (gument count for the ne)-.18 F .243(xt command is multiplied by four) --.15 F 5.243(.T)-.55 G(he)-5.243 E(ar)144 292.8 Q .378 +-.15 F 5.242(.T)-.55 G(he)-5.242 E(ar)144 472.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 304.8 Q 2.5(,as)-.4 G(econd time mak) +.378(gument count)-.18 F(four)144 484.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 321.6 Q(complete \(T)108 333.6 Q(AB\))-.9 E F0 1.908 -(Attempt to perform completion on the te)144 345.6 R 1.908 -(xt before point.)-.15 F 1.909(The actual completion performed is)6.909 -F(application-speci\214c.)144 357.6 Q F1(Bash)5.518 E F0 3.018(,f)C .518 -(or instance, attempts completion treating the te)-3.018 F .517 -(xt as a v)-.15 F .517(ariable \(if the)-.25 F(te)144 369.6 Q .656 -(xt be)-.15 F .656(gins with)-.15 F F1($)3.156 E F0 .656 +(Completing)87 501.6 Q(complete \(T)108 513.6 Q(AB\))-.9 E F0 1.909 +(Attempt to perform completion on the te)144 525.6 R 1.908 +(xt before point.)-.15 F 1.908(The actual completion performed is)6.908 +F(application-speci\214c.)144 537.6 Q F1(Bash)5.517 E F0 3.017(,f)C .518 +(or instance, attempts completion treating the te)-3.017 F .518 +(xt as a v)-.15 F .518(ariable \(if the)-.25 F(te)144 549.6 Q .657 +(xt be)-.15 F .657(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.157 E F0 .657(\), or)B .93 -(command \(including aliases and functions\) in turn.)144 381.6 R .929 -(If none of these produces a match, \214lename)5.929 F 1.273 -(completion is attempted.)144 393.6 R F1(Gdb)6.273 E F0 3.773(,o)C 3.773 +(gins with)-.15 F F1(@)3.156 E F0 .656(\), or)B .929 +(command \(including aliases and functions\) in turn.)144 561.6 R .93 +(If none of these produces a match, \214lename)5.929 F 1.274 +(completion is attempted.)144 573.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 405.6 S(riab\ +(ws completion of program functions and)-.25 F -.25(va)144 585.6 S(riab\ les, and only attempts \214lename completion under certain circumstance\ -s.).25 E F1(possible\255completions \(M\255?\))108 417.6 Q F0 -(List the possible completions of the te)144 429.6 Q(xt before point.) --.15 E F1(insert\255completions \(M\255*\))108 441.6 Q F0 .783 -(Insert all completions of the te)144 453.6 R .783 +s.).25 E F1(possible\255completions \(M\255?\))108 597.6 Q F0 +(List the possible completions of the te)144 609.6 Q(xt before point.) +-.15 E F1(insert\255completions \(M\255*\))108 621.6 Q F0 .783 +(Insert all completions of the te)144 633.6 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.282 E(pletions)144 -465.6 Q F0(.)A F1(menu\255complete)108 477.6 Q F0 .928(Similar to)144 -489.6 R F1(complete)3.428 E F0 3.428(,b)C .929(ut replaces the w)-3.628 +.783(een generated by).15 F F1(possible\255com-)3.283 E(pletions)144 +645.6 Q F0(.)A F1(menu\255complete)108 657.6 Q F0 .929(Similar to)144 +669.6 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.194(possible completions.)144 501.6 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 513.6 R .828 -(At the end of the list of completions, the bell is rung)5.828 F 1.927 -(\(subject to the setting of Bbell\255style)144 525.6 R F1 4.427(\)a)C -1.927(nd the original text is r)-4.427 F(estor)-.18 E 4.426(ed. An)-.18 -F(ar)4.426 E 1.926(gument of)-.1 F/F2 10/Times-Italic@0 SF(n)4.426 E F1 -(mo)144 537.6 Q -.1(ve)-.1 G(s).1 E F2(n)3.145 E F1 .645(positions f) -3.145 F .645(orward in the list of matches; a negati)-.25 F .845 -.1 -(ve a)-.1 H -.1(rg).1 G .645(ument may be used to mo).1 F -.1(ve)-.1 G -.666(backward thr)144 549.6 R .666(ough the list.)-.18 F .665 -(This command is intended to be bound to T)5.666 F .665(AB, b)-.9 F .665 -(ut is unbound)-.2 F(by default.)144 561.6 Q -(delete\255char\255or\255list)108 573.6 Q F0 .373 -(Deletes the character under the cursor if not at the be)144 585.6 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 597.6 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 614.4 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr) -108 626.4 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 638.4 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 650.4 Q 2.5(o\() --.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 662.4 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 674.4 Q 2.5(o\()-.18 G(C\255x e\))-2.5 -E F0(Re-e)144 686.4 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 698.4 Q -.15(ey)-.1 G(board.).15 E -(GNU Readline 4.2a)72 768 Q(2001 October 9)123.745 E(8)197.895 E EP +1.193(possible completions.)144 681.6 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 693.6 R .828 +(At the end of the list of completions, the bell is rung)5.828 F .965 +(\(subject to the setting of)144 705.6 R F1 .965 +(0and the original text is r)3.465 F(estor)-.18 E 3.465(ed. An)-.18 F +(ar)3.465 E .966(gument of)-.1 F F2(n)3.466 E F1(mo)3.466 E -.1(ve)-.1 G +(s).1 E F2(n)3.466 E F1(posi-)3.466 E 1.249(tions f)144 717.6 R 1.249 +(orward in the list of matches; a negati)-.25 F 1.449 -.1(ve a)-.1 H -.1 +(rg).1 G 1.248(ument may be used to mo).1 F 1.448 -.1(ve b)-.1 H +(ackward).1 E(thr)144 729.6 Q(ough the list.)-.18 E +(This command is intended to be bound to T)5 E(AB, b)-.9 E +(ut is unbound by default.)-.2 E F0(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(8)195.95 E EP %%Page: 9 9 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 -/Times-Bold@0 SF(Miscellaneous)87 84 Q -.18(re)108 96 S<ad72>.18 E +/Times-Bold@0 SF(delete\255char\255or\255list)108 84 Q F0 .373 +(Deletes the character under the cursor if not at the be)144 96 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 108 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 124.8 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)108 +136.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 148.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 160.8 Q 2.5(o\() +-.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 172.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 184.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5 +E F0(Re-e)144 196.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 208.8 Q -.15(ey)-.1 G(board.).15 E F1 +(Miscellaneous)87 225.6 Q -.18(re)108 237.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 108 R/F2 10/Times-Italic@0 SF(inputr) +(Read in the contents of the)144 249.6 R/F2 10/Times-Italic@0 SF(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 120 Q F1(abort \(C\255g\))108 132 Q F0 3.249 -(Abort the current editing command and ring the terminal')144 144 R +(found there.)144 261.6 Q F1(abort \(C\255g\))108 273.6 Q F0 3.249 +(Abort the current editing command and ring the terminal')144 285.6 R 5.748(sb)-.55 G 3.248(ell \(subject to the setting of)-5.748 F F1 -(bell\255style)144 156 Q F0(\).)A F1(do\255upper)108 168 Q(case\255v) --.18 E(ersion \(M\255a, M\255b, M\255)-.1 E F2(x)A F1 2.5(,.)C(..\))-2.5 -E F0 1.755(If the meta\214ed character)144 180 R F2(x)4.255 E F0 1.755 -(is lo)4.255 F 1.756 +(bell\255style)144 297.6 Q F0(\).)A F1(do\255upper)108 309.6 Q +(case\255v)-.18 E(ersion \(M\255a, M\255b, M\255)-.1 E F2(x)A F1 2.5(,.) +C(..\))-2.5 E F0 1.755(If the meta\214ed character)144 321.6 R F2(x) +4.255 E F0 1.755(is lo)4.255 F 1.756 (wercase, run the command that is bound to the corresponding)-.25 F -(uppercase character)144 192 Q(.)-.55 E F1(pr)108 204 Q -(e\214x\255meta \(ESC\))-.18 E F0(Metafy the ne)144 216 Q +(uppercase character)144 333.6 Q(.)-.55 E F1(pr)108 345.6 Q +(e\214x\255meta \(ESC\))-.18 E F0(Metafy the ne)144 357.6 Q (xt character typed.)-.15 E/F3 9/Times-Bold@0 SF(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 228 Q F0 -(Incremental undo, separately remembered for each line.)144 240 Q F1 --2.29 -.18(re v)108 252 T(ert\255line \(M\255r\)).08 E F0 1.095 -(Undo all changes made to this line.)144 264 R 1.095(This is lik)6.095 F -3.595(ee)-.1 G -.15(xe)-3.745 G 1.095(cuting the).15 F F1(undo)3.595 E +(undo \(C\255_, C\255x C\255u\))108 369.6 Q F0 +(Incremental undo, separately remembered for each line.)144 381.6 Q F1 +-2.29 -.18(re v)108 393.6 T(ert\255line \(M\255r\)).08 E F0 1.095 +(Undo all changes made to this line.)144 405.6 R 1.095(This is lik)6.095 +F 3.595(ee)-.1 G -.15(xe)-3.745 G 1.095(cuting the).15 F F1(undo)3.595 E F0 1.095(command enough times to)3.595 F -(return the line to its initial state.)144 276 Q F1 -(tilde\255expand \(M\255&\))108 288 Q F0(Perform tilde e)144 300 Q +(return the line to its initial state.)144 417.6 Q F1 +(tilde\255expand \(M\255&\))108 429.6 Q F0(Perform tilde e)144 441.6 Q (xpansion on the current w)-.15 E(ord.)-.1 E F1 -(set\255mark \(C\255@, M\255<space>\))108 312 Q F0 -(Set the mark to the point.)144 324 Q(If a numeric ar)5 E +(set\255mark \(C\255@, M\255<space>\))108 453.6 Q F0 +(Set the mark to the point.)144 465.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 336 Q F0(Sw)144 -348 Q .282(ap the point with the mark.)-.1 F .283 +(exchange\255point\255and\255mark \(C\255x C\255x\))108 477.6 Q F0(Sw) +144 489.6 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 360 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 372 Q(ch \(C\255]\))-.18 E F0 3.036(Ac)144 384 S -.536(haracter is read and point is mo)-3.036 F -.15(ve)-.15 G 3.035(dt) -.15 G 3.035(ot)-3.035 G .535(he ne)-3.035 F .535 +144 501.6 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 513.6 Q(ch \(C\255]\))-.18 E F0 3.036(Ac)144 +525.6 S .536(haracter is read and point is mo)-3.036 F -.15(ve)-.15 G +3.035(dt).15 G 3.035(ot)-3.035 G .535(he ne)-3.035 F .535 (xt occurrence of that character)-.15 F 5.535(.A)-.55 G(ne)-2.5 E -.05 (ga)-.15 G(ti).05 E .835 -.15(ve c)-.25 H(ount).15 E(searches for pre) -144 396 Q(vious occurrences.)-.25 E F1(character\255sear)108 408 Q -(ch\255backward \(M\255C\255]\))-.18 E F0 3.543(Ac)144 420 S 1.043 +144 537.6 Q(vious occurrences.)-.25 E F1(character\255sear)108 549.6 Q +(ch\255backward \(M\255C\255]\))-.18 E F0 3.543(Ac)144 561.6 S 1.043 (haracter is read and point is mo)-3.543 F -.15(ve)-.15 G 3.544(dt).15 G 3.544(ot)-3.544 G 1.044(he pre)-3.544 F 1.044 (vious occurrence of that character)-.25 F 6.044(.A)-.55 G(ne)-2.5 E -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G -(count searches for subsequent occurrences.)144 432 Q F1 -(insert\255comment \(M\255#\))108 444 Q F0 .291(The v)144 456 R .291 -(alue of the readline)-.25 F F1(comment\255begin)2.791 E F0 -.25(va) -2.791 G .291(riable is inserted at the be).25 F .29 -(ginning of the current line,)-.15 F 1.277 -(and the line is accepted as if a ne)144 468 R 1.277 -(wline had been typed.)-.25 F 1.277(The def)6.277 F 1.277(ault v)-.1 F -1.277(alue of)-.25 F F1(comment\255begin)3.777 E F0(mak)144 480 Q -(es the current line a shell comment.)-.1 E F1(dump\255functions)108 492 -Q F0 .627(Print all of the functions and their k)144 504 R .927 -.15 -(ey b)-.1 H .626(indings to the readline output stream.).15 F .626 +(count searches for subsequent occurrences.)144 573.6 Q F1 +(insert\255comment \(M\255#\))108 585.6 Q F0 -.4(Wi)144 597.6 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 609.6 Q .097 +(ginning of the current line.)-.15 F .098(If a numeric ar)5.097 F .098 +(gument is supplied, this command acts as a toggle:)-.18 F(if)5.098 E +.322(the characters at the be)144 621.6 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.821(,t)C .321(he v)-2.821 F .321(alue is) +-.25 F 1.013(inserted, otherwise the characters in)144 633.6 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 645.6 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 657.6 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 669.6 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 +681.6 Q F0 .627(Print all of the functions and their k)144 693.6 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 516 Q +(ment is supplied, the output is formatted in such a w)144 705.6 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\255v)108 528 Q(ariables)-.1 E F0 .283 -(Print all of the settable v)144 540 R .283(ariables and their v)-.25 F +(\214le.)2.5 E(GNU Readline 4.3)72 768 Q(2002 January 22)126.24 E(9) +195.95 E EP +%%Page: 10 10 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 +/Times-Bold@0 SF(dump\255v)108 84 Q(ariables)-.1 E F0 .283 +(Print all of the settable v)144 96 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 552 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 564 Q(os)-.18 E F0 .756 -(Print all of the readline k)144 576 R 1.056 -.15(ey s)-.1 H .756 +(ment is supplied, the output is formatted in such a w)144 108 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\255macr)108 120 Q(os)-.18 E F0 +.756(Print all of the readline k)144 132 R 1.056 -.15(ey s)-.1 H .756 (equences bound to macros and the strings the).15 F 3.256(yo)-.15 G -3.256(uput. If)-3.256 F 3.255(an)3.255 G(umeric)-3.255 E(ar)144 588 Q +3.256(uput. If)-3.256 F 3.255(an)3.255 G(umeric)-3.255 E(ar)144 144 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.028 E(c)-.37 E F0 -(\214le.)144 600 Q F1(emacs\255editing\255mode \(C\255e\))108 612 Q F0 -(When in)144 624 Q F1(vi)2.5 E F0(editing mode, this causes a switch to) +(\214le.)144 156 Q F1(emacs\255editing\255mode \(C\255e\))108 168 Q F0 +(When in)144 180 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 636 Q F0(When in)144 648 Q F1 +(vi\255editing\255mode \(M\255C\255j\))108 192 Q F0(When in)144 204 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/F4 10.95/Times-Bold@0 SF(DEF)72 664.8 Q -.548(AU) +F0(editing mode.)2.5 E/F3 10.95/Times-Bold@0 SF(DEF)72 220.8 Q -.548(AU) -.986 G 2.014 -1.007(LT K).548 H(EY BINDINGS)1.007 E F0 .065(The follo) -108 676.8 R .065(wing is a list of the def)-.25 F .065 +108 232.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 .615 -(M\255<character>, and are referred to as)108 688.8 R F2(meta\214ed) +(M\255<character>, and are referred to as)108 244.8 R F2(meta\214ed) 3.115 E F0 3.115(characters. The)3.115 F .616 (printable ASCII characters not mentioned)3.116 F 1.116 -(in the list of emacs standard bindings are bound to the)108 700.8 R F1 +(in the list of emacs standard bindings are bound to the)108 256.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 -712.8 R .945(In vi insertion mode, all characters not speci\214cally me\ -ntioned are bound to)5.945 F F1(self\255insert)108 724.8 Q F0 5.359(.C)C +268.8 R .945(In vi insertion mode, all characters not speci\214cally me\ +ntioned are bound to)5.945 F F1(self\255insert)108 280.8 Q F0 5.359(.C)C .359(haracters assigned to signal generation by)-5.359 F F2(stty)2.859 E F0 .359(\(1\) or the terminal dri).32 F -.15(ve)-.25 G 1.159 -.4(r, s) -.15 H .358(uch as C-Z or C-C,).4 F(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(9)197.895 E EP -%%Page: 10 10 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R .187 -(retain that function.)108 84 R .187(Upper and lo)5.187 F .188(wer case\ - meta\214ed characters are bound to the same function in the emacs)-.25 -F .305(mode meta k)108 96 R -.15(ey)-.1 G 2.805(map. The).15 F .305(rem\ -aining characters are unbound, which causes readline to ring the bell \ -\(subject)2.805 F(to the setting of the)108 108 Q/F1 10/Times-Bold@0 SF -(bell\255style)2.5 E F0 -.25(va)2.5 G(riable\).).25 E F1(Emacs Mode)87 -124.8 Q F0(Emacs Standard bindings)151.2 136.8 Q 2.5("C-@" set-mark) -151.2 160.8 R 2.5("C-A" be)151.2 172.8 R(ginning-of-line)-.15 E 2.5 -("C-B" backw)151.2 184.8 R(ard-char)-.1 E 2.5("C-D" delete-char)151.2 -196.8 R 2.5("C-E" end-of-line)151.2 208.8 R 2.5("C-F" forw)151.2 220.8 R -(ard-char)-.1 E 2.5("C-G" abort)151.2 232.8 R 2.5("C-H" backw)151.2 -244.8 R(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 256.8 R 2.5 -("C-J" accept-line)151.2 268.8 R 2.5("C-K" kill-line)151.2 280.8 R 2.5 -("C-L" clear)151.2 292.8 R(-screen)-.2 E 2.5("C-M" accept-line)151.2 -304.8 R 2.5("C-N" ne)151.2 316.8 R(xt-history)-.15 E 2.5("C-P" pre)151.2 -328.8 R(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 340.8 R 2.5 -("C-R" re)151.2 352.8 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 -("C-S" forw)151.2 364.8 R(ard-search-history)-.1 E 2.5 -("C-T" transpose-chars)151.2 376.8 R 2.5("C-U" unix-line-discard)151.2 -388.8 R 2.5("C-V" quoted-insert)151.2 400.8 R 2.5("C-W" unix-w)151.2 -412.8 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 424.8 R 2.5 -("C-]" character)151.2 436.8 R(-search)-.2 E 2.5("C-_" undo)151.2 448.8 -R 3.333("")151.2 460.8 S(to "/")-.833 E(self-insert)5 E 2.5("0" to)151.2 -472.8 R 2.5("9" self-insert)2.5 F 2.5(":" to)151.2 484.8 R 2.5 -("~" self-insert)2.5 F 2.5("C-?" backw)151.2 496.8 R(ard-delete-char)-.1 -E(Emacs Meta bindings)151.2 513.6 Q 2.5("M-C-G" abort)151.2 537.6 R 2.5 -("M-C-H" backw)151.2 549.6 R(ard-kill-w)-.1 E(ord)-.1 E 2.5 -("M-C-I" tab-insert)151.2 561.6 R 2.5("M-C-J" vi-editing-mode)151.2 -573.6 R 2.5("M-C-M" vi-editing-mode)151.2 585.6 R 2.5("M-C-R" re)151.2 -597.6 R -.15(ve)-.25 G(rt-line).15 E 2.5("M-C-Y" yank-nth-ar)151.2 609.6 -R(g)-.18 E 2.5("M-C-[" complete)151.2 621.6 R 2.5("M-C-]" character) -151.2 633.6 R(-search-backw)-.2 E(ard)-.1 E 2.5("M-space" set-mark)151.2 -645.6 R 2.5("M-#" insert-comment)151.2 657.6 R 2.5("M-&" tilde-e)151.2 -669.6 R(xpand)-.15 E 2.5("M-*" insert-completions)151.2 681.6 R 2.5 -("M--" digit-ar)151.2 693.6 R(gument)-.18 E 2.5("M-." yank-last-ar)151.2 -705.6 R(g)-.18 E 2.5("M-0" digit-ar)151.2 717.6 R(gument)-.18 E 2.5 -("M-1" digit-ar)151.2 729.6 R(gument)-.18 E(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(10)192.895 E EP +.15 H .358(uch as C-Z or C-C,).4 F .187(retain that function.)108 292.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 304.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 316.8 Q F1(bell\255style)2.5 E F0 -.25(va)2.5 +G(riable\).).25 E F1(Emacs Mode)87 333.6 Q F0(Emacs Standard bindings) +151.2 345.6 Q 2.5("C-@" set-mark)151.2 369.6 R 2.5("C-A" be)151.2 381.6 +R(ginning-of-line)-.15 E 2.5("C-B" backw)151.2 393.6 R(ard-char)-.1 E +2.5("C-D" delete-char)151.2 405.6 R 2.5("C-E" end-of-line)151.2 417.6 R +2.5("C-F" forw)151.2 429.6 R(ard-char)-.1 E 2.5("C-G" abort)151.2 441.6 +R 2.5("C-H" backw)151.2 453.6 R(ard-delete-char)-.1 E 2.5 +("C-I" complete)151.2 465.6 R 2.5("C-J" accept-line)151.2 477.6 R 2.5 +("C-K" kill-line)151.2 489.6 R 2.5("C-L" clear)151.2 501.6 R(-screen)-.2 +E 2.5("C-M" accept-line)151.2 513.6 R 2.5("C-N" ne)151.2 525.6 R +(xt-history)-.15 E 2.5("C-P" pre)151.2 537.6 R(vious-history)-.25 E 2.5 +("C-Q" quoted-insert)151.2 549.6 R 2.5("C-R" re)151.2 561.6 R -.15(ve) +-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2 573.6 R +(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 585.6 R 2.5 +("C-U" unix-line-discard)151.2 597.6 R 2.5("C-V" quoted-insert)151.2 +609.6 R 2.5("C-W" unix-w)151.2 621.6 R(ord-rubout)-.1 E 2.5("C-Y" yank) +151.2 633.6 R 2.5("C-]" character)151.2 645.6 R(-search)-.2 E 2.5 +("C-_" undo)151.2 657.6 R 3.333("")151.2 669.6 S(to "/")-.833 E +(self-insert)5 E 2.5("0" to)151.2 681.6 R 2.5("9" self-insert)2.5 F 2.5 +(":" to)151.2 693.6 R 2.5("~" self-insert)2.5 F 2.5("C-?" backw)151.2 +705.6 R(ard-delete-char)-.1 E(Emacs Meta bindings)151.2 722.4 Q +(GNU Readline 4.3)72 768 Q(2002 January 22)126.24 E(10)190.95 E EP %%Page: 11 11 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 2.5 -("M-2" digit-ar)151.2 84 R(gument)-.18 E 2.5("M-3" digit-ar)151.2 96 R -(gument)-.18 E 2.5("M-4" digit-ar)151.2 108 R(gument)-.18 E 2.5 -("M-5" digit-ar)151.2 120 R(gument)-.18 E 2.5("M-6" digit-ar)151.2 132 R -(gument)-.18 E 2.5("M-7" digit-ar)151.2 144 R(gument)-.18 E 2.5 -("M-8" digit-ar)151.2 156 R(gument)-.18 E 2.5("M-9" digit-ar)151.2 168 R -(gument)-.18 E 2.5("M-<" be)151.2 180 R(ginning-of-history)-.15 E 2.5 -("M-=" possible-completions)151.2 192 R 2.5("M->" end-of-history)151.2 -204 R 2.5("M-?" possible-completions)151.2 216 R 2.5("M-B" backw)151.2 -228 R(ard-w)-.1 E(ord)-.1 E 2.5("M-C" capitalize-w)151.2 240 R(ord)-.1 E -2.5("M-D" kill-w)151.2 252 R(ord)-.1 E 2.5("M-F" forw)151.2 264 R(ard-w) --.1 E(ord)-.1 E 2.5("M-L" do)151.2 276 R(wncase-w)-.25 E(ord)-.1 E 2.5 -("M-N" non-incremental-forw)151.2 288 R(ard-search-history)-.1 E 2.5 -("M-P" non-incremental-re)151.2 300 R -.15(ve)-.25 G(rse-search-history) -.15 E 2.5("M-R" re)151.2 312 R -.15(ve)-.25 G(rt-line).15 E 2.5 -("M-T" transpose-w)151.2 324 R(ords)-.1 E 2.5("M-U" upcase-w)151.2 336 R -(ord)-.1 E 2.5("M-Y" yank-pop)151.2 348 R 2.5 -("M-\\" delete-horizontal-space)151.2 360 R 2.5("M-~" tilde-e)151.2 372 -R(xpand)-.15 E 2.5("M-C-?" backw)151.2 384 R(ard-kill-w)-.1 E(ord)-.1 E -2.5("M-_" yank-last-ar)151.2 396 R(g)-.18 E(Emacs Control-X bindings) -151.2 412.8 Q 2.5("C-XC-G" abort)151.2 436.8 R 2.5 -("C-XC-R" re-read-init-\214le)151.2 448.8 R 2.5("C-XC-U" undo)151.2 -460.8 R 2.5("C-XC-X" e)151.2 472.8 R(xchange-point-and-mark)-.15 E 2.5 -("C-X\(" start-kbd-macro)151.2 484.8 R 2.5("C-X\)" end-kbd-macro)151.2 -496.8 R 2.5("C-XE" call-last-kbd-macro)151.2 508.8 R 2.5("C-XC-?" backw) -151.2 520.8 R(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF -(VI Mode bindings)87 549.6 Q F0(VI Insert Mode functions)151.2 561.6 Q -2.5("C-D" vi-eof-maybe)151.2 585.6 R 2.5("C-H" backw)151.2 597.6 R -(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 609.6 R 2.5 -("C-J" accept-line)151.2 621.6 R 2.5("C-M" accept-line)151.2 633.6 R 2.5 -("C-R" re)151.2 645.6 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 -("C-S" forw)151.2 657.6 R(ard-search-history)-.1 E 2.5 -("C-T" transpose-chars)151.2 669.6 R 2.5("C-U" unix-line-discard)151.2 -681.6 R 2.5("C-V" quoted-insert)151.2 693.6 R 2.5("C-W" unix-w)151.2 -705.6 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 717.6 R 2.5("C-[" vi-mo) -151.2 729.6 R -.15(ve)-.15 G(ment-mode).15 E(GNU Readline 4.2a)72 768 Q -(2001 October 9)123.745 E(11)192.895 E EP +("M-C-G" abort)151.2 84 R 2.5("M-C-H" backw)151.2 96 R(ard-kill-w)-.1 E +(ord)-.1 E 2.5("M-C-I" tab-insert)151.2 108 R 2.5 +("M-C-J" vi-editing-mode)151.2 120 R 2.5("M-C-M" vi-editing-mode)151.2 +132 R 2.5("M-C-R" re)151.2 144 R -.15(ve)-.25 G(rt-line).15 E 2.5 +("M-C-Y" yank-nth-ar)151.2 156 R(g)-.18 E 2.5("M-C-[" complete)151.2 168 +R 2.5("M-C-]" character)151.2 180 R(-search-backw)-.2 E(ard)-.1 E 2.5 +("M-space" set-mark)151.2 192 R 2.5("M-#" insert-comment)151.2 204 R 2.5 +("M-&" tilde-e)151.2 216 R(xpand)-.15 E 2.5("M-*" insert-completions) +151.2 228 R 2.5("M--" digit-ar)151.2 240 R(gument)-.18 E 2.5 +("M-." yank-last-ar)151.2 252 R(g)-.18 E 2.5("M-0" digit-ar)151.2 264 R +(gument)-.18 E 2.5("M-1" digit-ar)151.2 276 R(gument)-.18 E 2.5 +("M-2" digit-ar)151.2 288 R(gument)-.18 E 2.5("M-3" digit-ar)151.2 300 R +(gument)-.18 E 2.5("M-4" digit-ar)151.2 312 R(gument)-.18 E 2.5 +("M-5" digit-ar)151.2 324 R(gument)-.18 E 2.5("M-6" digit-ar)151.2 336 R +(gument)-.18 E 2.5("M-7" digit-ar)151.2 348 R(gument)-.18 E 2.5 +("M-8" digit-ar)151.2 360 R(gument)-.18 E 2.5("M-9" digit-ar)151.2 372 R +(gument)-.18 E 2.5("M-<" be)151.2 384 R(ginning-of-history)-.15 E 2.5 +("M-=" possible-completions)151.2 396 R 2.5("M->" end-of-history)151.2 +408 R 2.5("M-?" possible-completions)151.2 420 R 2.5("M-B" backw)151.2 +432 R(ard-w)-.1 E(ord)-.1 E 2.5("M-C" capitalize-w)151.2 444 R(ord)-.1 E +2.5("M-D" kill-w)151.2 456 R(ord)-.1 E 2.5("M-F" forw)151.2 468 R(ard-w) +-.1 E(ord)-.1 E 2.5("M-L" do)151.2 480 R(wncase-w)-.25 E(ord)-.1 E 2.5 +("M-N" non-incremental-forw)151.2 492 R(ard-search-history)-.1 E 2.5 +("M-P" non-incremental-re)151.2 504 R -.15(ve)-.25 G(rse-search-history) +.15 E 2.5("M-R" re)151.2 516 R -.15(ve)-.25 G(rt-line).15 E 2.5 +("M-T" transpose-w)151.2 528 R(ords)-.1 E 2.5("M-U" upcase-w)151.2 540 R +(ord)-.1 E 2.5("M-Y" yank-pop)151.2 552 R 2.5 +("M-\\" delete-horizontal-space)151.2 564 R 2.5("M-~" tilde-e)151.2 576 +R(xpand)-.15 E 2.5("M-C-?" backw)151.2 588 R(ard-kill-w)-.1 E(ord)-.1 E +2.5("M-_" yank-last-ar)151.2 600 R(g)-.18 E(Emacs Control-X bindings) +151.2 616.8 Q 2.5("C-XC-G" abort)151.2 640.8 R 2.5 +("C-XC-R" re-read-init-\214le)151.2 652.8 R 2.5("C-XC-U" undo)151.2 +664.8 R 2.5("C-XC-X" e)151.2 676.8 R(xchange-point-and-mark)-.15 E 2.5 +("C-X\(" start-kbd-macro)151.2 688.8 R 2.5("C-X\)" end-kbd-macro)151.2 +700.8 R 2.5("C-XE" call-last-kbd-macro)151.2 712.8 R 2.5("C-XC-?" backw) +151.2 724.8 R(ard-kill-line)-.1 E(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(11)190.95 E EP %%Page: 12 12 %%BeginPageSetup BP %%EndPageSetup -/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 2.5 -("C-_" undo)151.2 84 R 3.333("")151.2 96 S(to "~")-.833 E(self-insert)5 -E 2.5("C-?" backw)151.2 108 R(ard-delete-char)-.1 E -(VI Command Mode functions)151.2 124.8 Q 2.5("C-D" vi-eof-maybe)151.2 -148.8 R 2.5("C-E" emacs-editing-mode)151.2 160.8 R 2.5("C-G" abort)151.2 -172.8 R 2.5("C-H" backw)151.2 184.8 R(ard-char)-.1 E 2.5 -("C-J" accept-line)151.2 196.8 R 2.5("C-K" kill-line)151.2 208.8 R 2.5 -("C-L" clear)151.2 220.8 R(-screen)-.2 E 2.5("C-M" accept-line)151.2 -232.8 R 2.5("C-N" ne)151.2 244.8 R(xt-history)-.15 E 2.5("C-P" pre)151.2 -256.8 R(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 268.8 R 2.5 -("C-R" re)151.2 280.8 R -.15(ve)-.25 G(rse-search-history).15 E 2.5 -("C-S" forw)151.2 292.8 R(ard-search-history)-.1 E 2.5 -("C-T" transpose-chars)151.2 304.8 R 2.5("C-U" unix-line-discard)151.2 -316.8 R 2.5("C-V" quoted-insert)151.2 328.8 R 2.5("C-W" unix-w)151.2 -340.8 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 352.8 R 2.5("C-_" vi-undo) -151.2 364.8 R -4.166 3.333("" f)151.2 376.8 T(orw)-3.333 E(ard-char)-.1 -E 2.5("#" insert-comment)151.2 388.8 R 2.5("$" end-of-line)151.2 400.8 R -2.5("%" vi-match)151.2 412.8 R 2.5("&" vi-tilde-e)151.2 424.8 R(xpand) --.15 E 2.5("*" vi-complete)151.2 436.8 R 2.5("+" ne)151.2 448.8 R -(xt-history)-.15 E 2.5("," vi-char)151.2 460.8 R(-search)-.2 E 2.5 -("-" pre)151.2 472.8 R(vious-history)-.25 E 2.5("." vi-redo)151.2 484.8 -R 2.5("/" vi-search)151.2 496.8 R 2.5("0" be)151.2 508.8 R -(ginning-of-line)-.15 E("1" to "9")151.2 520.8 Q(vi-ar)5 E(g-digit)-.18 -E 2.5(";" vi-char)151.2 532.8 R(-search)-.2 E 2.5("=" vi-complete)151.2 -544.8 R 2.5("?" vi-search)151.2 556.8 R 2.5("A" vi-append-eol)151.2 -568.8 R 2.5("B" vi-pre)151.2 580.8 R(v-w)-.25 E(ord)-.1 E 2.5 -("C" vi-change-to)151.2 592.8 R 2.5("D" vi-delete-to)151.2 604.8 R 2.5 -("E" vi-end-w)151.2 616.8 R(ord)-.1 E 2.5("F" vi-char)151.2 628.8 R -(-search)-.2 E 2.5("G" vi-fetch-history)151.2 640.8 R 2.5 -("I" vi-insert-be)151.2 652.8 R(g)-.15 E 2.5("N" vi-search-ag)151.2 -664.8 R(ain)-.05 E 2.5("P" vi-put)151.2 676.8 R 2.5("R" vi-replace)151.2 -688.8 R 2.5("S" vi-subst)151.2 700.8 R 2.5("T" vi-char)151.2 712.8 R -(-search)-.2 E 2.5("U" re)151.2 724.8 R -.15(ve)-.25 G(rt-line).15 E -(GNU Readline 4.2a)72 768 Q(2001 October 9)123.745 E(12)192.895 E EP +/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10 +/Times-Bold@0 SF(VI Mode bindings)87 84 Q F0(VI Insert Mode functions) +151.2 96 Q 2.5("C-D" vi-eof-maybe)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-M" accept-line)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-[" vi-mo)151.2 264 R +-.15(ve)-.15 G(ment-mode).15 E 2.5("C-_" undo)151.2 276 R 3.333("")151.2 +288 S(to "~")-.833 E(self-insert)5 E 2.5("C-?" backw)151.2 300 R +(ard-delete-char)-.1 E(VI Command Mode functions)151.2 316.8 Q 2.5 +("C-D" vi-eof-maybe)151.2 340.8 R 2.5("C-E" emacs-editing-mode)151.2 +352.8 R 2.5("C-G" abort)151.2 364.8 R 2.5("C-H" backw)151.2 376.8 R +(ard-char)-.1 E 2.5("C-J" accept-line)151.2 388.8 R 2.5("C-K" kill-line) +151.2 400.8 R 2.5("C-L" clear)151.2 412.8 R(-screen)-.2 E 2.5 +("C-M" accept-line)151.2 424.8 R 2.5("C-N" ne)151.2 436.8 R(xt-history) +-.15 E 2.5("C-P" pre)151.2 448.8 R(vious-history)-.25 E 2.5 +("C-Q" quoted-insert)151.2 460.8 R 2.5("C-R" re)151.2 472.8 R -.15(ve) +-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2 484.8 R +(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 496.8 R 2.5 +("C-U" unix-line-discard)151.2 508.8 R 2.5("C-V" quoted-insert)151.2 +520.8 R 2.5("C-W" unix-w)151.2 532.8 R(ord-rubout)-.1 E 2.5("C-Y" yank) +151.2 544.8 R 2.5("C-_" vi-undo)151.2 556.8 R -4.166 3.333("" f)151.2 +568.8 T(orw)-3.333 E(ard-char)-.1 E 2.5("#" insert-comment)151.2 580.8 R +2.5("$" end-of-line)151.2 592.8 R 2.5("%" vi-match)151.2 604.8 R 2.5 +("&" vi-tilde-e)151.2 616.8 R(xpand)-.15 E 2.5("*" vi-complete)151.2 +628.8 R 2.5("+" ne)151.2 640.8 R(xt-history)-.15 E 2.5("," vi-char)151.2 +652.8 R(-search)-.2 E 2.5("-" pre)151.2 664.8 R(vious-history)-.25 E 2.5 +("." vi-redo)151.2 676.8 R 2.5("/" vi-search)151.2 688.8 R 2.5("0" be) +151.2 700.8 R(ginning-of-line)-.15 E("1" to "9")151.2 712.8 Q(vi-ar)5 E +(g-digit)-.18 E 2.5(";" vi-char)151.2 724.8 R(-search)-.2 E +(GNU Readline 4.3)72 768 Q(2002 January 22)126.24 E(12)190.95 E EP %%Page: 13 13 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 2.5 -("W" vi-ne)151.2 84 R(xt-w)-.15 E(ord)-.1 E 2.5("X" backw)151.2 96 R -(ard-delete-char)-.1 E 2.5("Y" vi-yank-to)151.2 108 R 2.5 -("\\" vi-complete)151.2 120 R 2.5("^" vi-\214rst-print)151.2 132 R 2.5 -("_" vi-yank-ar)151.2 144 R(g)-.18 E 2.5("`" vi-goto-mark)151.2 156 R -2.5("a" vi-append-mode)151.2 168 R 2.5("b" vi-pre)151.2 180 R(v-w)-.25 E -(ord)-.1 E 2.5("c" vi-change-to)151.2 192 R 2.5("d" vi-delete-to)151.2 -204 R 2.5("e" vi-end-w)151.2 216 R(ord)-.1 E 2.5("f" vi-char)151.2 228 R -(-search)-.2 E 2.5("h" backw)151.2 240 R(ard-char)-.1 E 2.5 -("i" vi-insertion-mode)151.2 252 R 2.5("j" ne)151.2 264 R(xt-history) --.15 E 2.5("k" pre)151.2 276 R(v-history)-.25 E 2.5("l" forw)151.2 288 R -(ard-char)-.1 E 2.5("m" vi-set-mark)151.2 300 R 2.5("n" vi-search-ag) -151.2 312 R(ain)-.05 E 2.5("p" vi-put)151.2 324 R 2.5 -("r" vi-change-char)151.2 336 R 2.5("s" vi-subst)151.2 348 R 2.5 -("t" vi-char)151.2 360 R(-search)-.2 E 2.5("u" vi-undo)151.2 372 R 2.5 -("w" vi-ne)151.2 384 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2 396 -R 2.5("y" vi-yank-to)151.2 408 R 2.5("|" vi-column)151.2 420 R 2.5 -("~" vi-change-case)151.2 432 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 -448.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 460.8 Q(ary) +("=" vi-complete)151.2 84 R 2.5("?" vi-search)151.2 96 R 2.5 +("A" vi-append-eol)151.2 108 R 2.5("B" vi-pre)151.2 120 R(v-w)-.25 E +(ord)-.1 E 2.5("C" vi-change-to)151.2 132 R 2.5("D" vi-delete-to)151.2 +144 R 2.5("E" vi-end-w)151.2 156 R(ord)-.1 E 2.5("F" vi-char)151.2 168 R +(-search)-.2 E 2.5("G" vi-fetch-history)151.2 180 R 2.5 +("I" vi-insert-be)151.2 192 R(g)-.15 E 2.5("N" vi-search-ag)151.2 204 R +(ain)-.05 E 2.5("P" vi-put)151.2 216 R 2.5("R" vi-replace)151.2 228 R +2.5("S" vi-subst)151.2 240 R 2.5("T" vi-char)151.2 252 R(-search)-.2 E +2.5("U" re)151.2 264 R -.15(ve)-.25 G(rt-line).15 E 2.5("W" vi-ne)151.2 +276 R(xt-w)-.15 E(ord)-.1 E 2.5("X" backw)151.2 288 R(ard-delete-char) +-.1 E 2.5("Y" vi-yank-to)151.2 300 R 2.5("\\" vi-complete)151.2 312 R +2.5("^" vi-\214rst-print)151.2 324 R 2.5("_" vi-yank-ar)151.2 336 R(g) +-.18 E 2.5("`" vi-goto-mark)151.2 348 R 2.5("a" vi-append-mode)151.2 360 +R 2.5("b" vi-pre)151.2 372 R(v-w)-.25 E(ord)-.1 E 2.5("c" vi-change-to) +151.2 384 R 2.5("d" vi-delete-to)151.2 396 R 2.5("e" vi-end-w)151.2 408 +R(ord)-.1 E 2.5("f" vi-char)151.2 420 R(-search)-.2 E 2.5("h" backw) +151.2 432 R(ard-char)-.1 E 2.5("i" vi-insertion-mode)151.2 444 R 2.5 +("j" ne)151.2 456 R(xt-history)-.15 E 2.5("k" pre)151.2 468 R(v-history) +-.25 E 2.5("l" forw)151.2 480 R(ard-char)-.1 E 2.5("m" vi-set-mark)151.2 +492 R 2.5("n" vi-search-ag)151.2 504 R(ain)-.05 E 2.5("p" vi-put)151.2 +516 R 2.5("r" vi-change-char)151.2 528 R 2.5("s" vi-subst)151.2 540 R +2.5("t" vi-char)151.2 552 R(-search)-.2 E 2.5("u" vi-undo)151.2 564 R +2.5("w" vi-ne)151.2 576 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2 +588 R 2.5("y" vi-yank-to)151.2 600 R 2.5("|" vi-column)151.2 612 R 2.5 +("~" vi-change-case)151.2 624 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 +640.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 652.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 472.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 484.8 Q F0(\(1\))A F1 -(FILES)72 501.6 Q F2(~/.inputr)109.666 513.6 Q(c)-.37 E F0(Indi)144 -525.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 542.4 S(THORS).548 E F0 -(Brian F)108 554.4 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E -(bfox@gnu.or)108 566.4 Q(g)-.18 E(Chet Rame)108 583.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@ins.CWR)108 595.2 Q(U.Edu)-.4 E F1 -.11(BU)72 -612 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .69(If you \214nd a b) -108 624 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 636 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 .705(Once you ha)108 652.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 .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 664.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 676.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 693.6 Q -(ug reports concerning this manual page should be directed to)-.2 E F2 --.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E -(GNU Readline 4.2a)72 768 Q(2001 October 9)123.745 E(13)192.895 E EP +(The Gnu History Libr)108 664.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 676.8 Q F0(\(1\))A F1 +(FILES)72 693.6 Q F2(~/.inputr)109.666 705.6 Q(c)-.37 E F0(Indi)144 +717.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(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(13)190.95 E EP %%Page: 14 14 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 -10.95/Times-Bold@0 SF -.11(BU)72 84 S(GS).11 E F0(It')108 96 Q 2.5(st) --.55 G(oo big and too slo)-2.5 E -.65(w.)-.25 G(GNU Readline 4.2a)72 768 -Q(2001 October 9)123.745 E(14)192.895 E EP +10.95/Times-Bold@0 SF -.548(AU)72 84 S(THORS).548 E F0(Brian F)108 96 Q +(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 108 +Q(g)-.18 E(Chet Rame)108 124.8 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@ins.CWR)108 136.8 Q(U.Edu)-.4 E F1 -.11(BU)72 153.6 S 2.738(GR).11 +G(EPOR)-2.738 E(TS)-.438 E F0 .69(If you \214nd a b)108 165.6 R .69 +(ug in)-.2 F/F2 10/Times-Bold@0 SF -.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 177.6 Q(ersion of the)-.15 E F2 +-.18(re)2.5 G(adline).18 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.) +.15 E .705(Once you ha)108 194.4 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 .704(ug report to)-.2 F/F3 10/Times-Italic@0 SF -.2(bu)3.204 G +(g\255r).2 E(eadline)-.37 E F0(@)A F3(gnu.or)A(g)-.37 E F0 5.704(.I)C +3.204(fy)-5.704 G(ou)-3.204 E(ha)108 206.4 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 218.4 Q F3 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F3 +(gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F2 +(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 235.2 Q +(ug reports concerning this manual page should be directed to)-.2 E F3 +-.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E F1 +-.11(BU)72 252 S(GS).11 E F0(It')108 264 Q 2.5(st)-.55 G +(oo big and too slo)-2.5 E -.65(w.)-.25 G(GNU Readline 4.3)72 768 Q +(2002 January 22)126.24 E(14)190.95 E EP %%Trailer end %%EOF diff --git a/doc/rlman.texinfo b/doc/rlman.texinfo index 894c516..1ffebad 100644 --- a/doc/rlman.texinfo +++ b/doc/rlman.texinfo @@ -18,7 +18,7 @@ This document describes the GNU Readline Library, a utility which aids in the consistency of user interface across discrete programs that need to provide a command line interface. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -73,7 +73,7 @@ except that this permission notice may be stated in a translation approved by the Free Software Foundation. @vskip 0pt plus 1filll -Copyright @copyright{} 1988-2001 Free Software Foundation, Inc. +Copyright @copyright{} 1988-2002 Free Software Foundation, Inc. @end titlepage @ifinfo diff --git a/doc/rltech.texinfo b/doc/rltech.texinfo index be9f662..037e824 100644 --- a/doc/rltech.texinfo +++ b/doc/rltech.texinfo @@ -8,7 +8,7 @@ This document describes the GNU Readline Library, a utility for aiding in the consitency of user interface across discrete programs that need to provide a command line interface. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -111,12 +111,13 @@ function, and has the advantage of no static buffer to overflow: /* A static variable for holding the line. */ static char *line_read = (char *)NULL; -/* Read a string, and return a pointer to it. Returns NULL on EOF. */ +/* Read a string, and return a pointer to it. + Returns NULL on EOF. */ char * rl_gets () @{ - /* If the buffer has already been allocated, return the memory - to the free pool. */ + /* If the buffer has already been allocated, + return the memory to the free pool. */ if (line_read) @{ free (line_read); @@ -126,7 +127,8 @@ rl_gets () /* Get a line from the user. */ line_read = readline (""); - /* If the line has any text in it, save it on the history. */ + /* If the line has any text in it, + save it on the history. */ if (line_read && *line_read) add_history (line_read); @@ -263,7 +265,7 @@ variables that describe the current state of the line read so far. The calling sequence for a command @code{foo} looks like @example -@code{foo (int count, int key)} +@code{int foo (int count, int key)} @end example @noindent @@ -280,6 +282,9 @@ to do something useful with both negative and positive arguments. At the very least, it should be aware that it can be passed a negative argument. +A command function should return 0 if its action completes successfully, +and a non-zero value if some error occurs. + @node Readline Variables @section Readline Variables @@ -385,10 +390,12 @@ The value allows conditional parsing of the inputrc file @deftypevar {FILE *} rl_instream The stdio stream from which Readline reads input. +If @code{NULL}, Readline defaults to @var{stdin}. @end deftypevar @deftypevar {FILE *} rl_outstream The stdio stream to which Readline performs output. +If @code{NULL}, Readline defaults to @var{stdout}. @end deftypevar @deftypevar {rl_command_func_t *} rl_last_func @@ -766,9 +773,9 @@ This is done with @code{rl_begin_undo_group()} and The types of events that can be undone are: -@example +@smallexample enum undo_code @{ UNDO_DELETE, UNDO_INSERT, UNDO_BEGIN, UNDO_END @}; -@end example +@end smallexample Notice that @code{UNDO_DELETE} means to insert some text, and @code{UNDO_INSERT} means to delete some text. That is, the undo code @@ -901,10 +908,12 @@ to the result. @deftypefun int rl_insert_text (const char *text) Insert @var{text} into the line at the current cursor position. +Returns the number of characters inserted. @end deftypefun @deftypefun int rl_delete_text (int start, int end) Delete the text between @var{start} and @var{end} in the current line. +Returns the number of characters deleted. @end deftypefun @deftypefun {char *} rl_copy_text (int start, int end) @@ -947,7 +956,9 @@ be the keyboard. @deftypefun int rl_stuff_char (int c) Insert @var{c} into the Readline input stream. It will be "read" before Readline attempts to read characters from the terminal with -@code{rl_read_key()}. +@code{rl_read_key()}. Up to 512 characters may be pushed back. +@code{rl_stuff_char} returns 1 if the character was successfully inserted; +0 otherwise. @end deftypefun @deftypefun int rl_execute_next (int c) @@ -1000,6 +1011,13 @@ environment variable is used. @node Utility Functions @subsection Utility Functions +@deftypefun void rl_replace_line (const char *text, int clear_undo) +Replace the contents of @code{rl_line_buffer} with @var{text}. +The point and mark are preserved, if possible. +If @var{clear_undo} is non-zero, the undo list associated with the +current line is cleared. +@end deftypefun + @deftypefun int rl_extend_line_buffer (int len) Ensure that @code{rl_line_buffer} has enough space to hold @var{len} characters, possibly reallocating it if necessary. @@ -1123,16 +1141,26 @@ The function takes the text of the line as an argument. @deftypefun void rl_callback_read_char (void) Whenever an application determines that keyboard input is available, it should call @code{rl_callback_read_char()}, which will read the next -character from the current input source. If that character completes the -line, @code{rl_callback_read_char} will invoke the @var{lhandler} -function saved by @code{rl_callback_handler_install} to process the -line. @code{EOF} is indicated by calling @var{lhandler} with a +character from the current input source. +If that character completes the line, @code{rl_callback_read_char} will +invoke the @var{lhandler} function saved by @code{rl_callback_handler_install} +to process the line. +Before calling the @var{lhandler} function, the terminal settings are +reset to the values they had before calling +@code{rl_callback_handler_install}. +If the @var{lhandler} function returns, +the terminal settings are modified for Readline's use again. +@code{EOF} is indicated by calling @var{lhandler} with a @code{NULL} line. @end deftypefun @deftypefun void rl_callback_handler_remove (void) Restore the terminal to its initial state and remove the line handler. This may be called from within a callback as well as independently. +If the @var{lhandler} installed by @code{rl_callback_handler_install} +does not exit the program, either this function or the function referred +to by the value of @code{rl_deprep_term_function} should be called before +the program exits to reset the terminal settings. @end deftypefun @node A Readline Example @@ -1185,8 +1213,8 @@ invert_case_line (count, key) end = temp; @} - /* Tell readline that we are modifying the line, so it will save - the undo information. */ + /* Tell readline that we are modifying the line, + so it will save the undo information. */ rl_modifying (start, end); for (i = start; i != end; i++) @@ -1442,6 +1470,14 @@ partially-completed word. See description of @code{rl_complete()}. This calls @code{rl_complete_internal()} with an argument of @samp{*}. @end deftypefun +@deftypefun int rl_completion_mode (rl_command_func_t *cfunc) +Returns the apppriate value to pass to @code{rl_complete_internal()} +depending on whether @var{cfunc} was called twice in succession and +the value of the @code{show-all-if-ambiguous} variable. +Application-specific completion functions may use this function to present +the same interface as @code{rl_complete()}. +@end deftypefun + @deftypefun {char **} rl_completion_matches (const char *text, rl_compentry_func_t *entry_func) Returns an array of strings which is a list of completions for @var{text}. If there are no completions, returns @code{NULL}. @@ -1528,10 +1564,41 @@ character found in @code{rl_completer_word_break_characters} should be used to break words for the completer. @end deftypevar -@deftypevar int rl_completion_query_items -Up to this many items will be displayed in response to a -possible-completions call. After that, we ask the user if she is sure -she wants to see them all. The default value is 100. +@deftypevar {rl_compignore_func_t *} rl_ignore_some_completions_function +This function, if defined, is called by the completer when real filename +completion is done, after all the matching names have been generated. +It is passed a @code{NULL} terminated array of matches. +The first element (@code{matches[0]}) is the +maximal substring common to all matches. This function can +re-arrange the list of matches as required, but each element deleted +from the array must be freed. +@end deftypevar + +@deftypevar {rl_icppfunc_t *} rl_directory_completion_hook +This function, if defined, is allowed to modify the directory portion +of filenames Readline completes. It is called with the address of a +string (the current directory name) as an argument, and may modify that string. +If the string is replaced with a new string, the old value should be freed. +Any modified directory name should have a trailing slash. +The modified value will be displayed as part of the completion, replacing +the directory portion of the pathname the user typed. +It returns an integer that should be non-zero if the function modifies +its directory argument. +It could be used to expand symbolic links or shell variables in pathnames. +@end deftypevar + +@deftypevar {rl_compdisp_func_t *} rl_completion_display_matches_hook +If non-zero, then this is the address of a function to call when +completing a word would normally display the list of possible matches. +This function is called in lieu of Readline displaying the list. +It takes three arguments: +(@code{char **}@var{matches}, @code{int} @var{num_matches}, @code{int} @var{max_length}) +where @var{matches} is the array of matching strings, +@var{num_matches} is the number of strings in that array, and +@var{max_length} is the length of the longest string in that array. +Readline provides a convenience function, @code{rl_display_match_list}, +that takes care of doing the display to Readline's output stream. That +function may be called from this hook. @end deftypevar @deftypevar {const char *} rl_basic_word_break_characters @@ -1571,6 +1638,12 @@ For instance, Bash sets this variable to "$@@" so that it can complete shell variables and hostnames. @end deftypevar +@deftypevar int rl_completion_query_items +Up to this many items will be displayed in response to a +possible-completions call. After that, we ask the user if she is sure +she wants to see them all. The default value is 100. +@end deftypevar + @deftypevar {int} rl_completion_append_character When a single completion alternative matches at the end of the command line, this character is appended to the inserted completion text. The @@ -1581,6 +1654,24 @@ provide the ``most sensible word separator character'' according to an application-specific command line syntax specification. @end deftypevar +@deftypevar int rl_completion_suppress_append +If non-zero, @var{rl_completion_append_character} is not appended to +matches at the end of the command line, as described above. It is +set to 0 before any application-specific completion function is called. +@end deftypevar + +@deftypevar int rl_completion_mark_symlink_dirs +If non-zero, a slash will be appended to completed filenames that are +symbolic links to directory names, subject to the value of the +user-settable @var{mark-directories} variable. +This variable exists so that application completion functions can +override the user's global preference (set via the +@var{mark-symlinked-directories} Readline variable) if appropriate. +This variable is set to the user's preference before any +application completion function is called, so unless that function +modifies the value, the user's preferences are honored. +@end deftypevar + @deftypevar int rl_ignore_completion_duplicates If non-zero, then duplicates in the matches are removed. The default is 1. @@ -1625,43 +1716,6 @@ If this variable is non-zero, completion is inhibited. The completion character will be inserted as any other bound to @code{self-insert}. @end deftypevar -@deftypevar {rl_compignore_func_t *} rl_ignore_some_completions_function -This function, if defined, is called by the completer when real filename -completion is done, after all the matching names have been generated. -It is passed a @code{NULL} terminated array of matches. -The first element (@code{matches[0]}) is the -maximal substring common to all matches. This function can -re-arrange the list of matches as required, but each element deleted -from the array must be freed. -@end deftypevar - -@deftypevar {rl_icppfunc_t *} rl_directory_completion_hook -This function, if defined, is allowed to modify the directory portion -of filenames Readline completes. It is called with the address of a -string (the current directory name) as an argument, and may modify that string. -If the string is replaced with a new string, the old value should be freed. -Any modified directory name should have a trailing slash. -The modified value will be displayed as part of the completion, replacing -the directory portion of the pathname the user typed. -It returns an integer that should be non-zero if the function modifies -its directory argument. -It could be used to expand symbolic links or shell variables in pathnames. -@end deftypevar - -@deftypevar {rl_compdisp_func_t *} rl_completion_display_matches_hook -If non-zero, then this is the address of a function to call when -completing a word would normally display the list of possible matches. -This function is called in lieu of Readline displaying the list. -It takes three arguments: -(@code{char **}@var{matches}, @code{int} @var{num_matches}, @code{int} @var{max_length}) -where @var{matches} is the array of matching strings, -@var{num_matches} is the number of strings in that array, and -@var{max_length} is the length of the longest string in that array. -Readline provides a convenience function, @code{rl_display_match_list}, -that takes care of doing the display to Readline's output stream. That -function may be called from this hook. -@end deftypevar - @node A Short Completion Example @subsection A Short Completion Example @@ -2089,12 +2143,13 @@ too_dangerous (caller) char *caller; @{ fprintf (stderr, - "%s: Too dangerous for me to distribute. Write it yourself.\n", + "%s: Too dangerous for me to distribute.\n" caller); + fprintf (stderr, "Write it yourself.\n"); @} -/* Return non-zero if ARG is a valid argument for CALLER, else print - an error message and return zero. */ +/* Return non-zero if ARG is a valid argument for CALLER, + else print an error message and return zero. */ int valid_argument (caller, arg) char *caller, *arg; diff --git a/doc/rluser.texinfo b/doc/rluser.texinfo index e4e56ff..94f851e 100644 --- a/doc/rluser.texinfo +++ b/doc/rluser.texinfo @@ -10,7 +10,7 @@ use these features. There is a document entitled "readline.texinfo" which contains both end-user and programmer documentation for the GNU Readline Library. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Authored by Brian Fox and Chet Ramey. @@ -512,6 +512,13 @@ This variable, when set to @samp{on}, causes Readline to display an asterisk (@samp{*}) at the start of history lines which have been modified. This variable is @samp{off} by default. +@item mark-symlinked-directories +@vindex mark-symlinked-directories +If set to @samp{on}, completed names which are symbolic links +to directories have a slash appended (subject to the value of +@code{mark-directories}). +The default is @samp{off}. + @item match-hidden-files @vindex match-hidden-files This variable, when set to @samp{on}, causes Readline to match files whose @@ -526,6 +533,12 @@ If set to @samp{on}, Readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is @samp{off}. +@item page-completions +@vindex page-completions +If set to @samp{on}, Readline uses an internal @code{more}-like pager +to display a screenful of possible completions at a time. +This variable is @samp{on} by default. + @item print-completions-horizontally If set to @samp{on}, Readline will display completions with matches sorted horizontally in alphabetical order, rather than down the screen. @@ -757,14 +770,14 @@ binding, variable assignment, and conditional syntax. @example @page # This file controls the behaviour of line input editing for -# programs that use the Gnu Readline library. Existing programs -# include FTP, Bash, and Gdb. +# programs that use the GNU Readline library. Existing +# programs include FTP, Bash, and GDB. # # You can re-read the inputrc file with C-x C-r. # Lines beginning with '#' are comments. # -# First, include any systemwide bindings and variable assignments from -# /etc/Inputrc +# First, include any systemwide bindings and variable +# assignments from /etc/Inputrc $include /etc/Inputrc # @@ -816,10 +829,12 @@ TAB: complete $if Bash # edit the path "\C-xp": "PATH=$@{PATH@}\e\C-e\C-a\ef\C-f" -# prepare to type a quoted word -- insert open and close double quotes +# prepare to type a quoted word -- +# insert open and close double quotes # and move to just after the open quote "\C-x\"": "\"\"\C-b" -# insert a backslash (testing backslash escapes in sequences and macros) +# insert a backslash (testing backslash escapes +# in sequences and macros) "\C-x\\": "\\" # Quote the current or previous word "\C-xq": "\eb\"\ef\"" @@ -835,16 +850,16 @@ set bell-style visible # don't strip characters to 7 bits when reading set input-meta on -# allow iso-latin1 characters to be inserted rather than converted to -# prefix-meta sequences +# allow iso-latin1 characters to be inserted rather +# than converted to prefix-meta sequences set convert-meta off -# display characters with the eighth bit set directly rather than -# as meta-prefixed characters +# display characters with the eighth bit set directly +# rather than as meta-prefixed characters set output-meta on -# if there are more than 150 possible completions for a word, ask the -# user if he wants to see all of them +# if there are more than 150 possible completions for +# a word, ask the user if he wants to see all of them set completion-query-items 150 # For FTP @@ -1053,6 +1068,20 @@ lowercase the previous word, but do not move the cursor. Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move the cursor. +@item overwrite-mode () +Toggle overwrite mode. With an explicit positive numeric argument, +switches to overwrite mode. With an explicit non-positive numeric +argument, switches to insert mode. This command affects only +@code{emacs} mode; @code{vi} mode does overwrite differently. +Each call to @code{readline()} starts in insert mode. + +In overwrite mode, characters bound to @code{self-insert} replace +the text at point rather than pushing the text to the right. +Characters bound to @code{backward-delete-char} replace the character +before point with a space. + +By default, this command is unbound. + @end ftable @node Commands For Killing @@ -1312,12 +1341,19 @@ of that character. A negative count searches for subsequent occurrences. @item insert-comment (M-#) -The value of the @code{comment-begin} -variable is inserted at the beginning of the current line, -and the line is accepted as if a newline had been typed. +Without a numeric argument, the value of the @code{comment-begin} +variable 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 @code{comment-begin}, the value is inserted, otherwise +the characters in @code{comment-begin} are deleted from the beginning of +the line. +In either case, the line is accepted as if a newline had been typed. @ifset BashFeatures The default value of @code{comment-begin} causes this command to make the current line a shell comment. +If a numeric argument causes the comment character to be removed, the line +will be executed by the shell. @end ifset @item dump-functions () @@ -1339,13 +1375,22 @@ the output is formatted in such a way that it can be made part of an @var{inputrc} file. This command is unbound by default. @ifset BashFeatures +@item glob-complete-word (M-g) +The word before point is treated as a pattern for pathname expansion, +with an asterisk implicitly appended. This pattern is used to +generate a list of matching file names for possible completions. + @item glob-expand-word (C-x *) The word before point is treated as a pattern for pathname expansion, and the list of matching file names is inserted, replacing the word. +If a numeric argument is supplied, a @samp{*} is appended before +pathname expansion. @item glob-list-expansions (C-x g) The list of expansions that would have been generated by @code{glob-expand-word} is displayed, and the line is redrawn. +If a numeric argument is supplied, a @samp{*} is appended before +pathname expansion. @item display-shell-version (C-x C-v) Display version information about the current instance of Bash. @@ -1376,13 +1421,26 @@ Accept the current line for execution and fetch the next line relative to the current line from the history for editing. Any argument is ignored. -@item emacs-editing-mode (C-e) -When in @code{vi} editing mode, this causes a switch back to -@code{emacs} editing mode, as if the command @samp{set -o emacs} had -been executed. +@item edit-and-execute-command (C-xC-e) +Invoke an editor on the current command line, and execute the result as shell +commands. +Bash attempts to invoke +@code{$FCEDIT}, @code{$EDITOR}, and @code{emacs} +as the editor, in that order. @end ifset +@ifclear BashFeatures +@item emacs-editing-mode (C-e) +When in @code{vi} command mode, this causes a switch to @code{emacs} +editing mode. + +@item vi-editing-mode (M-C-j) +When in @code{emacs} editing mode, this causes a switch to @code{vi} +editing mode. + +@end ifclear + @end ftable @node Readline vi Mode @@ -1518,6 +1576,12 @@ If the @option{-o default} option was supplied to @code{complete} when the compspec was defined, Readline's default completion will be performed if the compspec generates no matches. +When a compspec indicates that directory name completion is desired, +the programmable completion functions force Readline to append a slash +to completed names which are symbolic links to directories, subject to +the value of the @var{mark-directories} Readline variable, regardless +of the setting of the @var{mark-symlinked-directories} Readline variable. + @node Programmable Completion Builtins @section Programmable Completion Builtins @cindex completion builtins @@ -1553,7 +1617,7 @@ matches were generated. @item complete @btindex complete @example -@code{complete [-abcdefgjkvu] [-o @var{comp-option}] [-A @var{action}] [-G @var{globpat}] [-W @var{wordlist}] +@code{complete [-abcdefgjksuv] [-o @var{comp-option}] [-A @var{action}] [-G @var{globpat}] [-W @var{wordlist}] [-P @var{prefix}] [-S @var{suffix}] [-X @var{filterpat}] [-F @var{function}] [-C @var{command}] @var{name} [@var{name} @dots{}]} @code{complete -pr [@var{name} @dots{}]} @@ -1586,7 +1650,8 @@ beyond the simple generation of completions. @table @code @item default -Use readline's default completion if the compspec generates no matches. +Use Readline's default filename completion if the compspec generates +no matches. @item dirnames Perform directory name completion if the compspec generates no matches. @@ -1596,6 +1661,10 @@ Tell Readline that the compspec generates filenames, so it can perform any filename\-specific processing (like adding a slash to directory names or suppressing trailing spaces). This option is intended to be used with shell functions specified with @option{-F}. + +@item nospace +Tell Readline not to append a space (the default) to words completed at +the end of the line. @end table @item -A @var{action} @@ -1655,6 +1724,9 @@ Shell reserved words. May also be specified as @option{-k}. @item running Names of running jobs, if job control is active. +@item service +Service names. May also be specified as @option{-s}. + @item setopt Valid arguments for the @option{-o} option to the @code{set} builtin (@pxref{The Set Builtin}). diff --git a/doc/rluserman.dvi b/doc/rluserman.dvi Binary files differindex 5346db7..a2339aa 100644 --- a/doc/rluserman.dvi +++ b/doc/rluserman.dvi diff --git a/doc/rluserman.html b/doc/rluserman.html index 93bfe63..ac8bfbd 100644 --- a/doc/rluserman.html +++ b/doc/rluserman.html @@ -1,6 +1,6 @@ <HTML> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<!-- Created on October, 9 2001 by texi2html 1.64 --> +<!-- Created on June, 27 2002 by texi2html 1.64 --> <!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> @@ -700,8 +700,16 @@ asterisk (<SAMP>`*'</SAMP>) at the start of history lines which have been modifi This variable is <SAMP>`off'</SAMP> by default. <P> -<DT><CODE>match-hidden-files</CODE> +<DT><CODE>mark-symlinked-directories</CODE> <DD><A NAME="IDX20"></A> +If set to <SAMP>`on'</SAMP>, completed names which are symbolic links +to directories have a slash appended (subject to the value of +<CODE>mark-directories</CODE>). +The default is <SAMP>`off'</SAMP>. +<P> + +<DT><CODE>match-hidden-files</CODE> +<DD><A NAME="IDX21"></A> This variable, when set to <SAMP>`on'</SAMP>, causes Readline to match files whose names begin with a <SAMP>`.'</SAMP> (hidden files) when performing filename completion, unless the leading <SAMP>`.'</SAMP> is @@ -710,12 +718,19 @@ This variable is <SAMP>`on'</SAMP> by default. <P> <DT><CODE>output-meta</CODE> -<DD><A NAME="IDX21"></A> +<DD><A NAME="IDX22"></A> If set to <SAMP>`on'</SAMP>, Readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is <SAMP>`off'</SAMP>. <P> +<DT><CODE>page-completions</CODE> +<DD><A NAME="IDX23"></A> +If set to <SAMP>`on'</SAMP>, Readline uses an internal <CODE>more</CODE>-like pager +to display a screenful of possible completions at a time. +This variable is <SAMP>`on'</SAMP> by default. +<P> + <DT><CODE>print-completions-horizontally</CODE> <DD>If set to <SAMP>`on'</SAMP>, Readline will display completions with matches sorted horizontally in alphabetical order, rather than down the screen. @@ -723,7 +738,7 @@ The default is <SAMP>`off'</SAMP>. <P> <DT><CODE>show-all-if-ambiguous</CODE> -<DD><A NAME="IDX22"></A> +<DD><A NAME="IDX24"></A> This alters the default behavior of the completion functions. If set to <SAMP>`on'</SAMP>, words which have more than one possible completion cause the @@ -732,7 +747,7 @@ The default value is <SAMP>`off'</SAMP>. <P> <DT><CODE>visible-stats</CODE> -<DD><A NAME="IDX23"></A> +<DD><A NAME="IDX25"></A> If set to <SAMP>`on'</SAMP>, a character denoting a file's type is appended to the filename when listing possible completions. The default is <SAMP>`off'</SAMP>. @@ -988,14 +1003,14 @@ binding, variable assignment, and conditional syntax. </P><P> <TABLE><tr><td> </td><td class=example><pre># This file controls the behaviour of line input editing for -# programs that use the Gnu Readline library. Existing programs -# include FTP, Bash, and Gdb. +# programs that use the GNU Readline library. Existing +# programs include FTP, Bash, and GDB. # # You can re-read the inputrc file with C-x C-r. # Lines beginning with '#' are comments. # -# First, include any systemwide bindings and variable assignments from -# /etc/Inputrc +# First, include any systemwide bindings and variable +# assignments from /etc/Inputrc $include /etc/Inputrc # @@ -1047,10 +1062,12 @@ TAB: complete $if Bash # edit the path "\C-xp": "PATH=${PATH}\e\C-e\C-a\ef\C-f" -# prepare to type a quoted word -- insert open and close double quotes +# prepare to type a quoted word -- +# insert open and close double quotes # and move to just after the open quote "\C-x\"": "\"\"\C-b" -# insert a backslash (testing backslash escapes in sequences and macros) +# insert a backslash (testing backslash escapes +# in sequences and macros) "\C-x\\": "\\" # Quote the current or previous word "\C-xq": "\eb\"\ef\"" @@ -1066,16 +1083,16 @@ set bell-style visible # don't strip characters to 7 bits when reading set input-meta on -# allow iso-latin1 characters to be inserted rather than converted to -# prefix-meta sequences +# allow iso-latin1 characters to be inserted rather +# than converted to prefix-meta sequences set convert-meta off -# display characters with the eighth bit set directly rather than -# as meta-prefixed characters +# display characters with the eighth bit set directly +# rather than as meta-prefixed characters set output-meta on -# if there are more than 150 possible completions for a word, ask the -# user if he wants to see all of them +# if there are more than 150 possible completions for +# a word, ask the user if he wants to see all of them set completion-query-items 150 # For FTP @@ -1144,54 +1161,54 @@ The text between the point and mark is referred to as the <EM>region</EM>. <H3> 1.4.1 Commands For Moving </H3> <!--docid::SEC14::--> <DL COMPACT> -<A NAME="IDX24"></A> +<A NAME="IDX26"></A> <DT><CODE>beginning-of-line (C-a)</CODE> -<DD><A NAME="IDX25"></A> +<DD><A NAME="IDX27"></A> Move to the start of the current line. <P> -<A NAME="IDX26"></A> +<A NAME="IDX28"></A> <DT><CODE>end-of-line (C-e)</CODE> -<DD><A NAME="IDX27"></A> +<DD><A NAME="IDX29"></A> Move to the end of the line. <P> -<A NAME="IDX28"></A> +<A NAME="IDX30"></A> <DT><CODE>forward-char (C-f)</CODE> -<DD><A NAME="IDX29"></A> +<DD><A NAME="IDX31"></A> Move forward a character. <P> -<A NAME="IDX30"></A> +<A NAME="IDX32"></A> <DT><CODE>backward-char (C-b)</CODE> -<DD><A NAME="IDX31"></A> +<DD><A NAME="IDX33"></A> Move back a character. <P> -<A NAME="IDX32"></A> +<A NAME="IDX34"></A> <DT><CODE>forward-word (M-f)</CODE> -<DD><A NAME="IDX33"></A> +<DD><A NAME="IDX35"></A> Move forward to the end of the next word. Words are composed of letters and digits. <P> -<A NAME="IDX34"></A> +<A NAME="IDX36"></A> <DT><CODE>backward-word (M-b)</CODE> -<DD><A NAME="IDX35"></A> +<DD><A NAME="IDX37"></A> Move back to the start of the current or previous word. Words are composed of letters and digits. <P> -<A NAME="IDX36"></A> +<A NAME="IDX38"></A> <DT><CODE>clear-screen (C-l)</CODE> -<DD><A NAME="IDX37"></A> +<DD><A NAME="IDX39"></A> Clear the screen and redraw the current line, leaving the current line at the top of the screen. <P> -<A NAME="IDX38"></A> +<A NAME="IDX40"></A> <DT><CODE>redraw-current-line ()</CODE> -<DD><A NAME="IDX39"></A> +<DD><A NAME="IDX41"></A> Refresh the current line. By default, this is unbound. <P> @@ -1217,9 +1234,9 @@ Refresh the current line. By default, this is unbound. <P> <DL COMPACT> -<A NAME="IDX40"></A> +<A NAME="IDX42"></A> <DT><CODE>accept-line (Newline or Return)</CODE> -<DD><A NAME="IDX41"></A> +<DD><A NAME="IDX43"></A> 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 recall with @@ -1228,81 +1245,81 @@ If this line is a modified history line, the history line is restored to its original state. <P> -<A NAME="IDX42"></A> +<A NAME="IDX44"></A> <DT><CODE>previous-history (C-p)</CODE> -<DD><A NAME="IDX43"></A> +<DD><A NAME="IDX45"></A> Move `back' through the history list, fetching the previous command. <P> -<A NAME="IDX44"></A> +<A NAME="IDX46"></A> <DT><CODE>next-history (C-n)</CODE> -<DD><A NAME="IDX45"></A> +<DD><A NAME="IDX47"></A> Move `forward' through the history list, fetching the next command. <P> -<A NAME="IDX46"></A> +<A NAME="IDX48"></A> <DT><CODE>beginning-of-history (M-<)</CODE> -<DD><A NAME="IDX47"></A> +<DD><A NAME="IDX49"></A> Move to the first line in the history. <P> -<A NAME="IDX48"></A> +<A NAME="IDX50"></A> <DT><CODE>end-of-history (M->)</CODE> -<DD><A NAME="IDX49"></A> +<DD><A NAME="IDX51"></A> Move to the end of the input history, i.e., the line currently being entered. <P> -<A NAME="IDX50"></A> +<A NAME="IDX52"></A> <DT><CODE>reverse-search-history (C-r)</CODE> -<DD><A NAME="IDX51"></A> +<DD><A NAME="IDX53"></A> Search backward starting at the current line and moving `up' through the history as necessary. This is an incremental search. <P> -<A NAME="IDX52"></A> +<A NAME="IDX54"></A> <DT><CODE>forward-search-history (C-s)</CODE> -<DD><A NAME="IDX53"></A> +<DD><A NAME="IDX55"></A> Search forward starting at the current line and moving `down' through the the history as necessary. This is an incremental search. <P> -<A NAME="IDX54"></A> +<A NAME="IDX56"></A> <DT><CODE>non-incremental-reverse-search-history (M-p)</CODE> -<DD><A NAME="IDX55"></A> +<DD><A NAME="IDX57"></A> Search backward starting at the current line and moving `up' through the history as necessary using a non-incremental search for a string supplied by the user. <P> -<A NAME="IDX56"></A> +<A NAME="IDX58"></A> <DT><CODE>non-incremental-forward-search-history (M-n)</CODE> -<DD><A NAME="IDX57"></A> +<DD><A NAME="IDX59"></A> Search forward starting at the current line and moving `down' through the the history as necessary using a non-incremental search for a string supplied by the user. <P> -<A NAME="IDX58"></A> +<A NAME="IDX60"></A> <DT><CODE>history-search-forward ()</CODE> -<DD><A NAME="IDX59"></A> +<DD><A NAME="IDX61"></A> Search forward through the history for the string of characters between the start of the current line and the point. This is a non-incremental search. By default, this command is unbound. <P> -<A NAME="IDX60"></A> +<A NAME="IDX62"></A> <DT><CODE>history-search-backward ()</CODE> -<DD><A NAME="IDX61"></A> +<DD><A NAME="IDX63"></A> Search backward through the history for the string of characters between the start of the current line and the point. This is a non-incremental search. By default, this command is unbound. <P> -<A NAME="IDX62"></A> +<A NAME="IDX64"></A> <DT><CODE>yank-nth-arg (M-C-y)</CODE> -<DD><A NAME="IDX63"></A> +<DD><A NAME="IDX65"></A> Insert the first argument to the previous command (usually the second word on the previous line) at point. With an argument <VAR>n</VAR>, @@ -1311,9 +1328,9 @@ in the previous command begin with word 0). A negative argument inserts the <VAR>n</VAR>th word from the end of the previous command. <P> -<A NAME="IDX64"></A> +<A NAME="IDX66"></A> <DT><CODE>yank-last-arg (M-. or M-_)</CODE> -<DD><A NAME="IDX65"></A> +<DD><A NAME="IDX67"></A> Insert last argument to the previous command (the last word of the previous history entry). With an argument, behave exactly like <CODE>yank-nth-arg</CODE>. @@ -1343,52 +1360,52 @@ list, inserting the last argument of each line in turn. <P> <DL COMPACT> -<A NAME="IDX66"></A> +<A NAME="IDX68"></A> <DT><CODE>delete-char (C-d)</CODE> -<DD><A NAME="IDX67"></A> +<DD><A NAME="IDX69"></A> Delete the character at point. If point is at the beginning of the line, there are no characters in the line, and the last character typed was not bound to <CODE>delete-char</CODE>, then return EOF. <P> -<A NAME="IDX68"></A> +<A NAME="IDX70"></A> <DT><CODE>backward-delete-char (Rubout)</CODE> -<DD><A NAME="IDX69"></A> +<DD><A NAME="IDX71"></A> Delete the character behind the cursor. A numeric argument means to kill the characters instead of deleting them. <P> -<A NAME="IDX70"></A> +<A NAME="IDX72"></A> <DT><CODE>forward-backward-delete-char ()</CODE> -<DD><A NAME="IDX71"></A> +<DD><A NAME="IDX73"></A> Delete the character under the cursor, unless the cursor is at the end of the line, in which case the character behind the cursor is deleted. By default, this is not bound to a key. <P> -<A NAME="IDX72"></A> +<A NAME="IDX74"></A> <DT><CODE>quoted-insert (C-q or C-v)</CODE> -<DD><A NAME="IDX73"></A> +<DD><A NAME="IDX75"></A> Add the next character typed to the line verbatim. This is how to insert key sequences like <KBD>C-q</KBD>, for example. <P> -<A NAME="IDX74"></A> +<A NAME="IDX76"></A> <DT><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE> -<DD><A NAME="IDX75"></A> +<DD><A NAME="IDX77"></A> Insert a tab character. <P> -<A NAME="IDX76"></A> +<A NAME="IDX78"></A> <DT><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE> -<DD><A NAME="IDX77"></A> +<DD><A NAME="IDX79"></A> Insert yourself. <P> -<A NAME="IDX78"></A> +<A NAME="IDX80"></A> <DT><CODE>transpose-chars (C-t)</CODE> -<DD><A NAME="IDX79"></A> +<DD><A NAME="IDX81"></A> Drag the character before the cursor forward over the character at the cursor, moving the cursor forward as well. If the insertion point @@ -1397,36 +1414,55 @@ transposes the last two characters of the line. Negative arguments have no effect. <P> -<A NAME="IDX80"></A> +<A NAME="IDX82"></A> <DT><CODE>transpose-words (M-t)</CODE> -<DD><A NAME="IDX81"></A> +<DD><A NAME="IDX83"></A> Drag the word before point past the word after point, moving point past that word as well. If the insertion point is at the end of the line, this transposes the last two words on the line. <P> -<A NAME="IDX82"></A> +<A NAME="IDX84"></A> <DT><CODE>upcase-word (M-u)</CODE> -<DD><A NAME="IDX83"></A> +<DD><A NAME="IDX85"></A> Uppercase the current (or following) word. With a negative argument, uppercase the previous word, but do not move the cursor. <P> -<A NAME="IDX84"></A> +<A NAME="IDX86"></A> <DT><CODE>downcase-word (M-l)</CODE> -<DD><A NAME="IDX85"></A> +<DD><A NAME="IDX87"></A> Lowercase the current (or following) word. With a negative argument, lowercase the previous word, but do not move the cursor. <P> -<A NAME="IDX86"></A> +<A NAME="IDX88"></A> <DT><CODE>capitalize-word (M-c)</CODE> -<DD><A NAME="IDX87"></A> +<DD><A NAME="IDX89"></A> Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move the cursor. <P> +<A NAME="IDX90"></A> +<DT><CODE>overwrite-mode ()</CODE> +<DD><A NAME="IDX91"></A> +Toggle overwrite mode. With an explicit positive numeric argument, +switches to overwrite mode. With an explicit non-positive numeric +argument, switches to insert mode. This command affects only +<CODE>emacs</CODE> mode; <CODE>vi</CODE> mode does overwrite differently. +Each call to <CODE>readline()</CODE> starts in insert mode. +<P> + +In overwrite mode, characters bound to <CODE>self-insert</CODE> replace +the text at point rather than pushing the text to the right. +Characters bound to <CODE>backward-delete-char</CODE> replace the character +before point with a space. +</P><P> + +By default, this command is unbound. +</P><P> + </DL> <P> @@ -1450,98 +1486,98 @@ capitalize the previous word, but do not move the cursor. <DL COMPACT> -<A NAME="IDX88"></A> +<A NAME="IDX92"></A> <DT><CODE>kill-line (C-k)</CODE> -<DD><A NAME="IDX89"></A> +<DD><A NAME="IDX93"></A> Kill the text from point to the end of the line. <P> -<A NAME="IDX90"></A> +<A NAME="IDX94"></A> <DT><CODE>backward-kill-line (C-x Rubout)</CODE> -<DD><A NAME="IDX91"></A> +<DD><A NAME="IDX95"></A> Kill backward to the beginning of the line. <P> -<A NAME="IDX92"></A> +<A NAME="IDX96"></A> <DT><CODE>unix-line-discard (C-u)</CODE> -<DD><A NAME="IDX93"></A> +<DD><A NAME="IDX97"></A> Kill backward from the cursor to the beginning of the current line. <P> -<A NAME="IDX94"></A> +<A NAME="IDX98"></A> <DT><CODE>kill-whole-line ()</CODE> -<DD><A NAME="IDX95"></A> +<DD><A NAME="IDX99"></A> Kill all characters on the current line, no matter where point is. By default, this is unbound. <P> -<A NAME="IDX96"></A> +<A NAME="IDX100"></A> <DT><CODE>kill-word (M-d)</CODE> -<DD><A NAME="IDX97"></A> +<DD><A NAME="IDX101"></A> Kill from point to the end of the current word, or if between words, to the end of the next word. Word boundaries are the same as <CODE>forward-word</CODE>. <P> -<A NAME="IDX98"></A> +<A NAME="IDX102"></A> <DT><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE> -<DD><A NAME="IDX99"></A> +<DD><A NAME="IDX103"></A> Kill the word behind point. Word boundaries are the same as <CODE>backward-word</CODE>. <P> -<A NAME="IDX100"></A> +<A NAME="IDX104"></A> <DT><CODE>unix-word-rubout (C-w)</CODE> -<DD><A NAME="IDX101"></A> +<DD><A NAME="IDX105"></A> Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. <P> -<A NAME="IDX102"></A> +<A NAME="IDX106"></A> <DT><CODE>delete-horizontal-space ()</CODE> -<DD><A NAME="IDX103"></A> +<DD><A NAME="IDX107"></A> Delete all spaces and tabs around point. By default, this is unbound. <P> -<A NAME="IDX104"></A> +<A NAME="IDX108"></A> <DT><CODE>kill-region ()</CODE> -<DD><A NAME="IDX105"></A> +<DD><A NAME="IDX109"></A> Kill the text in the current region. By default, this command is unbound. <P> -<A NAME="IDX106"></A> +<A NAME="IDX110"></A> <DT><CODE>copy-region-as-kill ()</CODE> -<DD><A NAME="IDX107"></A> +<DD><A NAME="IDX111"></A> Copy the text in the region to the kill buffer, so it can be yanked right away. By default, this command is unbound. <P> -<A NAME="IDX108"></A> +<A NAME="IDX112"></A> <DT><CODE>copy-backward-word ()</CODE> -<DD><A NAME="IDX109"></A> +<DD><A NAME="IDX113"></A> Copy the word before point to the kill buffer. The word boundaries are the same as <CODE>backward-word</CODE>. By default, this command is unbound. <P> -<A NAME="IDX110"></A> +<A NAME="IDX114"></A> <DT><CODE>copy-forward-word ()</CODE> -<DD><A NAME="IDX111"></A> +<DD><A NAME="IDX115"></A> Copy the word following point to the kill buffer. The word boundaries are the same as <CODE>forward-word</CODE>. By default, this command is unbound. <P> -<A NAME="IDX112"></A> +<A NAME="IDX116"></A> <DT><CODE>yank (C-y)</CODE> -<DD><A NAME="IDX113"></A> +<DD><A NAME="IDX117"></A> Yank the top of the kill ring into the buffer at point. <P> -<A NAME="IDX114"></A> +<A NAME="IDX118"></A> <DT><CODE>yank-pop (M-y)</CODE> -<DD><A NAME="IDX115"></A> +<DD><A NAME="IDX119"></A> Rotate the kill-ring, and yank the new top. You can only do this if the prior command is <CODE>yank</CODE> or <CODE>yank-pop</CODE>. </DL> @@ -1565,16 +1601,16 @@ the prior command is <CODE>yank</CODE> or <CODE>yank-pop</CODE>. <!--docid::SEC18::--> <DL COMPACT> -<A NAME="IDX116"></A> +<A NAME="IDX120"></A> <DT><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE> -<DD><A NAME="IDX117"></A> +<DD><A NAME="IDX121"></A> Add this digit to the argument already accumulating, or start a new argument. <KBD>M--</KBD> starts a negative argument. <P> -<A NAME="IDX118"></A> +<A NAME="IDX122"></A> <DT><CODE>universal-argument ()</CODE> -<DD><A NAME="IDX119"></A> +<DD><A NAME="IDX123"></A> 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. @@ -1609,30 +1645,30 @@ By default, this is not bound to a key. <P> <DL COMPACT> -<A NAME="IDX120"></A> +<A NAME="IDX124"></A> <DT><CODE>complete (<KBD>TAB</KBD>)</CODE> -<DD><A NAME="IDX121"></A> +<DD><A NAME="IDX125"></A> Attempt to perform completion on the text before point. The actual completion performed is application-specific. The default is filename completion. <P> -<A NAME="IDX122"></A> +<A NAME="IDX126"></A> <DT><CODE>possible-completions (M-?)</CODE> -<DD><A NAME="IDX123"></A> +<DD><A NAME="IDX127"></A> List the possible completions of the text before point. <P> -<A NAME="IDX124"></A> +<A NAME="IDX128"></A> <DT><CODE>insert-completions (M-*)</CODE> -<DD><A NAME="IDX125"></A> +<DD><A NAME="IDX129"></A> Insert all completions of the text before point that would have been generated by <CODE>possible-completions</CODE>. <P> -<A NAME="IDX126"></A> +<A NAME="IDX130"></A> <DT><CODE>menu-complete ()</CODE> -<DD><A NAME="IDX127"></A> +<DD><A NAME="IDX131"></A> Similar to <CODE>complete</CODE>, but replaces the word to be completed with a single match from the list of possible completions. Repeated execution of <CODE>menu-complete</CODE> steps through the list @@ -1647,9 +1683,9 @@ This command is intended to be bound to <KBD>TAB</KBD>, but is unbound by default. <P> -<A NAME="IDX128"></A> +<A NAME="IDX132"></A> <DT><CODE>delete-char-or-list ()</CODE> -<DD><A NAME="IDX129"></A> +<DD><A NAME="IDX133"></A> Deletes the character under the cursor if not at the beginning or end of the line (like <CODE>delete-char</CODE>). If at the end of the line, behaves identically to @@ -1678,22 +1714,22 @@ This command is unbound by default. <!--docid::SEC20::--> <DL COMPACT> -<A NAME="IDX130"></A> +<A NAME="IDX134"></A> <DT><CODE>start-kbd-macro (C-x ()</CODE> -<DD><A NAME="IDX131"></A> +<DD><A NAME="IDX135"></A> Begin saving the characters typed into the current keyboard macro. <P> -<A NAME="IDX132"></A> +<A NAME="IDX136"></A> <DT><CODE>end-kbd-macro (C-x ))</CODE> -<DD><A NAME="IDX133"></A> +<DD><A NAME="IDX137"></A> Stop saving the characters typed into the current keyboard macro and save the definition. <P> -<A NAME="IDX134"></A> +<A NAME="IDX138"></A> <DT><CODE>call-last-kbd-macro (C-x e)</CODE> -<DD><A NAME="IDX135"></A> +<DD><A NAME="IDX139"></A> Re-execute the last keyboard macro defined, by making the characters in the macro appear as if typed at the keyboard. <P> @@ -1719,119 +1755,138 @@ in the macro appear as if typed at the keyboard. <!--docid::SEC21::--> <DL COMPACT> -<A NAME="IDX136"></A> +<A NAME="IDX140"></A> <DT><CODE>re-read-init-file (C-x C-r)</CODE> -<DD><A NAME="IDX137"></A> +<DD><A NAME="IDX141"></A> Read in the contents of the <VAR>inputrc</VAR> file, and incorporate any bindings or variable assignments found there. <P> -<A NAME="IDX138"></A> +<A NAME="IDX142"></A> <DT><CODE>abort (C-g)</CODE> -<DD><A NAME="IDX139"></A> +<DD><A NAME="IDX143"></A> Abort the current editing command and ring the terminal's bell (subject to the setting of <CODE>bell-style</CODE>). <P> -<A NAME="IDX140"></A> +<A NAME="IDX144"></A> <DT><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE> -<DD><A NAME="IDX141"></A> +<DD><A NAME="IDX145"></A> If the metafied character <VAR>x</VAR> is lowercase, run the command that is bound to the corresponding uppercase character. <P> -<A NAME="IDX142"></A> +<A NAME="IDX146"></A> <DT><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE> -<DD><A NAME="IDX143"></A> +<DD><A NAME="IDX147"></A> Metafy the next character typed. This is for keyboards without a meta key. Typing <SAMP>`<KBD>ESC</KBD> f'</SAMP> is equivalent to typing <KBD>M-f</KBD>. <P> -<A NAME="IDX144"></A> +<A NAME="IDX148"></A> <DT><CODE>undo (C-_ or C-x C-u)</CODE> -<DD><A NAME="IDX145"></A> +<DD><A NAME="IDX149"></A> Incremental undo, separately remembered for each line. <P> -<A NAME="IDX146"></A> +<A NAME="IDX150"></A> <DT><CODE>revert-line (M-r)</CODE> -<DD><A NAME="IDX147"></A> +<DD><A NAME="IDX151"></A> Undo all changes made to this line. This is like executing the <CODE>undo</CODE> command enough times to get back to the beginning. <P> -<A NAME="IDX148"></A> +<A NAME="IDX152"></A> <DT><CODE>tilde-expand (M-~)</CODE> -<DD><A NAME="IDX149"></A> +<DD><A NAME="IDX153"></A> Perform tilde expansion on the current word. <P> -<A NAME="IDX150"></A> +<A NAME="IDX154"></A> <DT><CODE>set-mark (C-@)</CODE> -<DD><A NAME="IDX151"></A> +<DD><A NAME="IDX155"></A> Set the mark to the point. If a numeric argument is supplied, the mark is set to that position. <P> -<A NAME="IDX152"></A> +<A NAME="IDX156"></A> <DT><CODE>exchange-point-and-mark (C-x C-x)</CODE> -<DD><A NAME="IDX153"></A> +<DD><A NAME="IDX157"></A> 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. <P> -<A NAME="IDX154"></A> +<A NAME="IDX158"></A> <DT><CODE>character-search (C-])</CODE> -<DD><A NAME="IDX155"></A> +<DD><A NAME="IDX159"></A> A character is read and point is moved to the next occurrence of that character. A negative count searches for previous occurrences. <P> -<A NAME="IDX156"></A> +<A NAME="IDX160"></A> <DT><CODE>character-search-backward (M-C-])</CODE> -<DD><A NAME="IDX157"></A> +<DD><A NAME="IDX161"></A> A character is read and point is moved to the previous occurrence of that character. A negative count searches for subsequent occurrences. <P> -<A NAME="IDX158"></A> +<A NAME="IDX162"></A> <DT><CODE>insert-comment (M-#)</CODE> -<DD><A NAME="IDX159"></A> -The value of the <CODE>comment-begin</CODE> -variable is inserted at the beginning of the current line, -and the line is accepted as if a newline had been typed. +<DD><A NAME="IDX163"></A> +Without a numeric argument, the value of the <CODE>comment-begin</CODE> +variable 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 <CODE>comment-begin</CODE>, the value is inserted, otherwise +the characters in <CODE>comment-begin</CODE> are deleted from the beginning of +the line. +In either case, the line is accepted as if a newline had been typed. <P> -<A NAME="IDX160"></A> +<A NAME="IDX164"></A> <DT><CODE>dump-functions ()</CODE> -<DD><A NAME="IDX161"></A> +<DD><A NAME="IDX165"></A> Print all of the functions and their key bindings 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> -<A NAME="IDX162"></A> +<A NAME="IDX166"></A> <DT><CODE>dump-variables ()</CODE> -<DD><A NAME="IDX163"></A> +<DD><A NAME="IDX167"></A> 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> -<A NAME="IDX164"></A> +<A NAME="IDX168"></A> <DT><CODE>dump-macros ()</CODE> -<DD><A NAME="IDX165"></A> +<DD><A NAME="IDX169"></A> 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 <VAR>inputrc</VAR> file. This command is unbound by default. <P> +<A NAME="IDX170"></A> +<DT><CODE>emacs-editing-mode (C-e)</CODE> +<DD><A NAME="IDX171"></A> +When in <CODE>vi</CODE> command mode, this causes a switch to <CODE>emacs</CODE> +editing mode. +<P> + +<A NAME="IDX172"></A> +<DT><CODE>vi-editing-mode (M-C-j)</CODE> +<DD><A NAME="IDX173"></A> +When in <CODE>emacs</CODE> editing mode, this causes a switch to <CODE>vi</CODE> +editing mode. +<P> + </DL> <P> @@ -1959,7 +2014,7 @@ so forth. <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD> </TR></TABLE> <H1>About this document</H1> -This document was generated by <I>Chet Ramey</I> on <I>October, 9 2001</I> +This document was generated by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> <P></P> @@ -2121,7 +2176,7 @@ the following structure: <BR> <FONT SIZE="-1"> This document was generated -by <I>Chet Ramey</I> on <I>October, 9 2001</I> +by <I>Chet Ramey</I> on <I>June, 27 2002</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> diff --git a/doc/rluserman.info b/doc/rluserman.info index 63ccdf0..3fccbd4 100644 --- a/doc/rluserman.info +++ b/doc/rluserman.info @@ -1,4 +1,4 @@ -This is rluserman.info, produced by makeinfo version 4.0 from +This is rluserman.info, produced by makeinfo version 4.1 from /usr/homes/chet/src/bash/readline-src/doc/rluserman.texinfo. INFO-DIR-SECTION Libraries @@ -10,7 +10,7 @@ END-INFO-DIR-ENTRY Library, a utility which aids in the consistency of user interface across discrete programs that need to provide a command line interface. - Copyright (C) 1988-2001 Free Software Foundation, Inc. + Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice pare @@ -466,6 +466,11 @@ Variable Settings asterisk (`*') at the start of history lines which have been modified. This variable is `off' by default. + `mark-symlinked-directories' + If set to `on', completed names which are symbolic links to + directories have a slash appended (subject to the value of + `mark-directories'). The default is `off'. + `match-hidden-files' This variable, when set to `on', causes Readline to match files whose names begin with a `.' (hidden files) when @@ -478,6 +483,11 @@ Variable Settings eighth bit set directly rather than as a meta-prefixed escape sequence. The default is `off'. + `page-completions' + If set to `on', Readline uses an internal `more'-like pager + to display a screenful of possible completions at a time. + This variable is `on' by default. + `print-completions-horizontally' If set to `on', Readline will display completions with matches sorted horizontally in alphabetical order, rather than down @@ -680,14 +690,14 @@ binding, variable assignment, and conditional syntax. # This file controls the behaviour of line input editing for - # programs that use the Gnu Readline library. Existing programs - # include FTP, Bash, and Gdb. + # programs that use the GNU Readline library. Existing + # programs include FTP, Bash, and GDB. # # You can re-read the inputrc file with C-x C-r. # Lines beginning with '#' are comments. # - # First, include any systemwide bindings and variable assignments from - # /etc/Inputrc + # First, include any systemwide bindings and variable + # assignments from /etc/Inputrc $include /etc/Inputrc # @@ -739,10 +749,12 @@ binding, variable assignment, and conditional syntax. $if Bash # edit the path "\C-xp": "PATH=${PATH}\e\C-e\C-a\ef\C-f" - # prepare to type a quoted word -- insert open and close double quotes + # prepare to type a quoted word -- + # insert open and close double quotes # and move to just after the open quote "\C-x\"": "\"\"\C-b" - # insert a backslash (testing backslash escapes in sequences and macros) + # insert a backslash (testing backslash escapes + # in sequences and macros) "\C-x\\": "\\" # Quote the current or previous word "\C-xq": "\eb\"\ef\"" @@ -758,16 +770,16 @@ binding, variable assignment, and conditional syntax. # don't strip characters to 7 bits when reading set input-meta on - # allow iso-latin1 characters to be inserted rather than converted to - # prefix-meta sequences + # allow iso-latin1 characters to be inserted rather + # than converted to prefix-meta sequences set convert-meta off - # display characters with the eighth bit set directly rather than - # as meta-prefixed characters + # display characters with the eighth bit set directly + # rather than as meta-prefixed characters set output-meta on - # if there are more than 150 possible completions for a word, ask the - # user if he wants to see all of them + # if there are more than 150 possible completions for + # a word, ask the user if he wants to see all of them set completion-query-items 150 # For FTP @@ -958,6 +970,20 @@ Commands For Changing Text Capitalize the current (or following) word. With a negative argument, capitalize the previous word, but do not move the cursor. +`overwrite-mode ()' + Toggle overwrite mode. With an explicit positive numeric argument, + switches to overwrite mode. With an explicit non-positive numeric + argument, switches to insert mode. This command affects only + `emacs' mode; `vi' mode does overwrite differently. Each call to + `readline()' starts in insert mode. + + In overwrite mode, characters bound to `self-insert' replace the + text at point rather than pushing the text to the right. + Characters bound to `backward-delete-char' replace the character + before point with a space. + + By default, this command is unbound. + File: rluserman.info, Node: Commands For Killing, Next: Numeric Arguments, Prev: Commands For Text, Up: Bindable Readline Commands @@ -1147,9 +1173,14 @@ Some Miscellaneous Commands occurrences. `insert-comment (M-#)' - The value of the `comment-begin' variable is inserted at the - beginning of the current line, and the line is accepted as if a - newline had been typed. + Without a numeric argument, the value of the `comment-begin' + variable 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 `comment-begin', the value is inserted, otherwise the + characters in `comment-begin' are deleted from the beginning of + the line. In either case, the line is accepted as if a newline + had been typed. `dump-functions ()' Print all of the functions and their key bindings to the Readline @@ -1169,6 +1200,14 @@ Some Miscellaneous Commands output is formatted in such a way that it can be made part of an INPUTRC file. This command is unbound by default. +`emacs-editing-mode (C-e)' + When in `vi' command mode, this causes a switch to `emacs' editing + mode. + +`vi-editing-mode (M-C-j)' + When in `emacs' editing mode, this causes a switch to `vi' editing + mode. + File: rluserman.info, Node: Readline vi Mode, Prev: Bindable Readline Commands, Up: Command Line Editing @@ -1205,17 +1244,17 @@ Node: Readline Arguments9675 Node: Searching10712 Node: Readline Init File12856 Node: Readline Init File Syntax13918 -Node: Conditional Init Constructs24369 -Node: Sample Init File26895 -Node: Bindable Readline Commands30066 -Node: Commands For Moving31117 -Node: Commands For History31967 -Node: Commands For Text34826 -Node: Commands For Killing36918 -Node: Numeric Arguments38870 -Node: Commands For Completion39999 -Node: Keyboard Macros41532 -Node: Miscellaneous Commands42092 -Node: Readline vi Mode44886 +Node: Conditional Init Constructs24802 +Node: Sample Init File27328 +Node: Bindable Readline Commands30513 +Node: Commands For Moving31564 +Node: Commands For History32414 +Node: Commands For Text35273 +Node: Commands For Killing37988 +Node: Numeric Arguments39940 +Node: Commands For Completion41069 +Node: Keyboard Macros42602 +Node: Miscellaneous Commands43162 +Node: Readline vi Mode46512 End Tag Table diff --git a/doc/rluserman.ps b/doc/rluserman.ps index c6b807e..b46417a 100644 --- a/doc/rluserman.ps +++ b/doc/rluserman.ps @@ -1,14 +1,14 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.86 Copyright 1999 Radical Eye Software %%Title: rluserman.dvi -%%Pages: 22 +%%Pages: 24 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 %%EndComments %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 300 -t letter -o rluserman.ps rluserman.dvi %DVIPSParameters: dpi=300, compressed -%DVIPSSource: TeX output 2001.10.09:1508 +%DVIPSSource: TeX output 2002.06.27:1354 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -769,9 +769,9 @@ letter %%EndSetup %%Page: 1 1 1 0 bop 75 659 a Fn(GNU)33 b(Readline)h(Library)e(User)h(In)m(terface)p -75 709 1800 17 v 891 757 a Fm(Edition)16 b(4.2a,)e(for)g -Fl(Readline)g(Library)h Fm(V)l(ersion)h(4.2a.)1608 811 -y(Octob)q(er)g(2001)75 2467 y Fk(Brian)23 b(F)-6 b(o)n(x,)23 +75 709 1800 17 v 936 757 a Fm(Edition)17 b(4.3,)c(for)i +Fl(Readline)f(Library)g Fm(V)l(ersion)i(4.3.)1643 811 +y(Marc)o(h)e(2002)75 2467 y Fk(Brian)23 b(F)-6 b(o)n(x,)23 b(F)-6 b(ree)23 b(Soft)n(w)n(are)f(F)-6 b(oundation)75 2534 y(Chet)22 b(Ramey)-6 b(,)23 b(Case)e(W)-6 b(estern)23 b(Reserv)n(e)f(Univ)n(ersit)n(y)p 75 2570 1800 9 v eop @@ -800,7 +800,7 @@ g(lan-)75 924 y(guage,)e(under)h(the)f(ab)q(o)o(v)o(e)g(conditions)i (ermission)g(notice)75 979 y(ma)o(y)f(b)q(e)i(stated)f(in)h(a)f (translation)g(appro)o(v)o(ed)g(b)o(y)g(the)g(F)l(ree)h(Soft)o(w)o(are) d(F)l(oundation.)75 2661 y(Cop)o(yrigh)o(t)301 2660 y(c)289 -2661 y Fj(\015)h Fm(1988-2001)f(F)l(ree)i(Soft)o(w)o(are)f(F)l +2661 y Fj(\015)h Fm(1988-2002)f(F)l(ree)i(Soft)o(w)o(are)f(F)l (oundation,)h(Inc.)p eop %%Page: 1 3 1 2 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 @@ -1128,7 +1128,7 @@ b(lines)g(are)75 1886 y(ignored.)36 b(Lines)22 b(b)q(eginning)h(with)d (a)h(`)p Fl(#)p Fm(')e(are)h(commen)o(ts.)35 b(Lines)22 b(b)q(eginning)h(with)e(a)f(`)p Fl($)p Fm(')f(indicate)75 1941 y(conditional)c(constructs)f(\(see)g(Section)g(1.3.2)f -([Conditional)h(Init)h(Constructs],)e(page)h(8\).)k(Other)c(lines)75 +([Conditional)h(Init)h(Constructs],)e(page)h(9\).)k(Other)c(lines)75 1996 y(denote)h(v)m(ariable)i(settings)e(and)h(k)o(ey)f(bindings.)75 2073 y(V)l(ariable)h(Settings)315 2128 y(Y)l(ou)k(can)h(mo)q(dify)g (the)f(run-time)h(b)q(eha)o(vior)g(of)e(Readline)j(b)o(y)e(altering)h @@ -1255,211 +1255,224 @@ y Fl(mark-modified-lines)555 1766 y Fm(This)j(v)m(ariable,)g(when)g (an)f(as-)555 1821 y(terisk)f(\(`)p Fl(*)p Fm('\))e(at)i(the)f(start)g (of)h(history)f(lines)j(whic)o(h)e(ha)o(v)o(e)g(b)q(een)h(mo)q (di\014ed.)555 1875 y(This)e(v)m(ariable)g(is)g(`)p Fl(off)p -Fm(')e(b)o(y)h(default.)315 1958 y Fl(match-hidden-files)555 -2012 y Fm(This)d(v)m(ariable,)h(when)e(set)g(to)g(`)p -Fl(on)p Fm(',)f(causes)h(Readline)i(to)d(matc)o(h)h(\014les)h(whose)555 -2067 y(names)22 b(b)q(egin)h(with)g(a)e(`)p Fl(.)p Fm(')h(\(hidden)h -(\014les\))g(when)f(p)q(erforming)h(\014lename)555 2122 -y(completion,)g(unless)f(the)f(leading)h(`)p Fl(.)p Fm(')e(is)h -(supplied)i(b)o(y)e(the)f(user)h(in)h(the)555 2177 y(\014lename)16 -b(to)f(b)q(e)h(completed.)21 b(This)15 b(v)m(ariable)i(is)f(`)p -Fl(on)p Fm(')e(b)o(y)h(default.)315 2259 y Fl(output-meta)555 -2314 y Fm(If)j(set)f(to)g(`)p Fl(on)p Fm(',)g(Readline)i(will)h(displa) -o(y)f(c)o(haracters)d(with)j(the)e(eigh)o(th)h(bit)555 -2369 y(set)g(directly)i(rather)d(than)h(as)g(a)g(meta-pre\014xed)h -(escap)q(e)g(sequence.)30 b(The)555 2423 y(default)16 -b(is)f(`)p Fl(off)p Fm('.)315 2506 y Fl(print-completions-horizont)o -(ally)555 2560 y Fm(If)d(set)g(to)f(`)p Fl(on)p Fm(',)h(Readline)h -(will)g(displa)o(y)h(completions)f(with)f(matc)o(hes)f(sorted)555 -2615 y(horizon)o(tally)23 b(in)f(alphab)q(etical)i(order,)f(rather)e -(than)g(do)o(wn)h(the)g(screen.)555 2670 y(The)15 b(default)h(is)g(`)p -Fl(off)p Fm('.)p eop +Fm(')e(b)o(y)h(default.)315 1958 y Fl(mark-symlinked-directories)555 +2012 y Fm(If)23 b(set)f(to)f(`)p Fl(on)p Fm(',)i(completed)g(names)g +(whic)o(h)g(are)f(sym)o(b)q(olic)i(links)f(to)f(di-)555 +2067 y(rectories)h(ha)o(v)o(e)g(a)g(slash)g(app)q(ended)i(\(sub)s(ject) +e(to)f(the)i(v)m(alue)g(of)f Fl(mark-)555 2122 y(directories)p +Fm(\).)18 b(The)d(default)h(is)g(`)p Fl(off)p Fm('.)315 +2204 y Fl(match-hidden-files)555 2259 y Fm(This)c(v)m(ariable,)h(when)e +(set)g(to)g(`)p Fl(on)p Fm(',)f(causes)h(Readline)i(to)d(matc)o(h)h +(\014les)h(whose)555 2314 y(names)22 b(b)q(egin)h(with)g(a)e(`)p +Fl(.)p Fm(')h(\(hidden)h(\014les\))g(when)f(p)q(erforming)h(\014lename) +555 2369 y(completion,)g(unless)f(the)f(leading)h(`)p +Fl(.)p Fm(')e(is)h(supplied)i(b)o(y)e(the)f(user)h(in)h(the)555 +2423 y(\014lename)16 b(to)f(b)q(e)h(completed.)21 b(This)15 +b(v)m(ariable)i(is)f(`)p Fl(on)p Fm(')e(b)o(y)h(default.)315 +2506 y Fl(output-meta)555 2560 y Fm(If)j(set)f(to)g(`)p +Fl(on)p Fm(',)g(Readline)i(will)h(displa)o(y)f(c)o(haracters)d(with)j +(the)e(eigh)o(th)h(bit)555 2615 y(set)g(directly)i(rather)d(than)h(as)g +(a)g(meta-pre\014xed)h(escap)q(e)g(sequence.)30 b(The)555 +2670 y(default)16 b(is)f(`)p Fl(off)p Fm('.)p eop %%Page: 7 9 7 8 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 -b(7)315 149 y Fl(show-all-if-ambiguous)555 204 y Fm(This)16 -b(alters)e(the)i(default)f(b)q(eha)o(vior)h(of)e(the)h(completion)h -(functions.)21 b(If)15 b(set)555 259 y(to)e(`)p Fl(on)p -Fm(',)g(w)o(ords)g(whic)o(h)h(ha)o(v)o(e)g(more)f(than)g(one)h(p)q -(ossible)i(completion)f(cause)555 314 y(the)20 b(matc)o(hes)f(to)f(b)q -(e)j(listed)f(immediately)h(instead)f(of)f(ringing)i(the)e(b)q(ell.)555 -369 y(The)c(default)h(v)m(alue)h(is)e(`)p Fl(off)p Fm('.)315 -448 y Fl(visible-stats)555 502 y Fm(If)h(set)g(to)f(`)p +b(7)315 149 y Fl(page-completions)555 204 y Fm(If)17 +b(set)g(to)f(`)p Fl(on)p Fm(',)g(Readline)i(uses)g(an)e(in)o(ternal)i +Fl(more)p Fm(-lik)o(e)g(pager)f(to)f(displa)o(y)555 259 +y(a)g(screenful)h(of)f(p)q(ossible)i(completions)f(at)f(a)g(time.)23 +b(This)17 b(v)m(ariable)g(is)g(`)p Fl(on)p Fm(')555 314 +y(b)o(y)e(default.)315 395 y Fl(print-completions-horizont)o(ally)555 +450 y Fm(If)d(set)g(to)f(`)p Fl(on)p Fm(',)h(Readline)h(will)g(displa)o +(y)h(completions)f(with)f(matc)o(hes)f(sorted)555 505 +y(horizon)o(tally)23 b(in)f(alphab)q(etical)i(order,)f(rather)e(than)g +(do)o(wn)h(the)g(screen.)555 560 y(The)15 b(default)h(is)g(`)p +Fl(off)p Fm('.)315 641 y Fl(show-all-if-ambiguous)555 +696 y Fm(This)g(alters)e(the)i(default)f(b)q(eha)o(vior)h(of)e(the)h +(completion)h(functions.)21 b(If)15 b(set)555 751 y(to)e(`)p +Fl(on)p Fm(',)g(w)o(ords)g(whic)o(h)h(ha)o(v)o(e)g(more)f(than)g(one)h +(p)q(ossible)i(completion)f(cause)555 806 y(the)20 b(matc)o(hes)f(to)f +(b)q(e)j(listed)f(immediately)h(instead)f(of)f(ringing)i(the)e(b)q +(ell.)555 861 y(The)c(default)h(v)m(alue)h(is)e(`)p Fl(off)p +Fm('.)315 942 y Fl(visible-stats)555 997 y Fm(If)h(set)g(to)f(`)p Fl(on)p Fm(',)g(a)h(c)o(haracter)f(denoting)h(a)g(\014le's)h(t)o(yp)q -(e)f(is)g(app)q(ended)i(to)d(the)555 557 y(\014lename)h(when)g(listing) -h(p)q(ossible)g(completions.)j(The)c(default)g(is)f(`)p -Fl(off)p Fm('.)75 636 y(Key)h(Bindings)315 691 y(The)21 +(e)f(is)g(app)q(ended)i(to)d(the)555 1052 y(\014lename)h(when)g +(listing)h(p)q(ossible)g(completions.)j(The)c(default)g(is)f(`)p +Fl(off)p Fm('.)75 1133 y(Key)h(Bindings)315 1188 y(The)21 b(syn)o(tax)f(for)h(con)o(trolling)h(k)o(ey)f(bindings)h(in)g(the)f (init)h(\014le)g(is)g(simple.)39 b(First)20 b(y)o(ou)315 -746 y(need)15 b(to)e(\014nd)h(the)g(name)g(of)g(the)f(command)h(that)f +1243 y(need)15 b(to)e(\014nd)h(the)g(name)g(of)g(the)f(command)h(that)f (y)o(ou)h(w)o(an)o(t)f(to)g(c)o(hange.)19 b(The)14 b(follo)o(wing)315 -801 y(sections)k(con)o(tain)h(tables)f(of)f(the)h(command)g(name,)g +1298 y(sections)k(con)o(tain)h(tables)f(of)f(the)h(command)g(name,)g (the)g(default)h(k)o(eybinding,)h(if)e(an)o(y)l(,)315 -855 y(and)d(a)g(short)g(description)i(of)d(what)h(the)g(command)g(do)q -(es.)315 922 y(Once)k(y)o(ou)f(kno)o(w)f(the)h(name)g(of)g(the)g +1353 y(and)d(a)g(short)g(description)i(of)d(what)h(the)g(command)g(do)q +(es.)315 1421 y(Once)k(y)o(ou)f(kno)o(w)f(the)h(name)g(of)g(the)g (command,)g(simply)h(place)g(on)f(a)f(line)j(in)f(the)f(init)315 -977 y(\014le)g(the)f(name)g(of)f(the)h(k)o(ey)g(y)o(ou)f(wish)i(to)e +1476 y(\014le)g(the)f(name)g(of)f(the)h(k)o(ey)g(y)o(ou)f(wish)i(to)e (bind)i(the)f(command)g(to,)f(a)g(colon,)i(and)f(then)315 -1032 y(the)f(name)g(of)g(the)g(command.)22 b(The)16 b(name)g(of)g(the)g +1530 y(the)f(name)g(of)g(the)g(command.)22 b(The)16 b(name)g(of)g(the)g (k)o(ey)f(can)i(b)q(e)f(expressed)h(in)g(di\013eren)o(t)315 -1087 y(w)o(a)o(ys,)d(dep)q(ending)j(on)e(what)g(y)o(ou)g(\014nd)h(most) -e(comfortable.)315 1154 y(In)19 b(addition)g(to)e(command)h(names,)g +1585 y(w)o(a)o(ys,)d(dep)q(ending)j(on)e(what)g(y)o(ou)g(\014nd)h(most) +e(comfortable.)315 1653 y(In)19 b(addition)g(to)e(command)h(names,)g (readline)i(allo)o(ws)e(k)o(eys)g(to)f(b)q(e)i(b)q(ound)g(to)e(a)h -(string)315 1208 y(that)c(is)i(inserted)g(when)g(the)f(k)o(ey)g(is)h -(pressed)g(\(a)e Fc(macro)r Fm(\).)315 1288 y Fc(k)o(eyname)s -Fm(:)19 b Fc(function-name)g Fm(or)c Fc(macro)555 1342 +(string)315 1708 y(that)c(is)i(inserted)g(when)g(the)f(k)o(ey)g(is)h +(pressed)g(\(a)e Fc(macro)r Fm(\).)315 1790 y Fc(k)o(eyname)s +Fm(:)19 b Fc(function-name)g Fm(or)c Fc(macro)555 1845 y(k)o(eyname)i Fm(is)e(the)f(name)h(of)f(a)g(k)o(ey)g(sp)q(elled)j(out) -d(in)h(English.)21 b(F)l(or)13 b(example:)675 1406 y -Fl(Control-u:)22 b(universal-argument)675 1458 y(Meta-Rubout:)g -(backward-kill-word)675 1510 y(Control-o:)g(">)i(output")555 -1577 y Fm(In)c(the)f(ab)q(o)o(v)o(e)g(example,)i Fg(C-u)e +d(in)h(English.)21 b(F)l(or)13 b(example:)675 1910 y +Fl(Control-u:)22 b(universal-argument)675 1962 y(Meta-Rubout:)g +(backward-kill-word)675 2014 y(Control-o:)g(">)i(output")555 +2082 y Fm(In)c(the)f(ab)q(o)o(v)o(e)g(example,)i Fg(C-u)e Fm(is)h(b)q(ound)g(to)f(the)g(function)h Fl(universal-)555 -1632 y(argument)p Fm(,)e Fg(M-DEL)h Fm(is)g(b)q(ound)h(to)e(the)h -(function)h Fl(backward-kill-word)p Fm(,)555 1687 y(and)g +2137 y(argument)p Fm(,)e Fg(M-DEL)h Fm(is)g(b)q(ound)h(to)e(the)h +(function)h Fl(backward-kill-word)p Fm(,)555 2191 y(and)g Fg(C-o)f Fm(is)h(b)q(ound)g(to)f(run)h(the)f(macro)g(expressed)h(on)g -(the)f(righ)o(t)h(hand)555 1741 y(side)c(\(that)e(is,)i(to)e(insert)i +(the)f(righ)o(t)h(hand)555 2246 y(side)c(\(that)e(is,)i(to)e(insert)i (the)f(text)g(`)p Fl(>)f(output)p Fm(')g(in)o(to)i(the)f(line\).)555 -1808 y(A)k(n)o(um)o(b)q(er)f(of)g(sym)o(b)q(olic)i(c)o(haracter)e -(names)g(are)g(recognized)i(while)g(pro-)555 1863 y(cessing)13 +2314 y(A)k(n)o(um)o(b)q(er)f(of)g(sym)o(b)q(olic)i(c)o(haracter)e +(names)g(are)g(recognized)i(while)g(pro-)555 2369 y(cessing)13 b(this)f(k)o(ey)g(binding)h(syn)o(tax:)18 b Fc(DEL)p Fm(,)11 b Fc(ESC)p Fm(,)h Fc(ESCAPE)p Fm(,)f Fc(LFD)p -Fm(,)g Fc(NEW-)555 1918 y(LINE)p Fm(,)16 b Fc(RET)p Fm(,)e +Fm(,)g Fc(NEW-)555 2424 y(LINE)p Fm(,)16 b Fc(RET)p Fm(,)e Fc(RETURN)p Fm(,)f Fc(R)o(UBOUT)p Fm(,)i Fc(SP)l(A)o(CE)p -Fm(,)g Fc(SPC)p Fm(,)f(and)i Fc(T)l(AB)p Fm(.)315 1997 +Fm(,)g Fc(SPC)p Fm(,)f(and)i Fc(T)l(AB)p Fm(.)315 2506 y Fl(")p Fc(k)o(eyseq)q Fl(")p Fm(:)k Fc(function-name)e -Fm(or)d Fc(macro)555 2052 y(k)o(eyseq)i Fm(di\013ers)e(from)g +Fm(or)d Fc(macro)555 2560 y(k)o(eyseq)i Fm(di\013ers)e(from)g Fc(k)o(eyname)j Fm(ab)q(o)o(v)o(e)d(in)i(that)d(strings)i(denoting)g -(an)f(en-)555 2107 y(tire)i(k)o(ey)g(sequence)h(can)f(b)q(e)g(sp)q +(an)f(en-)555 2615 y(tire)i(k)o(ey)g(sequence)h(can)f(b)q(e)g(sp)q (eci\014ed,)i(b)o(y)e(placing)h(the)f(k)o(ey)g(sequence)h(in)555 -2161 y(double)e(quotes.)j(Some)c Fh(gnu)g Fm(Emacs)f(st)o(yle)h(k)o(ey) -g(escap)q(es)g(can)g(b)q(e)g(used,)g(as)555 2216 y(in)j(the)f(follo)o -(wing)g(example,)h(but)f(the)g(sp)q(ecial)i(c)o(haracter)d(names)h(are) -f(not)555 2271 y(recognized.)675 2335 y Fl("\\C-u":)23 -b(universal-argument)675 2387 y("\\C-x\\C-r":)f(re-read-init-file)675 -2439 y("\\e[11~":)h("Function)f(Key)i(1")555 2506 y Fm(In)33 -b(the)f(ab)q(o)o(v)o(e)g(example,)37 b Fg(C-u)32 b Fm(is)h(again)f(b)q -(ound)h(to)f(the)g(function)555 2560 y Fl(universal-argument)19 -b Fm(\(just)j(as)f(it)h(w)o(as)f(in)i(the)f(\014rst)f(example\),)j(`)p -Fg(C-x)555 2615 y(C-r)p Fm(')c(is)h(b)q(ound)g(to)f(the)h(function)g -Fl(re-read-init-file)p Fm(,)f(and)g(`)1731 2613 y Ff(h)p -1743 2587 70 2 v 1743 2615 a Fe(ESC)p 1743 2623 V 1810 -2613 a Ff(i)15 b(h)p 1852 2587 10 2 v 1852 2615 a Fe([)p -1852 2623 V 1860 2613 a Ff(i)555 2668 y(h)p 567 2642 -18 2 v 567 2670 a Fe(1)p 567 2678 V 583 2668 a Ff(i)g(h)p -625 2642 V 625 2670 a Fe(1)p 625 2678 V 640 2668 a Ff(i)g(h)p -683 2642 24 2 v 683 2670 a Fl(~)p 683 2678 V 704 2668 -a Ff(i)719 2670 y Fm(')g(is)h(b)q(ound)g(to)e(insert)i(the)f(text)g(`)p -Fl(Function)f(Key)g(1)p Fm('.)p eop +2670 y(double)e(quotes.)j(Some)c Fh(gnu)g Fm(Emacs)f(st)o(yle)h(k)o(ey) +g(escap)q(es)g(can)g(b)q(e)g(used,)g(as)p eop %%Page: 8 10 -8 9 bop 75 -58 a Fm(8)1322 b(GNU)15 b(Readline)h(Library)315 -149 y(The)f(follo)o(wing)h Fh(gnu)e Fm(Emacs)h(st)o(yle)g(escap)q(e)h +8 9 bop 75 -58 a Fm(8)1322 b(GNU)15 b(Readline)h(Library)555 +149 y(in)i(the)f(follo)o(wing)g(example,)h(but)f(the)g(sp)q(ecial)i(c)o +(haracter)d(names)h(are)f(not)555 204 y(recognized.)675 +270 y Fl("\\C-u":)23 b(universal-argument)675 322 y("\\C-x\\C-r":)f +(re-read-init-file)675 373 y("\\e[11~":)h("Function)f(Key)i(1")555 +442 y Fm(In)33 b(the)f(ab)q(o)o(v)o(e)g(example,)37 b +Fg(C-u)32 b Fm(is)h(again)f(b)q(ound)h(to)f(the)g(function)555 +497 y Fl(universal-argument)19 b Fm(\(just)j(as)f(it)h(w)o(as)f(in)i +(the)f(\014rst)f(example\),)j(`)p Fg(C-x)555 551 y(C-r)p +Fm(')c(is)h(b)q(ound)g(to)f(the)h(function)g Fl(re-read-init-file)p +Fm(,)f(and)g(`)1731 549 y Ff(h)p 1743 523 70 2 v 1743 +551 a Fe(ESC)p 1743 559 V 1810 549 a Ff(i)15 b(h)p 1852 +523 10 2 v 1852 551 a Fe([)p 1852 560 V 1860 549 a Ff(i)555 +604 y(h)p 567 578 18 2 v 567 606 a Fe(1)p 567 614 V 583 +604 a Ff(i)g(h)p 625 578 V 625 606 a Fe(1)p 625 614 V +640 604 a Ff(i)g(h)p 683 578 24 2 v 683 606 a Fl(~)p +683 614 V 704 604 a Ff(i)719 606 y Fm(')g(is)h(b)q(ound)g(to)e(insert)i +(the)f(text)g(`)p Fl(Function)f(Key)g(1)p Fm('.)315 688 +y(The)h(follo)o(wing)h Fh(gnu)e Fm(Emacs)h(st)o(yle)g(escap)q(e)h (sequences)g(are)e(a)o(v)m(ailable)j(when)e(sp)q(ecifying)315 -204 y(k)o(ey)g(sequences:)315 287 y Fg(\\C-)168 b Fm(con)o(trol)15 -b(pre\014x)315 370 y Fg(\\M-)168 b Fm(meta)15 b(pre\014x)315 -453 y Fg(\\e)192 b Fm(an)15 b(escap)q(e)h(c)o(haracter)315 -536 y Fg(\\\\)192 b Fm(bac)o(kslash)315 619 y Fg(\\)p -Fl(")555 617 y Ff(h)p 567 591 24 2 v 567 619 a Fl(")p -567 627 V 589 617 a Ff(i)604 619 y Fm(,)15 b(a)f(double)j(quotation)e -(mark)315 702 y Fg(\\')555 700 y Ff(h)p 567 674 10 2 -v 567 702 a Fe(')p 567 710 V 575 700 a Ff(i)590 702 y -Fm(,)g(a)f(single)j(quote)e(or)g(ap)q(ostrophe)315 785 -y(In)f(addition)h(to)f(the)f Fh(gnu)h Fm(Emacs)g(st)o(yle)f(escap)q(e)i -(sequences,)g(a)e(second)i(set)e(of)h(bac)o(kslash)315 -840 y(escap)q(es)i(is)g(a)o(v)m(ailable:)315 923 y Fl(\\a)192 -b Fm(alert)15 b(\(b)q(ell\))315 1006 y Fl(\\b)192 b Fm(bac)o(kspace)315 -1089 y Fl(\\d)g Fm(delete)315 1172 y Fl(\\f)g Fm(form)14 -b(feed)315 1255 y Fl(\\n)192 b Fm(newline)315 1338 y -Fl(\\r)g Fm(carriage)15 b(return)315 1421 y Fl(\\t)192 -b Fm(horizon)o(tal)16 b(tab)315 1504 y Fl(\\v)192 b Fm(v)o(ertical)16 -b(tab)315 1587 y Fl(\\)p Fc(nnn)141 b Fm(the)17 b(eigh)o(t-bit)h(c)o -(haracter)f(whose)g(v)m(alue)i(is)e(the)h(o)q(ctal)f(v)m(alue)i -Fc(nnn)f Fm(\(one)f(to)555 1642 y(three)e(digits\))315 -1725 y Fl(\\x)p Fc(HH)124 b Fm(the)20 b(eigh)o(t-bit)g(c)o(haracter)f -(whose)h(v)m(alue)h(is)f(the)g(hexadecimal)h(v)m(alue)g -Fc(HH)555 1780 y Fm(\(one)15 b(or)g(t)o(w)o(o)f(hex)h(digits\))315 -1863 y(When)k(en)o(tering)g(the)g(text)f(of)g(a)h(macro,)f(single)i(or) -e(double)i(quotes)f(m)o(ust)f(b)q(e)h(used)h(to)315 1917 -y(indicate)12 b(a)f(macro)f(de\014nition.)20 b(Unquoted)11 -b(text)f(is)i(assumed)e(to)h(b)q(e)g(a)f(function)i(name.)18 -b(In)315 1972 y(the)11 b(macro)f(b)q(o)q(dy)l(,)i(the)f(bac)o(kslash)g -(escap)q(es)g(describ)q(ed)i(ab)q(o)o(v)o(e)d(are)g(expanded.)20 -b(Bac)o(kslash)315 2027 y(will)i(quote)d(an)o(y)h(other)g(c)o(haracter) -f(in)i(the)f(macro)f(text,)h(including)j(`)p Fl(")p Fm(')c(and)h(`)p -Fl(')p Fm('.)34 b(F)l(or)315 2082 y(example,)14 b(the)f(follo)o(wing)g -(binding)i(will)g(mak)o(e)d(`)p Fg(C-x)i Fl(\\)p Fm(')f(insert)g(a)g -(single)h(`)p Fl(\\)p Fm(')e(in)o(to)h(the)g(line:)435 -2148 y Fl("\\C-x\\\\":)23 b("\\\\")75 2267 y Fb(1.3.2)30 -b(Conditional)20 b(Init)g(Constructs)137 2366 y Fm(Readline)f(implemen) -o(ts)g(a)f(facilit)o(y)g(similar)h(in)g(spirit)f(to)f(the)h -(conditional)h(compilation)g(features)75 2421 y(of)e(the)g(C)g(prepro)q -(cessor)g(whic)o(h)i(allo)o(ws)e(k)o(ey)g(bindings)i(and)f(v)m(ariable) -g(settings)f(to)g(b)q(e)h(p)q(erformed)f(as)75 2476 y(the)e(result)h -(of)f(tests.)k(There)c(are)g(four)g(parser)g(directiv)o(es)h(used.)75 -2560 y Fl($if)168 b Fm(The)16 b Fl($if)f Fm(construct)g(allo)o(ws)h -(bindings)i(to)d(b)q(e)h(made)g(based)g(on)f(the)h(editing)h(mo)q(de,)f -(the)315 2615 y(terminal)k(b)q(eing)g(used,)g(or)f(the)g(application)i -(using)e(Readline.)33 b(The)19 b(text)g(of)f(the)i(test)315 -2670 y(extends)c(to)e(the)h(end)h(of)f(the)g(line;)i(no)e(c)o -(haracters)f(are)h(required)i(to)d(isolate)i(it.)p eop +743 y(k)o(ey)g(sequences:)315 825 y Fg(\\C-)168 b Fm(con)o(trol)15 +b(pre\014x)315 907 y Fg(\\M-)168 b Fm(meta)15 b(pre\014x)315 +989 y Fg(\\e)192 b Fm(an)15 b(escap)q(e)h(c)o(haracter)315 +1071 y Fg(\\\\)192 b Fm(bac)o(kslash)315 1152 y Fg(\\)p +Fl(")555 1150 y Ff(h)p 567 1124 V 567 1152 a Fl(")p 567 +1160 V 589 1150 a Ff(i)604 1152 y Fm(,)15 b(a)f(double)j(quotation)e +(mark)315 1234 y Fg(\\')555 1232 y Ff(h)p 567 1206 10 +2 v 567 1234 a Fe(')p 567 1242 V 575 1232 a Ff(i)590 +1234 y Fm(,)g(a)f(single)j(quote)e(or)g(ap)q(ostrophe)315 +1316 y(In)f(addition)h(to)f(the)f Fh(gnu)h Fm(Emacs)g(st)o(yle)f(escap) +q(e)i(sequences,)g(a)e(second)i(set)e(of)h(bac)o(kslash)315 +1371 y(escap)q(es)i(is)g(a)o(v)m(ailable:)315 1453 y +Fl(\\a)192 b Fm(alert)15 b(\(b)q(ell\))315 1535 y Fl(\\b)192 +b Fm(bac)o(kspace)315 1617 y Fl(\\d)g Fm(delete)315 1699 +y Fl(\\f)g Fm(form)14 b(feed)315 1781 y Fl(\\n)192 b +Fm(newline)315 1862 y Fl(\\r)g Fm(carriage)15 b(return)315 +1944 y Fl(\\t)192 b Fm(horizon)o(tal)16 b(tab)315 2026 +y Fl(\\v)192 b Fm(v)o(ertical)16 b(tab)315 2108 y Fl(\\)p +Fc(nnn)141 b Fm(the)17 b(eigh)o(t-bit)h(c)o(haracter)f(whose)g(v)m +(alue)i(is)e(the)h(o)q(ctal)f(v)m(alue)i Fc(nnn)f Fm(\(one)f(to)555 +2163 y(three)e(digits\))315 2245 y Fl(\\x)p Fc(HH)124 +b Fm(the)20 b(eigh)o(t-bit)g(c)o(haracter)f(whose)h(v)m(alue)h(is)f +(the)g(hexadecimal)h(v)m(alue)g Fc(HH)555 2300 y Fm(\(one)15 +b(or)g(t)o(w)o(o)f(hex)h(digits\))315 2382 y(When)k(en)o(tering)g(the)g +(text)f(of)g(a)h(macro,)f(single)i(or)e(double)i(quotes)f(m)o(ust)f(b)q +(e)h(used)h(to)315 2436 y(indicate)12 b(a)f(macro)f(de\014nition.)20 +b(Unquoted)11 b(text)f(is)i(assumed)e(to)h(b)q(e)g(a)f(function)i +(name.)18 b(In)315 2491 y(the)11 b(macro)f(b)q(o)q(dy)l(,)i(the)f(bac)o +(kslash)g(escap)q(es)g(describ)q(ed)i(ab)q(o)o(v)o(e)d(are)g(expanded.) +20 b(Bac)o(kslash)315 2546 y(will)i(quote)d(an)o(y)h(other)g(c)o +(haracter)f(in)i(the)f(macro)f(text,)h(including)j(`)p +Fl(")p Fm(')c(and)h(`)p Fl(')p Fm('.)34 b(F)l(or)315 +2601 y(example,)14 b(the)f(follo)o(wing)g(binding)i(will)g(mak)o(e)d(`) +p Fg(C-x)i Fl(\\)p Fm(')f(insert)g(a)g(single)h(`)p Fl(\\)p +Fm(')e(in)o(to)h(the)g(line:)435 2666 y Fl("\\C-x\\\\":)23 +b("\\\\")p eop %%Page: 9 11 9 10 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1077 -b(9)315 149 y Fl(mode)144 b Fm(The)11 b Fl(mode=)e Fm(form)h(of)g(the)h -Fl($if)f Fm(directiv)o(e)h(is)g(used)g(to)f(test)g(whether)h(Readline) -555 204 y(is)k(in)h Fl(emacs)e Fm(or)g Fl(vi)g Fm(mo)q(de.)20 +b(9)75 149 y Fb(1.3.2)30 b(Conditional)20 b(Init)g(Constructs)137 +246 y Fm(Readline)f(implemen)o(ts)g(a)f(facilit)o(y)g(similar)h(in)g +(spirit)f(to)f(the)h(conditional)h(compilation)g(features)75 +301 y(of)e(the)g(C)g(prepro)q(cessor)g(whic)o(h)i(allo)o(ws)e(k)o(ey)g +(bindings)i(and)f(v)m(ariable)g(settings)f(to)g(b)q(e)h(p)q(erformed)f +(as)75 355 y(the)e(result)h(of)f(tests.)k(There)c(are)g(four)g(parser)g +(directiv)o(es)h(used.)75 435 y Fl($if)168 b Fm(The)16 +b Fl($if)f Fm(construct)g(allo)o(ws)h(bindings)i(to)d(b)q(e)h(made)g +(based)g(on)f(the)h(editing)h(mo)q(de,)f(the)315 490 +y(terminal)k(b)q(eing)g(used,)g(or)f(the)g(application)i(using)e +(Readline.)33 b(The)19 b(text)g(of)f(the)i(test)315 545 +y(extends)c(to)e(the)h(end)h(of)f(the)g(line;)i(no)e(c)o(haracters)f +(are)h(required)i(to)d(isolate)i(it.)315 624 y Fl(mode)144 +b Fm(The)11 b Fl(mode=)e Fm(form)h(of)g(the)h Fl($if)f +Fm(directiv)o(e)h(is)g(used)g(to)f(test)g(whether)h(Readline)555 +679 y(is)k(in)h Fl(emacs)e Fm(or)g Fl(vi)g Fm(mo)q(de.)20 b(This)c(ma)o(y)e(b)q(e)h(used)g(in)h(conjunction)g(with)f(the)555 -259 y(`)p Fl(set)f(keymap)p Fm(')f(command,)g(for)h(instance,)g(to)f -(set)h(bindings)h(in)g(the)f Fl(emacs-)555 314 y(standard)d +734 y(`)p Fl(set)f(keymap)p Fm(')f(command,)g(for)h(instance,)g(to)f +(set)h(bindings)h(in)g(the)f Fl(emacs-)555 789 y(standard)d Fm(and)i Fl(emacs-ctlx)e Fm(k)o(eymaps)h(only)i(if)f(Readline)g(is)g -(starting)f(out)555 369 y(in)k Fl(emacs)f Fm(mo)q(de.)315 -448 y Fl(term)144 b Fm(The)14 b Fl(term=)e Fm(form)h(ma)o(y)g(b)q(e)h +(starting)f(out)555 844 y(in)k Fl(emacs)f Fm(mo)q(de.)315 +923 y Fl(term)144 b Fm(The)14 b Fl(term=)e Fm(form)h(ma)o(y)g(b)q(e)h (used)g(to)f(include)j(terminal-sp)q(eci\014c)g(k)o(ey)d(bind-)555 -503 y(ings,)19 b(p)q(erhaps)g(to)e(bind)i(the)g(k)o(ey)e(sequences)j -(output)e(b)o(y)g(the)g(terminal's)555 558 y(function)13 +978 y(ings,)19 b(p)q(erhaps)g(to)e(bind)i(the)g(k)o(ey)e(sequences)j +(output)e(b)o(y)g(the)g(terminal's)555 1033 y(function)13 b(k)o(eys.)18 b(The)13 b(w)o(ord)e(on)h(the)g(righ)o(t)g(side)g(of)g -(the)g(`)p Fl(=)p Fm(')f(is)h(tested)g(against)555 613 +(the)g(`)p Fl(=)p Fm(')f(is)h(tested)g(against)555 1088 y(b)q(oth)j(the)g(full)i(name)e(of)f(the)h(terminal)h(and)f(the)g(p)q -(ortion)h(of)e(the)h(terminal)555 667 y(name)i(b)q(efore)g(the)g +(ortion)h(of)e(the)h(terminal)555 1142 y(name)i(b)q(efore)g(the)g (\014rst)f(`)p Fl(-)p Fm('.)24 b(This)17 b(allo)o(ws)g Fl(sun)f Fm(to)g(matc)o(h)h(b)q(oth)f Fl(sun)h Fm(and)555 -722 y Fl(sun-cmd)p Fm(,)d(for)g(instance.)315 802 y Fl(application)555 -857 y Fm(The)d Fc(application)i Fm(construct)e(is)g(used)h(to)e -(include)j(application-sp)q(eci)q(\014c)h(set-)555 912 -y(tings.)19 b(Eac)o(h)12 b(program)f(using)j(the)e(Readline)i(library)f -(sets)f(the)g Fc(application)555 966 y(name)p Fm(,)g(and)g(y)o(ou)f -(can)h(test)f(for)g(a)g(particular)h(v)m(alue.)20 b(This)12 -b(could)h(b)q(e)f(used)h(to)555 1021 y(bind)18 b(k)o(ey)e(sequences)i -(to)d(functions)j(useful)f(for)f(a)g(sp)q(eci\014c)i(program.)23 -b(F)l(or)555 1076 y(instance,)17 b(the)g(follo)o(wing)g(command)g(adds) -f(a)g(k)o(ey)h(sequence)g(that)f(quotes)555 1131 y(the)f(curren)o(t)g -(or)g(previous)h(w)o(ord)e(in)j(Bash:)675 1195 y Fl($if)23 -b(Bash)675 1247 y(#)h(Quote)f(the)g(current)g(or)h(previous)f(word)675 -1299 y("\\C-xq":)g("\\eb\\"\\ef\\"")675 1351 y($endif)75 -1430 y($endif)96 b Fm(This)16 b(command,)e(as)h(seen)h(in)g(the)f -(previous)h(example,)g(terminates)f(an)g Fl($if)f Fm(command.)75 -1510 y Fl($else)120 b Fm(Commands)15 b(in)h(this)f(branc)o(h)h(of)e -(the)i Fl($if)e Fm(directiv)o(e)j(are)e(executed)h(if)g(the)f(test)g -(fails.)75 1590 y Fl($include)48 b Fm(This)22 b(directiv)o(e)h(tak)o -(es)e(a)h(single)h(\014lename)g(as)e(an)h(argumen)o(t)f(and)h(reads)f -(commands)315 1645 y(and)e(bindings)j(from)c(that)h(\014le.)33 +1197 y Fl(sun-cmd)p Fm(,)d(for)g(instance.)315 1277 y +Fl(application)555 1332 y Fm(The)d Fc(application)i Fm(construct)e(is)g +(used)h(to)e(include)j(application-sp)q(eci)q(\014c)h(set-)555 +1386 y(tings.)19 b(Eac)o(h)12 b(program)f(using)j(the)e(Readline)i +(library)f(sets)f(the)g Fc(application)555 1441 y(name)p +Fm(,)g(and)g(y)o(ou)f(can)h(test)f(for)g(a)g(particular)h(v)m(alue.)20 +b(This)12 b(could)h(b)q(e)f(used)h(to)555 1496 y(bind)18 +b(k)o(ey)e(sequences)i(to)d(functions)j(useful)f(for)f(a)g(sp)q +(eci\014c)i(program.)23 b(F)l(or)555 1551 y(instance,)17 +b(the)g(follo)o(wing)g(command)g(adds)f(a)g(k)o(ey)h(sequence)g(that)f +(quotes)555 1606 y(the)f(curren)o(t)g(or)g(previous)h(w)o(ord)e(in)j +(Bash:)675 1670 y Fl($if)23 b(Bash)675 1722 y(#)h(Quote)f(the)g +(current)g(or)h(previous)f(word)675 1774 y("\\C-xq":)g +("\\eb\\"\\ef\\"")675 1826 y($endif)75 1905 y($endif)96 +b Fm(This)16 b(command,)e(as)h(seen)h(in)g(the)f(previous)h(example,)g +(terminates)f(an)g Fl($if)f Fm(command.)75 1985 y Fl($else)120 +b Fm(Commands)15 b(in)h(this)f(branc)o(h)h(of)e(the)i +Fl($if)e Fm(directiv)o(e)j(are)e(executed)h(if)g(the)f(test)g(fails.)75 +2065 y Fl($include)48 b Fm(This)22 b(directiv)o(e)h(tak)o(es)e(a)h +(single)h(\014lename)g(as)e(an)h(argumen)o(t)f(and)h(reads)f(commands) +315 2120 y(and)e(bindings)j(from)c(that)h(\014le.)33 b(F)l(or)19 b(example,)i(the)e(follo)o(wing)h(directiv)o(e)h(reads)e -(from)315 1699 y(`)p Fl(/etc/inputrc)p Fm(':)435 1764 -y Fl($include)k(/etc/inputrc)75 1876 y Fb(1.3.3)30 b(Sample)20 -b(Init)h(File)137 1972 y Fm(Here)16 b(is)g(an)f(example)h(of)f(an)g +(from)315 2174 y(`)p Fl(/etc/inputrc)p Fm(':)435 2239 +y Fl($include)k(/etc/inputrc)75 2351 y Fb(1.3.3)30 b(Sample)20 +b(Init)h(File)137 2447 y Fm(Here)16 b(is)g(an)f(example)h(of)f(an)g Fc(inputrc)k Fm(\014le.)i(This)16 b(illustrates)g(k)o(ey)f(binding,)i -(v)m(ariable)f(assignmen)o(t,)75 2027 y(and)f(conditional)i(syn)o(tax.) +(v)m(ariable)f(assignmen)o(t,)75 2502 y(and)f(conditional)i(syn)o(tax.) p eop %%Page: 10 12 10 11 bop 75 -58 a Fm(10)1299 b(GNU)15 b(Readline)h(Library)195 201 y Fl(#)24 b(This)f(file)g(controls)g(the)h(behaviour)e(of)i(line)f -(input)g(editing)g(for)195 253 y(#)h(programs)e(that)i(use)f(the)h(Gnu) -f(Readline)g(library.)47 b(Existing)22 b(programs)195 -305 y(#)i(include)f(FTP,)g(Bash,)g(and)h(Gdb.)195 357 -y(#)195 409 y(#)g(You)f(can)h(re-read)f(the)g(inputrc)g(file)g(with)h -(C-x)f(C-r.)195 461 y(#)h(Lines)f(beginning)g(with)g('#')g(are)h -(comments.)195 513 y(#)195 565 y(#)g(First,)f(include)g(any)g -(systemwide)g(bindings)f(and)i(variable)f(assignments)f(from)195 -616 y(#)i(/etc/Inputrc)195 668 y($include)f(/etc/Inputrc)195 -772 y(#)195 824 y(#)h(Set)f(various)g(bindings)g(for)g(emacs)g(mode.) -195 928 y(set)g(editing-mode)g(emacs)195 1032 y($if)g(mode=emacs)195 +(input)g(editing)g(for)195 253 y(#)h(programs)e(that)i(use)f(the)h(GNU) +f(Readline)g(library.)47 b(Existing)195 305 y(#)24 b(programs)e +(include)h(FTP,)h(Bash,)f(and)g(GDB.)195 357 y(#)195 +409 y(#)h(You)f(can)h(re-read)f(the)g(inputrc)g(file)g(with)h(C-x)f +(C-r.)195 461 y(#)h(Lines)f(beginning)g(with)g('#')g(are)h(comments.) +195 513 y(#)195 565 y(#)g(First,)f(include)g(any)g(systemwide)g +(bindings)f(and)i(variable)195 616 y(#)g(assignments)e(from)h +(/etc/Inputrc)195 668 y($include)g(/etc/Inputrc)195 772 +y(#)195 824 y(#)h(Set)f(various)g(bindings)g(for)g(emacs)g(mode.)195 +928 y(set)g(editing-mode)g(emacs)195 1032 y($if)g(mode=emacs)195 1135 y(Meta-Control-h:)46 b(backward-kill-word)21 b(Text)i(after)h(the) f(function)g(name)g(is)h(ignored)p 1986 1145 21 38 v 195 1239 a(#)195 1291 y(#)g(Arrow)f(keys)g(in)h(keypad)f(mode)195 @@ -1487,406 +1500,441 @@ b(11)195 201 y Fl(C-q:)23 b(quoted-insert)195 305 y($endif)195 (are)h(convenient)e(for)h(shell)h(interaction)195 616 y($if)f(Bash)195 668 y(#)h(edit)f(the)g(path)195 720 y("\\C-xp":)g("PATH=${PATH}\\e\\C-e\\C-a\\)o(ef\\C-f")195 -772 y(#)h(prepare)f(to)g(type)h(a)f(quoted)g(word)h(--)f(insert)g(open) -h(and)f(close)g(double)g(quotes)195 824 y(#)h(and)f(move)g(to)h(just)f -(after)h(the)f(open)g(quote)195 876 y("\\C-x\\"":)g("\\"\\"\\C-b")195 -928 y(#)h(insert)f(a)g(backslash)g(\(testing)g(backslash)g(escapes)f -(in)i(sequences)f(and)g(macros\))195 980 y("\\C-x\\\\":)g("\\\\")195 -1032 y(#)h(Quote)f(the)g(current)g(or)h(previous)f(word)195 -1083 y("\\C-xq":)g("\\eb\\"\\ef\\"")195 1135 y(#)h(Add)f(a)h(binding)f -(to)g(refresh)g(the)h(line,)f(which)g(is)h(unbound)195 -1187 y("\\C-xr":)f(redraw-current-line)195 1239 y(#)h(Edit)f(variable)g -(on)g(current)g(line.)195 1291 y("\\M-\\C-v":)f -("\\C-a\\C-k$\\C-y\\M-\\C-e\\C-a\\C-y=)o(")195 1343 y($endif)195 -1447 y(#)i(use)f(a)h(visible)f(bell)g(if)h(one)f(is)h(available)195 -1499 y(set)f(bell-style)g(visible)195 1602 y(#)h(don't)f(strip)g -(characters)g(to)g(7)h(bits)f(when)h(reading)195 1654 -y(set)f(input-meta)g(on)195 1758 y(#)h(allow)f(iso-latin1)f(characters) -h(to)g(be)h(inserted)f(rather)g(than)g(converted)g(to)195 -1810 y(#)h(prefix-meta)e(sequences)195 1862 y(set)h(convert-meta)g(off) -195 1966 y(#)h(display)f(characters)f(with)h(the)h(eighth)f(bit)g(set)h -(directly)f(rather)g(than)195 2017 y(#)h(as)f(meta-prefixed)f -(characters)195 2069 y(set)h(output-meta)g(on)195 2173 -y(#)h(if)f(there)g(are)h(more)f(than)h(150)f(possible)g(completions)f -(for)i(a)f(word,)h(ask)f(the)195 2225 y(#)h(user)f(if)h(he)f(wants)g -(to)h(see)f(all)h(of)f(them)195 2277 y(set)g(completion-query-items)e -(150)195 2381 y(#)j(For)f(FTP)195 2433 y($if)g(Ftp)195 -2484 y("\\C-xg":)g("get)g(\\M-?")195 2536 y("\\C-xt":)g("put)g(\\M-?") -195 2588 y("\\M-.":)g(yank-last-arg)195 2640 y($endif)p -eop +772 y(#)h(prepare)f(to)g(type)h(a)f(quoted)g(word)h(--)195 +824 y(#)g(insert)f(open)g(and)h(close)f(double)g(quotes)195 +876 y(#)h(and)f(move)g(to)h(just)f(after)h(the)f(open)g(quote)195 +928 y("\\C-x\\"":)g("\\"\\"\\C-b")195 980 y(#)h(insert)f(a)g(backslash) +g(\(testing)g(backslash)g(escapes)195 1032 y(#)h(in)f(sequences)g(and)g +(macros\))195 1083 y("\\C-x\\\\":)g("\\\\")195 1135 y(#)h(Quote)f(the)g +(current)g(or)h(previous)f(word)195 1187 y("\\C-xq":)g +("\\eb\\"\\ef\\"")195 1239 y(#)h(Add)f(a)h(binding)f(to)g(refresh)g +(the)h(line,)f(which)g(is)h(unbound)195 1291 y("\\C-xr":)f +(redraw-current-line)195 1343 y(#)h(Edit)f(variable)g(on)g(current)g +(line.)195 1395 y("\\M-\\C-v":)f("\\C-a\\C-k$\\C-y\\M-\\C-e\\C-a\\C-y=) +o(")195 1447 y($endif)195 1550 y(#)i(use)f(a)h(visible)f(bell)g(if)h +(one)f(is)h(available)195 1602 y(set)f(bell-style)g(visible)195 +1706 y(#)h(don't)f(strip)g(characters)g(to)g(7)h(bits)f(when)h(reading) +195 1758 y(set)f(input-meta)g(on)195 1862 y(#)h(allow)f(iso-latin1)f +(characters)h(to)g(be)h(inserted)f(rather)195 1914 y(#)h(than)f +(converted)g(to)g(prefix-meta)g(sequences)195 1966 y(set)g +(convert-meta)g(off)195 2069 y(#)h(display)f(characters)f(with)h(the)h +(eighth)f(bit)g(set)h(directly)195 2121 y(#)g(rather)f(than)g(as)h +(meta-prefixed)e(characters)195 2173 y(set)h(output-meta)g(on)195 +2277 y(#)h(if)f(there)g(are)h(more)f(than)h(150)f(possible)g +(completions)f(for)195 2329 y(#)i(a)f(word,)h(ask)f(the)h(user)f(if)g +(he)h(wants)f(to)h(see)f(all)h(of)f(them)195 2381 y(set)g +(completion-query-items)e(150)195 2484 y(#)j(For)f(FTP)195 +2536 y($if)g(Ftp)195 2588 y("\\C-xg":)g("get)g(\\M-?")195 +2640 y("\\C-xt":)g("put)g(\\M-?")p eop %%Page: 12 14 -12 13 bop 75 -58 a Fm(12)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fk(1.4)33 b(Bindable)24 b(Readline)f(Commands)137 -247 y Fm(This)17 b(section)f(describ)q(es)h(Readline)g(commands)f(that) +12 13 bop 75 -58 a Fm(12)1299 b(GNU)15 b(Readline)h(Library)195 +149 y Fl("\\M-.":)23 b(yank-last-arg)195 201 y($endif)75 +329 y Fk(1.4)33 b(Bindable)24 b(Readline)f(Commands)137 +425 y Fm(This)17 b(section)f(describ)q(es)h(Readline)g(commands)f(that) e(ma)o(y)h(b)q(e)i(b)q(ound)f(to)f(k)o(ey)h(sequences.)22 -b(Com-)75 301 y(mand)15 b(names)g(without)h(an)f(accompan)o(ying)g(k)o +b(Com-)75 480 y(mand)15 b(names)g(without)h(an)f(accompan)o(ying)g(k)o (ey)g(sequence)i(are)e(un)o(b)q(ound)h(b)o(y)f(default.)137 -369 y(In)f(the)f(follo)o(wing)h(descriptions,)h Fc(p)q(oin)o(t)f +547 y(In)f(the)f(follo)o(wing)h(descriptions,)h Fc(p)q(oin)o(t)f Fm(refers)f(to)g(the)g(curren)o(t)g(cursor)f(p)q(osition,)j(and)e -Fc(mark)i Fm(refers)75 424 y(to)k(a)g(cursor)g(p)q(osition)h(sa)o(v)o +Fc(mark)i Fm(refers)75 601 y(to)k(a)g(cursor)g(p)q(osition)h(sa)o(v)o (ed)f(b)o(y)h(the)f Fl(set-mark)g Fm(command.)32 b(The)20 b(text)f(b)q(et)o(w)o(een)g(the)h(p)q(oin)o(t)g(and)75 -479 y(mark)15 b(is)g(referred)h(to)e(as)h(the)g Fc(region)p -Fm(.)75 593 y Fb(1.4.1)30 b(Commands)21 b(F)-5 b(or)19 -b(Mo)n(ving)75 716 y Fl(beginning-of-line)13 b(\(C-a\))315 -771 y Fm(Mo)o(v)o(e)h(to)h(the)g(start)f(of)h(the)g(curren)o(t)g(line.) -75 864 y Fl(end-of-line)f(\(C-e\))315 919 y Fm(Mo)o(v)o(e)g(to)h(the)g -(end)h(of)f(the)g(line.)75 1012 y Fl(forward-char)f(\(C-f\))315 -1067 y Fm(Mo)o(v)o(e)g(forw)o(ard)g(a)h(c)o(haracter.)75 -1160 y Fl(backward-char)e(\(C-b\))315 1215 y Fm(Mo)o(v)o(e)h(bac)o(k)h -(a)g(c)o(haracter.)75 1309 y Fl(forward-word)f(\(M-f\))315 -1363 y Fm(Mo)o(v)o(e)g(forw)o(ard)g(to)g(the)i(end)g(of)e(the)h(next)h +656 y(mark)15 b(is)g(referred)h(to)e(as)h(the)g Fc(region)p +Fm(.)75 767 y Fb(1.4.1)30 b(Commands)21 b(F)-5 b(or)19 +b(Mo)n(ving)75 888 y Fl(beginning-of-line)13 b(\(C-a\))315 +942 y Fm(Mo)o(v)o(e)h(to)h(the)g(start)f(of)h(the)g(curren)o(t)g(line.) +75 1034 y Fl(end-of-line)f(\(C-e\))315 1088 y Fm(Mo)o(v)o(e)g(to)h(the) +g(end)h(of)f(the)g(line.)75 1179 y Fl(forward-char)f(\(C-f\))315 +1234 y Fm(Mo)o(v)o(e)g(forw)o(ard)g(a)h(c)o(haracter.)75 +1325 y Fl(backward-char)e(\(C-b\))315 1380 y Fm(Mo)o(v)o(e)h(bac)o(k)h +(a)g(c)o(haracter.)75 1471 y Fl(forward-word)f(\(M-f\))315 +1526 y Fm(Mo)o(v)o(e)g(forw)o(ard)g(to)g(the)i(end)g(of)e(the)h(next)h (w)o(ord.)j(W)l(ords)c(are)f(comp)q(osed)i(of)f(letters)g(and)315 -1418 y(digits.)75 1512 y Fl(backward-word)e(\(M-b\))315 -1566 y Fm(Mo)o(v)o(e)j(bac)o(k)g(to)h(the)f(start)g(of)g(the)h(curren)o +1581 y(digits.)75 1672 y Fl(backward-word)e(\(M-b\))315 +1727 y Fm(Mo)o(v)o(e)j(bac)o(k)g(to)h(the)f(start)g(of)g(the)h(curren)o (t)g(or)f(previous)i(w)o(ord.)24 b(W)l(ords)16 b(are)h(comp)q(osed)315 -1621 y(of)e(letters)g(and)g(digits.)75 1715 y Fl(clear-screen)f -(\(C-l\))315 1769 y Fm(Clear)f(the)h(screen)g(and)f(redra)o(w)g(the)g +1782 y(of)e(letters)g(and)g(digits.)75 1873 y Fl(clear-screen)f +(\(C-l\))315 1928 y Fm(Clear)f(the)h(screen)g(and)f(redra)o(w)g(the)g (curren)o(t)g(line,)i(lea)o(ving)g(the)e(curren)o(t)g(line)i(at)e(the)g -(top)315 1824 y(of)i(the)g(screen.)75 1918 y Fl(redraw-current-line)e -(\(\))315 1972 y Fm(Refresh)i(the)g(curren)o(t)g(line.)22 -b(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 2086 +(top)315 1982 y(of)i(the)g(screen.)75 2074 y Fl(redraw-current-line)e +(\(\))315 2128 y Fm(Refresh)i(the)g(curren)o(t)g(line.)22 +b(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 2239 y Fb(1.4.2)30 b(Commands)21 b(F)-5 b(or)19 b(Manipulating)i(The)f -(History)75 2209 y Fl(accept-line)14 b(\(Newline)g(or)h(Return\))315 -2264 y Fm(Accept)j(the)g(line)h(regardless)f(of)f(where)h(the)g(cursor) +(History)75 2360 y Fl(accept-line)14 b(\(Newline)g(or)h(Return\))315 +2414 y Fm(Accept)j(the)g(line)h(regardless)f(of)f(where)h(the)g(cursor) f(is.)27 b(If)18 b(this)g(line)h(is)g(non-empt)o(y)l(,)f(it)315 -2319 y(ma)o(y)d(b)q(e)i(added)f(to)g(the)g(history)g(list)g(for)g +2469 y(ma)o(y)d(b)q(e)i(added)f(to)g(the)g(history)g(list)g(for)g (future)g(recall)h(with)f Fl(add_history\(\))p Fm(.)k(If)d(this)315 -2374 y(line)g(is)f(a)e(mo)q(di\014ed)j(history)e(line,)i(the)e(history) +2524 y(line)g(is)f(a)e(mo)q(di\014ed)j(history)e(line,)i(the)e(history) g(line)i(is)f(restored)e(to)h(its)g(original)i(state.)75 -2467 y Fl(previous-history)c(\(C-p\))315 2522 y Fm(Mo)o(v)o(e)h(`bac)o +2615 y Fl(previous-history)c(\(C-p\))315 2670 y Fm(Mo)o(v)o(e)h(`bac)o (k')h(through)f(the)i(history)f(list,)g(fetc)o(hing)h(the)f(previous)h -(command.)75 2615 y Fl(next-history)e(\(C-n\))315 2670 -y Fm(Mo)o(v)o(e)g(`forw)o(ard')f(through)i(the)h(history)f(list,)g -(fetc)o(hing)h(the)f(next)h(command.)p eop +(command.)p eop %%Page: 13 15 13 14 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(13)75 149 y Fl(beginning-of-history)12 b(\(M-<\))315 -204 y Fm(Mo)o(v)o(e)i(to)h(the)g(\014rst)g(line)i(in)f(the)f(history)l -(.)75 307 y Fl(end-of-history)e(\(M->\))315 362 y Fm(Mo)o(v)o(e)h(to)h -(the)g(end)h(of)f(the)g(input)h(history)l(,)f(i.e.,)g(the)g(line)i -(curren)o(tly)f(b)q(eing)g(en)o(tered.)75 466 y Fl -(reverse-search-history)c(\(C-r\))315 520 y Fm(Searc)o(h)k(bac)o(kw)o -(ard)e(starting)h(at)g(the)h(curren)o(t)f(line)j(and)d(mo)o(ving)h -(`up')f(through)g(the)h(his-)315 575 y(tory)e(as)h(necessary)l(.)20 -b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 678 -y Fl(forward-search-history)c(\(C-s\))315 733 y Fm(Searc)o(h)j(forw)o +b(13)75 149 y Fl(next-history)14 b(\(C-n\))315 204 y +Fm(Mo)o(v)o(e)g(`forw)o(ard')f(through)i(the)h(history)f(list,)g(fetc)o +(hing)h(the)f(next)h(command.)75 307 y Fl(beginning-of-history)c +(\(M-<\))315 362 y Fm(Mo)o(v)o(e)i(to)h(the)g(\014rst)g(line)i(in)f +(the)f(history)l(.)75 465 y Fl(end-of-history)e(\(M->\))315 +520 y Fm(Mo)o(v)o(e)h(to)h(the)g(end)h(of)f(the)g(input)h(history)l(,)f +(i.e.,)g(the)g(line)i(curren)o(tly)f(b)q(eing)g(en)o(tered.)75 +624 y Fl(reverse-search-history)c(\(C-r\))315 678 y Fm(Searc)o(h)k(bac) +o(kw)o(ard)e(starting)h(at)g(the)h(curren)o(t)f(line)j(and)d(mo)o(ving) +h(`up')f(through)g(the)h(his-)315 733 y(tory)e(as)h(necessary)l(.)20 +b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 836 +y Fl(forward-search-history)c(\(C-s\))315 891 y Fm(Searc)o(h)j(forw)o (ard)e(starting)h(at)h(the)f(curren)o(t)h(line)h(and)f(mo)o(ving)g(`do) -o(wn')f(through)g(the)h(the)315 788 y(history)g(as)g(necessary)l(.)20 -b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 891 +o(wn')f(through)g(the)h(the)315 946 y(history)g(as)g(necessary)l(.)20 +b(This)c(is)g(an)f(incremen)o(tal)h(searc)o(h.)75 1049 y Fl(non-incremental-reverse-se)o(arch-hi)o(story)c(\(M-p\))315 -946 y Fm(Searc)o(h)k(bac)o(kw)o(ard)e(starting)h(at)g(the)h(curren)o(t) -f(line)j(and)d(mo)o(ving)h(`up')f(through)g(the)h(his-)315 -1001 y(tory)h(as)h(necessary)g(using)h(a)e(non-incremen)o(tal)j(searc)o -(h)e(for)f(a)h(string)g(supplied)i(b)o(y)e(the)315 1056 -y(user.)75 1159 y Fl(non-incremental-forward-se)o(arch-hi)o(story)12 -b(\(M-n\))315 1214 y Fm(Searc)o(h)j(forw)o(ard)e(starting)h(at)h(the)f +1104 y Fm(Searc)o(h)k(bac)o(kw)o(ard)e(starting)h(at)g(the)h(curren)o +(t)f(line)j(and)d(mo)o(ving)h(`up')f(through)g(the)h(his-)315 +1159 y(tory)h(as)h(necessary)g(using)h(a)e(non-incremen)o(tal)j(searc)o +(h)e(for)f(a)h(string)g(supplied)i(b)o(y)e(the)315 1214 +y(user.)75 1317 y Fl(non-incremental-forward-se)o(arch-hi)o(story)12 +b(\(M-n\))315 1372 y Fm(Searc)o(h)j(forw)o(ard)e(starting)h(at)h(the)f (curren)o(t)h(line)h(and)f(mo)o(ving)g(`do)o(wn')f(through)g(the)h(the) -315 1268 y(history)e(as)g(necessary)h(using)g(a)f(non-incremen)o(tal)i +315 1426 y(history)e(as)g(necessary)h(using)g(a)f(non-incremen)o(tal)i (searc)o(h)e(for)g(a)g(string)g(supplied)j(b)o(y)d(the)315 -1323 y(user.)75 1427 y Fl(history-search-forward)f(\(\))315 -1481 y Fm(Searc)o(h)21 b(forw)o(ard)e(through)i(the)f(history)h(for)f +1481 y(user.)75 1584 y Fl(history-search-forward)f(\(\))315 +1639 y Fm(Searc)o(h)21 b(forw)o(ard)e(through)i(the)f(history)h(for)f (the)h(string)g(of)f(c)o(haracters)g(b)q(et)o(w)o(een)h(the)315 -1536 y(start)16 b(of)h(the)h(curren)o(t)g(line)h(and)e(the)h(p)q(oin)o +1694 y(start)16 b(of)h(the)h(curren)o(t)g(line)h(and)e(the)h(p)q(oin)o (t.)28 b(This)18 b(is)g(a)f(non-incremen)o(tal)i(searc)o(h.)27 -b(By)315 1591 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 -1694 y Fl(history-search-backward)c(\(\))315 1749 y Fm(Searc)o(h)18 +b(By)315 1749 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 +1852 y Fl(history-search-backward)c(\(\))315 1907 y Fm(Searc)o(h)18 b(bac)o(kw)o(ard)e(through)h(the)h(history)f(for)g(the)g(string)h(of)f -(c)o(haracters)f(b)q(et)o(w)o(een)i(the)315 1804 y(start)e(of)h(the)h +(c)o(haracters)f(b)q(et)o(w)o(een)i(the)315 1962 y(start)e(of)h(the)h (curren)o(t)g(line)h(and)e(the)h(p)q(oin)o(t.)28 b(This)18 b(is)g(a)f(non-incremen)o(tal)i(searc)o(h.)27 b(By)315 -1859 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 -1962 y Fl(yank-nth-arg)e(\(M-C-y\))315 2017 y Fm(Insert)f(the)g +2016 y(default,)15 b(this)h(command)f(is)h(un)o(b)q(ound.)75 +2120 y Fl(yank-nth-arg)e(\(M-C-y\))315 2174 y Fm(Insert)f(the)g (\014rst)g(argumen)o(t)f(to)g(the)i(previous)f(command)g(\(usually)h -(the)f(second)h(w)o(ord)e(on)315 2071 y(the)j(previous)h(line\))g(at)e +(the)f(second)h(w)o(ord)e(on)315 2229 y(the)j(previous)h(line\))g(at)e (p)q(oin)o(t.)21 b(With)15 b(an)g(argumen)o(t)f Fc(n)p Fm(,)h(insert)g(the)g Fc(n)p Fm(th)g(w)o(ord)g(from)f(the)315 -2126 y(previous)g(command)g(\(the)f(w)o(ords)f(in)j(the)e(previous)i +2284 y(previous)g(command)g(\(the)f(w)o(ords)f(in)j(the)e(previous)i (command)e(b)q(egin)i(with)e(w)o(ord)g(0\).)19 b(A)315 -2181 y(negativ)o(e)13 b(argumen)o(t)f(inserts)h(the)g +2339 y(negativ)o(e)13 b(argumen)o(t)f(inserts)h(the)g Fc(n)p Fm(th)g(w)o(ord)f(from)g(the)h(end)h(of)e(the)h(previous)g -(command.)75 2284 y Fl(yank-last-arg)g(\(M-.)i(or)g(M-_\))315 -2339 y Fm(Insert)j(last)f(argumen)o(t)g(to)g(the)g(previous)i(command)e -(\(the)g(last)h(w)o(ord)f(of)g(the)g(previous)315 2394 +(command.)75 2442 y Fl(yank-last-arg)g(\(M-.)i(or)g(M-_\))315 +2497 y Fm(Insert)j(last)f(argumen)o(t)g(to)g(the)g(previous)i(command)e +(\(the)g(last)h(w)o(ord)f(of)g(the)g(previous)315 2552 y(history)e(en)o(try\).)20 b(With)15 b(an)g(argumen)o(t,)g(b)q(eha)o(v) o(e)g(exactly)h(lik)o(e)g Fl(yank-nth-arg)p Fm(.)j(Succes-)315 -2449 y(siv)o(e)f(calls)g(to)f Fl(yank-last-arg)e Fm(mo)o(v)o(e)i(bac)o +2606 y(siv)o(e)f(calls)g(to)f Fl(yank-last-arg)e Fm(mo)o(v)o(e)i(bac)o (k)g(through)g(the)g(history)g(list,)i(inserting)f(the)315 -2503 y(last)d(argumen)o(t)g(of)f(eac)o(h)i(line)g(in)g(turn.)75 -2630 y Fb(1.4.3)30 b(Commands)21 b(F)-5 b(or)19 b(Changing)i(T)-5 -b(ext)p eop +2661 y(last)d(argumen)o(t)g(of)f(eac)o(h)i(line)g(in)g(turn.)p +eop %%Page: 14 16 14 15 bop 75 -58 a Fm(14)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fl(delete-char)e(\(C-d\))315 204 y Fm(Delete)20 -b(the)g(c)o(haracter)e(at)h(p)q(oin)o(t.)33 b(If)20 b(p)q(oin)o(t)g(is) -g(at)e(the)i(b)q(eginning)i(of)d(the)g(line,)j(there)315 -259 y(are)c(no)h(c)o(haracters)e(in)j(the)e(line,)j(and)e(the)f(last)h -(c)o(haracter)e(t)o(yp)q(ed)i(w)o(as)f(not)g(b)q(ound)i(to)315 -314 y Fl(delete-char)p Fm(,)13 b(then)j(return)f Fh(eof)p -Fm(.)75 401 y Fl(backward-delete-char)d(\(Rubout\))315 -456 y Fm(Delete)k(the)f(c)o(haracter)f(b)q(ehind)j(the)f(cursor.)j(A)c +149 y Fb(1.4.3)30 b(Commands)21 b(F)-5 b(or)19 b(Changing)i(T)-5 +b(ext)75 286 y Fl(delete-char)14 b(\(C-d\))315 341 y +Fm(Delete)20 b(the)g(c)o(haracter)e(at)h(p)q(oin)o(t.)33 +b(If)20 b(p)q(oin)o(t)g(is)g(at)e(the)i(b)q(eginning)i(of)d(the)g +(line,)j(there)315 396 y(are)c(no)h(c)o(haracters)e(in)j(the)e(line,)j +(and)e(the)f(last)h(c)o(haracter)e(t)o(yp)q(ed)i(w)o(as)f(not)g(b)q +(ound)i(to)315 450 y Fl(delete-char)p Fm(,)13 b(then)j(return)f +Fh(eof)p Fm(.)75 552 y Fl(backward-delete-char)d(\(Rubout\))315 +607 y Fm(Delete)k(the)f(c)o(haracter)f(b)q(ehind)j(the)f(cursor.)j(A)c (n)o(umeric)h(argumen)o(t)e(means)i(to)e(kill)j(the)315 -511 y(c)o(haracters)d(instead)i(of)f(deleting)i(them.)75 -598 y Fl(forward-backward-delete-ch)o(ar)12 b(\(\))315 -653 y Fm(Delete)20 b(the)f(c)o(haracter)f(under)i(the)f(cursor,)h +661 y(c)o(haracters)d(instead)i(of)f(deleting)i(them.)75 +763 y Fl(forward-backward-delete-ch)o(ar)12 b(\(\))315 +818 y Fm(Delete)20 b(the)f(c)o(haracter)f(under)i(the)f(cursor,)h (unless)g(the)f(cursor)g(is)h(at)e(the)h(end)h(of)f(the)315 -707 y(line,)e(in)g(whic)o(h)g(case)e(the)h(c)o(haracter)g(b)q(ehind)h +872 y(line,)e(in)g(whic)o(h)g(case)e(the)h(c)o(haracter)g(b)q(ehind)h (the)f(cursor)g(is)g(deleted.)23 b(By)16 b(default,)h(this)315 -762 y(is)f(not)f(b)q(ound)h(to)e(a)h(k)o(ey)l(.)75 850 -y Fl(quoted-insert)e(\(C-q)i(or)g(C-v\))315 904 y Fm(Add)j(the)f(next)g -(c)o(haracter)g(t)o(yp)q(ed)g(to)f(the)i(line)g(v)o(erbatim.)26 -b(This)18 b(is)f(ho)o(w)g(to)g(insert)g(k)o(ey)315 959 +927 y(is)f(not)f(b)q(ound)h(to)e(a)h(k)o(ey)l(.)75 1029 +y Fl(quoted-insert)e(\(C-q)i(or)g(C-v\))315 1083 y Fm(Add)j(the)f(next) +g(c)o(haracter)g(t)o(yp)q(ed)g(to)f(the)i(line)g(v)o(erbatim.)26 +b(This)18 b(is)f(ho)o(w)g(to)g(insert)g(k)o(ey)315 1138 y(sequences)f(lik)o(e)h Fg(C-q)p Fm(,)d(for)h(example.)75 -1046 y Fl(tab-insert)f(\(M-)401 1044 y Ff(h)p 412 1018 -74 2 v 412 1046 a Fe(T)m(AB)p 412 1054 V 484 1044 a Ff(i)499 -1046 y Fl(\))315 1101 y Fm(Insert)h(a)g(tab)g(c)o(haracter.)75 -1188 y Fl(self-insert)f(\(a,)g(b,)h(A,)g(1,)g(!,)g(...)o(\))315 -1243 y Fm(Insert)g(y)o(ourself.)75 1330 y Fl(transpose-chars)e(\(C-t\)) -315 1385 y Fm(Drag)i(the)h(c)o(haracter)f(b)q(efore)h(the)h(cursor)e +1240 y Fl(tab-insert)f(\(M-)401 1238 y Ff(h)p 412 1212 +74 2 v 412 1240 a Fe(T)m(AB)p 412 1247 V 484 1238 a Ff(i)499 +1240 y Fl(\))315 1294 y Fm(Insert)h(a)g(tab)g(c)o(haracter.)75 +1396 y Fl(self-insert)f(\(a,)g(b,)h(A,)g(1,)g(!,)g(...)o(\))315 +1451 y Fm(Insert)g(y)o(ourself.)75 1552 y Fl(transpose-chars)e(\(C-t\)) +315 1607 y Fm(Drag)i(the)h(c)o(haracter)f(b)q(efore)h(the)h(cursor)e (forw)o(ard)g(o)o(v)o(er)g(the)h(c)o(haracter)f(at)h(the)g(cursor,)315 -1440 y(mo)o(ving)i(the)f(cursor)h(forw)o(ard)e(as)i(w)o(ell.)28 +1662 y(mo)o(ving)i(the)f(cursor)h(forw)o(ard)e(as)i(w)o(ell.)28 b(If)18 b(the)g(insertion)h(p)q(oin)o(t)f(is)g(at)f(the)h(end)h(of)e -(the)315 1495 y(line,)c(then)e(this)h(transp)q(oses)e(the)h(last)g(t)o +(the)315 1716 y(line,)c(then)e(this)h(transp)q(oses)e(the)h(last)g(t)o (w)o(o)f(c)o(haracters)g(of)h(the)g(line.)20 b(Negativ)o(e)11 -b(argumen)o(ts)315 1550 y(ha)o(v)o(e)k(no)g(e\013ect.)75 -1637 y Fl(transpose-words)e(\(M-t\))315 1692 y Fm(Drag)i(the)h(w)o(ord) +b(argumen)o(ts)315 1771 y(ha)o(v)o(e)k(no)g(e\013ect.)75 +1873 y Fl(transpose-words)e(\(M-t\))315 1927 y Fm(Drag)i(the)h(w)o(ord) g(b)q(efore)g(p)q(oin)o(t)h(past)f(the)g(w)o(ord)f(after)h(p)q(oin)o -(t,)g(mo)o(ving)g(p)q(oin)o(t)h(past)f(that)315 1746 +(t,)g(mo)o(ving)g(p)q(oin)o(t)h(past)f(that)315 1982 y(w)o(ord)d(as)h(w)o(ell.)21 b(If)14 b(the)g(insertion)i(p)q(oin)o(t)e (is)h(at)f(the)g(end)h(of)e(the)i(line,)g(this)g(transp)q(oses)f(the) -315 1801 y(last)h(t)o(w)o(o)f(w)o(ords)g(on)i(the)f(line.)75 -1888 y Fl(upcase-word)f(\(M-u\))315 1943 y Fm(Upp)q(ercase)j(the)f +315 2037 y(last)h(t)o(w)o(o)f(w)o(ords)g(on)i(the)f(line.)75 +2138 y Fl(upcase-word)f(\(M-u\))315 2193 y Fm(Upp)q(ercase)j(the)f (curren)o(t)g(\(or)f(follo)o(wing\))h(w)o(ord.)22 b(With)16 -b(a)g(negativ)o(e)g(argumen)o(t,)f(upp)q(er-)315 1998 +b(a)g(negativ)o(e)g(argumen)o(t,)f(upp)q(er-)315 2248 y(case)g(the)g(previous)h(w)o(ord,)f(but)g(do)g(not)g(mo)o(v)o(e)f(the) -i(cursor.)75 2085 y Fl(downcase-word)d(\(M-l\))315 2140 +i(cursor.)75 2349 y Fl(downcase-word)d(\(M-l\))315 2404 y Fm(Lo)o(w)o(ercase)d(the)h(curren)o(t)g(\(or)f(follo)o(wing\))h(w)o (ord.)17 b(With)11 b(a)g(negativ)o(e)g(argumen)o(t,)f(lo)o(w)o(ercase) -315 2195 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f -(the)h(cursor.)75 2282 y Fl(capitalize-word)e(\(M-c\))315 -2337 y Fm(Capitalize)f(the)f(curren)o(t)f(\(or)g(follo)o(wing\))h(w)o +315 2459 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f +(the)h(cursor.)75 2560 y Fl(capitalize-word)e(\(M-c\))315 +2615 y Fm(Capitalize)f(the)f(curren)o(t)f(\(or)g(follo)o(wing\))h(w)o (ord.)18 b(With)11 b(a)f(negativ)o(e)h(argumen)o(t,)f(capitalize)315 -2392 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f -(the)h(cursor.)75 2499 y Fb(1.4.4)30 b(Killing)20 b(And)h(Y)-5 -b(anking)75 2615 y Fl(kill-line)14 b(\(C-k\))315 2670 -y Fm(Kill)j(the)f(text)e(from)h(p)q(oin)o(t)h(to)e(the)h(end)h(of)f -(the)g(line.)p eop +2670 y(the)15 b(previous)h(w)o(ord,)e(but)i(do)f(not)g(mo)o(v)o(e)f +(the)h(cursor.)p eop %%Page: 15 17 15 16 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(15)75 149 y Fl(backward-kill-line)13 b(\(C-x)h(Rubout\))315 -204 y Fm(Kill)j(bac)o(kw)o(ard)e(to)f(the)i(b)q(eginning)h(of)e(the)g -(line.)75 295 y Fl(unix-line-discard)e(\(C-u\))315 349 +b(15)75 149 y Fl(overwrite-mode)13 b(\(\))315 204 y Fm(T)l(oggle)j(o)o +(v)o(erwrite)g(mo)q(de.)24 b(With)17 b(an)f(explicit)j(p)q(ositiv)o(e)f +(n)o(umeric)f(argumen)o(t,)f(switc)o(hes)315 259 y(to)10 +b(o)o(v)o(erwrite)g(mo)q(de.)19 b(With)11 b(an)g(explicit)i(non-p)q +(ositiv)o(e)f(n)o(umeric)g(argumen)o(t,)e(switc)o(hes)i(to)315 +314 y(insert)k(mo)q(de.)k(This)c(command)f(a\013ects)g(only)h +Fl(emacs)e Fm(mo)q(de;)h Fl(vi)g Fm(mo)q(de)h(do)q(es)g(o)o(v)o +(erwrite)315 369 y(di\013eren)o(tly)l(.)21 b(Eac)o(h)15 +b(call)h(to)f Fl(readline\(\))f Fm(starts)f(in)k(insert)e(mo)q(de.)315 +436 y(In)g(o)o(v)o(erwrite)f(mo)q(de,)h(c)o(haracters)f(b)q(ound)h(to)f +Fl(self-insert)f Fm(replace)j(the)e(text)h(at)e(p)q(oin)o(t)315 +491 y(rather)20 b(than)h(pushing)h(the)f(text)f(to)g(the)h(righ)o(t.)36 +b(Characters)20 b(b)q(ound)i(to)e Fl(backward-)315 546 +y(delete-char)14 b Fm(replace)i(the)f(c)o(haracter)g(b)q(efore)g(p)q +(oin)o(t)h(with)f(a)g(space.)315 614 y(By)g(default,)h(this)f(command)g +(is)h(un)o(b)q(ound.)75 729 y Fb(1.4.4)30 b(Killing)20 +b(And)h(Y)-5 b(anking)75 853 y Fl(kill-line)14 b(\(C-k\))315 +908 y Fm(Kill)j(the)f(text)e(from)h(p)q(oin)o(t)h(to)e(the)h(end)h(of)f +(the)g(line.)75 1002 y Fl(backward-kill-line)e(\(C-x)h(Rubout\))315 +1057 y Fm(Kill)j(bac)o(kw)o(ard)e(to)f(the)i(b)q(eginning)h(of)e(the)g +(line.)75 1151 y Fl(unix-line-discard)e(\(C-u\))315 1205 y Fm(Kill)k(bac)o(kw)o(ard)e(from)f(the)i(cursor)e(to)h(the)g(b)q -(eginning)j(of)c(the)i(curren)o(t)f(line.)75 440 y Fl(kill-whole-line)e -(\(\))315 495 y Fm(Kill)20 b(all)g(c)o(haracters)d(on)h(the)h(curren)o -(t)f(line,)i(no)e(matter)g(where)g(p)q(oin)o(t)h(is.)29 -b(By)19 b(default,)315 549 y(this)d(is)f(un)o(b)q(ound.)75 -640 y Fl(kill-word)f(\(M-d\))315 695 y Fm(Kill)j(from)d(p)q(oin)o(t)h +(eginning)j(of)c(the)i(curren)o(t)f(line.)75 1299 y Fl(kill-whole-line) +e(\(\))315 1354 y Fm(Kill)20 b(all)g(c)o(haracters)d(on)h(the)h(curren) +o(t)f(line,)i(no)e(matter)g(where)g(p)q(oin)o(t)h(is.)29 +b(By)19 b(default,)315 1409 y(this)d(is)f(un)o(b)q(ound.)75 +1503 y Fl(kill-word)f(\(M-d\))315 1558 y Fm(Kill)j(from)d(p)q(oin)o(t)h (to)f(the)h(end)g(of)f(the)h(curren)o(t)g(w)o(ord,)e(or)i(if)g(b)q(et)o -(w)o(een)g(w)o(ords,)e(to)i(the)f(end)315 750 y(of)h(the)g(next)g(w)o +(w)o(een)g(w)o(ords,)e(to)i(the)f(end)315 1613 y(of)h(the)g(next)g(w)o (ord.)20 b(W)l(ord)14 b(b)q(oundaries)j(are)e(the)g(same)g(as)g -Fl(forward-word)p Fm(.)75 840 y Fl(backward-kill-word)e(\(M-)592 -838 y Ff(h)p 603 812 73 2 v 603 840 a Fe(DEL)p 603 848 -V 674 838 a Ff(i)689 840 y Fl(\))315 895 y Fm(Kill)k(the)d(w)o(ord)g(b) -q(ehind)i(p)q(oin)o(t.)21 b(W)l(ord)14 b(b)q(oundaries)h(are)f(the)h -(same)f(as)g Fl(backward-word)p Fm(.)75 985 y Fl(unix-word-rubout)f -(\(C-w\))315 1040 y Fm(Kill)18 b(the)e(w)o(ord)f(b)q(ehind)j(p)q(oin)o -(t,)e(using)h(white)f(space)g(as)g(a)f(w)o(ord)g(b)q(oundary)l(.)23 -b(The)16 b(killed)315 1095 y(text)f(is)g(sa)o(v)o(ed)g(on)g(the)h -(kill-ring.)75 1185 y Fl(delete-horizontal-space)c(\(\))315 -1240 y Fm(Delete)k(all)g(spaces)f(and)h(tabs)e(around)i(p)q(oin)o(t.)k -(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 1330 -y Fl(kill-region)e(\(\))315 1385 y Fm(Kill)j(the)f(text)e(in)i(the)g -(curren)o(t)f(region.)20 b(By)15 b(default,)h(this)f(command)g(is)h(un) -o(b)q(ound.)75 1476 y Fl(copy-region-as-kill)d(\(\))315 -1530 y Fm(Cop)o(y)j(the)i(text)e(in)i(the)f(region)g(to)g(the)g(kill)h +Fl(forward-word)p Fm(.)75 1707 y Fl(backward-kill-word)e(\(M-)592 +1705 y Ff(h)p 603 1679 73 2 v 603 1707 a Fe(DEL)p 603 +1714 V 674 1705 a Ff(i)689 1707 y Fl(\))315 1761 y Fm(Kill)k(the)d(w)o +(ord)g(b)q(ehind)i(p)q(oin)o(t.)21 b(W)l(ord)14 b(b)q(oundaries)h(are)f +(the)h(same)f(as)g Fl(backward-word)p Fm(.)75 1855 y +Fl(unix-word-rubout)f(\(C-w\))315 1910 y Fm(Kill)18 b(the)e(w)o(ord)f +(b)q(ehind)j(p)q(oin)o(t,)e(using)h(white)f(space)g(as)g(a)f(w)o(ord)g +(b)q(oundary)l(.)23 b(The)16 b(killed)315 1965 y(text)f(is)g(sa)o(v)o +(ed)g(on)g(the)h(kill-ring.)75 2059 y Fl(delete-horizontal-space)c +(\(\))315 2114 y Fm(Delete)k(all)g(spaces)f(and)h(tabs)e(around)i(p)q +(oin)o(t.)k(By)15 b(default,)h(this)f(is)h(un)o(b)q(ound.)75 +2208 y Fl(kill-region)e(\(\))315 2263 y Fm(Kill)j(the)f(text)e(in)i +(the)g(curren)o(t)f(region.)20 b(By)15 b(default,)h(this)f(command)g +(is)h(un)o(b)q(ound.)75 2357 y Fl(copy-region-as-kill)d(\(\))315 +2412 y Fm(Cop)o(y)j(the)i(text)e(in)i(the)f(region)g(to)g(the)g(kill)h (bu\013er,)f(so)g(it)g(can)g(b)q(e)h(y)o(ank)o(ed)f(righ)o(t)g(a)o(w)o -(a)o(y)l(.)315 1585 y(By)e(default,)h(this)f(command)g(is)h(un)o(b)q -(ound.)75 1676 y Fl(copy-backward-word)d(\(\))315 1730 +(a)o(y)l(.)315 2466 y(By)e(default,)h(this)f(command)g(is)h(un)o(b)q +(ound.)75 2560 y Fl(copy-backward-word)d(\(\))315 2615 y Fm(Cop)o(y)19 b(the)g(w)o(ord)g(b)q(efore)g(p)q(oin)o(t)h(to)e(the)i (kill)h(bu\013er.)32 b(The)19 b(w)o(ord)g(b)q(oundaries)h(are)f(the)315 -1785 y(same)c(as)g Fl(backward-word)p Fm(.)j(By)d(default,)g(this)h -(command)f(is)h(un)o(b)q(ound.)75 1876 y Fl(copy-forward-word)d(\(\)) -315 1930 y Fm(Cop)o(y)i(the)h(w)o(ord)e(follo)o(wing)j(p)q(oin)o(t)f -(to)f(the)g(kill)j(bu\013er.)i(The)c(w)o(ord)f(b)q(oundaries)i(are)e -(the)315 1985 y(same)g(as)g Fl(forward-word)p Fm(.)j(By)d(default,)h -(this)f(command)g(is)h(un)o(b)q(ound.)75 2076 y Fl(yank)f(\(C-y\))315 -2131 y Fm(Y)l(ank)g(the)h(top)f(of)f(the)i(kill)h(ring)e(in)o(to)g(the) -h(bu\013er)f(at)f(p)q(oin)o(t.)75 2221 y Fl(yank-pop)g(\(M-y\))315 -2276 y Fm(Rotate)i(the)h(kill-ring,)j(and)d(y)o(ank)g(the)h(new)f(top.) -26 b(Y)l(ou)17 b(can)h(only)g(do)f(this)h(if)f(the)h(prior)315 -2331 y(command)d(is)h Fl(yank)e Fm(or)h Fl(yank-pop)p -Fm(.)75 2441 y Fb(1.4.5)30 b(Sp)r(ecifying)20 b(Numeric)h(Argumen)n(ts) -75 2560 y Fl(digit-argument)13 b(\()p Fg(M-0)p Fl(,)i -Fg(M-1)p Fl(,)f(...)h Fg(M--)p Fl(\))315 2615 y Fm(Add)f(this)g(digit)g -(to)f(the)h(argumen)o(t)e(already)i(accum)o(ulating,)g(or)f(start)f(a)h -(new)h(argumen)o(t.)315 2670 y Fg(M--)h Fm(starts)f(a)h(negativ)o(e)g -(argumen)o(t.)p eop +2670 y(same)c(as)g Fl(backward-word)p Fm(.)j(By)d(default,)g(this)h +(command)f(is)h(un)o(b)q(ound.)p eop %%Page: 16 18 16 17 bop 75 -58 a Fm(16)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fl(universal-argument)d(\(\))315 204 y Fm(This)g(is)h(another)e +149 y Fl(copy-forward-word)d(\(\))315 204 y Fm(Cop)o(y)i(the)h(w)o(ord) +e(follo)o(wing)j(p)q(oin)o(t)f(to)f(the)g(kill)j(bu\013er.)i(The)c(w)o +(ord)f(b)q(oundaries)i(are)e(the)315 259 y(same)g(as)g +Fl(forward-word)p Fm(.)j(By)d(default,)h(this)f(command)g(is)h(un)o(b)q +(ound.)75 342 y Fl(yank)f(\(C-y\))315 397 y Fm(Y)l(ank)g(the)h(top)f +(of)f(the)i(kill)h(ring)e(in)o(to)g(the)h(bu\013er)f(at)f(p)q(oin)o(t.) +75 481 y Fl(yank-pop)g(\(M-y\))315 535 y Fm(Rotate)i(the)h(kill-ring,)j +(and)d(y)o(ank)g(the)h(new)f(top.)26 b(Y)l(ou)17 b(can)h(only)g(do)f +(this)h(if)f(the)h(prior)315 590 y(command)d(is)h Fl(yank)e +Fm(or)h Fl(yank-pop)p Fm(.)75 693 y Fb(1.4.5)30 b(Sp)r(ecifying)20 +b(Numeric)h(Argumen)n(ts)75 806 y Fl(digit-argument)13 +b(\()p Fg(M-0)p Fl(,)i Fg(M-1)p Fl(,)f(...)h Fg(M--)p +Fl(\))315 861 y Fm(Add)f(this)g(digit)g(to)f(the)h(argumen)o(t)e +(already)i(accum)o(ulating,)g(or)f(start)f(a)h(new)h(argumen)o(t.)315 +915 y Fg(M--)h Fm(starts)f(a)h(negativ)o(e)g(argumen)o(t.)75 +999 y Fl(universal-argument)e(\(\))315 1054 y Fm(This)g(is)h(another)e (w)o(a)o(y)g(to)g(sp)q(ecify)i(an)f(argumen)o(t.)18 b(If)13 b(this)g(command)g(is)g(follo)o(w)o(ed)g(b)o(y)g(one)315 -259 y(or)h(more)h(digits,)g(optionally)h(with)f(a)g(leading)h(min)o(us) -f(sign,)g(those)g(digits)g(de\014ne)h(the)f(ar-)315 314 -y(gumen)o(t.)k(If)c(the)g(command)f(is)h(follo)o(w)o(ed)g(b)o(y)g -(digits,)g(executing)g Fl(universal-argument)315 369 +1108 y(or)h(more)h(digits,)g(optionally)h(with)f(a)g(leading)h(min)o +(us)f(sign,)g(those)g(digits)g(de\014ne)h(the)f(ar-)315 +1163 y(gumen)o(t.)k(If)c(the)g(command)f(is)h(follo)o(w)o(ed)g(b)o(y)g +(digits,)g(executing)g Fl(universal-argument)315 1218 y Fm(again)h(ends)g(the)g(n)o(umeric)h(argumen)o(t,)e(but)h(is)h (otherwise)f(ignored.)22 b(As)16 b(a)g(sp)q(ecial)h(case,)315 -423 y(if)g(this)g(command)f(is)h(immediately)h(follo)o(w)o(ed)f(b)o(y)f -(a)g(c)o(haracter)g(that)g(is)h(neither)g(a)f(digit)315 -478 y(or)d(min)o(us)i(sign,)f(the)g(argumen)o(t)g(coun)o(t)f(for)h(the) -g(next)g(command)g(is)g(m)o(ultiplied)j(b)o(y)d(four.)315 -533 y(The)19 b(argumen)o(t)f(coun)o(t)g(is)h(initially)j(one,)d(so)f +1273 y(if)g(this)g(command)f(is)h(immediately)h(follo)o(w)o(ed)f(b)o(y) +f(a)g(c)o(haracter)g(that)g(is)h(neither)g(a)f(digit)315 +1328 y(or)d(min)o(us)i(sign,)f(the)g(argumen)o(t)g(coun)o(t)f(for)h +(the)g(next)g(command)g(is)g(m)o(ultiplied)j(b)o(y)d(four.)315 +1382 y(The)19 b(argumen)o(t)f(coun)o(t)g(is)h(initially)j(one,)d(so)f (executing)i(this)f(function)h(the)e(\014rst)h(time)315 -588 y(mak)o(es)c(the)h(argumen)o(t)f(coun)o(t)h(four,)f(a)h(second)g +1437 y(mak)o(es)c(the)h(argumen)o(t)f(coun)o(t)h(four,)f(a)h(second)g (time)g(mak)o(es)g(the)g(argumen)o(t)f(coun)o(t)g(six-)315 -643 y(teen,)g(and)g(so)g(on.)20 b(By)15 b(default,)h(this)f(is)h(not)f -(b)q(ound)h(to)f(a)g(k)o(ey)l(.)75 762 y Fb(1.4.6)30 +1492 y(teen,)g(and)g(so)g(on.)20 b(By)15 b(default,)h(this)f(is)h(not)f +(b)q(ound)h(to)f(a)g(k)o(ey)l(.)75 1595 y Fb(1.4.6)30 b(Letting)20 b(Readline)g(T)n(yp)r(e)h(F)-5 b(or)19 b(Y)-5 -b(ou)75 892 y Fl(complete)14 b(\()305 890 y Ff(h)p 317 -864 74 2 v 317 892 a Fe(T)m(AB)p 317 900 V 389 890 a -Ff(i)404 892 y Fl(\))315 947 y Fm(A)o(ttempt)c(to)h(p)q(erform)g -(completion)i(on)e(the)g(text)g(b)q(efore)h(p)q(oin)o(t.)19 -b(The)11 b(actual)h(completion)315 1002 y(p)q(erformed)j(is)h +b(ou)75 1708 y Fl(complete)14 b(\()305 1706 y Ff(h)p +317 1680 74 2 v 317 1708 a Fe(T)m(AB)p 317 1715 V 389 +1706 a Ff(i)404 1708 y Fl(\))315 1762 y Fm(A)o(ttempt)c(to)h(p)q +(erform)g(completion)i(on)e(the)g(text)g(b)q(efore)h(p)q(oin)o(t.)19 +b(The)11 b(actual)h(completion)315 1817 y(p)q(erformed)j(is)h (application-sp)q(eci\014)q(c.)23 b(The)15 b(default)h(is)g(\014lename) -g(completion.)75 1099 y Fl(possible-completions)c(\(M-?\))315 -1154 y Fm(List)k(the)f(p)q(ossible)i(completions)f(of)f(the)g(text)g(b) -q(efore)h(p)q(oin)o(t.)75 1251 y Fl(insert-completions)d(\(M-*\))315 -1306 y Fm(Insert)j(all)g(completions)g(of)f(the)g(text)g(b)q(efore)h(p) +g(completion.)75 1901 y Fl(possible-completions)c(\(M-?\))315 +1955 y Fm(List)k(the)f(p)q(ossible)i(completions)f(of)f(the)g(text)g(b) +q(efore)h(p)q(oin)o(t.)75 2039 y Fl(insert-completions)d(\(M-*\))315 +2093 y Fm(Insert)j(all)g(completions)g(of)f(the)g(text)g(b)q(efore)h(p) q(oin)o(t)f(that)g(w)o(ould)h(ha)o(v)o(e)f(b)q(een)h(generated)315 -1361 y(b)o(y)f Fl(possible-completions)p Fm(.)75 1458 -y Fl(menu-complete)e(\(\))315 1513 y Fm(Similar)g(to)f +2148 y(b)o(y)f Fl(possible-completions)p Fm(.)75 2232 +y Fl(menu-complete)e(\(\))315 2286 y Fm(Similar)g(to)f Fl(complete)p Fm(,)f(but)h(replaces)h(the)f(w)o(ord)f(to)g(b)q(e)i -(completed)f(with)h(a)e(single)j(matc)o(h)315 1568 y(from)k(the)h(list) +(completed)f(with)h(a)e(single)j(matc)o(h)315 2341 y(from)k(the)h(list) h(of)e(p)q(ossible)j(completions.)32 b(Rep)q(eated)19 -b(execution)h(of)f Fl(menu-complete)315 1623 y Fm(steps)h(through)g +b(execution)h(of)f Fl(menu-complete)315 2396 y Fm(steps)h(through)g (the)g(list)h(of)f(p)q(ossible)i(completions,)g(inserting)f(eac)o(h)f -(matc)o(h)f(in)i(turn.)315 1678 y(A)o(t)d(the)g(end)h(of)f(the)h(list)g +(matc)o(h)f(in)i(turn.)315 2451 y(A)o(t)d(the)g(end)h(of)f(the)h(list)g (of)f(completions,)i(the)e(b)q(ell)j(is)d(rung)h(\(sub)s(ject)f(to)f -(the)i(setting)315 1732 y(of)f Fl(bell-style)p Fm(\))e(and)i(the)g +(the)i(setting)315 2506 y(of)f Fl(bell-style)p Fm(\))e(and)i(the)g (original)h(text)f(is)g(restored.)28 b(An)19 b(argumen)o(t)e(of)g -Fc(n)i Fm(mo)o(v)o(es)e Fc(n)315 1787 y Fm(p)q(ositions)h(forw)o(ard)e +Fc(n)i Fm(mo)o(v)o(es)e Fc(n)315 2560 y Fm(p)q(ositions)h(forw)o(ard)e (in)j(the)e(list)h(of)f(matc)o(hes;)h(a)f(negativ)o(e)g(argumen)o(t)g -(ma)o(y)g(b)q(e)h(used)g(to)315 1842 y(mo)o(v)o(e)g(bac)o(kw)o(ard)h +(ma)o(y)g(b)q(e)h(used)g(to)315 2615 y(mo)o(v)o(e)g(bac)o(kw)o(ard)h (through)g(the)g(list.)32 b(This)20 b(command)f(is)h(in)o(tended)g(to)f -(b)q(e)h(b)q(ound)g(to)315 1895 y Ff(h)p 327 1869 V 327 -1897 a Fe(T)m(AB)p 327 1905 V 399 1895 a Ff(i)414 1897 -y Fm(,)15 b(but)g(is)h(un)o(b)q(ound)g(b)o(y)f(default.)75 -1994 y Fl(delete-char-or-list)e(\(\))315 2049 y Fm(Deletes)h(the)f(c)o -(haracter)g(under)h(the)g(cursor)f(if)h(not)f(at)g(the)g(b)q(eginning)j -(or)d(end)h(of)f(the)g(line)315 2104 y(\(lik)o(e)i Fl(delete-char)p -Fm(\).)j(If)d(at)f(the)h(end)g(of)f(the)g(line,)i(b)q(eha)o(v)o(es)f -(iden)o(tically)i(to)d Fl(possible-)315 2159 y(completions)p -Fm(.)k(This)e(command)f(is)h(un)o(b)q(ound)g(b)o(y)f(default.)75 -2278 y Fb(1.4.7)30 b(Keyb)r(oard)20 b(Macros)75 2408 -y Fl(start-kbd-macro)13 b(\(C-x)i(\(\))315 2463 y Fm(Begin)h(sa)o(ving) -f(the)h(c)o(haracters)e(t)o(yp)q(ed)i(in)o(to)f(the)g(curren)o(t)g(k)o -(eyb)q(oard)g(macro.)75 2560 y Fl(end-kbd-macro)e(\(C-x)i(\)\))315 -2615 y Fm(Stop)f(sa)o(ving)f(the)h(c)o(haracters)f(t)o(yp)q(ed)h(in)o -(to)f(the)h(curren)o(t)g(k)o(eyb)q(oard)f(macro)g(and)h(sa)o(v)o(e)f -(the)315 2670 y(de\014nition.)p eop +(b)q(e)h(b)q(ound)g(to)315 2668 y Ff(h)p 327 2642 V 327 +2670 a Fe(T)m(AB)p 327 2678 V 399 2668 a Ff(i)414 2670 +y Fm(,)15 b(but)g(is)h(un)o(b)q(ound)g(b)o(y)f(default.)p +eop %%Page: 17 19 17 18 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 -b(17)75 149 y Fl(call-last-kbd-macro)13 b(\(C-x)h(e\))315 -204 y Fm(Re-execute)k(the)g(last)f(k)o(eyb)q(oard)h(macro)f(de\014ned,) -i(b)o(y)e(making)h(the)g(c)o(haracters)e(in)j(the)315 -259 y(macro)14 b(app)q(ear)i(as)f(if)g(t)o(yp)q(ed)h(at)e(the)i(k)o -(eyb)q(oard.)75 368 y Fb(1.4.8)30 b(Some)20 b(Miscellaneous)h(Commands) -75 486 y Fl(re-read-init-file)13 b(\(C-x)h(C-r\))315 -541 y Fm(Read)d(in)g(the)g(con)o(ten)o(ts)g(of)f(the)h -Fc(inputrc)k Fm(\014le,)d(and)g(incorp)q(orate)f(an)o(y)f(bindings)j -(or)e(v)m(ariable)315 596 y(assignmen)o(ts)k(found)h(there.)75 -684 y Fl(abort)e(\(C-g\))315 739 y Fm(Ab)q(ort)f(the)g(curren)o(t)h +b(17)75 149 y Fl(delete-char-or-list)13 b(\(\))315 204 +y Fm(Deletes)h(the)f(c)o(haracter)g(under)h(the)g(cursor)f(if)h(not)f +(at)g(the)g(b)q(eginning)j(or)d(end)h(of)f(the)g(line)315 +259 y(\(lik)o(e)i Fl(delete-char)p Fm(\).)j(If)d(at)f(the)h(end)g(of)f +(the)g(line,)i(b)q(eha)o(v)o(es)f(iden)o(tically)i(to)d +Fl(possible-)315 314 y(completions)p Fm(.)k(This)e(command)f(is)h(un)o +(b)q(ound)g(b)o(y)f(default.)75 428 y Fb(1.4.7)30 b(Keyb)r(oard)20 +b(Macros)75 551 y Fl(start-kbd-macro)13 b(\(C-x)i(\(\))315 +606 y Fm(Begin)h(sa)o(ving)f(the)h(c)o(haracters)e(t)o(yp)q(ed)i(in)o +(to)f(the)g(curren)o(t)g(k)o(eyb)q(oard)g(macro.)75 699 +y Fl(end-kbd-macro)e(\(C-x)i(\)\))315 754 y Fm(Stop)f(sa)o(ving)f(the)h +(c)o(haracters)f(t)o(yp)q(ed)h(in)o(to)f(the)h(curren)o(t)g(k)o(eyb)q +(oard)f(macro)g(and)h(sa)o(v)o(e)f(the)315 809 y(de\014nition.)75 +902 y Fl(call-last-kbd-macro)g(\(C-x)h(e\))315 957 y +Fm(Re-execute)k(the)g(last)f(k)o(eyb)q(oard)h(macro)f(de\014ned,)i(b)o +(y)e(making)h(the)g(c)o(haracters)e(in)j(the)315 1012 +y(macro)14 b(app)q(ear)i(as)f(if)g(t)o(yp)q(ed)h(at)e(the)i(k)o(eyb)q +(oard.)75 1126 y Fb(1.4.8)30 b(Some)20 b(Miscellaneous)h(Commands)75 +1249 y Fl(re-read-init-file)13 b(\(C-x)h(C-r\))315 1304 +y Fm(Read)d(in)g(the)g(con)o(ten)o(ts)g(of)f(the)h Fc(inputrc)k +Fm(\014le,)d(and)g(incorp)q(orate)f(an)o(y)f(bindings)j(or)e(v)m +(ariable)315 1358 y(assignmen)o(ts)k(found)h(there.)75 +1452 y Fl(abort)e(\(C-g\))315 1507 y Fm(Ab)q(ort)f(the)g(curren)o(t)h (editing)g(command)f(and)h(ring)f(the)h(terminal's)f(b)q(ell)i(\(sub)s -(ject)e(to)g(the)315 794 y(setting)i(of)g Fl(bell-style)p -Fm(\).)75 883 y Fl(do-uppercase-version)d(\(M-a,)j(M-b,)f(M-)p -Fc(x)p Fl(,)h(...\))315 938 y Fm(If)f(the)g(meta\014ed)g(c)o(haracter)f -Fc(x)k Fm(is)d(lo)o(w)o(ercase,)g(run)g(the)g(command)f(that)h(is)g(b)q -(ound)h(to)e(the)315 993 y(corresp)q(onding)j(upp)q(ercase)g(c)o -(haracter.)75 1082 y Fl(prefix-meta)e(\()377 1080 y Ff(h)p -389 1054 70 2 v 389 1082 a Fe(ESC)p 389 1089 V 456 1080 -a Ff(i)471 1082 y Fl(\))315 1136 y Fm(Metafy)k(the)h(next)g(c)o +(ject)e(to)g(the)315 1561 y(setting)i(of)g Fl(bell-style)p +Fm(\).)75 1655 y Fl(do-uppercase-version)d(\(M-a,)j(M-b,)f(M-)p +Fc(x)p Fl(,)h(...\))315 1710 y Fm(If)f(the)g(meta\014ed)g(c)o(haracter) +f Fc(x)k Fm(is)d(lo)o(w)o(ercase,)g(run)g(the)g(command)f(that)h(is)g +(b)q(ound)h(to)e(the)315 1764 y(corresp)q(onding)j(upp)q(ercase)g(c)o +(haracter.)75 1858 y Fl(prefix-meta)e(\()377 1856 y Ff(h)p +389 1830 70 2 v 389 1858 a Fe(ESC)p 389 1866 V 456 1856 +a Ff(i)471 1858 y Fl(\))315 1913 y Fm(Metafy)k(the)h(next)g(c)o (haracter)f(t)o(yp)q(ed.)30 b(This)20 b(is)f(for)f(k)o(eyb)q(oards)h -(without)g(a)f(meta)g(k)o(ey)l(.)315 1191 y(T)o(yping)e(`)485 -1189 y Ff(h)p 496 1163 V 496 1191 a Fe(ESC)p 496 1199 -V 563 1189 a Ff(i)593 1191 y Fl(f)p Fm(')f(is)h(equiv)m(alen)o(t)h(to)d -(t)o(yping)i Fg(M-f)p Fm(.)75 1280 y Fl(undo)f(\(C-_)f(or)h(C-x)g -(C-u\))315 1335 y Fm(Incremen)o(tal)h(undo,)f(separately)h(remem)o(b)q -(ered)g(for)e(eac)o(h)h(line.)75 1424 y Fl(revert-line)f(\(M-r\))315 -1479 y Fm(Undo)j(all)g(c)o(hanges)g(made)f(to)g(this)h(line.)26 +(without)g(a)f(meta)g(k)o(ey)l(.)315 1968 y(T)o(yping)e(`)485 +1966 y Ff(h)p 496 1939 V 496 1968 a Fe(ESC)p 496 1975 +V 563 1966 a Ff(i)593 1968 y Fl(f)p Fm(')f(is)h(equiv)m(alen)o(t)h(to)d +(t)o(yping)i Fg(M-f)p Fm(.)75 2061 y Fl(undo)f(\(C-_)f(or)h(C-x)g +(C-u\))315 2116 y Fm(Incremen)o(tal)h(undo,)f(separately)h(remem)o(b)q +(ered)g(for)e(eac)o(h)h(line.)75 2209 y Fl(revert-line)f(\(M-r\))315 +2264 y Fm(Undo)j(all)g(c)o(hanges)g(made)f(to)g(this)h(line.)26 b(This)17 b(is)g(lik)o(e)h(executing)f(the)g Fl(undo)f -Fm(command)315 1533 y(enough)g(times)f(to)g(get)f(bac)o(k)h(to)g(the)g -(b)q(eginning.)75 1622 y Fl(tilde-expand)f(\(M-~\))315 -1677 y Fm(P)o(erform)g(tilde)j(expansion)f(on)f(the)g(curren)o(t)g(w)o -(ord.)75 1766 y Fl(set-mark)f(\(C-@\))315 1821 y Fm(Set)i(the)h(mark)f +Fm(command)315 2319 y(enough)g(times)f(to)g(get)f(bac)o(k)h(to)g(the)g +(b)q(eginning.)75 2412 y Fl(tilde-expand)f(\(M-~\))315 +2467 y Fm(P)o(erform)g(tilde)j(expansion)f(on)f(the)g(curren)o(t)g(w)o +(ord.)75 2560 y Fl(set-mark)f(\(C-@\))315 2615 y Fm(Set)i(the)h(mark)f (to)f(the)i(p)q(oin)o(t.)24 b(If)17 b(a)f(n)o(umeric)h(argumen)o(t)f -(is)g(supplied,)j(the)e(mark)e(is)i(set)315 1876 y(to)e(that)f(p)q -(osition.)75 1965 y Fl(exchange-point-and-mark)e(\(C-x)j(C-x\))315 -2020 y Fm(Sw)o(ap)g(the)h(p)q(oin)o(t)g(with)g(the)g(mark.)k(The)c -(curren)o(t)f(cursor)h(p)q(osition)g(is)g(set)g(to)f(the)g(sa)o(v)o(ed) -315 2074 y(p)q(osition,)h(and)f(the)h(old)f(cursor)g(p)q(osition)h(is)g -(sa)o(v)o(ed)f(as)g(the)g(mark.)75 2163 y Fl(character-search)e -(\(C-]\))315 2218 y Fm(A)f(c)o(haracter)g(is)h(read)g(and)f(p)q(oin)o -(t)h(is)g(mo)o(v)o(ed)f(to)g(the)g(next)h(o)q(ccurrence)g(of)f(that)g -(c)o(haracter.)315 2273 y(A)j(negativ)o(e)h(coun)o(t)f(searc)o(hes)g -(for)f(previous)i(o)q(ccurrences.)75 2362 y Fl -(character-search-backward)c(\(M-C-]\))315 2417 y Fm(A)22 -b(c)o(haracter)g(is)h(read)f(and)h(p)q(oin)o(t)g(is)g(mo)o(v)o(ed)f(to) -g(the)g(previous)h(o)q(ccurrence)h(of)e(that)315 2471 -y(c)o(haracter.)d(A)c(negativ)o(e)h(coun)o(t)f(searc)o(hes)g(for)f -(subsequen)o(t)i(o)q(ccurrences.)75 2560 y Fl(insert-comment)d(\(M-#\)) -315 2615 y Fm(The)19 b(v)m(alue)i(of)e(the)g Fl(comment-begin)e -Fm(v)m(ariable)k(is)f(inserted)g(at)e(the)i(b)q(eginning)h(of)e(the)315 -2670 y(curren)o(t)c(line,)i(and)e(the)g(line)i(is)f(accepted)g(as)e(if) -i(a)f(newline)i(had)f(b)q(een)g(t)o(yp)q(ed.)p eop +(is)g(supplied,)j(the)e(mark)e(is)i(set)315 2670 y(to)e(that)f(p)q +(osition.)p eop %%Page: 18 20 18 19 bop 75 -58 a Fm(18)1299 b(GNU)15 b(Readline)h(Library)75 -149 y Fl(dump-functions)d(\(\))315 204 y Fm(Prin)o(t)g(all)h(of)f(the)g +149 y Fl(exchange-point-and-mark)c(\(C-x)j(C-x\))315 +204 y Fm(Sw)o(ap)g(the)h(p)q(oin)o(t)g(with)g(the)g(mark.)k(The)c +(curren)o(t)f(cursor)h(p)q(osition)g(is)g(set)g(to)f(the)g(sa)o(v)o(ed) +315 259 y(p)q(osition,)h(and)f(the)h(old)f(cursor)g(p)q(osition)h(is)g +(sa)o(v)o(ed)f(as)g(the)g(mark.)75 347 y Fl(character-search)e(\(C-]\)) +315 402 y Fm(A)f(c)o(haracter)g(is)h(read)g(and)f(p)q(oin)o(t)h(is)g +(mo)o(v)o(ed)f(to)g(the)g(next)h(o)q(ccurrence)g(of)f(that)g(c)o +(haracter.)315 456 y(A)j(negativ)o(e)h(coun)o(t)f(searc)o(hes)g(for)f +(previous)i(o)q(ccurrences.)75 544 y Fl(character-search-backward)c +(\(M-C-]\))315 599 y Fm(A)22 b(c)o(haracter)g(is)h(read)f(and)h(p)q +(oin)o(t)g(is)g(mo)o(v)o(ed)f(to)g(the)g(previous)h(o)q(ccurrence)h(of) +e(that)315 654 y(c)o(haracter.)d(A)c(negativ)o(e)h(coun)o(t)f(searc)o +(hes)g(for)f(subsequen)o(t)i(o)q(ccurrences.)75 741 y +Fl(insert-comment)d(\(M-#\))315 796 y Fm(Without)18 b(a)f(n)o(umeric)i +(argumen)o(t,)e(the)h(v)m(alue)h(of)f(the)f Fl(comment-begin)f +Fm(v)m(ariable)k(is)e(in-)315 851 y(serted)e(at)f(the)h(b)q(eginning)i +(of)d(the)h(curren)o(t)g(line.)23 b(If)16 b(a)g(n)o(umeric)h(argumen)o +(t)e(is)h(supplied,)315 906 y(this)j(command)f(acts)g(as)f(a)h(toggle:) +26 b(if)19 b(the)f(c)o(haracters)g(at)f(the)i(b)q(eginning)h(of)e(the)g +(line)315 960 y(do)d(not)g(matc)o(h)g(the)g(v)m(alue)i(of)e +Fl(comment-begin)p Fm(,)e(the)i(v)m(alue)i(is)f(inserted,)f(otherwise)h +(the)315 1015 y(c)o(haracters)j(in)i Fl(comment-begin)d +Fm(are)i(deleted)i(from)d(the)h(b)q(eginning)i(of)e(the)g(line.)36 +b(In)315 1070 y(either)16 b(case,)f(the)g(line)i(is)f(accepted)f(as)g +(if)h(a)f(newline)i(had)e(b)q(een)i(t)o(yp)q(ed.)75 1158 +y Fl(dump-functions)c(\(\))315 1213 y Fm(Prin)o(t)g(all)h(of)f(the)g (functions)h(and)g(their)g(k)o(ey)f(bindings)i(to)d(the)i(Readline)g -(output)f(stream.)315 259 y(If)j(a)g(n)o(umeric)g(argumen)o(t)f(is)i +(output)f(stream.)315 1267 y(If)j(a)g(n)o(umeric)g(argumen)o(t)f(is)i (supplied,)h(the)e(output)f(is)i(formatted)d(in)j(suc)o(h)f(a)g(w)o(a)o -(y)f(that)315 314 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g +(y)f(that)315 1322 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fc(inputrc)k Fm(\014le.)i(This)16 b(command)f(is)h(un)o(b)q(ound)g(b)o -(y)f(default.)75 406 y Fl(dump-variables)e(\(\))315 461 -y Fm(Prin)o(t)e(all)g(of)f(the)h(settable)g(v)m(ariables)h(and)f(their) -g(v)m(alues)h(to)e(the)h(Readline)h(output)e(stream.)315 -516 y(If)16 b(a)g(n)o(umeric)g(argumen)o(t)f(is)i(supplied,)h(the)e +(y)f(default.)75 1410 y Fl(dump-variables)e(\(\))315 +1465 y Fm(Prin)o(t)e(all)g(of)f(the)h(settable)g(v)m(ariables)h(and)f +(their)g(v)m(alues)h(to)e(the)h(Readline)h(output)e(stream.)315 +1519 y(If)16 b(a)g(n)o(umeric)g(argumen)o(t)f(is)i(supplied,)h(the)e (output)f(is)i(formatted)d(in)j(suc)o(h)f(a)g(w)o(a)o(y)f(that)315 -570 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fc(inputrc)k +1574 y(it)g(can)h(b)q(e)g(made)f(part)f(of)h(an)g Fc(inputrc)k Fm(\014le.)i(This)16 b(command)f(is)h(un)o(b)q(ound)g(b)o(y)f(default.) -75 663 y Fl(dump-macros)f(\(\))315 717 y Fm(Prin)o(t)j(all)h(of)e(the)h -(Readline)h(k)o(ey)f(sequences)h(b)q(ound)g(to)e(macros)g(and)h(the)g -(strings)g(they)315 772 y(output.)26 b(If)18 b(a)f(n)o(umeric)h +75 1662 y Fl(dump-macros)f(\(\))315 1717 y Fm(Prin)o(t)j(all)h(of)e +(the)h(Readline)h(k)o(ey)f(sequences)h(b)q(ound)g(to)e(macros)g(and)h +(the)g(strings)g(they)315 1771 y(output.)26 b(If)18 b(a)f(n)o(umeric)h (argumen)o(t)f(is)h(supplied,)i(the)d(output)g(is)h(formatted)e(in)j -(suc)o(h)e(a)315 827 y(w)o(a)o(y)d(that)g(it)i(can)f(b)q(e)g(made)g +(suc)o(h)e(a)315 1826 y(w)o(a)o(y)d(that)g(it)i(can)f(b)q(e)g(made)g (part)g(of)f(an)h Fc(inputrc)k Fm(\014le.)i(This)15 b(command)g(is)h -(un)o(b)q(ound)g(b)o(y)315 882 y(default.)75 1010 y Fk(1.5)33 -b(Readline)23 b(vi)h(Mo)r(de)137 1107 y Fm(While)13 b(the)f(Readline)i -(library)e(do)q(es)g(not)g(ha)o(v)o(e)f(a)h(full)h(set)f(of)f -Fl(vi)g Fm(editing)j(functions,)f(it)f(do)q(es)g(con)o(tain)75 -1161 y(enough)17 b(to)g(allo)o(w)g(simple)h(editing)h(of)d(the)i(line.) -27 b(The)17 b(Readline)h Fl(vi)f Fm(mo)q(de)g(b)q(eha)o(v)o(es)g(as)g -(sp)q(eci\014ed)i(in)75 1216 y(the)c Fh(posix)g Fm(1003.2)f(standard.) -137 1284 y(In)h(order)g(to)f(switc)o(h)g(in)o(teractiv)o(ely)i(b)q(et)o -(w)o(een)f Fl(emacs)e Fm(and)i Fl(vi)f Fm(editing)i(mo)q(des,)f(use)f -(the)h(command)75 1338 y Fg(M-C-j)j Fm(\(b)q(ound)i(to)e -(emacs-editing-mo)q(de)j(when)e(in)h Fl(vi)f Fm(mo)q(de)g(and)g(to)f -(vi-editing-mo)q(de)k(in)e Fl(emacs)75 1393 y Fm(mo)q(de\).)g(The)15 -b(Readline)i(default)f(is)f Fl(emacs)g Fm(mo)q(de.)137 -1460 y(When)h(y)o(ou)e(en)o(ter)h(a)g(line)i(in)e Fl(vi)g -Fm(mo)q(de,)g(y)o(ou)g(are)f(already)i(placed)g(in)g(`insertion')f(mo)q -(de,)g(as)g(if)g(y)o(ou)75 1515 y(had)e(t)o(yp)q(ed)h(an)f(`)p -Fl(i)p Fm('.)18 b(Pressing)608 1513 y Ff(h)p 620 1487 -70 2 v 620 1515 a Fe(ESC)p 620 1523 V 687 1513 a Ff(i)715 -1515 y Fm(switc)o(hes)13 b(y)o(ou)g(in)o(to)g(`command')f(mo)q(de,)i -(where)f(y)o(ou)g(can)g(edit)h(the)75 1570 y(text)i(of)h(the)g(line)h -(with)g(the)f(standard)f Fl(vi)h Fm(mo)o(v)o(emen)o(t)f(k)o(eys,)g(mo)o -(v)o(e)g(to)h(previous)g(history)g(lines)i(with)75 1625 -y(`)p Fl(k)p Fm(')14 b(and)i(subsequen)o(t)f(lines)i(with)f(`)p +(un)o(b)q(ound)g(b)o(y)315 1881 y(default.)75 1969 y +Fl(emacs-editing-mode)d(\(C-e\))315 2024 y Fm(When)j(in)g +Fl(vi)e Fm(command)i(mo)q(de,)f(this)g(causes)h(a)f(switc)o(h)g(to)g +Fl(emacs)f Fm(editing)j(mo)q(de.)75 2111 y Fl(vi-editing-mode)c +(\(M-C-j\))315 2166 y Fm(When)j(in)g Fl(emacs)e Fm(editing)j(mo)q(de,)e +(this)g(causes)h(a)f(switc)o(h)g(to)g Fl(vi)f Fm(editing)j(mo)q(de.)75 +2290 y Fk(1.5)33 b(Readline)23 b(vi)h(Mo)r(de)137 2385 +y Fm(While)13 b(the)f(Readline)i(library)e(do)q(es)g(not)g(ha)o(v)o(e)f +(a)h(full)h(set)f(of)f Fl(vi)g Fm(editing)j(functions,)f(it)f(do)q(es)g +(con)o(tain)75 2440 y(enough)17 b(to)g(allo)o(w)g(simple)h(editing)h +(of)d(the)i(line.)27 b(The)17 b(Readline)h Fl(vi)f Fm(mo)q(de)g(b)q +(eha)o(v)o(es)g(as)g(sp)q(eci\014ed)i(in)75 2495 y(the)c +Fh(posix)g Fm(1003.2)f(standard.)137 2560 y(In)h(order)g(to)f(switc)o +(h)g(in)o(teractiv)o(ely)i(b)q(et)o(w)o(een)f Fl(emacs)e +Fm(and)i Fl(vi)f Fm(editing)i(mo)q(des,)f(use)f(the)h(command)75 +2615 y Fg(M-C-j)j Fm(\(b)q(ound)i(to)e(emacs-editing-mo)q(de)j(when)e +(in)h Fl(vi)f Fm(mo)q(de)g(and)g(to)f(vi-editing-mo)q(de)k(in)e +Fl(emacs)75 2670 y Fm(mo)q(de\).)g(The)15 b(Readline)i(default)f(is)f +Fl(emacs)g Fm(mo)q(de.)p eop +%%Page: 19 21 +19 20 bop 75 -58 a Fm(Chapter)15 b(1:)k(Command)c(Line)i(Editing)1055 +b(19)137 149 y(When)16 b(y)o(ou)e(en)o(ter)h(a)g(line)i(in)e +Fl(vi)g Fm(mo)q(de,)g(y)o(ou)g(are)f(already)i(placed)g(in)g +(`insertion')f(mo)q(de,)g(as)g(if)g(y)o(ou)75 204 y(had)e(t)o(yp)q(ed)h +(an)f(`)p Fl(i)p Fm('.)18 b(Pressing)608 202 y Ff(h)p +620 176 70 2 v 620 204 a Fe(ESC)p 620 212 V 687 202 a +Ff(i)715 204 y Fm(switc)o(hes)13 b(y)o(ou)g(in)o(to)g(`command')f(mo)q +(de,)i(where)f(y)o(ou)g(can)g(edit)h(the)75 259 y(text)i(of)h(the)g +(line)h(with)g(the)f(standard)f Fl(vi)h Fm(mo)o(v)o(emen)o(t)f(k)o +(eys,)g(mo)o(v)o(e)g(to)h(previous)g(history)g(lines)i(with)75 +314 y(`)p Fl(k)p Fm(')14 b(and)i(subsequen)o(t)f(lines)i(with)f(`)p Fl(j)p Fm(',)e(and)h(so)g(forth.)p eop -%%Page: -1 21 --1 20 bop 1862 -58 a Fm(i)75 149 y Fi(T)-7 b(able)27 +%%Page: 20 22 +20 21 bop 75 -58 a Fm(20)1299 b(GNU)15 b(Readline)h(Library)p +eop +%%Page: -1 23 +-1 22 bop 1862 -58 a Fm(i)75 149 y Fi(T)-7 b(able)27 b(of)f(Con)n(ten)n(ts)75 320 y Fk(1)67 b(Command)22 b(Line)i(Editing)d Fa(.)10 b(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)42 b Fk(1)224 389 y Fm(1.1)j(In)o(tro)q(duction)16 @@ -1915,7 +1963,7 @@ b(Init)g(File)h(Syn)o(tax)7 b Fd(.)g(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)21 b Fm(4)374 882 y(1.3.2)44 b(Conditional)16 b(Init)g(Constructs)5 b Fd(.)i(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)g(.)f(.)19 b Fm(8)374 937 y(1.3.3)44 b(Sample)16 +h(.)f(.)h(.)g(.)f(.)19 b Fm(9)374 937 y(1.3.3)44 b(Sample)16 b(Init)g(File)11 b Fd(.)e(.)e(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h (.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) h(.)f(.)26 b Fm(9)224 992 y(1.4)45 b(Bindable)17 b(Readline)g(Commands) @@ -1928,24 +1976,24 @@ b(Commands)14 b(F)l(or)h(Manipulating)i(The)e(History)9 b Fd(.)e(.)h(.)f(.)h(.)f(.)h(.)24 b Fm(12)374 1156 y(1.4.3)44 b(Commands)14 b(F)l(or)h(Changing)h(T)l(ext)e Fd(.)8 b(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)30 -b Fm(13)374 1211 y(1.4.4)44 b(Killing)18 b(And)e(Y)l(anking)9 +b Fm(14)374 1211 y(1.4.4)44 b(Killing)18 b(And)e(Y)l(anking)9 b Fd(.)e(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) -h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)24 b Fm(14)374 +h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)24 b Fm(15)374 1266 y(1.4.5)44 b(Sp)q(ecifying)17 b(Numeric)f(Argumen)o(ts)c Fd(.)c(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)27 -b Fm(15)374 1320 y(1.4.6)44 b(Letting)15 b(Readline)i(T)o(yp)q(e)e(F)l +b Fm(16)374 1320 y(1.4.6)44 b(Letting)15 b(Readline)i(T)o(yp)q(e)e(F)l (or)g(Y)l(ou)10 b Fd(.)d(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) h(.)f(.)h(.)f(.)25 b Fm(16)374 1375 y(1.4.7)44 b(Keyb)q(oard)15 b(Macros)6 b Fd(.)h(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)21 -b Fm(16)374 1430 y(1.4.8)44 b(Some)15 b(Miscellaneous)i(Commands)7 +b Fm(17)374 1430 y(1.4.8)44 b(Some)15 b(Miscellaneous)i(Commands)7 b Fd(.)g(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.) 22 b Fm(17)224 1485 y(1.5)45 b(Readline)16 b(vi)g(Mo)q(de)e Fd(.)7 b(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f (.)h(.)f(.)h(.)28 b Fm(18)p eop -%%Page: -2 22 --2 21 bop 75 -58 a Fm(ii)1321 b(GNU)15 b(Readline)h(Library)p +%%Page: -2 24 +-2 23 bop 75 -58 a Fm(ii)1321 b(GNU)15 b(Readline)h(Library)p eop %%Trailer end diff --git a/doc/rluserman.texinfo b/doc/rluserman.texinfo index db560b9..89abe31 100644 --- a/doc/rluserman.texinfo +++ b/doc/rluserman.texinfo @@ -17,7 +17,7 @@ This document describes the end user interface of the GNU Readline Library, a utility which aids in the consistency of user interface across discrete programs that need to provide a command line interface. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -72,7 +72,7 @@ except that this permission notice may be stated in a translation approved by the Free Software Foundation. @vskip 0pt plus 1filll -Copyright @copyright{} 1988-2001 Free Software Foundation, Inc. +Copyright @copyright{} 1988-2002 Free Software Foundation, Inc. @end titlepage @ifinfo |