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
Path: 
 g2news1.google.com!news1.google.com!news2.google.com!border1.nntp.dca.giganews.com!nntp.giganews.com!wns14feed!worldnet.att.net!attbi_s21.POSTED!53ab2750!not-for-mail
From: "Jeffrey R. Carter" <spam.jrcarter.not@spam.acm.org>
User-Agent: Thunderbird 2.0.0.14 (Windows/20080421)
MIME-Version: 1.0
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> <ufxrz81h5.fsf@nasa.gov>
 <g20oqm$slv$1@registered.motzarella.org>
In-Reply-To: <g20oqm$slv$1@registered.motzarella.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8bit
Message-ID: <RQW0k.191245$yE1.123687@attbi_s21>
NNTP-Posting-Host: 12.201.97.213
X-Complaints-To: abuse@mchsi.com
X-Trace: attbi_s21 1212430769 12.201.97.213 (Mon, 02 Jun 2008 18:19:29 GMT)
NNTP-Posting-Date: Mon, 02 Jun 2008 18:19:29 GMT
Organization: AT&T ASP.att.net
Date: Mon, 02 Jun 2008 18:19:29 GMT
Xref: g2news1.google.com comp.lang.ada:532
Date: 2008-06-02T18:19:29+00:00
List-Id: <comp.lang.ada>

S�bastien wrote [concerning the GNAT adainclude directory]:
>> 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. 
> 
> I can and I do, but just because I don't have any choice. Of course Ada 
> is easy to read, but there is no hyperlink navigation, this is quite 
> boring. For instance you find out a function, let's say the 
> documentation is clear, yes but ada is strongly typed and then have a 
> lot of new type in order to assure safety and quality of the code. So 
> you have then to find the definition of the type and so on...

The a-*.ad? files are the standard library (package Ada and its descendants) and 
its implementation. These are well documented in the ARM, primarily Annex A. 
This is readable and the online version is hyperlinked.

The i-*.ad? files are package Interfaces and its descendants, and their 
implementation. These are also well documented in the ARM, Annex B.

The s-*.ad? files are package System and its descendants, and their 
implementation. These are also documented in the ARM, section 13.

The g-*.ad? files are GNAT-specific units. Some are for general use and some are 
GNAT internal units. Documentation is up to the compiler supplier.

-- 
Jeff Carter
"He didn't get that nose from playing ping-pong."
Never Give a Sucker an Even Break
110