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?

Eli on the texinfo help mailing list replied to this with:

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.

Thanks,
Jon