all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* emacs manuals: make docs (html) issue with the index.html output
@ 2021-10-19  6:31 Jean-Christophe Helary
  2021-10-19 10:36 ` Gavin Smith
  2021-10-19 12:02 ` Eli Zaretskii
  0 siblings, 2 replies; 6+ messages in thread
From: Jean-Christophe Helary @ 2021-10-19  6:31 UTC (permalink / raw)
  To: emacs-devel, Texinfo

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/




^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2021-12-22  7:19 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-10-19  6:31 emacs manuals: make docs (html) issue with the index.html output Jean-Christophe Helary
2021-10-19 10:36 ` Gavin Smith
2021-10-19 11:30   ` Jean-Christophe Helary
2021-12-21 19:00     ` Gavin Smith
2021-12-22  7:19       ` Jean-Christophe Helary
2021-10-19 12:02 ` Eli Zaretskii

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.