The zsh style mechanism using the zstyle
command is describe in
The zsh/zutil Module. This is the same mechanism
used in the completion system.
The styles below are all examined in the context
:datetime:
function:
, for example :datetime:calendar:
.
calendar-file
The location of the main calendar. The default is ~/calendar
.
date-format
A strftime
format string (see strftime(3)) with the zsh
extensions providing various numbers with no leading zero or space
if the number is a single digit as described for the
%D{
string}
prompt format in
Prompt Expansion.
This is used for outputting dates in calendar
, both to support
the -v
option and when adding recurring events back to the calendar
file, and in calendar_showdate
as the final output format.
If the style is not set, the default used is similar the standard system
format as output by the date
command (also known as ‘ctime format’):
‘%a %b %d %H:%M:%S %Z %Y
’.
done-file
The location of the file to which events which have passed are appended.
The default is the calendar file location with the suffix .done
.
The style may be set to an empty string in which case a "done" file
will not be maintained.
reformat-date
Boolean, used by calendar_add
. If it is true, the date and time
of new entries added to the calendar will be reformatted to the format
given by the style date-format
or its default. Only the date and
time of the event itself is reformatted; any subsidiary dates and times
such as those associated with repeat and warning times are left alone.
show-prog
The programme run by calendar
for showing events. It will
be passed the start time and stop time of the events requested in seconds
since the epoch followed by the event text. Note that calendar -s
uses
a start time and stop time equal to one another to indicate alerts
for specific events.
The default is the function calendar_show
.
warn-time
The time before an event at which a warning will be displayed, if the
first line of the event does not include the text EVENT
reltime.
The default is 5 minutes.