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: Sun, 03 Jul 2022 16:13:20 +0300 Message-ID: <83o7y69w5r.fsf@gnu.org> References: <476ffbc9-bd89-b9f1-9132-86b54ff8dded@gmail.com> <6f746a42-09eb-dffc-993f-a0ba3467aa08@gmail.com> <87sfnjxza7.fsf@gnus.org> <83ilofbg7x.fsf@gnu.org> <87fsjibdd0.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23072"; 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 Sun Jul 03 15:14:11 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 1o7zQR-0005mv-FX for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 03 Jul 2022 15:14:11 +0200 Original-Received: from localhost ([::1]:48526 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 1o7zQP-000854-KL for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 03 Jul 2022 09:14:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44928) 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 1o7zQI-00084K-HC for bug-gnu-emacs@gnu.org; Sun, 03 Jul 2022 09:14:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49711) 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 1o7zQI-0006fG-8n for bug-gnu-emacs@gnu.org; Sun, 03 Jul 2022 09:14:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1o7zQH-0007ET-Vt for bug-gnu-emacs@gnu.org; Sun, 03 Jul 2022 09:14: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: Sun, 03 Jul 2022 13:14:01 +0000 Resent-Message-ID: <handler.48334.B48334.165685402227768@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.165685402227768 (code B ref 48334); Sun, 03 Jul 2022 13:14:01 +0000 Original-Received: (at 48334) by debbugs.gnu.org; 3 Jul 2022 13:13:42 +0000 Original-Received: from localhost ([127.0.0.1]:43608 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>) id 1o7zPx-0007Do-L2 for submit@debbugs.gnu.org; Sun, 03 Jul 2022 09:13:42 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:59956) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@gnu.org>) id 1o7zPu-0007DY-2G for 48334@debbugs.gnu.org; Sun, 03 Jul 2022 09:13:40 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37620) 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 1o7zPo-0006YW-PW; Sun, 03 Jul 2022 09:13:32 -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=N/dSFV0FqYM8/0vS8PZTg9QWnvLWveLOmCfGjKVLaPg=; b=SOSNUciXAEKX SmsD5Kj3cXO5zYDedJPG+FXUybkGNwXOTl8xLYSaSKMpaXEBm0f0e284y5LgfUJlLcAxOCAiClL3L L4gaiDLty70yz4ppOr9/hH/UPCgVfDzb9h3WgIdNkxo+gLNT2LyBXIS31GNSttY4hlwfU+lbHaSuj nMmce/59AwkGdAxfUI2Juk+az9BDL9mpsxLvegkxfzLxSWFDDr0TovbqOv/adHoqDdFqt5GuAN+Q6 N4Co+AeNOrRh50bMDjFzGzmEBscmdbs9wQCEcsTQA9bGAPHEguSvhEcvYXKBmDgFns0monlKHxkWe s3bTK8e+JimDoNf1XqUCAg==; Original-Received: from [87.69.77.57] (port=3684 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 1o7zPo-0005Lh-4L; Sun, 03 Jul 2022 09:13:32 -0400 In-Reply-To: <87fsjibdd0.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 03 Jul 2022 14:16:27 +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:235995 Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/235995> > From: Lars Ingebrigtsen <larsi@gnus.org> > Cc: m.a.nikulin@gmail.com, 48334@debbugs.gnu.org > Date: Sun, 03 Jul 2022 14:16:27 +0200 > > Eli Zaretskii <eliz@gnu.org> writes: > > > 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. > > Hm... it looks like the manuals are produced with "makeinfo --html", > though -- I can't see any usage of texi2html or texi2any there, but I > may be missing something. makeinfo is supposed to be a symlink to texi2any. > Ah, it's this code: > > (defun manual-html-fix-headers () > "Fix up HTML headers for the Emacs manual in the current buffer." > (let ((texi5 (search-forward "<!DOCTYPE" nil t)) > opoint) > > [...] > > (search-forward "<meta") > (setq opoint (match-beginning 0)) > (unless texi5 > (search-forward "<!--") > (goto-char (match-beginning 0)) > (delete-region opoint (point)) > (search-forward "<meta http-equiv=\"Content-Style") > (setq opoint (match-beginning 0))) > (search-forward "\n") > (delete-region opoint (point)) Yes. (But that's not the only editing we do, although the rest isn't relevant to , I think.) > So we delete the <title> that makeinfo --html has created. Perhaps > that's just a bug? It is definitely done on purpose, but I don't know what is the purpose of deleting <title> (and many other parts of the headers as well). > I see that you adjusted this code in May... I made changes there because someone reported a problem with reading the manuals on mobile devices, because we were deleting the line with '<meta name="viewport"...', which in latest Texinfo takes care of adjusting the viewport to the width of the device display. My changes were supposed to avoid deletion of this header (and a few others), but I don't think I kept <title>. I think the solution to this is for some HTML5 expert to look at our edits vs what Texinfo 6.8 produces, and tell which parts of the editing are needed (and why) and which aren't. I'm far from being that expert. Failing that, I think the only alternative is to see how the original Texinfo output looks in a browser, compare that with the edited manuals, and then decide which of the edits are really needed. One problem with that is that we'll probably have to require Texinfo 6.8 or later if we go that way, because maintaining compatibility with multiple Texinfo versions is really too much. Ideally, we should keep the edits to the absolute minimum.