Re: Invade wikipedia!

[Adam Beneschan <adam@irvine.com>]

On Feb 24, 11:48 am, Hibou57 (Yannick Duchêne)
<yannick_duch...@yahoo.fr> wrote:
> On 24 fév, 15:50, Martin <martin.do...@btopenworld.com> wrote:
>
>
>
> > Could we agree get rid of the box comments, e.g.
>
> >    ------------------
> >    -- Do_Something --
> >    ------------------
>
> >    procedure Do_Something ...;
>
> > Cheers
> > -- Martin
>
> Please, help me to understand : what's the trouble with this ?

In large source files, having comments like this can sometimes help a
reader who is scanning the entire source.  (Yes, the advantage of this
has been lessened with all the fancy editing tools we now have.  I'm
speaking as a Cobolosaurus who still remembers programs being on punch
cards and having to read listings from the line printer.  Even with
the tools available, I still sometimes find it useful to just read
through a whole source top to bottom, and something is needed to break
it up and put some structure in the list so that my eyes don't see it
as just one big continuous 1200-line blob.)

But in a small source, it's just clutter and it gets in the way.

                               -- Adam