Re: Should we standardize a way to create and maintain manpages?
On Tue, 2020-12-22 at 16:44 +0200, Andrius Merkys wrote:
> Hi Andreas,
>
> On 2020-12-21 18:49, Andreas Tille wrote:
> > I really like this idea. The problem why I stopped using plain
> > help2man
maintaining man pages is quite a hell when not provided, depends on
tool "help" , customize which option to get for help, and result in
quite often non up-to-date man pages... :-(
I usually don't... as quite often *xxx -h* is verbose enough to give
software hints/usage and do not need a man page.
> > is that in most cases the result is not a proper manpage. So I
> > frequently
> > used a createmanpages while beeing perfectly aware that upstream
> > changes
> > could make these (partially) wrong. I'd love to have a better
> > solution -
> > but the lintian check would be extremely helpful.
>
> Thank you for your opinion. I will proceed with submitting a request
> for
> the lintian check (with the help from Nilesh). I think such lintian
> check would be of value independently of whichever way to create and
> maintain manpages is chosen for standardization.
>
> Best,
> Andrius
>
--
Olivier Sallou
Univ Rennes, Inria, CNRS, IRISA
Irisa, Campus de Beaulieu
F-35042 RENNES - FRANCE
Tel: 02.99.84.71.95
gpg key id: 4096R/326D8438 (keyring.debian.org)
Key fingerprint = 5FB4 6F83 D3B9 5204 6335 D26D 78DC 68DB 326D 8438
Reply to: