Next: , Previous: , Up: Customization   [Contents][Index]


2.4.5 Auto-Reading Buffers

It sometimes useful to start reading some buffers without user’s explicit request. For instance, if a help command is invoked, the user usually wants to read the help text immediately. The following variables contain lists of names of the buffers that may be read automatically if they get changed by the last command and are visible in some window of the current frame.

speechd-speak-auto-speak-buffers

Content of these buffers is read after the command on the above conditions if nothing else (e.g. text around a new cursor position) is to be read.

speechd-speak-force-auto-speak-buffers

Like speechd-speak-auto-speak-buffers except that the buffer content is read forcibly, even when something else could be read.

The following variables define how to handle texts inserted during performing user commands. Only newly inserted text is read, the options don’t affect processing of deleted text. Also, the options don’t affect insertions within commands processed in a special way by speechd-el or user definitions, like self-insert-command.

speechd-speak-buffer-insertions

Defines whether insertions in the current buffer should be read automatically. The value may be one of the following symbols:

nil

Don’t read the inserted texts.

t

Read all the inserted texts.

one-line

Read only the first lines of inserted texts.

whole-buffer

Read whole buffer if it was modified in any way.

speechd-speak-insertions-in-buffers

List of names of buffers, in which insertions are automatically read, whether the buffer is current or not and regardless the speechd-speak-buffer-insertions variable.

speechd-speak-priority-insertions-in-buffers

List of names of buffers, in which insertions are automatically read immediately as they appear, not only after a command is evaluated as with speechd-speak-insertions-in-buffers. This is typically useful in comint buffers.

speechd-speak-align-buffer-insertions

If non-nil, the insertion text to be read is extended to the beginning of the first word affected by the insertion. This is particularly useful in completion functions.

If the last command modified the current buffer and moved its cursor to a completely different position, the new cursor position is not indicated in the alternative output. You can change it through the following variable:

speechd-speak-movement-on-insertions

If t, read the text around new cursor position even when the current buffer was modified. If read-only, read it only in read-only buffers. If nil, don’t read it.


Next: Reading State Changes, Previous: Basic Customization of Speaking, Up: Customization   [Contents][Index]