Re: epydoc reST markup for stdlib docstrings
Fred Drake <[email protected]>
| Newsgroups | gmane.comp.python.documentation |
|---|---|
| Message-ID | <[email protected]> |
On Wed, Apr 14, 2010 at 8:44 AM, Michael Foord <[email protected]> wrote: > I too would prefer a consistent pattern be adopted for the Python standard > library. Good luck finding someone to go and change all the docstrings in > the standard library to use it... We found someone interested in converting the LaTeX to ReST, didn't we? :-) If we can come up with a good recommendation, it'll take hold fairly thoroughly. Not quickly at first, but once there's value (tools) to be had it'll happen. The value for the standard library is that the documentation maintenance can be moved closer to the code, and is less likely to get out of sync. -Fred -- Fred L. Drake, Jr. <fdrake at gmail.com> "Chaos is the score upon which reality is written." --Henry Miller _______________________________________________ Doc-SIG maillist - [email protected] http://mail.python.org/mailman/listinfo/doc-sig