From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 6PhVLYbfkmSO3QAASxT56A (envelope-from ) for ; Wed, 21 Jun 2023 13:31:18 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id sJIwLYbfkmQyXwEA9RJhRA (envelope-from ) for ; Wed, 21 Jun 2023 13:31:18 +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 704403A10E for ; Wed, 21 Jun 2023 13:31:18 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qBw3J-0004YQ-2j; Wed, 21 Jun 2023 07:31:09 -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 1qBw3D-0004Y8-LF for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:31:05 -0400 Received: from mout02.posteo.de ([185.67.36.66]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qBw3A-000364-9B for emacs-orgmode@gnu.org; Wed, 21 Jun 2023 07:31:02 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 62929240104 for ; Wed, 21 Jun 2023 13:30:57 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1687347057; bh=PZwo3BxLPCupY+EywIshLeB+Ayv6+KVwHknNC4ehiTQ=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From; b=C+QTDrb0gk8jrFr90urd+dOeKVl2wn0/H3nO+IOGtmz0hZyNWi7/x4u3aXKyXFMZR mvcbchEnpGUuBhcnohkkLNEnMbv3zhqHSL25cuxI8Gy3TOM7v8OUmHaDDRVs5qa2XU YR5MRrqx1xUAgeGX/Jkfxtib3F7BsEadhELd9uxaCPeRWHs1rY/9QSi+z22UEyUS8h 2KwomyKMS1xE9FaKiFdTJy4/LigB9tizm6LO9TXDkw6j5OQH+UGAfnwWyiBu5scJuB UMfRJCR8z9yi3KwqEZzNaM/L7+ADp62Mj7bK4v/cH1U9g82WEHAdn6oIu/+5nnIEIu hNyDh0MPYNpgQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4QmLsr4pgJz9rxL; Wed, 21 Jun 2023 13:30:56 +0200 (CEST) From: Ihor Radchenko To: libreville Cc: emacs-orgmode@gnu.org Subject: Re: Offline documentation (Org Manual info file) of org hooks is misleading In-Reply-To: <29f9dd6385bca33ae1f3ab4beb9b8c2d@riseup.net> References: <87mt0tf6w4.fsf@localhost> <29f9dd6385bca33ae1f3ab4beb9b8c2d@riseup.net> Date: Wed, 21 Jun 2023 11:35:51 +0000 Message-ID: <87edm5f3oo.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@posteo.net; helo=mout02.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_MED=-2.3, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=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=1687347078; a=rsa-sha256; cv=none; b=dz08UijeQGplDVxEwDs9KtXQPKqoL9NdsXijFsYul7Q9x83hU/RHOYhEhwNobUq2naCZn0 RgeGw+52B+5dyCKJx1+OdaNOhXkvc0onotPq0Kjk7wfgaoVQZrUpZIfC09IQNtMryxTgIM eU5l7myIj5AiCzGQnGjJXWCQ8fYbknX0kUgSQEmVa+yVZ9FXVhYVU66CZGPM/Ytm4qM7Sz W+vVxXB6VOSUugbmSkM+rfDXAlf/Gil8TtXTlXrdmACg25K9GA1VwpszXfppS5mNfy2oCc oypWcKysRCLcDxkaJLQo2W90dhmtSQz6PgKbGLmFaWp43z4ovrrxBAuC8BVVow== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=C+QTDrb0; dmarc=pass (policy=none) header.from=posteo.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=1687347078; 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=n3rPgOaFdLp9go9Dcz/eY8yRUgLFDgS5heoFSyVZS8w=; b=grXcrkPXUUtRQhiiFn1EJ3Z+vgkcMONQGNVaLMUMXkjwzUTtWOwY0StINzHusb+Tf0vLaj wLZ7H2kZocwgUPzraY8yab6RehYwBkBp966cpzO/12XwBGFlYamcveG6aVD1XtpQAi4Tsj UxTOPLarPHUzEPKwcKL8VJ31iCllV3XGCq2JEHyj7vvn0nG0JxsHxut0348ar59PbBWMyt pPRHRlpV/lohQda+nAzhBO8MMInr8j7I7LvQRwbGxvvkrXBSLBFNPiogKV5flSpPvNww9X fkber3nfB7RpTcWA95it1jml5lEncv7CIihwSFiFHxS6E/mS/HksizG7inFPqA== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=C+QTDrb0; dmarc=pass (policy=none) header.from=posteo.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: -7.71 X-Spam-Score: -7.71 X-Migadu-Queue-Id: 704403A10E X-TUID: pfTQvhDx73ny 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 :) -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at