From c2e91d5c2c88967b5fb28a077c3c7107a2622334 Mon Sep 17 00:00:00 2001 Message-Id: From: Ihor Radchenko Date: Thu, 8 Jun 2023 13:22:45 +0300 Subject: [PATCH] doc/org-manual.org: Clarify how timestamps are considered by agenda * doc/org-manual.org (Timestamps): Clarify that multiple timestamps may be present under a heading. (Weekly/daily agenda): Add footnote explaining how timestamps are selected when building agenda views. Reported-by: David Masterson Link: https://orgmode.org/list/SJ0PR03MB5455C08FAD47C64F6EA7054CA252A@SJ0PR03MB5455.namprd03.prod.outlook.com --- doc/org-manual.org | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index c11694849..3b54764ab 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -6002,7 +6002,8 @@ ** Timestamps =<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: +agenda]]). There can be more than one timestamp in each entry. We +distinguish: - Plain timestamp; Event; Appointment :: @@ -8872,7 +8873,11 @@ *** Weekly/daily agenda #+cindex: daily agenda The purpose of the weekly/daily /agenda/ is to act like a page of -a paper agenda, showing all the tasks for the current week or day. +a paper agenda, showing all the tasks for the current week or day + [fn:: The tasks are displayed according to the contained timestamps. +Agenda has a number of customizations that determine which timestamps +are considered. See =org-agenda-skip= and =org-agenda-daily/weekly= +customization groups for the full list of customizations.]. - {{{kbd(M-x org-agenda a)}}} (~org-agenda-list~) :: -- 2.40.0