[Docs] [txt|pdf|xml] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: 00 01 02 03 04 05 06 07 08 09 draft-ietf-calext-extensions

Network Working Group                                           C. Daboo
Internet-Draft                                                Apple Inc.
Intended status: Standards Track                        October 24, 2010
Expires: April 27, 2011


                      New Properties for iCalendar
                  draft-daboo-icalendar-extensions-02

Abstract

   This document defines a set of new properties for iCalendar data.

Status of this Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on April 27, 2011.

Copyright Notice

   Copyright (c) 2010 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.







Daboo                    Expires April 27, 2011                 [Page 1]


Internet-Draft        iCalendar Property Extensions         October 2010


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  Conventions Used in This Document  . . . . . . . . . . . . . .  3
   3.  Modifications to Calendar Components . . . . . . . . . . . . .  3
   4.  Calendar Properties  . . . . . . . . . . . . . . . . . . . . .  4
     4.1.  CALENDAR-NAME Property . . . . . . . . . . . . . . . . . .  5
     4.2.  CALENDAR-DESCRIPTION Property  . . . . . . . . . . . . . .  6
     4.3.  CALENDAR-UID Property  . . . . . . . . . . . . . . . . . .  7
     4.4.  CALENDAR-URL Property  . . . . . . . . . . . . . . . . . .  7
     4.5.  CALENDAR-TZID Property . . . . . . . . . . . . . . . . . .  8
     4.6.  CALENDAR-REFRESH-INTERVAL Property . . . . . . . . . . . .  9
     4.7.  CALENDAR-COLOR Property  . . . . . . . . . . . . . . . . . 10
     4.8.  CALENDAR-IMAGE Property  . . . . . . . . . . . . . . . . . 10
   5.  Component Properties . . . . . . . . . . . . . . . . . . . . . 12
     5.1.  IMAGE Property . . . . . . . . . . . . . . . . . . . . . . 12
     5.2.  CONFERENCE Property  . . . . . . . . . . . . . . . . . . . 14
   6.  Property Parameters  . . . . . . . . . . . . . . . . . . . . . 16
     6.1.  DISPLAY Property Parameter . . . . . . . . . . . . . . . . 16
     6.2.  INFO Property Parameter  . . . . . . . . . . . . . . . . . 16
   7.  Security Considerations  . . . . . . . . . . . . . . . . . . . 17
   8.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 17
     8.1.  Property Registrations . . . . . . . . . . . . . . . . . . 17
     8.2.  Parameter Registrations  . . . . . . . . . . . . . . . . . 18
     8.3.  Display Types Registry . . . . . . . . . . . . . . . . . . 18
   9.  Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 18
   10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 18
     10.1. Normative References . . . . . . . . . . . . . . . . . . . 18
     10.2. Informative References . . . . . . . . . . . . . . . . . . 19
   Appendix A.  Change History (To be removed by RFC Editor
                before publication) . . . . . . . . . . . . . . . . . 19
   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 19



















Daboo                    Expires April 27, 2011                 [Page 2]


Internet-Draft        iCalendar Property Extensions         October 2010


1.  Introduction

   The iCalendar [RFC5545] data format is used to represent calendar
   data and is used with iTIP [RFC5546] to handle scheduling operations
   between calendar users. iCalendar is in widespread use, and in
   accordance with provisions in that specification, extension elements
   have been added by various vendors to the data format in order to
   support and enhance capabilities.  This specification collects a
   number of these ad-hoc extensions and uses the new IANA registry
   capability defined in [RFC5545] to register standard variants with
   clearly defined definitions and semantics.  In addition, some new
   elements are introduced for features that vendors have recently been
   requesting.


2.  Conventions Used in This Document

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in
   [RFC2119].

   The notation used in this memo is the ABNF notation of [RFC5234] as
   used by iCalendar [RFC5545].  Any syntax elements shown below that
   are not explicitly defined in this specification come from iCalendar
   [RFC5545].


