--- /dev/null
+--- 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.
++
++------------------------------------------------------------
++
++** emacspeak-self-insert-command Key Sequence: Character set JISX0213-2 Character set Tibetan 2 column Character set Indian 2 Column Character set CNS11643-7 (Chinese traditional): ISO-IR-187 Character set CNS11643-6 (Chinese traditional): ISO-IR-186 Character set CNS11643-5 (Chinese traditional): ISO-IR-185 Character set CNS11643-4 (Chinese traditional): ISO-IR-184 Character set CNS11643-3 (Chinese traditional): ISO-IR-183 Character set Ethiopic characters Character set Unicode subset ( cap U +0100.. cap U +24FF) Character set Unicode subset ( cap U +E000+FFFF) Character set Unicode subset ( cap U +2500.. cap U +33FF) Character set Tibetan 1 column Character set Indian 1 Column Character set Indian IS 13194 Character set Arabic 2-column Character set Lao Character set ASCII with right-to-left direction Character set Arabic 1-column Character set Arabic digit Character set VISCII upper-case Character set VISCII lower-case Character set IPA Character set SiSheng (PinYin/ZhuYin) Character set Big5 (Level-2) C940-FEFE Character set Big5 (Level-1) A141-C67F Character set JISX0213-1 Character set CNS11643-2 (Chinese traditional): ISO-IR-172 Character set CNS11643-1 (Chinese traditional): ISO-IR-171 Character set JISX0212 (Japanese): ISO-IR-159 Character set KSC5601 (Korean): ISO-IR-149 Character set JISX0208.1983/1990 (Japanese): ISO-IR-87 Character set GB2312: ISO-IR-58 Character set JISX0208.1978 (Japanese): ISO-IR-42 Character set RHP of Latin-8 (ISO 8859-14) Character set RHP of Latin-9 (ISO 8859-15): ISO-IR-203 Character set RHP of Latin-5 (ISO 8859-9): ISO-IR-148 Character set RHP of Cyrillic (ISO 8859-5): ISO-IR-144 Character set Japanese Roman (JISX0201.1976) Character set Japanese Katakana (JISX0201.1976) Character set RHP of Hebrew (ISO 8859-8): ISO-IR-138 Character set RHP of Arabic (ISO 8859-6): ISO-IR-127 Character set RHP of Greek (ISO 8859-7): ISO-IR-126 Character set RHP of Thai (TIS620): ISO-IR-166 Character set RHP of Latin-4 (ISO 8859-4): ISO-IR-110 Character set RHP of Latin-3 (ISO 8859-3): ISO-IR-109 Character set RHP of Latin-2 (ISO 8859-2): ISO-IR-101 Character set RHP of Latin-1 (ISO 8859-1): ISO-IR-100 ÿ þ ý ü û ú ù ø ÷ ö õ ô ó ò ñ ð ï î í ì ë ê é è ç æ å ä ã â á à ß Þ Ý Ü Û Ú Ù Ø × Ö Õ Ô Ó Ò Ñ Ð Ï Î Í Ì Ë Ê É È Ç Æ Å Ä Ã Â Á À ¿ ¾ ½ ¼ » º ¹ ¸ · ¶ µ ´ ³ ² ± ° ¯ ® ¬ « ª © ¨ § ¦ ¥ ¤ £ ¢ ¡ ~ } | { z y x w v u t s r q p o n m l k j i h g f e d c b a ` _ ^ ] \ [ cap Z cap Y cap X cap W cap V cap U cap T cap S cap R cap Q cap P cap O cap N cap M cap L cap K cap J cap I cap H cap G cap F cap E cap D cap C cap B cap A @ ? > = < ; : 9 8 7 6 5 4 3 2 1 0 / . - , + * ) ( ' & % $ # " ! SPACE
++
++Insert a character.
++Speaks the character if emacspeak-character-echo is true.
++See command emacspeak-toggle-word-echo bound to
++C-e d w.
++Toggle variable dtk-stop-immediately-while-typing if you want to have
++speech flush as you type.
++
++------------------------------------------------------------
++
++** emacspeak-rmail-speak-current-message-labels
++
++Speak labels of current message
++
++------------------------------------------------------------
++
++** emacspeak-rmail-summarize-current-message
++
++Summarize current message
++
++------------------------------------------------------------
++
++** emacspeak-play-all-icons
++
++Plays all defined icons and speaks their names.
++
++------------------------------------------------------------
++
++** emacspeak-set-auditory-icon-player Key Sequence: control e meta a
++
++Select player used for producing auditory icons.
++Recommended choices:
++
++emacspeak-serve-auditory-icon for the wave device.
++emacspeak-queue-auditory-icon when using software TTS.
++emacspeak-play-midi-icon for midi device.
++
++------------------------------------------------------------
++
++** emacspeak-sounds-reset-local-player
++
++Ask Emacspeak to use a local audio player.
++This lets me have Emacspeak switch to using audioplay on
++solaris after I've used it for a while from a remote session
++where it would use the more primitive speech-server based
++audio player.
++
++------------------------------------------------------------
++
++** emacspeak-sounds-reset-sound
++
++Reload sound drivers.
++
++------------------------------------------------------------
++
++** emacspeak-sounds-select-theme Key Sequence: control e )
++
++Select theme for auditory icons.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-auditory-icons Key Sequence: control e control a
++
++Toggle use of auditory icons.
++Optional interactive PREFIX arg toggles global value.
++
++------------------------------------------------------------
++
++** emacspeak-audio-annotate-paragraphs
++
++Set property auditory-icon at front of all paragraphs.
++
++------------------------------------------------------------
++
++** emacspeak-blink-matching-open
++
++Display matching delimiter in the minibuffer.
++
++------------------------------------------------------------
++
++** emacspeak-completions-move-to-completion-group
++
++Move to group of choices beginning with character last
++typed. If no such group exists, then we dont move.
++
++------------------------------------------------------------
++
++** emacspeak-dial-dtk Key Sequence: control e d t
++
++Prompt for and dial a phone NUMBER with the Dectalk.
++
++------------------------------------------------------------
++
++** emacspeak-execute-repeatedly
++
++Execute COMMAND repeatedly.
++
++------------------------------------------------------------
++
++** emacspeak-mark-backward-mark Key Sequence: <control up>
++
++Cycle backward through the mark ring.
++
++------------------------------------------------------------
++
++** emacspeak-mark-forward-mark Key Sequence: <control down>
++
++Cycle forward through the mark ring.
++
++------------------------------------------------------------
++
++** emacspeak-owindow-next-line Key Sequence: ESCAPE <down>
++
++Move to the next line in the other window and speak it.
++Numeric prefix arg COUNT can specify number of lines to move.
++
++------------------------------------------------------------
++
++** emacspeak-owindow-previous-line Key Sequence: ESCAPE <up>
++
++Move to the next line in the other window and speak it.
++Numeric prefix arg COUNT specifies number of lines to move.
++
++------------------------------------------------------------
++
++** emacspeak-owindow-scroll-down Key Sequence: ESCAPE <prior>
++
++Scroll down the window that command `other-window' would move to.
++Speak the window contents after scrolling.
++
++------------------------------------------------------------
++
++** emacspeak-owindow-scroll-up Key Sequence: ESCAPE <next>
++
++Scroll up the window that command `other-window' would move to.
++Speak the window contents after scrolling.
++
++------------------------------------------------------------
++
++** emacspeak-owindow-speak-line Key Sequence: ESCAPE <select>
++
++Speak the current line in the other window.
++
++------------------------------------------------------------
++
++** emacspeak-read-next-line Key Sequence: control e <down>
++
++Read next line, specified by an offset, without moving.
++Default is to read the next line.
++
++------------------------------------------------------------
++
++** emacspeak-read-next-word
++
++Read next word, specified as a numeric arg, without moving.
++Default is to read the next word.
++
++------------------------------------------------------------
++
++** emacspeak-read-previous-line Key Sequence: control e <up>
++
++Read previous line, specified by an offset, without moving.
++Default is to read the previous line.
++
++------------------------------------------------------------
++
++** emacspeak-read-previous-word
++
++Read previous word, specified as a prefix arg, without moving.
++Default is to read the previous word.
++
++------------------------------------------------------------
++
++** emacspeak-speak-and-skip-extent-upto-char
++
++Search forward from point until we hit char.
++Speak text between point and the char we hit.
++
++------------------------------------------------------------
++
++** emacspeak-speak-and-skip-extent-upto-this-char
++
++Speak extent delimited by point and last character typed.
++
++------------------------------------------------------------
++
++** emacspeak-speak-browse-buffer Key Sequence: control e ,
++
++Browse current buffer.
++Default is to speak chunk having current personality.
++Interactive prefix arg `browse' repeatedly browses through
++ chunks having same personality as the current text chunk.
++
++------------------------------------------------------------
++
++** emacspeak-speak-buffer Key Sequence: control e b
++
++Speak current buffer contents.
++With prefix ARG, speaks the rest of the buffer from point.
++Negative prefix arg speaks from start of buffer to point.
++ If voice lock mode is on, the paragraphs in the buffer are
++voice annotated first, see command `emacspeak-speak-voice-annotate-paragraphs'.
++
++------------------------------------------------------------
++
++** emacspeak-speak-buffer-filename Key Sequence: control e f
++
++Speak name of file being visited in current buffer.
++Speak default directory if invoked in a dired buffer,
++or when the buffer is not visiting any file.
++Interactive prefix arg `filename' speaks only the final path
++component.
++The result is put in the kill ring for convenience.
++
++------------------------------------------------------------
++
++** emacspeak-speak-buffer-interactively Key Sequence: control e cap B
++
++Speak the start of, rest of, or the entire buffer.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire buffer.
++
++------------------------------------------------------------
++
++** emacspeak-speak-char Key Sequence: control e c
++
++Speak character under point.
++Pronounces character phonetically unless called with a PREFIX arg.
++
++------------------------------------------------------------
++
++** emacspeak-speak-comint-send-input
++
++Causes output to be spoken i.e., as if comint autospeak were turned
++on.
++
++------------------------------------------------------------
++
++** emacspeak-speak-completions
++
++Speak completions buffer if one present.
++
++------------------------------------------------------------
++
++** emacspeak-speak-continuously Key Sequence: control e RETURN
++
++Speak a buffer continuously.
++First prompts using the minibuffer for the kind of action to
++perform after speaking each chunk. E.G. speak a line at a time
++etc. Speaking commences at current buffer position. Pressing
++C-g breaks out, leaving point on last chunk that
++was spoken. Any other key continues to speak the buffer.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-column Key Sequence: control e =
++
++Speak the current column.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-kill Key Sequence: control e k
++
++Speak the current kill entry.
++This is the text that will be yanked in by the next C-y.
++Prefix numeric arg, COUNT, specifies that the text that will be yanked as a
++result of a
++C-y followed by count-1 M-y
++be spoken.
++ The kill number that is spoken says what numeric prefix arg to give
++to command yank.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-mark Key Sequence: control e control @
++
++Speak the line containing the mark.
++With no argument, speaks the
++line containing the mark--this is where `exchange-point-and-mark'
++C-x C-x would jump. Numeric prefix arg 'COUNT' speaks
++line containing mark 'n' where 'n' is one less than the number of
++times one has to jump using `set-mark-command' to get to this marked
++position. The location of the mark is indicated by an aural highlight
++achieved by a change in voice personality.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-percentage Key Sequence: control e %
++
++Announce the percentage into the current buffer.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-window
++
++Speak contents of current window.
++Speaks entire window irrespective of point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-display-char
++
++Display char under point using current speech display table.
++Behavior is the same as command `emacspeak-speak-char'
++bound to C-e c
++for characters in the range 0--127.
++Optional argument PREFIX specifies that the character should be spoken phonetically.
++
++------------------------------------------------------------
++
++** emacspeak-speak-front-of-buffer
++
++Speak the buffer from start to point
++
++------------------------------------------------------------
++
++** emacspeak-speak-help Key Sequence: control e h
++
++Speak help buffer if one present.
++With prefix arg, speaks the rest of the buffer from point.
++Negative prefix arg speaks from start of buffer to point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-help-interactively
++
++Speak the start of, rest of, or the entire help.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire help.
++
++------------------------------------------------------------
++
++** emacspeak-speak-line Key Sequence: control e l
++
++Speaks current line. With prefix ARG, speaks the rest of the line
++from point. Negative prefix optional arg speaks from start of line to
++point. Voicifies if option `voice-lock-mode' is on. Indicates
++indentation with a tone if audio indentation is in use. Indicates
++position of point with an aural highlight if option
++`emacspeak-show-point' is turned on --see command
++`emacspeak-show-point' bound to M-x emacspeak-show-point. Lines that
++start hidden blocks of text, e.g. outline header lines, or header
++lines of blocks created by command `emacspeak-hide-or-expose-block'
++are indicated with auditory icon ellipses.
++
++------------------------------------------------------------
++
++** emacspeak-speak-line-interactively Key Sequence: control e cap L
++
++Speak the start of, rest of, or the entire line.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire line.
++
++------------------------------------------------------------
++
++** emacspeak-speak-line-number Key Sequence: control e control l
++
++Print the current buffer line number and narrowed line number of point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-line-number-obsolete
++
++Speak the line number of the current line.
++
++------------------------------------------------------------
++
++** emacspeak-speak-line-set-column-filter Key Sequence: control e |
++
++Set up filter for selectively speaking or ignoring portions of lines.
++The filter is specified as a list of pairs.
++For example, to filter columns 1 -- 10 and 20 -- 25,
++specify filter as
++((0 9) (20 25)). Filter settings are persisted across sessions. A
++persisted filter is used as the default when prompting for a filter.
++This allows one to accumulate a set of filters for specific files like
++/var/adm/messages and /var/adm/maillog over time.
++Option emacspeak-speak-line-invert-filter determines
++the sense of the filter.
++
++------------------------------------------------------------
++
++** emacspeak-speak-load-directory-settings
++
++Load a directory specific Emacspeak settings file.
++This is typically used to load up settings that are specific to
++an electronic book consisting of many files in the same
++directory.
++
++------------------------------------------------------------
++
++** emacspeak-speak-message-again Key Sequence: control e a
++
++Speak the last message from Emacs once again.
++Optional interactive prefix arg
++`from-message-cache' speaks message cached from the most
++recent call to function `message'.
++The message is also placed in the kill ring for convenient yanking
++if `emacspeak-speak-message-again-should-copy-to-kill-ring' is set.
++
++------------------------------------------------------------
++
++** emacspeak-speak-message-at-time Key Sequence: control e @
++
++Set up ring-at-time to speak message at specified time.
++Provides simple stop watch functionality in addition to other things.
++See documentation for command run-at-time for details on time-spec.
++
++------------------------------------------------------------
++
++** emacspeak-speak-minibuffer
++
++Speak the minibuffer contents
++ With prefix arg, speaks the rest of the buffer from point.
++Negative prefix arg speaks from start of buffer to point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-minor-mode-line Key Sequence: control e cap M
++
++Speak the minor mode-information.
++
++------------------------------------------------------------
++
++** emacspeak-speak-mode-line Key Sequence: control e m
++
++Speak the mode-line.
++Interactive prefix arg speaks buffer info.
++
++------------------------------------------------------------
++
++** emacspeak-speak-next-field Key Sequence: control e >
++
++Skip across and speak the next contiguous sequence of non-blank characters.
++Useful in moving across fields.
++Will be improved if it proves useful.
++
++------------------------------------------------------------
++
++** emacspeak-speak-next-personality-chunk
++
++Moves to the front of next chunk having current personality.
++Speak that chunk after moving.
++
++------------------------------------------------------------
++
++** emacspeak-speak-next-window Key Sequence: control e control n
++
++Speak the next window.
++
++------------------------------------------------------------
++
++** emacspeak-speak-other-buffer Key Sequence: control e meta b
++
++Speak specified buffer.
++Useful to listen to a buffer while in a different context.
++
++------------------------------------------------------------
++
++** emacspeak-speak-other-window
++
++Speak contents of `other' window.
++Speaks entire window irrespective of point.
++Semantics of `other' is the same as for the builtin Emacs command
++`other-window'.
++Optional argument ARG specifies `other' window to speak.
++
++------------------------------------------------------------
++
++** emacspeak-speak-page Key Sequence: control e [
++
++Speak a page.
++With prefix ARG, speaks rest of current page.
++Negative prefix arg will read from start of current page to point.
++If option `voice-lock-mode' is on, then it will use any defined personality.
++
++------------------------------------------------------------
++
++** emacspeak-speak-page-interactively Key Sequence: control e ]
++
++Speak the start of, rest of, or the entire page.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire page.
++
++------------------------------------------------------------
++
++** emacspeak-speak-paragraph Key Sequence: control e {
++
++Speak paragraph.
++With prefix arg, speaks rest of current paragraph.
++Negative prefix arg will read from start of current paragraph to point.
++If voice-lock-mode is on, then it will use any defined personality.
++
++------------------------------------------------------------
++
++** emacspeak-speak-paragraph-interactively Key Sequence: control e cap P
++
++Speak the start of, rest of, or the entire paragraph.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire paragraph.
++
++------------------------------------------------------------
++
++** emacspeak-speak-predefined-window Key Sequence: control e 9 control e 8 control e 7 control e 6 control e 5 control e 4 control e 3 control e 2 control e 1 control e 0
++
++Speak one of the first 10 windows on the screen.
++Speaks entire window irrespective of point.
++In general, you'll never have Emacs split the screen into more than
++two or three.
++Argument ARG determines the 'other' window to speak.
++Semantics of `other' is the same as for the builtin Emacs command
++`other-window'.
++
++------------------------------------------------------------
++
++** emacspeak-speak-previous-field Key Sequence: control e <
++
++Skip backwards across and speak contiguous sequence of non-blank characters.
++Useful in moving across fields.
++Will be improved if it proves useful.
++
++------------------------------------------------------------
++
++** emacspeak-speak-previous-personality-chunk
++
++Moves to the front of previous chunk having current personality.
++Speak that chunk after moving.
++
++------------------------------------------------------------
++
++** emacspeak-speak-previous-window Key Sequence: control e control p
++
++Speak the previous window.
++
++------------------------------------------------------------
++
++** emacspeak-speak-rectangle Key Sequence: control e cap R
++
++Speak a rectangle of text.
++Rectangle is delimited by point and mark.
++When call from a program,
++arguments specify the START and END of the rectangle.
++
++------------------------------------------------------------
++
++** emacspeak-speak-region Key Sequence: control e r
++
++Speak region.
++Argument START and END specify region to speak.
++
++------------------------------------------------------------
++
++** emacspeak-speak-rest-of-buffer Key Sequence: control e n
++
++Speak remainder of the buffer starting at point
++
++------------------------------------------------------------
++
++** emacspeak-speak-sentence
++
++Speak current sentence.
++With prefix ARG, speaks the rest of the sentence from point.
++Negative prefix arg speaks from start of sentence to point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-set-display-table
++
++Sets up buffer specific speech display table that controls how
++special characters are spoken. Interactive prefix argument causes
++setting to be global.
++
++------------------------------------------------------------
++
++** emacspeak-speak-sexp Key Sequence: control e '
++
++Speak current sexp.
++With prefix ARG, speaks the rest of the sexp from point.
++Negative prefix arg speaks from start of sexp to point.
++If option `voice-lock-mode' is on, then uses the personality.
++
++------------------------------------------------------------
++
++** emacspeak-speak-sexp-interactively Key Sequence: control e "
++
++Speak the start of, rest of, or the entire sexp.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire sexp.
++
++------------------------------------------------------------
++
++** emacspeak-speak-skim-buffer
++
++Skim the current buffer a paragraph at a time.
++
++------------------------------------------------------------
++
++** emacspeak-speak-skim-next-paragraph
++
++Skim next paragraph.
++
++------------------------------------------------------------
++
++** emacspeak-speak-skim-paragraph
++
++Skim paragraph.
++Skimming a paragraph results in the speech speeding up after
++the first clause.
++Speech is scaled by the value of dtk-speak-skim-scale
++
++------------------------------------------------------------
++
++** emacspeak-speak-spaces-at-point Key Sequence: control e CONTROL meta @
++
++Speak the white space at point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-spell-current-word
++
++Spell word at point.
++
++------------------------------------------------------------
++
++** emacspeak-speak-this-personality-chunk
++
++Speak chunk of text around point that has current
++personality.
++
++------------------------------------------------------------
++
++** emacspeak-speak-time Key Sequence: control e t
++
++Speak the time.
++Optional interactive prefix arg `C-u'invokes world clock.
++Timezone is specified using minibuffer completion.
++Second interactive prefix sets clock to new timezone.
++
++------------------------------------------------------------
++
++** emacspeak-speak-version Key Sequence: control e cap V
++
++Announce version information for running emacspeak.
++
++------------------------------------------------------------
++
++** emacspeak-speak-voice-annotate-paragraphs
++
++Locate paragraphs and voice annotate the first word.
++Here, paragraph is taken to mean a chunk of text preceded by a blank line.
++Useful to do this before you listen to an entire buffer.
++
++------------------------------------------------------------
++
++** emacspeak-speak-window-information Key Sequence: control e control w
++
++Speaks information about current window.
++
++------------------------------------------------------------
++
++** emacspeak-speak-word Key Sequence: control e w
++
++Speak current word.
++With prefix ARG, speaks the rest of the word from point.
++Negative prefix arg speaks from start of word to point.
++If executed on the same buffer position a second time, the word is
++spelt instead of being spoken.
++
++------------------------------------------------------------
++
++** emacspeak-speak-word-interactively
++
++Speak the start of, rest of, or the entire word.
++'s' to speak the start.
++'r' to speak the rest.
++any other key to speak entire word.
++
++------------------------------------------------------------
++
++** emacspeak-speak-world-clock
++
++Display current date and time for specified zone.
++Optional second arg `set' sets the TZ environment variable as well.
++
++------------------------------------------------------------
++
++** emacspeak-switch-to-completions-window
++
++Jump to the *Completions* buffer if it is active.
++We make the current minibuffer contents (which is obviously the
++prefix for each entry in the completions buffer) inaudible
++to reduce chatter.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-action-mode
++
++Toggle state of Emacspeak action mode.
++Interactive PREFIX arg means toggle the global default value, and then set the
++current local value to the result.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-audio-indentation Key Sequence: control e d i
++
++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'
++results in the Dectalk producing a tone whose length is a function of the
++line's indentation. Specifying `speak'
++results in the number of initial spaces being spoken.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-character-echo Key Sequence: control e d k
++
++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.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-comint-autospeak Key Sequence: control e control q
++
++Toggle state of Emacspeak comint autospeak.
++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-toggle-line-echo Key Sequence: control e d l
++
++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.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-mail-alert Key Sequence: control e meta m
++
++Toggle state of Emacspeak mail alert.
++Interactive PREFIX arg means toggle the global default value, and then set the
++current local value to the result.
++Turning on this option results in Emacspeak producing an auditory icon
++indicating the arrival of new mail when displaying the mode line.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-show-point Key Sequence: control e control d
++
++Toggle state of Emacspeak-show-point.
++Interactive PREFIX arg means toggle the global default value, and then set the
++current local value to the result.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-speak-line-invert-filter Key Sequence: control e \
++
++Toggle state of how column filter is interpreted.
++Interactive PREFIX arg means toggle the global default value, and then set the
++current local value to the result.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-speak-messages Key Sequence: control e q
++
++Toggle the state of whether emacspeak echoes messages.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-which-function Key Sequence: control e meta w
++
++Toggle state of Emacspeak which function mode.
++Interactive PREFIX arg means toggle the global default value, and then set the
++current local value to the result.
++
++------------------------------------------------------------
++
++** emacspeak-toggle-word-echo Key Sequence: control e d w
++
++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.
++
++------------------------------------------------------------
++
++** emacspeak-use-customized-blink-paren
++
++A customized blink-paren to speak matching opening paren.
++We need to call this in case Emacs
++is anal and loads its own builtin blink-paren function
++which does not talk.
++
++------------------------------------------------------------
++
++** emacspeak-view-register Key Sequence: control e v
++
++Display the contents of a register, and then speak it.
++
++------------------------------------------------------------
++
++** emacspeak-voicify-rectangle
++
++Voicify the current rectangle.
++When calling from a program,arguments are
++START END personality
++Prompts for PERSONALITY with completion when called interactively.
++
++------------------------------------------------------------
++
++** emacspeak-voicify-region
++
++Voicify the current region.
++When calling from a program,arguments are
++START END personality.
++Prompts for PERSONALITY with completion when called interactively.
++
++------------------------------------------------------------
++
++** emacspeak-zap-tts Key Sequence: control e d z
++
++Send this command to the TTS directly.
++
++------------------------------------------------------------
++
++** emacspeak-table-copy-current-element-to-register
++
++Speak current table element
++
++------------------------------------------------------------
++
++** emacspeak-table-copy-to-clipboard
++
++Copy table in current buffer to the table clipboard.
++Current buffer must be in emacspeak-table mode.
++
++------------------------------------------------------------
++
++** emacspeak-table-display-table-in-region Key Sequence: control e TAB
++
++Recognize tabular data in current region and display it in table
++browsing mode in a a separate buffer.
++emacspeak table mode is designed to let you browse tabular data using
++all the power of the two-dimensional spatial layout while giving you
++sufficient contextual information. The tables subdirectory of the
++emacspeak distribution contains some sample tables --these are the
++CalTrain schedules. Execute command `describe-mode' bound to
++C-h m in a buffer that is in emacspeak table mode to read
++the documentation on the table browser.
++
++------------------------------------------------------------
++
++** emacspeak-table-find-csv-file
++
++Process a csv (comma separated values) file.
++The processed data and presented using emacspeak table navigation.
++
++------------------------------------------------------------
++
++** emacspeak-table-find-file Key Sequence: control e control t
++
++Open a file containing table data and display it in table mode.
++emacspeak table mode is designed to let you browse tabular data using
++all the power of the two-dimensional spatial layout while giving you
++sufficient contextual information. The etc/tables subdirectory of the
++emacspeak distribution contains some sample tables --these are the
++CalTrain schedules. Execute command `describe-mode' bound to
++C-h m in a buffer that is in emacspeak table mode to read
++the documentation on the table browser.
++
++------------------------------------------------------------
++
++** emacspeak-table-get-entry-with-headers
++
++Return both row and column header and table element
++
++------------------------------------------------------------
++
++** emacspeak-table-goto
++
++Prompt for a table cell coordinates and jump to it.
++
++------------------------------------------------------------
++
++** emacspeak-table-goto-bottom
++
++Goes to the bottom of the current column.
++
++------------------------------------------------------------
++
++** emacspeak-table-goto-left
++
++Goes to the left of the current row.
++
++------------------------------------------------------------
++
++** emacspeak-table-goto-right
++
++Goes to the right of the current row.
++
++------------------------------------------------------------
++
++** emacspeak-table-goto-top
++
++Goes to the top of the current column.
++
++------------------------------------------------------------
++
++** emacspeak-table-next-column
++
++Move to the next column if possible
++
++------------------------------------------------------------
++
++** emacspeak-table-next-row
++
++Move to the next row if possible
++
++------------------------------------------------------------
++
++** emacspeak-table-paste-from-clipboard
++
++Paste the emacspeak table clipboard into the current buffer.
++Use the major mode of this buffer to decide what kind of table
++markup to use.
++
++------------------------------------------------------------
++
++** emacspeak-table-previous-column
++
++Move to the previous column if possible
++
++------------------------------------------------------------
++
++** emacspeak-table-previous-row
++
++Move to the previous row if possible
++
++------------------------------------------------------------
++
++** emacspeak-table-search
++
++Search the table for matching elements. Interactively prompts for
++row or column to search and pattern to look for. If there is a match, makes
++the matching cell current. When called from a program, `what' can
++ be either `row' or `column'.
++
++------------------------------------------------------------
++
++** emacspeak-table-search-column
++
++Search in current table column.
++
++------------------------------------------------------------
++
++** emacspeak-table-search-headers
++
++Search the table row or column headers. Interactively prompts for
++row or column to search and pattern to look for. If there is a
++match, makes the matching row or column current.
++
++------------------------------------------------------------
++
++** emacspeak-table-search-row
++
++Search in current table row.
++
++------------------------------------------------------------
++
++** emacspeak-table-select-automatic-speaking-method
++
++Interactively select the kind of automatic speech to produce when
++browsing table elements
++
++------------------------------------------------------------
++
++** emacspeak-table-sort-on-current-column
++
++Sort table on current column.
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-both-headers-and-element
++
++Speak both row and column header and table element
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-column-filtered
++
++Speaks a table column after applying a specified column filter.
++Optional prefix arg prompts for a new filter.
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-column-header-and-element
++
++Speak column header and table element
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-coordinates
++
++Speak current table coordinates.
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-current-element
++
++Speak current table element
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-dimensions
++
++Speak current table dimensions.
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-row-filtered
++
++Speaks a table row after applying a specified row filter.
++Optional prefix arg prompts for a new filter.
++
++------------------------------------------------------------
++
++** emacspeak-table-speak-row-header-and-element
++
++Speak row header and table element
++
++------------------------------------------------------------
++
++** emacspeak-table-ui-filter-load
++
++Load saved filter settings.
++
++------------------------------------------------------------
++
++** emacspeak-table-ui-filter-save
++
++Save out filter settings.
++
++------------------------------------------------------------
++
++** emacspeak-table-view-csv-buffer
++
++Process a csv (comma separated values) data.
++The processed data and presented using emacspeak table navigation.
++
++------------------------------------------------------------
++
++** emacspeak-widget-browse-widget-interactively
++
++Allows you to browse a widget
++
++------------------------------------------------------------
++
++** emacspeak-widget-help
++
++Speak help for widget under point.
++
++------------------------------------------------------------
++
++** emacspeak-widget-summarize-parent
++
++Summarize parent of widget at point.
++
++------------------------------------------------------------
++
++** emacspeak-widget-summarize-widget-under-point
++
++Summarize a widget if any under point.
++Optional interactive prefix specifies how many levels to go up from current
++widget before summarizing.
++
++------------------------------------------------------------
++
++** emacspeak-widget-update-from-minibuffer
++
++Sets widget at point by invoking its prompter.
++
++------------------------------------------------------------
++
++** emacspeak-annotate-add-annotation
++
++Add annotation to the annotation working buffer.
++Prompt for annotation buffer if not already set.
++Interactive prefix arg `reset' prompts for the annotation
++buffer even if one is already set.
++Annotation is entered in a temporary buffer and the
++annotation is inserted into the working buffer when complete.
++
++------------------------------------------------------------
++
++** emacspeak-clipboard-copy Key Sequence: control e control c
++
++Copy contents of the region to the emacspeak clipboard.
++Previous contents of the clipboard will be overwritten. The Emacspeak
++clipboard is a convenient way of sharing information between
++independent Emacspeak sessions running on the same or different
++machines. Do not use this for sharing information within an Emacs
++session --Emacs' register commands are far more efficient and
++light-weight. Optional interactive prefix arg results in Emacspeak
++prompting for the clipboard file to use.
++Argument START and END specifies region.
++Optional argument PROMPT specifies whether we prompt for the name of a clipboard file.
++
++------------------------------------------------------------
++
++** emacspeak-clipboard-paste Key Sequence: control e control y
++
++Yank contents of the Emacspeak clipboard at point.
++The Emacspeak clipboard is a convenient way of sharing information between
++independent Emacspeak sessions running on the same or different
++machines. Do not use this for sharing information within an Emacs
++session --Emacs' register commands are far more efficient and
++light-weight. Optional interactive prefix arg pastes from
++the emacspeak table clipboard instead.
++
++------------------------------------------------------------
++
++** emacspeak-copy-current-file Key Sequence: control e meta c
++
++Copy file visited in current buffer to new location.
++Prompts for the new location and preserves modification time
++ when copying. If location is a directory, the file is copied
++ to that directory under its current name ; if location names
++ a file in an existing directory, the specified name is
++ used. Asks for confirmation if the copy will result in an
++ existing file being overwritten.
++
++------------------------------------------------------------
++
++** emacspeak-curl
++
++Grab URL using Curl, and preview it with W3.
++
++------------------------------------------------------------
++
++** emacspeak-customize Key Sequence: control e cap C
++
++Customize Emacspeak.
++
++------------------------------------------------------------
++
++** emacspeak-customize-personal-settings
++
++Create a customization buffer for browsing and updating
++personal customizations.
++
++------------------------------------------------------------
++
++** emacspeak-cvs-get-anonymous Key Sequence: control e <control down>
++
++Get latest cvs snapshot of emacspeak.
++
++------------------------------------------------------------
++
++** emacspeak-cvs-gnu-get-project-snapshot
++
++Grab CVS snapshot of specified project from GNU.
++
++------------------------------------------------------------
++
++** emacspeak-cvs-sf-get-project-snapshot
++
++Grab CVS snapshot of specified project from Sourceforge.
++
++------------------------------------------------------------
++
++** emacspeak-emergency-tts-restart Key Sequence: control e <insert>
++
++For use in an emergency.
++Will start TTS engine specified by
++emacspeak-emergency-tts-server.
++
++------------------------------------------------------------
++
++** emacspeak-frame-label-or-switch-to-labelled-frame Key Sequence: control e meta f
++
++Switch to labelled frame.
++With optional PREFIX argument, label current frame.
++
++------------------------------------------------------------
++
++** emacspeak-frame-read-frame-label
++
++Read a frame label with completion.
++
++------------------------------------------------------------
++
++** emacspeak-generate-documentation
++
++Generate docs for all emacspeak commands.
++Prompts for FILENAME in which to save the documentation.
++Warning! Contents of file filename will be overwritten.
++
++------------------------------------------------------------
++
++** emacspeak-generate-texinfo-command-documentation
++
++Generate texinfo documentation for all emacspeak
++commands into file commands.texi.
++Warning! Contents of file commands.texi will be overwritten.
++
++------------------------------------------------------------
++
++** emacspeak-generate-texinfo-option-documentation
++
++Generate texinfo documentation for all emacspeak
++options into file filename.
++Warning! Contents of file filename will be overwritten.
++
++------------------------------------------------------------
++
++** emacspeak-kill-buffer-quietly
++
++Kill current buffer without asking for confirmation.
++
++------------------------------------------------------------
++
++** emacspeak-learn-mode Key Sequence: control e control h
++
++Helps you learn the keys. You can press keys and hear what they do.
++To leave, press C-g.
++
++------------------------------------------------------------
++
++** emacspeak-link-current-file Key Sequence: control e meta l
++
++Link (hard link) file visited in current buffer to new location.
++Prompts for the new location and preserves modification time
++ when linking. If location is a directory, the file is copied
++ to that directory under its current name ; if location names
++ a file in an existing directory, the specified name is
++ used. Signals an error if target already exists.
++
++------------------------------------------------------------
++
++** emacspeak-links
++
++Launch links on specified URL in a new terminal.
++
++------------------------------------------------------------
++
++** emacspeak-lynx
++
++Launch lynx on specified URL in a new terminal.
++
++------------------------------------------------------------
++
++** emacspeak-next-frame-or-buffer Key Sequence: <control right>
++
++Move to next buffer.
++With optional interactive prefix arg `frame', move to next frame instead.
++
++------------------------------------------------------------
++
++** emacspeak-previous-frame-or-buffer Key Sequence: <control left>
++
++Move to previous buffer.
++With optional interactive prefix arg `frame', move to previous frame instead.
++
++------------------------------------------------------------
++
++** emacspeak-root Key Sequence: control e control r
++
++Start a root shell or switch to one that already exists.
++Optional interactive prefix arg `cd' executes cd
++default-directory after switching.
++
++------------------------------------------------------------
++
++** emacspeak-select-this-buffer-next-display Key Sequence: control e <control right>
++
++Select this buffer as displayed in a `next' frame.
++See documentation for command
++`emacspeak-select-this-buffer-other-window-display' for the
++meaning of `next'.
++
++------------------------------------------------------------
++
++** emacspeak-select-this-buffer-other-window-display
++
++Switch to this buffer as displayed in a different frame. Emacs
++allows you to display the same buffer in multiple windows or
++frames. These different windows can display different
++portions of the buffer. This is equivalent to leaving a
++book open at places at once. This command allows you to
++move to the places where you have left the book open. The
++number used to invoke this command specifies which of the
++displays you wish to select. Typically you will have two or
++at most three such displays open. The current display is 0,
++the next is 1, and so on. Optional argument ARG specifies
++the display to select.
++
++------------------------------------------------------------
++
++** emacspeak-select-this-buffer-previous-display Key Sequence: control e <control left>
++
++Select this buffer as displayed in a `previous' window.
++See documentation for command
++`emacspeak-select-this-buffer-other-window-display' for the
++meaning of `previous'.
++
++------------------------------------------------------------
++
++** emacspeak-show-personality-at-point Key Sequence: control e meta v
++
++Show value of property personality (and possibly face)
++at point.
++
++------------------------------------------------------------
++
++** emacspeak-show-property-at-point Key Sequence: control e meta p
++
++Show value of PROPERTY at point.
++If optional arg property is not supplied, read it interactively.
++Provides completion based on properties that are of interest.
++If no property is set, show a message and exit.
++
++------------------------------------------------------------
++
++** emacspeak-skip-blank-lines-backward Key Sequence: <shift> <up>
++
++Move backward across blank lines.
++The line under point is then spoken.
++Signals beginning of buffer.
++
++------------------------------------------------------------
++
++** emacspeak-skip-blank-lines-forward Key Sequence: <shift> <down>
++
++Move forward across blank lines.
++The line under point is then spoken.
++Signals end of buffer.
++
++------------------------------------------------------------
++
++** emacspeak-speak-browse-linux-howto Key Sequence: control e cap H
++
++Browse a Linux Howto file.
++We cleanup underlining, and set up outline mode correctly.
++
++------------------------------------------------------------
++
++** emacspeak-speak-hostname Key Sequence: control e meta h
++
++Speak host name.
++
++------------------------------------------------------------
++
++** emacspeak-speak-popup-messages Key Sequence: control h cap M
++
++Pop up messages buffer.
++If it is already selected then hide it and try to restore
++previous window configuration.
++
++------------------------------------------------------------
++
++** emacspeak-speak-run-shell-command Key Sequence: control e !
++
++Invoke shell COMMAND and display its output as a table. The results
++are placed in a buffer in Emacspeak's table browsing mode. Optional
++interactive prefix arg as-root runs the command as root (not yet
++implemented). Use this for running shell commands that produce
++tabulated output. This command should be used for shell commands that
++produce tabulated output that works with Emacspeak's table recognizer.
++Verify this first by running the command in a shell and executing
++command `emacspeak-table-display-table-in-region' normally bound to
++C-e TAB.
++
++------------------------------------------------------------
++
++** emacspeak-speak-show-active-network-interfaces Key Sequence: control e cap I
++
++Shows all active network interfaces in the echo area.
++With interactive prefix argument ADDRESS it prompts for a
++specific interface and shows its address. The address is
++also copied to the kill ring for convenient yanking.
++
++------------------------------------------------------------
++
++** emacspeak-speak-show-memory-used
++
++Convenience command to view state of memory used in this session so far.
++
++------------------------------------------------------------
++
++** emacspeak-speak-telephone-directory
++
++Lookup and display a phone number.
++With prefix arg, opens the phone book for editting.
++
++------------------------------------------------------------
++
++** emacspeak-speak-this-buffer-next-display Key Sequence: control e <right>
++
++Speak this buffer as displayed in a `previous' window.
++See documentation for command
++`emacspeak-speak-this-buffer-other-window-display' for the
++meaning of `next'.
++
++------------------------------------------------------------
++
++** emacspeak-speak-this-buffer-other-window-display Key Sequence: control e /
++
++Speak this buffer as displayed in a different frame. Emacs
++allows you to display the same buffer in multiple windows or
++frames. These different windows can display different
++portions of the buffer. This is equivalent to leaving a
++book open at places at once. This command allows you to
++listen to the places where you have left the book open. The
++number used to invoke this command specifies which of the
++displays you wish to speak. Typically you will have two or
++at most three such displays open. The current display is 0,
++the next is 1, and so on. Optional argument ARG specifies
++the display to speak.
++
++------------------------------------------------------------
++
++** emacspeak-speak-this-buffer-previous-display Key Sequence: control e <aleft>
++
++Speak this buffer as displayed in a `previous' window.
++See documentation for command
++`emacspeak-speak-this-buffer-other-window-display' for the
++meaning of `previous'.
++
++------------------------------------------------------------
++
++** emacspeak-ssh-tts-restart
++
++Restart specified ssh tts server.
++
++------------------------------------------------------------
++
++** emacspeak-sudo
++
++SUDo command --run command as super user.
++
++------------------------------------------------------------
++
++** emacspeak-switch-to-previous-buffer
++
++Switch to most recently used interesting buffer.
++
++------------------------------------------------------------
++
++** emacspeak-symlink-current-file Key Sequence: control e meta s
++
++Link (symbolic link) file visited in current buffer to new location.
++Prompts for the new location and preserves modification time
++ when linking. If location is a directory, the file is copied
++ to that directory under its current name ; if location names
++ a file in an existing directory, the specified name is
++ used. Signals an error if target already exists.
++
++------------------------------------------------------------
++
++** emacspeak-view-emacspeak-doc Key Sequence: control e cap D
++
++Display a summary of all Emacspeak commands.
++
++------------------------------------------------------------
++
++** emacspeak-view-emacspeak-faq Key Sequence: control e cap F
++
++Browse the Emacspeak FAQ.
++
++------------------------------------------------------------
++
++** emacspeak-view-emacspeak-news Key Sequence: control e cap N
++
++Display info on recent change to Emacspeak.
++
++------------------------------------------------------------
++
++** emacspeak-view-emacspeak-tips Key Sequence: control e cap T
++
++Browse Emacspeak productivity tips.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-count-slides-in-region
++
++Count slides starting from point.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-dvi-display
++
++Called to set up preview of an DVI file.
++Assumes we are in a buffer visiting a .DVI file.
++Previews those contents as text and nukes the buffer
++visiting the DVI file.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-dvi-mode
++
++Major mode for browsing DVI files.
++
++
++DVI files are converted to text and previewed using text mode.
++
++This mode runs the hook `emacspeak-wizards-dvi-mode-hook', as the final step
++during initialization.
++
++key binding
++--- -------
++
++
++
++------------------------------------------------------------
++
++** emacspeak-wizards-edit-file-as-root
++
++Edit file as root using sudo vi.
++See /etc/sudoers for how to set up sudo.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-find-grep
++
++Run compile using find and grep.
++Interactive arguments specify filename pattern and search pattern.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-find-longest-line-in-region
++
++Find longest line in region.
++Moves to the longest line when called interactively.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-find-longest-paragraph-in-region
++
++Find longest paragraph in region.
++Moves to the longest paragraph when called interactively.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-finder-find
++
++Run find-dired on specified switches after prompting for the
++directory to where find is to be launched.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-finder-mode
++
++Emacspeak Finder
++
++
++
++This mode runs the hook `emacspeak-wizards-finder-mode-hook', as the final step
++during initialization.
++
++key binding
++--- -------
++
++
++
++------------------------------------------------------------
++
++** emacspeak-wizards-fix-read-only-text
++
++Nuke read-only property on text range.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-fix-typo
++
++Search and replace recursively in all files with extension `ext'
++for `word' and replace it with correction.
++Use with caution.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-generate-finder
++
++Generate a widget-enabled finder wizard.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-generate-voice-sampler
++
++Generate a buffer that shows a sample line in all the ACSS settings
++for the current voice family.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-get-table-content-from-file
++
++Extract table specified by depth and count from HTML
++content at file.
++Extracted content is placed as a csv file in task.csv.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-get-table-content-from-url
++
++Extract table specified by depth and count from HTML
++content at URL.
++Extracted content is placed as a csv file in task.csv.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-google-hits
++
++Filter Google results after performing search to show just the
++hits.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-how-many-matches
++
++If you define a file local variable
++called `emacspeak-occur-pattern' that holds a regular expression
++that matches lines of interest, you can use this command to conveniently
++run `how-many' to count matching header lines.
++With interactive prefix arg, prompts for and remembers the file local pattern.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-move-and-speak
++
++Speaks a chunk of text bounded by point and a target position.
++Target position is specified using a navigation command and a
++count that specifies how many times to execute that command
++first.
++Point is left at the target position.
++Interactively, command is specified by pressing the key that
++;;invokes the command.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-occur-header-lines
++
++If you define a file local variable called
++`emacspeak-occur-pattern' that holds a regular expression that
++matches header lines, you can use this command to conveniently
++run `occur' to find matching header lines. With prefix arg,
++prompts for and sets value of the file local pattern.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-portfolio-quotes
++
++Bring up detailed stock quotes for portfolio specified by
++emacspeak-websearch-personal-portfolio.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-ppp-toggle
++
++Bring up or bring down ppp.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-ppt-display
++
++Called to set up preview of an PPT file.
++Assumes we are in a buffer visiting a .ppt file.
++Previews those contents as HTML and nukes the buffer
++visiting the ppt file.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-ppt-mode
++
++Major mode for browsing PPT slides.
++
++
++PPT files are converted to HTML and previewed using W3.
++
++In addition to any hooks its parent mode `text-mode' might have run,
++this mode runs the hook `emacspeak-wizards-ppt-mode-hook', as the final step
++during initialization.
++
++key binding
++--- -------
++
++
++
++------------------------------------------------------------
++
++** emacspeak-wizards-rivo
++
++Rivo wizard.
++Prompts for relevant information and schedules a rivo job using
++ UNIX AT scheduling facility.
++RIVO is implemented by rivo.pl ---
++ a Perl script that can be used to launch realaudio and record
++ streaming media for a specified duration.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-rpm-query-in-dired
++
++Run rpm -qi on current dired entry.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-shell-toggle Key Sequence: control e <f11>
++
++Switch to the shell buffer and cd to
++ the directory of the current buffer.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-show-commentary
++
++Display commentary. Default is to display commentary from current buffer.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-show-environment-variable
++
++Display value of specified environment variable.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-show-face
++
++Show salient properties of specified face.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-show-list-variable
++
++Convenience command to view Emacs variables that are long lists.
++Prompts for a variable name and displays its value in a separate buffer.
++Lists are displayed one element per line.
++Argument VAR specifies variable whose value is to be displayed.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-speak-iso-datetime
++
++Make ISO date-time speech friendly.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-spot-words
++
++Searches recursively in all files with extension `ext'
++for `word' and displays hits in a compilation buffer.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-squeeze-blanks
++
++Squeeze multiple blank lines in current buffer.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-terminal
++
++Launch terminal and rename buffer appropriately.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-toggle-mm-dd-yyyy-date-pronouncer
++
++Toggle pronunciation of mm-dd-yyyy dates.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-tpctl-display-status
++
++Show display status on thinkpads using tpctl.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-tramp-open-location
++
++Open specified tramp location.
++Location is specified by name.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-unhex-uri
++
++UnEscape URI
++
++------------------------------------------------------------
++
++** emacspeak-wizards-units
++
++Run units in a comint sub-process.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-use-w3-or-w3m
++
++Alternates between using W3 and W3M for browse-url.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vc-n
++
++Accelerator for VC viewer.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vc-viewer
++
++View contents of specified virtual console.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vc-viewer-mode
++
++Major mode for interactively viewing virtual console contents.
++
++
++key binding
++--- -------
++
++C-l emacspeak-wizards-vc-viewer-refresh
++
++
++
++This mode runs the hook `emacspeak-wizards-vc-viewer-mode-hook', as the final step
++during initialization.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vc-viewer-refresh
++
++Refresh view of VC we're viewing.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vi-as-su-file
++
++Launch sudo vi on specified file in a terminal.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-voice-sampler
++
++Read a personality and apply it to the current line.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-vpn-toggle
++
++Bring up or bring down vpn.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-xl-display
++
++Called to set up preview of an XL file.
++Assumes we are in a buffer visiting a .xls file.
++Previews those contents as HTML and nukes the buffer
++visiting the xls file.
++
++------------------------------------------------------------
++
++** emacspeak-wizards-xl-mode
++
++Major mode for browsing XL spreadsheets.
++
++
++XL Sheets are converted to HTML and previewed using W3.
++
++In addition to any hooks its parent mode `text-mode' might have run,
++this mode runs the hook `emacspeak-wizards-xl-mode-hook', as the final step
++during initialization.
++
++key binding
++--- -------
++
++
++
++------------------------------------------------------------
++
++** cd-tool Key Sequence: control e DEL
++
++Front-end to CDTool.
++Bind this function to a convenient key-
++Emacspeak users automatically have
++this bound to <DEL> in the emacspeak keymap.
++
++Key Action
++--- ------
++
+++ Next Track
++- Previous Track
++SPC Pause or Resume
++e Eject
++= Shuffle
++i CD Info
++p Play
++s Stop
++t track
++c clip
++cap C Save clip to disk
++
++
++------------------------------------------------------------
++
++** emacspeak-alsaplayer-launch
++
++Launch Alsaplayer.
++user is placed in a buffer associated with the newly created
++Alsaplayer session.
++
++------------------------------------------------------------
++
++** emacspeak-amphetadesk
++
++Open amphetadesk.
++
++------------------------------------------------------------
++
++** emacspeak-amphetadesk-quick-add
++
++Quick add URL to Amphetadesk by prompting for URL.
++
++------------------------------------------------------------
++
++** emacspeak-appt-repeat-announcement Key Sequence: control e cap A
++
++Speaks the most recently displayed appointment message if any.
++
++------------------------------------------------------------
++
++** emacspeak-atom-browse
++
++Browse specified ATOM feed.
++
++------------------------------------------------------------
++
++** emacspeak-atom-display
++
++Retrieve and display ATOM URL.
++
++------------------------------------------------------------
++
++** emacspeak-daisy-open-book Key Sequence: control e control b
++
++Open Digital Talking Book specified by navigation file filename.
++
++This is the main entry point to the Emacspeak Daisy reader.
++Opening a Daisy navigation file (.ncx file) results in a
++navigation buffer that can be used to browse and read the book.
++
++------------------------------------------------------------
++
++** emacspeak-filtertext Key Sequence: control e ^
++
++Copy over text in region to special filtertext buffer in
++preparation for interactively filtering text.
++
++------------------------------------------------------------
++
++** emacspeak-freeamp
++
++Play specified resource using freeamp.
++Resource is an MP3 file or m3u playlist.
++The player is placed in a buffer in emacspeak-freeamp-mode.
++
++------------------------------------------------------------
++
++** emacspeak-freeamp-freeamp-call-command
++
++Call appropriate freeamp command.
++
++------------------------------------------------------------
++
++** emacspeak-freeamp-freeamp-command
++
++Execute FreeAmp command.
++
++------------------------------------------------------------
++
++** emacspeak-gridtext-apply
++
++Apply grid to region.
++
++------------------------------------------------------------
++
++** emacspeak-gridtext-load
++
++Load saved grid settings.
++
++------------------------------------------------------------
++
++** emacspeak-gridtext-save
++
++Save out grid settings.
++
++------------------------------------------------------------
++
++** emacspeak-hide-or-expose-all-blocks
++
++Hide or expose all blocks in buffer.
++
++------------------------------------------------------------
++
++** emacspeak-hide-or-expose-block Key Sequence: control e j
++
++Hide or expose a block of text.
++This command either hides or exposes a block of text
++starting on the current line. A block of text is defined as
++a portion of the buffer in which all lines start with a
++common PREFIX. Optional interactive prefix arg causes all
++blocks in current buffer to be hidden or exposed.
++
++------------------------------------------------------------
++
++** emacspeak-hide-speak-block-sans-prefix Key Sequence: control e control j
++
++Speaks current block after stripping its prefix.
++If the current block is not hidden, it first hides it.
++This is useful because as you locate blocks, you can invoke this
++command to listen to the block,
++and when you have heard enough navigate easily to move past the block.
++
++------------------------------------------------------------
++
++** emacspeak-imcom
++
++Start IMCom.
++
++------------------------------------------------------------
++
++** emacspeak-info-wizard Key Sequence: control h TAB
++
++Read a node spec from the minibuffer and launch
++Info-goto-node.
++See documentation for command `Info-goto-node' for details on
++node-spec.
++
++------------------------------------------------------------
++
++** emacspeak-m-player Key Sequence: control e :
++
++Play specified resource using m-player.
++Resource is an MP3 file or m3u playlist.
++The player is placed in a buffer in emacspeak-m-player-mode.
++
++------------------------------------------------------------
++
++** emacspeak-madplay
++
++Play specified resource using madplay.
++Resource is an MP3 file or directory containing mp3 files.
++The player is placed in a buffer in emacspeak-madplay-mode.
++
++------------------------------------------------------------
++
++** emacspeak-madplay-madplay-call-command
++
++Call appropriate madplay command.
++
++------------------------------------------------------------
++
++** emacspeak-madplay-madplay-command
++
++Execute Madplay command.
++
++------------------------------------------------------------
++
++** emacspeak-ocr Key Sequence: control e control o
++
++An OCR front-end for the Emacspeak desktop.
++
++Page image is acquired using tools from the SANE package.
++The acquired image is run through the OCR engine if one is
++available, and the results placed in a buffer that is
++suitable for browsing the results.
++
++For detailed help, invoke command emacspeak-ocr bound to
++C-e C-o to launch emacspeak-ocr-mode, and press
++`?' to display mode-specific help for emacspeak-ocr-mode.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio Key Sequence: control e ;
++
++Start or control streaming audio including MP3 and
++realaudio. If using `TRPlayer' as the player, accepts
++trplayer control commands if a stream is already playing.
++Otherwise, the playing stream is simply stopped. If no
++stream is playing, this command prompts for a realaudio
++resource. Realaudio resources can be specified either as a
++Realaudio URL, the location of a local Realaudio file, or as
++the name of a local Realaudio metafile. Realaudio resources
++you have played in this session are available in the
++minibuffer history. The default is to play the resource you
++played most recently. Emacspeak uses the contents of the
++directory specified by variable
++emacspeak-realaudio-shortcuts-directory to offer a set of
++completions. Hit space to use this completion list.
++
++If using TRPlayer, you can either give one-shot commands
++using command emacspeak-realaudio available from anywhere on
++the audio desktop as `C-e ;'.
++Alternatively, switch to buffer *realaudio* using
++`C-e ;;' if you wish to issue many
++navigation commands. Note that buffer *realaudio* uses a
++special major mode that provides the various navigation
++commands via single keystrokes.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-browse
++
++Browse RAM file before playing the selected component.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-get-current-time-in-seconds
++
++Return current time in seconds.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-play
++
++Play a realaudio stream. Uses files from your Realaudio
++shortcuts directory for completion. See documentation for
++user configurable variable emacspeak-realaudio-shortcuts-directory.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-set-end-mark
++
++Set end mark. Default is to set marker to current play time.
++Mark is specified in seconds.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-set-start-mark
++
++Set start mark. Default is to set marker to current play time.
++Mark is specified in seconds.
++
++------------------------------------------------------------
++
++** emacspeak-realaudio-write-mp3-clip
++
++Writes specified clip from current mp3 stream.
++Prompts for start and end times as well as file to save the clippi
++
++------------------------------------------------------------
++
++** emacspeak-remote-connect-to-server Key Sequence: control e meta r
++
++Connect to and start using remote speech server running on host host
++and listening on port port. Host is the hostname of the remote
++server, typically the desktop machine. Port is the tcp port that that
++host is listening on for speech requests.
++
++------------------------------------------------------------
++
++** emacspeak-remote-quick-connect-to-server
++
++Connect to remote server.
++Does not prompt for host or port, but quietly uses the
++guesses that appear as defaults when prompting.
++Use this once you are sure the guesses are usually correct.
++
++------------------------------------------------------------
++
++** emacspeak-remote-ssh-to-server
++
++Open ssh session to where we came from.
++
++------------------------------------------------------------
++
++** emacspeak-rss-browse Key Sequence: control e control u
++
++Browse specified RSS feed.
++
++------------------------------------------------------------
++
++** emacspeak-rss-display
++
++Retrieve and display RSS URL.
++
++------------------------------------------------------------
++
++** emacspeak-speak-current-field Key Sequence: control e .
++
++Speak current field.
++A field is
++defined by Emacs 21.
++
++------------------------------------------------------------
++
++** emacspeak-tabulate-region Key Sequence: control e i
++
++Voicifies the white-space of a table if one found. Optional interactive prefix
++arg mark-fields specifies if the header row information is used to mark fields
++in the white-space.
++
++------------------------------------------------------------
++
++** emacspeak-tapestry-describe-tapestry Key Sequence: control e meta t
++
++Describe the current layout of visible buffers in current frame.
++Use interactive prefix arg to get coordinate positions of the
++displayed buffers.
++
++------------------------------------------------------------
++
++** emacspeak-tapestry-select-window-by-name Key Sequence: control e cap W
++
++Select window by the name of the buffer it displays.
++This is useful when using modes like ECB or the new GDB UI where
++ you want to preserve the window layout
++but quickly switch to a window by name.
++
++------------------------------------------------------------
++
++** emacspeak-url-template-fetch Key Sequence: control e u
++
++Fetch a pre-defined resource.
++Use Emacs completion to obtain a list of available resources.
++Resources typically prompt for the relevant information
++before completing the request.
++Optional interactive prefix arg displays documentation for specified resource.
++
++------------------------------------------------------------
++
++** emacspeak-url-template-load
++
++Load URL template resources from specified location.
++
++------------------------------------------------------------
++
++** emacspeak-w3-browse-atom-at-point
++
++Browses Atom url under point.
++
++------------------------------------------------------------
++
++** emacspeak-w3-browse-rss-at-point
++
++Browses RSS url under point.
++
++------------------------------------------------------------
++
++** emacspeak-w3-browse-url-with-style
++
++Browse URL with specified XSL style.
++
++------------------------------------------------------------
++
++** emacspeak-w3-browse-xml-url-with-style
++
++Browse XML URL with specified XSL style.
++
++------------------------------------------------------------
++
++** emacspeak-w3-class-filter-and-follow
++
++Follow url and point, and filter the result by specified class.
++Class can be set locally for a buffer, and overridden with an
++interactive prefix arg. If there is a known rewrite url rule, that is
++used as well.
++
++------------------------------------------------------------
++
++** emacspeak-w3-count-matches
++
++Count matches for locator in HTML.
++
++------------------------------------------------------------
++
++** emacspeak-w3-count-nested-tables
++
++Count nested tables in HTML.
++
++------------------------------------------------------------
++
++** emacspeak-w3-count-tables
++
++Count tables in HTML.
++
++------------------------------------------------------------
++
++** emacspeak-w3-curl-url-under-point
++
++Display contents of URL under point using Curl and W3. The
++document is displayed in a separate buffer.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-by-class
++
++Extract elements having specified class attribute from HTML. Extracts
++specified elements from current WWW page and displays it in a separate
++buffer. Optional arg url specifies the page to extract content from.
++Interactive use provides list of class values as completion.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-by-class-list
++
++Extract elements having class specified in list `classes' from HTML.
++Extracts specified elements from current WWW page and displays it in a
++separate buffer. Optional arg url specifies the page to extract
++content from. Interactive use provides list of class values as
++completion.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-media-streams
++
++Extract links to media streams.
++operate on current web page when in a W3 buffer; otherwise prompt for url.
++`prompt-url' is the URL to process. Prompts for URL when called
++interactively. Optional arg `speak' specifies if the result should be
++spoken automatically.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-nested-table
++
++Extract nested table specified by `table-index'. Default is to
++operate on current web page when in a W3 buffer; otherwise
++`prompt-url' is the URL to process. Prompts for URL when called
++interactively. Optional arg `speak' specifies if the result should be
++spoken automatically.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-nested-table-list
++
++Extract specified list of tables from a WWW page.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-node-by-id
++
++Extract specified node from URI.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-print-streams
++
++Extract links to printable streams.
++operate on current web page when in a W3 buffer; otherwise prompt for url.
++`prompt-url' is the URL to process. Prompts for URL when called
++interactively. Optional arg `speak' specifies if the result should be
++spoken automatically.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-table-by-match
++
++Extract table containing specified match.
++ Optional arg url specifies the page to extract content from.
++Interactive prefix arg causes url to be read from the minibuffer.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-table-by-position
++
++Extract table at specified position.
++ Optional arg url specifies the page to extract content from.
++Interactive prefix arg causes url to be read from the minibuffer.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-tables-by-match-list
++
++Extract specified tables from a WWW page.
++Tables are specified by containing match pattern
++ found in the match list.
++
++------------------------------------------------------------
++
++** emacspeak-w3-extract-tables-by-position-list
++
++Extract specified list of nested tables from a WWW page.
++Tables are specified by their position in the list
++nested of tables found in the page.
++
++------------------------------------------------------------
++
++** emacspeak-w3-google-on-this-site
++
++Perform a google search restricted to the current WWW site.
++
++------------------------------------------------------------
++
++** emacspeak-w3-google-similar-to-this-page
++
++Ask Google to find documents similar to this one.
++
++------------------------------------------------------------
++
++** emacspeak-w3-google-who-links-to-this-page
++
++Perform a google search to locate documents that link to the
++current page.
++
++------------------------------------------------------------
++
++** emacspeak-w3-preview-this-buffer
++
++Preview this buffer.
++
++------------------------------------------------------------
++
++** emacspeak-w3-preview-this-region
++
++Preview this region.
++
++------------------------------------------------------------
++
++** emacspeak-w3-realaudio-play-url-at-point
++
++Play url under point as realaudio
++
++------------------------------------------------------------
++
++** emacspeak-w3-set-xsl-keep-result
++
++Set value of `emacspeak-w3-xsl-keep-result'.
++
++------------------------------------------------------------
++
++** emacspeak-w3-xpath-filter-and-follow
++
++Follow url and point, and filter the result by specified xpath.
++XPath can be set locally for a buffer, and overridden with an
++interactive prefix arg. If there is a known rewrite url rule, that is
++used as well.
++
++------------------------------------------------------------
++
++** emacspeak-w3-xsl-toggle
++
++Toggle application of XSL transformations.
++This uses XSLT Processor xsltproc available as part of the
++libxslt package.
++
++------------------------------------------------------------
++
++** emacspeak-w3-xslt-apply
++
++Apply specified transformation to current page.
++
++------------------------------------------------------------
++
++** emacspeak-w3-xslt-filter
++
++Extract elements matching specified XPath path locator
++from HTML. Extracts specified elements from current WWW
++page and displays it in a separate buffer. Optional arg url
++specifies the page to extract table from.
++Optional arg COMPLEMENT inverts the filter.
++
++------------------------------------------------------------
++
++** emacspeak-w3-xslt-select
++
++Select XSL transformation applied to WWW pages before they are displayed .
++
++------------------------------------------------------------
++
++** emacspeak-websearch-dispatch Key Sequence: control e ?
++
++Launches specific websearch queries.
++Press `?' to list available search engines.
++Once selected, the selected searcher prompts for additional information as appropriate.
++When using W3, this interface attempts to speak the most relevant information on the result page.
++
++------------------------------------------------------------
++
++** emacspeak-websearch-emapspeak-near-my-location
++
++Perform search relative to `my-location'.
++
++------------------------------------------------------------
++
++** emacspeak-websearch-google
++
++Perform a Google search.
++Optional interactive prefix arg `lucky' is equivalent to hitting the
++I'm Feeling Lucky button on Google.
++
++------------------------------------------------------------
++
++** emacspeak-websearch-google-search-in-date-range
++
++Use this from inside the calendar to do Google date-range searches.
++
++------------------------------------------------------------
++
++** emacspeak-websearch-usenet Key Sequence: control e cap U
++
++Prompt and browse a Usenet newsgroup.
++Optional interactive prefix arg results in prompting for a search term.
++
++------------------------------------------------------------
++
++** emacspeak-websearch-usenet-search
++
++Search a Usenet newsgroup.
++
++------------------------------------------------------------
++
++** emacspeak-xml-shell
++
++Start Xml-Shell on contents of system-id.
++
++ \f
++
++Local variables:
++ mode: outline
++paragraph-separate: "[ \f]*$"
++end:
++
+--- emacspeak-24.orig/debian/emacspeakconfig
++++ emacspeak-24/debian/emacspeakconfig
+@@ -0,0 +1,473 @@
++#!/bin/sh
++#
++# emacspeakconfig - configuration script for emacspeak
++#
++# This script sets values in /etc/emacspeak.conf, which override the
++# defaults compiled into emacspeak TCL scripts and .elc files.
++# Values in the user's environment will override those in
++# /etc/emacspeak.conf
++#
++# Written by Jim Van Zandt <jrv@debian.org> for Debian Linux,
++# and hereby placed in the public domain for use by anyone.
++
++set -e
++
++CFG=/etc/emacspeak.conf
++GROUPFILE=/etc/group
++DRIVERDIR=/usr/lib/emacs/common/emacspeak/drivers
++USUAL=/usr/share/emacs/site-lisp/emacspeak
++
++# on a Slackware or Red Hat system, a user may attempt configuration
++# with awk missing.
++if [ -x /usr/bin/awk -o -x /bin/awk ]; then true; else
++cat <<EOF
++
++awk is missing.
++Please execute /usr/sbin/emacspeakconfig again after installing it.
++
++EOF
++ echo -n "Press Enter: "; read junk;
++ exit 1;
++fi
++
++set -- `getopt i $*`
++if test $? != 0
++then
++ echo 'Usage: emacspeakconfig [-i]'
++ exit 2
++fi
++initial=no
++for i
++do
++ case "$i"
++ in
++ -i)
++ initial=yes; shift;;
++ --)
++ shift; break;;
++ esac
++done
++
++#echo initial=$initial
++
++# if there is no configuration file, then create one
++if [ -s $CFG ]; then
++ true
++else
++cat >$CFG <<\EOF
++# emacspeak configuration file
++#
++#
++if [ "$DTK_PROGRAM" = "" ]; then
++ DTK_PROGRAM=
++fi
++if [ "$DTK_TCL" = "" ]; then
++ DTK_TCL=
++fi
++if [ "$DTK_PORT" = "" ]; then
++ DTK_PORT=
++fi
++if [ "$DTK_DEVICE" = "" ]; then
++ DTK_DEVICE=
++fi
++export DTK_PROGRAM DTK_PORT DTK_DEVICE
++if [ "$DTK_TCL" != "" ]; then export DTK_TCL; fi
++EOF
++fi
++
++# if the configuration file does not set the DTK_DEVICE variable, then
++# add that section
++if grep 'export.*DTK_DEVICE' $CFG >/dev/null ; then
++ true
++else
++ awk '
++ / *export/{
++ print "if [ \"$DTK_DEVICE\" = \"\" ]; then";
++ print "DTK_DEVICE=";
++ print "fi";
++ print "export DTK_PROGRAM DTK_PORT DTK_DEVICE";
++ print "if [ \"$DTK_TCL\" != \"\" ]; then export DTK_TCL; fi";
++ next;}
++ {print;}' $CFG > $CFG.TMP && mv $CFG.TMP $CFG
++fi
++
++# return success if answer is "yes"
++yesno() {
++# first argument is question
++# second argument is default answer
++while true; do
++ echo -n "$1 [$2]: "; read ans;
++ if [ "$ans" = "" ]; then ans=$2; fi
++ if [ "$ans" = "y" -o "$ans" = "Y" -o "$ans" = "yes" ]; then return 0; fi
++ if [ "$ans" = "n" -o "$ans" = "N" -o "$ans" = "no" ]; then return 1; fi
++done
++}
++
++# set TEXT to a string typed by the user
++text() {
++# first argument is question
++# second argument is default answer
++echo -n "$1 [$2]: "; read ans;
++if [ "$ans" = "" ]; then ans=$2; fi
++TEXT=$ans
++}
++
++# get parameters for some new synthesizer
++request_params() {
++ text "Please enter the name of the synthesizer" "$DEVICE"; DEVICE=$TEXT
++ if [ "$TCL" = "tcl" ]; then IS_TCL=y; else IS_TCL=n; fi
++ if yesno "Is the speech server a TCL script? " $IS_TCL ; then
++ echo "These files in $USUAL/servers appear to be TCL scripts:"
++ (cd $USUAL/servers; grep -l dectalk_globals * 2>/dev/null)
++ text "Please enter the name (not path) of the $DEVICE speech server" \
++ ${PROGRAM:-$TCL}
++ PROGRAM=$TEXT
++ TCL=tcl;
++ else
++ text "Please enter the full path name of the $DEVICE speech server" \
++ ${PROGRAM:-$TCL}
++ TCL=$TEXT
++ PROGRAM=;
++ fi;
++ if echo $PORT|grep '^/dev/ttyS' >/dev/null; then ans=y; else ans=n; fi;
++ if yesno "Is the $DEVICE connected to a serial port?" $ans ; then
++ true;
++ else
++ valid=no;
++ while [ "$valid" = "no" ]; do
++ text "Please enter the device (for example, /dev/lp0): " \
++ ${PORT:-/dev/lp0}
++ PORT=$TEXT;
++ if check_port; then valid=yes; fi
++ done
++ HAVE_PORT=yes;
++ fi;
++
++# echo "PROGRAM=$PROGRAM, TCL=$TCL, PORT=$PORT"
++}
++
++# print warning if a program does not exist
++check_pgm() {
++if [ -x $TCL -o -x /usr/bin/$TCL ]; then true; else
++ echo
++ echo "NOTICE: Before using Emacspeak, please install"
++ echo " $TCL"
++ echo
++ echo -n "Press Enter to continue: "; read junk;
++fi
++}
++
++# return success if $PORT is (or will be) a valid character device
++check_port() {
++
++if [ -c "$PORT" ]; then return 0; fi
++echo "$PORT is not a character device"
++yesno "Will $PORT be compiled into the kernel or loaded as a module?" "y"
++}
++
++# give a user a supplementary group ID
++#
++# usage: enroll user1[,user2...] group1[,group2...]
++enroll() {
++set -e
++awk '
++BEGIN {
++ FS=":";
++ OFS=":";
++ if (ARGC<4) {
++ print "requires two arguments" >"/dev/stderr";
++ exit(1);
++ }
++ userlist=ARGV[1];
++ if (userlist!~/^[a-z][a-z,]*$/) {
++ print "invalid user list" >"/dev/stderr";
++ exit(1);
++ }
++ nu=split(userlist,user,",");
++ grouplist=ARGV[2];
++ if (grouplist!~/^[a-z][a-z,]*$/) {
++ print "invalid group list" >"/dev/stderr";
++ exit(1);
++ }
++ ng=split(grouplist,group,",");
++# printf("%d users: ",nu);
++# for (i=1; i<=nu; i++) printf("%s ", user[i]);
++# printf("\n");
++# printf("%d groups: ",ng);
++# for (i=1; i<=nu; i++) printf("%s ", group[i]);
++# printf("\n");
++ ARGC=2;
++ ARGV[1]=ARGV[3];
++}
++{
++ for (i=1; i<=ng; i++) {
++ if ($1~group[i]) {
++ if (NF==3) { # no group members yet
++ $4=userlist;
++ } else { # already some group members
++ delete names;
++ delete member;
++ split($4,names,",");
++ for (j in names) {member[names[j]]=1;}
++ for (j=1;j <= nu;j++) {member[user[j]]=1;}
++ $4="";
++ for (name in member) {$4=$4 "," name;}
++ $4=substr($4, 2);
++ }
++ }
++ }
++ print;
++}' $1 $2 $GROUPFILE >$GROUPFILE.$$ && mv $GROUPFILE.$$ $GROUPFILE
++}
++
++# take a supplementary group ID away from a user
++#
++# usage: dismiss user1[,user2...] group1[,group2...]
++dismiss() {
++set -e
++awk '
++BEGIN {
++ FS=":";
++ OFS=":";
++ if (ARGC<4) {
++ print "requires two arguments" >"/dev/stderr";
++ exit(1);
++ }
++ userlist=ARGV[1];
++ if (userlist!~/^[a-z][a-z,]*$/) {
++ print "invalid user list" >"/dev/stderr";
++ exit(1);
++ }
++ nu=split(userlist,user,",");
++ grouplist=ARGV[2];
++ if (grouplist!~/^[a-z][a-z,]*$/) {
++ print "invalid group list" >"/dev/stderr";
++ exit(1);
++ }
++ ng=split(grouplist,group,",");
++#printf("userlist=%s\n",userlist);
++#printf("%d users: ",nu); for (i=1; i<=nu; i++) printf("%s ", user[i]); printf("\n");
++#printf("%d groups: ",ng); for (i=1; i<=nu; i++) printf("%s ", group[i]); printf("\n");
++ ARGC=2;
++ ARGV[1]=ARGV[3];
++}
++{
++ for (i=1; i<=ng; i++) {
++ if ($1~group[i]) {
++ if (NF==3) { # no group members yet
++ } else { # already some group members
++ delete names;
++ delete member;
++ split($4,names,",");
++ for (j in names) {member[names[j]]=1;}
++ for (j=1;j <= nu;j++) {delete member[user[j]];}
++ $4="";
++ for (name in member) {$4=$4 "," name;}
++ $4=substr($4, 2);
++ }
++ }
++ }
++ print;
++}' $1 $2 $GROUPFILE >$GROUPFILE.$$ && mv $GROUPFILE.$$ $GROUPFILE
++}
++
++# get the current parameter values (if any) from the configuration file
++if [ -s $CFG ]; then
++ PORT=`awk 'BEGIN{FS="="}/^ *DTK_PORT/{print $2}' $CFG`
++ TCL=`awk 'BEGIN{FS="="}/^ *DTK_TCL/{print $2}' $CFG`
++ PROGRAM=`awk 'BEGIN{FS="="}/^ *DTK_PROGRAM/{print $2}' $CFG`
++ DEVICE=`awk '
++ / *DTK_DEVICE="?.*"?/{
++ word=substr($0,index($0,"=")+1);
++ gsub(/\"/,"",word);
++ if (length(word) == 0) word="DECtalk Express";
++ print word;
++ }' $CFG`
++fi
++HAVE_PORT=no;
++
++#echo initial values are: PROGRAM=$PROGRAM TCL=$TCL PORT=$PORT DEVICE=$DEVICE
++#echo getting speech server choice
++
++# There must be a file foo.blurb in $BLURBS for each distinct
++# combination of speech server and hardware device. It contains lines
++# beginning with a single word and a colon (anything else is ignored).
++# The valid words are
++# blurb: the description to print
++# device: value for DTK_DEVICE (supplies default for next time)
++# tcl: value for DTK_TCL
++# program: value for DTK_PROGRAM
++
++# get synthesizer name
++if [ $initial = no -o "$PROGRAM" = "" -o "$TCL" = "" ]; then
++ valid=no
++ while [ $valid = no ]; do
++
++ # first pass: print menu
++ awk '
++ BEGIN {
++ printf("Please enter the number of your choice:\n\n");
++ ARGC=1;
++ cmd = "ls " ARGV[1] "/blurbs/*.blurb";
++ while (cmd|getline >0){bname[++n] = $1;}
++ for (i = 1; i <= n; i++){
++ while (getline < bname[i] > 0){
++ if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
++ if ($0 ~ /^program:/){program[i] = $2;}
++ if ($0 ~ /^tcl:/){tcl[i] = $2;}
++ if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
++ }
++ close(bname[i]);
++ printf(" %2d %s\n", i, blurb[i]);
++ }
++ printf(" o other. I can provide the filename\n");
++ printf(" a abort, and restart configuration after\n");
++ printf(" installation of another speech server package\n");
++ }' $USUAL "$DEVICE"
++
++ # second pass: determine default choice
++ area=`awk '
++ BEGIN {
++ ARGC=1;
++ cmd = "ls " ARGV[1] "/blurbs/*.blurb";
++ while (cmd|getline >0){bname[++n] = $1;}
++ for (i = 1; i <= n; i++){
++ while (getline < bname[i] > 0){
++ if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
++ if ($0 ~ /^program:/){program[i] = $2;}
++ if ($0 ~ /^tcl:/){tcl[i] = $2;}
++ if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
++ }
++ if (index(device[i],ARGV[2])){deflt=i;}
++ if (index(device[i],"DECtalk Express")){decexp=i;}
++ close(bname[i]);
++ }
++ if (deflt == 0) print decexp;
++ print deflt;
++ }' $USUAL "$DEVICE" `
++
++ # get answer from user
++ text "Number" $area; area=$TEXT
++
++ # third pass: set shell variables according to his choice
++ eval `awk '
++ BEGIN {
++ ARGC=1;
++ cmd = "ls " ARGV[1] "/blurbs/*.blurb";
++ while (cmd|getline >0){bname[++n] = $1;}
++ for (i = 1; i <= n; i++){
++ while (getline < bname[i] > 0){
++ if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
++ if ($0 ~ /^program:/){program[i] = $2;}
++ if ($0 ~ /^tcl:/){tcl[i] = $2;}
++ if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
++ }
++ if (i == ARGV[2]){
++ sub(/^ */,"",device[i]);
++ printf("PROGRAM=%s; TCL=%s; DEVICE=\"%s\"; valid=yes;\n", \
++ program[i], tcl[i], device[i]);
++ }
++ }
++ }' $USUAL $area`
++ if [ "$area" = "a" ]; then exit 0; fi
++ if [ "$area" = "0" -o "$area" = "o" -o "$area" = "O" ]; then
++ request_params;
++ fi
++ if [ "$PROGRAM" = "none" -o "$PROGRAM" = "" ]; then check_pgm; fi
++ done
++fi
++
++#echo new values are: DEVICE=$DEVICE PROGRAM=$PROGRAM TCL=$TCL PORT=$PORT
++
++# get unix device
++if [ "$DEVICE" = "DoubleTalk PC" ]; then
++ IN_PORT=/dev/dtlk
++else
++ IN_PORT=$PORT
++ if [ "$IN_PORT" = "" -o "$IN_PORT" = "/dev/dtlk" ]; then
++ IN_PORT=/dev/ttyS0;
++ fi
++fi
++if [ $HAVE_PORT = no ]; then
++ if [ $initial = no -o "$PORT" = "" ]; then
++ valid=no
++ while [ $valid = no ]; do
++ text "
++ Your speech synthesizer is connected to which port, if any?
++ (The first serial port would be /dev/ttyS0.
++ This is ignored for a software synthesizer)" $IN_PORT
++ PORT=$TEXT
++ if check_port $PORT; then valid=yes; fi
++ done
++ fi
++fi
++
++#echo " "
++#echo emacspeak is configured for $DEVICE attached to $PORT
++
++# adjust unix device group membership if needed
++if [ -c "$PORT" ]; then
++ DEVICEGROUP=`ls -l -L $PORT|awk '{print $4}'`
++else
++ if [ "$DEVICE" = "DoubleTalk PC" -a -f /etc/makedev.cfg ]; then
++ DEVICEGROUP=`awk '/audio:/{print $4}' /etc/makedev.cfg`
++ else
++ DEVICEGROUP=audio
++ fi
++ echo "$PORT is assumed to be in group: $DEVICEGROUP"
++fi
++
++if [ $DEVICEGROUP = root ];
++then
++ echo "$PORT is in group: root"
++ echo "please move it to another group with chown,"
++ echo "then repeat emacspeak configuration"
++ exit 1
++fi
++
++# skip the enrolling of additional users if there is already at least
++# one user, and it's the initial installation
++MEMBERS=`grep ^${DEVICEGROUP} $GROUPFILE|awk 'BEGIN{FS=":"}{print $4}'`
++if [ "$MEMBERS" = "" -o $initial = no ];
++then
++ echo " "
++ echo $PORT can be accessed by members of the group: $DEVICEGROUP.
++ if [ "$MEMBERS" = "" ];
++ then echo "Currently, no users are in group $DEVICEGROUP";
++ else echo "Currently, these users are in group $DEVICEGROUP: $MEMBERS";
++ fi
++ finished=no
++ while [ $finished = no ]; do
++ echo " "
++ echo "If you wish to enroll any other users into group $DEVICEGROUP,"
++ echo "(even if their accounts have not been created yet),"
++ echo -n "please list their usernames here separated by commas: "
++ read USERS
++ if [ "$USERS" = "" ] || enroll $USERS $DEVICEGROUP; then
++ finished=yes;
++ fi
++ done
++ finished=no
++ while [ $finished = no ]; do
++ echo " "
++ echo "If you wish to remove any users from group $DEVICEGROUP,"
++ echo -n "please list their usernames here separated by commas: "
++ read USERS
++ if [ "$USERS" = "" ] || dismiss $USERS $DEVICEGROUP; then
++ finished=yes;
++ fi
++ done
++fi
++
++echo " "
++echo "You may reconfigure emacspeak at any time by running emacspeakconfig as root"
++
++# make sure the group has both read and write permissions
++if [ -e "$PORT" ]; then chmod g+rw $PORT; fi
++
++# update the configuration file
++sed -e "s@^ *DTK_PROGRAM=.*@ DTK_PROGRAM=$PROGRAM@" \
++ -e "s@^ *DTK_PORT=.*@ DTK_PORT=$PORT@" \
++ -e "s@^ *DTK_TCL=.*@ DTK_TCL=$TCL@" \
++ -e "s@^ *DTK_DEVICE=.*@ DTK_DEVICE=\"$DEVICE\"@" \
++ $CFG > $CFG.TMP && mv $CFG.TMP $CFG
+--- emacspeak-24.orig/debian/emacsen-startup
++++ emacspeak-24/debian/emacsen-startup
+@@ -0,0 +1,21 @@
++;; -*-emacs-lisp-*-
++;; /etc/emacs/site-start.d/50emacspeak.el
++;;
++;; Emacs startup file for the Debian emacspeak package
++;;
++;; Originally contributed by Nils Naumann <naumann@unileoben.ac.at>
++;; Modified by Dirk Eddelbuettel <edd@debian.org>
++;; Adapted for dh-make by Jim Van Zandt <jrv@vanzandt.mv.com>
++
++;; The emacspeak package follows the Debian/GNU Linux 'emacsen' policy and
++;; byte-compiles its elisp files for each 'emacs flavor' (emacs19,
++;; xemacs19, emacs20, xemacs20...). The compiled code is then
++;; installed in a subdirectory of the respective site-lisp directory.
++;; We have to add this to the load-path:
++(let ((package-dir (concat "/usr/share/"
++ (symbol-name flavor)
++ "/site-lisp/emacspeak"))
++ (source-dir "/usr/share/emacs/site-list/emacspeak"))
++ (when (file-directory-p package-dir)
++ (setq load-path (cons package-dir (cons source-dir load-path)))))
++
+--- emacspeak-24.orig/debian/emacspeak.conf
++++ emacspeak-24/debian/emacspeak.conf
+@@ -0,0 +1,17 @@
++# emacspeak configuration file
++#
++#
++if [ "$DTK_PROGRAM" = "" ]; then
++ DTK_PROGRAM=
++fi
++if [ "$DTK_PORT" = "" ]; then
++ DTK_PORT=
++fi
++if [ "$DTK_TCL" = "" ]; then
++ DTK_TCL=
++fi
++if [ "$DTK_DEVICE" = "" ]; then
++ DTK_DEVICE=
++fi
++export DTK_PROGRAM DTK_PORT DTK_DEVICE
++if [ "$DTK_TCL" != "" ]; then export DTK_TCL; fi
+--- emacspeak-24.orig/debian/emacspeak-initialization
++++ emacspeak-24/debian/emacspeak-initialization
+@@ -0,0 +1,35 @@
++Following is Raman's sample code to add to ~/.emacs to start
++emacspeak. File locations are different in a Debian system. - Jim Van Zandt
++
++emacspeak initialization...
++Anyone who copies this blindly without bothering to
++understand what it does will get what they deserve:-)
++
++ ;;{{{ Load and customize emacspeak
++
++
++ (unless (featurep 'emacspeak)
++ (load-file
++ (expand-file-name "~/emacs/lisp/emacspeak/emacspeak-setup.el")))
++
++ (when (featurep 'emacspeak)
++ (declare (special emacspeak-play-program emacspeak-play-args
++ emacspeak-auditory-icon-function
++ dtk-default-speech-rate))
++ (if (file-exists-p "/usr/demo/SOUND/play")
++ (setq
++ emacspeak-play-program "/usr/demo/SOUND/play"
++ emacspeak-play-args "-i"
++ emacspeak-auditory-icon-function
++ 'emacspeak-play-auditory-icon))
++ (if (file-exists-p "/usr/bin/audioplay")
++ (setq
++ emacspeak-play-program "/usr/bin/audioplay"
++ emacspeak-play-args "-i"
++ emacspeak-auditory-icon-function 'emacspeak-play-auditory-icon))
++ (setq dtk-default-speech-rate 485)
++ (emacspeak-pronounce-load-dictionaries "~/.emacspeak/.dictionary")
++ (dtk-set-rate 480 t)
++ (unless blackdog-p (emacspeak-toggle-auditory-icons t)))
++
++ ;;}}}
+--- emacspeak-24.orig/debian/decexp.blurb
++++ emacspeak-24/debian/decexp.blurb
+@@ -0,0 +1,4 @@
++blurb: DECtalk Express
++program: dtk-exp
++tcl: tcl
++device: DECtalk Express
+--- emacspeak-24.orig/debian/decmv.blurb
++++ emacspeak-24/debian/decmv.blurb
+@@ -0,0 +1,4 @@
++blurb: DECtalk Multivoice
++program: dtk-mv
++tcl: tcl
++device: DECtalk Multivoice
+--- emacspeak-24.orig/debian/decsoft.blurb
++++ emacspeak-24/debian/decsoft.blurb
+@@ -0,0 +1,4 @@
++blurb: Software DECtalk
++program: dtk-soft
++tcl: tcl
++device: sound card with Software DECtalk
+--- emacspeak-24.orig/debian/decthree.blurb
++++ emacspeak-24/debian/decthree.blurb
+@@ -0,0 +1,4 @@
++blurb: DECtalk 3
++program: dtk-mv
++tcl: tcl
++device: DECtalk 3
+--- emacspeak-24.orig/debian/dtksoft.blurb
++++ emacspeak-24/debian/dtksoft.blurb
+@@ -0,0 +1,4 @@
++blurb: Software DECtalk
++program: dtk-soft
++tcl: tcl
++device: Software DECtalk
+--- emacspeak-24.orig/debian/outloud.blurb
++++ emacspeak-24/debian/outloud.blurb
+@@ -0,0 +1,4 @@
++blurb: ViaVoice Outloud
++program: outloud
++tcl: tcl
++device: ViaVoice Outloud
+--- emacspeak-24.orig/debian/remote-tcl.blurb
++++ emacspeak-24/debian/remote-tcl.blurb
+@@ -0,0 +1,4 @@
++blurb: Remote DECtalk server
++program: remote-tcl
++tcl: /usr/share/emacs/site-lisp/emacspeak/servers/remote-tcl
++device: a speech server on another computer
+--- emacspeak-24.orig/debian/emacspeak.1
++++ emacspeak-24/debian/emacspeak.1
+@@ -0,0 +1,58 @@
++..\"{{{ Title Emacs major mode should be: -*- nroff -*-
++.TH EMACSPEAK 1 "December 1, 1999"
++..\"}}}
++..\"{{{ Name
++.SH NAME
++emacspeak \- speech output interface to Emacs
++..\"}}}
++..\"{{{ Synopsis
++.SH SYNOPSIS
++.ad l
++.\" commands only
++.BR emacspeak
++.RI "[ " options " ] [ " file... " ]"
++..\"}}}
++..\"{{{ Config
++.SH DESCRIPTION
++This script starts \fBemacs\fP(1) with speech extensions. \fBemacspeak\fP
++comes with support for the following speech synthesizers: DECtalk Express,
++DECtalk MultiVoice, and software DECtalk on the DEC Alpha.
++.\" or the IBM ViaVoice Outloud.
++Separate speech servers are available to support other synthesizers.
++.P
++\fBemacspeak\fP reads the type of text to speech device and the
++port where it is connected from \fI/etc/emacspeak.conf\fP.
++.P
++For runtime commands supplied by \fBemacspeak\fP, see the
++\fBEmacspeak-HOWTO\fP, or consult the .info file:
++.nf
++.B " info emacspeak"
++.fi
++.SH OPTIONS
++.TP
++.BI -o
++Use IBM ViaVoice Outloud speech server.
++.TP
++.BI -m
++Use \fBmbrola\fP(1) for speech output.
++.TP
++.BI -q
++Do not process the startup file \fI~/.emacs\fP.
++.SH AUTHOR
++T. V. Raman, Adobe Systems Incorporated <raman@adobe.com>
++..\"}}}
++..\"{{{
++.SH FILES
++.nf
++\fI/etc/emacspeak.conf\fP
++.fi
++..\"}}}
++..\"{{{ See also
++.SH "SEE ALSO"
++.nf
++.BR emacspeakconfig (8),
++.IR emacspeak.info ,
++.B ftp://leb.net/pub/blinux/emacspeak/blinux.
++
++.fi
++..\"}}}
+--- emacspeak-24.orig/debian/emacspeakconfig.8
++++ emacspeak-24/debian/emacspeakconfig.8
+@@ -0,0 +1,36 @@
++..\"{{{ Title Emacs major mode should be: -*- nroff -*-
++.TH EMACSPEAKCONFIG 8 "February 13, 1998"
++..\"}}}
++..\"{{{ Name
++.SH NAME
++emacspeakconfig \- configure emacspeak
++..\"}}}
++..\"{{{ Synopsis
++.SH SYNOPSIS
++.ad l
++.\" commands only
++.BR /usr/sbin/emacspeakconfig " [ " -i " ]"
++..\"}}}
++..\"{{{ Config
++.SH DESCRIPTION
++This script records in \fI/etc/emacspeak.conf\fP the type of text to
++speech device, the device (port) where it is connected, and the name
++of the speech server used to access it.
++.SH OPTIONS
++.IP "\fB\-i\fP"
++Initial configuration: If \fI/etc/emacspeakconfig\fP exists and has
++all the required entries, then leave it unchanged and ask no
++questions. The default is to ask regardless.
++.SH AUTHOR
++Jim Van Zandt <jrv@debian.org>
++..\"}}}
++..\"{{{
++.SH FILES
++.nf
++\fI/etc/emacspeak.conf\fP
++.fi
++..\"}}}
++..\"{{{ See also
++.SH "SEE ALSO"
++.BR emacspeak (1)
++..\"}}}
+--- emacspeak-24.orig/debian/bbc-channels-on-emacspeak.html
++++ emacspeak-24/debian/bbc-channels-on-emacspeak.html
+@@ -0,0 +1,36 @@
++<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
++<div xmlns="http://www.w3.org/1999/xhtml">
++<p>Since the BBC's various channels are what I listen to the
++most, launching BBC channels has always been a couple of
++keystrokes in Emacspeak. As a first step, directory
++<code>realaudio/radio</code> contains shortcut files for
++launching live streams from the various BBC channels.</p>
++<p>
++In addition, module <code>emacspeak-url-template</code> defines a
++number of <em>Smart URLs</em> for single-click access to BBC
++programs. The ones I use the most are:</p>
++
++<ul>
++<li><em>Smart URL</em> <code>BBC Channels On Demand</code>, and </li>
++<li><em>Smart URL</em> <code>BBC Genres On Demand</code></li>
++</ul>
++<p>
++These <em>smart URLs</em> prompt for the channel or genre
++respectively and bring up a Web page that lists the various shows
++that are available --- note that the BBC archives shows for a
++whole week.
++The resulting Web page is easy to browse in W3; the most
++effective way to skim the buffer is to repeatedly hit
++<code>i</code> which moves through the various items on the page.
++Hitting <code>e e</code> (that's the letter <code>e</code>
++<em>twice</em>) while on a hyperlink will launch the
++corresponding media stream by calling a <em>context-aware</em>
++command that knows about transforming the URL to one that
++accesses the program stream; --- note that simply following the
++hyperlink will get you first to a page about the program, rather
++than to the program stream itself.</p>
++<p>To find out what channels and genres are available, browse the
++BBC Web site --- channel and genre names are not hard-wired into
++Emacspeak since these can change over time with channels and
++genres being added or renamed.</p>
++ </div> <br /><br />--<br><font color="gray" size="2">Posted by T. V. Raman to <a href="http://emacspeak.blogspot.com/2006/01/bbc-channels-on-emacspeak.html">emacspeak The Complete Audio Desktop</a> at 1/27/2006 08:43:48 PM</font></body></html>
+--- emacspeak-24.orig/debian/browsing-sourceforge-download-servers.html
++++ emacspeak-24/debian/browsing-sourceforge-download-servers.html
+@@ -0,0 +1,29 @@
++<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
++<div xmlns="http://www.w3.org/1999/xhtml">
++<p>Sourceforge is a nice service, but it can also be painful to
++use because of the heavy-weight Web page design, and the need to
++repeatedly click before you get the download you want.</p>
++<p>The most irksome of these is the download mechanism provided
++by Sourceforge --- where you first need to browse a list of
++download servers, pick a mirror, and then download what you
++want.
++Emacspeak implements a <em>Smart URL</em> that enables one to
++download from Sourceforge in a single step.</p>
++<p>By default, this uses a North American mirror; the behavior
++can be customized if outside the US.
++Use <em>smart URL</em> <code>Sourceforge Browse Mirror</code> and
++specify the name of a SF hosted project when prompted.
++This brings up the index page for the project's download area,
++sorted by date. Move to the bottom of the page and hit
++<code>b</code> to move to the latest available download.</p>
++<p>The <em>smart URL</em> sets up the W3 buffer with a
++context-sensitive download function; when on a download link, hit
++<code>C-d</code>
++to start downloading. This command will prompt for the URL;
++rather than hitting <code>return</code> (which would bring you to
++the <em>browse mirrors</em> page, hit <code>M-p</code> to get the
++download URL for your SF mirror.
++Note that this wizard uses <code>GNU wget</code> to perform the
++download
++via Emacs module <code>w3-wget</code>.</p>
++ </div> <br /><br />--<br><font color="gray" size="2">Posted by T. V. Raman to <a href="http://emacspeak.blogspot.com/2006/01/browsing-sourceforge-download-servers.html">emacspeak The Complete Audio Desktop</a> at 1/27/2006 08:52:45 PM</font></body></html>
+--- emacspeak-24.orig/debian/playing-sudoku-using-auditory-feedback.html
++++ emacspeak-24/debian/playing-sudoku-using-auditory-feedback.html
+@@ -0,0 +1,105 @@
++<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
++<div xmlns="http://www.w3.org/1999/xhtml">
++<p>Emacspeak speech-enables <em>SuDoKu</em> implemented by <a href="http://www.columbia.edu/~jr2075/elisp/index.html">sudoku.el</a>.
++Speech-enabling games is an effective means of discovering what
++additions one needs to make to an auditory interface for
++working effectively in an eyes-free environment --- this was
++aptly demonstrated a few years ago by identifying interesting
++<em>conversational gestures</em> by speech-enabling the game of
++<code>Tetris</code> --- see <a href="http://emacspeak.sourceforge.net/raman/publications/assets-98/paper.pdf">Conversational
++Gestures For The Audio Desktop</a> from Assets 1998.</p>
++
++
++<h4>Advicing Interactive Commands</h4>
++<p>As with speech-enabling any Emacs module,
++<code>emacspeak-sudoku</code> <em>advices</em> all interactive
++commands to produce spoken feedback.
++In addition to speaking the cell moved to, all navigation
++commands produce an auditory icon that is a function of whether
++the cell value is mutable --- original values cannot be changed
++and this is indicated with a distinctive icon.</p>
++
++<h4>Additional Interactive Commands</h4>
++
++<p>Playing SuDoKu effectively requires one to build a good mental
++image of the state of the board as well as the ability to
++effectively query the game for currently active constraints. The
++eye's ability to quickly move around the board and perceive row,
++column and sub-square constraints needs to be compensated for in
++an eyes-free environment. As an example, it is too difficult to
++build the necessary mental model by just listening to the board
++spoken aloud, or by listening to idnividual cells by navigating
++to them.</p>
++
++<p>Here are the set of additional interactive commands that
++needed to be added in order to be able to play the game
++effectively.</p>
++
++<dl>
++<dt><code>r</code></dt>
++<dd>Speak current row.</dd>
++<dt><code>c</code></dt>
++<dd>Speak current column</dd>
++<dt><code>s</code></dt>
++<dd>Speak current sub-square.</dd>
++<dt><code>R</code></dt>
++<dd>Speak number of remaining cells in current row.</dd>
++<dt><code>C</code></dt>
++<dd>Speak number of remaining cells in current column.</dd>
++<dt><code>S</code></dt>
++<dd>Speak number of remaining cells in current sub-square.</dd>
++<dt><code>d</code></dt>
++<dd>Move to the sub-square below the current sub-square.</dd>
++<dt><code>u</code></dt>
++<dd>Move to the sub-square above the current sub-square.</dd>
++<dt><code>n</code></dt>
++<dd>Move to the next sub-square.</dd>
++<dt><code>p</code></dt>
++<dd>Move to the previous sub-square.</dd>
++<dt><code>a</code></dt>
++<dd>Move to the beginning of current row.</dd>
++<dt><code>e</code></dt>
++<dd>Move to the end of the current row.</dd>
++<dt><code>t</code></dt>
++<dd>Move to the top of the current column.</dd>
++<dt><code>b</code></dt>
++<dd>Move to the bottom of the current column.</dd>
++<dt><code>,</code></dt>
++<dd>Speaks information about the overall <em>distribution</em> of
++numbers on the board.
++<ul>
++<li><code>d</code> --- Conveys how many instances of each digit
++have been filled in.</li>
++<li><code>s</code> --- Conveys number of remaining cells in each
++sub-square.</li>
++<li><code>r</code> --- Conveys number of remaining cells in each
++row.</li>
++<li><code>c</code> --- Conveys number of remaining cells in each
++column.</li>
++</ul>
++</dd>
++<dt><code>/</code></dt>
++<dd>Speaks number of remaining cells in the current board.</dd>
++<dt><code>.</code></dt>
++<dd>Speaks value in current cell.</dd>
++</dl>
++
++<p>Notes on how invormation is spoken:</p>
++<ul>
++<li>Numbers are spoken in groups of 3 to achieve effective
++intonation.</li>
++<li>When navigating by sub-squares, point <em>always</em> moves
++to the top left corner of the sub-square.</li>
++<li>Additional commands bound to <code>M-r</code>,
++<code>M-c</code> and <code>M-s</code> erase the current row,
++column or sub-square respectively. These commands would probably
++be convenient to have independent of whether one is using visual
++output.</li>
++</ul>
++
++<h4>Effectiveness Of The Resulting Interface</h4>
++
++<p>With the above interface in place, the simpler levels of the
++game are a breeze, levels <em>difficult</em> and <em>evil</em>
++are sufficiently challenging to be fun.</p>
++ </div> <br /><br />--<br><font color="gray" size="2">Posted by T. V. Raman to <a href="http://emacspeak.blogspot.com/2006/02/playing-sudoku-using-auditory-feedback.html">emacspeak The Complete Audio Desktop</a> at 2/11/2006 06:04:52 PM</font></body></html>
projects / packages / emacspeak.git / commitdiff