Re: XML XInclude support

[Daniel Jacobowitz <drow@false.org>]

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.

-- 
Daniel Jacobowitz
CodeSourcery