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.1 required=5.0 tests=BAYES_00,
	PP_MIME_FAKE_ASCII_TEXT autolearn=no autolearn_force=no version=3.4.4
X-Google-Thread: 103376,8b756d9a0afb052a
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII
Path: 
 g2news1.google.com!news2.google.com!news3.google.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local01.nntp.dca.giganews.com!nntp.megapath.net!news.megapath.net.POSTED!not-for-mail
NNTP-Posting-Date: Mon, 20 Feb 2006 16:05:33 -0600
From: "Randy Brukardt" <randy@rrsoftware.com>
Newsgroups: comp.lang.ada
References: <Xns976E4AA3A7D3Cpchapinsovernet@198.186.192.137>
 <m2vevcpzlq.fsf@grendel.local>
 <Xns976EA58D4A4E4pchapinsovernet@198.186.192.137> <43F7915B.3090000@obry.net>
 <m2r760p5s7.fsf@grendel.local> <43F83D46.2090200@obry.net>
 <m2ek1zpt6s.fsf@grendel.local> <43F84890.7010900@obry.net>
 <43f871d8$0$491$9b4e6d93@newsread4.arcor-online.net>
 <43F872C4.50505@obry.net>
Subject: Re: Quick question about Ada code formatting.
Date: Mon, 20 Feb 2006 16:10:19 -0600
X-Priority: 3
X-MSMail-Priority: Normal
X-Newsreader: Microsoft Outlook Express 6.00.2800.1106
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
Message-ID: <zImdnfZp4LezoGfenZ2dnUVZ_vydnZ2d@megapath.net>
NNTP-Posting-Host: 64.32.209.38
X-Trace: 
 sv3-847IiTEb6Js33Q59Tjb93Bpj3rCPJpNkDQE9yYykg+njta0y4hjYivMaDSNg6WcToMMD4Obm1ojvYLR!T+OggUfLo4Tyl39f+mdXtRqLBovLsioJ7yml5TIftYPNc8mRhFn7JJ+lUyNfTIP2l8nr4d85ZzyX!1GmmnUYR3yw6BQ==
X-Complaints-To: abuse@megapath.net
X-DMCA-Complaints-To: abuse@megapath.net
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint
 properly
X-Postfilter: 1.3.32
Xref: g2news1.google.com comp.lang.ada:3026
Date: 2006-02-20T16:10:19-06:00
List-Id: <comp.lang.ada>

"Pascal Obry" <pascal@obry.net> wrote in message
news:43F872C4.50505@obry.net...
> Georg Bauhaus a �crit :
>
> > They can indicate a major block. For example in Matt's AI 302
> > implementation, there are blank lines between many executable
> > statements. There are two blank lines between most, if not all,
> > subprograms.
>
> Between subprograms I prefer the "GNAT style" header box:
>
>   ----------------------
>   -- Process_Whatever --
>   ----------------------
>
>   procedure Process_Whatever is
>   ...
>
> Far clearer than 2 blank lines IMHO.

But extremely hard to maintain. We used a style like that in the Janus/Ada
compiler, and we found that we were spending a lot of time lining up the
closing hyphens ever time the comment changed in some way. We abandoned the
whole idea with Claw, and went to two blank lines between subprograms.

After all, the idea isn't to carry any information, but to simply to
separate the procedures. (Comments that repeat what is obviously known by
reading the source code are evil, IMHO, so I find this comment wasteful.)
Perhaps a better approach would be to include a dashed line separator
between procedures -- but that takes *three* lines, and since you never have
enough screen real estate, so it seems like a waste.

                        Randy.