1. 19
  1.  

    1. 6

      One of the complains linked herein is one of my biggest complaints for all of the free operating systems: man pages aren’t kept in sync with what is actually there.

      It’s not enough to make the man pages reflect things that are added; you need to update the pages that reference those pages too.

      Major pet peeves.

      1. 10

        I really like how OpenBSD handles man page issues - missing, outdated, unclear, or incorrect documentation is considered a bug. Of course, what they have to back that up is a culture that considers those bugs serious and actually fixes them. For a user, it means you can probably use apropos instead of Google and still get good and relevant information.

        1. 4

          Yeah, I actually managed to configure my wifi on my laptop with just apropos and man pages on openbsd. The culture is wrong with linux.

          1. 2

            For a user, it means you can probably use apropos instead of Google and still get good and relevant information.

            Not only still but often even better results than by searching the web. At least that’s my experience when it comes to OpenBSD man pages vs Internet tutorials…

        2. 3

          Ah, nice to see this broken link has been resuscitated! (e.g. https://news.ycombinator.com/item?id=12251330)

          1. 1

            For reference: same Dustin Kirkland that relates to the whole Ubuntu displays advertising in /etc/motd recently

            We need a systemd-motd ? :-D /me runs