- fixes for emacspeak:

[packages/emacspeak.git] / emacspeak-debian.patch

--- emacspeak-24.orig/info/tts-server.texi
+++ emacspeak-24/info/tts-server.texi
@@ -1,209 +1,209 @@
-        @c $Id$
-        @node TTS Servers
-        @chapter Emacspeak TTS Servers
-
-        Emacspeak produces spoken output by communicating with one of many
-        speech servers. This section documents the communication protocol
-        between the client application i.e. Emacspeak, and the TTS
-        server. This section is primarily intended for developers wishing to:
-        @itemize @bullet
-        @item Create new speech servers that comply with this communication
-        protocol 
-        @item Developers of other client applications   who wish to use
-        the various Emacspeak speech servers.
-        @end itemize
-
-        @subsection High-level Overview
-
-        The TTS server reads commands from standard input, and  script
-        @emph{speech-server} can be used  to cause a TTS server to communicate
-        via a TCP socket. Speech server commands are used by the client
-        application to make specific requests of the server; the server
-        listens for these requests in a non-blocking read loop and executes
-        requests as they become available. Requests can be classified
-        as follows:
-        @itemize @bullet
-        @item Commands that send text to be spoken.
-        @item Commands that set @emph{state} of the TTS server.
-        @end itemize
-
-        All commands are of the form 
-        @example
-        commandWord @{arguments@}
-        @end example
-        The braces are optional if the command argument contains no white
-        space.  The speech server maintains a @emph{current state} that
-        determines various characteristics of spoken output such as speech
-        rate, punctuations mode etc. (see set of commands that manipulate
-        speech state for complete list).  The client application @emph{queues} The
-        text and non-speech audio output to be produced before asking the
-        server to @emph{dispatch} the set of queued requests, i.e. start
-        producing output.
-
-        Once the server has been asked to produce output, it removes items
-        from the front of the queue, sends the requisite commands to the
-        underlying TTS engine, and waits for the engine to acknowledge that
-        the request has been completely processed. This is a non-blocking
-        operation, i.e., if the client application generates additional
-        requests, these are processed @emph{immediately}.
-
-        The above design allows the Emacspeak TTS server to be
-        @emph{highly} responsive; Cleint applications can queue large
-        amounts of text (typically queued a clause at a time to
-        achieve the best prosody), ask the TTS server to start speaking,
-        and interrupt the spoken output at any time.
-
-        @subsection Commands That Queue Output.
-
-        This section documents commands that either produce spoken
-        output, or queue output to be produced on demand.
-        Commands that place the request on the queue are clearly marked.
-
-        @example
-        version
-        @end example
-
-        Speaks the @emph{version} of the TTS engine. Produces output
-        immediately.
-
-        @example
-        tts_say text 
-        @end example
-
-        Speaks the specified @emph{text} immediately. The text is not
-        pre-processed in any way, contrast this with the primary way of
-        speaking text which is to queue text before asking the server to
-        process the queue.
-
-        @example
-        l c
-        @end example
-
-        Speak @emph{c} a single character, as a letter.  The character is
-        spoken immediately. This command uses the TTS engine's capability to
-        speak a single character with the ability to flush speech
-        @emph{immediately}.  Client applications wishing to produce
-        character-at-a-time output, e.g., when providing character echo during
-        keyboard input should use this command.
-
-        @example
-        d
-        @end example
-
-        This command is used to @emph{dispatch} all queued requests.
-        It was renamed to a single character command (like many of the
-        commonly used TTS server commands) to work more effectively over
-        slow (9600) dialup lines.
-        The effect of calling this command is for the TTS server to start
-        processing items that have been queued via earlier requests.
-
-        @example
-        tts_pause
-        @end example
-
-        This pauses speech @emph{immediately}.
-        It does not affect queued requests; when command
-        @emph{tts_resume} is called, the output resumes at the point
-        where it was paused. Not all TTS engines provide this capability.
-
-        @example
-        tts_resume
-        @end example
-
-        Resume spoken output if it has been paused earlier.
-
-        @example
-        s
-        @end example
-
-        Stop speech @emph{immediately}.
-        Spoken output is interrupted, and all pending requests are
-        flushed from the queue.
-
-        @example
-        q text
-        @end example
-
-        Queues text to be spoken. No spoken output is produced until a
-        @emph{dispatch} request is received via execution of command
-        @emph{d}.
-
-        @example
-        a filename
-        @end example
-
-        Cues the audio file identified by filename for playing.
-
-        @example
-        t freq length
-        @end example
-
-        Queues a tone to be played at the specified frequency and having the
-        specified length.  Frequency is specified in hertz and length is
-        specified in milliseconds.
-
-        @example
-        sh duration
-        @end example
-
-        Queues the specified duration of silence. Silence is specified in
-        milliseconds.
-
-        @subsection Commands That Set State
-
-        @example
-        tts_reset
-        @end example
-
-        Reset TTS engine to  default settings.
-
-        @example
-        tts_set_punctuations mode
-        @end example
-
-        Sets TTS engine to the specified punctuation mode. Typicaly, TTS
-        servers provide at least three modes:
-        @itemize @bullet
-        @item None: Do not speak punctuation characters.
-        @item some: Speak some punctuation characters. Used for English
-        prose.
-        @item all: Speak out @emph{all} punctuation characters; useful in
-        programming modes.
-        @end itemize
-
-        @example
-        tts_set_speech_rate rate
-        @end example
-
-        Sets speech rate. The interpretation of this value is typically
-        engine specific.
-
-        @example
-        tts_set_character_scale factor
-        @end example
-
-        Scale factor applied to speech rate when speaking individual
-        characters.Thus, setting speech rate to 500 and character
-        scale to 1.2 will cause command @emph{l} to use a speech rate
-        of @emph{500 * 1.2 = 600}.
-
-        @example    
-        tts_split_caps flag
-        @end example
-
-        Set state of @emph{split caps} processing. Turn this on to
-        speak mixed-case (AKA Camel Case) identifiers.
-
-        @example
-        tts_capitalize flag
-        @end example
-
-        Indicate capitalization via a beep tone or voice  pitch.
-
-        @example
-        tts_allcaps_beep flag
-        @end example
+@c $Id$
+@node TTS Servers
+@chapter Emacspeak TTS Servers
+
+Emacspeak produces spoken output by communicating with one of many
+speech servers. This section documents the communication protocol
+between the client application i.e. Emacspeak, and the TTS
+server. This section is primarily intended for developers wishing to:
+@itemize @bullet
+@item Create new speech servers that comply with this communication
+protocol 
+@item Developers of other client applications   who wish to use
+the various Emacspeak speech servers.
+@end itemize
+
+@subsection High-level Overview
+
+The TTS server reads commands from standard input, and  script
+@emph{speech-server} can be used  to cause a TTS server to communicate
+via a TCP socket. Speech server commands are used by the client
+application to make specific requests of the server; the server
+listens for these requests in a non-blocking read loop and executes
+requests as they become available. Requests can be classified
+as follows:
+@itemize @bullet
+@item Commands that send text to be spoken.
+@item Commands that set @emph{state} of the TTS server.
+@end itemize
+
+All commands are of the form 
+@example
+commandWord @{arguments@}
+@end example
+The braces are optional if the command argument contains no white
+space.  The speech server maintains a @emph{current state} that
+determines various characteristics of spoken output such as speech
+rate, punctuations mode etc. (see set of commands that manipulate
+speech state for complete list).  The client application @emph{queues} The
+text and non-speech audio output to be produced before asking the
+server to @emph{dispatch} the set of queued requests, i.e. start
+producing output.
+
+Once the server has been asked to produce output, it removes items
+from the front of the queue, sends the requisite commands to the
+underlying TTS engine, and waits for the engine to acknowledge that
+the request has been completely processed. This is a non-blocking
+operation, i.e., if the client application generates additional
+requests, these are processed @emph{immediately}.
+
+The above design allows the Emacspeak TTS server to be
+@emph{highly} responsive; Cleint applications can queue large
+amounts of text (typically queued a clause at a time to
+achieve the best prosody), ask the TTS server to start speaking,
+and interrupt the spoken output at any time.
+
+@subsection Commands That Queue Output.
+
+This section documents commands that either produce spoken
+output, or queue output to be produced on demand.
+Commands that place the request on the queue are clearly marked.
+
+@example
+version
+@end example
+
+Speaks the @emph{version} of the TTS engine. Produces output
+immediately.
+
+@example
+tts_say text 
+@end example
+
+Speaks the specified @emph{text} immediately. The text is not
+pre-processed in any way, contrast this with the primary way of
+speaking text which is to queue text before asking the server to
+process the queue.
+
+@example
+l c
+@end example
+
+Speak @emph{c} a single character, as a letter.  The character is
+spoken immediately. This command uses the TTS engine's capability to
+speak a single character with the ability to flush speech
+@emph{immediately}.  Client applications wishing to produce
+character-at-a-time output, e.g., when providing character echo during
+keyboard input should use this command.
+
+@example
+d
+@end example
+
+This command is used to @emph{dispatch} all queued requests.
+It was renamed to a single character command (like many of the
+commonly used TTS server commands) to work more effectively over
+slow (9600) dialup lines.
+The effect of calling this command is for the TTS server to start
+processing items that have been queued via earlier requests.
+
+@example
+tts_pause
+@end example
+
+This pauses speech @emph{immediately}.
+It does not affect queued requests; when command
+@emph{tts_resume} is called, the output resumes at the point
+where it was paused. Not all TTS engines provide this capability.
+
+@example
+tts_resume
+@end example
+
+Resume spoken output if it has been paused earlier.
+
+@example
+s
+@end example
+
+Stop speech @emph{immediately}.
+Spoken output is interrupted, and all pending requests are
+flushed from the queue.
+
+@example
+q text
+@end example
+
+Queues text to be spoken. No spoken output is produced until a
+@emph{dispatch} request is received via execution of command
+@emph{d}.
+
+@example
+a filename
+@end example
+
+Cues the audio file identified by filename for playing.
+
+@example
+t freq length
+@end example
+
+Queues a tone to be played at the specified frequency and having the
+specified length.  Frequency is specified in hertz and length is
+specified in milliseconds.
+
+@example
+sh duration
+@end example
+
+Queues the specified duration of silence. Silence is specified in
+milliseconds.
+
+@subsection Commands That Set State
+
+@example
+tts_reset
+@end example
+
+Reset TTS engine to  default settings.
+
+@example
+tts_set_punctuations mode
+@end example
+
+Sets TTS engine to the specified punctuation mode. Typicaly, TTS
+servers provide at least three modes:
+@itemize @bullet
+@item None: Do not speak punctuation characters.
+@item some: Speak some punctuation characters. Used for English
+prose.
+@item all: Speak out @emph{all} punctuation characters; useful in
+programming modes.
+@end itemize
+
+@example
+tts_set_speech_rate rate
+@end example
+
+Sets speech rate. The interpretation of this value is typically
+engine specific.
+
+@example
+tts_set_character_scale factor
+@end example
+
+Scale factor applied to speech rate when speaking individual
+characters.Thus, setting speech rate to 500 and character
+scale to 1.2 will cause command @emph{l} to use a speech rate
+of @emph{500 * 1.2 = 600}.
+
+@example    
+tts_split_caps flag
+@end example
+
+Set state of @emph{split caps} processing. Turn this on to
+speak mixed-case (AKA Camel Case) identifiers.
+
+@example
+tts_capitalize flag
+@end example
+
+Indicate capitalization via a beep tone or voice  pitch.
+
+@example
+tts_allcaps_beep flag
+@end example
 
