Коллеги,

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

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

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

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

Дополнительная призовая игра - а чтобы многоязычные (русского и
английского для начала хватит) маны?
-- 

Ответить