12.155 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.

12.155.1 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.155.2 Emacspeak-Pronounce Commands

12.155.2.1 emacspeak-pronounce-clear

Command: emacspeak-pronounce-clear
Clear all current pronunciation dictionaries.

12.155.2.2 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.155.2.3 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.155.2.4 emacspeak-pronounce-dispatch

Command: emacspeak-pronounce-dispatch
C-e M-d
Pronounce Frontend

12.155.2.5 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.155.2.6 emacspeak-pronounce-load-dictionaries

Command: emacspeak-pronounce-load-dictionaries (&optional filename)
Load pronunciation dictionaries.
Optional argument FILENAME specifies the dictionary file,
Default is emacspeak-pronounce-dictionaries-file.

(fn &optional FILENAME)

12.155.2.7 emacspeak-pronounce-merge-dictionaries

Command: emacspeak-pronounce-merge-dictionaries (from into)
Merge dic ‘from’ into dict ‘into’

(fn FROM INTO)

12.155.2.8 emacspeak-pronounce-refresh-pronunciations

Command: emacspeak-pronounce-refresh-pronunciations
Refresh pronunciation table for current buffer. 

12.155.2.9 emacspeak-pronounce-save-dictionaries

Command: emacspeak-pronounce-save-dictionaries
Saves  pronunciation dictionaries.

12.155.2.10 emacspeak-pronounce-toggle-dictionaries

Command: emacspeak-pronounce-toggle-dictionaries (&optional state)
Toggle  pronunciation dictionaries. 

(fn &optional STATE)

12.155.2.11 emacspeak-pronounce-toggle-voice

Command: emacspeak-pronounce-toggle-voice
Toggle use of pronunciation personality.

12.155.3 emacspeak-pronounce Options

Variable: User Option emacspeak-pronounce-dictionaries-file
File that holds  emacspeak pronunciations.

Default Value:

"/home/raman/.emacspeak/.dictionary"

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

Default Value:

((":-)" . " smile ")
 (";)" . " half-wink ")
 (":)" . " grin ")
 (":-(" . " frown ")
 (":(" . " sigh ")
 (":-I" . " shrug ")
 (":->" . " sarcastic smile ")
 (">:->" . " devillish smile ")
 (">;->" . " lewd smile ")
 (";-)" . " wink "))

Variable: User Option emacspeak-pronounce-xml-ns
Namespace URIs.

Default Value:

(("http://www.w3.org/2005/Atom" . " atom ")
 ("http://www.w3.org/1999/02/22-rdf-syntax-ns#" . "RDF Syntax")
 ("http://www.w3.org/2002/06/xhtml2" . " xhtml2 ")
 ("http://www.w3.org/2003/XInclude" . "XInclude")
 ("http://www.w3.org/1999/XSL/Transform" . " XSLT ")
 ("http://www.w3.org/2002/xforms" . " XForms ")
 ("http://www.w3.org/2001/xml-events" . " XEvents ")
 ("http://www.w3.org/2001/vxml" . " vxml ")
 ("http://www.w3.org/2001/XMLSchema-instance" . " XSI ")
 ("http://www.w3.org/2001/XMLSchema" . " XSD ")
 ("http://www.w3.org/1999/xhtml" . " xhtml ")
 ("http://purl.org/dc/elements/1.1/" . "DC")
 ("http://search.yahoo.com/mrss/" . "media"))