Clarification: Just making fun of people(including myself) who watch shitty videos instead of official documentation.

You are viewing a single thread.
View all comments
103 points

Man pages are for people who already know a lot about Linux and understand all the nuances and understanding of Linux

Even after using Linux for many many years I still don’t understand wtf nearly all man pages mean. It’s like a fucking codex. It needs to be simplified but not to the extreme where it doesn’t give you information you need to understand it.

Tbh that’s most of Linux, not designed for average people, designed by Linux users who think that all others should know everything about Linux.

permalink
report
reply
36 points

Enter tldr and navi

permalink
report
parent
reply
13 points

I’d like to add apropos to this as well.

permalink
report
parent
reply
3 points

my favorite is tealdeer!

permalink
report
parent
reply
1 point

I find them very useful for programs that I already know what to use them for otherwise I usually consult the arch wiki.

permalink
report
parent
reply
16 points

They also usually assume a lot about the users’ knowledge of the domain of the program itself.

In my experience, many programs’ man/help is very brief, often a sentence or less per command/flag, with 2 or more terms that don’t mean anything to the uninitiated. Also, even when I think I know all the words, the descriptions are not nearly precise enough to confidently infer what exactly the program is going to do.
Disclaimers for potentially dangerous/irreversible actions are also often lacking.

Which is why I almost always look for an article that explains a command using examples, instead of trying to divine what the manual authors had in mind.

permalink
report
parent
reply
10 points

Tbh a lot of man pages don’t even give you enough usage information to make full use of a package. I’m thinking of the ones which are like an extended --help block

permalink
report
parent
reply
9 points
*

l must be using man pages very differently from you. To me they are mostly the easy reference to check the available flags for a command, and sometimes the reference on available config file entries, e.g. ssh_config(5)

For those things I was using them quite soon when I started using Linux, because it’s quicker than googleing every time if you just need one flag or one option name. For more complex things, like tar-and-gzip in one which needs like four, I still google though.

Probably there are very complicated ones too, the ones explaining subsystems or APIs of the kernel, but those I don’t need as a user.

permalink
report
parent
reply
5 points

I don’t get it either. I can see how you’re getting confused if you end up in section 2 or 3 of the manpages or with the kernel calls. But that’s not what a beginner is looking for. The manpages for the user commands are pretty alright. Sometimes even excellent.

permalink
report
parent
reply
2 points

It depends on who writes them, I guess. More “modern” software come with pretty good and concise manpages, meanwhile stuff like the coreutils still have manpages that feel like an incomprehensible mess.

permalink
report
parent
reply

linuxmemes

!linuxmemes@lemmy.world

Create post

Hint: :q!


Sister communities:

Community rules (click to expand)

1. Follow the site-wide rules
2. Be civil
  • Understand the difference between a joke and an insult.
  • Do not harrass or attack users for any reason. This includes using blanket terms, like “every user of thing”.
  • Don’t get baited into back-and-forth insults. We are not animals.
  • Leave remarks of “peasantry” to the PCMR community. If you dislike an OS/service/application, attack the thing you dislike, not the individuals who use it. Some people may not have a choice.
  • Bigotry will not be tolerated.
  • These rules are somewhat loosened when the subject is a public figure. Still, do not attack their person or incite harrassment.
3. Post Linux-related content
  • Including Unix and BSD.
  • Non-Linux content is acceptable as long as it makes a reference to Linux. For example, the poorly made mockery of sudo in Windows.
  • No porn. Even if you watch it on a Linux machine.
4. No recent reposts
  • Everybody uses Arch btw, can’t quit Vim, <loves/tolerates/hates> systemd, and wants to interject for a moment. You can stop now.
5. 🇬🇧 Language/язык/Sprache
  • This is primarily an English-speaking community. 🇬🇧🇦🇺🇺🇸
  • Comments written in other languages are allowed.
  • The substance of a post should be comprehensible for people who only speak English.
  • Titles and post bodies written in other languages will be allowed, but only as long as the above rule is observed.

 

Please report posts and comments that break these rules!


Important: never execute code or follow advice that you don’t understand or can’t verify, especially here. The word of the day is credibility. This is a meme community – even the most helpful comments might just be shitposts that can damage your system. Be aware, be smart, don’t remove France.

Community stats

  • 7.4K

    Monthly active users

  • 1.4K

    Posts

  • 76K

    Comments