1 --- emacspeak-24.orig/info/tts-server.texi
2 +++ emacspeak-24/info/tts-server.texi
6 - @chapter Emacspeak TTS Servers
8 - Emacspeak produces spoken output by communicating with one of many
9 - speech servers. This section documents the communication protocol
10 - between the client application i.e. Emacspeak, and the TTS
11 - server. This section is primarily intended for developers wishing to:
13 - @item Create new speech servers that comply with this communication
15 - @item Developers of other client applications who wish to use
16 - the various Emacspeak speech servers.
19 - @subsection High-level Overview
21 - The TTS server reads commands from standard input, and script
22 - @emph{speech-server} can be used to cause a TTS server to communicate
23 - via a TCP socket. Speech server commands are used by the client
24 - application to make specific requests of the server; the server
25 - listens for these requests in a non-blocking read loop and executes
26 - requests as they become available. Requests can be classified
29 - @item Commands that send text to be spoken.
30 - @item Commands that set @emph{state} of the TTS server.
33 - All commands are of the form
35 - commandWord @{arguments@}
37 - The braces are optional if the command argument contains no white
38 - space. The speech server maintains a @emph{current state} that
39 - determines various characteristics of spoken output such as speech
40 - rate, punctuations mode etc. (see set of commands that manipulate
41 - speech state for complete list). The client application @emph{queues} The
42 - text and non-speech audio output to be produced before asking the
43 - server to @emph{dispatch} the set of queued requests, i.e. start
46 - Once the server has been asked to produce output, it removes items
47 - from the front of the queue, sends the requisite commands to the
48 - underlying TTS engine, and waits for the engine to acknowledge that
49 - the request has been completely processed. This is a non-blocking
50 - operation, i.e., if the client application generates additional
51 - requests, these are processed @emph{immediately}.
53 - The above design allows the Emacspeak TTS server to be
54 - @emph{highly} responsive; Cleint applications can queue large
55 - amounts of text (typically queued a clause at a time to
56 - achieve the best prosody), ask the TTS server to start speaking,
57 - and interrupt the spoken output at any time.
59 - @subsection Commands That Queue Output.
61 - This section documents commands that either produce spoken
62 - output, or queue output to be produced on demand.
63 - Commands that place the request on the queue are clearly marked.
69 - Speaks the @emph{version} of the TTS engine. Produces output
76 - Speaks the specified @emph{text} immediately. The text is not
77 - pre-processed in any way, contrast this with the primary way of
78 - speaking text which is to queue text before asking the server to
85 - Speak @emph{c} a single character, as a letter. The character is
86 - spoken immediately. This command uses the TTS engine's capability to
87 - speak a single character with the ability to flush speech
88 - @emph{immediately}. Client applications wishing to produce
89 - character-at-a-time output, e.g., when providing character echo during
90 - keyboard input should use this command.
96 - This command is used to @emph{dispatch} all queued requests.
97 - It was renamed to a single character command (like many of the
98 - commonly used TTS server commands) to work more effectively over
99 - slow (9600) dialup lines.
100 - The effect of calling this command is for the TTS server to start
101 - processing items that have been queued via earlier requests.
107 - This pauses speech @emph{immediately}.
108 - It does not affect queued requests; when command
109 - @emph{tts_resume} is called, the output resumes at the point
110 - where it was paused. Not all TTS engines provide this capability.
116 - Resume spoken output if it has been paused earlier.
122 - Stop speech @emph{immediately}.
123 - Spoken output is interrupted, and all pending requests are
124 - flushed from the queue.
130 - Queues text to be spoken. No spoken output is produced until a
131 - @emph{dispatch} request is received via execution of command
138 - Cues the audio file identified by filename for playing.
144 - Queues a tone to be played at the specified frequency and having the
145 - specified length. Frequency is specified in hertz and length is
146 - specified in milliseconds.
152 - Queues the specified duration of silence. Silence is specified in
155 - @subsection Commands That Set State
161 - Reset TTS engine to default settings.
164 - tts_set_punctuations mode
167 - Sets TTS engine to the specified punctuation mode. Typicaly, TTS
168 - servers provide at least three modes:
170 - @item None: Do not speak punctuation characters.
171 - @item some: Speak some punctuation characters. Used for English
173 - @item all: Speak out @emph{all} punctuation characters; useful in
178 - tts_set_speech_rate rate
181 - Sets speech rate. The interpretation of this value is typically
185 - tts_set_character_scale factor
188 - Scale factor applied to speech rate when speaking individual
189 - characters.Thus, setting speech rate to 500 and character
190 - scale to 1.2 will cause command @emph{l} to use a speech rate
191 - of @emph{500 * 1.2 = 600}.
194 - tts_split_caps flag
197 - Set state of @emph{split caps} processing. Turn this on to
198 - speak mixed-case (AKA Camel Case) identifiers.
201 - tts_capitalize flag
204 - Indicate capitalization via a beep tone or voice pitch.
207 - tts_allcaps_beep flag
211 +@chapter Emacspeak TTS Servers
213 +Emacspeak produces spoken output by communicating with one of many
214 +speech servers. This section documents the communication protocol
215 +between the client application i.e. Emacspeak, and the TTS
216 +server. This section is primarily intended for developers wishing to:
218 +@item Create new speech servers that comply with this communication
220 +@item Developers of other client applications who wish to use
221 +the various Emacspeak speech servers.
224 +@subsection High-level Overview
226 +The TTS server reads commands from standard input, and script
227 +@emph{speech-server} can be used to cause a TTS server to communicate
228 +via a TCP socket. Speech server commands are used by the client
229 +application to make specific requests of the server; the server
230 +listens for these requests in a non-blocking read loop and executes
231 +requests as they become available. Requests can be classified
234 +@item Commands that send text to be spoken.
235 +@item Commands that set @emph{state} of the TTS server.
238 +All commands are of the form
240 +commandWord @{arguments@}
242 +The braces are optional if the command argument contains no white
243 +space. The speech server maintains a @emph{current state} that
244 +determines various characteristics of spoken output such as speech
245 +rate, punctuations mode etc. (see set of commands that manipulate
246 +speech state for complete list). The client application @emph{queues} The
247 +text and non-speech audio output to be produced before asking the
248 +server to @emph{dispatch} the set of queued requests, i.e. start
251 +Once the server has been asked to produce output, it removes items
252 +from the front of the queue, sends the requisite commands to the
253 +underlying TTS engine, and waits for the engine to acknowledge that
254 +the request has been completely processed. This is a non-blocking
255 +operation, i.e., if the client application generates additional
256 +requests, these are processed @emph{immediately}.
258 +The above design allows the Emacspeak TTS server to be
259 +@emph{highly} responsive; Cleint applications can queue large
260 +amounts of text (typically queued a clause at a time to
261 +achieve the best prosody), ask the TTS server to start speaking,
262 +and interrupt the spoken output at any time.
264 +@subsection Commands That Queue Output.
266 +This section documents commands that either produce spoken
267 +output, or queue output to be produced on demand.
268 +Commands that place the request on the queue are clearly marked.
274 +Speaks the @emph{version} of the TTS engine. Produces output
281 +Speaks the specified @emph{text} immediately. The text is not
282 +pre-processed in any way, contrast this with the primary way of
283 +speaking text which is to queue text before asking the server to
290 +Speak @emph{c} a single character, as a letter. The character is
291 +spoken immediately. This command uses the TTS engine's capability to
292 +speak a single character with the ability to flush speech
293 +@emph{immediately}. Client applications wishing to produce
294 +character-at-a-time output, e.g., when providing character echo during
295 +keyboard input should use this command.
301 +This command is used to @emph{dispatch} all queued requests.
302 +It was renamed to a single character command (like many of the
303 +commonly used TTS server commands) to work more effectively over
304 +slow (9600) dialup lines.
305 +The effect of calling this command is for the TTS server to start
306 +processing items that have been queued via earlier requests.
312 +This pauses speech @emph{immediately}.
313 +It does not affect queued requests; when command
314 +@emph{tts_resume} is called, the output resumes at the point
315 +where it was paused. Not all TTS engines provide this capability.
321 +Resume spoken output if it has been paused earlier.
327 +Stop speech @emph{immediately}.
328 +Spoken output is interrupted, and all pending requests are
329 +flushed from the queue.
335 +Queues text to be spoken. No spoken output is produced until a
336 +@emph{dispatch} request is received via execution of command
343 +Cues the audio file identified by filename for playing.
349 +Queues a tone to be played at the specified frequency and having the
350 +specified length. Frequency is specified in hertz and length is
351 +specified in milliseconds.
357 +Queues the specified duration of silence. Silence is specified in
360 +@subsection Commands That Set State
366 +Reset TTS engine to default settings.
369 +tts_set_punctuations mode
372 +Sets TTS engine to the specified punctuation mode. Typicaly, TTS
373 +servers provide at least three modes:
375 +@item None: Do not speak punctuation characters.
376 +@item some: Speak some punctuation characters. Used for English
378 +@item all: Speak out @emph{all} punctuation characters; useful in
383 +tts_set_speech_rate rate
386 +Sets speech rate. The interpretation of this value is typically
390 +tts_set_character_scale factor
393 +Scale factor applied to speech rate when speaking individual
394 +characters.Thus, setting speech rate to 500 and character
395 +scale to 1.2 will cause command @emph{l} to use a speech rate
396 +of @emph{500 * 1.2 = 600}.
402 +Set state of @emph{split caps} processing. Turn this on to
403 +speak mixed-case (AKA Camel Case) identifiers.
409 +Indicate capitalization via a beep tone or voice pitch.
412 +tts_allcaps_beep flag
415 - Setting this flag produces a high-pitched beep when speaking words that are in
416 - all-caps, e.g. abbreviations.
417 +Setting this flag produces a high-pitched beep when speaking words that are in
418 +all-caps, e.g. abbreviations.
420 --- emacspeak-24.orig/info/tts.texi
421 +++ emacspeak-24/info/tts.texi
424 - @section Speech System Commands
427 @cindex speech system
431 * Controlling Echo:: Character, Word and Line Echo.
432 -* Speech Output Control:: Indicating case, capitalization and indentation.
433 +* Speech Output Control:: Indicating case, capitalization and indentation.
434 * Miscellaneous:: Miscellaneous TTS Commands.
440 @findex emacspeak-toggle-character-echo
441 - @kindex control e d k
442 +@kindex control e d k
443 @item @kbd{control e d k }
444 emacspeak-toggle-character-echo
445 - Toggle state of Emacspeak character echo.
446 +Toggle state of Emacspeak character echo.
447 Interactive PREFIX arg means toggle the global default value, and then set the
448 current local value to the result.
451 @findex emacspeak-toggle-word-echo
452 - @kindex control e d w
454 +@kindex control e d w
456 @item @kbd{ control e d w }
457 emacspeak-toggle-word-echo
458 - Toggle state of Emacspeak word echo.
459 +Toggle state of Emacspeak word echo.
460 Interactive PREFIX arg means toggle the global default value, and then set the
461 current local value to the result.
464 @findex emacspeak-toggle-line-echo
465 - @kindex control e d l
467 +@kindex control e d l
469 @item @kbd{ control e d l }
470 emacspeak-toggle-line-echo
471 - Toggle state of Emacspeak line echo.
472 +Toggle state of Emacspeak line echo.
473 Interactive PREFIX arg means toggle the global default value, and then set the
474 current local value to the result.
480 - @kindex control e d r
482 +@kindex control e d r
484 @item @kbd{ control e d r }
486 - Set speaking RATE for the tts.
487 +Set speaking RATE for the tts.
488 Interactive PREFIX arg means set the global default value, and then set the
489 current local value to the result.
492 @findex dtk-set-character-scale
493 - @kindex control e d f
495 +@kindex control e d f
497 @item @kbd{ control e d f }
498 dtk-set-character-scale
499 - Set scale FACTOR for speech rate.
500 +Set scale FACTOR for speech rate.
501 Speech rate is scaled by this factor
502 when speaking characters.
503 Interactive PREFIX arg means set the global default value, and then set the
504 @@ -109,20 +108,20 @@
507 @findex dtk-set-predefined-speech-rate
508 - @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
510 +@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
512 @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 }
513 dtk-set-predefined-speech-rate
514 - Set speech rate to one of nine predefined levels.
515 +Set speech rate to one of nine predefined levels.
516 Interactive PREFIX arg says to set the rate globally.
519 @findex dtk-set-punctuations
520 - @kindex control e d p
522 +@kindex control e d p
524 @item @kbd{ control e d p }
526 - Set punctuation mode to MODE.
527 +Set punctuation mode to MODE.
528 Possible values are `some', `all', or `none'.
529 Interactive PREFIX arg means set the global default value, and then set the
530 current local value to the result.
531 @@ -130,11 +129,11 @@
534 @findex dtk-set-pronunciation-mode
535 - @kindex control e d m
537 +@kindex control e d m
539 @item @kbd{ control e d m }
540 dtk-set-pronunciation-mode
541 - Set pronunciation MODE.
542 +Set pronunciation MODE.
543 This command is valid only for newer
544 Dectalks, e.g. the Dectalk Express. Possible values are `math, name,
545 europe, spell', all of which can be turned on or off.
546 @@ -143,11 +142,11 @@
549 @findex dtk-toggle-split-caps
550 - @kindex control e d s
551 +@kindex control e d s
553 @item @kbd{ control e d s }
554 dtk-toggle-split-caps
555 - Toggle split caps mode.
556 +Toggle split caps mode.
557 Split caps mode is useful when reading
558 Hungarian notation in program source code. Interactive PREFIX arg
559 means toggle the global default value, and then set the current local
560 @@ -155,22 +154,22 @@
563 @findex dtk-toggle-capitalization
564 - @kindex control e d c
566 +@kindex control e d c
568 @item @kbd{ control e d c }
569 dtk-toggle-capitalization
570 - Toggle capitalization.
571 +Toggle capitalization.
572 when set, capitalization is indicated by a
573 short beep. Interactive PREFIX arg means toggle the global default
574 value, and then set the current local value to the result.
577 @findex dtk-toggle-allcaps-beep
578 - @kindex control e d cap C
580 +@kindex control e d cap C
582 @item @kbd{ control e d cap C }
583 dtk-toggle-allcaps-beep
584 - Toggle allcaps-beep.
585 +Toggle allcaps-beep.
586 when set, allcaps words are indicated by a
587 short beep. Interactive PREFIX arg means toggle the global default
588 value, and then set the current local value to the result.
589 @@ -188,11 +187,11 @@
592 @findex emacspeak-toggle-audio-indentation
593 - @kindex control e d i
595 +@kindex control e d i
597 @item @kbd{ control e d i }
598 emacspeak-toggle-audio-indentation
599 - Toggle state of Emacspeak audio indentation.
600 +Toggle state of Emacspeak audio indentation.
601 Interactive PREFIX arg means toggle the global default value, and then set the
602 current local value to the result.
603 Specifying the method of indentation as `tones'
604 @@ -227,19 +226,19 @@
608 - @kindex pause control e s
610 +@kindex pause control e s
612 @item @kbd{Control e s}
619 - @kindex control e p
623 @item @kbd{ control e p }
625 - Pause ongoing speech.
626 +Pause ongoing speech.
627 The speech can be resumed with command `dtk-resume'
628 normally bound to C-e SPC. Pausing speech is useful when one needs to
629 perform a few actions before continuing to read a large document. Emacspeak
630 @@ -250,24 +249,24 @@
634 - @kindex control e SPACE
636 +@kindex control e SPACE
638 @item @kbd{ control e SPACE }
640 - Resume paused speech.
641 +Resume paused speech.
642 This command resumes speech that has been suspended by executing
643 command `dtk-pause' bound to C-e p.
644 If speech has not been paused,
645 and variable `dtk-resume-should-toggle' is t
646 - then this command will pause ongoing speech.
647 +then this command will pause ongoing speech.
650 @findex dtk-toggle-quiet
651 - @kindex control e d q
653 +@kindex control e d q
655 @item @kbd{ control e d q }
657 - Toggle state of the speech device between being quiet and talkative.
658 +Toggle state of the speech device between being quiet and talkative.
659 Useful if you want to continue using an Emacs session that has
660 emacspeak loaded but wish to make the speech shut up.
661 Optional argument PREFIX specifies whether speech is turned off in the current buffer or in all buffers.
662 @@ -275,11 +274,11 @@
665 @findex dtk-emergency-restart
666 - @kindex control e control s
668 +@kindex control e control s
670 @item @kbd{ control e control s }
671 dtk-emergency-restart
672 - Use this to nuke the currently running dtk server and restart it.
673 +Use this to nuke the currently running dtk server and restart it.
674 Useful if you want to switch to another synthesizer while emacspeak is
675 running. Also useful for emergency stopping of speech.
677 @@ -293,11 +292,11 @@
680 @findex dtk-add-cleanup-pattern
681 - @kindex control e d a
683 +@kindex control e d a
685 @item @kbd{ control e d a }
686 dtk-add-cleanup-pattern
687 - Add this pattern to the list of repeating patterns that are cleaned up.
688 +Add this pattern to the list of repeating patterns that are cleaned up.
689 Optional interactive prefix arg deletes this pattern if
690 previously added. Cleaning up repeated patterns results in emacspeak
691 speaking the pattern followed by a repeat count instead of speaking
692 @@ -310,22 +309,22 @@
695 @findex dtk-select-server
696 - @kindex control e d d
698 +@kindex control e d d
700 @item @kbd{ control e d d }
702 - Select a speech server interactively.
703 +Select a speech server interactively.
704 This will be the server that is used when you next call either
705 M-x dtk-initialize or C-e C-s.
706 Argument PROGRAM specifies the speech server program.
709 @findex dtk-toggle-splitting-on-white-space
710 - @kindex control e d SPACE
712 +@kindex control e d SPACE
714 @item @kbd{ control e d SPACE }
715 dtk-toggle-splitting-on-white-space
716 - Toggle splitting of speech on white space.
717 +Toggle splitting of speech on white space.
718 This affects the internal state of emacspeak that decides if we split
719 text purely by clause boundaries, or also include
720 whitespace. By default, emacspeak sends a clause at a time
721 @@ -342,37 +341,37 @@
724 @findex dtk-set-chunk-separator-syntax
725 - @kindex control e d RETURN
727 +@kindex control e d RETURN
729 @item @kbd{ control e d RETURN }
730 dtk-set-chunk-separator-syntax
731 - Interactively set how text is split in chunks.
732 +Interactively set how text is split in chunks.
733 See the Emacs documentation on syntax tables for details on how characters are
734 classified into various syntactic classes.
735 Argument S specifies the syntax class.
738 @findex emacspeak-dial-dtk
739 - @kindex control e d t
741 +@kindex control e d t
743 @item @kbd{ control e d t }
745 - Prompt for and dial a phone NUMBER with the Dectalk.
746 +Prompt for and dial a phone NUMBER with the Dectalk.
749 @findex emacspeak-dtk-speak-version
750 - @kindex control e d cap V
752 +@kindex control e d cap V
754 @item @kbd{ control e d cap V }
755 emacspeak-dtk-speak-version
756 - Use this to find out which version of the TTS firmware you are running.
757 +Use this to find out which version of the TTS firmware you are running.
760 @findex emacspeak-zap-dtk
761 - @kindex control e d z
763 +@kindex control e d z
765 @item @kbd{ control e d z }
767 - Send this command to the TTS engine directly.
768 +Send this command to the TTS engine directly.
771 --- emacspeak-24.orig/info/emacspeak.texi
772 +++ emacspeak-24/info/emacspeak.texi
775 @include preamble.texi
776 @include copyright.texi
777 -@include announce.texi
778 +@include announce.texi
779 @include introduction.texi
780 @include install.texi
782 --- emacspeak-24.orig/servers/tts-lib.tcl
783 +++ emacspeak-24/servers/tts-lib.tcl
789 --- emacspeak-24.orig/etc/Makefile
790 +++ emacspeak-24/etc/Makefile
792 # {{{ User level target-- config
795 - @sed "s@<emacspeak-dir>@$(SRC)/lisp@g" \
796 + @sed -e "s@<emacspeak-dir>@/usr/share/$(FLAVOR)/site-lisp/emacspeak/lisp@g" \
797 + -e 's/exec emacs/exec $(FLAVOR)/' \
798 emacspeak.sh.def > emacspeak.sh
799 @chmod 755 emacspeak.sh
801 --- emacspeak-24.orig/debian/README.Debian
802 +++ emacspeak-24/debian/README.Debian
804 +emacspeak for DEBIAN
805 +----------------------
807 +Emacspeak is authored by T. V. Raman <raman@cs.cornell.edu>. These
808 +are the primary changes made in building the Debian package: html and
809 +plain text versions of the documentation were added. A configuration
810 +script (/usr/sbin/emacspeakconfig) and associated speech server
811 +descriptions (/usr/share/emacs/site-lisp/emacspeak/blurbs/*) were
812 +added. Manual pages for emacspeak and the configuration script were
813 +added. Minor changes are listed in changelog.Debian.
815 +The user is expected to start emacspeak with /usr/bin/emacspeak, which
816 +gets configuration parameters from /etc/emacspeak.conf and starts
817 +emacs with emacspeak support.
819 +Several "flavors" of emacs may be installed at the same time (emacs20,
820 +emacs21, xemacs21, etc.). In accordance with the Debian emacs policy,
821 +emacspeak is byte-compiled separately for each supported flavor -
822 +currently only emacs21. There is a separate script to start each
823 +flavor of emacs with emacspeak support - for example,
824 +/usr/bin/emacspeak.emacs21. /usr/bin/emacspeak is actually a symlink
825 +managed by the "alternatives" mechanism. That is, it points to
826 +/etc/alternatives/emacspeak, which points to one of several links like
827 +/usr/bin/emacspeak.emacs21. (See the manpage for
828 +update-alternatives.)
830 +The alternatives for emacspeak inherit their priorities from the
831 +corresponding emacs packages. So, as long as the emacs and emacspeak
832 +alternatives are in "automatic" mode, both "emacs" and "emacspeak"
833 +will start emacs21. If someday an emacs22 package is installed, with
834 +priority higher than for emacs 21, then by default both "emacs" and
835 +"emacspeak" will start emacs22.
837 +The administrator can use update-alternatives to change which flavor
838 +is started by either /usr/bin/emacs or /usr/bin/emacspeak. Or, of
839 +course, any user can use one of the flavor-specific links like
840 +/usr/bin/emacspeak.emacs21 to start whichever flavor he wants.
842 +Starting with version 11.0, the Emacspeak sources include a speech
843 +server written in C++ for the IBM ViaVoice speech synthesis software.
844 +However, it depends on the ViaVoice runtime kit which does not meet
845 +the Debian Free Software Guidelines. (It is available only as object
846 +code, and only under a temporary license.) Therefore, support for
847 +ViaVoice is not included in this Debian package. If you would like to
848 +try it, you can find some information in
849 +/usr/share/docs/emacspeak/VIAVOICE.
851 +Starting with version 10.0, Dr. Raman has rewritten the documentation
852 +files. Approximately 100 commands are described there, compared to
853 +over 800 in the documentation shipped with the previous release.
854 +Therefore, the user should pay particular attention to the section
855 +"Using Online Help".
857 +Many command-line applications can be run under emacs, and can
858 +therefore be made accessible with emacspeak. Much of this is
859 +explained in the documentation entitled "Running Terminal Based
860 +Applications". However, it is worth emphasizing this point: "For
861 +regular shell interaction just use M-x shell instead of using the
864 +The example file "tables.html" was supplied by Dr. Raman in a separate
865 +email. It may be found in /usr/doc/emacspeak/examples. It includes a
866 +sample table with three columns (labeled "item", "date", and
867 +"amount"), and three rows. For a discussion of the support for tables
868 +in emacspeak and w3, see NEWS (or NEWS.gz) in /usr/doc/emacspeak.
870 +The Emacspeak-HOWTO contains additional documentation. The plain text
871 +form of this can be found in the Debian package doc-linux, and is
872 +installed as /usr/doc/HOWTO/Emacspeak-HOWTO.gz. Other formats are
873 +also available. For example, these can be found at sunsite.unc.edu:
875 + /pub/Linux/docs/HOWTO/other-formats/dvi/Emacspeak-HOWTO.dvi.gz
876 + /pub/Linux/docs/HOWTO/other-formats/html/Emacspeak-HOWTO-html.tar.gz
877 + /pub/Linux/docs/HOWTO/other-formats/ps/Emacspeak-HOWTO.ps.gz
878 + /pub/Linux/docs/HOWTO/other-formats/sgml/Emacspeak-HOWTO.sgml.gz
880 +There is also an Emacspeak mailing list. To subscribe, send a message
883 + emacspeak-request@cs.vassar.edu
889 +James R. Van Zandt <jrv@debian.org>, Mon Jan 30 21:36:59 EST 2006
891 --- emacspeak-24.orig/debian/DOC
892 +++ emacspeak-24/debian/DOC
894 +DOC --- Automatically generated by command emacspeak-generate-documentation
896 +------------------------------------------------------------
898 +** dtk-add-cleanup-pattern Key Sequence: control e d a
900 +Add this pattern to the list of repeating patterns that
901 +are cleaned up. Optional interactive prefix arg deletes
902 +this pattern if previously added. Cleaning up repeated
903 +patterns results in emacspeak speaking the pattern followed
904 +by a repeat count instead of speaking all the characters
905 +making up the pattern. Thus, by adding the repeating
906 +pattern `.' (this is already added by default) emacspeak
907 +will say ``aw fifteen dot'' when speaking the string
908 +``...............'' instead of ``period period period period
911 +------------------------------------------------------------
913 +** dtk-notes-shutdown
915 +Shutdown midi system.
917 +------------------------------------------------------------
919 +** dtk-pause Key Sequence: control e p
921 +Pause ongoing speech.
922 +The speech can be resumed with command `dtk-resume'
923 +normally bound to C-e SPC. Pausing speech is useful when one needs to
924 +perform a few actions before continuing to read a large document. Emacspeak
925 +gives you speech feedback as usual once speech has been paused. `dtk-resume'
926 +continues the interrupted speech irrespective of the buffer
927 +in which it is executed.
928 +Optional PREFIX arg flushes any previously paused speech.
930 +------------------------------------------------------------
932 +** dtk-reset-state Key Sequence: control e d cap R
934 +Restore sanity to the Dectalk.
935 +Typically used after the Dectalk has been power cycled.
937 +------------------------------------------------------------
939 +** dtk-resume Key Sequence: control e SPACE
941 +Resume paused speech.
942 +This command resumes speech that has been suspended by executing
943 +command `dtk-pause' bound to C-e p.
944 +If speech has not been paused,
945 +and variable `dtk-resume-should-toggle' is t
946 + then this command will pause ongoing speech.
948 +------------------------------------------------------------
950 +** dtk-select-server Key Sequence: control e d d
952 +Select a speech server interactively.
953 +Argument PROGRAM specifies the speech server program.
954 +When called interactively, The selected server is started immediately.
956 +------------------------------------------------------------
958 +** dtk-set-character-scale Key Sequence: control e d f
960 +Set scale FACTOR for speech rate.
961 +Speech rate is scaled by this factor
962 +when speaking characters.
963 +Interactive PREFIX arg means set the global default value, and then set the
964 +current local value to the result.
966 +------------------------------------------------------------
968 +** dtk-set-chunk-separator-syntax Key Sequence: control e d RETURN
970 +Interactively set how text is split in chunks.
971 +See the Emacs documentation on syntax tables for details on how characters are
972 +classified into various syntactic classes.
973 +Argument S specifies the syntax class.
975 +------------------------------------------------------------
977 +** 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
979 +Set speech rate to one of nine predefined levels.
980 +Interactive PREFIX arg says to set the rate globally.
982 +rate = dtk-speech-rate-base + dtk-speech-rate-step * level.
984 +------------------------------------------------------------
986 +** dtk-set-punctuations Key Sequence: control e d p
988 +Set punctuation mode to MODE.
989 +Possible values are `some', `all', or `none'.
990 +Interactive PREFIX arg means set the global default value, and then set the
991 +current local value to the result.
993 +------------------------------------------------------------
995 +** dtk-set-punctuations-to-all
997 +Set punctuation mode to all.
998 +Interactive PREFIX arg sets punctuation mode globally.
1000 +------------------------------------------------------------
1002 +** dtk-set-punctuations-to-some
1004 +Set punctuation mode to some.
1005 +Interactive PREFIX arg sets punctuation mode globally.
1007 +------------------------------------------------------------
1009 +** dtk-set-rate Key Sequence: control e d r
1011 +Set speaking RATE for the tts.
1012 +Interactive PREFIX arg means set the global default value, and then set the
1013 +current local value to the result.
1015 +------------------------------------------------------------
1017 +** dtk-stop Key Sequence: <pause> control e s
1021 +------------------------------------------------------------
1023 +** dtk-toggle-allcaps-beep Key Sequence: control e d cap C
1025 +Toggle allcaps-beep.
1026 +when set, allcaps words are indicated by a
1027 +short beep. Interactive PREFIX arg means toggle the global default
1028 +value, and then set the current local value to the result.
1029 +Note that allcaps-beep is a very useful thing when programming.
1030 +However it is irritating to have it on when reading documents.
1032 +------------------------------------------------------------
1034 +** dtk-toggle-capitalization Key Sequence: control e d c
1036 +Toggle capitalization.
1037 +when set, capitalization is indicated by a
1038 +short beep. Interactive PREFIX arg means toggle the global default
1039 +value, and then set the current local value to the result.
1041 +------------------------------------------------------------
1043 +** dtk-toggle-debug Key Sequence: control e d b
1045 +Toggle state of the debug FLAG.
1046 +When debugging is on, you can switch to the buffer
1047 +*speaker* to examine the output from the process
1048 +that talks to the speech device by using command C-e d C-M-b.
1049 +Note: *speaker* is a hidden buffer, ie it has a leading space in its name.
1051 +------------------------------------------------------------
1053 +** dtk-toggle-punctuation-mode
1055 +Toggle punctuation mode between "some" and "all".
1056 +Interactive PREFIX arg makes the new setting global.
1058 +------------------------------------------------------------
1060 +** dtk-toggle-quiet Key Sequence: control e d q
1062 +Toggles state of dtk-quiet.
1063 +Turning on this switch silences speech.
1064 +Optional interactive prefix arg causes this setting to become global.
1066 +------------------------------------------------------------
1068 +** dtk-toggle-speak-nonprinting-chars Key Sequence: control e d n
1070 +Toggle speak-nonprinting-chars.
1071 +Switches behavior of how characters with the high bit set are handled.
1072 +Interactive PREFIX arg means toggle the global default
1073 +value, and then set the current local value to the result.
1075 +------------------------------------------------------------
1077 +** dtk-toggle-split-caps Key Sequence: control e d s
1079 +Toggle split caps mode.
1080 +Split caps mode is useful when reading
1081 +Hungarian notation in program source code. Interactive PREFIX arg
1082 +means toggle the global default value, and then set the current local
1083 +value to the result.
1085 +------------------------------------------------------------
1087 +** dtk-toggle-splitting-on-white-space Key Sequence: control e d SPACE
1089 +Toggle splitting of speech on white space.
1090 +This affects the internal state of emacspeak that decides if we split
1091 +text purely by clause boundaries, or also include
1092 +whitespace. By default, emacspeak sends a clause at a time
1093 +to the speech device. This produces fluent speech for
1094 +normal use. However in modes such as `shell-mode' and some
1095 +programming language modes, clause markers appear
1096 +infrequently, and this can result in large amounts of text
1097 +being sent to the speech device at once, making the system
1098 +unresponsive when asked to stop talking. Splitting on white
1099 +space makes emacspeak's stop command responsive. However,
1100 +when splitting on white space, the speech sounds choppy
1101 +since the synthesizer is getting a word at a time.
1103 +------------------------------------------------------------
1105 +** dtk-toggle-stop-immediately-while-typing Key Sequence: control e d cap I
1107 +Toggle state of variable `dtk-stop-immediately-while-typing'.
1108 +As the name implies, if T then speech flushes immediately as you
1109 +type. Optional argument PREFIX specifies if the setting applies
1112 +------------------------------------------------------------
1114 +** emacspeak-describe-emacspeak Key Sequence: control h control e
1116 +Give a brief overview of emacspeak.
1118 +------------------------------------------------------------
1120 +** emacspeak-submit-bug Key Sequence: control e CONTROL meta b
1122 +Function to submit a bug to the programs maintainer.
1124 +------------------------------------------------------------
1126 +** emacspeak-aumix Key Sequence: control e (
1128 +Setup output parameters of the auditory display.
1129 + Launch this tool while you have auditory output on
1130 +multiple channels playing so you can
1131 +adjust the settings to your preference. Hit q to quit when
1134 +------------------------------------------------------------
1136 +** emacspeak-aumix-edit
1138 +Edit aumix settings interactively.
1139 +Run command M-x emacspeak-aumix-reset
1140 +after saving the settings to have them take effect.
1142 +------------------------------------------------------------
1144 +** emacspeak-aumix-reset
1146 +Reset to default audio settings.
1148 +------------------------------------------------------------
1150 +** emacspeak-aumix-volume-decrease
1152 +Decrease overall volume.
1154 +------------------------------------------------------------
1156 +** emacspeak-aumix-volume-increase
1158 +Increase overall volume.
1160 +------------------------------------------------------------
1162 +** emacspeak-aumix-wave-decrease
1164 +Decrease volume of wave output.
1166 +------------------------------------------------------------
1168 +** emacspeak-aumix-wave-increase
1170 +Increase volume of wave output.
1172 +------------------------------------------------------------
1174 +** emacspeak-list-buffers-next-line
1176 +Speech enabled buffer menu navigation
1178 +------------------------------------------------------------
1180 +** emacspeak-list-buffers-previous-line
1182 +Speech enabled buffer menu navigation
1184 +------------------------------------------------------------
1186 +** emacspeak-list-buffers-speak-buffer-line
1188 +Speak information about this buffer
1190 +------------------------------------------------------------
1192 +** emacspeak-list-buffers-speak-buffer-name
1194 +Speak the name of the buffer on this line
1196 +------------------------------------------------------------
1198 +** emacspeak-compilation-speak-error
1200 +Speech feedback about the compilation error.
1202 +------------------------------------------------------------
1204 +** emacspeak-custom-goto-group
1206 +Jump to custom group when in a customization buffer.
1208 +------------------------------------------------------------
1210 +** emacspeak-custom-goto-toolbar
1212 +Jump to custom toolbar when in a customization buffer.
1214 +------------------------------------------------------------
1216 +** emacspeak-dired-label-fields
1218 +Labels the fields of the listing in the dired buffer.
1219 +Currently is a no-op unless
1220 +unless `dired-listing-switches' contains -al
1222 +------------------------------------------------------------
1224 +** emacspeak-dired-show-file-type
1226 +Displays type of current file by running command file.
1227 +Like Emacs' built-in dired-show-file-type but allows user to customize
1228 +options passed to command `file'.
1230 +------------------------------------------------------------
1232 +** emacspeak-dired-speak-file-access-time
1234 +Speak access time of the current file.
1236 +------------------------------------------------------------
1238 +** emacspeak-dired-speak-file-modification-time
1240 +Speak modification time of the current file.
1242 +------------------------------------------------------------
1244 +** emacspeak-dired-speak-file-permissions
1246 +Speak the permissions of the current file.
1248 +------------------------------------------------------------
1250 +** emacspeak-dired-speak-file-size
1252 +Speak the size of the current file.
1253 +On a directory line, run du -s on the directory to speak its size.
1255 +------------------------------------------------------------
1257 +** emacspeak-dired-speak-header-line
1259 +Speak the header line of the dired buffer.
1261 +------------------------------------------------------------
1263 +** emacspeak-dired-speak-symlink-target
1265 +Speaks the target of the symlink on the current line.
1267 +------------------------------------------------------------
1269 +** emacspeak-eterm-copy-region-to-register
1271 +Copy text from terminal to an Emacs REGISTER.
1272 +This copies region delimited by the emacspeak eterm marker
1273 +set by command M-x emacspeak-eterm-set-marker and the
1274 +emacspeak eterm pointer to a register.
1276 +------------------------------------------------------------
1278 +** emacspeak-eterm-define-window
1280 +Prompt for a window ID.
1281 +The window is then define to be
1282 +the rectangle delimited by point and eterm mark. This is to
1283 +be used when emacspeak is set to review mode inside an
1286 +------------------------------------------------------------
1288 +** emacspeak-eterm-describe-window
1290 +Describe an eterm window.
1291 +Description indicates eterm window coordinates and whether it is stretchable
1293 +------------------------------------------------------------
1295 +** emacspeak-eterm-goto-line
1297 +Move emacspeak eterm pointer to a specified LINE.
1299 +------------------------------------------------------------
1301 +** emacspeak-eterm-kill-ring-save-region
1303 +Copy text from terminal to kill ring.
1304 +This copies region delimited by the emacspeak eterm marker
1305 +set by command M-x emacspeak-eterm-set-marker and the
1306 +emacspeak eterm pointer.
1308 +------------------------------------------------------------
1310 +** emacspeak-eterm-maybe-send-raw
1312 +Send a raw character through if in the terminal buffer.
1313 +Execute end of line if
1314 +in a non eterm buffer if executed via C-e C-e
1316 +------------------------------------------------------------
1318 +** emacspeak-eterm-paste-register
1320 +Paste contents of REGISTER at current location.
1321 +If the specified register contains text, then that text is
1322 +sent to the terminal as if it were typed by the user.
1324 +------------------------------------------------------------
1326 +** emacspeak-eterm-pointer-backward-word
1328 +Move the pointer backward by words.
1329 +Interactive numeric prefix arg specifies number of words to move.
1330 +Argument COUNT specifies number of words by which to move.
1332 +------------------------------------------------------------
1334 +** emacspeak-eterm-pointer-down
1336 +Move the pointer down a line.
1337 +Argument COUNT specifies number of lines by which to move.
1339 +------------------------------------------------------------
1341 +** emacspeak-eterm-pointer-forward-word
1343 +Move the pointer forward by words.
1344 +Interactive numeric prefix arg specifies number of words to move.
1345 +Argument COUNT specifies number of words by which to move.
1347 +------------------------------------------------------------
1349 +** emacspeak-eterm-pointer-left
1351 +Move the pointer left.
1352 +Argument COUNT specifies number of columns by which to move.
1354 +------------------------------------------------------------
1356 +** emacspeak-eterm-pointer-right
1358 +Move the pointer right.
1359 +Argument COUNT specifies number of columns by which to move.
1361 +------------------------------------------------------------
1363 +** emacspeak-eterm-pointer-to-bottom
1365 +Move the pointer to the bottom of the screen.
1367 +------------------------------------------------------------
1369 +** emacspeak-eterm-pointer-to-cursor
1371 +Move the pointer to the cursor.
1373 +------------------------------------------------------------
1375 +** emacspeak-eterm-pointer-to-left-edge
1377 +Move the pointer to the right edge.
1379 +------------------------------------------------------------
1381 +** emacspeak-eterm-pointer-to-next-color-change
1383 +Move the eterm pointer to the next color change.
1384 +This allows you to move between highlighted regions of the screen.
1385 +Optional argument COUNT specifies how many changes to skip.
1387 +------------------------------------------------------------
1389 +** emacspeak-eterm-pointer-to-previous-color-change
1391 +Move the eterm pointer to the next color change.
1392 +This allows you to move between highlighted regions of the screen.
1393 +Optional argument COUNT specifies how many changes to skip.
1395 +------------------------------------------------------------
1397 +** emacspeak-eterm-pointer-to-right-edge
1399 +Move the pointer to the right edge.
1401 +------------------------------------------------------------
1403 +** emacspeak-eterm-pointer-to-top
1405 +Move the pointer to the top of the screen.
1407 +------------------------------------------------------------
1409 +** emacspeak-eterm-pointer-up
1411 +Move the pointer up a line.
1412 +Argument COUNT .specifies number of lines by which to move.
1414 +------------------------------------------------------------
1416 +** emacspeak-eterm-remote-term Key Sequence: control e CONTROL meta r
1418 +Start a terminal-emulator in a new buffer.
1420 +------------------------------------------------------------
1422 +** emacspeak-eterm-search-backward
1424 +Search backward on the terminal.
1426 +------------------------------------------------------------
1428 +** emacspeak-eterm-search-forward
1430 +Search forward on the terminal.
1432 +------------------------------------------------------------
1434 +** emacspeak-eterm-set-filter-window
1436 +Prompt for the id of a predefined window,
1437 +and set the `filter' window to it.
1438 +Non-nil interactive prefix arg `unsets' the filter window;
1439 +this is equivalent to having the entire terminal as the filter window (this is
1440 +what eterm starts up with).
1441 +Setting the filter window results in emacspeak only monitoring screen
1442 +activity within the filter window.
1444 +------------------------------------------------------------
1446 +** emacspeak-eterm-set-focus-window
1448 +Prompt for the id of a predefined window,
1449 +and set the `focus' window to it.
1450 +Non-nil interactive prefix arg `unsets' the focus window;
1451 +this is equivalent to having the entire terminal as the focus window (this is
1452 +what eterm starts up with).
1453 +Setting the focus window results in emacspeak monitoring screen
1454 +and speaking that window upon seeing screen activity.
1456 +------------------------------------------------------------
1458 +** emacspeak-eterm-set-marker
1460 +Set Emacspeak eterm marker.
1461 +This sets the emacspeak eterm marker to the position pointed
1462 +to by the emacspeak eterm pointer.
1464 +------------------------------------------------------------
1466 +** emacspeak-eterm-speak-cursor
1468 +Speak cursor position.
1470 +------------------------------------------------------------
1472 +** emacspeak-eterm-speak-pointer
1474 +Speak current pointer position.
1476 +------------------------------------------------------------
1478 +** emacspeak-eterm-speak-pointer-char
1480 +Speak char under eterm pointer.
1481 +Pronounces character phonetically unless called with a PREFIX arg.
1483 +------------------------------------------------------------
1485 +** emacspeak-eterm-speak-pointer-line
1487 +Speak the line the pointer is on.
1489 +------------------------------------------------------------
1491 +** emacspeak-eterm-speak-pointer-word
1493 +Speak the word the pointer is on.
1495 +------------------------------------------------------------
1497 +** emacspeak-eterm-speak-predefined-window
1499 +Speak a predefined eterm window between 1 and 10.
1501 +------------------------------------------------------------
1503 +** emacspeak-eterm-speak-screen
1505 +Speak the screen. Default is to speak from the emacspeak pointer to point.
1506 +Optional prefix arg FLAG causes region above
1507 +the Emacspeak pointer to be spoken.
1509 +------------------------------------------------------------
1511 +** emacspeak-eterm-speak-window
1513 +Speak an eterm window.
1514 +Argument ID specifies the window.
1516 +------------------------------------------------------------
1518 +** emacspeak-eterm-toggle-filter-window
1520 +Toggle active state of filter window.
1522 +------------------------------------------------------------
1524 +** emacspeak-eterm-toggle-focus-window
1526 +Toggle active state of focus window.
1528 +------------------------------------------------------------
1530 +** emacspeak-eterm-toggle-pointer-mode
1532 +Toggle emacspeak eterm pointer mode.
1533 +With optional interactive prefix arg, turn it on.
1534 +When emacspeak eterm is in pointer mode, the eterm read pointer
1535 +stays where it is rather than automatically moving to the terminal cursor when
1536 +there is terminal activity.
1538 +------------------------------------------------------------
1540 +** emacspeak-eterm-toggle-review
1542 +Toggle state of eterm review.
1543 +In review mode, you can move around the terminal and listen to the contnets
1544 +without sending input to the terminal itself.
1546 +------------------------------------------------------------
1548 +** emacspeak-eterm-yank-window
1550 +Yank contents of an eterm window at point.
1552 +------------------------------------------------------------
1554 +** emacspeak-toggle-eterm-autospeak
1556 +Toggle state of eterm autospeak.
1557 +When eterm autospeak is turned on and the terminal is in line mode,
1558 +all output to the terminal is automatically spoken.
1559 + Interactive prefix arg means toggle the global default value, and then set the
1560 + current local value to the result.
1562 +------------------------------------------------------------
1564 +** emacspeak-fix-all-recent-commands
1566 +Fix recently loaded interactive commands.
1567 +This command looks through `load-history' and fixes commands if necessary.
1568 +Memoizes call in emacspeak-load-history-pointer to memoize this call.
1570 +------------------------------------------------------------
1572 +** emacspeak-fix-commands-loaded-from
1574 +Fix all commands loaded from a specified module.
1576 +------------------------------------------------------------
1578 +** emacspeak-forms-find-file
1582 +------------------------------------------------------------
1584 +** emacspeak-forms-flush-unwanted-records
1586 +Prompt for pattern and flush matching lines
1588 +------------------------------------------------------------
1590 +** emacspeak-forms-rerun-filter
1592 +Rerun filter --allows us to nuke more matching records
1594 +------------------------------------------------------------
1596 +** emacspeak-forms-speak-field
1598 +Speak current form field name and value.
1599 +Assumes that point is at the front of a field value.
1601 +------------------------------------------------------------
1603 +** emacspeak-forms-summarize-current-position
1605 +Summarize current position in list of records
1607 +------------------------------------------------------------
1609 +** emacspeak-forms-summarize-current-record
1611 +Summarize current record
1613 +------------------------------------------------------------
1615 +** emacspeak-keymap-choose-new-emacspeak-prefix
1617 +Interactively select a new prefix key to use for all emacspeak
1618 +commands. The default is to use `C-e' This command
1619 +lets you switch the prefix to something else. This is a useful thing
1620 +to do if you run emacspeak on a remote machine from inside a terminal
1621 +that is running inside a local emacspeak session. You can have the
1622 +remote emacspeak use a different control key to give your fingers some
1625 +------------------------------------------------------------
1627 +** emacspeak-toggle-comint-output-monitor Key Sequence: control e o
1629 +Toggle state of Emacspeak comint monitor.
1630 +When turned on, comint output is automatically spoken. Turn this on if
1631 +you want your shell to speak its results. Interactive
1632 +PREFIX arg means toggle the global default value, and then
1633 +set the current local value to the result.
1635 +------------------------------------------------------------
1637 +** emacspeak-pronounce-clear-dictionaries
1639 +Clear all current pronunciation dictionaries.
1641 +------------------------------------------------------------
1643 +** emacspeak-pronounce-define-local-pronunciation
1645 +Define buffer local pronunciation.
1646 +Argument WORD specifies the word which should be pronounced as specified by PRONUNCIATION.
1648 +------------------------------------------------------------
1650 +** emacspeak-pronounce-define-pronunciation
1652 +Interactively define entries in the pronunciation dictionaries.
1653 +Default term to define is delimited by region.
1654 +First loads any persistent dictionaries if not already loaded.
1656 +------------------------------------------------------------
1658 +** emacspeak-pronounce-define-template-pronunciation
1660 +Interactively define template entries in the pronunciation dictionaries.
1661 +Default term to define is delimited by region.
1662 +First loads any persistent dictionaries if not already loaded.
1664 +------------------------------------------------------------
1666 +** emacspeak-pronounce-dispatch Key Sequence: control e meta d
1668 +Provides the user interface front-end to Emacspeak's pronunciation dictionaries.
1670 +------------------------------------------------------------
1672 +** emacspeak-pronounce-edit-pronunciations
1674 +Prompt for and launch a pronunciation editor on the
1675 +specified pronunciation dictionary key.
1677 +------------------------------------------------------------
1679 +** emacspeak-pronounce-load-dictionaries
1681 +Load pronunciation dictionaries.
1682 +Optional argument FILENAME specifies the dictionary file.
1684 +------------------------------------------------------------
1686 +** emacspeak-pronounce-refresh-pronunciations
1688 +Refresh pronunciation table for current buffer.
1689 +Activates pronunciation dictionaries if not already active.
1691 +------------------------------------------------------------
1693 +** emacspeak-pronounce-save-dictionaries
1695 +Writes out the persistent emacspeak pronunciation dictionaries.
1697 +------------------------------------------------------------
1699 +** emacspeak-pronounce-toggle-use-of-dictionaries
1701 +Toggle use of pronunciation dictionaries in current buffer.
1702 +Pronunciations can be defined on a per file, per directory and/or per
1704 +Pronunciations are activated on a per buffer basis.
1705 +Turning on the use of pronunciation dictionaries results in emacspeak
1706 +composing a pronunciation table based on the currently defined
1707 +pronunciation dictionaries.
1708 +After this, the pronunciations will be applied whenever text in the
1710 +Optional argument state can be used from Lisp programs to
1711 +explicitly turn pronunciations on or off.
1713 +------------------------------------------------------------
1715 +** emacspeak-pronounce-yank-word
1717 +Yank word at point into minibuffer.
1719 +------------------------------------------------------------
1721 +** emacspeak-backward-char Key Sequence: control b <left>
1723 +Backward-char redefined to speak char moved to.
1725 +------------------------------------------------------------
1727 +** emacspeak-forward-char Key Sequence: control f <right>
1729 +Forward-char redefined to speak char moved to.
1731 +------------------------------------------------------------
1733 +** 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
1735 +Insert a character.
1736 +Speaks the character if emacspeak-character-echo is true.
1737 +See command emacspeak-toggle-word-echo bound to
1739 +Toggle variable dtk-stop-immediately-while-typing if you want to have
1740 +speech flush as you type.
1742 +------------------------------------------------------------
1744 +** emacspeak-rmail-speak-current-message-labels
1746 +Speak labels of current message
1748 +------------------------------------------------------------
1750 +** emacspeak-rmail-summarize-current-message
1752 +Summarize current message
1754 +------------------------------------------------------------
1756 +** emacspeak-play-all-icons
1758 +Plays all defined icons and speaks their names.
1760 +------------------------------------------------------------
1762 +** emacspeak-set-auditory-icon-player Key Sequence: control e meta a
1764 +Select player used for producing auditory icons.
1765 +Recommended choices:
1767 +emacspeak-serve-auditory-icon for the wave device.
1768 +emacspeak-queue-auditory-icon when using software TTS.
1769 +emacspeak-play-midi-icon for midi device.
1771 +------------------------------------------------------------
1773 +** emacspeak-sounds-reset-local-player
1775 +Ask Emacspeak to use a local audio player.
1776 +This lets me have Emacspeak switch to using audioplay on
1777 +solaris after I've used it for a while from a remote session
1778 +where it would use the more primitive speech-server based
1781 +------------------------------------------------------------
1783 +** emacspeak-sounds-reset-sound
1785 +Reload sound drivers.
1787 +------------------------------------------------------------
1789 +** emacspeak-sounds-select-theme Key Sequence: control e )
1791 +Select theme for auditory icons.
1793 +------------------------------------------------------------
1795 +** emacspeak-toggle-auditory-icons Key Sequence: control e control a
1797 +Toggle use of auditory icons.
1798 +Optional interactive PREFIX arg toggles global value.
1800 +------------------------------------------------------------
1802 +** emacspeak-audio-annotate-paragraphs
1804 +Set property auditory-icon at front of all paragraphs.
1806 +------------------------------------------------------------
1808 +** emacspeak-blink-matching-open
1810 +Display matching delimiter in the minibuffer.
1812 +------------------------------------------------------------
1814 +** emacspeak-completions-move-to-completion-group
1816 +Move to group of choices beginning with character last
1817 +typed. If no such group exists, then we dont move.
1819 +------------------------------------------------------------
1821 +** emacspeak-dial-dtk Key Sequence: control e d t
1823 +Prompt for and dial a phone NUMBER with the Dectalk.
1825 +------------------------------------------------------------
1827 +** emacspeak-execute-repeatedly
1829 +Execute COMMAND repeatedly.
1831 +------------------------------------------------------------
1833 +** emacspeak-mark-backward-mark Key Sequence: <control up>
1835 +Cycle backward through the mark ring.
1837 +------------------------------------------------------------
1839 +** emacspeak-mark-forward-mark Key Sequence: <control down>
1841 +Cycle forward through the mark ring.
1843 +------------------------------------------------------------
1845 +** emacspeak-owindow-next-line Key Sequence: ESCAPE <down>
1847 +Move to the next line in the other window and speak it.
1848 +Numeric prefix arg COUNT can specify number of lines to move.
1850 +------------------------------------------------------------
1852 +** emacspeak-owindow-previous-line Key Sequence: ESCAPE <up>
1854 +Move to the next line in the other window and speak it.
1855 +Numeric prefix arg COUNT specifies number of lines to move.
1857 +------------------------------------------------------------
1859 +** emacspeak-owindow-scroll-down Key Sequence: ESCAPE <prior>
1861 +Scroll down the window that command `other-window' would move to.
1862 +Speak the window contents after scrolling.
1864 +------------------------------------------------------------
1866 +** emacspeak-owindow-scroll-up Key Sequence: ESCAPE <next>
1868 +Scroll up the window that command `other-window' would move to.
1869 +Speak the window contents after scrolling.
1871 +------------------------------------------------------------
1873 +** emacspeak-owindow-speak-line Key Sequence: ESCAPE <select>
1875 +Speak the current line in the other window.
1877 +------------------------------------------------------------
1879 +** emacspeak-read-next-line Key Sequence: control e <down>
1881 +Read next line, specified by an offset, without moving.
1882 +Default is to read the next line.
1884 +------------------------------------------------------------
1886 +** emacspeak-read-next-word
1888 +Read next word, specified as a numeric arg, without moving.
1889 +Default is to read the next word.
1891 +------------------------------------------------------------
1893 +** emacspeak-read-previous-line Key Sequence: control e <up>
1895 +Read previous line, specified by an offset, without moving.
1896 +Default is to read the previous line.
1898 +------------------------------------------------------------
1900 +** emacspeak-read-previous-word
1902 +Read previous word, specified as a prefix arg, without moving.
1903 +Default is to read the previous word.
1905 +------------------------------------------------------------
1907 +** emacspeak-speak-and-skip-extent-upto-char
1909 +Search forward from point until we hit char.
1910 +Speak text between point and the char we hit.
1912 +------------------------------------------------------------
1914 +** emacspeak-speak-and-skip-extent-upto-this-char
1916 +Speak extent delimited by point and last character typed.
1918 +------------------------------------------------------------
1920 +** emacspeak-speak-browse-buffer Key Sequence: control e ,
1922 +Browse current buffer.
1923 +Default is to speak chunk having current personality.
1924 +Interactive prefix arg `browse' repeatedly browses through
1925 + chunks having same personality as the current text chunk.
1927 +------------------------------------------------------------
1929 +** emacspeak-speak-buffer Key Sequence: control e b
1931 +Speak current buffer contents.
1932 +With prefix ARG, speaks the rest of the buffer from point.
1933 +Negative prefix arg speaks from start of buffer to point.
1934 + If voice lock mode is on, the paragraphs in the buffer are
1935 +voice annotated first, see command `emacspeak-speak-voice-annotate-paragraphs'.
1937 +------------------------------------------------------------
1939 +** emacspeak-speak-buffer-filename Key Sequence: control e f
1941 +Speak name of file being visited in current buffer.
1942 +Speak default directory if invoked in a dired buffer,
1943 +or when the buffer is not visiting any file.
1944 +Interactive prefix arg `filename' speaks only the final path
1946 +The result is put in the kill ring for convenience.
1948 +------------------------------------------------------------
1950 +** emacspeak-speak-buffer-interactively Key Sequence: control e cap B
1952 +Speak the start of, rest of, or the entire buffer.
1953 +'s' to speak the start.
1954 +'r' to speak the rest.
1955 +any other key to speak entire buffer.
1957 +------------------------------------------------------------
1959 +** emacspeak-speak-char Key Sequence: control e c
1961 +Speak character under point.
1962 +Pronounces character phonetically unless called with a PREFIX arg.
1964 +------------------------------------------------------------
1966 +** emacspeak-speak-comint-send-input
1968 +Causes output to be spoken i.e., as if comint autospeak were turned
1971 +------------------------------------------------------------
1973 +** emacspeak-speak-completions
1975 +Speak completions buffer if one present.
1977 +------------------------------------------------------------
1979 +** emacspeak-speak-continuously Key Sequence: control e RETURN
1981 +Speak a buffer continuously.
1982 +First prompts using the minibuffer for the kind of action to
1983 +perform after speaking each chunk. E.G. speak a line at a time
1984 +etc. Speaking commences at current buffer position. Pressing
1985 +C-g breaks out, leaving point on last chunk that
1986 +was spoken. Any other key continues to speak the buffer.
1988 +------------------------------------------------------------
1990 +** emacspeak-speak-current-column Key Sequence: control e =
1992 +Speak the current column.
1994 +------------------------------------------------------------
1996 +** emacspeak-speak-current-kill Key Sequence: control e k
1998 +Speak the current kill entry.
1999 +This is the text that will be yanked in by the next C-y.
2000 +Prefix numeric arg, COUNT, specifies that the text that will be yanked as a
2002 +C-y followed by count-1 M-y
2004 + The kill number that is spoken says what numeric prefix arg to give
2007 +------------------------------------------------------------
2009 +** emacspeak-speak-current-mark Key Sequence: control e control @
2011 +Speak the line containing the mark.
2012 +With no argument, speaks the
2013 +line containing the mark--this is where `exchange-point-and-mark'
2014 +C-x C-x would jump. Numeric prefix arg 'COUNT' speaks
2015 +line containing mark 'n' where 'n' is one less than the number of
2016 +times one has to jump using `set-mark-command' to get to this marked
2017 +position. The location of the mark is indicated by an aural highlight
2018 +achieved by a change in voice personality.
2020 +------------------------------------------------------------
2022 +** emacspeak-speak-current-percentage Key Sequence: control e %
2024 +Announce the percentage into the current buffer.
2026 +------------------------------------------------------------
2028 +** emacspeak-speak-current-window
2030 +Speak contents of current window.
2031 +Speaks entire window irrespective of point.
2033 +------------------------------------------------------------
2035 +** emacspeak-speak-display-char
2037 +Display char under point using current speech display table.
2038 +Behavior is the same as command `emacspeak-speak-char'
2040 +for characters in the range 0--127.
2041 +Optional argument PREFIX specifies that the character should be spoken phonetically.
2043 +------------------------------------------------------------
2045 +** emacspeak-speak-front-of-buffer
2047 +Speak the buffer from start to point
2049 +------------------------------------------------------------
2051 +** emacspeak-speak-help Key Sequence: control e h
2053 +Speak help buffer if one present.
2054 +With prefix arg, speaks the rest of the buffer from point.
2055 +Negative prefix arg speaks from start of buffer to point.
2057 +------------------------------------------------------------
2059 +** emacspeak-speak-help-interactively
2061 +Speak the start of, rest of, or the entire help.
2062 +'s' to speak the start.
2063 +'r' to speak the rest.
2064 +any other key to speak entire help.
2066 +------------------------------------------------------------
2068 +** emacspeak-speak-line Key Sequence: control e l
2070 +Speaks current line. With prefix ARG, speaks the rest of the line
2071 +from point. Negative prefix optional arg speaks from start of line to
2072 +point. Voicifies if option `voice-lock-mode' is on. Indicates
2073 +indentation with a tone if audio indentation is in use. Indicates
2074 +position of point with an aural highlight if option
2075 +`emacspeak-show-point' is turned on --see command
2076 +`emacspeak-show-point' bound to M-x emacspeak-show-point. Lines that
2077 +start hidden blocks of text, e.g. outline header lines, or header
2078 +lines of blocks created by command `emacspeak-hide-or-expose-block'
2079 +are indicated with auditory icon ellipses.
2081 +------------------------------------------------------------
2083 +** emacspeak-speak-line-interactively Key Sequence: control e cap L
2085 +Speak the start of, rest of, or the entire line.
2086 +'s' to speak the start.
2087 +'r' to speak the rest.
2088 +any other key to speak entire line.
2090 +------------------------------------------------------------
2092 +** emacspeak-speak-line-number Key Sequence: control e control l
2094 +Print the current buffer line number and narrowed line number of point.
2096 +------------------------------------------------------------
2098 +** emacspeak-speak-line-number-obsolete
2100 +Speak the line number of the current line.
2102 +------------------------------------------------------------
2104 +** emacspeak-speak-line-set-column-filter Key Sequence: control e |
2106 +Set up filter for selectively speaking or ignoring portions of lines.
2107 +The filter is specified as a list of pairs.
2108 +For example, to filter columns 1 -- 10 and 20 -- 25,
2110 +((0 9) (20 25)). Filter settings are persisted across sessions. A
2111 +persisted filter is used as the default when prompting for a filter.
2112 +This allows one to accumulate a set of filters for specific files like
2113 +/var/adm/messages and /var/adm/maillog over time.
2114 +Option emacspeak-speak-line-invert-filter determines
2115 +the sense of the filter.
2117 +------------------------------------------------------------
2119 +** emacspeak-speak-load-directory-settings
2121 +Load a directory specific Emacspeak settings file.
2122 +This is typically used to load up settings that are specific to
2123 +an electronic book consisting of many files in the same
2126 +------------------------------------------------------------
2128 +** emacspeak-speak-message-again Key Sequence: control e a
2130 +Speak the last message from Emacs once again.
2131 +Optional interactive prefix arg
2132 +`from-message-cache' speaks message cached from the most
2133 +recent call to function `message'.
2134 +The message is also placed in the kill ring for convenient yanking
2135 +if `emacspeak-speak-message-again-should-copy-to-kill-ring' is set.
2137 +------------------------------------------------------------
2139 +** emacspeak-speak-message-at-time Key Sequence: control e @
2141 +Set up ring-at-time to speak message at specified time.
2142 +Provides simple stop watch functionality in addition to other things.
2143 +See documentation for command run-at-time for details on time-spec.
2145 +------------------------------------------------------------
2147 +** emacspeak-speak-minibuffer
2149 +Speak the minibuffer contents
2150 + With prefix arg, speaks the rest of the buffer from point.
2151 +Negative prefix arg speaks from start of buffer to point.
2153 +------------------------------------------------------------
2155 +** emacspeak-speak-minor-mode-line Key Sequence: control e cap M
2157 +Speak the minor mode-information.
2159 +------------------------------------------------------------
2161 +** emacspeak-speak-mode-line Key Sequence: control e m
2163 +Speak the mode-line.
2164 +Interactive prefix arg speaks buffer info.
2166 +------------------------------------------------------------
2168 +** emacspeak-speak-next-field Key Sequence: control e >
2170 +Skip across and speak the next contiguous sequence of non-blank characters.
2171 +Useful in moving across fields.
2172 +Will be improved if it proves useful.
2174 +------------------------------------------------------------
2176 +** emacspeak-speak-next-personality-chunk
2178 +Moves to the front of next chunk having current personality.
2179 +Speak that chunk after moving.
2181 +------------------------------------------------------------
2183 +** emacspeak-speak-next-window Key Sequence: control e control n
2185 +Speak the next window.
2187 +------------------------------------------------------------
2189 +** emacspeak-speak-other-buffer Key Sequence: control e meta b
2191 +Speak specified buffer.
2192 +Useful to listen to a buffer while in a different context.
2194 +------------------------------------------------------------
2196 +** emacspeak-speak-other-window
2198 +Speak contents of `other' window.
2199 +Speaks entire window irrespective of point.
2200 +Semantics of `other' is the same as for the builtin Emacs command
2202 +Optional argument ARG specifies `other' window to speak.
2204 +------------------------------------------------------------
2206 +** emacspeak-speak-page Key Sequence: control e [
2209 +With prefix ARG, speaks rest of current page.
2210 +Negative prefix arg will read from start of current page to point.
2211 +If option `voice-lock-mode' is on, then it will use any defined personality.
2213 +------------------------------------------------------------
2215 +** emacspeak-speak-page-interactively Key Sequence: control e ]
2217 +Speak the start of, rest of, or the entire page.
2218 +'s' to speak the start.
2219 +'r' to speak the rest.
2220 +any other key to speak entire page.
2222 +------------------------------------------------------------
2224 +** emacspeak-speak-paragraph Key Sequence: control e {
2227 +With prefix arg, speaks rest of current paragraph.
2228 +Negative prefix arg will read from start of current paragraph to point.
2229 +If voice-lock-mode is on, then it will use any defined personality.
2231 +------------------------------------------------------------
2233 +** emacspeak-speak-paragraph-interactively Key Sequence: control e cap P
2235 +Speak the start of, rest of, or the entire paragraph.
2236 +'s' to speak the start.
2237 +'r' to speak the rest.
2238 +any other key to speak entire paragraph.
2240 +------------------------------------------------------------
2242 +** 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
2244 +Speak one of the first 10 windows on the screen.
2245 +Speaks entire window irrespective of point.
2246 +In general, you'll never have Emacs split the screen into more than
2248 +Argument ARG determines the 'other' window to speak.
2249 +Semantics of `other' is the same as for the builtin Emacs command
2252 +------------------------------------------------------------
2254 +** emacspeak-speak-previous-field Key Sequence: control e <
2256 +Skip backwards across and speak contiguous sequence of non-blank characters.
2257 +Useful in moving across fields.
2258 +Will be improved if it proves useful.
2260 +------------------------------------------------------------
2262 +** emacspeak-speak-previous-personality-chunk
2264 +Moves to the front of previous chunk having current personality.
2265 +Speak that chunk after moving.
2267 +------------------------------------------------------------
2269 +** emacspeak-speak-previous-window Key Sequence: control e control p
2271 +Speak the previous window.
2273 +------------------------------------------------------------
2275 +** emacspeak-speak-rectangle Key Sequence: control e cap R
2277 +Speak a rectangle of text.
2278 +Rectangle is delimited by point and mark.
2279 +When call from a program,
2280 +arguments specify the START and END of the rectangle.
2282 +------------------------------------------------------------
2284 +** emacspeak-speak-region Key Sequence: control e r
2287 +Argument START and END specify region to speak.
2289 +------------------------------------------------------------
2291 +** emacspeak-speak-rest-of-buffer Key Sequence: control e n
2293 +Speak remainder of the buffer starting at point
2295 +------------------------------------------------------------
2297 +** emacspeak-speak-sentence
2299 +Speak current sentence.
2300 +With prefix ARG, speaks the rest of the sentence from point.
2301 +Negative prefix arg speaks from start of sentence to point.
2303 +------------------------------------------------------------
2305 +** emacspeak-speak-set-display-table
2307 +Sets up buffer specific speech display table that controls how
2308 +special characters are spoken. Interactive prefix argument causes
2309 +setting to be global.
2311 +------------------------------------------------------------
2313 +** emacspeak-speak-sexp Key Sequence: control e '
2315 +Speak current sexp.
2316 +With prefix ARG, speaks the rest of the sexp from point.
2317 +Negative prefix arg speaks from start of sexp to point.
2318 +If option `voice-lock-mode' is on, then uses the personality.
2320 +------------------------------------------------------------
2322 +** emacspeak-speak-sexp-interactively Key Sequence: control e "
2324 +Speak the start of, rest of, or the entire sexp.
2325 +'s' to speak the start.
2326 +'r' to speak the rest.
2327 +any other key to speak entire sexp.
2329 +------------------------------------------------------------
2331 +** emacspeak-speak-skim-buffer
2333 +Skim the current buffer a paragraph at a time.
2335 +------------------------------------------------------------
2337 +** emacspeak-speak-skim-next-paragraph
2339 +Skim next paragraph.
2341 +------------------------------------------------------------
2343 +** emacspeak-speak-skim-paragraph
2346 +Skimming a paragraph results in the speech speeding up after
2348 +Speech is scaled by the value of dtk-speak-skim-scale
2350 +------------------------------------------------------------
2352 +** emacspeak-speak-spaces-at-point Key Sequence: control e CONTROL meta @
2354 +Speak the white space at point.
2356 +------------------------------------------------------------
2358 +** emacspeak-speak-spell-current-word
2360 +Spell word at point.
2362 +------------------------------------------------------------
2364 +** emacspeak-speak-this-personality-chunk
2366 +Speak chunk of text around point that has current
2369 +------------------------------------------------------------
2371 +** emacspeak-speak-time Key Sequence: control e t
2374 +Optional interactive prefix arg `C-u'invokes world clock.
2375 +Timezone is specified using minibuffer completion.
2376 +Second interactive prefix sets clock to new timezone.
2378 +------------------------------------------------------------
2380 +** emacspeak-speak-version Key Sequence: control e cap V
2382 +Announce version information for running emacspeak.
2384 +------------------------------------------------------------
2386 +** emacspeak-speak-voice-annotate-paragraphs
2388 +Locate paragraphs and voice annotate the first word.
2389 +Here, paragraph is taken to mean a chunk of text preceded by a blank line.
2390 +Useful to do this before you listen to an entire buffer.
2392 +------------------------------------------------------------
2394 +** emacspeak-speak-window-information Key Sequence: control e control w
2396 +Speaks information about current window.
2398 +------------------------------------------------------------
2400 +** emacspeak-speak-word Key Sequence: control e w
2402 +Speak current word.
2403 +With prefix ARG, speaks the rest of the word from point.
2404 +Negative prefix arg speaks from start of word to point.
2405 +If executed on the same buffer position a second time, the word is
2406 +spelt instead of being spoken.
2408 +------------------------------------------------------------
2410 +** emacspeak-speak-word-interactively
2412 +Speak the start of, rest of, or the entire word.
2413 +'s' to speak the start.
2414 +'r' to speak the rest.
2415 +any other key to speak entire word.
2417 +------------------------------------------------------------
2419 +** emacspeak-speak-world-clock
2421 +Display current date and time for specified zone.
2422 +Optional second arg `set' sets the TZ environment variable as well.
2424 +------------------------------------------------------------
2426 +** emacspeak-switch-to-completions-window
2428 +Jump to the *Completions* buffer if it is active.
2429 +We make the current minibuffer contents (which is obviously the
2430 +prefix for each entry in the completions buffer) inaudible
2433 +------------------------------------------------------------
2435 +** emacspeak-toggle-action-mode
2437 +Toggle state of Emacspeak action mode.
2438 +Interactive PREFIX arg means toggle the global default value, and then set the
2439 +current local value to the result.
2441 +------------------------------------------------------------
2443 +** emacspeak-toggle-audio-indentation Key Sequence: control e d i
2445 +Toggle state of Emacspeak audio indentation.
2446 +Interactive PREFIX arg means toggle the global default value, and then set the
2447 +current local value to the result.
2448 +Specifying the method of indentation as `tones'
2449 +results in the Dectalk producing a tone whose length is a function of the
2450 +line's indentation. Specifying `speak'
2451 +results in the number of initial spaces being spoken.
2453 +------------------------------------------------------------
2455 +** emacspeak-toggle-character-echo Key Sequence: control e d k
2457 +Toggle state of Emacspeak character echo.
2458 +Interactive PREFIX arg means toggle the global default value, and then set the
2459 +current local value to the result.
2461 +------------------------------------------------------------
2463 +** emacspeak-toggle-comint-autospeak Key Sequence: control e control q
2465 +Toggle state of Emacspeak comint autospeak.
2466 +When turned on, comint output is automatically spoken. Turn this on if
2467 +you want your shell to speak its results. Interactive
2468 +PREFIX arg means toggle the global default value, and then
2469 +set the current local value to the result.
2471 +------------------------------------------------------------
2473 +** emacspeak-toggle-line-echo Key Sequence: control e d l
2475 +Toggle state of Emacspeak line echo.
2476 +Interactive PREFIX arg means toggle the global default value, and then set the
2477 +current local value to the result.
2479 +------------------------------------------------------------
2481 +** emacspeak-toggle-mail-alert Key Sequence: control e meta m
2483 +Toggle state of Emacspeak mail alert.
2484 +Interactive PREFIX arg means toggle the global default value, and then set the
2485 +current local value to the result.
2486 +Turning on this option results in Emacspeak producing an auditory icon
2487 +indicating the arrival of new mail when displaying the mode line.
2489 +------------------------------------------------------------
2491 +** emacspeak-toggle-show-point Key Sequence: control e control d
2493 +Toggle state of Emacspeak-show-point.
2494 +Interactive PREFIX arg means toggle the global default value, and then set the
2495 +current local value to the result.
2497 +------------------------------------------------------------
2499 +** emacspeak-toggle-speak-line-invert-filter Key Sequence: control e \
2501 +Toggle state of how column filter is interpreted.
2502 +Interactive PREFIX arg means toggle the global default value, and then set the
2503 +current local value to the result.
2505 +------------------------------------------------------------
2507 +** emacspeak-toggle-speak-messages Key Sequence: control e q
2509 +Toggle the state of whether emacspeak echoes messages.
2511 +------------------------------------------------------------
2513 +** emacspeak-toggle-which-function Key Sequence: control e meta w
2515 +Toggle state of Emacspeak which function mode.
2516 +Interactive PREFIX arg means toggle the global default value, and then set the
2517 +current local value to the result.
2519 +------------------------------------------------------------
2521 +** emacspeak-toggle-word-echo Key Sequence: control e d w
2523 +Toggle state of Emacspeak word echo.
2524 +Interactive PREFIX arg means toggle the global default value, and then set the
2525 +current local value to the result.
2527 +------------------------------------------------------------
2529 +** emacspeak-use-customized-blink-paren
2531 +A customized blink-paren to speak matching opening paren.
2532 +We need to call this in case Emacs
2533 +is anal and loads its own builtin blink-paren function
2534 +which does not talk.
2536 +------------------------------------------------------------
2538 +** emacspeak-view-register Key Sequence: control e v
2540 +Display the contents of a register, and then speak it.
2542 +------------------------------------------------------------
2544 +** emacspeak-voicify-rectangle
2546 +Voicify the current rectangle.
2547 +When calling from a program,arguments are
2548 +START END personality
2549 +Prompts for PERSONALITY with completion when called interactively.
2551 +------------------------------------------------------------
2553 +** emacspeak-voicify-region
2555 +Voicify the current region.
2556 +When calling from a program,arguments are
2557 +START END personality.
2558 +Prompts for PERSONALITY with completion when called interactively.
2560 +------------------------------------------------------------
2562 +** emacspeak-zap-tts Key Sequence: control e d z
2564 +Send this command to the TTS directly.
2566 +------------------------------------------------------------
2568 +** emacspeak-table-copy-current-element-to-register
2570 +Speak current table element
2572 +------------------------------------------------------------
2574 +** emacspeak-table-copy-to-clipboard
2576 +Copy table in current buffer to the table clipboard.
2577 +Current buffer must be in emacspeak-table mode.
2579 +------------------------------------------------------------
2581 +** emacspeak-table-display-table-in-region Key Sequence: control e TAB
2583 +Recognize tabular data in current region and display it in table
2584 +browsing mode in a a separate buffer.
2585 +emacspeak table mode is designed to let you browse tabular data using
2586 +all the power of the two-dimensional spatial layout while giving you
2587 +sufficient contextual information. The tables subdirectory of the
2588 +emacspeak distribution contains some sample tables --these are the
2589 +CalTrain schedules. Execute command `describe-mode' bound to
2590 +C-h m in a buffer that is in emacspeak table mode to read
2591 +the documentation on the table browser.
2593 +------------------------------------------------------------
2595 +** emacspeak-table-find-csv-file
2597 +Process a csv (comma separated values) file.
2598 +The processed data and presented using emacspeak table navigation.
2600 +------------------------------------------------------------
2602 +** emacspeak-table-find-file Key Sequence: control e control t
2604 +Open a file containing table data and display it in table mode.
2605 +emacspeak table mode is designed to let you browse tabular data using
2606 +all the power of the two-dimensional spatial layout while giving you
2607 +sufficient contextual information. The etc/tables subdirectory of the
2608 +emacspeak distribution contains some sample tables --these are the
2609 +CalTrain schedules. Execute command `describe-mode' bound to
2610 +C-h m in a buffer that is in emacspeak table mode to read
2611 +the documentation on the table browser.
2613 +------------------------------------------------------------
2615 +** emacspeak-table-get-entry-with-headers
2617 +Return both row and column header and table element
2619 +------------------------------------------------------------
2621 +** emacspeak-table-goto
2623 +Prompt for a table cell coordinates and jump to it.
2625 +------------------------------------------------------------
2627 +** emacspeak-table-goto-bottom
2629 +Goes to the bottom of the current column.
2631 +------------------------------------------------------------
2633 +** emacspeak-table-goto-left
2635 +Goes to the left of the current row.
2637 +------------------------------------------------------------
2639 +** emacspeak-table-goto-right
2641 +Goes to the right of the current row.
2643 +------------------------------------------------------------
2645 +** emacspeak-table-goto-top
2647 +Goes to the top of the current column.
2649 +------------------------------------------------------------
2651 +** emacspeak-table-next-column
2653 +Move to the next column if possible
2655 +------------------------------------------------------------
2657 +** emacspeak-table-next-row
2659 +Move to the next row if possible
2661 +------------------------------------------------------------
2663 +** emacspeak-table-paste-from-clipboard
2665 +Paste the emacspeak table clipboard into the current buffer.
2666 +Use the major mode of this buffer to decide what kind of table
2669 +------------------------------------------------------------
2671 +** emacspeak-table-previous-column
2673 +Move to the previous column if possible
2675 +------------------------------------------------------------
2677 +** emacspeak-table-previous-row
2679 +Move to the previous row if possible
2681 +------------------------------------------------------------
2683 +** emacspeak-table-search
2685 +Search the table for matching elements. Interactively prompts for
2686 +row or column to search and pattern to look for. If there is a match, makes
2687 +the matching cell current. When called from a program, `what' can
2688 + be either `row' or `column'.
2690 +------------------------------------------------------------
2692 +** emacspeak-table-search-column
2694 +Search in current table column.
2696 +------------------------------------------------------------
2698 +** emacspeak-table-search-headers
2700 +Search the table row or column headers. Interactively prompts for
2701 +row or column to search and pattern to look for. If there is a
2702 +match, makes the matching row or column current.
2704 +------------------------------------------------------------
2706 +** emacspeak-table-search-row
2708 +Search in current table row.
2710 +------------------------------------------------------------
2712 +** emacspeak-table-select-automatic-speaking-method
2714 +Interactively select the kind of automatic speech to produce when
2715 +browsing table elements
2717 +------------------------------------------------------------
2719 +** emacspeak-table-sort-on-current-column
2721 +Sort table on current column.
2723 +------------------------------------------------------------
2725 +** emacspeak-table-speak-both-headers-and-element
2727 +Speak both row and column header and table element
2729 +------------------------------------------------------------
2731 +** emacspeak-table-speak-column-filtered
2733 +Speaks a table column after applying a specified column filter.
2734 +Optional prefix arg prompts for a new filter.
2736 +------------------------------------------------------------
2738 +** emacspeak-table-speak-column-header-and-element
2740 +Speak column header and table element
2742 +------------------------------------------------------------
2744 +** emacspeak-table-speak-coordinates
2746 +Speak current table coordinates.
2748 +------------------------------------------------------------
2750 +** emacspeak-table-speak-current-element
2752 +Speak current table element
2754 +------------------------------------------------------------
2756 +** emacspeak-table-speak-dimensions
2758 +Speak current table dimensions.
2760 +------------------------------------------------------------
2762 +** emacspeak-table-speak-row-filtered
2764 +Speaks a table row after applying a specified row filter.
2765 +Optional prefix arg prompts for a new filter.
2767 +------------------------------------------------------------
2769 +** emacspeak-table-speak-row-header-and-element
2771 +Speak row header and table element
2773 +------------------------------------------------------------
2775 +** emacspeak-table-ui-filter-load
2777 +Load saved filter settings.
2779 +------------------------------------------------------------
2781 +** emacspeak-table-ui-filter-save
2783 +Save out filter settings.
2785 +------------------------------------------------------------
2787 +** emacspeak-table-view-csv-buffer
2789 +Process a csv (comma separated values) data.
2790 +The processed data and presented using emacspeak table navigation.
2792 +------------------------------------------------------------
2794 +** emacspeak-widget-browse-widget-interactively
2796 +Allows you to browse a widget
2798 +------------------------------------------------------------
2800 +** emacspeak-widget-help
2802 +Speak help for widget under point.
2804 +------------------------------------------------------------
2806 +** emacspeak-widget-summarize-parent
2808 +Summarize parent of widget at point.
2810 +------------------------------------------------------------
2812 +** emacspeak-widget-summarize-widget-under-point
2814 +Summarize a widget if any under point.
2815 +Optional interactive prefix specifies how many levels to go up from current
2816 +widget before summarizing.
2818 +------------------------------------------------------------
2820 +** emacspeak-widget-update-from-minibuffer
2822 +Sets widget at point by invoking its prompter.
2824 +------------------------------------------------------------
2826 +** emacspeak-annotate-add-annotation
2828 +Add annotation to the annotation working buffer.
2829 +Prompt for annotation buffer if not already set.
2830 +Interactive prefix arg `reset' prompts for the annotation
2831 +buffer even if one is already set.
2832 +Annotation is entered in a temporary buffer and the
2833 +annotation is inserted into the working buffer when complete.
2835 +------------------------------------------------------------
2837 +** emacspeak-clipboard-copy Key Sequence: control e control c
2839 +Copy contents of the region to the emacspeak clipboard.
2840 +Previous contents of the clipboard will be overwritten. The Emacspeak
2841 +clipboard is a convenient way of sharing information between
2842 +independent Emacspeak sessions running on the same or different
2843 +machines. Do not use this for sharing information within an Emacs
2844 +session --Emacs' register commands are far more efficient and
2845 +light-weight. Optional interactive prefix arg results in Emacspeak
2846 +prompting for the clipboard file to use.
2847 +Argument START and END specifies region.
2848 +Optional argument PROMPT specifies whether we prompt for the name of a clipboard file.
2850 +------------------------------------------------------------
2852 +** emacspeak-clipboard-paste Key Sequence: control e control y
2854 +Yank contents of the Emacspeak clipboard at point.
2855 +The Emacspeak clipboard is a convenient way of sharing information between
2856 +independent Emacspeak sessions running on the same or different
2857 +machines. Do not use this for sharing information within an Emacs
2858 +session --Emacs' register commands are far more efficient and
2859 +light-weight. Optional interactive prefix arg pastes from
2860 +the emacspeak table clipboard instead.
2862 +------------------------------------------------------------
2864 +** emacspeak-copy-current-file Key Sequence: control e meta c
2866 +Copy file visited in current buffer to new location.
2867 +Prompts for the new location and preserves modification time
2868 + when copying. If location is a directory, the file is copied
2869 + to that directory under its current name ; if location names
2870 + a file in an existing directory, the specified name is
2871 + used. Asks for confirmation if the copy will result in an
2872 + existing file being overwritten.
2874 +------------------------------------------------------------
2878 +Grab URL using Curl, and preview it with W3.
2880 +------------------------------------------------------------
2882 +** emacspeak-customize Key Sequence: control e cap C
2884 +Customize Emacspeak.
2886 +------------------------------------------------------------
2888 +** emacspeak-customize-personal-settings
2890 +Create a customization buffer for browsing and updating
2891 +personal customizations.
2893 +------------------------------------------------------------
2895 +** emacspeak-cvs-get-anonymous Key Sequence: control e <control down>
2897 +Get latest cvs snapshot of emacspeak.
2899 +------------------------------------------------------------
2901 +** emacspeak-cvs-gnu-get-project-snapshot
2903 +Grab CVS snapshot of specified project from GNU.
2905 +------------------------------------------------------------
2907 +** emacspeak-cvs-sf-get-project-snapshot
2909 +Grab CVS snapshot of specified project from Sourceforge.
2911 +------------------------------------------------------------
2913 +** emacspeak-emergency-tts-restart Key Sequence: control e <insert>
2915 +For use in an emergency.
2916 +Will start TTS engine specified by
2917 +emacspeak-emergency-tts-server.
2919 +------------------------------------------------------------
2921 +** emacspeak-frame-label-or-switch-to-labelled-frame Key Sequence: control e meta f
2923 +Switch to labelled frame.
2924 +With optional PREFIX argument, label current frame.
2926 +------------------------------------------------------------
2928 +** emacspeak-frame-read-frame-label
2930 +Read a frame label with completion.
2932 +------------------------------------------------------------
2934 +** emacspeak-generate-documentation
2936 +Generate docs for all emacspeak commands.
2937 +Prompts for FILENAME in which to save the documentation.
2938 +Warning! Contents of file filename will be overwritten.
2940 +------------------------------------------------------------
2942 +** emacspeak-generate-texinfo-command-documentation
2944 +Generate texinfo documentation for all emacspeak
2945 +commands into file commands.texi.
2946 +Warning! Contents of file commands.texi will be overwritten.
2948 +------------------------------------------------------------
2950 +** emacspeak-generate-texinfo-option-documentation
2952 +Generate texinfo documentation for all emacspeak
2953 +options into file filename.
2954 +Warning! Contents of file filename will be overwritten.
2956 +------------------------------------------------------------
2958 +** emacspeak-kill-buffer-quietly
2960 +Kill current buffer without asking for confirmation.
2962 +------------------------------------------------------------
2964 +** emacspeak-learn-mode Key Sequence: control e control h
2966 +Helps you learn the keys. You can press keys and hear what they do.
2967 +To leave, press C-g.
2969 +------------------------------------------------------------
2971 +** emacspeak-link-current-file Key Sequence: control e meta l
2973 +Link (hard link) file visited in current buffer to new location.
2974 +Prompts for the new location and preserves modification time
2975 + when linking. If location is a directory, the file is copied
2976 + to that directory under its current name ; if location names
2977 + a file in an existing directory, the specified name is
2978 + used. Signals an error if target already exists.
2980 +------------------------------------------------------------
2984 +Launch links on specified URL in a new terminal.
2986 +------------------------------------------------------------
2990 +Launch lynx on specified URL in a new terminal.
2992 +------------------------------------------------------------
2994 +** emacspeak-next-frame-or-buffer Key Sequence: <control right>
2996 +Move to next buffer.
2997 +With optional interactive prefix arg `frame', move to next frame instead.
2999 +------------------------------------------------------------
3001 +** emacspeak-previous-frame-or-buffer Key Sequence: <control left>
3003 +Move to previous buffer.
3004 +With optional interactive prefix arg `frame', move to previous frame instead.
3006 +------------------------------------------------------------
3008 +** emacspeak-root Key Sequence: control e control r
3010 +Start a root shell or switch to one that already exists.
3011 +Optional interactive prefix arg `cd' executes cd
3012 +default-directory after switching.
3014 +------------------------------------------------------------
3016 +** emacspeak-select-this-buffer-next-display Key Sequence: control e <control right>
3018 +Select this buffer as displayed in a `next' frame.
3019 +See documentation for command
3020 +`emacspeak-select-this-buffer-other-window-display' for the
3023 +------------------------------------------------------------
3025 +** emacspeak-select-this-buffer-other-window-display
3027 +Switch to this buffer as displayed in a different frame. Emacs
3028 +allows you to display the same buffer in multiple windows or
3029 +frames. These different windows can display different
3030 +portions of the buffer. This is equivalent to leaving a
3031 +book open at places at once. This command allows you to
3032 +move to the places where you have left the book open. The
3033 +number used to invoke this command specifies which of the
3034 +displays you wish to select. Typically you will have two or
3035 +at most three such displays open. The current display is 0,
3036 +the next is 1, and so on. Optional argument ARG specifies
3037 +the display to select.
3039 +------------------------------------------------------------
3041 +** emacspeak-select-this-buffer-previous-display Key Sequence: control e <control left>
3043 +Select this buffer as displayed in a `previous' window.
3044 +See documentation for command
3045 +`emacspeak-select-this-buffer-other-window-display' for the
3046 +meaning of `previous'.
3048 +------------------------------------------------------------
3050 +** emacspeak-show-personality-at-point Key Sequence: control e meta v
3052 +Show value of property personality (and possibly face)
3055 +------------------------------------------------------------
3057 +** emacspeak-show-property-at-point Key Sequence: control e meta p
3059 +Show value of PROPERTY at point.
3060 +If optional arg property is not supplied, read it interactively.
3061 +Provides completion based on properties that are of interest.
3062 +If no property is set, show a message and exit.
3064 +------------------------------------------------------------
3066 +** emacspeak-skip-blank-lines-backward Key Sequence: <shift> <up>
3068 +Move backward across blank lines.
3069 +The line under point is then spoken.
3070 +Signals beginning of buffer.
3072 +------------------------------------------------------------
3074 +** emacspeak-skip-blank-lines-forward Key Sequence: <shift> <down>
3076 +Move forward across blank lines.
3077 +The line under point is then spoken.
3078 +Signals end of buffer.
3080 +------------------------------------------------------------
3082 +** emacspeak-speak-browse-linux-howto Key Sequence: control e cap H
3084 +Browse a Linux Howto file.
3085 +We cleanup underlining, and set up outline mode correctly.
3087 +------------------------------------------------------------
3089 +** emacspeak-speak-hostname Key Sequence: control e meta h
3093 +------------------------------------------------------------
3095 +** emacspeak-speak-popup-messages Key Sequence: control h cap M
3097 +Pop up messages buffer.
3098 +If it is already selected then hide it and try to restore
3099 +previous window configuration.
3101 +------------------------------------------------------------
3103 +** emacspeak-speak-run-shell-command Key Sequence: control e !
3105 +Invoke shell COMMAND and display its output as a table. The results
3106 +are placed in a buffer in Emacspeak's table browsing mode. Optional
3107 +interactive prefix arg as-root runs the command as root (not yet
3108 +implemented). Use this for running shell commands that produce
3109 +tabulated output. This command should be used for shell commands that
3110 +produce tabulated output that works with Emacspeak's table recognizer.
3111 +Verify this first by running the command in a shell and executing
3112 +command `emacspeak-table-display-table-in-region' normally bound to
3115 +------------------------------------------------------------
3117 +** emacspeak-speak-show-active-network-interfaces Key Sequence: control e cap I
3119 +Shows all active network interfaces in the echo area.
3120 +With interactive prefix argument ADDRESS it prompts for a
3121 +specific interface and shows its address. The address is
3122 +also copied to the kill ring for convenient yanking.
3124 +------------------------------------------------------------
3126 +** emacspeak-speak-show-memory-used
3128 +Convenience command to view state of memory used in this session so far.
3130 +------------------------------------------------------------
3132 +** emacspeak-speak-telephone-directory
3134 +Lookup and display a phone number.
3135 +With prefix arg, opens the phone book for editting.
3137 +------------------------------------------------------------
3139 +** emacspeak-speak-this-buffer-next-display Key Sequence: control e <right>
3141 +Speak this buffer as displayed in a `previous' window.
3142 +See documentation for command
3143 +`emacspeak-speak-this-buffer-other-window-display' for the
3146 +------------------------------------------------------------
3148 +** emacspeak-speak-this-buffer-other-window-display Key Sequence: control e /
3150 +Speak this buffer as displayed in a different frame. Emacs
3151 +allows you to display the same buffer in multiple windows or
3152 +frames. These different windows can display different
3153 +portions of the buffer. This is equivalent to leaving a
3154 +book open at places at once. This command allows you to
3155 +listen to the places where you have left the book open. The
3156 +number used to invoke this command specifies which of the
3157 +displays you wish to speak. Typically you will have two or
3158 +at most three such displays open. The current display is 0,
3159 +the next is 1, and so on. Optional argument ARG specifies
3160 +the display to speak.
3162 +------------------------------------------------------------
3164 +** emacspeak-speak-this-buffer-previous-display Key Sequence: control e <aleft>
3166 +Speak this buffer as displayed in a `previous' window.
3167 +See documentation for command
3168 +`emacspeak-speak-this-buffer-other-window-display' for the
3169 +meaning of `previous'.
3171 +------------------------------------------------------------
3173 +** emacspeak-ssh-tts-restart
3175 +Restart specified ssh tts server.
3177 +------------------------------------------------------------
3181 +SUDo command --run command as super user.
3183 +------------------------------------------------------------
3185 +** emacspeak-switch-to-previous-buffer
3187 +Switch to most recently used interesting buffer.
3189 +------------------------------------------------------------
3191 +** emacspeak-symlink-current-file Key Sequence: control e meta s
3193 +Link (symbolic link) file visited in current buffer to new location.
3194 +Prompts for the new location and preserves modification time
3195 + when linking. If location is a directory, the file is copied
3196 + to that directory under its current name ; if location names
3197 + a file in an existing directory, the specified name is
3198 + used. Signals an error if target already exists.
3200 +------------------------------------------------------------
3202 +** emacspeak-view-emacspeak-doc Key Sequence: control e cap D
3204 +Display a summary of all Emacspeak commands.
3206 +------------------------------------------------------------
3208 +** emacspeak-view-emacspeak-faq Key Sequence: control e cap F
3210 +Browse the Emacspeak FAQ.
3212 +------------------------------------------------------------
3214 +** emacspeak-view-emacspeak-news Key Sequence: control e cap N
3216 +Display info on recent change to Emacspeak.
3218 +------------------------------------------------------------
3220 +** emacspeak-view-emacspeak-tips Key Sequence: control e cap T
3222 +Browse Emacspeak productivity tips.
3224 +------------------------------------------------------------
3226 +** emacspeak-wizards-count-slides-in-region
3228 +Count slides starting from point.
3230 +------------------------------------------------------------
3232 +** emacspeak-wizards-dvi-display
3234 +Called to set up preview of an DVI file.
3235 +Assumes we are in a buffer visiting a .DVI file.
3236 +Previews those contents as text and nukes the buffer
3237 +visiting the DVI file.
3239 +------------------------------------------------------------
3241 +** emacspeak-wizards-dvi-mode
3243 +Major mode for browsing DVI files.
3246 +DVI files are converted to text and previewed using text mode.
3248 +This mode runs the hook `emacspeak-wizards-dvi-mode-hook', as the final step
3249 +during initialization.
3256 +------------------------------------------------------------
3258 +** emacspeak-wizards-edit-file-as-root
3260 +Edit file as root using sudo vi.
3261 +See /etc/sudoers for how to set up sudo.
3263 +------------------------------------------------------------
3265 +** emacspeak-wizards-find-grep
3267 +Run compile using find and grep.
3268 +Interactive arguments specify filename pattern and search pattern.
3270 +------------------------------------------------------------
3272 +** emacspeak-wizards-find-longest-line-in-region
3274 +Find longest line in region.
3275 +Moves to the longest line when called interactively.
3277 +------------------------------------------------------------
3279 +** emacspeak-wizards-find-longest-paragraph-in-region
3281 +Find longest paragraph in region.
3282 +Moves to the longest paragraph when called interactively.
3284 +------------------------------------------------------------
3286 +** emacspeak-wizards-finder-find
3288 +Run find-dired on specified switches after prompting for the
3289 +directory to where find is to be launched.
3291 +------------------------------------------------------------
3293 +** emacspeak-wizards-finder-mode
3299 +This mode runs the hook `emacspeak-wizards-finder-mode-hook', as the final step
3300 +during initialization.
3307 +------------------------------------------------------------
3309 +** emacspeak-wizards-fix-read-only-text
3311 +Nuke read-only property on text range.
3313 +------------------------------------------------------------
3315 +** emacspeak-wizards-fix-typo
3317 +Search and replace recursively in all files with extension `ext'
3318 +for `word' and replace it with correction.
3321 +------------------------------------------------------------
3323 +** emacspeak-wizards-generate-finder
3325 +Generate a widget-enabled finder wizard.
3327 +------------------------------------------------------------
3329 +** emacspeak-wizards-generate-voice-sampler
3331 +Generate a buffer that shows a sample line in all the ACSS settings
3332 +for the current voice family.
3334 +------------------------------------------------------------
3336 +** emacspeak-wizards-get-table-content-from-file
3338 +Extract table specified by depth and count from HTML
3340 +Extracted content is placed as a csv file in task.csv.
3342 +------------------------------------------------------------
3344 +** emacspeak-wizards-get-table-content-from-url
3346 +Extract table specified by depth and count from HTML
3348 +Extracted content is placed as a csv file in task.csv.
3350 +------------------------------------------------------------
3352 +** emacspeak-wizards-google-hits
3354 +Filter Google results after performing search to show just the
3357 +------------------------------------------------------------
3359 +** emacspeak-wizards-how-many-matches
3361 +If you define a file local variable
3362 +called `emacspeak-occur-pattern' that holds a regular expression
3363 +that matches lines of interest, you can use this command to conveniently
3364 +run `how-many' to count matching header lines.
3365 +With interactive prefix arg, prompts for and remembers the file local pattern.
3367 +------------------------------------------------------------
3369 +** emacspeak-wizards-move-and-speak
3371 +Speaks a chunk of text bounded by point and a target position.
3372 +Target position is specified using a navigation command and a
3373 +count that specifies how many times to execute that command
3375 +Point is left at the target position.
3376 +Interactively, command is specified by pressing the key that
3377 +;;invokes the command.
3379 +------------------------------------------------------------
3381 +** emacspeak-wizards-occur-header-lines
3383 +If you define a file local variable called
3384 +`emacspeak-occur-pattern' that holds a regular expression that
3385 +matches header lines, you can use this command to conveniently
3386 +run `occur' to find matching header lines. With prefix arg,
3387 +prompts for and sets value of the file local pattern.
3389 +------------------------------------------------------------
3391 +** emacspeak-wizards-portfolio-quotes
3393 +Bring up detailed stock quotes for portfolio specified by
3394 +emacspeak-websearch-personal-portfolio.
3396 +------------------------------------------------------------
3398 +** emacspeak-wizards-ppp-toggle
3400 +Bring up or bring down ppp.
3402 +------------------------------------------------------------
3404 +** emacspeak-wizards-ppt-display
3406 +Called to set up preview of an PPT file.
3407 +Assumes we are in a buffer visiting a .ppt file.
3408 +Previews those contents as HTML and nukes the buffer
3409 +visiting the ppt file.
3411 +------------------------------------------------------------
3413 +** emacspeak-wizards-ppt-mode
3415 +Major mode for browsing PPT slides.
3418 +PPT files are converted to HTML and previewed using W3.
3420 +In addition to any hooks its parent mode `text-mode' might have run,
3421 +this mode runs the hook `emacspeak-wizards-ppt-mode-hook', as the final step
3422 +during initialization.
3429 +------------------------------------------------------------
3431 +** emacspeak-wizards-rivo
3434 +Prompts for relevant information and schedules a rivo job using
3435 + UNIX AT scheduling facility.
3436 +RIVO is implemented by rivo.pl ---
3437 + a Perl script that can be used to launch realaudio and record
3438 + streaming media for a specified duration.
3440 +------------------------------------------------------------
3442 +** emacspeak-wizards-rpm-query-in-dired
3444 +Run rpm -qi on current dired entry.
3446 +------------------------------------------------------------
3448 +** emacspeak-wizards-shell-toggle Key Sequence: control e <f11>
3450 +Switch to the shell buffer and cd to
3451 + the directory of the current buffer.
3453 +------------------------------------------------------------
3455 +** emacspeak-wizards-show-commentary
3457 +Display commentary. Default is to display commentary from current buffer.
3459 +------------------------------------------------------------
3461 +** emacspeak-wizards-show-environment-variable
3463 +Display value of specified environment variable.
3465 +------------------------------------------------------------
3467 +** emacspeak-wizards-show-face
3469 +Show salient properties of specified face.
3471 +------------------------------------------------------------
3473 +** emacspeak-wizards-show-list-variable
3475 +Convenience command to view Emacs variables that are long lists.
3476 +Prompts for a variable name and displays its value in a separate buffer.
3477 +Lists are displayed one element per line.
3478 +Argument VAR specifies variable whose value is to be displayed.
3480 +------------------------------------------------------------
3482 +** emacspeak-wizards-speak-iso-datetime
3484 +Make ISO date-time speech friendly.
3486 +------------------------------------------------------------
3488 +** emacspeak-wizards-spot-words
3490 +Searches recursively in all files with extension `ext'
3491 +for `word' and displays hits in a compilation buffer.
3493 +------------------------------------------------------------
3495 +** emacspeak-wizards-squeeze-blanks
3497 +Squeeze multiple blank lines in current buffer.
3499 +------------------------------------------------------------
3501 +** emacspeak-wizards-terminal
3503 +Launch terminal and rename buffer appropriately.
3505 +------------------------------------------------------------
3507 +** emacspeak-wizards-toggle-mm-dd-yyyy-date-pronouncer
3509 +Toggle pronunciation of mm-dd-yyyy dates.
3511 +------------------------------------------------------------
3513 +** emacspeak-wizards-tpctl-display-status
3515 +Show display status on thinkpads using tpctl.
3517 +------------------------------------------------------------
3519 +** emacspeak-wizards-tramp-open-location
3521 +Open specified tramp location.
3522 +Location is specified by name.
3524 +------------------------------------------------------------
3526 +** emacspeak-wizards-unhex-uri
3530 +------------------------------------------------------------
3532 +** emacspeak-wizards-units
3534 +Run units in a comint sub-process.
3536 +------------------------------------------------------------
3538 +** emacspeak-wizards-use-w3-or-w3m
3540 +Alternates between using W3 and W3M for browse-url.
3542 +------------------------------------------------------------
3544 +** emacspeak-wizards-vc-n
3546 +Accelerator for VC viewer.
3548 +------------------------------------------------------------
3550 +** emacspeak-wizards-vc-viewer
3552 +View contents of specified virtual console.
3554 +------------------------------------------------------------
3556 +** emacspeak-wizards-vc-viewer-mode
3558 +Major mode for interactively viewing virtual console contents.
3564 +C-l emacspeak-wizards-vc-viewer-refresh
3568 +This mode runs the hook `emacspeak-wizards-vc-viewer-mode-hook', as the final step
3569 +during initialization.
3571 +------------------------------------------------------------
3573 +** emacspeak-wizards-vc-viewer-refresh
3575 +Refresh view of VC we're viewing.
3577 +------------------------------------------------------------
3579 +** emacspeak-wizards-vi-as-su-file
3581 +Launch sudo vi on specified file in a terminal.
3583 +------------------------------------------------------------
3585 +** emacspeak-wizards-voice-sampler
3587 +Read a personality and apply it to the current line.
3589 +------------------------------------------------------------
3591 +** emacspeak-wizards-vpn-toggle
3593 +Bring up or bring down vpn.
3595 +------------------------------------------------------------
3597 +** emacspeak-wizards-xl-display
3599 +Called to set up preview of an XL file.
3600 +Assumes we are in a buffer visiting a .xls file.
3601 +Previews those contents as HTML and nukes the buffer
3602 +visiting the xls file.
3604 +------------------------------------------------------------
3606 +** emacspeak-wizards-xl-mode
3608 +Major mode for browsing XL spreadsheets.
3611 +XL Sheets are converted to HTML and previewed using W3.
3613 +In addition to any hooks its parent mode `text-mode' might have run,
3614 +this mode runs the hook `emacspeak-wizards-xl-mode-hook', as the final step
3615 +during initialization.
3622 +------------------------------------------------------------
3624 +** cd-tool Key Sequence: control e DEL
3626 +Front-end to CDTool.
3627 +Bind this function to a convenient key-
3628 +Emacspeak users automatically have
3629 +this bound to <DEL> in the emacspeak keymap.
3636 +SPC Pause or Resume
3644 +cap C Save clip to disk
3647 +------------------------------------------------------------
3649 +** emacspeak-alsaplayer-launch
3652 +user is placed in a buffer associated with the newly created
3653 +Alsaplayer session.
3655 +------------------------------------------------------------
3657 +** emacspeak-amphetadesk
3661 +------------------------------------------------------------
3663 +** emacspeak-amphetadesk-quick-add
3665 +Quick add URL to Amphetadesk by prompting for URL.
3667 +------------------------------------------------------------
3669 +** emacspeak-appt-repeat-announcement Key Sequence: control e cap A
3671 +Speaks the most recently displayed appointment message if any.
3673 +------------------------------------------------------------
3675 +** emacspeak-atom-browse
3677 +Browse specified ATOM feed.
3679 +------------------------------------------------------------
3681 +** emacspeak-atom-display
3683 +Retrieve and display ATOM URL.
3685 +------------------------------------------------------------
3687 +** emacspeak-daisy-open-book Key Sequence: control e control b
3689 +Open Digital Talking Book specified by navigation file filename.
3691 +This is the main entry point to the Emacspeak Daisy reader.
3692 +Opening a Daisy navigation file (.ncx file) results in a
3693 +navigation buffer that can be used to browse and read the book.
3695 +------------------------------------------------------------
3697 +** emacspeak-filtertext Key Sequence: control e ^
3699 +Copy over text in region to special filtertext buffer in
3700 +preparation for interactively filtering text.
3702 +------------------------------------------------------------
3704 +** emacspeak-freeamp
3706 +Play specified resource using freeamp.
3707 +Resource is an MP3 file or m3u playlist.
3708 +The player is placed in a buffer in emacspeak-freeamp-mode.
3710 +------------------------------------------------------------
3712 +** emacspeak-freeamp-freeamp-call-command
3714 +Call appropriate freeamp command.
3716 +------------------------------------------------------------
3718 +** emacspeak-freeamp-freeamp-command
3720 +Execute FreeAmp command.
3722 +------------------------------------------------------------
3724 +** emacspeak-gridtext-apply
3726 +Apply grid to region.
3728 +------------------------------------------------------------
3730 +** emacspeak-gridtext-load
3732 +Load saved grid settings.
3734 +------------------------------------------------------------
3736 +** emacspeak-gridtext-save
3738 +Save out grid settings.
3740 +------------------------------------------------------------
3742 +** emacspeak-hide-or-expose-all-blocks
3744 +Hide or expose all blocks in buffer.
3746 +------------------------------------------------------------
3748 +** emacspeak-hide-or-expose-block Key Sequence: control e j
3750 +Hide or expose a block of text.
3751 +This command either hides or exposes a block of text
3752 +starting on the current line. A block of text is defined as
3753 +a portion of the buffer in which all lines start with a
3754 +common PREFIX. Optional interactive prefix arg causes all
3755 +blocks in current buffer to be hidden or exposed.
3757 +------------------------------------------------------------
3759 +** emacspeak-hide-speak-block-sans-prefix Key Sequence: control e control j
3761 +Speaks current block after stripping its prefix.
3762 +If the current block is not hidden, it first hides it.
3763 +This is useful because as you locate blocks, you can invoke this
3764 +command to listen to the block,
3765 +and when you have heard enough navigate easily to move past the block.
3767 +------------------------------------------------------------
3773 +------------------------------------------------------------
3775 +** emacspeak-info-wizard Key Sequence: control h TAB
3777 +Read a node spec from the minibuffer and launch
3779 +See documentation for command `Info-goto-node' for details on
3782 +------------------------------------------------------------
3784 +** emacspeak-m-player Key Sequence: control e :
3786 +Play specified resource using m-player.
3787 +Resource is an MP3 file or m3u playlist.
3788 +The player is placed in a buffer in emacspeak-m-player-mode.
3790 +------------------------------------------------------------
3792 +** emacspeak-madplay
3794 +Play specified resource using madplay.
3795 +Resource is an MP3 file or directory containing mp3 files.
3796 +The player is placed in a buffer in emacspeak-madplay-mode.
3798 +------------------------------------------------------------
3800 +** emacspeak-madplay-madplay-call-command
3802 +Call appropriate madplay command.
3804 +------------------------------------------------------------
3806 +** emacspeak-madplay-madplay-command
3808 +Execute Madplay command.
3810 +------------------------------------------------------------
3812 +** emacspeak-ocr Key Sequence: control e control o
3814 +An OCR front-end for the Emacspeak desktop.
3816 +Page image is acquired using tools from the SANE package.
3817 +The acquired image is run through the OCR engine if one is
3818 +available, and the results placed in a buffer that is
3819 +suitable for browsing the results.
3821 +For detailed help, invoke command emacspeak-ocr bound to
3822 +C-e C-o to launch emacspeak-ocr-mode, and press
3823 +`?' to display mode-specific help for emacspeak-ocr-mode.
3825 +------------------------------------------------------------
3827 +** emacspeak-realaudio Key Sequence: control e ;
3829 +Start or control streaming audio including MP3 and
3830 +realaudio. If using `TRPlayer' as the player, accepts
3831 +trplayer control commands if a stream is already playing.
3832 +Otherwise, the playing stream is simply stopped. If no
3833 +stream is playing, this command prompts for a realaudio
3834 +resource. Realaudio resources can be specified either as a
3835 +Realaudio URL, the location of a local Realaudio file, or as
3836 +the name of a local Realaudio metafile. Realaudio resources
3837 +you have played in this session are available in the
3838 +minibuffer history. The default is to play the resource you
3839 +played most recently. Emacspeak uses the contents of the
3840 +directory specified by variable
3841 +emacspeak-realaudio-shortcuts-directory to offer a set of
3842 +completions. Hit space to use this completion list.
3844 +If using TRPlayer, you can either give one-shot commands
3845 +using command emacspeak-realaudio available from anywhere on
3846 +the audio desktop as `C-e ;'.
3847 +Alternatively, switch to buffer *realaudio* using
3848 +`C-e ;;' if you wish to issue many
3849 +navigation commands. Note that buffer *realaudio* uses a
3850 +special major mode that provides the various navigation
3851 +commands via single keystrokes.
3853 +------------------------------------------------------------
3855 +** emacspeak-realaudio-browse
3857 +Browse RAM file before playing the selected component.
3859 +------------------------------------------------------------
3861 +** emacspeak-realaudio-get-current-time-in-seconds
3863 +Return current time in seconds.
3865 +------------------------------------------------------------
3867 +** emacspeak-realaudio-play
3869 +Play a realaudio stream. Uses files from your Realaudio
3870 +shortcuts directory for completion. See documentation for
3871 +user configurable variable emacspeak-realaudio-shortcuts-directory.
3873 +------------------------------------------------------------
3875 +** emacspeak-realaudio-set-end-mark
3877 +Set end mark. Default is to set marker to current play time.
3878 +Mark is specified in seconds.
3880 +------------------------------------------------------------
3882 +** emacspeak-realaudio-set-start-mark
3884 +Set start mark. Default is to set marker to current play time.
3885 +Mark is specified in seconds.
3887 +------------------------------------------------------------
3889 +** emacspeak-realaudio-write-mp3-clip
3891 +Writes specified clip from current mp3 stream.
3892 +Prompts for start and end times as well as file to save the clippi
3894 +------------------------------------------------------------
3896 +** emacspeak-remote-connect-to-server Key Sequence: control e meta r
3898 +Connect to and start using remote speech server running on host host
3899 +and listening on port port. Host is the hostname of the remote
3900 +server, typically the desktop machine. Port is the tcp port that that
3901 +host is listening on for speech requests.
3903 +------------------------------------------------------------
3905 +** emacspeak-remote-quick-connect-to-server
3907 +Connect to remote server.
3908 +Does not prompt for host or port, but quietly uses the
3909 +guesses that appear as defaults when prompting.
3910 +Use this once you are sure the guesses are usually correct.
3912 +------------------------------------------------------------
3914 +** emacspeak-remote-ssh-to-server
3916 +Open ssh session to where we came from.
3918 +------------------------------------------------------------
3920 +** emacspeak-rss-browse Key Sequence: control e control u
3922 +Browse specified RSS feed.
3924 +------------------------------------------------------------
3926 +** emacspeak-rss-display
3928 +Retrieve and display RSS URL.
3930 +------------------------------------------------------------
3932 +** emacspeak-speak-current-field Key Sequence: control e .
3934 +Speak current field.
3936 +defined by Emacs 21.
3938 +------------------------------------------------------------
3940 +** emacspeak-tabulate-region Key Sequence: control e i
3942 +Voicifies the white-space of a table if one found. Optional interactive prefix
3943 +arg mark-fields specifies if the header row information is used to mark fields
3944 +in the white-space.
3946 +------------------------------------------------------------
3948 +** emacspeak-tapestry-describe-tapestry Key Sequence: control e meta t
3950 +Describe the current layout of visible buffers in current frame.
3951 +Use interactive prefix arg to get coordinate positions of the
3954 +------------------------------------------------------------
3956 +** emacspeak-tapestry-select-window-by-name Key Sequence: control e cap W
3958 +Select window by the name of the buffer it displays.
3959 +This is useful when using modes like ECB or the new GDB UI where
3960 + you want to preserve the window layout
3961 +but quickly switch to a window by name.
3963 +------------------------------------------------------------
3965 +** emacspeak-url-template-fetch Key Sequence: control e u
3967 +Fetch a pre-defined resource.
3968 +Use Emacs completion to obtain a list of available resources.
3969 +Resources typically prompt for the relevant information
3970 +before completing the request.
3971 +Optional interactive prefix arg displays documentation for specified resource.
3973 +------------------------------------------------------------
3975 +** emacspeak-url-template-load
3977 +Load URL template resources from specified location.
3979 +------------------------------------------------------------
3981 +** emacspeak-w3-browse-atom-at-point
3983 +Browses Atom url under point.
3985 +------------------------------------------------------------
3987 +** emacspeak-w3-browse-rss-at-point
3989 +Browses RSS url under point.
3991 +------------------------------------------------------------
3993 +** emacspeak-w3-browse-url-with-style
3995 +Browse URL with specified XSL style.
3997 +------------------------------------------------------------
3999 +** emacspeak-w3-browse-xml-url-with-style
4001 +Browse XML URL with specified XSL style.
4003 +------------------------------------------------------------
4005 +** emacspeak-w3-class-filter-and-follow
4007 +Follow url and point, and filter the result by specified class.
4008 +Class can be set locally for a buffer, and overridden with an
4009 +interactive prefix arg. If there is a known rewrite url rule, that is
4012 +------------------------------------------------------------
4014 +** emacspeak-w3-count-matches
4016 +Count matches for locator in HTML.
4018 +------------------------------------------------------------
4020 +** emacspeak-w3-count-nested-tables
4022 +Count nested tables in HTML.
4024 +------------------------------------------------------------
4026 +** emacspeak-w3-count-tables
4028 +Count tables in HTML.
4030 +------------------------------------------------------------
4032 +** emacspeak-w3-curl-url-under-point
4034 +Display contents of URL under point using Curl and W3. The
4035 +document is displayed in a separate buffer.
4037 +------------------------------------------------------------
4039 +** emacspeak-w3-extract-by-class
4041 +Extract elements having specified class attribute from HTML. Extracts
4042 +specified elements from current WWW page and displays it in a separate
4043 +buffer. Optional arg url specifies the page to extract content from.
4044 +Interactive use provides list of class values as completion.
4046 +------------------------------------------------------------
4048 +** emacspeak-w3-extract-by-class-list
4050 +Extract elements having class specified in list `classes' from HTML.
4051 +Extracts specified elements from current WWW page and displays it in a
4052 +separate buffer. Optional arg url specifies the page to extract
4053 +content from. Interactive use provides list of class values as
4056 +------------------------------------------------------------
4058 +** emacspeak-w3-extract-media-streams
4060 +Extract links to media streams.
4061 +operate on current web page when in a W3 buffer; otherwise prompt for url.
4062 +`prompt-url' is the URL to process. Prompts for URL when called
4063 +interactively. Optional arg `speak' specifies if the result should be
4064 +spoken automatically.
4066 +------------------------------------------------------------
4068 +** emacspeak-w3-extract-nested-table
4070 +Extract nested table specified by `table-index'. Default is to
4071 +operate on current web page when in a W3 buffer; otherwise
4072 +`prompt-url' is the URL to process. Prompts for URL when called
4073 +interactively. Optional arg `speak' specifies if the result should be
4074 +spoken automatically.
4076 +------------------------------------------------------------
4078 +** emacspeak-w3-extract-nested-table-list
4080 +Extract specified list of tables from a WWW page.
4082 +------------------------------------------------------------
4084 +** emacspeak-w3-extract-node-by-id
4086 +Extract specified node from URI.
4088 +------------------------------------------------------------
4090 +** emacspeak-w3-extract-print-streams
4092 +Extract links to printable streams.
4093 +operate on current web page when in a W3 buffer; otherwise prompt for url.
4094 +`prompt-url' is the URL to process. Prompts for URL when called
4095 +interactively. Optional arg `speak' specifies if the result should be
4096 +spoken automatically.
4098 +------------------------------------------------------------
4100 +** emacspeak-w3-extract-table-by-match
4102 +Extract table containing specified match.
4103 + Optional arg url specifies the page to extract content from.
4104 +Interactive prefix arg causes url to be read from the minibuffer.
4106 +------------------------------------------------------------
4108 +** emacspeak-w3-extract-table-by-position
4110 +Extract table at specified position.
4111 + Optional arg url specifies the page to extract content from.
4112 +Interactive prefix arg causes url to be read from the minibuffer.
4114 +------------------------------------------------------------
4116 +** emacspeak-w3-extract-tables-by-match-list
4118 +Extract specified tables from a WWW page.
4119 +Tables are specified by containing match pattern
4120 + found in the match list.
4122 +------------------------------------------------------------
4124 +** emacspeak-w3-extract-tables-by-position-list
4126 +Extract specified list of nested tables from a WWW page.
4127 +Tables are specified by their position in the list
4128 +nested of tables found in the page.
4130 +------------------------------------------------------------
4132 +** emacspeak-w3-google-on-this-site
4134 +Perform a google search restricted to the current WWW site.
4136 +------------------------------------------------------------
4138 +** emacspeak-w3-google-similar-to-this-page
4140 +Ask Google to find documents similar to this one.
4142 +------------------------------------------------------------
4144 +** emacspeak-w3-google-who-links-to-this-page
4146 +Perform a google search to locate documents that link to the
4149 +------------------------------------------------------------
4151 +** emacspeak-w3-preview-this-buffer
4153 +Preview this buffer.
4155 +------------------------------------------------------------
4157 +** emacspeak-w3-preview-this-region
4159 +Preview this region.
4161 +------------------------------------------------------------
4163 +** emacspeak-w3-realaudio-play-url-at-point
4165 +Play url under point as realaudio
4167 +------------------------------------------------------------
4169 +** emacspeak-w3-set-xsl-keep-result
4171 +Set value of `emacspeak-w3-xsl-keep-result'.
4173 +------------------------------------------------------------
4175 +** emacspeak-w3-xpath-filter-and-follow
4177 +Follow url and point, and filter the result by specified xpath.
4178 +XPath can be set locally for a buffer, and overridden with an
4179 +interactive prefix arg. If there is a known rewrite url rule, that is
4182 +------------------------------------------------------------
4184 +** emacspeak-w3-xsl-toggle
4186 +Toggle application of XSL transformations.
4187 +This uses XSLT Processor xsltproc available as part of the
4190 +------------------------------------------------------------
4192 +** emacspeak-w3-xslt-apply
4194 +Apply specified transformation to current page.
4196 +------------------------------------------------------------
4198 +** emacspeak-w3-xslt-filter
4200 +Extract elements matching specified XPath path locator
4201 +from HTML. Extracts specified elements from current WWW
4202 +page and displays it in a separate buffer. Optional arg url
4203 +specifies the page to extract table from.
4204 +Optional arg COMPLEMENT inverts the filter.
4206 +------------------------------------------------------------
4208 +** emacspeak-w3-xslt-select
4210 +Select XSL transformation applied to WWW pages before they are displayed .
4212 +------------------------------------------------------------
4214 +** emacspeak-websearch-dispatch Key Sequence: control e ?
4216 +Launches specific websearch queries.
4217 +Press `?' to list available search engines.
4218 +Once selected, the selected searcher prompts for additional information as appropriate.
4219 +When using W3, this interface attempts to speak the most relevant information on the result page.
4221 +------------------------------------------------------------
4223 +** emacspeak-websearch-emapspeak-near-my-location
4225 +Perform search relative to `my-location'.
4227 +------------------------------------------------------------
4229 +** emacspeak-websearch-google
4231 +Perform a Google search.
4232 +Optional interactive prefix arg `lucky' is equivalent to hitting the
4233 +I'm Feeling Lucky button on Google.
4235 +------------------------------------------------------------
4237 +** emacspeak-websearch-google-search-in-date-range
4239 +Use this from inside the calendar to do Google date-range searches.
4241 +------------------------------------------------------------
4243 +** emacspeak-websearch-usenet Key Sequence: control e cap U
4245 +Prompt and browse a Usenet newsgroup.
4246 +Optional interactive prefix arg results in prompting for a search term.
4248 +------------------------------------------------------------
4250 +** emacspeak-websearch-usenet-search
4252 +Search a Usenet newsgroup.
4254 +------------------------------------------------------------
4256 +** emacspeak-xml-shell
4258 +Start Xml-Shell on contents of system-id.
4264 +paragraph-separate: "[
\f]*$"
4267 --- emacspeak-24.orig/debian/emacspeakconfig
4268 +++ emacspeak-24/debian/emacspeakconfig
4272 +# emacspeakconfig - configuration script for emacspeak
4274 +# This script sets values in /etc/emacspeak.conf, which override the
4275 +# defaults compiled into emacspeak TCL scripts and .elc files.
4276 +# Values in the user's environment will override those in
4277 +# /etc/emacspeak.conf
4279 +# Written by Jim Van Zandt <jrv@debian.org> for Debian Linux,
4280 +# and hereby placed in the public domain for use by anyone.
4284 +CFG=/etc/emacspeak.conf
4285 +GROUPFILE=/etc/group
4286 +DRIVERDIR=/usr/lib/emacs/common/emacspeak/drivers
4287 +USUAL=/usr/share/emacs/site-lisp/emacspeak
4289 +# on a Slackware or Red Hat system, a user may attempt configuration
4290 +# with awk missing.
4291 +if [ -x /usr/bin/awk -o -x /bin/awk ]; then true; else
4295 +Please execute /usr/sbin/emacspeakconfig again after installing it.
4298 + echo -n "Press Enter: "; read junk;
4302 +set -- `getopt i $*`
4305 + echo 'Usage: emacspeakconfig [-i]'
4314 + initial=yes; shift;;
4320 +#echo initial=$initial
4322 +# if there is no configuration file, then create one
4323 +if [ -s $CFG ]; then
4327 +# emacspeak configuration file
4330 +if [ "$DTK_PROGRAM" = "" ]; then
4333 +if [ "$DTK_TCL" = "" ]; then
4336 +if [ "$DTK_PORT" = "" ]; then
4339 +if [ "$DTK_DEVICE" = "" ]; then
4342 +export DTK_PROGRAM DTK_PORT DTK_DEVICE
4343 +if [ "$DTK_TCL" != "" ]; then export DTK_TCL; fi
4347 +# if the configuration file does not set the DTK_DEVICE variable, then
4349 +if grep 'export.*DTK_DEVICE' $CFG >/dev/null ; then
4354 + print "if [ \"$DTK_DEVICE\" = \"\" ]; then";
4355 + print "DTK_DEVICE=";
4357 + print "export DTK_PROGRAM DTK_PORT DTK_DEVICE";
4358 + print "if [ \"$DTK_TCL\" != \"\" ]; then export DTK_TCL; fi";
4360 + {print;}' $CFG > $CFG.TMP && mv $CFG.TMP $CFG
4363 +# return success if answer is "yes"
4365 +# first argument is question
4366 +# second argument is default answer
4368 + echo -n "$1 [$2]: "; read ans;
4369 + if [ "$ans" = "" ]; then ans=$2; fi
4370 + if [ "$ans" = "y" -o "$ans" = "Y" -o "$ans" = "yes" ]; then return 0; fi
4371 + if [ "$ans" = "n" -o "$ans" = "N" -o "$ans" = "no" ]; then return 1; fi
4375 +# set TEXT to a string typed by the user
4377 +# first argument is question
4378 +# second argument is default answer
4379 +echo -n "$1 [$2]: "; read ans;
4380 +if [ "$ans" = "" ]; then ans=$2; fi
4384 +# get parameters for some new synthesizer
4386 + text "Please enter the name of the synthesizer" "$DEVICE"; DEVICE=$TEXT
4387 + if [ "$TCL" = "tcl" ]; then IS_TCL=y; else IS_TCL=n; fi
4388 + if yesno "Is the speech server a TCL script? " $IS_TCL ; then
4389 + echo "These files in $USUAL/servers appear to be TCL scripts:"
4390 + (cd $USUAL/servers; grep -l dectalk_globals * 2>/dev/null)
4391 + text "Please enter the name (not path) of the $DEVICE speech server" \
4396 + text "Please enter the full path name of the $DEVICE speech server" \
4401 + if echo $PORT|grep '^/dev/ttyS' >/dev/null; then ans=y; else ans=n; fi;
4402 + if yesno "Is the $DEVICE connected to a serial port?" $ans ; then
4406 + while [ "$valid" = "no" ]; do
4407 + text "Please enter the device (for example, /dev/lp0): " \
4410 + if check_port; then valid=yes; fi
4415 +# echo "PROGRAM=$PROGRAM, TCL=$TCL, PORT=$PORT"
4418 +# print warning if a program does not exist
4420 +if [ -x $TCL -o -x /usr/bin/$TCL ]; then true; else
4422 + echo "NOTICE: Before using Emacspeak, please install"
4425 + echo -n "Press Enter to continue: "; read junk;
4429 +# return success if $PORT is (or will be) a valid character device
4432 +if [ -c "$PORT" ]; then return 0; fi
4433 +echo "$PORT is not a character device"
4434 +yesno "Will $PORT be compiled into the kernel or loaded as a module?" "y"
4437 +# give a user a supplementary group ID
4439 +# usage: enroll user1[,user2...] group1[,group2...]
4447 + print "requires two arguments" >"/dev/stderr";
4451 + if (userlist!~/^[a-z][a-z,]*$/) {
4452 + print "invalid user list" >"/dev/stderr";
4455 + nu=split(userlist,user,",");
4456 + grouplist=ARGV[2];
4457 + if (grouplist!~/^[a-z][a-z,]*$/) {
4458 + print "invalid group list" >"/dev/stderr";
4461 + ng=split(grouplist,group,",");
4462 +# printf("%d users: ",nu);
4463 +# for (i=1; i<=nu; i++) printf("%s ", user[i]);
4465 +# printf("%d groups: ",ng);
4466 +# for (i=1; i<=nu; i++) printf("%s ", group[i]);
4472 + for (i=1; i<=ng; i++) {
4473 + if ($1~group[i]) {
4474 + if (NF==3) { # no group members yet
4476 + } else { # already some group members
4479 + split($4,names,",");
4480 + for (j in names) {member[names[j]]=1;}
4481 + for (j=1;j <= nu;j++) {member[user[j]]=1;}
4483 + for (name in member) {$4=$4 "," name;}
4489 +}' $1 $2 $GROUPFILE >$GROUPFILE.$$ && mv $GROUPFILE.$$ $GROUPFILE
4492 +# take a supplementary group ID away from a user
4494 +# usage: dismiss user1[,user2...] group1[,group2...]
4502 + print "requires two arguments" >"/dev/stderr";
4506 + if (userlist!~/^[a-z][a-z,]*$/) {
4507 + print "invalid user list" >"/dev/stderr";
4510 + nu=split(userlist,user,",");
4511 + grouplist=ARGV[2];
4512 + if (grouplist!~/^[a-z][a-z,]*$/) {
4513 + print "invalid group list" >"/dev/stderr";
4516 + ng=split(grouplist,group,",");
4517 +#printf("userlist=%s\n",userlist);
4518 +#printf("%d users: ",nu); for (i=1; i<=nu; i++) printf("%s ", user[i]); printf("\n");
4519 +#printf("%d groups: ",ng); for (i=1; i<=nu; i++) printf("%s ", group[i]); printf("\n");
4524 + for (i=1; i<=ng; i++) {
4525 + if ($1~group[i]) {
4526 + if (NF==3) { # no group members yet
4527 + } else { # already some group members
4530 + split($4,names,",");
4531 + for (j in names) {member[names[j]]=1;}
4532 + for (j=1;j <= nu;j++) {delete member[user[j]];}
4534 + for (name in member) {$4=$4 "," name;}
4540 +}' $1 $2 $GROUPFILE >$GROUPFILE.$$ && mv $GROUPFILE.$$ $GROUPFILE
4543 +# get the current parameter values (if any) from the configuration file
4544 +if [ -s $CFG ]; then
4545 + PORT=`awk 'BEGIN{FS="="}/^ *DTK_PORT/{print $2}' $CFG`
4546 + TCL=`awk 'BEGIN{FS="="}/^ *DTK_TCL/{print $2}' $CFG`
4547 + PROGRAM=`awk 'BEGIN{FS="="}/^ *DTK_PROGRAM/{print $2}' $CFG`
4549 + / *DTK_DEVICE="?.*"?/{
4550 + word=substr($0,index($0,"=")+1);
4551 + gsub(/\"/,"",word);
4552 + if (length(word) == 0) word="DECtalk Express";
4558 +#echo initial values are: PROGRAM=$PROGRAM TCL=$TCL PORT=$PORT DEVICE=$DEVICE
4559 +#echo getting speech server choice
4561 +# There must be a file foo.blurb in $BLURBS for each distinct
4562 +# combination of speech server and hardware device. It contains lines
4563 +# beginning with a single word and a colon (anything else is ignored).
4564 +# The valid words are
4565 +# blurb: the description to print
4566 +# device: value for DTK_DEVICE (supplies default for next time)
4567 +# tcl: value for DTK_TCL
4568 +# program: value for DTK_PROGRAM
4570 +# get synthesizer name
4571 +if [ $initial = no -o "$PROGRAM" = "" -o "$TCL" = "" ]; then
4573 + while [ $valid = no ]; do
4575 + # first pass: print menu
4578 + printf("Please enter the number of your choice:\n\n");
4580 + cmd = "ls " ARGV[1] "/blurbs/*.blurb";
4581 + while (cmd|getline >0){bname[++n] = $1;}
4582 + for (i = 1; i <= n; i++){
4583 + while (getline < bname[i] > 0){
4584 + if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
4585 + if ($0 ~ /^program:/){program[i] = $2;}
4586 + if ($0 ~ /^tcl:/){tcl[i] = $2;}
4587 + if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
4590 + printf(" %2d %s\n", i, blurb[i]);
4592 + printf(" o other. I can provide the filename\n");
4593 + printf(" a abort, and restart configuration after\n");
4594 + printf(" installation of another speech server package\n");
4595 + }' $USUAL "$DEVICE"
4597 + # second pass: determine default choice
4601 + cmd = "ls " ARGV[1] "/blurbs/*.blurb";
4602 + while (cmd|getline >0){bname[++n] = $1;}
4603 + for (i = 1; i <= n; i++){
4604 + while (getline < bname[i] > 0){
4605 + if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
4606 + if ($0 ~ /^program:/){program[i] = $2;}
4607 + if ($0 ~ /^tcl:/){tcl[i] = $2;}
4608 + if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
4610 + if (index(device[i],ARGV[2])){deflt=i;}
4611 + if (index(device[i],"DECtalk Express")){decexp=i;}
4614 + if (deflt == 0) print decexp;
4616 + }' $USUAL "$DEVICE" `
4618 + # get answer from user
4619 + text "Number" $area; area=$TEXT
4621 + # third pass: set shell variables according to his choice
4625 + cmd = "ls " ARGV[1] "/blurbs/*.blurb";
4626 + while (cmd|getline >0){bname[++n] = $1;}
4627 + for (i = 1; i <= n; i++){
4628 + while (getline < bname[i] > 0){
4629 + if ($0 ~ /^blurb:/){$1 = ""; blurb[i] = $0;}
4630 + if ($0 ~ /^program:/){program[i] = $2;}
4631 + if ($0 ~ /^tcl:/){tcl[i] = $2;}
4632 + if ($0 ~ /^device:/){$1 = ""; device[i] = $0;}
4634 + if (i == ARGV[2]){
4635 + sub(/^ */,"",device[i]);
4636 + printf("PROGRAM=%s; TCL=%s; DEVICE=\"%s\"; valid=yes;\n", \
4637 + program[i], tcl[i], device[i]);
4641 + if [ "$area" = "a" ]; then exit 0; fi
4642 + if [ "$area" = "0" -o "$area" = "o" -o "$area" = "O" ]; then
4645 + if [ "$PROGRAM" = "none" -o "$PROGRAM" = "" ]; then check_pgm; fi
4649 +#echo new values are: DEVICE=$DEVICE PROGRAM=$PROGRAM TCL=$TCL PORT=$PORT
4652 +if [ "$DEVICE" = "DoubleTalk PC" ]; then
4656 + if [ "$IN_PORT" = "" -o "$IN_PORT" = "/dev/dtlk" ]; then
4657 + IN_PORT=/dev/ttyS0;
4660 +if [ $HAVE_PORT = no ]; then
4661 + if [ $initial = no -o "$PORT" = "" ]; then
4663 + while [ $valid = no ]; do
4665 + Your speech synthesizer is connected to which port, if any?
4666 + (The first serial port would be /dev/ttyS0.
4667 + This is ignored for a software synthesizer)" $IN_PORT
4669 + if check_port $PORT; then valid=yes; fi
4675 +#echo emacspeak is configured for $DEVICE attached to $PORT
4677 +# adjust unix device group membership if needed
4678 +if [ -c "$PORT" ]; then
4679 + DEVICEGROUP=`ls -l -L $PORT|awk '{print $4}'`
4681 + if [ "$DEVICE" = "DoubleTalk PC" -a -f /etc/makedev.cfg ]; then
4682 + DEVICEGROUP=`awk '/audio:/{print $4}' /etc/makedev.cfg`
4686 + echo "$PORT is assumed to be in group: $DEVICEGROUP"
4689 +if [ $DEVICEGROUP = root ];
4691 + echo "$PORT is in group: root"
4692 + echo "please move it to another group with chown,"
4693 + echo "then repeat emacspeak configuration"
4697 +# skip the enrolling of additional users if there is already at least
4698 +# one user, and it's the initial installation
4699 +MEMBERS=`grep ^${DEVICEGROUP} $GROUPFILE|awk 'BEGIN{FS=":"}{print $4}'`
4700 +if [ "$MEMBERS" = "" -o $initial = no ];
4703 + echo $PORT can be accessed by members of the group: $DEVICEGROUP.
4704 + if [ "$MEMBERS" = "" ];
4705 + then echo "Currently, no users are in group $DEVICEGROUP";
4706 + else echo "Currently, these users are in group $DEVICEGROUP: $MEMBERS";
4709 + while [ $finished = no ]; do
4711 + echo "If you wish to enroll any other users into group $DEVICEGROUP,"
4712 + echo "(even if their accounts have not been created yet),"
4713 + echo -n "please list their usernames here separated by commas: "
4715 + if [ "$USERS" = "" ] || enroll $USERS $DEVICEGROUP; then
4720 + while [ $finished = no ]; do
4722 + echo "If you wish to remove any users from group $DEVICEGROUP,"
4723 + echo -n "please list their usernames here separated by commas: "
4725 + if [ "$USERS" = "" ] || dismiss $USERS $DEVICEGROUP; then
4732 +echo "You may reconfigure emacspeak at any time by running emacspeakconfig as root"
4734 +# make sure the group has both read and write permissions
4735 +if [ -e "$PORT" ]; then chmod g+rw $PORT; fi
4737 +# update the configuration file
4738 +sed -e "s@^ *DTK_PROGRAM=.*@ DTK_PROGRAM=$PROGRAM@" \
4739 + -e "s@^ *DTK_PORT=.*@ DTK_PORT=$PORT@" \
4740 + -e "s@^ *DTK_TCL=.*@ DTK_TCL=$TCL@" \
4741 + -e "s@^ *DTK_DEVICE=.*@ DTK_DEVICE=\"$DEVICE\"@" \
4742 + $CFG > $CFG.TMP && mv $CFG.TMP $CFG
4743 --- emacspeak-24.orig/debian/emacsen-startup
4744 +++ emacspeak-24/debian/emacsen-startup
4746 +;; -*-emacs-lisp-*-
4747 +;; /etc/emacs/site-start.d/50emacspeak.el
4749 +;; Emacs startup file for the Debian emacspeak package
4751 +;; Originally contributed by Nils Naumann <naumann@unileoben.ac.at>
4752 +;; Modified by Dirk Eddelbuettel <edd@debian.org>
4753 +;; Adapted for dh-make by Jim Van Zandt <jrv@vanzandt.mv.com>
4755 +;; The emacspeak package follows the Debian/GNU Linux 'emacsen' policy and
4756 +;; byte-compiles its elisp files for each 'emacs flavor' (emacs19,
4757 +;; xemacs19, emacs20, xemacs20...). The compiled code is then
4758 +;; installed in a subdirectory of the respective site-lisp directory.
4759 +;; We have to add this to the load-path:
4760 +(let ((package-dir (concat "/usr/share/"
4761 + (symbol-name flavor)
4762 + "/site-lisp/emacspeak"))
4763 + (source-dir "/usr/share/emacs/site-list/emacspeak"))
4764 + (when (file-directory-p package-dir)
4765 + (setq load-path (cons package-dir (cons source-dir load-path)))))
4767 --- emacspeak-24.orig/debian/emacspeak.conf
4768 +++ emacspeak-24/debian/emacspeak.conf
4770 +# emacspeak configuration file
4773 +if [ "$DTK_PROGRAM" = "" ]; then
4776 +if [ "$DTK_PORT" = "" ]; then
4779 +if [ "$DTK_TCL" = "" ]; then
4782 +if [ "$DTK_DEVICE" = "" ]; then
4785 +export DTK_PROGRAM DTK_PORT DTK_DEVICE
4786 +if [ "$DTK_TCL" != "" ]; then export DTK_TCL; fi
4787 --- emacspeak-24.orig/debian/emacspeak-initialization
4788 +++ emacspeak-24/debian/emacspeak-initialization
4790 +Following is Raman's sample code to add to ~/.emacs to start
4791 +emacspeak. File locations are different in a Debian system. - Jim Van Zandt
4793 +emacspeak initialization...
4794 +Anyone who copies this blindly without bothering to
4795 +understand what it does will get what they deserve:-)
4797 + ;;{{{ Load and customize emacspeak
4800 + (unless (featurep 'emacspeak)
4802 + (expand-file-name "~/emacs/lisp/emacspeak/emacspeak-setup.el")))
4804 + (when (featurep 'emacspeak)
4805 + (declare (special emacspeak-play-program emacspeak-play-args
4806 + emacspeak-auditory-icon-function
4807 + dtk-default-speech-rate))
4808 + (if (file-exists-p "/usr/demo/SOUND/play")
4810 + emacspeak-play-program "/usr/demo/SOUND/play"
4811 + emacspeak-play-args "-i"
4812 + emacspeak-auditory-icon-function
4813 + 'emacspeak-play-auditory-icon))
4814 + (if (file-exists-p "/usr/bin/audioplay")
4816 + emacspeak-play-program "/usr/bin/audioplay"
4817 + emacspeak-play-args "-i"
4818 + emacspeak-auditory-icon-function 'emacspeak-play-auditory-icon))
4819 + (setq dtk-default-speech-rate 485)
4820 + (emacspeak-pronounce-load-dictionaries "~/.emacspeak/.dictionary")
4821 + (dtk-set-rate 480 t)
4822 + (unless blackdog-p (emacspeak-toggle-auditory-icons t)))
4825 --- emacspeak-24.orig/debian/decexp.blurb
4826 +++ emacspeak-24/debian/decexp.blurb
4828 +blurb: DECtalk Express
4831 +device: DECtalk Express
4832 --- emacspeak-24.orig/debian/decmv.blurb
4833 +++ emacspeak-24/debian/decmv.blurb
4835 +blurb: DECtalk Multivoice
4838 +device: DECtalk Multivoice
4839 --- emacspeak-24.orig/debian/decsoft.blurb
4840 +++ emacspeak-24/debian/decsoft.blurb
4842 +blurb: Software DECtalk
4845 +device: sound card with Software DECtalk
4846 --- emacspeak-24.orig/debian/decthree.blurb
4847 +++ emacspeak-24/debian/decthree.blurb
4853 --- emacspeak-24.orig/debian/dtksoft.blurb
4854 +++ emacspeak-24/debian/dtksoft.blurb
4856 +blurb: Software DECtalk
4859 +device: Software DECtalk
4860 --- emacspeak-24.orig/debian/outloud.blurb
4861 +++ emacspeak-24/debian/outloud.blurb
4863 +blurb: ViaVoice Outloud
4866 +device: ViaVoice Outloud
4867 --- emacspeak-24.orig/debian/remote-tcl.blurb
4868 +++ emacspeak-24/debian/remote-tcl.blurb
4870 +blurb: Remote DECtalk server
4871 +program: remote-tcl
4872 +tcl: /usr/share/emacs/site-lisp/emacspeak/servers/remote-tcl
4873 +device: a speech server on another computer
4874 --- emacspeak-24.orig/debian/emacspeak.1
4875 +++ emacspeak-24/debian/emacspeak.1
4877 +..\"{{{ Title Emacs major mode should be: -*- nroff -*-
4878 +.TH EMACSPEAK 1 "December 1, 1999"
4882 +emacspeak \- speech output interface to Emacs
4889 +.RI "[ " options " ] [ " file... " ]"
4893 +This script starts \fBemacs\fP(1) with speech extensions. \fBemacspeak\fP
4894 +comes with support for the following speech synthesizers: DECtalk Express,
4895 +DECtalk MultiVoice, and software DECtalk on the DEC Alpha.
4896 +.\" or the IBM ViaVoice Outloud.
4897 +Separate speech servers are available to support other synthesizers.
4899 +\fBemacspeak\fP reads the type of text to speech device and the
4900 +port where it is connected from \fI/etc/emacspeak.conf\fP.
4902 +For runtime commands supplied by \fBemacspeak\fP, see the
4903 +\fBEmacspeak-HOWTO\fP, or consult the .info file:
4905 +.B " info emacspeak"
4910 +Use IBM ViaVoice Outloud speech server.
4913 +Use \fBmbrola\fP(1) for speech output.
4916 +Do not process the startup file \fI~/.emacs\fP.
4918 +T. V. Raman, Adobe Systems Incorporated <raman@adobe.com>
4923 +\fI/etc/emacspeak.conf\fP
4929 +.BR emacspeakconfig (8),
4930 +.IR emacspeak.info ,
4931 +.B ftp://leb.net/pub/blinux/emacspeak/blinux.
4935 --- emacspeak-24.orig/debian/emacspeakconfig.8
4936 +++ emacspeak-24/debian/emacspeakconfig.8
4938 +..\"{{{ Title Emacs major mode should be: -*- nroff -*-
4939 +.TH EMACSPEAKCONFIG 8 "February 13, 1998"
4943 +emacspeakconfig \- configure emacspeak
4949 +.BR /usr/sbin/emacspeakconfig " [ " -i " ]"
4953 +This script records in \fI/etc/emacspeak.conf\fP the type of text to
4954 +speech device, the device (port) where it is connected, and the name
4955 +of the speech server used to access it.
4958 +Initial configuration: If \fI/etc/emacspeakconfig\fP exists and has
4959 +all the required entries, then leave it unchanged and ask no
4960 +questions. The default is to ask regardless.
4962 +Jim Van Zandt <jrv@debian.org>
4967 +\fI/etc/emacspeak.conf\fP
4974 --- emacspeak-24.orig/debian/bbc-channels-on-emacspeak.html
4975 +++ emacspeak-24/debian/bbc-channels-on-emacspeak.html
4977 +<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
4978 +<div xmlns="http://www.w3.org/1999/xhtml">
4979 +<p>Since the BBC's various channels are what I listen to the
4980 +most, launching BBC channels has always been a couple of
4981 +keystrokes in Emacspeak. As a first step, directory
4982 +<code>realaudio/radio</code> contains shortcut files for
4983 +launching live streams from the various BBC channels.</p>
4985 +In addition, module <code>emacspeak-url-template</code> defines a
4986 +number of <em>Smart URLs</em> for single-click access to BBC
4987 +programs. The ones I use the most are:</p>
4990 +<li><em>Smart URL</em> <code>BBC Channels On Demand</code>, and </li>
4991 +<li><em>Smart URL</em> <code>BBC Genres On Demand</code></li>
4994 +These <em>smart URLs</em> prompt for the channel or genre
4995 +respectively and bring up a Web page that lists the various shows
4996 +that are available --- note that the BBC archives shows for a
4998 +The resulting Web page is easy to browse in W3; the most
4999 +effective way to skim the buffer is to repeatedly hit
5000 +<code>i</code> which moves through the various items on the page.
5001 +Hitting <code>e e</code> (that's the letter <code>e</code>
5002 +<em>twice</em>) while on a hyperlink will launch the
5003 +corresponding media stream by calling a <em>context-aware</em>
5004 +command that knows about transforming the URL to one that
5005 +accesses the program stream; --- note that simply following the
5006 +hyperlink will get you first to a page about the program, rather
5007 +than to the program stream itself.</p>
5008 +<p>To find out what channels and genres are available, browse the
5009 +BBC Web site --- channel and genre names are not hard-wired into
5010 +Emacspeak since these can change over time with channels and
5011 +genres being added or renamed.</p>
5012 + </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>
5013 --- emacspeak-24.orig/debian/browsing-sourceforge-download-servers.html
5014 +++ emacspeak-24/debian/browsing-sourceforge-download-servers.html
5016 +<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
5017 +<div xmlns="http://www.w3.org/1999/xhtml">
5018 +<p>Sourceforge is a nice service, but it can also be painful to
5019 +use because of the heavy-weight Web page design, and the need to
5020 +repeatedly click before you get the download you want.</p>
5021 +<p>The most irksome of these is the download mechanism provided
5022 +by Sourceforge --- where you first need to browse a list of
5023 +download servers, pick a mirror, and then download what you
5025 +Emacspeak implements a <em>Smart URL</em> that enables one to
5026 +download from Sourceforge in a single step.</p>
5027 +<p>By default, this uses a North American mirror; the behavior
5028 +can be customized if outside the US.
5029 +Use <em>smart URL</em> <code>Sourceforge Browse Mirror</code> and
5030 +specify the name of a SF hosted project when prompted.
5031 +This brings up the index page for the project's download area,
5032 +sorted by date. Move to the bottom of the page and hit
5033 +<code>b</code> to move to the latest available download.</p>
5034 +<p>The <em>smart URL</em> sets up the W3 buffer with a
5035 +context-sensitive download function; when on a download link, hit
5037 +to start downloading. This command will prompt for the URL;
5038 +rather than hitting <code>return</code> (which would bring you to
5039 +the <em>browse mirrors</em> page, hit <code>M-p</code> to get the
5040 +download URL for your SF mirror.
5041 +Note that this wizard uses <code>GNU wget</code> to perform the
5043 +via Emacs module <code>w3-wget</code>.</p>
5044 + </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>
5045 --- emacspeak-24.orig/debian/playing-sudoku-using-auditory-feedback.html
5046 +++ emacspeak-24/debian/playing-sudoku-using-auditory-feedback.html
5048 +<html><head><base href="http://emacspeak.blogspot.com"></head><body bgcolor="white" text="black">
5049 +<div xmlns="http://www.w3.org/1999/xhtml">
5050 +<p>Emacspeak speech-enables <em>SuDoKu</em> implemented by <a href="http://www.columbia.edu/~jr2075/elisp/index.html">sudoku.el</a>.
5051 +Speech-enabling games is an effective means of discovering what
5052 +additions one needs to make to an auditory interface for
5053 +working effectively in an eyes-free environment --- this was
5054 +aptly demonstrated a few years ago by identifying interesting
5055 +<em>conversational gestures</em> by speech-enabling the game of
5056 +<code>Tetris</code> --- see <a href="http://emacspeak.sourceforge.net/raman/publications/assets-98/paper.pdf">Conversational
5057 +Gestures For The Audio Desktop</a> from Assets 1998.</p>
5060 +<h4>Advicing Interactive Commands</h4>
5061 +<p>As with speech-enabling any Emacs module,
5062 +<code>emacspeak-sudoku</code> <em>advices</em> all interactive
5063 +commands to produce spoken feedback.
5064 +In addition to speaking the cell moved to, all navigation
5065 +commands produce an auditory icon that is a function of whether
5066 +the cell value is mutable --- original values cannot be changed
5067 +and this is indicated with a distinctive icon.</p>
5069 +<h4>Additional Interactive Commands</h4>
5071 +<p>Playing SuDoKu effectively requires one to build a good mental
5072 +image of the state of the board as well as the ability to
5073 +effectively query the game for currently active constraints. The
5074 +eye's ability to quickly move around the board and perceive row,
5075 +column and sub-square constraints needs to be compensated for in
5076 +an eyes-free environment. As an example, it is too difficult to
5077 +build the necessary mental model by just listening to the board
5078 +spoken aloud, or by listening to idnividual cells by navigating
5081 +<p>Here are the set of additional interactive commands that
5082 +needed to be added in order to be able to play the game
5086 +<dt><code>r</code></dt>
5087 +<dd>Speak current row.</dd>
5088 +<dt><code>c</code></dt>
5089 +<dd>Speak current column</dd>
5090 +<dt><code>s</code></dt>
5091 +<dd>Speak current sub-square.</dd>
5092 +<dt><code>R</code></dt>
5093 +<dd>Speak number of remaining cells in current row.</dd>
5094 +<dt><code>C</code></dt>
5095 +<dd>Speak number of remaining cells in current column.</dd>
5096 +<dt><code>S</code></dt>
5097 +<dd>Speak number of remaining cells in current sub-square.</dd>
5098 +<dt><code>d</code></dt>
5099 +<dd>Move to the sub-square below the current sub-square.</dd>
5100 +<dt><code>u</code></dt>
5101 +<dd>Move to the sub-square above the current sub-square.</dd>
5102 +<dt><code>n</code></dt>
5103 +<dd>Move to the next sub-square.</dd>
5104 +<dt><code>p</code></dt>
5105 +<dd>Move to the previous sub-square.</dd>
5106 +<dt><code>a</code></dt>
5107 +<dd>Move to the beginning of current row.</dd>
5108 +<dt><code>e</code></dt>
5109 +<dd>Move to the end of the current row.</dd>
5110 +<dt><code>t</code></dt>
5111 +<dd>Move to the top of the current column.</dd>
5112 +<dt><code>b</code></dt>
5113 +<dd>Move to the bottom of the current column.</dd>
5114 +<dt><code>,</code></dt>
5115 +<dd>Speaks information about the overall <em>distribution</em> of
5116 +numbers on the board.
5118 +<li><code>d</code> --- Conveys how many instances of each digit
5119 +have been filled in.</li>
5120 +<li><code>s</code> --- Conveys number of remaining cells in each
5122 +<li><code>r</code> --- Conveys number of remaining cells in each
5124 +<li><code>c</code> --- Conveys number of remaining cells in each
5128 +<dt><code>/</code></dt>
5129 +<dd>Speaks number of remaining cells in the current board.</dd>
5130 +<dt><code>.</code></dt>
5131 +<dd>Speaks value in current cell.</dd>
5134 +<p>Notes on how invormation is spoken:</p>
5136 +<li>Numbers are spoken in groups of 3 to achieve effective
5138 +<li>When navigating by sub-squares, point <em>always</em> moves
5139 +to the top left corner of the sub-square.</li>
5140 +<li>Additional commands bound to <code>M-r</code>,
5141 +<code>M-c</code> and <code>M-s</code> erase the current row,
5142 +column or sub-square respectively. These commands would probably
5143 +be convenient to have independent of whether one is using visual
5147 +<h4>Effectiveness Of The Resulting Interface</h4>
5149 +<p>With the above interface in place, the simpler levels of the
5150 +game are a breeze, levels <em>difficult</em> and <em>evil</em>
5151 +are sufficiently challenging to be fun.</p>
5152 + </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>