Re: Ada Reference Manual 2012 in info format

[Oliver Kleinke <oliver.kleinke@c-01a.de>]

Am Wed, 9 May 2012 20:54:32 -0500
schrieb "Randy Brukardt" <randy@rrsoftware.com>:

> "Oliver Kleinke" <oliver.kleinke@c-01a.de> wrote in message 
> news:20120509131736.63c924c8@vostro...
> >...
> > Honestly, you should consider converting the sources to a more
> > appropriate format.
> 
> The sources are still in the original Scribe format used by Jean
> Ichbiah's team back in the 1970s. Some sort of conversion (without
> losing any information) would be pretty expensive, even if it could
> be automated. (Preserving the comments in the files would be hard,
> for instance, as the formatter discards them immediately.)

I concur; however, it might still be worth it in the long run. Maybe it
would suffice to progressively make adjustments to the current format,
for example converting some of the style-markup into semantic-markup
(bold to keyword where it is appropriate, &c.)

> ...
> > Also, the
> > way the Formatter sources are provided sucks major -- cvsweb, you
> > have to click around a lot until you have a complete set of files
> > plus some of the HEAD versions have been broken.
> 
> There is are ZIP files with the complete set of sources, both to the
> tools and the RM (Scribe-like) source. But I think the links
> disappeared, because I can't find them. (Something else for the todo
> list.)

I did not find any of ZIP files, if I overlooked them it was of course
my mistake and I shall withdraw my accusations.

> Not sure what you mean by the "HEAD versions have been broken",
> because this is a frequently updated copy of the repository on my
> computer, and I'm pretty sure there is no broken source on my
> computer. :-) If you have any examples, I'll look into them.

With broken I meant inconsistencies. I'll tip you off if I encounter
that problem again ;-)


Oliver