From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.bugs Subject: bug#36206: [PATCH] Change `user-error' docstring from "pilot error" to "user error" Date: Sat, 22 Jun 2019 17:39:23 -0700 Organization: UCLA Computer Science Department Message-ID: <71cf083c-441c-6e94-772a-68550161b455@cs.ucla.edu> References: Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------DBD9DDA1826C20DC2D1ED078" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="191636"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.7.1 Cc: 36206@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 23 02:40:12 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1heqYG-000nk7-0n for geb-bug-gnu-emacs@m.gmane.org; Sun, 23 Jun 2019 02:40:12 +0200 Original-Received: from localhost ([::1]:42792 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1heqYE-0005gj-EA for geb-bug-gnu-emacs@m.gmane.org; Sat, 22 Jun 2019 20:40:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52331) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1heqY8-0005gX-AJ for bug-gnu-emacs@gnu.org; Sat, 22 Jun 2019 20:40:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1heqY6-0006nq-GD for bug-gnu-emacs@gnu.org; Sat, 22 Jun 2019 20:40:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39182) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1heqY6-0006nh-8j for bug-gnu-emacs@gnu.org; Sat, 22 Jun 2019 20:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1heqY6-00008a-1z for bug-gnu-emacs@gnu.org; Sat, 22 Jun 2019 20:40:02 -0400 X-Loop: help-debbugs@gnu.org In-Reply-To: Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 23 Jun 2019 00:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36206 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 36206-submit@debbugs.gnu.org id=B36206.1561250374486 (code B ref 36206); Sun, 23 Jun 2019 00:40:01 +0000 Original-Received: (at 36206) by debbugs.gnu.org; 23 Jun 2019 00:39:34 +0000 Original-Received: from localhost ([127.0.0.1]:52726 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1heqXe-00007l-1Q for submit@debbugs.gnu.org; Sat, 22 Jun 2019 20:39:34 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:46736) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1heqXb-00007X-It for 36206@debbugs.gnu.org; Sat, 22 Jun 2019 20:39:32 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id EA3D5161CC1; Sat, 22 Jun 2019 17:39:24 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id OTC5-Vs5KoCk; Sat, 22 Jun 2019 17:39:23 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id BCFEB161CC4; Sat, 22 Jun 2019 17:39:23 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id hRcWQMMDCaHq; Sat, 22 Jun 2019 17:39:23 -0700 (PDT) Original-Received: from [192.168.1.9] (cpe-23-242-74-103.socal.res.rr.com [23.242.74.103]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 84CDA161C47; Sat, 22 Jun 2019 17:39:23 -0700 (PDT) Content-Language: en-US X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:161078 Archived-At: This is a multi-part message in MIME format. --------------DBD9DDA1826C20DC2D1ED078 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Thanks for the proposed fix. Although it appears that the proposal has substantial support, some reviewers like the phrase "pilot error". So I propose the attached additional patch, which keeps the phrase "pilot error" and says that it means the same thing as "user error" - a point that will help people unfamiliar with the term "pilot error". This patch also takes the bikeshedding opportunity to improve the doc strings further by ordering them more logically and tightening up the wording. --------------DBD9DDA1826C20DC2D1ED078 Content-Type: text/plain; charset=UTF-8; name="0001-Tweak-error-and-user-error-doc-strings.txt" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="0001-Tweak-error-and-user-error-doc-strings.txt" RnJvbSA2MzVlMzE3NTc4MWFhNzBjMDQ3ZTcwOWM2Nzg1NzJhMDcwYjQ0YTdlIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1 PgpEYXRlOiBTYXQsIDIyIEp1biAyMDE5IDE3OjI4OjU0IC0wNzAwClN1YmplY3Q6IFtQQVRD SF0gPT9VVEYtOD9xP1R3ZWFrPTIwPUUyPTgwPTk4ZXJyb3I9RTI9ODA9OTk9MjBhbmQ9MjA/ PQogPT9VVEYtOD9xPz1FMj04MD05OHVzZXItZXJyb3I9RTI9ODA9OTk9MjBkb2M9MjBzdHJp bmdzPz0KTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFy c2V0PVVURi04CkNvbnRlbnQtVHJhbnNmZXItRW5jb2Rpbmc6IDhiaXQKCiogbGlzcC9uZXQv dHJhbXAuZWwgKHRyYW1wLXVzZXItZXJyb3IpOgoqIGxpc3Avc3Vici5lbCAodXNlci1lcnJv cik6ClNheSB0aGF0IHVzZXIgZXJyb3JzIGFyZSBzb21ldGltZXMgY2FsbGVkIHBpbG90IGVy cm9ycy4KKiBsaXNwL3N1YnIuZWwgKGVycm9yLCB1c2VyLWVycm9yKToKUmVvcmRlciB3b3Jk aW5nIHRvIGRpc2N1c3MgbWVjaGFuaXNtIGZpcnN0LCB0aGVuIGZvcm1hdHRpbmcgYWR2aWNl LApyYXRoZXIgdGhhbiBnb2luZyBiYWNrIGFuZCBmb3J0aCBiZXR3ZWVuIHRoZSB0d28gdG9w aWNzLgpUaWdodGVuIHVwIHRoZSB3b3JkaW5nIGEgYml0LgotLS0KIGxpc3AvbmV0L3RyYW1w LmVsIHwgIDIgKy0KIGxpc3Avc3Vici5lbCAgICAgIHwgMjcgKysrKysrKysrKysrKy0tLS0t LS0tLS0tLS0tCiAyIGZpbGVzIGNoYW5nZWQsIDE0IGluc2VydGlvbnMoKyksIDE1IGRlbGV0 aW9ucygtKQoKZGlmZiAtLWdpdCBhL2xpc3AvbmV0L3RyYW1wLmVsIGIvbGlzcC9uZXQvdHJh bXAuZWwKaW5kZXggN2I2ZGNjYzk5MC4uNjUzMTQzZGZjNyAxMDA2NDQKLS0tIGEvbGlzcC9u ZXQvdHJhbXAuZWwKKysrIGIvbGlzcC9uZXQvdHJhbXAuZWwKQEAgLTE4NTksNyArMTg1OSw3 IEBAIHRyYW1wLWVycm9yLXdpdGgtYnVmZmVyCiAKIDs7IFdlIG11c3QgbWFrZSBpdCBhIGRl ZnVuLCBiZWNhdXNlIGl0IGlzIHVzZWQgZWFybGllciBhbHJlYWR5LgogKGRlZnVuIHRyYW1w LXVzZXItZXJyb3IgKHZlYy1vci1wcm9jIGZtdC1zdHJpbmcgJnJlc3QgYXJndW1lbnRzKQot ICAiU2lnbmFsIGEgdXNlciBlcnJvci4iCisgICJTaWduYWwgYSB1c2VyIGVycm9yIChvciDi gJxwaWxvdCBlcnJvcuKAnSkuIgogICAodW53aW5kLXByb3RlY3QKICAgICAgIChhcHBseQog ICAgICAgICMndHJhbXAtZXJyb3IgdmVjLW9yLXByb2MKZGlmZiAtLWdpdCBhL2xpc3Avc3Vi ci5lbCBiL2xpc3Avc3Vici5lbAppbmRleCAzZTg0MTQwZmQ4Li5hY2NlODIyZDdiIDEwMDY0 NAotLS0gYS9saXNwL3N1YnIuZWwKKysrIGIvbGlzcC9zdWJyLmVsCkBAIC0zMjcsMzEgKzMy NywzMCBAQCBpZ25vcmUKIDs7IFNpZ25hbCBhIGNvbXBpbGUtZXJyb3IgaWYgdGhlIGZpcnN0 IGFyZyBpcyBtaXNzaW5nLgogKGRlZnVuIGVycm9yICgmcmVzdCBhcmdzKQogICAiU2lnbmFs IGFuIGVycm9yLCBtYWtpbmcgYSBtZXNzYWdlIGJ5IHBhc3NpbmcgQVJHUyB0byBgZm9ybWF0 LW1lc3NhZ2UnLgorRXJyb3JzIGNhdXNlIGVudHJ5IHRvIHRoZSBkZWJ1Z2dlciB3aGVuIGBk ZWJ1Zy1vbi1lcnJvcicgaXMgbm9uLW5pbC4KK1RoaXMgY2FuIGJlIG92ZXJyaWRkZW4gYnkg YGRlYnVnLWlnbm9yZWQtZXJyb3JzJy4KKworVG8gc2lnbmFsIHdpdGggTUVTU0FHRSB3aXRo b3V0IGludGVycHJldGluZyBmb3JtYXQgY2hhcmFjdGVycworbGlrZSBgJScsIGBcXD1gJyBh bmQgYFxcPScnLCB1c2UgKGVycm9yIFwiJXNcIiBNRVNTQUdFKS4KIEluIEVtYWNzLCB0aGUg Y29udmVudGlvbiBpcyB0aGF0IGVycm9yIG1lc3NhZ2VzIHN0YXJ0IHdpdGggYSBjYXBpdGFs CiBsZXR0ZXIgYnV0ICpkbyBub3QqIGVuZCB3aXRoIGEgcGVyaW9kLiAgUGxlYXNlIGZvbGxv dyB0aGlzIGNvbnZlbnRpb24KLWZvciB0aGUgc2FrZSBvZiBjb25zaXN0ZW5jeS4KLUVycm9y cyBjYXVzZSBlbnRyeSB0byB0aGUgZGVidWdnZXIgd2hlbiBgZGVidWctb24tZXJyb3InIGlz Ci1ub24tbmlsLiAgVGhpcyBjYW4gYmUgb3ZlcnJpZGRlbiBieSBgZGVidWctaWdub3JlZC1l cnJvcnMnLgotCi1Ob3RlOiAoZXJyb3IgXCIlc1wiIFZBTFVFKSBtYWtlcyB0aGUgbWVzc2Fn ZSBWQUxVRSB3aXRob3V0Ci1pbnRlcnByZXRpbmcgZm9ybWF0IGNoYXJhY3RlcnMgbGlrZSBg JScsIGBcXD1gJywgYW5kIGBcXD0nJy4iCitmb3IgdGhlIHNha2Ugb2YgY29uc2lzdGVuY3ku IgogICAoZGVjbGFyZSAoYWR2ZXJ0aXNlZC1jYWxsaW5nLWNvbnZlbnRpb24gKHN0cmluZyAm cmVzdCBhcmdzKSAiMjMuMSIpKQogICAoc2lnbmFsICdlcnJvciAobGlzdCAoYXBwbHkgIydm b3JtYXQtbWVzc2FnZSBhcmdzKSkpKQogCiAoZGVmdW4gdXNlci1lcnJvciAoZm9ybWF0ICZy ZXN0IGFyZ3MpCiAgICJTaWduYWwgYSB1c2VyIGVycm9yLCBtYWtpbmcgYSBtZXNzYWdlIGJ5 IHBhc3NpbmcgQVJHUyB0byBgZm9ybWF0LW1lc3NhZ2UnLgotVGhpcyBpcyBqdXN0IGxpa2Ug YGVycm9yJyBleGNlcHQgdGhhdCBgdXNlci1lcnJvcidzIGFyZSBleHBlY3RlZCB0byBiZSB0 aGUKLXJlc3VsdCBvZiBhbiBpbmNvcnJlY3QgbWFuaXB1bGF0aW9uIG9uIHRoZSBwYXJ0IG9m IHRoZSB1c2VyLCByYXRoZXIgdGhhbiB0aGUKLXJlc3VsdCBvZiBhbiBhY3R1YWwgcHJvYmxl bS4KLUluIEVtYWNzLCB0aGUgY29udmVudGlvbiBpcyB0aGF0IGVycm9yIG1lc3NhZ2VzIHN0 YXJ0IHdpdGggYSBjYXBpdGFsCi1sZXR0ZXIgYnV0ICpkbyBub3QqIGVuZCB3aXRoIGEgcGVy aW9kLiAgUGxlYXNlIGZvbGxvdyB0aGlzIGNvbnZlbnRpb24KLWZvciB0aGUgc2FrZSBvZiBj b25zaXN0ZW5jeS4KK1RoaXMgaXMgbGlrZSBgZXJyb3InIGV4Y2VwdCB0aGF0IGEgdXNlciBl cnJvciAob3Ig4oCccGlsb3QgZXJyb3LigJ0pIGNvbWVzCitmcm9tIGFuIGluY29ycmVjdCBt YW5pcHVsYXRpb24gYnkgdGhlIHVzZXIsIG5vdCBmcm9tIGFuIGFjdHVhbCBwcm9ibGVtLgog SW4gY29udHJhc3Qgd2l0aCBvdGhlciBlcnJvcnMsIHVzZXIgZXJyb3JzIG5vcm1hbGx5IGRv IG5vdCBjYXVzZQogZW50cnkgdG8gdGhlIGRlYnVnZ2VyLCBldmVuIHdoZW4gYGRlYnVnLW9u LWVycm9yJyBpcyBub24tbmlsLgogVGhpcyBjYW4gYmUgb3ZlcnJpZGRlbiBieSBgZGVidWct aWdub3JlZC1lcnJvcnMnLgogCi1Ob3RlOiAodXNlci1lcnJvciBcIiVzXCIgVkFMVUUpIG1h a2VzIHRoZSBtZXNzYWdlIFZBTFVFIHdpdGhvdXQKLWludGVycHJldGluZyBmb3JtYXQgY2hh cmFjdGVycyBsaWtlIGAlJywgYFxcPWAnLCBhbmQgYFxcPScnLiIKK1RvIHNpZ25hbCB3aXRo IE1FU1NBR0Ugd2l0aG91dCBpbnRlcnByZXRpbmcgZm9ybWF0IGNoYXJhY3RlcnMKK2xpa2Ug YCUnLCBgXFw9YCcgYW5kIGBcXD0nJywgdXNlIChlcnJvciBcIiVzXCIgTUVTU0FHRSkuCitJ biBFbWFjcywgdGhlIGNvbnZlbnRpb24gaXMgdGhhdCBlcnJvciBtZXNzYWdlcyBzdGFydCB3 aXRoIGEgY2FwaXRhbAorbGV0dGVyIGJ1dCAqZG8gbm90KiBlbmQgd2l0aCBhIHBlcmlvZC4g IFBsZWFzZSBmb2xsb3cgdGhpcyBjb252ZW50aW9uCitmb3IgdGhlIHNha2Ugb2YgY29uc2lz dGVuY3kuIgogICAoc2lnbmFsICd1c2VyLWVycm9yIChsaXN0IChhcHBseSAjJ2Zvcm1hdC1t ZXNzYWdlIGZvcm1hdCBhcmdzKSkpKQogCiAoZGVmdW4gZGVmaW5lLWVycm9yIChuYW1lIG1l c3NhZ2UgJm9wdGlvbmFsIHBhcmVudCkKLS0gCjIuMTcuMQoK --------------DBD9DDA1826C20DC2D1ED078--