From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id ACOtOSteiWQmygAASxT56A (envelope-from ) for ; Wed, 14 Jun 2023 08:29:00 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id GAOIOSteiWR3UAEAauVa8A (envelope-from ) for ; Wed, 14 Jun 2023 08:28:59 +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 6B0F9380D4 for ; Wed, 14 Jun 2023 08:28:59 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q9Jyz-0004Lx-7K; Wed, 14 Jun 2023 02:27:53 -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 1q9Jyw-0004Ld-Rv for emacs-orgmode@gnu.org; Wed, 14 Jun 2023 02:27:51 -0400 Received: from mail-dm6nam10olkn2044.outbound.protection.outlook.com ([40.92.41.44] helo=NAM10-DM6-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 1q9Jyu-0004I1-Kv for emacs-orgmode@gnu.org; Wed, 14 Jun 2023 02:27:50 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EiOi78/tMXUW85f+B7zGBU6PR8lSTtjogo6PXRQTOVnwUjdWJFzZAe/lHqh3jcTGv6d4zG+1VdIl9FDca8xCBiVMD1aZzG+uQCKufVnptaWEScZfuInjfGwTVpJbuBgHAjon5/3UKsw3hUP6qNidRymXpqyl1V2bukBWnnb4TofZbhHKGeSED6RPOvfUObQm/Qw3zpnIXooVDXYOtUuq5d36MzqjeWRsognJAbYjy6A+VrK/3LQ86hmVy7LGEaSzcql3Lrao4bQLU0HhaIgD7+MH/F0NzJE/3TNC3tvtS6qQC6qgjnYMZSW0ESgvqTa9F0Xpeg9KqafMu4UqsGczow== 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=uWa5XTKaX7oHMi/PqF/cMwrZbNZcA4H4Iy4ywalPULc=; b=FETHgZWPApwlfdUG0Y7Q++466ekCNuIbzLoturlx9Ix/jw/Aus5P0XU5tNBWBlgo5LNYnOEBmn4pk0SsKP2ka+KMK5W59qCRGVUuxMMIg/T6nF7X4eOENxw5wwCdRpqFNWWetMhzH3LDqSKNoL8hgEi9DDKWUgFZNSDYsvW+MG96lC64m1jT722HKab6BiErPt7PedHvslxbkjgouYbVI8XNmiy3YMVPGFthgxO0yzAtFadL8y/FrtUcXH/iYDABRfDNCfFlWG8umj9aXgOBkIO05NXaT0ws0wLukwk+cJ/tP1DeZ0m9+TsUDLQc/8WAWFwcEGeHCS3CnRW7M/rFKA== 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=uWa5XTKaX7oHMi/PqF/cMwrZbNZcA4H4Iy4ywalPULc=; b=YySpCNVNWRoUlz3UY838xc9HKGmtnIgXiFGTSFQ5ZAu8wB8uu4oP7Mw8pDFY6Z7BLaM71J9H+9nSkfi9cWwCHBxwA+MO3H6lwM9CWDLl44vp2gbDejrBZAdwFonJ0dBKF8v51cJjKDS2lp2pkLIPZanPlwy+JMgRkoA7mw9clRtEUpx+dEmor5akZxXDiPBd4bgpmAHoLH9EITJWMPTrqBCgmF7Jo7DzQE6pOXHraJC/6mFmnU1XJYF0n1sdiI4hC/IoR3H2bZDXCDzB87kswfNnloqaOFfmV7U3cgLcLmYHOHYlDLJvR0sygvQw8pFjVtr949zoLmcRggvsleLpKA== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by PH0PR03MB5734.namprd03.prod.outlook.com (2603:10b6:510:41::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.37; Wed, 14 Jun 2023 06:16:43 +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.6477.028; Wed, 14 Jun 2023 06:16:42 +0000 From: David Masterson To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Is this proper time format? References: <87r0qplm9y.fsf@localhost> <87ilc1ktrx.fsf@localhost> <875y7y2qga.fsf@localhost> <87h6rh140j.fsf@localhost> <87v8fvtz1u.fsf@localhost> <87a5x6tjr3.fsf@localhost> <87legplzck.fsf@localhost> <87fs6vwvfs.fsf@localhost> Date: Tue, 13 Jun 2023 23:16:39 -0700 In-Reply-To: <87fs6vwvfs.fsf@localhost> (Ihor Radchenko's message of "Tue, 13 Jun 2023 09:41:43 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: multipart/mixed; boundary="=-=-=" X-TMN: [I/PZXAjky68GQqo+Skaq1sP09D3d03EWRyybNVxwR+k/fCFBEt8pueTDOx/9JkAc] X-ClientProxiedBy: PH8PR05CA0024.namprd05.prod.outlook.com (2603:10b6:510:2cc::12) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87v8fqwou0.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|PH0PR03MB5734:EE_ X-MS-Office365-Filtering-Correlation-Id: 36bab425-009c-4177-2129-08db6c9eebb6 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: +2bhInrKLQkrSODNSODnwAm3UREHASbmNXDms6I1ux/TKCASL/DxvAWyFz5O229YJexZMO3z+lCBChO0LD0zWDSM4+8ljstK+AFEsTAasjrGb3qby+8HMdVnMoVEp+CO0xGWdoULboUuMTVWxB6geHBkvjM4CXEWsg55YGqMFXZOhtNlNZZGSUS0BOZpjNFAKjJP/VQo0J+SGPH93QCxLZVVmScP90LQ+7tKgN1s2HcGTkXfTYor/s3XCGIgtwAf2nz2JG3+zT6gZ1HlritASvOIr++Jqrc5pgz0s/ivHgSvDm4TU6XvHPcZeeT8o84F8tGjK2q7zrHBxffd8J+wTAtZAbmKP+kXJOoNxiKt+JccC6QecbTQayW+8ci50VIcNZQdx4FAJDu1/tPnGiXXk1ofsRHk7sWjypk2SMhc4hWYi/lOA8ajcJf/41yH90FdwYrPVCxwuDfcckoZTclfZfCUsTlI1inUmXhLfmhKabndMLMV8cFVsecg1JOPnzAg536PLTD2S64s28NiQTSG27UR1JJoFqNEDs/KldruR1gFGzJ66WwGbenAE4CCxANQFlQOq9YbyztgaO/puTPnIrrnJ9DP9kgH0n9tk9pJa4QJIw3IR4B4JclguFLVuegC X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?ZLpyYMm4EahTO3KG5p+1LXuSiFqArgplJr5Y7pYVNeemBBkBJcAjXPW1eDhU?= =?us-ascii?Q?UekI2v49nrnPhRbAQSy1LFVEaUKOIfi86xTKcko8yuxpbi762Lvl65lDwTFS?= =?us-ascii?Q?J5vjoQ2gjWLF8GeBIUTU7NbgG5h4V1l7mZVw3AkjzyzbuQt7Cgzfe8GjgBFP?= =?us-ascii?Q?j0LZyq2WnIrD5spKqS1P9KI3vz558i4H4y3kafgByE8a+PTZrgr0IaeQ9feu?= =?us-ascii?Q?GmRP+yEava0Uc6o+4yqrgdLeHy2xu3fYINU6ZGapRXX9iOVE1G7HCeIdPiOU?= =?us-ascii?Q?ktJFydGU1e9YEzgmOaKk/fH/yn4trnYXyATVwikLPCCPW0FMA1yM5IfLBWSC?= =?us-ascii?Q?JybZ1gOm+co/M4AQ6T76NorWan6r3XOLqp81lU0Ubja08Mts9+GwDBHNGy9j?= =?us-ascii?Q?2t45BxhC0msnBakCbfZKMR5xMhhOe0z5aFK7n07fmfUnplLBYuKTgZysHUbN?= =?us-ascii?Q?K44uv1ChyL7LyKTpWO3kE8qveoE6dTAkZMmNYYJ6K6PKIe9j3zvjKQNG46u7?= =?us-ascii?Q?p3339veQ1ctEx1jsTz35s9YZJcaazowoFT0sF0/H5zUnkyVi/wh0ZM5QN5Oq?= =?us-ascii?Q?1YZ6Xu693m6X/ElQ+qkWrwrds3hrK4BlVKDhFNpb6rQ657iI6l4G21Zwk9iF?= =?us-ascii?Q?Bn/DHd7UZY2EWWP6yLH8HhtcrK196wjoIcBXkxdOOKt1jgqdnudUtPUAfkks?= =?us-ascii?Q?Xz5h5ak9pIwH2D27ceRvN1N/gJzkvas9Rq4oDTwrH+jDPVFRkc2RIyFrexyn?= =?us-ascii?Q?X9gcGtpkEBXTADYlVpfSkLxY35koJ8dHUPa6KC6Q3YysMTuGeLG2qfVsNb4L?= =?us-ascii?Q?m3APaEMD55/CIUyJJZt2xx72RHywTwSRB7vraW6rVWHgMgv2zwsl4F5FF+eH?= =?us-ascii?Q?fJ4X5tJCJT6SQpwWx6v6xEVNVj6y3A10kEEnVG3e5ajKNeqT4XDK0IiD/V+u?= =?us-ascii?Q?P9bULKdvBpmDJ8SOqOeQbK5rD/LeYZ6uz8gCbN7zUMXTZeXK9QwPBEmfIKtU?= =?us-ascii?Q?5ubLx7qa2cf3cpVxsUG8PwNRVt1X5H7gwHxJ/YVUKVZVjIy3hLL+QfHvbDor?= =?us-ascii?Q?sZFbAH9zBMbcKy8Xa5qDGyCEZUi8v1puvFw2hOLAlw+gAiLfF2UCH1oeoiI0?= =?us-ascii?Q?pKOcfwyfis1/y5FyPkPc7Bsi1T2Q34xXxvBiIy7pXfVVcktbiZ5trvmxElYu?= =?us-ascii?Q?fqMjPACty8cPBXUjdc/Ivyq7hAmVioBcvnYGukCYjz3EgfSqyf1QZlezoBcv?= =?us-ascii?Q?CeVY0rxEbIgrlbKPY5tlpN4lWFgbSOdcowZYxoeOxolcTK5Kiiz4Qm2KkvY1?= =?us-ascii?Q?0A6ynaLVrDL1FVMVf+gaABv6?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 36bab425-009c-4177-2129-08db6c9eebb6 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Jun 2023 06:16:42.7294 (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: PH0PR03MB5734 Received-SPF: pass client-ip=40.92.41.44; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM10-DM6-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.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NML_ADSP_CUSTOM_MED=0.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, 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=1686724139; a=rsa-sha256; cv=pass; b=sz7ccM6yU9rSQuIwGLbr3BLoJB8rrStkNlJASMykgRGePffimIX2AOdZPnrW8laFOcplxD oN8D026PO7k3qK9mGbE6GlEc7q3pCHFiaMgVmBgz+6ycbVwzX4VYBZ0ddJmFxLI2WeNABK cszq2lHx5Jl0ObVXWYDdZrpcxN/ZT9XTJibZycIj3IiZgKvBCGs8nJJBCd94Wq2H0jscxt nzNDOouXsLd16zBMtOVOY/i7gDGh7m+RpK7dArsZ70yy8GGfXrGG9B10k8DVddOZEZ6Pkm v5PDY12kyz01PoEwIpZZelASjNPFuJhaA0nSpSHaBknxcqGdU1zEjGcOPK7wAA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=YySpCNVN; 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=1686724139; 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=uWa5XTKaX7oHMi/PqF/cMwrZbNZcA4H4Iy4ywalPULc=; b=fWT9HU6FJ7YsYr02Ogn+ZZcOM9gxJu18El53mUfG817LYCb4aTfKwNGMcOKESbhhU/9an0 Tp9pg6WVfwoLySj8bK30/jy79S14NbuT/LjIOm728hqmjoEC4ZrUniQfSR/4nQxIwTuMQe 8V9iVpDZ2Qqw1RMHnlN+9kvX2zKui8Y9VVBcolMhQgwTSyI9ekjsBepiRMw6KrdVHEo30F X++nsjK2tGWrCz2DeblFTlQnE7s3/iDUwOn5DdoL/c3YZb2UjoIz2zr5XONysoTpnvCcq3 2Ejn4ngUqQsJvx3kl9+8Lc1GnAVwbvJHN8CCxqB58gVWg/JUD6sb/nqZiNc92g== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=YySpCNVN; 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: -10.77 X-Spam-Score: -10.77 X-Migadu-Queue-Id: 6B0F9380D4 X-TUID: NGYkhETI31+e --=-=-= Content-Type: text/plain Ihor Radchenko writes: > Would you mind updating the patch? See below. > If you do not use magit, you can easily re-create patches for a given > file from Emacs using > M-x vc-diff M-x write-file /path/to/your.path I do use magit, but I'm not good with it. In particular, I wanted to walk thru my changes with EDiff, but, when ediff brought up the buffers, the buffers were in org-mode and everything was folded and I didn't see how to tell ediff to not fold so I could see the diffs. 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=patch3.diff Content-Description: Change for org-guide and org-manual diff --git a/doc/org-guide.org b/doc/org-guide.org index 95828e4c0..3a19027ba 100644 --- a/doc/org-guide.org +++ b/doc/org-guide.org @@ -1080,7 +1080,9 @@ Tags and Properties]]. :END: To assist project planning, TODO items can be labeled with a date -and/or a time. The specially formatted string carrying the date and +and/or a time for purposes like a timestamp on an event, a deadline +for a task, or clocking time on a task as described in later sections +of this chapter. The specially formatted string carrying the date and time information is called a /timestamp/ in Org mode. ** Timestamps @@ -1099,20 +1101,24 @@ 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 event. #+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 :: A timestamp may contain a /repeater interval/, indicating that it - applies not only on the given date, but again and again after - a certain interval of N days (d), weeks (w), months (m), or years - (y). The following shows up in the agenda every Wednesday: + applies not only on the given date, but again and again after a + certain interval of N hours (h), days (d), weeks (w), months (m), or + years (y). The following shows up in the agenda every Wednesday: #+begin_example ,* Pick up Sam at school @@ -1121,8 +1127,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 +1136,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..3ec9bc10b 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5978,10 +5978,11 @@ 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 +and/or a time for purposes like a timestamp on an event, a deadline +for a task, or clocking time on a task as described in later sections +of this chapter. The specially formatted string carrying the date and 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 @@ -5993,16 +5994,15 @@ is used in a much wider sense. :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 +6011,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 event. #+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 +6056,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 --=-=-=--