- Feature Articles
- CodeSOD
- Error'd
-
Forums
-
Other Articles
- Random Article
- Other Series
- Alex's Soapbox
- Announcements
- Best of…
- Best of Email
- Best of the Sidebar
- Bring Your Own Code
- Coded Smorgasbord
- Mandatory Fun Day
- Off Topic
- Representative Line
- News Roundup
- Editor's Soapbox
- Software on the Rocks
- Souvenir Potpourri
- Sponsor Post
- Tales from the Interview
- The Daily WTF: Live
- Virtudyne
Admin
This article needs to be commented, or deleted.
Admin
Wasn’t there a famous one "You are not meant to understand this"?
Admin
Along with the official documentation that said: "Nobody wants to say how this works. Maybe nobody knows."
Admin
My favorite comment was 'Store AX register'. What made it special was that the code was 68000 assembler which does not have an AX register.
Admin
One of my professors told us about some code he worked with that only had one comment in it: "Turn the bugger on". He had no idea what the bugger was or what was happening that would be turning it on.
Admin
To be commented or deleted. That is the ?.
Admin
I seem to recall the comment was "You are not expected to understand this" and was from the bowels of the original UNIX kernel...
Admin
Our company has a policy that all methods must be documented. Fortunately, the documentation is not code-reviewed; and fortunately GhostDoc can auto-generate the comments; so there are many methods documented like this:
///
Admin
Yeah, I once saw for a 286 assembly listing a comment about "accessing the zero page". Ah, that throw me back to those C64 times. Then again, the comment made not sense at all, however there were a ton of those in the listing, so I guess there was some mandated comment quote and the dev got bored and just wrote nonsense.
Admin
Years ago on a hobby project, I ran into something like "You don't want to know" and had to figure it out anyway. (It was a Forth variant, turns out the function just expected eight items on the stack in the right order. Far from the worst code I've ever personally run into.)
Admin
I'll just remind the regulars here of the one I found once:
And, of course, it took me about ten minutes to work out why not, just by following the code around.
Admin
I like this one (from https://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered/482129#482129):
Admin
Sometimes I leave comments along the lines of "I probably screwed up type conversion, but it works".
Admin
Not to mention all the ones along the lines of 'temporary hack. remove ASAP'.
Admin
In .net ´´´// HACK´´´ is actually something that shows up in the TODO list of Visual Studio - with obviously ´´´// TODO´´´. So at least there's some tooling support for those exact keywords for the last two decades.
Admin
I saw this in assembler code from the 80's, right after a tricky part: "Neat, eh!"
Admin
That third one could well be mine, I've certainly left a similar one before. In my defense, the company was so toxic that there wasn't the opportunity to do things right. My recommendation to Samir is to get out ASAP.
Admin
That third one could well be mine, I've certainly left a similar one before. In my defense, the company was so toxic that there wasn't the opportunity to do things right. My recommendation to Samir is to get out ASAP.
Admin
I love how code formatting gone wild in the second example makes it sound like the gym teacher from Beavis and Butthead. (Or Dave Spokesperson, for people under 40?)
Admin
Probably ported from something that was written in 6502