Date: Thu, 12 Feb 1998 12:01:52 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: DJ Delorie <dj AT delorie DOT com>
cc: djgpp-workers AT delorie DOT com
Subject: Re: Suggestion: Portability section for libc docs
In-Reply-To: <199802120156.UAA17898@delorie.com>
Message-ID: <Pine.SUN.3.91.980212120129.19556E-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk


On Wed, 11 Feb 1998, DJ Delorie wrote:

> Since we parse the txi files anyway, we can use macros to denote
> compatibility and turn them into texinfo when we run mkdoc.

If `mkdoc' will eliminate these @compat macros entirely, then okay.
Otherwise, I'd advise against using macros, since they can bite you if
you want to generate a printed version of the docs.  texinfo.tex
ignores the macros (they cannot be supported by TeX), so you will need
to feed TeX with macro-expanded sources, and that doesn't work very
well (it's a long story).

An alternative would be to use the @multitable tag, first introduced
with Texinfo 3.9, to create compatibility tables.

> How about by source directory instead?  That's easier to work with in
> the source tree, which is where the txi files are.

I think this is indeed easier than the alphabetical order.