===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/less/lesskey.1,v
retrieving revision 1.11
retrieving revision 1.12
diff -c -r1.11 -r1.12
*** src/usr.bin/less/lesskey.1	2014/04/25 13:38:21	1.11
--- src/usr.bin/less/lesskey.1	2014/11/23 08:01:06	1.12
***************
*** 1,4 ****
! .\"	$OpenBSD: lesskey.1,v 1.11 2014/04/25 13:38:21 shadchin Exp $
  .\"
  .\" Copyright (C) 2000-2012  Mark Nudelman
  .\"
--- 1,4 ----
! .\"	$OpenBSD: lesskey.1,v 1.12 2014/11/23 08:01:06 bentley Exp $
  .\"
  .\" Copyright (C) 2000-2012  Mark Nudelman
  .\"
***************
*** 22,28 ****
  .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! .Dd $Mdocdate: April 25 2014 $
  .Dt LESSKEY 1
  .Os
  .Sh NAME
--- 22,28 ----
  .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! .Dd $Mdocdate: November 23 2014 $
  .Dt LESSKEY 1
  .Os
  .Sh NAME
***************
*** 30,37 ****
  .Nd specify key bindings for less
  .Sh SYNOPSIS
  .Nm lesskey
! .Oo Fl o Ar output
! .Pf " | " Fl -output Ns = Ns Ar output Oc
  .Op Ar input
  .Nm lesskey
  .Fl V | -version
--- 30,36 ----
  .Nd specify key bindings for less
  .Sh SYNOPSIS
  .Nm lesskey
! .Op Fl o Ar output | Fl -output Ns = Ns Ar output
  .Op Ar input
  .Nm lesskey
  .Fl V | -version
***************
*** 109,115 ****
  Defines environment variables.
  .El
  .Pp
! Blank lines and lines which start with a pound sign (#) are ignored,
  except for the special section header lines.
  .Sh COMMAND SECTION
  The command section begins with the line
--- 108,116 ----
  Defines environment variables.
  .El
  .Pp
! Blank lines and lines which start with a pound sign
! .Pq Sq #
! are ignored,
  except for the special section header lines.
  .Sh COMMAND SECTION
  The command section begins with the line
***************
*** 181,204 ****
  Characters which must be preceded by backslash include
  caret, space, tab and the backslash itself.
  .Pp
! An action may be followed by an
! .Qq extra
! string.
  When such a command is entered while running less,
  the action is performed, and then the extra
! string is parsed, just as if it were typed in to less.
  This feature can be used in certain cases to extend
  the functionality of a command.
  For example, see the
! .Sq {
  and
! .Sq :t
  commands in the example below.
  The extra string has a special meaning for the
! .Qq quit
  action:
  when less quits,
! first character of the extra string is used as its exit status.
  .Pp
  The following input file describes the set of
  default command keys used by less:
--- 182,203 ----
  Characters which must be preceded by backslash include
  caret, space, tab and the backslash itself.
  .Pp
! An action may be followed by an additional string.
  When such a command is entered while running less,
  the action is performed, and then the extra
! string is parsed, just as if it were typed into less.
  This feature can be used in certain cases to extend
  the functionality of a command.
  For example, see the
! .Cm {
  and
! .Cm :t
  commands in the example below.
  The extra string has a special meaning for the
! .Cm quit
  action:
  when less quits,
! the first character of the extra string is used as its exit status.
  .Pp
  The following input file describes the set of
  default command keys used by less:
***************
*** 321,351 ****
  take precedence over the default commands.
  A default command key may be disabled by including it in the
  input file with the action
! .Qq invalid .
  Alternatively, a key may be defined
  to do nothing by using the action
! .Qq noaction .
! .Qq noaction
  is similar to
! .Qq invalid ,
  but less will give an error beep for an
! .Qq invalid
  command, but not for a
! .Qq noaction
  command.
! In addition, ALL default commands may be disabled by
  adding this control line to the input file:
  .Pp
  .Dl #stop
  .Pp
  This will cause all default commands to be ignored.
! The #stop line should be the last line in that section of the file.
  .Pp
! 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
! .Qq quit
  command can lead to frustration.
  .Sh LINE EDITING SECTION
  The line-editing section begins with the line:
--- 320,356 ----
  take precedence over the default commands.
  A default command key may be disabled by including it in the
  input file with the action
! .Cm invalid .
  Alternatively, a key may be defined
  to do nothing by using the action
! .Cm noaction .
! .Cm noaction
  is similar to
! .Cm invalid ,
  but less will give an error beep for an
! .Cm invalid
  command, but not for a
! .Cm noaction
  command.
! In addition, all default commands may be disabled by
  adding this control line to the input file:
  .Pp
  .Dl #stop
  .Pp
  This will cause all default commands to be ignored.
! The
! .Cm #stop
! line should be the last line in that section of the file.
  .Pp
! Be aware that
! .Cm #stop
! can be dangerous.
  Since all default commands are disabled, you must provide sufficient
! commands before the
! .Cm #stop
! line to enable all necessary actions.
  For example, failure to provide a
! .Cm quit
  command can lead to frustration.
  .Sh LINE EDITING SECTION
  The line-editing section begins with the line:
***************
*** 410,418 ****
  environment, the main purpose of assigning variables in the lesskey file
  is simply to have all less configuration information stored in one file.
  .Pp
! The following input file sets the -i option whenever less is run,
  and specifies the character set to be
! .Qq latin1 :
  .Bd -literal -offset indent
  #env
  LESS = -i
--- 415,425 ----
  environment, the main purpose of assigning variables in the lesskey file
  is simply to have all less configuration information stored in one file.
  .Pp
! The following input file sets the
! .Fl i
! option whenever less is run,
  and specifies the character set to be
! .Cm latin1 :
  .Bd -literal -offset indent
  #env
  LESS = -i
***************
*** 431,445 ****
  .El
  .Sh FILES
  .Bl -tag -width "$HOME/.lesskey" -compact
! .It $HOME/.less
  Default
  .Nm
  file.
! .It $HOME/.lesskey
  Default
  .Nm
  input file.
! .It /etc/sysless
  Default system-wide
  .Nm
  file.
--- 438,452 ----
  .El
  .Sh FILES
  .Bl -tag -width "$HOME/.lesskey" -compact
! .It Pa $HOME/.less
  Default
  .Nm
  file.
! .It Pa $HOME/.lesskey
  Default
  .Nm
  input file.
! .It Pa /etc/sysless
  Default system-wide
  .Nm
  file.
***************
*** 450,456 ****
  .An Mark Nudelman
  .Pp
  Send bug reports or comments to
! .Aq Mt bug\-less@gnu.org .
  .\" .Sh CAVEATS
  .\" On MS-DOS and OS/2 systems, certain keys send a sequence of characters
  .\" which start with a NUL character (0).
--- 457,463 ----
  .An Mark Nudelman
  .Pp
  Send bug reports or comments to
! .Aq Mt bug-less@gnu.org .
  .\" .Sh CAVEATS
  .\" On MS-DOS and OS/2 systems, certain keys send a sequence of characters
  .\" which start with a NUL character (0).