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

Peter Pentchev <[email protected]> Sun, 10 May 2020 23:31:41 +0300
Newsgroups	gmane.linux.debian.user.russian
Message-ID	<[email protected]>
On Thu, Apr 23, 2020 at 12:15:52PM +0300, Victor Wagner wrote:
> В Thu, 23 Apr 2020 11:51:48 +0400
> [email protected] пишет:
> 
> > On Thu, 23 Apr 2020 09:34:37 +0300
> > Victor Wagner wrote:
> > 
> > VW> dh_python из коробки поддерживает систему документирования sphynx,
> > VW> Но я заглянул в её описание и понял, что ничего не понял. Она
> > VW> ориентирована в первую очередь на написание документации к
> > VW> библиотека, для программистов, а не на man-страницы, для
> > VW> пользователей.  
> > 
> > В сторону Asciidoc гляньте (сам не пробовал).
> 
> Дело не в том, какой язык разметки использовать.
> 
> В конце концов писал я 20 лет маны непосредственно на *roff.
[snip]

BTW пробовали когда-то -mdoc? Мне всегда казалось, что лучше
использовать семантичних макросов, а не типографских.
Пример: https://gitlab.com/confget/confget/-/blob/master/confget.1

> Если же это правило писать вручную через override_dh_auto_install, то
> придется потом debian/rules хранить в git, а не перегенерировать каждый
> раз с помощью py2dsp из пакета pypi2deb.

Если Вы уже используете debhelper, тогда у Вас dh_installman
вызывается автоматично, так что опишите something.1 и another.1
в debian/manpages, он их поставит. Конечно, если самие *.1
не в upstream source, debian/manpages может содержать и пути
внутри debian/*, как в https://sources.debian.org/src/mktorrent/1.1-2/debian/manpages/

Всего лучшего,
Петр

-- 
Peter Pentchev  [email protected] [email protected] [email protected]
PGP key:        http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint 2EE7 A7A5 17FC 124C F115  C354 651E EFB0 2527 DF13
signature.asc (application/pgp-signature, 833 B)