From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id KBPNAbVNhmOGUwAAbAwnHQ (envelope-from ) for ; Tue, 29 Nov 2022 19:21:41 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id ZmLrALVNhmOoJgAAG6o9tA (envelope-from ) for ; Tue, 29 Nov 2022 19:21:41 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 3348D2E440 for ; Tue, 29 Nov 2022 19:21:40 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p05Dk-0007H5-LR; Tue, 29 Nov 2022 13:20:40 -0500 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 1p05Di-0007GR-It for emacs-orgmode@gnu.org; Tue, 29 Nov 2022 13:20:38 -0500 Received: from mail-4319.protonmail.ch ([185.70.43.19]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p05De-0007ZN-Ez for emacs-orgmode@gnu.org; Tue, 29 Nov 2022 13:20:38 -0500 Date: Tue, 29 Nov 2022 18:20:24 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1669746030; x=1670005230; bh=XTvqdzvj5cOp7JJiUoA6sM1UuyiW00PYftgIUZ00RqQ=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=EaEIZwayoNz3yxjWtgJXMHEXyrdG0ibpPMsxK1hyBhRrwDPocIwo6CYBwc3l0oJ+C LGRWzhuKEATxttrR2pXRSlLPaY5IpRn7nCrTkFLcBTsSbDhvZlqWyeDk541IuUfNj2 r5f2dIc8nfk1Edf+mASBpTWZR31Lqw/0OZ0n1BojThCtlKmSfSxRWUy45tl9xnYRg2 WQDVYPbWVfBt5R6yqRiWWuMedeQ2i9Jx3bxJ/W9tMQ56pO30afQdzkUen+QqoMLRjF lyZ6jdxJQT+m4GVMiGJdmz5Rs+OQeGVlIg2bXuWemVoBTUNu3V3WIj1wl3pUiOKwX/ 84YW08T3rayIQ== To: Ihor Radchenko From: yuvallangerontheroad Cc: "emacs-orgmode@gnu.org" Subject: Re: [PATCH] Explain how to end a buffer narrowing. Message-ID: <4042lqgWuT9V_iup06oM6vwmGJZUibs3dC_0WbJbw6vuoXQyz_JmsNUmMWOqmfDpLcg3gj8ke324mV-vnxajySAxFiqLSmaH1OrSTYpTJn4=@proton.me> In-Reply-To: <87tu2mlace.fsf@localhost> References: <87cz9b9kau.fsf@localhost> <877czj9jd2.fsf@localhost> <87tu2mlace.fsf@localhost> Feedback-ID: 60860146:user:proton MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="b1_Lm4MFJ3jzMLu8GhZqu11vUyF8Yjgbt8Lm2Xfd1bII" Received-SPF: pass client-ip=185.70.43.19; envelope-from=yuvallangerontheroad@proton.me; helo=mail-4319.protonmail.ch X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1669746100; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=XTvqdzvj5cOp7JJiUoA6sM1UuyiW00PYftgIUZ00RqQ=; b=qwfcGd2Syp4RbgUZoFWr/UAGd1y+g9ZOluwbRLGSgT7UdtKOeqbOELC3ObpR7QH7mKUrWW let1u8H0JoChvKmuSZiJnTLDp9IYv3qR36h/pYXE+pSIgWbyCD877pjMd0t0KulKwqxaDY 2BdkpZ1l0gE6P8LTIeQaRDabJc/hmqp1wZf1wq5KEFRFJHWzEYHnNrx/OdDnuK/18qur/L IFXfnUpSoPGzeajkbc+YEReSKlVsJE+nEeeVg6J/uohwqQMKykAiz1PYcMvYArG9+Yy9Fw 4enwU1d3j4NzELgKJT4Z/TtZdrNNTDRebrAN1Ol809qXeGogwIlXnLqpLkLO4w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1669746100; a=rsa-sha256; cv=none; b=OY0rnvKRaVI8Inro4imcLM8Leg/qdMI15PFDIaZFZ9ilc7AdfcOXDOTriqVOv0xT0oJUde O3uxPUTWZRaj9koQWP1Z5Iw3fdaKi3ZmJDf7yDcLONvYP2ZTC+VZfxT2MH7o+iT8ReKv4E oF60aLSYy+6+/qnBaEFqp+4FGzkz6hPphthAh12bHI9DBIlH71Xf9N1/phx+iSI46Zlndb EKrJhpQ3jjGzOYXjGwQT9CRmHb5+gc17d4BS38nltZXsZLWnVZ0+v07SQWIqQkykrTHM2V 2XwPY5PIMyWlV1G76M6ubowoSXA7cuHUJ1rQdJpIIKl1OpgZMjdGdAZ7W4viAA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=proton.me header.s=protonmail header.b=EaEIZway; dmarc=pass (policy=quarantine) header.from=proton.me; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.96 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=proton.me header.s=protonmail header.b=EaEIZway; dmarc=pass (policy=quarantine) header.from=proton.me; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 3348D2E440 X-Spam-Score: -2.96 X-Migadu-Scanner: scn0.migadu.com X-TUID: jP9D+ILWI1g+ This is a multi-part message in MIME format. --b1_Lm4MFJ3jzMLu8GhZqu11vUyF8Yjgbt8Lm2Xfd1bII Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Saturday, November 26th, 2022 at 04:26, Ihor Radchenko wrote: > yuvallangerontheroad yuvallangerontheroad@proton.me writes: >=20 > > > Extra [...] are redundant. > > > Please test the patch before submitting. > >=20 > > Sorry. Removed redundant brackets. >=20 >=20 > Thanks. :) > It is also a good idea to add quotes around the command key. See the > example in 25.3 Substituting Key Bindings in Documentation > (I am honestly not sure how important quoting is, but let's better > follow the Elisp manual). Hopefully done. > Also, please make the commit message more concrete. >=20 > Maybe something like >=20 > org: Mention how to widen in docstrings of the commands that do narrowing Hopefully done. > Finally, please follow the commit message format as described in > https://orgmode.org/worg/org-contribute.html#commit-messages > In particular, add the changelog entries and TINYCHANGE cookie (I assume > that you don't have FSF copyright assignment). Hopefully done. Please review. --b1_Lm4MFJ3jzMLu8GhZqu11vUyF8Yjgbt8Lm2Xfd1bII Content-Type: text/x-patch; name=0001-lisp-org.el-Mention-how-to-widen-in-docstrings-of-co.patch Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename=0001-lisp-org.el-Mention-how-to-widen-in-docstrings-of-co.patch RnJvbSBmNTNiMTQxYmQyMDU3ODk4ZjI2MDZlODg0Y2YxYTA5NDg3NjY5NmMyIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBZdXZhbCBMYW5nZXIgPHl1dmFsbGFuZ2Vyb250aGVyb2FkQHBy b3Rvbi5tZT4KRGF0ZTogRnJpLCAyNSBOb3YgMjAyMiAxNjo0MDo1MCArMDIwMApTdWJqZWN0OiBb UEFUQ0hdIGxpc3Avb3JnLmVsOiBNZW50aW9uIGhvdyB0byB3aWRlbiBpbiBkb2NzdHJpbmdzIG9m IGNvbW1hbmRzCiB0aGF0IGRvIG5hcnJvd2luZwoKbGlzcC9vcmcuZWw6IChvcmctbmFycm93LXRv LXN1YnRyZWUsIG9yZy10b2dnbGUtbmFycm93LXRvLXN1YnRyZWUsCm9yZy1uYXJyb3ctdG8tYmxv Y2ssIG9yZy1uYXJyb3ctdG8tZWxlbWVudCkgTWVudGlvbiBob3cgdG8gd2lkZW4gaW4KZG9jc3Ry aW5ncyBvZiBjb21tYW5kcyB0aGF0IGRvIG5hcnJvd2luZy4KClRJTllDSEFOR0UKLS0tCiBsaXNw L29yZy5lbCB8IDEyICsrKysrKysrLS0tLQogMSBmaWxlIGNoYW5nZWQsIDggaW5zZXJ0aW9ucygr KSwgNCBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9saXNwL29yZy5lbCBiL2xpc3Avb3JnLmVs CmluZGV4IDQ3MmU4N2I5Yi4uMmExMDI0Yzg5IDEwMDY0NAotLS0gYS9saXNwL29yZy5lbAorKysg Yi9saXNwL29yZy5lbApAQCAtNzIyMCw3ICs3MjIwLDggQEAgSWYgeWVzLCByZW1lbWJlciB0aGUg bWFya2VyIGFuZCB0aGUgZGlzdGFuY2UgdG8gQkVHLiIKICAgKHNldHEgb3JnLW1hcmtlcnMtdG8t bW92ZSBuaWwpKQogCiAoZGVmdW4gb3JnLW5hcnJvdy10by1zdWJ0cmVlICgmb3B0aW9uYWwgZWxl bWVudCkKLSAgIk5hcnJvdyBidWZmZXIgdG8gdGhlIGN1cnJlbnQgc3VidHJlZS4iCisgICJOYXJy b3cgYnVmZmVyIHRvIHRoZSBjdXJyZW50IHN1YnRyZWUuCitVc2UgdGhlIGNvbW1hbmQgYFxcW3dp ZGVuXScgdG8gc2VlIHRoZSB3aG9sZSBidWZmZXIgYWdhaW4uIgogICAoaW50ZXJhY3RpdmUpCiAg IChpZiAob3JnLWVsZW1lbnQtLWNhY2hlLWFjdGl2ZS1wKQogICAgICAgKGxldCogKChoZWFkaW5n IChvcmctZWxlbWVudC1saW5lYWdlCkBAIC03MjQyLDcgKzcyNDMsOCBAQCBJZiB5ZXMsIHJlbWVt YmVyIHRoZSBtYXJrZXIgYW5kIHRoZSBkaXN0YW5jZSB0byBCRUcuIgogCSAgICAgICAgIChwb2lu dCkpKSkpKSkpCiAKIChkZWZ1biBvcmctdG9nZ2xlLW5hcnJvdy10by1zdWJ0cmVlICgpCi0gICJO YXJyb3cgdG8gdGhlIHN1YnRyZWUgYXQgcG9pbnQgb3Igd2lkZW4gYSBuYXJyb3dlZCBidWZmZXIu IgorICAiTmFycm93IHRvIHRoZSBzdWJ0cmVlIGF0IHBvaW50IG9yIHdpZGVuIGEgbmFycm93ZWQg YnVmZmVyLgorVXNlIHRoZSBjb21tYW5kIGBcXFt3aWRlbl0nIHRvIHNlZSB0aGUgd2hvbGUgYnVm ZmVyIGFnYWluLiIKICAgKGludGVyYWN0aXZlKQogICAoaWYgKGJ1ZmZlci1uYXJyb3dlZC1wKQog ICAgICAgKHByb2duICh3aWRlbikgKG1lc3NhZ2UgIkJ1ZmZlciB3aWRlbiIpKQpAQCAtNzI1MCw3 ICs3MjUyLDggQEAgSWYgeWVzLCByZW1lbWJlciB0aGUgbWFya2VyIGFuZCB0aGUgZGlzdGFuY2Ug dG8gQkVHLiIKICAgICAobWVzc2FnZSAiQnVmZmVyIG5hcnJvd2VkIHRvIGN1cnJlbnQgc3VidHJl ZSIpKSkKIAogKGRlZnVuIG9yZy1uYXJyb3ctdG8tYmxvY2sgKCkKLSAgIk5hcnJvdyBidWZmZXIg dG8gdGhlIGN1cnJlbnQgYmxvY2suIgorICAiTmFycm93IGJ1ZmZlciB0byB0aGUgY3VycmVudCBi bG9jay4KK1VzZSB0aGUgY29tbWFuZCBgXFxbd2lkZW5dJyB0byBzZWUgdGhlIHdob2xlIGJ1ZmZl ciBhZ2Fpbi4iCiAgIChpbnRlcmFjdGl2ZSkKICAgKGxldCogKChjYXNlLWZvbGQtc2VhcmNoIHQp CiAJIChibG9ja3AgKG9yZy1iZXR3ZWVuLXJlZ2V4cHMtcCAiXlsgXHRdKiNcXCtiZWdpbl8uKiIK QEAgLTIxMTYyLDcgKzIxMTY1LDggQEAgb25lcyBhbHJlYWR5IG1hcmtlZC4iCiAJKGdvdG8tY2hh ciAob3JnLWVsZW1lbnQtcHJvcGVydHkgOmJlZ2luIGVsZW1lbnQpKSkpKSkKIAogKGRlZnVuIG9y Zy1uYXJyb3ctdG8tZWxlbWVudCAoKQotICAiTmFycm93IGJ1ZmZlciB0byBjdXJyZW50IGVsZW1l bnQuIgorICAiTmFycm93IGJ1ZmZlciB0byBjdXJyZW50IGVsZW1lbnQuCitVc2UgdGhlIGNvbW1h bmQgYFxcW3dpZGVuXScgdG8gc2VlIHRoZSB3aG9sZSBidWZmZXIgYWdhaW4uIgogICAoaW50ZXJh Y3RpdmUpCiAgIChsZXQgKChlbGVtIChvcmctZWxlbWVudC1hdC1wb2ludCkpKQogICAgIChjb25k Ci0tIAoyLjMwLjIKCg== --b1_Lm4MFJ3jzMLu8GhZqu11vUyF8Yjgbt8Lm2Xfd1bII--