Может ли pydoc использоваться для создания manpages?

Question

У меня есть набор скриптов python, для которых я хотел бы создавать manpages. Они задокументированы документами, поэтому я могу получить документацию по этому пути, но я также хотел бы иметь manpages.

Есть ли способ использовать pydoc для генерации * roff-источников для manpages?

Редактировать: Что-то вроде pod2man perl для python.

Answer 1

pydoc не генерирует страницы Справочника, просто показывая документы в виде страницы человека:

... в стиле похож на ручных страницах, отображаемых командой Unix человек ...

Вы можете сохранить его:

pydoc sys >sys-docs.txt 

или с терминалом "цвета" (используйте less, чтобы сделать их):

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