transient-suffix, which in
turn derives from
transient-child, from which
derives (see Group Classes).
which in turn derives from the
Infixes are a special type of suffixes. The primary difference is
that infixes always use the
transient--do-stay pre-command, while
non-infix suffixes use a variety of pre-commands (see Transient State). Doing that is most easily achieved by using this class,
though theoretically it would be possible to define an infix class
that does not do so. If you do that then you get to implement many
Also, infixes and non-infix suffixes are usually defined using different macros (see Defining Suffix and Infix Commands).
transient-switch class (or a derived class) is used for infix
arguments that represent command-line switches (arguments that do
not take a value).
transient-option class (or a derived class) is used for infix
arguments that represent command-line options (arguments that do
take a value).
transient-switches class can be used for a set of mutually
exclusive command-line switches.
transient-files class can be used for a ‘--’ argument that
indicates that all remaining arguments are files.
transient-information class is special in that suffixes that use
this class are not associated with a command and thus also not with
any key binding. Such suffixes are only used to display arbitrary
information, and that anywhere a suffix can appear. Display-only
suffix specifications take this form:
([LEVEL] :info DESCRIPTION [KEYWORD VALUE]...)
:info keyword argument replaces the
:description keyword used for
other suffix classes. Other keyword arguments that you might want to
:face, predicate keywords (such as
By default the value of
%k, which for this class is
replaced with the empty string or spaces, if keys are being padded in
the containing group.
Magit defines additional classes, which can serve as examples for the fancy things you can do without modifying Transient. Some of these classes will likely get generalized and added to Transient. For now they are very much subject to change and not documented.