From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp12.migadu.com ([2001:41d0:403:4876::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms8.migadu.com with LMTPS
	id SOgkD0EodmXIQQEAauVa8A:P1
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sun, 10 Dec 2023 22:06:09 +0100
Received: from aspmx1.migadu.com ([2001:41d0:403:4876::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp12.migadu.com with LMTPS
	id SOgkD0EodmXIQQEAauVa8A
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sun, 10 Dec 2023 22:06:09 +0100
X-Envelope-To: larch@yhetil.org
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=outlook.com header.s=selector1 header.b=YnjsTLqD;
	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=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none);
	arc=pass ("microsoft.com:s=arcselector9901:i=1")
ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1702242369;
	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=vOc5R5WhDicSlPYLFygPQt7o381TVfcKxT83pNinQ2E=;
	b=aakCswktEKB3sVcnWRZG7u1MxBZiWLipX5APXrGmH7gHXgqzaRHiRFRQcjAxfQft/+iBWh
	dCRGjcbJTbySsBHlhVvQiylRevRsrHZT+z8Y9UoLXe6fYjAZ8WNG++sI5TmIreroxDKWfv
	ABWYs21FWoOJ9f7005hhePfaWgELxeVdWjt0Ob8wUTLbcLhpAP0WPsQhjglYv09P8faEMH
	pgf4ovmi4MCaIicupwXHLjNr9KWPhdlvNlqU1Zlpqlijkozb0XxAQLGJa9IbtezARGLBeC
	GtguGD5qB42PSQ4TSqBZ5WObj2YWUgkyD9GcINQJtbhq6BP8TnX3s1Q2UdYK2Q==
ARC-Authentication-Results: i=2;
	aspmx1.migadu.com;
	dkim=pass header.d=outlook.com header.s=selector1 header.b=YnjsTLqD;
	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=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none);
	arc=pass ("microsoft.com:s=arcselector9901:i=1")
ARC-Seal: i=2; s=key1; d=yhetil.org; t=1702242369; a=rsa-sha256; cv=pass;
	b=Lj92mNWtiRw5XYcg8vqRcSkKCbNK0AMwokND+EkndttqDq6KEIb7msn9ZNsIx8TcQHjuW7
	O3aZbluDmXmesJaOtuUk6Ho7U+WtOu9DQhp+s48f49BfmYjbufMHAgBTuE1qnpn+7uDpWE
	4ZhcxCXU+mKoQeftQ9p1nvCLUntdtFQS1UJBqWLnoHvVL68Sw/QR9ESMGSJNw9oC0s5Cdc
	Qr6LXXPlJ6Ao9g+bVFkGVG/TiEq6YuQgLIRaDvH1Y3zV8jKs0WS9lb7tXmE80LQtzwCe4M
	/Zkv5FrLfU4jmnZy0jnaEtNIyzUFiBu7Sr2Df2lWUsz1DEOzuyBiUsqZFggsYA==
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 E1F302079A
	for <larch@yhetil.org>; Sun, 10 Dec 2023 22:06:08 +0100 (CET)
Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces@gnu.org>)
	id 1rCQzG-0003r3-36; Sun, 10 Dec 2023 16:05:18 -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 <outlook_98C99531806B1C22@outlook.com>)
 id 1rCQzB-0003qo-J7
 for emacs-orgmode@gnu.org; Sun, 10 Dec 2023 16:05:14 -0500
