From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 20 09:22:10 2021 Received: (at submit) by debbugs.gnu.org; 20 Jul 2021 13:22:10 +0000 Received: from localhost ([127.0.0.1]:33224 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5phK-0007Ct-22 for submit@debbugs.gnu.org; Tue, 20 Jul 2021 09:22:10 -0400 Received: from lists.gnu.org ([209.51.188.17]:51938) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5phI-0007Cl-LC for submit@debbugs.gnu.org; Tue, 20 Jul 2021 09:22:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:56838) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m5phI-000777-Eh for bug-gnu-emacs@gnu.org; Tue, 20 Jul 2021 09:22:08 -0400 Received: from forward104o.mail.yandex.net ([2a02:6b8:0:1a2d::607]:47706) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m5phF-0006ZF-DG for bug-gnu-emacs@gnu.org; Tue, 20 Jul 2021 09:22:07 -0400 Received: from myt4-5dd3963c4bb1.qloud-c.yandex.net (myt4-5dd3963c4bb1.qloud-c.yandex.net [IPv6:2a02:6b8:c12:525:0:640:5dd3:963c]) by forward104o.mail.yandex.net (Yandex) with ESMTP id 54D02941A6D for ; Tue, 20 Jul 2021 16:21:58 +0300 (MSK) Received: from myt5-aad1beefab42.qloud-c.yandex.net (myt5-aad1beefab42.qloud-c.yandex.net [2a02:6b8:c12:128:0:640:aad1:beef]) by myt4-5dd3963c4bb1.qloud-c.yandex.net (mxback/Yandex) with ESMTP id DQR9v263lA-LwIKTerS; Tue, 20 Jul 2021 16:21:58 +0300 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex.ru; s=mail; t=1626787318; bh=MHzfzfnB7aDVg9Q3nDtg5eQ/Q8lOgo9QXoMxlHh6ahk=; h=Date:To:From:Subject:Message-ID; b=S3Re4lQQFLN5gd78zCykmu69SsaPfAU8weVyN083wftWGD1TPgb7ue10MBYfboFrd 4tEatx9s9Q6yy8dKFGrDte6lrF+fI491+fw4LqLI2e8knWbI2Eo/bg8jmBP4LLvHeE XwgWRI3HMR//LgraSYkWbcp2ywKEzisWAnxkdL5U= Authentication-Results: myt4-5dd3963c4bb1.qloud-c.yandex.net; dkim=pass header.i=@yandex.ru Received: by myt5-aad1beefab42.qloud-c.yandex.net (smtp/Yandex) with ESMTPSA id pi7UmlN5zf-Lv58SWQ4; Tue, 20 Jul 2021 16:21:57 +0300 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (Client certificate not present) Message-ID: <04087dac4bcedf495a0561b392c20091c265433f.camel@yandex.ru> Subject: (patches) Improve docs for revert-buffer and auto-revert-mode From: Konstantin Kharlamov To: bug-gnu-emacs@gnu.org Date: Tue, 20 Jul 2021 16:21:57 +0300 Content-Type: multipart/mixed; boundary="=-eQUVJf02RI/vRftHfmna" User-Agent: Evolution 3.40.2 MIME-Version: 1.0 Received-SPF: pass client-ip=2a02:6b8:0:1a2d::607; envelope-from=hi-angel@yandex.ru; helo=forward104o.mail.yandex.net 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, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -0.0 (/) 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: -2.3 (--) --=-eQUVJf02RI/vRftHfmna Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit Patches attached. The reasoning behind the changes as follow: 1. `revert-buffer`: its current docs only mention that it tries its best to keep markers, but it does not mention that it may fail to do so, and that there is a slower but better alternative to this function. The lack of it being mentioned resulted in me researching its code down to C, and also another maintainer testing a bug, and yet another contributor writing up a large post about the new alternative revert functions…¹ All of that could've been avoided had `revert-function` referred to the new alternative, so that's what the patch does. 2. `auto-revert-mode`: Even with the change in 1 it's still unclear how to make use of that for `auto-revert-mode`. It does not even mention that the mode may break markers, so a person would have to debug it and find out revert-buffer, which in turn mentions about the problem, but doesn't really mention how to fix the auto-revert-mode specifically. So let's save people time, and just have a paragraph about it as well. 1: https://github.com/magit/magit/issues/4442 --=-eQUVJf02RI/vRftHfmna Content-Disposition: attachment; filename*0=0001-Mention-that-revert-buffer-isn-t-best-for-markers-pr.pat; filename*1=ch Content-Transfer-Encoding: base64 Content-Type: text/x-patch; name="0001-Mention-that-revert-buffer-isn-t-best-for-markers-pr.patch"; charset="UTF-8" RnJvbSAyYzIyMzYxNTVlNTRlMjQ4YjExODJlZmU2NmRhZmM2Zjg2MmNlYWU0IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBLb25zdGFudGluIEtoYXJsYW1vdiA8SGktQW5nZWxAeWFuZGV4 LnJ1PgpEYXRlOiBUdWUsIDIwIEp1bCAyMDIxIDE1OjUyOjQ4ICswMzAwClN1YmplY3Q6IFtQQVRD SCAxLzJdIE1lbnRpb24gdGhhdCAocmV2ZXJ0LWJ1ZmZlcikgaXNuJ3QgYmVzdCBmb3IgbWFya2Vy cwogcHJlc2VydmF0aW9uCgoqIGxpc3AvZmlsZXMuZWwgKHJldmVydC1idWZmZXIpOiBtZW50aW9u IHRoYXQgdGhlcmUgaXMKICByZXZlcnQtYnVmZmVyLXdpdGgtZmluZS1ncmFpbiB0aGF0IGlzIGJl dHRlciBzdWl0ZWQgZm9yIG1hcmtlcnMKcHJlc2VydmF0aW9uCi0tLQogbGlzcC9maWxlcy5lbCB8 IDUgKysrLS0KIDEgZmlsZSBjaGFuZ2VkLCAzIGluc2VydGlvbnMoKyksIDIgZGVsZXRpb25zKC0p CgpkaWZmIC0tZ2l0IGEvbGlzcC9maWxlcy5lbCBiL2xpc3AvZmlsZXMuZWwKaW5kZXggNTkwNzdj ZDI2NmEuLmMyY2VjNGRjMmEyIDEwMDY0NAotLS0gYS9saXNwL2ZpbGVzLmVsCisrKyBiL2xpc3Av ZmlsZXMuZWwKQEAgLTYyNzQsOCArNjI3NCw5IEBAIHJldmVydC1idWZmZXIKIFdpdGggYSBwcmVm aXggYXJndW1lbnQsIG9mZmVyIHRvIHJldmVydCBmcm9tIGxhdGVzdCBhdXRvLXNhdmUgZmlsZSwg aWYKIHRoYXQgaXMgbW9yZSByZWNlbnQgdGhhbiB0aGUgdmlzaXRlZCBmaWxlLgogCi1SZXZlcnRp bmcgYSBidWZmZXIgd2lsbCB0cnkgdG8gcHJlc2VydmUgbWFya2VycyBpbiB0aGUgYnVmZmVyOwot c2VlIHRoZSBJbmZvIG5vZGUgYChlbGlzcClSZXZlcnRpbmcnIGZvciBkZXRhaWxzLgorUmV2ZXJ0 aW5nIGEgYnVmZmVyIHdpbGwgdHJ5IHRvIHByZXNlcnZlIG1hcmtlcnMgaW4gdGhlIGJ1ZmZlciwK K2J1dCBmb3IgYmV0dGVyIHJlc3VsdHMgc2VlIGByZXZlcnQtYnVmZmVyLXdpdGgtZmluZS1ncmFp bicuIEZvcgorZGV0YWlscyBzZWUgdGhlIEluZm8gbm9kZSBgKGVsaXNwKVJldmVydGluZycuCiAK IFRoaXMgY29tbWFuZCBhbHNvIGltcGxlbWVudHMgYW4gaW50ZXJmYWNlIGZvciBzcGVjaWFsIGJ1 ZmZlcnMKIHRoYXQgY29udGFpbiB0ZXh0IHRoYXQgZG9lc24ndCBjb21lIGZyb20gYSBmaWxlLCBi dXQgcmVmbGVjdHMKLS0gCjIuMzIuMAoK --=-eQUVJf02RI/vRftHfmna Content-Disposition: attachment; filename="0002-Mention-that-auto-revert-mode-may-break-markers.patch" Content-Transfer-Encoding: base64 Content-Type: text/x-patch; name="0002-Mention-that-auto-revert-mode-may-break-markers.patch"; charset="UTF-8" RnJvbSBjMGQ1ZTc2NTcwOGY1ZWNkMGRjYzViOTdlNDZkZWU1MDQyOWRmNDZiIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBLb25zdGFudGluIEtoYXJsYW1vdiA8SGktQW5nZWxAeWFuZGV4 LnJ1PgpEYXRlOiBUdWUsIDIwIEp1bCAyMDIxIDE2OjAyOjE2ICswMzAwClN1YmplY3Q6IFtQQVRD SCAyLzJdIE1lbnRpb24gdGhhdCBhdXRvLXJldmVydC1tb2RlIG1heSBicmVhayBtYXJrZXJzCgps aXNwL2F1dG9yZXZlcnQuZWwgKGF1dG8tcmV2ZXJ0LW1vZGUpOiBNZW50aW9uIHRoYXQgYXV0by1y ZXZlcnQtbW9kZSBtYXkKYnJlYWsgbWFya2VycwotLS0KIGxpc3AvYXV0b3JldmVydC5lbCB8IDYg KysrKysrCiAxIGZpbGUgY2hhbmdlZCwgNiBpbnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEvbGlz cC9hdXRvcmV2ZXJ0LmVsIGIvbGlzcC9hdXRvcmV2ZXJ0LmVsCmluZGV4IGVkZDRjN2U1ZTQ1Li4w MDM3ZTExODVkMSAxMDA2NDQKLS0tIGEvbGlzcC9hdXRvcmV2ZXJ0LmVsCisrKyBiL2xpc3AvYXV0 b3JldmVydC5lbApAQCAtMzkxLDYgKzM5MSwxMiBAQCBhdXRvLXJldmVydC1tb2RlCiBXaGVuIGEg YnVmZmVyIGlzIHJldmVydGVkLCBhIG1lc3NhZ2UgaXMgZ2VuZXJhdGVkLiAgVGhpcyBjYW4gYmUK IHN1cHByZXNzZWQgYnkgc2V0dGluZyBgYXV0by1yZXZlcnQtdmVyYm9zZScgdG8gbmlsLgogCitS ZXZlcnRpbmcgbWF5IGFsc28gYnJlYWsgbWFya2VycyBpbiB0aGUgYnVmZmVyLiBUbyBhdm9pZCB0 aGF0IHlvdQorbWF5IHNldCBgcmV2ZXJ0LWJ1ZmZlci1pbnNlcnQtZmlsZS1jb250ZW50cy1mdW5j dGlvbicgdG8gdGhlCitzbG93ZXIgZnVuY3Rpb24KK2ByZXZlcnQtYnVmZmVyLWluc2VydC1maWxl LWNvbnRlbnRzLWRlbGljYXRlbHknLiBTZWUgaXRzCitkZXNjcmlwdGlvbiBmb3IgZGV0YWlscy4K KwogVXNlIGBnbG9iYWwtYXV0by1yZXZlcnQtbW9kZScgdG8gYXV0b21hdGljYWxseSByZXZlcnQg YWxsIGJ1ZmZlcnMuCiBVc2UgYGF1dG8tcmV2ZXJ0LXRhaWwtbW9kZScgaWYgeW91IGtub3cgdGhh dCB0aGUgZmlsZSB3aWxsIG9ubHkgZ3Jvdwogd2l0aG91dCBiZWluZyBjaGFuZ2VkIGluIHRoZSBw YXJ0IHRoYXQgaXMgYWxyZWFkeSBpbiB0aGUgYnVmZmVyLiIKLS0gCjIuMzIuMAoK --=-eQUVJf02RI/vRftHfmna-- From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 20 10:40:06 2021 Received: (at 49661) by debbugs.gnu.org; 20 Jul 2021 14:40:07 +0000 Received: from localhost ([127.0.0.1]:35059 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5quk-0005bF-N8 for submit@debbugs.gnu.org; Tue, 20 Jul 2021 10:40:06 -0400 Received: from quimby.gnus.org ([95.216.78.240]:58326) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5qui-0005ae-1q for 49661@debbugs.gnu.org; Tue, 20 Jul 2021 10:40:04 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=Mcxf9tYpwNJsbXBGmMxpa7lKgyolLlBBGwHiWM2Pk3o=; b=nB5Vtrp6sVhhwrakc+OiYi6cPb Lp+xp7xFget2sppsT/ofvBdIWk4BOGXbSYL2JpdsbRzYF7AiepZyvwodkYFC0Zio/D6Tv1idK+qIk eY51ooHYffwgNg0suRRlvMmKQnXEtMvI9pET1iGQGG+fn0MjtYC7/DwiupVAac0xCOns=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m5quZ-0004F0-D0; Tue, 20 Jul 2021 16:39:57 +0200 From: Lars Ingebrigtsen To: Konstantin Kharlamov Subject: Re: bug#49661: (patches) Improve docs for revert-buffer and auto-revert-mode References: <04087dac4bcedf495a0561b392c20091c265433f.camel@yandex.ru> X-Now-Playing: Afik Naim's _Fabric 94: Steffi_: "Saturniidae" Date: Tue, 20 Jul 2021 16:39:54 +0200 In-Reply-To: <04087dac4bcedf495a0561b392c20091c265433f.camel@yandex.ru> (Konstantin Kharlamov's message of "Tue, 20 Jul 2021 16:21:57 +0300") Message-ID: <87h7gpcamd.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.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 @@CONTACT_ADDRESS@@ for details. Content preview: Konstantin Kharlamov writes: > Patches attached. Thanks; applied to Emacs 28 (with some trivial white-space changes -- we prefer two spaces after "." in doc strings). Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 49661 Cc: 49661@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 (---) Konstantin Kharlamov writes: > Patches attached. Thanks; applied to Emacs 28 (with some trivial white-space changes -- we prefer two spaces after "." in doc strings). -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 20 10:40:09 2021 Received: (at control) by debbugs.gnu.org; 20 Jul 2021 14:40:09 +0000 Received: from localhost ([127.0.0.1]:35062 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5qum-0005bU-To for submit@debbugs.gnu.org; Tue, 20 Jul 2021 10:40:09 -0400 Received: from quimby.gnus.org ([95.216.78.240]:58342) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m5qul-0005as-GJ for control@debbugs.gnu.org; Tue, 20 Jul 2021 10:40:07 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=1kWt9m0GX6h9qhn4Qm7ecxZgsHqU4AzP/Kk+//gyw4k=; b=cB/wlL4fhFlq8FoAhD402szsJu 0lBVFpxKTvf9p+6ah7yJ6AJ0GemSzD3zXjjGlin3L60bXRehuVGHmJL95qkDRLkxpaq03BQoMSmMl Zb806Vg4RSek4kFbOU0qFZ0RehJpuZ6B+46/6bj2kCLfEtTzJNOYn8y7+YfOGDAOoSms=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m5qud-0004F8-Th for control@debbugs.gnu.org; Tue, 20 Jul 2021 16:40:01 +0200 Date: Tue, 20 Jul 2021 16:39:59 +0200 Message-Id: <87fsw9cam8.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #49661 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.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 @@CONTACT_ADDRESS@@ for details. Content preview: close 49661 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control 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 (---) close 49661 28.1 quit From unknown Sat Jun 21 12:27:30 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 18 Aug 2021 11:24:09 +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