ARPUS/ce, Version 2.6.2 (03/10/05) (SCCS 1.7)
_______________________________________________________________________________
kd <keyname> [ [<key_definition>] ke ]
"key definition"
DESCRIPTION:
'kd' is used to set, display, or erase a key definition for a specific
key. The three forms of the 'kd' command are as follows:
kd <keyname> Display in ce's output window the
definition currently assigned to the
specified key.
kd <keyname> <def> ke Set the specified key's definition to
<def>; <def> is parsed at definition
time for validity, and if ce detects a
syntax error in the definition, it is
rejected.
kd <keyname> ke Erase any definition associated with
the specified key and revert to the
default definition. For most keys the
default definition is a no-op. For
alphanumeric keys such as 'a' and '3',
the default action is to insert the
typed character.
<keyname> can be an unmodified or modified X keysym such
as "BackSpace" or a string of the form #hhhhhhhh, where #hhhhhhhh
is a hexadecimal representation of the keycode for the desired key or
mouse button with a leading #. To find the keysym for a
specific key,
use the ce 'kk' command.
The act of pressing a key and then releasing it really generates two
events, one corresponding to the downstroke and the other
corresponding to the upstroke. Each stroke can be identified
individually. A basic <keyname> refers to the downstroke. If you
want to assign a definition to a key's upstroke, append a 'U' to the
<keyname>. For example, if you want the BackSpace key to take its
normal action (deleting the character before the cursor) and would
additionally like the upstroke to show the new cursor position in the
output window, you would use the following kd command:
kd BackSpaceU = ke
Keysym modifications are prefixed or suffixed to the keysym. Multiple
modifiers are allowed. <keyname>'s are case-sensitive; 'BackSpace'
and 'backspace' are not equivalent
As an example, consider how one might assign numerous definitions to
the F1 function key, whose keysym is "F1". To define F1 to insert a
blank line below the current line, you would issue the command
kd F1 tr;en ke
There are six (7) modifiers supported. The two most commonly used
modifiers are 'shift' and 'control'. The other five, in X terminology,
are called 'mod1', 'mod2', 'mod3', 'mod4' and 'mod5'. The actual keys
that invoke mods 1-5 vary between keyboards, so you will have to
determine for yourself which keys those are. (They may be labeled as
"Alt", "Extend Char", "Compose Char", or other similar names.) The mod1
modifier is usually mapped to the Alt key.
The <keyname>'s for the 6 modified F1 definitions would be:
What to press <keyname>
-----------------------------------------
Shift and F1 F1S or F1s
Control and F1 ^F1
Mod 1 and F1 *F1
Mod 2 and F1 ~F1
Mod 3 and F1 =F1
Mod 4 and F1 `F1
Mod 5 and F1 %F1
Modifiers can be combined. This means that pressing Shift and Control
and F1 is a valid key combination whose unique <keyname> is "^F1S". The
<keyname> "^*~=`F1S" is valid and corresponds to pressing Shift, Control,
and Mods 1-4, and, while holding them all down, pressing F1. Try doing
THAT with one hand!
NOTE: The up stoke of a key can also be defined for different
modifiers just like the downstroke. Thus F1SU and F1U are
separate key definitions. This is a divergence from the behavior of an
HP/Apollo Domain/OS system.
NOTE: The window manager that you use (OSF/Motif, Open Window, ...) can
reserve certain keys, making them unavailable for use by applications
such as ce. If you find that one of your key definitions is not
functioning as expected, consult your window manager documentation to
see if you are using such a reserved key or key
combination.
NOTE: If you are using 'ce' on an HP/Apollo Domain/OS system with a
"kbd3" keyboard, you can refer to the keys using the Apollo keynames,
"l1" ... "lf", "r1" ... "r6", "np0" ... "np9", etc. An exception to this
is the definition for "bs" which on an HP/Apollo Domain/OS system refers
to the backspace key. Under Ce, the X name of BackSpace must be used.
The f0 key on an Apollo keyboard is officially F10.
RELATED HELP FILES:
lkd (Local Key Definition)
kk (Key Key)
mi (Menu Item)
cmdf (Command File)
alias (Alias commands)
commands (List of Commands)
(Prompt)
keyCon (Key Concepts)
xresources (Arguments and X resources)
support (customer support)
_______________________________________________________________________________
Copyright (c) 2005, Robert Styma Consulting. All rights reserved.