top 50 comments

sorted by: hot top controversial new old
[–] 90 points 2 years ago (3 children)

what's wrong with man pages?

  • source
  • hideshow 6 child comments
  • [–] 75 points 2 years ago (2 children)

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

  • source
  • parent
  • hideshow 4 child comments
  • [–] 37 points 2 years ago (3 children)

    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.

  • source
  • parent
  • hideshow 6 child comments
  • [–] 19 points 2 years ago* (1 child)

    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...

  • source
  • parent
  • hideshow 2 child comments
  • [–] 10 points 2 years 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.

  • source
  • parent
  • [–] 14 points 2 years ago (1 child)

    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?

  • source
  • parent
  • hideshow 2 child comments
  • [–] 6 points 2 years ago (2 children)

    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.

  • source
  • parent
  • hideshow 2 child comments
  • load more comments (2 replies)
  • [–] 4 points 2 years ago*

    Some man pages are just gigantic lists of unintuitive parameters in alphabetical order with no usage examples and even if you know how to search for text in a man page (forward slash then the text you want to search for) you're just stabbing in the dark.

    Others are excellent.

    The problem with man pages is that you never know if you're getting the former or the latter.

  • source
  • parent
  • [–] 72 points 2 years ago* (last edited 2 years ago) (1 child)

    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.

  • source
  • hideshow 2 child comments
  • [–] 57 points 2 years ago (2 children)

    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

  • source
  • hideshow 4 child comments
  • [–] 52 points 2 years ago

    The internet is full of bad advice.

    Man pages are never wrong.

  • source
  • [–] 31 points 2 years ago (1 child)

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

  • source
  • hideshow 1 child comment
  • load more comments (1 reply)
    [–] 26 points 2 years ago (1 child)

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

  • source
  • hideshow 2 child comments
  • [–] 26 points 2 years ago

    Actually man page good

  • source
  • [–] 23 points 2 years ago (2 children)

    Am I the only one using tldr?

  • source
  • hideshow 4 child comments
  • [–] 19 points 2 years ago

    Wrong meme. The dark place is systemd.

  • source
  • [–] 17 points 2 years ago (2 children)

    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.

  • source
  • hideshow 4 child comments
  • [–] 16 points 2 years ago (1 child)

    "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/

  • source
  • hideshow 2 child comments
  • [–] 15 points 2 years ago (5 children)

    Anyone who thinks this is just incapable of navigating them.

  • source
  • hideshow 6 child comments
  • load more comments (4 replies)
    [–] 10 points 2 years ago

    Was this bullshit meme created by AI?

  • source
  • [–] 9 points 2 years ago (1 child)

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

  • source
  • hideshow 1 child comment
  • load more comments (1 reply)
    [–] 9 points 2 years ago*

    man "app" | grep "search keyword"

  • source
  • [–] 7 points 2 years ago

    If you're electing to use linux, you got time to burn. Spend a little time getting comfy with manpages. Little things like that really add up to being effective.

  • source
  • [–] 7 points 2 years ago

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

  • source
  • [–] 7 points 2 years ago

    RTFM amaright guys?

  • source
  • [–] 7 points 2 years 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.

  • source
  • [–] 6 points 2 years 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'.

  • source
  • [–] 6 points 2 years ago* (1 child)
    load more comments (1 reply)
    [–] 5 points 2 years ago* (1 child)
    load more comments (1 reply)
    [–] 4 points 2 years ago* (last edited 2 years ago) (1 child)

    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.

  • source
  • hideshow 1 child comment
  • load more comments (1 reply)
    load more comments
    view more: next β€Ί