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#49719: 27.2; make-manuals fails Date: Mon, 04 Apr 2022 20:44:54 +0300 Message-ID: <83pmlweoa1.fsf@gnu.org> References: <83r1foypcq.fsf@gnu.org> <87o8ar1xeb.fsf@gnus.org> <83tukjy80s.fsf@gnu.org> 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="16961"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 49719@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Apr 04 19:45:53 2022 Return-path: 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 ) id 1nbQm0-0004DD-62 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 04 Apr 2022 19:45:52 +0200 Original-Received: from localhost ([::1]:36258 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nbQly-0002Q9-Ga for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 04 Apr 2022 13:45:50 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39006) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbQlE-0002Oy-CL for bug-gnu-emacs@gnu.org; Mon, 04 Apr 2022 13:45:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58961) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nbQlC-0001Xg-Cr for bug-gnu-emacs@gnu.org; Mon, 04 Apr 2022 13:45:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nbQlC-0007aO-4Q for bug-gnu-emacs@gnu.org; Mon, 04 Apr 2022 13:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 04 Apr 2022 17:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 49719 X-GNU-PR-Package: emacs Original-Received: via spool by 49719-submit@debbugs.gnu.org id=B49719.164909430129136 (code B ref 49719); Mon, 04 Apr 2022 17:45:02 +0000 Original-Received: (at 49719) by debbugs.gnu.org; 4 Apr 2022 17:45:01 +0000 Original-Received: from localhost ([127.0.0.1]:52858 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQlA-0007Zs-Lb for submit@debbugs.gnu.org; Mon, 04 Apr 2022 13:45:00 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:47716) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQl8-0007ZS-UK for 49719@debbugs.gnu.org; Mon, 04 Apr 2022 13:44:59 -0400 Original-Received: from [2001:470:142:3::e] (port=37376 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 1nbQl3-0001WF-IN; Mon, 04 Apr 2022 13:44:53 -0400 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=dfWLlmXH+vaKiYxeqZeSontUpwBL4pPT5b1BkxGDVX0=; b=eDul17AnbAZFEywjuzwI eLR5xdAbodxmgJwG2oHGQwoQMrDFn3dNLsM9dbYd2HgqKJNqfJrx6kzsjgU1GwgVI5xM6qD9UsJAA BzGUNguk8Cx/whHombjdx7N1biumw+BAsiD4b/sHJG/BuS7WFsiO77KVpUf3/EBpTcvLDl+QwHXXD pLTdJbuoH6BVAG4TwyLyU0VAR2CmwBaWQxVuNz3Ekb9kDxw383u2nd56myFzyxHUXWLgHlyLBx7HG ihJffbTj3EY0KCRCov8xesEXGlqSc0CsoTkD0BvMO0BOhL14FaeuGNigTVB3IWWFq4LdeACD5vbL7 ZrhUpBGcWQ1d9g==; Original-Received: from [87.69.77.57] (port=1210 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 1nbQl2-0004Dg-Pc; Mon, 04 Apr 2022 13:44:53 -0400 In-Reply-To: <83tukjy80s.fsf@gnu.org> (message from Eli Zaretskii on Sat, 24 Jul 2021 19:46:27 +0300) 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" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:229419 Archived-At: > Date: Sat, 24 Jul 2021 19:46:27 +0300 > From: Eli Zaretskii > Cc: 49719@debbugs.gnu.org > > > From: Lars Ingebrigtsen > > Cc: 49719@debbugs.gnu.org > > Date: Sat, 24 Jul 2021 18:37:00 +0200 > > > > [larsi@stories ~/src/emacs/emacs-27]$ ./admin/make-manuals > > Making manuals (slow)... > > Adding compressed html files... > > Making manual tarfiles... > > Doing emacs... > > ...created emacs-manual-27.2.50.tar > > Doing lispref... > > ...created emacs-lispref-27.2.50.tar > > Doing lispintro... > > ...created emacs-lispintro-27.2.50.tar > > Doing misc... > > ...created emacs-misc-27.2.50.tar > > Making refcards... > > > > But this is with an older makeinfo: > > > > [larsi@stories ~/src/emacs/emacs-27]$ makeinfo --version > > texi2any (GNU texinfo) 6.7 > > Yes, with that version it worked for me as well, back when I updated > the manuals for the v27.2 release. Nine months later, the script (admin/make-manuals) still doesn't work with the latest Texinfo. The end result is that right now, I'm unable to update the Emacs on-line docs to the version that was released with Emacs 28.1. (And no, I don't want to downgrade my Texinfo just to do that.) I looked at the code in admin.el, and it seems to be trying to make the produced HTML more pretty than what Texinfo produces. While I'm not objected to having prettier HTML manuals, this is not really our job, and playing catch-up with the ever-changing HTML that comes from Texinfo is a maintenance burden. Moreover, the documentation of the various "fixes" is minimal at best, and in many places nonexistent (in the sense that there's no description of the original HTML, the "improved" one, and the rationale for each "fix"); reverse-engineering that from code which runs in batch mode is a non-trivial job, especially since some "fixes" need old versions of Texinfo to be used to even understand what they are doing. So I don't think we should continue making these "fixes", unless Someone™ steps forward and volunteers to keep maintaining this script, keeping it up-to-date with the latest Texinfo developments, and generally making sure the script is usable at all times. I will wait for a day or two for someone to volunteer; failing that I will remove most or all of the "fixes" from the script, so that it works with the latest Texinfo, and so I could again refresh our on-line documentation when needed. TIA