3.  Modifications to Calendar Components

   The following changes to the syntax defined in iCalendar [RFC5545]
   are made here.  New elements are defined in subsequent sections.



















Daboo                    Expires April 27, 2011                 [Page 3]


Internet-Draft        iCalendar Property Extensions         October 2010


          calprops /= *(
                       ;
                       ; The following are OPTIONAL,
                       ; but MUST NOT occur more than once.
                       ;
                       caluid / calurl / caltzid /
                       calrefresh / calcolor /
                       ;
                       ; The following are OPTIONAL,
                       ; and MAY occur more than once.
                       ;
                       calname / caldescription / calimg
                       ;
                       )

          eventprop /= *(
                        ;
                        ; The following are OPTIONAL,
                        ; and MAY occur more than once.
                        ;
                        image, conference
                        ;
                        )

          todoprop /= *(
                       ;
                       ; The following are OPTIONAL,
                       ; and MAY occur more than once.
                       ;
                       image, conference
                       ;
                       )

          jourprop /= *(
                       ;
                       ; The following are OPTIONAL,
                       ; and MAY occur more than once.
                       ;
                       image
                       ;
                       )



4.  Calendar Properties






Daboo                    Expires April 27, 2011                 [Page 4]


Internet-Draft        iCalendar Property Extensions         October 2010


4.1.  CALENDAR-NAME Property

   Property Name:  CALENDAR-NAME

   Purpose:  This property specifies the name of the calendar.

   Value Type:  TEXT

   Property Parameters:  IANA, non-standard, alternate text
      representation, and language property parameters can be specified
      on this property.

   Conformance:  This property can be specified multiple times in an
      iCalendar object.  However, each property MUST represent the name
      of the calendar in a different language.

   Description:  This property is used to specify a name (a short, one-
      line description) of the iCalendar object that can be used by
      calendar user agents when presenting the calendar data to a user.
      Whilst a calendar only has a single name, multiple language
      variants can be specified by including this property multiple
      times with different "LANGUAGE" parameter values on each.

   Format Definition:  This property is defined by the following
      notation:

          calname       = "CALENDAR-NAME" calnameparam ":" text CRLF

          calnameparam  = *(
                           ;
                           ; The following are OPTIONAL,
                           ; but MUST NOT occur more than once.
                           ;
                           (";" altrepparam) / (";" languageparam) /
                           ;
                           ; The following is OPTIONAL,
                           ; and MAY occur more than once.
                           ;
                           (";" other-param)
                           ;
                           )

   Example:  The following is an example of this property:

          CALENDAR-NAME:Company Vacation Days






Daboo                    Expires April 27, 2011                 [Page 5]


Internet-Draft        iCalendar Property Extensions         October 2010


4.2.  CALENDAR-DESCRIPTION Property

   Property Name:  CALENDAR-DESCRIPTION

   Purpose:  This property specifies the description of the calendar.

   Value Type:  TEXT

   Property Parameters:  IANA, non-standard, alternate text
      representation, and language property parameters can be specified
      on this property.

   Conformance:  This property can be specified multiple times in an
      iCalendar object.  However, each property MUST represent the
      description of the calendar in a different language.

   Description:  This property is used to specify a lengthy textual
      description of the iCalendar object that can be used by calendar
      user agents when describing the nature of the calendar data to a
      user.  Whilst a calendar only has a single description, multiple
      language variants can be specified by including this property
      multiple times with different "LANGUAGE" parameter values on each.

   Format Definition:  This property is defined by the following
      notation:

          caldesc       = "CALENDAR-DESCRIPTION" caldescparam ":" text
                          CRLF

          caldescparam  = *(
                           ;
                           ; The following are OPTIONAL,
                           ; but MUST NOT occur more than once.
                           ;
                           (";" altrepparam) / (";" languageparam) /
                           ;
                           ; The following is OPTIONAL,
                           ; and MAY occur more than once.
                           ;
                           (";" other-param)
                           ;
                           )

   Example:  The following is an example of this property:

          CALENDAR-DESCRIPTION:This calendar contains all the \
           official vacation days of our company.\nThese repre\
           sent paid time-off - make sure you have fun, we'll \



