How to comment code?

2007-01-19 Thread Martin P. Hellwig
Hi all, I've been toying with python for about two years now. Not every day, just when I encounter something in my job (sysadmin) repetitively dull. The amazing thing is that like any other language (natural or not) learning it more gives you power to express your thoughts better and create

Re: How to comment code?

2007-01-19 Thread James Stroud
Martin P. Hellwig wrote: Hi all, I've been toying with python for about two years now. Not every day, just when I encounter something in my job (sysadmin) repetitively dull. The amazing thing is that like any other language (natural or not) learning it more gives you power to express your

Re: How to comment code?

2007-01-19 Thread Pavel Panchekha
I think that doc strings are the most important way in which you should be commenting on your code. Once the code works, you can elimainate most inline comments, leaving only doc string for everything and a few comments on some particularly confusing parts. Other than that, comments usually only

Re: How to comment code?

2007-01-19 Thread gonzlobo
If it's hard to write, it should be hard to read! :) On 1/19/07, Martin P. Hellwig [EMAIL PROTECTED] wrote: Hi all, (snip) However since I'm learning more of python I've struggled with commenting, how should I've comment my code (snip) -- http://mail.python.org/mailman/listinfo/python-list