On 2016-06-03 18:30 +0200, Christian Seiler wrote: > On 06/03/2016 06:25 PM, Ghislain Vaillant wrote: > > And I don't mind for a handful of scripts. But what if you have 20 or > > 30? > > 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. Yep, that's a reasonable plan. Missing man pages is better than things that gratuitously won't cross-build. Just copying the help into a man page is mostly makework to shut lintian up. They are often very poor manpages. If the help is there already or upstream documentation is some other format (e.g. html), then if you _really_ can't be bothered making man pages, just leave it as upstream supplied. Using help2man is a worse 'solution' than doing nothing. Wookey -- Principal hats: Linaro, Debian, Wookware, ARM http://wookware.org/
Attachment:
signature.asc
Description: Digital signature