Re: Ada Reference Manual 2012 in info format

["Randy Brukardt" <randy@rrsoftware.com>]

"Oliver Kleinke" <oliver.kleinke@c-01a.de> wrote in message 
news:20120511043604.344c13a8@vostro...
> 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.)

The original sources were somewhat inconsistent about this. I try to use the 
semantic markup whenever possible (@key, @nt, @syni, @examcom, etc. --  
keyword, non-terminal, syntax italics [the prefixes to syntax terms, like 
@SynI<exception_>@nt<name>], and example comment respectively) but I 
probably forget from time-to-time like any human. And there probably are a 
few others that could have been defined.

>> ...
>> 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.

I didn't find them, either, which is weird because my batch files make them 
every time I post a new version of the Standard. Not sure why links to them 
never got added to the web site. I've added that to me "todo" list.

                                 Randy.


>> 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
>