From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Okamsn Newsgroups: gmane.emacs.devel Subject: Re: How to install documentation in sub-directory with Package VC? Date: Tue, 28 Mar 2023 01:50:04 +0000 Message-ID: References: <87bkkvconh.fsf@posteo.net> <87o7oujqqp.fsf@posteo.net> <98f76116-4f5a-c225-3123-78c612ec64cb@protonmail.com> <875yb1gk55.fsf@posteo.net> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="b1_JoAJCpLREYJFQg83Rc9f8ZXjzGDiXtfz2IuwS01DYMM" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32829"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Mar 28 04:21:16 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 1pgyxX-0008Eb-QB for ged-emacs-devel@m.gmane-mx.org; Tue, 28 Mar 2023 04:21:15 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pgywg-0003bB-GL; Mon, 27 Mar 2023 22:20:22 -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 1pgyTa-0006rE-RP for emacs-devel@gnu.org; Mon, 27 Mar 2023 21:50:18 -0400 Original-Received: from mail-40133.protonmail.ch ([185.70.40.133]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pgyTY-0000bg-K0 for emacs-devel@gnu.org; Mon, 27 Mar 2023 21:50:18 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1679968212; x=1680227412; bh=WBbQ89oL5UpR5ZsMh95+K9WQTRmKZ61UGG4SNz6accA=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=vh8Wb9JSFlh83sJxUU/gawWv7eyrOdyINccpfW6Plcorbv2rsPfrWn0vzzDwwEF4F Jqx1aSuA0dwLe8EIxqK5Y4gP0qj/zJr3WF2p804GHMuYmyCXHd/ImuBfY1BamLYsZF 1dWSAn72xMgUAVC4KRNk36g29wXgHxdG6lV0/PZRgGaZpDYvWLPl+TqdlMnse51TWY FB8T+nujBsLGeRIau9c2mjxarA0cdTL8PNCdxnafTiswryHUCrPGvhxgM6Di14DA27 kzN/mfyWNifwEwbOJ0Feo/KXnBykARr+57aM87evld/mJkZOvx47PTf/8qKmHsiv+O iLceUTHv+ZiSA== In-Reply-To: <875yb1gk55.fsf@posteo.net> Feedback-ID: 25935600:user:proton Received-SPF: pass client-ip=185.70.40.133; envelope-from=okamsn@protonmail.com; helo=mail-40133.protonmail.ch X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Mon, 27 Mar 2023 22:20:18 -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:304793 Archived-At: This is a multi-part message in MIME format. --b1_JoAJCpLREYJFQg83Rc9f8ZXjzGDiXtfz2IuwS01DYMM Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 2023-03-16 08:44 UTC, Philip Kaludercic wrote: >> Are the keys used by the ELPA package specification documented in the >> manual? If not, I would like to list the keys accepted at the end of the >> Package VC manual page, take from here: >> https://git.savannah.gnu.org/cgit/emacs/elpa.git/tree/README > > Yes, exactly. > >> I will write a patch for this, unless there is a reason to not do so. >> What do you think? > > If you think it can be clarified, why not? I have tried to write a patch doing this (attached). I think that each of the keys supported by Package VC should be listed in the documentation, but I'm still not sure which keys those are. In the patch, these are currently listed: - `:url` - `:branch` - `:lisp-dir` - `:main-file` - `:doc` - `:vc-backend` I did not see any others. Are there others? I have listed these keys at the end of the Texi file, based on what was in the documentation string. For the information in the manual, should the data type be included? --b1_JoAJCpLREYJFQg83Rc9f8ZXjzGDiXtfz2IuwS01DYMM Content-Type: text/x-patch; charset=UTF-8; name=0001-Add-more-documentation-for-the-keys-of-package-vc-se.patch; name=0001-Add-more-documentation-for-the-keys-of-package-vc-se.patch Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename=0001-Add-more-documentation-for-the-keys-of-package-vc-se.patch RnJvbSAxZDRkNGViZmQ4NzRkOTlkNWUyZDI5MDc4ZjMzMTZmNDlkY2YzMTM2IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBFYXJsIEh5YXR0IDxva2Ftc25AcHJvdG9ubWFpbC5jb20+CkRh dGU6IE1vbiwgMjcgTWFyIDIwMjMgMjA6NTc6MzEgLTA0MDAKU3ViamVjdDogW1BBVENIXSBBZGQg bW9yZSBkb2N1bWVudGF0aW9uIGZvciB0aGUga2V5cyBvZgogYHBhY2thZ2UtdmMtc2VsZWN0ZWQt cGFja2FnZXNgLgoKKiBkb2MvZW1hY3MvcGFja2FnZS50ZXhpIChGZXRjaGluZyBQYWNrYWdlIFNv dXJjZXMpOiBMaXN0IHRoZQogIGFjY2VwdGVkIGtleXMuCiogbGlzcC9lbWFjcy1saXNwL3BhY2th Z2UtdmMuZWwgKHBhY2thZ2UtdmMtc2VsZWN0ZWQtcGFja2FnZXMpOgogIE1lbnRpb24gdGhlIGA6 ZG9jYCBrZXkuCi0tLQogZG9jL2VtYWNzL3BhY2thZ2UudGV4aSAgICAgICAgfCA1MyArKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKwogbGlzcC9lbWFjcy1saXNwL3BhY2thZ2UtdmMu ZWwgfCAgNCArKysKIDIgZmlsZXMgY2hhbmdlZCwgNTcgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdp dCBhL2RvYy9lbWFjcy9wYWNrYWdlLnRleGkgYi9kb2MvZW1hY3MvcGFja2FnZS50ZXhpCmluZGV4 IDdhMmJjMTFkMDNjLi42ZjFmYWQyMjkxYSAxMDA2NDQKLS0tIGEvZG9jL2VtYWNzL3BhY2thZ2Uu dGV4aQorKysgYi9kb2MvZW1hY3MvcGFja2FnZS50ZXhpCkBAIC01NzgsMyArNTc4LDU2IEBAIEZl dGNoaW5nIFBhY2thZ2UgU291cmNlcwogYW5kIGluaXRpYWxpemVzIHRoZSBjb2RlLiAgTm90ZSB0 aGF0IHlvdSBtaWdodCBoYXZlIHRvIHVzZQogQGNvZGV7cGFja2FnZS12Yy1yZWZyZXNofSB0byBy ZXBlYXQgdGhlIGluaXRpYWxpemF0aW9uIGFuZCB1cGRhdGUgdGhlCiBhdXRvbG9hZHMuCisKK1Ro ZXJlIGFyZSB0d28gd2F5cyBmb3IgRW1hY3MgdG8gbGVhcm4gaG93IGFuZCB3aGVuY2UgdG8gaW5z dGFsbCBhCitwYWNrYWdlIGZyb20gc291cmNlLiAgVGhlIGZpcnN0IHdheSwgd2hlbiBzdXBwb3J0 ZWQsIGlzIHRvCithdXRvbWF0aWNhbGx5IGRvd25sb2FkIHRoZSBuZWVkZWQgaW5mb3JtYXRpb24g ZnJvbSBhIHBhY2thZ2UgYXJjaGl2ZQorKEBweHJlZntQYWNrYWdlIEFyY2hpdmVzLCwsZWxpc3As IFRoZSBFbWFjcyBMaXNwIFJlZmVyZW5jZSBNYW51YWx9KS4KK1RoaXMgaXMgd2hhdCBpcyBkb25l IHdoZW4gb25seSBzcGVjaWZ5aW5nIHRoZSBzeW1ib2wgb2YgYSBwYWNrYWdlLgorCitAZXhhbXBs ZQorQGdyb3VwCisocGFja2FnZS12Yy1pbnN0YWxsICdjc3YtbW9kZSkKK0BlbmQgZ3JvdXAKK0Bl bmQgZXhhbXBsZQorCitUaGUgc2Vjb25kIHdheSBpcyB0byBzcGVjaWZ5IHRoaXMgaW5mb3JtYXRp b24gbWFudWFsbHkgaW4gdGhlIGZpcnN0Cithcmd1bWVudCBvZiBAY29kZXtwYWNrYWdlLXZjLWlu c3RhbGx9LCBpbiB0aGUgZm9ybSBvZgorQHNhbXB7KEB2YXJ7bmFtZX0gLiBAdmFye3NwZWN9KX0u ICBAdmFye3NwZWN9IHNob3VsZCBiZSBhIHByb3BlcnR5CitsaXN0IHVzaW5nIGFueSBvZiB0aGUg Zm9sbG93aW5nIGtleXM6CisKK0BpdGVtaXplIEBidWxsZXQKK0BpdGVtIEBjb2Rlezp1cmx9CitB IFVSTCBzcGVjaWZ5aW5nIHRoZSByZXBvc2l0b3J5IGZyb20gd2hpY2ggdG8gZmV0Y2ggdGhlIHBh Y2thZ2Uncworc291cmNlIGNvZGUuCisKK0BpdGVtIEBjb2RlezpicmFuY2h9CitUaGUgbmFtZSBv ZiB0aGUgYnJhbmNoIHRvIGNoZWNrb3V0IGFmdGVyIGNsb25pbmcgdGhlIGRpcmVjdG9yeS4KKwor QGl0ZW0gQGNvZGV7Omxpc3AtZGlyfQorVGhlIHJlcG9zaXRvcnktcmVsYXRpdmUgbmFtZSBvZiB0 aGUgZGlyZWN0b3J5IHRvIHVzZSBmb3IgbG9hZGluZyB0aGUKK0xpc3Agc291cmNlcywgaWYgbm90 IHRoZSByb290IGRpcmVjdG9yeSBvZiB0aGUgcmVwb3NpdG9yeS4KKworQGl0ZW0gQGNvZGV7Om1h aW4tZmlsZX0KK1RoZSBtYWluIGZpbGUgb2YgdGhlIHByb2plY3QsIGZyb20gd2hpY2ggdG8gZ2F0 aGVyIHBhY2thZ2UgbWV0YWRhdGEuCitJZiBub3QgZ2l2ZW4sIHRoZSBhc3N1bWVkIGRlZmF1bHQg aXMgdGhlIHBhY2thZ2UgbmFtZSB3aXRoICIuZWwiCithcHBlbmRlZCB0byBpdC4KKworQGl0ZW0g QGNvZGV7OmRvY30KK1RoZSByZXBvc2l0b3J5LXJlbGF0aXZlIG5hbWUgb2YgdGhlIGRvY3VtZW50 YXRpb24gZmlsZSBmcm9tIHdoaWNoIHRvCitidWlsZCBhbiBJbmZvIGZpbGUuIFRoaXMgY2FuIGJl IGEgVGV4SW5mbyBmaWxlIG9yIGFuIE9yZyBmaWxlLgorCitAaXRlbSBAY29kZXs6dmMtYmFja2Vu ZH0KK1RoZSBWQyBiYWNrZW5kIHRvIHVzZSBmb3IgY2xvbmluZyB0aGUgcGFja2FnZS4gIElmIG9t aXR0ZWQsCit0aGUgcHJvY2VzcyB3aWxsIGZhbGwgYmFjayBvbnRvIHRoZSBhcmNoaXZlIGRlZmF1 bHQgb3Igb250bwordGhlIHZhbHVlIG9mIEBjb2Rle3BhY2thZ2UtdmMtZGVmYXVsdC1iYWNrZW5k fS4KK0BlbmQgaXRlbWl6ZQorCitAZXhhbXBsZQorQGdyb3VwCis7OyBTcGVjaWZ5aW5nIGluZm9y bWF0aW9uIG1hbnVhbGx5OgorKHBhY2thZ2UtdmMtaW5zdGFsbAorICAnKGNzdi1tb2RlIDp1cmwg Imh0dHBzOi8vZ2l0LnN2LmdudS5vcmcvZ2l0L2VtYWNzL2VscGEuZ2l0IgorICAgICAgICAgICAg IDpicmFuY2ggImV4dGVybmFscy9jc3YtbW9kZSIpKQorQGVuZCBncm91cAorQGVuZCBleGFtcGxl CmRpZmYgLS1naXQgYS9saXNwL2VtYWNzLWxpc3AvcGFja2FnZS12Yy5lbCBiL2xpc3AvZW1hY3Mt bGlzcC9wYWNrYWdlLXZjLmVsCmluZGV4IDI1M2IzNWYxZjFhLi5lNzVkYmFjMzA2MSAxMDA2NDQK LS0tIGEvbGlzcC9lbWFjcy1saXNwL3BhY2thZ2UtdmMuZWwKKysrIGIvbGlzcC9lbWFjcy1saXNw L3BhY2thZ2UtdmMuZWwKQEAgLTE2NCw2ICsxNjQsMTAgQEAgcGFja2FnZS12Yy1zZWxlY3RlZC1w YWNrYWdlcwogICAgICAgSWYgbm90IGdpdmVuLCB0aGUgYXNzdW1lZCBkZWZhdWx0IGlzIHRoZSBw YWNrYWdlIG5hbWUgd2l0aCBcIi5lbFwiCiAgICAgICBhcHBlbmRlZCB0byBpdC4KIAorICAgYDpk b2MnIChzdHJpbmcpCisgICAgICBUaGUgZG9jdW1lbnRhdGlvbiBmaWxlIGZyb20gd2hpY2ggdG8g YnVpbGQgYW4gSW5mbyBmaWxlLgorICAgICAgVGhpcyBjYW4gYmUgYSBUZXhJbmZvIGZpbGUgb3Ig YW4gT3JnIGZpbGUuCisKICAgIGA6dmMtYmFja2VuZCcgKHN5bWJvbCkKICAgICAgIEEgc3ltYm9s IG9mIHRoZSBWQyBiYWNrZW5kIHRvIHVzZSBmb3IgY2xvbmluZyB0aGUgcGFja2FnZS4gIFRoZQog ICAgICAgdmFsdWUgb3VnaHQgdG8gYmUgYSBtZW1iZXIgb2YgYHZjLWhhbmRsZWQtYmFja2VuZHMn LiAgSWYgb21pdHRlZCwKLS0gCjIuMzQuMQoK --b1_JoAJCpLREYJFQg83Rc9f8ZXjzGDiXtfz2IuwS01DYMM--