Path: csiph.com!x330-a1.tempe.blueboxinc.net!newsfeed.hal-mli.net!feeder1.hal-mli.net!border3.nntp.dca.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!news-out.readnews.com!transit3.readnews.com!panix!not-for-mail From: Grant Edwards Newsgroups: comp.lang.python Subject: Re: The worth of comments Date: Sun, 29 May 2011 14:43:57 +0000 (UTC) Organization: PANIX Public Access Internet and UNIX, NYC Lines: 17 Message-ID: References: <87sjs0apgh.fsf@benfinney.id.au> <4ddfd9bf$0$49183$e4fe514c@news.xs4all.nl> <4de1011f$0$49184$e4fe514c@news.xs4all.nl> <94djdoFt6U1@mid.individual.net> <877h9a9tbb.fsf@benfinney.id.au> <94enkcFj5mU1@mid.individual.net> NNTP-Posting-Host: 67-220-17-92.usiwireless.com Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: reader1.panix.com 1306680237 27267 67.220.17.92 (29 May 2011 14:43:57 GMT) X-Complaints-To: abuse@panix.com NNTP-Posting-Date: Sun, 29 May 2011 14:43:57 +0000 (UTC) User-Agent: slrn/0.9.9p1 (Linux) Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:6544 On 2011-05-29, Gregory Ewing wrote: > Ben Finney wrote: > >> You omit the common third possibility: *both* the comment and the code >> are wrong. > > In that case, the correct response is to fix both of them. :-) Only as a last resort. IMO, the best option is to fix the code so it's purpose and operation is obvious from the code, and then delete the comment. -- Grant