Re: st: -stylerules- updated on SSC

[Richard Williams <Richard.A.Williams.5@nd.edu>]

At 04:07 PM 4/13/2005 +0100, Nick Cox wrote:
> The package -stylerules- on SSC has been
> updated. I started by making a few changes
> in the light of Stata 9, but mostly thought
> of some other things to mention while
> I was doing that.
"Well-written programs don't need many comments. (Comment: We could 
certainly argue about that!)"

Yes, I might be one of those who quibbles a bit!  One thing I find 
confusing is when there are lots of programs in an ado file.  Going through 
them in isolation can be pretty confusing.  Comments like "This routine 
does...This routine is called by..." can help a lot.  In any event, 
comments don't slow the program down.  I might say  "Well-written programs 
don't need many comments (but go ahead and write them anyway)."

*
*   For searches and help try:
*   http://www.stata.com/support/faqs/res/findit.html
*   http://www.stata.com/support/statalist/faq
*   http://www.ats.ucla.edu/stat/stata/