zsh: Calendar Styles

Next: Calendar Utility Functions, Previous: Calendar System User Functions, Up: Calendar Function System [Contents][Index]

### 23.4 Styles

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 man page 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.

Next: Calendar Utility Functions, Previous: Calendar System User Functions, Up: Calendar Function System [Contents][Index]