邂逅PyDoc

先感谢 霏昀 在qq群上问了个问题:
"想pydoc用生成一个目录的文档，调哪个函数？"
这个问题我现在还答不出来.

不过我查了一下pydoc的资料,manual里居然没多少东西(其实已经讲得很清楚了,可能是习惯了,太短的东西就觉得讲得不全),发扬我一贯的作风直接看source.
pydoc太经典了,居然是用于生成python 文档的工具,
根据文件开头的注释
随手打了
pydoc -p 8070
哈哈 用浏览器看一下http://localhost:8070/  居然是python模块的文档,非常全,因为他是直接从源文件里生成的.以后可以省得乱翻source找模块和包的文件了,因为他自动生成了很好的连接,布局也不错,唯一美中不足的是页面有点丑,但是规划得不错,这个就不强求了.

译编码风格的时候还不理解什么叫docstring,现在知道了,原来可以用于生成文档的. : )

看看官方文档的描述,不过好像不是自带的那个,呆会儿我在试一下

PyPI: epydoc 2.1

A tool for generating API documentation for Python modules, based on their docstrings. Epydoc supports two output formats (HTML and PDF), and four markup languages for docstrings (Epytext, Javadoc, ReStructuredText, and plaintext).