1 '\" te

     2 .\" Copyright (c) 2000, 2001, 2002, 2003, 2004 by Martin C. Shepherd. All Rights Reserved.

     3 .\" Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation.  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.  Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

     4 .\" Portions Copyright (c) 2013, 2000, Oracle and/or its affiliates. All rights reserved.

     5 .TH tecla 5 "20 May 2004" "SunOS 5.12" "Standards, Environments, and Macros"

     6 .SH NAME

     7 tecla, teclarc \- User interface provided by the tecla library.

     8 .SH DESCRIPTION

     9 .sp

    10 .LP

    11 This man page describes the command-line editing features that are available to users of programs that read keyboard input via the tecla library. Users of the \fBtcsh shell\fR will find the default key bindings very familiar. Users of the \fBbash\fR shell will also find it quite familiar, but with a few minor differences, most notably in how forward and backward searches through the list of historical commands are performed. There are two major editing modes, one with \fBemacs\fR-like key bindings and another with \fBvi\fR-like key bindings. By default \fBemacs\fR mode is enabled, but \fBvi\fR(1) mode can alternatively be selected via the user's configuration file. This file can also be used to change the bindings of individual keys to suit the user's preferences. By default, tab completion is provided. If the application hasn't reconfigured this to complete other types of symbols, then tab completion completes file names.

    12 .SS "Key Sequence Notation"

    13 .sp

    14 .LP

    15 In the rest of this man page, and also in all tecla configuration files, key sequences are expressed as follows.

    16 .sp

    17 .ne 2

    18 .mk

    19 .na

    20 \fB\fB^A\fR or \fBC-a\fR\fR

    21 .ad

    22 .RS 13n

    23 .rt  

    24 This is a 'CONTROL-A', entered by pressing the CONTROL key at the same time as the 'A' key.

    25 .RE

    26 

    27 .sp

    28 .ne 2

    29 .mk

    30 .na

    31 \fB\fB\eE\fR or \fBM-\fR\fR

    32 .ad

    33 .RS 13n

    34 .rt  

    35 In key sequences, both of these notations can be entered either by pressing the ESCAPE key, then the following key, or by pressing the META key at the same time as the following key. Thus the key sequence \fBM-p\fR can be typed in two ways, by pressing the ESCAPE key, followed by pressing 'P', or by pressing the META key at the same time as 'P'.

    36 .RE

    37 

    38 .sp

    39 .ne 2

    40 .mk

    41 .na

    42 \fBup\fR

    43 .ad

    44 .RS 13n

    45 .rt  

    46 This refers to the up-arrow key.

    47 .RE

    48 

    49 .sp

    50 .ne 2

    51 .mk

    52 .na

    53 \fBdown\fR

    54 .ad

    55 .RS 13n

    56 .rt  

    57 This refers to the down-arrow key.

    58 .RE

    59 

    60 .sp

    61 .ne 2

    62 .mk

    63 .na

    64 \fBleft\fR

    65 .ad

    66 .RS 13n

    67 .rt  

    68 This refers to the left-arrow key.

    69 .RE

    70 

    71 .sp

    72 .ne 2

    73 .mk

    74 .na

    75 \fBright\fR

    76 .ad

    77 .RS 13n

    78 .rt  

    79 This refers to the right-arrow key.

    80 .RE

    81 

    82 .sp

    83 .ne 2

    84 .mk

    85 .na

    86 \fBa\fR

    87 .ad

    88 .RS 13n

    89 .rt  

    90 This is just a normal 'A' key.

    91 .RE

    92 

    93 .SS "The Tecla Configuration File"

    94 .sp

    95 .LP

    96 By default, tecla looks for a file called \fB\&.teclarc\fR in your home directory (ie. \fB~/.teclarc\fR). If it finds this file, it reads it, interpreting each line as defining a new key binding or an editing configuration option. Since the \fBemacs\fR key-bindings are installed by default, if you want to use the non-default \fBvi\fR editing mode, the most important item to go in this file is the following line:

    97 .sp

    98 .in +2

    99 .nf

   100 edit-mode vi

   101 .fi

   102 .in -2

   103 

   104 .sp

   105 .LP

   106 This will re-configure the default bindings for \fBvi\fR-mode. The complete set of arguments that this command accepts are:

   107 .sp

   108 .ne 2

   109 .mk

   110 .na

   111 \fBvi\fR

   112 .ad

   113 .RS 9n

   114 .rt  

   115 Install key bindings like those of the \fBvi\fR editor.

   116 .RE

   117 

   118 .sp

   119 .ne 2

   120 .mk

   121 .na

   122 \fBemacs\fR

   123 .ad

   124 .RS 9n

   125 .rt  

   126 Install key bindings like those of the \fBemacs\fR editor. This is the default.

   127 .RE

   128 

   129 .sp

   130 .ne 2

   131 .mk

   132 .na

   133 \fBnone\fR

   134 .ad

   135 .RS 9n

   136 .rt  

   137 Use just the native line editing facilities provided by the terminal driver.

   138 .RE

   139 

   140 .sp

   141 .LP

   142 To prevent the terminal bell from being rung, such as when an unrecognized control-sequence is typed, place the following line in the configuration file:

   143 .sp

   144 .in +2

   145 .nf

   146 nobeep

   147 .fi

   148 .in -2

   149 

   150 .sp

   151 .LP

   152 An example of a key binding line in the configuration file is the following.

   153 .sp

   154 .in +2

   155 .nf

   156 bind M-[2~ insert-mode

   157 .fi

   158 .in -2

   159 

   160 .sp

   161 .LP

   162 On many keyboards, the above key sequence is generated when one presses the insert key, so with this key binding, one can toggle between the \fBemacs\fR-mode insert and overwrite modes by hitting one key. One could also do it by typing out the above sequence of characters one by one. As explained above, the \fBM-\fR part of this sequence can be typed either by pressing the ESCAPE key before the following key, or by pressing the META key at the same time as the following key. Thus if you had set the above key binding, and the insert key on your keyboard didn't generate the above key sequence, you could still type it in either of the following 2 ways.

   163 .RS +4

   164 .TP

   165 1.

   166 Hit the ESCAPE key momentarily, then press '[', then \&'2', then finally '~'.

   167 .RE

   168 .RS +4

   169 .TP

   170 2.

   171 Press the META key at the same time as pressing the \&'[' key, then press '2', then '~'.

   172 .RE

   173 .sp

   174 .LP

   175 If you set a key binding for a key sequence that is already bound to a function, the new binding overrides the old one. If in the new binding you omit the name of the new function to bind to the key sequence, the original binding becomes undefined.

   176 .sp

   177 .LP

   178 Starting with versions of \fBlibtecla\fR later than 1.3.3 it is now possible to bind key sequences that begin with a printable character. Previously key sequences were required to start with a CONTROL or META character.

   179 .sp

   180 .LP

   181 Note that the special keywords "up", "down", "left", and "right" refer to the arrow keys, and are thus not treated as key sequences. So, for example, to rebind the up and down arrow keys to use the history search mechanism instead of the simple history recall method, you could place the following in your configuration file:

   182 .sp

   183 .in +2

   184 .nf

   185 bind up history-search-backwards

   186 bind down history-search-backwards

   187 .fi

   188 .in -2

   189 

   190 .sp

   191 .LP

   192 To unbind an existing binding, you can do this with the bind command by omitting to name any action to rebind the key sequence to. For example, by not specifying an action function, the following command unbinds the default beginning-of-line action from the \fB^A\fR key sequence:

   193 .sp

   194 .in +2

   195 .nf

   196 bind ^A

   197 .fi

   198 .in -2

   199 

   200 .sp

   201 .LP

   202 If you create a \fB~/.teclarc\fR configuration file, but it appears to have no effect on the program, check the documentation of the program to see if the author chose a different name for this file.

   203 .SS "Filename and Tilde Completion"

   204 .sp

   205 .LP

   206 With the default key bindings, pressing the TAB key (aka. \fB^I\fR) results in tecla attempting to complete the incomplete file name that precedes the cursor. Tecla searches backwards from the cursor, looking for the start of the file name, stopping when it hits either a space or the start of the line. If more than one file has the specified prefix, then tecla completes the file name up to the point at which the ambiguous matches start to differ, then lists the possible matches.

   207 .sp

   208 .LP

   209 In addition to literally written file names, tecla can complete files that start with \fB~/\fR and \fB~user/\fR expressions and that contain \fB$envvar\fR expressions. In particular, if you hit TAB within an incomplete \fB~user\fR, expression, tecla will attempt to complete the username, listing any ambiguous matches.

   210 .sp

   211 .LP

   212 The completion binding is implemented using the \fBcpl_complete_word()\fR function, which is also available separately to users of this library. See the \fBcpl_complete_word\fR(3TECLA) man page for more details.

   213 .SS "Filename Expansion"

   214 .sp

   215 .LP

   216 With the default key bindings, pressing \fB^X*\fR causes tecla to expand the file name that precedes the cursor, replacing \fB~/\fR and \fB~user/\fR expressions with the corresponding home directories, and replacing \fB$envvar\fR expressions with the value of the specified environment variable, then if there are any wildcards, replacing the so far expanded file name with a space-separated list of the files which match the wild cards.

   217 .sp

   218 .LP

   219 The expansion binding is implemented using the \fBef_expand_file()\fR function. See the \fBef_expand_file\fR(3TECLA) man page for more details.

   220 .SS "Recalling Previously Typed Lines"

   221 .sp

   222 .LP

   223 Every time that a new line is entered by the user, it is appended to a list of historical input lines maintained within the \fBGetLine\fR resource object. You can traverse up and down this list using the up and down arrow keys. Alternatively, you can do the same with the \fB^P\fR, and \fB^N\fR keys, and in \fBvi\fR command mode you can alternatively use the k and j characters. Thus pressing up-arrow once, replaces the current input line with the previously entered line. Pressing up-arrow again, replaces this with the line that was entered before it, etc.. Having gone back one or more lines into the history list, one can return to newer lines by pressing down-arrow one or more times. If you do this sufficient times, you will return to the original line that you were entering when you first hit up-arrow.

   224 .sp

   225 .LP

   226 Note that in \fBvi\fR mode, all of the history recall functions switch the library into command mode.

   227 .sp

   228 .LP

   229 In \fBemacs\fR mode the \fBM-p\fR and \fBM-n\fR keys work just like the \fB^P\fR and \fB^N\fR keys, except that they skip all but those historical lines which share the prefix that precedes the cursor. In \fBvi\fR command mode the upper case 'K' and 'J' characters do the same thing, except that the string that they search for includes the character under the cursor as well as what precedes it.

   230 .sp

   231 .LP

   232 Thus for example, suppose that you were in \fBemacs\fR mode, and you had just entered the following list of commands in the order shown:

   233 .sp

   234 .in +2

   235 .nf

   236 ls ~/tecla/

   237 cd ~/tecla

   238 ls -l getline.c

   239 \fBemacs\fR ~/tecla/getline.c

   240 .fi

   241 .in -2

   242 

   243 .sp

   244 .LP

   245 If you next typed:

   246 .sp

   247 .in +2

   248 .nf

   249 ls

   250 .fi

   251 .in -2

   252 

   253 .sp

   254 .LP

   255 and then hit \fBM-p\fR, then rather than returning the previously typed \fBemacs\fR line, which doesn't start with "ls", tecla would recall the "ls -l getline.c" line. Pressing \fBM-p\fR again would recall the "ls ~/tecla/" line.

   256 .sp

   257 .LP

   258 Note that if the string that you are searching for, contains any of the special characters, *, ?, or '[', then it is interpretted as a pattern to be matched. Thus, cotinuing with the above example, after typing in the list of commands shown, if you then typed:

   259 .sp

   260 .in +2

   261 .nf

   262 *tecla*

   263 .fi

   264 .in -2

   265 

   266 .sp

   267 .LP

   268 and hit \fBM-p\fR, then the "\fBemacs\fR ~/tecla/getline.c" line would be recalled first, since it contains the word tecla somewhere in the line, Similarly, hitting \fBM-p\fR again, would recall the "ls ~/tecla/" line, and hitting it once more would recall the "ls ~/tecla/" line. The pattern syntax is the same as that described for file name expansion, in the \fBef_expand_file\fR(3TECLA).

   269 .SS "History Files"

   270 .sp

   271 .LP

   272 Authors of programs that use the tecla library have the option of saving historical command-lines in a file before exiting, and subsequently reading them back in from this file when the program is next started. There is no standard name for this file, since it makes sense for each application to use its own history file, so that commands from different applications don't get mixed up.

   273 .SS "International Character Sets"

   274 .sp

   275 .LP

   276 Since \fBlibtecla\fR version 1.4.0, tecla has been 8-bit clean. This means that all 8-bit characters that are printable in the user's current locale are now displayed verbatim and included in the returned input line. Assuming that the calling program correctly contains a call like the following,

   277 .sp

   278 .in +2

   279 .nf

   280 setlocale(LC_CTYPE, "");

   281 .fi

   282 .in -2

   283 

   284 .sp

   285 .LP

   286 then the current locale is determined by the first of the environment variables \fBLC_CTYPE\fR, \fBLC_ALL\fR, and \fBLANG\fR, that is found to contain a valid locale name. If none of these variables are defined, or the program neglects to call \fBsetlocale\fR, then the default C locale is used, which is US 7-bit ASCII. On most unix-like platforms, you can get a list of valid locales by typing the command:

   287 .sp

   288 .in +2

   289 .nf

   290 locale -a

   291 .fi

   292 .in -2

   293 

   294 .sp

   295 .LP

   296 at the shell prompt.

   297 .SS "Meta Keys and Locales"

   298 .sp

   299 .LP

   300 Beware that in most locales other than the default C locale, META characters become printable, and they are then no longer considered to match \fBM-c\fR style key bindings. This allows international characters to be entered with the compose key without unexpectedly triggering META key bindings. You can still invoke META bindings, since there are actually two ways to do this. For example the binding \fBM-c\fR can also be invoked by pressing the ESCAPE key momentarily, then pressing the c key, and this will work regardless of locale. Moreover, many modern terminal emulators, such as gnome's gnome-terminal's and KDE's konsole terminals, already generate escape pairs like this when you use the META key, rather than a real meta character, and other emulators usually have a way to request this behavior, so you can continue to use the META key on most systems.

   301 .sp

   302 .LP

   303 For example, although xterm terminal emulators generate real 8-bit meta characters by default when you use the META key, they can be configured to output the equivalent escape pair by setting their \fBEightBitInput\fR X resource to False. You can either do this by placing a line like the following in your \fB~/.Xdefaults\fR file,

   304 .sp

   305 .in +2

   306 .nf

   307 XTerm*EightBitInput: False

   308 .fi

   309 .in -2

   310 

   311 .sp

   312 .LP

   313 or by starting an \fBxterm\fR with an \fB-xrm\fR '*EightBitInput: False' command-line argument. In recent versions of xterm you can toggle this feature on and off with the 'Meta Sends Escape' option in the menu that is displayed when you press the left mouse button and the CONTROL key within an xterm window. In CDE, dtterms can be similarly coerced to generate escape pairs in place of meta characters, by setting the \fBDtterm*KshMode\fR resource to True.

   314 .SS "Entering International Characters"

   315 .sp

   316 .LP

   317 If you don't have a keyboard that generates all of the international characters that you need, there is usually a compose key that will allow you to enter special characters, or a way to create one. For example, under X windows on unix-like systems, if your keyboard doesn't have a compose key, you can designate a redundant key to serve this purpose with the xmodmap command. For example, on many PC keyboards there is a microsoft-windows key, which is otherwise useless under Linux. On a laptop, for example, the \fBxev\fR program might report that pressing this key generates keycode 115. To turn this key into a COMPOSE  key, do the following:

   318 .sp

   319 .in +2

   320 .nf

   321 xmodmap -e 'keycode 115 = Multi_key'

   322 .fi

   323 .in -2

   324 

   325 .sp

   326 .LP

   327 Type this key followed by a " character to enter an 'I' with a umlaut over it.

   328 .SS "The Available Key Binding Functions"

   329 .sp

   330 .LP

   331 The following is a list of the editing functions provided by the tecla library. The names in the leftmost column of the list can be used in configuration files to specify which function a given key or combination of keys should invoke. They are also used in the next two sections to list the default key bindings in \fBemacs\fR and \fBvi\fR modes.

   332 .sp

   333 .ne 2

   334 .mk

   335 .na

   336 \fBuser-interrupt\fR

   337 .ad

   338 .RS 30n

   339 .rt  

   340 Send a SIGINT signal to the parent process.

   341 .RE

   342 

   343 .sp

   344 .ne 2

   345 .mk

   346 .na

   347 \fBsuspend\fR

   348 .ad

   349 .RS 30n

   350 .rt  

   351 Suspend the parent process.

   352 .RE

   353 

   354 .sp

   355 .ne 2

   356 .mk

   357 .na

   358 \fBstop-output\fR

   359 .ad

   360 .RS 30n

   361 .rt  

   362 Pause terminal output.

   363 .RE

   364 

   365 .sp

   366 .ne 2

   367 .mk

   368 .na

   369 \fBstart-output\fR

   370 .ad

   371 .RS 30n

   372 .rt  

   373 Resume paused terminal output.

   374 .RE

   375 

   376 .sp

   377 .ne 2

   378 .mk

   379 .na

   380 \fBliteral-next\fR

   381 .ad

   382 .RS 30n

   383 .rt  

   384 Arrange for the next character to be treated as a normal character. This allows control characters to be entered.

   385 .RE

   386 

   387 .sp

   388 .ne 2

   389 .mk

   390 .na

   391 \fBcursor-right\fR

   392 .ad

   393 .RS 30n

   394 .rt  

   395 Move the cursor one character right.

   396 .RE

   397 

   398 .sp

   399 .ne 2

   400 .mk

   401 .na

   402 \fBcursor-left\fR

   403 .ad

   404 .RS 30n

   405 .rt  

   406 Move the cursor one character left.

   407 .RE

   408 

   409 .sp

   410 .ne 2

   411 .mk

   412 .na

   413 \fBinsert-mode\fR

   414 .ad

   415 .RS 30n

   416 .rt  

   417 Toggle between insert mode and overwrite mode.

   418 .RE

   419 

   420 .sp

   421 .ne 2

   422 .mk

   423 .na

   424 \fBbeginning-of-line\fR

   425 .ad

   426 .RS 30n

   427 .rt  

   428 Move the cursor to the beginning of the line.

   429 .RE

   430 

   431 .sp

   432 .ne 2

   433 .mk

   434 .na

   435 \fBend-of-line\fR

   436 .ad

   437 .RS 30n

   438 .rt  

   439 Move the cursor to the end of the line.

   440 .RE

   441 

   442 .sp

   443 .ne 2

   444 .mk

   445 .na

   446 \fBdelete-line\fR

   447 .ad

   448 .RS 30n

   449 .rt  

   450 Delete the contents of the current line.

   451 .RE

   452 

   453 .sp

   454 .ne 2

   455 .mk

   456 .na

   457 \fBkill-line\fR

   458 .ad

   459 .RS 30n

   460 .rt  

   461 Delete everything that follows the cursor.

   462 .RE

   463 

   464 .sp

   465 .ne 2

   466 .mk

   467 .na

   468 \fBbackward-kill-line\fR

   469 .ad

   470 .RS 30n

   471 .rt  

   472 Delete all characters between the cursor and the start of the line.

   473 .RE

   474 

   475 .sp

   476 .ne 2

   477 .mk

   478 .na

   479 \fBforward-word\fR

   480 .ad

   481 .RS 30n

   482 .rt  

   483 Move to the end of the word which follows the cursor.

   484 .RE

   485 

   486 .sp

   487 .ne 2

   488 .mk

   489 .na

   490 \fBforward-to-word\fR

   491 .ad

   492 .RS 30n

   493 .rt  

   494 Move the cursor to the start of the word that follows the cursor.

   495 .RE

   496 

   497 .sp

   498 .ne 2

   499 .mk

   500 .na

   501 \fBbackward-word\fR

   502 .ad

   503 .RS 30n

   504 .rt  

   505 Move to the start of the word which precedes the cursor.

   506 .RE

   507 

   508 .sp

   509 .ne 2

   510 .mk

   511 .na

   512 \fBgoto-column\fR

   513 .ad

   514 .RS 30n

   515 .rt  

   516 Move the cursor to the 1-relative column in the line specified by any preceding digit-argument sequences (see Entering Repeat Counts below).

   517 .RE

   518 

   519 .sp

   520 .ne 2

   521 .mk

   522 .na

   523 \fBfind-parenthesis\fR

   524 .ad

   525 .RS 30n

   526 .rt  

   527 If the cursor is currently over a parenthesis character, move it to the matching parenthesis character. If not over a parenthesis character move right to the next close parenthesis.

   528 .RE

   529 

   530 .sp

   531 .ne 2

   532 .mk

   533 .na

   534 \fBforward-delete-char\fR

   535 .ad

   536 .RS 30n

   537 .rt  

   538 Delete the character under the cursor.

   539 .RE

   540 

   541 .sp

   542 .ne 2

   543 .mk

   544 .na

   545 \fBbackward-delete-char\fR

   546 .ad

   547 .RS 30n

   548 .rt  

   549 Delete the character which precedes the cursor.

   550 .RE

   551 

   552 .sp

   553 .ne 2

   554 .mk

   555 .na

   556 \fBlist-or-eof\fR

   557 .ad

   558 .RS 30n

   559 .rt  

   560 This is intended for binding to \fB^D\fR. When invoked when the cursor is within the line it displays all possible completions then redisplays the line unchanged. When invoked on an empty line, it signals end-of-input (EOF) to the caller of \fBgl_get_line()\fR.

   561 .RE

   562 

   563 .sp

   564 .ne 2

   565 .mk

   566 .na

   567 \fBdel-char-or-list-or-eof\fR

   568 .ad

   569 .RS 30n

   570 .rt  

   571 This is intended for binding to \fB^D\fR. When invoked when the cursor is within the line it invokes forward-delete-char. When invoked at the end of the line it displays all possible completions then redisplays the line unchanged. When invoked on an empty line, it signals end-of-input (EOF) to the caller of \fBgl_get_line()\fR.

   572 .RE

   573 

   574 .sp

   575 .ne 2

   576 .mk

   577 .na

   578 \fBforward-delete-word\fR

   579 .ad

   580 .RS 30n

   581 .rt  

   582 Delete the word which follows the cursor.

   583 .RE

   584 

   585 .sp

   586 .ne 2

   587 .mk

   588 .na

   589 \fBbackward-delete-word\fR

   590 .ad

   591 .RS 30n

   592 .rt  

   593 Delete the word which precedes the cursor.

   594 .RE

   595 

   596 .sp

   597 .ne 2

   598 .mk

   599 .na

   600 \fBupcase-word\fR

   601 .ad

   602 .RS 30n

   603 .rt  

   604 Convert all of the characters of the word which follows the cursor, to upper case.

   605 .RE

   606 

   607 .sp

   608 .ne 2

   609 .mk

   610 .na

   611 \fBdowncase-word\fR

   612 .ad

   613 .RS 30n

   614 .rt  

   615 Convert all of the characters of the word which follows the cursor, to lower case.

   616 .RE

   617 

   618 .sp

   619 .ne 2

   620 .mk

   621 .na

   622 \fBcapitalize-word\fR

   623 .ad

   624 .RS 30n

   625 .rt  

   626 Capitalize the word which follows the cursor.

   627 .RE

   628 

   629 .sp

   630 .ne 2

   631 .mk

   632 .na

   633 \fBchange-case\fR

   634 .ad

   635 .RS 30n

   636 .rt  

   637 If the next character is upper case, toggle it to lower case and vice versa.

   638 .RE

   639 

   640 .sp

   641 .ne 2

   642 .mk

   643 .na

   644 \fBredisplay\fR

   645 .ad

   646 .RS 30n

   647 .rt  

   648 Redisplay the line.

   649 .RE

   650 

   651 .sp

   652 .ne 2

   653 .mk

   654 .na

   655 \fBclear-screen\fR

   656 .ad

   657 .RS 30n

   658 .rt  

   659 Clear the terminal, then redisplay the current line.

   660 .RE

   661 

   662 .sp

   663 .ne 2

   664 .mk

   665 .na

   666 \fBtranspose-chars\fR

   667 .ad

   668 .RS 30n

   669 .rt  

   670 Swap the character under the cursor with the character just before the cursor.

   671 .RE

   672 

   673 .sp

   674 .ne 2

   675 .mk

   676 .na

   677 \fBset-mark\fR

   678 .ad

   679 .RS 30n

   680 .rt  

   681 Set a mark at the position of the cursor.

   682 .RE

   683 

   684 .sp

   685 .ne 2

   686 .mk

   687 .na

   688 \fBexchange-point-and-mark\fR

   689 .ad

   690 .RS 30n

   691 .rt  

   692 Move the cursor to the last mark that was set, and move the mark to where the cursor used to be.

   693 .RE

   694 

   695 .sp

   696 .ne 2

   697 .mk

   698 .na

   699 \fBkill-region\fR

   700 .ad

   701 .RS 30n

   702 .rt  

   703 Delete the characters that lie between the last mark that was set, and the cursor.

   704 .RE

   705 

   706 .sp

   707 .ne 2

   708 .mk

   709 .na

   710 \fBcopy-region-as-kill\fR

   711 .ad

   712 .RS 30n

   713 .rt  

   714 Copy the text between the mark and the cursor to the cut buffer, without deleting the original text.

   715 .RE

   716 

   717 .sp

   718 .ne 2

   719 .mk

   720 .na

   721 \fByank\fR

   722 .ad

   723 .RS 30n

   724 .rt  

   725 Insert the text that was last deleted, just before the current position of the cursor.

   726 .RE

   727 

   728 .sp

   729 .ne 2

   730 .mk

   731 .na

   732 \fBappend-yank\fR

   733 .ad

   734 .RS 30n

   735 .rt  

   736 Paste the current contents of the cut buffer, after the cursor.

   737 .RE

   738 

   739 .sp

   740 .ne 2

   741 .mk

   742 .na

   743 \fBup-history\fR

   744 .ad

   745 .RS 30n

   746 .rt  

   747 Recall the next oldest line that was entered. Note that in \fBvi\fR mode you are left in command mode.

   748 .RE

   749 

   750 .sp

   751 .ne 2

   752 .mk

   753 .na

   754 \fBdown-history\fR

   755 .ad

   756 .RS 30n

   757 .rt  

   758 Recall the next most recent line that was entered. If no history recall session is currently active, the next line from a previous recall session is recalled. Note that in vi mode you are left in command mode.

   759 .RE

   760 

   761 .sp

   762 .ne 2

   763 .mk

   764 .na

   765 \fBhistory-search-backward\fR

   766 .ad

   767 .RS 30n

   768 .rt  

   769 Recall the next oldest line who's prefix matches the string which currently precedes the cursor (in \fBvi\fR command-mode the character under the cursor is also included in the search string). Note that in \fBvi\fR mode you are left in command mode.

   770 .RE

   771 

   772 .sp

   773 .ne 2

   774 .mk

   775 .na

   776 \fBhistory-search-forward\fR

   777 .ad

   778 .RS 30n

   779 .rt  

   780 Recall the next newest line who's prefix matches the string which currently precedes the cursor (in \fBvi\fR command-mode the character under the cursor is also included in the search string). Note that in \fBvi\fR mode you are left in command mode.

   781 .RE

   782 

   783 .sp

   784 .ne 2

   785 .mk

   786 .na

   787 \fBhistory-re-search-backward\fR

   788 .ad

   789 .RS 30n

   790 .rt  

   791 Recall the next oldest line who's prefix matches that established by the last invocation of either history-search-forward or history-search-backward.

   792 .RE

   793 

   794 .sp

   795 .ne 2

   796 .mk

   797 .na

   798 \fBhistory-re-search-forward\fR

   799 .ad

   800 .RS 30n

   801 .rt  

   802 Recall the next newest line who's prefix matches that established by the last invocation of either history-search-forward or history-search-backward.

   803 .RE

   804 

   805 .sp

   806 .ne 2

   807 .mk

   808 .na

   809 \fBcomplete-word\fR

   810 .ad

   811 .RS 30n

   812 .rt  

   813 Attempt to complete the incomplete word which precedes the cursor. Unless the host program has customized word completion, file name completion is attempted. In \fBvi\fR commmand mode the character under the cursor is also included in the word being completed, and you are left in \fBvi\fR insert mode.

   814 .RE

   815 

   816 .sp

   817 .ne 2

   818 .mk

   819 .na

   820 \fBexpand-filename\fR

   821 .ad

   822 .RS 30n

   823 .rt  

   824 Within the command line, expand wild cards, tilde expressions and dollar expressions in the file name which immediately precedes the cursor. In \fBvi\fR commmand mode the character under the cursor is also included in the file name being expanded, and you are left in \fBvi\fR insert mode.

   825 .RE

   826 

   827 .sp

   828 .ne 2

   829 .mk

   830 .na

   831 \fBlist-glob\fR

   832 .ad

   833 .RS 30n

   834 .rt  

   835 List any file names which match the wild-card, tilde and dollar expressions in the file name which immediately precedes the cursor, then redraw the input line unchanged.

   836 .RE

   837 

   838 .sp

   839 .ne 2

   840 .mk

   841 .na

   842 \fBlist-history\fR

   843 .ad

   844 .RS 30n

   845 .rt  

   846 Display the contents of the history list for the current history group. If a repeat count of \fB> 1\fR is specified, only that many of the most recent lines are displayed. See the Entering Repeat Counts section.

   847 .RE

   848 

   849 .sp

   850 .ne 2

   851 .mk

   852 .na

   853 \fBread-from-file\fR

   854 .ad

   855 .RS 30n

   856 .rt  

   857 Temporarily switch to reading input from the file who's name precedes the cursor.

   858 .RE

   859 

   860 .sp

   861 .ne 2

   862 .mk

   863 .na

   864 \fBread-init-files\fR

   865 .ad

   866 .RS 30n

   867 .rt  

   868 Re-read \fBteclarc\fR configuration files.

   869 .RE

   870 

   871 .sp

   872 .ne 2

   873 .mk

   874 .na

   875 \fBbeginning-of-history\fR

   876 .ad

   877 .RS 30n

   878 .rt  

   879 Move to the oldest line in the history list. Note that in \fBvi\fR mode you are left in command mode.

   880 .RE

   881 

   882 .sp

   883 .ne 2

   884 .mk

   885 .na

   886 \fBend-of-history\fR

   887 .ad

   888 .RS 30n

   889 .rt  

   890 Move to the newest line in the history list (ie. the current line). Note that in \fBvi\fR mode this leaves you in command mode.

   891 .RE

   892 

   893 .sp

   894 .ne 2

   895 .mk

   896 .na

   897 \fBdigit-argument\fR

   898 .ad

   899 .RS 30n

   900 .rt  

   901 Enter a repeat count for the next key binding function. For details, see the Entering Repeat Counts section.

   902 .RE

   903 

   904 .sp

   905 .ne 2

   906 .mk

   907 .na

   908 \fBnewline\fR

   909 .ad

   910 .RS 30n

   911 .rt  

   912 Terminate and return the current contents of the line, after appending a newline character. The newline character is normally \&'\en', but will be the first character of the key sequence that invoked the newline action, if this happens to be a printable character. If the action was invoked by the '\en' newline character or the \&'\er' carriage return character, the line is appended to the history buffer.

   913 .RE

   914 

   915 .sp

   916 .ne 2

   917 .mk

   918 .na

   919 \fBrepeat-history\fR

   920 .ad

   921 .RS 30n

   922 .rt  

   923 Return the line that is being edited, then arrange for the next most recent entry in the history buffer to be recalled when tecla is next called. Repeatedly invoking this action causes successive historical input lines to be re-executed. Note that this action is equivalent to the 'Operate' action in ksh.

   924 .RE

   925 

   926 .sp

   927 .ne 2

   928 .mk

   929 .na

   930 \fBring-bell\fR

   931 .ad

   932 .RS 30n

   933 .rt  

   934 Ring the terminal bell, unless the bell has been silenced via the nobeep configuration option (see The Tecla Configuration File section).

   935 .RE

   936 

   937 .sp

   938 .ne 2

   939 .mk

   940 .na

   941 \fBforward-copy-char\fR

   942 .ad

   943 .RS 30n

   944 .rt  

   945 Copy the next character into the cut buffer (NB. use repeat counts to copy more than one).

   946 .RE

   947 

   948 .sp

   949 .ne 2

   950 .mk

   951 .na

   952 \fBbackward-copy-char\fR

   953 .ad

   954 .RS 30n

   955 .rt  

   956 Copy the previous character into the cut buffer.

   957 .RE

   958 

   959 .sp

   960 .ne 2

   961 .mk

   962 .na

   963 \fBforward-copy-word\fR

   964 .ad

   965 .RS 30n

   966 .rt  

   967 Copy the next word into the cut buffer.

   968 .RE

   969 

   970 .sp

   971 .ne 2

   972 .mk

   973 .na

   974 \fBbackward-copy-word\fR

   975 .ad

   976 .RS 30n

   977 .rt  

   978 Copy the previous word into the cut buffer.

   979 .RE

   980 

   981 .sp

   982 .ne 2

   983 .mk

   984 .na

   985 \fBforward-find-char\fR

   986 .ad

   987 .RS 30n

   988 .rt  

   989 Move the cursor to the next occurrence of the next character that you type.

   990 .RE

   991 

   992 .sp

   993 .ne 2

   994 .mk

   995 .na

   996 \fBbackward-find-char\fR

   997 .ad

   998 .RS 30n

   999 .rt  

  1000 Move the cursor to the last occurrence of the next character that you type.

  1001 .RE

  1002 

  1003 .sp

  1004 .ne 2

  1005 .mk

  1006 .na

  1007 \fBforward-to-char\fR

  1008 .ad

  1009 .RS 30n

  1010 .rt  

  1011 Move the cursor to the character just before the next occurrence of the next character that the user types.

  1012 .RE

  1013 

  1014 .sp

  1015 .ne 2

  1016 .mk

  1017 .na

  1018 \fBbackward-to-char\fR

  1019 .ad

  1020 .RS 30n

  1021 .rt  

  1022 Move the cursor to the character just after the last occurrence before the cursor of the next character that the user types.

  1023 .RE

  1024 

  1025 .sp

  1026 .ne 2

  1027 .mk

  1028 .na

  1029 \fBrepeat-find-char\fR

  1030 .ad

  1031 .RS 30n

  1032 .rt  

  1033 Repeat the last backward-find-char, forward-find-char, backward-to-char or forward-to-char.

  1034 .RE

  1035 

  1036 .sp

  1037 .ne 2

  1038 .mk

  1039 .na

  1040 \fBinvert-refind-char\fR

  1041 .ad

  1042 .RS 30n

  1043 .rt  

  1044 Repeat the last backward-find-char, forward-find-char, backward-to-char, or forward-to-char in the opposite direction.

  1045 .RE

  1046 

  1047 .sp

  1048 .ne 2

  1049 .mk

  1050 .na

  1051 \fBdelete-to-column\fR

  1052 .ad

  1053 .RS 30n

  1054 .rt  

  1055 Delete the characters from the cursor up to the column that is specified by the repeat count.

  1056 .RE

  1057 

  1058 .sp

  1059 .ne 2

  1060 .mk

  1061 .na

  1062 \fBdelete-to-parenthesis\fR

  1063 .ad

  1064 .RS 30n

  1065 .rt  

  1066 Delete the characters from the cursor up to and including the matching parenthesis, or next close parenthesis.

  1067 .RE

  1068 

  1069 .sp

  1070 .ne 2

  1071 .mk

  1072 .na

  1073 \fBforward-delete-find\fR

  1074 .ad

  1075 .RS 30n

  1076 .rt  

  1077 Delete the characters from the cursor up to and including the following occurence of the next character typed.

  1078 .RE

  1079 

  1080 .sp

  1081 .ne 2

  1082 .mk

  1083 .na

  1084 \fBbackward-delete-find\fR

  1085 .ad

  1086 .RS 30n

  1087 .rt  

  1088 Delete the characters from the cursor up to and including the preceding occurence of the next character typed.

  1089 .RE

  1090 

  1091 .sp

  1092 .ne 2

  1093 .mk

  1094 .na

  1095 \fBforward-delete-to\fR

  1096 .ad

  1097 .RS 30n

  1098 .rt  

  1099 Delete the characters from the cursor up to, but not including, the following occurence of the next character typed.

  1100 .RE

  1101 

  1102 .sp

  1103 .ne 2

  1104 .mk

  1105 .na

  1106 \fBbackward-delete-to\fR

  1107 .ad

  1108 .RS 30n

  1109 .rt  

  1110 Delete the characters from the cursor up to, but not including, the preceding occurence of the next character typed.

  1111 .RE

  1112 

  1113 .sp

  1114 .ne 2

  1115 .mk

  1116 .na

  1117 \fBdelete-refind\fR

  1118 .ad

  1119 .RS 30n

  1120 .rt  

  1121 Repeat the last *-delete-find or *-delete-to action.

  1122 .RE

  1123 

  1124 .sp

  1125 .ne 2

  1126 .mk

  1127 .na

  1128 \fBdelete-invert-refind\fR

  1129 .ad

  1130 .RS 30n

  1131 .rt  

  1132 Repeat the last *-delete-find or *-delete-to action, in the opposite direction.

  1133 .RE

  1134 

  1135 .sp