ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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.
This commit is contained in:
Ilya Chernyshov 2023-02-17 01:23:27 +07:00 committed by Ihor Radchenko
parent fff9239dc1
commit 715f74db36
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 17 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/org-manual.org
View File

@ -5915,12 +5915,12 @@ is used in a much wider sense.
#+cindex: deadlines #+cindex: deadlines
#+cindex: scheduling #+cindex: scheduling
A timestamp is a specification of a date (possibly with a time or A timestamp is a specification of a date (possibly with a time) in a
a range of times) in a special format, either =<2003-09-16 Tue>= or 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]. =<2003-09-16 Tue 09:39>=[fn:19]. A timestamp can appear anywhere in
A timestamp can appear anywhere in the headline or body of an Org tree the headline or body of an Org tree entry. Its presence causes
entry. Its presence causes entries to be shown on specific dates in entries to be shown on specific dates in the agenda (see [[*Weekly/daily
the agenda (see [[*Weekly/daily agenda]]). We distinguish: agenda]]). We distinguish:
- Plain timestamp; Event; Appointment :: - Plain timestamp; Event; Appointment ::
@ -5935,7 +5935,7 @@ the agenda (see [[*Weekly/daily agenda]]). We distinguish:
,* Meet Peter at the movies ,* Meet Peter at the movies
<2006-11-01 Wed 19:15> <2006-11-01 Wed 19:15>
,* Discussion on climate change ,* Discussion on climate change
<2006-11-02 Thu 20:00-22:00> <2006-11-02 Thu>
#+end_example #+end_example
- Timestamp with repeater interval :: - Timestamp with repeater interval ::
@ -5974,15 +5974,22 @@ the agenda (see [[*Weekly/daily agenda]]). We distinguish:
#+cindex: timerange #+cindex: timerange
#+cindex: date range #+cindex: date range
Two timestamps connected by =--= denote a range. The headline is Two timestamps connected by =--= denote a range. In the agenda, the
shown on the first and last day of the range, and on any dates that headline is shown on the first and last day of the range, and on any
are displayed and fall in the range. Here is an example: dates that are displayed and fall in the range. Here is an example:
#+begin_example #+begin_example
,** Meeting in Amsterdam ,** Meeting in Amsterdam
<2004-08-23 Mon>--<2004-08-26 Thu> <2004-08-23 Mon>--<2004-08-26 Thu>
#+end_example #+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 :: - Inactive timestamp ::
#+cindex: timestamp, inactive #+cindex: timestamp, inactive