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 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,587e0e0a16d65b10
X-Google-Attributes: gid103376,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII
Path: 
 g2news1.google.com!news2.google.com!border1.nntp.dca.giganews.com!nntp.giganews.com!newsfeed00.sul.t-online.de!t-online.de!news-1.dfn.de!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: "(see below)" <yaldnif.w@blueyonder.co.uk>
Newsgroups: comp.lang.ada
Subject: Re: Invade wikipedia!
Date: Wed, 25 Feb 2009 01:45:38 +0000
Message-ID: <C5CA5342.10CF3D%yaldnif.w@blueyonder.co.uk>
References: <l6k0og.o0o.ln@hunter.axlog.fr>
 <1tw8gryqdolal$.1osqedj9x821c.dlg@40tude.net>
  <5c44eaae-631d-46d2-8384-86af79d5e048@n20g2000vba.googlegroups.com>
  <944a1924-0fa7-487f-a94d-084a2be1b231@v31g2000vbb.googlegroups.com>
  <WCZol.586329$yE1.342435@attbi_s21>
 <b26ae712-a4e9-49d1-9869-aa29626fb5e5@t13g2000yqc.googlegroups.com>
  <9f2553d3-66f5-4708-a237-bfef1d8404f4@v42g2000yqj.googlegroups.com>
  <C5CA3442.10CF05%yaldnif.w@blueyonder.co.uk>
 <9c729d86-763b-446e-9ba0-3bd682ba23fa@u38g2000yqe.googlegroups.com>
Mime-Version: 1.0
Content-Type: text/plain;
	charset="ISO-8859-1"
Content-Transfer-Encoding: 8bit
X-Trace: individual.net pxJFJqkOq1sNv8HeZ9eNGQHV4imyBe71Mk5w9FyeW2EuQH580+
Cancel-Lock: sha1:UCWIoLkEUwmdOU1T+i66C7mvOwk=
User-Agent: Microsoft-Entourage/12.14.0.081024
Thread-Topic: Invade wikipedia!
Thread-Index: AcmW6sIdA4zSy8HuPUybPx2ekopsbA==
Xref: g2news1.google.com comp.lang.ada:3789
Date: 2009-02-25T01:45:38+00:00
List-Id: <comp.lang.ada>

On 25/02/2009 00:08, in article
9c729d86-763b-446e-9ba0-3bd682ba23fa@u38g2000yqe.googlegroups.com, "Martin"
<martin.dowie@btopenworld.com> wrote:

> On Feb 24, 11:33�pm, "(see below)" <yaldni...@blueyonder.co.uk> wrote:
>> On 24/02/2009 23:28, in article
>> 9f2553d3-66f5-4708-a237-bfef1d840...@v42g2000yqj.googlegroups.com, "Martin"
>> 
>> <martin.do...@btopenworld.com> wrote:
>>> Sorry my made up example doesn't cut mustard! Does this make it any
>>> clearer? :-)
>> 
>>> ------------------------
>>> -- Calculate_Velocity --
>>> ------------------------
>> 
>>> procedure Calculate_Velocity
>>> � � � � � � �(Speed � �: � � Meters_Per_Second;
>>> � � � � � � � Time � � : � � Seconds;
>>> � � � � � � � Velocity : out Meters_Per_Second_Per_Second);
>> 
>> Nope!
>> The reason why is left as an exercise for the student. 8-)
>> 
>> --
>> Bill Findlay
>> <surname><forename> chez blueyonder.co.uk
> 
> Hmmm, the tautology? I'm using C too much these days...
> 
> ---------------
> -- Calculate --
> ---------------
> 
> procedure Calculate (Speed    :     Meters_Per_Second;
>                      Time     :     Seconds;
>                      Velocity : out Meters_Per_Second_Per_Second);
> 

Still cold! 8-)

I hate comments, for being next to un-maintainable, and write as few as
possible (but no fewer). Better to make the code say what it really means,
as this example shows.

The comments I find useful are reminders to myself in stereotyped formats
that are easy to retrieve with an editor (e.g. "STUB" or "??").
 
Short clarifications of inherent obscurities are sometimes necessary.

-- 
Bill Findlay
<surname><forename> chez blueyonder.co.uk