422
Man pages bad (sh.itjust.works)
top 50 comments
sorted by: hot top controversial new old
[-] olsonexi@lemmy.world 88 points 1 year ago

what's wrong with man pages?

[-] drolex@sopuli.xyz 74 points 1 year ago

You need to read them apparently? I don't know, this is weird

[-] chuso@kbin.social 37 points 1 year ago

Yeah, many people don't want to read and understand, just copy and paste.
I saw that in a lot of people I worked with on projects, they just look for something to copy and paste from the Internet without even trying to understand what it does. Just looking for some command without even paying attention to the text around it.
I remember one girl once that I gave her the link to the documentation explaining step by step what she needed to do, a link I had to find myself and pass it to her, of course, even when it was her task. Those steps included some alternatives like "if you are in this situation, run this command, but if you are in this other situation, run this other command" but she ignored all the instructions on that page and started copying and pasting every command that was found there. When I asked her what she was doing and why she was running every command there without reading the explanations around them, she said she thought she just had to run all the commands on that page.

[-] CapeWearingAeroplane@sopuli.xyz 19 points 1 year ago* (last edited 1 year ago)

The amount of times someone has asked me why something doesn't work, and I've silently pointed to the sentence or paragraph next to the code snippet they've copied...

[-] chuso@kbin.social 10 points 1 year ago

Oh, yeah. I had this situation so many times in this same project. Even pointing them to the documentation and telling them to read it because the explanation was there didn't even work because they just wanted immediate answers. Sometimes I even had to join them on a call and tell them to stop, open the link on a screenshare and read it out loud to me to make sure they were actually reading it and not just telling me they read it.
It felt like teaching to read to first-grade schoolers.

[-] drolex@sopuli.xyz 14 points 1 year ago

not reading that essay (/s)

It's strange. The man pages contain everything you need to know and even examples ready to use. But people would rather try and fail several times. I wonder what inner motivation makes someone have this kind of process. Is there a reward when you manage to make it work through erring? Psychologists, do you know?

[-] chuso@kbin.social 6 points 1 year ago

I think it's that the mental effort required to read the documentation, understanding how a tool works and producing an idea in your mind of how to achieve your purpose with the learning you just got of how that tool works is usually bigger.
Even if it takes more time, the mental effort of copying and pasting examples from Google until you find the one that works is way lower.

[-] chuso@kbin.social 3 points 1 year ago* (last edited 1 year ago)

And that reminds me of an anecdote with one of the products our customers usually use. There was a problem which was kind of common and it had a discussion thread in the forum on the vendor's website where somebody suggested that the solution to the problem was rm -rf /var/lib/rpm.
Needless to say, we had a customer who ran that command because they had read on the Internet that it was the solution to their problem without understanding what that command was going to do. And of course they ruined that server which needed to be fully reinstalled.
Until I notified the vendor to delete that malicious advice from their forum, that answer lasted there for years and who knows how many people ran the same malicious command without trying to understand first the disaster they were going to cause.

load more comments (1 replies)
[-] MigratingtoLemmy@lemmy.world 6 points 1 year ago

I'm starting to see this a lot. Some man-pages are very verbose and one might not have the time, but for the most part, opening a man page and lessing through it doesn't take too long, and it's usually up-to-date

[-] abbadon420@lemm.ee 15 points 1 year ago

They're the best. I mean, just look at the alternative that Windows offers... oh wait there isn't any.

load more comments (3 replies)
load more comments (1 replies)
[-] antithetical@lemmy.deedium.nl 71 points 1 year ago* (last edited 1 year ago)

Man pages are great to have, all documentation easily accessible, mostly complete and directly available in your terminal.

Compare this to the shitshow that is git --help in windows opening a stupid browser. Somebody should be defenestrated for that decission.

[-] JoMomma@lemm.ee 60 points 1 year ago

I'm so fucking sick of every Linux meme being negative... Like are we supporting the community or actively trying to sabotage it?

Fuxk all these memes

Linux makes the word turn

Learn it and support it

This all started as irony, but it has gone too far

Regroup and get creative you sad intelligent fucks

[-] NoIWontPickAName@kbin.earth 17 points 1 year ago

Are your fuzzy socks in the wash?

load more comments (1 replies)
[-] AncientMariner@lemmy.world 4 points 1 year ago

How can you feel good about yourself if you aren't shaming people with less technical capabilities? Next you'll say something crazy like believing in yourself. Nonsense, crazy person. Get out of here.

[-] pHr34kY@lemmy.world 51 points 1 year ago

The internet is full of bad advice.

Man pages are never wrong.

[-] leo85811nardo@lemmy.world 31 points 1 year ago

At least man pages are better than ChatGPT or other generative LLM that can hallucinate

[-] jaromil@fed.dyne.org 28 points 1 year ago

Wrong meme. The dark place is systemd.

[-] gerryflap@feddit.nl 25 points 1 year ago

Man pages save me an online search multiple times per week. Not sure that you're no about

[-] 0x4E4F@sh.itjust.works 8 points 1 year ago

It's a /s meme.

