• rumba@lemmy.zip
    link
    fedilink
    English
    arrow-up
    4
    ·
    16 hours ago

    I was always onboard to RTFM, that was my primary learning tool, but some of those fucking manuals were written by people who are entirely incapable of writing documents in a way that people who don’t already know the contents can understand it.

    Once you know something, almost any manpage is fine for reference, but few of the manpages actually teach you cleanly how to use a command from a beginner standpoint.

    • JigglySackles@lemmy.world
      link
      fedilink
      English
      arrow-up
      1
      ·
      19 minutes ago

      That’s been my biggest gripe with man pages since I first tried Linux decades back. I couldn’t figure it out because most every page back then was written by an engineer for other engineers.

      • rumba@lemmy.zip
        link
        fedilink
        English
        arrow-up
        2
        ·
        8 minutes ago

        There are occasional ones that are ok, man ip for example include examples, but you have to make it below lengthy Synopsis and Options

    • spizzat2@lemmy.zip
      link
      fedilink
      English
      arrow-up
      5
      ·
      edit-2
      16 hours ago

      Yes, at a minimum, I feel like every man page would be well served by a single example near the top that is something like

      Common Usage:

      grep [what] [where]

      e.g.

      grep “search string” *.txt

      Instead it’s “grep [-the entire alphabet, twice] [-12 other options you probably won’t use] [cryptic arguments]”

      The description is helpful, at least.