News for hackers. Stuff that matters.
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.
Re:The Art of Command Line (2015) by cpach on Thursday May 23, 2019 @05:06AM (#19989852)
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.

Re:The Art of Command Line (2015) by muxator on Thursday May 23, 2019 @03:49PM (#19995278)
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 ...
Re:The Art of Command Line (2015) by monista on Thursday May 23, 2019 @02:50PM (#19994672)
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.