From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jens Schmidt via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#65603: 29.1.50; [PATCH] Improve some EPG docstrings Date: Tue, 29 Aug 2023 23:16:52 +0200 Message-ID: <2bfde119-24d4-1813-b0b4-64157f9df698@vodafonemail.de> Reply-To: Jens Schmidt Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------BUS5hER7bXTecyRITT9H1ltV" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39020"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.14.0 To: 65603@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Aug 29 23:22:00 2023 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 1qb69v-0009lp-5z for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 29 Aug 2023 23:21:59 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qb69l-0003Aw-6d; Tue, 29 Aug 2023 17:21:49 -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 1qb665-0001cq-7U for bug-gnu-emacs@gnu.org; Tue, 29 Aug 2023 17:18:04 -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 1qb65y-0004pv-Ps for bug-gnu-emacs@gnu.org; Tue, 29 Aug 2023 17:18:00 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qb665-0008RX-Si for bug-gnu-emacs@gnu.org; Tue, 29 Aug 2023 17:18:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jens Schmidt Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 29 Aug 2023 21:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 65603 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.169334385832421 (code B ref -1); Tue, 29 Aug 2023 21:18:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Aug 2023 21:17:38 +0000 Original-Received: from localhost ([127.0.0.1]:51729 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qb65i-0008Qq-7q for submit@debbugs.gnu.org; Tue, 29 Aug 2023 17:17:38 -0400 Original-Received: from lists.gnu.org ([2001:470:142::17]:49114) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qb65e-0008Qa-54 for submit@debbugs.gnu.org; Tue, 29 Aug 2023 17:17: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 1qb65R-0001bj-EU for bug-gnu-emacs@gnu.org; Tue, 29 Aug 2023 17:17:21 -0400 Original-Received: from mr3.vodafonemail.de ([145.253.228.163]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qb65O-0004n8-0c for bug-gnu-emacs@gnu.org; Tue, 29 Aug 2023 17:17:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vodafonemail.de; s=vfde-mb-mr2-21dec; t=1693343826; bh=Ioob2svIjMzTQt0kmEw4CehbupC58Epl63lZV33i2o0=; h=Content-Type:Message-ID:Date:User-Agent:Content-Language:From:To: Subject:From; b=BjeWy5QEWxSXgYXMhxmzwg6w1CEPTtFQoLJriWafcS+YkNOW32Mjy1OwTNraoi+PJ 2r/361yCjOleCOouWbkZgpAT0uHbRVZrgwm8rHco9enO/vDtvTqXBjKLFgPADZyxoY HnYknoOjOl1lxh4FEiX0ijLygxHEn7r5VyUHnKH8= Original-Received: from smtp.vodafone.de (unknown [10.0.0.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by mr3.vodafonemail.de (Postfix) with ESMTPS id 4Rb0cL3KXfz1yVw for ; Tue, 29 Aug 2023 21:17:06 +0000 (UTC) Original-Received: from [192.168.0.138] (unknown [86.33.79.79]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by smtp.vodafone.de (Postfix) with ESMTPSA id 4Rb0cF5j5kz9s3Z for ; Tue, 29 Aug 2023 21:16:58 +0000 (UTC) Content-Language: de-DE-frami, en-US X-purgate-type: clean X-purgate: clean X-purgate-size: 7566 X-purgate-ID: 155817::1693343822-9AFFA7FF-C9F62697/0/0 Received-SPF: pass client-ip=145.253.228.163; envelope-from=jschmidt4gnu@vodafonemail.de; helo=mr3.vodafonemail.de 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, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:268678 Archived-At: This is a multi-part message in MIME format. --------------BUS5hER7bXTecyRITT9H1ltV Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit While working on bug#63627 I came across some issues in EPG docstrings, plus the challenge to use function `epg-edit-key' without any example whatsoever. Here are two patches that should rectify this. Please check. Thanks. --------------BUS5hER7bXTecyRITT9H1ltV Content-Type: text/x-patch; charset=UTF-8; name="0001-Update-GnuPG-version-dependent-information-in-docstr.patch" Content-Disposition: attachment; filename*0="0001-Update-GnuPG-version-dependent-information-in-docstr.pa"; filename*1="tch" Content-Transfer-Encoding: base64 RnJvbSA3NTQ5YmVmM2Y0OWI4NjAwMjkwYWQ3ODU1MjMyOTM5NGFjZjk5NDc2IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKZW5zIFNjaG1pZHQgPGpzY2htaWR0NGdudUB2b2Rh Zm9uZW1haWwuZGU+CkRhdGU6IFR1ZSwgMjkgQXVnIDIwMjMgMjI6MTQ6NDggKzAyMDAKU3Vi amVjdDogW1BBVENIIDEvMl0gVXBkYXRlIEdudVBHLXZlcnNpb24tZGVwZW5kZW50IGluZm9y bWF0aW9uIGluIGRvY3N0cmluZwoKKiBsaXNwL2VwZy5lbCAoZXBnLWNvbnRleHQtc2V0LXBh c3NwaHJhc2UtY2FsbGJhY2spOiBVcGRhdGUKR251UEctdmVyc2lvbi1kZXBlbmRlbnQgaW5m b3JtYXRpb24gaW4gZG9jc3RyaW5nIGFuZCByZWZlciB0byBJbmZvCm5vZGUgYChlcGEpJyBm b3IgZGV0YWlscy4KLS0tCiBsaXNwL2VwZy5lbCB8IDEwICsrKysrLS0tLS0KIDEgZmlsZSBj aGFuZ2VkLCA1IGluc2VydGlvbnMoKyksIDUgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEv bGlzcC9lcGcuZWwgYi9saXNwL2VwZy5lbAppbmRleCA5ZGE1YTM2YmEzZC4uN2FkZDNkY2Qx NzMgMTAwNjQ0Ci0tLSBhL2xpc3AvZXBnLmVsCisrKyBiL2xpc3AvZXBnLmVsCkBAIC0yNjYs MTEgKzI2NiwxMSBAQCBlcGctY29udGV4dC1zZXQtcGFzc3BocmFzZS1jYWxsYmFjawogVGhl IGZ1bmN0aW9uIGdldHMgdGhyZWUgYXJndW1lbnRzOiB0aGUgY29udGV4dCwgdGhlIGtleS1p ZCBpbgogcXVlc3Rpb24sIGFuZCB0aGUgY2FsbGJhY2sgZGF0YSAoaWYgYW55KS4KCi1UaGUg Y2FsbGJhY2sgbWF5IG5vdCBiZSBjYWxsZWQgaWYgeW91IHVzZSBHbnVQRyAyLngsIHdoaWNo IHJlbGllcwotb24gdGhlIGV4dGVybmFsIHByb2dyYW0gY2FsbGVkIGBncGctYWdlbnQnIGZv ciBwYXNzcGhyYXNlIHF1ZXJ5LgotSWYgeW91IHJlYWxseSB3YW50IHRvIGludGVyY2VwdCBw YXNzcGhyYXNlIHF1ZXJ5LCBjb25zaWRlcgotaW5zdGFsbGluZyBHbnVQRyAxLnggX2Fsb25n IHdpdGhfIEdudVBHIDIueCwgd2hpY2ggZG9lcyBwYXNzcGhyYXNlCi1xdWVyeSBieSBpdHNl bGYgYW5kIEVtYWNzIGNhbiBpbnRlcmNlcHQgdGhlbS4iCitUaGUgY2FsbGJhY2sgbWF5IG5v dCBiZSBjYWxsZWQgaWYgeW91IHVzZSBHbnVQRyAyLjAsIHdoaWNoIHJlbGllcworb25seSBv biBleHRlcm5hbCBwcm9ncmFtcyBmb3IgcGFzc3BocmFzZSBxdWVyeSBhbmQgZG9lcyBub3QK K3Byb3ZpZGUgbG9vcGJhY2sgcGluZW50cnkuICBGb3IgZGV0YWlscyBzZWUgSW5mbyBub2Rl IGAoZXBhKQorR251UEcgdmVyc2lvbiBjb21wYXRpYmlsaXR5JyBhbmQgSW5mbyBub2RlIGAo ZXBhKSBHbnVQRworUGluZW50cnknLiIKICAgOzsgKGRlY2xhcmUgKG9ic29sZXRlIHNldGYg IjI1LjEiKSkKICAgKHNldGYgKGVwZy1jb250ZXh0LXBhc3NwaHJhc2UtY2FsbGJhY2sgY29u dGV4dCkKICAgICAgICAgKGlmIChmdW5jdGlvbnAgcGFzc3BocmFzZS1jYWxsYmFjaykKLS0K Mi4zMC4yCg== --------------BUS5hER7bXTecyRITT9H1ltV Content-Type: text/x-patch; charset=UTF-8; name="0002-Improve-docstrings-and-provide-an-example.patch" Content-Disposition: attachment; filename="0002-Improve-docstrings-and-provide-an-example.patch" Content-Transfer-Encoding: base64 RnJvbSA2ODk3YWNlOTkxNjAyMGUwODZmNjIyZTcyMWY0N2E3ZmFlODYxNGI5IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKZW5zIFNjaG1pZHQgPGpzY2htaWR0NGdudUB2b2Rh Zm9uZW1haWwuZGU+CkRhdGU6IFR1ZSwgMjkgQXVnIDIwMjMgMjM6MDM6MzYgKzAyMDAKU3Vi amVjdDogW1BBVENIIDIvMl0gSW1wcm92ZSBkb2NzdHJpbmdzIGFuZCBwcm92aWRlIGFuIGV4 YW1wbGUKCiogbGlzcC9lcGcuZWwgKGVwZy1zdGFydC1lZGl0LWtleSk6IFJlcGxhY2UgZGVz Y3JpcHRpb24gb2YgYXJndW1lbnRzCmJ5IGEgcmVmZXJlbmNlIHRvIGBlcGctZWRpdC1rZXkn LgooZXBnLWVkaXQta2V5KTogTW9yZSBwcmVjaXNlbHkgZGVzY3JpYmUgY2FsbGJhY2sgb3Bl cmF0aW9uIGFuZAphcmd1bWVudHMgYW5kIHByb3ZpZGUgYW4gZXhhbXBsZSBvZiBob3cgdG8g ZWRpdCBhIGtleS4KLS0tCiBsaXNwL2VwZy5lbCB8IDQ2ICsrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKy0tLS0KIDEgZmlsZSBjaGFuZ2VkLCA0MiBpbnNlcnRp b25zKCspLCA0IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2xpc3AvZXBnLmVsIGIvbGlz cC9lcGcuZWwKaW5kZXggN2FkZDNkY2QxNzMuLmVkMjlmMDhhMDhmIDEwMDY0NAotLS0gYS9s aXNwL2VwZy5lbAorKysgYi9saXNwL2VwZy5lbApAQCAtMjAxOSw5ICsyMDE5LDcgQEAgZXBn LWdlbmVyYXRlLWtleS1mcm9tLXN0cmluZwogKGRlZnVuIGVwZy1zdGFydC1lZGl0LWtleSAo Y29udGV4dCBrZXkgZWRpdC1jYWxsYmFjayBoYW5kYmFjaykKICAgIkluaXRpYXRlIGFuIGVk aXQgb3BlcmF0aW9uIG9uIEtFWS4KIAotRURJVC1DQUxMQkFDSyBpcyBjYWxsZWQgZnJvbSBw cm9jZXNzIGZpbHRlciBhbmQgdGFrZXMgZm91cgotYXJndW1lbnRzOiB0aGUgY29udGV4dCwg YSBzdGF0dXMsIGFuIGFyZ3VtZW50IHN0cmluZywgYW5kIHRoZQotaGFuZGJhY2sgYXJndW1l bnQuCitTZWUgYGVwZy1lZGl0LWtleScgZm9yIGEgZGVzY3JpcHRpb24gb2YgdGhlIGFyZ3Vt ZW50cy4KIAogSWYgeW91IHVzZSB0aGlzIGZ1bmN0aW9uLCB5b3Ugd2lsbCBuZWVkIHRvIHdh aXQgZm9yIHRoZSBjb21wbGV0aW9uIG9mCiBgZXBnLWdwZy1wcm9ncmFtJyBieSB1c2luZyBg ZXBnLXdhaXQtZm9yLWNvbXBsZXRpb24nIGFuZCBjYWxsCkBAIC0yMDM2LDcgKzIwMzQsNDcg QEAgZXBnLXN0YXJ0LWVkaXQta2V5CiAJCQkgICAgIChjYXIgKGVwZy1rZXktc3ViLWtleS1s aXN0IGtleSkpKSkpKQogCiAoZGVmdW4gZXBnLWVkaXQta2V5IChjb250ZXh0IGtleSBlZGl0 LWNhbGxiYWNrIGhhbmRiYWNrKQotICAiRWRpdCBLRVkgaW4gdGhlIGtleXJpbmcuIgorICAi RWRpdCBLRVkgaW4gdGhlIGtleXJpbmcuCisKK1RoaXMgZnVuY3Rpb24gYW5kIGZ1bmN0aW9u IGBlcGctc3RhcnQtZWRpdC1rZXknIHVzZSB0aGUKK2xpbmUtYmFzZWQgcHJvdG9jb2wgZW5h YmxlZCBieSBcImdwZ1wiIHBhcmFtZXRlciBcIi0tc3RhdHVzLWZkXCIKK3RvIGVkaXQgS0VZ LiAgRm9yIGVhY2ggR251UEcgc3RhdHVzIGxpbmUsIHRoZXNlIGZ1bmN0aW9ucyBvciwKK21v cmUgcHJlY2lzZWx5LCB0aGUgRVBHIHByb2Nlc3MgZmlsdGVyIGNhbGxzIEVESVQtQ0FMTEJB Q0sgd2l0aAorZm91ciBhcmd1bWVudHM6IGFyZ3VtZW50IENPTlRFWFQsIHRoZSBHbnVQRyBz dGF0dXMga2V5d29yZCwgdGhlCitHbnVQRyBzdGF0dXMgYXJndW1lbnQgc3RyaW5nLCBhbmQg YXJndW1lbnQgSEFOREJBQ0suCisKK1RoZSBmb2xsb3dpbmcgZXhhbXBsZSB1c2VzIGEgc2lt cGxlIHN0YXRlIG1hY2hpbmUgdG8gdHJ1c3QgdGhlCitmaXJzdCBzdWJrZXkgb2Yga2V5IEtF WSB1bHRpbWF0ZWx5OgorCisgIChsZXQgKChzdGF0ZSAwKSkKKyAgICAoZXBnLWVkaXQta2V5 CisgICAgIGNvbnRleHQga2V5CisgICAgIChsYW1iZGEgKGNvbnRleHQgc3RhdHVzIHN0cmlu ZyBfaGFuZGJhY2spCisgICAgICAgKHBjYXNlICh2ZWN0b3Igc3RhdGUgc3RhdHVzIHN0cmlu ZykKKyAgICAgICAgIChcXD1gWzAgIFwiS0VZX0NPTlNJREVSRURcIiAsX10pCisgICAgICAg ICAoXFw9J1sxICBcIkdFVF9MSU5FXCIgXCJrZXllZGl0LnByb21wdFwiXQorICAgICAgICAg IChwcm9jZXNzLXNlbmQtc3RyaW5nIChlcGctY29udGV4dC1wcm9jZXNzIGNvbnRleHQpIFwi MVxcblwiKSkKKyAgICAgICAgIChcXD0nWzIgIFwiR09UX0lUXCIgXCJcIl0pCisgICAgICAg ICAoXFw9J1szICBcIkdFVF9MSU5FXCIgXCJrZXllZGl0LnByb21wdFwiXQorICAgICAgICAg IChwcm9jZXNzLXNlbmQtc3RyaW5nIChlcGctY29udGV4dC1wcm9jZXNzIGNvbnRleHQpIFwi dHJ1c3RcXG5cIikpCisgICAgICAgICAoXFw9J1s0ICBcIkdPVF9JVFwiIFwiXCJdKQorICAg ICAgICAgKFxcPSdbNSAgXCJHRVRfTElORVwiIFwiZWRpdF9vd25lcnRydXN0LnZhbHVlXCJd CisgICAgICAgICAgKHByb2Nlc3Mtc2VuZC1zdHJpbmcgKGVwZy1jb250ZXh0LXByb2Nlc3Mg Y29udGV4dCkgXCI1XFxuXCIpKQorICAgICAgICAgKFxcPSdbNiAgXCJHT1RfSVRcIiBcIlwi XSkKKyAgICAgICAgIChcXD0nWzcgIFwiR0VUX0JPT0xcIiBcImVkaXRfb3duZXJ0cnVzdC5z ZXRfdWx0aW1hdGUub2theVwiXQorICAgICAgICAgIChwcm9jZXNzLXNlbmQtc3RyaW5nIChl cGctY29udGV4dC1wcm9jZXNzIGNvbnRleHQpIFwieWVzXFxuXCIpKQorICAgICAgICAgKFxc PSdbOCAgXCJHT1RfSVRcIiBcIlwiXSkKKyAgICAgICAgIChcXD0nWzkgIFwiR0VUX0xJTkVc IiBcImtleWVkaXQucHJvbXB0XCJdCisgICAgICAgICAgKHByb2Nlc3Mtc2VuZC1zdHJpbmcg KGVwZy1jb250ZXh0LXByb2Nlc3MgY29udGV4dCkgXCJxdWl0XFxuXCIpKQorICAgICAgICAg KFxcPSdbMTAgXCJHT1RfSVRcIiBcIlwiXSkKKyAgICAgICAgIChfCisgICAgICAgICAgKGVy cm9yIFwiS2V5IGVkaXQgcHJvdG9jb2wgZXJyb3IgaW4gc3RhdGUgJWRcIiBzdGF0ZSkpKQor ICAgICAgIChzZXRxIHN0YXRlICgxKyBzdGF0ZSkpKQorICAgICBuaWwpKQorCitUaGlzIGlz IGEgc2xpZ2h0bHkgc2ltcGxpZmllZCBleGFtcGxlOiBJZGVhbGx5LCBpdCBzaG91bGQgaGF2 ZQorZG91YmxlLWNoZWNrZWQgdGhlIGZpbmdlcnByaW50IGFyZ3VtZW50IHRvIHRoZSBcIktF WV9DT05TSURFUkVEXCIKK3N0YXR1cyBrZXl3b3JkIGluc3RlYWQgb2YgaWdub3JpbmcgaXQu IgogICAodW53aW5kLXByb3RlY3QKICAgICAgIChwcm9nbgogCShlcGctc3RhcnQtZWRpdC1r ZXkgY29udGV4dCBrZXkgZWRpdC1jYWxsYmFjayBoYW5kYmFjaykKLS0gCjIuMzAuMgoK --------------BUS5hER7bXTecyRITT9H1ltV--