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
|
What is the Ada Reference Manual?
=================================
The Ada Reference Manual is the free (libre) version of the
international standard ISO/IEC 8652:2007(E). It describes a
programming language called "Ada".
The Ada Reference Manual was last revised in 2005 (but not actually
approved by ISO until 2007). The official standard consists of the 1995
standard plus a corrigendum and an amendment. The corrigendum fixes
bugs in the 1995 standard; the amendment introduces new features. The
documents here merge these together into one document, with no change
markup, for easy reading.
If you want versions of the manual with change markup, see
http://www.adaic.com/standards/ada05.html
There are two different versions of manual, one that contains just the
text of 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.
Why aren't these files the same as upstream?
================================================
The upstream PDF files are produced from the original sources using
Microsoft word as an intermediate step. The HTML files are produced
from the original sources from a tool that is not DFSG-compatible.
Therefore, we take a different route; we patch the Ada sources for the
tool to generate texinfo, and use that texinfo as the upstream source
for this package. Then we run pdftx on the texinfo to generate PDF,
and makeinfo to generate HTML and info. The formatting is not as
nice as in the upstream version.
Why don't these PDF files have hyperlinks?
==========================================
The upstream PDF files don't have hyperlinks either. The problem is
the intermediate processors; they don't generate proper hyperlinks for
PDF (they do for HTML and info). To get hyperlinks in PDF, we need to
adapt the Ada code to produce PDF directly from the original source.
-- Stephen Leake <stephen_leake@stephe-leake.org>, Wed, 16 Jun 2010 02:28:09 -0400
|