Daboo                    Expires April 27, 2011                 [Page 6]


Internet-Draft        iCalendar Property Extensions         October 2010


           be working you hard on the other days!

4.3.  CALENDAR-UID Property

   Property Name:  CALENDAR-UID

   Purpose:  This property specifies the persistent, globally unique
      identifier for the calendar.

   Value Type:  TEXT

   Property Parameters:  IANA and non-standard property parameters can
      be specified on this property.

   Conformance:  This property can be specified once in an iCalendar
      object.

   Description:  The value of this property MUST be a globally unique
      identifier.  The generator of the property MUST guarantee that the
      value is unique.  This can be done following the recommendations
      in Section 3.8.4.7 of [RFC5545].  Implementations MUST be able to
      receive and persist values of at least 255 octets for this
      property, but they MUST NOT truncate values in the middle of a
      UTF-8 multi-octet sequence.

   Format Definition:  This property is defined by the following
      notation:

          caluid       = "CALENDAR-UID" caluidparam ":" text CRLF

          caluidparam  = *(";" other-param)

   Example:  The following is an example of this property:

          CALENDAR-UID:19960401T080045Z-4000F192713-0052@example.com

4.4.  CALENDAR-URL Property

   Property Name:  CALENDAR-URL

   Purpose:  This property specifies a URL from where the calendar data
      was retrieved or where it can be refreshed.

   Value Type:  URI







Daboo                    Expires April 27, 2011                 [Page 7]


Internet-Draft        iCalendar Property Extensions         October 2010


   Property Parameters:  IANA and non-standard property parameters can
      be specified on this property.

   Conformance:  This property can be specified once in an iCalendar
      object.

   Description:  This property specifies a URL identifying the source of
      the calendar data and a location from where updates can be
      retrieved.

   Format Definition:  This property is defined by the following
      notation:

          calurl       = "CALENDAR-URL" calurlparam ":" uri CRLF

          calurlparam  = *(";" other-param)

   Example:  The following is an example of this property:

          CALENDAR-URL:http://calendars.example.com/holidays/canada.ics

4.5.  CALENDAR-TZID Property

   Property Name:  CALENDAR-TZID

   Purpose:  This property specifies the default time zone identifier
      for the calendar.

   Value Type:  TEXT

   Property Parameters:  IANA and non-standard property parameters can
      be specified on this property.

   Conformance:  This property can be specified once in an iCalendar
      object.

   Description:  This property specifies a time zone identifier that
      represents the default timezone for which floating time or all-day
      events in the iCalendar object can be assumed to be relative to.
      It can also be used to choose an initial time zone for use when
      creating new components in the iCalendar object.  A "VTIMEZONE"
      component having a "TZID" property matching the value specified in
      this property MUST be present in the iCalendar object.

   Format Definition:  This property is defined by the following
      notation:





Daboo                    Expires April 27, 2011                 [Page 8]


Internet-Draft        iCalendar Property Extensions         October 2010


          caltzid       = "CALENDAR-TZID" caltzidparam ":" [tzidprefix]
                          text CRLF

          caltzidparam  = *(";" other-param)

   Example:  The following is an example of this property:

          CALENDAR-TZID:America/New_York

