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 ms9.migadu.com with LMTPS id AMreBjNfh2S+2wAASxT56A (envelope-from ) for ; Mon, 12 Jun 2023 20:08:51 +0200 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 sL/UBjNfh2TQmgAA9RJhRA (envelope-from ) for ; Mon, 12 Jun 2023 20:08:51 +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 C2211AB96 for ; Mon, 12 Jun 2023 20:08:49 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q8lxA-00088q-2Q; Mon, 12 Jun 2023 14:07:45 -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 1q8lx8-00088d-4I for emacs-orgmode@gnu.org; Mon, 12 Jun 2023 14:07:42 -0400 Received: from mail-bn8nam12olkn20825.outbound.protection.outlook.com ([2a01:111:f400:fe5b::825] helo=NAM12-BN8-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 1q8lx2-0005il-PH for emacs-orgmode@gnu.org; Mon, 12 Jun 2023 14:07:40 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cR8oEDrEvXhMKr6tBesk4EAbgm48mBeUjdYsGCkC508FPlS8uNHpCVXn+qAe+NHz4KMLj8h4nABUVaDBZq4+WJ2+/rlUy40bn0d4vadj0nY7PlBgxmcXQnEa9D4a4quBpHuWgb9JrRIrKVqlK64tdb16ZAoX2rCRItQkJ0Z0fLuVzVzK8XsvfnLy9r2nU2Th+udejcozn95MuIIFRegGQaARskUKU/PYtwsyiOzA849VE61cAalsTStMOuJZ9DSrM41C4CoC9f4+VTOgIMeVqrrvHYYTYJ0KhRV/ctcludNd7S0t2jtZpCPCCqC8+yfScUzAlJmrE2GmPpwDy7UHmw== 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=ZxMcXpT+g5yeWo0J6kFjNYJl//GQMepo4E/M1PvIoO4=; b=GlLF1e8Pd1p3mP4/ujCtYZW+L63TrOMp72UY06Lk7RSrvoMnVeuhImZY5z7DDhinUX8DrDI8yw5Ag7B3JT4WnPSZ1el+wFUMQdJ0MAq8178BoeRADqJtI9yt5CTnSCqqEnsl8dBr6ozQj9utIkkaJlxN8uJGRGubo+sgTCpQDEgHNRMvmf65sePLrOr8cWBAsDiQAVyvvufoj4zWS8y4HSbfYsVRnrX7x/u99jaMZHK10YbXmUyWgbesM2lZUFptZd+FT3Q4oQ9AHA/r7cQk01mZGP2xif8C8JQyWORJaPbWCRvpDA7LvV+L355QOx1ahYoVr+AYElhNzpHFZMG9Ow== 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=ZxMcXpT+g5yeWo0J6kFjNYJl//GQMepo4E/M1PvIoO4=; b=BZSJfalpv1fGflfb/1KiQKTf2bAdCzjPNhqz0g18G8pM75tt5nKpCZEPHrXP/4BklesoF5w+3ieF61Op3E3KIa7YZeTsCnRGaSgCZX/3PbKDBf3k5Z4KJXOJ2fIDmmPZivUvd0+udoyg9gk9Q8oxFQklfFivorKFn4VX2LruATw9AQqxACrH9qfzjummLI2cil1zjC+2ZbiofqnTUNGA5IApnkyStvZntTDD0D14lEfJ98Mq8M8PqWin61wCOsinQL4RJK9I4xp3CVJHinuhEr06Y12GmFUcMT1mImcoW7hWBTT4cSNclvbaqGZwUGYDQkIzEIX2t8q9qc3QtRITcg== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by SA1PR03MB6449.namprd03.prod.outlook.com (2603:10b6:806:1c0::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.46; Mon, 12 Jun 2023 18:02:31 +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; Mon, 12 Jun 2023 18:02:31 +0000 From: David Masterson To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Is this proper time format? In-Reply-To: <87legplzck.fsf@localhost> (Ihor Radchenko's message of "Mon, 12 Jun 2023 11:00:27 +0000") References: <87r0qplm9y.fsf@localhost> <87ilc1ktrx.fsf@localhost> <875y7y2qga.fsf@localhost> <87h6rh140j.fsf@localhost> <87v8fvtz1u.fsf@localhost> <87a5x6tjr3.fsf@localhost> <87legplzck.fsf@localhost> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Date: Mon, 12 Jun 2023 11:02:28 -0700 Message-ID: Content-Type: text/plain X-TMN: [Nyo0bd9k7AKmHHcw5MQ2wHIvV4bSU8PMnqNOwKkC/BnlAMKnYZdJai5IpdCVDoOb] X-ClientProxiedBy: PH8PR22CA0020.namprd22.prod.outlook.com (2603:10b6:510:2d1::27) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87h6rcftjf.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|SA1PR03MB6449:EE_ X-MS-Office365-Filtering-Correlation-Id: 8a5bdb10-077c-4e6d-6f27-08db6b6f30d7 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 8zVeN8bz2JLTf7/iVtKWBrUUICzG5ULErJY2W3TVXOg+QfnkG1PjxZy8pKH/Y0Vp2B0AuUJqg+PsojdtQDc6Wi5x0nZPLKIeoqoZYKaJeZr7qibA4NRwzDmFRGd9W4m45zSkUYecg2apsj00yY59msNWEBv95zdYjXtfqEh2vxS0wpJhCwBXmgWgodQP74ntYvp7pukLaRaHyRsSQwwWQoA/SG1wKbkDv+BT6fcJf6hUzwwHb65ekQz177uYaZUECgOOCJVyC0dcPjKDcxy3rEPTX3fAZxFYL3kHJfx6vBpUWcd3bsvgnjSt2pCB1gFhabwo5E36IAm1N2PSFHBtca3Ifp1YujndXGecGqNNYCtRZNskmhWLSZsVOkOdmsCWVoTNwE6agLDZ8WleNT0kG7RxAwqJhMGn0Knl8tz6blpd6MwcrUyUL/KKx4i1G+UwKto15MAJ1P9K1bkEEyjswTDEyG6VG8nX0YOJ/jhC4SVAoTuEvah7k1CdlZQTMhKfzb3KiWjiyinxg3+VffiGjyW7mJkvL53R9uBYzFbGMGIWWdN79Mw3dN8enBGnNdCNc3FFHIlx6XzzqdqUqMzzNtDgyepMw/0awSwUtN4vVmPdD3PVOVuA99Oo3kvBSXo4 X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?rX+bMPY7G6+lw3v/UGhy0KlRyCyA4a+pQ+07RpKtbH8/SsHHmOZgicAisMBL?= =?us-ascii?Q?dDKcjhBZN+NQH7gv9oRT7b0Le5+IwmQmmQmhRUD8VkbO5HukNsB1x18XGq8j?= =?us-ascii?Q?A9dSkNsGITN+4A+f/cIdic2cJrYdiHO0wwSuFSqwRRFYHs3ZGgiGjNjVE0tF?= =?us-ascii?Q?uxVKwgmdU1FfEWTNoE6PuMfrkiZVIsci7vjN0SJfJIo6hSXVuXUMuvl3Y/Cg?= =?us-ascii?Q?3NHLWtsftM8mbXNJquu4ZM84WKWZhHgzpcu68TRg5foV5JPThClDjekAozWj?= =?us-ascii?Q?emqdzLbZVyNix1mxn9d6SXLEHsBjjdJSBWzIhqetyCPdYVt51XhbjTW50MK0?= =?us-ascii?Q?v08XiD/mW66rLoFrjUldRcMqUXNqMq4r60s4Z9bapylVG95TPOJUIMs13xrb?= =?us-ascii?Q?IwXd8UpuUL6jZdj7nJDj6/cWryBAhvwku7KgPMRDp8VS7ZXEIjGklgfQ8Ef6?= =?us-ascii?Q?TnrlhPERYv8aVQAyKOzjkw6BlvgQDC7FzOk+ks4wAvqCqj8bj0QWaotCyrbP?= =?us-ascii?Q?ZU8A3FkJkKOSTv6dRefJ6NL23rwDzwsOq4n+8yyDswPdM6JDVX98JanLu3Ir?= =?us-ascii?Q?WVDDd//iNb6MhONX3Ha5GJwIleSRc8MZBXm06wUUtFnQntWZi1pWh53xDSqv?= =?us-ascii?Q?/mRqc/LamWL9sXNV48h73bBxlQSB80MXq8nVhYOewyDAybqynXv07Myhsmf/?= =?us-ascii?Q?68jCPML1tJ5Oqq5nt7+5KNpX+E2FW8a9UjA6uXUrS+KaNSTlA9Wb4KoaaWDg?= =?us-ascii?Q?Gl2D1mCxfMrWuLLscNKfkmEmWgadVbtGUaHXr4SdE2utzKULEL7ycP6DGl4/?= =?us-ascii?Q?2OdIKeJU5O/vSBvckG88f2PoGvcSOnBh2v/hr5gJZVpxeHydLgwoMcT+213R?= =?us-ascii?Q?6murC5RhZeKCw/tGLrviSpt5C0OWR+lmTNRMNBB91i7EkCnptKAC60rhTqRk?= =?us-ascii?Q?GO49BmS86EBeeAX8D8WWX3pBn7hq3wd6ASk4OLFtZP8AhI2QMlNOun1bxOoR?= =?us-ascii?Q?v8FTrobGcZTpOKgU1SYDe9HTwwT3E+x43l1fBeb91pw+UQJRn/9hLakvgULb?= =?us-ascii?Q?MyQ+YAfVttdMcwzJdFQe2fOZbETP/uaYzlZ/wdGWnXQdoolbrAJzAizXOYdN?= =?us-ascii?Q?1IZC8SAC/Rn5nfjOwvVJETx/iSv3ClhBBwr3J98Z9TQlUaSX16RzgQSqTl20?= =?us-ascii?Q?9qYTVIbiw3oUMAa+VJDs9UKNLzfY+GSgLloG8JebHKKcU4P7Dwwt6BjO/roK?= =?us-ascii?Q?NyH5rK+wqxea51px7UHQvzL6VXHHp6LgSc/TiWQEIrcrWCBkAVZZvxuEhb7t?= =?us-ascii?Q?v/fozdEDtJpnWkwHbKcc4qFc?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8a5bdb10-077c-4e6d-6f27-08db6b6f30d7 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jun 2023 18:02:31.3293 (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: SA1PR03MB6449 Received-SPF: pass client-ip=2a01:111:f400:fe5b::825; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM12-BN8-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=1686593330; a=rsa-sha256; cv=pass; b=JhTUvKx7n/TnKkboBdZ5ZF1vlEnkk6L9fbG4ebwKlH8FdsC8ufrDZAWfRAgrPNqsmdHmKL mu1ws7FBSyjmwcZ9ZlNHFK72KysEu2v41YeM2Bc00fa4FFoFHwMTlu01mRq0kCw22yqIqB FlKZZn7sN0QXfmheu4hnD+ENeqEtNGyqMkPpOuYCmy7jXnsevV827eJTdMJzBhajs5My5B egpg4LvNAVsSj0FvAvWxNslPyF1a1zqtkcGveNYs1iifCaySSZngvIAf7coCFV3KDJ8VcY Z5W6x9tXZZCRY48y9gnyBO4SUJNC47helXGpzbjZJx2XTsY3vw+HW5idRXhpnQ== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=BZSJfalp; 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=1686593330; 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=ZxMcXpT+g5yeWo0J6kFjNYJl//GQMepo4E/M1PvIoO4=; b=ONJzGz9aRE1Ygh/1M3wKSJa1GNo7WZ3q/ldSDaPiOQM9bB4ePaRK9zmRmIdMSqPrPi4Cmb vz5iwcCvw9GV80qaZ0i2r4JllndvMXsYIn0B9jfJGIfGxGXkPusl6W93F7PXflJ/uEk4YK iNEzsYDhXo1ShcqqOEfmELRJ+owvZ8g8iopM7tlK5Cd0DrvQqjKayIq6i6+vAFTHdGVjQY H5WL+eTQrf/7bJmwQE2Grew6Mmmd51Hv4NkZJeJZwuo6OPDdU2lFD3Xrz4OkTokOo+9y8h /P2+rG9zYHgiEDts3/4M4xM286/F3kpZkJrpLWYpt7OtJC32R5m7EFM88aoh0w== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=BZSJfalp; 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: -5.76 X-Spam-Score: -5.76 X-Migadu-Queue-Id: C2211AB96 X-TUID: Y64Gxfhe4k+P Ihor Radchenko writes: > David Masterson writes: > >>>> -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. >>>> +To assist project planning, TODO items can be labeled with dates >>>> +and/or times for purposes described in this chapter. The specially >>>> +formatted string carrying the date and time information is called a >>>> +/timestamp/ in Org mode. >>> >>> What is the purpose of this change? The updated sentence is rather >>> confusing, IMHO. >> >> Mostly changing the statement from singular to plural to imply that more >> than one timestamp can be in a TODO item (SCHEDULED, DEADLINE, multiple >> plain timestamps) w/o directly mentioning how (leave that for later >> examples in the chapter). > > I am mostly questioning "for purposes described in this chapter". > All the TODO items can be labelled with multiple dates/times, not just in > "this chapter". I see. I'm trying to say that the rest of this chapter describes how, where and why you would use dates/times in an Org file. For example, the Timestamps subchapter describes what a timestamp looks like and that it can be used in any header or paragraph in an Org file and how the timestamp affects the agenda. >>>> +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>=. 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/times in the agenda (see [[*The Weekly/Daily Agenda]]). We >>>> +distinguish: >>> >>> This is not accurate. Only date is considered by agenda. Not time. >>> Time can be displayed, but has no effect (by default) on whether an >>> entry appears in the agenda or not. >> >> In testing, I found the following: >> >> * TODO summer school >> <2023-06-05 Mon 10:30-12:15>--<2023-06-08 Thu 10:30-12:15> >> >> ... >> Is this being done by an add-on package? I have these, but most of them >> are not setup: > > No. I meant that presence of time has no effect on whether an entry > appear in agenda or not. Once agenda decides that an entry should > appear, the time is taken into account when formatting the display. > > You modified the manual to "Its presence causes entries to be shown on > specific dates/times in the agenda". There is no concept of "shown on > specific time" in agenda views. Just "shown on specific day". I think I see what you're saying. I'm fine with dropping "/times". >>>> - 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 week at the >>>> + given day of the week and time: >>> >>> I miss the point here. You changed the last sentence to mention time, >>> but the "following" example does not specify the time (<%%(diary-float t 4 2)>). >> >> I think you're looking at the patch file, so you're not seeing the line >> before the 'diary' line which has a time of 22:00-23:00 on it. I don't >> use 'diary-float', so did I misinterpret the example? If so, drop the >> "and time". The main purpose was to add in "hours" after N. > > "22:00-23:00" has no relation to timestamps. > Agenda still accounts for it because of > `org-agenda-search-headline-for-time', but this part of the manual is > talking about timestamps, not agenda extras. The diary timestamp does > not set the time. Ah, then just drop the "and time" change. -- David Masterson