Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!selfless.tophat.at!news.glorb.com!news.astraweb.com!border6.newsrouter.astraweb.com!not-for-mail From: Ben Finney Newsgroups: comp.lang.python Subject: Re: The worth of comments References: <87sjs0apgh.fsf@benfinney.id.au> <4ddfd9bf$0$49183$e4fe514c@news.xs4all.nl> <4de1011f$0$49184$e4fe514c@news.xs4all.nl> <94djdoFt6U1@mid.individual.net> X-Public-Key-ID: 0xAC128405 X-Public-Key-Fingerprint: 517C F14B B2F3 98B0 CB35 4855 B8B2 4C06 AC12 8405 X-Public-Key-URL: http://www.benfinney.id.au/contact/bfinney-pubkey.asc X-Post-From: Ben Finney Date: Sun, 29 May 2011 11:41:44 +1000 Message-ID: <877h9a9tbb.fsf@benfinney.id.au> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) Cancel-Lock: sha1:qukIdw+OQItWnKn2/M6R96qSRz8= MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Lines: 17 Organization: Unlimited download news at news.astraweb.com NNTP-Posting-Host: 121a8c35.news.astraweb.com X-Trace: DXC=CV;?jK3>dE>l`aiKB9>hO1L?0kYOcDh@:7^o:UA4R?c5BV[_EIl5[h?]G;2>V^?kW3bEW9A[5UK?5NZ[SL`C\Kg3P4Vm04N2Ld6 Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:6507 Gregory Ewing writes: > If the contract comment doesn't match what code does, then there are > two possibilities -- the comment is wrong, or the code is wrong. The > appropriate response is to find out which one is wrong and fix it. You omit the common third possibility: *both* the comment and the code are wrong. That's the one that I bet on whenever I notice code and comment don't match. -- \ “Anyone can do any amount of work provided it isn't the work he | `\ is supposed to be doing at the moment.” —Robert Benchley | _o__) | Ben Finney