From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id YFDeArUFjWQS9wAASxT56A (envelope-from ) for ; Sat, 17 Jun 2023 03:00:37 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id gEgWA7UFjWSpWgEAauVa8A (envelope-from ) for ; Sat, 17 Jun 2023 03:00:37 +0200 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 812D837092 for ; Sat, 17 Jun 2023 03:00:36 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qAKHv-0007L4-90; Fri, 16 Jun 2023 20:59:35 -0400 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 1qAKHu-0007Kv-BA for emacs-orgmode@gnu.org; Fri, 16 Jun 2023 20:59:34 -0400 Received: from mail-bn7nam10olkn2082d.outbound.protection.outlook.com ([2a01:111:f400:7e8a::82d] helo=NAM10-BN7-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 1qAKHs-0001eF-4Y for emacs-orgmode@gnu.org; Fri, 16 Jun 2023 20:59:34 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=CWRxEBwf6EUfiEeUwjeri68+FGZ3mSuwlcTCqgLYqIjcSCGFvbBii4w19Gi+qiduoPmweR8konilR2eTML5wkyIbS2DNQRFhdLsTf0dZgHsr/dVInFjXxpRLqbQ2xXjRhXLEnVOFqDAsrWqqulvWaD/kf+PnZdXnKBQ7+voLL47q3lmUCY9YeDOwA5hW1QL7a0ysT0blUMD8S63yJqieo7vSNJj8GSmCeDwg2LyQlc5A65QRcwtWY0pzWVGZKpX1kpND8ntRJ/TbFY4hDzuNEyONXIQ204uekbtJdQJYl/puxhLMPMqGtzbEx2CyzsvNVO64rimq40E62+dzvhz7BA== 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=ioje2HKIvMutVVwmC0Rrd6P9zudFDgjKDdqjcCtR7yg=; b=IVvnIkofido8NtjPp21X7XeJn729ZZZh+pm59JY2W46UMJ/NSEajD+tku2gPqkyUksedbuRdof4sDFh/N89H+iTWpe+Ln3BdW4KozsLm2ihXs99AP2VNJ97kqaaMst33NXMr/CIOqOrGhEgLLDOjGbR/YQ5l+0qSo8qugwTizJsQ/Jp6zbRogRpXVS1VH7fxEHXX+c4BAruS0W9wVwu81kg2OVLqFi8uFqpYWqjfjvgVOzaF1rmYmiEvglwkPCoReInwsY4ZtlUFl0H6ibYP7lXuH48etm2lsDdpRMBK2ByDP1lbDBO7wfl4SbBLG2RRYt6OYEKgrRrhJZ7fSnVNEw== 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=ioje2HKIvMutVVwmC0Rrd6P9zudFDgjKDdqjcCtR7yg=; b=H/LEvKfHFMVP0JZ3mCpRtZLxgp6CW44caWpUwLdrLxInn7jLUB7L6YMbmNNVcoXD8B8Dk1IwXRB7k6HO713ZPWAHMlQYCtha6UMZTkcjjEmX5o6CDz1u5AbvnytV2/4rUOGQMCjcfQGtpD/6uVBfRhfH4fwQZVZUeYosgT9nKkeZx1hjSGFMYdtxIlFPR9C+oFipXiOHcbN5jVOhIJzGS2I4Go6VSwHDdGMRtIUqGp9cOvWhSV4fGYbv7OSSridYDOrBf5y9yYKT3zbZWN06GVwk+NcZQNB/YXMAormpiZnCc4R1ucKeJ2MKlLM/2OHUjoRtFsOkbSJAuYJaYZ30wQ== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by SA0PR03MB5546.namprd03.prod.outlook.com (2603:10b6:806:bb::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6500.25; Sat, 17 Jun 2023 00:54:35 +0000 Received: from SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::34a9:d9f6:b659:70d0]) by SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::34a9:d9f6:b659:70d0%6]) with mapi id 15.20.6500.026; Sat, 17 Jun 2023 00:54:26 +0000 From: David Masterson To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Is this proper time format? References: <87ilc1ktrx.fsf@localhost> <875y7y2qga.fsf@localhost> <87h6rh140j.fsf@localhost> <87v8fvtz1u.fsf@localhost> <87a5x6tjr3.fsf@localhost> <87legplzck.fsf@localhost> <87fs6vwvfs.fsf@localhost> <87zg528fzv.fsf@localhost> <87h6r9rnkz.fsf@localhost> <87cz1vkaqq.fsf@localhost> Date: Fri, 16 Jun 2023 17:54:24 -0700 In-Reply-To: <87cz1vkaqq.fsf@localhost> (Ihor Radchenko's message of "Fri, 16 Jun 2023 09:38:37 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: multipart/mixed; boundary="=-=-=" X-TMN: [49N0Kdti5mA/qeGoCl+rzSK2VMvFcmRwmMrOBvHRyBI68Mj1hjOFGZ9P1QGswprj] X-ClientProxiedBy: PH8PR07CA0030.namprd07.prod.outlook.com (2603:10b6:510:2cf::16) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <877cs2q56n.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|SA0PR03MB5546:EE_ X-MS-Office365-Filtering-Correlation-Id: 22a608df-bc99-4a8e-606d-08db6ecd6612 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: szoiq57Z/sSI2qHwhgLh7KfgiDrxuJ80YlnHW9xxXjzi8pin69LaZMhUp42RNprjHD7zPVF3Y95yae7BeLGuB1mxgMu+XL+ErzVoNuJhD1P1QbobBHxeelTMW3rbqkB21VxXfHbELpzLKnry+UwxHYF1P5HZ1d/4fQVGD0wUtyCI2tRVldbrPJ7rUzCJkGkpVsejq38UiW9YtDq2xqe47TAQ6tOk67kji2krOWDhrKBkOwioVRDXbqQENFoRhUijBC7ONbTwfgd2dNGvXaODzfuNYdmYARWnmHjJs0WTuzGaGQhFRoBN+sowQ+UpkLYZL6TCSWEVO2HCUF+p9hu4qLnfIEaB7XddkNg/n8xEFqFKAjqBn67A58wHBBiDHiRCQxDX/DHTAMbGffwE1JOfgmXtNe3K8MHqPLTdpk02sM3RNjtG2AsEd+CYCQaUbV6jT5/CtCU1sQaBARp/VvC00sjKGxCjDK1LcOCm/Nnw7ZMBlQslhhlyDR9+Ex2XOEIy5FeXJNW98gKtC0WQLT+spoVhwp03T70DrXzdhwGJlxvZE+sv7WlTwjYVvBM/F/rR+RwkfCHQb+3bOzF/AIHq65mjenZHIiFoGlhY1KASnkeE689l18vdFRR8SR3QGJox X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?06PAj+xKJaEw2e4HEtRhiS2UYcKWT5XlY2yN/WjHMeLoDluu6EBur6z9fgUp?= =?us-ascii?Q?VrWDsuvqMnNB7s2DBeH2qO7JanR08L/hkpHcKWB+JkI+A8cr6GN/0jl1sknQ?= =?us-ascii?Q?3iZuouQCdFieNCxYCW/nIIJNpImFLphqBuwgfX3vvhrQc/owaLzJCVhe00IR?= =?us-ascii?Q?vr0mTcRJdLQbVvpSwL/Tm/X7PMK9K73l3kJ6xP97OHgaKLnGALDwyCNTJjMt?= =?us-ascii?Q?77gj5TJIZTVZRlTpfdE/Y8d4igUWcgut7VxAC8NCZUmlbFpwbQxKNWaSDzI2?= =?us-ascii?Q?TABjfy9m6wr31xtlLfzMncN0PCuUqjqTQTfMuDjzRDVZrKSHL754D/3bT5+3?= =?us-ascii?Q?CBkvl/AdW070F6Yo1L7iMSKCkmeHT/fRSTozZZLNZJpLLOt8mnU+aY9TuH8S?= =?us-ascii?Q?/UPv8D4Z8sSDAD0UUQaFlyovK3mtWRgd42pCDs4IUk+erXdTNJORUZhx//ef?= =?us-ascii?Q?O5Vhgj5FOc7xjoyPitnJ5ig/W/DY6x8JuTo5zgFkxtxrdBFs6SS8IHB8ADfS?= =?us-ascii?Q?o5vCPMmbxdFUj/aalPuJ/RWGg4Cp0399GS6I+4JvHaU7o+kRpt2ejU1FNWvX?= =?us-ascii?Q?GBOr5mjE9o7xVHV+8QNOJGx/QsEiCevtvQW0IG3FSMkVDqP4xcWWI+Pzjid9?= =?us-ascii?Q?VjLemHlMXmXcuKDyhj4uqSV78wWpZyyYMNl45x1kbKRFgPvcXGI2yi4/S2fW?= =?us-ascii?Q?M2Z4FlZtujT5cbnh1V/sU86g0YovMH0SzV6GNZ3ewPEdz4/qZ8CVC83tOVDi?= =?us-ascii?Q?/7AwWVhlgqVMmHWloRYwdMGS4eeG4ocXxiMDqo6pGJBwRoXWaa8OUKBnqLjK?= =?us-ascii?Q?OnFaI7cdmWzaoHasMXFg0a8rTYzkJcNNeIir3RC21Kh8XVP6i4Ms2spY7Lri?= =?us-ascii?Q?czO+DC4IYTdC1vnL29/Qg7Sd95noZ8L6ubpTDas9Jwkj9xgj8+DriTaJ4OVI?= =?us-ascii?Q?Bsjhb6W7/XHIodm+kcmFTI86Zrt/UaNWuRD09yjr0vloEXCWrhlLc46c18ow?= =?us-ascii?Q?MNYFoT4hkFfZjKXXssYhD2X6CH8wploTZ+oo6KQku/7Uau8cRVETke0Yt966?= =?us-ascii?Q?J2gxHtkL6xRSgQLTooGwZm5pUCxIEXDxqALPOmMXIMfTa4aDww17ULHlOFj7?= =?us-ascii?Q?l/p/KrUQL0x4VTS2NcWOxHKwG5wbtmI7kS2gVFvNmGtkkIC6lHFPHB8tN6bo?= =?us-ascii?Q?dX3bmOcG+hihxaoR9PNml3oz7yjGw9kb/nD1XMScue1vQQyosUVLfFyPe9uA?= =?us-ascii?Q?CnbictArrnnagDYB5Q80v5eWyHhhA++g9I9n9Uhxei254VjIlBl54mUHMkrJ?= =?us-ascii?Q?OAcHVaX5FZx4vn12MA87RiQV?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 22a608df-bc99-4a8e-606d-08db6ecd6612 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jun 2023 00:54:26.6323 (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: SA0PR03MB5546 Received-SPF: pass client-ip=2a01:111:f400:7e8a::82d; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM10-BN7-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 ARC-Seal: i=2; s=key1; d=yhetil.org; t=1686963636; a=rsa-sha256; cv=pass; b=MZoVi/6sPc6XKVKqfe6MDcKgnI/YUrUgbYHE7GUZ6TcxHr9mMgSzEz9oAVSMWgg92ZsRin e0cdMsKwGa1zejF+kHKmeu1J7anthsTNEfcN42tVEYPxjxJ5KpBTER1FFyiG+H2vVIuA7j 11kxu4PreaIyZEQA4GXZRygXl9R+N0k6BN4AuM16iZiY7NU4+/r3ZHZqF3iLi9DI4E8wzj 5z5S0PqLUJ/OYx6FP9QEWaq4kGeOfL5KebYsyBp46WrxtEIEhse0/5jjVmdtqRaE/NTqR1 4bQ2M2IpFd3ztLyWUAfJomCuPwoUaDWdJtl0t/5aq2n7SwYT17SYQPbZddD29A== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b="H/LEvKfH"; 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"); 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" ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1686963636; 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=ioje2HKIvMutVVwmC0Rrd6P9zudFDgjKDdqjcCtR7yg=; b=pokSPt5EuDXCIIjyvff0ihOqvNjM/EHuZtBqbBRKJB9uZEfpm+3ajfMArUqnlEr7B4v7h3 EJ7ZBoSP5oxPRrQf3qHlBt7FDvat3IWZLwG8afljCuB2SPGKReb9AzqMXfbb7Y+wpbBuk7 mUVyIvYPdTWa3Iw0gczaCBmv+DUacMxWA1AKQ2zPhMzQh0keAMOp5E3QzXeI7URXBrRdjg 0MoZHvP4G38GOaOzMxnDfNo8/wYya9EAYyCzQj06zuH5ZpKGYU2V+nHJ0PtNeEWbOiQJzk 5gUXdYmMnN2AiggDVupPJYOq9tAYgFmvlmNK18LdDjoWmRCzK4ON4rEvM0EOjg== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b="H/LEvKfH"; 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"); 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" X-Migadu-Scanner: scn0.migadu.com X-Migadu-Spam-Score: -7.78 X-Spam-Score: -7.78 X-Migadu-Queue-Id: 812D837092 X-TUID: eMh3UgCAQmgj --=-=-= Content-Type: text/plain Ihor Radchenko writes: > May you please re-create the patch for the current main? Ok. See below. Minor question -- I've used Ediff in the past, but I now see diff-mode in Emacs. I get the idea of it (I think I used an early version of it in the deep past), but wonder if I am seeing a bug in it. In the diff file below, there is a few mentions of "=--=" in separating timestamps in a date/time range. When I view the diff file in Diff mode, a couple on those strings show up and a couple do not. I had to check the file with 'less' to make sure the diff file was intact. Switching from unified to context view didn't change this. Am I missing an option in diff mode or is this a bug around handling this particular string? Change log: ================ Doc change to explain timestamps better doc/org-guide.org (Dates and Times): purpose of timestamp + examples doc/org-manual.org (Dates and Times): purpose of timestamp + examples ================ --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=patch5.diff Content-Description: Changee for org-guide and org-manual diff --git a/doc/org-guide.org b/doc/org-guide.org index 828bdd872..a6d4e7c3d 100644 --- a/doc/org-guide.org +++ b/doc/org-guide.org @@ -1081,7 +1081,15 @@ To assist project planning, TODO items can be labeled with a date and/or a time. The specially formatted string carrying the date and -time information is called a /timestamp/ in Org mode. +time information is called a /timestamp/ in Org mode. This may be +a little confusing because timestamp is often used as indicating when +something was created or last changed. However, in Org mode this term +is used in a much wider sense. + +Timestamps can be used to plan appointments, schedule tasks, set +deadlines, track time, and more. The following sections describe +the timestamp format and tooling that Org mode provides for common +use cases dealing with time and time intervals. ** Timestamps :PROPERTIES: @@ -1099,12 +1107,16 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: A simple timestamp just assigns a date/time to an item. This is just like writing down an appointment or event in a paper agenda. + There can be multiple timestamps in an item. #+begin_example ,* Meet Peter at the movies <2006-11-01 Wed 19:15> ,* Discussion on climate change <2006-11-02 Thu 20:00-22:00> + ,* My days off + <2006-11-03 Fri> + <2006-11-06 Mon> #+end_example - Timestamp with repeater interval :: @@ -1121,8 +1133,6 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: - Diary-style expression entries :: - #+cindex: diary style timestamps - #+cindex: sexp timestamps For more complex date specifications, Org mode supports using the special expression diary entries implemented in the Emacs Calendar package. For example, with optional time: @@ -1132,13 +1142,28 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example +- Time range + + Time range is a timestamp having two time units connected by =-= + + #+begin_example + ,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> + #+end_example + - Time/Date range :: - Two timestamps connected by =--= denote a range. + 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. The first example + specifies just the dates of the range while the second example + specifies a time range for each date. #+begin_example ,** Meeting in Amsterdam <2004-08-23 Mon>--<2004-08-26 Thu> + ,** This weeks committee meetings + <2004-08-23 Mon 10:00-11:00>--<2004-08-26 Thu 10:00-11:00> #+end_example - Inactive timestamp :: diff --git a/doc/org-manual.org b/doc/org-manual.org index c11694849..e0c100474 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5978,7 +5978,6 @@ or a dynamic block. #+cindex: dates #+cindex: times #+cindex: timestamp -#+cindex: date stamp To assist project planning, TODO items can be labeled with a date and/or a time. The specially formatted string carrying the date and @@ -5987,22 +5986,26 @@ a little confusing because timestamp is often used as indicating when something was created or last changed. However, in Org mode this term is used in a much wider sense. +Timestamps can be used to plan appointments, schedule tasks, set +deadlines, track time, and more. The following sections describe +the timestamp format and tooling that Org mode provides for common +use cases dealing with time and time intervals. + ** Timestamps :PROPERTIES: :DESCRIPTION: Assigning a time to a tree entry. :END: #+cindex: timestamps #+cindex: ranges, time -#+cindex: date stamps #+cindex: deadlines #+cindex: scheduling -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: +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 [[*The Weekly/Daily Agenda]]). We distinguish: - Plain timestamp; Event; Appointment :: @@ -6011,13 +6014,16 @@ agenda]]). We distinguish: A simple timestamp just assigns a date/time to an item. This is just like writing down an appointment or event in a paper agenda. In the agenda display, the headline of an entry associated with - a plain timestamp is shown exactly on that date. + a plain timestamp is shown exactly on that date. There can be multiple timestamps in an item. #+begin_example ,* Meet Peter at the movies <2006-11-01 Wed 19:15> ,* Discussion on climate change - <2006-11-02 Thu> + <2006-11-02 Thu 10:00-12:00> + ,* My days off + <2006-11-03 Fri> + <2006-11-06 Mon> #+end_example - Timestamp with repeater interval :: @@ -6053,24 +6059,31 @@ agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example +- Time range :: +#+cindex time range + +Time range is a timestamp having two time units connected by =-= + +#+begin_example +,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> +#+end_example + - Time/Date range :: - #+cindex: timerange + #+cindex: time range #+cindex: date range 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: + dates that are displayed and fall in the range. The first example + specifies just the dates of the range while the second example + specifies a time range for each date. #+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> + ,** This weeks committee meetings + <2004-08-23 Mon 10:00-11:00>--<2004-08-26 Thu 10:00-11:00> #+end_example - Inactive timestamp :: --=-=-= Content-Type: text/plain -- David Masterson --=-=-=--