Is this over-commenting / a sign that I didn't sleep well enough last night? I just wrote, in a C program:

    int     i;                     /* Ye olde generick loope counter (you  */
                                   /* do know that the 'Y' in "ye olde" is */  
                                   /* really supposed to be a _thorn_, so  */
                                   /* it's still pronounced "the old" not  */
                                   /* "yee old" right?  Well you do now.   */
                                   /* Not sure what most C compilers would */
                                   /* do with a non-ASCII character in a   */
                                   /* comment though.  But I digress ...)  */

I do seem to comment more extensively after trying to read almost anybody else's code, where I'm lucky to find comments describing a function's purpose, much less any explanation of its arguments or useful clues as to where I need to poke at it to add a feature. And I've been reading other people's code lately.

Obviously, this is code I'm planning to send to a bunch of other people ... (But while I'm posting -- do other compilers supply the __FILE__ and __DATE__ pre-defined macros, or is that just a gcc thing? I don't know what Windows users will compile this with.)