From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Gavin Smith Newsgroups: gmane.comp.tex.texinfo.bugs,gmane.emacs.devel Subject: Re: emacs manuals: make docs (html) issue with the index.html output Date: Tue, 19 Oct 2021 11:36:01 +0100 Message-ID: <20211019103601.GB17522@mintstar> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30907"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mutt/1.9.4 (2018-02-28) Cc: Texinfo , emacs-devel To: Jean-Christophe Helary Original-X-From: bug-texinfo-bounces+gnu-bug-texinfo2=m.gmane-mx.org@gnu.org Tue Oct 19 12:36:21 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 1mcmTl-0007uB-Ds for gnu-bug-texinfo2@m.gmane-mx.org; Tue, 19 Oct 2021 12:36:21 +0200 Original-Received: from localhost ([::1]:52332 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mcmTk-0000oo-DG for gnu-bug-texinfo2@m.gmane-mx.org; Tue, 19 Oct 2021 06:36:20 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40754) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mcmTa-0000nA-2X; Tue, 19 Oct 2021 06:36:10 -0400 Original-Received: from mail-wm1-x32b.google.com ([2a00:1450:4864:20::32b]:38773) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mcmTW-0004zB-Ka; Tue, 19 Oct 2021 06:36:09 -0400 Original-Received: by mail-wm1-x32b.google.com with SMTP id y74-20020a1c7d4d000000b00322f53b9bbfso2164407wmc.3; Tue, 19 Oct 2021 03:36:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:date:to:cc:subject:message-id:mail-followup-to:references :mime-version:content-disposition:in-reply-to:user-agent; bh=o3/BpoiQfN5RU1yIigRYzQxdX7c79XHTkS1SQSbXSTU=; b=KBXf/aVcCDsk5qFs/zfKhbXsyljod4vTcvPJddudmOG+oSsunQEt8l7JJX1fLkduMc hrnxtWJG3lbbBpnPktVCfaJCrtLm5l62dK57krlB9Ke2KfRmX/n8xQvSW8bOsbgrsVB9 lZ/UPbjHE4BZzK/cAUKv6x6q5BUafglPRg8QeGlVCuV/hc5wn7YlbP4dPMvSFOQDExnn ljmoeUX/KndeWWYs3B1sJjHi4iKPkbxTNYuHf/nZjFoISGa+mA3BDIO0pqvi/ySg1Y50 TpXkY+DZ2blmRupQNMPOC/dWof/OuNfxcbh1PnRBbbglKp+uQVg90Jokvh26OVmzjNrY yQ0A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:date:to:cc:subject:message-id :mail-followup-to:references:mime-version:content-disposition :in-reply-to:user-agent; bh=o3/BpoiQfN5RU1yIigRYzQxdX7c79XHTkS1SQSbXSTU=; b=jWODRlbEGsiFTm13yAsuUOKf3LUs5jtYQMW+PaLcEgEiqtW55zsU/4hf+dQIBsE8uX LLIoUHSgriuaWs6fExbqMqyX0H69eFFRL2/lvHRGWmdPMHzbvPibO+95lEcC7BjaLC18 8rBf405++fgYKbrqtcuiS7vx5iBYQtvtm+6nknkXS9P29SbIqg2HSDrHYZo2wQIsO/Ay VfiYhfnB29OKHwlg7c2Zp9XzbOYb6DKknl8VVk1T8W042cf/VcMnlnyNi6+4BR7gi8Tb XD+MqcZmg7Qjla21C4H3nST/aI+rrok8lJ2DRqOWSeH1fWB9mHiK48jmljoU79DGiyMg Q4MA== X-Gm-Message-State: AOAM530rW+/rfUF7zgIRs3ITB+hGw7SpyoMay/lqDjuveefm6eQyNcFx hcMXxzW2ZLuLD4KP94JtAz5UhBMLozA= X-Google-Smtp-Source: ABdhPJw8GcWGonvTCGZKwhbfTpMucs870xm1E8qby30FPO9jXFTYmCghMbLmMarUCZGoVu4BF9Myog== X-Received: by 2002:a7b:c0d6:: with SMTP id s22mr5206789wmh.135.1634639764542; Tue, 19 Oct 2021 03:36:04 -0700 (PDT) Original-Received: from mintstar.lan (7.96.90.146.dyn.plus.net. [146.90.96.7]) by smtp.gmail.com with ESMTPSA id v18sm16427031wrm.63.2021.10.19.03.36.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Oct 2021 03:36:04 -0700 (PDT) X-Google-Original-From: Gavin Smith Original-Received: by mintstar.lan (Postfix, from userid 1000) id 3BFEFB4022F; Tue, 19 Oct 2021 11:36:02 +0100 (BST) Mail-Followup-To: Gavin Smith , Jean-Christophe Helary , emacs-devel , Texinfo Content-Disposition: inline In-Reply-To: Received-SPF: pass client-ip=2a00:1450:4864:20::32b; envelope-from=gavinsmith0123@gmail.com; helo=mail-wm1-x32b.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:10835 gmane.emacs.devel:277345 Archived-At: On Tue, Oct 19, 2021 at 03:31:28PM +0900, Jean-Christophe Helary wrote: > 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: > > [Contents][Index] 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). > 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? I haven't but I remember there was code in texi2any to deal with this exact eventuality. I haven't but I remember there was code in texi2any to deal with this exact eventuality. If there was a node called "index" then it would be output at the bottom of index.html. > Wouldn't it be more sensible to call the ToC just ToC.html so that it never conflicts with any concept index file? For HTTP, index.html is a special name that is the file returned if no filename component was present in the URL.