From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.comp.tex.texinfo.bugs,gmane.emacs.devel Subject: emacs manuals: make docs (html) issue with the index.html output Date: Tue, 19 Oct 2021 15:31:28 +0900 Message-ID: Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40956"; mail-complaints-to="usenet@ciao.gmane.io" To: emacs-devel , Texinfo Original-X-From: bug-texinfo-bounces+gnu-bug-texinfo2=m.gmane-mx.org@gnu.org Tue Oct 19 08:31:54 2021 Return-path: Envelope-to: gnu-bug-texinfo2@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mcifC-000AVh-8m for gnu-bug-texinfo2@m.gmane-mx.org; Tue, 19 Oct 2021 08:31:54 +0200 Original-Received: from localhost ([::1]:44944 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mcifA-0007M4-Q5 for gnu-bug-texinfo2@m.gmane-mx.org; Tue, 19 Oct 2021 02:31:52 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44010) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mcif1-0007LJ-NY; Tue, 19 Oct 2021 02:31:45 -0400 Original-Received: from relay7-d.mail.gandi.net ([217.70.183.200]:46253) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mciev-00042y-IO; Tue, 19 Oct 2021 02:31:43 -0400 Original-Received: (Authenticated sender: lists@traduction-libre.org) by relay7-d.mail.gandi.net (Postfix) with ESMTPSA id 71A532000E; Tue, 19 Oct 2021 06:31:30 +0000 (UTC) X-Mailer: Apple Mail (2.3654.120.0.1.13) Received-SPF: pass client-ip=217.70.183.200; envelope-from=lists@traduction-libre.org; helo=relay7-d.mail.gandi.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: bug-texinfo@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Bug reports for the GNU Texinfo documentation system List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-texinfo-bounces+gnu-bug-texinfo2=m.gmane-mx.org@gnu.org Original-Sender: "bug-texinfo" Xref: news.gmane.io gmane.comp.tex.texinfo.bugs:10832 gmane.emacs.devel:277337 Archived-At: 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 =3D --split=3Dchapter --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: [Contents][Index] 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: [Contents][Index] The org-mode manual too has 4 indexes and works fine: [Contents][Index] 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? --=20 Jean-Christophe Helary @brandelune https://mac4translators.blogspot.com https://sr.ht/~brandelune/omegat-as-a-book/