Received: from mail-co1nam11olkn20801.outbound.protection.outlook.com
 ([2a01:111:f403:2c16::801]
 helo=NAM11-CO1-obe.outbound.protection.outlook.com)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <outlook_98C99531806B1C22@outlook.com>)
 id 1rCQz6-0005W1-SB
 for emacs-orgmode@gnu.org; Sun, 10 Dec 2023 16:05:10 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;
 b=SWtbg4kuVGUF625aN2bXY8QdU1DFD5VcjzK6RnXIwGokJhl7LqfeloXkVBswsFr1zQKMBREjkANkmj9R1IDSX+S13sUYbTFlsucthprP7kCnCx/pBrzYPLunkwY2pWY+XhFfomTgnyVlW0osTwCaQlWxvQJ8qtNsynsb6T8SL91344+SCCyfeggKXNHVJMtgZrMAnkY+k02AQv2hQcRaPFnHECDvt1cFkyGRNH92zBavMvMo8om9caX+DO82+5rivf+vhlvvfL0qfAy1H0tJ6sWNPL4BwZzSX9SY+xjaW6Vjc/Mtd1nifWSqSwHcFlCTrpAXl1AbpZBv8u+Aosbbfw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector9901;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;
 bh=vOc5R5WhDicSlPYLFygPQt7o381TVfcKxT83pNinQ2E=;
 b=LXq0BGzh0tlbznGj9VQyjH7M294hhmmz7F8GtJBzU1tRSmjgBJ8zIMXP4UlUAU+vQGLmr6gji//oSz2eBcgdbVB1sUFs26Xtm0/hTAIWWtgv23WrjOfsufcEJCd3vvIV6P77yypBKu+gSQXv5R36CVE7S989FufMDlZozRt8GNIvuDuh4tWz/KmIWe0f/LVL6gdg79EJXqboDtIapwEfTMKrlRJwukHq+S4OfwBif58V1H/BPLFvoqU5ehXy61L3MfkrbRh4rzs9J8+JvS0dDAqJ9+wVQ9j5umUsjWSWc86dEu6SvWzD6YSUdQ/8BlLeI5l2qVA2s6e5SDQYe4DrNw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none;
 dkim=none; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com;
 s=selector1;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=vOc5R5WhDicSlPYLFygPQt7o381TVfcKxT83pNinQ2E=;
 b=YnjsTLqDd5YXBnGsIXLZA1aAfBeoETNskdqCLqangrNAFqClxI23uNGvkSeUyrOKuuJJvrNie7CbQp+bxuxDSrWRVj4I1RS5lFoZfCB3rGNP1yDVMclmuGvDP1dxmND5KnTStQS81Og2Ln3ynVOjD3TFZP9MFnk/H1dxDnj3v9vvt1+VwOxCwnWFbQ5WYbY2rZjth/8TadfKI9uba+Vuc5T4rb31DKkkNJHGYhQ3U8jITBGqfVrzNBkwKq30TZYbuOv8ml0/xSwyib4Fd4ci69reHpn5MnWdwP+/pJaVcrg9ArsdGO0mv3iduVLRNCTyQKTOTxBpFgXObKjVXIlplQ==
Received: from LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM (2603:10b6:408:1be::16)
 by EA2P223MB0834.NAMP223.PROD.OUTLOOK.COM (2603:10b6:303:24e::22)
 with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.21; Sun, 10 Dec
 2023 21:00:04 +0000
Received: from LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM
 ([fe80::f266:6655:51c6:b5d2]) by LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM
 ([fe80::f266:6655:51c6:b5d2%5]) with mapi id 15.20.7091.020; Sun, 10 Dec 2023
 21:00:03 +0000
From: David Masterson <dsmasterson@gmail.com>
To: Ihor Radchenko <yantar92@posteo.net>
Cc: emacs-orgmode@gnu.org
Subject: Re: oeg-add-note and double backslash ?
References: <LV8P223MB092002D3AC4C4A0A61826981A287A@LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM>
 <87jzpuatr1.fsf@localhost>
 <LV8P223MB092079EF6618C88EAC01FEADA286A@LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM>
 <87il5cvjvw.fsf@localhost>
 <SA1P223MB0924FD6ED6F98B6B2829ED24A28BA@SA1P223MB0924.NAMP223.PROD.OUTLOOK.COM>
 <8734we47i4.fsf@localhost>
 <LV8P223MB0920DBA505A2D4080311CB4AA289A@LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM>
 <87jzpnskmy.fsf@localhost>
 <LV8P223MB09203FA5D66628FEA32E2E03A288A@LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM>
 <877clm9kbo.fsf@localhost>
Date: Sun, 10 Dec 2023 13:00:00 -0800
In-Reply-To: <877clm9kbo.fsf@localhost> (Ihor Radchenko's message of "Sun, 10
 Dec 2023 14:57:31 +0000")
Message-ID: <LV8P223MB0920EB98752321D066FB5BEBA288A@LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux)
Content-Type: text/plain
X-TMN: [yRp95NPbvwBhW1XEUYKhREYzDmW5GV1tl22JrvK9EvEIgMZN9TSKkpOgChBTql4L]
X-ClientProxiedBy: SJ0PR03CA0044.namprd03.prod.outlook.com
 (2603:10b6:a03:33e::19) To LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM
 (2603:10b6:408:1be::16)
