[PATCH] Fixes for the SSIP documentation.

[Boris Dusek]

On Sep 20, 2010, at 12:53 PM, Christopher Brannon wrote:

>> +The intended use for this functionality is on-line debugging from
>> +client application. If the user wants to report a problem, the client
> 
> Applications should be plural.

OK

>> This event means that the synthesizer just started to speak the
>> -message and the user is able to hear the speech on his speakers.
>> +message and the user is able to hear the speech on their speakers.
> 
> English doesn't have singular gender-neutral pronouns, except for "it",
> which is used for things.  They / them / their are plural.
> Unfortunately, pronouns have become a political issue, and nobody will
> be happy with the one you choose.  I usually pick one of the
> gender-specific pronouns and stick with it.  If I'm of a mind to make
> the feminists happy, I choose "she".

On a side note, for me it's not a political issue, just a matter of logical
consistency. Seing "user is able to hear on his speakers" and asking
"what if the user is a woman?" is the same for me as seing
"void do(char *p) { *p = '\0'; }" and asking "what if p is NULL?".

What Bohdan proposed is a simple fix that works for me
("the users are able to hear the speech on their..."), but
"user ... on his/her" is more precise and would make it consistent with the
other 2 similar corrections in my patch (he/she and him/her).

Boris