home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / editor / less / lesskey.man < prev    next >
Text File  |  1994-01-31  |  5KB  |  144 lines
  1. NAME
  2.      lesskey - specify key bindings for less
  3.  
  4. SYNOPSIS
  5.      lesskey [-o output] [input]
  6.  
  7. DESCRIPTION
  8.      Lesskey is used to specify a set of key bindings to be used
  9.      by less. The input file is a text file which describes the
  10.      key bindings, and the output file is a binary file which is
  11.      used by less. If no input file is specified, standard input
  12.      is used.  If no output file is specified, $HOME/.less is
  13.      used.
  14.  
  15.      The input file consists of lines of the form:
  16.  
  17.           string <whitespace> action [extra-string] <newline>
  18.  
  19.      Whitespace is any sequence of one or more spaces and/or
  20.      tabs.  The "string" is the command key(s) which invoke the
  21.      action.  The string may be a single command key, or a
  22.      sequence of up to 15 keys.  The "action" is the name of the
  23.      less action, from the list below.  The characters in the
  24.      "string" may appear literally, or be prefixed by a carat to
  25.      indicate a control key.  A backslash may be used to cause
  26.      the following character to be taken literally.  Characters
  27.      which must be preceded by backslash include carat, space,
  28.      tab and the backslash itself.  A backslash followed by one
  29.      to three octal digits may be used to specify a character by
  30.      its octal value.  Blank lines and lines which start with a
  31.      pound sign (#) are ignored.
  32.  
  33.      An action may be followed by an extra string.  This string
  34.      is parsed after the command is entered, just as if it were
  35.      entered on the command line.  This feature can be used in
  36.      certain cases to extend the functionality of a command.  For
  37.      example, these entries would create a pair of commands to
  38.      turn on/off line numbers using vi syntax:
  39.  
  40.           :set\ nu       toggle-option -N
  41.           :set\ nonu     toggle-option +N
  42.  
  43.      See also the ":ta" command in the example below.
  44.  
  45.  
  46. EXAMPLE
  47.      The following input file describes the set of default
  48.      command keys used by less:
  49.  
  50.           r         forw-line
  51.           n         forw-line
  52.           e         forw-line
  53.           j         forw-line
  54.           ^E        forw-line
  55.           ^N        forw-line
  56.           k         back-line
  57.           y         back-line
  58.           ^Y        back-line
  59.           ^K        back-line
  60.           ^P        back-line
  61.           J         forw-line-force
  62.           K         back-line-force
  63.           Y         back-line-force
  64.           d         forw-scroll
  65.           ^D        forw-scroll
  66.           u         back-scroll
  67.           ^U        back-scroll
  68.           '         back-scroll
  69.           \40       forw-screen
  70.           f         forw-screen
  71.           ^F        forw-screen
  72.           ^V        forw-screen
  73.           b         back-screen
  74.           ^B        back-screen
  75.           \33v      back-screen
  76.           z         forw-window
  77.           w         back-window
  78.           F         forw-forever
  79.           R         repaint-flush
  80.           r         repaint
  81.           ^R        repaint
  82.           ^L        repaint
  83.           g         goto-line
  84.           <         goto-line
  85.           \33<      goto-line
  86.           p         percent
  87.           %         percent
  88.           {         forw-bracket {}
  89.           }         back-bracket {}
  90.           (         forw-bracket ()
  91.           )         back-bracket ()
  92.           [         forw-bracket []
  93.           ]         back-bracket []
  94.           \33^F     forw-bracket
  95.           \33^B     back-bracket
  96.           G         goto-end
  97.           \33>      goto-end
  98.           >         goto-end
  99.           P         goto-end
  100.           =         status
  101.           ^G        status
  102.           :f        status
  103.           /         forw-search
  104.           ?         back-search
  105.           \33/      forw-search *
  106.           \33?      back-search *
  107.           n         repeat-search
  108.           \33n      repeat-search-all
  109.           N         reverse-search
  110.           \33N      reverse-search-all
  111.           m         set-mark
  112.           '         goto-mark
  113.           ^X^X      goto-mark
  114.           E         examine
  115.           :e        examine
  116.           ^X^V      examine
  117.           :n        next-file
  118.           :p        prev-file
  119.           :x        index-file
  120.           -         toggle-option
  121.           :t        toggle-option t
  122.           s         toggle-option o
  123.           _         display-option
  124.           |         pipe
  125.           v         visual
  126.           !         shell
  127.           +         firstcmd
  128.           H         help
  129.           h         help
  130.           V         version
  131.           q         quit
  132.           :q        quit
  133.           :Q        quit
  134.           ZZ        quit
  135.           \33\33    quit
  136.  
  137.      Commands specified by lesskey take precedence over the
  138.      default commands.  A default command key may be disabled by
  139.      including it in the key file with the action "invalid".
  140.  
  141.  
  142. SEE ALSO
  143.      less(1)
  144.