Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.python > #6336 > unrolled thread

The worth of comments

Started byRichard Parker <r.richardparker@comcast.net>
First post2011-05-26 11:50 -0700
Last post2011-05-27 14:17 -0400
Articles 4 on this page of 24 — 14 participants

Back to article view | Back to comp.lang.python

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.


Contents

  The worth of comments Richard Parker <r.richardparker@comcast.net> - 2011-05-26 11:50 -0700
    Re: The worth of comments Ben Finney <ben+python@benfinney.id.au> - 2011-05-27 11:42 +1000
      Re: The worth of comments Grant Edwards <invalid@invalid.invalid> - 2011-05-27 13:54 +0000
        Re: The worth of comments Irmen de Jong <irmen@-NOSPAM-xs4all.nl> - 2011-05-27 19:05 +0200
          Re: The worth of comments Grant Edwards <invalid@invalid.invalid> - 2011-05-27 17:53 +0000
            Re: The worth of comments Irmen de Jong <irmen.NOSPAM@xs4all.nl> - 2011-05-28 15:09 +0200
              Re: The worth of comments python@bdurham.com - 2011-05-28 09:34 -0400
            Re: The worth of comments Roy Smith <roy@panix.com> - 2011-05-28 09:36 -0400
              Re: The worth of comments Chris Angelico <rosuav@gmail.com> - 2011-05-29 00:02 +1000
              Re: The worth of comments Irmen de Jong <irmen.NOSPAM@xs4all.nl> - 2011-05-28 16:05 +0200
                Re: The worth of comments Gregory Ewing <greg.ewing@canterbury.ac.nz> - 2011-05-29 12:47 +1200
                  Re: The worth of comments Ben Finney <ben+python@benfinney.id.au> - 2011-05-29 11:41 +1000
                    Re: The worth of comments Gregory Ewing <greg.ewing@canterbury.ac.nz> - 2011-05-29 23:05 +1200
                      Re: The worth of comments Grant Edwards <invalid@invalid.invalid> - 2011-05-29 14:43 +0000
                        Re: The worth of comments Roy Smith <roy@panix.com> - 2011-05-29 11:39 -0400
                  Re: The worth of comments Irmen de Jong <irmen.NOSPAM@xs4all.nl> - 2011-05-29 03:49 +0200
                  Re: The worth of comments Alister Ware <alister.ware@ntlworld.com> - 2011-05-29 17:26 +0000
              Re: The worth of comments Neil Cerutti <neilc@norwich.edu> - 2011-05-31 14:47 +0000
    Re: The worth of comments Roy Smith <roy@panix.com> - 2011-05-26 22:08 -0400
      Re: The worth of comments Chris Angelico <rosuav@gmail.com> - 2011-05-27 15:13 +1000
        Re: The worth of comments Roy Smith <roy@panix.com> - 2011-05-27 09:25 -0400
      Re: The worth of comments Tim Roberts <timr@probo.com> - 2011-05-27 00:02 -0700
        Re: The worth of comments "D'Arcy J.M. Cain" <darcy@druid.net> - 2011-05-27 09:29 -0400
      RE: The worth of comments "Prasad, Ramit" <ramit.prasad@jpmchase.com> - 2011-05-27 14:17 -0400

Page 2 of 2 — ← Prev page 1 [2]


#6386

FromRoy Smith <roy@panix.com>
Date2011-05-27 09:25 -0400
Message-ID<roy-159D24.09251227052011@news.panix.com>
In reply to#6371
In article <mailman.2145.1306473197.9059.python-list@python.org>,
 Chris Angelico <rosuav@gmail.com> wrote:

> (Did I *really* write that code? It has my name on it.....)

Most version control systems have an annotate command which lets you see 
who wrote a given line of code.  Some of them are even honest enough to 
call the command "blame" instead of "annotate" :-)

And, yes, it's always a rude shock when I stare at some hunk of code, 
mutter, "who wrote this crap!?" and fire up annotate/blame only to 
discover my name on it.