[-] TimeNaan@lemmy.world 25 points 1 year ago

Actually man page good

[-] mikyopii@programming.dev 23 points 1 year ago

Am I the only one using tldr?

[-] coolboole@infosec.pub 8 points 1 year ago

Well today my life just got easier. Thank you for the recommendation!

[-] VinesNFluff@pawb.social 5 points 1 year ago

Tldr is awesome.

[-] woelkchen@lemmy.world 16 points 1 year ago

"tldr pages. Simplified and community-driven man pages. The tldr pages are a community effort to simplify the beloved man pages with practical examples."

https://tldr.sh/

load more comments (1 replies)
[-] zweieuro@lemmy.world 16 points 1 year ago

Anyone who thinks this is just incapable of navigating them.

[-] 0x4E4F@sh.itjust.works 5 points 1 year ago

It's a /s meme, I thought it was obvious.

[-] zweieuro@lemmy.world 8 points 1 year ago

I think you accidently made a meme that is just too close to the truth to be seen as sarcastic

load more comments (1 replies)
[-] TimeSquirrel@kbin.social 4 points 1 year ago

You have to admit though, they are a blast of the 1980s to the face for those who are younger and not used to it. It might be intimidating.

load more comments (1 replies)
[-] jadedwench@lemmy.world 15 points 1 year ago

I get confused every time I install a distro and man isn't installed by default. I guess I get the bare minimum philosophy, but it throws me off every time. First thing I install is vim, man, git, and probably a couple other things I can't remember right now.

I do like a decent man page that has examples for us dummies and I have found that they have improved a lot over the years.

[-] wer2@lemm.ee 12 points 1 year ago

There are distros that don't install man by default? Crazy.

load more comments (1 replies)
load more comments (3 replies)
[-] Franconian_Nomad@feddit.de 10 points 1 year ago

Was this bullshit meme created by AI?

[-] bruhduh@lemmy.world 9 points 1 year ago* (last edited 1 year ago)

man "app" | grep "search keyword"

[-] sik0fewl@lemmy.ca 8 points 1 year ago* (last edited 1 year ago)

Manpages are good reference documentation when you already know which tool to use and how to use it and just need to tweak something. They can often be overwhelming otherwise. Just look at the number of flags on any git command, for example.

[-] AncientMariner@lemmy.world 4 points 1 year ago

You've nailed this here, yet get downvotes. The amount of times I've gone to a man page and my eyes glaze over. Really handy to learn new flags or if you forget, but as an introductory material. They don't work for everyone. People learn in different ways, sometimes by doing and my brain isn't wired this way.

[-] Siegfried@lemmy.world 8 points 1 year ago

Hey, I always check man pages, they are pretty usefull

load more comments (1 replies)
[-] HStone32@lemmy.world 7 points 1 year ago

I don't get what's so wrong with man. If the creator neglected to add a -h option, then there's at least a chance somebody made a man page.

[-] Fenrisulfir@lemmy.ca 7 points 1 year ago

A lot of people in here need tldr before getting comfortable with man it seems

[-] vanderbilt@lemmy.world 6 points 1 year ago* (last edited 1 year ago)
load more comments (1 replies)
[-] MTK@lemmy.world 6 points 1 year ago

RTFM amaright guys?

[-] possiblylinux127@lemmy.zip 6 points 1 year ago

Man pages are fairly useless in my experience, at least compared to the internet. I can see where they had a place at some point though.

[-] urda@lebowski.social 18 points 1 year ago

I’ll never understand someone’s need to “self own” by exposing the fact they either won’t or can’t read.

Man pages are great, you’re just not reading.

load more comments (1 replies)
[-] Sp00kyB00k@lemmy.world 5 points 1 year ago

Reading man pages is a skill of it''s own and the quality of man pages vary. However the ways of figuring out how to do something. 'Command -h' or 'command --help' 'man command' Search online for 'command examples'.

[-] problematicPanther@lemmy.world 5 points 1 year ago* (last edited 1 year ago)
load more comments (1 replies)
[-] tiny_electron@sh.itjust.works 5 points 1 year ago
[-] VinesNFluff@pawb.social 4 points 1 year ago

The only "issue" with man pages is that they open in less and less is a bit too -- Vim-y. So you end up needing to read a manual on how to read manuals?

load more comments (2 replies)
[-] _hovi_@lemmy.world 3 points 1 year ago

Even with that title people still missed the sarcasm, mad

load more comments
view more: next ›
this post was submitted on 17 Apr 2024
422 points (100.0% liked)

linuxmemes

24808 readers
2069 users here now

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.
  • 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, no politics, no trolling or ragebaiting.
  • 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.
  • 6. (NEW!) Regarding public figuresWe all have our opinions, and certain public figures can be divisive. Keep in mind that this is a community for memes and light-hearted fun, not for airing grievances or leveling accusations.
  • Keep discussions polite and free of disparagement.
  • We are never in possession of all of the facts. Defamatory comments will not be tolerated.
  • Discussions that get too heated will be locked and offending comments removed.
  •  

    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.

    founded 2 years ago
    MODERATORS