On Sun, Nov 04, 2018 at 10:28:31AM +0100, Mattia Rizzolo wrote:
> I'm wary of one thing: I don't really want to be bothered by this.
same here.
> Going around patching upstream's manpages to add an EXAMPLE section is
> totally busywork, not mention possibly even hard to do for all the
> autogenerated manpages.
> What I mean is: if there is really enough people wanting this change by
> all means do it, but 1. make the wording clear that is really optional
> (in this view, I see "recommended" as too strong a word) and 2. I really
> hope lintian won't start bothering for this.
totally agreed.
manpages are great for cli software but for lots of desktop software
most of its users (and developers?) dont even know what manpages are, or
how to use them. thus I consider current policy (which treats the
absence of a manpage for *every* program, utility, and function in
Debian as a bug) already to be too strong today.
--
cheers,
Holger
-------------------------------------------------------------------------------
holger@(debian|reproducible-builds|layer-acht).org
PGP fingerprint: B8BF 5413 7B09 D35C F026 FE9D 091A B856 069A AA1C
Attachment:
signature.asc
Description: PGP signature