1.\" $FreeBSD: head/contrib/libreadline/doc/readline.3 157188 2006-03-27 23:11:32Z ache $ |
2.\" 3.\" MAN PAGE COMMENTS to 4.\" 5.\" Chet Ramey 6.\" Information Network Services 7.\" Case Western Reserve University 8.\" chet@ins.CWRU.Edu 9.\" |
10.\" Last Change: Tue Sep 13 12:07:26 EDT 2005 |
11.\" |
12.TH READLINE 3 "2005 Sep 13" "GNU Readline 5.1-beta1" |
13.\" 14.\" File Name macro. This used to be `.PN', for Path Name, 15.\" but Sun doesn't seem to like that very much. |
16.\" 17.de FN 18\fI\|\\$1\|\fP 19.. 20.SH NAME 21readline \- get a line from a user with editing 22.SH SYNOPSIS 23.LP --- 300 unchanged lines hidden (view full) --- 324\fBset\fP \fIvariable\-name\fP \fIvalue\fP 325.RE 326.PP 327Except where noted, readline variables can take the values 328.B On 329or 330.B Off 331(without regard to case). |
332Unrecognized variable names are ignored. 333When a variable value is read, empty or null values, "on" (case-insensitive), 334and "1" are equivalent to \fBOn\fP. All other values are equivalent to 335\fBOff\fP. |
336The variables and their default values are: 337.PP 338.PD 0 339.TP 340.B bell\-style (audible) 341Controls what happens when readline wants to ring the terminal bell. 342If set to \fBnone\fP, readline never rings the bell. If set to 343\fBvisible\fP, readline uses a visible bell if one is available. 344If set to \fBaudible\fP, readline attempts to ring the terminal's bell. 345.TP |
346.B bind\-tty\-special\-chars (On) 347If set to \fBOn\fP, readline attempts to bind the control characters 348treated specially by the kernel's terminal driver to their readline 349equivalents. 350.TP |
351.B comment\-begin (``#'') 352The string that is inserted in \fBvi\fP mode when the 353.B insert\-comment 354command is executed. 355This command is bound to 356.B M\-# 357in emacs mode and to 358.B # --- 6 unchanged lines hidden (view full) --- 365.B completion\-query\-items (100) 366This determines when the user is queried about viewing 367the number of possible completions 368generated by the \fBpossible\-completions\fP command. 369It may be set to any integer value greater than or equal to 370zero. If the number of possible completions is greater than 371or equal to the value of this variable, the user is asked whether 372or not he wishes to view them; otherwise they are simply listed |
373on the terminal. A negative value causes readline to never ask. |
374.TP 375.B convert\-meta (On) 376If set to \fBOn\fP, readline will convert characters with the 377eighth bit set to an ASCII key sequence 378by stripping the eighth bit and prefixing it with an 379escape character (in effect, using escape as the \fImeta prefix\fP). 380.TP 381.B disable\-completion (Off) --- 14 unchanged lines hidden (view full) --- 396When set to \fBOn\fP, readline will try to enable the application 397keypad when it is called. Some systems need this to enable the 398arrow keys. 399.TP 400.B expand\-tilde (Off) 401If set to \fBon\fP, tilde expansion is performed when readline 402attempts word completion. 403.TP |
404.B history\-preserve\-point (Off) |
405If set to \fBon\fP, the history code attempts to place point at the |
406same location on each history line retrieved with \fBprevious-history\fP |
407or \fBnext-history\fP. 408.TP 409.B horizontal\-scroll\-mode (Off) 410When set to \fBOn\fP, makes readline use a single line for display, 411scrolling the input horizontally on a single screen line when it 412becomes longer than the screen width rather than wrapping to a new line. 413.TP 414.B input\-meta (Off) --- 281 unchanged lines hidden (view full) --- 696.B yank\-nth\-arg (M\-C\-y) 697Insert the first argument to the previous command (usually 698the second word on the previous line) at point. 699With an argument 700.IR n , 701insert the \fIn\fPth word from the previous command (the words 702in the previous command begin with word 0). A negative argument 703inserts the \fIn\fPth word from the end of the previous command. |
704Once the argument \fIn\fP is computed, the argument is extracted 705as if the "!\fIn\fP" history expansion had been specified. |
706.TP 707.B 708yank\-last\-arg (M\-.\^, M\-_\^) 709Insert the last argument to the previous command (the last word of 710the previous history entry). With an argument, 711behave exactly like \fByank\-nth\-arg\fP. 712Successive calls to \fByank\-last\-arg\fP move back through the history 713list, inserting the last argument of each line in turn. |
714The history expansion facilities are used to extract the last argument, 715as if the "!$" history expansion had been specified. |
716.PD 717.SS Commands for Changing Text 718.PP 719.PD 0 720.TP 721.B delete\-char (C\-d) 722Delete the character at point. If point is at the 723beginning of the line, there are no characters in the line, and --- 578 unchanged lines hidden --- |