4023 - Typo in file(1) manpage and various others

          --- old/usr/src/man/man5/tecla.5
          +++ new/usr/src/man/man5/tecla.5

   1    1  '\" te
   2    2  .\" Copyright (c) 2000, 2001, 2002, 2003, 2004 by Martin C. Shepherd. All Rights Reserved.
   3    3  .\" Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the
   4    4  .\" "Software"), to deal in the Software without restriction, including
   5    5  .\" without limitation the rights to use, copy, modify, merge, publish,
   6    6  .\" distribute, and/or sell copies of the Software, and to permit persons
   7    7  .\" to whom the Software is furnished to do so, provided that the above
   8    8  .\" copyright notice(s) and this permission notice appear in all copies of
   9    9  .\" the Software and that both the above copyright notice(s) and this
  10   10  .\" permission notice appear in supporting documentation.
  11   11  .\"
  12   12  .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  13   13  .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  14   14  .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
  15   15  .\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
  16   16  .\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL

  17   17  .\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
  18   18  .\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
  19   19  .\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
  20   20  .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  21   21  .\"
  22   22  .\" Except as contained in this notice, the name of a copyright holder
  23   23  .\" shall not be used in advertising or otherwise to promote the sale, use
  24   24  .\" or other dealings in this Software without prior written authorization
  25   25  .\" of the copyright holder.
  26   26  .\" Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
  27      -.TH TECLA 5 "May 20, 2004"
       27 +.TH TECLA 5 "Sep 10, 2013"
  28   28  .SH NAME
  29   29  tecla, teclarc \- User interface provided by the tecla library.
  30   30  .SH DESCRIPTION
  31   31  .sp
  32   32  .LP
  33   33  This man page describes the command-line editing features that are available to
  34   34  users of programs that read keyboard input via the tecla library. Users of the
  35   35  \fBtcsh shell\fR will find the default key bindings very familiar. Users of the
  36   36  \fBbash\fR shell will also find it quite familiar, but with a few minor
  37   37  differences, most notably in how forward and backward searches through the list

  38   38  of historical commands are performed. There are two major editing modes, one
  39   39  with \fBemacs\fR-like key bindings and another with \fBvi\fR-like key bindings.
  40   40  By default \fBemacs\fR mode is enabled, but \fBvi\fR(1) mode can alternatively
  41   41  be selected via the user's configuration file. This file can also be used to
  42   42  change the bindings of individual keys to suit the user's preferences. By
  43   43  default, tab completion is provided. If the application hasn't reconfigured
  44   44  this to complete other types of symbols, then tab completion completes file
  45   45  names.
  46   46  .SS "Key Sequence Notation"
  47   47  .sp
  48   48  .LP
  49   49  In the rest of this man page, and also in all tecla configuration files, key
  50   50  sequences are expressed as follows.
  51   51  .sp
  52   52  .ne 2
  53   53  .na
  54   54  \fB\fB^A\fR or \fBC-a\fR\fR
  55   55  .ad
  56   56  .RS 13n
  57   57  This is a 'CONTROL-A', entered by pressing the CONTROL key at the same time as
  58   58  the 'A' key.
  59   59  .RE
  60   60  
  61   61  .sp
  62   62  .ne 2
  63   63  .na
  64   64  \fB\fB\E\fR or \fBM-\fR\fR
  65   65  .ad
  66   66  .RS 13n
  67   67  In key sequences, both of these notations can be entered either by pressing the
  68   68  ESCAPE key, then the following key, or by pressing the META key at the same
  69   69  time as the following key. Thus the key sequence \fBM-p\fR can be typed in two
  70   70  ways, by pressing the ESCAPE key, followed by pressing 'P', or by pressing the
  71   71  META key at the same time as 'P'.
  72   72  .RE
  73   73  
  74   74  .sp
  75   75  .ne 2
  76   76  .na
  77   77  \fBup\fR
  78   78  .ad
  79   79  .RS 13n
  80   80  This refers to the up-arrow key.
  81   81  .RE
  82   82  
  83   83  .sp
  84   84  .ne 2
  85   85  .na
  86   86  \fBdown\fR
  87   87  .ad
  88   88  .RS 13n
  89   89  This refers to the down-arrow key.
  90   90  .RE
  91   91  
  92   92  .sp
  93   93  .ne 2
  94   94  .na
  95   95  \fBleft\fR
  96   96  .ad
  97   97  .RS 13n
  98   98  This refers to the left-arrow key.
  99   99  .RE
 100  100  
 101  101  .sp
 102  102  .ne 2
 103  103  .na
 104  104  \fBright\fR
 105  105  .ad
 106  106  .RS 13n
 107  107  This refers to the right-arrow key.
 108  108  .RE
 109  109  
 110  110  .sp
 111  111  .ne 2
 112  112  .na
 113  113  \fBa\fR
 114  114  .ad
 115  115  .RS 13n
 116  116  This is just a normal 'A' key.
 117  117  .RE
 118  118  
 119  119  .SS "The Tecla Configuration File"
 120  120  .sp
 121  121  .LP
 122  122  By default, tecla looks for a file called \fB\&.teclarc\fR in your home
 123  123  directory (ie. \fB~/.teclarc\fR). If it finds this file, it reads it,
 124  124  interpreting each line as defining a new key binding or an editing
 125  125  configuration option. Since the \fBemacs\fR key-bindings are installed by
 126  126  default, if you want to use the non-default \fBvi\fR editing mode, the most
 127  127  important item to go in this file is the following line:
 128  128  .sp
 129  129  .in +2
 130  130  .nf
 131  131  edit-mode vi
 132  132  .fi
 133  133  .in -2
 134  134  
 135  135  .sp
 136  136  .LP
 137  137  This will re-configure the default bindings for \fBvi\fR-mode. The complete set
 138  138  of arguments that this command accepts are:
 139  139  .sp
 140  140  .ne 2
 141  141  .na
 142  142  \fBvi\fR
 143  143  .ad
 144  144  .RS 9n
 145  145  Install key bindings like those of the \fBvi\fR editor.
 146  146  .RE
 147  147  
 148  148  .sp
 149  149  .ne 2
 150  150  .na
 151  151  \fBemacs\fR
 152  152  .ad
 153  153  .RS 9n
 154  154  Install key bindings like those of the \fBemacs\fR editor. This is the default.
 155  155  .RE
 156  156  
 157  157  .sp
 158  158  .ne 2
 159  159  .na
 160  160  \fBnone\fR
 161  161  .ad
 162  162  .RS 9n
 163  163  Use just the native line editing facilities provided by the terminal driver.
 164  164  .RE
 165  165  
 166  166  .sp
 167  167  .LP
 168  168  To prevent the terminal bell from being rung, such as when an unrecognized
 169  169  control-sequence is typed, place the following line in the configuration file:
 170  170  .sp
 171  171  .in +2
 172  172  .nf
 173  173  nobeep
 174  174  .fi
 175  175  .in -2
 176  176  
 177  177  .sp
 178  178  .LP
 179  179  An example of a key binding line in the configuration file is the following.
 180  180  .sp
 181  181  .in +2
 182  182  .nf
 183  183  bind M-[2~ insert-mode
 184  184  .fi
 185  185  .in -2
 186  186  
 187  187  .sp
 188  188  .LP
 189  189  On many keyboards, the above key sequence is generated when one presses the
 190  190  insert key, so with this key binding, one can toggle between the
 191  191  \fBemacs\fR-mode insert and overwrite modes by hitting one key. One could also
 192  192  do it by typing out the above sequence of characters one by one. As explained
 193  193  above, the \fBM-\fR part of this sequence can be typed either by pressing the
 194  194  ESCAPE key before the following key, or by pressing the META key at the same
 195  195  time as the following key. Thus if you had set the above key binding, and the
 196  196  insert key on your keyboard didn't generate the above key sequence, you could
 197  197  still type it in either of the following 2 ways.
 198  198  .RS +4
 199  199  .TP
 200  200  1.
 201  201  Hit the ESCAPE key momentarily, then press '[', then '2', then finally '~'.
 202  202  .RE
 203  203  .RS +4
 204  204  .TP
 205  205  2.
 206  206  Press the META key at the same time as pressing the '[' key, then press '2',
 207  207  then '~'.
 208  208  .RE
 209  209  .sp
 210  210  .LP
 211  211  If you set a key binding for a key sequence that is already bound to a
 212  212  function, the new binding overrides the old one. If in the new binding you omit
 213  213  the name of the new function to bind to the key sequence, the original binding
 214  214  becomes undefined.
 215  215  .sp
 216  216  .LP
 217  217  Starting with versions of \fBlibtecla\fR later than 1.3.3 it is now possible to
 218  218  bind key sequences that begin with a printable character. Previously key
 219  219  sequences were required to start with a CONTROL or META character.
 220  220  .sp
 221  221  .LP
 222  222  Note that the special keywords "up", "down", "left", and "right" refer to the
 223  223  arrow keys, and are thus not treated as key sequences. So, for example, to
 224  224  rebind the up and down arrow keys to use the history search mechanism instead
 225  225  of the simple history recall method, you could place the following in your
 226  226  configuration file:
 227  227  .sp
 228  228  .in +2
 229  229  .nf
 230  230  bind up history-search-backwards
 231  231  bind down history-search-backwards
 232  232  .fi
 233  233  .in -2
 234  234  
 235  235  .sp
 236  236  .LP
 237  237  To unbind an existing binding, you can do this with the bind command by
 238  238  omitting to name any action to rebind the key sequence to. For example, by not
 239  239  specifying an action function, the following command unbinds the default
 240  240  beginning-of-line action from the \fB^A\fR key sequence:
 241  241  .sp
 242  242  .in +2
 243  243  .nf
 244  244  bind ^A
 245  245  .fi
 246  246  .in -2
 247  247  
 248  248  .sp
 249  249  .LP
 250  250  If you create a \fB~/.teclarc\fR configuration file, but it appears to have no
 251  251  effect on the program, check the documentation of the program to see if the
 252  252  author chose a different name for this file.
 253  253  .SS "Filename and Tilde Completion"
 254  254  .sp
 255  255  .LP
 256  256  With the default key bindings, pressing the TAB key (aka. \fB^I\fR) results in
 257  257  tecla attempting to complete the incomplete file name that precedes the cursor.
 258  258  Tecla searches backwards from the cursor, looking for the start of the file
 259  259  name, stopping when it hits either a space or the start of the line. If more
 260  260  than one file has the specified prefix, then tecla completes the file name up
 261  261  to the point at which the ambiguous matches start to differ, then lists the
 262  262  possible matches.
 263  263  .sp
 264  264  .LP
 265  265  In addition to literally written file names, tecla can complete files that
 266  266  start with \fB~/\fR and \fB~user/\fR expressions and that contain \fB$envvar\fR
 267  267  expressions. In particular, if you hit TAB within an incomplete \fB~user\fR,
 268  268  expression, tecla will attempt to complete the username, listing any ambiguous
 269  269  matches.
 270  270  .sp
 271  271  .LP
 272  272  The completion binding is implemented using the \fBcpl_complete_word()\fR
 273  273  function, which is also available separately to users of this library. See the
 274  274  \fBcpl_complete_word\fR(3TECLA) man page for more details.
 275  275  .SS "Filename Expansion"
 276  276  .sp
 277  277  .LP
 278  278  With the default key bindings, pressing \fB^X*\fR causes tecla to expand the
 279  279  file name that precedes the cursor, replacing \fB~/\fR and \fB~user/\fR
 280  280  expressions with the corresponding home directories, and replacing
 281  281  \fB$envvar\fR expressions with the value of the specified environment variable,
 282  282  then if there are any wildcards, replacing the so far expanded file name with a
 283  283  space-separated list of the files which match the wild cards.
 284  284  .sp
 285  285  .LP
 286  286  The expansion binding is implemented using the \fBef_expand_file()\fR function.
 287  287  See the \fBef_expand_file\fR(3TECLA) man page for more details.
 288  288  .SS "Recalling Previously Typed Lines"
 289  289  .sp
 290  290  .LP
 291  291  Every time that a new line is entered by the user, it is appended to a list of
 292  292  historical input lines maintained within the \fBGetLine\fR resource object. You
 293  293  can traverse up and down this list using the up and down arrow keys.
 294  294  Alternatively, you can do the same with the \fB^P\fR, and \fB^N\fR keys, and in
 295  295  \fBvi\fR command mode you can alternatively use the k and j characters. Thus
 296  296  pressing up-arrow once, replaces the current input line with the previously
 297  297  entered line. Pressing up-arrow again, replaces this with the line that was
 298  298  entered before it, etc.. Having gone back one or more lines into the history
 299  299  list, one can return to newer lines by pressing down-arrow one or more times.
 300  300  If you do this sufficient times, you will return to the original line that you
 301  301  were entering when you first hit up-arrow.
 302  302  .sp
 303  303  .LP
 304  304  Note that in \fBvi\fR mode, all of the history recall functions switch the
 305  305  library into command mode.
 306  306  .sp
 307  307  .LP
 308  308  In \fBemacs\fR mode the \fBM-p\fR and \fBM-n\fR keys work just like the
 309  309  \fB^P\fR and \fB^N\fR keys, except that they skip all but those historical
 310  310  lines which share the prefix that precedes the cursor. In \fBvi\fR command mode
 311  311  the upper case 'K' and 'J' characters do the same thing, except that the string
 312  312  that they search for includes the character under the cursor as well as what
 313  313  precedes it.
 314  314  .sp
 315  315  .LP
 316  316  Thus for example, suppose that you were in \fBemacs\fR mode, and you had just
 317  317  entered the following list of commands in the order shown:
 318  318  .sp
 319  319  .in +2
 320  320  .nf
 321  321  ls ~/tecla/
 322  322  cd ~/tecla
 323  323  ls -l getline.c
 324  324  \fBemacs\fR ~/tecla/getline.c
 325  325  .fi
 326  326  .in -2
 327  327  
 328  328  .sp
 329  329  .LP
 330  330  If you next typed:
 331  331  .sp
 332  332  .in +2
 333  333  .nf
 334  334  ls
 335  335  .fi
 336  336  .in -2
 337  337  
 338  338  .sp
 339  339  .LP
 340  340  and then hit \fBM-p\fR, then rather than returning the previously typed
 341  341  \fBemacs\fR line, which doesn't start with "ls", tecla would recall the "ls -l
 342  342  getline.c" line. Pressing \fBM-p\fR again would recall the "ls ~/tecla/" line.
 343  343  .sp
 344  344  .LP
 345  345  Note that if the string that you are searching for, contains any of the special
 346  346  characters, *, ?, or '[', then it is interpretted as a pattern to be matched.
 347  347  Thus, cotinuing with the above example, after typing in the list of commands
 348  348  shown, if you then typed:
 349  349  .sp
 350  350  .in +2
 351  351  .nf
 352  352  *tecla*
 353  353  .fi
 354  354  .in -2
 355  355  
 356  356  .sp
 357  357  .LP
 358  358  and hit \fBM-p\fR, then the "\fBemacs\fR ~/tecla/getline.c" line would be
 359  359  recalled first, since it contains the word tecla somewhere in the line,
 360  360  Similarly, hitting \fBM-p\fR again, would recall the "ls ~/tecla/" line, and
 361  361  hitting it once more would recall the "ls ~/tecla/" line. The pattern syntax is
 362  362  the same as that described for file name expansion, in the
 363  363  \fBef_expand_file\fR(3TECLA).
 364  364  .SS "History Files"
 365  365  .sp
 366  366  .LP
 367  367  Authors of programs that use the tecla library have the option of saving
 368  368  historical command-lines in a file before exiting, and subsequently reading
 369  369  them back in from this file when the program is next started. There is no
 370  370  standard name for this file, since it makes sense for each application to use
 371  371  its own history file, so that commands from different applications don't get
 372  372  mixed up.
 373  373  .SS "International Character Sets"
 374  374  .sp
 375  375  .LP
 376  376  Since \fBlibtecla\fR version 1.4.0, tecla has been 8-bit clean. This means that
 377  377  all 8-bit characters that are printable in the user's current locale are now
 378  378  displayed verbatim and included in the returned input line. Assuming that the
 379  379  calling program correctly contains a call like the following,
 380  380  .sp
 381  381  .in +2
 382  382  .nf
 383  383  setlocale(LC_CTYPE, "");
 384  384  .fi
 385  385  .in -2
 386  386  
 387  387  .sp
 388  388  .LP
 389  389  then the current locale is determined by the first of the environment variables
 390  390  \fBLC_CTYPE\fR, \fBLC_ALL\fR, and \fBLANG\fR, that is found to contain a valid
 391  391  locale name. If none of these variables are defined, or the program neglects to
 392  392  call \fBsetlocale\fR, then the default C locale is used, which is US 7-bit
 393  393  ASCII. On most unix-like platforms, you can get a list of valid locales by
 394  394  typing the command:
 395  395  .sp
 396  396  .in +2
 397  397  .nf
 398  398  locale -a
 399  399  .fi
 400  400  .in -2
 401  401  
 402  402  .sp
 403  403  .LP
 404  404  at the shell prompt.
 405  405  .SS "Meta Keys and Locales"
 406  406  .sp
 407  407  .LP
 408  408  Beware that in most locales other than the default C locale, META characters
 409  409  become printable, and they are then no longer considered to match \fBM-c\fR
 410  410  style key bindings. This allows international characters to be entered with the
 411  411  compose key without unexpectedly triggering META key bindings. You can still
 412  412  invoke META bindings, since there are actually two ways to do this. For example
 413  413  the binding \fBM-c\fR can also be invoked by pressing the ESCAPE key
 414  414  momentarily, then pressing the c key, and this will work regardless of locale.
 415  415  Moreover, many modern terminal emulators, such as gnome's gnome-terminal's and
 416  416  KDE's konsole terminals, already generate escape pairs like this when you use
 417  417  the META key, rather than a real meta character, and other emulators usually
 418  418  have a way to request this behavior, so you can continue to use the META key on
 419  419  most systems.
 420  420  .sp
 421  421  .LP
 422  422  For example, although xterm terminal emulators generate real 8-bit meta
 423  423  characters by default when you use the META key, they can be configured to
 424  424  output the equivalent escape pair by setting their \fBEightBitInput\fR X
 425  425  resource to False. You can either do this by placing a line like the following
 426  426  in your \fB~/.Xdefaults\fR file,
 427  427  .sp
 428  428  .in +2
 429  429  .nf
 430  430  XTerm*EightBitInput: False
 431  431  .fi
 432  432  .in -2
 433  433  
 434  434  .sp
 435  435  .LP
 436  436  or by starting an \fBxterm\fR with an \fB-xrm\fR \&'*EightBitInput: False'
 437  437  command-line argument. In recent versions of xterm you can toggle this feature
 438  438  on and off with the 'Meta Sends Escape' option in the menu that is displayed
 439  439  when you press the left mouse button and the CONTROL key within an xterm
 440  440  window. In CDE, dtterms can be similarly coerced to generate escape pairs in
 441  441  place of meta characters, by setting the \fBDtterm*KshMode\fR resource to True.
 442  442  .SS "Entering International Characters"
 443  443  .sp
 444  444  .LP
 445  445  If you don't have a keyboard that generates all of the international characters
 446  446  that you need, there is usually a compose key that will allow you to enter
 447  447  special characters, or a way to create one. For example, under X windows on
 448  448  unix-like systems, if your keyboard doesn't have a compose key, you can
 449  449  designate a redundant key to serve this purpose with the xmodmap command. For
 450  450  example, on many PC keyboards there is a microsoft-windows key, which is
 451  451  otherwise useless under Linux. On a laptop, for example, the \fBxev\fR program
 452  452  might report that pressing this key generates keycode 115. To turn this key
 453  453  into a COMPOSE  key, do the following:
 454  454  .sp
 455  455  .in +2
 456  456  .nf
 457  457  xmodmap -e 'keycode 115 = Multi_key'
 458  458  .fi
 459  459  .in -2
 460  460  
 461  461  .sp
 462  462  .LP
 463  463  Type this key followed by a " character to enter an 'I' with a umlaut over it.
 464  464  .SS "The Available Key Binding Functions"
 465  465  .sp
 466  466  .LP
 467  467  The following is a list of the editing functions provided by the tecla library.
 468  468  The names in the leftmost column of the list can be used in configuration files
 469  469  to specify which function a given key or combination of keys should invoke.
 470  470  They are also used in the next two sections to list the default key bindings in
 471  471  \fBemacs\fR and \fBvi\fR modes.
 472  472  .sp
 473  473  .ne 2
 474  474  .na
 475  475  \fBuser-interrupt\fR
 476  476  .ad
 477  477  .RS 30n
 478  478  Send a SIGINT signal to the parent process.
 479  479  .RE
 480  480  
 481  481  .sp
 482  482  .ne 2
 483  483  .na
 484  484  \fBsuspend\fR
 485  485  .ad
 486  486  .RS 30n
 487  487  Suspend the parent process.
 488  488  .RE
 489  489  
 490  490  .sp
 491  491  .ne 2
 492  492  .na
 493  493  \fBstop-output\fR
 494  494  .ad
 495  495  .RS 30n
 496  496  Pause terminal output.
 497  497  .RE
 498  498  
 499  499  .sp
 500  500  .ne 2
 501  501  .na
 502  502  \fBstart-output\fR
 503  503  .ad
 504  504  .RS 30n
 505  505  Resume paused terminal output.
 506  506  .RE
 507  507  
 508  508  .sp
 509  509  .ne 2
 510  510  .na
 511  511  \fBliteral-next\fR
 512  512  .ad
 513  513  .RS 30n
 514  514  Arrange for the next character to be treated as a normal character. This allows
 515  515  control characters to be entered.
 516  516  .RE
 517  517  
 518  518  .sp
 519  519  .ne 2
 520  520  .na
 521  521  \fBcursor-right\fR
 522  522  .ad
 523  523  .RS 30n
 524  524  Move the cursor one character right.
 525  525  .RE
 526  526  
 527  527  .sp
 528  528  .ne 2
 529  529  .na
 530  530  \fBcursor-left\fR
 531  531  .ad
 532  532  .RS 30n
 533  533  Move the cursor one character left.
 534  534  .RE
 535  535  
 536  536  .sp
 537  537  .ne 2
 538  538  .na
 539  539  \fBinsert-mode\fR
 540  540  .ad
 541  541  .RS 30n
 542  542  Toggle between insert mode and overwrite mode.
 543  543  .RE
 544  544  
 545  545  .sp
 546  546  .ne 2
 547  547  .na
 548  548  \fBbeginning-of-line\fR
 549  549  .ad
 550  550  .RS 30n
 551  551  Move the cursor to the beginning of the line.
 552  552  .RE
 553  553  
 554  554  .sp
 555  555  .ne 2
 556  556  .na
 557  557  \fBend-of-line\fR
 558  558  .ad
 559  559  .RS 30n
 560  560  Move the cursor to the end of the line.
 561  561  .RE
 562  562  
 563  563  .sp
 564  564  .ne 2
 565  565  .na
 566  566  \fBdelete-line\fR
 567  567  .ad
 568  568  .RS 30n
 569  569  Delete the contents of the current line.
 570  570  .RE
 571  571  
 572  572  .sp
 573  573  .ne 2
 574  574  .na
 575  575  \fBkill-line\fR
 576  576  .ad
 577  577  .RS 30n
 578  578  Delete everything that follows the cursor.
 579  579  .RE
 580  580  
 581  581  .sp
 582  582  .ne 2
 583  583  .na
 584  584  \fBbackward-kill-line\fR
 585  585  .ad
 586  586  .RS 30n
 587  587  Delete all characters between the cursor and the start of the line.
 588  588  .RE
 589  589  
 590  590  .sp
 591  591  .ne 2
 592  592  .na
 593  593  \fBforward-word\fR
 594  594  .ad
 595  595  .RS 30n
 596  596  Move to the end of the word which follows the cursor.
 597  597  .RE
 598  598  
 599  599  .sp
 600  600  .ne 2
 601  601  .na
 602  602  \fBforward-to-word\fR
 603  603  .ad
 604  604  .RS 30n
 605  605  Move the cursor to the start of the word that follows the cursor.
 606  606  .RE
 607  607  
 608  608  .sp
 609  609  .ne 2
 610  610  .na
 611  611  \fBbackward-word\fR
 612  612  .ad
 613  613  .RS 30n
 614  614  Move to the start of the word which precedes the cursor.
 615  615  .RE
 616  616  
 617  617  .sp
 618  618  .ne 2
 619  619  .na
 620  620  \fBgoto-column\fR
 621  621  .ad
 622  622  .RS 30n
 623  623  Move the cursor to the 1-relative column in the line specified by any preceding
 624  624  digit-argument sequences (see Entering Repeat Counts below).
 625  625  .RE
 626  626  
 627  627  .sp
 628  628  .ne 2
 629  629  .na
 630  630  \fBfind-parenthesis\fR
 631  631  .ad
 632  632  .RS 30n
 633  633  If the cursor is currently over a parenthesis character, move it to the
 634  634  matching parenthesis character. If not over a parenthesis character move right
 635  635  to the next close parenthesis.
 636  636  .RE
 637  637  
 638  638  .sp
 639  639  .ne 2
 640  640  .na
 641  641  \fBforward-delete-char\fR
 642  642  .ad
 643  643  .RS 30n
 644  644  Delete the character under the cursor.
 645  645  .RE
 646  646  
 647  647  .sp
 648  648  .ne 2
 649  649  .na
 650  650  \fBbackward-delete-char\fR
 651  651  .ad
 652  652  .RS 30n
 653  653  Delete the character which precedes the cursor.
 654  654  .RE
 655  655  
 656  656  .sp
 657  657  .ne 2
 658  658  .na
 659  659  \fBlist-or-eof\fR
 660  660  .ad
 661  661  .RS 30n
 662  662  This is intended for binding to \fB^D\fR. When invoked when the cursor is
 663  663  within the line it displays all possible completions then redisplays the line
 664  664  unchanged. When invoked on an empty line, it signals end-of-input (EOF) to the
 665  665  caller of \fBgl_get_line()\fR.
 666  666  .RE
 667  667  
 668  668  .sp
 669  669  .ne 2
 670  670  .na
 671  671  \fBdel-char-or-list-or-eof\fR
 672  672  .ad
 673  673  .RS 30n
 674  674  This is intended for binding to \fB^D\fR. When invoked when the cursor is
 675  675  within the line it invokes forward-delete-char. When invoked at the end of the
 676  676  line it displays all possible completions then redisplays the line unchanged.
 677  677  When invoked on an empty line, it signals end-of-input (EOF) to the caller of
 678  678  \fBgl_get_line()\fR.
 679  679  .RE
 680  680  
 681  681  .sp
 682  682  .ne 2
 683  683  .na
 684  684  \fBforward-delete-word\fR
 685  685  .ad
 686  686  .RS 30n
 687  687  Delete the word which follows the cursor.
 688  688  .RE
 689  689  
 690  690  .sp
 691  691  .ne 2
 692  692  .na
 693  693  \fBbackward-delete-word\fR
 694  694  .ad
 695  695  .RS 30n
 696  696  Delete the word which precedes the cursor.
 697  697  .RE
 698  698  
 699  699  .sp
 700  700  .ne 2
 701  701  .na
 702  702  \fBupcase-word\fR
 703  703  .ad
 704  704  .RS 30n
 705  705  Convert all of the characters of the word which follows the cursor, to upper
 706  706  case.
 707  707  .RE
 708  708  
 709  709  .sp
 710  710  .ne 2
 711  711  .na
 712  712  \fBdowncase-word\fR
 713  713  .ad
 714  714  .RS 30n
 715  715  Convert all of the characters of the word which follows the cursor, to lower
 716  716  case.
 717  717  .RE
 718  718  
 719  719  .sp
 720  720  .ne 2
 721  721  .na
 722  722  \fBcapitalize-word\fR
 723  723  .ad
 724  724  .RS 30n
 725  725  Capitalize the word which follows the cursor.
 726  726  .RE
 727  727  
 728  728  .sp
 729  729  .ne 2
 730  730  .na
 731  731  \fBchange-case\fR
 732  732  .ad
 733  733  .RS 30n
 734  734  If the next character is upper case, toggle it to lower case and vice versa.
 735  735  .RE
 736  736  
 737  737  .sp
 738  738  .ne 2
 739  739  .na
 740  740  \fBredisplay\fR
 741  741  .ad
 742  742  .RS 30n
 743  743  Redisplay the line.
 744  744  .RE
 745  745  
 746  746  .sp
 747  747  .ne 2
 748  748  .na
 749  749  \fBclear-screen\fR
 750  750  .ad
 751  751  .RS 30n
 752  752  Clear the terminal, then redisplay the current line.
 753  753  .RE
 754  754  
 755  755  .sp
 756  756  .ne 2
 757  757  .na
 758  758  \fBtranspose-chars\fR
 759  759  .ad
 760  760  .RS 30n
 761  761  Swap the character under the cursor with the character just before the cursor.
 762  762  .RE
 763  763  
 764  764  .sp
 765  765  .ne 2
 766  766  .na
 767  767  \fBset-mark\fR
 768  768  .ad
 769  769  .RS 30n
 770  770  Set a mark at the position of the cursor.
 771  771  .RE
 772  772  
 773  773  .sp
 774  774  .ne 2
 775  775  .na
 776  776  \fBexchange-point-and-mark\fR
 777  777  .ad
 778  778  .RS 30n
 779  779  Move the cursor to the last mark that was set, and move the mark to where the
 780  780  cursor used to be.
 781  781  .RE
 782  782  
 783  783  .sp
 784  784  .ne 2
 785  785  .na
 786  786  \fBkill-region\fR
 787  787  .ad
 788  788  .RS 30n
 789  789  Delete the characters that lie between the last mark that was set, and the
 790  790  cursor.
 791  791  .RE
 792  792  
 793  793  .sp
 794  794  .ne 2
 795  795  .na
 796  796  \fBcopy-region-as-kill\fR
 797  797  .ad
 798  798  .RS 30n
 799  799  Copy the text between the mark and the cursor to the cut buffer, without
 800  800  deleting the original text.
 801  801  .RE
 802  802  
 803  803  .sp
 804  804  .ne 2
 805  805  .na
 806  806  \fByank\fR
 807  807  .ad
 808  808  .RS 30n
 809  809  Insert the text that was last deleted, just before the current position of the
 810  810  cursor.
 811  811  .RE
 812  812  
 813  813  .sp
 814  814  .ne 2
 815  815  .na
 816  816  \fBappend-yank\fR
 817  817  .ad
 818  818  .RS 30n
 819  819  Paste the current contents of the cut buffer, after the cursor.
 820  820  .RE
 821  821  
 822  822  .sp
 823  823  .ne 2
 824  824  .na
 825  825  \fBup-history\fR
 826  826  .ad
 827  827  .RS 30n
 828  828  Recall the next oldest line that was entered. Note that in \fBvi\fR mode you
 829  829  are left in command mode.
 830  830  .RE
 831  831  
 832  832  .sp
 833  833  .ne 2
 834  834  .na
 835  835  \fBdown-history\fR
 836  836  .ad
 837  837  .RS 30n
 838  838  Recall the next most recent line that was entered. If no history recall session
 839  839  is currently active, the next line from a previous recall session is recalled.
 840  840  Note that in vi mode you are left in command mode.
 841  841  .RE
 842  842  
 843  843  .sp
 844  844  .ne 2
 845  845  .na
 846  846  \fBhistory-search-backward\fR
 847  847  .ad
 848  848  .RS 30n
 849  849  Recall the next oldest line who's prefix matches the string which currently
 850  850  precedes the cursor (in \fBvi\fR command-mode the character under the cursor is
 851  851  also included in the search string). Note that in \fBvi\fR mode you are left in
 852  852  command mode.
 853  853  .RE
 854  854  
 855  855  .sp
 856  856  .ne 2
 857  857  .na
 858  858  \fBhistory-search-forward\fR
 859  859  .ad
 860  860  .RS 30n
 861  861  Recall the next newest line who's prefix matches the string which currently
 862  862  precedes the cursor (in \fBvi\fR command-mode the character under the cursor is
 863  863  also included in the search string). Note that in \fBvi\fR mode you are left in
 864  864  command mode.
 865  865  .RE
 866  866  
 867  867  .sp
 868  868  .ne 2
 869  869  .na
 870  870  \fBhistory-re-search-backward\fR
 871  871  .ad
 872  872  .RS 30n
 873  873  Recall the next oldest line who's prefix matches that established by the last
 874  874  invocation of either history-search-forward or history-search-backward.
 875  875  .RE
 876  876  
 877  877  .sp
 878  878  .ne 2
 879  879  .na
 880  880  \fBhistory-re-search-forward\fR
 881  881  .ad
 882  882  .RS 30n
 883  883  Recall the next newest line who's prefix matches that established by the last
 884  884  invocation of either history-search-forward or history-search-backward.
 885  885  .RE
 886  886  
 887  887  .sp
 888  888  .ne 2
 889  889  .na
 890  890  \fBcomplete-word\fR
 891  891  .ad
 892  892  .RS 30n
 893  893  Attempt to complete the incomplete word which precedes the cursor. Unless the
 894  894  host program has customized word completion, file name completion is attempted.
 895  895  In \fBvi\fR commmand mode the character under the cursor is also included in
 896  896  the word being completed, and you are left in \fBvi\fR insert mode.
 897  897  .RE
 898  898  
 899  899  .sp
 900  900  .ne 2
 901  901  .na
 902  902  \fBexpand-filename\fR
 903  903  .ad
 904  904  .RS 30n
 905  905  Within the command line, expand wild cards, tilde expressions and dollar
 906  906  expressions in the file name which immediately precedes the cursor. In \fBvi\fR
 907  907  commmand mode the character under the cursor is also included in the file name
 908  908  being expanded, and you are left in \fBvi\fR insert mode.
 909  909  .RE
 910  910  
 911  911  .sp
 912  912  .ne 2
 913  913  .na
 914  914  \fBlist-glob\fR
 915  915  .ad
 916  916  .RS 30n
 917  917  List any file names which match the wild-card, tilde and dollar expressions in
 918  918  the file name which immediately precedes the cursor, then redraw the input line
 919  919  unchanged.
 920  920  .RE
 921  921  
 922  922  .sp
 923  923  .ne 2
 924  924  .na
 925  925  \fBlist-history\fR
 926  926  .ad
 927  927  .RS 30n
 928  928  Display the contents of the history list for the current history group. If a
 929  929  repeat count of \fB> 1\fR is specified, only that many of the most recent lines
 930  930  are displayed. See the Entering Repeat Counts section.
 931  931  .RE
 932  932  
 933  933  .sp
 934  934  .ne 2
 935  935  .na
 936  936  \fBread-from-file\fR
 937  937  .ad
 938  938  .RS 30n
 939  939  Temporarily switch to reading input from the file who's name precedes the
 940  940  cursor.
 941  941  .RE
 942  942  
 943  943  .sp
 944  944  .ne 2
 945  945  .na
 946  946  \fBread-init-files\fR
 947  947  .ad
 948  948  .RS 30n
 949  949  Re-read \fBteclarc\fR configuration files.
 950  950  .RE
 951  951  
 952  952  .sp
 953  953  .ne 2
 954  954  .na
 955  955  \fBbeginning-of-history\fR
 956  956  .ad
 957  957  .RS 30n
 958  958  Move to the oldest line in the history list. Note that in \fBvi\fR mode you are
 959  959  left in command mode.
 960  960  .RE
 961  961  
 962  962  .sp
 963  963  .ne 2
 964  964  .na
 965  965  \fBend-of-history\fR
 966  966  .ad
 967  967  .RS 30n
 968  968  Move to the newest line in the history list (ie. the current line). Note that
 969  969  in \fBvi\fR mode this leaves you in command mode.
 970  970  .RE
 971  971  
 972  972  .sp
 973  973  .ne 2
 974  974  .na
 975  975  \fBdigit-argument\fR
 976  976  .ad
 977  977  .RS 30n
 978  978  Enter a repeat count for the next key binding function. For details, see the

 979  979  Entering Repeat Counts section.
 980  980  .RE
 981  981  
 982  982  .sp
 983  983  .ne 2
 984  984  .na
 985  985  \fBnewline\fR
 986  986  .ad
 987  987  .RS 30n
 988  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
      989 +newline character. The newline character is normally '\en', but will be the
 990  990  first character of the key sequence that invoked the newline action, if this
 991  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
      992 +newline character or the '\er' carriage return character, the line is appended
 993  993  to the history buffer.
 994  994  .RE
 995  995  
 996  996  .sp
 997  997  .ne 2
 998  998  .na
 999  999  \fBrepeat-history\fR
1000 1000  .ad
1001 1001  .RS 30n
1002 1002  Return the line that is being edited, then arrange for the next most recent

1003 1003  entry in the history buffer to be recalled when tecla is next called.
1004 1004  Repeatedly invoking this action causes successive historical input lines to be
1005 1005  re-executed. Note that this action is equivalent to the 'Operate' action in
1006 1006  ksh.
1007 1007  .RE
1008 1008  
1009 1009  .sp
1010 1010  .ne 2
1011 1011  .na
1012 1012  \fBring-bell\fR
1013 1013  .ad
1014 1014  .RS 30n
1015 1015  Ring the terminal bell, unless the bell has been silenced via the nobeep
1016 1016  configuration option (see The Tecla Configuration File section).
1017 1017  .RE
1018 1018  
1019 1019  .sp
1020 1020  .ne 2
1021 1021  .na
1022 1022  \fBforward-copy-char\fR
1023 1023  .ad
1024 1024  .RS 30n
1025 1025  Copy the next character into the cut buffer (NB. use repeat counts to copy more
1026 1026  than one).
1027 1027  .RE
1028 1028  
1029 1029  .sp
1030 1030  .ne 2
1031 1031  .na
1032 1032  \fBbackward-copy-char\fR
1033 1033  .ad
1034 1034  .RS 30n
1035 1035  Copy the previous character into the cut buffer.
1036 1036  .RE
1037 1037  
1038 1038  .sp
1039 1039  .ne 2
1040 1040  .na
1041 1041  \fBforward-copy-word\fR
1042 1042  .ad
1043 1043  .RS 30n
1044 1044  Copy the next word into the cut buffer.
1045 1045  .RE
1046 1046  
1047 1047  .sp
1048 1048  .ne 2
1049 1049  .na
1050 1050  \fBbackward-copy-word\fR
1051 1051  .ad
1052 1052  .RS 30n
1053 1053  Copy the previous word into the cut buffer.
1054 1054  .RE
1055 1055  
1056 1056  .sp
1057 1057  .ne 2
1058 1058  .na
1059 1059  \fBforward-find-char\fR
1060 1060  .ad
1061 1061  .RS 30n
1062 1062  Move the cursor to the next occurrence of the next character that you type.
1063 1063  .RE
1064 1064  
1065 1065  .sp
1066 1066  .ne 2
1067 1067  .na
1068 1068  \fBbackward-find-char\fR
1069 1069  .ad
1070 1070  .RS 30n
1071 1071  Move the cursor to the last occurrence of the next character that you type.
1072 1072  .RE
1073 1073  
1074 1074  .sp
1075 1075  .ne 2
1076 1076  .na
1077 1077  \fBforward-to-char\fR
1078 1078  .ad
1079 1079  .RS 30n
1080 1080  Move the cursor to the character just before the next occurrence of the next
1081 1081  character that the user types.
1082 1082  .RE
1083 1083  
1084 1084  .sp
1085 1085  .ne 2
1086 1086  .na
1087 1087  \fBbackward-to-char\fR
1088 1088  .ad
1089 1089  .RS 30n
1090 1090  Move the cursor to the character just after the last occurrence before the
1091 1091  cursor of the next character that the user types.
1092 1092  .RE
1093 1093  
1094 1094  .sp
1095 1095  .ne 2
1096 1096  .na
1097 1097  \fBrepeat-find-char\fR
1098 1098  .ad
1099 1099  .RS 30n
1100 1100  Repeat the last backward-find-char, forward-find-char, backward-to-char or
1101 1101  forward-to-char.
1102 1102  .RE
1103 1103  
1104 1104  .sp
1105 1105  .ne 2
1106 1106  .na
1107 1107  \fBinvert-refind-char\fR
1108 1108  .ad
1109 1109  .RS 30n
1110 1110  Repeat the last backward-find-char, forward-find-char, backward-to-char, or
1111 1111  forward-to-char in the opposite direction.
1112 1112  .RE
1113 1113  
1114 1114  .sp
1115 1115  .ne 2
1116 1116  .na
1117 1117  \fBdelete-to-column\fR
1118 1118  .ad
1119 1119  .RS 30n
1120 1120  Delete the characters from the cursor up to the column that is specified by the
1121 1121  repeat count.
1122 1122  .RE
1123 1123  
1124 1124  .sp
1125 1125  .ne 2
1126 1126  .na
1127 1127  \fBdelete-to-parenthesis\fR
1128 1128  .ad
1129 1129  .RS 30n
1130 1130  Delete the characters from the cursor up to and including the matching
1131 1131  parenthesis, or next close parenthesis.
1132 1132  .RE
1133 1133  
1134 1134  .sp
1135 1135  .ne 2
1136 1136  .na
1137 1137  \fBforward-delete-find\fR
1138 1138  .ad
1139 1139  .RS 30n
1140 1140  Delete the characters from the cursor up to and including the following
1141 1141  occurence of the next character typed.
1142 1142  .RE
1143 1143  
1144 1144  .sp
1145 1145  .ne 2
1146 1146  .na
1147 1147  \fBbackward-delete-find\fR
1148 1148  .ad
1149 1149  .RS 30n
1150 1150  Delete the characters from the cursor up to and including the preceding
1151 1151  occurence of the next character typed.
1152 1152  .RE
1153 1153  
1154 1154  .sp
1155 1155  .ne 2
1156 1156  .na
1157 1157  \fBforward-delete-to\fR
1158 1158  .ad
1159 1159  .RS 30n
1160 1160  Delete the characters from the cursor up to, but not including, the following
1161 1161  occurence of the next character typed.
1162 1162  .RE
1163 1163  
1164 1164  .sp
1165 1165  .ne 2
1166 1166  .na
1167 1167  \fBbackward-delete-to\fR
1168 1168  .ad
1169 1169  .RS 30n
1170 1170  Delete the characters from the cursor up to, but not including, the preceding
1171 1171  occurence of the next character typed.
1172 1172  .RE
1173 1173  
1174 1174  .sp
1175 1175  .ne 2
1176 1176  .na
1177 1177  \fBdelete-refind\fR
1178 1178  .ad
1179 1179  .RS 30n
1180 1180  Repeat the last *-delete-find or *-delete-to action.
1181 1181  .RE
1182 1182  
1183 1183  .sp
1184 1184  .ne 2
1185 1185  .na
1186 1186  \fBdelete-invert-refind\fR
1187 1187  .ad
1188 1188  .RS 30n
1189 1189  Repeat the last *-delete-find or *-delete-to action, in the opposite direction.
1190 1190  .RE
1191 1191  
1192 1192  .sp
1193 1193  .ne 2
1194 1194  .na
1195 1195  \fBcopy-to-column\fR
1196 1196  .ad
1197 1197  .RS 30n
1198 1198  Copy the characters from the cursor up to the column that is specified by the
1199 1199  repeat count, into the cut buffer.
1200 1200  .RE
1201 1201  
1202 1202  .sp
1203 1203  .ne 2
1204 1204  .na
1205 1205  \fBcopy-to-parenthesis\fR
1206 1206  .ad
1207 1207  .RS 30n
1208 1208  Copy the characters from the cursor up to and including the matching
1209 1209  parenthesis, or next close parenthesis, into the cut buffer.
1210 1210  .RE
1211 1211  
1212 1212  .sp
1213 1213  .ne 2
1214 1214  .na
1215 1215  \fBforward-copy-find\fR
1216 1216  .ad
1217 1217  .RS 30n
1218 1218  Copy the characters from the cursor up to and including the following occurence
1219 1219  of the next character typed, into the cut buffer.
1220 1220  .RE
1221 1221  
1222 1222  .sp
1223 1223  .ne 2
1224 1224  .na
1225 1225  \fBbackward-copy-find\fR
1226 1226  .ad
1227 1227  .RS 30n
1228 1228  Copy the characters from the cursor up to and including the preceding occurence
1229 1229  of the next character typed, into the cut buffer.
1230 1230  .RE
1231 1231  
1232 1232  .sp
1233 1233  .ne 2
1234 1234  .na
1235 1235  \fBforward-copy-to\fR
1236 1236  .ad
1237 1237  .RS 30n
1238 1238  Copy the characters from the cursor up to, but not including, the following
1239 1239  occurence of the next character typed, into the cut buffer.
1240 1240  .RE
1241 1241  
1242 1242  .sp
1243 1243  .ne 2
1244 1244  .na
1245 1245  \fBbackward-copy-to\fR
1246 1246  .ad
1247 1247  .RS 30n
1248 1248  Copy the characters from the cursor up to, but not including, the preceding
1249 1249  occurence of the next character typed, into the cut buffer.
1250 1250  .RE
1251 1251  
1252 1252  .sp
1253 1253  .ne 2
1254 1254  .na
1255 1255  \fBcopy-refind\fR
1256 1256  .ad
1257 1257  .RS 30n
1258 1258  Repeat the last *-copy-find or *-copy-to action.
1259 1259  .RE
1260 1260  
1261 1261  .sp
1262 1262  .ne 2
1263 1263  .na
1264 1264  \fBcopy-invert-refind\fR
1265 1265  .ad
1266 1266  .RS 30n
1267 1267  Repeat the last *-copy-find or *-copy-to action, in the opposite direction.
1268 1268  .RE
1269 1269  
1270 1270  .sp
1271 1271  .ne 2
1272 1272  .na
1273 1273  \fBvi-mode\fR
1274 1274  .ad
1275 1275  .RS 30n
1276 1276  Switch to \fBvi\fR mode from emacs mode.
1277 1277  .RE
1278 1278  
1279 1279  .sp
1280 1280  .ne 2
1281 1281  .na
1282 1282  \fBemacs-mode\fR
1283 1283  .ad
1284 1284  .RS 30n
1285 1285  Switch to \fBemacs\fR mode from \fBvi\fR mode.
1286 1286  .RE
1287 1287  
1288 1288  .sp
1289 1289  .ne 2
1290 1290  .na
1291 1291  \fBvi-insert\fR
1292 1292  .ad
1293 1293  .RS 30n
1294 1294  From \fBvi\fR command mode, switch to insert mode.
1295 1295  .RE
1296 1296  
1297 1297  .sp
1298 1298  .ne 2
1299 1299  .na
1300 1300  \fBvi-overwrite\fR
1301 1301  .ad
1302 1302  .RS 30n
1303 1303  From \fBvi\fR command mode, switch to overwrite mode.
1304 1304  .RE
1305 1305  
1306 1306  .sp
1307 1307  .ne 2
1308 1308  .na
1309 1309  \fBvi-insert-at-bol\fR
1310 1310  .ad
1311 1311  .RS 30n
1312 1312  From \fBvi\fR command mode, move the cursor to the start of the line and switch
1313 1313  to insert mode.
1314 1314  .RE
1315 1315  
1316 1316  .sp
1317 1317  .ne 2
1318 1318  .na
1319 1319  \fBvi-append-at-eol\fR
1320 1320  .ad
1321 1321  .RS 30n
1322 1322  From \fBvi\fR command mode, move the cursor to the end of the line and switch
1323 1323  to append mode.
1324 1324  .RE
1325 1325  
1326 1326  .sp
1327 1327  .ne 2
1328 1328  .na
1329 1329  \fBvi-append\fR
1330 1330  .ad
1331 1331  .RS 30n
1332 1332  From \fBvi\fR command mode, move the cursor one position right, and switch to
1333 1333  insert mode.
1334 1334  .RE
1335 1335  
1336 1336  .sp
1337 1337  .ne 2
1338 1338  .na
1339 1339  \fBvi-replace-char\fR
1340 1340  .ad
1341 1341  .RS 30n
1342 1342  From \fBvi\fR command mode, replace the character under the cursor with the
1343 1343  next character entered.
1344 1344  .RE
1345 1345  
1346 1346  .sp
1347 1347  .ne 2
1348 1348  .na
1349 1349  \fBvi-forward-change-char\fR
1350 1350  .ad
1351 1351  .RS 30n
1352 1352  From \fBvi\fR command mode, delete the next character then enter insert mode.
1353 1353  .RE
1354 1354  
1355 1355  .sp
1356 1356  .ne 2
1357 1357  .na
1358 1358  \fBvi-backward-change-char\fR
1359 1359  .ad
1360 1360  .RS 30n
1361 1361  From vi command mode, delete the preceding character then enter insert mode.
1362 1362  .RE
1363 1363  
1364 1364  .sp
1365 1365  .ne 2
1366 1366  .na
1367 1367  \fBvi-forward-change-word\fR
1368 1368  .ad
1369 1369  .RS 30n
1370 1370  From \fBvi\fR command mode, delete the next word then enter insert mode.
1371 1371  .RE
1372 1372  
1373 1373  .sp
1374 1374  .ne 2
1375 1375  .na
1376 1376  \fBvi-backward-change-word\fR
1377 1377  .ad
1378 1378  .RS 30n
1379 1379  From vi command mode, delete the preceding word then enter insert mode.
1380 1380  .RE
1381 1381  
1382 1382  .sp
1383 1383  .ne 2
1384 1384  .na
1385 1385  \fBvi-change-rest-of-line\fR
1386 1386  .ad
1387 1387  .RS 30n
1388 1388  From \fBvi\fR command mode, delete from the cursor to the end of the line, then
1389 1389  enter insert mode.
1390 1390  .RE
1391 1391  
1392 1392  .sp
1393 1393  .ne 2
1394 1394  .na
1395 1395  \fBvi-change-line\fR
1396 1396  .ad
1397 1397  .RS 30n
1398 1398  From \fBvi\fR command mode, delete the current line, then enter insert mode.
1399 1399  .RE
1400 1400  
1401 1401  .sp
1402 1402  .ne 2
1403 1403  .na
1404 1404  \fBvi-change-to-bol\fR
1405 1405  .ad
1406 1406  .RS 30n
1407 1407  From \fBvi\fR command mode, delete all characters between the cursor and the
1408 1408  beginning of the line, then enter insert mode.
1409 1409  .RE
1410 1410  
1411 1411  .sp
1412 1412  .ne 2
1413 1413  .na
1414 1414  \fBvi-change-to-column\fR
1415 1415  .ad
1416 1416  .RS 30n
1417 1417  From \fBvi\fR command mode, delete the characters from the cursor up to the
1418 1418  column that is specified by the repeat count, then enter insert mode.
1419 1419  .RE
1420 1420  
1421 1421  .sp
1422 1422  .ne 2
1423 1423  .na
1424 1424  \fBvi-change-to-parenthesis\fR
1425 1425  .ad
1426 1426  .RS 30n
1427 1427  Delete the characters from the cursor up to and including the matching
1428 1428  parenthesis, or next close parenthesis, then enter \fBvi\fR insert mode.
1429 1429  .RE
1430 1430  
1431 1431  .sp
1432 1432  .ne 2
1433 1433  .na
1434 1434  \fBvi-forward-change-find\fR
1435 1435  .ad
1436 1436  .RS 30n
1437 1437  From \fBvi\fR command mode, delete the characters from the cursor up to and
1438 1438  including the following occurence of the next character typed, then enter
1439 1439  insert mode.
1440 1440  .RE
1441 1441  
1442 1442  .sp
1443 1443  .ne 2
1444 1444  .na
1445 1445  \fBvi-backward-change-find\fR
1446 1446  .ad
1447 1447  .RS 30n
1448 1448  From vi command mode, delete the characters from the cursor up to and including
1449 1449  the preceding occurence of the next character typed, then enter insert mode.
1450 1450  .RE
1451 1451  
1452 1452  .sp
1453 1453  .ne 2
1454 1454  .na
1455 1455  \fBvi-forward-change-to\fR
1456 1456  .ad
1457 1457  .RS 30n
1458 1458  From \fBvi\fR command mode, delete the characters from the cursor up to, but
1459 1459  not including, the following occurence of the next character typed, then enter
1460 1460  insert mode.
1461 1461  .RE
1462 1462  
1463 1463  .sp
1464 1464  .ne 2
1465 1465  .na
1466 1466  \fBvi-backward-change-to\fR
1467 1467  .ad
1468 1468  .RS 30n
1469 1469  From \fBvi\fR command mode, delete the characters from the cursor up to, but
1470 1470  not including, the preceding occurence of the next character typed, then enter
1471 1471  insert mode.
1472 1472  .RE
1473 1473  
1474 1474  .sp
1475 1475  .ne 2
1476 1476  .na
1477 1477  \fBvi-change-refind\fR
1478 1478  .ad
1479 1479  .RS 30n
1480 1480  Repeat the last vi-*-change-find or vi-*-change-to action.
1481 1481  .RE
1482 1482  
1483 1483  .sp
1484 1484  .ne 2
1485 1485  .na
1486 1486  \fBvi-change-invert-refind\fR
1487 1487  .ad
1488 1488  .RS 30n
1489 1489  Repeat the last vi-*-change-find or vi-*-change-to action, in the opposite
1490 1490  direction.
1491 1491  .RE
1492 1492  
1493 1493  .sp
1494 1494  .ne 2
1495 1495  .na
1496 1496  \fBvi-undo\fR
1497 1497  .ad
1498 1498  .RS 30n
1499 1499  In \fBvi\fR mode, undo the last editing operation.
1500 1500  .RE
1501 1501  
1502 1502  .sp
1503 1503  .ne 2
1504 1504  .na
1505 1505  \fBvi-repeat-change\fR
1506 1506  .ad
1507 1507  .RS 30n
1508 1508  In \fBvi\fR command mode, repeat the last command that modified the line.
1509 1509  .RE
1510 1510  
1511 1511  .SS "Default Key Bindings In \fBemacs\fR Mode"
1512 1512  .sp
1513 1513  .LP
1514 1514  The following default key bindings, which can be overriden by the tecla
1515 1515  configuration file, are designed to mimic most of the bindings of the unix
1516 1516  \fBtcsh shell\fR shell, when it is in \fBemacs\fR editing mode.
1517 1517  .sp
1518 1518  .LP
1519 1519  This is the default editing mode of the tecla library.
1520 1520  .sp
1521 1521  .LP
1522 1522  Under UNIX the terminal driver sets a number of special keys for certain
1523 1523  functions. The tecla library attempts to use the same key bindings to maintain
1524 1524  consistency. The key sequences shown for the following 6 bindings are thus just
1525 1525  examples of what they will probably be set to. If you have used the stty
1526 1526  command to change these keys, then the default bindings should match.
1527 1527  .sp
1528 1528  .ne 2
1529 1529  .na
1530 1530  \fB\fB^C\fR\fR
1531 1531  .ad
1532 1532  .RS 6n
1533 1533  user-interrupt
1534 1534  .RE
1535 1535  
1536 1536  .sp
1537 1537  .ne 2
1538 1538  .na
1539 1539  \fB\fB^\\fR\fR
1540 1540  .ad
1541 1541  .RS 6n
1542 1542  abort
1543 1543  .RE
1544 1544  
1545 1545  .sp
1546 1546  .ne 2
1547 1547  .na
1548 1548  \fB\fB^Z\fR\fR
1549 1549  .ad
1550 1550  .RS 6n
1551 1551  suspend
1552 1552  .RE
1553 1553  
1554 1554  .sp
1555 1555  .ne 2
1556 1556  .na
1557 1557  \fB\fB^Q\fR\fR
1558 1558  .ad
1559 1559  .RS 6n
1560 1560  start-output
1561 1561  .RE
1562 1562  
1563 1563  .sp
1564 1564  .ne 2
1565 1565  .na
1566 1566  \fB\fB^S\fR\fR
1567 1567  .ad
1568 1568  .RS 6n
1569 1569  stop-output
1570 1570  .RE
1571 1571  
1572 1572  .sp
1573 1573  .ne 2
1574 1574  .na
1575 1575  \fB\fB^V\fR\fR
1576 1576  .ad
1577 1577  .RS 6n
1578 1578  literal-next
1579 1579  .RE
1580 1580  
1581 1581  .sp
1582 1582  .LP
1583 1583  The cursor keys are refered to by name, as follows. This is necessary because
1584 1584  different types of terminals generate different key sequences when their cursor
1585 1585  keys are pressed.
1586 1586  .sp
1587 1587  .ne 2
1588 1588  .na
1589 1589  \fBright\fR
1590 1590  .ad
1591 1591  .RS 9n
1592 1592  cursor-right
1593 1593  .RE
1594 1594  
1595 1595  .sp
1596 1596  .ne 2
1597 1597  .na
1598 1598  \fBleft\fR
1599 1599  .ad
1600 1600  .RS 9n
1601 1601  cursor-left
1602 1602  .RE
1603 1603  
1604 1604  .sp
1605 1605  .ne 2
1606 1606  .na
1607 1607  \fBup\fR
1608 1608  .ad
1609 1609  .RS 9n
1610 1610  up-history
1611 1611  .RE
1612 1612  
1613 1613  .sp
1614 1614  .ne 2
1615 1615  .na
1616 1616  \fBdown\fR
1617 1617  .ad
1618 1618  .RS 9n
1619 1619  down-history
1620 1620  .RE
1621 1621  
1622 1622  .sp
1623 1623  .LP
1624 1624  The remaining bindings don't depend on the terminal setttings.
1625 1625  .sp
1626 1626  .ne 2
1627 1627  .na
1628 1628  \fB\fB^F\fR\fR
1629 1629  .ad
1630 1630  .RS 21n
1631 1631  cursor-right
1632 1632  .RE
1633 1633  
1634 1634  .sp
1635 1635  .ne 2
1636 1636  .na
1637 1637  \fB\fB^B\fR\fR
1638 1638  .ad
1639 1639  .RS 21n
1640 1640  cursor-left
1641 1641  .RE
1642 1642  
1643 1643  .sp
1644 1644  .ne 2
1645 1645  .na
1646 1646  \fB\fBM-i\fR\fR
1647 1647  .ad
1648 1648  .RS 21n
1649 1649  insert-mode
1650 1650  .RE
1651 1651  
1652 1652  .sp
1653 1653  .ne 2
1654 1654  .na
1655 1655  \fB\fB^A\fR\fR
1656 1656  .ad
1657 1657  .RS 21n
1658 1658  beginning-of-line
1659 1659  .RE
1660 1660  
1661 1661  .sp
1662 1662  .ne 2
1663 1663  .na
1664 1664  \fB\fB^E\fR\fR
1665 1665  .ad
1666 1666  .RS 21n
1667 1667  end-of-line
1668 1668  .RE
1669 1669  
1670 1670  .sp
1671 1671  .ne 2
1672 1672  .na
1673 1673  \fB\fB^U\fR\fR
1674 1674  .ad
1675 1675  .RS 21n
1676 1676  delete-line
1677 1677  .RE
1678 1678  
1679 1679  .sp
1680 1680  .ne 2
1681 1681  .na
1682 1682  \fB\fB^K\fR\fR
1683 1683  .ad
1684 1684  .RS 21n
1685 1685  kill-line
1686 1686  .RE
1687 1687  
1688 1688  .sp
1689 1689  .ne 2
1690 1690  .na
1691 1691  \fB\fBM-f\fR\fR
1692 1692  .ad
1693 1693  .RS 21n
1694 1694  forward-word
1695 1695  .RE
1696 1696  
1697 1697  .sp
1698 1698  .ne 2
1699 1699  .na
1700 1700  \fB\fBM-b\fR\fR
1701 1701  .ad
1702 1702  .RS 21n
1703 1703  backward-word
1704 1704  .RE
1705 1705  
1706 1706  .sp
1707 1707  .ne 2
1708 1708  .na
1709 1709  \fB\fB^D\fR\fR
1710 1710  .ad
1711 1711  .RS 21n
1712 1712  del-char-or-list-or-eof
1713 1713  .RE
1714 1714  
1715 1715  .sp
1716 1716  .ne 2
1717 1717  .na
1718 1718  \fB\fB^H\fR\fR
1719 1719  .ad
1720 1720  .RS 21n
1721 1721  backward-delete-char
1722 1722  .RE
1723 1723  
1724 1724  .sp
1725 1725  .ne 2
1726 1726  .na
1727 1727  \fB\fB^?\fR\fR
1728 1728  .ad
1729 1729  .RS 21n
1730 1730  backward-delete-char
1731 1731  .RE
1732 1732  
1733 1733  .sp
1734 1734  .ne 2
1735 1735  .na
1736 1736  \fB\fBM-d\fR\fR
1737 1737  .ad
1738 1738  .RS 21n
1739 1739  forward-delete-word
1740 1740  .RE
1741 1741  
1742 1742  .sp
1743 1743  .ne 2
1744 1744  .na
1745 1745  \fB\fBM-^H\fR\fR
1746 1746  .ad
1747 1747  .RS 21n
1748 1748  backward-delete-word
1749 1749  .RE
1750 1750  
1751 1751  .sp
1752 1752  .ne 2
1753 1753  .na
1754 1754  \fB\fBM-^?\fR\fR
1755 1755  .ad
1756 1756  .RS 21n
1757 1757  backward-delete-word
1758 1758  .RE
1759 1759  
1760 1760  .sp
1761 1761  .ne 2
1762 1762  .na
1763 1763  \fB\fBM-u\fR\fR
1764 1764  .ad
1765 1765  .RS 21n
1766 1766  upcase-word
1767 1767  .RE
1768 1768  
1769 1769  .sp
1770 1770  .ne 2
1771 1771  .na
1772 1772  \fB\fBM-l\fR\fR
1773 1773  .ad
1774 1774  .RS 21n
1775 1775  downcase-word
1776 1776  .RE
1777 1777  
1778 1778  .sp
1779 1779  .ne 2
1780 1780  .na
1781 1781  \fB\fBM-c\fR\fR
1782 1782  .ad
1783 1783  .RS 21n
1784 1784  capitalize-word
1785 1785  .RE
1786 1786  
1787 1787  .sp
1788 1788  .ne 2
1789 1789  .na
1790 1790  \fB\fB^R\fR\fR
1791 1791  .ad
1792 1792  .RS 21n
1793 1793  redisplay
1794 1794  .RE
1795 1795  
1796 1796  .sp
1797 1797  .ne 2
1798 1798  .na
1799 1799  \fB\fB^L\fR\fR
1800 1800  .ad
1801 1801  .RS 21n
1802 1802  clear-screen
1803 1803  .RE
1804 1804  
1805 1805  .sp
1806 1806  .ne 2
1807 1807  .na
1808 1808  \fB\fB^T\fR\fR
1809 1809  .ad
1810 1810  .RS 21n
1811 1811  transpose-chars
1812 1812  .RE
1813 1813  
1814 1814  .sp
1815 1815  .ne 2
1816 1816  .na
1817 1817  \fB\fB^@\fR\fR
1818 1818  .ad
1819 1819  .RS 21n
1820 1820  set-mark
1821 1821  .RE
1822 1822  
1823 1823  .sp
1824 1824  .ne 2
1825 1825  .na
1826 1826  \fB\fB^X^X\fR\fR
1827 1827  .ad
1828 1828  .RS 21n
1829 1829  exchange-point-and-mark
1830 1830  .RE
1831 1831  
1832 1832  .sp
1833 1833  .ne 2
1834 1834  .na
1835 1835  \fB\fB^W\fR\fR
1836 1836  .ad
1837 1837  .RS 21n
1838 1838  kill-region
1839 1839  .RE
1840 1840  
1841 1841  .sp
1842 1842  .ne 2
1843 1843  .na
1844 1844  \fB\fBM-w\fR\fR
1845 1845  .ad
1846 1846  .RS 21n
1847 1847  copy-region-as-kill
1848 1848  .RE
1849 1849  
1850 1850  .sp
1851 1851  .ne 2
1852 1852  .na
1853 1853  \fB\fB^Y\fR\fR
1854 1854  .ad
1855 1855  .RS 21n
1856 1856  yank
1857 1857  .RE
1858 1858  
1859 1859  .sp
1860 1860  .ne 2
1861 1861  .na
1862 1862  \fB\fB^P\fR\fR
1863 1863  .ad
1864 1864  .RS 21n
1865 1865  up-history
1866 1866  .RE
1867 1867  
1868 1868  .sp
1869 1869  .ne 2
1870 1870  .na
1871 1871  \fB\fB^N\fR\fR
1872 1872  .ad
1873 1873  .RS 21n
1874 1874  down-history
1875 1875  .RE
1876 1876  
1877 1877  .sp
1878 1878  .ne 2
1879 1879  .na
1880 1880  \fB\fBM-p\fR\fR
1881 1881  .ad
1882 1882  .RS 21n
1883 1883  history-search-backward
1884 1884  .RE
1885 1885  
1886 1886  .sp
1887 1887  .ne 2
1888 1888  .na
1889 1889  \fB\fBM-n\fR\fR
1890 1890  .ad
1891 1891  .RS 21n
1892 1892  history-search-forward
1893 1893  .RE
1894 1894  
1895 1895  .sp
1896 1896  .ne 2
1897 1897  .na
1898 1898  \fB\fB^I\fR\fR
1899 1899  .ad
1900 1900  .RS 21n
1901 1901  complete-word
1902 1902  .RE
1903 1903  
1904 1904  .sp
1905 1905  .ne 2
1906 1906  .na
1907 1907  \fB\fB^X*\fR\fR
1908 1908  .ad
1909 1909  .RS 21n
1910 1910  expand-filename
1911 1911  .RE
1912 1912  
1913 1913  .sp
1914 1914  .ne 2
1915 1915  .na
1916 1916  \fB\fB^X^F\fR\fR
1917 1917  .ad
1918 1918  .RS 21n
1919 1919  read-from-file
1920 1920  .RE
1921 1921  
1922 1922  .sp
1923 1923  .ne 2
1924 1924  .na
1925 1925  \fB\fB^X^R\fR\fR
1926 1926  .ad
1927 1927  .RS 21n
1928 1928  read-init-files
1929 1929  .RE
1930 1930  
1931 1931  .sp
1932 1932  .ne 2
1933 1933  .na
1934 1934  \fB\fB^Xg\fR\fR
1935 1935  .ad
1936 1936  .RS 21n
1937 1937  list-glob
1938 1938  .RE
1939 1939  
1940 1940  .sp
1941 1941  .ne 2
1942 1942  .na
1943 1943  \fB\fB^Xh\fR\fR
1944 1944  .ad
1945 1945  .RS 21n
1946 1946  list-history
1947 1947  .RE
1948 1948  
1949 1949  .sp
1950 1950  .ne 2
1951 1951  .na
1952 1952  \fB\fBM-<\fR\fR
1953 1953  .ad
1954 1954  .RS 21n
1955 1955  beginning-of-history
1956 1956  .RE
1957 1957  
1958 1958  .sp
1959 1959  .ne 2

1960 1960  .na
1961 1961  \fB\fBM->\fR\fR
1962 1962  .ad
1963 1963  .RS 21n
1964 1964  end-of-history
1965 1965  .RE
1966 1966  
1967 1967  .sp
1968 1968  .ne 2
1969 1969  .na
1970      -\fB\fB\n\fR\fR
     1970 +\fB\fB\en\fR\fR
1971 1971  .ad
1972 1972  .RS 21n
1973 1973  newline
1974 1974  .RE
1975 1975  
1976 1976  .sp
1977 1977  .ne 2
1978 1978  .na
1979      -\fB\fB\r\fR\fR
     1979 +\fB\fB\er\fR\fR
1980 1980  .ad
1981 1981  .RS 21n
1982 1982  newline
1983 1983  .RE
1984 1984  
1985 1985  .sp
1986 1986  .ne 2
1987 1987  .na
1988 1988  \fB\fBM-o\fR\fR
1989 1989  .ad

1990 1990  .RS 21n
1991 1991  repeat-history
1992 1992  .RE
1993 1993  
1994 1994  .sp
1995 1995  .ne 2
1996 1996  .na
1997 1997  \fB\fBM-^V\fR\fR
1998 1998  .ad
1999 1999  .RS 21n
2000 2000  \fBvi\fR-mode
2001 2001  .RE
2002 2002  
2003 2003  .sp
2004 2004  .ne 2
2005 2005  .na
2006 2006  \fB\fBM-0, M-1, ... M-9\fR\fR
2007 2007  .ad
2008 2008  .RS 21n
2009 2009  digit-argument (see below)
2010 2010  .RE
2011 2011  
2012 2012  .sp
2013 2013  .LP
2014 2014  Note that \fB^I\fR is what the TAB key generates, and that \fB^@\fR can be
2015 2015  generated not only by pressing the CONTROL key and the @ key simultaneously,
2016 2016  but also by pressing the CONTROL key and the space bar at the same time.
2017 2017  .SS "Default Key Bindings in \fBvi\fR Mode"
2018 2018  .sp
2019 2019  .LP
2020 2020  The following default key bindings are designed to mimic the \fBvi\fR style of
2021 2021  editing as closely as possible. This means that very few editing functions are
2022 2022  provided in the initial character input mode, editing functions instead being
2023 2023  provided by the \fBvi\fR command mode. The \fBvi\fR command mode is entered
2024 2024  whenever the ESCAPE character is pressed, or whenever a key sequence that
2025 2025  starts with a meta character is entered. In addition to mimicing \fBvi\fR,
2026 2026  \fBlibtecla\fR provides bindings for tab completion, wild-card expansion of
2027 2027  file names, and historical line recall.
2028 2028  .sp
2029 2029  .LP
2030 2030  To learn how to tell the tecla library to use \fBvi\fR mode instead of the
2031 2031  default \fBemacs\fR editing mode, see the earlier section entitled The Tecla
2032 2032  Configuration File.
2033 2033  .sp
2034 2034  .LP
2035 2035  Under UNIX the terminal driver sets a number of special keys for certain
2036 2036  functions. The tecla library attempts to use the same key bindings to maintain
2037 2037  consistency, binding them both in input mode and in command mode. The key
2038 2038  sequences shown for the following 6 bindings are thus just examples of what
2039 2039  they will probably be set to. If you have used the \fBstty\fR command to change
2040 2040  these keys, then the default bindings should match.
2041 2041  .sp
2042 2042  .ne 2
2043 2043  .na
2044 2044  \fB\fB^C\fR\fR
2045 2045  .ad
2046 2046  .RS 8n
2047 2047  user-interrupt
2048 2048  .RE
2049 2049  
2050 2050  .sp
2051 2051  .ne 2
2052 2052  .na
2053 2053  \fB\fB^\\fR\fR
2054 2054  .ad
2055 2055  .RS 8n
2056 2056  abort
2057 2057  .RE
2058 2058  
2059 2059  .sp
2060 2060  .ne 2
2061 2061  .na
2062 2062  \fB\fB^Z\fR\fR
2063 2063  .ad
2064 2064  .RS 8n
2065 2065  suspend
2066 2066  .RE
2067 2067  
2068 2068  .sp
2069 2069  .ne 2
2070 2070  .na
2071 2071  \fB\fB^Q\fR\fR
2072 2072  .ad
2073 2073  .RS 8n
2074 2074  start-output
2075 2075  .RE
2076 2076  
2077 2077  .sp
2078 2078  .ne 2
2079 2079  .na
2080 2080  \fB\fB^S\fR\fR
2081 2081  .ad
2082 2082  .RS 8n
2083 2083  stop-output
2084 2084  .RE
2085 2085  
2086 2086  .sp
2087 2087  .ne 2
2088 2088  .na
2089 2089  \fB\fB^V\fR\fR
2090 2090  .ad
2091 2091  .RS 8n
2092 2092  literal-next
2093 2093  .RE
2094 2094  
2095 2095  .sp
2096 2096  .ne 2
2097 2097  .na
2098 2098  \fB\fBM-^C\fR\fR
2099 2099  .ad
2100 2100  .RS 8n
2101 2101  user-interrupt
2102 2102  .RE
2103 2103  
2104 2104  .sp
2105 2105  .ne 2
2106 2106  .na
2107 2107  \fB\fBM-^\\fR\fR
2108 2108  .ad
2109 2109  .RS 8n
2110 2110  abort
2111 2111  .RE
2112 2112  
2113 2113  .sp
2114 2114  .ne 2
2115 2115  .na
2116 2116  \fB\fBM-^Z\fR\fR
2117 2117  .ad
2118 2118  .RS 8n
2119 2119  suspend
2120 2120  .RE
2121 2121  
2122 2122  .sp
2123 2123  .ne 2
2124 2124  .na
2125 2125  \fB\fBM-^Q\fR\fR
2126 2126  .ad
2127 2127  .RS 8n
2128 2128  start-output
2129 2129  .RE
2130 2130  
2131 2131  .sp
2132 2132  .ne 2
2133 2133  .na
2134 2134  \fB\fBM-^S\fR\fR
2135 2135  .ad
2136 2136  .RS 8n
2137 2137  stop-output
2138 2138  .RE
2139 2139  
2140 2140  .sp
2141 2141  .LP
2142 2142  Note that above, most of the bindings are defined twice, once as a raw control
2143 2143  code like \fB^C\fR and then a second time as a META character like \fBM-^C\fR.
2144 2144  The former is the binding for \fBvi\fR input mode, whereas the latter is the
2145 2145  binding for \fBvi\fR command mode. Once in command mode all key sequences that
2146 2146  the user types that they don't explicitly start with an ESCAPE or a META key,
2147 2147  have their first key secretly converted to a META character before the key
2148 2148  sequence is looked up in the key binding table. Thus, once in command mode,
2149 2149  when you type the letter i, for example, the tecla library actually looks up
2150 2150  the binding for \fBM-i\fR.
2151 2151  .sp
2152 2152  .LP
2153 2153  The cursor keys are refered to by name, as follows. This is necessary because
2154 2154  different types of terminals generate different key sequences when their cursor
2155 2155  keys are pressed.
2156 2156  .sp
2157 2157  .ne 2
2158 2158  .na
2159 2159  \fB\fBright\fR\fR
2160 2160  .ad
2161 2161  .RS 9n
2162 2162  cursor-right
2163 2163  .RE
2164 2164  
2165 2165  .sp
2166 2166  .ne 2
2167 2167  .na
2168 2168  \fB\fBleft\fR\fR
2169 2169  .ad
2170 2170  .RS 9n
2171 2171  cursor-left
2172 2172  .RE
2173 2173  
2174 2174  .sp
2175 2175  .ne 2
2176 2176  .na
2177 2177  \fB\fBup\fR\fR
2178 2178  .ad
2179 2179  .RS 9n
2180 2180  up-history
2181 2181  .RE
2182 2182  
2183 2183  .sp
2184 2184  .ne 2
2185 2185  .na
2186 2186  \fB\fBdown\fR\fR
2187 2187  .ad
2188 2188  .RS 9n
2189 2189  down-history
2190 2190  .RE
2191 2191  
2192 2192  .sp
2193 2193  .LP
2194 2194  The cursor keys normally generate a key sequence that start with an ESCAPE
2195 2195  character, so beware that using the arrow keys will put you into command mode
2196 2196  (if you aren't already in command mode).
2197 2197  .sp
2198 2198  .LP
2199 2199  The following are the terminal-independent key bindings for \fBvi\fR input
2200 2200  mode.
2201 2201  .sp
2202 2202  .ne 2
2203 2203  .na
2204 2204  \fB\fB^D\fR\fR
2205 2205  .ad
2206 2206  .RS 8n
2207 2207  list-or-eof
2208 2208  .RE
2209 2209  
2210 2210  .sp
2211 2211  .ne 2
2212 2212  .na
2213 2213  \fB\fB^G\fR\fR
2214 2214  .ad
2215 2215  .RS 8n
2216 2216  list-glob
2217 2217  .RE
2218 2218  
2219 2219  .sp
2220 2220  .ne 2
2221 2221  .na
2222 2222  \fB\fB^H\fR\fR
2223 2223  .ad
2224 2224  .RS 8n
2225 2225  backward-delete-char
2226 2226  .RE
2227 2227  
2228 2228  .sp
2229 2229  .ne 2

2230 2230  .na
2231 2231  \fB\fB^I\fR\fR
2232 2232  .ad
2233 2233  .RS 8n
2234 2234  complete-word
2235 2235  .RE
2236 2236  
2237 2237  .sp
2238 2238  .ne 2
2239 2239  .na
2240      -\fB\fB\r\fR\fR
     2240 +\fB\fB\er\fR\fR
2241 2241  .ad
2242 2242  .RS 8n
2243 2243  newline
2244 2244  .RE
2245 2245  
2246 2246  .sp
2247 2247  .ne 2
2248 2248  .na
2249      -\fB\fB\n\fR\fR
     2249 +\fB\fB\en\fR\fR
2250 2250  .ad
2251 2251  .RS 8n
2252 2252  newline
2253 2253  .RE
2254 2254  
2255 2255  .sp
2256 2256  .ne 2
2257 2257  .na
2258 2258  \fB\fB^L\fR\fR
2259 2259  .ad

2260 2260  .RS 8n
2261 2261  clear-screen
2262 2262  .RE
2263 2263  
2264 2264  .sp
2265 2265  .ne 2
2266 2266  .na
2267 2267  \fB\fB^N\fR\fR
2268 2268  .ad
2269 2269  .RS 8n
2270 2270  down-history
2271 2271  .RE
2272 2272  
2273 2273  .sp
2274 2274  .ne 2
2275 2275  .na
2276 2276  \fB\fB^P\fR\fR
2277 2277  .ad
2278 2278  .RS 8n
2279 2279  up-history
2280 2280  .RE
2281 2281  
2282 2282  .sp
2283 2283  .ne 2
2284 2284  .na
2285 2285  \fB\fB^R\fR\fR
2286 2286  .ad
2287 2287  .RS 8n
2288 2288  redisplay
2289 2289  .RE
2290 2290  
2291 2291  .sp
2292 2292  .ne 2
2293 2293  .na
2294 2294  \fB\fB^U\fR\fR
2295 2295  .ad
2296 2296  .RS 8n
2297 2297  backward-kill-line
2298 2298  .RE
2299 2299  
2300 2300  .sp
2301 2301  .ne 2
2302 2302  .na
2303 2303  \fB\fB^W\fR\fR
2304 2304  .ad
2305 2305  .RS 8n
2306 2306  backward-delete-word
2307 2307  .RE
2308 2308  
2309 2309  .sp
2310 2310  .ne 2
2311 2311  .na
2312 2312  \fB\fB^X*\fR\fR
2313 2313  .ad
2314 2314  .RS 8n
2315 2315  expand-filename
2316 2316  .RE
2317 2317  
2318 2318  .sp
2319 2319  .ne 2
2320 2320  .na
2321 2321  \fB\fB^X^F\fR\fR
2322 2322  .ad
2323 2323  .RS 8n
2324 2324  read-from-file
2325 2325  .RE
2326 2326  
2327 2327  .sp
2328 2328  .ne 2
2329 2329  .na
2330 2330  \fB\fB^X^R\fR\fR
2331 2331  .ad
2332 2332  .RS 8n
2333 2333  read-init-files
2334 2334  .RE
2335 2335  
2336 2336  .sp
2337 2337  .ne 2
2338 2338  .na
2339 2339  \fB\fB^?\fR\fR
2340 2340  .ad
2341 2341  .RS 8n
2342 2342  backward-delete-char
2343 2343  .RE
2344 2344  
2345 2345  .sp
2346 2346  .LP
2347 2347  The following are the key bindings that are defined in \fBvi\fR command mode,
2348 2348  this being specified by them all starting with a META character. As mentioned
2349 2349  above, once in command mode the initial meta character is optional. For
2350 2350  example, you might enter command mode by typing ESCAPE, and then press 'H'
2351 2351  twice to move the cursor two positions to the left. Both 'H' characters get
2352 2352  quietly converted to \fBM-h\fR before being compared to the key binding table,
2353 2353  the first one because ESCAPE followed by a character is always converted to the
2354 2354  equivalent META character, and the second because command mode was already
2355 2355  active.
2356 2356  .sp
2357 2357  .ne 2
2358 2358  .na
2359 2359  \fB\fBM-\\fR\fR
2360 2360  .ad
2361 2361  .RS 21n
2362 2362  cursor-right (META-space)
2363 2363  .RE
2364 2364  
2365 2365  .sp
2366 2366  .ne 2
2367 2367  .na
2368 2368  \fB\fBM-$\fR\fR
2369 2369  .ad
2370 2370  .RS 21n
2371 2371  end-of-line
2372 2372  .RE
2373 2373  
2374 2374  .sp
2375 2375  .ne 2
2376 2376  .na
2377 2377  \fB\fBM-*\fR\fR
2378 2378  .ad
2379 2379  .RS 21n
2380 2380  expand-filename
2381 2381  .RE
2382 2382  
2383 2383  .sp
2384 2384  .ne 2
2385 2385  .na
2386 2386  \fB\fBM-+\fR\fR
2387 2387  .ad
2388 2388  .RS 21n
2389 2389  down-history
2390 2390  .RE
2391 2391  
2392 2392  .sp
2393 2393  .ne 2
2394 2394  .na
2395 2395  \fB\fBM--\fR\fR
2396 2396  .ad
2397 2397  .RS 21n
2398 2398  up-history
2399 2399  .RE
2400 2400  
2401 2401  .sp
2402 2402  .ne 2
2403 2403  .na
2404 2404  \fB\fBM-<\fR\fR
2405 2405  .ad
2406 2406  .RS 21n
2407 2407  beginning-of-history
2408 2408  .RE
2409 2409  
2410 2410  .sp
2411 2411  .ne 2
2412 2412  .na
2413 2413  \fB\fBM->\fR\fR
2414 2414  .ad
2415 2415  .RS 21n
2416 2416  end-of-history
2417 2417  .RE
2418 2418  
2419 2419  .sp
2420 2420  .ne 2
2421 2421  .na
2422 2422  \fB\fBM-^\fR\fR
2423 2423  .ad
2424 2424  .RS 21n
2425 2425  beginning-of-line
2426 2426  .RE
2427 2427  
2428 2428  .sp
2429 2429  .ne 2
2430 2430  .na
2431 2431  \fB\fBM-\fR\fR
2432 2432  .ad
2433 2433  .RS 21n
2434 2434  repeat-find-char
2435 2435  .RE
2436 2436  
2437 2437  .sp
2438 2438  .ne 2
2439 2439  .na
2440 2440  \fB\fBM-,\fR\fR
2441 2441  .ad
2442 2442  .RS 21n
2443 2443  invert-refind-char
2444 2444  .RE
2445 2445  
2446 2446  .sp
2447 2447  .ne 2
2448 2448  .na
2449 2449  \fB\fBM-|\fR\fR
2450 2450  .ad
2451 2451  .RS 21n
2452 2452  goto-column
2453 2453  .RE
2454 2454  
2455 2455  .sp
2456 2456  .ne 2
2457 2457  .na
2458 2458  \fB\fBM-~\fR\fR
2459 2459  .ad
2460 2460  .RS 21n
2461 2461  change-case
2462 2462  .RE
2463 2463  
2464 2464  .sp
2465 2465  .ne 2
2466 2466  .na
2467 2467  \fB\fBM-.\fR\fR
2468 2468  .ad
2469 2469  .RS 21n
2470 2470  vi-repeat-change
2471 2471  .RE
2472 2472  
2473 2473  .sp
2474 2474  .ne 2
2475 2475  .na
2476 2476  \fB\fBM-%\fR\fR
2477 2477  .ad
2478 2478  .RS 21n
2479 2479  find-parenthesis
2480 2480  .RE
2481 2481  
2482 2482  .sp
2483 2483  .ne 2
2484 2484  .na
2485 2485  \fB\fBM-a\fR\fR
2486 2486  .ad
2487 2487  .RS 21n
2488 2488  vi-append
2489 2489  .RE
2490 2490  
2491 2491  .sp
2492 2492  .ne 2
2493 2493  .na
2494 2494  \fB\fBM-A\fR\fR
2495 2495  .ad
2496 2496  .RS 21n
2497 2497  vi-append-at-eol
2498 2498  .RE
2499 2499  
2500 2500  .sp
2501 2501  .ne 2
2502 2502  .na
2503 2503  \fB\fBM-b\fR\fR
2504 2504  .ad
2505 2505  .RS 21n
2506 2506  backward-word
2507 2507  .RE
2508 2508  
2509 2509  .sp
2510 2510  .ne 2
2511 2511  .na
2512 2512  \fB\fBM-B\fR\fR
2513 2513  .ad
2514 2514  .RS 21n
2515 2515  backward-word
2516 2516  .RE
2517 2517  
2518 2518  .sp
2519 2519  .ne 2
2520 2520  .na
2521 2521  \fB\fBM-C\fR\fR
2522 2522  .ad
2523 2523  .RS 21n
2524 2524  vi-change-rest-of-line
2525 2525  .RE
2526 2526  
2527 2527  .sp
2528 2528  .ne 2
2529 2529  .na
2530 2530  \fB\fBM-cb\fR\fR
2531 2531  .ad
2532 2532  .RS 21n
2533 2533  vi-backward-change-word
2534 2534  .RE
2535 2535  
2536 2536  .sp
2537 2537  .ne 2
2538 2538  .na
2539 2539  \fB\fBM-cB\fR\fR
2540 2540  .ad
2541 2541  .RS 21n
2542 2542  vi-backward-change-word
2543 2543  .RE
2544 2544  
2545 2545  .sp
2546 2546  .ne 2
2547 2547  .na
2548 2548  \fB\fBM-cc\fR\fR
2549 2549  .ad
2550 2550  .RS 21n
2551 2551  vi-change-line
2552 2552  .RE
2553 2553  
2554 2554  .sp
2555 2555  .ne 2
2556 2556  .na
2557 2557  \fB\fBM-ce\fR\fR
2558 2558  .ad
2559 2559  .RS 21n
2560 2560  vi-forward-change-word
2561 2561  .RE
2562 2562  
2563 2563  .sp
2564 2564  .ne 2
2565 2565  .na
2566 2566  \fB\fBM-cE\fR\fR
2567 2567  .ad
2568 2568  .RS 21n
2569 2569  vi-forward-change-word
2570 2570  .RE
2571 2571  
2572 2572  .sp
2573 2573  .ne 2
2574 2574  .na
2575 2575  \fB\fBM-cw\fR\fR
2576 2576  .ad
2577 2577  .RS 21n
2578 2578  vi-forward-change-word
2579 2579  .RE
2580 2580  
2581 2581  .sp
2582 2582  .ne 2
2583 2583  .na
2584 2584  \fB\fBM-cW\fR\fR
2585 2585  .ad
2586 2586  .RS 21n
2587 2587  vi-forward-change-word
2588 2588  .RE
2589 2589  
2590 2590  .sp
2591 2591  .ne 2
2592 2592  .na
2593 2593  \fB\fBM-cF\fR\fR
2594 2594  .ad
2595 2595  .RS 21n
2596 2596  vi-backward-change-find
2597 2597  .RE
2598 2598  
2599 2599  .sp
2600 2600  .ne 2
2601 2601  .na
2602 2602  \fB\fBM-cf\fR\fR
2603 2603  .ad
2604 2604  .RS 21n
2605 2605  vi-forward-change-find
2606 2606  .RE
2607 2607  
2608 2608  .sp
2609 2609  .ne 2
2610 2610  .na
2611 2611  \fB\fBM-cT\fR\fR
2612 2612  .ad
2613 2613  .RS 21n
2614 2614  vi-backward-change-to
2615 2615  .RE
2616 2616  
2617 2617  .sp
2618 2618  .ne 2
2619 2619  .na
2620 2620  \fB\fBM-ct\fR\fR
2621 2621  .ad
2622 2622  .RS 21n
2623 2623  vi-forward-change-to
2624 2624  .RE
2625 2625  
2626 2626  .sp
2627 2627  .ne 2
2628 2628  .na
2629 2629  \fB\fBM-c;\fR\fR
2630 2630  .ad
2631 2631  .RS 21n
2632 2632  vi-change-refind
2633 2633  .RE
2634 2634  
2635 2635  .sp
2636 2636  .ne 2
2637 2637  .na
2638 2638  \fB\fBM-c,\fR\fR
2639 2639  .ad
2640 2640  .RS 21n
2641 2641  vi-change-invert-refind
2642 2642  .RE
2643 2643  
2644 2644  .sp
2645 2645  .ne 2
2646 2646  .na
2647 2647  \fB\fBM-ch\fR\fR
2648 2648  .ad
2649 2649  .RS 21n
2650 2650  vi-backward-change-char
2651 2651  .RE
2652 2652  
2653 2653  .sp
2654 2654  .ne 2
2655 2655  .na
2656 2656  \fB\fBM-c^H\fR\fR
2657 2657  .ad
2658 2658  .RS 21n
2659 2659  vi-backward-change-char
2660 2660  .RE
2661 2661  
2662 2662  .sp
2663 2663  .ne 2
2664 2664  .na
2665 2665  \fB\fBM-c^?\fR\fR
2666 2666  .ad
2667 2667  .RS 21n
2668 2668  vi-backward-change-char
2669 2669  .RE
2670 2670  
2671 2671  .sp
2672 2672  .ne 2
2673 2673  .na
2674 2674  \fB\fBM-cl\fR\fR
2675 2675  .ad
2676 2676  .RS 21n
2677 2677  vi-forward-change-char
2678 2678  .RE
2679 2679  
2680 2680  .sp
2681 2681  .ne 2
2682 2682  .na
2683 2683  \fB\fBM-c\\fR\fR
2684 2684  .ad
2685 2685  .RS 21n
2686 2686  vi-forward-change-char (META-c-space)
2687 2687  .RE
2688 2688  
2689 2689  .sp
2690 2690  .ne 2
2691 2691  .na
2692 2692  \fB\fBM-c^\fR\fR
2693 2693  .ad
2694 2694  .RS 21n
2695 2695  vi-change-to-bol
2696 2696  .RE
2697 2697  
2698 2698  .sp
2699 2699  .ne 2
2700 2700  .na
2701 2701  \fB\fBM-c0\fR\fR
2702 2702  .ad
2703 2703  .RS 21n
2704 2704  vi-change-to-bol
2705 2705  .RE
2706 2706  
2707 2707  .sp
2708 2708  .ne 2
2709 2709  .na
2710 2710  \fB\fBM-c$\fR\fR
2711 2711  .ad
2712 2712  .RS 21n
2713 2713  vi-change-rest-of-line
2714 2714  .RE
2715 2715  
2716 2716  .sp
2717 2717  .ne 2
2718 2718  .na
2719 2719  \fB\fBM-c|\fR\fR
2720 2720  .ad
2721 2721  .RS 21n
2722 2722  vi-change-to-column
2723 2723  .RE
2724 2724  
2725 2725  .sp
2726 2726  .ne 2
2727 2727  .na
2728 2728  \fB\fBM-c%\fR\fR
2729 2729  .ad
2730 2730  .RS 21n
2731 2731  vi-change-to-parenthesis
2732 2732  .RE
2733 2733  
2734 2734  .sp
2735 2735  .ne 2
2736 2736  .na
2737 2737  \fB\fBM-dh\fR\fR
2738 2738  .ad
2739 2739  .RS 21n
2740 2740  backward-delete-char
2741 2741  .RE
2742 2742  
2743 2743  .sp
2744 2744  .ne 2
2745 2745  .na
2746 2746  \fB\fBM-d^H\fR\fR
2747 2747  .ad
2748 2748  .RS 21n
2749 2749  backward-delete-char
2750 2750  .RE
2751 2751  
2752 2752  .sp
2753 2753  .ne 2
2754 2754  .na
2755 2755  \fB\fBM-d^?\fR\fR
2756 2756  .ad
2757 2757  .RS 21n
2758 2758  backward-delete-char
2759 2759  .RE
2760 2760  
2761 2761  .sp
2762 2762  .ne 2
2763 2763  .na
2764 2764  \fB\fBM-dl\fR\fR
2765 2765  .ad
2766 2766  .RS 21n
2767 2767  forward-delete-char
2768 2768  .RE
2769 2769  
2770 2770  .sp
2771 2771  .ne 2
2772 2772  .na
2773 2773  \fB\fBM-d\fR\fR
2774 2774  .ad
2775 2775  .RS 21n
2776 2776  forward-delete-char (META-d-space)
2777 2777  .RE
2778 2778  
2779 2779  .sp
2780 2780  .ne 2
2781 2781  .na
2782 2782  \fB\fBM-dd\fR\fR
2783 2783  .ad
2784 2784  .RS 21n
2785 2785  delete-line
2786 2786  .RE
2787 2787  
2788 2788  .sp
2789 2789  .ne 2
2790 2790  .na
2791 2791  \fB\fBM-db\fR\fR
2792 2792  .ad
2793 2793  .RS 21n
2794 2794  backward-delete-word
2795 2795  .RE
2796 2796  
2797 2797  .sp
2798 2798  .ne 2
2799 2799  .na
2800 2800  \fB\fBM-dB\fR\fR
2801 2801  .ad
2802 2802  .RS 21n
2803 2803  backward-delete-word
2804 2804  .RE
2805 2805  
2806 2806  .sp
2807 2807  .ne 2
2808 2808  .na
2809 2809  \fB\fBM-de\fR\fR
2810 2810  .ad
2811 2811  .RS 21n
2812 2812  forward-delete-word
2813 2813  .RE
2814 2814  
2815 2815  .sp
2816 2816  .ne 2
2817 2817  .na
2818 2818  \fB\fBM-dE\fR\fR
2819 2819  .ad
2820 2820  .RS 21n
2821 2821  forward-delete-word
2822 2822  .RE
2823 2823  
2824 2824  .sp
2825 2825  .ne 2
2826 2826  .na
2827 2827  \fB\fBM-dw\fR\fR
2828 2828  .ad
2829 2829  .RS 21n
2830 2830  forward-delete-word
2831 2831  .RE
2832 2832  
2833 2833  .sp
2834 2834  .ne 2
2835 2835  .na
2836 2836  \fB\fBM-dW\fR\fR
2837 2837  .ad
2838 2838  .RS 21n
2839 2839  forward-delete-word
2840 2840  .RE
2841 2841  
2842 2842  .sp
2843 2843  .ne 2
2844 2844  .na
2845 2845  \fB\fBM-dF\fR\fR
2846 2846  .ad
2847 2847  .RS 21n
2848 2848  backward-delete-find
2849 2849  .RE
2850 2850  
2851 2851  .sp
2852 2852  .ne 2
2853 2853  .na
2854 2854  \fB\fBM-df\fR\fR
2855 2855  .ad
2856 2856  .RS 21n
2857 2857  forward-delete-find
2858 2858  .RE
2859 2859  
2860 2860  .sp
2861 2861  .ne 2
2862 2862  .na
2863 2863  \fB\fBM-dT\fR\fR
2864 2864  .ad
2865 2865  .RS 21n
2866 2866  backward-delete-to
2867 2867  .RE
2868 2868  
2869 2869  .sp
2870 2870  .ne 2
2871 2871  .na
2872 2872  \fB\fBM-dt\fR\fR
2873 2873  .ad
2874 2874  .RS 21n
2875 2875  forward-delete-to
2876 2876  .RE
2877 2877  
2878 2878  .sp
2879 2879  .ne 2
2880 2880  .na
2881 2881  \fB\fBM-d;\fR\fR
2882 2882  .ad
2883 2883  .RS 21n
2884 2884  delete-refind
2885 2885  .RE
2886 2886  
2887 2887  .sp
2888 2888  .ne 2
2889 2889  .na
2890 2890  \fB\fBM-d,\fR\fR
2891 2891  .ad
2892 2892  .RS 21n
2893 2893  delete-invert-refind
2894 2894  .RE
2895 2895  
2896 2896  .sp
2897 2897  .ne 2
2898 2898  .na
2899 2899  \fB\fBM-d^\fR\fR
2900 2900  .ad
2901 2901  .RS 21n
2902 2902  backward-kill-line
2903 2903  .RE
2904 2904  
2905 2905  .sp
2906 2906  .ne 2
2907 2907  .na
2908 2908  \fB\fBM-d0\fR\fR
2909 2909  .ad
2910 2910  .RS 21n
2911 2911  backward-kill-line
2912 2912  .RE
2913 2913  
2914 2914  .sp
2915 2915  .ne 2
2916 2916  .na
2917 2917  \fB\fBM-d$\fR\fR
2918 2918  .ad
2919 2919  .RS 21n
2920 2920  kill-line
2921 2921  .RE
2922 2922  
2923 2923  .sp
2924 2924  .ne 2
2925 2925  .na
2926 2926  \fB\fBM-D\fR\fR
2927 2927  .ad
2928 2928  .RS 21n
2929 2929  kill-line
2930 2930  .RE
2931 2931  
2932 2932  .sp
2933 2933  .ne 2
2934 2934  .na
2935 2935  \fB\fBM-d|\fR\fR
2936 2936  .ad
2937 2937  .RS 21n
2938 2938  delete-to-column
2939 2939  .RE
2940 2940  
2941 2941  .sp
2942 2942  .ne 2
2943 2943  .na
2944 2944  \fB\fBM-d%\fR\fR
2945 2945  .ad
2946 2946  .RS 21n
2947 2947  delete-to-parenthesis
2948 2948  .RE
2949 2949  
2950 2950  .sp
2951 2951  .ne 2
2952 2952  .na
2953 2953  \fB\fBM-e\fR\fR
2954 2954  .ad
2955 2955  .RS 21n
2956 2956  forward-word
2957 2957  .RE
2958 2958  
2959 2959  .sp
2960 2960  .ne 2
2961 2961  .na
2962 2962  \fB\fBM-E\fR\fR
2963 2963  .ad
2964 2964  .RS 21n
2965 2965  forward-word
2966 2966  .RE
2967 2967  
2968 2968  .sp
2969 2969  .ne 2
2970 2970  .na
2971 2971  \fB\fBM-f\fR\fR
2972 2972  .ad
2973 2973  .RS 21n
2974 2974  forward-find-char
2975 2975  .RE
2976 2976  
2977 2977  .sp
2978 2978  .ne 2
2979 2979  .na
2980 2980  \fB\fBM-F\fR\fR
2981 2981  .ad
2982 2982  .RS 21n
2983 2983  backward-find-char
2984 2984  .RE
2985 2985  
2986 2986  .sp
2987 2987  .ne 2
2988 2988  .na
2989 2989  \fB\fBM--\fR\fR
2990 2990  .ad
2991 2991  .RS 21n
2992 2992  up-history
2993 2993  .RE
2994 2994  
2995 2995  .sp
2996 2996  .ne 2
2997 2997  .na
2998 2998  \fB\fBM-h\fR\fR
2999 2999  .ad
3000 3000  .RS 21n
3001 3001  cursor-left
3002 3002  .RE
3003 3003  
3004 3004  .sp
3005 3005  .ne 2
3006 3006  .na
3007 3007  \fB\fBM-H\fR\fR
3008 3008  .ad
3009 3009  .RS 21n
3010 3010  beginning-of-history
3011 3011  .RE
3012 3012  
3013 3013  .sp
3014 3014  .ne 2
3015 3015  .na
3016 3016  \fB\fBM-i\fR\fR
3017 3017  .ad
3018 3018  .RS 21n
3019 3019  vi-insert
3020 3020  .RE
3021 3021  
3022 3022  .sp
3023 3023  .ne 2
3024 3024  .na
3025 3025  \fB\fBM-I\fR\fR
3026 3026  .ad
3027 3027  .RS 21n
3028 3028  vi-insert-at-bol
3029 3029  .RE
3030 3030  
3031 3031  .sp
3032 3032  .ne 2
3033 3033  .na
3034 3034  \fB\fBM-j\fR\fR
3035 3035  .ad
3036 3036  .RS 21n
3037 3037  down-history
3038 3038  .RE
3039 3039  
3040 3040  .sp
3041 3041  .ne 2
3042 3042  .na
3043 3043  \fB\fBM-J\fR\fR
3044 3044  .ad
3045 3045  .RS 21n
3046 3046  history-search-forward
3047 3047  .RE
3048 3048  
3049 3049  .sp
3050 3050  .ne 2
3051 3051  .na
3052 3052  \fB\fBM-k\fR\fR
3053 3053  .ad
3054 3054  .RS 21n
3055 3055  up-history
3056 3056  .RE
3057 3057  
3058 3058  .sp
3059 3059  .ne 2
3060 3060  .na
3061 3061  \fB\fBM-K\fR\fR
3062 3062  .ad
3063 3063  .RS 21n
3064 3064  history-search-backward
3065 3065  .RE
3066 3066  
3067 3067  .sp
3068 3068  .ne 2
3069 3069  .na
3070 3070  \fB\fBM-l\fR\fR
3071 3071  .ad
3072 3072  .RS 21n
3073 3073  cursor-right
3074 3074  .RE
3075 3075  
3076 3076  .sp
3077 3077  .ne 2
3078 3078  .na
3079 3079  \fB\fBM-L\fR\fR
3080 3080  .ad
3081 3081  .RS 21n
3082 3082  end-of-history
3083 3083  .RE
3084 3084  
3085 3085  .sp
3086 3086  .ne 2
3087 3087  .na
3088 3088  \fB\fBM-n\fR\fR
3089 3089  .ad
3090 3090  .RS 21n
3091 3091  history-re-search-forward
3092 3092  .RE
3093 3093  
3094 3094  .sp
3095 3095  .ne 2
3096 3096  .na
3097 3097  \fB\fBM-N\fR\fR
3098 3098  .ad
3099 3099  .RS 21n
3100 3100  history-re-search-backward
3101 3101  .RE
3102 3102  
3103 3103  .sp
3104 3104  .ne 2
3105 3105  .na
3106 3106  \fB\fBM-p\fR\fR
3107 3107  .ad
3108 3108  .RS 21n
3109 3109  append-yank
3110 3110  .RE
3111 3111  
3112 3112  .sp
3113 3113  .ne 2
3114 3114  .na
3115 3115  \fB\fBM-P\fR\fR
3116 3116  .ad
3117 3117  .RS 21n
3118 3118  yank
3119 3119  .RE
3120 3120  
3121 3121  .sp
3122 3122  .ne 2
3123 3123  .na
3124 3124  \fB\fBM-r\fR\fR
3125 3125  .ad
3126 3126  .RS 21n
3127 3127  vi-replace-char
3128 3128  .RE
3129 3129  
3130 3130  .sp
3131 3131  .ne 2
3132 3132  .na
3133 3133  \fB\fBM-R\fR\fR
3134 3134  .ad
3135 3135  .RS 21n
3136 3136  vi-overwrite
3137 3137  .RE
3138 3138  
3139 3139  .sp
3140 3140  .ne 2
3141 3141  .na
3142 3142  \fB\fBM-s\fR\fR
3143 3143  .ad
3144 3144  .RS 21n
3145 3145  vi-forward-change-char
3146 3146  .RE
3147 3147  
3148 3148  .sp
3149 3149  .ne 2
3150 3150  .na
3151 3151  \fB\fBM-S\fR\fR
3152 3152  .ad
3153 3153  .RS 21n
3154 3154  vi-change-line
3155 3155  .RE
3156 3156  
3157 3157  .sp
3158 3158  .ne 2
3159 3159  .na
3160 3160  \fB\fBM-t\fR\fR
3161 3161  .ad
3162 3162  .RS 21n
3163 3163  forward-to-char
3164 3164  .RE
3165 3165  
3166 3166  .sp
3167 3167  .ne 2
3168 3168  .na
3169 3169  \fB\fBM-T\fR\fR
3170 3170  .ad
3171 3171  .RS 21n
3172 3172  backward-to-char
3173 3173  .RE
3174 3174  
3175 3175  .sp
3176 3176  .ne 2
3177 3177  .na
3178 3178  \fB\fBM-u\fR\fR
3179 3179  .ad
3180 3180  .RS 21n
3181 3181  vi-undo
3182 3182  .RE
3183 3183  
3184 3184  .sp
3185 3185  .ne 2
3186 3186  .na
3187 3187  \fB\fBM-w\fR\fR
3188 3188  .ad
3189 3189  .RS 21n
3190 3190  forward-to-word
3191 3191  .RE
3192 3192  
3193 3193  .sp
3194 3194  .ne 2
3195 3195  .na
3196 3196  \fB\fBM-W\fR\fR
3197 3197  .ad
3198 3198  .RS 21n
3199 3199  forward-to-word
3200 3200  .RE
3201 3201  
3202 3202  .sp
3203 3203  .ne 2
3204 3204  .na
3205 3205  \fB\fBM-x\fR\fR
3206 3206  .ad
3207 3207  .RS 21n
3208 3208  forward-delete-char
3209 3209  .RE
3210 3210  
3211 3211  .sp
3212 3212  .ne 2
3213 3213  .na
3214 3214  \fB\fBM-X\fR\fR
3215 3215  .ad
3216 3216  .RS 21n
3217 3217  backward-delete-char
3218 3218  .RE
3219 3219  
3220 3220  .sp
3221 3221  .ne 2
3222 3222  .na
3223 3223  \fB\fBM-yh\fR\fR
3224 3224  .ad
3225 3225  .RS 21n
3226 3226  backward-copy-char
3227 3227  .RE
3228 3228  
3229 3229  .sp
3230 3230  .ne 2
3231 3231  .na
3232 3232  \fB\fBM-y^H\fR\fR
3233 3233  .ad
3234 3234  .RS 21n
3235 3235  backward-copy-char
3236 3236  .RE
3237 3237  
3238 3238  .sp
3239 3239  .ne 2
3240 3240  .na
3241 3241  \fB\fBM-y^?\fR\fR
3242 3242  .ad
3243 3243  .RS 21n
3244 3244  backward-copy-char
3245 3245  .RE
3246 3246  
3247 3247  .sp
3248 3248  .ne 2
3249 3249  .na
3250 3250  \fB\fBM-yl\fR\fR
3251 3251  .ad
3252 3252  .RS 21n
3253 3253  forward-copy-char
3254 3254  .RE
3255 3255  
3256 3256  .sp
3257 3257  .ne 2
3258 3258  .na
3259 3259  \fB\fBM-y\\fR\fR
3260 3260  .ad
3261 3261  .RS 21n
3262 3262  forward-copy-char (META-y-space)
3263 3263  .RE
3264 3264  
3265 3265  .sp
3266 3266  .ne 2
3267 3267  .na
3268 3268  \fB\fBM-ye\fR\fR
3269 3269  .ad
3270 3270  .RS 21n
3271 3271  forward-copy-word
3272 3272  .RE
3273 3273  
3274 3274  .sp
3275 3275  .ne 2
3276 3276  .na
3277 3277  \fB\fBM-yE\fR\fR
3278 3278  .ad
3279 3279  .RS 21n
3280 3280  forward-copy-word
3281 3281  .RE
3282 3282  
3283 3283  .sp
3284 3284  .ne 2
3285 3285  .na
3286 3286  \fB\fBM-yw\fR\fR
3287 3287  .ad
3288 3288  .RS 21n
3289 3289  forward-copy-word
3290 3290  .RE
3291 3291  
3292 3292  .sp
3293 3293  .ne 2
3294 3294  .na
3295 3295  \fB\fBM-yW\fR\fR
3296 3296  .ad
3297 3297  .RS 21n
3298 3298  forward-copy-word
3299 3299  .RE
3300 3300  
3301 3301  .sp
3302 3302  .ne 2
3303 3303  .na
3304 3304  \fB\fBM-yb\fR\fR
3305 3305  .ad
3306 3306  .RS 21n
3307 3307  backward-copy-word
3308 3308  .RE
3309 3309  
3310 3310  .sp
3311 3311  .ne 2
3312 3312  .na
3313 3313  \fB\fBM-yB\fR\fR
3314 3314  .ad
3315 3315  .RS 21n
3316 3316  backward-copy-word
3317 3317  .RE
3318 3318  
3319 3319  .sp
3320 3320  .ne 2
3321 3321  .na
3322 3322  \fB\fBM-yf\fR\fR
3323 3323  .ad
3324 3324  .RS 21n
3325 3325  forward-copy-find
3326 3326  .RE
3327 3327  
3328 3328  .sp
3329 3329  .ne 2
3330 3330  .na
3331 3331  \fB\fBM-yF\fR\fR
3332 3332  .ad
3333 3333  .RS 21n
3334 3334  backward-copy-find
3335 3335  .RE
3336 3336  
3337 3337  .sp
3338 3338  .ne 2
3339 3339  .na
3340 3340  \fB\fBM-yt\fR\fR
3341 3341  .ad
3342 3342  .RS 21n
3343 3343  forward-copy-to
3344 3344  .RE
3345 3345  
3346 3346  .sp
3347 3347  .ne 2
3348 3348  .na
3349 3349  \fB\fBM-yT\fR\fR
3350 3350  .ad
3351 3351  .RS 21n
3352 3352  backward-copy-to
3353 3353  .RE
3354 3354  
3355 3355  .sp
3356 3356  .ne 2
3357 3357  .na
3358 3358  \fB\fBM-y;\fR\fR
3359 3359  .ad
3360 3360  .RS 21n
3361 3361  copy-refind
3362 3362  .RE
3363 3363  
3364 3364  .sp
3365 3365  .ne 2
3366 3366  .na
3367 3367  \fB\fBM-y,\fR\fR
3368 3368  .ad
3369 3369  .RS 21n
3370 3370  copy-invert-refind
3371 3371  .RE
3372 3372  
3373 3373  .sp
3374 3374  .ne 2
3375 3375  .na
3376 3376  \fB\fBM-y^\fR\fR
3377 3377  .ad
3378 3378  .RS 21n
3379 3379  copy-to-bol
3380 3380  .RE
3381 3381  
3382 3382  .sp
3383 3383  .ne 2
3384 3384  .na
3385 3385  \fB\fBM-y0\fR\fR
3386 3386  .ad
3387 3387  .RS 21n
3388 3388  copy-to-bol
3389 3389  .RE
3390 3390  
3391 3391  .sp
3392 3392  .ne 2
3393 3393  .na
3394 3394  \fB\fBM-y$\fR\fR
3395 3395  .ad
3396 3396  .RS 21n
3397 3397  copy-rest-of-line
3398 3398  .RE
3399 3399  
3400 3400  .sp
3401 3401  .ne 2
3402 3402  .na
3403 3403  \fB\fBM-yy\fR\fR
3404 3404  .ad
3405 3405  .RS 21n
3406 3406  copy-line
3407 3407  .RE
3408 3408  
3409 3409  .sp
3410 3410  .ne 2
3411 3411  .na
3412 3412  \fB\fBM-Y\fR\fR
3413 3413  .ad
3414 3414  .RS 21n
3415 3415  copy-line
3416 3416  .RE
3417 3417  
3418 3418  .sp
3419 3419  .ne 2
3420 3420  .na
3421 3421  \fB\fBM-y|\fR\fR
3422 3422  .ad
3423 3423  .RS 21n
3424 3424  copy-to-column
3425 3425  .RE
3426 3426  
3427 3427  .sp
3428 3428  .ne 2
3429 3429  .na
3430 3430  \fB\fBM-y%\fR\fR
3431 3431  .ad
3432 3432  .RS 21n
3433 3433  copy-to-parenthesis
3434 3434  .RE
3435 3435  
3436 3436  .sp
3437 3437  .ne 2
3438 3438  .na
3439 3439  \fB\fBM-^E\fR\fR
3440 3440  .ad
3441 3441  .RS 21n
3442 3442  emacs-mode
3443 3443  .RE
3444 3444  
3445 3445  .sp
3446 3446  .ne 2
3447 3447  .na
3448 3448  \fB\fBM-^H\fR\fR
3449 3449  .ad
3450 3450  .RS 21n
3451 3451  cursor-left
3452 3452  .RE
3453 3453  
3454 3454  .sp
3455 3455  .ne 2
3456 3456  .na
3457 3457  \fB\fBM-^?\fR\fR
3458 3458  .ad
3459 3459  .RS 21n
3460 3460  cursor-left
3461 3461  .RE
3462 3462  
3463 3463  .sp
3464 3464  .ne 2
3465 3465  .na
3466 3466  \fB\fBM-^L\fR\fR
3467 3467  .ad
3468 3468  .RS 21n
3469 3469  clear-screen
3470 3470  .RE
3471 3471  
3472 3472  .sp
3473 3473  .ne 2
3474 3474  .na
3475 3475  \fB\fBM-^N\fR\fR
3476 3476  .ad
3477 3477  .RS 21n
3478 3478  down-history
3479 3479  .RE
3480 3480  
3481 3481  .sp
3482 3482  .ne 2
3483 3483  .na
3484 3484  \fB\fBM-^P\fR\fR
3485 3485  .ad
3486 3486  .RS 21n
3487 3487  up-history
3488 3488  .RE
3489 3489  
3490 3490  .sp
3491 3491  .ne 2
3492 3492  .na
3493 3493  \fB\fBM-^R\fR\fR
3494 3494  .ad
3495 3495  .RS 21n
3496 3496  redisplay
3497 3497  .RE
3498 3498  
3499 3499  .sp
3500 3500  .ne 2
3501 3501  .na
3502 3502  \fB\fBM-^D\fR\fR
3503 3503  .ad
3504 3504  .RS 21n
3505 3505  list-or-eof
3506 3506  .RE
3507 3507  
3508 3508  .sp
3509 3509  .ne 2
3510 3510  .na
3511 3511  \fB\fBM-^I\fR\fR
3512 3512  .ad
3513 3513  .RS 21n
3514 3514  complete-word
3515 3515  .RE
3516 3516  
3517 3517  .sp
3518 3518  .ne 2

3519 3519  .na
3520 3520  \fB\fBM-\r\fR\fR
3521 3521  .ad
3522 3522  .RS 21n
3523 3523  newline
3524 3524  .RE
3525 3525  
3526 3526  .sp
3527 3527  .ne 2
3528 3528  .na
3529      -\fB\fBM-\n\fR\fR
     3529 +\fB\fBM-\en\fR\fR
3530 3530  .ad
3531 3531  .RS 21n
3532 3532  newline
3533 3533  .RE
3534 3534  
3535 3535  .sp
3536 3536  .ne 2
3537 3537  .na
3538 3538  \fB\fBM-^X^R\fR\fR
3539 3539  .ad

3540 3540  .RS 21n
3541 3541  read-init-files
3542 3542  .RE
3543 3543  
3544 3544  .sp
3545 3545  .ne 2
3546 3546  .na
3547 3547  \fB\fBM-^Xh\fR\fR
3548 3548  .ad
3549 3549  .RS 21n
3550 3550  list-history
3551 3551  .RE
3552 3552  
3553 3553  .sp
3554 3554  .ne 2
3555 3555  .na
3556 3556  \fB\fBM-0, M-1, ... M-9\fR\fR
3557 3557  .ad
3558 3558  .RS 21n
3559 3559  digit-argument (see below)
3560 3560  .RE
3561 3561  
3562 3562  .sp
3563 3563  .LP
3564 3564  Note that \fB^I\fR is what the TAB key generates.
3565 3565  .SS "Entering Repeat Counts"
3566 3566  .sp
3567 3567  .LP
3568 3568  Many of the key binding functions described previously, take an optional count,
3569 3569  typed in before the target key sequence. This is interpreted as a repeat count
3570 3570  by most bindings. A notable exception is the goto-column binding, which
3571 3571  interprets the count as a column number.
3572 3572  .sp
3573 3573  .LP
3574 3574  By default you can specify this count argument by pressing the META key while
3575 3575  typing in the numeric count. This relies on the digit-argument action being
3576 3576  bound to 'META-0', 'META-1' etc. Once any one of these bindings has been
3577 3577  activated, you can optionally take your finger off the META key to type in the
3578 3578  rest of the number, since every numeric digit thereafter is treated as part of
3579 3579  the number, unless it is preceded by the literal-next binding. As soon as a
3580 3580  non-digit, or literal digit key is pressed the repeat count is terminated and
3581 3581  either causes the just typed character to be added to the line that many times,
3582 3582  or causes the next key binding function to be given that argument.
3583 3583  .sp
3584 3584  .LP
3585 3585  For example, in \fBemacs\fR mode, typing:
3586 3586  .sp
3587 3587  .in +2
3588 3588  .nf
3589 3589  M-12a
3590 3590  .fi
3591 3591  .in -2
3592 3592  
3593 3593  .sp
3594 3594  .LP
3595 3595  causes the letter 'a' to be added to the line 12 times, whereas
3596 3596  .sp
3597 3597  .in +2
3598 3598  .nf
3599 3599  M-4M-c
3600 3600  .fi
3601 3601  .in -2
3602 3602  
3603 3603  .sp
3604 3604  .LP
3605 3605  Capitalizes the next 4 words.
3606 3606  .sp
3607 3607  .LP
3608 3608  In \fBvi\fR command mode the meta modifier is automatically added to all
3609 3609  characters typed in, so to enter a count in \fBvi\fR command-mode, just
3610 3610  involves typing in the number, just as it does in the \fBvi\fR editor itself.
3611 3611  So for example, in vi command mode, typing:
3612 3612  .sp
3613 3613  .in +2
3614 3614  .nf
3615 3615  4w2x
3616 3616  .fi
3617 3617  .in -2
3618 3618  
3619 3619  .sp
3620 3620  .LP
3621 3621  moves the cursor four words to the right, then deletes two characters.
3622 3622  .sp
3623 3623  .LP
3624 3624  You can also bind digit-argument to other key sequences. If these end in a
3625 3625  numeric digit, that digit gets appended to the current repeat count. If it
3626 3626  doesn't end in a numeric digit, a new repeat count is started with a value of
3627 3627  zero, and can be completed by typing in the number, after letting go of the key
3628 3628  which triggered the digit-argument action.
3629 3629  .SH FILES
3630 3630  .sp
3631 3631  .ne 2
3632 3632  .na
3633 3633  \fB\fB/usr/lib/libtecla.so\fR\fR
3634 3634  .ad
3635 3635  .RS 27n
3636 3636  The tecla library
3637 3637  .RE
3638 3638  
3639 3639  .sp
3640 3640  .ne 2
3641 3641  .na
3642 3642  \fB\fB/usr/include/libtecla.h\fR\fR
3643 3643  .ad
3644 3644  .RS 27n
3645 3645  The tecla header file
3646 3646  .RE
3647 3647  
3648 3648  .sp
3649 3649  .ne 2
3650 3650  .na
3651 3651  \fB\fB~/.teclarc\fR\fR
3652 3652  .ad
3653 3653  .RS 27n
3654 3654  The personal tecla customization file
3655 3655  .RE
3656 3656  
3657 3657  .SH ATTRIBUTES
3658 3658  .sp
3659 3659  .LP
3660 3660  See \fBattributes\fR(5) for descriptions of the following attributes:
3661 3661  .sp
3662 3662  
3663 3663  .sp
3664 3664  .TS
3665 3665  box;
3666 3666  c | c
3667 3667  l | l .
3668 3668  ATTRIBUTE TYPE  ATTRIBUTE VALUE
3669 3669  _
3670 3670  Interface Stability     Evolving
3671 3671  .TE
3672 3672  
3673 3673  .SH SEE ALSO
3674 3674  .sp
3675 3675  .LP
3676 3676  \fBvi\fR(1), \fBcpl_complete_word\fR(3TECLA), \fBef_expand_file\fR(3TECLA),
3677 3677  \fBgl_get_line\fR(3TECLA), \fBgl_io_mode\fR(3TECLA), \fBlibtecla\fR(3LIB),
3678 3678  \fBpca_lookup_file\fR(3TECLA), \fBattributes\fR(5)

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX