makeinfo --html doesn't split properly if a node is named index

makeinfo --html doesn't split properly if a node is named index

[Jon Beniston]

Hi,

I'm using makeinfo to try to build html docs for newlib C library.

When using --no-split, the html file seems to be correctly generated. 

When using any of the split options (--split=chapter|node|section or
--split-size=5000000), the output is corrupted. In the index.html file, what
should be one of the sub-nodes, appears at the top, and many of the
navigation footers on random pages are missing.

I suspect this relates to the node name "index" being used. The node names
are generated based on C function names, and there is an index function.
Changing this name to something else, seems to fix the problem. However, all
of the other doc formats (info/pdf etc) seem ok.

Is this an issue with makeinfo --html, or should "@node index" not be used
in the newlib tex files?

Cheers,
Jon

Re: [help-texinfo] makeinfo --html doesn't split properly if a node is named index

[Eli Zaretskii]

> From: "Jon Beniston" <jon@beniston.com>
> Date: Fri, 17 Oct 2014 12:19:14 +0100
> 
> When using any of the split options (--split=chapter|node|section or
> --split-size=5000000), the output is corrupted. In the index.html file, what
> should be one of the sub-nodes, appears at the top, and many of the
> navigation footers on random pages are missing.
> 
> I suspect this relates to the node name "index" being used. The node names
> are generated based on C function names, and there is an index function.
> Changing this name to something else, seems to fix the problem. However, all
> of the other doc formats (info/pdf etc) seem ok.
> 
> Is this an issue with makeinfo --html, or should "@node index" not be used
> in the newlib tex files?

Long time ago, when the split-HTML options were implemented in
makeinfo, the design was that if several nodes map to the same file
name, they all appear in the file by that name, one after the other,
but the URLs that point to each node on that file have a #node-name
appended to them, so that the links still work correctly.

Since then makeinfo was reimplemented in Perl, and it's possible that
this feature has a bug of some sort.  I suggest to post this to
bug-texinfo list, where the maintainers will see it and act on it.