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: Thu, 26 Sep 2024 16:10:53 -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> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.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="14662"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Philip Kaludercic , me@eshelyaron.com, Eli Zaretskii , 73425@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 26 22:11:56 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 1stuqC-0003db-3R for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 26 Sep 2024 22:11:56 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1stupt-0005wZ-T2; Thu, 26 Sep 2024 16:11:37 -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 1stupr-0005wK-GE for bug-gnu-emacs@gnu.org; Thu, 26 Sep 2024 16:11:35 -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 1stupr-0001ly-4V for bug-gnu-emacs@gnu.org; Thu, 26 Sep 2024 16:11:35 -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=HRY+bZbSQdEnMQK9ANRJeKlY2D2CECpkmIN36B/pi+E=; b=nZ+IWhU7DwfXPtaVa9tQNcjtN0Epwwa248SDZk28EuC+74Z1s9ievg0et5Ajs/r9BcdLH+RtkLQlGM/jW0nurnXeNBfBKMJApVlZrcRNMZMj/jrqQv9U0SQzvPbJ1XsxNMFtWIEUjN26trmudcWgZwTnYNXyzzv134eKbQEWxcROQdEKDFokREEK7yemo+W+UMq5a4ibXmv/wx8TseMxA87sLMU4MEUZ3mohE32DaboxJKVL5pBT/NTEUia+rCrKe17tWQI/g/XS9yxiSH3DPKqokfwYo9SjLzhoJ/Q//fG5pDMQI/no3GNgLpb2iEudQccQ2mK+Q4CEhuNfL8XAvg==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1stuqI-0002MW-LV for bug-gnu-emacs@gnu.org; Thu, 26 Sep 2024 16:12:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 26 Sep 2024 20:12:02 +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.17273814969041 (code B ref 73425); Thu, 26 Sep 2024 20:12:02 +0000 Original-Received: (at 73425) by debbugs.gnu.org; 26 Sep 2024 20:11:36 +0000 Original-Received: from localhost ([127.0.0.1]:51900 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stupr-0002Li-0I for submit@debbugs.gnu.org; Thu, 26 Sep 2024 16:11:36 -0400 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:10950) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stupm-0002LP-4L for 73425@debbugs.gnu.org; Thu, 26 Sep 2024 16:11:33 -0400 Original-Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 35E658099D; Thu, 26 Sep 2024 16:10:56 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1727381454; bh=KzNpQJBl0c5dG2dZp5wu4V+lOKWyuPDQDou1kXY06aQ=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=by4WqK6lHZkPR8E4k2LzOTCoYywbZsLT4I757UbQvmD2T1ewycJfFBB8jiEd/2l+H JC2thFlRUe+pAqInju0jf3tPPwlRFJPyveYe8sGEd2F4ww6jq3gjmFefeWcox9Rz4f fqYYpzsd4mAi5GM3AEKJqZAwqCr8BQOVrlx3JzGthWL1xvA/WPBQBVOP9nuMftyXAH w1tgVWAdK/nCwa+7KFMIs/ZzO7ZgtJarfpisp4VR80wErh+8rjBwrVDBR3Uu1eqQc6 +b0xu66Sbqow9T1+sFYcTmbayyHYclhVaDDQAr+gVCQnvxDfEcOsRNQUwTsJ62Mnhl T0upE9WLBIhDQ== Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 5087F80781; Thu, 26 Sep 2024 16:10:54 -0400 (EDT) Original-Received: from alfajor (modemcable115.250-20-96.mc.videotron.ca [96.20.250.115]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 193591204C2; Thu, 26 Sep 2024 16:10:54 -0400 (EDT) In-Reply-To: (Stefan Kangas's message of "Wed, 25 Sep 2024 21:02:45 -0700") 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:292479 Archived-At: >> Yes. My suggestion is to allow listing additional non-.texi/.org files >> under :doc that would be copied out to the web server. So in Eshel's >> case, we could update the specification to be >> >> (kubed :url "https://git.sr.ht/~eshel/kubed" >> :doc ("kubed.texi" "images/")) >> >> and the HTTP server could host all files under images/. > > That has a significant drawback: when package maintainers want to add a > new image, they have to patch the (Non-)GNU ELPA package listing. Agreed. > It would be better to keep that information it in the package itself > somehow, like we do with .elpaignore. Or we could just copy all image > files automatically. I think we should provide a "generic" way to provide some of the `elpa-packages` contents directly from the package's own files. I was thinking of something like a ;; ELPA-spec: (:readme "README.md" :doc "clear.texi" ...) there's a security implication, so we'd need to "sanitize" this info before using it, but other than that it should not be too hard to implement. But to get back to the "real" problem of images: in order for manual `foo` to be able to have (working) cross-links to manual `bar`, it's important that they are both exposed as `.../doc/foo.html` and `.../doc/bar.html`, so they can't both use an image with a relative URL of `snapshot1.png`. Stefan