unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Gavin Smith <gavinsmith0123@gmail.com>
To: Jean-Christophe Helary <lists@traduction-libre.org>
Cc: Texinfo <bug-texinfo@gnu.org>, emacs-devel <emacs-devel@gnu.org>
Subject: Re: emacs manuals: make docs (html) issue with the index.html output
Date: Tue, 21 Dec 2021 19:00:38 +0000	[thread overview]
Message-ID: <20211221190038.GG9514@mintstar> (raw)
In-Reply-To: <4A61041F-432D-4BC4-BCC1-145CD72B4B74@traduction-libre.org>

On Tue, Oct 19, 2021 at 08:30:59PM +0900, Jean-Christophe Helary wrote:
> >> 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>]
> > 
> > Can you link to an online manual where the problem occurs as I couldn't find
> > one (I checked three of the emacs manuals before giving up).
> 
> https://doublet.jp/gnu/
> 
> https://doublet.jp/gnu/elisp/elisp.html/index.html
> 
> https://doublet.jp/gnu/lispintro/emacs-lisp-intro.html/index.html
> 
> >> 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).
> > 
> > Have you actually tested this on macOS?
> 
> Yes. That's my machine.

I'm trying to catch up with Texinfo mail.

I saw the problem with the Top node not being present in the links you sent above.

There appears to be code to check a CASE_INSENSITIVE_FILENAMES configuration
value in Texinfo/Common.pm, now in set_tree_unit_file.  Could you try
building your manuals with texi2any -c CASE_INSENSITIVE_FILENAMES=1 and see
if that makes a difference?



  reply	other threads:[~2021-12-21 19:00 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
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 [this message]
2021-12-22  7:19       ` Jean-Christophe Helary
2021-10-19 12:02 ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20211221190038.GG9514@mintstar \
    --to=gavinsmith0123@gmail.com \
    --cc=bug-texinfo@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=lists@traduction-libre.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).