2.52 emacsvox-aural-submission

Combine semantic content and explicitly ordered compatibility actions at one frozen source boundary. Legacy entry points remain independent adapters until their callers migrate to this service.

2.52.1 Emacsvox-Aural-Submission Commands

2.52.1.1 emacsvox-aural-toggle-diagnostic-logging

Command: emacsvox-aural-toggle-diagnostic-logging (&optional choose-file)
C-e d D
Toggle sensitive aural diagnostic logging for this Emacs session.

When enabling logging, reuse the last configured file or default to
~/.emacsvox-aural-diagnostics.log.  With prefix argument CHOOSE-FILE, prompt
for the log file.  Diagnostic records include complete spoken text.

(fn &optional CHOOSE-FILE)

2.52.2 emacsvox-aural-submission Options

Variable: User Option emacsvox-aural-diagnostic-log-file
File receiving opt-in aural submission diagnostics.

When non-nil, Emacsvox appends one Lisp plist per line with command,
submission, dispatch-send, mixer-source observation, and terminal timing, plus
complete submitted text.  Dispatch records carry the native submission and
Omnivox dispatch IDs when available.  The log can therefore contain sensitive
material and is disabled by default.  Emacsvox creates the file with owner-only
permissions and tightens an existing file before appending to it.

Default Value:

nil

Variable: User Option emacsvox-aural-diagnostic-log-max-bytes
Soft size limit for one aural diagnostic log file.

Before appending a record that would cross this limit, Emacsvox renames the
current log to a session-tagged archive.  A single oversized record remains
intact and may exceed the limit.  Set this to nil to disable rotation.

Default Value:

16777216

Variable: User Option emacsvox-aural-diagnostic-log-retained-files
Number of rotated aural diagnostic log files to retain.

The active log is additional to this number.

Default Value:

4