From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jonas Bernoulli Newsgroups: gmane.emacs.devel Subject: Re: How to install documentation in sub-directory with Package VC? Date: Sun, 09 Apr 2023 20:39:52 +0200 Message-ID: <87lej0lx1j.fsf@bernoul.li> References: <87bkkvconh.fsf@posteo.net> <87o7oujqqp.fsf@posteo.net> <98f76116-4f5a-c225-3123-78c612ec64cb@protonmail.com> <875yb1gk55.fsf@posteo.net> <87cz4te31m.fsf@posteo.net> <877cun5psj.fsf@bernoul.li> <87mt3i93ex.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6460"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Okamsn , emacs-devel@gnu.org To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Apr 09 21:12:08 2023 Return-path: Envelope-to: ged-emacs-devel@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 1plaSN-0001Vc-Tl for ged-emacs-devel@m.gmane-mx.org; Sun, 09 Apr 2023 21:12:07 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1plaRd-00019Y-D2; Sun, 09 Apr 2023 15:11:21 -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 1plZxJ-0003t0-1q for emacs-devel@gnu.org; Sun, 09 Apr 2023 14:40:01 -0400 Original-Received: from mail.hostpark.net ([212.243.197.30]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1plZxH-0004f3-1W for emacs-devel@gnu.org; Sun, 09 Apr 2023 14:40:00 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by mail.hostpark.net (Postfix) with ESMTP id 335A916568; Sun, 9 Apr 2023 20:39:53 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=bernoul.li; h= content-type:content-type:mime-version:message-id:date:date :references:in-reply-to:subject:subject:from:from:received :received; s=sel2011a; t=1681065592; bh=lft77iSe663pkLLJGrpwouVq ObzXZnamnLaDWEaOb0I=; b=SvtFFFEBajtG/S2JjwkBOvFhvjGEdlF2nijFBGky RgTSlqp3j2DOdYCtcVjgQYpf+iZGP+k95ku+Y7ZHFQYG/MrJOWkcSF5UPAF8jRlw CQge47p0BeWoDfpR1s12SwnxfAOgWfE/1jW/JqBIS3r64fZ5WMYY2UmHZbOFuSFg XTo= X-Virus-Scanned: by Hostpark/NetZone Mailprotection at hostpark.net Original-Received: from mail.hostpark.net ([127.0.0.1]) by localhost (mail0.hostpark.net [127.0.0.1]) (amavisd-new, port 10224) with ESMTP id a043otxNeMq4; Sun, 9 Apr 2023 20:39:52 +0200 (CEST) Original-Received: from customer (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mail.hostpark.net (Postfix) with ESMTPSA id DD66516564; Sun, 9 Apr 2023 20:39:52 +0200 (CEST) In-Reply-To: <87mt3i93ex.fsf@posteo.net> Received-SPF: none client-ip=212.243.197.30; envelope-from=jonas@bernoul.li; helo=mail.hostpark.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 09 Apr 2023 15:11:19 -0400 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:305211 Archived-At: Philip Kaludercic writes: >> We only provide :url, and where appropriate :branch, :vc-backend and >> :maintainer. > > :maintainer is currently not used Removed. Could you please ping me when you add new properties? > (TBH I am not sure what the point of it is in elpa-admin to begin > with), Sending emails to a package's maintainer. It is used to send every pushed commit for example. >> We don't set :doc or :lisp-dir (yet?). > > Do you think it could be possible to support :doc and :lisp-dir. IIUC > the issue is that MELPA only accepts a list of files to include when > bundling a package (:files) and the build system would have to infer > what what is? Why is :doc needed? I think package-install simply runs makeinfo on all texi files, but of course it can rely on them being at the top-level. It might end up trying (and failing) to directly process gpl.texi and similar. But still, cannot package-vc simply do that too? The value of :doc can also be an org file and we cannot just blindly try to transcode *all* org files to texi. But Melpa doesn't support exporting ort to texi, so packages distributed there cannot assume that that happens. (I wish Melpa supported this and I actually implemented it, but the main Melpa maintainers didn't want to merge it for security reasons.) I am not sure determining :lisp-dir from :files on the archive's side, is easier and/or more reliable than package-vc doing it itself based solely on what it finds in the latest commit. In Borg I use "if lisp/ exists, then use that, else use ./" and that works for 99% of all packages. I think it would be better to first try to add some heuristics to package-vc. If that doesn't work well enough, we can still later make package-build generate more elpa-admin-style metadata.