From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals Date: Mon, 23 Sep 2024 10:00:00 -0400 Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> Reply-To: Stefan Monnier Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31631"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Eli Zaretskii , me@eshelyaron.com, 73425@debbugs.gnu.org To: Philip Kaludercic Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Sep 23 16:01:13 2024 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 1ssjcm-00081k-Tp for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 23 Sep 2024 16:01:13 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ssjcQ-000284-JH; Mon, 23 Sep 2024 10:00:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ssjcF-00026o-DA for bug-gnu-emacs@gnu.org; Mon, 23 Sep 2024 10:00:41 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ssjcF-0000bt-4J for bug-gnu-emacs@gnu.org; Mon, 23 Sep 2024 10:00:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=zZgygvOYjkrW/OPJIqCQFhNfpIRcoLxz0MiIs0uatcE=; b=F+2Ovt3bYgFau5bQ526M0Y2Roa0JsdBEvPvyiBruVDyC9JG3a8AcuZeV4OqYNy4HBxGno/Llmy95SMKQWJ4m/xaikMT8TjqnakJaAY2gbRUGgOC3hMACGorfpmMUNfEyjPZXp1m7vead46d2Lz47EA0JilN8WeMXHHR1Vc4pK6GRhpnnG0EOuAo5+8ybmlIdB4I3NsYqeyaim6+rwpu6Qz0XnQwVGqoVZWnOVMopyor2YawhLkKYQoGuXB/89w/tt4X+5cY/UCg4V2sR5hNbh+3eG8OJZDVJCAm9ej5sa/VTeMGxFWFP1Kt2HFnFmezRV/U9pnJxQU1/FeNF9ZRU5A==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ssjcb-0007z5-TN for bug-gnu-emacs@gnu.org; Mon, 23 Sep 2024 10:01:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 23 Sep 2024 14:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73425 X-GNU-PR-Package: emacs Original-Received: via spool by 73425-submit@debbugs.gnu.org id=B73425.172710003830646 (code B ref 73425); Mon, 23 Sep 2024 14:01:01 +0000 Original-Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 14:00:38 +0000 Original-Received: from localhost ([127.0.0.1]:44491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssjcD-0007yE-Ha for submit@debbugs.gnu.org; Mon, 23 Sep 2024 10:00:37 -0400 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:24400) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssjc9-0007s4-5R for 73425@debbugs.gnu.org; Mon, 23 Sep 2024 10:00:36 -0400 Original-Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id B5B694438A9; Mon, 23 Sep 2024 10:00:03 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1727100002; bh=GYXyH3DCXhK4tDU8ZkDu82B8PXDym0chiaCxvQNkM/I=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=aeT5u6iV1bPtwzASziwNVlW96CXB1dUOguGZspFQkA/EVmJdqw48joQTDUW5olIxB Q/nNSdCFOKp1UhwWAhXxvDHZPnk+h0lcyGsbHNdKOi0AeXnGg2rgPhAneDlhjRb7I/ 2HNLQeF1UUIWJKMWb7WM3heFVNI3WH/dldCNGa8VaFnvbgtx84yUt6z5FffCW+9reD tg06Y46wjB1fLK7Cm5TOGJJ/Z6Z3dakUHTT6X7WXm4LhrpfEilaWqqjVXm0WoE+m0K c/tTCzB9j8SPbdcz5SXYS/TkkrzXbD3gPYdZKXoGlL6tCWfqgZQzT3LbY7hLEB2qIU X/3WyE7dCY7Wg== Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 23FCD44386E; Mon, 23 Sep 2024 10:00:02 -0400 (EDT) Original-Received: from pastel (unknown [45.72.221.103]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id E62E41208A5; Mon, 23 Sep 2024 10:00:01 -0400 (EDT) In-Reply-To: <87ldzifxx2.fsf@posteo.net> (Philip Kaludercic's message of "Mon, 23 Sep 2024 10:48:41 +0000") 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:292278 Archived-At: >> How do we generate these HTML files from the Texinfo sources? > > Basically by executing, > > --8<---------------cut here---------------start------------->8--- > makeinfo --no-split [input-name] -o [output-name] --html --css-ref=[css-url] > --8<---------------cut here---------------end--------------->8--- > >>> plus the manual under https://elpa.gnu.org/packages/doc/[package name] >> >> So we have the HTML docs in two places? Why two? And why do I see >> both https://elpa.gnu.org/packages/doc/compat.html and >> https://elpa.gnu.org/packages/doc/compat/compat.html? > > I am not sure, my suspicion is some kind of historical backwards > compatibility. I have CC'ed Stefan who might know more. On disk, this is only one place: the `doc/compat.html` is a symlink to `doc/compat/compat.html`. The only URL we want to expose is the `doc/compat.html`, OTOH (which is why `doc/compat.html` is a symlink rather than an HTTP redirect). The reason is the following: - We put all the generated files into the `doc/PKG/` subdir so we know which files belong to which package when we need to "garbage collect" old files when updating a package. - We need to the URL to be `doc/compat.html` (i.e. include only the manual name but not the package name) so that links from one manual to the other work correctly regardless if the other manual belongs to the same package or not. Stefan