emacs manuals: make docs (html) issue with the index.html output

[Jean-Christophe Helary]

I am not sure whether this is an emacs "make" issue or a texinfo issue so I am 
sending this report to the 2 lists.

When running "make docs" to produce the emacs manuals HTML sets with the 
following options:

HTML_OPTS = --split=chapter --html

There are issues with the ToC files and index files in

1) the elisp reference set
2) the lisp intro set

In both cases, the issue seems to be that the ToC is output as 
"index.html#SEC_Contents" and is then overwritten by the index which is output 
as "Index.html" (notice the change in case).

The navigation HTML reads:

[<a href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html" title="Index" 
rel="index">Index</a>]

In the [misc] section, the following manuals show the same faulty behavior:

- auth
- dbus
- ediff
- emacs-mime
- ert
- eudc
- flymake
- forms
- gnus
- htmlfontify
- info
- message
- newsticker
- rcirc
- reftex
- sasl
- semantic
- ses
- sieve
- smtpmail
- speedbar
- srecode
- widget
- wisent

In the case of the Emacs manual, the links work since Emacs uses 5 different 
index files that are accordingly named differently:

[<a href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Key-Index.html" title="Index" 
rel="index">Index</a>]

The org-mode manual too has 4 indexes and works fine:

[<a href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Main-Index.html" title="Index" 
rel="index">Index</a>]


It looks like (I have not checked for all the manuals) when a manual only has 1 
index it is output as Index.html and the ToC is output as index.html, but on 
case-insensitive systems (macOS) the files conflict and only the index is kept 
(presumably after overwriting the ToC).

Wouldn't it be more sensible to call the ToC just ToC.html so that it never 
conflicts with any concept index file?

-- 
Jean-Christophe Helary @brandelune
https://mac4translators.blogspot.com
https://sr.ht/~brandelune/omegat-as-a-book/