ada/5907: The Ada front end lacks a proper manual

[Florian Weimer]

"Joseph S. Myers" <jsm28@cam.ac.uk> writes:

> On Sun, 10 Mar 2002, Florian Weimer wrote:
>
>> We would need a couple of hundered macros, I think.  For example, the
>> preprocessing rewrites all strings like "hello.adb" to "HELLO.ADB",
>> "hello.o" to "HELLO.OBJ", and so on.  If you had to write
>> "@helloadb{}" and "@helloo{}", reading the sources would become rather
>> difficult.
>
> Define a macro that's used like @vmsfile{hello.adb}{HELLO.ADB}.

This still reduces readability to a certain extent.  In addition,
there are about 100 command names and options which have to be
replaced in the VMS version.  Of course, you could use the macro
approach for this one, too, but we decided not to do that.

Anyway, when I've finished writing the preprocessor, I can tweak it so
that it writes a macroized Texinfo version, and we can still decide if
we want to use this one, or the keep the preprocessor.