3 ms·
I learned BSD largely from the man pages, but man pages on Linux distributions always felt a bit deficient to me, partly because of GNU utilities with placehold
by musicale 7y ago
I learned BSD largely from the man pages, but man pages on Linux distributions always felt a bit deficient to me, partly because of GNU utilities with placeholder man pages that just said "use info instead" and partly because of (at the time at least) many missing EXAMPLES sections.
I think they've improved greatly, but man pages on Debian, Ubuntu et al. still feel a bit like second-class citizens.
What TLDR pages seem to be getting right is putting EXAMPLES first or second rather than last, and/or having a command to bring up EXAMPLES.
Also I want to put in a plug for AUTHORS/HISTORY and BUGS sections. The former can create a sense of community and context and the latter can point out annoying gotchas.
- JdeBP 7y agoContext, definitely. I have myself found them to be very useful. This is why I added HISTORY sections to the user manuals for some of Daniel J. Bernstein's tools when I converted them. * http://cr.yp.to/daemontools/multilog.html http://cr.yp.to/daemontools/multilog.html * http://jdebp.uk./Softwares/djbwares/guide/commands/multilog.xml http://jdebp.uk./Softwares/djbwares/guide/commands/multilog....