From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ) for ; 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 ) for ; 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 ; 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 ) 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 ) 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 ) 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 To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: oeg-add-note and double backslash ? References: <87jzpuatr1.fsf@localhost> <87il5cvjvw.fsf@localhost> <8734we47i4.fsf@localhost> <87jzpnskmy.fsf@localhost> <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: 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." 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-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 writes: > David Masterson 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