Import less v394

1 files changed, 100 insertions, 202 deletions

diff --git a/contrib/less/lesskey.man b/contrib/less/lesskey.man
index addefe9..4730df4 100644
--- a/contrib/less/lesskey.man
+++ b/contrib/less/lesskey.man
@@ -1,9 +1,7 @@
+LESSKEY(1)                                                          LESSKEY(1)
 
 
 
-LESSKEY(1)                                             LESSKEY(1)
-
-
 NNAAMMEE
        lesskey - specify key bindings for less
 
@@ -14,33 +12,29 @@ SSYYNNOOPPSSIISS
        lleesssskkeeyy ----vveerrssiioonn
 
 DDEESSCCRRIIPPTTIIOONN
-       _L_e_s_s_k_e_y  is  used  to  specify a set of key bindings to be
-       used by _l_e_s_s_.   The  input  file  is  a  text  file  which
-       describes  the  key  bindings,  If  the input file is "-",
-       standard input is read.  If no input file is specified,  a
-       standard  filename  is used as the name of the input file,
-       which depends on the system being used: On  Unix  systems,
-       $HOME/.lesskey  is used; on MS-DOS systems, $HOME/_lesskey
-       is used; and on OS/2 systems $HOME/lesskey.ini is used, or
-       $INIT/lesskey.ini  if $HOME is undefined.  The output file
-       is a binary file which is used by _l_e_s_s_.  If no output file
-       is specified, and the environment variable LESSKEY is set,
-       the value of LESSKEY is used as the  name  of  the  output
-       file.   Otherwise, a standard filename is used as the name
-       of the output file, which  depends  on  the  system  being
-       used:  On  Unix  and OS-9 systems, $HOME/.less is used; on
-       MS-DOS systems, $HOME/_less is used; and on OS/2  systems,
-       $HOME/less.ini  is  used,  or  $INIT/less.ini  if $HOME is
-       undefined.  If the output  file  already  exists,  _l_e_s_s_k_e_y
-       will overwrite it.
-
-       The  -V  or  --version  option causes _l_e_s_s_k_e_y to print its
-       version number and immediately exit.  If -V  or  --version
-       is present, other options and arguments are ignored.
-
-       The  input  file  consists  of one or more _s_e_c_t_i_o_n_s_.  Each
-       section starts with a line that  identifies  the  type  of
-       section.  Possible sections are:
+       _L_e_s_s_k_e_y  is  used  to specify a set of key bindings to be used by _l_e_s_s_.
+       The input file is a text file which describes the key bindings, If  the
+       input  file is "-", standard input is read.  If no input file is speci-
+       fied, a standard filename is used as the name of the input file,  which
+       depends  on  the  system being used: On Unix systems, $HOME/.lesskey is
+       used; on MS-DOS systems, $HOME/_lesskey is used; and  on  OS/2  systems
+       $HOME/lesskey.ini  is used, or $INIT/lesskey.ini if $HOME is undefined.
+       The output file is a binary file which is used by _l_e_s_s_.  If  no  output
+       file  is  specified,  and  the environment variable LESSKEY is set, the
+       value of LESSKEY is used as the name of the output file.  Otherwise,  a
+       standard filename is used as the name of the output file, which depends
+       on the system being used: On Unix  and  OS-9  systems,  $HOME/.less  is
+       used;  on  MS-DOS  systems,  $HOME/_less  is used; and on OS/2 systems,
+       $HOME/less.ini is used, or $INIT/less.ini if $HOME  is  undefined.   If
+       the output file already exists, _l_e_s_s_k_e_y will overwrite it.
+
+       The  -V  or --version option causes _l_e_s_s_k_e_y to print its version number
+       and immediately exit.  If -V or --version is present, other options and
+       arguments are ignored.
+
+       The  input  file consists of one or more _s_e_c_t_i_o_n_s_.  Each section starts
+       with a line that identifies the type  of  section.   Possible  sections
+       are:
 
        #command
               Defines new command keys.
@@ -50,8 +44,8 @@ DDEESSCCRRIIPPTTIIOONN
 
        #env   Defines environment variables.
 
