Re: S-expression I/O in Ada

[Britt Snodgrass <britt.snodgrass@gmail.com>]

On Aug 29, 8:23 am, 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?  Have you read the GNAT User's Guide, and the GNAT Reference
> Manual?  They should be under some 'doc' directory in your
> GNAT installation.  Or 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