4.6.  CALENDAR-REFRESH-INTERVAL Property

   Property Name:  CALENDAR-REFRESH-INTERVAL

   Purpose:  This property specifies a suggested minimum interval for
      polling for changes of the calendar data from the original source
      of that data.

   Value Type:  DURATION

   Property Parameters:  IANA and non-standard property parameters can
      be specified on this property.

   Conformance:  This property can be specified once in an iCalendar
      object.

   Description:  This property specifies a positive duration that gives
      a suggested minimum polling interval for checking for updates to
      the calendar data.  The value of this property SHOULD be used by
      calendar user agents to limit the polling interval for calendar
      data updates to the minimum interval specified.

   Format Definition:  This property is defined by the following
      notation:

          calrefesh      = "CALENDAR-REFRESH-INTERVAL" calrefreshparam
                           ":" dur-value CRLF
                           ;consisting of a positive duration of time.

          calrefeshparam = *(";" other-param)

   Example:  The following is an example of this property:

          CALENDAR-REFRESH-INTERVAL:P1W








Daboo                    Expires April 27, 2011                 [Page 9]


Internet-Draft        iCalendar Property Extensions         October 2010


4.7.  CALENDAR-COLOR Property

   Property Name:  CALENDAR-COLOR

   Purpose:  This property specifies a color used for displaying the
      calendar data.

   Value Type:  INTEGER.  The value MUST be three SEMICOLON-separated
      INTEGER values.

   Property Parameters:  IANA and non-standard property parameters can
      be specified on this property.

   Conformance:  This property can be specified once in an iCalendar
      object.

   Description:  This property specifies a color that client MAY use
      when presenting the calendar data to a user.  Typically this would
      appear as the "background" color of events or tasks.  The value
      MUST be an RGB value with integer value components in the range
      0..255

   Format Definition:  This property is defined by the following
      notation:

          calcolor       = "CALENDAR-COLOR" calcolorparam ":"
                           calcolorvalue CRLF

          calcolorparam  = *(";" other-param)

          calcolorvalue  = integer ";" integer ";" integer
                           ; Red, green, and blue values in the range
                           ; 0 - 255.

   Example:  The following is an example of this property:

          CALENDAR-COLOR:255;0;255

4.8.  CALENDAR-IMAGE Property

   Property Name:  CALENDAR-IMAGE

   Purpose:  This property specifies an image associated with the
      calendar.







Daboo                    Expires April 27, 2011                [Page 10]


Internet-Draft        iCalendar Property Extensions         October 2010


   Value Type:  The default value type for this property is URI.  The
      value type can also be set to BINARY to indicate inline binary
      encoded content information.  The value MUST refer to or be data
      with a media type of "image".

   Property Parameters:  IANA, non-standard, display, inline encoding,
      and value data type property parameters can be specified on this
      property.  The format type parameter can be specified on this
      property and is RECOMMENDED for inline binary encoded content
      information.

   Conformance:  This property can be specified multiple times in an
      iCalendar object.

   Description:  This property specifies an image for an iCalendar
      object via a uri or directly with inline data that can be used by
      calendar user agents when presenting the calendar data to a user.
      Multiple properties MAY be used to specify alternative sets of
      images with, for example, varying media subtypes, resolutions or
      sizes.  When multiple properties are present, calendar user agents
      SHOULD display only one of them, picking one that provides the
      most appropriate image quality, or display none.  The "DISPLAY"
      parameter is used to indicate the intended display mode for the
      image.

   Format Definition:  This property is defined by the following
      notation:
























Daboo                    Expires April 27, 2011                [Page 11]


Internet-Draft        iCalendar Property Extensions         October 2010


          calimg     = "CALENDAR-IMAGE" calimgparam ( ":" uri ) /
                       (
                         ";" "ENCODING" "=" "BASE64"
                         ";" "VALUE" "=" "BINARY"
                         ":" binary
                       )
                       CRLF

          calimgparam = *(
                         ;
                         ; The following is OPTIONAL for a URI value,
                         ; RECOMMENDED for a BINARY value,
                         ; and MUST NOT occur more than once.
                         ;
                         (";" fmttypeparam) /
                         ;
                         ; The following is OPTIONAL,
                         ; and MOST NOT occur more than once.
                         ;
                         (";" displayparam) /
                         ;
                         ; The following is OPTIONAL,
                         ; and MAY occur more than once.
                         ;
                         (";" other-param)
                         ;
                         )

   Example:  The following is an example of this property:

          CALENDAR-IMAGE;DISPLAY=BADGE;FMTTYPE=image/png:http://ex
           ample.com/images/holiday.png


