Greg Ward wrote:
>
> On 08 November 2001, Gustavo Niemeyer said:
> > It means that about 10% of python's executable is documentation.
>
> Interesting! I wonder what the corresponding figure for .pyc files in
> the std library is.
>
> > Now I'm
> > wondering if something like a DOCSTRING("foo") macro would be valid in
> > that case. If the user disabled it trough --disable-doc, for example,
> > DOCSTRING() would return "".
>
> I think it would have to be a bit fancier than that; wouldn't you also
> have to specify the name of the C identifier into which that
> documentation is put? That's doable in an all-ANSI-C world, but
> trickier than DOCSTRING("foo").
>
> Anyways, that sounds like a useful idea. It would probably be a big
> patch that touches lots of files, so it's unlikely to get into Python
> 2.2. You might consider whipping up a patch now to get it under
> consideration early in 2.3's life-cycle.
Even better: why not work together with Martin to have the doc-strings
localized ?! (One of the possible languages could then be the emtpy
one ;-)
--
Marc-Andre Lemburg
CEO eGenix.com Software GmbH
______________________________________________________________________
Consulting & Company: http://www.egenix.com/
Python Software: http://www.lemburg.com/python/
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4