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=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD,
	FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4
X-Google-Thread: 103376,24d7acf9b853aac8
X-Google-NewGroupId: yes
X-Google-Attributes: gida07f3367d7,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII
Path: 
 g2news1.google.com!postnews.google.com!f42g2000yqn.googlegroups.com!not-for-mail
From: Britt Snodgrass <britt.snodgrass@gmail.com>
Newsgroups: comp.lang.ada
Subject: Re: S-expression I/O in Ada
Date: Sun, 29 Aug 2010 07:18:12 -0700 (PDT)
Organization: http://groups.google.com
Message-ID: 
 <e6948ae9-cd74-4f65-9112-06039c0be822@f42g2000yqn.googlegroups.com>
References: <547afa6b-731e-475f-a7f2-eaefefb25861@k8g2000prh.googlegroups.com>
 <slrni7feq5.dki.lithiumcat@sigil.instinctive.eu>
 <4c77d250$0$7653$9b4e6d93@newsspool1.arcor-online.net>
 <slrni7keig.dki.lithiumcat@sigil.instinctive.eu>
 <wccaao5v9hn.fsf@shell01.TheWorld.com>
NNTP-Posting-Host: 209.252.170.138
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
X-Trace: posting.google.com 1283091492 23273 127.0.0.1 (29 Aug 2010 14:18:12
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Sun, 29 Aug 2010 14:18:12 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: f42g2000yqn.googlegroups.com; posting-host=209.252.170.138;
 posting-account=rdRzuwoAAAAyW3CSBhs_xgfCUJSc1aNt
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1;
 Trident/4.0; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648;
 .NET CLR 3.5.21022; InfoPath.1; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729;
 OfficeLiveConnector.1.3; OfficeLivePatch.0.0),gzip(gfe)
Xref: g2news1.google.com comp.lang.ada:13808
Date: 2010-08-29T07:18:12-07:00
List-Id: <comp.lang.ada>

On Aug 29, 8:23=A0am, Robert A Duff <bobd...@shell01.TheWorld.com>
wrote:

>
> > I find compiler issues to be the weakest point of Ada: documentation is
> > pretty well hidden, ...
>
> Heh? =A0Have you read the GNAT User's Guide, and the GNAT Reference
> Manual? =A0They should be under some 'doc' directory in your
> GNAT installation. =A0Or a quick google sends me to:
>
> http://gcc.gnu.org/onlinedocs/index.html#dir
>
> How are these "well hidden"?
>

Of course thay are not hidden since they are also located in a "...
\share\doc\..." subdirectory within the compiler installation.  THe
GNAT Programming System (GPS) Help menu also provides sub-menus for
all the documentation.

I find the GNAT manuals to be quite complete and generally well
written.  I appreciate the fact that the are supplied in PDF format as
well as HTML.  I like PDF because I often use the "find all
occurences" search feature in Adobe Reader and Acrobat. I also
sometime print a reference section from one of the PDF manuals.

If I do have a complaint it is that there are possibly too many
different manuals.  I deal with that by using Adobe Acrobat to create
an index of _all_ the GNAT PDF manuals so that I can quickly search
all of them at once.

The GNAT Project (GPR file) information is a pretty complete but
scattered among several manuals. In addition to the Users Guide, it is
important to look in the GNAT Reference Manual as well, and also in
the GPS and GPRbuild manuals for a few things.


- Britt