From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM autolearn=ham autolearn_force=no version=3.4.4 X-Google-Thread: 103376,429176cb92b1b825 X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,UTF8 Path: g2news2.google.com!news3.google.com!feeder3.cambriumusenet.nl!feed.tweaknews.nl!193.201.147.68.MISMATCH!feeder.news-service.com!94.75.214.39.MISMATCH!aioe.org!not-for-mail From: =?utf-8?Q?Yannick_Duch=C3=AAne_=28Hibou57?= =?utf-8?Q?=29?= Newsgroups: comp.lang.ada Subject: Re: AWS Coding Styles (and about boring plain-linear text files in the end) Date: Tue, 18 Jan 2011 23:11:55 +0100 Organization: Ada @ Home Message-ID: References: <24418fa4-8843-4fe6-8c2f-026ea6009b68@g26g2000vbz.googlegroups.com> <87lj2ido9j.fsf@mid.deneb.enyo.de> NNTP-Posting-Host: 59xjXE7stDARAmb8zI1USw.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed; delsp=yes Content-Transfer-Encoding: Quoted-Printable X-Complaints-To: abuse@aioe.org X-Notice: Filtered by postfilter v. 0.8.2 User-Agent: Opera Mail/11.00 (Win32) Xref: g2news2.google.com comp.lang.ada:17504 Date: 2011-01-18T23:11:55+01:00 List-Id: Le Tue, 18 Jan 2011 20:07:20 +0100, Florian Weimer a = = =C3=A9crit: > * pascal: > >>> > Comments describing a subprogram spec should specifically >>> > mention the formal argument names. General rule: write a >>> > comment that does not depend on the names of things. >>> >>> Q: I am afraid I did not understood this one, as it seems >>> ambiguous to me. How to refer to formal argument names >>> without refering to the names of things ? Or else, are >>> does =E2=80=9Cnames of things=E2=80=9D refer to in this conte= xt ? >> >> Instead of saying: >> >> procedure Call (Filename : String); >> -- The name of the file should be an absolute name >> >> Say: >> >> procedure Call (Filename : String); >> -- Filename must be an abosulute name > > The problem is that the rule is self-contradictory. I think it should= > say, "should not specifically mention", i.e., the opposite of what you= > suggested. > > I will submit a patch to gcc/ada/gnat-style.texi to fix this. Thanks, that's crystal-clear now. Just that we may wait for a confirmati= on = from Pascal (if ever this interpretation is also wrong). -- = Si les chats miaulent et font autant de vocalises bizarres, c=E2=80=99es= t pas pour = les chiens. =E2=80=9CI am fluent in ASCII=E2=80=9D [Warren 2010]