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,CP1252
Path: 
 g2news2.google.com!postnews.google.com!r41g2000yqm.googlegroups.com!not-for-mail
From: Martin <martin.dowie@btopenworld.com>
Newsgroups: comp.lang.ada
Subject: Re: Invade wikipedia!
Date: Tue, 24 Feb 2009 16:07:28 -0800 (PST)
Organization: http://groups.google.com
Message-ID: 
 <7e8a32ee-50cd-486d-bc1e-12a0bc57ed3a@r41g2000yqm.googlegroups.com>
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>
	<83521726-ce3a-413a-9a58-92a0205ba5f5@f3g2000yqf.googlegroups.com>
NNTP-Posting-Host: 81.156.241.180
Mime-Version: 1.0
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: quoted-printable
X-Trace: posting.google.com 1235520448 13537 127.0.0.1 (25 Feb 2009 00:07:28
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Wed, 25 Feb 2009 00:07:28 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: r41g2000yqm.googlegroups.com; posting-host=81.156.241.180;
	posting-account=g4n69woAAACHKbpceNrvOhHWViIbdQ9G
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;
	rv:1.9.0.6) Gecko/2009011912 Firefox/3.0.6,gzip(gfe),gzip(gfe)
Xref: g2news2.google.com comp.lang.ada:4757
Date: 2009-02-24T16:07:28-08:00
List-Id: <comp.lang.ada>

On Feb 24, 11:53=A0pm, Hibou57 (Yannick Duch=EAne)
<yannick_duch...@yahoo.fr> wrote:
> On 25 f=E9v, 00:28, 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
> > =A0 =A0 =A0 =A0 =A0 =A0 =A0(Speed =A0 =A0: =A0 =A0 Meters_Per_Second;
> > =A0 =A0 =A0 =A0 =A0 =A0 =A0 Time =A0 =A0 : =A0 =A0 Seconds;
> > =A0 =A0 =A0 =A0 =A0 =A0 =A0 Velocity : out Meters_Per_Second_Per_Second=
);
>
> > Cheers
> > -- Martin
>
> For visual seeking in a long page, I would reply =93yes=94 about me.
> Perhaps my eyes need this while others will not.
> As somebody enjoy white text on black or dark background while others
> feel theire eyes hurt with this layout.
> Visual perception and ergonomy is a complex and big science.


Sorry, the point I was making has been lost...

The problem I have with 'box comments' _in_examples_ - as found in
Wikipedia, Rosetta, etc - is that they distract the reader and nothing
to do with helping reads scan source in the real world.

For all I know they may actually lead some people to believe that Ada /
requires/ such comments or that they are common practice.

<shout>
That's just going to put potential Ada users off.
</shout>

NB: Check other languages examples - no comments. And certainly no
comments that don't actually explain something useful.

They /may/ or /may not/ have a use in the real world but that's a
topic for another thread.

Cheers
-- Martin