Variable: diary-icalendar-export-linewise

diary-icalendar-export-linewise is a customizable variable defined in diary-icalendar.el.gz.

Value

nil

Documentation

Export entries with multiple lines to distinct events.

If this is non-nil, each line of a diary entry will be exported as a separate iCalendar event.

If you write your diary entries in a one-entry-per-day style, with multiple events or appointments per day, you can use this variable to export these individual events to iCalendar format. For example, an entry like:

2025-05-03
  9AM Lab meeting
    Günter to present on new assay
  Start experiment A
  12:30-1:30PM Lunch with Phil
  16:00 Experiment A finishes; move to freezer

will be exported as four events, each on 2025-05-03 but with different start times (except for the second event, "Start experiment A", which has no start time). An event line can be continued onto subsequent lines via additional indentation, as in the first event in this entry.

If this variable is non-nil, each distinct event must begin on a continuation line of the entry (below the date); any text on the same line as the date is ignored. A time specification can only appear at the beginning of each continuation line of the entry, immediately after the leading whitespace.

If this variable is nil, each entry will be exported as exactly one event, and only a time specification immediately following the date will determine the start and end times for that event. Thus, in the example above, the exported event would have a start date but no start time or end time. The times in the entry would be preserved as text in the event description.

This variable was added, or its default value changed, in Emacs 31.1.

View in manual

Source Code

;; Defined in /usr/src/emacs/lisp/calendar/diary-icalendar.el.gz
(defcustom di:export-linewise
  nil
  "Export entries with multiple lines to distinct events.

If this is non-nil, each line of a diary entry will be exported as a
separate iCalendar event.

If you write your diary entries in a one-entry-per-day style, with
multiple events or appointments per day, you can use this variable to
export these individual events to iCalendar format.  For example, an
entry like:

2025-05-03
  9AM Lab meeting
    Günter to present on new assay
  Start experiment A
  12:30-1:30PM Lunch with Phil
  16:00 Experiment A finishes; move to freezer

will be exported as four events, each on 2025-05-03 but with different
start times (except for the second event, \"Start experiment A\", which
has no start time).  An event line can be continued onto subsequent lines
via additional indentation, as in the first event in this entry.

If this variable is non-nil, each distinct event must begin on a
continuation line of the entry (below the date); any text on the same
line as the date is ignored.  A time specification can only appear at
the beginning of each continuation line of the entry, immediately after
the leading whitespace.

If this variable is nil, each entry will be exported as exactly one
event, and only a time specification immediately following the date will
determine the start and end times for that event.  Thus, in the example
above, the exported event would have a start date but no start time or
end time.  The times in the entry would be preserved as text in the
event description."
  :version "31.1"
  :type '(radio (const :tag "Do not export linewise" nil)
                (const :tag "Export linewise" t)))