* doc/org-manual.org: Refactor, explain diary sexp export in ox-icalendar

(iCalendar Export): Explain what is exported by default.  Mention
`icalendar-export-sexp-enumeration-days' that limits how far into
future generic diary sexps are exported.  Split large paragraph
explaining about handling entries with scheduled and deadline set.

Link: https://orgmode.org/list/87v8e93hor.fsf@localhost
This commit is contained in:
Ihor Radchenko 2023-07-25 14:19:58 +03:00
parent ac0042184e
commit 5f7cfdfd1d
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 15 additions and 6 deletions

View File

@ -16103,17 +16103,26 @@ easily export to or import from external applications. The iCalendar
export backend takes calendar data from Org files and exports to the
standard iCalendar format.
#+vindex: icalendar-export-sexp-enumeration-days
By default, iCalendar export only includes headings that contain
active timestamps or diary sexps[fn:: Diary sexp events, except
certain built-in types (see ~icalendar-export-sexp-enumerate-all~),
are exported up to ~icalendar-export-sexp-enumeration-days~ into
future.].
#+vindex: org-icalendar-include-todo
#+vindex: org-icalendar-use-deadline
#+vindex: org-icalendar-use-scheduled
#+vindex: org-icalendar-todo-unscheduled-start
The iCalendar export backend can also incorporate TODO entries based
on the configuration of the ~org-icalendar-include-todo~ variable.
The backend exports plain timestamps as =VEVENT=, TODO items as
=VTODO=, and also create events from deadlines that are in non-TODO
items. The backend uses the deadlines and scheduling dates in Org
TODO items for setting the start and due dates for the iCalendar TODO
entry. Consult the ~org-icalendar-use-deadline~,
items.
#+vindex: org-icalendar-use-deadline
#+vindex: org-icalendar-use-scheduled
#+vindex: org-icalendar-todo-unscheduled-start
The backend uses the deadlines and scheduling dates in Org TODO items
for setting the start and due dates for the iCalendar TODO entry.
Consult the ~org-icalendar-use-deadline~,
~org-icalendar-use-scheduled~, and
~org-icalendar-todo-unscheduled-start~ variables for more details.