groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [groff] mom manpage


From: Doug McIlroy
Subject: Re: [groff] mom manpage
Date: Sat, 01 Dec 2018 09:27:03 -0500
User-agent: Heirloom mailx 12.5 7/5/10

> if you are interested in my perspective - scrap the HTML documentation
> and fix the manpage.  The reference manual - i.e. the manpage - is
> really important: when you use some software regularly, you use the
> reference manual all your life.  Catering to the experienced user

> is most important because whoever is serious about using the software
> will become experienced sooner rather than later.  So the reference
> manual (manpage) must be concise, precise, and correct.
...
> This is not rocket science and nothing new - just do it...

+10

Software that inherently defies concise description is suspect on
its face. In all likelihood it was built by accumulation way beyond
the bounds of any organizing principles that the author(s) may have
had at the outset.

Doug



reply via email to

[Prev in Thread] Current Thread [Next in Thread]