From 56c07622adcc190f4a44a10e9deab43443f7d256 Mon Sep 17 00:00:00 2001 From: Samuel Thibault Date: Sat, 11 Dec 2021 22:49:37 +0100 Subject: [PATCH] 0.11.0 release --- doc/spd-say.html | 57 +-- doc/speech-dispatcher-cs.html | 2 +- doc/speech-dispatcher.html | 2 +- doc/ssip.html | 727 ++++++++++++++++------------------ po/cs.po | 2 +- po/de.po | 2 +- po/eo.po | 2 +- po/fr.po | 2 +- po/hu.po | 2 +- po/nb_NO.po | 2 +- po/pt.po | 2 +- po/pt_BR.po | 2 +- po/ru.po | 2 +- po/speech-dispatcher.pot | 4 +- 14 files changed, 395 insertions(+), 415 deletions(-) diff --git a/doc/spd-say.html b/doc/spd-say.html index c50060709..c8c7fcd15 100644 --- a/doc/spd-say.html +++ b/doc/spd-say.html @@ -1,6 +1,6 @@ - + Say client to Speech Dispatcher @@ -10,15 +10,18 @@ + + + @@ -41,7 +45,8 @@

Say client to Speech Dispatcher

- +
+

This manual documents Say for Speech Dispatcher, version 0.4.

Copyright © 2001, 2002, 2003, 2006 Brailcom, o.p.s. @@ -67,77 +72,77 @@

Say client to Speech Dispatcher

-
-r or --rate
+
-r or --rate

Set the rate of the speech (between -100 and +100, default see below).

-
-p or --pitch
+
-p or --pitch

Set the pitch of the speech (between -100 and +100, default see below).

-
-R or --pitch-range
+
-R or --pitch-range

Set the pitch range of the speech (between -100 and +100, default see below).

-
-i or --volume
+
-i or --volume

Set the volume (intensity) of the speech (between -100 and +100, default see below).

-
-o or --output-module
+
-o or --output-module

Set the output module. Default see below.

-
-O or --list-output-modules
+
-O or --list-output-modules

List the output modules that are available with the current server.

-
-I or --sound-icon
+
-I or --sound-icon

Play the sound icon.

-
-l or --language
+
-l or --language

Set the language. The parameter is an iso language code, like en or cs, possibly with a region qualification, like en-US or en-GB. Default see below.

-
-t or --voice-type
+
-t or --voice-type

Set the preferred voice type (male1, male2, male3, female1, female2, female3, child_male, child_female).

-
-L or --list-synthesis-voices
+
-L or --list-synthesis-voices

List the ”synthesis voices” supported by an output module. If no -o option is supplied, -L displays the synthesis voices provided by the default output module. Otherwise, it displays the synthesis voices provided by the chosen module.

-
-y or --synthesis-voice
+
-y or --synthesis-voice

Set the synthesis voice. The synthesis voice is an attribute of the chosen synthesizer. Most users will probably not wish to set it, but this setting is provided for completeness.

-
-m or --punctuation-mode
+
-m or --punctuation-mode

Set the punctuation mode (none, some, most, all). Default see below.

-
-s or --spelling
+
-s or --spelling

Spell the message.

-
-x or --ssml
+
-x or --ssml

Set SSML mode on (default: off). The text contains SSML markup.

-
-e or --pipe-mode
+
-e or --pipe-mode

Set pipe mode on (default: off). Reads text from stdin, writes to stdout, and also sends to Speech Dispatcher.

-
-w or --wait
+
-w or --wait

Wait till the end of speaking the message. In this mode, spd-say returns only after the message is fully spoken on the speakers or after it gets discarded.

-
-S or --stop
+
-S or --stop

Stop the previous message in Speech Dispatcher (regardless of the client who sent it and it’s priority) before saying the specified message. If no message is specified, it just performs the stop function.

-
-C or --cancel
+
-C or --cancel

Similar to -S, but it stops (cancels) all the messages in all the queues in Speech Dispatcher. Use this for total stop of speech.

-
-v or --version
+
-v or --version

Print version and copyright info.

-
-h or --help
+
-h or --help

Print a short help message.

@@ -155,7 +160,9 @@

Say client to Speech Dispatcher

The default punctuation mode is determined by the DefaultPunctuationMode setting in the speechd.conf file. Factory default is none.

-

2 Pipe Mode

+
+
+

2 Pipe Mode

In pipe mode (option --pipe-mode or -e), spd-say reads text from stdin, writes to stdout, and also sends the text to Speech Dispatcher. Example: @@ -212,7 +219,7 @@

Say client to Speech Dispatcher

 $ spd-say -C
-
+
diff --git a/doc/speech-dispatcher-cs.html b/doc/speech-dispatcher-cs.html index fc68cd009..8549c4146 100644 --- a/doc/speech-dispatcher-cs.html +++ b/doc/speech-dispatcher-cs.html @@ -54,7 +54,7 @@

Speech Dispatcher

Top

-

Tento manuál se vzathuje ke Speech Dispatcher, verze 0.11.0-rc5. Jedná se +

Tento manuál se vzathuje ke Speech Dispatcher, verze 0.11.0. Jedná se však pouze o uživatelskou část dokumentace a upozorňujeme, že tento překlad již není aktuální! Poskytujeme jej s tím, že možná bude užitečný a to zejména v sekcích, které popisují obecné koncepty a myšlenky projektu, a to těm, kteří si diff --git a/doc/speech-dispatcher.html b/doc/speech-dispatcher.html index 6da29711f..de804d2c8 100644 --- a/doc/speech-dispatcher.html +++ b/doc/speech-dispatcher.html @@ -54,7 +54,7 @@

Speech Dispatcher

Top

-

This manual documents Speech Dispatcher, version 0.11.0-rc5. +

This manual documents Speech Dispatcher, version 0.11.0.

Copyright © 2001, 2002, 2003, 2006 Brailcom, o.p.s.

diff --git a/doc/ssip.html b/doc/ssip.html index b56631990..1a87d7327 100644 --- a/doc/ssip.html +++ b/doc/ssip.html @@ -1,6 +1,6 @@ - + Speech Synthesis Interface Protocol @@ -10,16 +10,20 @@ + + + + @@ -79,104 +84,25 @@

Top

Menu

- -

Table of Contents

- -
- -
- - - - - - - - - -
• Introduction   -
• Basic Terminology   -
• General Rules   -
• SSIP Commands   -
• Return Codes   -
• Appendices   -
• GNU Free Documentation License   -
• GNU General Public Licence   -
-
-
+
+

Next: , Previous: , Up: Top   [Contents]

1 Introduction

- - - - -
• Purpose   -
• Protocol Philosophy   -
• Higher Level API   -
+
-
+
+

Next: , Previous: , Up: Introduction   [Contents]

@@ -209,7 +135,9 @@

Table of Contents

supressing others.

-
+
+
+

Next: , Previous: , Up: Introduction   [Contents]

@@ -255,7 +183,9 @@

Table of Contents

supported formats of the messages you can send through SSIP is SSML.

-
+
+
+

Previous: , Up: Introduction   [Contents]

@@ -278,7 +208,10 @@

Table of Contents

a lot easier and allow programmers to make more of them.

-
+
+
+
+

Next: , Previous: , Up: Top   [Contents]

@@ -319,7 +252,9 @@

Table of Contents

-
+
+
+

Next: , Previous: , Up: Top   [Contents]

@@ -347,10 +282,10 @@

Table of Contents

carriage return and line feed characters, in that order.

When you connect to Speech Server, you should at least set your client -name, through the SET SELF CLIENT_NAME command (see Parameter Setting Commands). This is important to get a proper identification of your client +name, through the SET SELF CLIENT_NAME command (see Parameter Setting). This is important to get a proper identification of your client — to allow managing it from the control center application and to identify it in a message history browser. You might want to set other connection -parameters as well. Look for more details in Parameter Setting Commands. +parameters as well. Look for more details in Parameter Setting.

An SSIP connection is preferably closed by issuing the QUIT command, see Other Commands. @@ -372,8 +307,8 @@

Table of Contents

to prevent one user from seeing history messages of another user.

-

Some of the commands (Speech Output Control Commands -and Parameter Setting Commands) +

Some of the commands (Controlling Speech Output +and Parameter Setting) take an argument in the form: 

        { id | all | self }
@@ -407,7 +342,9 @@ 
Table of Contents

 action in a human readable form.
 

 

-

+

+

+

 

 Next: , Previous: , Up: Top   [Contents]

 

@@ -431,31 +368,23 @@ 
Table of Contents

 repetition (zero or more times) of all the arguments within the
 current brackets.
 

-
-
-
-
-
-
-
-
-
-
-
• Speech Synthesis and Sound Output Commands  
-
• Speech Output Control Commands  
-
• Message Priority Commands  
-
• Blocks of Messages Commands  
-
• Parameter Setting Commands  
-
• Information Retrieval Commands  
-
• Message Events Notification and Index Marking  
-
• History Handling Commands  
-
• Other Commands  
-

 
+
 

-

+

+

 

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

 

 
4.1 Speech Synthesis and Sound Output

 
@@ -464,7 +393,7 @@ 
Table of Contents

 parameter settings and user configuration.
 

 

-
SPEAK

+
SPEAK

 
Start receiving a text message and synthesize it.  After sending a
 reply to the command, Speech Server waits for the text of the
 message.  The text can spread over any number of lines and is
@@ -505,7 +434,7 @@ 
Table of Contents

where msg_id is a unique id assigned to this message in Speech -Server. This is useful for the History Handling Commands +Server. This is useful for the History Handling commands as well as for Message Events Notification and Index Marking.

The SPEAK command might be used for example in this way: @@ -520,7 +449,7 @@

Table of Contents

-
CHAR char
+
CHAR char

Speak letter char. char can be any character representable by the UTF-8 encoding. The only exception is the character space ( ); that can’t be sent directly. In this case, @@ -537,7 +466,7 @@

Table of Contents

e.g. when reading a character under cursor or when spelling words.

-
KEY key-name
+
KEY key-name

Speak key identified by key-name. The command is intended to be used for speaking keys pressed by the user.

@@ -574,7 +503,7 @@

Table of Contents

-
SOUND_ICON icon-name
+
SOUND_ICON icon-name

Send a sound identified by icon-name to the audio output. icon-name is a symbolic name of the given sound from the standard set listed in Standard Sound Icons, or another name @@ -583,9 +512,11 @@

Table of Contents

-
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.2 Controlling Speech Output

@@ -594,7 +525,7 @@

Table of Contents

do not affect the message history.

-
STOP { id | all | self }
+
STOP { id | all | self }

Immediately stop outputting the current message (whatever it is — text, letter, key, or sound icon) from the identified client, if any is being output. If the command argument is self, the last message @@ -605,14 +536,14 @@

Table of Contents

by id is stopped; if there is none such, do nothing.

-
CANCEL { id | all | self }
+
CANCEL { id | all | self }

This command is the same as STOP, with the exception that it stops as yet unspoken output messages as well. All currently queued messages are stored into the message history without being sent to the audio output device.

-
PAUSE { id | all | self }
+
PAUSE { id | all | self }

Stop audio output immediately, but do not discard anything. All the currently speaking and currently or later queued messages are postponed and saved for later processing, until a corresponding RESUME @@ -622,7 +553,7 @@

Table of Contents

command.

-
RESUME { id | all | self }
+
RESUME { id | all | self }

Cancel the effect of the previously issued PAUSE command. Note that messages of the priority “progress” and “notification” received during the pause are not output (but they remain stored in the message history). @@ -638,9 +569,11 @@

Table of Contents

-
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.3 Priority Setting Commands

@@ -659,21 +592,18 @@

Table of Contents

coming from different clients) is automatically handled by the Speech Server by applying certain rules based on the priorities.

- - - - - -
• Priority Categories  What are the available priorities. -
• Priority Diagram  Schematic diagram of used priority model. -
• Priority Setting Commands   -
• Examples of Using Priorities  A few examples of using the priorities. -
+
-
+
+

-Next: , Previous: , Up: Message Priority Commands   [Contents]

+Next: , Previous: , Up: Priority Setting Commands   [Contents]

4.3.1 Priority Categories

@@ -769,18 +699,22 @@

Table of Contents

end of the progress sequences will be said.

-
+
+
+

-Next: , Previous: , Up: Message Priority Commands   [Contents]

+Next: , Previous: , Up: Priority Setting Commands   [Contents]

4.3.2 Priority Diagram

Speech Synthesis Interface Protocol Priorities
-
+
+
+

-Next: , Previous: , Up: Message Priority Commands   [Contents]

+Next: , Previous: , Up: Priority Setting Commands   [Contents]

4.3.3 Priority Setting Commands

@@ -800,9 +734,11 @@

Table of Contents

-
+
+
+

-Previous: , Up: Message Priority Commands   [Contents]

+Previous: , Up: Priority Setting Commands   [Contents]

4.3.4 Examples of Using Priorities

@@ -848,9 +784,12 @@

Table of Contents

-
+
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.4 Blocks of Messages Commands

@@ -859,7 +798,7 @@

Table of Contents

opening the block, client can send a specified subset of the commands and the messages introduced by SPEAK will be processed immediately, however there will be no priority interaction before closing the block. -The Speech Output Control Commands also handle the whole block as one +The Controlling Speech Output also handle the whole block as one message.

Take for example this message from an email client: @@ -875,7 +814,7 @@

Table of Contents

because in fact, it logically is one message.

-
BLOCK BEGIN
+
BLOCK BEGIN

Opens a block of messages. There will be no priority interaction between the messages inside the block, the whole block will be treated as one message of the priority that was specified by previous SET command. @@ -900,7 +839,7 @@

Table of Contents

-
BLOCK END
+
BLOCK END

Closes a block of messages, see BLOCK BEGIN.

It can be only called inside a block opened by BLOCK BEGIN; @@ -945,9 +884,11 @@

Table of Contents

-
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.5 Parameter Setting

@@ -966,7 +907,7 @@

Table of Contents

implementation of SSIP.

-
SET self CLIENT_NAME user:client:component
+
SET self CLIENT_NAME user:client:component

Set client’s name. Client name consists of the user name, client (application) identification, and the identification of the component of the client (application). Each of the parts of the client name may @@ -996,7 +937,7 @@

Table of Contents

Only self is allowed as the ‘target’ argument.

-
SET all DEBUG {ON|OFF}
+
SET all DEBUG {ON|OFF}

If set to ON, Speech Dispatcher will write all its debugging information (including output modules) with maximal verbosity into a debug directory which is reported by the server to the client in reply @@ -1023,7 +964,7 @@

Table of Contents

-
SET {all | self | id } OUTPUT_MODULE module
+
SET {all | self | id } OUTPUT_MODULE module