-        Setting this flag produces  a high-pitched beep when speaking words that are in
-        all-caps, e.g. abbreviations.
+Setting this flag produces  a high-pitched beep when speaking words that are in
+all-caps, e.g. abbreviations.
 
--- emacspeak-24.orig/info/tts.texi
+++ emacspeak-24/info/tts.texi
@@ -1,5 +1,4 @@
 @c $Id$
- @section Speech System Commands
 
 @cindex tts
 @cindex speech system
@@ -10,7 +9,7 @@
 
 @menu
 * Controlling Echo::             Character, Word and Line Echo.
-* Speech Output  Control::       Indicating case, capitalization and indentation.
+* Speech Output Control::        Indicating case, capitalization and indentation.
 * Miscellaneous:: Miscellaneous TTS Commands.
 @end menu
 
@@ -36,30 +35,30 @@
 
 @table @kbd 
 @findex  emacspeak-toggle-character-echo
- @kindex  control e d k 
+@kindex  control e d k 
 @item  @kbd{control e d k }
 emacspeak-toggle-character-echo
- Toggle state of  Emacspeak  character echo.
+Toggle state of  Emacspeak  character echo.
 Interactive PREFIX arg means toggle  the global default value, and then set the
 current local  value to the result.
 
 
 @findex  emacspeak-toggle-word-echo
