β² 1268 βΌ And no man page (feddit.de) submitted 2 years ago by crispy_kilt@feddit.de to c/linuxmemes@lemmy.world 114 comments fedilink hide all child comments
[β] Rooty@lemmy.world 42 points 2 years ago (3 children) If the program's author hasn't bothered to properly document its function, then it has no business being on my machine. permalink fedilink source hideshow 6 child comments replies: [β] AnIntenseMoist@lemmy.world 30 points 2 years ago (2 children) "tHe PrOgRaM iS sElF dOcUmEnTiNg" permalink fedilink source parent hideshow 4 child comments replies: [β] taladar@sh.itjust.works 3 points 2 years ago That claim doesn't even work for the 0 line shell script that used to be /bin/true (which is why it is no longer a 0 line shell script), much less any more complicated program. permalink fedilink source parent [β] sheogorath@lemmy.world 0 points 2 years ago (1 child) Fuck those people, people who says that usually doesn't even understand half the time. When I ask people like that when they write a functionality a certain way during code review usually they'll just quote someone on Twitter or some blogspam article saying A is shit, B is the best way to do things. permalink fedilink source parent hideshow 2 child comments replies: [β] AnIntenseMoist@lemmy.world 0 points 2 years ago you forget StackOverflow. I saw my coworker once copy-and-paste code... from the question.... and not understand why it wasn't working.... I'm all for using StackOverflow to get help with weird problems but, most of the time, simply reading the docs and applying that knowledge to the problem you are trying to solve is enough. a forgotten art for sure..... permalink fedilink source parent [β] Kolanaki@yiffit.net 6 points 2 years ago (1 child) I'd pretend to be Joey from Hackers and just throw commands at it to see what happens. Maybe I'll make an ATM in bumfuck, Egypt spit out hundreds of dollars or find a worm in a garbage file π€·π»ββοΈ permalink fedilink source parent hideshow 2 child comments replies: [β] PainInTheAES@lemmy.world 3 points 2 years ago Hack the planet! permalink fedilink source parent [β] topinambour_rex@lemmy.world -3 points 2 years ago (3 children) If it is open source, you can read the source... permalink fedilink source parent hideshow 6 child comments replies: [β] Darkhoof@lemmy.world 12 points 2 years ago Or he can waste less time and download a properly documented open source tool. permalink fedilink source parent [β] Draconic_NEO@lemmy.world 4 points 2 years ago* (last edited 2 years ago) Only if the source is structured and has readable names. Spaghetti code with made up variable names that only the programmer knows the meaning of (or may not even remember what they mean at all) isn't that much better than combing through the disassembled machine code. permalink fedilink source parent [β] Treczoks@lemmy.world 2 points 2 years ago Which is fine for a.small and simple tool. But I have seen massive graphic/UI libraries with a documentation of about two pages and a non-working example. Worst offenders I have to deal with is mediawiki. Some random hacker replaces some code with his own, and immeditely obsoletes the previous code that worked absolutely fine. The new code might work, too, but the concept, the philosophy is 100% different that the old interface. So e.g. the old interface made a call with 10 or 20 parameters, the new one makes a ton of calls of the type "add one or two parameters to an object". And of course the only documentation is just the excrement of a Doxygen call. Where nobody ever cared for the function description headers in the source. My "favourite" one is a function with a parameter named "options" and a description as "option flags". Nothing more. And the source of the function? Well, I have seen staighter spaghetti dinners. permalink fedilink source parent
[β] AnIntenseMoist@lemmy.world 30 points 2 years ago (2 children) "tHe PrOgRaM iS sElF dOcUmEnTiNg" permalink fedilink source parent hideshow 4 child comments replies: [β] taladar@sh.itjust.works 3 points 2 years ago That claim doesn't even work for the 0 line shell script that used to be /bin/true (which is why it is no longer a 0 line shell script), much less any more complicated program. permalink fedilink source parent [β] sheogorath@lemmy.world 0 points 2 years ago (1 child) Fuck those people, people who says that usually doesn't even understand half the time. When I ask people like that when they write a functionality a certain way during code review usually they'll just quote someone on Twitter or some blogspam article saying A is shit, B is the best way to do things. permalink fedilink source parent hideshow 2 child comments replies: [β] AnIntenseMoist@lemmy.world 0 points 2 years ago you forget StackOverflow. I saw my coworker once copy-and-paste code... from the question.... and not understand why it wasn't working.... I'm all for using StackOverflow to get help with weird problems but, most of the time, simply reading the docs and applying that knowledge to the problem you are trying to solve is enough. a forgotten art for sure..... permalink fedilink source parent
[β] taladar@sh.itjust.works 3 points 2 years ago That claim doesn't even work for the 0 line shell script that used to be /bin/true (which is why it is no longer a 0 line shell script), much less any more complicated program. permalink fedilink source parent
[β] sheogorath@lemmy.world 0 points 2 years ago (1 child) Fuck those people, people who says that usually doesn't even understand half the time. When I ask people like that when they write a functionality a certain way during code review usually they'll just quote someone on Twitter or some blogspam article saying A is shit, B is the best way to do things. permalink fedilink source parent hideshow 2 child comments replies: [β] AnIntenseMoist@lemmy.world 0 points 2 years ago you forget StackOverflow. I saw my coworker once copy-and-paste code... from the question.... and not understand why it wasn't working.... I'm all for using StackOverflow to get help with weird problems but, most of the time, simply reading the docs and applying that knowledge to the problem you are trying to solve is enough. a forgotten art for sure..... permalink fedilink source parent
[β] AnIntenseMoist@lemmy.world 0 points 2 years ago you forget StackOverflow. I saw my coworker once copy-and-paste code... from the question.... and not understand why it wasn't working.... I'm all for using StackOverflow to get help with weird problems but, most of the time, simply reading the docs and applying that knowledge to the problem you are trying to solve is enough. a forgotten art for sure..... permalink fedilink source parent
[β] Kolanaki@yiffit.net 6 points 2 years ago (1 child) I'd pretend to be Joey from Hackers and just throw commands at it to see what happens. Maybe I'll make an ATM in bumfuck, Egypt spit out hundreds of dollars or find a worm in a garbage file π€·π»ββοΈ permalink fedilink source parent hideshow 2 child comments replies: [β] PainInTheAES@lemmy.world 3 points 2 years ago Hack the planet! permalink fedilink source parent
[β] PainInTheAES@lemmy.world 3 points 2 years ago Hack the planet! permalink fedilink source parent
[β] topinambour_rex@lemmy.world -3 points 2 years ago (3 children) If it is open source, you can read the source... permalink fedilink source parent hideshow 6 child comments replies: [β] Darkhoof@lemmy.world 12 points 2 years ago Or he can waste less time and download a properly documented open source tool. permalink fedilink source parent [β] Draconic_NEO@lemmy.world 4 points 2 years ago* (last edited 2 years ago) Only if the source is structured and has readable names. Spaghetti code with made up variable names that only the programmer knows the meaning of (or may not even remember what they mean at all) isn't that much better than combing through the disassembled machine code. permalink fedilink source parent [β] Treczoks@lemmy.world 2 points 2 years ago Which is fine for a.small and simple tool. But I have seen massive graphic/UI libraries with a documentation of about two pages and a non-working example. Worst offenders I have to deal with is mediawiki. Some random hacker replaces some code with his own, and immeditely obsoletes the previous code that worked absolutely fine. The new code might work, too, but the concept, the philosophy is 100% different that the old interface. So e.g. the old interface made a call with 10 or 20 parameters, the new one makes a ton of calls of the type "add one or two parameters to an object". And of course the only documentation is just the excrement of a Doxygen call. Where nobody ever cared for the function description headers in the source. My "favourite" one is a function with a parameter named "options" and a description as "option flags". Nothing more. And the source of the function? Well, I have seen staighter spaghetti dinners. permalink fedilink source parent
[β] Darkhoof@lemmy.world 12 points 2 years ago Or he can waste less time and download a properly documented open source tool. permalink fedilink source parent
[β] Draconic_NEO@lemmy.world 4 points 2 years ago* (last edited 2 years ago) Only if the source is structured and has readable names. Spaghetti code with made up variable names that only the programmer knows the meaning of (or may not even remember what they mean at all) isn't that much better than combing through the disassembled machine code. permalink fedilink source parent
[β] Treczoks@lemmy.world 2 points 2 years ago Which is fine for a.small and simple tool. But I have seen massive graphic/UI libraries with a documentation of about two pages and a non-working example. Worst offenders I have to deal with is mediawiki. Some random hacker replaces some code with his own, and immeditely obsoletes the previous code that worked absolutely fine. The new code might work, too, but the concept, the philosophy is 100% different that the old interface. So e.g. the old interface made a call with 10 or 20 parameters, the new one makes a ton of calls of the type "add one or two parameters to an object". And of course the only documentation is just the excrement of a Doxygen call. Where nobody ever cared for the function description headers in the source. My "favourite" one is a function with a parameter named "options" and a description as "option flags". Nothing more. And the source of the function? Well, I have seen staighter spaghetti dinners. permalink fedilink source parent