Set the output module to module. This overrides the selection based on language. Only values returned by the LIST OUTPUT_MODULES command are permitted. @@ -1035,7 +976,7 @@

Table of Contents

-
GET OUTPUT_MODULE
+
GET OUTPUT_MODULE

Get the output module currently in use. This takes no parameters and simply returns the current output module.

@@ -1046,7 +987,7 @@

Table of Contents

-
SET { all | self | id } LANGUAGE language-code
+
SET { all | self | id } LANGUAGE language-code

Set recommended language for this client according to language-code. language-code is the code of the language according to RFC 1766.

@@ -1066,7 +1007,7 @@

Table of Contents

speechd.conf file. The factory default is en-US (American English).

-
SET {self} SSML_MODE mode
+
SET {self} SSML_MODE mode

Set the mode of the text received in the message body sent by the SPEAK command. This can be either a plain text, if mode is set to off or a SSML marked text, if mode is set to on. @@ -1089,7 +1030,7 @@

Table of Contents

-
SET { all | self | id } PUNCTUATION { all | most | some | none }
+
SET { all | self | id } PUNCTUATION { all | most | some | none }

Set punctuation mode to the given value. all means speak all punctuation characters, none means speak no punctuation characters, some and most mean speak only intermediate sets of punctuation @@ -1099,7 +1040,7 @@

Table of Contents

speechd.conf file. The factory default is none.

-
SET { all | self | id } SPELLING { on | off }
+
SET { all | self | id } SPELLING { on | off }

Switch spelling on or off. If spelling is set to on, all the incoming messages will be said letter-by-letter, instead of speaking them as whole words. @@ -1108,7 +1049,7 @@

Table of Contents

speechd.conf file. The factory default is off.

-
SET { all | self | id } CAP_LET_RECOGN { none | spell | icon }
+
SET { all | self | id } CAP_LET_RECOGN { none | spell | icon }

Set capital letters recognition mode. none switches this feature off. spell causes capital letters to be spelled in the speech using the table set as CAP_LET_RECOGN_TABLE. @@ -1120,9 +1061,9 @@

Table of Contents

speechd.conf file. The factory default is none.

-
SET { all | self | id } VOICE_TYPE name
+
SET { all | self | id } VOICE_TYPE name

Set the voice identified by name. name must be one of the voice -identifiers returned by the command LIST VOICES (see Information Retrieval Commands). +identifiers returned by the command LIST VOICES (see Retrieving Information).

There is a standard set of voice identifiers defined in Standard Voices.

@@ -1131,9 +1072,9 @@

Table of Contents

speechd.conf file. The factory default is MALE1.

-
GET VOICE_TYPE
+
GET VOICE_TYPE

Gets the current pre-defined voice. A list of voice identifiers can be -obtained by the command LIST VOICES (see Information Retrieval Commands). +obtained by the command LIST VOICES (see Retrieving Information). 

GET VOICE_TYPE
@@ -1142,18 +1083,18 @@ 
Table of Contents
-
SET { all | self | id } SYNTHESIS_VOICE name
+
SET { all | self | id } SYNTHESIS_VOICE name

Set the voice identified by name. name is a voice name recognized by the current synthesizer. It must be one of the names returned by the command LIST SYNTHESIS_VOICES run for the -appropriate synthesizer. (see Information Retrieval Commands). +appropriate synthesizer. (see Retrieving Information).

Please note, that switching to a particular voice may require switching a language, so this command may actually override a previous call to SET LANGUAGE.

-
SET { all | self | id } RATE n
+
SET { all | self | id } RATE n

Set the rate of speech. n is an integer value within the range from -100 to 100, lower values meaning slower speech and higher values meaning faster speech. @@ -1162,7 +1103,7 @@

Table of Contents

speechd.conf file. The factory default is 0.

-
GET RATE
+
GET RATE

Get the current rate of speech value.

@@ -1172,7 +1113,7 @@

Table of Contents

-
SET { all | self | id } PITCH n
+
SET { all | self | id } PITCH n

Set the pitch of speech. n is an integer value within the range from -100 to 100, lower values meaning lower pitch and higher values meaning higher pitch. @@ -1181,7 +1122,7 @@

Table of Contents

speechd.conf file. The factory default is 0.

-
GET PITCH
+
GET PITCH

Get the current pitch value.

@@ -1191,7 +1132,7 @@

Table of Contents

-
SET { all | self | id } VOLUME n
+
SET { all | self | id } VOLUME n

Set the volume of speech. n is an integer value within the range from -100 to 100. lower values meaning lower volume and higher values meaning higher volume. @@ -1200,7 +1141,7 @@

Table of Contents

speechd.conf file. The factory default is 100.

-
GET VOLUME
+
GET VOLUME

Get the current volume value.

@@ -1210,7 +1151,7 @@

Table of Contents

-
SET { all | self | id } PAUSE_CONTEXT n
+
SET { all | self | id } PAUSE_CONTEXT n

