OT: Best comments in source code ;-)

[David Marso]

I ran into this yesterday and simply couldn't stop laughing at some of them.
---
http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered?page=1&tab=votes#tab-top
---
Possibly my favorite:
//When I wrote this, only God and I understood what I was doing
//Now, God only knows
---
OR:
/* Look not upon this file lest your eyes be burnt from your head. */
---
Careful:  Some of them were clearly written by a frazzled geek suffering from death march PTSD and/or computer induced Tourettes.
---
At times I have been guilty of this but have become much better over the years.
One current project about 1000 lines of very concise/elegant/automagical MATRIX code.
About 500-600 lines of comment and method description (and not a single expletive ;-).
---

[J. R. Carroll]

Good find, David.

Lol'ed pretty hard at a few of them, like:

/** * Always returns true. */ 
public boolean isAvailable() 
{ return false; }

and 

/* * You may think you know what the following code does. 
* But you dont. Trust me. 
* Fiddle with it, and youll spend many a sleepless 
* night cursing the moment you thought youd be clever 
* enough to "optimize" the code below. 
* Now close this file and go play with something else. */

I have a few scripts that read something like that 

*magic hands*

----


J. R. Carroll

Cell:  [phone]

Email: [hidden email]

          [hidden email]

          [hidden email]

On Thu, Dec 6, 2012 at 6:42 AM, David Marso <[hidden email]> wrote:

I ran into this yesterday and simply couldn't stop laughing at some of them.
---
http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered?page=1&tab=votes#tab-top
---
Possibly my favorite:
//When I wrote this, only God and I understood what I was doing
//Now, God only knows
---
OR:
/* Look not upon this file lest your eyes be burnt from your head. */
---
Careful:  Some of them were clearly written by a frazzled geek suffering
from death march PTSD and/or computer induced Tourettes.
---
At times I have been guilty of this but have become much better over the
years.
One current project about 1000 lines of very concise/elegant/automagical
MATRIX code.
About 500-600 lines of comment and method description (and not a single
expletive ;-).
---




-----
Please reply to the list and not to my personal email.
Those desiring my consulting or training services please feel free to email me.
--
View this message in context: http://spssx-discussion.1045642.n5.nabble.com/OT-Best-comments-in-source-code-tp5716711.html
Sent from the SPSSX Discussion mailing list archive at Nabble.com.

=====================
To manage your subscription to SPSSX-L, send a message to
[hidden email] (not to SPSSX-L), with no body text except the
command. To leave the list, send the command
SIGNOFF SPSSX-L
For a list of commands to manage subscriptions, send the command
INFO REFCARD

[Richard Ristow]

Not a comment in source code, but I'm moved to share a maxim of my own:

"Thou shalt not seek for bugs in thy programs, nor yet for errors in
thy data; for if thou dost, lo, though shalt surely find them."

=====================
To manage your subscription to SPSSX-L, send a message to
[hidden email] (not to SPSSX-L), with no body text except the
command. To leave the list, send the command
SIGNOFF SPSSX-L
For a list of commands to manage subscriptions, send the command
INFO REFCARD

[David Marso]

How about this juicy nugget ;-)
//if (!response) // we're going to crash
            //if (!items) // we're going to crash
            //TODO: Don't crash
-----------------------------
Or

/* Legacy jism from the last batch of flying monkeys */
--

J. R. Carroll wrote

Good find, David.

Lol'ed pretty hard at a few of them, like:


/** * Always returns true. */
> public boolean isAvailable()
> { return false; }


and

/* * You may think you know what the following code does.
> * But you dont. Trust me.
> * Fiddle with it, and youll spend many a sleepless
> * night cursing the moment you thought youd be clever
> * enough to "optimize" the code below.
> * Now close this file and go play with something else. */


I have a few scripts that read something like that

*magic hands*

----


J. R. Carroll
Cell:  [phone]
Email: [hidden email]
          [hidden email]
          [hidden email]





On Thu, Dec 6, 2012 at 6:42 AM, David Marso <[hidden email]> wrote:

> I ran into this yesterday and simply couldn't stop laughing at some of
> them.
> ---
>
> http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered?page=1&tab=votes#tab-top
> ---
> Possibly my favorite:
> //When I wrote this, only God and I understood what I was doing
> //Now, God only knows
> ---
> OR:
> /* Look not upon this file lest your eyes be burnt from your head. */
> ---
> Careful:  Some of them were clearly written by a frazzled geek suffering
> from death march PTSD and/or computer induced Tourettes.
> ---
> At times I have been guilty of this but have become much better over the
> years.
> One current project about 1000 lines of very concise/elegant/automagical
> MATRIX code.
> About 500-600 lines of comment and method description (and not a single
> expletive ;-).
> ---
>
>
>
>
> -----
> Please reply to the list and not to my personal email.
> Those desiring my consulting or training services please feel free to
> email me.
> --
> View this message in context:
> http://spssx-discussion.1045642.n5.nabble.com/OT-Best-comments-in-source-code-tp5716711.html
> Sent from the SPSSX Discussion mailing list archive at Nabble.com.
>
> =====================
> To manage your subscription to SPSSX-L, send a message to
> [hidden email] (not to SPSSX-L), with no body text except the
> command. To leave the list, send the command
> SIGNOFF SPSSX-L
> For a list of commands to manage subscriptions, send the command
> INFO REFCARD
>

J. R. Carroll wrote

Good find, David.

Lol'ed pretty hard at a few of them, like:


/** * Always returns true. */
> public boolean isAvailable()
> { return false; }


and

/* * You may think you know what the following code does.
> * But you dont. Trust me.
> * Fiddle with it, and youll spend many a sleepless
> * night cursing the moment you thought youd be clever
> * enough to "optimize" the code below.
> * Now close this file and go play with something else. */


I have a few scripts that read something like that

*magic hands*

----


J. R. Carroll
Cell:  [phone]
Email: [hidden email]
          [hidden email]
          [hidden email]





On Thu, Dec 6, 2012 at 6:42 AM, David Marso <[hidden email]> wrote:

> I ran into this yesterday and simply couldn't stop laughing at some of
> them.
> ---
>
> http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered?page=1&tab=votes#tab-top
> ---
> Possibly my favorite:
> //When I wrote this, only God and I understood what I was doing
> //Now, God only knows
> ---
> OR:
> /* Look not upon this file lest your eyes be burnt from your head. */
> ---
> Careful:  Some of them were clearly written by a frazzled geek suffering
> from death march PTSD and/or computer induced Tourettes.
> ---
> At times I have been guilty of this but have become much better over the
> years.
> One current project about 1000 lines of very concise/elegant/automagical
> MATRIX code.
> About 500-600 lines of comment and method description (and not a single
> expletive ;-).
> ---
>
>
>
>
> -----
> Please reply to the list and not to my personal email.
> Those desiring my consulting or training services please feel free to
> email me.
> --
> View this message in context:
> http://spssx-discussion.1045642.n5.nabble.com/OT-Best-comments-in-source-code-tp5716711.html
> Sent from the SPSSX Discussion mailing list archive at Nabble.com.
>
> =====================
> To manage your subscription to SPSSX-L, send a message to
> [hidden email] (not to SPSSX-L), with no body text except the
> command. To leave the list, send the command
> SIGNOFF SPSSX-L
> For a list of commands to manage subscriptions, send the command
> INFO REFCARD
>