Re: Debian-way мануалы для python-скриптов
В Sun, 10 May 2020 23:31:41 +0300
Peter Pentchev <roam@ringlet.net> пишет:
> On Thu, Apr 23, 2020 at 12:15:52PM +0300, Victor Wagner wrote:
> > В Thu, 23 Apr 2020 11:51:48 +0400
> > a.v.korotkov@gmail.com пишет:
> >
> > > On Thu, 23 Apr 2020 09:34:37 +0300
> > > Victor Wagner wrote:
> > >
> > > VW> dh_python из коробки поддерживает систему документирования
> > > VW> sphynx, Но я заглянул в её описание и понял, что ничего не
> > > VW> понял. Она ориентирована в первую очередь на написание
> > > VW> документации к библиотека, для программистов, а не на
> > > VW> man-страницы, для пользователей.
> > >
> > > В сторону Asciidoc гляньте (сам не пробовал).
> >
> > Дело не в том, какой язык разметки использовать.
> >
> > В конце концов писал я 20 лет маны непосредственно на *roff.
> [snip]
>
> BTW пробовали когда-то -mdoc? Мне всегда казалось, что лучше
> использовать семантичних макросов, а не типографских.
В -man более чем достаточно семантических макросов.
Да, в некоторых сообществах принят такой стиль, когда используют
физическую разметку, например в Tcl это очень любят. Но это именно
заморочки конкретных сообществ.
в> > Если же это правило писать вручную через override_dh_auto_install,
> > то придется потом debian/rules хранить в git, а не перегенерировать
> > каждый раз с помощью py2dsp из пакета pypi2deb.
>
> Если Вы уже используете debhelper, тогда у Вас dh_installman
> вызывается автоматично, так что опишите something.1 и another.1
> в debian/manpages, он их поставит. Конечно, если самие *.1
Это все, конечно хорошо, но как объяснить питноовскому setuptools
что по команде setup.py sdist их надо в orig.tar.gz положить?
> не в upstream source, debian/manpages может содержать и пут
В том-то и дело, что мне хочется сформировать такой upstream source,
который был бы весь из себя pythonway, настолько что я бы мог не
заботиться о ручном написании содержимого директории debian,
зная что py2dsc все сделает правильно.
Я не хочу хранить debian/* в version control, хочу их каждый раз
воссоздавать автоматически
--
Reply to: