[PATCH 7/8] updated the documentation to reference pitch_change additions

[Luke Yelavich]

From: Hussain Jasim <address@hidden>
To: address@hidden

---
 doc/spd-say.texi           |  2 ++
 doc/speech-dispatcher.texi | 25 ++++++++++++++++++++++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/doc/spd-say.texi b/doc/spd-say.texi
index cdcd107..4efbeea 100644
--- a/doc/spd-say.texi
+++ b/doc/spd-say.texi
@@ -71,6 +71,8 @@ Usage: @code{spd-say [options] ["some text"]}
 Set the rate of the speech (between -100 and +100, default see below).
 @item -p or --pitch
 Set the pitch of the speech (between -100 and +100, default see below).
+ at item -R or --pitch-range
+Set the pitch range of the speech (between -100 and +100, default see below).
 @item -i or --volume
 Set the volume (intensity) of the speech (between -100 and +100, default see 
below).
 @item -o or --output-module
diff --git a/doc/speech-dispatcher.texi b/doc/speech-dispatcher.texi
index b03563e..e22201d 100755
--- a/doc/speech-dispatcher.texi
+++ b/doc/speech-dispatcher.texi
@@ -878,6 +878,8 @@ The language identification string (it's defined by 
GenericLanguage).
 The voice identification string (it's defined by AddVoice).
 @item @code{$PITCH}
 The desired pitch (a float number defined in GenericPitchAdd and 
GenericPitchMultiply).
+ at item @code{$PITCH_RANGE}
+The desired pitch range (a float number defined in GenericPitchRangeAdd and 
GenericPitchRangeMultiply).
 @item @code{$RATE}
 The desired rate or speed (a float number defined in GenericRateAdd and 
GenericRateMultiply)
 @end itemize
@@ -914,8 +916,12 @@ GenericLanguage "sk" "slovak"
 @defvr {GenericModuleConfiguration} GenericPitchAdd @var{num}
 @end defvr
 @defvr {GenericModuleConfiguration} GenericPitchMultiply @var{num}
+ at end defvr
+ at defvr {GenericModuleConfiguration} GenericPitchRangeAdd @var{num}
+ at end defvr
+ at defvr {GenericModuleConfiguration} GenericPitchRangeMultiply @var{num}
 These parameters set rate and pitch conversion to compute
-the value of @code{$RATE} and @code{$PITCH}. 
+the value of @code{$RATE}, @code{$PITCH} and @code{$PITCH_RANGE}. 
 
 The resulting rate (or pitch) is calculated using the following formula:
 @example
@@ -1924,6 +1930,18 @@ lowest and the highest pitch respectively.
 
 @end deffn
 
+ at deffn {C API function}  int spd_set_voice_pitch_range(SPDConnection* 
connection, int pitch_range);
+ at findex spd_set_voice_pitch()
+
+Set voice pitch range.
+
+ at code{connection} is the SPDConnection* connection created by spd_open().
+
+ at code{pitch_range} is a number between -100 and +100, which means the
+lowest and the highest pitch range respectively.
+
+ at end deffn
+
 @deffn {C API function}  int spd_set_volume(SPDConnection* connection, int 
volume);
 @findex spd_set_volume()
 
@@ -2654,8 +2672,8 @@ response to the particular lines sent.  The response line 
is sent only
 immediately after the @code{SET} command and after receiving the
 closing dot line.
 
-The available parameters that accept numerical values are @code{rate}
-and @code{pitch}.
+The available parameters that accept numerical values are @code{rate},
+ at code{pitch} and @code{pitch_range}.
 
 The available parameters that accept string values are
 @code{punctuation_mode}, @code{spelling_mode}, @code{cap_let_recogn},
@@ -2679,6 +2697,7 @@ SET
 203 OK RECEIVING SETTINGS
 rate=20
 pitch=-10
+pitch_range=50
 punctuation_mode=all
 spelling_mode=on
 punctuation_some=NULL
-- 
2.1.0