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=unavailable autolearn_force=no version=3.4.4
Path: 
 eternal-september.org!reader01.eternal-september.org!feeder.eternal-september.org!news.swapon.de!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: Niklas Holsti <niklas.holsti@tidorum.invalid>
Newsgroups: comp.lang.ada
Subject: Re: Why .ads as well as .adb?
Date: Fri, 7 Jun 2019 10:36:30 +0300
Organization: Tidorum Ltd
Message-ID: <gluifuF1agkU1@mid.individual.net>
References: <28facad3-c55f-4ef2-8ef8-004925b7d1f1@googlegroups.com>
 <qcvqut$ejh$1@gioia.aioe.org>
 <dbbcf7b1-091f-4c87-b2b1-021bb9503b70@googlegroups.com>
 <qd2krk$pin$1@gioia.aioe.org>
 <f37f6f75-62d4-4152-917e-d666d67f6cb7@googlegroups.com>
 <qd6rb8$hl7$1@franka.jacob-sparre.dk>
 <a902e41a-729d-4c00-8e3f-0cda1822a349@googlegroups.com>
 <qd81gq$aej$1@dont-email.me> <87woi0xtwm.fsf@nightsong.com>
 <glpiqeFt9jqU1@mid.individual.net>
 <f611bdb8-5a40-48bd-afe5-17de72bbe193@googlegroups.com>
 <glq1rpF1v52U1@mid.individual.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: individual.net 0ATQIqLUKyQtnqgnQjfZBg+M+76nl6vwRLPdgRr+4fAHBSAoHN
Cancel-Lock: sha1:fOit7RgmMgmuzaQ+VNh8qFlS52U=
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:45.0)
 Gecko/20100101 Thunderbird/45.8.0
In-Reply-To: <glq1rpF1v52U1@mid.individual.net>
Xref: reader01.eternal-september.org comp.lang.ada:56533
Date: 2019-06-07T10:36:30+03:00
List-Id: <comp.lang.ada>

On 19-06-05 17:28 , Niklas Holsti wrote:

I wrote:

> Most of my specs contain mostly type declarations, with a smattering of
> subprogram declarations -- no, in fact most of my specs contain mostly
> comments to explain the types and to specify and explain what the
> subprograms (should) do.

An amusing but unfortunate side-effect of such extensive comments in the 
spec is that, for simpler subprograms, few or perhaps no comments are 
needed in the body -- which often makes static source-code analysers 
complain that the comment-to-code ratio is too small, because the 
analyser only counts the comments in the subprogram's body... :-(

This problem might be solved by merging the spec and body in the same 
file. Or, of course, by making the source-code analysers a bit smarter.

-- 
Niklas Holsti
Tidorum Ltd
niklas holsti tidorum fi
       .      @       .