From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Y. E. via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#53205: 28.0.90; [PATCH] GNU ELPA: Provide more control over linked documentation Date: Thu, 13 Jan 2022 15:20:25 +0200 Message-ID: References: Reply-To: "Y. E." Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18913"; mail-complaints-to="usenet@ciao.gmane.io" Cc: yet@ego.team, 53205@debbugs.gnu.org, monnier@iro.umontreal.ca To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 13 14:22:34 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 1n803m-0004il-1h for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 13 Jan 2022 14:22:34 +0100 Original-Received: from localhost ([::1]:41360 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n803j-0003gd-LQ for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 13 Jan 2022 08:22:31 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:52716) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n802I-0003WZ-OS for bug-gnu-emacs@gnu.org; Thu, 13 Jan 2022 08:21:07 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39347) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n802I-0002xL-1I for bug-gnu-emacs@gnu.org; Thu, 13 Jan 2022 08:21:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n802H-0006tx-VO for bug-gnu-emacs@gnu.org; Thu, 13 Jan 2022 08:21:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Y. E. Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 13 Jan 2022 13:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53205 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 53205-submit@debbugs.gnu.org id=B53205.164208003126439 (code B ref 53205); Thu, 13 Jan 2022 13:21:01 +0000 Original-Received: (at 53205) by debbugs.gnu.org; 13 Jan 2022 13:20:31 +0000 Original-Received: from localhost ([127.0.0.1]:60478 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n801n-0006sN-51 for submit@debbugs.gnu.org; Thu, 13 Jan 2022 08:20:31 -0500 Original-Received: from out0.migadu.com ([94.23.1.103]:55520) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n801k-0006sB-LP for 53205@debbugs.gnu.org; Thu, 13 Jan 2022 08:20:29 -0500 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ego.team; s=key1; t=1642080027; h=from:from:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to; bh=sGxopdXYn6vfdyegXdYwxGN8U8Xf0TKf3CZTmfNYsrA=; b=vN5v2iKdktfukMd63+Ggw54dYxcbbwLXpQYzrw0Uu2RpkfxGklPCyoaJa7e+P4BGpeJzUh dBujC4f63sGM2slXSw/U48IszNaTeoRuXL93pr0g8Zpv/7Bzrs1ccYS0zcd3nBubReXuBw MagkNBmE2VjEzv0q19m69YcsfZWQcr4= In-Reply-To: <871r1c9mrr.fsf@gnus.org> (message from Lars Ingebrigtsen on Thu, 13 Jan 2022 07:23:52 +0100) X-Migadu-Flow: FLOW_OUT X-Migadu-Auth-User: ego.team 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" X-ACL-Warn: , Y. E. Xref: news.gmane.io gmane.emacs.bugs:224104 Archived-At: >Lars Ingebrigtsen writes: >> Y. E. writes: >> >> My initial idea for fixing this issue was to add a property >> ':doc-asset', which could be configured to '(FROM . TO)' directories >> names, then used for moving images to the 'archive-devel/doc/company/' >> folder, as shown below: > > I think that sounds OK... Fine by me, though with a workaround to apply custom styles. The generated plain HTML outputs images as is, which doesn't look well in the described case. > >> That worked fine during my tests but thinking about how to apply CSS >> styles to the manual (including to control the size of the shown >> images), I've got the second idea: Company already has an online version >> of the user manual with all the proper styles and images in place, so >> why not link directly to it? > > [...] > >> :doc-html ignore >> :resources (("User Manual" . "https://company-mode.github.io/manual/index.html")) > > Well, the user wants to see the version of the manual that corresponds > to the version of the package they have installed, so just redirecting > them to an external web page doesn't seem very useful? But perhaps I'm > misunderstanding the proposal. (And I'm adding Stefan to the CCs; > perhaps he has some comments.) I agree, this is a good point. Currently, the most recent version of the manual is displayed at Company website. But it's planned to output the stable version there in the future. So, yes, it would be nice/convenient to have a development version generated at GNU ELPA.