Without the comment, one might have thought that was the end of the package spec - the comment saves all the work of scrolling up to see what one is looking at :)
/* I think you are missing the point * because you think that anything * less than commenting everything * that could be commented upon is * simply not going to cut on my * development team. */
Without the comment, one might have thought that was the end of the package spec - the comment saves all the work of scrolling up to see what one is looking at :)
ReplyDeleteHere's one I saw not that long ago.
ReplyDelete--get wonum, changedate, description --from workorder
cursor getWorkorder is
select wonum, changedate, description from workorder
-- BEGIN comment
ReplyDelete/* I think you are missing the point
* because you think that anything
* less than commenting everything
* that could be commented upon is
* simply not going to cut on my
* development team.
*/
-- END comment
Could be worse...
ReplyDeleteyou could have comments like
/*do some stuff*/
Comment WTFs are fun. I used to leave comments like this in my own code:
ReplyDelete# Someone is going to hate me for this later.
# That someone is likely to be me.
I think TOAD or something generates those stupid little comments...
ReplyDelete