2.3 Common Suffix Commands

A few shared suffix commands are available in all transients. These suffix commands are not shown permanently in every menu by default. Most of these commands share a common prefix key and pressing that key causes the common commands to be temporarily shown in the active menu.

User Option: transient-show-common-commands

This option controls whether shared suffix commands are permanently shown alongside the menu-specific infix and suffix commands. By default, the shared commands are not permanently shown to avoid wasting precious space and overwhelming the user with too many choices.

If you prefer to always see these commands, then set this option to a non-nil value. Alternatively the value can be toggled for the current Emacs session only, using transient-toggle-common, described below.

User Option: transient-common-command-prefix

This option specifies the prefix key used in all transient menus to invoke most of the shared commands, which are available in all transient menus. By default these bindings are only shown after pressing that prefix key and before following that up with a valid key binding (but see the previous option).

For historic reasons C-x is used by default, but users are encouraged to pick another key, preferably one that is not commonly used in Emacs but is still convenient to them.

Usually, while a transient menu is active, the user cannot invoke commands that are not bound in the menu itself. For those menus it does not matter, if C-x or another commonly used prefix key is used for common menu commands. However, certain other, newer menus do not suppress key bindings established outside the menu itself, and in those cases a binding for a common menu command could shadow an external binding. For example, C-x C-s could not be used to invoke save-buffer, if that binding is shadowed by the menu binding for transient-save.

Which key is most suitable depends on the user’s preferences, but good choices may include function keys and C-z (for many keyboard layouts z is right next to x, and invoking suspend-frame, while a transient menu is active, would not be a good idea anyway).

C-x t (transient-toggle-common)

This command toggles whether the generic commands, that are common to all transients, are permanently displayed or only after typing the incomplete prefix key sequence. This only affects the current Emacs session.

The other common commands are described in either the previous or in one of the following sections.