Re: Invade wikipedia!

["(see below)" <yaldnif.w@blueyonder.co.uk>]

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