From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id sHiCJ2XwnmbrKQAAqHPOHw:P1 (envelope-from ) for ; Mon, 22 Jul 2024 23:51:01 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id sHiCJ2XwnmbrKQAAqHPOHw (envelope-from ) for ; Tue, 23 Jul 2024 01:51:01 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=PJBlTqz2; 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"; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1721692261; 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=XUChjSaS3CxH0NVK2axf5RwUUpztxe6HzMtpKT6VJ1g=; b=RewyKEtNfRcKbSz+t40lOv9/hXEyRHdJ7Z7+HD6oh2kwiwvKi86TT+ZMDPEyw9/BndVtj2 CE7r3YutpYFB9EYSQz2ROidffXTCWQxthAYbQmLecSQY5FoYs6tZrkD0CH0Y4nEcqcrIsY yElnEtfWgGexPtgmY3c5musTeVM5awLE6tz6yrI98MJYIonYs5iZDEPeSrMojS6PaeqTnW Q9TePgjRe9JNcGupatErDfHJXiiZucivTk1b0D31Vxbwt+zuT7OVPfxp2SRNO7MjHTrbiE FYa71woBlLuKCxrVzGIDrF3EV2Sp79ZAB9krguUXxQQyKvXJgWTpl+Lb1Mr4sg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=PJBlTqz2; 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"; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=key1; d=yhetil.org; t=1721692261; a=rsa-sha256; cv=none; b=lwpMSTCZDokgb7Yhs9eUKvEjKmCvF3k4S7CEUiaR51tgPWmj2jCjU+XuPxVZfxGXKepNOY z6IRBACxDWaQ2JtkTKPRuY5VHM/lnruO98Z40BPF/OA3xtEDUgxKsONKscAVkfomtfswPG 19SfIwATq3nxe8JocI5DS4hs0PG2zkOWrnDxyLCW+LTxb14b9teG4fubha/KSfkvwxTnBC qDYQ+R2qpAdO3gv/8KjKFi+IJdFtL5Al7CT2dDgKox9cfLr+1laqwJ8Vvis3jsjfDtwhUr twzCv3HBT5ZXHSSiNQy513u7PirIutqzwofebj+4aznLCsVPcfgN5sZlEOmIEg== 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 48624EDAE for ; Tue, 23 Jul 2024 01:51:00 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sW2nL-0000d7-0r; Mon, 22 Jul 2024 19:50:19 -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 1sW2nJ-0000co-0p for emacs-orgmode@gnu.org; Mon, 22 Jul 2024 19:50:17 -0400 Received: from mail-lj1-x22e.google.com ([2a00:1450:4864:20::22e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sW2nH-0002kP-2r for emacs-orgmode@gnu.org; Mon, 22 Jul 2024 19:50:16 -0400 Received: by mail-lj1-x22e.google.com with SMTP id 38308e7fff4ca-2eeb1ba0468so66009621fa.0 for ; Mon, 22 Jul 2024 16:50:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1721692211; x=1722297011; darn=gnu.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=XUChjSaS3CxH0NVK2axf5RwUUpztxe6HzMtpKT6VJ1g=; b=PJBlTqz20mWHHcV6hTB4U+Zu44wRrsJyYNQH68RXrT24ViD7ulTcaeukERrZEuTy+K QYqQHq2KpzSVxAurNVq4zdZDcaUOe7uSQBwPrukF4LOhFU+pbBzQpLxr0muNOagooaRd ND2yglHdoa8/zmUC8LJIvWDNboZMkMZXvpgImE0lghp1O+iLvUIQOpSrJSGINHwejuHQ 90B+SSOawbBgnopckpO0y4EAF7MJCOBDBrycPZ8Wvcn+vrVyyl9RtA5cUxdcctgbKmxu ZcrfeYJktErj9mAYJcvOtIp9/Osa0ayrhaHPuw9b9dZn5eHSYFPT+KYx5hDR4U1u1KK9 p48g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1721692211; x=1722297011; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=XUChjSaS3CxH0NVK2axf5RwUUpztxe6HzMtpKT6VJ1g=; b=HIYkS5epZ+FDsaWkeRNj1FQUrWf/nhhN1maGu28gWsdiokqnhVxHR/gsv8ba0gdSSn 4sbwvFcdFwY6ZCOtBlmkYhLV3X/eVOsotNveSB1SyAEMd63figBFlHgKzw3RD+vwb5F7 +G1AdfeqAvRH2S9h84MzXB4NyxDEtg+RtoAiUmI2etCrGiQbPvIS9Ffe2ECkZjxbyPkS 2rZ7dlU4ivIBHhtSjQ8e37+J1Q8uk9X9kwVLn4bG2RGCgwQWJpHda/Kb+puY1pyKsOE2 NNsEwOAiNpkkDdVqdWjwilV0vPa/h2JBmlr3avbbptnXNNCM/25JNqoy30w2gFgsjxS7 lbWQ== X-Gm-Message-State: AOJu0YxpZ+PilUB2WpZW6E26xrJ5Y6O6FFdr8fXXdffdncFxRA9fxg7o jJiqyoN429mijeftfJVFeKtajMTJWb6Oje80gI4nprypOMw4XSwzkEQqDxE6skd9yzGEiYYxl4r fLgfixEnjzQY59I9SpZRsMk/NxKM= X-Google-Smtp-Source: AGHT+IHjz+mWWNMjK2DF1FZz4eG65AZ3n3+06bWQ+n7BwtkGz/UNr1fGOuIQNMDYV777sVH6KVOJO9k8m/eOpwv8B0M= X-Received: by 2002:a05:6512:31c9:b0:52e:9ebe:7325 with SMTP id 2adb3069b0e04-52efb74e24amr6163975e87.31.1721692210948; Mon, 22 Jul 2024 16:50:10 -0700 (PDT) MIME-Version: 1.0 References: <87o76pmth5.fsf@localhost> In-Reply-To: <87o76pmth5.fsf@localhost> From: Peter Mao Date: Mon, 22 Jul 2024 16:50:00 -0700 Message-ID: Subject: Re: Documentation request To: Ihor Radchenko Cc: org-mode-email Content-Type: multipart/alternative; boundary="000000000000a573d0061ddeb49c" Received-SPF: pass client-ip=2a00:1450:4864:20::22e; envelope-from=peter.mao@gmail.com; helo=mail-lj1-x22e.google.com 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, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=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-Country: US X-Migadu-Flow: FLOW_IN X-Spam-Score: -9.75 X-Migadu-Queue-Id: 48624EDAE X-Migadu-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -9.75 X-TUID: IBjOGFjtHvy+ --000000000000a573d0061ddeb49c Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable ah, I failed to mention my version number -- 9.6.15 (which ships with Emacs 29.3). If it's complete in the latest version, then that's great -- I can wait for the future to come to me. Peter On Mon, Jul 22, 2024 at 6:43=E2=80=AFAM Ihor Radchenko wrote: > Peter Mao writes: > > > The docstrings for org-metadown and org-metaup (and maybe other > > context-dependent commands) should reference the corresponding hooks, > > org-metadown-hook and org-metaup-hook. > > But they do? > > org-metadown is an interactive and natively compiled function defined > in org-edit-special.el. > > Signature > (org-metadown &optional ARG) > > Documentation > ... > > This function runs the functions in org-metadown-hook one by > one as a first step, and exits immediately if a function from the > hook returns non-nil. In the absence of a specific context, the > function runs org-metadown-final-hook using the same logic. > > -- > Ihor Radchenko // yantar92, > Org mode contributor, > Learn more about Org mode at . > Support Org development at , > or support my work at > --000000000000a573d0061ddeb49c Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
ah, I failed to mention my version number -- 9.6.15 (= which ships with Emacs 29.3).

If it's complete= in the latest version, then that's great -- I can wait for the future = to come to me.

Peter

On Mon, Jul 22, 2024= at 6:43=E2=80=AFAM Ihor Radchenko <yantar92@posteo.net> wrote:
Peter Mao <peter.mao@gmail.com> writes:

> The docstrings for org-metadown and org-metaup (and maybe other
> context-dependent commands) should reference the corresponding hooks,<= br> > org-metadown-hook and org-metaup-hook.

But they do?

=C2=A0 =C2=A0 org-metadown is an interactive and natively compiled function= defined
=C2=A0 =C2=A0 in org-edit-special.el.

=C2=A0 =C2=A0 Signature
=C2=A0 =C2=A0 (org-metadown &optional ARG)

=C2=A0 =C2=A0 Documentation
=C2=A0 =C2=A0 ...

=C2=A0 =C2=A0 This function runs the functions in org-metadown-hook one by<= br> =C2=A0 =C2=A0 one as a first step, and exits immediately if a function from= the
=C2=A0 =C2=A0 hook returns non-nil.=C2=A0 In the absence of a specific cont= ext, the
=C2=A0 =C2=A0 function runs org-metadown-final-hook using the same logic.
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,=
or support my work at <https://liberapay.com/yantar92>
--000000000000a573d0061ddeb49c--