3 commits - KEP-0017.txt
Christian Mollekopf
mollekopf at kolabsys.com
Mon Feb 20 20:08:57 CET 2012
KEP-0017.txt | 72 ++++++++++++++++++++++++++++++++++++++++++-----------------
1 file changed, 52 insertions(+), 20 deletions(-)
New commits:
commit 847af2f1aa107aab3ce226c87300b246c2edd7c2
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Mon Feb 20 20:04:27 2012 +0100
Document Role property
diff --git a/KEP-0017.txt b/KEP-0017.txt
index cebb0e8..7e87bf7 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -1047,6 +1047,17 @@ Implements:
Implements:
* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-6.6.1 section-6.6.1]
+====== Role ======
+
+ property-role = element role {
+ element text { [[#String]] }
+ }
+
+''Specifies a role of the contact within the organization.''
+
+Implements:
+* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-6.6.2 section-6.6.2]
+
====== Manager ======
property-manager = element x-manager {
commit 3e98ef31717e36e7ab33f367175549f9140d5d08
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Mon Feb 20 20:01:58 2012 +0100
Content-Type instead of Content-MimeType
diff --git a/KEP-0017.txt b/KEP-0017.txt
index 6c0b8d7..cebb0e8 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -822,7 +822,7 @@ Implements:
''An object representing a task/todo.''
-* Content-MimeType: application/calendar+xml
+* Content-Type: application/calendar+xml
* X-Kolab-Type: application/x-vnd.kolab.task
Implements:
@@ -865,7 +865,7 @@ Implements:
''An object representing an event.''
-* Content-MimeType: application/calendar+xml
+* Content-Type: application/calendar+xml
* X-Kolab-Type: application/x-vnd.kolab.event
Implements:
@@ -898,7 +898,7 @@ Implements:
An object representing an journal entry. Journal entries '''SHALL''', as opposed to notes, be related to a calendar date.
-* Content-MimeType: application/calendar+xml
+* Content-Type: application/calendar+xml
* X-Kolab-Type: application/x-vnd.kolab.journal
Implements:
@@ -1445,7 +1445,7 @@ Implements:
''An address book entry for a contact.''
-* Content-MimeType: application/vcard+xml
+* Content-Type: application/vcard+xml
* X-Kolab-Type: application/x-vnd.kolab.contact
If the vcard:kind element is absent, it '''MUST''' default to "individual".
@@ -1472,7 +1472,7 @@ Implements:
''A distribution list mostly used for emailing.''
-* Content-MimeType: application/vcard+xml
+* Content-Type: application/vcard+xml
* X-Kolab-Type: application/x-vnd.kolab.contact.distlist
The vcard:kind element '''MUST''' have the value "group".
@@ -1496,7 +1496,7 @@ The vcard:kind element '''MUST''' have the value "group".
''A generic note, not necessarily associated with a specific date.''
-* Content-MimeType: application/x-vnd.kolab.*
+* Content-Type: application/x-vnd.kolab.*
* X-Kolab-Type: application/x-vnd.kolab.note
{{note|Needs clarfication: colors|do we need the color property? }}
@@ -1531,7 +1531,7 @@ The following color types are defined:
''A Kolab configuration object.''
-* Content-MimeType: application/x-vnd.kolab.configuration
+* Content-Type: application/x-vnd.kolab.configuration
* X-Kolab-Type: application/x-vnd.kolab.configuration.TYPE
The TYPE of the X-Kolab-Type '''MUST''' correspond to the "type" element.
commit 4dec3a7eeef2400b8c14f6bce32fbe6ab18e2693
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Thu Feb 9 20:22:53 2012 +0100
Minor updates.
*Added hint regarding all-day events
*Be more specific how the x-uid param should be used.
*Cardinality fixes
*xCard date-times are local time OR UTC, proper definition of the format
diff --git a/KEP-0017.txt b/KEP-0017.txt
index c053a71..6c0b8d7 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -122,6 +122,10 @@ Implements:
==== Product ID ====
value-productid = ( [[#String]] )
+
+ property-prodid = element prodid {
+ element text { value-productid }
+ }
''An identification of the client who has written out the last version of the object.''
@@ -255,6 +259,8 @@ Implements:
''Start date of the event/todo/journal entry.''
+"All-Day" Events are indicated by using the date-only format for the dtstart property.
+
Implements:
* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.2.4 section-3.8.2.4]
@@ -273,6 +279,8 @@ The value type of this property '''MUST''' be the same as the [[#Start date]] pr
This property '''MUST NOT''' be specified if an [[#Incidence Duration]] was specified.
+{{note|Example: Full-Day Event|To indicate an event which takes one full day, the dtend must be a day later than dtstart. dtstart=20110208 dtend=20110209 results in an Event taking all of 20110208.}}
+
Implements:
* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.2.2 section-3.8.2.2]
@@ -658,7 +666,7 @@ The cal-address '''MUST''' be a [[#Mailto URL]] email address.
:* "REQ-PARTICIPANT": Indicates a participant whose participation is required.
:* "OPT-PARTICIPANT": Indicates a participant whose participation is optional.
:* "NON-PARTICIPANT": Indicates a participant who is copied for information purposes only.
-* "x-uid": This propery may '''MAY''' be used to refer to the [[#Contact]] object of the attendee. The x-uid '''MUST''' contain the [[#UID]] of a [[#Contact]] if specified.
+* "x-uid": This propery may '''MAY''' be used to refer to the [[#Contact]] object of the attendee. The x-uid '''MUST''' contain the globally unique [[#UID]] of a [[#Contact]] if specified, internally used UID's '''MUST NOT''' be used.
Implements:
* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.4.1 section-3.8.4.1]
@@ -737,8 +745,8 @@ Properties:
type-audioprop = element properties {
element action { text { "AUDIO" } },
- property-trigger,
element attach { [[#Attachment]] } ?
+ property-trigger,
(
element duration { [[#Duration]] },
element repeat { element integer { [[#Integer|xsd:integer]] } }
@@ -787,7 +795,7 @@ Implements:
element sequence { [[#Sequence]] }, ?
element class { [[#Classification]] } ?,
element categories { [[#Categories|property-categories]] } ?,
- element related-to { [[#Related-to]] } ?,
+ element related-to { [[#Related-to]] } *,
element dtstart { [[#Start date]] } ?,
element due { [[#Due date]] } ?,
element rrule { [[#Recurrence rule]] } ?,
@@ -935,11 +943,11 @@ Implements:
===== Name Components =====
property-n = element n {
- element surname { [[#String]] }+,
- element given { [[#String]] }+,
- element additional { [[#String]] }+,
- element prefix { [[#String]] }+,
- element suffix { [[#String]] }+
+ element surname { [[#String]] }*,
+ element given { [[#String]] }*,
+ element additional { [[#String]] }*,
+ element prefix { [[#String]] }*,
+ element suffix { [[#String]] }*
}
''Specifies the indvidual components the name of the contact consists of.''
@@ -1313,9 +1321,9 @@ Implements:
===== Global Positioning =====
-property-geo = element geo {
- element uri{ [[#Geo URI]] }
-}
+ property-geo = element geo {
+ element uri{ [[#Geo URI]] }
+ }
''Specifies a global position of the contact.''
@@ -1431,7 +1439,7 @@ Implements:
element impp { [[#IM Address]] } *,
element email { [[#EMail]] } *,
element geo { [[#Global Positioning]] } *,
- element x-crypto { [[#Crypto]] },
+ element x-crypto { [[#Crypto]] } ?,
element x-custom { [[#Kolab Custom Property]] } *
}
@@ -1603,7 +1611,15 @@ Implements:
==== xCard Date-Time ====
- xcard-date-time = xsd:string { pattern = "\d\d\d\d\d\d\d\dT\d\d\d\d\d\d" }
+ xcard-date-time = date-time {
+ xsd:string { pattern = "\d\d\d\d\d\d\d\dT\d\d\d\d\d\dZ?" }
+ }
+
+ xcard-date = date {
+ xsd:string { pattern = "\d\d\d\d\d\d\d\d" }
+ }
+
+ xcard-date-or-date-time = ( xcard-date | xcard-date-time )
The date and time pattern '''MUST''' be in the format
@@ -1612,6 +1628,11 @@ The date and time pattern '''MUST''' be in the format
The date-time value '''MUST''' be a local time as specified in {{rfc|6350}}<ref name="rfc6350" />.
Note that while {{rfc|6350}}<ref name="rfc6350" /> allows the usage of UTC-offset times, this '''MUST NOT''' be used.
+To indicate that a date-time is in UTC a 'Z' '''MUST''' be appended.
+
+Implements:
+* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-4.3 section 4.3]
+
==== Examples ====
* Floating Time according to {{rfc|6321}}: <date-time>2011-05-17T13:00:00</date-time>
More information about the commits
mailing list