On Wed, 2010-01-20 at 10:54 -0700, Alex Esplin wrote: > Macros are useful, but don't always play nice with gdb (if you end up > needing to debug). Sub-routines and comments are difficult to > over-use.
Comments are easy to overuse. They're distracting and waste space, making it harder to grok the code. They become outdated unless maintained, doubling maintenance overhead. They can become crutches, compensating for poorly written code instead of fixing it. Comments are like salt. Helpful in moderation. Harmful in excess. -- "XML is like violence: if it doesn't solve your problem, you aren't using enough of it." - Chris Maden -------------------- BYU Unix Users Group http://uug.byu.edu/ The opinions expressed in this message are the responsibility of their author. They are not endorsed by BYU, the BYU CS Department or BYU-UUG. ___________________________________________________________________ List Info (unsubscribe here): http://uug.byu.edu/mailman/listinfo/uug-list
