Nicolas,
I do not want to seem ungrateful for your work, but having done it myself in the past, here goes:
Op 4-9-2013 1:48, Nicolas Boulenguez wrote:
On Tue, Sep 03, 2013 at 04:06:41PM +0200, Jerry van Dijk wrote:
Alas, not everyone can choose to work with the latest Ada standard.
Hence GNAT still supports Ada83, Ada95 and Ada05. Personally I would
love to have all 4 manuals available. As the manuals never change and
new ones come around only every 5 to 10 years, how much extra work could
that be ?
gr.
Jerry.
Adaic provides HTML browsable versions of older standards at [1],
giving the impression that the manuals are available as free software.
However, packaging is not trivial, as you can see at [2].
- AdaIC only provides the prefered form of modification ("unformatted
sources") for the *latest* version of the manual.
Yes, and that is all you need as the older manuals do not change (*).
(*) yes, in theory there could be corrections to the converted manual. Practically speaking, have you seen any
in the past 15 years ?
- These sources are available via a ZIP archive whose name contains no
version. In other words, its content may change with the same name,
breaking assumptions of downstream packagers.
I do not see why _existing_ manuals change would change ?
- Their history (> 2005) is also visible via a CVS web interface. The
current ZIP archive does not even match the Ada2012_Final tag of the
CVSWeb interface (even if ignoring new lines and casing problems).
- Formatting them requires either non-free tools, either a formatter
whose source are only available via the CVSWeb interface (no ZIP).
This interface handles casing and new lines poorly. Even finding the
right version of each source file is tricky.
I know, I did the Ada95 texi version. But again, the older manuals already exist and are not changing.
- Further processing tools like texinfo may be updated and transform
some warnings into errors. Patching is then not trivial, because
changes have indirect effects: formatter must be compiled, executed,
and its output processed by texinfo.
Yes, and when the pdf, html, info and other formats are no longer readable by the then current readers it would
be time to drop them. However there is no _need_ to rebuild them as again they are not changing.
[1] http://www.adaic.org/ada-resources/standards/.
[2] http://sources.debian.net/src/ada-reference-manual/1:2012.1-2/debian
gr.
Jerry.