Debian-way мануалы для python-ск риптов

Victor Wagner <[email protected]>
Newsgroups gmane.linux.debian.user.russian
Message-ID <[email protected]>
Коллеги,

Может быть кто поделится опытом - как правильно писать man-ы для
скриптов на питоне.

dh_python из коробки поддерживает систему документирования sphynx, Но я
заглянул в её описание и понял, что ничего не понял. Она ориентирована
в первую очередь на написание документации к библиотека, для
программистов, а не на man-страницы, для пользователей.

А у меня фактически чистый командно-строчный скрипт, хотя и организован
по питоновским правилам - набор модулей и setup.py на setuptools,
который генерирует запускалку. И lintian, естественно, ворчит что вот
есть исполняемый файл в /usr/bin а man-страницы к нему нет. 

Ну то есть понятно, что можно после генерации пакетировочных файлов
прописать туда override_dh_install и подложить написанную руками на
*roff страничку, но хочется как-то поэстетичнее, чтобы потом
поддерживать легче было. Писать же исходник на *roff, markdown или rst
- как-то все равно. 

Дополнительная призовая игра - а чтобы многоязычные (русского и
английского для начала хватит) маны?
--
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.