====== bindkey ======

===== Default Keybindings =====

None.

===== Syntax =====

  * ''**bindkey** [-d] [-m] [-a] %%[[%%-k|-t] //string// [//cmd// //args//]]''

===== Description =====

This command manages ''screen''’s input translation tables.  Every entry
in one of the tables tells screen how to react if a certain sequence of
characters is encountered.  There are three tables:  one that should
contain actions programmed by the user, one for the default actions used
for terminal emulation and one for screen’s ''[[commands:copy]]'' mode to
do cursor movement.  See section [[man:Default Key Bindings]] for a list of
default key bindings.  If the ''-d'' option is given, ''bindkey'' modifies
the default table; ''-m'' changes the copy mode table and with neither
option the user table is selected.  The argument //string// is the
sequence of characters to which an action is bound.  This can either be a
fixed string or a termcap keyboard capability name (selectable with the
''-k'' option).

Some keys on a VT100 terminal can send a different string if application
mode is turned on (e.g the cursor keys).  Such keys have two entries in
the translation table.  You can select the application mode entry by
specifying the ''-a'' option.

The ''-t'' option tells screen not to do inter-character timing.  One
cannot turn off the timing if a termcap capability is used.

//cmd// can be any of screen’s commands with an arbitrary number of
//args//.  If //cmd// is omitted the key-binding is removed from the
table.

===== Examples =====

<code>
bindkey -d
</code>

Show all of the default key bindings.  The application mode entries are
marked with [A].

<code>
bindkey -k k1 select 1
</code>

Make the "F1" key switch to window one.

<code>
bindkey -t foo stuff barfoo
</code>

Make "''foo''" an abbreviation of the word "''barfoo''".  Timeout is
disabled so that users can type slowly.

<code>
bindkey "\024" mapdefault
</code>

This key-binding makes "''^T''" an escape character for keybindings.  If
you did the above "''[[commands:stuff]] barfoo''" binding, you can enter
the word "''foo''" by typing "''^Tfoo''". If you want to insert a "''^T''"
you have to press the key twice (i.e., escape the escape binding).

<code>
bindkey -k F1 command
</code>

Make the ''F11'' (not ''F1''!) key an alternative screen escape (besides ''^A'').

===== See Also =====

  * ''[[maptimeout]]''
  * [[:interface]]