This is the mail archive of the
gcc-bugs@gcc.gnu.org
mailing list for the GCC project.
Re: ada/5907: The Ada front end lacks a proper manual
- From: Florian Weimer <fw at deneb dot enyo dot de>
- To: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Cc: <gcc-gnats at gcc dot gnu dot org>, <gcc-bugs at gcc dot gnu dot org>, brosgol at gnat dot com
- Date: Sun, 10 Mar 2002 12:34:50 +0100
- Subject: Re: ada/5907: The Ada front end lacks a proper manual
- References: <Pine.LNX.4.33.0203101103040.27852-100000@kern.srcf.societies.cam.ac.uk>
"Joseph S. Myers" <jsm28@cam.ac.uk> writes:
> On 10 Mar 2002 fw@deneb.enyo.de wrote:
>
>> Add the User Guide to the tree. Florian Weimer is working on an Ada
>> version of the preprocessor which is required to generate proper
>> Texinfo files.
>
> It is desirable if possible that preprocessing is done within Texinfo (via
> Texinfo manuals).
The VMS version requires substantial postprocessing (words are
replaced globally, file names are rewritten). It is not possible to
express this in Texinfo.
I think it would be possible to change the manual so that you can
build all the other version straight from the Texinfo sources,
but this might reduce maintainability. There would be two rather
different ways to build the manual, the Texinfo markup would be a
bit clumsy, and the TeX implementation of Texinfo doesn't handle
extensive use of conditional processing and macros very well. On the
other hand, having the generated sources in CVS is ugly and prone to
problems.
Ben, what do you think?