1.1 --- a/docs/preferences.txt Fri Aug 21 14:47:53 2015 +0200
1.2 +++ b/docs/preferences.txt Sat Aug 29 00:14:32 2015 +0200
1.3 @@ -1,19 +1,74 @@
1.4 -General user preferences are as follows:
1.5 +Preferences and Settings
1.6 +========================
1.7 +
1.8 +LANG
1.9 +----
1.10
1.11 -LANG (en) language for messages and interfaces
1.12 +Default: en (English)
1.13 +Alternatives: (any recognised and supported locale)
1.14 +
1.15 +The language for messages and user interface text.
1.16 +
1.17 +TZID
1.18 +----
1.19 +
1.20 +Default: system timezone (see /etc/timezone)
1.21 +Alternatives: (any recognised Olson time zone identifier)
1.22
1.23 -The user preferences for message and calendar functionality are as follows:
1.24 +The default time zone/regime for calendars, new events and local times.
1.25 +
1.26 +freebusy_bundling
1.27 +-----------------
1.28 +
1.29 +Default: never
1.30 +Alternative: always
1.31
1.32 -freebusy_bundling always bundle free/busy details with other
1.33 - payloads
1.34 +Indicate whether to bundle free/busy details with other payloads such as
1.35 +event and free/busy objects.
1.36 +
1.37 +freebusy_messages
1.38 +-----------------
1.39 +
1.40 +Default: none
1.41 +Alternative: notify
1.42 +
1.43 +Indicate whether recipients are notified about received free/busy payloads.
1.44
1.45 -freebusy_messages notify notify recipients of received free/busy
1.46 - payloads
1.47 +freebusy_sharing
1.48 +----------------
1.49 +
1.50 +Default: no
1.51 +Alternative: share
1.52 +
1.53 +Share free/busy details generally:
1.54 +
1.55 + * bundling in e-mail messages if bundling is configured
1.56 + * responding to free/busy requests via e-mail
1.57 + * publishing as Web resources if a static Web resource is configured
1.58 +
1.59 +incoming
1.60 +--------
1.61 +
1.62 +Default: summary-wraps-message
1.63 +Alternatives: (see below)
1.64
1.65 -freebusy_sharing share share free/busy details generally:
1.66 - * bundling in e-mail messages if bundling
1.67 - is configured
1.68 - * responding to free/busy requests via
1.69 - e-mail
1.70 - * publishing as Web resources if a static
1.71 - Web resource is configured
1.72 +Define how incoming event messages are delivered to recipients:
1.73 +
1.74 + * message-only (deliver only the incoming message as it was received)
1.75 + * message-then-summary (deliver the message first followed by a summary
1.76 + message)
1.77 + * summary-then-message (deliver a summary first followed by the message)
1.78 + * summary-only (deliver only a summary of the message)
1.79 +
1.80 +participating
1.81 +-------------
1.82 +
1.83 +Default: participate
1.84 +Alternative: no
1.85 +
1.86 +Indicate whether a recipient participates in the calendar system. Note that
1.87 +participation by default occurs because the handler programs will be defined
1.88 +in the mail system for recipients fulfilling certain criteria; other
1.89 +recipients will be handled in other ways. Thus, initial non-participation must
1.90 +be defined by initialising this setting to "no" for all eligible users, if
1.91 +this is the general policy on initial calendar system participation.