X-Microsoft-Original-Message-ID: <877cllu627.fsf@penguin>
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 2
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: LV8P223MB0920:EE_|EA2P223MB0834:EE_
X-MS-Office365-Filtering-Correlation-Id: 0c9f2b1a-f94f-4ba1-7acf-08dbf9c2fadf
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: UpJJVK6QkfV6hQmMA1UR50D3VhFXqLerCpuy9CKjtxh4UalbeaF/F8Urrz5nj/ALC4VD24VeTGspH3kI5t1AtD/q6aYQINWHyf6bqDOClpHPa87z+ykwS0aKfPNUlYcqtJK+/Aip5B9IZe9tZoNiMMBc28P/h1CBY204xiBOnTeR0dnqnhuwrvqynoxD04KheGr9frgEcH22PiTLA3SUfIIemrC/YRWetZBjvuXFVkxemhnX+htNuPIdEKo1rnn5P1dxoq0eBbBr9Moeu3am/nToHTDA9NMBFERQPE1QhF6cg4PC8JBrwW/Urc9vqC5RlFfNxoS5B7Ys3SdqpgDQ09qLZ+LOubjjsVxHhwS7ykdtr0aAu+stVCloOgdC8lWFpCzc+6D3MsB0FBbMIDi/5dvHMbLaSfQTeyXfgZQDN5NI3pA7HOeHuBpkXtkcPwqNHAYmqBF2VQOp+vjl697s//K5ICoIAKrwRq8ueOtY7rFHhZ/foA/Eu+GOXogjfZ5aC4MQuEmx0WH0MU1Ehj1T69c26zshIS7VGxLxkELAFSV3U7H5DaZjbIm9gRjYD8PQ
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?z04dBN/P14gnqwBRE9ArzHy6IVvdh6ZID3wrGRpitA5Qq6/E9Ba+/5dM1LTg?=
 =?us-ascii?Q?r7ZSaeQGzlGi577vaI7NbF5L+zSuc3LRkgK0wXlSrOpdWG6leCyWUtnHUAqm?=
 =?us-ascii?Q?coswh4qzPOvDgxxzqel7ibL+mZIwMw5o0wAoKpFAItUxopcXGriKXed0NFRT?=
 =?us-ascii?Q?TABTu0oDtWC2ypscdPDlW5Ff+SqDYBtcyjQqhBiCG0ijItiYrVzqTrHLzOlF?=
 =?us-ascii?Q?86nEk5ZM2IXcr4hAMmpNCXpLKcfAQC0eA1yC+3hbcYP0B/rLReGYyXI8jRZB?=
 =?us-ascii?Q?df7166c8WkdXBU7zA57YX1Lb0Gnq1d9SRWNy38cH5YeGNZH5H9mtE9OSWEeg?=
 =?us-ascii?Q?4sBnmGClYMHQwGepELrCy1V+PMmPMXGzX7j3unpY7jEt/mY6ncjEceMLzli0?=
 =?us-ascii?Q?BQ6TgiLBEfHauL6zXzzaGm3rAZC15AzeYJLvbK5Kc7jL1JAJUKGlwxL5yEoh?=
 =?us-ascii?Q?7SAbm/e2DEEjUuUennZ8TGuNIxul7842BGszEQ6nU21VJtPaou7GwKj2/jbJ?=
 =?us-ascii?Q?DWPtdmFbkDsUJKFCsBtqB8EY7x/L/OHPNi3HY+RSk7ZrZsczBxq3PHTJ0yjk?=
 =?us-ascii?Q?TQa/+OH3hMsSTymh2fTPt5CjqDPdIZkwCIjDaoG5P1o8kF51Cxh0DygRkJYq?=
 =?us-ascii?Q?JwhbjoJiqpRtiESARp4XwgA9Yyi0tu5vB9YsdbU4SSEFQfCfp7RXcBiAk62u?=
 =?us-ascii?Q?oZBuqWWe+X0NBthykQ+yf4pGVIpzE3VReTpwsyUn1YecOYAtvuPW15cLSUGS?=
 =?us-ascii?Q?L4aIvnD3+07QyYGQKUs/+iNXH/XgUOSIt7X5zlZNCnYJVoWzPumP5NfT5Ygf?=
 =?us-ascii?Q?VJMCtCZbLtSniDST2mLoNGN4K0e5PlEMpi2wTDYBVA2dsTVI+qCY+ZFgza3I?=
 =?us-ascii?Q?F9WfkT1TYUeYdERsQl7r3h7v+XtLheVqMdx/lBY3fdkUgFUUIv5Qf9I2eEYO?=
 =?us-ascii?Q?wssG+LR4ofSgzO48IpAe2xyx5Zniiq54mUsZ7K/tXyV2Grvp/FndQyvOrGIp?=
 =?us-ascii?Q?CNJTFNBw6HYH6KMikD6Os+Hu9YnSGpiyuuVXN89kOvPR9IUB7CfwzM8AmZi9?=
 =?us-ascii?Q?F7xGAqyNIechL2VdWm1lUr2uOzPdyGnokqZz2cTatfXZSaHfBvOZ+Cnc/ufP?=
 =?us-ascii?Q?WBQJd8RB3cXYXgU8DlUUvolHY/yJU2ty2P54480XEACBx3/RbZ/IknQMZe6E?=
 =?us-ascii?Q?vUnyQl8eg4hbxhCwetN6z7zMuuoNaUybtgcR1XQLzzhgZTTV5zKmK2q2BHpk?=
 =?us-ascii?Q?3K317UcxvWlaenpv215cJU4ocGgrKqfi8O8TIq45qPTPYH61M5dwEzVPapg2?=
 =?us-ascii?Q?kLAtXmu0T1R5RttLevSBRVeE?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 0c9f2b1a-f94f-4ba1-7acf-08dbf9c2fadf