-       Blank  lines  and  lines which start with a pound sign (#)
-       are ignored, except for the special section header  lines.
+       Blank  lines  and  lines which start with a pound sign (#) are ignored,
+       except for the special section header lines.
 
 
 CCOOMMMMAANNDD SSEECCTTIIOONN
@@ -59,33 +53,19 @@ CCOOMMMMAANNDD SSEECCTTIIOONN
 
        #command
 
-
-
-                     Version 381: 17 Jan 2003                   1
-
-
-
-
-
-LESSKEY(1)                                             LESSKEY(1)
-
-
-       If  the  command section is the first section in the file,
-       this line may be omitted.  The command section consists of
-       lines of the form:
+       If the command section is the first section in the file, this line  may
+       be omitted.  The command section consists of lines of the form:
 
             _s_t_r_i_n_g <whitespace> _a_c_t_i_o_n [extra-string] <newline>
 
-       Whitespace  is  any  sequence of one or more spaces and/or
-       tabs.  The _s_t_r_i_n_g is the command key(s) which  invoke  the
-       action.   The  _s_t_r_i_n_g  may  be  a single command key, or a
-       sequence of up to 15 keys.  The _a_c_t_i_o_n is the name of  the
-       less  action,  from the list below.  The characters in the
-       _s_t_r_i_n_g may appear literally, or be prefixed by a caret  to
-       indicate  a  control  key.  A backslash followed by one to
-       three octal digits may be used to specify a  character  by
-       its  octal value.  A backslash followed by certain charac­
-       ters specifies input characters as follows:
+       Whitespace  is  any  sequence  of  one or more spaces and/or tabs.  The
+       _s_t_r_i_n_g is the command key(s) which invoke the action.  The  _s_t_r_i_n_g  may
+       be a single command key, or a sequence of up to 15 keys.  The _a_c_t_i_o_n is
+       the name of the less action, from the list below.   The  characters  in
+       the  _s_t_r_i_n_g may appear literally, or be prefixed by a caret to indicate
+       a control key.  A backslash followed by one to three octal  digits  may
+       be  used  to  specify a character by its octal value.  A backslash fol-
+       lowed by certain characters specifies input characters as follows:
 
        \b     BACKSPACE
 
@@ -115,37 +95,22 @@ LESSKEY(1)                                             LESSKEY(1)
 
        \kx    DELETE
 
-       A backslash followed by any other character indicates that
-       character is to be taken literally.  Characters which must
-       be preceded by backslash include caret, space, tab and the
-       backslash itself.
-
-       An action may be followed by an "extra" string.  When such
-       a command is entered while running  _l_e_s_s_,  the  action  is
-       performed, and then the extra string is parsed, just as if
-       it were typed in to _l_e_s_s_.  This feature  can  be  used  in
-
-
-
-                     Version 381: 17 Jan 2003                   2
-
-
-
+       A backslash followed by any other character indicates that character is
+       to  be taken literally.  Characters which must be preceded by backslash
+       include caret, space, tab and the backslash itself.
 
-
-LESSKEY(1)                                             LESSKEY(1)
-
-
-       certain  cases  to  extend the functionality of a command.
-       For example, see the "{" and ":t" commands in the  example
-       below.   The  extra  string  has a special meaning for the
-       "quit" action: when _l_e_s_s quits,  first  character  of  the
-       extra string is used as its exit status.
+       An action may be followed by an "extra" string.  When such a command is
+       entered while running _l_e_s_s_, the action is performed, and then the extra
+       string is parsed, just as if it were typed in to  _l_e_s_s_.   This  feature
+       can  be used in certain cases to extend the functionality of a command.
+       For example, see the "{" and ":t" commands in the example  below.   The
+       extra  string  has  a  special meaning for the "quit" action: when _l_e_s_s
+       quits, first character of the extra string is used as its exit  status.
 
 
 EEXXAAMMPPLLEE
-       The following input file describes the set of default com­
-       mand keys used by less:
+       The following input file describes the set of default command keys used
+       by less:
 
             #command
             \r        forw-line
@@ -190,18 +155,6 @@ EEXXAAMMPPLLEE
             <         goto-line
             \e<       goto-line
             p         percent
-
-
-
-                     Version 381: 17 Jan 2003                   3
-
-
-
-
-
-LESSKEY(1)                                             LESSKEY(1)
-
-
             %         percent
             \e[       left-scroll
             \e]       right-scroll
@@ -256,18 +209,6 @@ LESSKEY(1)                                             LESSKEY(1)
             0         digit
             1         digit
             2         digit
-
-
-
-                     Version 381: 17 Jan 2003                   4
-
-
-
-
-
-LESSKEY(1)                                             LESSKEY(1)
-
-
             3         digit
             4         digit
             5         digit
@@ -283,27 +224,23 @@ LESSKEY(1)                                             LESSKEY(1)
 
 
 PPRREECCEEDDEENNCCEE
-       Commands specified by _l_e_s_s_k_e_y  take  precedence  over  the
-       default  commands.   A default command key may be disabled
-       by  including  it  in  the  input  file  with  the  action
-       "invalid".   Alternatively,  a  key  may  be defined to do
-       nothing by using the  action  "noaction".   "noaction"  is
-       similar to "invalid", but _l_e_s_s will give an error beep for
-       an "invalid" command, but not for  a  "noaction"  command.
-       In  addition,  ALL  default  commands  may  be disabled by
-       adding this control line to the input file:
+       Commands specified by _l_e_s_s_k_e_y take precedence  over  the  default  com-
+       mands.   A  default  command key may be disabled by including it in the
+       input file with the action "invalid".   Alternatively,  a  key  may  be
+       defined  to  do  nothing by using the action "noaction".  "noaction" is
+       similar to "invalid", but _l_e_s_s will give an error beep for an "invalid"
+       command,  but  not  for a "noaction" command.  In addition, ALL default
+       commands may be disabled by adding this control line to the input file:
 
        #stop
 
-       This will cause all default commands to be  ignored.   The
-       #stop  line should be the last line in that section of the
-       file.
+       This  will  cause  all  default commands to be ignored.  The #stop line
+       should be the last line in that section of the file.
 
-       Be aware that #stop can be dangerous.  Since  all  default
-       commands  are  disabled,  you must provide sufficient com­
-       mands before  the  #stop  line  to  enable  all  necessary
-       actions.  For example, failure to provide a "quit" command
-       can lead to frustration.
+       Be aware that #stop can be dangerous.  Since all default  commands  are
+       disabled, you must provide sufficient commands before the #stop line to
+       enable all necessary actions.  For example, failure to provide a "quit"
+       command can lead to frustration.
 
 
 LLIINNEE EEDDIITTIINNGG SSEECCTTIIOONN
@@ -311,28 +248,15 @@ LLIINNEE EEDDIITTIINNGG SSEECCTTIIOONN
 
        #line-edit
 
-       This section specifies new key bindings for the line edit­
-       ing  commands, in a manner similar to the way key bindings
-       for ordinary commands are specified in the  #command  sec­
-       tion.  The line-editing section consists of a list of keys
-       and actions, one per line as in the example below.
+       This  section specifies new key bindings for the line editing commands,
+       in a manner similar to the way key bindings for ordinary  commands  are
+       specified  in  the #command section.  The line-editing section consists
+       of a list of keys and actions, one per line as in the example below.
 
 
 EEXXAAMMPPLLEE
-       The following input file  describes  the  set  of  default
-       line-editing keys used by less:
-
-
-
-
-                     Version 381: 17 Jan 2003                   5
-
-
-
-
-
-LESSKEY(1)                                             LESSKEY(1)
-
+       The following input file describes the set of default line-editing keys
+       used by less:
 
             #line-edit
             \t        forw-complete
@@ -370,35 +294,21 @@ LLEESSSS EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
 
        #env
 
-       Following  this  line  is  a  list of environment variable
-       assignments.  Each line consists of an  environment  vari­
-       able name, an equals sign (=) and the value to be assigned
-       to the environment variable.  White space before and after
-       the  equals  sign  is ignored.  Variables assigned in this
-       way are visible only to _l_e_s_s_.  If a variable is  specified
-       in  the system environment and also in a lesskey file, the
-       value in the lesskey file takes precedence.  Although  the
-       lesskey  file can be used to override variables set in the
-       environment, the main purpose of  assigning  variables  in
-       the  lesskey file is simply to have all _l_e_s_s configuration
+       Following  this  line  is  a  list of environment variable assignments.
+       Each line consists of an environment variable name, an equals sign  (=)
+       and  the value to be assigned to the environment variable.  White space
+       before and after the equals sign is  ignored.   Variables  assigned  in
+       this  way  are visible only to _l_e_s_s_.  If a variable is specified in the
+       system environment and also in a lesskey file, the value in the lesskey
+       file  takes precedence.  Although the lesskey file can be used to over-
+       ride variables set in the environment, the main  purpose  of  assigning
+       variables  in the lesskey file is simply to have all _l_e_s_s configuration
        information stored in one file.
 
 
 EEXXAAMMPPLLEE
-       The following input file sets the -i option whenever  _l_e_s_s
-       is run, and specifies the character set to be "latin1":
-
-
-
-
-                     Version 381: 17 Jan 2003                   6
-
-
-
-
-
-LESSKEY(1)                                             LESSKEY(1)
-
+       The following input file sets the -i option whenever _l_e_s_s is  run,  and
+       specifies the character set to be "latin1":
 
             #env
             LESS = -i
@@ -411,52 +321,40 @@ SSEEEE AALLSSOO
 
 
 WWAARRNNIINNGGSS
-       It  is not possible to specify special keys, such as upar­
-       row, in a keyboard-independent manner.  The  only  way  to
-       specify  such keys is to specify the escape sequence which
-       a particular keyboard sends when such a key is pressed.
+       It  is not possible to specify special keys, such as uparrow, in a key-
+       board-independent manner.  The only way to  specify  such  keys  is  to
+       specify the escape sequence which a particular keyboard sends when such
+       a key is pressed.
 
-       On MS-DOS and OS/2 systems, certain keys send  a  sequence
-       of  characters which start with a NUL character (0).  This
-       NUL character should be represented as \340 in  a  lesskey
-       file.
+       On MS-DOS and OS/2 systems, certain keys send a sequence of  characters
+       which  start  with  a  NUL character (0).  This NUL character should be
+       represented as \340 in a lesskey file.
 
 
 CCOOPPYYRRIIGGHHTT
-       Copyright (C) 2000  Mark Nudelman
+       Copyright (C) 2004  Mark Nudelman
 
-       lesskey  is  part of the GNU project and is free software;
-       you can redistribute it and/or modify it under  the  terms
-       of the GNU General Public License as published by the Free
-       Software Foundation; either version 2, or (at your option)
-       any later version.
+       lesskey is part of the GNU project and is free software; you can redis-
+       tribute  it  and/or modify it under the terms of the GNU General Public
+       License as published by the Free Software Foundation; either version 2,
+       or (at your option) any later version.
 
-       lesskey is distributed in the hope that it will be useful,
-       but WITHOUT ANY WARRANTY; without even  the  implied  war­
-       ranty  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR­
-       POSE.   See  the  GNU  General  Public  License  for  more
-       details.
+       lesskey  is distributed in the hope that it will be useful, but WITHOUT
+       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
+       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
+       for more details.
 
-       You  should have received a copy of the GNU General Public
-       License along with lesskey; see the file COPYING.  If not,
-       write  to  the  Free Software Foundation, 59 Temple Place,
-       Suite 330, Boston, MA  02111-1307, USA.
+       You should have received a copy of the GNU General Public License along
+       with lesskey; see the file COPYING.  If not, write to the Free Software
+       Foundation, 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
 
 
 AAUUTTHHOORR
        Mark Nudelman <markn@greenwoodsoftware.com>
-       Send bug reports or comments to the above  address  or  to
-       bug-less@gnu.org.
-
-
-
-
-
-
-
-
+       Send  bug  reports  or  comments  to  the  above  address  or  to  bug-
+       less@gnu.org.
 
 
-                     Version 381: 17 Jan 2003                   7
 
 
+                           Version 394: 03 Dec 2005                 LESSKEY(1)