From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:1008:1e59::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id WOTJDfIAmGWxNQAAkFu2QA (envelope-from ) for ; Fri, 05 Jan 2024 14:15:30 +0100 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id yFejCvIAmGV9xAAA62LTzQ (envelope-from ) for ; Fri, 05 Jan 2024 14:15:30 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=LBhXMdxX; 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=posteo.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1704460530; 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=dbnZ8a6uajdRFOI0ffFj7Ddv7Nsq/zqAKzUYraNpAVg=; b=H8U0aYcN2NMvHqlr6gQsLX87IZuJPLgM3WLjWrUlW28ebbuu8AFqaZ56cXbKjrQqEX4p/b 5z2jsi30T+wjPH9kJjHoqL4iqR6vv/w3mU6HF76HIa6pgx3d6lGx6u0ZDM8O6XQPijNonY La9aUEuqmeEGB33Y56+g06r1wc8HET3ML04BJ1s+8TBjzWFKRrMuHov9p4xlY06QVup14O od8t6EGbacy7U2QBrSTbWoWTr1v2QuKgdJU2F8eiEDO/ddGNwk5d5C2ol9IWkBanprheCs ooQuwxq7fRV7cPjNlh5qdMS1hpWPjIj9u3hwxmWt0XPHBsvC0pL2Xa0NzijicQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=LBhXMdxX; 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=posteo.net ARC-Seal: i=1; s=key1; d=yhetil.org; t=1704460530; a=rsa-sha256; cv=none; b=QeLEQ5GaujMVX60YOnnLPKN4UjVW1d+LNkokjC4nGhP2goZd8Wv1atWBzh6cBBfLbk1YfO cQM1sO9jbTzOaKxWtWwUXkVJNZXBEED61YjpWWQpwEbGBHOeF0FQJARrnYlkbFJOg+1Whm 00Td9LxSBMNHNRdrlrkWVhwqwCH4B8wdnwGVQaV4SLunqmqqJE22Pi4Y+4UMWkDyM1jOrZ /z86qDC1D3V6P12LCkHHaZalfKttEVju/Cn0Jwok5vdsjTeMhRSsew35CWDusjm5MfzOQB XUm8FLiCC9m4SxHnblkeeTlF6oTeiaqPxm53q9mR9Yv1zrPsryJ8SnGJZzKiLg== 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 0CC9657B20 for ; Fri, 5 Jan 2024 14:15:30 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rLk21-0007BN-It; Fri, 05 Jan 2024 08:14:37 -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 1rLk20-0007BA-5V for emacs-orgmode@gnu.org; Fri, 05 Jan 2024 08:14:36 -0500 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rLk1x-0005Ae-Tw for emacs-orgmode@gnu.org; Fri, 05 Jan 2024 08:14:35 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id F1CF9240029 for ; Fri, 5 Jan 2024 14:14:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1704460470; bh=atEbSib99vNoPGwEek6OTD/nawhyZqMET5EtuWrvsRA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From; b=LBhXMdxXd7qdG1PX+pfsDGCLaaKaoRrN5T3Z1g30SlJl8OifzWWUMa6UlWxibiVhc U/IF5IvK1SGwIYsveDnr6c/U0TG6O5uYZfC82GjONSTQe4IH67SDDJhWrfp1crs6X9 PkwQFNS9itjbJSp7aeCyzKmBRwDUFIXV8PuCrWycx0GN47e/xMHHwdDGaHpT9HL204 L7HLs9RKMNThWxKMHb0QwYDfpL9JLqpeRQdnwPi4T0wx7Jl1nhE8dY+KcPmXsWxkFg hv5LUe/jdbnUWF0R6IBnUqUg7M24wcimPVLf5DugrdlAQysIgPJOuRK3EuwUKKY0IS VMxomopwXsqfw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4T63nx2pPPz6tx1; Fri, 5 Jan 2024 14:14:29 +0100 (CET) From: Ihor Radchenko To: Matt Cc: emacs-orgmode Subject: Re: Comments on Summary section of Org manual (was: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable) In-Reply-To: <18cd111777e.efad32b9285772.6378361649896083029@excalamus.com> References: <87il4e75u8.fsf@localhost> <18ccc5c24ab.11c0534ea910085.7925872212667260908@excalamus.com> <87o7e2a5wf.fsf@localhost> <18cd111777e.efad32b9285772.6378361649896083029@excalamus.com> Date: Fri, 05 Jan 2024 13:17:41 +0000 Message-ID: <87zfxj6hsa.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.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 X-Migadu-Scanner: mx13.migadu.com X-Migadu-Spam-Score: -5.68 X-Spam-Score: -5.68 X-Migadu-Queue-Id: 0CC9657B20 X-TUID: Fb97AE8nAABK Matt writes: > ---- On Wed, 03 Jan 2024 14:41:29 +0100 Ihor Radchenko wrote --- > > > I do not see much benefit changing "todo list" to "to-do list". Both are > > clear and both are grammatically correct. > > I said "TODO" to "to-do". I was reacting to it being all caps. I'm sorry I didn't say that. > > When it's all caps, TODO is a keyword. Otherwise, it's prose. The following are different (AFAIK): > > * TODO Finish this headline > * todo Finish this headline > * to-do Finish this headline > > Agreed, it's a minor detail. Yeah. TODO may be a bit funny. Although, we consistently use "TODO list" across the manual and often say something like "list of all TODO items", which is resonant with the concept of TODO keywords in Org mode. So, TODO in caps actually make some sense within the context of Org manual. You can call it a style. Unless I hear from people being seriously confused by "TODO" in caps, I am inclined to keep the existing style convention. > ... > "Markup language" is fine. It's correct. Org syntax is a markup language. > > I'm happy to leave it rather than risk bike-shedding it more than I have. If we learn that it caused friction for a newcomer, we can change it easily enough. +1 -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at