5.  Component Properties

5.1.  IMAGE Property

   Property Name:  IMAGE

   Purpose:  This property specifies an image associated with a calendar
      component.

   Value Type:  The default value type for this property is URI.  The
      value type can also be set to BINARY to indicate inline binary
      encoded content information.  The value MUST refer to or be data
      with a media type of "image".




Daboo                    Expires April 27, 2011                [Page 12]


Internet-Draft        iCalendar Property Extensions         October 2010


   Property Parameters:  IANA, non-standard, display, inline encoding,
      and value data type property parameters can be specified on this
      property.  The format type parameter can be specified on this
      property and is RECOMMENDED for inline binary encoded content
      information.

   Conformance:  This property can be specified multiple times in a
      "VEVENT", "VTODO", or "VJOURNAL" calendar component.

   Description:  This property specifies an image for a calendar
      component via a uri or directly with inline data that can be used
      by calendar user agents when presenting the calendar data to a
      user.  Multiple properties MAY be used to specify alternative sets
      of images with, for example, varying media subtypes, resolutions
      or sizes.  When multiple properties are present, calendar user
      agents SHOULD display only one of them, picking one that provides
      the most appropriate image quality, or display none.  The
      "DISPLAY" parameter is used to indicate the intended display mode
      for the image.

   Format Definition:  This property is defined by the following
      notation:





























Daboo                    Expires April 27, 2011                [Page 13]


Internet-Draft        iCalendar Property Extensions         October 2010


          image      = "IMAGE" imageparam ( ":" uri ) /
                       (
                         ";" "ENCODING" "=" "BASE64"
                         ";" "VALUE" "=" "BINARY"
                         ":" binary
                       )
                       CRLF

          imageparam = *(
                        ;
                        ; The following is OPTIONAL for a URI value,
                        ; RECOMMENDED for a BINARY value,
                        ; and MUST NOT occur more than once.
                        ;
                        (";" fmttypeparam) /
                        ;
                        ; The following is OPTIONAL,
                        ; and MOST NOT occur more than once.
                        ;
                        (";" displayparam) /
                        ;
                        ; The following is OPTIONAL,
                        ; and MAY occur more than once.
                        ;
                        (";" other-param)
                        ;
                        )

   Example:  The following is an example of this property:

          IMAGE;DISPLAY=BACKGROUND;FMTTYPE=image/png:htt
           p://example.com/images/party.png

5.2.  CONFERENCE Property

   Property Name:  CONFERENCE

   Purpose:  This property specifies information for accessing a
      conferencing system.

   Value Type:  URI.

   Property Parameters:  IANA, non-standard, information, and language
      property parameters can be specified on this property.







Daboo                    Expires April 27, 2011                [Page 14]


