➜

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.

作者 LambertDW
收信人 LambertDW, dalloliogm
日期 2009-01-09.19:52:58
SpamBayes Score 0.0011013316
Marked as misclassified 否
Message-id <1231530779.73.0.818206141585.issue4899@psf.upfronthosting.co.za>
In-reply-to
内容
I disagree.  Purpose of __doc__ is to explain functionality all at once.
This command idiom is useful:

$ python -c 'from a_module import thing; help(thing)'

The doctest module is a lightweight nicety that helps verify that which
is suitable.  The sufficiently simple algorithms of my code have doc
strings that are the complete test and explanation.  For others I
provide both docstring and unit tests.  But with many I explain the
arguments and output, possibly the algorithm in a doc string.  Tests and
use case examples reside in the module's unit test.

I'm among the "Choose correct tool for the job.  python comes with full
tool bag." group.
历史
日期 用户 动作 参数
2009-01-09 19:52:59LambertDW修改recipients: + LambertDW, dalloliogm
2009-01-09 19:52:59LambertDW修改messageid: <1231530779.73.0.818206141585.issue4899@psf.upfronthosting.co.za>
2009-01-09 19:52:59LambertDW链接issue4899 messages
2009-01-09 19:52:58LambertDW创建