[I18n-sig] Re: pygettext.py extraction of docstrings

Martin v. Loewis martin@loewis.home.cs.tu-berlin.de
Thu, 21 Jun 2001 08:46:53 +0200

> Cool, just be sure to make docstring extraction optional.  E.g. it
> makes sense for Mailman's bin/* scripts where the module docstring
> doubles as usage text, but it doesn't make much sense for most plain
> old module docstrings.

Certainly. This is essentially like a new keyword (-k) to look for.

> OTOH, maybe we should define a convention in the docstring to indicate
> that it's ripe for extraction.  E.g. an _ as the first character in
> the docstring...

Please, no. In any case, it is up to translators to translate them; if
the doc strings look too useless, they can ignore them.