From unknown Sat Jun 21 10:17:33 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#37410 <37410@debbugs.gnu.org> To: bug#37410 <37410@debbugs.gnu.org> Subject: Status: [PATCH] Several doc fixes in package.el Reply-To: bug#37410 <37410@debbugs.gnu.org> Date: Sat, 21 Jun 2025 17:17:33 +0000 retitle 37410 [PATCH] Several doc fixes in package.el reassign 37410 emacs submitter 37410 Stefan Kangas severity 37410 minor tag 37410 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 15 12:01:41 2019 Received: (at submit) by debbugs.gnu.org; 15 Sep 2019 16:01:41 +0000 Received: from localhost ([127.0.0.1]:48660 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9Wy4-00051r-Nj for submit@debbugs.gnu.org; Sun, 15 Sep 2019 12:01:41 -0400 Received: from lists.gnu.org ([209.51.188.17]:56547) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9Wy2-00051h-JG for submit@debbugs.gnu.org; Sun, 15 Sep 2019 12:01:39 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50363) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i9Wxz-0001XY-St for bug-gnu-emacs@gnu.org; Sun, 15 Sep 2019 12:01:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: ** X-Spam-Status: No, score=2.9 required=5.0 tests=BAYES_50,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,SPOOFED_FREEMAIL autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i9Wxx-0002Ce-Tk for bug-gnu-emacs@gnu.org; Sun, 15 Sep 2019 12:01:35 -0400 Received: from mail-pf1-f177.google.com ([209.85.210.177]:35892) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i9Wxv-0002A3-HH for bug-gnu-emacs@gnu.org; Sun, 15 Sep 2019 12:01:32 -0400 Received: by mail-pf1-f177.google.com with SMTP id y22so21098839pfr.3 for ; Sun, 15 Sep 2019 09:01:29 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=7DWjySS8PUs0OpDg2hvvgXAl9JoS4PQC0AQSc1o7YA4=; b=L5+y6cMxEielZeMQzZYkbZJZ6d0BrLMs/MRs41+/BDEN1QA41WokNEyTFy8kMcuBVA a/ZwbL7EkDuVHvIueXNMwP+gjOpfke0AOUqBLTbkQgr7iVKjC+1SfQyMkSkH+mRApXpy vKJatVMmqEma/2ohVt17vZ0z91qHebOtHPEX9DOiNr9jJcxSjK0e3WN+Pt1tFCvR3ta4 YcJ2JRjaQhlenbAA9F485L8fa+/xQ0jGNa0Ay1VZIBICedLVKW0f/OqpCfC8aq3HMPXi /BYz2XaMiVqUvS5pKVV19bm27qd/UKXUVwhdstJds3dJGqeqd3zQCOJLciux9nKg4Oid 9OWw== X-Gm-Message-State: APjAAAVzUKZMr6syPiOrDxJRbPp12YCprsnZx18q41dfESjyN9wcQ4vH tBXvlpNYhQfOtSg+D+kcfv58Fbdn7Ise8SlwmiKzJw== X-Google-Smtp-Source: APXvYqxnUl02KoD9D2fkxWHUERSHsGSQYIb5G4DFnHB7xcOGia3qUJc7Tk37daJ2W1vH7wqYNuKW/86jc1A81/s+RQ4= X-Received: by 2002:a17:90a:8d0c:: with SMTP id c12mr16281850pjo.119.1568563288207; Sun, 15 Sep 2019 09:01:28 -0700 (PDT) MIME-Version: 1.0 From: Stefan Kangas Date: Sun, 15 Sep 2019 18:01:17 +0200 Message-ID: Subject: [PATCH] Several doc fixes in package.el To: bug-gnu-emacs@gnu.org Content-Type: multipart/mixed; boundary="0000000000009a1fb9059299996c" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.210.177 X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Seeing as the documentation in package.el leaves much to be desired, I spent some time adding doc strings and fixing checkdoc and stylistic errors. I've attached a patch with my results, which should [...] Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -2.3 RCVD_IN_DNSWL_MED RBL: Sender listed at https://www.dnswl.org/, medium trust [209.51.188.17 listed in list.dnswl.org] 0.2 HEADER_FROM_DIFFERENT_DOMAINS From and EnvelopeFrom 2nd level mail domains are different 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (stefankangas[at]gmail.com) 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail) 0.2 FREEMAIL_FORGED_FROMDOMAIN 2nd level domains in From and EnvelopeFrom freemail headers are different 2.1 SPOOFED_FREEMAIL No description available. X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) --0000000000009a1fb9059299996c Content-Type: text/plain; charset="UTF-8" Seeing as the documentation in package.el leaves much to be desired, I spent some time adding doc strings and fixing checkdoc and stylistic errors. I've attached a patch with my results, which should improve the situation a little bit at least. Is this okay to install? Best regards, Stefan Kangas --0000000000009a1fb9059299996c Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Several-doc-fixes-in-package.el.patch" Content-Disposition: attachment; filename="0001-Several-doc-fixes-in-package.el.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_k0l62drd0 RnJvbSBhNWMzMjQwMjhkZDAwMWEzYTc1OTUzNGI5OTg2NmFmYTA1YTI1MzViIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTdW4sIDE1IFNlcCAyMDE5IDE3OjQxOjI3ICswMjAwClN1YmplY3Q6IFtQQVRDSF0g U2V2ZXJhbCBkb2MgZml4ZXMgaW4gcGFja2FnZS5lbAoKKiBsaXNwL2VtYWNzLWxpc3AvcGFja2Fn ZS5lbCAodG9wLWxldmVsKQoocGFja2FnZS1jaGVjay1zaWduYXR1cmUsIHBhY2thZ2UtLWZyb20t YnVpbHRpbikKKHBhY2thZ2UtZGVzYy1mdWxsLW5hbWUsIHBhY2thZ2UtZGVzYy1zdWZmaXgpCihw YWNrYWdlLWRlc2MtLWtleXdvcmRzLCBwYWNrYWdlLS1iaS1kZXNjKQoocGFja2FnZS1wcm9jZXNz LWRlZmluZS1wYWNrYWdlLCBwYWNrYWdlLWFyY2hpdmUtYmFzZSkKKHBhY2thZ2UtaW5zdGFsbC1m cm9tLWFyY2hpdmUsIHBhY2thZ2UtaW5zdGFsbC1mcm9tLWJ1ZmZlcikKKHBhY2thZ2UtaW5zdGFs bC1maWxlLCBwYWNrYWdlLWF1dG9yZW1vdmUsIGRlc2NyaWJlLXBhY2thZ2UtMSkKKHBhY2thZ2Ut aW5zdGFsbC1idXR0b24tYWN0aW9uLCBwYWNrYWdlLWRlbGV0ZS1idXR0b24tYWN0aW9uKQoocGFj a2FnZS1rZXl3b3JkLWJ1dHRvbi1hY3Rpb24sIHBhY2thZ2UtbWFrZS1idXR0b24pCihwYWNrYWdl LS1wcmludC1lbWFpbC1idXR0b24sIHBhY2thZ2UtbGlzdC11bnZlcnNpb25lZCkKKHBhY2thZ2Ut LWVtYWNzLXZlcnNpb24tbGlzdCwgcGFja2FnZS1tZW51LXRvZ2dsZS1oaWRpbmcpCihwYWNrYWdl LWhpZGRlbi1yZWdleHBzLCBwYWNrYWdlLW1lbnUtaGlkZS1wYWNrYWdlKQoocGFja2FnZS1tZW51 LWdldC1zdGF0dXMsIHBhY2thZ2UtbWVudS0tZmluZC11cGdyYWRlcykKKHBhY2thZ2UtbWVudS0t cG9zdC1yZWZyZXNoKTogRG9jIGZpeGVzLgotLS0KIGxpc3AvZW1hY3MtbGlzcC9wYWNrYWdlLmVs IHwgODUgKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLS0tLS0KIDEgZmlsZSBjaGFu Z2VkLCA2NSBpbnNlcnRpb25zKCspLCAyMCBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9saXNw L2VtYWNzLWxpc3AvcGFja2FnZS5lbCBiL2xpc3AvZW1hY3MtbGlzcC9wYWNrYWdlLmVsCmluZGV4 IGVmMGM1MTcxZGUuLmVkYzYyYzUzOTQgMTAwNjQ0Ci0tLSBhL2xpc3AvZW1hY3MtbGlzcC9wYWNr YWdlLmVsCisrKyBiL2xpc3AvZW1hY3MtbGlzcC9wYWNrYWdlLmVsCkBAIC0xMjAsOSArMTIwLDkg QEAKIDs7IC0gImluc3RhbGxlZCIgaW5zdGVhZCBvZiBhIGJsYW5rIGluIHRoZSBzdGF0dXMgY29s dW1uCiA7OyAtIHRyYW1wIG5lZWRzIGl0cyBmaWxlcyB0byBiZSBjb21waWxlZCBpbiBhIGNlcnRh aW4gb3JkZXIuCiA7OyAgIGhvdyB0byBoYW5kbGUgdGhpcz8gIGZpeCB0cmFtcD8KLTs7IC0gbWF5 YmUgd2UgbmVlZCBzZXBhcmF0ZSAuZWxjIGRpcmVjdG9yaWVzIGZvciB2YXJpb3VzIGVtYWNzIHZl cnNpb25zCi07OyAgIGFuZCBhbHNvIGVtYWNzLXZzLXhlbWFjcy4gIFRoYXQgd2F5IGNvbmRpdGlv bmFsIGNvbXBpbGF0aW9uIGNhbgotOzsgICB3b3JrLiAgQnV0IHdvdWxkIHRoaXMgYnJlYWsgYW55 dGhpbmc/Cis7OyAtIG1heWJlIHdlIG5lZWQgc2VwYXJhdGUgLmVsYyBkaXJlY3RvcmllcyBmb3Ig dmFyaW91cyBlbWFjcworOzsgICB2ZXJzaW9ucy4gIFRoYXQgd2F5IGNvbmRpdGlvbmFsIGNvbXBp bGF0aW9uIGNhbiB3b3JrLiAgQnV0IHdvdWxkCis7OyAgIHRoaXMgYnJlYWsgYW55dGhpbmc/CiA7 OyAtIFdpbGxpYW0gWHUgc3VnZ2VzdHMgYmVpbmcgYWJsZSB0byBvcGVuIGEgcGFja2FnZSBmaWxl IHdpdGhvdXQKIDs7ICAgaW5zdGFsbGluZyBpdAogOzsgLSBJbnRlcmZhY2Ugd2l0aCBkZXNrdG9w LmVsIHNvIHRoYXQgcmVzdGFydGluZyBhZnRlciBhbiBpbnN0YWxsCkBAIC0zNTQsOSArMzU0LDkg QEAgcGFja2FnZS1jaGVjay1zaWduYXR1cmUKIAogKGRlZnVuIHBhY2thZ2UtY2hlY2stc2lnbmF0 dXJlICgpCiAgICJDaGVjayB3aGV0aGVyIHdlIGhhdmUgYSB1c2FibGUgT3BlblBHUCBjb25maWd1 cmF0aW9uLgotSWYgdHJ1ZSwgYW5kIGBwYWNrYWdlLWNoZWNrLXNpZ25hdHVyZScgaXMgYGFsbG93 LXVuc2lnbmVkJywKLXJldHVybiBgYWxsb3ctdW5zaWduZWQnLCBvdGhlcndpc2UgcmV0dXJuIHRo ZSB2YWx1ZSBvZgotYHBhY2thZ2UtY2hlY2stc2lnbmF0dXJlJy4iCitJZiB0cnVlLCBhbmQgdmFy aWFibGUgYHBhY2thZ2UtY2hlY2stc2lnbmF0dXJlJyBpcworYGFsbG93LXVuc2lnbmVkJywgcmV0 dXJuIGBhbGxvdy11bnNpZ25lZCcsIG90aGVyd2lzZSByZXR1cm4gdGhlCit2YWx1ZSBvZiB2YXJp YWJsZSBgcGFja2FnZS1jaGVjay1zaWduYXR1cmUnLiIKICAgKGlmIChlcSBwYWNrYWdlLWNoZWNr LXNpZ25hdHVyZSAnYWxsb3ctdW5zaWduZWQpCiAgICAgICAocHJvZ24KICAgICAgICAgKHJlcXVp cmUgJ2VwZy1jb25maWcpCkBAIC00NzIsNiArNDcyLDggQEAgcGFja2FnZS0tZGVmYXVsdC1zdW1t YXJ5CiAgIHNpZ25lZCkKIAogKGRlZnVuIHBhY2thZ2UtLWZyb20tYnVpbHRpbiAoYmktZGVzYykK KyAgIkNyZWF0ZSBhIGBwYWNrYWdlLWRlc2MnIG9iamVjdCBmcm9tIEJJLURFU0MuCitCSS1ERVND IHNob3VsZCBiZSBhbiBgcGFja2FnZS0tYmktZGVzYycgb2JqZWN0LiIKICAgKHBhY2thZ2UtZGVz Yy1jcmVhdGUgOm5hbWUgKHBvcCBiaS1kZXNjKQogICAgICAgICAgICAgICAgICAgICAgICA6dmVy c2lvbiAocGFja2FnZS0tYmktZGVzYy12ZXJzaW9uIGJpLWRlc2MpCiAgICAgICAgICAgICAgICAg ICAgICAgIDpzdW1tYXJ5IChwYWNrYWdlLS1iaS1kZXNjLXN1bW1hcnkgYmktZGVzYykKQEAgLTUw OSwxMSArNTExLDIyIEBAIHBhY2thZ2UtdmVyc2lvbi1qb2luCiAgICAgICAoYXBwbHkgIydjb25j YXQgKG5yZXZlcnNlIHN0ci1saXN0KSkpKSkKIAogKGRlZnVuIHBhY2thZ2UtZGVzYy1mdWxsLW5h bWUgKHBrZy1kZXNjKQorICAiUmV0dXJuIGZ1bGwgbmFtZSBvZiBwYWNrYWdlLWRlc2Mgb2JqZWN0 IFBLRy1ERVNDLgorRm9yIGV4YW1wbGUsIGlmIHRoZSBwYWNrYWdlIGlzIG5hbWVkIFwiZm9vXCIg YW5kIGhhcyB2ZXJzaW9uCitcIjEuMi4zXCIsIHRoZW4gcmV0dXJuIFwiZm9vLTEuMi4zXCIuIgog ICAoZm9ybWF0ICIlcy0lcyIKICAgICAgICAgICAocGFja2FnZS1kZXNjLW5hbWUgcGtnLWRlc2Mp CiAgICAgICAgICAgKHBhY2thZ2UtdmVyc2lvbi1qb2luIChwYWNrYWdlLWRlc2MtdmVyc2lvbiBw a2ctZGVzYykpKSkKIAogKGRlZnVuIHBhY2thZ2UtZGVzYy1zdWZmaXggKHBrZy1kZXNjKQorICAi UmV0dXJuIHN1ZmZpeCBvZiBwYWNrYWdlLWRlc2Mgb2JqZWN0IFBLRy1ERVNDLgorRGVwZW5kaW5n IG9uIHRoZSBgcGFja2FnZS1kZXNjLWtpbmQnIG9mIFBLRy1ERVNDLCB0aGlzIGlzIG9uZSBvZjoK KworICAgJ3NpbmdsZSAtIFwiLmVsXCIKKyAgICd0YXIgICAgLSBcIi50YXJcIgorICAgJ2RpciAg ICAtIFwiXCIKKworSWYgdGhlIGtpbmQgaXMgbm9uZSBvZiB0aGUgYWJvdmUsIHNpZ25hbCBhbiBl cnJvci4iCiAgIChwY2FzZSAocGFja2FnZS1kZXNjLWtpbmQgcGtnLWRlc2MpCiAgICAgKCdzaW5n bGUgIi5lbCIpCiAgICAgKCd0YXIgIi50YXIiKQpAQCAtNTIxLDYgKzUzNCw3IEBAIHBhY2thZ2Ut ZGVzYy1zdWZmaXgKICAgICAoa2luZCAoZXJyb3IgIlVua25vd24gcGFja2FnZSBraW5kOiAlcyIg a2luZCkpKSkKIAogKGRlZnVuIHBhY2thZ2UtZGVzYy0ta2V5d29yZHMgKHBrZy1kZXNjKQorICAi UmV0dXJuIGtleXdvcmRzIG9mIHBhY2thZ2UtZGVzYyBvYmplY3QgUEtHLURFU0MuIgogICAobGV0 ICgoa2V5d29yZHMgKGNkciAoYXNzb2MgOmtleXdvcmRzIChwYWNrYWdlLWRlc2MtZXh0cmFzIHBr Zy1kZXNjKSkpKSkKICAgICAoaWYgKGVxIChjYXItc2FmZSBrZXl3b3JkcykgJ3F1b3RlKQogICAg ICAgICAobnRoIDEga2V5d29yZHMpCkBAIC01MzAsMTAgKzU0NCwxMCBAQCBwYWNrYWdlLWRlc2Mt cHJpb3JpdHkKICAgIlJldHVybiB0aGUgcHJpb3JpdHkgb2YgdGhlIGFyY2hpdmUgb2YgcGFja2Fn ZS1kZXNjIG9iamVjdCBQLiIKICAgKHBhY2thZ2UtYXJjaGl2ZS1wcmlvcml0eSAocGFja2FnZS1k ZXNjLWFyY2hpdmUgcCkpKQogCi07OyBQYWNrYWdlIGRlc2NyaXB0b3IgZm9ybWF0IHVzZWQgaW4g ZmluZGVyLWluZi5lbCBhbmQgcGFja2FnZS0tYnVpbHRpbnMuCiAoY2wtZGVmc3RydWN0IChwYWNr YWdlLS1iaS1kZXNjCiAgICAgICAgICAgICAgICAoOmNvbnN0cnVjdG9yIHBhY2thZ2UtbWFrZS1i dWlsdGluICh2ZXJzaW9uIHN1bW1hcnkpKQogICAgICAgICAgICAgICAgKDp0eXBlIHZlY3Rvcikp CisgICJQYWNrYWdlIGRlc2NyaXB0b3IgZm9ybWF0IHVzZWQgaW4gZmluZGVyLWluZi5lbCBhbmQg cGFja2FnZS0tYnVpbHRpbnMuIgogICB2ZXJzaW9uCiAgIHJlcXMKICAgc3VtbWFyeSkKQEAgLTU3 NSw3ICs1ODksMTUgQEAgcGFja2FnZS1hY3RpdmF0ZWQtbGlzdAogOzsgVGhlIGZvbGxvd2luZyBm dW5jdGlvbnMgYXJlIGNhbGxlZCBvbiBlYWNoIGluc3RhbGxlZCBwYWNrYWdlIGJ5CiA7OyBgcGFj a2FnZS1sb2FkLWFsbC1kZXNjcmlwdG9ycycsIHdoaWNoIHVsdGltYXRlbHkgcG9wdWxhdGVzIHRo ZQogOzsgYHBhY2thZ2UtYWxpc3QnIHZhcmlhYmxlLgorCiAoZGVmdW4gcGFja2FnZS1wcm9jZXNz LWRlZmluZS1wYWNrYWdlIChleHApCisgICJQcm9jZXNzIGRlZmluZS1wYWNrYWdlIGV4cHJlc3Np b24gRVhQIGFuZCBwdXNoIGl0IHRvIGBwYWNrYWdlLWFsaXN0Jy4KK0VYUCBzaG91bGQgYmUgYSBm b3JtIHJlYWQgZnJvbSBhIGZvby1wa2cuZWwgZmlsZS4KK0NvbnZlcnQgRVhQIGludG8gYSBgcGFj a2FnZS1kZXNjJyBvYmplY3QgdXNpbmcgdGhlCitgcGFja2FnZS1kZXNjLWZyb20tZGVmaW5lJyBj b25zdHJ1Y3RvciBiZWZvcmUgcHVzaGluZyBpdCB0bworYHBhY2thZ2UtYWxpc3QuCitJZiB0aGVy ZSBhbHJlYWR5IGV4aXN0cyBhIHBhY2thZ2UgYnkgdGhhdCBuYW1lIGluCitgcGFja2FnZS1hbGlz dCcsIHJlcGxhY2UgdGhhdCBkZWZpbml0aW9uIHdpdGggdGhlIG5ldyBvbmUuIgogICAod2hlbiAo ZXEgKGNhci1zYWZlIGV4cCkgJ2RlZmluZS1wYWNrYWdlKQogICAgIChsZXQqICgobmV3LXBrZy1k ZXNjIChhcHBseSAjJ3BhY2thZ2UtZGVzYy1mcm9tLWRlZmluZSAoY2RyIGV4cCkpKQogICAgICAg ICAgICAobmFtZSAocGFja2FnZS1kZXNjLW5hbWUgbmV3LXBrZy1kZXNjKSkKQEAgLTg2Niw2ICs4 ODgsNyBAQCBwYWNrYWdlLS1hbGlzdC10by1wbGlzdC1hcmdzCiAgIChtYXBjYXIgIydtYWNyb2V4 cC1xdW90ZQogICAgICAgICAgIChhcHBseSAjJ25jb25jCiAgICAgICAgICAgICAgICAgIChtYXBj YXIgKGxhbWJkYSAocGFpcikgKGxpc3QgKGNhciBwYWlyKSAoY2RyIHBhaXIpKSkgYWxpc3QpKSkp CisKIChkZWZ1biBwYWNrYWdlLXVucGFjayAocGtnLWRlc2MpCiAgICJJbnN0YWxsIHRoZSBjb250 ZW50cyBvZiB0aGUgY3VycmVudCBidWZmZXIgYXMgYSBwYWNrYWdlLiIKICAgKGxldCogKChuYW1l IChwYWNrYWdlLWRlc2MtbmFtZSBwa2ctZGVzYykpCkBAIC0xOTAwLDExICsxOTIzLDExIEBAIHBh Y2thZ2UtLXNvcnQtYnktZGVwZW5kZW5jZQogOzsgcmVxdWlyZW1lbnRzIChkZXBlbmRlbmNpZXMp IGFyZSBhbHdheXMgc2F0aXNmaWVkIGJ5IGxvb2tpbmcgaW4KIDs7IGBwYWNrYWdlLWFyY2hpdmUt Y29udGVudHMnLgogKGRlZnVuIHBhY2thZ2UtYXJjaGl2ZS1iYXNlIChkZXNjKQotICAiUmV0dXJu IHRoZSBhcmNoaXZlIGNvbnRhaW5pbmcgdGhlIHBhY2thZ2UgTkFNRS4iCisgICJSZXR1cm4gdGhl IGFyY2hpdmUgY29udGFpbmluZyB0aGUgcGFja2FnZSBERVNDLiIKICAgKGNkciAoYXNzb2MgKHBh Y2thZ2UtZGVzYy1hcmNoaXZlIGRlc2MpIHBhY2thZ2UtYXJjaGl2ZXMpKSkKIAogKGRlZnVuIHBh Y2thZ2UtaW5zdGFsbC1mcm9tLWFyY2hpdmUgKHBrZy1kZXNjKQotICAiRG93bmxvYWQgYW5kIGlu c3RhbGwgYSB0YXIgcGFja2FnZS4iCisgICJEb3dubG9hZCBhbmQgaW5zdGFsbCBhIHRhciBwYWNr YWdlIGRlZmluZWQgYnkgUEtHLURFU0MuIgogICA7OyBUaGlzIHdvbid0IGhhcHBlbiwgdW5sZXNz IHRoZSBhcmNoaXZlIGlzIGRvaW5nIHNvbWV0aGluZyB3cm9uZy4KICAgKHdoZW4gKGVxIChwYWNr YWdlLWRlc2Mta2luZCBwa2ctZGVzYykgJ2RpcikKICAgICAoZXJyb3IgIkNhbid0IGluc3RhbGwg ZGlyZWN0b3J5IHBhY2thZ2UgZnJvbSBhcmNoaXZlIikpCkBAIC0yMDQzLDcgKzIwNjYsNyBAQCBw YWNrYWdlLXN0cmlwLXJjcy1pZAogCiA7OzsjIyNhdXRvbG9hZAogKGRlZnVuIHBhY2thZ2UtaW5z dGFsbC1mcm9tLWJ1ZmZlciAoKQotICAiSW5zdGFsbCBhIHBhY2thZ2UgZnJvbSB0aGUgY3VycmVu dCBidWZmZXIuCisgICJJbnN0YWxsIHBhY2thZ2UgZnJvbSBjdXJyZW50IGJ1ZmZlci4KIFRoZSBj dXJyZW50IGJ1ZmZlciBpcyBhc3N1bWVkIHRvIGJlIGEgc2luZ2xlIC5lbCBvciAudGFyIGZpbGUg b3IKIGEgZGlyZWN0b3J5LiAgVGhlc2UgbXVzdCBmb2xsb3cgdGhlIHBhY2thZ2luZyBndWlkZWxp bmVzIChzZWUKIGluZm8gbm9kZSBgKGVsaXNwKVBhY2thZ2luZycpLgpAQCAtMjA4MSw3ICsyMTA0 LDcgQEAgcGFja2FnZS1pbnN0YWxsLWZyb20tYnVmZmVyCiAKIDs7OyMjI2F1dG9sb2FkCiAoZGVm dW4gcGFja2FnZS1pbnN0YWxsLWZpbGUgKGZpbGUpCi0gICJJbnN0YWxsIGEgcGFja2FnZSBmcm9t IGEgZmlsZS4KKyAgIkluc3RhbGwgcGFja2FnZSBmcm9tIEZJTEUuCiBUaGUgZmlsZSBjYW4gZWl0 aGVyIGJlIGEgdGFyIGZpbGUsIGFuIEVtYWNzIExpc3AgZmlsZSwgb3IgYQogZGlyZWN0b3J5LiIK ICAgKGludGVyYWN0aXZlICJmUGFja2FnZSBmaWxlIG5hbWU6ICIpCkBAIC0yMjE3LDcgKzIyNDAs NyBAQCBwYWNrYWdlLXJlaW5zdGFsbAogCiA7OzsjIyNhdXRvbG9hZAogKGRlZnVuIHBhY2thZ2Ut YXV0b3JlbW92ZSAoKQotICAiUmVtb3ZlIHBhY2thZ2VzIHRoYXQgYXJlIG5vIG1vcmUgbmVlZGVk LgorICAiUmVtb3ZlIHBhY2thZ2VzIHRoYXQgYXJlIG5vIGxvbmdlciBuZWVkZWQuCiAKIFBhY2th Z2VzIHRoYXQgYXJlIG5vIG1vcmUgbmVlZGVkIGJ5IG90aGVyIHBhY2thZ2VzIGluCiBgcGFja2Fn ZS1zZWxlY3RlZC1wYWNrYWdlcycgYW5kIHRoZWlyIGRlcGVuZGVuY2llcwpAQCAtMjMzNCw2ICsy MzU3LDggQEAgcGFja2FnZS0tZ2V0LWRlc2NyaXB0aW9uCiAgICAgICkpKQogCiAoZGVmdW4gZGVz Y3JpYmUtcGFja2FnZS0xIChwa2cpCisgICJJbnNlcnQgcGFja2FnZSBkZXNjcmlwdGlvbiBvZiBQ S0cgYXQgcG9pbnQuCitIZWxwZXIgZnVuY3Rpb24gZm9yIGBkZXNjcmliZS1wYWNrYWdlJy4iCiAg IChyZXF1aXJlICdsaXNwLW1udCkKICAgKGxldCogKChkZXNjIChvcgogICAgICAgICAgICAgICAg IChpZiAocGFja2FnZS1kZXNjLXAgcGtnKSBwa2cpCkBAIC0yNTYzLDYgKzI1ODgsOSBAQCBkZXNj cmliZS1wYWNrYWdlLTEKICAgICAgIChicm93c2UtdXJsLWFkZC1idXR0b25zKSkpKQogCiAoZGVm dW4gcGFja2FnZS1pbnN0YWxsLWJ1dHRvbi1hY3Rpb24gKGJ1dHRvbikKKyAgIlJ1biBgcGFja2Fn ZS1pbnN0YWxsJyBvbiBwYWNrYWdlIGRlZmluZWQgYnkgQlVUVE9OLgorVXNlZCBmb3IgdGhlICdh Y3Rpb24gcHJvcGVydHkgb2YgYnV0dG9ucyBpbiB0aGUgYnVmZmVyIGNyZWF0ZWQgYnkKK2BkZXNj cmliZS1wYWNrYWdlJy4iCiAgIChsZXQgKChwa2ctZGVzYyAoYnV0dG9uLWdldCBidXR0b24gJ3Bh Y2thZ2UtZGVzYykpKQogICAgICh3aGVuICh5LW9yLW4tcCAoZm9ybWF0LW1lc3NhZ2UgIkluc3Rh bGwgcGFja2FnZSBgJXMnPyAiCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAo cGFja2FnZS1kZXNjLWZ1bGwtbmFtZSBwa2ctZGVzYykpKQpAQCAtMjU3MSw2ICsyNTk5LDkgQEAg cGFja2FnZS1pbnN0YWxsLWJ1dHRvbi1hY3Rpb24KICAgICAgIChnb3RvLWNoYXIgKHBvaW50LW1p bikpKSkpCiAKIChkZWZ1biBwYWNrYWdlLWRlbGV0ZS1idXR0b24tYWN0aW9uIChidXR0b24pCisg ICJSdW4gYHBhY2thZ2UtZGVsZXRlJyBvbiBwYWNrYWdlIGRlZmluZWQgYnkgQlVUVE9OLgorVXNl ZCBmb3IgdGhlICdhY3Rpb24gcHJvcGVydHkgb2YgYnV0dG9ucyBpbiB0aGUgYnVmZmVyIGNyZWF0 ZWQgYnkKK2BkZXNjcmliZS1wYWNrYWdlJy4iCiAgIChsZXQgKChwa2ctZGVzYyAoYnV0dG9uLWdl dCBidXR0b24gJ3BhY2thZ2UtZGVzYykpKQogICAgICh3aGVuICh5LW9yLW4tcCAoZm9ybWF0LW1l c3NhZ2UgIkRlbGV0ZSBwYWNrYWdlIGAlcyc/ICIKICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgIChwYWNrYWdlLWRlc2MtZnVsbC1uYW1lIHBrZy1kZXNjKSkpCkBAIC0yNTc5LDEw ICsyNjEwLDE2IEBAIHBhY2thZ2UtZGVsZXRlLWJ1dHRvbi1hY3Rpb24KICAgICAgIChnb3RvLWNo YXIgKHBvaW50LW1pbikpKSkpCiAKIChkZWZ1biBwYWNrYWdlLWtleXdvcmQtYnV0dG9uLWFjdGlv biAoYnV0dG9uKQorICAiU2hvdyAqUGFja2FnZXMqIGJ1ZmZlciBmaWx0ZXJlZCBieSBrZXl3b3Jk IGZyb20gQlVUVE9OIGxhYmVsLgorVXNlZCBmb3IgdGhlICdhY3Rpb24gcHJvcGVydHkgb2YgYnV0 dG9ucyBpbiB0aGUgYnVmZmVyIGNyZWF0ZWQgYnkKK2BkZXNjcmliZS1wYWNrYWdlJy4iCiAgIChs ZXQgKChwa2cta2V5d29yZCAoYnV0dG9uLWdldCBidXR0b24gJ3BhY2thZ2Uta2V5d29yZCkpKQog ICAgIChwYWNrYWdlLXNob3ctcGFja2FnZS1saXN0IHQgKGxpc3QgcGtnLWtleXdvcmQpKSkpCiAK LShkZWZ1biBwYWNrYWdlLW1ha2UtYnV0dG9uICh0ZXh0ICZyZXN0IHByb3BzKQorKGRlZnVuIHBh Y2thZ2UtbWFrZS1idXR0b24gKHRleHQgJnJlc3QgcHJvcGVydGllcykKKyAgIkluc2VydCBidXR0 b24gbGFiZWxsZWQgVEVYVCB3aXRoIGJ1dHRvbiBQUk9QRVJUSUVTIGF0IHBvaW50LgorUFJPUEVS VElFUyBhcmUgcGFzc2VkIHRvIGBpbnNlcnQtdGV4dC1idXR0b24nLCBmb3Igd2hpY2ggdGhpcwor ZnVuY3Rpb24gaXMgYSBjb252ZW5pZW5jZSB3cmFwcGVyIHVzZWQgYnkgYGRlc2NyaWJlLXBhY2th Z2UtMScuIgogICAobGV0ICgoYnV0dG9uLXRleHQgKGlmIChkaXNwbGF5LWdyYXBoaWMtcCkgdGV4 dCAoY29uY2F0ICJbIiB0ZXh0ICJdIikpKQogICAgICAgICAoYnV0dG9uLWZhY2UgKGlmIChkaXNw bGF5LWdyYXBoaWMtcCkKICAgICAgICAgICAgICAgICAgICAgICAgICAnKDpib3ggKDpsaW5lLXdp ZHRoIDIgOmNvbG9yICJkYXJrIGdyZXkiKQpAQCAtMjU5MCw5ICsyNjI3LDEyIEBAIHBhY2thZ2Ut bWFrZS1idXR0b24KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgOmZvcmVncm91bmQg ImJsYWNrIikKICAgICAgICAgICAgICAgICAgICAgICAgJ2xpbmspKSkKICAgICAoYXBwbHkgIydp bnNlcnQtdGV4dC1idXR0b24gYnV0dG9uLXRleHQgJ2ZhY2UgYnV0dG9uLWZhY2UgJ2ZvbGxvdy1s aW5rIHQKLSAgICAgICAgICAgcHJvcHMpKSkKKyAgICAgICAgICAgcHJvcGVydGllcykpKQogCiAo ZGVmdW4gcGFja2FnZS0tcHJpbnQtZW1haWwtYnV0dG9uIChuYW1lKQorICAiSW5zZXJ0IGEgYnV0 dG9uIHRvIGVtYWlsIE5BTUUgYXQgcG9pbnQuCitOQU1FIHNob3VsZCBoYXZlIHRoZSBmb3JtIChG VUxMTkFNRSAuIEVNQUlMKSB3aGVyZSBOQU1FIGlzIGVpdGhlcgorYSBmdWxsIG5hbWUgb3Igbmls LCBhbmQgRU1BSUwgaXMgYSB2YWxpZCBlbWFpbCBhZGRyZXNzLiIKICAgKHdoZW4gKGNhciBuYW1l KQogICAgIChpbnNlcnQgKGNhciBuYW1lKSkpCiAgICh3aGVuIChhbmQgKGNhciBuYW1lKSAoY2Ry IG5hbWUpKQpAQCAtMjcwMSwxMyArMjc0MSwxMyBAQCBwYWNrYWdlLS1wdXNoCiAgICAgIChwdXNo IChjb25zICxwa2ctZGVzYyAsc3RhdHVzKSAsbGlzdG5hbWUpKSkKIAogKGRlZnZhciBwYWNrYWdl LWxpc3QtdW52ZXJzaW9uZWQgbmlsCi0gICJJZiBub24tbmlsIGluY2x1ZGUgcGFja2FnZXMgdGhh dCBkb24ndCBoYXZlIGEgdmVyc2lvbiBpbiBgbGlzdC1wYWNrYWdlJy4iKQorICAiSWYgbm9uLW5p bCwgaW5jbHVkZSBwYWNrYWdlcyB0aGF0IGRvbid0IGhhdmUgYSB2ZXJzaW9uIGluIGBsaXN0LXBh Y2thZ2UnLiIpCiAKIChkZWZ2YXIgcGFja2FnZS1saXN0LXVuc2lnbmVkIG5pbAogICAiSWYgbm9u LW5pbCwgbWVudGlvbiBpbiB0aGUgbGlzdCB3aGljaCBwYWNrYWdlcyB3ZXJlIGluc3RhbGxlZCB3 L28gc2lnbmF0dXJlLiIpCiAKIChkZWZ2YXIgcGFja2FnZS0tZW1hY3MtdmVyc2lvbi1saXN0ICh2 ZXJzaW9uLXRvLWxpc3QgZW1hY3MtdmVyc2lvbikKLSAgImBlbWFjcy12ZXJzaW9uJywgYXMgYSBs aXN0LiIpCisgICJWYXJpYWJsZSBgZW1hY3MtdmVyc2lvbicgYXMgYSBsaXN0LiIpCiAKIChkZWZ1 biBwYWNrYWdlLS1pbmNvbXBhdGlibGUtcCAocGtnICZvcHRpb25hbCBzaGFsbG93KQogICAiUmV0 dXJuIG5vbi1uaWwgaWYgUEtHIGhhcyBubyBjaGFuY2Ugb2YgYmVpbmcgaW5zdGFsbGFibGUuCkBA IC0yNzgyLDcgKzI4MjIsNyBAQCBwYWNrYWdlLW1lbnUtLWhpZGUtcGFja2FnZXMKIEluc3RhbGxl ZCBvYnNvbGV0ZSBwYWNrYWdlcyBhcmUgYWx3YXlzIGRpc3BsYXllZC4iKQogCiAoZGVmdW4gcGFj a2FnZS1tZW51LXRvZ2dsZS1oaWRpbmcgKCkKLSAgIlRvZ2dsZSB2aXNpYmlsaXR5IG9mIG9ic29s ZXRlIGF2YWlsYWJsZSBwYWNrYWdlcy4iCisgICJJbiBQYWNrYWdlIE1lbnUsIHRvZ2dsZSB2aXNp YmlsaXR5IG9mIG9ic29sZXRlIGF2YWlsYWJsZSBwYWNrYWdlcy4iCiAgIChpbnRlcmFjdGl2ZSkK ICAgKHVubGVzcyAoZGVyaXZlZC1tb2RlLXAgJ3BhY2thZ2UtbWVudS1tb2RlKQogICAgICh1c2Vy LWVycm9yICJUaGUgY3VycmVudCBidWZmZXIgaXMgbm90IGEgUGFja2FnZSBNZW51IikpCkBAIC0y ODQwLDcgKzI4ODAsNyBAQCBwYWNrYWdlLWhpZGRlbi1yZWdleHBzCiBvbWl0dGVkIGZyb20gdGhl IHBhY2thZ2UgbWVudS4gIFRvIHRvZ2dsZSB0aGlzLCB0eXBlIFxcW3BhY2thZ2UtbWVudS10b2dn bGUtaGlkaW5nXS4KIAogVmFsdWVzIGNhbiBiZSBpbnRlcmFjdGl2ZWx5IGFkZGVkIHRvIHRoaXMg bGlzdCBieSB0eXBpbmcKLVxcW3BhY2thZ2UtbWVudS1oaWRlLXBhY2thZ2VdIG9uIGEgcGFja2Fn ZSIKK1xcW3BhY2thZ2UtbWVudS1oaWRlLXBhY2thZ2VdIG9uIGEgcGFja2FnZS4iCiAgIDp2ZXJz aW9uICIyNS4xIgogICA6dHlwZSAnKHJlcGVhdCAocmVnZXhwIDp0YWcgIkhpZGUgcGFja2FnZXMg d2l0aCBuYW1lIG1hdGNoaW5nIikpKQogCkBAIC0zMTAwLDcgKzMxNDAsNyBAQCBwYWNrYWdlLW1l bnUtcmVmcmVzaAogICAocGFja2FnZS1yZWZyZXNoLWNvbnRlbnRzIHBhY2thZ2UtbWVudS1hc3lu YykpCiAKIChkZWZ1biBwYWNrYWdlLW1lbnUtaGlkZS1wYWNrYWdlICgpCi0gICJIaWRlIGEgcGFj a2FnZSB1bmRlciBwb2ludC4KKyAgIkhpZGUgYSBwYWNrYWdlIHVuZGVyIHBvaW50IGluIFBhY2th Z2UgTWVudS4KIElmIG9wdGlvbmFsIGFyZyBCVVRUT04gaXMgbm9uLW5pbCwgZGVzY3JpYmUgaXRz IGFzc29jaWF0ZWQgcGFja2FnZS4iCiAgIChpbnRlcmFjdGl2ZSkKICAgKGRlY2xhcmUgKGludGVy YWN0aXZlLW9ubHkgImNoYW5nZSBgcGFja2FnZS1oaWRkZW4tcmVnZXhwcycgaW5zdGVhZC4iKSkK QEAgLTMxOTksNiArMzIzOSw3IEBAIHBhY2thZ2UtbWVudS1xdWljay1oZWxwCiAgICdwYWNrYWdl LW1lbnUtdmlldy1jb21tZW50YXJ5ICdwYWNrYWdlLW1lbnUtZGVzY3JpYmUtcGFja2FnZSAiMjQu MSIpCiAKIChkZWZ1biBwYWNrYWdlLW1lbnUtZ2V0LXN0YXR1cyAoKQorICAiUmV0dXJuIHN0YXR1 cyB0ZXh0IG9mIHBhY2thZ2UgYXQgcG9pbnQgaW4gUGFja2FnZSBNZW51LiIKICAgKGxldCogKChp ZCAodGFidWxhdGVkLWxpc3QtZ2V0LWlkKSkKICAgICAgICAgIChlbnRyeSAoYW5kIGlkIChhc3Nv YyBpZCB0YWJ1bGF0ZWQtbGlzdC1lbnRyaWVzKSkpKQogICAgIChpZiBlbnRyeQpAQCAtMzIyNCw2 ICszMjY1LDEwIEBAIHBhY2thZ2UtZGVzYy1wcmlvcml0eS12ZXJzaW9uCiAgICAgICAgIChwYWNr YWdlLWRlc2MtdmVyc2lvbiBwa2ctZGVzYykpKQogCiAoZGVmdW4gcGFja2FnZS1tZW51LS1maW5k LXVwZ3JhZGVzICgpCisgICJJbiBQYWNrYWdlIE1lbnUsIHJldHVybiBhbiBhbGlzdCBvZiBwYWNr YWdlcyB0aGF0IGNhbiBiZSB1cGdyYWRlZC4KK1RoZSBhbGlzdCBoYXMgdGhlIHNhbWUgZm9ybSBh cyBgcGFja2FnZS1hbGlzdCcsIG5hbWVseSBhIGxpc3QKK29mIChQS0cgLiBERVNDUyksIGJ1dCB3 aGVyZSBERVNDUyBpcyB0aGUgYHBhY2thZ2UtZGVzYycgb2JqZWN0Citjb3JyZXNwb25kaW5nIHRv IHRoZSBuZXdlciB2ZXJzaW9uLiIKICAgKGxldCAoaW5zdGFsbGVkIGF2YWlsYWJsZSB1cGdyYWRl cykKICAgICA7OyBCdWlsZCBsaXN0IG9mIGluc3RhbGxlZC9hdmFpbGFibGUgcGFja2FnZXMgaW4g dGhpcyBidWZmZXIuCiAgICAgKGRvbGlzdCAoZW50cnkgdGFidWxhdGVkLWxpc3QtZW50cmllcykK QEAgLTM0ODcsNyArMzUzMiw3IEBAIHBhY2thZ2UtbWVudS0tZmluZC1hbmQtbm90aWZ5LXVwZ3Jh ZGVzCiAKIAogKGRlZnVuIHBhY2thZ2UtbWVudS0tcG9zdC1yZWZyZXNoICgpCi0gICJJZiB0aGVy ZSdzIGEgKlBhY2thZ2VzKiBidWZmZXIsIHJldmVydCBpdCBhbmQgY2hlY2sgZm9yIG5ldyBwYWNr YWdlcyBhbmQgdXBncmFkZXMuCisgICJSZXZlcnQgKlBhY2thZ2VzKiBidWZmZXIgYW5kIGNoZWNr IGZvciBuZXcgcGFja2FnZXMgYW5kIHVwZ3JhZGVzLgogRG8gbm90aGluZyBpZiB0aGVyZSdzIG5v ICpQYWNrYWdlcyogYnVmZmVyLgogCiBUaGlzIGZ1bmN0aW9uIGlzIGNhbGxlZCBhZnRlciBgcGFj a2FnZS1yZWZyZXNoLWNvbnRlbnRzJyBhbmQgaXQKLS0gCjIuMjAuMQoK --0000000000009a1fb9059299996c-- From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 15 12:37:07 2019 Received: (at 37410) by debbugs.gnu.org; 15 Sep 2019 16:37:07 +0000 Received: from localhost ([127.0.0.1]:48676 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9XWM-00061t-GU for submit@debbugs.gnu.org; Sun, 15 Sep 2019 12:37:07 -0400 Received: from eggs.gnu.org ([209.51.188.92]:44951) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9XWK-00061O-Nq for 37410@debbugs.gnu.org; Sun, 15 Sep 2019 12:37:05 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:37678) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1i9XWF-0006cZ-Df; Sun, 15 Sep 2019 12:36:59 -0400 Received: from [176.228.60.248] (port=2328 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1i9XWC-0004Qk-Tb; Sun, 15 Sep 2019 12:36:58 -0400 Date: Sun, 15 Sep 2019 19:37:14 +0300 Message-Id: <83a7b5y0qt.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-reply-to: (message from Stefan Kangas on Sun, 15 Sep 2019 18:01:17 +0200) Subject: Re: bug#37410: [PATCH] Several doc fixes in package.el References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 37410 Cc: 37410@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Sun, 15 Sep 2019 18:01:17 +0200 > > Seeing as the documentation in package.el leaves much to be desired, I > spent some time adding doc strings and fixing checkdoc and stylistic > errors. I've attached a patch with my results, which should improve > the situation a little bit at least. Thanks for working on this. > (defun package-check-signature () > "Check whether we have a usable OpenPGP configuration. > -If true, and `package-check-signature' is `allow-unsigned', > -return `allow-unsigned', otherwise return the value of > -`package-check-signature'." > +If true, and variable `package-check-signature' is "True" is inappropriate here. I'd use "If so, and..." instead. > (defun package--from-builtin (bi-desc) > + "Create a `package-desc' object from BI-DESC. > +BI-DESC should be an `package--bi-desc' object." ^^ "a" > (defun package-desc-full-name (pkg-desc) > + "Return full name of package-desc object PKG-DESC. > +For example, if the package is named \"foo\" and has version > +\"1.2.3\", then return \"foo-1.2.3\"." Instead of "for example", it is better to tell explicitly whet this does. E.g.,: "Return full name of package-desc object PKG-DESC. This is the name of the package with its version appended." > (defun package-desc-suffix (pkg-desc) > + "Return suffix of package-desc object PKG-DESC. I'd say "file-name extension" instead of "suffix". > (defun package-desc--keywords (pkg-desc) > + "Return keywords of package-desc object PKG-DESC." Suggest to say something about what these keywords are and where they come from. Otherwise, "keywords" is such a vague term that it's impossible to understand that without reading the code. > +Convert EXP into a `package-desc' object using the > +`package-desc-from-define' constructor before pushing it to > +`package-alist. ^ A closing quote missing there. > (defun package-archive-base (desc) > - "Return the archive containing the package NAME." > + "Return the archive containing the package DESC." I'd say "the package described by DESC". > (defun package-install-from-buffer () > - "Install a package from the current buffer. > + "Install package from current buffer. Why this change? > ;;;###autoload > (defun package-install-file (file) > - "Install a package from a file. > + "Install package from FILE. And this? > (defun describe-package-1 (pkg) > + "Insert package description of PKG at point. > +Helper function for `describe-package'." The "at point" here is ambiguous: does it mean "insert at point" or "PKG at point"? > (defun package-install-button-action (button) > + "Run `package-install' on package defined by BUTTON. Can a package really be defined by a button? > (defun package-keyword-button-action (button) > + "Show *Packages* buffer filtered by keyword from BUTTON label. *Packages* should be in double quotes. I generally find this sentence confusing: what do you mean by "keyword from BUTTON label"? > +(defun package-make-button (text &rest properties) > + "Insert button labelled TEXT with button PROPERTIES at point. ^^^^^^^^ "labeled" > (defun package--print-email-button (name) > + "Insert a button to email NAME at point. "To email NAME" is confusing. I'd suggest to rename it ADDRESSEE. "Insert a button to email" is also confusing. Is this alternative correct? Insert a button whose action will send email to ADDRESSEE. > +NAME should have the form (FULLNAME . EMAIL) where NAME is either ^^^^ FULLNAME > (defvar package-list-unversioned nil > - "If non-nil include packages that don't have a version in `list-package'.") > + "If non-nil, include packages that don't have a version in `list-package'.") ^^^^^^^^^^^^ "list-packages", I presume? > (defvar package--emacs-version-list (version-to-list emacs-version) > - "`emacs-version', as a list.") > + "Variable `emacs-version' as a list.") "The value of `emacs-version', as a list." From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 15 15:57:09 2019 Received: (at 37410) by debbugs.gnu.org; 15 Sep 2019 19:57:09 +0000 Received: from localhost ([127.0.0.1]:48752 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9adw-0003FC-Fi for submit@debbugs.gnu.org; Sun, 15 Sep 2019 15:57:09 -0400 Received: from mail-pl1-f172.google.com ([209.85.214.172]:37223) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i9adu-0003Ei-3k for 37410@debbugs.gnu.org; Sun, 15 Sep 2019 15:57:07 -0400 Received: by mail-pl1-f172.google.com with SMTP id b10so15830230plr.4 for <37410@debbugs.gnu.org>; Sun, 15 Sep 2019 12:57:05 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=hRFy+W8HU6YURi6CQKMv4n9ewGTUWCtslVKqVcy7II0=; b=HEwHomWYSuWuvCR64jI8bbFctGHKt+Lek4jBM4v7hifqEtGhLTfC0MBdDI+Tie1f35 l1PvstPzdda4m17L9gceMUUGNe2mPhXp3Bfuu9Ww5xAdbIAwTJTPEJgALpvcpcuvMH3v XlyWvaBt6xdcUC+B/t9AdN0raeb5eisc6LJh3op9aYU/mARRIq10IXfM4voSuBZgIu7a F0NHcy8kcgopW9ePeKJ90ba/5IqjHpJtD2rMn+QsxGmMIPlO7yI3TcP+8zX5q7KXFWwQ hhV3esX0pChiSs9ejsYv8gE4eN70ssEEmmWCRwCOTZ58eDKIl8/1YAX1WPgmEOFlkXd3 U1DA== X-Gm-Message-State: APjAAAXllcMvlujOaPVoGQsqcdn6jUzM+XE00ebg6fG0ThHdXxN+Li9j T0y7A6Vj+YDl7U1XrPK0kVqpYNWNtcS3ug8ERm0= X-Google-Smtp-Source: APXvYqx26kTeUx8c/j7OcsATnoerHSB468/Laxkcy9C3N1MyabP5bNh5ylzhADbe1LbeBLvvFqYk4YuAn8AnXK73dpc= X-Received: by 2002:a17:902:326:: with SMTP id 35mr62075820pld.128.1568577420097; Sun, 15 Sep 2019 12:57:00 -0700 (PDT) MIME-Version: 1.0 References: <83a7b5y0qt.fsf@gnu.org> In-Reply-To: <83a7b5y0qt.fsf@gnu.org> From: Stefan Kangas Date: Sun, 15 Sep 2019 21:56:48 +0200 Message-ID: Subject: Re: bug#37410: [PATCH] Several doc fixes in package.el To: Eli Zaretskii Content-Type: multipart/mixed; boundary="000000000000edf95f05929ce34c" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 37410 Cc: 37410@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) --000000000000edf95f05929ce34c Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: >> From: Stefan Kangas >> Date: Sun, 15 Sep 2019 18:01:17 +0200 >> >> Seeing as the documentation in package.el leaves much to be desired, I >> spent some time adding doc strings and fixing checkdoc and stylistic >> errors. I've attached a patch with my results, which should improve >> the situation a little bit at least. > > Thanks for working on this. Thanks for your detailed review. I have attached an updated patch. >> (defun package-install-from-buffer () >> - "Install a package from the current buffer. >> + "Install package from current buffer. > > Why this change? Reverted that. >> ;;;###autoload >> (defun package-install-file (file) >> - "Install a package from a file. >> + "Install package from FILE. > > And this? I think the original is wordy for no reason, and imprecise: We do not install just "a package" in general, but specifically the package pointed to by FILE. But if I'm the only one who feels that the terse version is better, I'm willing to concede that point. >> (defun describe-package-1 (pkg) >> + "Insert package description of PKG at point. >> +Helper function for `describe-package'." > > The "at point" here is ambiguous: does it mean "insert at point" or > "PKG at point"? Changed that to: Insert the package description for PKG. >> (defun package-install-button-action (button) >> + "Run `package-install' on package defined by BUTTON. > > Can a package really be defined by a button? Changed that to: Run `package-install' on the package BUTTON points to. >> (defun package-keyword-button-action (button) >> + "Show *Packages* buffer filtered by keyword from BUTTON label. > > *Packages* should be in double quotes. > > I generally find this sentence confusing: what do you mean by "keyword > from BUTTON label"? Changed that to: + "Show filtered \"*Packages*\" buffer for BUTTON. +The buffer is filtered by the `package-keyword' property of BUTTON. >> +(defun package-make-button (text &rest properties) >> + "Insert button labelled TEXT with button PROPERTIES at point. > ^^^^^^^^ > "labeled" Right, I used the British spelling by mistake. Fixed. >> (defun package--print-email-button (name) >> + "Insert a button to email NAME at point. > > "To email NAME" is confusing. I'd suggest to rename it ADDRESSEE. > "Insert a button to email" is also confusing. Is this alternative > correct? "Insert a button" is from the doc string of insert-text-button (for which this is a wrapper) which says: "Insert a button with the label LABEL.# > Insert a button whose action will send email to ADDRESSEE. Better, but I changed it to RECIPIENT instead of ADDRESSEE. >> (defvar package--emacs-version-list (version-to-list emacs-version) >> - "`emacs-version', as a list.") >> + "Variable `emacs-version' as a list.") > > "The value of `emacs-version', as a list." Fixed. (FWIW, I don't know what the point of this defvar is -- it's only used once as far as I can tell. Maybe it should just be removed.) Best regards, Stefan Kangas --000000000000edf95f05929ce34c Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Several-doc-fixes-in-package.el.patch" Content-Disposition: attachment; filename="0001-Several-doc-fixes-in-package.el.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_k0legfpt0 RnJvbSBiYWNlYmE2MzYzZTlhNmVkMDljZDJhYTg3OGUxNWMwOTA2MTZkZDA5IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTdW4sIDE1IFNlcCAyMDE5IDE3OjQxOjI3ICswMjAwClN1YmplY3Q6IFtQQVRDSF0g U2V2ZXJhbCBkb2MgZml4ZXMgaW4gcGFja2FnZS5lbAoKKiBsaXNwL2VtYWNzLWxpc3AvcGFja2Fn ZS5lbCAodG9wLWxldmVsKQoocGFja2FnZS1jaGVjay1zaWduYXR1cmUsIHBhY2thZ2UtLWZyb20t YnVpbHRpbikKKHBhY2thZ2UtZGVzYy1mdWxsLW5hbWUsIHBhY2thZ2UtZGVzYy1zdWZmaXgpCihw YWNrYWdlLWRlc2MtLWtleXdvcmRzLCBwYWNrYWdlLS1iaS1kZXNjKQoocGFja2FnZS1wcm9jZXNz LWRlZmluZS1wYWNrYWdlLCBwYWNrYWdlLWFyY2hpdmUtYmFzZSkKKHBhY2thZ2UtaW5zdGFsbC1m cm9tLWFyY2hpdmUsIHBhY2thZ2UtaW5zdGFsbC1mcm9tLWJ1ZmZlcikKKHBhY2thZ2UtaW5zdGFs bC1maWxlLCBwYWNrYWdlLWF1dG9yZW1vdmUsIGRlc2NyaWJlLXBhY2thZ2UtMSkKKHBhY2thZ2Ut aW5zdGFsbC1idXR0b24tYWN0aW9uLCBwYWNrYWdlLWRlbGV0ZS1idXR0b24tYWN0aW9uKQoocGFj a2FnZS1rZXl3b3JkLWJ1dHRvbi1hY3Rpb24sIHBhY2thZ2UtbWFrZS1idXR0b24pCihwYWNrYWdl LS1wcmludC1lbWFpbC1idXR0b24sIHBhY2thZ2UtbGlzdC11bnZlcnNpb25lZCkKKHBhY2thZ2Ut LWVtYWNzLXZlcnNpb24tbGlzdCwgcGFja2FnZS1tZW51LXRvZ2dsZS1oaWRpbmcpCihwYWNrYWdl LWhpZGRlbi1yZWdleHBzLCBwYWNrYWdlLW1lbnUtaGlkZS1wYWNrYWdlKQoocGFja2FnZS1tZW51 LWdldC1zdGF0dXMsIHBhY2thZ2UtbWVudS0tZmluZC11cGdyYWRlcykKKHBhY2thZ2UtbWVudS0t cG9zdC1yZWZyZXNoKTogRG9jIGZpeGVzLiAgKEJ1ZyMzNzQxMCkKLS0tCiBsaXNwL2VtYWNzLWxp c3AvcGFja2FnZS5lbCB8IDEwMyArKysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLS0tLS0t CiAxIGZpbGUgY2hhbmdlZCwgNzYgaW5zZXJ0aW9ucygrKSwgMjcgZGVsZXRpb25zKC0pCgpkaWZm IC0tZ2l0IGEvbGlzcC9lbWFjcy1saXNwL3BhY2thZ2UuZWwgYi9saXNwL2VtYWNzLWxpc3AvcGFj a2FnZS5lbAppbmRleCBlZjBjNTE3MWRlLi4xOGI1Yzk2MmY2IDEwMDY0NAotLS0gYS9saXNwL2Vt YWNzLWxpc3AvcGFja2FnZS5lbAorKysgYi9saXNwL2VtYWNzLWxpc3AvcGFja2FnZS5lbApAQCAt MTIwLDkgKzEyMCw5IEBACiA7OyAtICJpbnN0YWxsZWQiIGluc3RlYWQgb2YgYSBibGFuayBpbiB0 aGUgc3RhdHVzIGNvbHVtbgogOzsgLSB0cmFtcCBuZWVkcyBpdHMgZmlsZXMgdG8gYmUgY29tcGls ZWQgaW4gYSBjZXJ0YWluIG9yZGVyLgogOzsgICBob3cgdG8gaGFuZGxlIHRoaXM/ICBmaXggdHJh bXA/Ci07OyAtIG1heWJlIHdlIG5lZWQgc2VwYXJhdGUgLmVsYyBkaXJlY3RvcmllcyBmb3IgdmFy aW91cyBlbWFjcyB2ZXJzaW9ucwotOzsgICBhbmQgYWxzbyBlbWFjcy12cy14ZW1hY3MuICBUaGF0 IHdheSBjb25kaXRpb25hbCBjb21waWxhdGlvbiBjYW4KLTs7ICAgd29yay4gIEJ1dCB3b3VsZCB0 aGlzIGJyZWFrIGFueXRoaW5nPworOzsgLSBtYXliZSB3ZSBuZWVkIHNlcGFyYXRlIC5lbGMgZGly ZWN0b3JpZXMgZm9yIHZhcmlvdXMgZW1hY3MKKzs7ICAgdmVyc2lvbnMuICBUaGF0IHdheSBjb25k aXRpb25hbCBjb21waWxhdGlvbiBjYW4gd29yay4gIEJ1dCB3b3VsZAorOzsgICB0aGlzIGJyZWFr IGFueXRoaW5nPwogOzsgLSBXaWxsaWFtIFh1IHN1Z2dlc3RzIGJlaW5nIGFibGUgdG8gb3BlbiBh IHBhY2thZ2UgZmlsZSB3aXRob3V0CiA7OyAgIGluc3RhbGxpbmcgaXQKIDs7IC0gSW50ZXJmYWNl IHdpdGggZGVza3RvcC5lbCBzbyB0aGF0IHJlc3RhcnRpbmcgYWZ0ZXIgYW4gaW5zdGFsbApAQCAt MzU0LDkgKzM1NCw5IEBAIHBhY2thZ2UtY2hlY2stc2lnbmF0dXJlCiAKIChkZWZ1biBwYWNrYWdl LWNoZWNrLXNpZ25hdHVyZSAoKQogICAiQ2hlY2sgd2hldGhlciB3ZSBoYXZlIGEgdXNhYmxlIE9w ZW5QR1AgY29uZmlndXJhdGlvbi4KLUlmIHRydWUsIGFuZCBgcGFja2FnZS1jaGVjay1zaWduYXR1 cmUnIGlzIGBhbGxvdy11bnNpZ25lZCcsCi1yZXR1cm4gYGFsbG93LXVuc2lnbmVkJywgb3RoZXJ3 aXNlIHJldHVybiB0aGUgdmFsdWUgb2YKLWBwYWNrYWdlLWNoZWNrLXNpZ25hdHVyZScuIgorSWYg c28sIGFuZCB2YXJpYWJsZSBgcGFja2FnZS1jaGVjay1zaWduYXR1cmUnIGlzCitgYWxsb3ctdW5z aWduZWQnLCByZXR1cm4gYGFsbG93LXVuc2lnbmVkJywgb3RoZXJ3aXNlIHJldHVybiB0aGUKK3Zh bHVlIG9mIHZhcmlhYmxlIGBwYWNrYWdlLWNoZWNrLXNpZ25hdHVyZScuIgogICAoaWYgKGVxIHBh Y2thZ2UtY2hlY2stc2lnbmF0dXJlICdhbGxvdy11bnNpZ25lZCkKICAgICAgIChwcm9nbgogICAg ICAgICAocmVxdWlyZSAnZXBnLWNvbmZpZykKQEAgLTQ3Miw2ICs0NzIsOCBAQCBwYWNrYWdlLS1k ZWZhdWx0LXN1bW1hcnkKICAgc2lnbmVkKQogCiAoZGVmdW4gcGFja2FnZS0tZnJvbS1idWlsdGlu IChiaS1kZXNjKQorICAiQ3JlYXRlIGEgYHBhY2thZ2UtZGVzYycgb2JqZWN0IGZyb20gQkktREVT Qy4KK0JJLURFU0Mgc2hvdWxkIGJlIGEgYHBhY2thZ2UtLWJpLWRlc2MnIG9iamVjdC4iCiAgIChw YWNrYWdlLWRlc2MtY3JlYXRlIDpuYW1lIChwb3AgYmktZGVzYykKICAgICAgICAgICAgICAgICAg ICAgICAgOnZlcnNpb24gKHBhY2thZ2UtLWJpLWRlc2MtdmVyc2lvbiBiaS1kZXNjKQogICAgICAg ICAgICAgICAgICAgICAgICA6c3VtbWFyeSAocGFja2FnZS0tYmktZGVzYy1zdW1tYXJ5IGJpLWRl c2MpCkBAIC01MDksMTEgKzUxMSwyMSBAQCBwYWNrYWdlLXZlcnNpb24tam9pbgogICAgICAgKGFw cGx5ICMnY29uY2F0IChucmV2ZXJzZSBzdHItbGlzdCkpKSkpCiAKIChkZWZ1biBwYWNrYWdlLWRl c2MtZnVsbC1uYW1lIChwa2ctZGVzYykKKyAgIlJldHVybiBmdWxsIG5hbWUgb2YgcGFja2FnZS1k ZXNjIG9iamVjdCBQS0ctREVTQy4KK1RoaXMgaXMgdGhlIG5hbWUgb2YgdGhlIHBhY2thZ2Ugd2l0 aCBpdHMgdmVyc2lvbiBhcHBlbmRlZC4iCiAgIChmb3JtYXQgIiVzLSVzIgogICAgICAgICAgIChw YWNrYWdlLWRlc2MtbmFtZSBwa2ctZGVzYykKICAgICAgICAgICAocGFja2FnZS12ZXJzaW9uLWpv aW4gKHBhY2thZ2UtZGVzYy12ZXJzaW9uIHBrZy1kZXNjKSkpKQogCiAoZGVmdW4gcGFja2FnZS1k ZXNjLXN1ZmZpeCAocGtnLWRlc2MpCisgICJSZXR1cm4gZmlsZS1uYW1lIGV4dGVuc2lvbiBvZiBw YWNrYWdlLWRlc2Mgb2JqZWN0IFBLRy1ERVNDLgorRGVwZW5kaW5nIG9uIHRoZSBgcGFja2FnZS1k ZXNjLWtpbmQnIG9mIFBLRy1ERVNDLCB0aGlzIGlzIG9uZSBvZjoKKworICAgJ3NpbmdsZSAtIFwi LmVsXCIKKyAgICd0YXIgICAgLSBcIi50YXJcIgorICAgJ2RpciAgICAtIFwiXCIKKworSWYgdGhl IGtpbmQgaXMgbm9uZSBvZiB0aGUgYWJvdmUsIHNpZ25hbCBhbiBlcnJvci4iCiAgIChwY2FzZSAo cGFja2FnZS1kZXNjLWtpbmQgcGtnLWRlc2MpCiAgICAgKCdzaW5nbGUgIi5lbCIpCiAgICAgKCd0 YXIgIi50YXIiKQpAQCAtNTIxLDYgKzUzMywxMCBAQCBwYWNrYWdlLWRlc2Mtc3VmZml4CiAgICAg KGtpbmQgKGVycm9yICJVbmtub3duIHBhY2thZ2Uga2luZDogJXMiIGtpbmQpKSkpCiAKIChkZWZ1 biBwYWNrYWdlLWRlc2MtLWtleXdvcmRzIChwa2ctZGVzYykKKyAgIlJldHVybiBrZXl3b3JkcyBv ZiBwYWNrYWdlLWRlc2Mgb2JqZWN0IFBLRy1ERVNDLgorVGhlc2Uga2V5d29yZHMgY29tZSBmcm9t IHRoZSBmb28tcGtnLmVsIGZpbGUsIGFuZCBpbiBnZW5lcmFsCitjb3JyZXNwb25kcyB0byB0aGUg a2V5d29yZHMgaW4gdGhlIFwiS2V5d29yZHNcIiBoZWFkZXIgb2YgdGhlCitwYWNrYWdlLiIKICAg KGxldCAoKGtleXdvcmRzIChjZHIgKGFzc29jIDprZXl3b3JkcyAocGFja2FnZS1kZXNjLWV4dHJh cyBwa2ctZGVzYykpKSkpCiAgICAgKGlmIChlcSAoY2FyLXNhZmUga2V5d29yZHMpICdxdW90ZSkK ICAgICAgICAgKG50aCAxIGtleXdvcmRzKQpAQCAtNTMwLDEwICs1NDYsMTAgQEAgcGFja2FnZS1k ZXNjLXByaW9yaXR5CiAgICJSZXR1cm4gdGhlIHByaW9yaXR5IG9mIHRoZSBhcmNoaXZlIG9mIHBh Y2thZ2UtZGVzYyBvYmplY3QgUC4iCiAgIChwYWNrYWdlLWFyY2hpdmUtcHJpb3JpdHkgKHBhY2th Z2UtZGVzYy1hcmNoaXZlIHApKSkKIAotOzsgUGFja2FnZSBkZXNjcmlwdG9yIGZvcm1hdCB1c2Vk IGluIGZpbmRlci1pbmYuZWwgYW5kIHBhY2thZ2UtLWJ1aWx0aW5zLgogKGNsLWRlZnN0cnVjdCAo cGFja2FnZS0tYmktZGVzYwogICAgICAgICAgICAgICAgKDpjb25zdHJ1Y3RvciBwYWNrYWdlLW1h a2UtYnVpbHRpbiAodmVyc2lvbiBzdW1tYXJ5KSkKICAgICAgICAgICAgICAgICg6dHlwZSB2ZWN0 b3IpKQorICAiUGFja2FnZSBkZXNjcmlwdG9yIGZvcm1hdCB1c2VkIGluIGZpbmRlci1pbmYuZWwg YW5kIHBhY2thZ2UtLWJ1aWx0aW5zLiIKICAgdmVyc2lvbgogICByZXFzCiAgIHN1bW1hcnkpCkBA IC01NzUsNyArNTkxLDE1IEBAIHBhY2thZ2UtYWN0aXZhdGVkLWxpc3QKIDs7IFRoZSBmb2xsb3dp bmcgZnVuY3Rpb25zIGFyZSBjYWxsZWQgb24gZWFjaCBpbnN0YWxsZWQgcGFja2FnZSBieQogOzsg YHBhY2thZ2UtbG9hZC1hbGwtZGVzY3JpcHRvcnMnLCB3aGljaCB1bHRpbWF0ZWx5IHBvcHVsYXRl cyB0aGUKIDs7IGBwYWNrYWdlLWFsaXN0JyB2YXJpYWJsZS4KKwogKGRlZnVuIHBhY2thZ2UtcHJv Y2Vzcy1kZWZpbmUtcGFja2FnZSAoZXhwKQorICAiUHJvY2VzcyBkZWZpbmUtcGFja2FnZSBleHBy ZXNzaW9uIEVYUCBhbmQgcHVzaCBpdCB0byBgcGFja2FnZS1hbGlzdCcuCitFWFAgc2hvdWxkIGJl IGEgZm9ybSByZWFkIGZyb20gYSBmb28tcGtnLmVsIGZpbGUuCitDb252ZXJ0IEVYUCBpbnRvIGEg YHBhY2thZ2UtZGVzYycgb2JqZWN0IHVzaW5nIHRoZQorYHBhY2thZ2UtZGVzYy1mcm9tLWRlZmlu ZScgY29uc3RydWN0b3IgYmVmb3JlIHB1c2hpbmcgaXQgdG8KK2BwYWNrYWdlLWFsaXN0Jy4KK0lm IHRoZXJlIGFscmVhZHkgZXhpc3RzIGEgcGFja2FnZSBieSB0aGF0IG5hbWUgaW4KK2BwYWNrYWdl LWFsaXN0JywgcmVwbGFjZSB0aGF0IGRlZmluaXRpb24gd2l0aCB0aGUgbmV3IG9uZS4iCiAgICh3 aGVuIChlcSAoY2FyLXNhZmUgZXhwKSAnZGVmaW5lLXBhY2thZ2UpCiAgICAgKGxldCogKChuZXct cGtnLWRlc2MgKGFwcGx5ICMncGFja2FnZS1kZXNjLWZyb20tZGVmaW5lIChjZHIgZXhwKSkpCiAg ICAgICAgICAgIChuYW1lIChwYWNrYWdlLWRlc2MtbmFtZSBuZXctcGtnLWRlc2MpKQpAQCAtODY2 LDYgKzg5MCw3IEBAIHBhY2thZ2UtLWFsaXN0LXRvLXBsaXN0LWFyZ3MKICAgKG1hcGNhciAjJ21h Y3JvZXhwLXF1b3RlCiAgICAgICAgICAgKGFwcGx5ICMnbmNvbmMKICAgICAgICAgICAgICAgICAg KG1hcGNhciAobGFtYmRhIChwYWlyKSAobGlzdCAoY2FyIHBhaXIpIChjZHIgcGFpcikpKSBhbGlz dCkpKSkKKwogKGRlZnVuIHBhY2thZ2UtdW5wYWNrIChwa2ctZGVzYykKICAgIkluc3RhbGwgdGhl IGNvbnRlbnRzIG9mIHRoZSBjdXJyZW50IGJ1ZmZlciBhcyBhIHBhY2thZ2UuIgogICAobGV0KiAo KG5hbWUgKHBhY2thZ2UtZGVzYy1uYW1lIHBrZy1kZXNjKSkKQEAgLTE4OTksMTIgKzE5MjQsMTMg QEAgcGFja2FnZS0tc29ydC1ieS1kZXBlbmRlbmNlCiA7OyBpbnN0YWxsZWQgaW4gYSB2YXJpZXR5 IG9mIHdheXMgKGFyY2hpdmVzLCBidWZmZXIsIGZpbGUpLCBidXQKIDs7IHJlcXVpcmVtZW50cyAo ZGVwZW5kZW5jaWVzKSBhcmUgYWx3YXlzIHNhdGlzZmllZCBieSBsb29raW5nIGluCiA7OyBgcGFj a2FnZS1hcmNoaXZlLWNvbnRlbnRzJy4KKwogKGRlZnVuIHBhY2thZ2UtYXJjaGl2ZS1iYXNlIChk ZXNjKQotICAiUmV0dXJuIHRoZSBhcmNoaXZlIGNvbnRhaW5pbmcgdGhlIHBhY2thZ2UgTkFNRS4i CisgICJSZXR1cm4gdGhlIHBhY2thZ2UgZGVzY3JpYmVkIGJ5IERFU0MuIgogICAoY2RyIChhc3Nv YyAocGFja2FnZS1kZXNjLWFyY2hpdmUgZGVzYykgcGFja2FnZS1hcmNoaXZlcykpKQogCiAoZGVm dW4gcGFja2FnZS1pbnN0YWxsLWZyb20tYXJjaGl2ZSAocGtnLWRlc2MpCi0gICJEb3dubG9hZCBh bmQgaW5zdGFsbCBhIHRhciBwYWNrYWdlLiIKKyAgIkRvd25sb2FkIGFuZCBpbnN0YWxsIGEgdGFy IHBhY2thZ2UgZGVmaW5lZCBieSBQS0ctREVTQy4iCiAgIDs7IFRoaXMgd29uJ3QgaGFwcGVuLCB1 bmxlc3MgdGhlIGFyY2hpdmUgaXMgZG9pbmcgc29tZXRoaW5nIHdyb25nLgogICAod2hlbiAoZXEg KHBhY2thZ2UtZGVzYy1raW5kIHBrZy1kZXNjKSAnZGlyKQogICAgIChlcnJvciAiQ2FuJ3QgaW5z dGFsbCBkaXJlY3RvcnkgcGFja2FnZSBmcm9tIGFyY2hpdmUiKSkKQEAgLTIwODEsNyArMjEwNyw3 IEBAIHBhY2thZ2UtaW5zdGFsbC1mcm9tLWJ1ZmZlcgogCiA7OzsjIyNhdXRvbG9hZAogKGRlZnVu IHBhY2thZ2UtaW5zdGFsbC1maWxlIChmaWxlKQotICAiSW5zdGFsbCBhIHBhY2thZ2UgZnJvbSBh IGZpbGUuCisgICJJbnN0YWxsIHBhY2thZ2UgZnJvbSBGSUxFLgogVGhlIGZpbGUgY2FuIGVpdGhl ciBiZSBhIHRhciBmaWxlLCBhbiBFbWFjcyBMaXNwIGZpbGUsIG9yIGEKIGRpcmVjdG9yeS4iCiAg IChpbnRlcmFjdGl2ZSAiZlBhY2thZ2UgZmlsZSBuYW1lOiAiKQpAQCAtMjIxNyw3ICsyMjQzLDcg QEAgcGFja2FnZS1yZWluc3RhbGwKIAogOzs7IyMjYXV0b2xvYWQKIChkZWZ1biBwYWNrYWdlLWF1 dG9yZW1vdmUgKCkKLSAgIlJlbW92ZSBwYWNrYWdlcyB0aGF0IGFyZSBubyBtb3JlIG5lZWRlZC4K KyAgIlJlbW92ZSBwYWNrYWdlcyB0aGF0IGFyZSBubyBsb25nZXIgbmVlZGVkLgogCiBQYWNrYWdl cyB0aGF0IGFyZSBubyBtb3JlIG5lZWRlZCBieSBvdGhlciBwYWNrYWdlcyBpbgogYHBhY2thZ2Ut c2VsZWN0ZWQtcGFja2FnZXMnIGFuZCB0aGVpciBkZXBlbmRlbmNpZXMKQEAgLTIzMzQsNiArMjM2 MCw4IEBAIHBhY2thZ2UtLWdldC1kZXNjcmlwdGlvbgogICAgICApKSkKIAogKGRlZnVuIGRlc2Ny aWJlLXBhY2thZ2UtMSAocGtnKQorICAiSW5zZXJ0IHRoZSBwYWNrYWdlIGRlc2NyaXB0aW9uIGZv ciBQS0cuCitIZWxwZXIgZnVuY3Rpb24gZm9yIGBkZXNjcmliZS1wYWNrYWdlJy4iCiAgIChyZXF1 aXJlICdsaXNwLW1udCkKICAgKGxldCogKChkZXNjIChvcgogICAgICAgICAgICAgICAgIChpZiAo cGFja2FnZS1kZXNjLXAgcGtnKSBwa2cpCkBAIC0yNTYzLDYgKzI1OTEsOSBAQCBkZXNjcmliZS1w YWNrYWdlLTEKICAgICAgIChicm93c2UtdXJsLWFkZC1idXR0b25zKSkpKQogCiAoZGVmdW4gcGFj a2FnZS1pbnN0YWxsLWJ1dHRvbi1hY3Rpb24gKGJ1dHRvbikKKyAgIlJ1biBgcGFja2FnZS1pbnN0 YWxsJyBvbiB0aGUgcGFja2FnZSBCVVRUT04gcG9pbnRzIHRvLgorVXNlZCBmb3IgdGhlICdhY3Rp b24gcHJvcGVydHkgb2YgYnV0dG9ucyBpbiB0aGUgYnVmZmVyIGNyZWF0ZWQgYnkKK2BkZXNjcmli ZS1wYWNrYWdlJy4iCiAgIChsZXQgKChwa2ctZGVzYyAoYnV0dG9uLWdldCBidXR0b24gJ3BhY2th Z2UtZGVzYykpKQogICAgICh3aGVuICh5LW9yLW4tcCAoZm9ybWF0LW1lc3NhZ2UgIkluc3RhbGwg cGFja2FnZSBgJXMnPyAiCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAocGFj a2FnZS1kZXNjLWZ1bGwtbmFtZSBwa2ctZGVzYykpKQpAQCAtMjU3MSw2ICsyNjAyLDkgQEAgcGFj a2FnZS1pbnN0YWxsLWJ1dHRvbi1hY3Rpb24KICAgICAgIChnb3RvLWNoYXIgKHBvaW50LW1pbikp KSkpCiAKIChkZWZ1biBwYWNrYWdlLWRlbGV0ZS1idXR0b24tYWN0aW9uIChidXR0b24pCisgICJS dW4gYHBhY2thZ2UtZGVsZXRlJyBvbiB0aGUgcGFja2FnZSBCVVRUT04gcG9pbnRzIHRvLgorVXNl ZCBmb3IgdGhlICdhY3Rpb24gcHJvcGVydHkgb2YgYnV0dG9ucyBpbiB0aGUgYnVmZmVyIGNyZWF0 ZWQgYnkKK2BkZXNjcmliZS1wYWNrYWdlJy4iCiAgIChsZXQgKChwa2ctZGVzYyAoYnV0dG9uLWdl dCBidXR0b24gJ3BhY2thZ2UtZGVzYykpKQogICAgICh3aGVuICh5LW9yLW4tcCAoZm9ybWF0LW1l c3NhZ2UgIkRlbGV0ZSBwYWNrYWdlIGAlcyc/ICIKICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgIChwYWNrYWdlLWRlc2MtZnVsbC1uYW1lIHBrZy1kZXNjKSkpCkBAIC0yNTc5LDEw ICsyNjEzLDE3IEBAIHBhY2thZ2UtZGVsZXRlLWJ1dHRvbi1hY3Rpb24KICAgICAgIChnb3RvLWNo YXIgKHBvaW50LW1pbikpKSkpCiAKIChkZWZ1biBwYWNrYWdlLWtleXdvcmQtYnV0dG9uLWFjdGlv biAoYnV0dG9uKQorICAiU2hvdyBmaWx0ZXJlZCBcIipQYWNrYWdlcypcIiBidWZmZXIgZm9yIEJV VFRPTi4KK1RoZSBidWZmZXIgaXMgZmlsdGVyZWQgYnkgdGhlIGBwYWNrYWdlLWtleXdvcmQnIHBy b3BlcnR5IG9mIEJVVFRPTi4KK1VzZWQgZm9yIHRoZSAnYWN0aW9uIHByb3BlcnR5IG9mIGJ1dHRv bnMgaW4gdGhlIGJ1ZmZlciBjcmVhdGVkIGJ5CitgZGVzY3JpYmUtcGFja2FnZScuIgogICAobGV0 ICgocGtnLWtleXdvcmQgKGJ1dHRvbi1nZXQgYnV0dG9uICdwYWNrYWdlLWtleXdvcmQpKSkKICAg ICAocGFja2FnZS1zaG93LXBhY2thZ2UtbGlzdCB0IChsaXN0IHBrZy1rZXl3b3JkKSkpKQogCi0o ZGVmdW4gcGFja2FnZS1tYWtlLWJ1dHRvbiAodGV4dCAmcmVzdCBwcm9wcykKKyhkZWZ1biBwYWNr YWdlLW1ha2UtYnV0dG9uICh0ZXh0ICZyZXN0IHByb3BlcnRpZXMpCisgICJJbnNlcnQgYnV0dG9u IGxhYmVsZWQgVEVYVCB3aXRoIGJ1dHRvbiBQUk9QRVJUSUVTIGF0IHBvaW50LgorUFJPUEVSVElF UyBhcmUgcGFzc2VkIHRvIGBpbnNlcnQtdGV4dC1idXR0b24nLCBmb3Igd2hpY2ggdGhpcworZnVu Y3Rpb24gaXMgYSBjb252ZW5pZW5jZSB3cmFwcGVyIHVzZWQgYnkgYGRlc2NyaWJlLXBhY2thZ2Ut MScuIgogICAobGV0ICgoYnV0dG9uLXRleHQgKGlmIChkaXNwbGF5LWdyYXBoaWMtcCkgdGV4dCAo Y29uY2F0ICJbIiB0ZXh0ICJdIikpKQogICAgICAgICAoYnV0dG9uLWZhY2UgKGlmIChkaXNwbGF5 LWdyYXBoaWMtcCkKICAgICAgICAgICAgICAgICAgICAgICAgICAnKDpib3ggKDpsaW5lLXdpZHRo IDIgOmNvbG9yICJkYXJrIGdyZXkiKQpAQCAtMjU5MCwyMCArMjYzMSwyMyBAQCBwYWNrYWdlLW1h a2UtYnV0dG9uCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIDpmb3JlZ3JvdW5kICJi bGFjayIpCiAgICAgICAgICAgICAgICAgICAgICAgICdsaW5rKSkpCiAgICAgKGFwcGx5ICMnaW5z ZXJ0LXRleHQtYnV0dG9uIGJ1dHRvbi10ZXh0ICdmYWNlIGJ1dHRvbi1mYWNlICdmb2xsb3ctbGlu ayB0Ci0gICAgICAgICAgIHByb3BzKSkpCi0KLShkZWZ1biBwYWNrYWdlLS1wcmludC1lbWFpbC1i dXR0b24gKG5hbWUpCi0gICh3aGVuIChjYXIgbmFtZSkKLSAgICAoaW5zZXJ0IChjYXIgbmFtZSkp KQotICAod2hlbiAoYW5kIChjYXIgbmFtZSkgKGNkciBuYW1lKSkKKyAgICAgICAgICAgcHJvcGVy dGllcykpKQorCisoZGVmdW4gcGFja2FnZS0tcHJpbnQtZW1haWwtYnV0dG9uIChyZWNpcGllbnQp CisgICJJbnNlcnQgYSBidXR0b24gd2hvc2UgYWN0aW9uIHdpbGwgc2VuZCBhbiBlbWFpbCB0byBS RUNJUElFTlQuCitOQU1FIHNob3VsZCBoYXZlIHRoZSBmb3JtIChGVUxMTkFNRSAuIEVNQUlMKSB3 aGVyZSBGVUxMTkFNRSBpcworZWl0aGVyIGEgZnVsbCBuYW1lIG9yIG5pbCwgYW5kIEVNQUlMIGlz IGEgdmFsaWQgZW1haWwgYWRkcmVzcy4iCisgICh3aGVuIChjYXIgcmVjaXBpZW50KQorICAgIChp bnNlcnQgKGNhciByZWNpcGllbnQpKSkKKyAgKHdoZW4gKGFuZCAoY2FyIHJlY2lwaWVudCkgKGNk ciByZWNpcGllbnQpKQogICAgIChpbnNlcnQgIiAiKSkKLSAgKHdoZW4gKGNkciBuYW1lKQorICAo d2hlbiAoY2RyIHJlY2lwaWVudCkKICAgICAoaW5zZXJ0ICI8IikKLSAgICAoaW5zZXJ0LXRleHQt YnV0dG9uIChjZHIgbmFtZSkKKyAgICAoaW5zZXJ0LXRleHQtYnV0dG9uIChjZHIgcmVjaXBpZW50 KQogICAgICAgICAgICAgICAgICAgICAgICAgJ2ZvbGxvdy1saW5rIHQKICAgICAgICAgICAgICAg ICAgICAgICAgICdhY3Rpb24gKGxhbWJkYSAoXykKICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAoY29tcG9zZS1tYWlsCi0gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg IChmb3JtYXQgIiVzIDwlcz4iIChjYXIgbmFtZSkgKGNkciBuYW1lKSkpKSkKKyAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgKGZvcm1hdCAiJXMgPCVzPiIgKGNhciByZWNpcGllbnQp IChjZHIgcmVjaXBpZW50KSkpKSkKICAgICAoaW5zZXJ0ICI+IikpCiAgIChpbnNlcnQgIlxuIikp CiAKQEAgLTI3MDEsMTMgKzI3NDUsMTMgQEAgcGFja2FnZS0tcHVzaAogICAgICAocHVzaCAoY29u cyAscGtnLWRlc2MgLHN0YXR1cykgLGxpc3RuYW1lKSkpCiAKIChkZWZ2YXIgcGFja2FnZS1saXN0 LXVudmVyc2lvbmVkIG5pbAotICAiSWYgbm9uLW5pbCBpbmNsdWRlIHBhY2thZ2VzIHRoYXQgZG9u J3QgaGF2ZSBhIHZlcnNpb24gaW4gYGxpc3QtcGFja2FnZScuIikKKyAgIklmIG5vbi1uaWwsIGlu Y2x1ZGUgcGFja2FnZXMgdGhhdCBkb24ndCBoYXZlIGEgdmVyc2lvbiBpbiBgbGlzdC1wYWNrYWdl cycuIikKIAogKGRlZnZhciBwYWNrYWdlLWxpc3QtdW5zaWduZWQgbmlsCiAgICJJZiBub24tbmls LCBtZW50aW9uIGluIHRoZSBsaXN0IHdoaWNoIHBhY2thZ2VzIHdlcmUgaW5zdGFsbGVkIHcvbyBz aWduYXR1cmUuIikKIAogKGRlZnZhciBwYWNrYWdlLS1lbWFjcy12ZXJzaW9uLWxpc3QgKHZlcnNp b24tdG8tbGlzdCBlbWFjcy12ZXJzaW9uKQotICAiYGVtYWNzLXZlcnNpb24nLCBhcyBhIGxpc3Qu IikKKyAgIlRoZSB2YWx1ZSBvZiB2YXJpYWJsZSBgZW1hY3MtdmVyc2lvbicgYXMgYSBsaXN0LiIp CiAKIChkZWZ1biBwYWNrYWdlLS1pbmNvbXBhdGlibGUtcCAocGtnICZvcHRpb25hbCBzaGFsbG93 KQogICAiUmV0dXJuIG5vbi1uaWwgaWYgUEtHIGhhcyBubyBjaGFuY2Ugb2YgYmVpbmcgaW5zdGFs bGFibGUuCkBAIC0yNzgyLDcgKzI4MjYsNyBAQCBwYWNrYWdlLW1lbnUtLWhpZGUtcGFja2FnZXMK IEluc3RhbGxlZCBvYnNvbGV0ZSBwYWNrYWdlcyBhcmUgYWx3YXlzIGRpc3BsYXllZC4iKQogCiAo ZGVmdW4gcGFja2FnZS1tZW51LXRvZ2dsZS1oaWRpbmcgKCkKLSAgIlRvZ2dsZSB2aXNpYmlsaXR5 IG9mIG9ic29sZXRlIGF2YWlsYWJsZSBwYWNrYWdlcy4iCisgICJJbiBQYWNrYWdlIE1lbnUsIHRv Z2dsZSB2aXNpYmlsaXR5IG9mIG9ic29sZXRlIGF2YWlsYWJsZSBwYWNrYWdlcy4iCiAgIChpbnRl cmFjdGl2ZSkKICAgKHVubGVzcyAoZGVyaXZlZC1tb2RlLXAgJ3BhY2thZ2UtbWVudS1tb2RlKQog ICAgICh1c2VyLWVycm9yICJUaGUgY3VycmVudCBidWZmZXIgaXMgbm90IGEgUGFja2FnZSBNZW51 IikpCkBAIC0yODQwLDcgKzI4ODQsNyBAQCBwYWNrYWdlLWhpZGRlbi1yZWdleHBzCiBvbWl0dGVk IGZyb20gdGhlIHBhY2thZ2UgbWVudS4gIFRvIHRvZ2dsZSB0aGlzLCB0eXBlIFxcW3BhY2thZ2Ut bWVudS10b2dnbGUtaGlkaW5nXS4KIAogVmFsdWVzIGNhbiBiZSBpbnRlcmFjdGl2ZWx5IGFkZGVk IHRvIHRoaXMgbGlzdCBieSB0eXBpbmcKLVxcW3BhY2thZ2UtbWVudS1oaWRlLXBhY2thZ2VdIG9u IGEgcGFja2FnZSIKK1xcW3BhY2thZ2UtbWVudS1oaWRlLXBhY2thZ2VdIG9uIGEgcGFja2FnZS4i CiAgIDp2ZXJzaW9uICIyNS4xIgogICA6dHlwZSAnKHJlcGVhdCAocmVnZXhwIDp0YWcgIkhpZGUg cGFja2FnZXMgd2l0aCBuYW1lIG1hdGNoaW5nIikpKQogCkBAIC0zMTAwLDcgKzMxNDQsNyBAQCBw YWNrYWdlLW1lbnUtcmVmcmVzaAogICAocGFja2FnZS1yZWZyZXNoLWNvbnRlbnRzIHBhY2thZ2Ut bWVudS1hc3luYykpCiAKIChkZWZ1biBwYWNrYWdlLW1lbnUtaGlkZS1wYWNrYWdlICgpCi0gICJI aWRlIGEgcGFja2FnZSB1bmRlciBwb2ludC4KKyAgIkhpZGUgYSBwYWNrYWdlIHVuZGVyIHBvaW50 IGluIFBhY2thZ2UgTWVudS4KIElmIG9wdGlvbmFsIGFyZyBCVVRUT04gaXMgbm9uLW5pbCwgZGVz Y3JpYmUgaXRzIGFzc29jaWF0ZWQgcGFja2FnZS4iCiAgIChpbnRlcmFjdGl2ZSkKICAgKGRlY2xh cmUgKGludGVyYWN0aXZlLW9ubHkgImNoYW5nZSBgcGFja2FnZS1oaWRkZW4tcmVnZXhwcycgaW5z dGVhZC4iKSkKQEAgLTMxOTksNiArMzI0Myw3IEBAIHBhY2thZ2UtbWVudS1xdWljay1oZWxwCiAg ICdwYWNrYWdlLW1lbnUtdmlldy1jb21tZW50YXJ5ICdwYWNrYWdlLW1lbnUtZGVzY3JpYmUtcGFj a2FnZSAiMjQuMSIpCiAKIChkZWZ1biBwYWNrYWdlLW1lbnUtZ2V0LXN0YXR1cyAoKQorICAiUmV0 dXJuIHN0YXR1cyB0ZXh0IG9mIHBhY2thZ2UgYXQgcG9pbnQgaW4gUGFja2FnZSBNZW51LiIKICAg KGxldCogKChpZCAodGFidWxhdGVkLWxpc3QtZ2V0LWlkKSkKICAgICAgICAgIChlbnRyeSAoYW5k IGlkIChhc3NvYyBpZCB0YWJ1bGF0ZWQtbGlzdC1lbnRyaWVzKSkpKQogICAgIChpZiBlbnRyeQpA QCAtMzIyNCw2ICszMjY5LDEwIEBAIHBhY2thZ2UtZGVzYy1wcmlvcml0eS12ZXJzaW9uCiAgICAg ICAgIChwYWNrYWdlLWRlc2MtdmVyc2lvbiBwa2ctZGVzYykpKQogCiAoZGVmdW4gcGFja2FnZS1t ZW51LS1maW5kLXVwZ3JhZGVzICgpCisgICJJbiBQYWNrYWdlIE1lbnUsIHJldHVybiBhbiBhbGlz dCBvZiBwYWNrYWdlcyB0aGF0IGNhbiBiZSB1cGdyYWRlZC4KK1RoZSBhbGlzdCBoYXMgdGhlIHNh bWUgZm9ybSBhcyBgcGFja2FnZS1hbGlzdCcsIG5hbWVseSBhIGxpc3QKK29mIChQS0cgLiBERVND UyksIGJ1dCB3aGVyZSBERVNDUyBpcyB0aGUgYHBhY2thZ2UtZGVzYycgb2JqZWN0Citjb3JyZXNw b25kaW5nIHRvIHRoZSBuZXdlciB2ZXJzaW9uLiIKICAgKGxldCAoaW5zdGFsbGVkIGF2YWlsYWJs ZSB1cGdyYWRlcykKICAgICA7OyBCdWlsZCBsaXN0IG9mIGluc3RhbGxlZC9hdmFpbGFibGUgcGFj a2FnZXMgaW4gdGhpcyBidWZmZXIuCiAgICAgKGRvbGlzdCAoZW50cnkgdGFidWxhdGVkLWxpc3Qt ZW50cmllcykKQEAgLTM0ODcsNyArMzUzNiw3IEBAIHBhY2thZ2UtbWVudS0tZmluZC1hbmQtbm90 aWZ5LXVwZ3JhZGVzCiAKIAogKGRlZnVuIHBhY2thZ2UtbWVudS0tcG9zdC1yZWZyZXNoICgpCi0g ICJJZiB0aGVyZSdzIGEgKlBhY2thZ2VzKiBidWZmZXIsIHJldmVydCBpdCBhbmQgY2hlY2sgZm9y IG5ldyBwYWNrYWdlcyBhbmQgdXBncmFkZXMuCisgICJSZXZlcnQgXCIqUGFja2FnZXMqXCIgYnVm ZmVyIGFuZCBjaGVjayBmb3IgbmV3IHBhY2thZ2VzIGFuZCB1cGdyYWRlcy4KIERvIG5vdGhpbmcg aWYgdGhlcmUncyBubyAqUGFja2FnZXMqIGJ1ZmZlci4KIAogVGhpcyBmdW5jdGlvbiBpcyBjYWxs ZWQgYWZ0ZXIgYHBhY2thZ2UtcmVmcmVzaC1jb250ZW50cycgYW5kIGl0Ci0tIAoyLjIwLjEKCg== --000000000000edf95f05929ce34c-- From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 21 17:14:53 2019 Received: (at 37410-done) by debbugs.gnu.org; 21 Sep 2019 21:14:53 +0000 Received: from localhost ([127.0.0.1]:33260 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iBmiT-0000Sy-Lb for submit@debbugs.gnu.org; Sat, 21 Sep 2019 17:14:53 -0400 Received: from mail-pl1-f196.google.com ([209.85.214.196]:35030) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iBmiS-0000Sh-KL for 37410-done@debbugs.gnu.org; Sat, 21 Sep 2019 17:14:52 -0400 Received: by mail-pl1-f196.google.com with SMTP id y10so3459501plp.2 for <37410-done@debbugs.gnu.org>; Sat, 21 Sep 2019 14:14:52 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=fI7w30Nfg1+ayOlr35AmC87f4DEY5bV3v9fCWS86rGY=; b=uCfKjTirzLzggdqYDVoICcbjJq69D2ZkIL1L+RwdQ2a4MYaHUse0+aVRar2cjfXvDX PiOqeNxJYQmyqJrje6Vy4Mg9/+u89vELhpdE+97Of9icMBcPUqgnfRi5YA+qRhb+zfrt IVgRxEQecmG5PYZjMLPE+m64v5GuZrw5SCss9rkoeUEEirjp+VNlopI0H2QzP/WVCG/c 2iaCORpfqZoxnDQ6LKp3wyidIcrh07l6EzyXp8NzrtlNzT9aKpEqp4Cg//rFMpu5pCWe 3Hya+6UlYiys6gWtfeimhTIJRJgzgqGXxI4AucfuvoboWvQjehDjN7UefrGqO8sdVlvG 0H7w== X-Gm-Message-State: APjAAAXO6kUt5cU58tTiQAFR7rLYIshWhoDOjj4F2fUWrmx5ZLPrFwFK pIyUXYCjUKgO3QV7WsZwLQS/IDw6jCsIk1skYsJoxh+a X-Google-Smtp-Source: APXvYqyvXo1YrZ6WvtORQbBjeFDOJZkwIdFjcwzQcIE9ifevsn9f3kqHZ0OmkuEO3rF9gm8wXcdTwkQYMm5aBzE870I= X-Received: by 2002:a17:902:bd97:: with SMTP id q23mr24864172pls.259.1569100486875; Sat, 21 Sep 2019 14:14:46 -0700 (PDT) MIME-Version: 1.0 References: <83a7b5y0qt.fsf@gnu.org> In-Reply-To: From: Stefan Kangas Date: Sat, 21 Sep 2019 23:14:35 +0200 Message-ID: Subject: Re: bug#37410: [PATCH] Several doc fixes in package.el To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 37410-done Cc: 37410-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) Stefan Kangas writes: > Thanks for your detailed review. I have attached an updated patch. No more comments in a week, so I've now pushed this as commit b86bc62ca5. > >> (defun package-install-file (file) > >> - "Install a package from a file. > >> + "Install package from FILE. > > > > And this? > > I think the original is wordy for no reason, and imprecise: We do not > install just "a package" in general, but specifically the package > pointed to by FILE. But if I'm the only one who feels that the terse > version is better, I'm willing to concede that point. In the end, I stuck with: "Install a package from FILE." Best regards, Stefan Kangas From unknown Sat Jun 21 10:17:33 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 20 Oct 2019 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator