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
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 Calc init file; that is, the file given by the variable
calc-settings-file, typically ~/.emacs.d/calc.el.) For example,
Z P s would register our
sincos command permanently. If
you later wish to unregister this command you must edit your Calc init
file by hand. (See General Mode Commands, for a way to tell Calc to
use a different file for the Calc init file.)
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 an algebraic function, type ' (the apostrophe) when prompted for a key, and type the function name. To save a command without its key binding, type M-x and enter a function name. (The ‘calc-’ prefix will automatically be inserted for you.) (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