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 AEMBOZjckmQHkgAASxT56A (envelope-from ) for ; Wed, 21 Jun 2023 13:18:49 +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 QKT8N5jckmTJ9QAAG6o9tA (envelope-from ) for ; Wed, 21 Jun 2023 13:18:48 +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 5560B2F16D for ; Wed, 21 Jun 2023 13:18:48 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qBvpz-0005y5-As; Wed, 21 Jun 2023 07:17:23 -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 1qBvpx-0005xp-BC for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:17:21 -0400 Received: from mx0.riseup.net ([198.252.153.6]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qBvpv-0003q9-Fw for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:17:21 -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 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "mail.riseup.net", Issuer "R3" (not verified)) by mx0.riseup.net (Postfix) with ESMTPS id 4QmLZ537Dwz9s5s; Wed, 21 Jun 2023 11:17:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1687346237; bh=YSEQVXm8vqEGCYZ5R7gvpVRfMAzhCmHE8gToD6LOeJE=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=rYNpTJbbeD3tKq3BDkzwn0KaWcXreUm7x3pM04V+OMz9mBdyP3UzJ4k/00gi3pu+2 vYc/MX4aRbsnWTd5FdAVjs/0nO3oeiBJxz+Dk12vLdw0zwDhgtKFSPWGUdZQSnhoEf xxztTHjY2wnXWUu73EOumTV498IE7qtM+ameHyZU= X-Riseup-User-ID: DF6725231F2D3AB1B613D48B97DC416F343ACE0FC1E0ED42115FC06FCB5F5920 Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews02-sea.riseup.net (Postfix) with ESMTPSA id 4QmLYt1YqHzFqjW; Wed, 21 Jun 2023 11:17:06 +0000 (UTC) MIME-Version: 1.0 Date: Wed, 21 Jun 2023 11:17:05 +0000 From: libreville To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Offline documentation (Org Manual info file) of org hooks is misleading In-Reply-To: <87mt0tf6w4.fsf@localhost> References: <87mt0tf6w4.fsf@localhost> Message-ID: <29f9dd6385bca33ae1f3ab4beb9b8c2d@riseup.net> Content-Type: multipart/mixed; boundary="=_90038c105a4c5151b6700090e5c27fab" Received-SPF: pass client-ip=198.252.153.6; envelope-from=libreville@riseup.net; helo=mx0.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, 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-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1687346328; 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=yJAeQNjb9v4V+7qFo7HtNcnJF4upohhYx5KQXpknsG8=; b=O+tZ9O26LVfBDaRsV3/RAwGa2kqa5MS4+nn9vwanRhoOLMpV0nmkbc5NxJjc9pQbU0v7aU MrwbAnWUOTHYM9shC4mcG6Ww7KS3rkLHXGhP684rPcf+5n4lV2KrcMBfjqGzkuuMjJ005Y RGeO6Nl/SvbyaChz9XuI6ImR7jZh3DjEJxGyb5vdvPr35HeCKW2JrE/7CUajwsCNo6BoY8 yxhHm7/OGSWFwg+Fu8vUYFq6hRr3eBa8X1vDQndzeIJWaGoUblwUopL7lA03RVBnGFyO7n udbzZDHf0vuXC9pEfMADmgfkguZ8USUXJ4C7stsjlDxtRJSd4DD4ogEteClFaw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=rYNpTJbb; 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-Seal: i=1; s=key1; d=yhetil.org; t=1687346328; a=rsa-sha256; cv=none; b=Ly4e3yA3k3744D2eUj9Iaxz+/SvLLKhoTwdIxGr3lx2CjAxqhAQZz2f16jtTsb+/wIghqO g8GqnpXhC0GceTwSTL9MURoyHFSiqhu8d5t5afIh+unc86cY0qhnTA7deosSK9LZ6zEZX0 gsA//eTr6qzAr4SCYW8MqUnAOu+5kSM6fkCAOCkhimke078BvOJ6ZC3RkVeIPzZweXwl52 5zcmYFz2jsVjFp6PTmT4KRtops/b8yxToEp+C7wI1X+JAfh5vd8Z5VgiUaPCWq7wT4JI3E 6buEWxs6X/4CnNTub4yk4iQsqN6jE9Qgl3qG6zkL5a1TfL2pkuXvqXVOxnR3aQ== X-Migadu-Scanner: scn1.migadu.com X-Migadu-Spam-Score: -5.49 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=rYNpTJbb; 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-Queue-Id: 5560B2F16D X-Spam-Score: -5.49 X-TUID: pDUZuxqMzY+w --=_90038c105a4c5151b6700090e5c27fab Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII Here's my attempt. It's my first time doing this, so kindly let me know if there's something I can do better! For example, should I have replaced the subject line of this email with the subject in the formatted .patch? On 2023-06-21 10:26, Ihor Radchenko wrote: > libreville writes: > >> Chapter A.1 Hooks of the Org Manual reads, in its entirety: >> ... >> Contrary to what it says, I couldn't find any illustrations of hook >> usage in the appendix. The Variables index only refers to four, and >> they're in other places. >> >> Perhaps the line about illustrating could be deleted, to avoid sending >> people on a search for something that isn't there? > > Agree. > Would you be interested to submit a patch? --=_90038c105a4c5151b6700090e5c27fab Content-Transfer-Encoding: base64 Content-Type: text/x-diff; name=0001-Delete-reference-to-non-existent-examples-of-hook-us.patch Content-Disposition: attachment; filename=0001-Delete-reference-to-non-existent-examples-of-hook-us.patch; size=981 RnJvbSBjMWZkYThkMDE2MjU4M2RiNzA5YzkwZjAxZGYyYjg2NzhkZGM3OTU3IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBsaWJyZXZpbGxlIDxsaWJyZXZpbGxlQHJpc2V1cC5uZXQ+CkRh dGU6IFdlZCwgMjEgSnVuIDIwMjMgMTM6MDQ6MTkgKzAyMDAKU3ViamVjdDogW1BBVENIXSBEZWxl dGUgcmVmZXJlbmNlIHRvIG5vbi1leGlzdGVudCBleGFtcGxlcyBvZiBob29rIHVzYWdlLgoKLS0t CiBkb2Mvb3JnLW1hbnVhbC5vcmcgfCA3ICsrKy0tLS0KIDEgZmlsZSBjaGFuZ2VkLCAzIGluc2Vy dGlvbnMoKyksIDQgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL29yZy1tYW51YWwub3Jn IGIvZG9jL29yZy1tYW51YWwub3JnCmluZGV4IDRmZWIxNWU3MS4uMjE1ODJmZThlIDEwMDY0NAot LS0gYS9kb2Mvb3JnLW1hbnVhbC5vcmcKKysrIGIvZG9jL29yZy1tYW51YWwub3JnCkBAIC0yMTEy OCwxMCArMjExMjgsOSBAQCBvZiBPcmcuCiA6RU5EOgogIytjaW5kZXg6IGhvb2tzCiAKLU9yZyBo YXMgYSBsYXJnZSBudW1iZXIgb2YgaG9vayB2YXJpYWJsZXMgZm9yIGFkZGluZyBmdW5jdGlvbmFs aXR5LgotVGhpcyBhcHBlbmRpeCBpbGx1c3RyYXRlcyB1c2luZyBhIGZldy4gIEEgY29tcGxldGUg bGlzdCBvZiBob29rcyB3aXRoCi1kb2N1bWVudGF0aW9uIGlzIG1haW50YWluZWQgYnkgdGhlIFdv cmcgcHJvamVjdCBhdAotaHR0cHM6Ly9vcmdtb2RlLm9yZy93b3JnL2RvYy5odG1sI2hvb2tzLgor T3JnIGhhcyBhIGxhcmdlIG51bWJlciBvZiBob29rIHZhcmlhYmxlcyBmb3IgYWRkaW5nIGZ1bmN0 aW9uYWxpdHkuICBBCitjb21wbGV0ZSBsaXN0IG9mIGhvb2tzIHdpdGggZG9jdW1lbnRhdGlvbiBp cyBtYWludGFpbmVkIGJ5IHRoZSBXb3JnCitwcm9qZWN0IGF0IGh0dHBzOi8vb3JnbW9kZS5vcmcv d29yZy9kb2MuaHRtbCNob29rcy4KIAogKiogQWRkLW9uIFBhY2thZ2VzCiA6UFJPUEVSVElFUzoK LS0gCjIuMzAuMgoK --=_90038c105a4c5151b6700090e5c27fab--