Set the number of (more or less) sentences that should be repeated after a previously paused text is resumed. If there isn’t enough text before the pause spot, the entire message is repeated. n @@ -1221,7 +1162,7 @@

Table of Contents

speechd.conf file. The factory default is 0.

-
SET { all | self | id } HISTORY { on | off }
+
SET { all | self | id } HISTORY { on | off }

Enable (on) or disable (off) storing of received messages into history.

@@ -1231,9 +1172,11 @@

Table of Contents

-
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.6 Retrieving Information

@@ -1244,7 +1187,7 @@

Table of Contents

-
LIST OUTPUT_MOUDLES
+
LIST OUTPUT_MOUDLES

Lists the available output modules putting each module identification name one on a single line.

@@ -1258,7 +1201,7 @@

Table of Contents

-
LIST VOICES
+
LIST VOICES

Lists the available symbolic voice names putting each voice name on a single line. These are symbolic names that are mapped to the real voices used in the synthesizer either automatically or via synthesizer or output module @@ -1279,7 +1222,7 @@

Table of Contents

-
LIST SYNTHESIS_VOICES
+
LIST SYNTHESIS_VOICES

Lists the available voices for the current synthesizer in use. These names differ from those obtained by LIST VOICES in that they @@ -1310,25 +1253,24 @@

Table of Contents

-
+
+
+

-Next: , Previous: , Up: SSIP Commands   [Contents]

+Next: , Previous: , Up: SSIP Commands   [Contents]

4.7 Message Events Notification and Index Marking

- - - - - -
• Why Events Notification   -
• Types of Events   -
• Events Notifications in SSIP   -
• Switching Notifications On and Off   -
+
-
+
+

Next: , Previous: , Up: Message Events Notification and Index Marking   [Contents]

@@ -1349,9 +1291,11 @@

Table of Contents

applications should not rely on it.

-
+
+
+

-Next: , Previous: , Up: Message Events Notification and Index Marking   [Contents]

+Next: , Previous: , Up: Message Events Notification and Index Marking   [Contents]

4.7.2 Types of Events

@@ -1361,7 +1305,7 @@

Table of Contents

detailed SSIP syntax, please look below.

-
BEGIN
+
BEGIN

This event means that the synthesizer just started to speak the message and the user is able to hear the speech on his/her speakers. @@ -1371,7 +1315,7 @@

Table of Contents

CANCEL event instead.

-
END
+
END

This event means that the synthesizer just terminated speaking the message (by reaching its end) and the user is no longer able to hear @@ -1382,25 +1326,25 @@

Table of Contents

It might instead issue the CANCEL or PAUSE events.

-
CANCEL
+
CANCEL

The CANCEL event is reported when the message was canceled (either after BEGIN during speaking or even before, when waiting in the queues) and will not be spoken anymore.

-
PAUSE
+
PAUSE

The event PAUSE means that the message that was being spoken was paused and no longer produces any sound on the speakers, but was not discarded and the rest of the message might be spoken again after the -RESUME command is sent. See Speech Output Control Commands. This will be reported by the RESUME event. +RESUME command is sent. See Controlling Speech Output. This will be reported by the RESUME event.

PAUSE is always preceded by the event BEGIN, and can be followed by either the event RESUME or CANCEL.

-
RESUME
+
RESUME

The event RESUME means that a message that was paused while being spoken, just started to continue and again produces @@ -1410,7 +1354,7 @@

Table of Contents

be followed by either the event END or CANCEL.

-
INDEX_MARK
+
INDEX_MARK

This event means that some previously specified place in the text (so-called index mark) was reached when speaking the synthesized @@ -1447,7 +1391,9 @@

Table of Contents

-
+
+
+

Next: , Previous: , Up: Message Events Notification and Index Marking   [Contents]

@@ -1468,7 +1414,7 @@

Table of Contents

parameters.

-
INDEX_MARK
+
INDEX_MARK
700-msg_id
@@ -1483,7 +1429,7 @@ 
Table of Contents

 SSML tag <mark/>.
-
BEGIN
+
BEGIN
701-msg_id
@@ -1491,7 +1437,7 @@ 
Table of Contents

 701 BEGIN
-
END
+
END
702-msg_id
@@ -1500,7 +1446,7 @@ 
Table of Contents
-
CANCEL
+
CANCEL
703-msg_id
@@ -1509,7 +1455,7 @@ 
Table of Contents
-
PAUSE
+
PAUSE
704-msg_id
@@ -1518,7 +1464,7 @@ 
Table of Contents
-
RESUME
+
RESUME
705-msg_id
@@ -1530,9 +1476,11 @@ 
Table of Contents

 
 
 

-

+

+

+

 

-Previous: , Up: Message Events Notification and Index Marking   [Contents]

+Previous: , Up: Message Events Notification and Index Marking   [Contents]

 

 
4.7.4 Switching Notifications On and Off

 
@@ -1550,28 +1498,28 @@ 
Table of Contents

 notifications are already turned off.
 

 

-
SET SELF NOTIFICATION ALL { on | off }

+
SET SELF NOTIFICATION ALL { on | off }

 

 
Set all available event notifications to either “on” or “off” for
 for the messages that follow. See Types of Events.
 

 

-
SET SELF NOTIFICATION BEGIN { on | off }

-
SET SELF NOTIFICATION END { on | off }

+
SET SELF NOTIFICATION BEGIN { on | off }

+
SET SELF NOTIFICATION END { on | off }

 

 
Set the event notifications for BEGIN or END to either
 “on” or “off” for the messages that follow. See Types of Events.
 

 

-
SET SELF NOTIFICATION CANCEL { on | off }

+
SET SELF NOTIFICATION CANCEL { on | off }

 

 
Set the event notifications for CANCEL to mode where
 mode is either “on” or “off” for switching the
 notifications on or off for the messages that follow. See Types of Events.
 

 

-
SET SELF NOTIFICATION PAUSE { on | off }

-
SET SELF NOTIFICATION RESUME { on | off }

+
SET SELF NOTIFICATION PAUSE { on | off }

+
SET SELF NOTIFICATION RESUME { on | off }

 

 
Set the event notifications for PAUSE or RESUME to
 mode where mode is either “on” or “off” for
@@ -1579,7 +1527,7 @@ 
Table of Contents

 follow. See Types of Events.
 

 

-
SET SELF NOTIFICATION INDEX_MARKS { on | off }

+
SET SELF NOTIFICATION INDEX_MARKS { on | off }

 

 
Set the event notifications for INDEX_MARK to either “on” or
 “off” for switching the notifications on or off for the messages
@@ -1589,23 +1537,25 @@ 
Table of Contents

 

 
 

-

+

+

+

+

 

 Next: , Previous: , Up: SSIP Commands   [Contents]

 

 
4.8 History Handling

 
-
-
-
-
• Purpose of Message History  
-
• Message History in SSIP  
-

 
+
 

-

+

+

 

-Next: , Previous: , Up: History Handling Commands   [Contents]

+Next: , Previous: , Up: History Handling   [Contents]

 

 
4.8.1 Purpose of Message History

 
@@ -1631,9 +1581,11 @@ 
Table of Contents

 that come from the same client connection are accessible.
 

 

-

+

+

+

 

-Previous: , Up: History Handling Commands   [Contents]

+Previous: , Up: History Handling   [Contents]

 

 
4.8.2 Message History in SSIP

 
@@ -1654,7 +1606,7 @@ 
Table of Contents

 of command arguments described below.
 

 

-
HISTORY GET CLIENT_LIST

+
HISTORY GET CLIENT_LIST

 
List known client names, their identifiers and status.  Each connection is
 listed on a separate line in the following format:
 

@@ -1664,7 +1616,7 @@ 
Table of Contents

 
 
where id is a client id that can be used in other history
 handling requests or in the speech output control commands
-(see Speech Output Control Commands), name is the client
+(see Controlling Speech Output), name is the client
 name as set through the SET SELF CLIENT_NAME command, and
 status is 1 for connected clients and 0 for
 disconnected clients.  ids are unique within a single run of
@@ -1680,7 +1632,7 @@ 
Table of Contents
-
HISTORY GET CLIENT_ID
+
HISTORY GET CLIENT_ID

Return id of the client itself.

The id is listed on a separate line in the following format: @@ -1696,7 +1648,7 @@

Table of Contents

-
HISTORY GET CLIENT_MESSAGES { id | all | self } start number
+
HISTORY GET CLIENT_MESSAGES { id | all | self } start number

List identifiers of messages sent by the client identified by id. If the special identifier all is used, identifiers of messages sent by all clients are listed; if the special identifier @@ -1724,11 +1676,11 @@

Table of Contents

client-id is a numeric identifier of the client which sent the message, client-name is its name as set by the SET SELF -CLIENT_NAME command (see Parameter Setting Commands). +CLIENT_NAME command (see Parameter Setting). time is the time of arrival of the message, in the fixed length YYYY-MM-DD HH:MM:SS format. priority is the priority of the message, one of the values accepted by the SET SELF PRIORITY -command (see Parameter Setting Commands). +command (see Parameter Setting).

intro is the introductory part of the message of a certain maximum length, see the HISTORY SET SHORT_MESSAGE_LENGTH @@ -1740,7 +1692,7 @@

Table of Contents

remain unchanged.

-
HISTORY GET LAST
+
HISTORY GET LAST

List the id of the last message sent by the client.

The id is listed on a separate line of the following format: @@ -1752,7 +1704,7 @@

Table of Contents

If the client hasn’t sent any message yet, return an error code.

-
HISTORY GET MESSAGE id
+
HISTORY GET MESSAGE id

Return the text of the history message identified by id. If id doesn’t refer to any message, return an error code instead. The text is sent as a multi-line message, with no escaping or special @@ -1767,7 +1719,7 @@

Table of Contents

-
HISTORY CURSOR GET
+
HISTORY CURSOR GET

