Page 266	Table of Contents	Index	Page 268
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E

---

CHAPTER 27. COMMAND PROCESSING

command directly, but will instead use a define-frame-command form that is automatically gen-
erated by define-application-frame. define-frame-command adds the command to the ap-
plication frame's command table. By default, define-command does not add the command to
any command table.

name-and-options is either a command name, or a cons of the command name and a list of
keyword-value pairs.

define-command defines two functions. The first function has the same name as the command
name, and implements the body of the command. It takes as arguments the arguments to the
command as specified by the define-command form, as required and keyword arguments.

The name of the other function defined by define-command is unspecified. It implements the
code used by the command processor for parsing and returning the command's arguments.

The keywords from name-and-options can be:

• :command-table command-table-name, where command-table-name either names a com-
  mand table to which the command will be added, or is nil (the default) to indicate that
  the command should not be added to any command table. If the command table does
  not exist, the command-table-not-found error will be signalled. This keyword is only
  accepted by define-command, not by define-frame-command.
  
  
• :name string, where string is a string that will be used as the command-line name for
  the command for keyboard interactions in the command table specified by the :command-
  table option. The default is nil, meaning that the command will not be available via
  command-line interactions. If string is t, then the command-line name will be generated
  automatically, as described in add-command-to-command-table.
  
  
• :menu menu-spec, where menu-spec describes an item in the menu of the command table
  specified by the :command-table option. The default is nil, meaning that the command
  will not be available via menu interactions. If menu-spec is a string, then that string will
  be used as the menu name. If menu-spec is t, then if a command-line name was supplied, it
  will be used as the menu name; otherwise the menu name will be generated automatically,
  as described in add-command-to-command-table. Otherwise, menu-spec must be a cons
  of the form (string . menu-options), where string is the menu name and menu-options
  consists of keyword-value pairs. The valid keywords are :after, :documentation, and
  :text-style, which are interpreted as for add-menu-item-to-command-table.
  
  
• :keystroke gesture, where gesture is a keyboard gesture name that specifies a keystroke
  accelerator to use for this command in the command table specified by the :command-
  table option. The default is nil, meaning that there is no keystroke accelerator.

The :name, :menu, and :keystroke options are only allowed if the :command-table option was
supplied explicitly or implicitly, as in define-frame-command.

arguments is a list consisting of argument descriptions. A single occurrence of the symbol &key
may appear in arguments to separate required command arguments from keyword arguments.
Each argument description consists of a parameter variable, followed by a presentation type
specifier, followed by keyword-value pairs. The keywords can be:

---

Page 266	Table of Contents	Index	Page 268
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E