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!reader02.eternal-september.org!.POSTED!not-for-mail
From: "Jeffrey R. Carter" <spam.jrcarter.not@spam.not.acm.org>
Newsgroups: comp.lang.ada
Subject: Re: Is the Documentation In a spec File Usually Enough For You ?
Date: Mon, 15 Oct 2018 18:50:19 +0200
Organization: Also freenews.netfront.net; news.tornevall.net;
 news.eternal-september.org
Message-ID: <pq2gge$a3s$1@dont-email.me>
References: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Mon, 15 Oct 2018 16:50:22 -0000 (UTC)
Injection-Info: reader02.eternal-september.org;
 posting-host="c2ea726c768b374600ce4d6d32ce305a";
	logging-data="10364"; mail-complaints-to="abuse@eternal-september.org";
	posting-account="U2FsdGVkX1/AP8tgCTL263HQiYyQvuPimcbuShcqNxU="
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.9.1
Cancel-Lock: sha1:mFRiMk0Y+RrgCzTltSXbEKELkZg=
In-Reply-To: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com>
Content-Language: en-US
Xref: reader02.eternal-september.org comp.lang.ada:54595
Date: 2018-10-15T18:50:19+02:00
List-Id: <comp.lang.ada>

On 10/15/2018 02:42 AM, patrick@spellingbeewinnars.org wrote:
> 
> The thing is, that the Ada libraries come with almost no documentation/example code at all.

"The Ada libraries" covers a lot of ground. If you're referring to the standard 
library, as others have pointed out, it's well documented in the ARM.

For other libraries, if they can't be used by only reading the specs or by 
documentation similar to that in Annex A, then I question the competence of the 
developer and the correctness of the implementation.

(Now you can look at the pkgs at github.com/jrcarter and question my competence. 
If they can be clearer I'd like to improve them.)

-- 
Jeff Carter
"Insufficient laughter--that's grounds for divorce."
Play It Again, Sam
126