[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [groff] mom manpage
From: |
Ulrich Lauther |
Subject: |
Re: [groff] mom manpage |
Date: |
Wed, 5 Dec 2018 12:35:12 +0100 |
User-agent: |
Mutt/1.9.0 (2017-09-02) |
Peter, I couldn't agree more to what you are saying.
In my opinion, a man page should contain (at most) NAME, SYNOPSIS, COPYRIGHT,
DESCRIPTION,
OPTIONS, ARGUMENTS, INVOCATION, but not LANGUAGE.
A bad example is bash: NAME to INVOCATION take 210 lines, o.k..
The whole man-page is 5869 lines. A horror to search for some feature you need,
even if you vaguely remember to have it seen before.
And on the other hand, how happily I browse through the html mom
documentation! (38472 lines, more than 6.5 times the bash lines)
Cheers and thanks to Peter,
ulrich
- Re: [groff] mom manpage, John Gardner, 2018/12/01
- Re: [groff] mom manpage, Doug McIlroy, 2018/12/01
- Re: [groff] mom manpage, Peter Schaffter, 2018/12/04
- [groff] man page structure and philosophy (was: mom manpage), G. Branden Robinson, 2018/12/11
- Re: [groff] man page structure and philosophy (was: mom manpage), Ingo Schwarze, 2018/12/11
- [groff] Asynchronous events (was: man page structure and philosophy (was: mom manpage)), G. Branden Robinson, 2018/12/11
- Re: [groff] Asynchronous events, Ingo Schwarze, 2018/12/11
- Re: [groff] Asynchronous events, James K. Lowden, 2018/12/12