- @kindex  control e d w 
- 
+@kindex  control e d w 
+
 @item @kbd{ control e d w }
 emacspeak-toggle-word-echo
- Toggle state of  Emacspeak  word echo.
+Toggle state of  Emacspeak  word echo.
 Interactive PREFIX arg means toggle  the global default value, and then set the
 current local  value to the result.
 
 
 @findex  emacspeak-toggle-line-echo
- @kindex  control e d l 
- 
+@kindex  control e d l 
+
 @item @kbd{ control e d l }
 emacspeak-toggle-line-echo
- Toggle state of  Emacspeak  line echo.
+Toggle state of  Emacspeak  line echo.
 Interactive PREFIX arg means toggle  the global default value, and then set the
 current local  value to the result.
 @end table
@@ -82,21 +81,21 @@
 @table @kbd 
 
 @findex  dtk-set-rate
- @kindex  control e d r 
- 
+@kindex  control e d r 
+
 @item @kbd{ control e d r }
 dtk-set-rate
- Set speaking RATE for the tts.
+Set speaking RATE for the tts.
 Interactive PREFIX arg means set   the global default value, and then set the
 current local  value to the result.
 
 
 @findex  dtk-set-character-scale
- @kindex  control e d f 
- 
+@kindex  control e d f 
+
 @item @kbd{ control e d f }
 dtk-set-character-scale
- Set scale FACTOR for   speech rate.
+Set scale FACTOR for   speech rate.
 Speech rate is scaled by this factor
 when speaking characters.
 Interactive PREFIX arg means set   the global default value, and then set the
@@ -109,20 +108,20 @@
 
 
 @findex  dtk-set-predefined-speech-rate
- @kindex  control e d 9   control e d 8   control e d 7   control e d 6   control e d 5   control e d 4   control e d 3   control e d 2   control e d 1   control e d 0 
- 
+@kindex  control e d 9   control e d 8   control e d 7   control e d 6   control e d 5   control e d 4   control e d 3   control e d 2   control e d 1   control e d 0 
+
 @item @kbd{ control e d 9   control e d 8   control e d 7   control e d 6   control e d 5   control e d 4   control e d 3   control e d 2   control e d 1   control e d 0 }
 dtk-set-predefined-speech-rate
- Set speech rate to one of nine predefined levels.
+Set speech rate to one of nine predefined levels.
 Interactive PREFIX arg says to set the rate globally.
 
 
 @findex  dtk-set-punctuations
- @kindex  control e d p 
- 
+@kindex  control e d p 
+
 @item @kbd{ control e d p }
 dtk-set-punctuations
- Set punctuation mode to MODE.
+Set punctuation mode to MODE.
 Possible values are `some', `all', or `none'.
 Interactive PREFIX arg means set   the global default value, and then set the
 current local  value to the result.
@@ -130,11 +129,11 @@
 
 
 @findex  dtk-set-pronunciation-mode
- @kindex  control e d m 
- 
+@kindex  control e d m 
+
 @item @kbd{ control e d m }
 dtk-set-pronunciation-mode
- Set pronunciation MODE.
+Set pronunciation MODE.
 This command is valid only for newer
 Dectalks, e.g.  the Dectalk Express.  Possible values are `math, name,
 europe, spell', all of which can be turned on or off.
@@ -143,11 +142,11 @@
 
 
 @findex  dtk-toggle-split-caps
- @kindex  control e d s 
+@kindex  control e d s 
 
 @item @kbd{ control e d s }
 dtk-toggle-split-caps
- Toggle split caps mode.
+Toggle split caps mode.
 Split caps mode is useful when reading
 Hungarian notation in program source code.  Interactive PREFIX arg
 means toggle the global default value, and then set the current local
@@ -155,22 +154,22 @@
 
 
 @findex  dtk-toggle-capitalization
- @kindex  control e d c 
- 
+@kindex  control e d c 
+
 @item @kbd{ control e d c }
 dtk-toggle-capitalization
- Toggle capitalization.
+Toggle capitalization.
 when set, capitalization is indicated by a
 short beep.  Interactive PREFIX arg means toggle the global default
 value, and then set the current local value to the result.
 
 
 @findex  dtk-toggle-allcaps-beep
- @kindex  control e d  cap C  
- 
+@kindex  control e d  cap C  
+
 @item @kbd{ control e d  cap C  }
 dtk-toggle-allcaps-beep
- Toggle allcaps-beep.
+Toggle allcaps-beep.
 when set, allcaps words  are  indicated by a
 short beep.  Interactive PREFIX arg means toggle the global default
 value, and then set the current local value to the result.
@@ -188,11 +187,11 @@
 @table @kbd
 
 @findex  emacspeak-toggle-audio-indentation
- @kindex  control e d i 
- 
+@kindex  control e d i 
+
 @item @kbd{ control e d i }
 emacspeak-toggle-audio-indentation
- Toggle state of  Emacspeak  audio indentation.
+Toggle state of  Emacspeak  audio indentation.
 Interactive PREFIX arg means toggle  the global default value, and then set the
 current local  value to the result.
 Specifying the method of indentation as `tones'
@@ -227,19 +226,19 @@
 @table @kbd
 
 @findex  dtk-stop
- @kindex     pause   control e s   
- 
+@kindex     pause   control e s   
+
 @item @kbd{Control e s}
 dtk-stop
- Stop speech now.
+Stop speech now.
 
 
 @findex  dtk-pause
- @kindex  control e p 
- 
+@kindex  control e p 
+
 @item @kbd{ control e p }
 dtk-pause
- Pause ongoing speech.
+Pause ongoing speech.
 The speech can be resumed with command `dtk-resume'
 normally bound to C-e SPC.  Pausing speech is useful when one needs to
 perform a few actions before continuing to read a large document.  Emacspeak
@@ -250,24 +249,24 @@
 
 
 @findex  dtk-resume
- @kindex  control e SPACE 
- 
+@kindex  control e SPACE 
+
 @item @kbd{ control e SPACE }
 dtk-resume
- Resume paused speech.
+Resume paused speech.
 This command resumes  speech that has been suspended by executing
 command `dtk-pause' bound to C-e p.
 If speech has not been paused,
 and variable `dtk-resume-should-toggle' is t
- then this command will pause ongoing speech.
+then this command will pause ongoing speech.
 
 
 @findex  dtk-toggle-quiet
- @kindex  control e d q 
- 
+@kindex  control e d q 
+
 @item @kbd{ control e d q }
 dtk-toggle-quiet
- Toggle state of the speech device between being quiet and talkative.
+Toggle state of the speech device between being quiet and talkative.
 Useful if you want to continue using an Emacs session that has
 emacspeak loaded but wish to make the speech shut up.
 Optional argument PREFIX specifies whether speech is turned off in the current buffer or in all buffers.
@@ -275,11 +274,11 @@
 
 
 @findex  dtk-emergency-restart
- @kindex  control e control s 
- 
+@kindex  control e control s 
+
 @item @kbd{ control e control s }
 dtk-emergency-restart
- Use this to nuke the currently running dtk server and restart it.
+Use this to nuke the currently running dtk server and restart it.
 Useful if you want to switch to another synthesizer while emacspeak is
 running.  Also useful for emergency stopping of speech.
 
@@ -293,11 +292,11 @@
 @table @kbd
 
 @findex  dtk-add-cleanup-pattern
- @kindex  control e d a 
- 
+@kindex  control e d a 
+
 @item @kbd{ control e d a }
 dtk-add-cleanup-pattern
- Add this pattern to the list of repeating patterns that are cleaned up.
+Add this pattern to the list of repeating patterns that are cleaned up.
 Optional interactive prefix arg deletes  this pattern if
 previously added.  Cleaning up repeated patterns results in emacspeak
 speaking the pattern followed by a repeat count instead of speaking
@@ -310,22 +309,22 @@
 
 
 @findex  dtk-select-server
- @kindex  control e d d 
- 
+@kindex  control e d d 
+
 @item @kbd{ control e d d }
 dtk-select-server
- Select a speech server interactively.
+Select a speech server interactively.
 This will be the server that is used when you next call either
 M-x dtk-initialize or C-e C-s.
 Argument PROGRAM specifies the speech server program.
 
 
 @findex  dtk-toggle-splitting-on-white-space
- @kindex  control e d SPACE 
- 
+@kindex  control e d SPACE 
+
 @item @kbd{ control e d SPACE }
 dtk-toggle-splitting-on-white-space
- Toggle splitting of speech on white space.
+Toggle splitting of speech on white space.
 This affects the internal state of emacspeak that decides if we split
 text purely by clause boundaries, or also include
 whitespace.  By default, emacspeak sends a clause at a time
@@ -342,37 +341,37 @@
 
 
 @findex  dtk-set-chunk-separator-syntax
- @kindex  control e d RETURN 
- 
+@kindex  control e d RETURN 
+
 @item @kbd{ control e d RETURN }
 dtk-set-chunk-separator-syntax
- Interactively set how text is split in chunks.
+Interactively set how text is split in chunks.
 See the Emacs documentation on syntax tables for details on how characters are
 classified into various syntactic classes.
 Argument S specifies the syntax class.
 
 
 @findex  emacspeak-dial-dtk
- @kindex  control e d t 
- 
+@kindex  control e d t 
+
 @item @kbd{ control e d t }
 emacspeak-dial-dtk
- Prompt for and dial a phone NUMBER with the Dectalk.
+Prompt for and dial a phone NUMBER with the Dectalk.
 
 
 @findex  emacspeak-dtk-speak-version
- @kindex  control e d  cap V  
- 
+@kindex  control e d  cap V  
+
 @item @kbd{ control e d  cap V  }
 emacspeak-dtk-speak-version
- Use this to find out which version of the TTS firmware you are running.
+Use this to find out which version of the TTS firmware you are running.
 
 
 @findex  emacspeak-zap-dtk
- @kindex  control e d z 
- 
+@kindex  control e d z 
+
 @item @kbd{ control e d z }
 emacspeak-zap-dtk
- Send this command to the TTS engine  directly.
+Send this command to the TTS engine  directly.
 
 @end table
--- emacspeak-24.orig/info/emacspeak.texi
+++ emacspeak-24/info/emacspeak.texi
@@ -12,7 +12,7 @@
 
 @include preamble.texi
 @include copyright.texi
-@include announce.texi     
+@include announce.texi
 @include introduction.texi
 @include install.texi
 @include using.texi
--- emacspeak-24.orig/servers/tts-lib.tcl
+++ emacspeak-24/servers/tts-lib.tcl
@@ -1,3 +1,4 @@
+#!/usr/bin/tclsh
 #$Id$
 # {{{ LCD Entry: 
 #x
--- emacspeak-24.orig/etc/Makefile
+++ emacspeak-24/etc/Makefile
@@ -47,7 +47,8 @@
 # {{{ User level target--  config 
 config:
 	@rm -f    emacspeak.sh
-	@sed "s@<emacspeak-dir>@$(SRC)/lisp@g" \
+	@sed -e "s@<emacspeak-dir>@/usr/share/$(FLAVOR)/site-lisp/emacspeak/lisp@g" \
+		-e 's/exec emacs/exec $(FLAVOR)/' \
 		emacspeak.sh.def > emacspeak.sh
 	@chmod 755   emacspeak.sh
 	@chmod 755   *.pl
--- emacspeak-24.orig/debian/README.Debian
+++ emacspeak-24/debian/README.Debian
@@ -0,0 +1,87 @@
+emacspeak for DEBIAN
+----------------------
+
+Emacspeak is authored by T. V. Raman <raman@cs.cornell.edu>.  These
+are the primary changes made in building the Debian package: html and
+plain text versions of the documentation were added.  A configuration
+script (/usr/sbin/emacspeakconfig) and associated speech server
+descriptions (/usr/share/emacs/site-lisp/emacspeak/blurbs/*) were
+added.  Manual pages for emacspeak and the configuration script were
+added.  Minor changes are listed in changelog.Debian.
+
+The user is expected to start emacspeak with /usr/bin/emacspeak, which
+gets configuration parameters from /etc/emacspeak.conf and starts
+emacs with emacspeak support.
+
+Several "flavors" of emacs may be installed at the same time (emacs20,
+emacs21, xemacs21, etc.).  In accordance with the Debian emacs policy,
+emacspeak is byte-compiled separately for each supported flavor -
+currently only emacs21.  There is a separate script to start each
+flavor of emacs with emacspeak support - for example,
+/usr/bin/emacspeak.emacs21.  /usr/bin/emacspeak is actually a symlink
+managed by the "alternatives" mechanism.  That is, it points to
+/etc/alternatives/emacspeak, which points to one of several links like
+/usr/bin/emacspeak.emacs21.  (See the manpage for
+update-alternatives.)
+
+The alternatives for emacspeak inherit their priorities from the
+corresponding emacs packages.  So, as long as the emacs and emacspeak
+alternatives are in "automatic" mode, both "emacs" and "emacspeak"
+will start emacs21.  If someday an emacs22 package is installed, with
+priority higher than for emacs 21, then by default both "emacs" and
+"emacspeak" will start emacs22.
+
+The administrator can use update-alternatives to change which flavor
+is started by either /usr/bin/emacs or /usr/bin/emacspeak.  Or, of
+course, any user can use one of the flavor-specific links like
+/usr/bin/emacspeak.emacs21 to start whichever flavor he wants.
+
+Starting with version 11.0, the Emacspeak sources include a speech
+server written in C++ for the IBM ViaVoice speech synthesis software.
+However, it depends on the ViaVoice runtime kit which does not meet
+the Debian Free Software Guidelines.  (It is available only as object
+code, and only under a temporary license.)  Therefore, support for
+ViaVoice is not included in this Debian package.  If you would like to
+try it, you can find some information in
+/usr/share/docs/emacspeak/VIAVOICE.
+
+Starting with version 10.0, Dr. Raman has rewritten the documentation
+files.  Approximately 100 commands are described there, compared to
+over 800 in the documentation shipped with the previous release.
+Therefore, the user should pay particular attention to the section
+"Using Online Help".
+
+Many command-line applications can be run under emacs, and can
+therefore be made accessible with emacspeak.  Much of this is
+explained in the documentation entitled "Running Terminal Based
+Applications".  However, it is worth emphasizing this point: "For
+regular shell interaction just use M-x shell instead of using the
+terminal emulator."
+
+The example file "tables.html" was supplied by Dr. Raman in a separate
+email.  It may be found in /usr/doc/emacspeak/examples.  It includes a
+sample table with three columns (labeled "item", "date", and
+"amount"), and three rows.  For a discussion of the support for tables
+in emacspeak and w3, see NEWS (or NEWS.gz) in /usr/doc/emacspeak.
+
+The Emacspeak-HOWTO contains additional documentation.  The plain text
+form of this can be found in the Debian package doc-linux, and is
+installed as /usr/doc/HOWTO/Emacspeak-HOWTO.gz.  Other formats are
+also available.  For example, these can be found at sunsite.unc.edu:
+
+  /pub/Linux/docs/HOWTO/other-formats/dvi/Emacspeak-HOWTO.dvi.gz
+  /pub/Linux/docs/HOWTO/other-formats/html/Emacspeak-HOWTO-html.tar.gz
+  /pub/Linux/docs/HOWTO/other-formats/ps/Emacspeak-HOWTO.ps.gz
+  /pub/Linux/docs/HOWTO/other-formats/sgml/Emacspeak-HOWTO.sgml.gz
+
+There is also an Emacspeak mailing list.  To subscribe, send a message
+to:
+
+        emacspeak-request@cs.vassar.edu
+
+with a subject of:
+
+        subscribe
+
+James R. Van Zandt <jrv@debian.org>, Mon Jan 30 21:36:59 EST 2006
+
--- emacspeak-24.orig/debian/DOC
+++ emacspeak-24/debian/DOC
@@ -0,0 +1,3373 @@
+DOC --- Automatically generated by command emacspeak-generate-documentation
+$Id$
+------------------------------------------------------------
+
+** dtk-add-cleanup-pattern	Key Sequence: control e d a 
+
+Add this pattern to the list of repeating patterns that
+are cleaned up.  Optional interactive prefix arg deletes
+this pattern if previously added.  Cleaning up repeated
+patterns results in emacspeak speaking the pattern followed
+by a repeat count instead of speaking all the characters
+making up the pattern.  Thus, by adding the repeating
+pattern `.' (this is already added by default) emacspeak
+will say ``aw fifteen dot'' when speaking the string
+``...............'' instead of ``period period period period
+''
+
+------------------------------------------------------------
+
+** dtk-notes-shutdown
+
+Shutdown midi system.
+
+------------------------------------------------------------
+
+** dtk-pause	Key Sequence: control e p 
+
+Pause ongoing speech.
+The speech can be resumed with command `dtk-resume'
+normally bound to C-e SPC.  Pausing speech is useful when one needs to
+perform a few actions before continuing to read a large document.  Emacspeak
+gives you speech feedback as usual once speech has been paused.  `dtk-resume'
+continues the interrupted speech irrespective of the buffer
+in which it is executed.
+Optional PREFIX arg flushes any previously paused speech.
+
+------------------------------------------------------------
+
+** dtk-reset-state	Key Sequence: control e d  cap R  
+
+Restore sanity to the Dectalk.
+Typically used after the Dectalk has been power   cycled.
+
+------------------------------------------------------------
+
+** dtk-resume	Key Sequence: control e SPACE 
+
+Resume paused speech.
+This command resumes  speech that has been suspended by executing
+command `dtk-pause' bound to C-e p.
+If speech has not been paused,
+and variable `dtk-resume-should-toggle' is t
+ then this command will pause ongoing speech.
+
+------------------------------------------------------------
+
+** dtk-select-server	Key Sequence: control e d d 
+
+Select a speech server interactively.
+Argument PROGRAM specifies the speech server program.
+When called  interactively, The selected server is started immediately. 
+
+------------------------------------------------------------
+
+** dtk-set-character-scale	Key Sequence: control e d f 
+
+Set scale FACTOR for   speech rate.
+Speech rate is scaled by this factor
+when speaking characters.
+Interactive PREFIX arg means set   the global default value, and then set the
+current local  value to the result.
+
+------------------------------------------------------------
+
+** dtk-set-chunk-separator-syntax	Key Sequence: control e d RETURN 
+
+Interactively set how text is split in chunks.
+See the Emacs documentation on syntax tables for details on how characters are
+classified into various syntactic classes.
+Argument S specifies the syntax class.
+
+------------------------------------------------------------
+
+** dtk-set-predefined-speech-rate	Key Sequence: control e d 9   control e d 8   control e d 7   control e d 6   control e d 5   control e d 4   control e d 3   control e d 2   control e d 1   control e d 0 
+
+Set speech rate to one of nine predefined levels.
+Interactive PREFIX arg says to set the rate globally.
+Formula used is:
+rate = dtk-speech-rate-base + dtk-speech-rate-step * level.
+
+------------------------------------------------------------
+
+** dtk-set-punctuations	Key Sequence: control e d p 
+
+Set punctuation mode to MODE.
+Possible values are `some', `all', or `none'.
+Interactive PREFIX arg means set   the global default value, and then set the
+current local  value to the result.
+
+------------------------------------------------------------
+
+** dtk-set-punctuations-to-all
+
+Set punctuation  mode to all.
+Interactive PREFIX arg sets punctuation mode globally.
+
+------------------------------------------------------------
+
+** dtk-set-punctuations-to-some
+
+Set punctuation  mode to some.
+Interactive PREFIX arg sets punctuation mode globally.
+
+------------------------------------------------------------
+
+** dtk-set-rate	Key Sequence: control e d r 
+
+Set speaking RATE for the tts.
+Interactive PREFIX arg means set   the global default value, and then set the
+current local  value to the result.
+
+------------------------------------------------------------
+
+** dtk-stop	Key Sequence: <pause>   control e s 
+
+Stop speech now.
+
+------------------------------------------------------------
+
+** dtk-toggle-allcaps-beep	Key Sequence: control e d  cap C  
+
+Toggle allcaps-beep.
+when set, allcaps words  are  indicated by a
+short beep.  Interactive PREFIX arg means toggle the global default
+value, and then set the current local value to the result.
+Note that allcaps-beep is a very useful thing when programming.
+However it is irritating to have it on when reading documents.
+
+------------------------------------------------------------
+
+** dtk-toggle-capitalization	Key Sequence: control e d c 
+
+Toggle capitalization.
+when set, capitalization is indicated by a
+short beep.  Interactive PREFIX arg means toggle the global default
+value, and then set the current local value to the result.
+
+------------------------------------------------------------
+
+** dtk-toggle-debug	Key Sequence: control e d b 
+
+Toggle state of the debug FLAG.
+When debugging is on, you can switch to the buffer
+*speaker* to examine the output from the process
+that talks to the speech device by using command C-e d C-M-b.
+Note: *speaker* is a hidden buffer, ie it has a leading space in its name.
+
+------------------------------------------------------------
+
+** dtk-toggle-punctuation-mode
+
+Toggle punctuation mode between "some" and "all".
+Interactive PREFIX arg makes the new setting global.
+
+------------------------------------------------------------
+
+** dtk-toggle-quiet	Key Sequence: control e d q 
+
+Toggles state of  dtk-quiet.
+Turning on this switch silences speech.
+Optional interactive prefix arg causes this setting to become global.
+
+------------------------------------------------------------
+
+** dtk-toggle-speak-nonprinting-chars	Key Sequence: control e d n 
+
+Toggle speak-nonprinting-chars.
+Switches behavior of how characters with the high bit set are handled.
+Interactive PREFIX arg means toggle the global default
+value, and then set the current local value to the result.
+
+------------------------------------------------------------
+
+** dtk-toggle-split-caps	Key Sequence: control e d s 
+
+Toggle split caps mode.
+Split caps mode is useful when reading
+Hungarian notation in program source code.  Interactive PREFIX arg
+means toggle the global default value, and then set the current local
+value to the result.
+
+------------------------------------------------------------
+
+** dtk-toggle-splitting-on-white-space	Key Sequence: control e d SPACE 
+
+Toggle splitting of speech on white space.
+This affects the internal state of emacspeak that decides if we split
+text purely by clause boundaries, or also include
+whitespace.  By default, emacspeak sends a clause at a time
+to the speech device.  This produces fluent speech for
+normal use.  However in modes such as `shell-mode' and some
+programming language modes, clause markers appear
+infrequently, and this can result in large amounts of text
+being sent to the speech device at once, making the system
+unresponsive when asked to stop talking.  Splitting on white
+space makes emacspeak's stop command responsive.  However,
+when splitting on white space, the speech sounds choppy
+since the synthesizer is getting a word at a time.
+
+------------------------------------------------------------
+
+** dtk-toggle-stop-immediately-while-typing	Key Sequence: control e d  cap I  
+
+Toggle state of variable `dtk-stop-immediately-while-typing'.
+As the name implies, if T then speech flushes immediately as you
+type.  Optional argument PREFIX specifies if the setting applies
+to all buffers.
+
+------------------------------------------------------------
+
+** emacspeak-describe-emacspeak	Key Sequence: control h control e 
+
+Give a brief overview of emacspeak.
+
+------------------------------------------------------------
+
+** emacspeak-submit-bug	Key Sequence: control e CONTROL meta b 
+
+Function to submit a bug to the programs maintainer.
+
+------------------------------------------------------------
+
+** emacspeak-aumix	Key Sequence: control e ( 
+
+Setup output parameters of the auditory display.
+ Launch this tool while you have auditory output on
+multiple channels playing so you can
+adjust the settings to your preference.  Hit q to quit when
+you are done.
+
+------------------------------------------------------------
+
+** emacspeak-aumix-edit
+
+Edit aumix settings interactively. 
+Run command M-x emacspeak-aumix-reset
+after saving the settings to have them take effect.
+
+------------------------------------------------------------
+
+** emacspeak-aumix-reset
+
+Reset to default audio settings.
+
+------------------------------------------------------------
+
+** emacspeak-aumix-volume-decrease
+
+Decrease overall volume. 
+
+------------------------------------------------------------
+
+** emacspeak-aumix-volume-increase
+
+Increase overall volume. 
+
+------------------------------------------------------------
+
+** emacspeak-aumix-wave-decrease
+
+Decrease volume of wave output. 
+
+------------------------------------------------------------
+
+** emacspeak-aumix-wave-increase
+
+Increase volume of wave output. 
+
+------------------------------------------------------------
+
+** emacspeak-list-buffers-next-line
+
+Speech enabled buffer menu navigation
+
+------------------------------------------------------------
+
+** emacspeak-list-buffers-previous-line
+
+Speech enabled buffer menu navigation
+
+------------------------------------------------------------
+
+** emacspeak-list-buffers-speak-buffer-line
+
+Speak information about this buffer
+
+------------------------------------------------------------
+
+** emacspeak-list-buffers-speak-buffer-name
+
+Speak the name of the buffer on this line
+
+------------------------------------------------------------
+
+** emacspeak-compilation-speak-error
+
+Speech feedback about the compilation error. 
+
+------------------------------------------------------------
+
+** emacspeak-custom-goto-group
+
+Jump to custom group when in a customization buffer.
+
+------------------------------------------------------------
+
+** emacspeak-custom-goto-toolbar
+
+Jump to custom toolbar when in a customization buffer.
+
+------------------------------------------------------------
+
+** emacspeak-dired-label-fields
+
+Labels the fields of the listing in the dired buffer.
+Currently is a no-op  unless
+unless `dired-listing-switches' contains -al
+
+------------------------------------------------------------
+
+** emacspeak-dired-show-file-type
+
+Displays type of current file by running command file.
+Like Emacs' built-in dired-show-file-type but allows user to customize
+options passed to command `file'.
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-file-access-time
+
+Speak access time  of the current file.
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-file-modification-time
+
+Speak modification time  of the current file.
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-file-permissions
+
+Speak the permissions of the current file.
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-file-size
+
+Speak the size of the current file.
+On a directory line, run du -s on the directory to speak its size.
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-header-line
+
+Speak the header line of the dired buffer. 
+
+------------------------------------------------------------
+
+** emacspeak-dired-speak-symlink-target
+
+Speaks the target of the symlink on the current line.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-copy-region-to-register
+
+Copy text from terminal to an Emacs REGISTER.
+This copies  region delimited by the emacspeak eterm marker 
+set by command M-x emacspeak-eterm-set-marker and the 
+emacspeak eterm pointer to a register.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-define-window
+
+Prompt for a window ID.
+The window is then define to be
+the rectangle delimited by point and eterm mark.  This is to
+be used when emacspeak is set to review mode inside an
+eterm.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-describe-window
+
+Describe an eterm  window.
+Description indicates eterm window coordinates and whether it is stretchable
+
+------------------------------------------------------------
+
+** emacspeak-eterm-goto-line
+
+Move emacspeak eterm pointer to a specified LINE.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-kill-ring-save-region
+
+Copy text from terminal to kill ring.
+This copies  region delimited by the emacspeak eterm marker 
+set by command M-x emacspeak-eterm-set-marker and the 
+emacspeak eterm pointer.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-maybe-send-raw
+
+Send a raw character through if in the terminal buffer.
+Execute end of line if
+in a non eterm buffer if executed via C-e C-e
+
+------------------------------------------------------------
+
+** emacspeak-eterm-paste-register
+
+Paste contents of REGISTER at current location.
+If the specified register contains text, then that text is
+sent to the terminal as if it were typed by the user.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-backward-word
+
+Move the pointer backward  by words. 
+Interactive numeric prefix arg specifies number of words to move.
+Argument COUNT specifies number of words by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-down
+
+Move the pointer down a line.
+Argument COUNT specifies number of lines by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-forward-word
+
+Move the pointer forward by words. 
+Interactive numeric prefix arg specifies number of words to move.
+Argument COUNT specifies number of words by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-left
+
+Move the pointer left.
+Argument COUNT specifies number of columns by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-right
+
+Move the pointer right.
+Argument COUNT specifies number of columns by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-bottom
+
+Move the pointer to the bottom  of the screen.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-cursor
+
+Move the pointer to the cursor.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-left-edge
+
+Move the pointer to the right edge.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-next-color-change
+
+Move the eterm pointer to the next color change.
+This allows you to move between highlighted regions of the screen.
+Optional argument COUNT specifies how many changes to skip.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-previous-color-change
+
+Move the eterm pointer to the next color change.
+This allows you to move between highlighted regions of the screen.
+Optional argument COUNT specifies how many changes to skip.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-right-edge
+
+Move the pointer to the right edge.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-to-top
+
+Move the pointer to the top of the screen.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-pointer-up
+
+Move the pointer up a line.
+Argument COUNT .specifies number of lines by which to move.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-remote-term	Key Sequence: control e CONTROL meta r 
+
+Start a terminal-emulator in a new buffer.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-search-backward
+
+Search backward on the terminal.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-search-forward
+
+Search forward on the terminal.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-set-filter-window
+
+Prompt for the id of a predefined window,
+and set the `filter' window to it.
+Non-nil interactive prefix arg `unsets' the filter window;
+this is equivalent to having the entire terminal as the filter window (this is
+what eterm starts up with).
+Setting the filter window results in emacspeak  only monitoring screen
+activity within the filter window.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-set-focus-window
+
+Prompt for the id of a predefined window,
+and set the `focus' window to it.
+Non-nil interactive prefix arg `unsets' the focus window;
+this is equivalent to having the entire terminal as the focus window (this is
+what eterm starts up with).
+Setting the focus window results in emacspeak  monitoring screen
+and speaking that window upon seeing screen activity.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-set-marker
+
+Set Emacspeak eterm marker.
+This sets  the emacspeak eterm marker to the position pointed 
+to by the emacspeak eterm pointer.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-cursor
+
+Speak cursor position.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-pointer
+
+Speak current pointer position.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-pointer-char
+
+Speak char under eterm pointer.
+Pronounces character phonetically unless  called with a PREFIX arg.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-pointer-line
+
+Speak the line the pointer is on.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-pointer-word
+
+Speak the word  the pointer is on.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-predefined-window
+
+Speak a predefined eterm window between 1 and 10.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-screen
+
+Speak the screen.  Default is to speak from the emacspeak pointer  to point.
+Optional prefix arg FLAG causes region above
+the Emacspeak pointer to be spoken.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-speak-window
+
+Speak an eterm window.
+Argument ID specifies the window.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-toggle-filter-window
+
+Toggle active state of filter window.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-toggle-focus-window
+
+Toggle active state of focus window.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-toggle-pointer-mode
+
+Toggle emacspeak eterm pointer mode.
+With optional interactive prefix  arg, turn it on.
+When emacspeak eterm is in pointer mode, the eterm read pointer
+stays where it is rather than automatically moving to the terminal cursor when
+there is terminal activity.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-toggle-review
+
+Toggle state of eterm review. 
+In review mode, you can move around the terminal and listen to the contnets 
+without sending input to the terminal itself.
+
+------------------------------------------------------------
+
+** emacspeak-eterm-yank-window
+
+Yank contents of  an eterm window at point.
+
+------------------------------------------------------------
+
+** emacspeak-toggle-eterm-autospeak
+
+Toggle state of eterm autospeak.
+When eterm autospeak is turned on and the terminal is in line mode,
+all output to the terminal is automatically spoken. 
+  Interactive prefix arg means toggle  the global default value, and then set the
+  current local  value to the result. 
+
+------------------------------------------------------------
+
+** emacspeak-fix-all-recent-commands
+
+Fix recently loaded interactive commands.
+This command looks through `load-history' and fixes commands if necessary.
+Memoizes call in emacspeak-load-history-pointer to memoize this call. 
+
+------------------------------------------------------------
+
+** emacspeak-fix-commands-loaded-from
+
+Fix all commands loaded from a specified module.
+
+------------------------------------------------------------
+
+** emacspeak-forms-find-file
+
+Visit a forms file
+
+------------------------------------------------------------
+
+** emacspeak-forms-flush-unwanted-records
+
+Prompt for pattern and flush matching lines
+
+------------------------------------------------------------
+
+** emacspeak-forms-rerun-filter
+
+Rerun  filter --allows us to nuke more matching records
+
+------------------------------------------------------------
+
+** emacspeak-forms-speak-field
+
+Speak current form field name and value.
+Assumes that point is at the front of a field value.
+
+------------------------------------------------------------
+
+** emacspeak-forms-summarize-current-position
+
+Summarize current position in list of records
+
+------------------------------------------------------------
+
+** emacspeak-forms-summarize-current-record
+
+Summarize current record
+
+------------------------------------------------------------
+
+** emacspeak-keymap-choose-new-emacspeak-prefix
+
+Interactively select a new prefix key to use for all emacspeak
+commands.  The default is to use `C-e'  This command
+lets you switch the prefix to something else.  This is a useful thing
+to do if you run emacspeak on a remote machine from inside a terminal
+that is running inside a local emacspeak session.  You can have the
+remote emacspeak use a different control key to give your fingers some
+relief.
+
+------------------------------------------------------------
+
+** emacspeak-toggle-comint-output-monitor	Key Sequence: control e o 
+
+Toggle state of Emacspeak comint monitor.
+When turned on, comint output is automatically spoken.  Turn this on if
+you want your shell to speak its results.  Interactive
+PREFIX arg means toggle the global default value, and then
+set the current local value to the result.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-clear-dictionaries
+
+Clear all current pronunciation dictionaries.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-define-local-pronunciation
+
+Define buffer local pronunciation.
+Argument WORD specifies the word which should be pronounced as specified by PRONUNCIATION.
+
+------------------------------------------------------------
+
+** 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.
+
+------------------------------------------------------------
+
+** 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.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-dispatch	Key Sequence: control e meta d 
+
+Provides the user interface front-end to Emacspeak's pronunciation dictionaries.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-edit-pronunciations
+
+Prompt for and launch a pronunciation editor on the
+specified pronunciation dictionary key.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-load-dictionaries
+
+Load pronunciation dictionaries.
+Optional argument FILENAME specifies the dictionary file.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-refresh-pronunciations
+
+Refresh pronunciation table for current buffer.
+Activates pronunciation dictionaries if not already active.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-save-dictionaries
+
+Writes out the persistent emacspeak pronunciation dictionaries.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-toggle-use-of-dictionaries
+
+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.
+
+------------------------------------------------------------
+
+** emacspeak-pronounce-yank-word
+
+Yank word at point into minibuffer.
+
+------------------------------------------------------------
+
+** emacspeak-backward-char	Key Sequence: control b   <left> 
+
+Backward-char redefined to speak char moved to. 
+
+------------------------------------------------------------
+
+** emacspeak-forward-char	Key Sequence: control f   <right> 
+
+Forward-char redefined to speak char moved to. 
+
+------------------------------------------------------------
+