this post was submitted on 12 Oct 2023
1255 points (98.6% liked)

linuxmemes

24236 readers
1673 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
     
    top 50 comments
    sorted by: hot top controversial new old
    [–] [email protected] 138 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.

    [–] [email protected] 106 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] 31 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)
    [–] [email protected] 12 points 1 year ago

    At what point is documenting decompiled code easier?

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

    WHAT DID YOU DO?!

    [–] [email protected] 41 points 1 year ago
    $ mysterytool -vv
    DEBUG: Complete.
    $
    
    [–] [email protected] 32 points 1 year ago

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

    [–] [email protected] 100 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

    [–] [email protected] 50 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.

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

    Even on simple scripts, it's so help to remind yourself however the hell you made it work.

    load more comments (1 replies)
    [–] [email protected] 42 points 1 year ago* (last edited 1 year ago) (1 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.

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

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

    [–] [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] 10 points 1 year ago (1 children)

    Easy: people who still use Discord have brain rot

    load more comments (1 replies)
    load more comments (2 replies)
    [–] [email protected] 82 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

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

    Did they at least provide woman pages then?

    /s

    [–] [email protected] 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)
    [–] [email protected] 62 points 1 year ago* (last edited 1 year ago) (1 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/

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

    Correct, I shamelessly stole it!

    Also, sorry, I stole it.

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

    But also

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

    ok then...

    mysterytool -h
    mysterytool: unrecognized option: 'h'

    [–] [email protected] 38 points 1 year ago* (last edited 1 year ago)
    mysterytool --help
    
       β€˜--help’ unrecognized option, -h for help
    
    

    I will burn this motherfucker to the ground

    [–] [email protected] 25 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)
    [–] [email protected] 40 points 1 year ago (5 children)

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

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

    "tHe PrOgRaM iS sElF dOcUmEnTiNg"

    load more comments (3 replies)
    load more comments (4 replies)
    [–] [email protected] 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)
    [–] [email protected] 31 points 1 year ago (2 children)
    [–] [email protected] 12 points 1 year ago (1 children)
    load more comments (1 replies)
    load more comments (1 replies)
    [–] [email protected] 31 points 1 year ago

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

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

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

    [–] [email protected] 24 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!

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

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

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

    I'd try mysterytool -H

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

    Quite the mystery!

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

    What's worse is when the tool doesn't error out for providing bad flags. And it always seems like those same tools always use nonstandard flags.

    load more comments
    view more: next β€Ί