Path: csiph.com!usenet.pasdenom.info!dedibox.gegeweb.org!gegeweb.eu!nntpfeed.proxad.net!proxad.net!feeder1-2.proxad.net!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.144 X-Spam-Level: * X-Spam-Evidence: '*H*': 0.71; '*S*': 0.00; 'explicit': 0.07; 'matches': 0.07; 'comment,': 0.09; 'cc:addr:python-list': 0.11; 'posted': 0.15; '23,': 0.16; 'discrepancy': 0.16; 'from:addr:rosuav': 0.16; 'from:name:chris angelico': 0.16; 'subject:python': 0.16; 'wrote:': 0.18; 'cc:addr:python.org': 0.22; 'cc:2**0': 0.24; 'right.': 0.26; 'least': 0.26; 'header:In- Reply-To:1': 0.27; 'fixed': 0.29; 'rest': 0.29; 'am,': 0.29; "doesn't": 0.30; 'dos': 0.30; 'message-id:@mail.gmail.com': 0.30; "i'm": 0.30; 'code': 0.31; 'sep': 0.31; 'subject:some': 0.31; 'table,': 0.31; 'file': 0.32; 'bugs': 0.33; 'comment': 0.34; 'could': 0.34; 'but': 0.35; 'received:google.com': 0.35; 'should': 0.36; 'two': 0.37; 'easily': 0.37; 'form,': 0.38; 'rather': 0.38; 'anything': 0.39; 'sure': 0.39; 'days': 0.60; 'catch': 0.60; 'tell': 0.60; 'simply': 0.61; 'more': 0.64; 'between': 0.67; 'attention.': 0.68; 'design.': 0.68; 'allocation': 0.74; 'obvious': 0.74; 'subject:!!!': 0.74; 'subject:get': 0.81; 'comment.': 0.84; 'differences,': 0.84; 'eponymous': 0.84; 'fat': 0.84; 'subject:Love': 0.91; 'to:none': 0.92 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:cc :content-type; bh=E6vZ8+0fHuaoGTxtUH4yYoqrYPPYOPLUue9mm5ncap0=; b=iKIzXQQRGEx97WYZVHpP1ARqxORN5kGD+culGa70M7r/QU72QggaqGvTOaaeqS2Zls 3mAJsH2n8P7x8jexWYco/BIHVhNqCbad8D0V+CelB/4Fq97LYlWQnBbo5elHdv281YNl f9igVXpItgRGZIA+z5hc1Wwazn/j8K9TYrxYQcYAczz1+R4dpmYx6anEP3QyeyN1KETd tNuiOgXk7VvBmd3lDzKZe9OwVbkPZLyKLbv6gfGCh/6+Unw3I3ji5HENfIZK2XVAj6dg gtfmPeGLj5pXMAwEfqUjAnj2Xw9jH7E9UUXYeMH8mrQ1K7mUl4kyXa/ZTW/qhkw3U+jB a25Q== MIME-Version: 1.0 X-Received: by 10.50.176.202 with SMTP id ck10mr15678686igc.2.1411401883784; Mon, 22 Sep 2014 09:04:43 -0700 (PDT) In-Reply-To: <1142710437.7070860.1411401142913.JavaMail.root@sequans.com> References: <1142710437.7070860.1411401142913.JavaMail.root@sequans.com> Date: Tue, 23 Sep 2014 02:04:43 +1000 Subject: Re: Love to get some feedback on my first python app!!! From: Chris Angelico Cc: "python-list@python.org" Content-Type: text/plain; charset=UTF-8 X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 15 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1411401886 news.xs4all.nl 2844 [2001:888:2000:d::a6]:41683 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:78158 On Tue, Sep 23, 2014 at 1:52 AM, Jean-Michel Pichavant wrote: > The code I posted had many bugs but one could not be fixed without the comment. Or at least there's an obvious discrepancy between the comment and the code that should catch the reader's attention. > The obvious discrepancy, sadly, doesn't tell you which one is right. It's like the old days of FAT file systems - DOS would maintain two copies of the eponymous File Allocation Table, but in the event of corruption, it had no way of knowing which was to be trusted. (And I'm not sure anything would ever actually notice differences, other than an explicit CHKDSK.) When you have an intention comment, rather than simply replicating the functionality in human-readable form, you can more easily check that the intention matches the rest of the design. ChrisA