Any Calculator command may be bound to a key using the Z D
(calc-user-define
) command. Actually, it is bound to a two-key
sequence beginning with the lower-case z prefix.
The Z D command first prompts for the key to define. For example,
press Z D a to define the new key sequence z a. You are then
prompted for the name of the Calculator command that this key should
run. For example, the calc-sincos
command is not normally
available on a key. Typing Z D s sincos RET programs the
z s key sequence to run calc-sincos
. This definition will remain
in effect for the rest of this Emacs session, or until you redefine
z s to be something else.
You can actually bind any Emacs command to a z key sequence by backspacing over the `calc-' when you are prompted for the command name.
As with any other prefix key, you can type z ? to see a list of all the two-key sequences you have defined that start with z. Initially, no z sequences (except z ? itself) are defined.
User keys are typically letters, but may in fact be any key. (META-keys are not permitted, nor are a terminal's special function keys which generate multi-character sequences when pressed.) You can define different commands on the shifted and unshifted versions of a letter if you wish.
The Z U (calc-user-undefine
) command unbinds a user key.
For example, the key sequence Z U s will undefine the sincos
key we defined above.
The Z P (calc-user-define-permanent
) command makes a key
binding permanent so that it will remain in effect even in future Emacs
sessions. (It does this by adding a suitable bit of Lisp code into
your `.emacs' file.) For example, Z P s would register
our sincos
command permanently. If you later wish to unregister
this command you must edit your `.emacs' file by hand.
(See section General Mode Commands, for a way to tell Calc to use a
different file instead of `.emacs'.)
The Z P command also saves the user definition, if any, for the command bound to the key. After Z F and Z C, a given user key could invoke a command, which in turn calls an algebraic function, which might have one or more special display formats. A single Z P command will save all of these definitions.
To save a command or function without its key binding (or if there is no key binding for the command or function), type ' (the apostrophe) when prompted for a key. Then, type the function name, or backspace to change the `calcFunc-' prefix to `calc-' and enter a command name. (If the command you give implies a function, the function will be saved, and if the function has any display formats, those will be saved, but not the other way around: Saving a function will not save any commands or key bindings associated with the function.)
The Z E (calc-user-define-edit
) command edits the definition
of a user key. This works for keys that have been defined by either
keyboard macros or formulas; further details are contained in the relevant
following sections.