pydoc可以用来生成手册吗？

Question

我有一组python脚本，我想为其创建手册页。它们是用docstring记录的，所以我可以通过这种方式获得文档，但我也希望有手册。

有没有一种方法可以使用pydoc为手册生成*roff源？

编辑:类似于perl的pod2man for python。

Answer 1

比多并不是在生成手册页，而是以手册页的形式显示文档：

...in风格类似于Unix命令显示的手册页面.

您可以通过以下方式保存它：

pydoc sys >sys-docs.txt

或使用终端颜色(使用less渲染它们)：

PAGER="cat>sys-docs.txt" pydoc sys