From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id qG4RIy7ikmT+PQAASxT56A (envelope-from ) for ; Wed, 21 Jun 2023 13:42:38 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id kH8AIi7ikmR0fgEAG6o9tA (envelope-from ) for ; Wed, 21 Jun 2023 13:42:38 +0200 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 4F183EFE for ; Wed, 21 Jun 2023 13:42:38 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qBwDU-0008AQ-KM; Wed, 21 Jun 2023 07:41:40 -0400 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 1qBwDS-0008AB-Ib for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:41:38 -0400 Received: from mx1.riseup.net ([198.252.153.129]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qBwDQ-0007m2-0Y for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:41:37 -0400 Received: from fews02-sea.riseup.net (fews02-sea-pn.riseup.net [10.0.1.112]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx1.riseup.net (Postfix) with ESMTPS id 4QmM655kbczDrZx; Wed, 21 Jun 2023 11:41:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1687347693; bh=0i9cGHYr9HKKF6xu/el3W/Rsji4lKOIZDeoJahwlQhY=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=cUOzlTtoSVxo0QZh48kkZcOUQ77cwbVvTLAYfSFAmWwy+LVEk7Y1OulFscJIS/Oja 2MGy718cwU+NDLYDV1VohhmrYjsU4sDnHidHFvR2DE0ddkYLSQ+ZPPahR661jzRcoS AMY0ES7GhPsiiaNdkSPkQwhCC6dVmHFLUTA0ZXvI= X-Riseup-User-ID: 13C39AD97780DD0CBCCE9391CF14805550C196776B10844A8E0D1008F7C4AA31 Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews02-sea.riseup.net (Postfix) with ESMTPSA id 4QmM654HrPzFpcg; Wed, 21 Jun 2023 11:41:33 +0000 (UTC) MIME-Version: 1.0 Date: Wed, 21 Jun 2023 11:41:33 +0000 From: libreville To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: [PATCH] Re: Offline documentation (Org Manual info file) of org hooks is misleading In-Reply-To: <87edm5f3oo.fsf@localhost> References: <87mt0tf6w4.fsf@localhost> <29f9dd6385bca33ae1f3ab4beb9b8c2d@riseup.net> <87edm5f3oo.fsf@localhost> Message-ID: Content-Type: multipart/mixed; boundary="=_cb75e13f6df7694746345e693eedf390" Received-SPF: pass client-ip=198.252.153.129; envelope-from=libreville@riseup.net; helo=mx1.riseup.net 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, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=1; s=key1; d=yhetil.org; t=1687347758; a=rsa-sha256; cv=none; b=KaD1GMv+lbwB5fj7OpmfzUzFbjxwUZgjerSV4fd+phInlZm4cv+sm0xc0yNC5pCJCF2oEY xQOszn/9mZmpHAswB9s6rBNro5sELDse/FnbcipFPfgwG3qrQQ3j0iCw1joYAahIMbcqqo nsZ2wwjbpvAYHQDkpFZhpM1aYu+JIkH4KCA4zgK+fUAth6xr0yRNuXba5UCL9emfx4Ns/6 u4yL7viMRrMQU3IWs9vW99zhRbzEnDXiTy2fY3+C81Vq2s7u5QNG1EpCmRZSLs1UexdwS2 /tzMIOg5w0Bz+b3uVwcnk3VH+mlHm/07y2uTigIDgmNnRC74MxuTDO1pSn40Kw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=cUOzlTto; dmarc=pass (policy=none) header.from=riseup.net; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1687347758; 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=cBz/zHVCMj+msNzH1ne7Wvfse5uVtNTaceaTdseYbeo=; b=KKvFZrqiwOJD9oFtNBgx4EmZDwz7ak4qXwfb7lXBnF535qvwsFAfZZ/pLS49UNywh3v1Ud E0SAiDOHi0w/FUdqoyTwfvVJ9Og1+V4+QrZK2w9cf2tN2yR/2c6Cmly5ktEqTDH3/2XZvi uFQg0tvMMJM3Yz5CRPCmTZAKBBa/w0i+n/f5bjTdphWw6UyuU9VMxs2mjxHFpeJrz3iDJ8 3rRWSDz+hHy42qiTPJomxVcRRzNNwZ8+HIQzBfm9IBY5cH0glLTB2iExDSBr6UWOWspAIU UQ964IrOZ6AB1NjAgsA498pXC2e08KBsy+Go45PsBa6tX9vibTqqg0DkrI69og== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=cUOzlTto; dmarc=pass (policy=none) header.from=riseup.net; 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-Scanner: scn0.migadu.com X-Migadu-Spam-Score: -6.99 X-Spam-Score: -6.99 X-Migadu-Queue-Id: 4F183EFE X-TUID: OYMCGiGxeorQ --=_cb75e13f6df7694746345e693eedf390 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII Thanks a lot for the pointers. Is this better? On 2023-06-21 11:35, Ihor Radchenko wrote: > libreville writes: > >> Here's my attempt. > > Thanks! > >> It's my first time doing this, so kindly let me know if there's >> something I can do better! > > Generally, we have instructions in https://orgmode.org/worg/org-contribute.html#first-patch > >> For example, should I have replaced the subject line of this email with >> the subject in the formatted .patch? > > Not necessarily. Although, adding [PATCH] to the subject would be > helpful as an indication. > >> From c1fda8d0162583db709c90f01df2b8678ddc7957 Mon Sep 17 00:00:00 2001 >> From: libreville >> Date: Wed, 21 Jun 2023 13:04:19 +0200 >> Subject: [PATCH] Delete reference to non-existent examples of hook usage. > > 1. I'd add "org-manual: ..." to indicate which part of Org is modified. > 2. There is no need to end the subject (first) line with "." > 3. You need to add TINYCHANGE cookie, unless you have FSF copyright > assignment. > 4. Changelog entry would be good, although this is a simple patch and we > can skip it here. > > Hope it is going to be a good practice :) --=_cb75e13f6df7694746345e693eedf390 Content-Transfer-Encoding: base64 Content-Type: text/x-diff; name=0001-org-manual.org-Delete-ref-to-non-existent-examples-o.patch Content-Disposition: attachment; filename=0001-org-manual.org-Delete-ref-to-non-existent-examples-o.patch; size=1187 RnJvbSA2ZDBhZGU2YWY0ZWM0YWIyZmQ4YmU1NzhkZDg4NTFmYWU5ZTkxMjUzIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBsaWJyZXZpbGxlIDxsaWJyZXZpbGxlQHJpc2V1cC5uZXQ+CkRh dGU6IFdlZCwgMjEgSnVuIDIwMjMgMTM6MDQ6MTkgKzAyMDAKU3ViamVjdDogW1BBVENIXSBvcmct bWFudWFsLm9yZzogRGVsZXRlIHJlZiB0byBub24tZXhpc3RlbnQgZXhhbXBsZXMgb2YgaG9vawog dXNhZ2UKCiBEYXRlOiAgICAgIFdlZCBKdW4gMjEgMTM6MDQ6MTkgMjAyMyArMDIwMAogQ2hhbmdl cyB0byBiZSBjb21taXR0ZWQ6Cgltb2RpZmllZDogICBkb2Mvb3JnLW1hbnVhbC5vcmcKCiogb3Jn LW1hbnVhbC5vcmc6ICBEZWxldGUgcmVmIHRvIG5vbi1leGlzdGVudCBleGFtcGxlcyBvZiBob29r IHVzYWdlIGluCkEuMSBIb29rcwoKVElOWUNIQU5HRQotLS0KIGRvYy9vcmctbWFudWFsLm9yZyB8 IDcgKysrLS0tLQogMSBmaWxlIGNoYW5nZWQsIDMgaW5zZXJ0aW9ucygrKSwgNCBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2Mvb3JnLW1hbnVhbC5vcmcgYi9kb2Mvb3JnLW1hbnVhbC5vcmcK aW5kZXggNGZlYjE1ZTcxLi4yMTU4MmZlOGUgMTAwNjQ0Ci0tLSBhL2RvYy9vcmctbWFudWFsLm9y ZworKysgYi9kb2Mvb3JnLW1hbnVhbC5vcmcKQEAgLTIxMTI4LDEwICsyMTEyOCw5IEBAIG9mIE9y Zy4KIDpFTkQ6CiAjK2NpbmRleDogaG9va3MKIAotT3JnIGhhcyBhIGxhcmdlIG51bWJlciBvZiBo b29rIHZhcmlhYmxlcyBmb3IgYWRkaW5nIGZ1bmN0aW9uYWxpdHkuCi1UaGlzIGFwcGVuZGl4IGls bHVzdHJhdGVzIHVzaW5nIGEgZmV3LiAgQSBjb21wbGV0ZSBsaXN0IG9mIGhvb2tzIHdpdGgKLWRv Y3VtZW50YXRpb24gaXMgbWFpbnRhaW5lZCBieSB0aGUgV29yZyBwcm9qZWN0IGF0Ci1odHRwczov L29yZ21vZGUub3JnL3dvcmcvZG9jLmh0bWwjaG9va3MuCitPcmcgaGFzIGEgbGFyZ2UgbnVtYmVy IG9mIGhvb2sgdmFyaWFibGVzIGZvciBhZGRpbmcgZnVuY3Rpb25hbGl0eS4gIEEKK2NvbXBsZXRl IGxpc3Qgb2YgaG9va3Mgd2l0aCBkb2N1bWVudGF0aW9uIGlzIG1haW50YWluZWQgYnkgdGhlIFdv cmcKK3Byb2plY3QgYXQgaHR0cHM6Ly9vcmdtb2RlLm9yZy93b3JnL2RvYy5odG1sI2hvb2tzLgog CiAqKiBBZGQtb24gUGFja2FnZXMKIDpQUk9QRVJUSUVTOgotLSAKMi4zMC4yCgo= --=_cb75e13f6df7694746345e693eedf390--