this post was submitted on 16 Nov 2026
459 points (97.7% liked)

Technology

89924 readers
3483 users here now

This is a most excellent place for technology news and articles.


Our Rules


  1. Follow the lemmy.world rules.
  2. Only tech related news or articles.
  3. Be excellent to each other!
  4. Mod approved content bots can post up to 10 articles per day.
  5. Threads asking for personal tech support may be deleted.
  6. Politics threads may be removed.
  7. No memes allowed as posts, OK to post as comments.
  8. Only approved bots from the list below, this includes using AI responses and summaries. To ask if your bot can be added please contact a mod.
  9. Check for duplicates before posting, duplicates may be removed
  10. Accounts 7 days and younger will have their posts automatically removed.

Approved Bots


founded 3 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] rumba@lemmy.zip 4 points 3 days ago (2 children)

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.

[–] spizzat2@lemmy.zip 5 points 3 days ago* (last edited 3 days ago) (3 children)

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.

[–] neclimdul@lemmy.world 2 points 2 days ago

most man man pages have an example section. its at the bottom because man pages are optimized as a reference since that's what you use them for most.

that said, greps example section is obtuse so a couple more straight forward examples would probably serve it well.

i think the bigger problem with the rtfm response is we often dont know what we know. The Unix/Linux software systems have ton of internalized knowledge. everything is a file. comfort on a cli shell. pipes and chaining cli programs. common command arguments and man page structures. Tons I'm forgetting I'm sure.

If you have all those things internalized, a quick trip to man is probably all you need. But if someone's asking, that isnt true, and you need to coax them toward the right location by explaining how and why the answer is in ths manual.

Teach them to fish as the saying goes.

[–] rumba@lemmy.zip 4 points 3 days ago

Some of them are really well done

Some of them look like they're summoning a Great One

[–] michaelnik@lemmy.world 3 points 3 days ago (1 children)

I recommend installing tldrpackage, it does what you are just describing.

[–] spizzat2@lemmy.zip 2 points 3 days ago

Well, that looks amazing. Thank you!

[–] JigglySackles@lemmy.world 1 points 2 days ago (1 children)

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 2 points 2 days 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