Florent Xicluna <florent.xicl...@gmail.com> added the comment: FWIW, Fredrik, who is the creator of ElementTree, had a preference for JavaDoc conventions, as explained here: http://bugs.python.org/issue6488#msg102087
They are compatible with the tool PythonDoc, authored by Fredrik too: http://www.effbot.org/zone/pythondoc.htm However, I agree it makes sense to turn them into docstrings if the package is only maintained in the standard library. BTW, the issue 6488 is still opened. I did not check if there's something left to do before to close it. There's also a patch attached to issue 2864, which need some review. ---------- dependencies: +ElementTree documentation refers to "path" with no explanation, and inconsistently nosy: +effbot _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue14006> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
