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: Zack Weinberg <zack at codesourcery dot com>
- To: Florian Weimer <fw at deneb dot enyo dot de>
- Cc: Hans-Peter Nilsson <hp at bitrange dot com>,"Joseph S. Myers" <jsm28 at cam dot ac dot uk>, gcc-bugs at gcc dot gnu dot org,brosgol at gnat dot com
- Date: Sun, 10 Mar 2002 10:22:34 -0800
- Subject: Re: ada/5907: The Ada front end lacks a proper manual
- References: <Pine.BSF.4.30.0203100922340.25050-100000@dair.pair.com> <87r8msjx1b.fsf@deneb.enyo.de>
On Sun, Mar 10, 2002 at 03:51:44PM +0100, Florian Weimer wrote:
> Hans-Peter Nilsson <hp@bitrange.com> writes:
>
> > Can't you make @file{} or an equivalent do that transformation?
> > If the docs are as other doc files in the tree, it would already
> > use @file{} around file names.
>
> I don't think you can express the transformation in terms of Texinfo
> macros (no problem for TeX, but we won't get info files this way).
There isn't any technical difficulty, in principle, with generating
.texi files at build time. In fact, the Fortran front end does this
already. (see f/intdoc.*)
If I remember correctly from the last time this came up, the problem
is that the transforming program is written in an exotic language
(SNOBOL?) and therefore can't be run on most people's systems. If so,
I encourage you to check everything into CVS anyway, right now, but
comment out the relevant Makefile rules. The documentation will then
be available in some form for people to read; we can proceed
immediately to address concerns about the content; and other people
may be motivated to help fix the build problems.
zw