From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id uNkNBtJ87mMJQwAAbAwnHQ (envelope-from ) for ; Thu, 16 Feb 2023 19:58:26 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id aFIDBtJ87mMsXAEA9RJhRA (envelope-from ) for ; Thu, 16 Feb 2023 19:58:26 +0100 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 AEC5C16F43 for ; Thu, 16 Feb 2023 19:58:25 +0100 (CET) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="Z/l7bd4B"; 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=gmail.com ARC-Seal: i=1; s=key1; d=yhetil.org; t=1676573905; a=rsa-sha256; cv=none; b=KqVQfTGKIy7OzdxE0cCGiuI/N5jN4z3e4886DRRo5mzGfitZROAnAz16+CnBYjPVItscw2 pfBmxUZ9DjeXBRo8vt6bSdgcYC8GL5+1zq422RzXxFCG6joGnkrBoB7nt2DKHQAPvPbxnx qgb8F25KGZ7BNRMx4XeQB9PpduCc06tvI+5sey5wTVK/9bDr7HNOVA6MXSYnjI4ZpfjlmQ tGyexhwhq/KH0C1Pt8zRox5DLpp0NgRR9Nn46hhUjdDY14EIcXeV/lDcnVm+U+s4nOvLbT LOrOvBZdn2QxP5xvvp7PRx463wOQ5NLNr+afcPYzXYkM6szhVBhZBSpZays4HQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="Z/l7bd4B"; 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=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1676573905; 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=mbtlVRbDB0PD4u20+P4o8Seu+37nT5UNkQYqcWeZzGM=; b=Bk13dwdJBYAq8KgzvwkIptQZKj4WIPBE8idePLBbWnOCWkGprhjREU2AAy7HrCzsbF1lWa 4KSBX5NiEumc64Isigu4HVEONYoFMBolA0Ftuo95lZWECanFyWow1y7GH2gSVddIysgWBM cWwJQEv67/R4lIBnttw4T46JU2DoEF+Tw1DJV7/Zm+4gGbkRdkW3PqVHW7XSfBZozsbFUE zl2ku4Cl7YQbCIHhuoID9Uzk3xoTen7NKKevDOkgMDQpB/VblKpLFHHBdgVIekZAUd9qhd RYjZRyHbu5SB94osoCr/eICt8XsflWhWROXMTmomj5+Ysl8ZtLrBmbM5/8qFTQ== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pSjRm-0008P6-MR; Thu, 16 Feb 2023 13:57:34 -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 1pSjRk-0008Om-IH for emacs-orgmode@gnu.org; Thu, 16 Feb 2023 13:57:32 -0500 Received: from mail-lf1-x12f.google.com ([2a00:1450:4864:20::12f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pSjRi-00052q-S0 for emacs-orgmode@gnu.org; Thu, 16 Feb 2023 13:57:32 -0500 Received: by mail-lf1-x12f.google.com with SMTP id cf42so3997680lfb.1 for ; Thu, 16 Feb 2023 10:57:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:cc:to:from :user-agent:references:from:to:cc:subject:date:message-id:reply-to; bh=mbtlVRbDB0PD4u20+P4o8Seu+37nT5UNkQYqcWeZzGM=; b=Z/l7bd4BVN0bqWZOrqzT5sSNftnrOhNVpKlZoGQhlhWcysv60CO3ux5caomokxCRyB WYuzZ2Za6WFQTIojR7uJYVCLMLq+t6jjnsMUQbJDcep8aqYS8X2SjRZpcoWKI93BADh0 9dlNaqcJHQwXIDvTV8gjTVQSr8gQ714oyYOdz3R060l3fds9ncw28JXZw2CQoVOdNcF9 B2YRWn4ZdOwOAiN7htdgsf+Lr2snhcmoQP/y/BBgF2XL7UBwFJXLTZjatMsvMxRQuKP5 JT/BYmKTokS01I7pqSFFz/QRGPkzHA3x95OikUWjQUrf6klt7s6CZxrY3y13l6H0QPmR bJHQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:cc:to:from :user-agent:references:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=mbtlVRbDB0PD4u20+P4o8Seu+37nT5UNkQYqcWeZzGM=; b=GZ/2MTI8ws4l05+MPfHrWx6oa2gvrQWCTAeriklY+sY2w/okktKbY1K8XwEjp+46gD AEGGq9vDadk2VdAGWdXB0hVHkzlgKnXN53P6JowrBmkhz+6RsrLWLsqbjLhwyZZmV8oW 9/hYrXgsUeg4WMuMMrCESaxJHbOelQYRaf1ao7vom5txADadG3XSqW8Bt5wNH9nX8Kbz RPAeeAGude9BtHFY3SfkT6aUKMbMtgw4l+vSnBMcUYB82nrLFRwTI61GtyyNs6/nVpQ9 B7gOKeu9ElN0B6tjVf/4aY0i2d6UnclQyHsmF6BlcCP91HUVxN/MPB49PbrA2jVeIZS4 V7ug== X-Gm-Message-State: AO0yUKWf2nypecBUtuHZAnwNgXjQg4VRlnks1B2dtDheljarBK9p2QT9 J35s9YeB4BB7Mj1tauSw7sCCdZpbmevzRw== X-Google-Smtp-Source: AK7set+wAYZkFz0LuWqTyyc6t9kO7X0lIDnNm4W1uB9yD5AVboZt/7LQABeRXFQ5jeHqkyFU50yBpA== X-Received: by 2002:a19:c20a:0:b0:4dc:4c1d:eec1 with SMTP id l10-20020a19c20a000000b004dc4c1deec1mr1318008lfc.46.1676573848241; Thu, 16 Feb 2023 10:57:28 -0800 (PST) Received: from laptop ([62.118.86.156]) by smtp.gmail.com with ESMTPSA id h18-20020ac250d2000000b004d865c781eesm391723lfm.24.2023.02.16.10.57.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Feb 2023 10:57:27 -0800 (PST) References: <87zg9ido76.fsf@gmail.com> <87pmab3qxm.fsf@localhost> User-agent: mu4e 1.8.13; emacs 30.0.50 From: Ilya Chernyshov To: Ihor Radchenko Cc: emacs-orgmode Subject: Re: Timestamp and timestamp range definitions Date: Fri, 17 Feb 2023 01:55:12 +0700 In-reply-to: <87pmab3qxm.fsf@localhost> Message-ID: <87fsb5xwts.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2a00:1450:4864:20::12f; envelope-from=ichernyshovvv@gmail.com; helo=mail-lf1-x12f.google.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 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: X-Migadu-Queue-Id: AEC5C16F43 X-Spam-Score: -9.63 X-Migadu-Spam-Score: -9.63 X-Migadu-Scanner: scn0.migadu.com 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-TUID: 1iKHxFpRUYTj --=-=-= Content-Type: text/plain; format=flowed Ihor Radchenko writes: > Updating the manual will make more sense. Would you mind writing > a patch? Of course. --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-org-manual.org-Update-timestamp-and-timerange-defini.patch >From da84673301de7e9453cb359536235d8ce56399f1 Mon Sep 17 00:00:00 2001 From: Ilya Chernyshov Date: Fri, 17 Feb 2023 01:23:27 +0700 Subject: [PATCH] org-manual.org: Update timestamp and timerange definitions * doc/org-manual.org (Timestamps): Document that time specification of the form <2023-02-17 Fri 10:00-12:00> is not a timestamp, but a timerange. --- doc/org-manual.org | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 2d38cf76c..5b6633417 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5915,12 +5915,12 @@ ** Timestamps #+cindex: deadlines #+cindex: scheduling -A timestamp is a specification of a date (possibly with a time or -a range of times) in a special format, either =<2003-09-16 Tue>= or -=<2003-09-16 Tue 09:39>= or =<2003-09-16 Tue 12:00-12:30>=[fn:19]. -A timestamp can appear anywhere in the headline or body of an Org tree -entry. Its presence causes entries to be shown on specific dates in -the agenda (see [[*Weekly/daily agenda]]). We distinguish: +A timestamp is a specification of a date (possibly with a time) in a +special format, either =<2003-09-16 Tue>= or +=<2003-09-16 Tue 09:39>=[fn:19]. A timestamp can appear anywhere in +the headline or body of an Org tree entry. Its presence causes +entries to be shown on specific dates in the agenda (see [[*Weekly/daily +agenda]]). We distinguish: - Plain timestamp; Event; Appointment :: @@ -5935,7 +5935,7 @@ ** Timestamps ,* Meet Peter at the movies <2006-11-01 Wed 19:15> ,* Discussion on climate change - <2006-11-02 Thu 20:00-22:00> + <2006-11-02 Thu> #+end_example - Timestamp with repeater interval :: @@ -5974,15 +5974,22 @@ ** Timestamps #+cindex: timerange #+cindex: date range - Two timestamps connected by =--= denote a range. The headline is - shown on the first and last day of the range, and on any dates that - are displayed and fall in the range. Here is an example: + Two timestamps connected by =--= denote a range. In the agenda, the + headline is shown on the first and last day of the range, and on any + dates that are displayed and fall in the range. Here is an example: #+begin_example ,** Meeting in Amsterdam <2004-08-23 Mon>--<2004-08-26 Thu> #+end_example + Timerange is a timestamp consisting of two time units connected by =-= + + #+begin_example + ,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> + #+end_example + - Inactive timestamp :: #+cindex: timestamp, inactive -- 2.39.0 --=-=-= Content-Type: text/plain; format=flowed -- Best, Ilya --=-=-=--