On 2010-11-02 10:42:22 +0000, jk said:
Hi,I've been coding in PHP and Java for years, and their documentation is concise, well structured and easy to scan.
Are you mad? Javadoc is one of the worst examples of source code documentation I can possibly imagine. I would go as far to say that the Python guys should do exactly the opposite of Javadoc.
-- http://mail.python.org/mailman/listinfo/python-list