1: <HTML>
2: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3: <!-- Created on February, 11 2014 by texi2html 1.64 -->
4: <!--
5: Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
6: Karl Berry <karl@freefriends.org>
7: Olaf Bachmann <obachman@mathematik.uni-kl.de>
8: and many others.
9: Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
10: Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
11:
12: -->
13: <HEAD>
14: <TITLE>GNU Readline Library: </TITLE>
15:
16: <META NAME="description" CONTENT="GNU Readline Library: ">
17: <META NAME="keywords" CONTENT="GNU Readline Library: ">
18: <META NAME="resource-type" CONTENT="document">
19: <META NAME="distribution" CONTENT="global">
20: <META NAME="Generator" CONTENT="texi2html 1.64">
21:
22: </HEAD>
23:
24: <BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
25:
26: <A NAME="SEC_Top"></A>
27: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
28: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
29: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
30: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
31: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
32: </TR></TABLE>
33: <H1>GNU Readline Library</H1></P><P>
34:
35: This document describes the end user interface of the GNU Readline Library,
36: a utility which aids in the consistency of user interface across discrete
37: programs which provide a command line interface.
38: The Readline home page is <A HREF="http://www.gnu.org/software/readline/">http://www.gnu.org/software/readline/</A>.
39: </P><P>
40:
41: <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
42: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC1">1. Command Line Editing</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">GNU Readline User's Manual.</TD></TR>
43: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC23">A. GNU Free Documentation License</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">License for copying this manual.</TD></TR>
44: </TABLE></BLOCKQUOTE>
45: <P>
46:
47: <HR SIZE=1>
48: <A NAME="SEC1"></A>
49: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
50: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top"> < </A>]</TD>
51: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC2"> > </A>]</TD>
52: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
53: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top"> Up </A>]</TD>
54: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC23"> >> </A>]</TD>
55: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
56: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
57: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
58: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
59: </TR></TABLE>
60: <A NAME="Command Line Editing"></A>
61: <H1> 1. Command Line Editing </H1>
62: <!--docid::SEC1::-->
63: <P>
64:
65: This chapter describes the basic features of the GNU
66: command line editing interface.
67: </P><P>
68:
69: <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
70: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC2">1.1 Introduction to Line Editing</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Notation used in this text.</TD></TR>
71: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC3">1.2 Readline Interaction</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">The minimum set of commands for editing a line.</TD></TR>
72: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC9">1.3 Readline Init File</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Customizing Readline from a user's view.</TD></TR>
73: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC13">1.4 Bindable Readline Commands</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">A description of most of the Readline commands
74: available for binding</TD></TR>
75: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC22">1.5 Readline vi Mode</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">A short description of how to make Readline
76: behave like the vi editor.</TD></TR>
77: </TABLE></BLOCKQUOTE>
78: <P>
79:
80: <A NAME="Introduction and Notation"></A>
81: <HR SIZE="6">
82: <A NAME="SEC2"></A>
83: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
84: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> < </A>]</TD>
85: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> > </A>]</TD>
86: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
87: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> Up </A>]</TD>
88: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC23"> >> </A>]</TD>
89: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
90: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
91: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
92: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
93: </TR></TABLE>
94: <H2> 1.1 Introduction to Line Editing </H2>
95: <!--docid::SEC2::-->
96: <P>
97:
98: The following paragraphs describe the notation used to represent
99: keystrokes.
100: </P><P>
101:
102: The text <KBD>C-k</KBD> is read as `Control-K' and describes the character
103: produced when the <KBD>k</KBD> key is pressed while the Control key
104: is depressed.
105: </P><P>
106:
107: The text <KBD>M-k</KBD> is read as `Meta-K' and describes the character
108: produced when the Meta key (if you have one) is depressed, and the <KBD>k</KBD>
109: key is pressed.
110: The Meta key is labeled <KBD>ALT</KBD> on many keyboards.
111: On keyboards with two keys labeled <KBD>ALT</KBD> (usually to either side of
112: the space bar), the <KBD>ALT</KBD> on the left side is generally set to
113: work as a Meta key.
114: The <KBD>ALT</KBD> key on the right may also be configured to work as a
115: Meta key or may be configured as some other modifier, such as a
116: Compose key for typing accented characters.
117: </P><P>
118:
119: If you do not have a Meta or <KBD>ALT</KBD> key, or another key working as
120: a Meta key, the identical keystroke can be generated by typing <KBD>ESC</KBD>
121: <EM>first</EM>, and then typing <KBD>k</KBD>.
122: Either process is known as <EM>metafying</EM> the <KBD>k</KBD> key.
123: </P><P>
124:
125: The text <KBD>M-C-k</KBD> is read as `Meta-Control-k' and describes the
126: character produced by <EM>metafying</EM> <KBD>C-k</KBD>.
127: </P><P>
128:
129: In addition, several keys have their own names. Specifically,
130: <KBD>DEL</KBD>, <KBD>ESC</KBD>, <KBD>LFD</KBD>, <KBD>SPC</KBD>, <KBD>RET</KBD>, and <KBD>TAB</KBD> all
131: stand for themselves when seen in this text, or in an init file
132: (see section <A HREF="rluserman.html#SEC9">1.3 Readline Init File</A>).
133: If your keyboard lacks a <KBD>LFD</KBD> key, typing <KBD>C-j</KBD> will
134: produce the desired character.
135: The <KBD>RET</KBD> key may be labeled <KBD>Return</KBD> or <KBD>Enter</KBD> on
136: some keyboards.
137: </P><P>
138:
139: <A NAME="Readline Interaction"></A>
140: <HR SIZE="6">
141: <A NAME="SEC3"></A>
142: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
143: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC2"> < </A>]</TD>
144: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC4"> > </A>]</TD>
145: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> << </A>]</TD>
146: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> Up </A>]</TD>
147: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
148: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
149: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
150: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
151: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
152: </TR></TABLE>
153: <H2> 1.2 Readline Interaction </H2>
154: <!--docid::SEC3::-->
155: <P>
156:
157: Often during an interactive session you type in a long line of text,
158: only to notice that the first word on the line is misspelled. The
159: Readline library gives you a set of commands for manipulating the text
160: as you type it in, allowing you to just fix your typo, and not forcing
161: you to retype the majority of the line. Using these editing commands,
162: you move the cursor to the place that needs correction, and delete or
163: insert the text of the corrections. Then, when you are satisfied with
164: the line, you simply press <KBD>RET</KBD>. You do not have to be at the
165: end of the line to press <KBD>RET</KBD>; the entire line is accepted
166: regardless of the location of the cursor within the line.
167: </P><P>
168:
169: <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
170: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC4">1.2.1 Readline Bare Essentials</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">The least you need to know about Readline.</TD></TR>
171: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC5">1.2.2 Readline Movement Commands</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Moving about the input line.</TD></TR>
172: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC6">1.2.3 Readline Killing Commands</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">How to delete text, and how to get it back!</TD></TR>
173: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC7">1.2.4 Readline Arguments</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Giving numeric arguments to commands.</TD></TR>
174: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC8">1.2.5 Searching for Commands in the History</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Searching through previous lines.</TD></TR>
175: </TABLE></BLOCKQUOTE>
176: <P>
177:
178: <A NAME="Readline Bare Essentials"></A>
179: <HR SIZE="6">
180: <A NAME="SEC4"></A>
181: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
182: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> < </A>]</TD>
183: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC5"> > </A>]</TD>
184: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> << </A>]</TD>
185: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> Up </A>]</TD>
186: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
187: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
188: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
189: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
190: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
191: </TR></TABLE>
192: <H3> 1.2.1 Readline Bare Essentials </H3>
193: <!--docid::SEC4::-->
194: <P>
195:
196: In order to enter characters into the line, simply type them. The typed
197: character appears where the cursor was, and then the cursor moves one
198: space to the right. If you mistype a character, you can use your
199: erase character to back up and delete the mistyped character.
200: </P><P>
201:
202: Sometimes you may mistype a character, and
203: not notice the error until you have typed several other characters. In
204: that case, you can type <KBD>C-b</KBD> to move the cursor to the left, and then
205: correct your mistake. Afterwards, you can move the cursor to the right
206: with <KBD>C-f</KBD>.
207: </P><P>
208:
209: When you add text in the middle of a line, you will notice that characters
210: to the right of the cursor are `pushed over' to make room for the text
211: that you have inserted. Likewise, when you delete text behind the cursor,
212: characters to the right of the cursor are `pulled back' to fill in the
213: blank space created by the removal of the text. A list of the bare
214: essentials for editing the text of an input line follows.
215: </P><P>
216:
217: <DL COMPACT>
218: <DT><KBD>C-b</KBD>
219: <DD>Move back one character.
220: <DT><KBD>C-f</KBD>
221: <DD>Move forward one character.
222: <DT><KBD>DEL</KBD> or <KBD>Backspace</KBD>
223: <DD>Delete the character to the left of the cursor.
224: <DT><KBD>C-d</KBD>
225: <DD>Delete the character underneath the cursor.
226: <DT>Printing characters
227: <DD>Insert the character into the line at the cursor.
228: <DT><KBD>C-_</KBD> or <KBD>C-x C-u</KBD>
229: <DD>Undo the last editing command. You can undo all the way back to an
230: empty line.
231: </DL>
232: <P>
233:
234: (Depending on your configuration, the <KBD>Backspace</KBD> key be set to
235: delete the character to the left of the cursor and the <KBD>DEL</KBD> key set
236: to delete the character underneath the cursor, like <KBD>C-d</KBD>, rather
237: than the character to the left of the cursor.)
238: </P><P>
239:
240: <A NAME="Readline Movement Commands"></A>
241: <HR SIZE="6">
242: <A NAME="SEC5"></A>
243: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
244: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC4"> < </A>]</TD>
245: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC6"> > </A>]</TD>
246: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC6"> << </A>]</TD>
247: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> Up </A>]</TD>
248: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
249: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
250: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
251: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
252: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
253: </TR></TABLE>
254: <H3> 1.2.2 Readline Movement Commands </H3>
255: <!--docid::SEC5::-->
256: <P>
257:
258: The above table describes the most basic keystrokes that you need
259: in order to do editing of the input line. For your convenience, many
260: other commands have been added in addition to <KBD>C-b</KBD>, <KBD>C-f</KBD>,
261: <KBD>C-d</KBD>, and <KBD>DEL</KBD>. Here are some commands for moving more rapidly
262: about the line.
263: </P><P>
264:
265: <DL COMPACT>
266: <DT><KBD>C-a</KBD>
267: <DD>Move to the start of the line.
268: <DT><KBD>C-e</KBD>
269: <DD>Move to the end of the line.
270: <DT><KBD>M-f</KBD>
271: <DD>Move forward a word, where a word is composed of letters and digits.
272: <DT><KBD>M-b</KBD>
273: <DD>Move backward a word.
274: <DT><KBD>C-l</KBD>
275: <DD>Clear the screen, reprinting the current line at the top.
276: </DL>
277: <P>
278:
279: Notice how <KBD>C-f</KBD> moves forward a character, while <KBD>M-f</KBD> moves
280: forward a word. It is a loose convention that control keystrokes
281: operate on characters while meta keystrokes operate on words.
282: </P><P>
283:
284: <A NAME="Readline Killing Commands"></A>
285: <HR SIZE="6">
286: <A NAME="SEC6"></A>
287: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
288: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC5"> < </A>]</TD>
289: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC7"> > </A>]</TD>
290: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC7"> << </A>]</TD>
291: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> Up </A>]</TD>
292: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
293: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
294: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
295: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
296: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
297: </TR></TABLE>
298: <H3> 1.2.3 Readline Killing Commands </H3>
299: <!--docid::SEC6::-->
300: <P>
301:
302: <A NAME="IDX1"></A>
303: <A NAME="IDX2"></A>
304: </P><P>
305:
306: <EM>Killing</EM> text means to delete the text from the line, but to save
307: it away for later use, usually by <EM>yanking</EM> (re-inserting)
308: it back into the line.
309: (`Cut' and `paste' are more recent jargon for `kill' and `yank'.)
310: </P><P>
311:
312: If the description for a command says that it `kills' text, then you can
313: be sure that you can get the text back in a different (or the same)
314: place later.
315: </P><P>
316:
317: When you use a kill command, the text is saved in a <EM>kill-ring</EM>.
318: Any number of consecutive kills save all of the killed text together, so
319: that when you yank it back, you get it all. The kill
320: ring is not line specific; the text that you killed on a previously
321: typed line is available to be yanked back later, when you are typing
322: another line.
323: <A NAME="IDX3"></A>
324: </P><P>
325:
326: Here is the list of commands for killing text.
327: </P><P>
328:
329: <DL COMPACT>
330: <DT><KBD>C-k</KBD>
331: <DD>Kill the text from the current cursor position to the end of the line.
332: <P>
333:
334: <DT><KBD>M-d</KBD>
335: <DD>Kill from the cursor to the end of the current word, or, if between
336: words, to the end of the next word.
337: Word boundaries are the same as those used by <KBD>M-f</KBD>.
338: <P>
339:
340: <DT><KBD>M-<KBD>DEL</KBD></KBD>
341: <DD>Kill from the cursor the start of the current word, or, if between
342: words, to the start of the previous word.
343: Word boundaries are the same as those used by <KBD>M-b</KBD>.
344: <P>
345:
346: <DT><KBD>C-w</KBD>
347: <DD>Kill from the cursor to the previous whitespace. This is different than
348: <KBD>M-<KBD>DEL</KBD></KBD> because the word boundaries differ.
349: <P>
350:
351: </DL>
352: <P>
353:
354: Here is how to <EM>yank</EM> the text back into the line. Yanking
355: means to copy the most-recently-killed text from the kill buffer.
356: </P><P>
357:
358: <DL COMPACT>
359: <DT><KBD>C-y</KBD>
360: <DD>Yank the most recently killed text back into the buffer at the cursor.
361: <P>
362:
363: <DT><KBD>M-y</KBD>
364: <DD>Rotate the kill-ring, and yank the new top. You can only do this if
365: the prior command is <KBD>C-y</KBD> or <KBD>M-y</KBD>.
366: </DL>
367: <P>
368:
369: <A NAME="Readline Arguments"></A>
370: <HR SIZE="6">
371: <A NAME="SEC7"></A>
372: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
373: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC6"> < </A>]</TD>
374: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC8"> > </A>]</TD>
375: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC8"> << </A>]</TD>
376: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> Up </A>]</TD>
377: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
378: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
379: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
380: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
381: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
382: </TR></TABLE>
383: <H3> 1.2.4 Readline Arguments </H3>
384: <!--docid::SEC7::-->
385: <P>
386:
387: You can pass numeric arguments to Readline commands. Sometimes the
388: argument acts as a repeat count, other times it is the <I>sign</I> of the
389: argument that is significant. If you pass a negative argument to a
390: command which normally acts in a forward direction, that command will
391: act in a backward direction. For example, to kill text back to the
392: start of the line, you might type <SAMP>`M-- C-k'</SAMP>.
393: </P><P>
394:
395: The general way to pass numeric arguments to a command is to type meta
396: digits before the command. If the first `digit' typed is a minus
397: sign (<SAMP>`-'</SAMP>), then the sign of the argument will be negative. Once
398: you have typed one meta digit to get the argument started, you can type
399: the remainder of the digits, and then the command. For example, to give
400: the <KBD>C-d</KBD> command an argument of 10, you could type <SAMP>`M-1 0 C-d'</SAMP>,
401: which will delete the next ten characters on the input line.
402: </P><P>
403:
404: <A NAME="Searching"></A>
405: <HR SIZE="6">
406: <A NAME="SEC8"></A>
407: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
408: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC7"> < </A>]</TD>
409: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> > </A>]</TD>
410: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> << </A>]</TD>
411: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC3"> Up </A>]</TD>
412: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> >> </A>]</TD>
413: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
414: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
415: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
416: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
417: </TR></TABLE>
418: <H3> 1.2.5 Searching for Commands in the History </H3>
419: <!--docid::SEC8::-->
420: <P>
421:
422: Readline provides commands for searching through the command history
423: for lines containing a specified string.
424: There are two search modes: <EM>incremental</EM> and <EM>non-incremental</EM>.
425: </P><P>
426:
427: Incremental searches begin before the user has finished typing the
428: search string.
429: As each character of the search string is typed, Readline displays
430: the next entry from the history matching the string typed so far.
431: An incremental search requires only as many characters as needed to
432: find the desired history entry.
433: To search backward in the history for a particular string, type
434: <KBD>C-r</KBD>. Typing <KBD>C-s</KBD> searches forward through the history.
435: The characters present in the value of the <CODE>isearch-terminators</CODE> variable
436: are used to terminate an incremental search.
437: If that variable has not been assigned a value, the <KBD>ESC</KBD> and
438: <KBD>C-J</KBD> characters will terminate an incremental search.
439: <KBD>C-g</KBD> will abort an incremental search and restore the original line.
440: When the search is terminated, the history entry containing the
441: search string becomes the current line.
442: </P><P>
443:
444: To find other matching entries in the history list, type <KBD>C-r</KBD> or
445: <KBD>C-s</KBD> as appropriate.
446: This will search backward or forward in the history for the next
447: entry matching the search string typed so far.
448: Any other key sequence bound to a Readline command will terminate
449: the search and execute that command.
450: For instance, a <KBD>RET</KBD> will terminate the search and accept
451: the line, thereby executing the command from the history list.
452: A movement command will terminate the search, make the last line found
453: the current line, and begin editing.
454: </P><P>
455:
456: Readline remembers the last incremental search string. If two
457: <KBD>C-r</KBD>s are typed without any intervening characters defining a new
458: search string, any remembered search string is used.
459: </P><P>
460:
461: Non-incremental searches read the entire search string before starting
462: to search for matching history lines. The search string may be
463: typed by the user or be part of the contents of the current line.
464: </P><P>
465:
466: <A NAME="Readline Init File"></A>
467: <HR SIZE="6">
468: <A NAME="SEC9"></A>
469: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
470: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC8"> < </A>]</TD>
471: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC10"> > </A>]</TD>
472: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> << </A>]</TD>
473: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> Up </A>]</TD>
474: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> >> </A>]</TD>
475: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
476: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
477: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
478: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
479: </TR></TABLE>
480: <H2> 1.3 Readline Init File </H2>
481: <!--docid::SEC9::-->
482: <P>
483:
484: Although the Readline library comes with a set of Emacs-like
485: keybindings installed by default, it is possible to use a different set
486: of keybindings.
487: Any user can customize programs that use Readline by putting
488: commands in an <EM>inputrc</EM> file, conventionally in his home directory.
489: The name of this
490: file is taken from the value of the environment variable <CODE>INPUTRC</CODE>. If
491: that variable is unset, the default is <TT>`~/.inputrc'</TT>. If that
492: file does not exist or cannot be read, the ultimate default is
493: <TT>`/etc/inputrc'</TT>.
494: </P><P>
495:
496: When a program which uses the Readline library starts up, the
497: init file is read, and the key bindings are set.
498: </P><P>
499:
500: In addition, the <CODE>C-x C-r</CODE> command re-reads this init file, thus
501: incorporating any changes that you might have made to it.
502: </P><P>
503:
504: <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
505: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC10">1.3.1 Readline Init File Syntax</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Syntax for the commands in the inputrc file.</TD></TR>
506: </TABLE>
507:
508: <br>
509: <TABLE BORDER=0 CELLSPACING=0>
510: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC11">1.3.2 Conditional Init Constructs</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Conditional key bindings in the inputrc file.</TD></TR>
511: </TABLE>
512:
513: <br>
514: <TABLE BORDER=0 CELLSPACING=0>
515: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC12">1.3.3 Sample Init File</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">An example inputrc file.</TD></TR>
516: </TABLE></BLOCKQUOTE>
517: <P>
518:
519: <A NAME="Readline Init File Syntax"></A>
520: <HR SIZE="6">
521: <A NAME="SEC10"></A>
522: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
523: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> < </A>]</TD>
524: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC11"> > </A>]</TD>
525: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> << </A>]</TD>
526: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> Up </A>]</TD>
527: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> >> </A>]</TD>
528: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
529: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
530: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
531: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
532: </TR></TABLE>
533: <H3> 1.3.1 Readline Init File Syntax </H3>
534: <!--docid::SEC10::-->
535: <P>
536:
537: There are only a few basic constructs allowed in the
538: Readline init file. Blank lines are ignored.
539: Lines beginning with a <SAMP>`#'</SAMP> are comments.
540: Lines beginning with a <SAMP>`$'</SAMP> indicate conditional
541: constructs (see section <A HREF="rluserman.html#SEC11">1.3.2 Conditional Init Constructs</A>). Other lines
542: denote variable settings and key bindings.
543: </P><P>
544:
545: <DL COMPACT>
546: <DT>Variable Settings
547: <DD>You can modify the run-time behavior of Readline by
548: altering the values of variables in Readline
549: using the <CODE>set</CODE> command within the init file.
550: The syntax is simple:
551: <P>
552:
553: <TABLE><tr><td> </td><td class=example><pre>set <VAR>variable</VAR> <VAR>value</VAR>
554: </pre></td></tr></table></P><P>
555:
556: Here, for example, is how to
557: change from the default Emacs-like key binding to use
558: <CODE>vi</CODE> line editing commands:
559: </P><P>
560:
561: <TABLE><tr><td> </td><td class=example><pre>set editing-mode vi
562: </pre></td></tr></table></P><P>
563:
564: Variable names and values, where appropriate, are recognized without regard
565: to case. Unrecognized variable names are ignored.
566: </P><P>
567:
568: Boolean variables (those that can be set to on or off) are set to on if
569: the value is null or empty, <VAR>on</VAR> (case-insensitive), or 1. Any other
570: value results in the variable being set to off.
571: </P><P>
572:
573: A great deal of run-time behavior is changeable with the following
574: variables.
575: </P><P>
576:
577: <A NAME="IDX4"></A>
578: <DL COMPACT>
579:
580: <DT><CODE>bell-style</CODE>
581: <DD><A NAME="IDX5"></A>
582: Controls what happens when Readline wants to ring the terminal bell.
583: If set to <SAMP>`none'</SAMP>, Readline never rings the bell. If set to
584: <SAMP>`visible'</SAMP>, Readline uses a visible bell if one is available.
585: If set to <SAMP>`audible'</SAMP> (the default), Readline attempts to ring
586: the terminal's bell.
587: <P>
588:
589: <DT><CODE>bind-tty-special-chars</CODE>
590: <DD><A NAME="IDX6"></A>
591: If set to <SAMP>`on'</SAMP>, Readline attempts to bind the control characters
592: treated specially by the kernel's terminal driver to their Readline
593: equivalents.
594: <P>
595:
596: <DT><CODE>colored-stats</CODE>
597: <DD><A NAME="IDX7"></A>
598: If set to <SAMP>`on'</SAMP>, Readline displays possible completions using different
599: colors to indicate their file type.
600: The color definitions are taken from the value of the <CODE>LS_COLORS</CODE>
601: environment variable.
602: The default is <SAMP>`off'</SAMP>.
603: <P>
604:
605: <DT><CODE>comment-begin</CODE>
606: <DD><A NAME="IDX8"></A>
607: The string to insert at the beginning of the line when the
608: <CODE>insert-comment</CODE> command is executed. The default value
609: is <CODE>"#"</CODE>.
610: <P>
611:
612: <DT><CODE>completion-display-width</CODE>
613: <DD><A NAME="IDX9"></A>
614: The number of screen columns used to display possible matches
615: when performing completion.
616: The value is ignored if it is less than 0 or greater than the terminal
617: screen width.
618: A value of 0 will cause matches to be displayed one per line.
619: The default value is -1.
620: <P>
621:
622: <DT><CODE>completion-ignore-case</CODE>
623: <DD><A NAME="IDX10"></A>
624: If set to <SAMP>`on'</SAMP>, Readline performs filename matching and completion
625: in a case-insensitive fashion.
626: The default value is <SAMP>`off'</SAMP>.
627: <P>
628:
629: <DT><CODE>completion-map-case</CODE>
630: <DD><A NAME="IDX11"></A>
631: If set to <SAMP>`on'</SAMP>, and <VAR>completion-ignore-case</VAR> is enabled, Readline
632: treats hyphens (<SAMP>`-'</SAMP>) and underscores (<SAMP>`_'</SAMP>) as equivalent when
633: performing case-insensitive filename matching and completion.
634: <P>
635:
636: <DT><CODE>completion-prefix-display-length</CODE>
637: <DD><A NAME="IDX12"></A>
638: The length in characters of the common prefix of a list of possible
639: completions that is displayed without modification. When set to a
640: value greater than zero, common prefixes longer than this value are
641: replaced with an ellipsis when displaying possible completions.
642: <P>
643:
644: <DT><CODE>completion-query-items</CODE>
645: <DD><A NAME="IDX13"></A>
646: The number of possible completions that determines when the user is
647: asked whether the list of possibilities should be displayed.
648: If the number of possible completions is greater than this value,
649: Readline will ask the user whether or not he wishes to view
650: them; otherwise, they are simply listed.
651: This variable must be set to an integer value greater than or equal to 0.
652: A negative value means Readline should never ask.
653: The default limit is <CODE>100</CODE>.
654: <P>
655:
656: <DT><CODE>convert-meta</CODE>
657: <DD><A NAME="IDX14"></A>
658: If set to <SAMP>`on'</SAMP>, Readline will convert characters with the
659: eighth bit set to an ASCII key sequence by stripping the eighth
660: bit and prefixing an <KBD>ESC</KBD> character, converting them to a
661: meta-prefixed key sequence. The default value is <SAMP>`on'</SAMP>.
662: <P>
663:
664: <DT><CODE>disable-completion</CODE>
665: <DD><A NAME="IDX15"></A>
666: If set to <SAMP>`On'</SAMP>, Readline will inhibit word completion.
667: Completion characters will be inserted into the line as if they had
668: been mapped to <CODE>self-insert</CODE>. The default is <SAMP>`off'</SAMP>.
669: <P>
670:
671: <DT><CODE>editing-mode</CODE>
672: <DD><A NAME="IDX16"></A>
673: The <CODE>editing-mode</CODE> variable controls which default set of
674: key bindings is used. By default, Readline starts up in Emacs editing
675: mode, where the keystrokes are most similar to Emacs. This variable can be
676: set to either <SAMP>`emacs'</SAMP> or <SAMP>`vi'</SAMP>.
677: <P>
678:
679: <DT><CODE>echo-control-characters</CODE>
680: <DD>When set to <SAMP>`on'</SAMP>, on operating systems that indicate they support it,
681: readline echoes a character corresponding to a signal generated from the
682: keyboard. The default is <SAMP>`on'</SAMP>.
683: <P>
684:
685: <DT><CODE>enable-keypad</CODE>
686: <DD><A NAME="IDX17"></A>
687: When set to <SAMP>`on'</SAMP>, Readline will try to enable the application
688: keypad when it is called. Some systems need this to enable the
689: arrow keys. The default is <SAMP>`off'</SAMP>.
690: <P>
691:
692: <DT><CODE>enable-meta-key</CODE>
693: <DD>When set to <SAMP>`on'</SAMP>, Readline will try to enable any meta modifier
694: key the terminal claims to support when it is called. On many terminals,
695: the meta key is used to send eight-bit characters.
696: The default is <SAMP>`on'</SAMP>.
697: <P>
698:
699: <DT><CODE>expand-tilde</CODE>
700: <DD><A NAME="IDX18"></A>
701: If set to <SAMP>`on'</SAMP>, tilde expansion is performed when Readline
702: attempts word completion. The default is <SAMP>`off'</SAMP>.
703: <P>
704:
705: <DT><CODE>history-preserve-point</CODE>
706: <DD><A NAME="IDX19"></A>
707: If set to <SAMP>`on'</SAMP>, the history code attempts to place the point (the
708: current cursor position) at the
709: same location on each history line retrieved with <CODE>previous-history</CODE>
710: or <CODE>next-history</CODE>. The default is <SAMP>`off'</SAMP>.
711: <P>
712:
713: <DT><CODE>history-size</CODE>
714: <DD><A NAME="IDX20"></A>
715: Set the maximum number of history entries saved in the history list.
716: If set to zero, any existing history entries are deleted and no new entries
717: are saved.
718: If set to a value less than zero, the number of history entries is not
719: limited.
720: By default, the number of history entries is not limited.
721: <P>
722:
723: <DT><CODE>horizontal-scroll-mode</CODE>
724: <DD><A NAME="IDX21"></A>
725: This variable can be set to either <SAMP>`on'</SAMP> or <SAMP>`off'</SAMP>. Setting it
726: to <SAMP>`on'</SAMP> means that the text of the lines being edited will scroll
727: horizontally on a single screen line when they are longer than the width
728: of the screen, instead of wrapping onto a new screen line. By default,
729: this variable is set to <SAMP>`off'</SAMP>.
730: <P>
731:
732: <DT><CODE>input-meta</CODE>
733: <DD><A NAME="IDX22"></A>
734: <A NAME="IDX23"></A>
735: If set to <SAMP>`on'</SAMP>, Readline will enable eight-bit input (it
736: will not clear the eighth bit in the characters it reads),
737: regardless of what the terminal claims it can support. The
738: default value is <SAMP>`off'</SAMP>. The name <CODE>meta-flag</CODE> is a
739: synonym for this variable.
740: <P>
741:
742: <DT><CODE>isearch-terminators</CODE>
743: <DD><A NAME="IDX24"></A>
744: The string of characters that should terminate an incremental search without
745: subsequently executing the character as a command (see section <A HREF="rluserman.html#SEC8">1.2.5 Searching for Commands in the History</A>).
746: If this variable has not been given a value, the characters <KBD>ESC</KBD> and
747: <KBD>C-J</KBD> will terminate an incremental search.
748: <P>
749:
750: <DT><CODE>keymap</CODE>
751: <DD><A NAME="IDX25"></A>
752: Sets Readline's idea of the current keymap for key binding commands.
753: Acceptable <CODE>keymap</CODE> names are
754: <CODE>emacs</CODE>,
755: <CODE>emacs-standard</CODE>,
756: <CODE>emacs-meta</CODE>,
757: <CODE>emacs-ctlx</CODE>,
758: <CODE>vi</CODE>,
759: <CODE>vi-move</CODE>,
760: <CODE>vi-command</CODE>, and
761: <CODE>vi-insert</CODE>.
762: <CODE>vi</CODE> is equivalent to <CODE>vi-command</CODE>; <CODE>emacs</CODE> is
763: equivalent to <CODE>emacs-standard</CODE>. The default value is <CODE>emacs</CODE>.
764: The value of the <CODE>editing-mode</CODE> variable also affects the
765: default keymap.
766: <P>
767:
768: <DT><CODE>keyseq-timeout</CODE>
769: <DD>Specifies the duration Readline will wait for a character when reading an
770: ambiguous key sequence (one that can form a complete key sequence using
771: the input read so far, or can take additional input to complete a longer
772: key sequence).
773: If no input is received within the timeout, Readline will use the shorter
774: but complete key sequence.
775: Readline uses this value to determine whether or not input is
776: available on the current input source (<CODE>rl_instream</CODE> by default).
777: The value is specified in milliseconds, so a value of 1000 means that
778: Readline will wait one second for additional input.
779: If this variable is set to a value less than or equal to zero, or to a
780: non-numeric value, Readline will wait until another key is pressed to
781: decide which key sequence to complete.
782: The default value is <CODE>500</CODE>.
783: <P>
784:
785: <DT><CODE>mark-directories</CODE>
786: <DD>If set to <SAMP>`on'</SAMP>, completed directory names have a slash
787: appended. The default is <SAMP>`on'</SAMP>.
788: <P>
789:
790: <DT><CODE>mark-modified-lines</CODE>
791: <DD><A NAME="IDX26"></A>
792: This variable, when set to <SAMP>`on'</SAMP>, causes Readline to display an
793: asterisk (<SAMP>`*'</SAMP>) at the start of history lines which have been modified.
794: This variable is <SAMP>`off'</SAMP> by default.
795: <P>
796:
797: <DT><CODE>mark-symlinked-directories</CODE>
798: <DD><A NAME="IDX27"></A>
799: If set to <SAMP>`on'</SAMP>, completed names which are symbolic links
800: to directories have a slash appended (subject to the value of
801: <CODE>mark-directories</CODE>).
802: The default is <SAMP>`off'</SAMP>.
803: <P>
804:
805: <DT><CODE>match-hidden-files</CODE>
806: <DD><A NAME="IDX28"></A>
807: This variable, when set to <SAMP>`on'</SAMP>, causes Readline to match files whose
808: names begin with a <SAMP>`.'</SAMP> (hidden files) when performing filename
809: completion.
810: If set to <SAMP>`off'</SAMP>, the leading <SAMP>`.'</SAMP> must be
811: supplied by the user in the filename to be completed.
812: This variable is <SAMP>`on'</SAMP> by default.
813: <P>
814:
815: <DT><CODE>menu-complete-display-prefix</CODE>
816: <DD><A NAME="IDX29"></A>
817: If set to <SAMP>`on'</SAMP>, menu completion displays the common prefix of the
818: list of possible completions (which may be empty) before cycling through
819: the list. The default is <SAMP>`off'</SAMP>.
820: <P>
821:
822: <DT><CODE>output-meta</CODE>
823: <DD><A NAME="IDX30"></A>
824: If set to <SAMP>`on'</SAMP>, Readline will display characters with the
825: eighth bit set directly rather than as a meta-prefixed escape
826: sequence. The default is <SAMP>`off'</SAMP>.
827: <P>
828:
829: <DT><CODE>page-completions</CODE>
830: <DD><A NAME="IDX31"></A>
831: If set to <SAMP>`on'</SAMP>, Readline uses an internal <CODE>more</CODE>-like pager
832: to display a screenful of possible completions at a time.
833: This variable is <SAMP>`on'</SAMP> by default.
834: <P>
835:
836: <DT><CODE>print-completions-horizontally</CODE>
837: <DD>If set to <SAMP>`on'</SAMP>, Readline will display completions with matches
838: sorted horizontally in alphabetical order, rather than down the screen.
839: The default is <SAMP>`off'</SAMP>.
840: <P>
841:
842: <DT><CODE>revert-all-at-newline</CODE>
843: <DD><A NAME="IDX32"></A>
844: If set to <SAMP>`on'</SAMP>, Readline will undo all changes to history lines
845: before returning when <CODE>accept-line</CODE> is executed. By default,
846: history lines may be modified and retain individual undo lists across
847: calls to <CODE>readline</CODE>. The default is <SAMP>`off'</SAMP>.
848: <P>
849:
850: <DT><CODE>show-all-if-ambiguous</CODE>
851: <DD><A NAME="IDX33"></A>
852: This alters the default behavior of the completion functions. If
853: set to <SAMP>`on'</SAMP>,
854: words which have more than one possible completion cause the
855: matches to be listed immediately instead of ringing the bell.
856: The default value is <SAMP>`off'</SAMP>.
857: <P>
858:
859: <DT><CODE>show-all-if-unmodified</CODE>
860: <DD><A NAME="IDX34"></A>
861: This alters the default behavior of the completion functions in
862: a fashion similar to <VAR>show-all-if-ambiguous</VAR>.
863: If set to <SAMP>`on'</SAMP>,
864: words which have more than one possible completion without any
865: possible partial completion (the possible completions don't share
866: a common prefix) cause the matches to be listed immediately instead
867: of ringing the bell.
868: The default value is <SAMP>`off'</SAMP>.
869: <P>
870:
871: <DT><CODE>show-mode-in-prompt</CODE>
872: <DD><A NAME="IDX35"></A>
873: If set to <SAMP>`on'</SAMP>, add a character to the beginning of the prompt
874: indicating the editing mode: emacs (<SAMP>`@'</SAMP>), vi command (<SAMP>`:'</SAMP>),
875: or vi insertion (<SAMP>`+'</SAMP>).
876: The default value is <SAMP>`off'</SAMP>.
877: <P>
878:
879: <DT><CODE>skip-completed-text</CODE>
880: <DD><A NAME="IDX36"></A>
881: If set to <SAMP>`on'</SAMP>, this alters the default completion behavior when
882: inserting a single match into the line. It's only active when
883: performing completion in the middle of a word. If enabled, readline
884: does not insert characters from the completion that match characters
885: after point in the word being completed, so portions of the word
886: following the cursor are not duplicated.
887: For instance, if this is enabled, attempting completion when the cursor
888: is after the <SAMP>`e'</SAMP> in <SAMP>`Makefile'</SAMP> will result in <SAMP>`Makefile'</SAMP>
889: rather than <SAMP>`Makefilefile'</SAMP>, assuming there is a single possible
890: completion.
891: The default value is <SAMP>`off'</SAMP>.
892: <P>
893:
894: <DT><CODE>visible-stats</CODE>
895: <DD><A NAME="IDX37"></A>
896: If set to <SAMP>`on'</SAMP>, a character denoting a file's type
897: is appended to the filename when listing possible
898: completions. The default is <SAMP>`off'</SAMP>.
899: <P>
900:
901: </DL>
902: <P>
903:
904: <DT>Key Bindings
905: <DD>The syntax for controlling key bindings in the init file is
906: simple. First you need to find the name of the command that you
907: want to change. The following sections contain tables of the command
908: name, the default keybinding, if any, and a short description of what
909: the command does.
910: <P>
911:
912: Once you know the name of the command, simply place on a line
913: in the init file the name of the key
914: you wish to bind the command to, a colon, and then the name of the
915: command.
916: There can be no space between the key name and the colon -- that will be
917: interpreted as part of the key name.
918: The name of the key can be expressed in different ways, depending on
919: what you find most comfortable.
920: </P><P>
921:
922: In addition to command names, readline allows keys to be bound
923: to a string that is inserted when the key is pressed (a <VAR>macro</VAR>).
924: </P><P>
925:
926: <DL COMPACT>
927: <DT><VAR>keyname</VAR>: <VAR>function-name</VAR> or <VAR>macro</VAR>
928: <DD><VAR>keyname</VAR> is the name of a key spelled out in English. For example:
929: <TABLE><tr><td> </td><td class=example><pre>Control-u: universal-argument
930: Meta-Rubout: backward-kill-word
931: Control-o: "> output"
932: </pre></td></tr></table><P>
933:
934: In the above example, <KBD>C-u</KBD> is bound to the function
935: <CODE>universal-argument</CODE>,
936: <KBD>M-DEL</KBD> is bound to the function <CODE>backward-kill-word</CODE>, and
937: <KBD>C-o</KBD> is bound to run the macro
938: expressed on the right hand side (that is, to insert the text
939: <SAMP>`> output'</SAMP> into the line).
940: </P><P>
941:
942: A number of symbolic character names are recognized while
943: processing this key binding syntax:
944: <VAR>DEL</VAR>,
945: <VAR>ESC</VAR>,
946: <VAR>ESCAPE</VAR>,
947: <VAR>LFD</VAR>,
948: <VAR>NEWLINE</VAR>,
949: <VAR>RET</VAR>,
950: <VAR>RETURN</VAR>,
951: <VAR>RUBOUT</VAR>,
952: <VAR>SPACE</VAR>,
953: <VAR>SPC</VAR>,
954: and
955: <VAR>TAB</VAR>.
956: </P><P>
957:
958: <DT>"<VAR>keyseq</VAR>": <VAR>function-name</VAR> or <VAR>macro</VAR>
959: <DD><VAR>keyseq</VAR> differs from <VAR>keyname</VAR> above in that strings
960: denoting an entire key sequence can be specified, by placing
961: the key sequence in double quotes. Some GNU Emacs style key
962: escapes can be used, as in the following example, but the
963: special character names are not recognized.
964: <P>
965:
966: <TABLE><tr><td> </td><td class=example><pre>"\C-u": universal-argument
967: "\C-x\C-r": re-read-init-file
968: "\e[11~": "Function Key 1"
969: </pre></td></tr></table></P><P>
970:
971: In the above example, <KBD>C-u</KBD> is again bound to the function
972: <CODE>universal-argument</CODE> (just as it was in the first example),
973: <SAMP>`<KBD>C-x</KBD> <KBD>C-r</KBD>'</SAMP> is bound to the function <CODE>re-read-init-file</CODE>,
974: and <SAMP>`<KBD>ESC</KBD> <KBD>[</KBD> <KBD>1</KBD> <KBD>1</KBD> <KBD>~</KBD>'</SAMP> is bound to insert
975: the text <SAMP>`Function Key 1'</SAMP>.
976: </P><P>
977:
978: </DL>
979: <P>
980:
981: The following GNU Emacs style escape sequences are available when
982: specifying key sequences:
983: </P><P>
984:
985: <DL COMPACT>
986: <DT><CODE><KBD>\C-</KBD></CODE>
987: <DD>control prefix
988: <DT><CODE><KBD>\M-</KBD></CODE>
989: <DD>meta prefix
990: <DT><CODE><KBD>\e</KBD></CODE>
991: <DD>an escape character
992: <DT><CODE><KBD>\\</KBD></CODE>
993: <DD>backslash
994: <DT><CODE><KBD>\"</KBD></CODE>
995: <DD><KBD>"</KBD>, a double quotation mark
996: <DT><CODE><KBD>\'</KBD></CODE>
997: <DD><KBD>'</KBD>, a single quote or apostrophe
998: </DL>
999: <P>
1000:
1001: In addition to the GNU Emacs style escape sequences, a second
1002: set of backslash escapes is available:
1003: </P><P>
1004:
1005: <DL COMPACT>
1006: <DT><CODE>\a</CODE>
1007: <DD>alert (bell)
1008: <DT><CODE>\b</CODE>
1009: <DD>backspace
1010: <DT><CODE>\d</CODE>
1011: <DD>delete
1012: <DT><CODE>\f</CODE>
1013: <DD>form feed
1014: <DT><CODE>\n</CODE>
1015: <DD>newline
1016: <DT><CODE>\r</CODE>
1017: <DD>carriage return
1018: <DT><CODE>\t</CODE>
1019: <DD>horizontal tab
1020: <DT><CODE>\v</CODE>
1021: <DD>vertical tab
1022: <DT><CODE>\<VAR>nnn</VAR></CODE>
1023: <DD>the eight-bit character whose value is the octal value <VAR>nnn</VAR>
1024: (one to three digits)
1025: <DT><CODE>\x<VAR>HH</VAR></CODE>
1026: <DD>the eight-bit character whose value is the hexadecimal value <VAR>HH</VAR>
1027: (one or two hex digits)
1028: </DL>
1029: <P>
1030:
1031: When entering the text of a macro, single or double quotes must
1032: be used to indicate a macro definition.
1033: Unquoted text is assumed to be a function name.
1034: In the macro body, the backslash escapes described above are expanded.
1035: Backslash will quote any other character in the macro text,
1036: including <SAMP>`"'</SAMP> and <SAMP>`''</SAMP>.
1037: For example, the following binding will make <SAMP>`<KBD>C-x</KBD> \'</SAMP>
1038: insert a single <SAMP>`\'</SAMP> into the line:
1039: <TABLE><tr><td> </td><td class=example><pre>"\C-x\\": "\\"
1040: </pre></td></tr></table></P><P>
1041:
1042: </DL>
1043: <P>
1044:
1045: <A NAME="Conditional Init Constructs"></A>
1046: <HR SIZE="6">
1047: <A NAME="SEC11"></A>
1048: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1049: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC10"> < </A>]</TD>
1050: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC12"> > </A>]</TD>
1051: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC12"> << </A>]</TD>
1052: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> Up </A>]</TD>
1053: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> >> </A>]</TD>
1054: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1055: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1056: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1057: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1058: </TR></TABLE>
1059: <H3> 1.3.2 Conditional Init Constructs </H3>
1060: <!--docid::SEC11::-->
1061: <P>
1062:
1063: Readline implements a facility similar in spirit to the conditional
1064: compilation features of the C preprocessor which allows key
1065: bindings and variable settings to be performed as the result
1066: of tests. There are four parser directives used.
1067: </P><P>
1068:
1069: <DL COMPACT>
1070: <DT><CODE>$if</CODE>
1071: <DD>The <CODE>$if</CODE> construct allows bindings to be made based on the
1072: editing mode, the terminal being used, or the application using
1073: Readline. The text of the test extends to the end of the line;
1074: no characters are required to isolate it.
1075: <P>
1076:
1077: <DL COMPACT>
1078: <DT><CODE>mode</CODE>
1079: <DD>The <CODE>mode=</CODE> form of the <CODE>$if</CODE> directive is used to test
1080: whether Readline is in <CODE>emacs</CODE> or <CODE>vi</CODE> mode.
1081: This may be used in conjunction
1082: with the <SAMP>`set keymap'</SAMP> command, for instance, to set bindings in
1083: the <CODE>emacs-standard</CODE> and <CODE>emacs-ctlx</CODE> keymaps only if
1084: Readline is starting out in <CODE>emacs</CODE> mode.
1085: <P>
1086:
1087: <DT><CODE>term</CODE>
1088: <DD>The <CODE>term=</CODE> form may be used to include terminal-specific
1089: key bindings, perhaps to bind the key sequences output by the
1090: terminal's function keys. The word on the right side of the
1091: <SAMP>`='</SAMP> is tested against both the full name of the terminal and
1092: the portion of the terminal name before the first <SAMP>`-'</SAMP>. This
1093: allows <CODE>sun</CODE> to match both <CODE>sun</CODE> and <CODE>sun-cmd</CODE>,
1094: for instance.
1095: <P>
1096:
1097: <DT><CODE>application</CODE>
1098: <DD>The <VAR>application</VAR> construct is used to include
1099: application-specific settings. Each program using the Readline
1100: library sets the <VAR>application name</VAR>, and you can test for
1101: a particular value.
1102: This could be used to bind key sequences to functions useful for
1103: a specific program. For instance, the following command adds a
1104: key sequence that quotes the current or previous word in Bash:
1105: <TABLE><tr><td> </td><td class=example><pre>$if Bash
1106: # Quote the current or previous word
1107: "\C-xq": "\eb\"\ef\""
1108: $endif
1109: </pre></td></tr></table></DL>
1110: <P>
1111:
1112: <DT><CODE>$endif</CODE>
1113: <DD>This command, as seen in the previous example, terminates an
1114: <CODE>$if</CODE> command.
1115: <P>
1116:
1117: <DT><CODE>$else</CODE>
1118: <DD>Commands in this branch of the <CODE>$if</CODE> directive are executed if
1119: the test fails.
1120: <P>
1121:
1122: <DT><CODE>$include</CODE>
1123: <DD>This directive takes a single filename as an argument and reads commands
1124: and bindings from that file.
1125: For example, the following directive reads from <TT>`/etc/inputrc'</TT>:
1126: <TABLE><tr><td> </td><td class=example><pre>$include /etc/inputrc
1127: </pre></td></tr></table></DL>
1128: <P>
1129:
1130: <A NAME="Sample Init File"></A>
1131: <HR SIZE="6">
1132: <A NAME="SEC12"></A>
1133: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1134: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC11"> < </A>]</TD>
1135: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> > </A>]</TD>
1136: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> << </A>]</TD>
1137: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC9"> Up </A>]</TD>
1138: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> >> </A>]</TD>
1139: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1140: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1141: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1142: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1143: </TR></TABLE>
1144: <H3> 1.3.3 Sample Init File </H3>
1145: <!--docid::SEC12::-->
1146: <P>
1147:
1148: Here is an example of an <VAR>inputrc</VAR> file. This illustrates key
1149: binding, variable assignment, and conditional syntax.
1150: </P><P>
1151:
1152: <TABLE><tr><td> </td><td class=example><pre># This file controls the behaviour of line input editing for
1153: # programs that use the GNU Readline library. Existing
1154: # programs include FTP, Bash, and GDB.
1155: #
1156: # You can re-read the inputrc file with C-x C-r.
1157: # Lines beginning with '#' are comments.
1158: #
1159: # First, include any system-wide bindings and variable
1160: # assignments from /etc/Inputrc
1161: $include /etc/Inputrc
1162:
1163: #
1164: # Set various bindings for emacs mode.
1165:
1166: set editing-mode emacs
1167:
1168: $if mode=emacs
1169:
1170: Meta-Control-h: backward-kill-word Text after the function name is ignored
1171:
1172: #
1173: # Arrow keys in keypad mode
1174: #
1175: #"\M-OD": backward-char
1176: #"\M-OC": forward-char
1177: #"\M-OA": previous-history
1178: #"\M-OB": next-history
1179: #
1180: # Arrow keys in ANSI mode
1181: #
1182: "\M-[D": backward-char
1183: "\M-[C": forward-char
1184: "\M-[A": previous-history
1185: "\M-[B": next-history
1186: #
1187: # Arrow keys in 8 bit keypad mode
1188: #
1189: #"\M-\C-OD": backward-char
1190: #"\M-\C-OC": forward-char
1191: #"\M-\C-OA": previous-history
1192: #"\M-\C-OB": next-history
1193: #
1194: # Arrow keys in 8 bit ANSI mode
1195: #
1196: #"\M-\C-[D": backward-char
1197: #"\M-\C-[C": forward-char
1198: #"\M-\C-[A": previous-history
1199: #"\M-\C-[B": next-history
1200:
1201: C-q: quoted-insert
1202:
1203: $endif
1204:
1205: # An old-style binding. This happens to be the default.
1206: TAB: complete
1207:
1208: # Macros that are convenient for shell interaction
1209: $if Bash
1210: # edit the path
1211: "\C-xp": "PATH=${PATH}\e\C-e\C-a\ef\C-f"
1212: # prepare to type a quoted word --
1213: # insert open and close double quotes
1214: # and move to just after the open quote
1215: "\C-x\"": "\"\"\C-b"
1216: # insert a backslash (testing backslash escapes
1217: # in sequences and macros)
1218: "\C-x\\": "\\"
1219: # Quote the current or previous word
1220: "\C-xq": "\eb\"\ef\""
1221: # Add a binding to refresh the line, which is unbound
1222: "\C-xr": redraw-current-line
1223: # Edit variable on current line.
1224: "\M-\C-v": "\C-a\C-k$\C-y\M-\C-e\C-a\C-y="
1225: $endif
1226:
1227: # use a visible bell if one is available
1228: set bell-style visible
1229:
1230: # don't strip characters to 7 bits when reading
1231: set input-meta on
1232:
1233: # allow iso-latin1 characters to be inserted rather
1234: # than converted to prefix-meta sequences
1235: set convert-meta off
1236:
1237: # display characters with the eighth bit set directly
1238: # rather than as meta-prefixed characters
1239: set output-meta on
1240:
1241: # if there are more than 150 possible completions for
1242: # a word, ask the user if he wants to see all of them
1243: set completion-query-items 150
1244:
1245: # For FTP
1246: $if Ftp
1247: "\C-xg": "get \M-?"
1248: "\C-xt": "put \M-?"
1249: "\M-.": yank-last-arg
1250: $endif
1251: </pre></td></tr></table></P><P>
1252:
1253: <A NAME="Bindable Readline Commands"></A>
1254: <HR SIZE="6">
1255: <A NAME="SEC13"></A>
1256: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1257: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC12"> < </A>]</TD>
1258: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC14"> > </A>]</TD>
1259: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> << </A>]</TD>
1260: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> Up </A>]</TD>
1261: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1262: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1263: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1264: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1265: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1266: </TR></TABLE>
1267: <H2> 1.4 Bindable Readline Commands </H2>
1268: <!--docid::SEC13::-->
1269: <P>
1270:
1271: <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
1272: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC14">1.4.1 Commands For Moving</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Moving about the line.</TD></TR>
1273: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC15">1.4.2 Commands For Manipulating The History</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Getting at previous lines.</TD></TR>
1274: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC16">1.4.3 Commands For Changing Text</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Commands for changing text.</TD></TR>
1275: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC17">1.4.4 Killing And Yanking</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Commands for killing and yanking.</TD></TR>
1276: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC18">1.4.5 Specifying Numeric Arguments</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Specifying numeric arguments, repeat counts.</TD></TR>
1277: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC19">1.4.6 Letting Readline Type For You</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Getting Readline to do the typing for you.</TD></TR>
1278: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC20">1.4.7 Keyboard Macros</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Saving and re-executing typed characters</TD></TR>
1279: <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="rluserman.html#SEC21">1.4.8 Some Miscellaneous Commands</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Other miscellaneous commands.</TD></TR>
1280: </TABLE></BLOCKQUOTE>
1281: <P>
1282:
1283: This section describes Readline commands that may be bound to key
1284: sequences.
1285: Command names without an accompanying key sequence are unbound by default.
1286: </P><P>
1287:
1288: In the following descriptions, <EM>point</EM> refers to the current cursor
1289: position, and <EM>mark</EM> refers to a cursor position saved by the
1290: <CODE>set-mark</CODE> command.
1291: The text between the point and mark is referred to as the <EM>region</EM>.
1292: </P><P>
1293:
1294: <A NAME="Commands For Moving"></A>
1295: <HR SIZE="6">
1296: <A NAME="SEC14"></A>
1297: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1298: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> < </A>]</TD>
1299: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC15"> > </A>]</TD>
1300: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> << </A>]</TD>
1301: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1302: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1303: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1304: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1305: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1306: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1307: </TR></TABLE>
1308: <H3> 1.4.1 Commands For Moving </H3>
1309: <!--docid::SEC14::-->
1310: <DL COMPACT>
1311: <A NAME="IDX38"></A>
1312: <DT><CODE>beginning-of-line (C-a)</CODE>
1313: <DD><A NAME="IDX39"></A>
1314: Move to the start of the current line.
1315: <P>
1316:
1317: <A NAME="IDX40"></A>
1318: <DT><CODE>end-of-line (C-e)</CODE>
1319: <DD><A NAME="IDX41"></A>
1320: Move to the end of the line.
1321: <P>
1322:
1323: <A NAME="IDX42"></A>
1324: <DT><CODE>forward-char (C-f)</CODE>
1325: <DD><A NAME="IDX43"></A>
1326: Move forward a character.
1327: <P>
1328:
1329: <A NAME="IDX44"></A>
1330: <DT><CODE>backward-char (C-b)</CODE>
1331: <DD><A NAME="IDX45"></A>
1332: Move back a character.
1333: <P>
1334:
1335: <A NAME="IDX46"></A>
1336: <DT><CODE>forward-word (M-f)</CODE>
1337: <DD><A NAME="IDX47"></A>
1338: Move forward to the end of the next word.
1339: Words are composed of letters and digits.
1340: <P>
1341:
1342: <A NAME="IDX48"></A>
1343: <DT><CODE>backward-word (M-b)</CODE>
1344: <DD><A NAME="IDX49"></A>
1345: Move back to the start of the current or previous word.
1346: Words are composed of letters and digits.
1347: <P>
1348:
1349: <A NAME="IDX50"></A>
1350: <DT><CODE>clear-screen (C-l)</CODE>
1351: <DD><A NAME="IDX51"></A>
1352: Clear the screen and redraw the current line,
1353: leaving the current line at the top of the screen.
1354: <P>
1355:
1356: <A NAME="IDX52"></A>
1357: <DT><CODE>redraw-current-line ()</CODE>
1358: <DD><A NAME="IDX53"></A>
1359: Refresh the current line. By default, this is unbound.
1360: <P>
1361:
1362: </DL>
1363: <P>
1364:
1365: <A NAME="Commands For History"></A>
1366: <HR SIZE="6">
1367: <A NAME="SEC15"></A>
1368: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1369: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC14"> < </A>]</TD>
1370: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC16"> > </A>]</TD>
1371: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC16"> << </A>]</TD>
1372: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1373: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1374: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1375: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1376: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1377: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1378: </TR></TABLE>
1379: <H3> 1.4.2 Commands For Manipulating The History </H3>
1380: <!--docid::SEC15::-->
1381: <P>
1382:
1383: <DL COMPACT>
1384: <A NAME="IDX54"></A>
1385: <DT><CODE>accept-line (Newline or Return)</CODE>
1386: <DD><A NAME="IDX55"></A>
1387: Accept the line regardless of where the cursor is.
1388: If this line is
1389: non-empty, it may be added to the history list for future recall with
1390: <CODE>add_history()</CODE>.
1391: If this line is a modified history line, the history line is restored
1392: to its original state.
1393: <P>
1394:
1395: <A NAME="IDX56"></A>
1396: <DT><CODE>previous-history (C-p)</CODE>
1397: <DD><A NAME="IDX57"></A>
1398: Move `back' through the history list, fetching the previous command.
1399: <P>
1400:
1401: <A NAME="IDX58"></A>
1402: <DT><CODE>next-history (C-n)</CODE>
1403: <DD><A NAME="IDX59"></A>
1404: Move `forward' through the history list, fetching the next command.
1405: <P>
1406:
1407: <A NAME="IDX60"></A>
1408: <DT><CODE>beginning-of-history (M-<)</CODE>
1409: <DD><A NAME="IDX61"></A>
1410: Move to the first line in the history.
1411: <P>
1412:
1413: <A NAME="IDX62"></A>
1414: <DT><CODE>end-of-history (M->)</CODE>
1415: <DD><A NAME="IDX63"></A>
1416: Move to the end of the input history, i.e., the line currently
1417: being entered.
1418: <P>
1419:
1420: <A NAME="IDX64"></A>
1421: <DT><CODE>reverse-search-history (C-r)</CODE>
1422: <DD><A NAME="IDX65"></A>
1423: Search backward starting at the current line and moving `up' through
1424: the history as necessary. This is an incremental search.
1425: <P>
1426:
1427: <A NAME="IDX66"></A>
1428: <DT><CODE>forward-search-history (C-s)</CODE>
1429: <DD><A NAME="IDX67"></A>
1430: Search forward starting at the current line and moving `down' through
1431: the the history as necessary. This is an incremental search.
1432: <P>
1433:
1434: <A NAME="IDX68"></A>
1435: <DT><CODE>non-incremental-reverse-search-history (M-p)</CODE>
1436: <DD><A NAME="IDX69"></A>
1437: Search backward starting at the current line and moving `up'
1438: through the history as necessary using a non-incremental search
1439: for a string supplied by the user.
1440: <P>
1441:
1442: <A NAME="IDX70"></A>
1443: <DT><CODE>non-incremental-forward-search-history (M-n)</CODE>
1444: <DD><A NAME="IDX71"></A>
1445: Search forward starting at the current line and moving `down'
1446: through the the history as necessary using a non-incremental search
1447: for a string supplied by the user.
1448: <P>
1449:
1450: <A NAME="IDX72"></A>
1451: <DT><CODE>history-search-forward ()</CODE>
1452: <DD><A NAME="IDX73"></A>
1453: Search forward through the history for the string of characters
1454: between the start of the current line and the point.
1455: The search string must match at the beginning of a history line.
1456: This is a non-incremental search.
1457: By default, this command is unbound.
1458: <P>
1459:
1460: <A NAME="IDX74"></A>
1461: <DT><CODE>history-search-backward ()</CODE>
1462: <DD><A NAME="IDX75"></A>
1463: Search backward through the history for the string of characters
1464: between the start of the current line and the point.
1465: The search string must match at the beginning of a history line.
1466: This is a non-incremental search.
1467: By default, this command is unbound.
1468: <P>
1469:
1470: <A NAME="IDX76"></A>
1471: <DT><CODE>history-substr-search-forward ()</CODE>
1472: <DD><A NAME="IDX77"></A>
1473: Search forward through the history for the string of characters
1474: between the start of the current line and the point.
1475: The search string may match anywhere in a history line.
1476: This is a non-incremental search.
1477: By default, this command is unbound.
1478: <P>
1479:
1480: <A NAME="IDX78"></A>
1481: <DT><CODE>history-substr-search-backward ()</CODE>
1482: <DD><A NAME="IDX79"></A>
1483: Search backward through the history for the string of characters
1484: between the start of the current line and the point.
1485: The search string may match anywhere in a history line.
1486: This is a non-incremental search.
1487: By default, this command is unbound.
1488: <P>
1489:
1490: <A NAME="IDX80"></A>
1491: <DT><CODE>yank-nth-arg (M-C-y)</CODE>
1492: <DD><A NAME="IDX81"></A>
1493: Insert the first argument to the previous command (usually
1494: the second word on the previous line) at point.
1495: With an argument <VAR>n</VAR>,
1496: insert the <VAR>n</VAR>th word from the previous command (the words
1497: in the previous command begin with word 0). A negative argument
1498: inserts the <VAR>n</VAR>th word from the end of the previous command.
1499: Once the argument <VAR>n</VAR> is computed, the argument is extracted
1500: as if the <SAMP>`!<VAR>n</VAR>'</SAMP> history expansion had been specified.
1501: <P>
1502:
1503: <A NAME="IDX82"></A>
1504: <DT><CODE>yank-last-arg (M-. or M-_)</CODE>
1505: <DD><A NAME="IDX83"></A>
1506: Insert last argument to the previous command (the last word of the
1507: previous history entry).
1508: With a numeric argument, behave exactly like <CODE>yank-nth-arg</CODE>.
1509: Successive calls to <CODE>yank-last-arg</CODE> move back through the history
1510: list, inserting the last word (or the word specified by the argument to
1511: the first call) of each line in turn.
1512: Any numeric argument supplied to these successive calls determines
1513: the direction to move through the history. A negative argument switches
1514: the direction through the history (back or forward).
1515: The history expansion facilities are used to extract the last argument,
1516: as if the <SAMP>`!$'</SAMP> history expansion had been specified.
1517: <P>
1518:
1519: </DL>
1520: <P>
1521:
1522: <A NAME="Commands For Text"></A>
1523: <HR SIZE="6">
1524: <A NAME="SEC16"></A>
1525: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1526: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC15"> < </A>]</TD>
1527: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC17"> > </A>]</TD>
1528: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC17"> << </A>]</TD>
1529: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1530: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1531: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1532: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1533: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1534: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1535: </TR></TABLE>
1536: <H3> 1.4.3 Commands For Changing Text </H3>
1537: <!--docid::SEC16::-->
1538: <P>
1539:
1540: <DL COMPACT>
1541:
1542: <A NAME="IDX84"></A>
1543: <DT><CODE><I>end-of-file</I> (usually C-d)</CODE>
1544: <DD><A NAME="IDX85"></A>
1545: The character indicating end-of-file as set, for example, by
1546: <CODE>stty</CODE>. If this character is read when there are no characters
1547: on the line, and point is at the beginning of the line, Readline
1548: interprets it as the end of input and returns EOF.
1549: <P>
1550:
1551: <A NAME="IDX86"></A>
1552: <DT><CODE>delete-char (C-d)</CODE>
1553: <DD><A NAME="IDX87"></A>
1554: Delete the character at point. If this function is bound to the
1555: same character as the tty EOF character, as <KBD>C-d</KBD>
1556: commonly is, see above for the effects.
1557: <P>
1558:
1559: <A NAME="IDX88"></A>
1560: <DT><CODE>backward-delete-char (Rubout)</CODE>
1561: <DD><A NAME="IDX89"></A>
1562: Delete the character behind the cursor. A numeric argument means
1563: to kill the characters instead of deleting them.
1564: <P>
1565:
1566: <A NAME="IDX90"></A>
1567: <DT><CODE>forward-backward-delete-char ()</CODE>
1568: <DD><A NAME="IDX91"></A>
1569: Delete the character under the cursor, unless the cursor is at the
1570: end of the line, in which case the character behind the cursor is
1571: deleted. By default, this is not bound to a key.
1572: <P>
1573:
1574: <A NAME="IDX92"></A>
1575: <DT><CODE>quoted-insert (C-q or C-v)</CODE>
1576: <DD><A NAME="IDX93"></A>
1577: Add the next character typed to the line verbatim. This is
1578: how to insert key sequences like <KBD>C-q</KBD>, for example.
1579: <P>
1580:
1581: <A NAME="IDX94"></A>
1582: <DT><CODE>tab-insert (M-<KBD>TAB</KBD>)</CODE>
1583: <DD><A NAME="IDX95"></A>
1584: Insert a tab character.
1585: <P>
1586:
1587: <A NAME="IDX96"></A>
1588: <DT><CODE>self-insert (a, b, A, 1, !, <small>...</small>)</CODE>
1589: <DD><A NAME="IDX97"></A>
1590: Insert yourself.
1591: <P>
1592:
1593: <A NAME="IDX98"></A>
1594: <DT><CODE>transpose-chars (C-t)</CODE>
1595: <DD><A NAME="IDX99"></A>
1596: Drag the character before the cursor forward over
1597: the character at the cursor, moving the
1598: cursor forward as well. If the insertion point
1599: is at the end of the line, then this
1600: transposes the last two characters of the line.
1601: Negative arguments have no effect.
1602: <P>
1603:
1604: <A NAME="IDX100"></A>
1605: <DT><CODE>transpose-words (M-t)</CODE>
1606: <DD><A NAME="IDX101"></A>
1607: Drag the word before point past the word after point,
1608: moving point past that word as well.
1609: If the insertion point is at the end of the line, this transposes
1610: the last two words on the line.
1611: <P>
1612:
1613: <A NAME="IDX102"></A>
1614: <DT><CODE>upcase-word (M-u)</CODE>
1615: <DD><A NAME="IDX103"></A>
1616: Uppercase the current (or following) word. With a negative argument,
1617: uppercase the previous word, but do not move the cursor.
1618: <P>
1619:
1620: <A NAME="IDX104"></A>
1621: <DT><CODE>downcase-word (M-l)</CODE>
1622: <DD><A NAME="IDX105"></A>
1623: Lowercase the current (or following) word. With a negative argument,
1624: lowercase the previous word, but do not move the cursor.
1625: <P>
1626:
1627: <A NAME="IDX106"></A>
1628: <DT><CODE>capitalize-word (M-c)</CODE>
1629: <DD><A NAME="IDX107"></A>
1630: Capitalize the current (or following) word. With a negative argument,
1631: capitalize the previous word, but do not move the cursor.
1632: <P>
1633:
1634: <A NAME="IDX108"></A>
1635: <DT><CODE>overwrite-mode ()</CODE>
1636: <DD><A NAME="IDX109"></A>
1637: Toggle overwrite mode. With an explicit positive numeric argument,
1638: switches to overwrite mode. With an explicit non-positive numeric
1639: argument, switches to insert mode. This command affects only
1640: <CODE>emacs</CODE> mode; <CODE>vi</CODE> mode does overwrite differently.
1641: Each call to <CODE>readline()</CODE> starts in insert mode.
1642: <P>
1643:
1644: In overwrite mode, characters bound to <CODE>self-insert</CODE> replace
1645: the text at point rather than pushing the text to the right.
1646: Characters bound to <CODE>backward-delete-char</CODE> replace the character
1647: before point with a space.
1648: </P><P>
1649:
1650: By default, this command is unbound.
1651: </P><P>
1652:
1653: </DL>
1654: <P>
1655:
1656: <A NAME="Commands For Killing"></A>
1657: <HR SIZE="6">
1658: <A NAME="SEC17"></A>
1659: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1660: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC16"> < </A>]</TD>
1661: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC18"> > </A>]</TD>
1662: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC18"> << </A>]</TD>
1663: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1664: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1665: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1666: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1667: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1668: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1669: </TR></TABLE>
1670: <H3> 1.4.4 Killing And Yanking </H3>
1671: <!--docid::SEC17::-->
1672: <P>
1673:
1674: <DL COMPACT>
1675:
1676: <A NAME="IDX110"></A>
1677: <DT><CODE>kill-line (C-k)</CODE>
1678: <DD><A NAME="IDX111"></A>
1679: Kill the text from point to the end of the line.
1680: <P>
1681:
1682: <A NAME="IDX112"></A>
1683: <DT><CODE>backward-kill-line (C-x Rubout)</CODE>
1684: <DD><A NAME="IDX113"></A>
1685: Kill backward to the beginning of the line.
1686: <P>
1687:
1688: <A NAME="IDX114"></A>
1689: <DT><CODE>unix-line-discard (C-u)</CODE>
1690: <DD><A NAME="IDX115"></A>
1691: Kill backward from the cursor to the beginning of the current line.
1692: <P>
1693:
1694: <A NAME="IDX116"></A>
1695: <DT><CODE>kill-whole-line ()</CODE>
1696: <DD><A NAME="IDX117"></A>
1697: Kill all characters on the current line, no matter where point is.
1698: By default, this is unbound.
1699: <P>
1700:
1701: <A NAME="IDX118"></A>
1702: <DT><CODE>kill-word (M-d)</CODE>
1703: <DD><A NAME="IDX119"></A>
1704: Kill from point to the end of the current word, or if between
1705: words, to the end of the next word.
1706: Word boundaries are the same as <CODE>forward-word</CODE>.
1707: <P>
1708:
1709: <A NAME="IDX120"></A>
1710: <DT><CODE>backward-kill-word (M-<KBD>DEL</KBD>)</CODE>
1711: <DD><A NAME="IDX121"></A>
1712: Kill the word behind point.
1713: Word boundaries are the same as <CODE>backward-word</CODE>.
1714: <P>
1715:
1716: <A NAME="IDX122"></A>
1717: <DT><CODE>unix-word-rubout (C-w)</CODE>
1718: <DD><A NAME="IDX123"></A>
1719: Kill the word behind point, using white space as a word boundary.
1720: The killed text is saved on the kill-ring.
1721: <P>
1722:
1723: <A NAME="IDX124"></A>
1724: <DT><CODE>unix-filename-rubout ()</CODE>
1725: <DD><A NAME="IDX125"></A>
1726: Kill the word behind point, using white space and the slash character
1727: as the word boundaries.
1728: The killed text is saved on the kill-ring.
1729: <P>
1730:
1731: <A NAME="IDX126"></A>
1732: <DT><CODE>delete-horizontal-space ()</CODE>
1733: <DD><A NAME="IDX127"></A>
1734: Delete all spaces and tabs around point. By default, this is unbound.
1735: <P>
1736:
1737: <A NAME="IDX128"></A>
1738: <DT><CODE>kill-region ()</CODE>
1739: <DD><A NAME="IDX129"></A>
1740: Kill the text in the current region.
1741: By default, this command is unbound.
1742: <P>
1743:
1744: <A NAME="IDX130"></A>
1745: <DT><CODE>copy-region-as-kill ()</CODE>
1746: <DD><A NAME="IDX131"></A>
1747: Copy the text in the region to the kill buffer, so it can be yanked
1748: right away. By default, this command is unbound.
1749: <P>
1750:
1751: <A NAME="IDX132"></A>
1752: <DT><CODE>copy-backward-word ()</CODE>
1753: <DD><A NAME="IDX133"></A>
1754: Copy the word before point to the kill buffer.
1755: The word boundaries are the same as <CODE>backward-word</CODE>.
1756: By default, this command is unbound.
1757: <P>
1758:
1759: <A NAME="IDX134"></A>
1760: <DT><CODE>copy-forward-word ()</CODE>
1761: <DD><A NAME="IDX135"></A>
1762: Copy the word following point to the kill buffer.
1763: The word boundaries are the same as <CODE>forward-word</CODE>.
1764: By default, this command is unbound.
1765: <P>
1766:
1767: <A NAME="IDX136"></A>
1768: <DT><CODE>yank (C-y)</CODE>
1769: <DD><A NAME="IDX137"></A>
1770: Yank the top of the kill ring into the buffer at point.
1771: <P>
1772:
1773: <A NAME="IDX138"></A>
1774: <DT><CODE>yank-pop (M-y)</CODE>
1775: <DD><A NAME="IDX139"></A>
1776: Rotate the kill-ring, and yank the new top. You can only do this if
1777: the prior command is <CODE>yank</CODE> or <CODE>yank-pop</CODE>.
1778: </DL>
1779: <P>
1780:
1781: <A NAME="Numeric Arguments"></A>
1782: <HR SIZE="6">
1783: <A NAME="SEC18"></A>
1784: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1785: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC17"> < </A>]</TD>
1786: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC19"> > </A>]</TD>
1787: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC19"> << </A>]</TD>
1788: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1789: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1790: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1791: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1792: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1793: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1794: </TR></TABLE>
1795: <H3> 1.4.5 Specifying Numeric Arguments </H3>
1796: <!--docid::SEC18::-->
1797: <DL COMPACT>
1798:
1799: <A NAME="IDX140"></A>
1800: <DT><CODE>digit-argument (<KBD>M-0</KBD>, <KBD>M-1</KBD>, <small>...</small> <KBD>M--</KBD>)</CODE>
1801: <DD><A NAME="IDX141"></A>
1802: Add this digit to the argument already accumulating, or start a new
1803: argument. <KBD>M--</KBD> starts a negative argument.
1804: <P>
1805:
1806: <A NAME="IDX142"></A>
1807: <DT><CODE>universal-argument ()</CODE>
1808: <DD><A NAME="IDX143"></A>
1809: This is another way to specify an argument.
1810: If this command is followed by one or more digits, optionally with a
1811: leading minus sign, those digits define the argument.
1812: If the command is followed by digits, executing <CODE>universal-argument</CODE>
1813: again ends the numeric argument, but is otherwise ignored.
1814: As a special case, if this command is immediately followed by a
1815: character that is neither a digit or minus sign, the argument count
1816: for the next command is multiplied by four.
1817: The argument count is initially one, so executing this function the
1818: first time makes the argument count four, a second time makes the
1819: argument count sixteen, and so on.
1820: By default, this is not bound to a key.
1821: </DL>
1822: <P>
1823:
1824: <A NAME="Commands For Completion"></A>
1825: <HR SIZE="6">
1826: <A NAME="SEC19"></A>
1827: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1828: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC18"> < </A>]</TD>
1829: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC20"> > </A>]</TD>
1830: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC20"> << </A>]</TD>
1831: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1832: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1833: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1834: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1835: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1836: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1837: </TR></TABLE>
1838: <H3> 1.4.6 Letting Readline Type For You </H3>
1839: <!--docid::SEC19::-->
1840: <P>
1841:
1842: <DL COMPACT>
1843: <A NAME="IDX144"></A>
1844: <DT><CODE>complete (<KBD>TAB</KBD>)</CODE>
1845: <DD><A NAME="IDX145"></A>
1846: Attempt to perform completion on the text before point.
1847: The actual completion performed is application-specific.
1848: The default is filename completion.
1849: <P>
1850:
1851: <A NAME="IDX146"></A>
1852: <DT><CODE>possible-completions (M-?)</CODE>
1853: <DD><A NAME="IDX147"></A>
1854: List the possible completions of the text before point.
1855: When displaying completions, Readline sets the number of columns used
1856: for display to the value of <CODE>completion-display-width</CODE>, the value of
1857: the environment variable <CODE>COLUMNS</CODE>, or the screen width, in that order.
1858: <P>
1859:
1860: <A NAME="IDX148"></A>
1861: <DT><CODE>insert-completions (M-*)</CODE>
1862: <DD><A NAME="IDX149"></A>
1863: Insert all completions of the text before point that would have
1864: been generated by <CODE>possible-completions</CODE>.
1865: <P>
1866:
1867: <A NAME="IDX150"></A>
1868: <DT><CODE>menu-complete ()</CODE>
1869: <DD><A NAME="IDX151"></A>
1870: Similar to <CODE>complete</CODE>, but replaces the word to be completed
1871: with a single match from the list of possible completions.
1872: Repeated execution of <CODE>menu-complete</CODE> steps through the list
1873: of possible completions, inserting each match in turn.
1874: At the end of the list of completions, the bell is rung
1875: (subject to the setting of <CODE>bell-style</CODE>)
1876: and the original text is restored.
1877: An argument of <VAR>n</VAR> moves <VAR>n</VAR> positions forward in the list
1878: of matches; a negative argument may be used to move backward
1879: through the list.
1880: This command is intended to be bound to <KBD>TAB</KBD>, but is unbound
1881: by default.
1882: <P>
1883:
1884: <A NAME="IDX152"></A>
1885: <DT><CODE>menu-complete-backward ()</CODE>
1886: <DD><A NAME="IDX153"></A>
1887: Identical to <CODE>menu-complete</CODE>, but moves backward through the list
1888: of possible completions, as if <CODE>menu-complete</CODE> had been given a
1889: negative argument.
1890: <P>
1891:
1892: <A NAME="IDX154"></A>
1893: <DT><CODE>delete-char-or-list ()</CODE>
1894: <DD><A NAME="IDX155"></A>
1895: Deletes the character under the cursor if not at the beginning or
1896: end of the line (like <CODE>delete-char</CODE>).
1897: If at the end of the line, behaves identically to
1898: <CODE>possible-completions</CODE>.
1899: This command is unbound by default.
1900: <P>
1901:
1902: </DL>
1903: <P>
1904:
1905: <A NAME="Keyboard Macros"></A>
1906: <HR SIZE="6">
1907: <A NAME="SEC20"></A>
1908: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1909: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC19"> < </A>]</TD>
1910: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC21"> > </A>]</TD>
1911: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC21"> << </A>]</TD>
1912: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1913: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1914: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1915: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1916: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1917: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1918: </TR></TABLE>
1919: <H3> 1.4.7 Keyboard Macros </H3>
1920: <!--docid::SEC20::-->
1921: <DL COMPACT>
1922:
1923: <A NAME="IDX156"></A>
1924: <DT><CODE>start-kbd-macro (C-x ()</CODE>
1925: <DD><A NAME="IDX157"></A>
1926: Begin saving the characters typed into the current keyboard macro.
1927: <P>
1928:
1929: <A NAME="IDX158"></A>
1930: <DT><CODE>end-kbd-macro (C-x ))</CODE>
1931: <DD><A NAME="IDX159"></A>
1932: Stop saving the characters typed into the current keyboard macro
1933: and save the definition.
1934: <P>
1935:
1936: <A NAME="IDX160"></A>
1937: <DT><CODE>call-last-kbd-macro (C-x e)</CODE>
1938: <DD><A NAME="IDX161"></A>
1939: Re-execute the last keyboard macro defined, by making the characters
1940: in the macro appear as if typed at the keyboard.
1941: <P>
1942:
1943: <A NAME="IDX162"></A>
1944: <DT><CODE>print-last-kbd-macro ()</CODE>
1945: <DD><A NAME="IDX163"></A>
1946: Print the last keboard macro defined in a format suitable for the
1947: <VAR>inputrc</VAR> file.
1948: <P>
1949:
1950: </DL>
1951: <P>
1952:
1953: <A NAME="Miscellaneous Commands"></A>
1954: <HR SIZE="6">
1955: <A NAME="SEC21"></A>
1956: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1957: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC20"> < </A>]</TD>
1958: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> > </A>]</TD>
1959: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> << </A>]</TD>
1960: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC13"> Up </A>]</TD>
1961: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> >> </A>]</TD>
1962: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
1963: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
1964: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
1965: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
1966: </TR></TABLE>
1967: <H3> 1.4.8 Some Miscellaneous Commands </H3>
1968: <!--docid::SEC21::-->
1969: <DL COMPACT>
1970:
1971: <A NAME="IDX164"></A>
1972: <DT><CODE>re-read-init-file (C-x C-r)</CODE>
1973: <DD><A NAME="IDX165"></A>
1974: Read in the contents of the <VAR>inputrc</VAR> file, and incorporate
1975: any bindings or variable assignments found there.
1976: <P>
1977:
1978: <A NAME="IDX166"></A>
1979: <DT><CODE>abort (C-g)</CODE>
1980: <DD><A NAME="IDX167"></A>
1981: Abort the current editing command and
1982: ring the terminal's bell (subject to the setting of
1983: <CODE>bell-style</CODE>).
1984: <P>
1985:
1986: <A NAME="IDX168"></A>
1987: <DT><CODE>do-uppercase-version (M-a, M-b, M-<VAR>x</VAR>, <small>...</small>)</CODE>
1988: <DD><A NAME="IDX169"></A>
1989: If the metafied character <VAR>x</VAR> is lowercase, run the command
1990: that is bound to the corresponding uppercase character.
1991: <P>
1992:
1993: <A NAME="IDX170"></A>
1994: <DT><CODE>prefix-meta (<KBD>ESC</KBD>)</CODE>
1995: <DD><A NAME="IDX171"></A>
1996: Metafy the next character typed. This is for keyboards
1997: without a meta key. Typing <SAMP>`<KBD>ESC</KBD> f'</SAMP> is equivalent to typing
1998: <KBD>M-f</KBD>.
1999: <P>
2000:
2001: <A NAME="IDX172"></A>
2002: <DT><CODE>undo (C-_ or C-x C-u)</CODE>
2003: <DD><A NAME="IDX173"></A>
2004: Incremental undo, separately remembered for each line.
2005: <P>
2006:
2007: <A NAME="IDX174"></A>
2008: <DT><CODE>revert-line (M-r)</CODE>
2009: <DD><A NAME="IDX175"></A>
2010: Undo all changes made to this line. This is like executing the <CODE>undo</CODE>
2011: command enough times to get back to the beginning.
2012: <P>
2013:
2014: <A NAME="IDX176"></A>
2015: <DT><CODE>tilde-expand (M-~)</CODE>
2016: <DD><A NAME="IDX177"></A>
2017: Perform tilde expansion on the current word.
2018: <P>
2019:
2020: <A NAME="IDX178"></A>
2021: <DT><CODE>set-mark (C-@)</CODE>
2022: <DD><A NAME="IDX179"></A>
2023: Set the mark to the point. If a
2024: numeric argument is supplied, the mark is set to that position.
2025: <P>
2026:
2027: <A NAME="IDX180"></A>
2028: <DT><CODE>exchange-point-and-mark (C-x C-x)</CODE>
2029: <DD><A NAME="IDX181"></A>
2030: Swap the point with the mark. The current cursor position is set to
2031: the saved position, and the old cursor position is saved as the mark.
2032: <P>
2033:
2034: <A NAME="IDX182"></A>
2035: <DT><CODE>character-search (C-])</CODE>
2036: <DD><A NAME="IDX183"></A>
2037: A character is read and point is moved to the next occurrence of that
2038: character. A negative count searches for previous occurrences.
2039: <P>
2040:
2041: <A NAME="IDX184"></A>
2042: <DT><CODE>character-search-backward (M-C-])</CODE>
2043: <DD><A NAME="IDX185"></A>
2044: A character is read and point is moved to the previous occurrence
2045: of that character. A negative count searches for subsequent
2046: occurrences.
2047: <P>
2048:
2049: <A NAME="IDX186"></A>
2050: <DT><CODE>skip-csi-sequence ()</CODE>
2051: <DD><A NAME="IDX187"></A>
2052: Read enough characters to consume a multi-key sequence such as those
2053: defined for keys like Home and End. Such sequences begin with a
2054: Control Sequence Indicator (CSI), usually ESC-[. If this sequence is
2055: bound to "\e[", keys producing such sequences will have no effect
2056: unless explicitly bound to a readline command, instead of inserting
2057: stray characters into the editing buffer. This is unbound by default,
2058: but usually bound to ESC-[.
2059: <P>
2060:
2061: <A NAME="IDX188"></A>
2062: <DT><CODE>insert-comment (M-#)</CODE>
2063: <DD><A NAME="IDX189"></A>
2064: Without a numeric argument, the value of the <CODE>comment-begin</CODE>
2065: variable is inserted at the beginning of the current line.
2066: If a numeric argument is supplied, this command acts as a toggle: if
2067: the characters at the beginning of the line do not match the value
2068: of <CODE>comment-begin</CODE>, the value is inserted, otherwise
2069: the characters in <CODE>comment-begin</CODE> are deleted from the beginning of
2070: the line.
2071: In either case, the line is accepted as if a newline had been typed.
2072: <P>
2073:
2074: <A NAME="IDX190"></A>
2075: <DT><CODE>dump-functions ()</CODE>
2076: <DD><A NAME="IDX191"></A>
2077: Print all of the functions and their key bindings to the
2078: Readline output stream. If a numeric argument is supplied,
2079: the output is formatted in such a way that it can be made part
2080: of an <VAR>inputrc</VAR> file. This command is unbound by default.
2081: <P>
2082:
2083: <A NAME="IDX192"></A>
2084: <DT><CODE>dump-variables ()</CODE>
2085: <DD><A NAME="IDX193"></A>
2086: Print all of the settable variables and their values to the
2087: Readline output stream. If a numeric argument is supplied,
2088: the output is formatted in such a way that it can be made part
2089: of an <VAR>inputrc</VAR> file. This command is unbound by default.
2090: <P>
2091:
2092: <A NAME="IDX194"></A>
2093: <DT><CODE>dump-macros ()</CODE>
2094: <DD><A NAME="IDX195"></A>
2095: Print all of the Readline key sequences bound to macros and the
2096: strings they output. If a numeric argument is supplied,
2097: the output is formatted in such a way that it can be made part
2098: of an <VAR>inputrc</VAR> file. This command is unbound by default.
2099: <P>
2100:
2101: <A NAME="IDX196"></A>
2102: <DT><CODE>emacs-editing-mode (C-e)</CODE>
2103: <DD><A NAME="IDX197"></A>
2104: When in <CODE>vi</CODE> command mode, this causes a switch to <CODE>emacs</CODE>
2105: editing mode.
2106: <P>
2107:
2108: <A NAME="IDX198"></A>
2109: <DT><CODE>vi-editing-mode (M-C-j)</CODE>
2110: <DD><A NAME="IDX199"></A>
2111: When in <CODE>emacs</CODE> editing mode, this causes a switch to <CODE>vi</CODE>
2112: editing mode.
2113: <P>
2114:
2115: </DL>
2116: <P>
2117:
2118: <A NAME="Readline vi Mode"></A>
2119: <HR SIZE="6">
2120: <A NAME="SEC22"></A>
2121: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2122: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC21"> < </A>]</TD>
2123: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC23"> > </A>]</TD>
2124: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
2125: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> Up </A>]</TD>
2126: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC23"> >> </A>]</TD>
2127: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
2128: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
2129: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
2130: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
2131: </TR></TABLE>
2132: <H2> 1.5 Readline vi Mode </H2>
2133: <!--docid::SEC22::-->
2134: <P>
2135:
2136: While the Readline library does not have a full set of <CODE>vi</CODE>
2137: editing functions, it does contain enough to allow simple editing
2138: of the line. The Readline <CODE>vi</CODE> mode behaves as specified in
2139: the POSIX standard.
2140: </P><P>
2141:
2142: In order to switch interactively between <CODE>emacs</CODE> and <CODE>vi</CODE>
2143: editing modes, use the command <KBD>M-C-j</KBD> (bound to emacs-editing-mode
2144: when in <CODE>vi</CODE> mode and to vi-editing-mode in <CODE>emacs</CODE> mode).
2145: The Readline default is <CODE>emacs</CODE> mode.
2146: </P><P>
2147:
2148: When you enter a line in <CODE>vi</CODE> mode, you are already placed in
2149: `insertion' mode, as if you had typed an <SAMP>`i'</SAMP>. Pressing <KBD>ESC</KBD>
2150: switches you into `command' mode, where you can edit the text of the
2151: line with the standard <CODE>vi</CODE> movement keys, move to previous
2152: history lines with <SAMP>`k'</SAMP> and subsequent lines with <SAMP>`j'</SAMP>, and
2153: so forth.
2154: </P><P>
2155:
2156: <A NAME="GNU Free Documentation License"></A>
2157: <HR SIZE="6">
2158: <A NAME="SEC23"></A>
2159: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2160: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC22"> < </A>]</TD>
2161: <TD VALIGN="MIDDLE" ALIGN="LEFT">[ > ]</TD>
2162: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC1"> << </A>]</TD>
2163: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top"> Up </A>]</TD>
2164: <TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
2165: <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
2166: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
2167: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
2168: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
2169: </TR></TABLE>
2170: <H1> A. GNU Free Documentation License </H1>
2171: <!--docid::SEC23::-->
2172: <P>
2173:
2174: <center>
2175: Version 1.3, 3 November 2008
2176: </center>
2177: </P><P>
2178:
2179: <TABLE><tr><td> </td><td class=display><pre style="font-family: serif">Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
2180: <A HREF="http://fsf.org/">http://fsf.org/</A>
2181:
2182: Everyone is permitted to copy and distribute verbatim copies
2183: of this license document, but changing it is not allowed.
2184: </pre></td></tr></table></P><P>
2185:
2186: <OL>
2187: <LI>
2188: PREAMBLE
2189: <P>
2190:
2191: The purpose of this License is to make a manual, textbook, or other
2192: functional and useful document <EM>free</EM> in the sense of freedom: to
2193: assure everyone the effective freedom to copy and redistribute it,
2194: with or without modifying it, either commercially or noncommercially.
2195: Secondarily, this License preserves for the author and publisher a way
2196: to get credit for their work, while not being considered responsible
2197: for modifications made by others.
2198: </P><P>
2199:
2200: This License is a kind of "copyleft", which means that derivative
2201: works of the document must themselves be free in the same sense. It
2202: complements the GNU General Public License, which is a copyleft
2203: license designed for free software.
2204: </P><P>
2205:
2206: We have designed this License in order to use it for manuals for free
2207: software, because free software needs free documentation: a free
2208: program should come with manuals providing the same freedoms that the
2209: software does. But this License is not limited to software manuals;
2210: it can be used for any textual work, regardless of subject matter or
2211: whether it is published as a printed book. We recommend this License
2212: principally for works whose purpose is instruction or reference.
2213: </P><P>
2214:
2215: <LI>
2216: APPLICABILITY AND DEFINITIONS
2217: <P>
2218:
2219: This License applies to any manual or other work, in any medium, that
2220: contains a notice placed by the copyright holder saying it can be
2221: distributed under the terms of this License. Such a notice grants a
2222: world-wide, royalty-free license, unlimited in duration, to use that
2223: work under the conditions stated herein. The "Document", below,
2224: refers to any such manual or work. Any member of the public is a
2225: licensee, and is addressed as "you". You accept the license if you
2226: copy, modify or distribute the work in a way requiring permission
2227: under copyright law.
2228: </P><P>
2229:
2230: A "Modified Version" of the Document means any work containing the
2231: Document or a portion of it, either copied verbatim, or with
2232: modifications and/or translated into another language.
2233: </P><P>
2234:
2235: A "Secondary Section" is a named appendix or a front-matter section
2236: of the Document that deals exclusively with the relationship of the
2237: publishers or authors of the Document to the Document's overall
2238: subject (or to related matters) and contains nothing that could fall
2239: directly within that overall subject. (Thus, if the Document is in
2240: part a textbook of mathematics, a Secondary Section may not explain
2241: any mathematics.) The relationship could be a matter of historical
2242: connection with the subject or with related matters, or of legal,
2243: commercial, philosophical, ethical or political position regarding
2244: them.
2245: </P><P>
2246:
2247: The "Invariant Sections" are certain Secondary Sections whose titles
2248: are designated, as being those of Invariant Sections, in the notice
2249: that says that the Document is released under this License. If a
2250: section does not fit the above definition of Secondary then it is not
2251: allowed to be designated as Invariant. The Document may contain zero
2252: Invariant Sections. If the Document does not identify any Invariant
2253: Sections then there are none.
2254: </P><P>
2255:
2256: The "Cover Texts" are certain short passages of text that are listed,
2257: as Front-Cover Texts or Back-Cover Texts, in the notice that says that
2258: the Document is released under this License. A Front-Cover Text may
2259: be at most 5 words, and a Back-Cover Text may be at most 25 words.
2260: </P><P>
2261:
2262: A "Transparent" copy of the Document means a machine-readable copy,
2263: represented in a format whose specification is available to the
2264: general public, that is suitable for revising the document
2265: straightforwardly with generic text editors or (for images composed of
2266: pixels) generic paint programs or (for drawings) some widely available
2267: drawing editor, and that is suitable for input to text formatters or
2268: for automatic translation to a variety of formats suitable for input
2269: to text formatters. A copy made in an otherwise Transparent file
2270: format whose markup, or absence of markup, has been arranged to thwart
2271: or discourage subsequent modification by readers is not Transparent.
2272: An image format is not Transparent if used for any substantial amount
2273: of text. A copy that is not "Transparent" is called "Opaque".
2274: </P><P>
2275:
2276: Examples of suitable formats for Transparent copies include plain
2277: ASCII without markup, Texinfo input format, LaTeX input
2278: format, <FONT SIZE="-1">SGML</FONT> or <FONT SIZE="-1">XML</FONT> using a publicly available
2279: <FONT SIZE="-1">DTD</FONT>, and standard-conforming simple <FONT SIZE="-1">HTML</FONT>,
2280: PostScript or <FONT SIZE="-1">PDF</FONT> designed for human modification. Examples
2281: of transparent image formats include <FONT SIZE="-1">PNG</FONT>, <FONT SIZE="-1">XCF</FONT> and
2282: <FONT SIZE="-1">JPG</FONT>. Opaque formats include proprietary formats that can be
2283: read and edited only by proprietary word processors, <FONT SIZE="-1">SGML</FONT> or
2284: <FONT SIZE="-1">XML</FONT> for which the <FONT SIZE="-1">DTD</FONT> and/or processing tools are
2285: not generally available, and the machine-generated <FONT SIZE="-1">HTML</FONT>,
2286: PostScript or <FONT SIZE="-1">PDF</FONT> produced by some word processors for
2287: output purposes only.
2288: </P><P>
2289:
2290: The "Title Page" means, for a printed book, the title page itself,
2291: plus such following pages as are needed to hold, legibly, the material
2292: this License requires to appear in the title page. For works in
2293: formats which do not have any title page as such, "Title Page" means
2294: the text near the most prominent appearance of the work's title,
2295: preceding the beginning of the body of the text.
2296: </P><P>
2297:
2298: The "publisher" means any person or entity that distributes copies
2299: of the Document to the public.
2300: </P><P>
2301:
2302: A section "Entitled XYZ" means a named subunit of the Document whose
2303: title either is precisely XYZ or contains XYZ in parentheses following
2304: text that translates XYZ in another language. (Here XYZ stands for a
2305: specific section name mentioned below, such as "Acknowledgements",
2306: "Dedications", "Endorsements", or "History".) To "Preserve the Title"
2307: of such a section when you modify the Document means that it remains a
2308: section "Entitled XYZ" according to this definition.
2309: </P><P>
2310:
2311: The Document may include Warranty Disclaimers next to the notice which
2312: states that this License applies to the Document. These Warranty
2313: Disclaimers are considered to be included by reference in this
2314: License, but only as regards disclaiming warranties: any other
2315: implication that these Warranty Disclaimers may have is void and has
2316: no effect on the meaning of this License.
2317: </P><P>
2318:
2319: <LI>
2320: VERBATIM COPYING
2321: <P>
2322:
2323: You may copy and distribute the Document in any medium, either
2324: commercially or noncommercially, provided that this License, the
2325: copyright notices, and the license notice saying this License applies
2326: to the Document are reproduced in all copies, and that you add no other
2327: conditions whatsoever to those of this License. You may not use
2328: technical measures to obstruct or control the reading or further
2329: copying of the copies you make or distribute. However, you may accept
2330: compensation in exchange for copies. If you distribute a large enough
2331: number of copies you must also follow the conditions in section 3.
2332: </P><P>
2333:
2334: You may also lend copies, under the same conditions stated above, and
2335: you may publicly display copies.
2336: </P><P>
2337:
2338: <LI>
2339: COPYING IN QUANTITY
2340: <P>
2341:
2342: If you publish printed copies (or copies in media that commonly have
2343: printed covers) of the Document, numbering more than 100, and the
2344: Document's license notice requires Cover Texts, you must enclose the
2345: copies in covers that carry, clearly and legibly, all these Cover
2346: Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
2347: the back cover. Both covers must also clearly and legibly identify
2348: you as the publisher of these copies. The front cover must present
2349: the full title with all words of the title equally prominent and
2350: visible. You may add other material on the covers in addition.
2351: Copying with changes limited to the covers, as long as they preserve
2352: the title of the Document and satisfy these conditions, can be treated
2353: as verbatim copying in other respects.
2354: </P><P>
2355:
2356: If the required texts for either cover are too voluminous to fit
2357: legibly, you should put the first ones listed (as many as fit
2358: reasonably) on the actual cover, and continue the rest onto adjacent
2359: pages.
2360: </P><P>
2361:
2362: If you publish or distribute Opaque copies of the Document numbering
2363: more than 100, you must either include a machine-readable Transparent
2364: copy along with each Opaque copy, or state in or with each Opaque copy
2365: a computer-network location from which the general network-using
2366: public has access to download using public-standard network protocols
2367: a complete Transparent copy of the Document, free of added material.
2368: If you use the latter option, you must take reasonably prudent steps,
2369: when you begin distribution of Opaque copies in quantity, to ensure
2370: that this Transparent copy will remain thus accessible at the stated
2371: location until at least one year after the last time you distribute an
2372: Opaque copy (directly or through your agents or retailers) of that
2373: edition to the public.
2374: </P><P>
2375:
2376: It is requested, but not required, that you contact the authors of the
2377: Document well before redistributing any large number of copies, to give
2378: them a chance to provide you with an updated version of the Document.
2379: </P><P>
2380:
2381: <LI>
2382: MODIFICATIONS
2383: <P>
2384:
2385: You may copy and distribute a Modified Version of the Document under
2386: the conditions of sections 2 and 3 above, provided that you release
2387: the Modified Version under precisely this License, with the Modified
2388: Version filling the role of the Document, thus licensing distribution
2389: and modification of the Modified Version to whoever possesses a copy
2390: of it. In addition, you must do these things in the Modified Version:
2391: </P><P>
2392:
2393: <OL>
2394: <LI>
2395: Use in the Title Page (and on the covers, if any) a title distinct
2396: from that of the Document, and from those of previous versions
2397: (which should, if there were any, be listed in the History section
2398: of the Document). You may use the same title as a previous version
2399: if the original publisher of that version gives permission.
2400: <P>
2401:
2402: <LI>
2403: List on the Title Page, as authors, one or more persons or entities
2404: responsible for authorship of the modifications in the Modified
2405: Version, together with at least five of the principal authors of the
2406: Document (all of its principal authors, if it has fewer than five),
2407: unless they release you from this requirement.
2408: <P>
2409:
2410: <LI>
2411: State on the Title page the name of the publisher of the
2412: Modified Version, as the publisher.
2413: <P>
2414:
2415: <LI>
2416: Preserve all the copyright notices of the Document.
2417: <P>
2418:
2419: <LI>
2420: Add an appropriate copyright notice for your modifications
2421: adjacent to the other copyright notices.
2422: <P>
2423:
2424: <LI>
2425: Include, immediately after the copyright notices, a license notice
2426: giving the public permission to use the Modified Version under the
2427: terms of this License, in the form shown in the Addendum below.
2428: <P>
2429:
2430: <LI>
2431: Preserve in that license notice the full lists of Invariant Sections
2432: and required Cover Texts given in the Document's license notice.
2433: <P>
2434:
2435: <LI>
2436: Include an unaltered copy of this License.
2437: <P>
2438:
2439: <LI>
2440: Preserve the section Entitled "History", Preserve its Title, and add
2441: to it an item stating at least the title, year, new authors, and
2442: publisher of the Modified Version as given on the Title Page. If
2443: there is no section Entitled "History" in the Document, create one
2444: stating the title, year, authors, and publisher of the Document as
2445: given on its Title Page, then add an item describing the Modified
2446: Version as stated in the previous sentence.
2447: <P>
2448:
2449: <LI>
2450: Preserve the network location, if any, given in the Document for
2451: public access to a Transparent copy of the Document, and likewise
2452: the network locations given in the Document for previous versions
2453: it was based on. These may be placed in the "History" section.
2454: You may omit a network location for a work that was published at
2455: least four years before the Document itself, or if the original
2456: publisher of the version it refers to gives permission.
2457: <P>
2458:
2459: <LI>
2460: For any section Entitled "Acknowledgements" or "Dedications", Preserve
2461: the Title of the section, and preserve in the section all the
2462: substance and tone of each of the contributor acknowledgements and/or
2463: dedications given therein.
2464: <P>
2465:
2466: <LI>
2467: Preserve all the Invariant Sections of the Document,
2468: unaltered in their text and in their titles. Section numbers
2469: or the equivalent are not considered part of the section titles.
2470: <P>
2471:
2472: <LI>
2473: Delete any section Entitled "Endorsements". Such a section
2474: may not be included in the Modified Version.
2475: <P>
2476:
2477: <LI>
2478: Do not retitle any existing section to be Entitled "Endorsements" or
2479: to conflict in title with any Invariant Section.
2480: <P>
2481:
2482: <LI>
2483: Preserve any Warranty Disclaimers.
2484: </OL>
2485: <P>
2486:
2487: If the Modified Version includes new front-matter sections or
2488: appendices that qualify as Secondary Sections and contain no material
2489: copied from the Document, you may at your option designate some or all
2490: of these sections as invariant. To do this, add their titles to the
2491: list of Invariant Sections in the Modified Version's license notice.
2492: These titles must be distinct from any other section titles.
2493: </P><P>
2494:
2495: You may add a section Entitled "Endorsements", provided it contains
2496: nothing but endorsements of your Modified Version by various
2497: parties--for example, statements of peer review or that the text has
2498: been approved by an organization as the authoritative definition of a
2499: standard.
2500: </P><P>
2501:
2502: You may add a passage of up to five words as a Front-Cover Text, and a
2503: passage of up to 25 words as a Back-Cover Text, to the end of the list
2504: of Cover Texts in the Modified Version. Only one passage of
2505: Front-Cover Text and one of Back-Cover Text may be added by (or
2506: through arrangements made by) any one entity. If the Document already
2507: includes a cover text for the same cover, previously added by you or
2508: by arrangement made by the same entity you are acting on behalf of,
2509: you may not add another; but you may replace the old one, on explicit
2510: permission from the previous publisher that added the old one.
2511: </P><P>
2512:
2513: The author(s) and publisher(s) of the Document do not by this License
2514: give permission to use their names for publicity for or to assert or
2515: imply endorsement of any Modified Version.
2516: </P><P>
2517:
2518: <LI>
2519: COMBINING DOCUMENTS
2520: <P>
2521:
2522: You may combine the Document with other documents released under this
2523: License, under the terms defined in section 4 above for modified
2524: versions, provided that you include in the combination all of the
2525: Invariant Sections of all of the original documents, unmodified, and
2526: list them all as Invariant Sections of your combined work in its
2527: license notice, and that you preserve all their Warranty Disclaimers.
2528: </P><P>
2529:
2530: The combined work need only contain one copy of this License, and
2531: multiple identical Invariant Sections may be replaced with a single
2532: copy. If there are multiple Invariant Sections with the same name but
2533: different contents, make the title of each such section unique by
2534: adding at the end of it, in parentheses, the name of the original
2535: author or publisher of that section if known, or else a unique number.
2536: Make the same adjustment to the section titles in the list of
2537: Invariant Sections in the license notice of the combined work.
2538: </P><P>
2539:
2540: In the combination, you must combine any sections Entitled "History"
2541: in the various original documents, forming one section Entitled
2542: "History"; likewise combine any sections Entitled "Acknowledgements",
2543: and any sections Entitled "Dedications". You must delete all
2544: sections Entitled "Endorsements."
2545: </P><P>
2546:
2547: <LI>
2548: COLLECTIONS OF DOCUMENTS
2549: <P>
2550:
2551: You may make a collection consisting of the Document and other documents
2552: released under this License, and replace the individual copies of this
2553: License in the various documents with a single copy that is included in
2554: the collection, provided that you follow the rules of this License for
2555: verbatim copying of each of the documents in all other respects.
2556: </P><P>
2557:
2558: You may extract a single document from such a collection, and distribute
2559: it individually under this License, provided you insert a copy of this
2560: License into the extracted document, and follow this License in all
2561: other respects regarding verbatim copying of that document.
2562: </P><P>
2563:
2564: <LI>
2565: AGGREGATION WITH INDEPENDENT WORKS
2566: <P>
2567:
2568: A compilation of the Document or its derivatives with other separate
2569: and independent documents or works, in or on a volume of a storage or
2570: distribution medium, is called an "aggregate" if the copyright
2571: resulting from the compilation is not used to limit the legal rights
2572: of the compilation's users beyond what the individual works permit.
2573: When the Document is included in an aggregate, this License does not
2574: apply to the other works in the aggregate which are not themselves
2575: derivative works of the Document.
2576: </P><P>
2577:
2578: If the Cover Text requirement of section 3 is applicable to these
2579: copies of the Document, then if the Document is less than one half of
2580: the entire aggregate, the Document's Cover Texts may be placed on
2581: covers that bracket the Document within the aggregate, or the
2582: electronic equivalent of covers if the Document is in electronic form.
2583: Otherwise they must appear on printed covers that bracket the whole
2584: aggregate.
2585: </P><P>
2586:
2587: <LI>
2588: TRANSLATION
2589: <P>
2590:
2591: Translation is considered a kind of modification, so you may
2592: distribute translations of the Document under the terms of section 4.
2593: Replacing Invariant Sections with translations requires special
2594: permission from their copyright holders, but you may include
2595: translations of some or all Invariant Sections in addition to the
2596: original versions of these Invariant Sections. You may include a
2597: translation of this License, and all the license notices in the
2598: Document, and any Warranty Disclaimers, provided that you also include
2599: the original English version of this License and the original versions
2600: of those notices and disclaimers. In case of a disagreement between
2601: the translation and the original version of this License or a notice
2602: or disclaimer, the original version will prevail.
2603: </P><P>
2604:
2605: If a section in the Document is Entitled "Acknowledgements",
2606: "Dedications", or "History", the requirement (section 4) to Preserve
2607: its Title (section 1) will typically require changing the actual
2608: title.
2609: </P><P>
2610:
2611: <LI>
2612: TERMINATION
2613: <P>
2614:
2615: You may not copy, modify, sublicense, or distribute the Document
2616: except as expressly provided under this License. Any attempt
2617: otherwise to copy, modify, sublicense, or distribute it is void, and
2618: will automatically terminate your rights under this License.
2619: </P><P>
2620:
2621: However, if you cease all violation of this License, then your license
2622: from a particular copyright holder is reinstated (a) provisionally,
2623: unless and until the copyright holder explicitly and finally
2624: terminates your license, and (b) permanently, if the copyright holder
2625: fails to notify you of the violation by some reasonable means prior to
2626: 60 days after the cessation.
2627: </P><P>
2628:
2629: Moreover, your license from a particular copyright holder is
2630: reinstated permanently if the copyright holder notifies you of the
2631: violation by some reasonable means, this is the first time you have
2632: received notice of violation of this License (for any work) from that
2633: copyright holder, and you cure the violation prior to 30 days after
2634: your receipt of the notice.
2635: </P><P>
2636:
2637: Termination of your rights under this section does not terminate the
2638: licenses of parties who have received copies or rights from you under
2639: this License. If your rights have been terminated and not permanently
2640: reinstated, receipt of a copy of some or all of the same material does
2641: not give you any rights to use it.
2642: </P><P>
2643:
2644: <LI>
2645: FUTURE REVISIONS OF THIS LICENSE
2646: <P>
2647:
2648: The Free Software Foundation may publish new, revised versions
2649: of the GNU Free Documentation License from time to time. Such new
2650: versions will be similar in spirit to the present version, but may
2651: differ in detail to address new problems or concerns. See
2652: <A HREF="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</A>.
2653: </P><P>
2654:
2655: Each version of the License is given a distinguishing version number.
2656: If the Document specifies that a particular numbered version of this
2657: License "or any later version" applies to it, you have the option of
2658: following the terms and conditions either of that specified version or
2659: of any later version that has been published (not as a draft) by the
2660: Free Software Foundation. If the Document does not specify a version
2661: number of this License, you may choose any version ever published (not
2662: as a draft) by the Free Software Foundation. If the Document
2663: specifies that a proxy can decide which future versions of this
2664: License can be used, that proxy's public statement of acceptance of a
2665: version permanently authorizes you to choose that version for the
2666: Document.
2667: </P><P>
2668:
2669: <LI>
2670: RELICENSING
2671: <P>
2672:
2673: "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
2674: World Wide Web server that publishes copyrightable works and also
2675: provides prominent facilities for anybody to edit those works. A
2676: public wiki that anybody can edit is an example of such a server. A
2677: "Massive Multiauthor Collaboration" (or "MMC") contained in the
2678: site means any set of copyrightable works thus published on the MMC
2679: site.
2680: </P><P>
2681:
2682: "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
2683: license published by Creative Commons Corporation, a not-for-profit
2684: corporation with a principal place of business in San Francisco,
2685: California, as well as future copyleft versions of that license
2686: published by that same organization.
2687: </P><P>
2688:
2689: "Incorporate" means to publish or republish a Document, in whole or
2690: in part, as part of another Document.
2691: </P><P>
2692:
2693: An MMC is "eligible for relicensing" if it is licensed under this
2694: License, and if all works that were first published under this License
2695: somewhere other than this MMC, and subsequently incorporated in whole
2696: or in part into the MMC, (1) had no cover texts or invariant sections,
2697: and (2) were thus incorporated prior to November 1, 2008.
2698: </P><P>
2699:
2700: The operator of an MMC Site may republish an MMC contained in the site
2701: under CC-BY-SA on the same site at any time before August 1, 2009,
2702: provided the MMC is eligible for relicensing.
2703: </P><P>
2704:
2705: </OL>
2706: <P>
2707:
2708: <A NAME="SEC24"></A>
2709: <H2> ADDENDUM: How to use this License for your documents </H2>
2710: <!--docid::SEC24::-->
2711: <P>
2712:
2713: To use this License in a document you have written, include a copy of
2714: the License in the document and put the following copyright and
2715: license notices just after the title page:
2716: </P><P>
2717:
2718: <TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre> Copyright (C) <VAR>year</VAR> <VAR>your name</VAR>.
2719: Permission is granted to copy, distribute and/or modify this document
2720: under the terms of the GNU Free Documentation License, Version 1.3
2721: or any later version published by the Free Software Foundation;
2722: with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
2723: Texts. A copy of the license is included in the section entitled ``GNU
2724: Free Documentation License''.
2725: </FONT></pre></td></tr></table></P><P>
2726:
2727: If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
2728: replace the "with<small>...</small>Texts." line with this:
2729: </P><P>
2730:
2731: <TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre> with the Invariant Sections being <VAR>list their titles</VAR>, with
2732: the Front-Cover Texts being <VAR>list</VAR>, and with the Back-Cover Texts
2733: being <VAR>list</VAR>.
2734: </FONT></pre></td></tr></table></P><P>
2735:
2736: If you have Invariant Sections without Cover Texts, or some other
2737: combination of the three, merge those two alternatives to suit the
2738: situation.
2739: </P><P>
2740:
2741: If your document contains nontrivial examples of program code, we
2742: recommend releasing these examples in parallel under your choice of
2743: free software license, such as the GNU General Public License,
2744: to permit their use in free software.
2745: </P><P>
2746:
2747: <HR SIZE="6">
2748: <A NAME="SEC_Contents"></A>
2749: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2750: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
2751: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
2752: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
2753: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
2754: </TR></TABLE>
2755: <H1>Table of Contents</H1>
2756: <UL>
2757: <A NAME="TOC1" HREF="rluserman.html#SEC1">1. Command Line Editing</A>
2758: <BR>
2759: <UL>
2760: <A NAME="TOC2" HREF="rluserman.html#SEC2">1.1 Introduction to Line Editing</A>
2761: <BR>
2762: <A NAME="TOC3" HREF="rluserman.html#SEC3">1.2 Readline Interaction</A>
2763: <BR>
2764: <UL>
2765: <A NAME="TOC4" HREF="rluserman.html#SEC4">1.2.1 Readline Bare Essentials</A>
2766: <BR>
2767: <A NAME="TOC5" HREF="rluserman.html#SEC5">1.2.2 Readline Movement Commands</A>
2768: <BR>
2769: <A NAME="TOC6" HREF="rluserman.html#SEC6">1.2.3 Readline Killing Commands</A>
2770: <BR>
2771: <A NAME="TOC7" HREF="rluserman.html#SEC7">1.2.4 Readline Arguments</A>
2772: <BR>
2773: <A NAME="TOC8" HREF="rluserman.html#SEC8">1.2.5 Searching for Commands in the History</A>
2774: <BR>
2775: </UL>
2776: <A NAME="TOC9" HREF="rluserman.html#SEC9">1.3 Readline Init File</A>
2777: <BR>
2778: <UL>
2779: <A NAME="TOC10" HREF="rluserman.html#SEC10">1.3.1 Readline Init File Syntax</A>
2780: <BR>
2781: <A NAME="TOC11" HREF="rluserman.html#SEC11">1.3.2 Conditional Init Constructs</A>
2782: <BR>
2783: <A NAME="TOC12" HREF="rluserman.html#SEC12">1.3.3 Sample Init File</A>
2784: <BR>
2785: </UL>
2786: <A NAME="TOC13" HREF="rluserman.html#SEC13">1.4 Bindable Readline Commands</A>
2787: <BR>
2788: <UL>
2789: <A NAME="TOC14" HREF="rluserman.html#SEC14">1.4.1 Commands For Moving</A>
2790: <BR>
2791: <A NAME="TOC15" HREF="rluserman.html#SEC15">1.4.2 Commands For Manipulating The History</A>
2792: <BR>
2793: <A NAME="TOC16" HREF="rluserman.html#SEC16">1.4.3 Commands For Changing Text</A>
2794: <BR>
2795: <A NAME="TOC17" HREF="rluserman.html#SEC17">1.4.4 Killing And Yanking</A>
2796: <BR>
2797: <A NAME="TOC18" HREF="rluserman.html#SEC18">1.4.5 Specifying Numeric Arguments</A>
2798: <BR>
2799: <A NAME="TOC19" HREF="rluserman.html#SEC19">1.4.6 Letting Readline Type For You</A>
2800: <BR>
2801: <A NAME="TOC20" HREF="rluserman.html#SEC20">1.4.7 Keyboard Macros</A>
2802: <BR>
2803: <A NAME="TOC21" HREF="rluserman.html#SEC21">1.4.8 Some Miscellaneous Commands</A>
2804: <BR>
2805: </UL>
2806: <A NAME="TOC22" HREF="rluserman.html#SEC22">1.5 Readline vi Mode</A>
2807: <BR>
2808: </UL>
2809: <A NAME="TOC23" HREF="rluserman.html#SEC23">A. GNU Free Documentation License</A>
2810: <BR>
2811: </UL>
2812: <HR SIZE=1>
2813: <A NAME="SEC_OVERVIEW"></A>
2814: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2815: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
2816: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
2817: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
2818: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
2819: </TR></TABLE>
2820: <H1>Short Table of Contents</H1>
2821: <BLOCKQUOTE>
2822: <A NAME="TOC1" HREF="rluserman.html#SEC1">1. Command Line Editing</A>
2823: <BR>
2824: <A NAME="TOC23" HREF="rluserman.html#SEC23">A. GNU Free Documentation License</A>
2825: <BR>
2826:
2827: </BLOCKQUOTE>
2828: <HR SIZE=1>
2829: <A NAME="SEC_About"></A>
2830: <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2831: <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Top">Top</A>]</TD>
2832: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_Contents">Contents</A>]</TD>
2833: <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
2834: <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
2835: </TR></TABLE>
2836: <H1>About this document</H1>
2837: This document was generated by <I>Chet Ramey</I> on <I>February, 11 2014</I>
2838: using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
2839: "><I>texi2html</I></A>
2840: <P></P>
2841: The buttons in the navigation panels have the following meaning:
2842: <P></P>
2843: <table border = "1">
2844: <TR>
2845: <TH> Button </TH>
2846: <TH> Name </TH>
2847: <TH> Go to </TH>
2848: <TH> From 1.2.3 go to</TH>
2849: </TR>
2850: <TR>
2851: <TD ALIGN="CENTER">
2852: [ < ] </TD>
2853: <TD ALIGN="CENTER">
2854: Back
2855: </TD>
2856: <TD>
2857: previous section in reading order
2858: </TD>
2859: <TD>
2860: 1.2.2
2861: </TD>
2862: </TR>
2863: <TR>
2864: <TD ALIGN="CENTER">
2865: [ > ] </TD>
2866: <TD ALIGN="CENTER">
2867: Forward
2868: </TD>
2869: <TD>
2870: next section in reading order
2871: </TD>
2872: <TD>
2873: 1.2.4
2874: </TD>
2875: </TR>
2876: <TR>
2877: <TD ALIGN="CENTER">
2878: [ << ] </TD>
2879: <TD ALIGN="CENTER">
2880: FastBack
2881: </TD>
2882: <TD>
2883: previous or up-and-previous section
2884: </TD>
2885: <TD>
2886: 1.1
2887: </TD>
2888: </TR>
2889: <TR>
2890: <TD ALIGN="CENTER">
2891: [ Up ] </TD>
2892: <TD ALIGN="CENTER">
2893: Up
2894: </TD>
2895: <TD>
2896: up section
2897: </TD>
2898: <TD>
2899: 1.2
2900: </TD>
2901: </TR>
2902: <TR>
2903: <TD ALIGN="CENTER">
2904: [ >> ] </TD>
2905: <TD ALIGN="CENTER">
2906: FastForward
2907: </TD>
2908: <TD>
2909: next or up-and-next section
2910: </TD>
2911: <TD>
2912: 1.3
2913: </TD>
2914: </TR>
2915: <TR>
2916: <TD ALIGN="CENTER">
2917: [Top] </TD>
2918: <TD ALIGN="CENTER">
2919: Top
2920: </TD>
2921: <TD>
2922: cover (top) of document
2923: </TD>
2924: <TD>
2925:
2926: </TD>
2927: </TR>
2928: <TR>
2929: <TD ALIGN="CENTER">
2930: [Contents] </TD>
2931: <TD ALIGN="CENTER">
2932: Contents
2933: </TD>
2934: <TD>
2935: table of contents
2936: </TD>
2937: <TD>
2938:
2939: </TD>
2940: </TR>
2941: <TR>
2942: <TD ALIGN="CENTER">
2943: [Index] </TD>
2944: <TD ALIGN="CENTER">
2945: Index
2946: </TD>
2947: <TD>
2948: concept index
2949: </TD>
2950: <TD>
2951:
2952: </TD>
2953: </TR>
2954: <TR>
2955: <TD ALIGN="CENTER">
2956: [ ? ] </TD>
2957: <TD ALIGN="CENTER">
2958: About
2959: </TD>
2960: <TD>
2961: this page
2962: </TD>
2963: <TD>
2964:
2965: </TD>
2966: </TR>
2967: </TABLE>
2968: <P></P>
2969: where the <STRONG> Example </STRONG> assumes that the current position
2970: is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of
2971: the following structure:
2972: <UL>
2973: <LI> 1. Section One </LI>
2974: <UL>
2975: <LI>1.1 Subsection One-One</LI>
2976: <UL>
2977: <LI> ... </LI>
2978: </UL>
2979: <LI>1.2 Subsection One-Two</LI>
2980: <UL>
2981: <LI>1.2.1 Subsubsection One-Two-One
2982: </LI><LI>1.2.2 Subsubsection One-Two-Two
2983: </LI><LI>1.2.3 Subsubsection One-Two-Three <STRONG>
2984: <== Current Position </STRONG>
2985: </LI><LI>1.2.4 Subsubsection One-Two-Four
2986: </LI></UL>
2987: <LI>1.3 Subsection One-Three</LI>
2988: <UL>
2989: <LI> ... </LI>
2990: </UL>
2991: <LI>1.4 Subsection One-Four</LI>
2992: </UL>
2993: </UL>
2994:
2995: <HR SIZE=1>
2996: <BR>
2997: <FONT SIZE="-1">
2998: This document was generated
2999: by <I>Chet Ramey</I> on <I>February, 11 2014</I>
3000: using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
3001: "><I>texi2html</I></A>
3002:
3003: </BODY>
3004: </HTML>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to rluserman.html CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / readline / doc