7 .\" to whom the Software is furnished to do so, provided that the above
8 .\" copyright notice(s) and this permission notice appear in all copies of
9 .\" the Software and that both the above copyright notice(s) and this
10 .\" permission notice appear in supporting documentation.
11 .\"
12 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
13 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
15 .\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
16 .\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
17 .\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
18 .\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
19 .\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
20 .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 .\"
22 .\" Except as contained in this notice, the name of a copyright holder
23 .\" shall not be used in advertising or otherwise to promote the sale, use
24 .\" or other dealings in this Software without prior written authorization
25 .\" of the copyright holder.
26 .\" Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
27 .TH TECLA 5 "May 20, 2004"
28 .SH NAME
29 tecla, teclarc \- User interface provided by the tecla library.
30 .SH DESCRIPTION
31 .sp
32 .LP
33 This man page describes the command-line editing features that are available to
34 users of programs that read keyboard input via the tecla library. Users of the
35 \fBtcsh shell\fR will find the default key bindings very familiar. Users of the
36 \fBbash\fR shell will also find it quite familiar, but with a few minor
37 differences, most notably in how forward and backward searches through the list
38 of historical commands are performed. There are two major editing modes, one
39 with \fBemacs\fR-like key bindings and another with \fBvi\fR-like key bindings.
40 By default \fBemacs\fR mode is enabled, but \fBvi\fR(1) mode can alternatively
41 be selected via the user's configuration file. This file can also be used to
42 change the bindings of individual keys to suit the user's preferences. By
43 default, tab completion is provided. If the application hasn't reconfigured
44 this to complete other types of symbols, then tab completion completes file
45 names.
46 .SS "Key Sequence Notation"
47 .sp
969 in \fBvi\fR mode this leaves you in command mode.
970 .RE
971
972 .sp
973 .ne 2
974 .na
975 \fBdigit-argument\fR
976 .ad
977 .RS 30n
978 Enter a repeat count for the next key binding function. For details, see the
979 Entering Repeat Counts section.
980 .RE
981
982 .sp
983 .ne 2
984 .na
985 \fBnewline\fR
986 .ad
987 .RS 30n
988 Terminate and return the current contents of the line, after appending a
989 newline character. The newline character is normally '\n', but will be the
990 first character of the key sequence that invoked the newline action, if this
991 happens to be a printable character. If the action was invoked by the '\n'
992 newline character or the '\r' carriage return character, the line is appended
993 to the history buffer.
994 .RE
995
996 .sp
997 .ne 2
998 .na
999 \fBrepeat-history\fR
1000 .ad
1001 .RS 30n
1002 Return the line that is being edited, then arrange for the next most recent
1003 entry in the history buffer to be recalled when tecla is next called.
1004 Repeatedly invoking this action causes successive historical input lines to be
1005 re-executed. Note that this action is equivalent to the 'Operate' action in
1006 ksh.
1007 .RE
1008
1009 .sp
1010 .ne 2
1011 .na
1012 \fBring-bell\fR
1950 .ne 2
1951 .na
1952 \fB\fBM-<\fR\fR
1953 .ad
1954 .RS 21n
1955 beginning-of-history
1956 .RE
1957
1958 .sp
1959 .ne 2
1960 .na
1961 \fB\fBM->\fR\fR
1962 .ad
1963 .RS 21n
1964 end-of-history
1965 .RE
1966
1967 .sp
1968 .ne 2
1969 .na
1970 \fB\fB\n\fR\fR
1971 .ad
1972 .RS 21n
1973 newline
1974 .RE
1975
1976 .sp
1977 .ne 2
1978 .na
1979 \fB\fB\r\fR\fR
1980 .ad
1981 .RS 21n
1982 newline
1983 .RE
1984
1985 .sp
1986 .ne 2
1987 .na
1988 \fB\fBM-o\fR\fR
1989 .ad
1990 .RS 21n
1991 repeat-history
1992 .RE
1993
1994 .sp
1995 .ne 2
1996 .na
1997 \fB\fBM-^V\fR\fR
1998 .ad
1999 .RS 21n
2220 .ne 2
2221 .na
2222 \fB\fB^H\fR\fR
2223 .ad
2224 .RS 8n
2225 backward-delete-char
2226 .RE
2227
2228 .sp
2229 .ne 2
2230 .na
2231 \fB\fB^I\fR\fR
2232 .ad
2233 .RS 8n
2234 complete-word
2235 .RE
2236
2237 .sp
2238 .ne 2
2239 .na
2240 \fB\fB\r\fR\fR
2241 .ad
2242 .RS 8n
2243 newline
2244 .RE
2245
2246 .sp
2247 .ne 2
2248 .na
2249 \fB\fB\n\fR\fR
2250 .ad
2251 .RS 8n
2252 newline
2253 .RE
2254
2255 .sp
2256 .ne 2
2257 .na
2258 \fB\fB^L\fR\fR
2259 .ad
2260 .RS 8n
2261 clear-screen
2262 .RE
2263
2264 .sp
2265 .ne 2
2266 .na
2267 \fB\fB^N\fR\fR
2268 .ad
2269 .RS 8n
3509 .ne 2
3510 .na
3511 \fB\fBM-^I\fR\fR
3512 .ad
3513 .RS 21n
3514 complete-word
3515 .RE
3516
3517 .sp
3518 .ne 2
3519 .na
3520 \fB\fBM-\r\fR\fR
3521 .ad
3522 .RS 21n
3523 newline
3524 .RE
3525
3526 .sp
3527 .ne 2
3528 .na
3529 \fB\fBM-\n\fR\fR
3530 .ad
3531 .RS 21n
3532 newline
3533 .RE
3534
3535 .sp
3536 .ne 2
3537 .na
3538 \fB\fBM-^X^R\fR\fR
3539 .ad
3540 .RS 21n
3541 read-init-files
3542 .RE
3543
3544 .sp
3545 .ne 2
3546 .na
3547 \fB\fBM-^Xh\fR\fR
3548 .ad
3549 .RS 21n
|
7 .\" to whom the Software is furnished to do so, provided that the above
8 .\" copyright notice(s) and this permission notice appear in all copies of
9 .\" the Software and that both the above copyright notice(s) and this
10 .\" permission notice appear in supporting documentation.
11 .\"
12 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
13 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
15 .\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
16 .\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
17 .\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
18 .\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
19 .\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
20 .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 .\"
22 .\" Except as contained in this notice, the name of a copyright holder
23 .\" shall not be used in advertising or otherwise to promote the sale, use
24 .\" or other dealings in this Software without prior written authorization
25 .\" of the copyright holder.
26 .\" Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
27 .TH TECLA 5 "Sep 10, 2013"
28 .SH NAME
29 tecla, teclarc \- User interface provided by the tecla library.
30 .SH DESCRIPTION
31 .sp
32 .LP
33 This man page describes the command-line editing features that are available to
34 users of programs that read keyboard input via the tecla library. Users of the
35 \fBtcsh shell\fR will find the default key bindings very familiar. Users of the
36 \fBbash\fR shell will also find it quite familiar, but with a few minor
37 differences, most notably in how forward and backward searches through the list
38 of historical commands are performed. There are two major editing modes, one
39 with \fBemacs\fR-like key bindings and another with \fBvi\fR-like key bindings.
40 By default \fBemacs\fR mode is enabled, but \fBvi\fR(1) mode can alternatively
41 be selected via the user's configuration file. This file can also be used to
42 change the bindings of individual keys to suit the user's preferences. By
43 default, tab completion is provided. If the application hasn't reconfigured
44 this to complete other types of symbols, then tab completion completes file
45 names.
46 .SS "Key Sequence Notation"
47 .sp
969 in \fBvi\fR mode this leaves you in command mode.
970 .RE
971
972 .sp
973 .ne 2
974 .na
975 \fBdigit-argument\fR
976 .ad
977 .RS 30n
978 Enter a repeat count for the next key binding function. For details, see the
979 Entering Repeat Counts section.
980 .RE
981
982 .sp
983 .ne 2
984 .na
985 \fBnewline\fR
986 .ad
987 .RS 30n
988 Terminate and return the current contents of the line, after appending a
989 newline character. The newline character is normally '\en', but will be the
990 first character of the key sequence that invoked the newline action, if this
991 happens to be a printable character. If the action was invoked by the '\n'
992 newline character or the '\er' carriage return character, the line is appended
993 to the history buffer.
994 .RE
995
996 .sp
997 .ne 2
998 .na
999 \fBrepeat-history\fR
1000 .ad
1001 .RS 30n
1002 Return the line that is being edited, then arrange for the next most recent
1003 entry in the history buffer to be recalled when tecla is next called.
1004 Repeatedly invoking this action causes successive historical input lines to be
1005 re-executed. Note that this action is equivalent to the 'Operate' action in
1006 ksh.
1007 .RE
1008
1009 .sp
1010 .ne 2
1011 .na
1012 \fBring-bell\fR
1950 .ne 2
1951 .na
1952 \fB\fBM-<\fR\fR
1953 .ad
1954 .RS 21n
1955 beginning-of-history
1956 .RE
1957
1958 .sp
1959 .ne 2
1960 .na
1961 \fB\fBM->\fR\fR
1962 .ad
1963 .RS 21n
1964 end-of-history
1965 .RE
1966
1967 .sp
1968 .ne 2
1969 .na
1970 \fB\fB\en\fR\fR
1971 .ad
1972 .RS 21n
1973 newline
1974 .RE
1975
1976 .sp
1977 .ne 2
1978 .na
1979 \fB\fB\er\fR\fR
1980 .ad
1981 .RS 21n
1982 newline
1983 .RE
1984
1985 .sp
1986 .ne 2
1987 .na
1988 \fB\fBM-o\fR\fR
1989 .ad
1990 .RS 21n
1991 repeat-history
1992 .RE
1993
1994 .sp
1995 .ne 2
1996 .na
1997 \fB\fBM-^V\fR\fR
1998 .ad
1999 .RS 21n
2220 .ne 2
2221 .na
2222 \fB\fB^H\fR\fR
2223 .ad
2224 .RS 8n
2225 backward-delete-char
2226 .RE
2227
2228 .sp
2229 .ne 2
2230 .na
2231 \fB\fB^I\fR\fR
2232 .ad
2233 .RS 8n
2234 complete-word
2235 .RE
2236
2237 .sp
2238 .ne 2
2239 .na
2240 \fB\fB\er\fR\fR
2241 .ad
2242 .RS 8n
2243 newline
2244 .RE
2245
2246 .sp
2247 .ne 2
2248 .na
2249 \fB\fB\en\fR\fR
2250 .ad
2251 .RS 8n
2252 newline
2253 .RE
2254
2255 .sp
2256 .ne 2
2257 .na
2258 \fB\fB^L\fR\fR
2259 .ad
2260 .RS 8n
2261 clear-screen
2262 .RE
2263
2264 .sp
2265 .ne 2
2266 .na
2267 \fB\fB^N\fR\fR
2268 .ad
2269 .RS 8n
3509 .ne 2
3510 .na
3511 \fB\fBM-^I\fR\fR
3512 .ad
3513 .RS 21n
3514 complete-word
3515 .RE
3516
3517 .sp
3518 .ne 2
3519 .na
3520 \fB\fBM-\r\fR\fR
3521 .ad
3522 .RS 21n
3523 newline
3524 .RE
3525
3526 .sp
3527 .ne 2
3528 .na
3529 \fB\fBM-\en\fR\fR
3530 .ad
3531 .RS 21n
3532 newline
3533 .RE
3534
3535 .sp
3536 .ne 2
3537 .na
3538 \fB\fBM-^X^R\fR\fR
3539 .ad
3540 .RS 21n
3541 read-init-files
3542 .RE
3543
3544 .sp
3545 .ne 2
3546 .na
3547 \fB\fBM-^Xh\fR\fR
3548 .ad
3549 .RS 21n
|