< ^ txt
Sun Jul 5 10:48:36 EDT 2015
I stayed up too late again last night. It's going to be hard to go to bed on time tonight.
I did some reading last night on creating man pages and the groff typesetting language used to do so.
http://paulgorman.org/technical/linux-writing-man-pages.txt
Groff looks simple enough, although mdoc might be a good option.
OpenBSD man pages are better than many linux man pages by a significant margin. That struck me immediately when I started playing with OpenBSD this year.
What makes OpenBSD man pages better? I'd like to do some side-by-side comparisons today. Having not yet done so, my general impression is that the OpenBSD man pages feel like a wise mentor advising you (albeit tersely) on how and why to do something. The linux man pages feel like a bare list of flags that might have been auto-generated from one-line source code comments.
< ^ txt