[BRLTTY] Improving the speech support of brltty

[Dave Mielke]

[quoted lines by Sebastian Humenda on 2012/05/07 at 12:13 +0200]

>I guess you're using gettext. I take a look at wikipedia, since I'm not a C
>programmer:
>===
>printf(_("My name is %s.\n"), my_name);
>
>Comments (starting with ///) placed directly before strings thus marked are made available
>as hints to translators by helper programs.
>===
>Would that work?

We use xgettext to generate the message template. It turns out that xgettext 
has an --add-comments option which needs to be specified. Then, any comment 
which is just before the line containing the term is copied into the template. 
For example:

   case ucSayCap:
     // "cap" here is short for "capital" (as in an uppercase letter).
     // It is spoken just before an uppercase letter, e.g. "cap A".
     prefix = gettext("cap");
     break;

Results in:

   #. "cap" here is short for "capital" (as in an uppercase letter).
   #. It is spoken just before an uppercase letter, e.g. "cap A".
   #: Programs/brltty.c:591
   msgid "cap"
   msgstr ""

-- 
Dave Mielke           | 2213 Fox Crescent | The Bible is the very Word of God.
Phone: 1-613-726-0014 | Ottawa, Ontario   | 2011 May 21 is the End of Salvation.
EMail: dave at mielke.cc | Canada  K2A 1H7   | http://Mielke.cc/now.html
http://FamilyRadio.com/                   | http://Mielke.cc/bible/