Get the id of the message the history cursor is pointing to.

The id is listed on a separate line. Sample SSIP reply to @@ -1779,7 +1731,7 @@

Table of Contents

-
HISTORY CURSOR SET { id | all | self } { first | last | pos n }
+
HISTORY CURSOR SET { id | all | self } { first | last | pos n }

Set the history cursor to the given position. The meaning of the first argument after SET is the same as in the HISTORY GET CLIENT_MESSAGES command. The argument first asks to set @@ -1794,14 +1746,14 @@

Table of Contents

same rules apply as in HISTORY GET CLIENT_MESSAGES. See above.

-
HISTORY CURSOR { forward | backward }
+
HISTORY CURSOR { forward | backward }

Move the cursor one position forward, resp. backward, within the messages of the client specified in the last HISTORY CURSOR SET command. If there is no next, resp. previous, message, don’t move the cursor and return an error code.

-
HISTORY SAY id
+
HISTORY SAY id

Speak the message from history identified by id. If id doesn’t refer to any message, return an error code instead.

@@ -1810,30 +1762,30 @@

Table of Contents

(priority, etc.) apply.

-
HISTORY SORT { asc | desc } { time | user | client_name | priority | message_type }
+
HISTORY SORT { asc | desc } { time | user | client_name | priority | message_type }

Sort the messages in history according to the given criteria. If the second command argument is asc, sort in ascending order, if it is desc, sort in descending order. The third command argument specifies the message property to order by:

-
time
+
time

Time of arrival of the message.

-
user
+
user

User name.

-
client_name
+
client_name

Client name, excluding user name.

-
priority
+
priority

Priority.

-
message_type
+
message_type

Type of the message (text, sound icon, character, key), in the order specified in the Speech Server configuration or by the HISTORY SET MESSAGE_TYPE_ORDERING command. @@ -1847,7 +1799,7 @@

Table of Contents

connections are unaffected by invocation of this command.

-
HISTORY SET SHORT_MESSAGE_LENGTH length
+
HISTORY SET SHORT_MESSAGE_LENGTH length

Set the maximum length of short versions of history messages to length characters. length must be a non-negative integer.

@@ -1855,7 +1807,7 @@

Table of Contents

answer to the HISTORY GET CLIENT_MESSAGES format.

-
HISTORY SET MESSAGE_TYPE_ORDERING "ordering"
+
HISTORY SET MESSAGE_TYPE_ORDERING "ordering"

Set the ordering of the message types, from the minimum to the maximum. ordering is a sequence of the following symbols, separated by spaces: text, sound_icon, char, @@ -1865,7 +1817,7 @@

Table of Contents

The specified ordering can be used by the HISTORY SORT command.

-
HISTORY SEARCH { id | all | self } "condition"
+
HISTORY SEARCH { id | all | self } "condition"

Return the list of history messages satisfying condition. The command allows searching messages by given words. The output format is the same as the HISTORY GET CLIENT_MESSAGES command. @@ -1877,19 +1829,19 @@

Table of Contents

rules:

-
condition :: word
+
condition :: word

Matches messages containing word.

-
condition :: ( ! condition )
+
condition :: ( ! condition )

Negation of the given condition.

-
condition :: ( condition [ & condition ... ] )
+
condition :: ( condition [ & condition ... ] )

Logical AND — all the conditions must be satisfied.

-
condition :: ( condition [ | condition ... ] )
+
condition :: ( condition [ | condition ... ] )

Logical OR — at least one of the conditions must be satisfied.

@@ -1928,24 +1880,30 @@

Table of Contents

-
+
+ +
+

-Previous: , Up: SSIP Commands   [Contents]

+Previous: , Up: SSIP Commands   [Contents]

4.9 Other Commands

-
QUIT
+
QUIT

Close the connection.

-
HELP
+
HELP

Print a short list of all SSIP commands, as a multi-line message.

-
+
+
+
+

Next: , Previous: , Up: Top   [Contents]

@@ -1958,29 +1916,29 @@

Table of Contents

SSIP defines the following result groups:

-
1xx
+
1xx

Informative response — general information about the protocol, help messages.

-
2xx
+
2xx

Operation was completely successful.

-
3xx
+
3xx

Server error, problem on the server side.

-
4xx
+
4xx

Client error, invalid arguments or parameters received.

-
5xx
+
5xx

Client error, invalid command syntax, unparseable input.

-
7xx
-

Event notifications. See See Events Notifications in SSIP. +

7xx
+

Event notifications. See See Events Notification in SSIP.

@@ -2001,13 +1959,13 @@

Table of Contents

In the future, these return codes should be fixed so that clients can rely on them.

- - -
• Sample SSIP Dialog   -
+
-
+
+

Previous: , Up: Return Codes   [Contents]

@@ -2054,23 +2012,24 @@

Table of Contents

-
+
+
+
+

Next: , Previous: , Up: Top   [Contents]

Appendix A Appendices

- - - - -
• Key Names  List of the symbolic key names. -
• Standard Sound Icons  List of the standard sound icon names. -
• Standard Voices   -
+
-
+
+

