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

linuxmemes

21222 readers
79 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!

    founded 1 year ago
    MODERATORS
     
    top 50 comments
    sorted by: hot top controversial new old
    [–] oleorun@real.lemmy.fan 140 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@lemmy.world 108 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

    [–] oleorun@real.lemmy.fan 31 points 1 year ago (2 children)
    [–] corsicanguppy@lemmy.ca 11 points 1 year ago

    As demonstrated by the variable naming and documentation.

    load more comments (1 replies)
    [–] spacesweedkid27@lemmy.world 12 points 1 year ago

    At what point is documenting decompiled code easier?

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

    WHAT DID YOU DO?!

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

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

    [–] clearleaf@lemmy.world 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

    [–] RoyaltyInTraining@lemmy.world 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.

    [–] kurwa@lemmy.world 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)
    [–] Rooty@lemmy.world 42 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.

    load more comments (2 replies)
    [–] MonsiuerPatEBrown@reddthat.com 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)
    [–] pimento64@sopuli.xyz 11 points 1 year ago (1 children)

    Easy: people who still use Discord have brain rot

    load more comments (1 replies)
    [–] peopleproblems@lemmy.world 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)
    [–] Navigate@partizle.com 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@lemmy.world 25 points 1 year ago

    Did they at least provide woman pages then?

    /s

    [–] Giftzwerg02@lemmy.world 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@lemmy.world 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)
    [–] qupada@kbin.social 49 points 1 year ago (2 children)

    But also

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

    ok then...

    mysterytool -h
    mysterytool: unrecognized option: 'h'

    [–] NegativeLookBehind@kbin.social 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

    [–] Melody@lemmy.one 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)
    [–] corsicanguppy@lemmy.ca 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@lemmy.world 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@lemmy.world 30 points 1 year ago (3 children)

    "tHe PrOgRaM iS sElF dOcUmEnTiNg"

    load more comments (3 replies)
    load more comments (6 replies)
    [–] Aceticon@lemmy.world 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.

    [–] isVeryLoud@lemmy.ca 22 points 1 year ago (1 children)

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

    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)
    [–] AnUnusualRelic@lemmy.world 32 points 1 year ago

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

    [–] SpaceNoodle@lemmy.world 32 points 1 year ago (2 children)
    [–] lemming741@lemmy.world 12 points 1 year ago (1 children)
    load more comments (1 replies)
    load more comments (1 replies)
    [–] anarchy79@lemmy.world 27 points 1 year ago

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

    [–] kshade@lemmy.world 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@lemmy.world 22 points 1 year ago

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

    [–] Inductor@feddit.de 14 points 1 year ago (1 children)
    [–] BeardedGingerWonder@feddit.uk 35 points 1 year ago (6 children)

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

    load more comments (6 replies)
    [–] TunaCowboy@lemmy.world 10 points 1 year ago
    [–] captainWhatsHisName@lemm.ee 10 points 1 year ago (3 children)
    find / -name mysterytool -exec rm {} \;
    [–] jbk@discuss.tchncs.de 21 points 1 year ago (1 children)
    load more comments (1 replies)
    load more comments (2 replies)
    [–] _dev_null@lemmy.zxcvn.xyz 9 points 1 year ago

    python -V

    What the actual fuck

    [–] Honytawk@lemmy.zip 9 points 1 year ago

    Quite the mystery!

    load more comments
    view more: next ›