Re: XML XInclude support

Daniel Jacobowitz
2007-02-07T18:37:05Z

On Wed, Feb 07, 2007 at 08:15:59PM +0200, Eli Zaretskii wrote:
> "d:" is wrong because when you use it to construct a file name, you
> will get "d:/bar", which is generally not in the same directory as
> "d:foo".
>
> What you need is to produce "d:." from "d:foo", not "d:".

Thank you for explaining! I've added this, and some notes so that
I can remember why.

On Wed, Feb 07, 2007 at 08:20:13PM +0200, Eli Zaretskii wrote:
> > But the colon is a syntactic element here, and this is what
> > I would look for. Plus it works in the PDF, or in print. What do you
> > think - should I leave the somewhat broken @cindex, since it's more
> > useful than not?
>
> I think you can condition it on the output format, like so:
>
> @ifnotinfo
> @cindex <xi:include>
> @end ifnotinfo

Thanks - I'll use that.

> Btw, isn't it better to use "@cindex xi:include", without the
> brackets? If I were looking for this, I'd probably omitted the
> brackets; wouldn't you?

For this case, I've added xi:include too, since that's reasonable with
or without the brackets. But in general, no, I wouldn't. Especially
not since "reg" and "architecture" are very ambiguous index entries,
but "<reg>" and "<architecture>" are quite clear. So I didn't
add a matching @cindex reg.