Re: help2man usage with pybuild / debhelper packaging workflow
On Sat, Jun 4, 2016 at 12:30 AM, Christian Seiler wrote:
> Well, you could add a custom target to debian/rules that calls
> help2man for all these scripts - so that you as a maintainer
> can refresh the manpages every now and then. (And store them
> in debian/ in the packaging.) That way, you don't break cross
> builds (manpages are pre-generated), but still automate it to
> a large extent.
I don't think it is ever appropriate to store pre-generated files in
source packages, neither in the upstream tarball nor in the Debian
tarball (except for autotools cruft or VCS metadata through
autorevision).
For Python stuff, it is generally arch all and never needs to be
cross-built so help2man is fine.
In any case, using something like sphinx and sphinxcontrib-autoprogram
or python3-sphinx-argparse plus manual page source in Markdown or
reStructuredText format is a better way to go since you get a nice
format to write in and automatically sync your --help output with the
manual page.
--
bye,
pabs
https://wiki.debian.org/PaulWise
Reply to: