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,34e28efa1a88ae84
X-Google-Attributes: gid103376,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news1.google.com!border1.nntp.dca.giganews.com!nntp.giganews.com!nx01.iad01.newshosting.com!newshosting.com!208.49.83.146.MISMATCH!uns-out.usenetserver.com!news.usenetserver.com!pc03.usenetserver.com!news.flashnewsgroups.com-b7.4zTQh5tI3A!not-for-mail
Newsgroups: comp.lang.ada
Subject: Re: Access procedure to pointer
References: <g1gqom$2i5$1@registered.motzarella.org>
 <df53ad53-f1fd-4783-9ea0-9a353a330168@m73g2000hsh.googlegroups.com>
 <483C48B5.9060303@gmail.com> <d6kyupfbpon4$.eloynz2lu01v.dlg@40tude.net>
 <483D209D.5010408@gmail.com> <t7bj1g.qad.ln@hunter.axlog.fr>
 <483D72F0.9090308@gmail.com> <eitj1g.lh8.ln@hunter.axlog.fr>
 <49d0600f-e5cd-4d95-9ca4-1eb25a832437@l17g2000pri.googlegroups.com>
 <483DE480.9020208@gmail.com>
From: Stephen Leake <Stephe.Leake@nasa.gov>
Date: Sat, 31 May 2008 01:52:06 -0400
Message-ID: <ufxrz81h5.fsf@nasa.gov>
User-Agent: Gnus/5.1008 (Gnus v5.10.8) Emacs/22.2 (windows-nt)
Cancel-Lock: sha1:5IdPSQJz6z9c/sTXOcwqWBpCLfs=
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Complaints-To: abuse@flashnewsgroups.com
Organization: FlashNewsgroups.com
X-Trace: e24e54840e28ee05e48ed16535
Xref: g2news1.google.com comp.lang.ada:494
Date: 2008-05-31T01:52:06-04:00
List-Id: <comp.lang.ada>

Sebastien Morand <seb.morand@gmail.com> writes:

> There is so many packages in my adainclude directory, that make me
> sick not to know what is inside ;-)

You could read the .ads files. They are well written and concise. I
don't see what other form of documentation would be much better. 

You mention javadoc in another post. That's just a massaged form of
comments and code from java source code. In java, that makes sense,
because there is no separation of interface from implementation (no
analogy of .ads vs .adb). So reading the java source files is tedious
and confusing, if all you want is a list of functions you could call.

For Ada, that's simply not necessary; .ads files serve the same
purpose, without needing a separate tool. 

You _know_ the .ads files are accurate (the code parts, anyway :) and
up-to-date; you don't know that with javadoc output.

-- 
-- Stephe