Internet-Draft        iCalendar Property Extensions         October 2010


   Conformance:  This property can be specified multiple times in a
      "VEVENT" or "VTODO" calendar component.

   Description:  This property specifies information for accessing a
      conferencing system for attendees of a meeting or to-do.  This
      might be a tel: URI [RFC3496] for a telephone-based conference
      number dial-in (with access codes included), or it might be an
      http: URI [RFC2616] for a web-based video chat, or a URI for an
      instant messaging group chat room.  If a specific URI for a
      conferencing system is not available, a data: URI [RFC2397]
      containing a text description can be used.

      The "INFO" property paramater is used to convey additional details
      on the use of the URI.  For example, the URIs or access codes for
      the moderator and attendee of a teleconference system could be
      different, and the "INFO" property parameter could be used to
      "tag" each "CONFERENCE" property to indicate which is which.

      The "LANGUAGE" property parameter is used to indicate the language
      associated with the property, and in particular any "INFO"
      property parameter.

   Format Definition:  This property is defined by the following
      notation:

          conference = "CONFERENCE" confparam  ":" uri CRLF

          confparam  = *(
                        ;
                        ; The following are OPTIONAL,
                        ; and MOST NOT occur more than once.
                        ;
                        (";" infoparam) / (";" languageparam) /
                        ;
                        ; The following is OPTIONAL,
                        ; and MAY occur more than once.
                        ;
                        (";" other-param)
                        ;
                        )

   Example:  The following are examples of this property:

          CONFERENCE;INFO=Moderator dial-in;:tel:+1-412-
           555-0123,,,654321
          CONFERENCE;INFO=Attendee dial-in;:tel:+1-412-5
           55-0123,,,555123
          CONFERENCE;INFO=Chat room:xmpp:chat-123@confer



Daboo                    Expires April 27, 2011                [Page 15]


Internet-Draft        iCalendar Property Extensions         October 2010


           ence.example.com


6.  Property Parameters

6.1.  DISPLAY Property Parameter

   Parameter Name:  DISPLAY

   Purpose:  To specify different ways in which an image for a calendar
      or component can be displayed.

   Format Definition:  This property parameter is defined by the
      following notation:

      displayparam = "DISPLAY" "="
                     ("BADGE" /       ; A small "badge" image
                      "BACKGROUND" /  ; Use as a background image
                      "OVERLAY" /     ; Use as an overlay image
                      "BANNER" /      ; Use as a "banner" across the top
                      x-name /        ; Experimental type
                      iana-token)     ; Other IANA registered type
                                      ;
                                      ; Default is BADGE

   Description:  This property parameter MAY be specified on "CALENDAR-
      IMAGE" or "IMAGE" properties.  In the absence of this parameter,
      the value "BADGE" MUST be used for the default behavior.  The
      value determines how a client ought to present an image supplied
      in iCalendar data to the user.

      Values for this parameter are registered with IANA as per
      Section 8.3.  New values can be added to this registry following
      the procedure outlined in Section 8.2.1 of [RFC5545].

      Servers and clients MUST handle x-name and iana-token values they
      don't recognize by not displaying any image at all.

   Example:

          IMAGE;DISPLAY=BANNER;FMTTYPE=image/png:htt
           p://example.com/images/weather-cloudy.png

6.2.  INFO Property Parameter







Daboo                    Expires April 27, 2011                [Page 16]


Internet-Draft        iCalendar Property Extensions         October 2010


   Parameter Name:  INFO

   Purpose:  To specify descriptive text about a property.

   Format Definition:  This property parameter is defined by the
      following notation:

      infoparam = "INFO" "=" paramtext

   Description:  This property parameter MAY be specified on
      "CONFERENCE" properties.

   Example:

          CONFERENCE;INFO="Web video chat, access code=7654
           3";:http://video-chat.example.com/;group-id=1234


7.  Security Considerations

   TODO:Perhaps discuss issues with image processing related buffer
   overflows, accessing external URLs (privacy), etc.


8.  IANA Considerations

8.1.  Property Registrations

   This document defines the following new iCalendar properties to be
   added to the registry defined in Section 8.2.3 of [RFC5545]:

      +---------------------------+---------+----------------------+
      | Property                  | Status  | Reference            |
      +---------------------------+---------+----------------------+
      | CALENDAR-NAME             | Current | RFCXXXX, Section 4.1 |
      | CALENDAR-DESCRIPTION      | Current | RFCXXXX, Section 4.2 |
      | CALENDAR-UID              | Current | RFCXXXX, Section 4.3 |
      | CALENDAR-URL              | Current | RFCXXXX, Section 4.4 |
      | CALENDAR-TZID             | Current | RFCXXXX, Section 4.5 |
      | CALENDAR-REFRESH-INTERVAL | Current | RFCXXXX, Section 4.6 |
      | CALENDAR-COLOR            | Current | RFCXXXX, Section 4.7 |
      | CALENDAR-IMAGE            | Current | RFCXXXX, Section 4.8 |
      | IMAGE                     | Current | RFCXXXX, Section 5.1 |
      | CONFERENCE                | Current | RFCXXXX, Section 5.2 |
      +---------------------------+---------+----------------------+






