Next: , Previous: , Up: Emacspeak Commands And Options   [Contents][Index]


12.195 emacspeak-transient

TRANSIENT == Transient commands — used by magit and friends. This module speech-enables transient.

12.195.1 Introduction

Package Transient is similar to package Hydra in the sense that it can be used to create a sequence of chained/hierarchical commands that are invoked via a sequence of keys. It is used by Magit for dispatching to the various Git commands. Speech-enabling package Transient results in the various interactive commands producing auditory feedback. Transient shows an ephemeral window with the currently available commands, Emacspeak speech-enables transient–show to speak that content.

Finally, this module defines a new minor mode called transient-emacspeak that enables interactive browsing of the contents displayed temporarily. Note that without this functionality, learning complex packages like Magit would be difficult because the list of available commands (potentially very long) gets spoken in its entirety by the advice on transient–show.

12.195.2 Browsing Contents Of transient–show

When executing a command defined via Transient — e.g. command Magit-dispatch and friends, press C-z (transient-suspend) to temporarily suspend the currently active transient. Emacspeak now displays a *transient-emacspeak* buffer that displays the contents of the most recently displayed transient choices. Pressing C-c resumes the transient; Pressing C-q quits the transient.

12.195.3 emacspeak-transient Commands

12.195.3.1 emacspeak-transient-mode

Command: emacspeak-transient-mode
emacspeak integration with Transient.

In addition to any hooks its parent mode ‘special-mode’ might have run,
this mode runs the hook ‘emacspeak-transient-mode-hook’, as the final or penultimate step
during initialization.

key             binding
—             ——-

12.195.4 emacspeak-transient Options

Variable: User Option voice-transient-argument

Personality used for transient-argument This personality uses voice-animate whose effect can be changed globally by customizing voice-animate-settings.

Variable: User Option voice-transient-disabled-suffix

Personality used for transient-disabled-suffix This personality uses voice-smoothen whose effect can be changed globally by customizing voice-smoothen-settings.

Variable: User Option voice-transient-enabled-suffix

Personality used for transient-enabled-suffix This personality uses voice-brighten whose effect can be changed globally by customizing voice-brighten-settings.

Variable: User Option voice-transient-heading

Personality used for transient-heading This personality uses voice-bolden whose effect can be changed globally by customizing voice-bolden-settings.

Variable: User Option voice-transient-inactive-argument

Personality used for transient-inactive-argument This personality uses voice-smoothen-extra whose effect can be changed globally by customizing voice-smoothen-extra-settings.

Variable: User Option voice-transient-inactive-value

Personality used for transient-inactive-value This personality uses voice-smoothen-extra whose effect can be changed globally by customizing voice-smoothen-extra-settings.

Variable: User Option voice-transient-key

Personality used for transient-key This personality uses voice-highlight whose effect can be changed globally by customizing voice-highlight-settings.

Variable: User Option voice-transient-mismatched-key

Personality used for transient-mismatched-key This personality uses voice-monotone whose effect can be changed globally by customizing voice-monotone-settings.

Variable: User Option voice-transient-nonstandard-key

Personality used for transient-nonstandard-key This personality uses voice-monotone whose effect can be changed globally by customizing voice-monotone-settings.

Variable: User Option voice-transient-unreachable

Personality used for transient-unreachable This personality uses voice-monotone whose effect can be changed globally by customizing voice-monotone-settings.

Variable: User Option voice-transient-unreachable-key

Personality used for transient-unreachable-key This personality uses voice-monotone whose effect can be changed globally by customizing voice-monotone-settings.

Variable: User Option voice-transient-value

Personality used for transient-value This personality uses voice-brighten whose effect can be changed globally by customizing voice-brighten-settings.


Next: , Previous: , Up: Emacspeak Commands And Options   [Contents][Index]