Guido van Rossum wrote: > [I'm hoping David Goodger is reading this on python-dev. Yes, I do. I read it off the web. I know I can now subscribe without going through the initiation ceremony and learning the secret handshake, but old habits die hard. > > What about existing docstrings? There is plenty of informal markup in > > there already. > Yeah, but they're not using any particular formal markup. You'd still > have to do a massive, *massive* cleanup if you wanted reST to apply. > And it's not clear what the advantage would be ... > The situation would be different if the goal was to replace > the reference docs, but since it isn't, I think the informal markup is > just fine. Fair enough. This is a long-term project. Plenty of time to change your mind later, when the advantages become clear. :-) -- David Goodger goodger@users.sourceforge.net Open-source projects: - Python Docstring Processing System: http://docstring.sourceforge.net - reStructuredText: http://structuredtext.sourceforge.net - The Go Tools Project: http://gotools.sourceforge.net
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