[toc] | [prev] | [next] | [standalone]


#6374

FromTim Roberts <timr@probo.com>
Date2011-05-27 00:02 -0700
Message-ID<nsiut6hcra33fmgdrcp0s6h0r7sap451qv@4ax.com>
In reply to#6361
Roy Smith <roy@panix.com> wrote:
>
>Over the years, my use of comments has evolved.  I was taught, "You 
>should comment your code".  Eventually, I came to realize that the real 
>mandate is, "You should make it easy to understand your code".  Comments 
>are just one possible tool to help achieve that goal.

Absolutely correct.  In my view, this is one of the strongest attributes of
Python -- its syntax is such that much of the code can be read out loud
like prose.  That's a HUGE benefit.  Code is read a lot more often than it
is written.

Ruby has a lot of followers, and I am trying to get excited about it, but
it has succumbed to the same special-characters-as-syntax disease that
killed Perl.  Much Ruby code is just unreadable.
-- 
Tim Roberts, timr@probo.com
Providenza & Boekelheide, Inc.

[toc] | [prev] | [next] | [standalone]


#6387

From"D'Arcy J.M. Cain" <darcy@druid.net>
Date2011-05-27 09:29 -0400
Message-ID<mailman.2149.1306502995.9059.python-list@python.org>
In reply to#6374
On Fri, 27 May 2011 00:02:23 -0700
Tim Roberts <timr@probo.com> wrote:
> Ruby has a lot of followers, and I am trying to get excited about it, but
> it has succumbed to the same special-characters-as-syntax disease that
> killed Perl.  Much Ruby code is just unreadable.

What?  The recent Perl flame war wasn't enough entertainment for
you?  ;-)

-- 
D'Arcy J.M. Cain <darcy@druid.net>         |  Democracy is three wolves
http://www.druid.net/darcy/                |  and a sheep voting on
+1 416 425 1212     (DoD#0082)    (eNTP)   |  what's for dinner.

[toc] | [prev] | [next] | [standalone]


#6421

From"Prasad, Ramit" <ramit.prasad@jpmchase.com>
Date2011-05-27 14:17 -0400
Message-ID<mailman.2162.1306520911.9059.python-list@python.org>
In reply to#6361
>(Did I *really* write that code? It has my name on it.....)

Damn those ninja programmers who stole your name and coded something!


Ramit



Ramit Prasad | JPMorgan Chase Investment Bank | Currencies Technology
712 Main Street | Houston, TX 77002
work phone: 713 - 216 - 5423



This communication is for informational purposes only. It is not
intended as an offer or solicitation for the purchase or sale of
any financial instrument or as an official confirmation of any
transaction. All market prices, data and other information are not
warranted as to completeness or accuracy and are subject to change
without notice. Any comments or statements made herein do not
necessarily reflect those of JPMorgan Chase & Co., its subsidiaries
and affiliates.

This transmission may contain information that is privileged,
confidential, legally privileged, and/or exempt from disclosure
under applicable law. If you are not the intended recipient, you
are hereby notified that any disclosure, copying, distribution, or
use of the information contained herein (including any reliance
thereon) is STRICTLY PROHIBITED. Although this transmission and any
attachments are believed to be free of any virus or other defect
that might affect any computer system into which it is received and
opened, it is the responsibility of the recipient to ensure that it
is virus free and no responsibility is accepted by JPMorgan Chase &
Co., its subsidiaries and affiliates, as applicable, for any loss
or damage arising in any way from its use. If you received this
transmission in error, please immediately contact the sender and
destroy the material in its entirety, whether in electronic or hard
copy format. Thank you.

Please refer to http://www.jpmorgan.com/pages/disclosures for
disclosures relating to European legal entities.

[toc] | [prev] | [standalone]


Page 2 of 2 — ← Prev page 1 [2]

Back to top | Article view | comp.lang.python


csiph-web