From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id 6CbMH7H7tWVINwAA62LTzQ:P1 (envelope-from ) for ; Sun, 28 Jan 2024 08:01:05 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id 6CbMH7H7tWVINwAA62LTzQ (envelope-from ) for ; Sun, 28 Jan 2024 08:01:05 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=verilab.com header.s=v202012 header.b="C/MBL2yw"; dkim=pass header.d=verilab.com header.s=gv202012 header.b=SV6E1noh; 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=verilab.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1706425265; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=HTHLR1omi/X7yvYbEyY1237N/SIKZZMGHHqadMGfHOc=; b=Rnbv0p454WiXxtp6eQW8A/KxeRACaQU9cJ3uQgb8P6cgviOFXfWUmxdnsTyyvlnhtW0bLk 5BKrq649588pJX9Gvk6NqZRIJE/bB6mJBJc9hBnNx7wFUX2OBXYmDV9dU0XDPhLc5tooN/ pZ5cqSWg2wCaK1YRClFMTFSuCE3SCVrny+v3uxPMRI8pvE/3i2AqYGBJBp0gwLa7ceDHbx pY8Ob7CixWAj0F20hBe3DDN+G4SPdOCEdFUoEFv5eSGabyGIeRsn5pXEPtSJNHkjrWwsqB 0GtElwV+pLp0UbqWl/AAiB5ug4fM4XfgK0J8YrSHf5C0RU4b+79Zl3BrTYbFkg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=verilab.com header.s=v202012 header.b="C/MBL2yw"; dkim=pass header.d=verilab.com header.s=gv202012 header.b=SV6E1noh; 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=verilab.com ARC-Seal: i=1; s=key1; d=yhetil.org; t=1706425265; a=rsa-sha256; cv=none; b=QBTKf9VVfEePqtQfG38cWxcrMXBGSpNNXpXW4WhdeTHUN8xQaG5O0cpM125ovP4fFai/WW svQgj4l0KaAZ9B4gsLZvmsfx8BZpSt1b1DwCm7FvvYAoVRF5xIXGwNLIUmBJ4hJ4v50QhK CvQQx8J+E1bbdm/5qWvZdpJu850YzZ9mvamXH+vsPq86fRJAenUJjb5j1Do1J17kKfabbd mkdQPt1+PdKo864rP0qx/X4BPUPm2YGsCxhmQdRqCDQIffiJo+NM0hcJjBOC8my2WzFI97 +jiRtYkem5GFM5s00SmPjGNDtjOCVXIrF0mFFUQBMs1UzoIff4vDxi8+m/Y8vw== 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 1B85546CD2 for ; Sun, 28 Jan 2024 08:01:05 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rTz9S-0006Eq-C0; Sun, 28 Jan 2024 02:00:22 -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 1rTz9R-0006Ei-3n for emacs-orgmode@gnu.org; Sun, 28 Jan 2024 02:00:21 -0500 Received: from cather.verilab.com ([64.20.234.125]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rTz9N-0001iQ-LA for emacs-orgmode@gnu.org; Sun, 28 Jan 2024 02:00:20 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=verilab.com; s=v202012; t=1706425213; bh=HTHLR1omi/X7yvYbEyY1237N/SIKZZMGHHqadMGfHOc=; h=From:Date:Subject:To; b=C/MBL2ywa1/9Aq/v/OcF9d6cpqlZ4T8DltS+GP+zLA/GLrb02TKx1Y0KmdFd5rHAr NWs3FUHXJO7DbdmsO33DWeVqjlzeQLRDucuuUcLgz53GAgWryA8thU4QO2B/1aMcew o/rc0Y+3O5de7LfY04+FvNUqYqfT4osqxa1e4DxHOtNviG3NsxKjriMdHVW3/zKqYL kndfHhJEyMr5RBrGHmvhJvm+n/PjRLhluZ5k03HZkDEXCCUs3l2rs6g4Sb2HrD73n4 XxNFc7hW5jUzRGPlIOqPO9gwyuFoD9Az7n1GTkaV+MK7PdX6Jzk+1U7t+44cxI0Ivt rSoBqrAFrCzZw== Received: from mail-wr1-f72.google.com (mail-wr1-f72.google.com [209.85.221.72]) by cather.verilab.com (Postfix) with ESMTPS id 209D41ABE3 for ; Sun, 28 Jan 2024 07:00:13 +0000 (UTC) Received: by mail-wr1-f72.google.com with SMTP id ffacd0b85a97d-339222e46a0so1089415f8f.2 for ; Sat, 27 Jan 2024 23:00:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=verilab.com; s=gv202012; t=1706425211; x=1707030011; darn=gnu.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=HTHLR1omi/X7yvYbEyY1237N/SIKZZMGHHqadMGfHOc=; b=SV6E1nohFrpLwsAOT0CK9hRC+Sr14uHD+mLUTzIVz3aLNlixGB2SWgObWfMjcpgYER JJbJV9SNLli9iMo44ljs6+SDSwduI9mPw5knzDxAyMwPlfogZGf3o/RdWhzj9ka4HXUP PY+eQB5ZeXD+9PtxzGQHGaaME5jvAJosfRNC5irRsUhBNEqj1tlh2Qz9EcJZ82o6d6he CxMsFDIZR0LsPKYglkK0lqBvfwKgExFrrGidWqgMVRmJi1mfwM1ip98GtqS4rfJR6e23 2GOA77G8aEGMVTwg6W3GKWUILq2Itp9TCH9CPxgVYegz4kwygYXVErDv6vL6puGuudwJ FWwQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706425211; x=1707030011; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=HTHLR1omi/X7yvYbEyY1237N/SIKZZMGHHqadMGfHOc=; b=e9d7rk9RAOmSqVClYKviqhNN396axUZ9FCwvQnproZsI+2LuFAHPyfYnbSaFLt0a7t XmF96E27kJFERirjAnGPVdKiAyOWKH5dNM0Zs7JbeVEbfMQMMaBCYbYW4DHoZdQTcicC Lu2Q2rh4TTA2B9NHo1fDAZ15E+7XP6i3+hNjY2shjZN1Y9XbBvVWn6bMfJD77+qy8XYN zxDQbP6reRkRID+y9pYGfUjtOW90w+el3LmHoQayXHNIkD4rCSP1Z3oizlGBa90/cN8p jIjpW8gQCtSkWhIAhoEN2fxG9d8blXC56U3B180BPr44kpdnTe6qjfq5ulWeCOudBYyM 5lcQ== X-Gm-Message-State: AOJu0YzEIg7nPv7FwPISfcYfHobWj0B+JRrIuAu1d6R4Mlt2pRVJWW9j ekPdTAjDBuzfYaQRUUArWTeS7+qieMXrcb42Xou4v+KQZR2bFC1dLwiy18rZhcEKND0Z17dtMD0 rWPt08a5b4z0JBdT2ZB6Id/t/E1RhR8eYEqGjmgw77bAJbKYALv+j7ZCr7P/H8ByqiJwX0gx91x NAf9mZU+GphSKh5J/CwMxHrpgcPpF7kpwumsTZIvSQ X-Received: by 2002:adf:f8d0:0:b0:33a:e2f4:7d06 with SMTP id f16-20020adff8d0000000b0033ae2f47d06mr2199434wrq.34.1706425211081; Sat, 27 Jan 2024 23:00:11 -0800 (PST) X-Google-Smtp-Source: AGHT+IHSDanOVtF7KGJyLlVwOwXuaW9psxSPCYHdiMTSXWL7LHuhPbzGHg/VcvwGgEvgXc/I57dNzSGStv0agBjq1zA= X-Received: by 2002:adf:f8d0:0:b0:33a:e2f4:7d06 with SMTP id f16-20020adff8d0000000b0033ae2f47d06mr2199417wrq.34.1706425210675; Sat, 27 Jan 2024 23:00:10 -0800 (PST) MIME-Version: 1.0 From: Tommy Kelly Date: Sat, 27 Jan 2024 22:59:34 -0800 Message-ID: Subject: Suggested manual changes - section 7.2 Special Properties To: emacs-orgmode@gnu.org Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=64.20.234.125; envelope-from=tommy.kelly@verilab.com; helo=cather.verilab.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, RCVD_IN_MSPIKE_H3=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-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -7.85 X-Migadu-Queue-Id: 1B85546CD2 X-Spam-Score: -7.85 X-Migadu-Scanner: mx11.migadu.com X-TUID: pBAORXRBK3Br After figuring out, with help on Reddit (ht: Adam), some nuances affecting timestamps, column mode, and the Special Properties TIMESTAMP, and TIMESTAMP_IA, I think the following modifications to section 7.2 (Special Properties) of the manual would be worthwhile. As it stands, the relevant part reads as follows: 'TIMESTAMP' The first keyword-less timestamp in the entry. 'TIMESTAMP_IA' The first inactive timestamp in the entry. Both are slightly incorrect and that can be fixed by changing to the following: 'TIMESTAMP' The first inactive keyword-less timestamp in the entry. 'TIMESTAMP_IA' The first inactive keyword-less timestamp in the entry. In addition, the following three clarifying details would be useful (the last of them is required) perhaps as a footnote: For both TIMESTAMP and TIMESTAMP_IA: the word "first" refers to the first occurrence in the entry, not the earliest in time; the prefix 'CLOCK:' at the beginning of a clock entry is considered a keyword in this context; and timestamps inside property drawers are ignored. regards. P.S. I'm not familiar enough with the various moving parts to provide the above as a proper git patch. However, FWIW, I did the following. I modified a local copy of org-manual.org and then I ensured that at least a PDF export (produced using 'C-c C-e l p', but only the section in question) looked sensible. Then I produced a diff-based patch file. Here it is, in case its of any use: #### START OF PATCHFILE #### --- work/git/org-mode/doc/org-manual.org 2022-10-06 11:49:32 +++ org-manual-changed.org 2024-01-27 22:44:36 @@ -5353,8 +5353,8 @@ | =PRIORITY= | The priority of the entry, a string with a single letter. | | =SCHEDULED= | The scheduling timestamp. | | =TAGS= | The tags defined directly in the headline. | -| =TIMESTAMP= | The first keyword-less timestamp in the entry. | -| =TIMESTAMP_IA= | The first inactive timestamp in the entry. | +| =TIMESTAMP= | The first active keyword-less timestamp in the entry.[fn::For both TIMESTAMP and TIMESTAMP_IA: the word "first" refers to the first occurrence in the entry, not the earliest in time; the prefix 'CLOCK:' at the beginning of a clock entry is considered a keyword in this context; and timestamps inside property drawers are ignored.] | +| =TIMESTAMP_IA= | The first inactive keyword-less timestamp in the entry. | | =TODO= | The TODO keyword of the entry. | ** Property Searches #### END OF PATCHFILE ####