Re:The Art of Command Line (2015)
by pfortuny on Thursday May 23, 2019 @04:17AM
(#19989623)
OpenBSD man pages are what engineering documents should be. The contrast with Linux's is astounding.
[ Parent
| on HN ]
This reminds me of a writeup by John Carmack. Last year he did a programming retreat where he set up a OpenBSD dev environment and tried to use the base system and the included documentation as much as possible rather than using ports and WWW†. That would probably not be so nice on a Linux system.
https://www.facebook.com/permalink.php?story_fbid=2110408722...
† Anyone else here that remembers the days when man pages and Windows help files used to be referred to as online documentation? As opposed to printed manuals.
The MSDN CDs where an endless source of amusement. The reference manuals were very good and search actually worked well. Did not feel crippled at all.
Re:The Art of Command Line (2015)
by wodenokoto on Thursday May 23, 2019 @08:27AM
(#19991015)
I don't know.
From `man wc`
WC(1) BSD General Commands Manual
WC(1)
NAME
wc -- word, line, character, and byte count
When in actuality `wc` outputs lines, words bytes ...You probably referring to FreeBSD man, OpenBSD is slightly different:
https://man.openbsd.org/wc.1
Re:The Art of Command Line (2015)
by wodenokoto on Thursday May 23, 2019 @03:42PM
(#19995215)
That still has the order wrong in the name section.
I mean, strictly speaking, the name field doesn’t document the output, but having those aligned makes the documentation much easier to read.