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.bugs Subject: bug#48334: No elements in HTML manual pages Date: Sat, 02 Jul 2022 20:02:26 +0300 Message-ID: <83ilofbg7x.fsf@gnu.org> References: <476ffbc9-bd89-b9f1-9132-86b54ff8dded@gmail.com> <6f746a42-09eb-dffc-993f-a0ba3467aa08@gmail.com> <87sfnjxza7.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20245"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 48334@debbugs.gnu.org, m.a.nikulin@gmail.com To: Lars Ingebrigtsen <larsi@gnus.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jul 02 19:03:12 2022 Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org> Envelope-to: geb-bug-gnu-emacs@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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>) id 1o7gWV-00052g-VZ for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 02 Jul 2022 19:03:12 +0200 Original-Received: from localhost ([::1]:33024 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>) id 1o7gWU-0002hv-MK for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 02 Jul 2022 13:03:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44892) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1o7gWL-0002fo-U3 for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2022 13:03:01 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48875) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1o7gWL-0003Ky-LG for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2022 13:03:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1o7gWL-0006tO-I9 for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2022 13:03:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii <eliz@gnu.org> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org> Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Jul 2022 17:03:01 +0000 Resent-Message-ID: <handler.48334.B48334.165678136725975@debbugs.gnu.org> Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 48334 X-GNU-PR-Package: emacs Original-Received: via spool by 48334-submit@debbugs.gnu.org id=B48334.165678136725975 (code B ref 48334); Sat, 02 Jul 2022 17:03:01 +0000 Original-Received: (at 48334) by debbugs.gnu.org; 2 Jul 2022 17:02:47 +0000 Original-Received: from localhost ([127.0.0.1]:42766 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>) id 1o7gW6-0006kd-No for submit@debbugs.gnu.org; Sat, 02 Jul 2022 13:02:47 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:59860) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@gnu.org>) id 1o7gW3-0006fr-NF for 48334@debbugs.gnu.org; Sat, 02 Jul 2022 13:02:46 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:50672) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@gnu.org>) id 1o7gVy-0003HW-BJ; Sat, 02 Jul 2022 13:02:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=xYqeoCVKK/PypJsNo+W5cfLB96Jauq9PNRv6C+wGAMY=; b=DVbehgu6qew9 zIgtSajNYSGkQ2xm7YX4GRmPHOoD9ilinuqvDDchIrb1iVfWhBDEyP4GFm+bCMIxLng1YtzfvEPJy c1MFuImRpf0GkkhbnXZNYMivXFJemCedX/SeTLMZZjRjKIA96f3AbGpiBkYLVNCMJsaGwQy2B8XQu 0gj+gEmsjUXw3uqNwrOp7y/a/4akBI61Q8XXwkwI6wru5FfKq9N9i7FjyDqe5dSPj8tCyB3ivNPfK 8URcHI4XHAcV1NjzSdY68dY11IhOn8nk4tEWAlB5U7v4DHAC0Zf5Y8dOf/GPm9/swk8QFIMx2/H0U NLD+IGn3i0B3M/qe8+wvxw==; Original-Received: from [87.69.77.57] (port=1069 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@gnu.org>) id 1o7gVx-0004tZ-Qz; Sat, 02 Jul 2022 13:02:38 -0400 In-Reply-To: <87sfnjxza7.fsf@gnus.org> (message from Lars Ingebrigtsen on Sat, 02 Jul 2022 18:19:44 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org> List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>, <mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe> List-Archive: <https://lists.gnu.org/archive/html/bug-gnu-emacs> List-Post: <mailto:bug-gnu-emacs@gnu.org> List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help> List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>, <mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe> Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org> Xref: news.gmane.io gmane.emacs.bugs:235938 Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/235938> > Cc: 48334@debbugs.gnu.org > From: Lars Ingebrigtsen <larsi@gnus.org> > Date: Sat, 02 Jul 2022 18:19:44 +0200 > > Maxim Nikulin <m.a.nikulin@gmail.com> writes: > > >> HTML pages of Emacs manual, e.g. > >> https://www.gnu.org/software/emacs/manual/html_node/elisp/Motion.html > >> do not have <title> element. > > ... > >> Texinfo manual is not affected, its pages contains reasonable > >> <title>, e.g. > >> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Generating-HTML.html > > > > Emacs manual is generated by texi2html, texinfo and e.g. Org mode by > > makeinfo --html ... > > In the latter case pages have <title> element, in the former they do > > not (at least without some tuning). > > (I'm going through old bug reports that unfortunately weren't resolved > at the time.) > > These manuals still seem to be missing <title>s. And texi2html has been > superseded by texi2any, which should be adding <title> elements > according to: > > https://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Customization-Variables.html > > Anybody know who's responsible for generating the HTML manuals? We are. See the instructions in admin/make-tarball.txt and the scripts admin/make-manuals and admin/upload-manuals. I don't remember if texi2any produces <title>, but the above scripts modify the HTML produced by texi2any, so what we eventually have is the result of those scripts. We could decide dropping admin/make-manuals, or at least the parts that modify the produced HTML, but presumably those parts were written for a reason. Unfortunately, I see no detailed documentation of the reasons for those changes, so it's hard to decide whether any of them are still valid, what with Texinfo's progress since the time those changes were coded.