From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10118 invoked by alias); 10 Mar 2002 11:36:04 -0000 Mailing-List: contact gcc-prs-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Archive: List-Post: List-Help: Sender: gcc-prs-owner@gcc.gnu.org Received: (qmail 10096 invoked by uid 71); 10 Mar 2002 11:36:02 -0000 Date: Sun, 10 Mar 2002 03:36:00 -0000 Message-ID: <20020310113602.10093.qmail@sources.redhat.com> To: nobody@gcc.gnu.org Cc: gcc-prs@gcc.gnu.org, From: Florian Weimer Subject: Re: ada/5907: The Ada front end lacks a proper manual Reply-To: Florian Weimer X-SW-Source: 2002-03/txt/msg00312.txt.bz2 List-Id: The following reply was made to PR ada/5907; it has been noted by GNATS. From: Florian Weimer To: "Joseph S. Myers" Cc: , , brosgol@gnat.com Subject: Re: ada/5907: The Ada front end lacks a proper manual Date: Sun, 10 Mar 2002 12:34:50 +0100 "Joseph S. Myers" 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?