12.149 emacspeak-pronounce

This module implements user customizable pronunciation dictionaries for emacspeak. Custom pronunciations can be defined per file, per directory and/or per major mode. Emacspeak maintains a persistent user dictionary upon request and loads these in new emacspeak sessions. This module implements the user interface to the custom dictionary as well as providing the internal API used by the rest of emacspeak in using the dictionary. Algorithm:

The persistent dictionary is a hash table where the hash keys are filenames, directory names, or major-mode names. The hash values are association lists defining the dictionary. Users of this module can retrieve a dictionary made up of all applicable association lists for a given file.

12.149.1 emacspeak-pronounce Commands

12.149.1.1 emacspeak-pronounce-clear-dictionaries

Command: emacspeak-pronounce-clear-dictionaries

        Clear all current pronunciation dictionaries.

12.149.1.2 emacspeak-pronounce-define-local-pronunciation

Command: emacspeak-pronounce-define-local-pronunciation (word pronunciation)

Define buffer local pronunciation.
Argument WORD specifies the word which should be pronounced as specified by PRONUNCIATION.

(fn WORD PRONUNCIATION)

12.149.1.3 emacspeak-pronounce-define-pronunciation

Command: emacspeak-pronounce-define-pronunciation

        Interactively define entries in the pronunciation dictionaries.
Default term to define is delimited by region.
First loads any persistent dictionaries if not already loaded.

12.149.1.4 emacspeak-pronounce-define-template-pronunciation

Command: emacspeak-pronounce-define-template-pronunciation

        Interactively define template entries in the pronunciation dictionaries.
Default term to define is delimited by region.
First loads any persistent dictionaries if not already loaded.

12.149.1.5 emacspeak-pronounce-dispatch

Command: emacspeak-pronounce-dispatch

C-e M-d

<fn> M-d

        Provides the user interface front-end to Emacspeak’s pronunciation dictionaries.

12.149.1.6 emacspeak-pronounce-edit-pronunciations

Command: emacspeak-pronounce-edit-pronunciations (key)

        Prompt for and launch a pronunciation editor on the
specified pronunciation dictionary key.

(fn KEY)

12.149.1.7 emacspeak-pronounce-load-dictionaries

Command: emacspeak-pronounce-load-dictionaries (&optional filename)

Load pronunciation dictionaries.
Optional argument FILENAME specifies the dictionary file.

(fn &optional FILENAME)

12.149.1.8 emacspeak-pronounce-refresh-pronunciations

Command: emacspeak-pronounce-refresh-pronunciations

        Refresh pronunciation table for current buffer.
Activates pronunciation dictionaries if not already active.

12.149.1.9 emacspeak-pronounce-save-dictionaries

Command: emacspeak-pronounce-save-dictionaries

        Writes out the persistent emacspeak pronunciation dictionaries.

12.149.1.10 emacspeak-pronounce-toggle-use-of-dictionaries

Command: emacspeak-pronounce-toggle-use-of-dictionaries (&optional state)

        Toggle use of pronunciation dictionaries in current buffer.
Pronunciations can be defined on a per file, per directory and/or
per mode basis.  Pronunciations are activated on a per buffer
basis.  Turning on the use of pronunciation dictionaries results
in emacspeak composing a pronunciation table based on the
currently defined pronunciation dictionaries.  After this, the
pronunciations will be applied whenever text in the buffer is
spoken.  Optional argument state can be used from Lisp programs
to explicitly turn pronunciations on or off.

(fn &optional STATE)

12.149.1.11 emacspeak-pronounce-yank-word

Command: emacspeak-pronounce-yank-word

Yank word at point into minibuffer.

12.149.2 emacspeak-pronounce Options

Variable: User Option emacspeak-pronounce-common-xml-namespace-uri-pronunciations

Pronunciations for well known namespace URIs.

Variable: User Option emacspeak-pronounce-dictionaries-file

File that holds the persistent emacspeak pronunciation dictionaries.

Variable: User Option emacspeak-pronounce-internet-smileys-pronunciations

Pronunciation dictionary used in all instant messenger and IRC chat modes. See http://www.charm.net/~kmarsh/smiley.html.

Variable: User Option emacspeak-pronounce-load-pronunciations-on-startup

Says if user dictionaries loaded on emacspeak startup.

Variable: User Option emacspeak-pronounce-pronunciation-personality

*Pronunciation personality. This is the personality used when speaking things that have a pronunciation applied.