X-MS-Exchange-CrossTenant-AuthSource: LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Dec 2023 21:00:03.3231 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: EA2P223MB0834
Received-SPF: pass client-ip=2a01:111:f403:2c16::801;
 envelope-from=outlook_98C99531806B1C22@outlook.com;
 helo=NAM11-CO1-obe.outbound.protection.outlook.com
X-Spam_score_int: 6
X-Spam_score: 0.6
X-Spam_bar: /
X-Spam_report: (0.6 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001,
 DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FORGED_GMAIL_RCVD=1,
 FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.249,
 FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25,
 NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001,
 T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no 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." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=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-Migadu-Spam-Score: -5.56
X-Spam-Score: -5.56
X-Migadu-Queue-Id: E1F302079A
X-Migadu-Scanner: mx10.migadu.com
X-TUID: V1FXLO+STcnm

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>>> The detailed reason why we use this particular markup is that
>>> otherwise some internal code assumptions inside Org mode may break when
>>> users run `fill-region' on the notes. This is an internal implementation
>>> detail which should not be explained in the manual.
>>
>> Hmm.  Fill-region will also compress the blanks in the generate note
>> header -- does that run up against the code assumptions?
>
> No. See `org-skip-over-state-notes'.

Hmm. The docstring on that should discuss what it's looking for to say
"this is the end of the state notes".  Does a plain note (org-add-note)
count as a state note?

>> I'm all for keeping internal implementation details out of the user's
>> manual, unless...
>>
>>> What we might explain better is what is a line break, although I am not
>>> very sure what to explain here - I may be too familiar with the concept
>>> from my LaTeX-foo.
>>
>> The manual should set expectations on what an Org file should look like
>> -- at least the key components.  It already defines Header, Paragraph
>> and Timestamp. What I think is missing here is the definition of a Note
>> along with some structure info about it (header line + 2 space indented
>> paragraphs[s]) to prepare the user.
>
> Unlike headings, paragraphs, and timestamps, notes are not a part of Org
> syntax. Their format is customizeable via `org-log-note-headings'.

Oh! That's an interesting point.  That variable is not mentioned in the
Manual (AFAICS), but perhaps it should be -- particularly around the
talk of "rescheduling" (and "delschedule" which I don't see in the
manual). Mentioned only in the sense of, if you want to change the note
header, look here.

> However, it is probably worth describing the notes in 5.3 Progress
> Logging section of the manual.

I'd agree.  In particular, what depends on the format of the note
(header) -- like Agenda.  To warn people what they can or cannot touch.

-- 
David Masterson