From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.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 kDHAGV8OdWWgfgAA9RJhRA:P1 (envelope-from ) for ; Sun, 10 Dec 2023 02:03:27 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id kDHAGV8OdWWgfgAA9RJhRA (envelope-from ) for ; Sun, 10 Dec 2023 02:03:27 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=J+gwFZy9; 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=1702170207; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=fDp/hb2NU5qKEA/O17iIjQ1pPtVCI4vwCbxhmA0J6YQ=; b=sLaX2Ur5L3zuN7WbZxnJQR0i5CjBkc/qfTvdohJiRI9mtzJFXf0lr0aQwQ84PXduvfFwAi 2V0nAq2FaHH0jQTnRUNzrdDYK5h3/vV2sx8yvksKO3hWAWqE6CZaW+RcWVRVJ/Owf5oXv5 Dq4chuzehPb4rvftgfnsYAS6afy03qrlGFZim3LOlvnmSG6gprqt5GKzizOkF5OtVxM2vd I1VbU4rdrkRt8X14417lKEOKSeNblS5ieTVXPe37HYMer/RYsgHgRxUCaTK1bJ+mZwoqJO JrcDYycEokGvvnEjvPB9mSAKhyKNNd2zS+KO3+HAK0oSetNC4KgcreI39TwvJg== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=J+gwFZy9; 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=1702170207; a=rsa-sha256; cv=pass; b=hkKAcGV5xMwhK7VbEGsVvZa6CDWcdxFQBTK/zBzf25uBLEBnHxHDy7wPXr3D6X/khIbB6x pWi6OHljDZPSsGuzlL7RXaHr6gYXNNk8sMHFXr8mbEDpBdj+fe07jS8RTrf3HCGwRMzb+x ZjL/7pkN91Zm5WE8t9xfavxuQsd98M51PpDMhMcPTefEdPiQBGyJyeuclzeKx32WhtHDI6 ohmoq/Mj/v9+Bda6jtYcXA1YuD5r7FWHUXR79+grA6nMCULhD+gFQMS+ffNBLqGGa6MRQ6 Vn9jxOiJOyAM88zKaIBy5pZcTXF3USTrR2/E6IzKOKUgDMn1IMjNUeHXbBb/ZA== 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 0AD245980A for ; Sun, 10 Dec 2023 02:03:27 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rC7gm-0000MO-Aa; Sat, 09 Dec 2023 19:29:00 -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 1rC7gc-0000Lm-FH for emacs-orgmode@gnu.org; Sat, 09 Dec 2023 19:28:47 -0500 Received: from mail-bn8nam12olkn20810.outbound.protection.outlook.com ([2a01:111:f400:fe5b::810] helo=NAM12-BN8-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 1rC7gZ-0004XR-Uw for emacs-orgmode@gnu.org; Sat, 09 Dec 2023 19:28:46 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aN8zCmAE8ECd9SCDztFpUqNjfy6jsco0TRnqsNUTewsA7XsYLqAAoFd3wxfx707AzZoEIOjcMoCzU7B18BXvgC2C3lu1L74ZZc/eTKlZ6Jb4g8PYHadvM4sNKdkjEhIUYtavYbA41NJVeyI/Tb3FjfuIi52EEtOtZ9wEXIF22NMkf6jBI2T+NGlVWiUTwu1oRaTqfiTws/vPY6cEFgmtjzJUrnAFRYD9FlvmQ47c+Ut3nBDJlj9BsBiqph+hADEA5O4QJyxGeVbdymbW4Y371vgjycyaKFTJieoqXWCxwOeWWbaeBrGSnW3I3gZB6neXqZeP1inMZmupL9AJHakNRg== 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=fDp/hb2NU5qKEA/O17iIjQ1pPtVCI4vwCbxhmA0J6YQ=; b=m4OpbISNC2iyIgAH9Z8WkoynysTlJPyt59uwV6H/yZqu0hqc5sH79aGGkzV1dclcqahJH3NZdhRGsH+klcrCzyXCvgGqKFomPiCd2uZI2/fMUqMEjx2W5yA+92ZDHJ1J9KWTSmXE+/2T2gTyF9Ccfej/B4KljOWYJalUfpxainT/Vw3Qz44t3UrQsqFMQOeD60GDF9aw1jiLJk3BJIzFTp+eHeTjsC9utCf5fDjyoiIcu5aV/E2F1xOh8XmhSzNcsDc0yaeichd5CQOvZjpLuV9DIckcfc+2ElTt+lN5D+i5zur1Ok0wKWeIppVa3kJklo3sDg1/y4+OrVklv2ZXdQ== 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=fDp/hb2NU5qKEA/O17iIjQ1pPtVCI4vwCbxhmA0J6YQ=; b=J+gwFZy9JK2llFnQxIFvIuDPT3p77+7HgRIhzsmjfeLmf0KJXKq8Ftt+Zh+lKx8+vpuiZRsvASR8VEXHwhxPER6/Nn4gTbefH5+cvHZGCOFVR+FXem20BgMPkTnlXcRCehNqfEmNozkfjdlWUZPc5M+Xjn3OFZMOWXmvecqOiTo5o6zaF7EpgzxikkjoVe+Ah3R/TSegX2sMmILgXI5mqX9zEptXV+XJtPrYUiU0gGyfreMoQT6CxoUujV9EbCC38faiVyZjVFnGWPUnTZKUCi903eXUAq9zLuGBFnZCh4+YWkgIGPsP4ImZwG2y0z+LrNxdOU0Gs0urR4p2cZ6hcA== Received: from LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM (2603:10b6:408:1be::16) by CH0P223MB0171.NAMP223.PROD.OUTLOOK.COM (2603:10b6:610:e9::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.19; Sun, 10 Dec 2023 00:23:39 +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.019; Sun, 10 Dec 2023 00:23:39 +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> Date: Sat, 09 Dec 2023 16:23:36 -0800 In-Reply-To: <87jzpnskmy.fsf@localhost> (Ihor Radchenko's message of "Sat, 09 Dec 2023 11:03:33 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-TMN: [AVqm4s/Sa7FS+Rq5DFACiv1oqlQi/JuqTZVlILoKLEmQb8a/gQVTOKFrkjxxSzql] X-ClientProxiedBy: SJ0PR13CA0132.namprd13.prod.outlook.com (2603:10b6:a03:2c6::17) To LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM (2603:10b6:408:1be::16) X-Microsoft-Original-Message-ID: <87edfuucqf.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: LV8P223MB0920:EE_|CH0P223MB0171:EE_ X-MS-Office365-Filtering-Correlation-Id: 9a0765dc-7032-4e8c-4172-08dbf9164188 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: Xo1JPtOGzR8ih30anUkJvTCNMkuYIwBGina0ulCxIRJm02XFekD/ryPF9yqeN4U5LZ2LjRdFh9/ACY/hrP+DUtxpsBz+5qqQmSRMRXNJ6A9/9/E6sk+/kFxlfqrPWzJjaJPvlhyMSIKHZSX6tb5IvGbQyW1fqlkkrVb3LJqFIB6o1gt/im5AvW0Pkhb2ecCJlcEhjTFVIWpvAk0C0XwReSydqUModJvg/9eZhtjxw7/JLfYWaQqM3qEuNhMUJdZyNRyrpAG2yYEduCxFLtC39NV2fivCxnoFUc8RWraGbKN+c6AwCad/FSma2hzdLM5J95PVYehHULHNg+BLAY+CELvJ+r5eml68OoBXnJ9Ugo/vfiJm9LJeSp5vg3yn9bVWgeB0fAp0gsmR2AxRd6OhgmqLBpRg9fWGFcopTgT1P9jseTynvseaJxu21EEvLchbpQFt5lu9ttvscYbUqADiXLYLqaYoyEibMVArWpptkGfse9eW8s8TM6P4uiyc1fR+x7e6+2P16sFSo65SBEJtEFweiQDvDZtRcCJuPfH3owg= X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OGpDNGFEVHEvVlNMQTY0YjN4ZFd2Q0RVeFVsY1MxbjU2dWRGSWlZYnJGZmM0?= =?utf-8?B?VTNUS1dUbFlzTkNCQm9pYVYzTHNNU0lFNDRBYjVycVpFWUZkaTRWOTY0SUVi?= =?utf-8?B?amkwaFNWNTNhVTU3Ym4xWVVMQjN3Wm82b2c1bXg2b1pORVNRRzdsQ0N5bS96?= =?utf-8?B?K09RZ0Z2Y2VRb1Jkc1gvRVdDM01VdEpVZUJQQ3ZyOVh2M3I0N2FZdFBOZjBQ?= =?utf-8?B?SHFTMVBqNERpUmR3dmlXc2hGMTJtSEFBMTRpQTdWWFFScUxiUUxVRFlNeWQ1?= =?utf-8?B?VnBBZWRkbkN5Vk9sajR0Wi93YitDNi9vRlg1N2J0SS9Ub04rQnY0dFhEeFFM?= =?utf-8?B?WVg4VG1SVFFNNmF3L1JnM0Z5VDE0VjUzOG1tdktCQ2FTbEZVVytaMlF3ZnR4?= =?utf-8?B?TlREdGMxNndpNVhtdmR3QUd0cWlwT0NBNXpsNmtEUHVsRFFwK3NJVm1UbklV?= =?utf-8?B?SEhJMTV1SEtoa1ppSXdmSzkzSzNPWS94RGNXeU42b3VHMTA5WGNuWTlNTjBv?= =?utf-8?B?dXVmWkJ2SUlET2lSdlpCODU5eXRmZXRDdE9rdXg0MVY1cXlKUVp0bGc2ZVc4?= =?utf-8?B?Tlg0VktZMDZSOVUwc0ExOFRuZDBZb1FrTFNmcTQxemJzYUJGdGJ4eFJGSEhG?= =?utf-8?B?V0pMYS82TWNjQ3lva1Z2S1JJNjRDS2tRYSs5dHU4MndLSk9OTmZYdnFWdUdJ?= =?utf-8?B?dFhWVFU4bk9EVGphZFE5WGZ5cGZIc2t0R2gvQnc2VmJGWFdZUDQwSGcyeU1U?= =?utf-8?B?UkEzazBiQnhQZFZ5TjBVZHRBRkd3WnY4bEtDUnk5cFJ2NHF3WW1FdVh6c2Fq?= =?utf-8?B?L2V3bWlyeUNlZ0N3R1BvSWNxZ1pPU2RJcHdWNHFhcVpFY3hzK2g1di8vUitL?= =?utf-8?B?Vm52UERnSFAvQmF3d0FUSHYvekhDU1ZxeXYvRWJIR2hqMi9MdjNuS0hmNy9a?= =?utf-8?B?VmRVYldHRkp5K3pRSlpKaHk2Ry9za2RDc2VCUEo0bjJwZFJ6aTlJVXh6TTB3?= =?utf-8?B?YlJpM2VVSFlwYlZvcHVnaGkrMGlIU2ZMdnNmRm9IclBubU9TZjNNZFBPVm1Z?= =?utf-8?B?V1BwQ2RlQVNZNndRUWhJNVpJNFlVcVUrdzljS1hBYkhPdVpRc1AxcEdGOTlm?= =?utf-8?B?LzB6TXhlNGhuU2k2enJPZHhxTGJWakVIUDdUV1hkTC9rSUtrWVdVVHpvUXB0?= =?utf-8?B?bjd0MFlaQ1pJUTlMZnpsVWdvSTk2dk9zT1ExWDhZY2ZPam52WWQ1UGZmRDdP?= =?utf-8?B?TnVpMUZXQkQxZ3R3V1hHNGFjaFNSSHU0OWxLY0JYNnV0OG9obDFZY3Uvc2VV?= =?utf-8?B?UXA4K0dRb002Y2tUOVkwNXo2ditKU0MyWlFzYTNrZnBuK3NGTnQySG5vcWp1?= =?utf-8?B?ZXhyUlk0ZjA4eHVBTXpsNXhXS1p3Sm9pT3JQd050aklMY0tEYWdpRFVyWkhC?= =?utf-8?B?SUI1OEdWTzNWdUxvTmVDT3dEYWFEN2VFVzFBKzBaVy95ODJ2NkNkR2dnajNk?= =?utf-8?B?UDZqZ2ZMZ2dnMERWL1JVWVU2ZHdrMHh2ZVdBM0lYZzhIQkE3Tm5LZVk1cG5O?= =?utf-8?B?cnV4MmE4cHVGZ2RFbHpnU055SGxTMTBKaGxta3BiM3VvWnZUS2hTSWw4Nit6?= =?utf-8?B?WWVBRXg3RUNidWJjYVp0cU1jdGtKR3NRUVBqSWUxTkx2eENxeWFoSVo4aHVF?= =?utf-8?B?bVF5dW85TXdJNERkQmIrcjFTWk9ocEhGWWtYSEZFc1M4Zk5NKzFIbmxjWjIy?= =?utf-8?Q?XcVfDWAhL8MA6WRxo2jByzYdaHH2KUlM2GvDg7u?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 9a0765dc-7032-4e8c-4172-08dbf9164188 X-MS-Exchange-CrossTenant-AuthSource: LV8P223MB0920.NAMP223.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Dec 2023 00:23:38.9613 (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: CH0P223MB0171 Received-SPF: pass client-ip=2a01:111:f400:fe5b::810; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM12-BN8-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.25, 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: -8.12 X-Spam-Score: -8.12 X-Migadu-Queue-Id: 0AD245980A X-Migadu-Scanner: mx10.migadu.com X-TUID: em9LxiNZ0psY Ihor Radchenko writes: > David Masterson writes: > >>> We do document the line breaks in >>> https://orgmode.org/manual/Paragraphs.html >> >> The only thing I see with respect to '\\' is: >> >> Paragraphs are separated by at least one empty line. If you need to >> enforce a line break within a paragraph, use =E2=80=98\\=E2=80=99 at t= he end of a line. >> >> Which doesn't answer the question of why org-add-note (etc) added it the >> end of the first line of a Note which lead to my confusion. It's easy to >> assume, if Org is adding '\\' to the first line of the Note and the Note >> is a unit, then this is there to prevent folding/wrapping in the Note >> when Org does "something" (but what?). > > Line break is a "forced" break of a line in paragraph. When there is a > line break, paragraph does not re-flow to the page width. > > Re-flow may imply different things, including `fill-region' command in > Emacs or paragraph layout during export. > > 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? 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. In this, I probably come from a more Reference Manual viewpoint (ie. "this is what all the pieces could look like -- now lets discuss why you want each piece"). You could say that the '\\' is needed to keep "other things" from combining the header and paragraph of the note. You could leave the details of "other things" to variable or function docstrings as well as internal code. p.s. would requiring a blank line after the Note header eliminate the need for '\\' ? --=20 David Masterson