Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
LESSKEY(1)		    General Commands Manual		    LESSKEY(1)

       clesskey	- specify key bindings for cless

       clesskey	[-o output] [input]
       clesskey	-V

       Lesskey	is  used to specify a set of key bindings to be	used by	cless.
       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, $HOME/.clesskey is	read.  The output file is a binary file	 which
       is  used	 by  cless.   If  no output file is specified, $HOME/.cless is
       written.	 If the	output file already exists,  clesskey  will  overwrite

       The input file consists of lines	of the form:

	    string <whitespace>	action [extra-string] <newline>

       Whitespace  is  any  sequence  of  one or more spaces and/or tabs.  The
       string is the command key(s) which invoke the action.  The  string  may
       be a single command key,	or a sequence of up to 15 keys.	 The action is
       the name	of the cless action, from the list below.  The	characters  in
       the  string 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	b, e, n, r or t	specifies BACKSPACE, ESCAPE,  NEWLINE,	RETURN
       or  TAB,	respectively.  A backslash followed by any other character in-
       dicates that character is to be taken literally.	 Characters which must
       be  preceded  by	 backslash include caret, space, tab and the backslash
       itself.	Blank lines and	lines which start with a pound	sign  (#)  are

       An action may be	followed by an "extra" string.	When such a command is
       entered while running cless, the	action is performed, and then the  ex-
       tra  string is parsed, just as if it were typed in to cless.  This fea-
       ture can	be used	in certain cases to extend the functionality of	a com-
       mand.  For example, see the "{" and ":t"	commands in the	example	below.

       The -V flag causes clesskey to print its	version	number and immediately
       exit.  Other flags and arguments	are ignored.

       The following input file	describes the set of default command keys used
       by cless:

	    \r	      forw-line
	    \n	      forw-line
	    e	      forw-line
	    j	      forw-line
	    ^E	      forw-line
	    ^N	      forw-line
	    k	      back-line
	    y	      back-line
	    ^Y	      back-line
	    ^K	      back-line
	    ^P	      back-line
	    J	      forw-line-force
	    K	      back-line-force
	    Y	      back-line-force
	    d	      forw-scroll
	    ^D	      forw-scroll
	    u	      back-scroll
	    ^U	      back-scroll
	    \40	      forw-screen
	    f	      forw-screen
	    ^F	      forw-screen
	    ^V	      forw-screen
	    b	      back-screen
	    ^B	      back-screen
	    \ev	      back-screen
	    z	      forw-window
	    w	      back-window
	    F	      forw-forever
	    R	      repaint-flush
	    r	      repaint
	    ^R	      repaint
	    ^L	      repaint
	    g	      goto-line
	    <	      goto-line
	    \e<	      goto-line
	    p	      percent
	    %	      percent
	    {	      forw-bracket {}
	    }	      back-bracket {}
	    (	      forw-bracket ()
	    )	      back-bracket ()
	    [	      forw-bracket []
	    ]	      back-bracket []
	    \e^F      forw-bracket
	    \e^B      back-bracket
	    G	      goto-end
	    \e>	      goto-end
	    >	      goto-end
	    =	      status
	    ^G	      status
	    :f	      status
	    /	      forw-search
	    ?	      back-search
	    \e/	      forw-search *
	    \e?	      back-search *
	    n	      repeat-search
	    \en	      repeat-search-all
	    N	      reverse-search
	    \eN	      reverse-search-all
	    \u	      undo-hilite
	    m	      set-mark
	    '	      goto-mark
	    ^X^X      goto-mark
	    E	      examine
	    :e	      examine
	    ^X^V      examine
	    :n	      next-file
	    :p	      prev-file
	    :x	      index-file
	    -	      toggle-option
	    :t	      toggle-option t
	    s	      toggle-option o
	    _	      display-option
	    |	      pipe
	    v	      visual
	    !	      shell
	    +	      firstcmd
	    H	      help
	    h	      help
	    V	      version
	    q	      quit
	    :q	      quit
	    :Q	      quit
	    ZZ	      quit

       Commands	 specified  by	clesskey 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 de-
       fined to	do nothing by using the	action "noaction".  "noaction" is sim-
       ilar  to	 "invalid", but	cless 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:


       This  will  cause  all  default commands	to be ignored.	The #stop line
       should be the last line in that section of the file.  (Another section,
       introduced by #line-edit, may follow the	#stop line.)

       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.

       New key bindings	may be specified for the line editing commands,	 in  a
       manner similar to the way key bindings for ordinary commands are	speci-
       fied.  This control line	marks the beginning of a section of line-edit-
       ing commands:


       Following  this	line is	a list of keys and actions, one	per line as in
       the example below.

       The following input file	describes the set of default line-editing keys
       used by cless:

	    \t	      forw-complete
	    \17	      back-complete
	    \e\t      back-complete
	    \14	      expand
	    ^V	      literal
	    ^A	      literal
	    \el	      right
	    \eh	      left
	    \eb	      word-left
	    \ew	      word-right
	    \ei	      insert
	    \ex	      delete
	    \e\b      word-backspace
	    \e0	      home
	    \e$	      end
	    \ek	      up
	    \ej	      down

       cless(1)	less(1)

       Copyright (c) 1984,1985,1989,1994,1995  Mark Nudelman



Want to link to this manual page? Use this URL:

home | help