Next: , Previous: , Up: Appendices   [Contents]

@@ -2082,92 +2041,94 @@

Table of Contents

Special Key Names

-
space
-
underscore
-
double-quote
+
space
+
underscore
+
double-quote

Auxiliary Keys

-
alt
-
control
-
hyper
-
meta
-
shift
-
super
+
alt
+
control
+
hyper
+
meta
+
shift
+
super

Control Character Keys

-
backspace
-
break
-
delete
-
down
-
end
-
enter
-
escape
-
f1
-
f2
-
f3
-
f4
-
f5
-
f6
-
f7
-
f8
-
f9
-
f10
-
f11
-
f12
-
f13
-
f14
-
f15
-
f16
-
f17
-
f18
-
f19
-
f20
-
f21
-
f22
-
f23
-
f24
-
home
-
insert
-
kp-*
-
kp-+
-
kp--
-
kp-.
-
kp-/
-
kp-0
-
kp-1
-
kp-2
-
kp-3
-
kp-4
-
kp-5
-
kp-6
-
kp-7
-
kp-8
-
kp-9
-
kp-enter
-
left
-
menu
-
next
-
num-lock
-
pause
-
print
-
prior
-
return
-
right
-
scroll-lock
-
space
-
tab
-
up
-
window
+
backspace
+
break
+
delete
+
down
+
end
+
enter
+
escape
+
f1
+
f2
+
f3
+
f4
+
f5
+
f6
+
f7
+
f8
+
f9
+
f10
+
f11
+
f12
+
f13
+
f14
+
f15
+
f16
+
f17
+
f18
+
f19
+
f20
+
f21
+
f22
+
f23
+
f24
+
home
+
insert
+
kp-*
+
kp-+
+
kp--
+
kp-.
+
kp-/
+
kp-0
+
kp-1
+
kp-2
+
kp-3
+
kp-4
+
kp-5
+
kp-6
+
kp-7
+
kp-8
+
kp-9
+
kp-enter
+
left
+
menu
+
next
+
num-lock
+
pause
+
print
+
prior
+
return
+
right
+
scroll-lock
+
space
+
tab
+
up
+
window
-
+
+
+

Next: , Previous: , Up: Appendices   [Contents]

@@ -2176,35 +2137,40 @@

Table of Contents

There are none currently.

-
+
+
+

Previous: , Up: Appendices   [Contents]

A.3 Standard Voices

The following voice names are always present in the output of the -LIST VOICES command (see Information Retrieval Commands): +LIST VOICES command (see Retrieving Information):

-
MALE1
-
MALE2
-
MALE3
-
FEMALE1
-
FEMALE2
-
FEMALE3
-
CHILD_MALE
-
CHILD_FEMALE
+
MALE1
+
MALE2
+
MALE3
+
FEMALE1
+
FEMALE2
+
FEMALE3
+
CHILD_MALE
+
CHILD_FEMALE

The actual presence of any of these voices is not guaranteed. But the -command SET VOICE (see Parameter Setting Commands) must +command SET VOICE (see Parameter Setting) must accept any of them. If the given voice is not available, it is mapped to another voice by the output module.

-
+
+
+
+

-Next: , Previous: , Up: Top   [Contents]

+Next: , Previous: , Up: Top   [Contents]

Appendix B GNU Free Documentation License

Version 1.2, November 2002 @@ -2586,7 +2552,11 @@

Table of Contents

as a draft) by the Free Software Foundation.

-

B.1 ADDENDUM: How to use this License for your documents

+ +
+

B.1 ADDENDUM: How to use this License for your documents

To use this License in a document you have written, include a copy of the License in the document and put the following copyright and @@ -2623,7 +2593,10 @@

Table of Contents

-
+
+
+
+

Previous: , Up: Top   [Contents]

@@ -2983,7 +2956,7 @@

Table of Contents

library. If this is what you want to do, use the GNU Lesser General Public License instead of this License.

-
+
diff --git a/po/cs.po b/po/cs.po index 2287c5434..5f1936eb6 100644 --- a/po/cs.po +++ b/po/cs.po @@ -19,7 +19,7 @@ msgid "" msgstr "" "Project-Id-Version: Speech Dispatcher\n" "Report-Msgid-Bugs-To: speechd-discuss@nongnu.org\n" -"POT-Creation-Date: 2021-11-09 00:44+0100\n" +"POT-Creation-Date: 2021-12-11 22:50+0100\n" "PO-Revision-Date: 2020-09-08 07:42+0000\n" "Last-Translator: Hynek Hanke \n" "Language-Team: Czech \n" "Language-Team: German \n" "Language-Team: Esperanto \n" "Language-Team: French \n" "Language-Team: Hungarian \n" "Language-Team: Norwegian BokmĂĽl \n" "Language-Team: Portuguese \n" "Language-Team: Portuguese (Brazil) \n" "Language-Team: Russian \n" "Language-Team: LANGUAGE \n"