From 426fc88215c7fdfa5a995ff9a0e993bf62fa8136 Mon Sep 17 00:00:00 2001
From: pdm <pdm>
Date: Wed, 12 Mar 2008 09:53:48 +0000
Subject: [PATCH] speechd-voices parameter setting clarification added to
 documentation

---
 speechd-el.texi | 6 +++++-
 speechd.el      | 4 ++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/speechd-el.texi b/speechd-el.texi
index 62aca65..6accfbf 100644
--- a/speechd-el.texi
+++ b/speechd-el.texi
@@ -1365,7 +1365,11 @@ identifiers and parameter values.  Valid parameter names are the
 following symbols: @code{language}, @code{gender}, @code{age},
 @code{style}, @code{name}, @code{rate}, @code{pitch}, @code{volume},
 @code{punctuation-mode}, @code{capital-character-mode},
-@code{message-priority}, @code{output-module}.
+@code{message-priority}, @code{output-module}.  Please note that any
+parameter entry present will change the corresponding parameter, even
+if the parameter value is @code{nil} or empty; if you don't want to
+change the parameter in any way by the voice, don't put it to the list
+(and don't enable its entry in customize).
 
 @code{name} value is a string identifying Speech Dispatcher voice
 name.  If it is not given, the parameters @code{gender}, @code{age},
diff --git a/speechd.el b/speechd.el
index 559f143..604c435 100644
--- a/speechd.el
+++ b/speechd.el
@@ -117,6 +117,10 @@ is a symbol under which the voice will be accessed and PARAMETERS is an alist
 of parameter identifiers and parameter values.  Valid parameter names are the
 following symbols: language, gender, age, style, name, rate, pitch, volume,
 punctuation-mode, capital-character-mode, message-priority, output-module.
+Please note that any parameter entry present will change the corresponding
+parameter, even if the parameter value is nil or empty; if you don't want to
+change the parameter in any way by the voice, don't put it to the list (and
+don't enable its entry in customize).
 
 Name is a string identifying Speech Dispatcher voice name.  If it is not given,
 the parameters gender, age, and style are considered to select a Speech