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

Karl Eichwalder keichwa@gmx.net
24 May 2001 22:02:47 +0200


barry@wooz.org (Barry A. Warsaw) writes:

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

>     MvL> #, py-doc
> 
>     MvL> I don't know the exact specification of the #, comments, but
>     MvL> it can look like
> 
>     MvL> #, c-format, fuzzy
> 
>     MvL> i.e. it appears to be a comma-separated list of informative
>     MvL> flags. Translators could then decide to deal with doc strings
>     MvL> in a different manner (e.g follow different grammatical
>     MvL> conventions).

> I think the correct thing to do is to mark docstring extractions with
> 
>     #. docstring
> 
> comments.

No, #. is reserved for literally extracted comments; #, is for
meta-comments.  Martin's proposal sounds better.

-- 
work : ke@suse.de                          |                   ,__o
     : http://www.suse.de/~ke/             |                 _-\_<,
home : keichwa@gmx.net                     |                (*)/'(*)