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

Barry A. Warsaw barry@wooz.org
Wed, 20 Jun 2001 18:07:52 -0400

>>>>> "MvL" == Martin v Loewis <martin@loewis.home.cs.tu-berlin.de> writes:

    >> Cool.  Let me know if I can help.  I'm relying on pygettext
    >> quite heavily in Mailman, so I think it's pretty solid (latest
    >> revision is pygettext.py 1.20).

    MvL> Personally, I think xgettext should itself recognize
    MvL> docstrings. The po-utils already support extracting doc
    MvL> strings, and I added support to extract strings with __doc__
    MvL> from C modules as well.

    MvL> Maybe I'll look into contributing these features to GNU
    MvL> gettext with native code.

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.

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...