This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients Arfrever, docs@python, eli.bendersky, eric.araujo, ezio.melotti, flox, leonov, scoder
Date 2012-02-23.01:27:01
SpamBayes Score 3.5893943e-10
Marked as misclassified No
Message-id <1329960422.72.0.602754063182.issue14006@psf.upfronthosting.co.za>
In-reply-to
Content
> The ElementTree.py module has good JavaDoc-style function-level documentation, but as it's not
> in docstring format, it can't be seen from the interactive help.
> 
> I'd be willing to convert the current comments into docstrings, as long as I wouldn't be
> stepping on anybody's toes,
Great, thanks!  I don’t know if the best approach here is to add lengthy docstrings or move the information from the comments into the reST docs.  Maybe this should be asked on the core-mentorship or python-dev mailing list.

> and somebody could give me some guidance as to how to convert the @return and @param declarations
In docstrings as well as in reST docs we just use English, with asterisks to mark up parameters, e.g. “*path* is an instance of :class:`ElementPath`. ... Returns ``True`` if there is a match, ``False`` otherwise.”

> and how to handle the C version of the module.
Doctrings for C modules are not hard to find, just a little painful to write.  If we agree to turn comments into docstrings and you need help, I’ll be glad to guide you with that.
History
Date User Action Args
2012-02-23 01:27:02eric.araujosetrecipients: + eric.araujo, scoder, ezio.melotti, Arfrever, eli.bendersky, leonov, flox, docs@python
2012-02-23 01:27:02eric.araujosetmessageid: <1329960422.72.0.602754063182.issue14006@psf.upfronthosting.co.za>
2012-02-23 01:27:02eric.araujolinkissue14006 messages
2012-02-23 01:27:01eric.araujocreate