From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: HTML info Date: Sun, 26 Dec 2021 12:20:54 +0200 Message-ID: <83k0frpszd.fsf@gnu.org> References: <87zgosdbo1.fsf@gnus.org> <86mtkszhnq.fsf@mail.linkov.net> <87o858e5r2.fsf@gnu.org> <86fsqjcqd8.fsf@mail.linkov.net> <87zgor41oc.fsf@gnus.org> <86lf0b6uf0.fsf@mail.linkov.net> <87v8zf40qw.fsf@gnus.org> <8635mj5ept.fsf@mail.linkov.net> <83pmpnt7s5.fsf@gnu.org> <83ilvft6ru.fsf@gnu.org> <91625EFE-6771-4C17-B388-A0E3DBC3A9E6@gmail.com> <86mtkqjtq5.fsf@mail.linkov.net> <864k6wo97k.fsf@mail.linkov.net> <4CE3CBAC-752F-4359-85CE-841E4654E3A5@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3719"; mail-complaints-to="usenet@ciao.gmane.io" Cc: tsdh@gnu.org, larsi@gnus.org, emacs-devel@gnu.org, monnier@iro.umontreal.ca, juri@linkov.net To: Yuan Fu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Dec 26 11:21:39 2021 Return-path: Envelope-to: ged-emacs-devel@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 1n1Qeo-0000n0-Oo for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Dec 2021 11:21:38 +0100 Original-Received: from localhost ([::1]:34352 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n1Qen-0003Mk-Mu for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Dec 2021 05:21:37 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:39574) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n1Qdt-0002aR-KW for emacs-devel@gnu.org; Sun, 26 Dec 2021 05:20:41 -0500 Original-Received: from [2001:470:142:3::e] (port=49652 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n1Qds-000476-KD; Sun, 26 Dec 2021 05:20:40 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=nqXqjHUegbrII9KEdNpsm1Jo/lNSMUgf4l4qvxKy76w=; b=XrkJDPC/huDDSZEKAjbz zDQgMGkregLNrASpzwJGYQRHqGm7leDfyfIZV7VQvQA5vPkfu9ceA828hSrUWwIwaPBI8YFEjvLsl dJSR8DtscKfJV6Q605ebLlAVUDYzO6ps4wibPOpwmWLch757LbLBmw5UjzUS6AyBm3KDbtwY/blYh zHkfYnVBvjXOG31xePvuqx8kmymffCnk6W1kvEwyIYHG8jvB4on/VFOWYg1nJPKT3IA21N/Q5OBlg Hm7OmtcJ3heqjGhoczPOeVzKrqFPYTPF+jLX8gBDnkCte8J/i2IC8hWjm4xtQ8Zwuq3QsuXfN1Kah 9gArLQP+3fPspg==; Original-Received: from [87.69.77.57] (port=4330 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n1Qds-0000dg-Ed; Sun, 26 Dec 2021 05:20:40 -0500 In-Reply-To: <4CE3CBAC-752F-4359-85CE-841E4654E3A5@gmail.com> (message from Yuan Fu on Sun, 26 Dec 2021 01:50:50 -0800) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:283275 Archived-At: > From: Yuan Fu > Date: Sun, 26 Dec 2021 01:50:50 -0800 > Cc: Lars Ingebrigtsen , > Eli Zaretskii , > emacs-devel@gnu.org, > Stefan Monnier , > tsdh@gnu.org > > One thing I noticed is that the HTML Info files lack a nice top level menu. The HTML Top only has a (very) long TOC and a short TOC. The TOC's only include the node name and leave out the short description. > > I’m on a Mac which is case-insensitive, and my texinfo still have the bug where it drops index.html when merging Index.html and index.html. So I can’t test multi-file manual’s Top node (it’s in index.html). Besides that, single-file and multi-file seem to both work fine. These (and some others) all are basic issues that should be addressed by the Texinfo project, not by us. Emacs cannot tell other GNU projects how to produce their HTML docs, and we definitely cannot provide the missing top-level menus and the corresponding install-info capabilities of updating that menu when new manuals are installed. I've written a message to the Texinfo list about this today, see https://lists.gnu.org/archive/html/bug-texinfo/2021-12/msg00150.html We could work on the HTNL-doc viewing capabilities for Emacs, but we cannot complete our work before the problems I mentioned there (and probably others as well) are fixed, or at least we know how they will be fixed. Thanks.