This module defines the core speech services used by emacsvox. It depends on the speech server interface modules It protects other parts of emacsvox from becoming dependent on the speech server modules
Move to start or end of buffer.
Select buffer by smart cycling. Use option emacsvox-buffer-select-help to customize interactive feedback. By default, this command is bound to multiple keys. The final key of the initial key-sequence, and further invocations of the keys below call the following bindings: , previous-buffer . next-buffer b switch-to-buffer f find-file k emacsvox-kill-buffer-quietly n emacsvox-cycle-to-next-buffer o other-window p emacsvox-cycle-to-previous-buffer
Move to group of choices beginning with character last typed. If no such group exists, then we try to search for that char, or dont move.
Cycles to next buffer having same mode.
Cycles to previous buffer having same mode.
Cycle backward through the mark ring. To cycle forward, use pop-to-mark-command bound to M-x pop-to-mark-command
Speak the current line in the other window.
Select indentation PRESENTATION and preview four-column indentation. Set the option buffer-locally by default. With interactive prefix GLOBAL, also set the global default and use it in the current buffer. (fn PRESENTATION &optional GLOBAL)
Select point PRESENTATION and preview the current line. Set the option buffer-locally by default. With interactive prefix GLOBAL, also set the global default and use it in the current buffer. (fn PRESENTATION &optional GLOBAL)
Run shell command COMMANDAND speak its output. (fn COMMAND)
Speak name of file being visited in current buffer. Speak default directory if invoked in a dired buffer, or when the buffer is not visiting any file. Interactive prefix arg ‘filename’ speaks only the final path component. The result is put in the kill ring for convenience. (fn &optional FILENAME)
tell me what this is (fn CHAR)
Speak a buffer continuously. First prompts using the minibuffer for the kind of action to perform after speaking each chunk, E.G. speak a line at a time etc. Speaking commences at current buffer position. Pressing C-g breaks out, leaving point on last chunk that was spoken. Pressing SPC continues to speak the buffer; any other key quits.
Speak the current kill. This is what will be yanked by the next C-y. Prefix numeric arg, COUNT, specifies that the text that will be yanked as a result of a C-y followed by count-1 M-y be spoken. The kill number that is spoken says what numeric prefix arg to give to command yank. (fn &optional COUNT)
Speak the line containing the mark. With no argument, speaks the line containing the mark–this is where C-x C-x would jump. Numeric prefix arg ‘COUNT’ speaks line containing mark ‘n’ where ‘n’ is one less than the number of times one has to jump using ‘set-mark-command’ to get to this marked position. The location of the mark is indicated by an aural highlight. (fn COUNT)
Speak contents of current window. Speaks entire window irrespective of point.
Read time value as a human-readable string, return seconds. Seconds value is also placed in the kill-ring. (fn TIME)
Property search for face at point see M-x text-property-search-backward
Property search for face — see M-x text-property-search-forward
Speaks current line. With prefix ARG, speaks the rest of the line from point. Negative prefix optional arg speaks from start of line to point. Indicates indentation with a spoken message if audio indentation is on see ‘emacsvox-toggle-audio-indentation’ bound to C-e d i. Indicates position of point with an aural highlight if option ‘emacsvox-show-point’ is on –see command ‘emacsvox-toggle-show-point’ bound to C-e C-d. Lines that start hidden blocks of text, e.g. outline header lines, or header lines of blocks created by command ‘emacsvox-hide-or-expose-block’ are indicated with auditory icon ellipses. Presence of additional presentational overlays (created via property display, before-string, or after-string) is indicated with auditory icon ‘left’, ‘right’, or ‘more’ as appropriate. These can then be spoken using command C-e M-l. This function has :around advice: ‘emacsvox–advice-markdown-speak-line-around’. (fn &optional ARG)
Set up filter for selectively speaking or ignoring portions of lines. The filter is specified as a list of pairs. For example, to filter columns 1 – 10 and 20 – 25, specify filter as ((0 9) (20 25)). Filter settings are persisted across sessions. A persisted filter is used as the default when prompting for a filter. This allows one to accumulate a set of filters for specific files like /var/adm/messages and /var/adm/maillog over time. Option emacsvox-speak-line-invert-filter determines the sense of the filter. (fn FILTER)
Load emacsvox filter settings.
Speaks time value specified as microseconds since epoch. (fn MS)
Speaks time value specified as milliseconds since epoch.. (fn MS)
Move to and speak next field.
Speak the start of, rest of, or the entire page. ‘s’ to speak the start. ‘r’ to speak the rest. any other key to speak entire page.
Persist emacsvox filter settings for future sessions.
Speak character before point.
Speak one of the first 10 windows on the screen, 0 is current window. Speaks entire window irrespective of point. Semantics of ‘other’ is the same as for the Emacs builtin ‘other-window’. (fn &optional ARG)
Move to previous field and speak it.
Speak and return range at point (fn &optional PROP)
Speaks time value specified as seconds since epoch. (fn SECONDS)
Speak current sentence. With prefix ARG, speaks the rest of the sentence from point. Negative prefix arg speaks from start of sentence to point. (fn &optional ARG)
Speak current sexp. With prefix ARG, speaks the rest of the sexp from point. Negative prefix arg speaks from start of sexp to point. (fn &optional ARG)
Speak the start of, rest of, or the entire sexp. ‘s’ to speak the start. ‘r’ to speak the rest. any other key to speak entire sexp.
Skim the current buffer a paragraph at a time.
Spell word at point.
Speaks current visual line. Cues the start of a physical line with auditory icon ‘left’.
Locate paragraphs and voice annotate the first word. Here, paragraph is taken to mean a chunk of text preceded by a blank line. Useful to do this before you listen to an entire buffer.
Speak current word. With prefix ARG, speaks the rest of the word from point. Negative prefix arg speaks from start of word to point. If executed on the same buffer position a second time, the word is spelled out instead of being spoken. (fn &optional ARG)
Speak the start of, rest of, or the entire word. ‘s’ to speak the start. ‘r’ to speak the rest. any other key to speak entire word.
Display current date and time for specified zone. Optional second arg ‘set’ sets the TZ environment variable as well. (fn ZONE &optional SET)
Function to submit a bug to the Emacsvox list
Switch back to buffer that generated completions.
Toggle state of Emacsvox audio indentation. Interactive PREFIX arg means toggle the global default value, and then set the current local value to the result. Specifying the method of indentation as ‘tones’ results in the Dectalk producing a tone whose length is a function of the line’s indentation. Specifying ‘speak’ results in the number of initial spaces being spoken.
Toggle Emacsvox’s default header line.
Toggle state of Emacsvox mail alert. Interactive PREFIX arg means toggle the global default value, and then set the current local value to the result. Turning on this option results in Emacsvox producing an auditory icon indicating the arrival of new mail when displaying the mode line.
String passed to speak help. Set this to the empty string once you’ve learnt this command.
Default Value:
""
Pitch in hertz for the first nonzero indentation column.
Default Value:
250.0
Requested duration in milliseconds for rising-pitch indentation tones. The actual duration is never shorter than the registered blank-line tone.
Default Value:
150
Maximum pitch in hertz for rising-pitch indentation tones.
Default Value:
2000.0
Pitch rise in semitones for each additional indentation column.
Default Value:
1.0
How enabled line indentation is presented. ‘spoken’ says the indentation column. ‘duration-tone’ uses a fixed pitch and increases duration with indentation. ‘pitch-tone’ uses a fixed duration and raises pitch with indentation. The two ‘spoken-...-tone’ values combine the corresponding tone with speech. ‘custom’ publishes indentation facts for personal aural rules, and ‘none’ suppresses presentation while leaving ‘emacsvox-audio-indentation’ enabled.
Default Value:
spoken
Interval in seconds between mail alerts for the same pending message.
Default Value:
300
Mail spool file examined to alert you about newly arrived mail.
Default Value:
"<system-mail-spool>/<login>"
How ‘emacsvox-speak-line’ presents buffer point. ‘voice’ applies the animated voice to the character at point. ‘tone’ and ‘earcon’ place a short marker at the exact text boundary. ‘voice-tone’ and ‘voice-earcon’ combine the corresponding presentations. ‘spoken’ says "point" at the boundary. ‘custom’ publishes point facts for personal aural rules without adding a built-in presentation, and ‘none’ suppresses point presentation while leaving ‘emacsvox-show-point’ enabled.
Default Value:
voice
Functions run after emacsvox-silence is called.
Default Value:
(emacsvox-m-player-pause-or-resume emacsvox-emms-pause-or-resume)
Format for time in brief.
Default Value:
"%l %M"
Format string that specifies how the time should be spoken. See the documentation for function ‘format-time-string’
Default Value:
"%l %M%p on %A %B %_e"
Maximum source characters in one tracked reading chunk. Tracked reading prefers sentence boundaries and uses this limit to keep the position retained after interruption reasonably close to audible playback.
Default Value:
280