1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
|
What is the Ada Reference Manual?
=================================
The Ada Reference Manual is the free (libre) version of the
international standard ISO/IEC 8652:1995(E). It describes a programming
language called "Ada".
Why are there so many different documents?
==========================================
(All file names in this section are relative to the directory
/usr/share/doc/ada-reference-manual.)
The Ada Reference Manual was revised in 2000/2001, so there are two
revisions which differ in a few aspects. This packages includes only
the newer version (if it is available in a particular format).
There are two different versions of manual, one that closely matches the
official standard, and one which contains additional annotations for
compiler writers, language lawyers etc. The latter version is called
the "Annotated Ada Reference Manual" (or AARM for short). Both versions
are provided by this package.
The Ada Reference Manual with Technical Corrigendum 1 applied is stored
in the directory html/arm95tc1 (table of contents:
html/arm95tc1/RM-TOC.html). The plain text version is located in the
directory arm95tc1/.
Besides the annotations, the version of the AARM which is distributed in
this package contains marks for all changes made by Technical
Corrigendum 1. The table of contents is available in
html/aarm95tc1/AA-TOC.html. No text version is provided because it
would not be very readable due to lack of markup.
The file html/tc1/Corrigendum.html contains the changes applied to the
original version of the standard in Technical Corrigendum 1.
The AARM refers to the defect reports in html/tc1/defect1.html and
html/tc1/defect2.html.
At the moment, the Texinfo version does not include Technical
Corrigendum 1.
Why aren't there any PDF files for printing?
============================================
PDF is not an "open" format. In order to be DFSG-compliant, we need the
original sources (available from <http://www.ada-auth.org/>, under a
reasonable license) and a free preprocessor (which is currently
missing). That's why this package contains open formats only (HTML,
plain text, and Texinfo).
|