Daboo                    Expires April 27, 2011                [Page 17]


Internet-Draft        iCalendar Property Extensions         October 2010


8.2.  Parameter Registrations

   This document defines the following new iCalendar property parameters
   to be added to the registry defined in Section 8.2.4 of [RFC5545]:

          +--------------------+---------+----------------------+
          | Property Parameter | Status  | Reference            |
          +--------------------+---------+----------------------+
          | DISPLAY            | Current | RFCXXXX, Section 6.1 |
          | INFO               | Current | RFCXXXX, Section 6.2 |
          +--------------------+---------+----------------------+

8.3.  Display Types Registry

   This document defines the following new iCalendar value registry as
   per Section 8.2.6 of [RFC5545]:

             +--------------+---------+----------------------+
             | Display Type | Status  | Reference            |
             +--------------+---------+----------------------+
             | BADGE        | Current | RFCXXXX, Section 6.1 |
             | BACKGROUND   | Current | RFCXXXX, Section 6.1 |
             | OVERLAY      | Current | RFCXXXX, Section 6.1 |
             | BANNER       | Current | RFCXXXX, Section 6.1 |
             +--------------+---------+----------------------+


9.  Acknowledgments

   This specification came about via discussions at the Calendaring and
   Scheduling Consortium.


10.  References

10.1.  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC5234]  Crocker, D. and P. Overell, "Augmented BNF for Syntax
              Specifications: ABNF", STD 68, RFC 5234, January 2008.

   [RFC5545]  Desruisseaux, B., "Internet Calendaring and Scheduling
              Core Object Specification (iCalendar)", RFC 5545,
              September 2009.





Daboo                    Expires April 27, 2011                [Page 18]


Internet-Draft        iCalendar Property Extensions         October 2010


10.2.  Informative References

   [RFC2397]  Masinter, L., "The "data" URL scheme", RFC 2397,
              August 1998.

   [RFC2616]  Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
              Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
              Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.

   [RFC3496]  Malis, A. and T. Hsiao, "Protocol Extension for Support of
              Asynchronous Transfer Mode (ATM) Service Class-aware
              Multiprotocol Label Switching (MPLS) Traffic Engineering",
              RFC 3496, March 2003.

   [RFC5546]  Daboo, C., "iCalendar Transport-Independent
              Interoperability Protocol (iTIP)", RFC 5546,
              December 2009.


Appendix A.  Change History (To be removed by RFC Editor before
             publication)

   Changes in -02:

   1.  Minor wording changes.

   2.  Interval is now described as the "minimum interval".

   3.  Added CONFERENCE property and INFO parameter.

   Changes in -01:

   1.  Fixed DISPLAY parameter handling of x- and iana tokens to state
       that clients ignore the image if the token is not recognized.

   2.  Allow language variants for CALENDAR-NAME and CALENDAR-
       DESCRIPTION.

   3.  Added registry for DISPLAY values.












Daboo                    Expires April 27, 2011                [Page 19]


Internet-Draft        iCalendar Property Extensions         October 2010


Author's Address

   Cyrus Daboo
   Apple Inc.
   1 Infinite Loop
   Cupertino, CA  95014
   USA

   Email: cyrus@daboo.name
   URI:   http://www.apple.com/









































Daboo                    Expires April 27, 2011                [Page 20]


Html markup produced by rfcmarkup 1.129d, available from https://tools.ietf.org/tools/rfcmarkup/