this post was submitted on 12 Oct 2023
1268 points (98.5% liked)

linuxmemes

21435 readers
1237 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 members of the community for any reason.
  • 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, and wants to interject for a moment. You can stop now.
  •  

    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 fork-bomb your computer.

    founded 1 year ago
    MODERATORS
     
    top 50 comments
    sorted by: hot top controversial new old
    [–] [email protected] 141 points 1 year ago (4 children)

    Reminds me of a comment I once came across in a work application's code: "This function took forever to write correctly. It was hard work. I didn't document it. Figure it out."

    Of course the variables were not defined properly and were named esoterically.

    [–] BleatingZombie 109 points 1 year ago (1 children)

    the variables were not defined properly and were named esoterically

    I wonder why it was so hard and took so long to write

    [–] [email protected] 32 points 1 year ago (2 children)
    [–] [email protected] 11 points 1 year ago

    As demonstrated by the variable naming and documentation.

    load more comments (1 replies)
    [–] spacesweedkid27 12 points 1 year ago

    At what point is documenting decompiled code easier?

    load more comments (1 replies)
    [–] Perroboc 136 points 1 year ago (2 children)
    $ mysterytool
    $
    

    WHAT DID YOU DO?!

    [–] hperrin 41 points 1 year ago
    $ mysterytool -vv
    DEBUG: Complete.
    $
    
    [–] RoyaltyInTraining 34 points 1 year ago

    Knowing my luck, It probably deleted a rarely used system library and will lead to unpredictable crashes.

    [–] clearleaf 101 points 1 year ago* (last edited 1 year ago) (7 children)

    I don't understand how devs can be too lazy to write documentation but somehow they'd rather explain the same shit in discord over and over and over and over and over and over

    [–] RoyaltyInTraining 51 points 1 year ago (2 children)

    The help command is one of the first things I work on in any project. Even if I'm never gonna share it, my future self will appreciate it.

    load more comments (2 replies)
    [–] Rooty 43 points 1 year ago* (last edited 1 year ago) (2 children)

    Why is discord so popular in non-gaming circles? People use it as a shitty, bloated and centralized IRC clone, with the voice fuction being completely ignored.

    [–] dym_sh 9 points 1 year ago

    bc everyone is a gamer, and using another chatting app is just adding more clutter

    load more comments (1 replies)
    [–] [email protected] 11 points 1 year ago* (last edited 1 year ago) (1 children)

    i write poorly documented code on my solo projects because i am lonely

    load more comments (1 replies)
    [–] [email protected] 11 points 1 year ago (1 children)

    Easy: people who still use Discord have brain rot

    load more comments (1 replies)
    [–] peopleproblems 9 points 1 year ago

    I think it's loneliness, honestly.

    That and corporate work environment tends to rewards those that can explain stuff vocally ad nauseum.

    load more comments (2 replies)
    [–] [email protected] 83 points 1 year ago* (last edited 1 year ago) (12 children)

    I was recently trying trying to get help on a clipboard program someone had recommended me, clipq. What I found instead was a GitHub discussion where the dev said "I'm not sure what you mean by 'man' pages" in response to someone asking for them. I think I need to find an alternative

    [–] kamen 25 points 1 year ago

    Did they at least provide woman pages then?

    /s

    [–] Giftzwerg02 10 points 1 year ago (1 children)

    I've only known about (and always use) xclip.

    load more comments (1 replies)
    load more comments (10 replies)
    [–] Xophmeister 64 points 1 year ago* (last edited 1 year ago) (2 children)

    Haha, I made this :) Here’s the blog post I created it for, if you want a bit of context:

    https://www.tweag.io/blog/2023-10-05-cli-ux-in-topiary/

    load more comments (2 replies)
    [–] [email protected] 49 points 1 year ago (2 children)

    But also

    mysterytool --help
    mysterytool: unrecognized option: '-'

    ok then...

    mysterytool -h
    mysterytool: unrecognized option: 'h'

    [–] [email protected] 40 points 1 year ago* (last edited 1 year ago) (1 children)
    mysterytool --help
    
       ‘--help’ unrecognized option, -h for help
    
    

    I will burn this motherfucker to the ground

    [–] [email protected] 15 points 1 year ago* (last edited 1 year ago) (3 children)

    Or the opposite:

    mysterytool -h
    
         -h unrecognized option, --help for help
    

    Both need to burn.

    load more comments (3 replies)
    [–] [email protected] 26 points 1 year ago* (last edited 1 year ago) (5 children)

    And

    mysterytool -h

    mysterytool: try our info page that requires a custom viewer because gnu is better than standards. And there is no regular man page because fuck you

    load more comments (5 replies)
    [–] Rooty 42 points 1 year ago (7 children)

    If the program's author hasn't bothered to properly document its function, then it has no business being on my machine.

    [–] AnIntenseMoist 30 points 1 year ago (3 children)

    "tHe PrOgRaM iS sElF dOcUmEnTiNg"

    load more comments (3 replies)
    load more comments (6 replies)
    [–] SpaceNoodle 32 points 1 year ago (2 children)
    [–] lemming741 12 points 1 year ago (1 children)
    load more comments (1 replies)
    load more comments (1 replies)
    [–] AnUnusualRelic 32 points 1 year ago

    It's like people don't like surprises anymore.

    [–] Aceticon 32 points 1 year ago* (last edited 1 year ago) (10 children)

    Programmers generally detest to do documentation, so when the user help "UI" is all down to a programmer to define this is often what you get, especially if it's a small tool.

    [–] [email protected] 22 points 1 year ago (1 children)

    I never understood that. I'm a programmer and I tend to over-document.

    [–] [email protected] 16 points 1 year ago

    Yeah this is shitty, and if you're a programmer reading this and you agree with it, be better. There is no excuse for under-documenting a CLI.

    Even when I'm developing, I write out my usage text first, like -o [json,csv,pretty] specify output format (default 'pretty') [NOT IMPLEMENTED] or the like.

    load more comments (8 replies)
    [–] anarchy79 27 points 1 year ago

    Exclusively installed through some dodgy PPA you got from a blog.

    [–] kshade 25 points 1 year ago* (last edited 1 year ago)

    strings `which mysterytool` | less

    Give up your darn secrets before I start fumbling around with strace and get even more frustrated!

    [–] TheHighRoad 22 points 1 year ago

    I just want to say this is a masterful use of the format.

    [–] [email protected] 14 points 1 year ago (1 children)
    [–] [email protected] 35 points 1 year ago (6 children)

    -H for Hard drive to delete, -h is help

    load more comments (6 replies)
    [–] [email protected] 10 points 1 year ago (3 children)
    find / -name mysterytool -exec rm {} \;
    [–] [email protected] 21 points 1 year ago (1 children)
    load more comments (1 replies)
    load more comments (2 replies)
    [–] TunaCowboy 10 points 1 year ago
    [–] [email protected] 9 points 1 year ago

    Quite the mystery!

    load more comments
    view more: next ›