Medium to Large Scale Python Deployments

Steve Holden sholden at holdenweb.com
Thu Jun 13 05:27:44 CEST 2002


"Peter Hansen" <peter at engcorp.com> wrote in message
news:3D0140BF.A239E39E at engcorp.com...
> Bengt Richter wrote:
> >
> > Is the "comments" number a count of _pure_ comment lines,
> > # (like this one) ?
>
> I believe so.  I haven't examined the pycount code yet.
>
> > I think it would be interesting to analyze comments further,
> > to see what the relative comment byte count is overall,
> > and for lines with both code and comments,
> > """like this line:""" # (this has code and comment).
>
> I consider it a mild stylistic no-no to use line-ending
> comments, personally.  I believe it's almost always better
> to put a block-comment of one or more lines above a block
> of code with related purpose.  A good comment there tends to
> be more maintainable, and useful, than lots of little comments
> on each line.
>
I wouldn't necessarily disagree, but I used (when programming (gulp) Basic
Plus) to make the line-end comments into a free-form narrative that rough;y
parallelled the code.

[...]
regards
-----------------------------------------------------------------------
Steve Holden                                 http://www.holdenweb.com/
Python Web Programming                http://pydish.holdenweb.com/pwp/
-----------------------------------------------------------------------








More information about the Python-list mailing list