Коллеги, Может быть кто поделится опытом - как правильно писать man-ы для скриптов на питоне.
dh_python из коробки поддерживает систему документирования sphynx, Но я заглянул в её описание и понял, что ничего не понял. Она ориентирована в первую очередь на написание документации к библиотека, для программистов, а не на man-страницы, для пользователей. А у меня фактически чистый командно-строчный скрипт, хотя и организован по питоновским правилам - набор модулей и setup.py на setuptools, который генерирует запускалку. И lintian, естественно, ворчит что вот есть исполняемый файл в /usr/bin а man-страницы к нему нет. Ну то есть понятно, что можно после генерации пакетировочных файлов прописать туда override_dh_install и подложить написанную руками на *roff страничку, но хочется как-то поэстетичнее, чтобы потом поддерживать легче было. Писать же исходник на *roff, markdown или rst - как-то все равно. Дополнительная призовая игра - а чтобы многоязычные (русского и английского для начала хватит) маны? --