vcarddav                                                           K. Li
Internet-Draft                                                  B. Leiba
Intended status: Standards Track                     Huawei Technologies
Expires: December 24, 2011                                 June 22, January 6, 2012                                    July 5, 2011

   vCard Format Extensions : place of birth, place and date of death
           draft-li-vcarddav-vcard-id-property-extensions-02
           draft-li-vcarddav-vcard-id-property-extensions-03

Abstract

   The base vCard 4.0 specification defines a large number of
   properties, including date of birth.  This specification adds three
   new properties to vCard 4.0, for place of birth, place of death, and
   date of death.

Note

   Discussion and suggestions for improvement are requested, and should
   be sent to vcarddav@ietf.org.

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 December 24, 2011. January 6, 2012.

Copyright Notice

   Copyright (c) 2011 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.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 3
     1.1.  Terminology Used in This Document . . . . . . . . . . . . . 3
   2.  Identification Property Extensions  . . . . . . . . . . . . . . 3
     2.1.  Property: BIRTH . . . BIRTHPLACE  . . . . . . . . . . . . . . . . . . . 3
     2.2.  Property: DEATH . . . DEATHPLACE  . . . . . . . . . . . . . . . . . . . 4
     2.3.  Property: DDAY  . . DEATHDATE . . . . . . . . . . . . . . . . . . . . 4
   3.  Security Considerations . . . . . . . . . . . . . . . . . . . . 5
   4.  IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 5
   5.  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . 6
   6.  Normative References  . . . . . . . . . . . . . . . . . . . . . 6
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . . . 6

1.  Introduction

   The base vCard 4.0 specification [I-D.ietf-vcarddav-vcardrev] defines
   a large number of properties, including date of birth.  This
   specification adds three new properties to vCard 4.0, for place of
   birth, place of death, and date of death.

1.1.  Terminology Used in This Document

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

   Syntax specifications shown here use the augmented Backus-Naur Form
   (ABNF) as described in [RFC5234], and are specified as in the base
   vcard specification [I-D.ietf-vcarddav-vcardrev].

2.  Identification Property Extensions

2.1.  Property: BIRTH BIRTHPLACE

   Namespace:

   Property name:  BIRTH  BIRTHPLACE

   Purpose:  To specify the place of birth of the object the vCard
       represents.

   Value type:  A single text value (default) or a single URI value.

   Cardinality:  *1

   Property parameters:  VALUE, LANGUAGE

   Description:

   Format definition:
       BIRTH-param
       BIRTHPLACE-param =  "VALUE=" / ("text" / "uri")
       BIRTH-value
       BIRTHPLACE-value =  text / uri
           ; Value and parameter MUST match.

       BIRTH-param

       BIRTHPLACE-param =/  altid-param / language-param / any-param

   Examples:
       BIRTH:Babies'R'Us
       BIRTHPLACE:Babies'R'Us Hospital
       BIRTH;VALUE=uri:http://example.com/hospitals/babiesrus.vcf
       BIRTH;VALUE=uri:geo:46.769307,-71.283079
       BIRTHPLACE;VALUE=uri:http://example.com/hospitals/babiesrus.vcf
       BIRTHPLACE;VALUE=uri:geo:46.769307,-71.283079

2.2.  Property: DEATH DEATHPLACE

   Namespace:

   Property name:  DEATH  DEATHPLACE

   Purpose:  To specify the place of death of the object the vCard
       represents.

   Value type:  A single text value (default) or a single URI value.

   Cardinality:  *1

   Property parameters:  VALUE, LANGUAGE

   Description:

   Format definition:
       DEATH-param
       DEATHPLACE-param =  "VALUE=" / ("text" / "uri")
       DEATH-value
       DEATHPLACE-value =  text / uri
           ; Value and parameter MUST match.

       DEATH-param

       DEATHPLACE-param =/  altid-param / language-param / any-param

   Examples:
       DEATH:Aboard
       DEATHPLACE:Aboard the Titanic\, near Newfoundland
       DEATH;VALUE=uri:http://example.com/ships/titanic.vcf
       DEATH;VALUE=uri:41.731944,-49.945833
       DEATHPLACE;VALUE=uri:http://example.com/ships/titanic.vcf
       DEATHPLACE;VALUE=uri:41.731944,-49.945833

2.3.  Property: DDAY DEATHDATE

   Namespace:

   Property name:  DDAY  DEATHDATE

   Purpose:  To specify the date of death of the object the vCard
       represents.

   Value type:  The default is a single date-and-or-time value.  It can
       also be reset to a single text value.

   Cardinality:  *1

   Property parameters:  VALUE, CALSCALE, LANGUAGE
       CALSCALE can only be present when the value is a
       date-and-or-time value and actually contains a date or date-time.
       LANGUAGE can only be present when the value is text.

   Description:

   Format definition:
       DDAY-param
       DEATHDATE-param =  DDAY-param-date  DEATHDATE-param-date / DDAY-param-text
       DDAY-value DEATHDATE-param-text
       DEATHDATE-value =  date-and-or-time / text
           ; Value and parameter MUST match.

       DDAY-param-date

       DEATHDATE-param-date =  "VALUE=date-and-or-time"
       DDAY-param-text
       DEATHDATE-param-text =  "VALUE=text" / language-param

       DDAY-param

       DEATHDATE-param =/  altid-param / calscale-param / any-param
           ; calscale-param can only be present when DDAY-value DEATHDATE-value is
           ; date-and-or-time and actually contains a date or date-time.

   Examples:
       DDAY:19960415
       DDAY:--0415
       DDAY;19531015T231000Z
       DDAY;VALUE=text:circa
       DEATHDATE:19960415
       DEATHDATE:--0415
       DEATHDATE;19531015T231000Z
       DEATHDATE;VALUE=text:circa 1800

3.  Security Considerations

   This presents no security considerations beyond those in section 9 of
   the base vcard specification [I-D.ietf-vcarddav-vcardrev].

4.  IANA Considerations

   The IANA is requested to add the following entries to the vCard
   Properties registry, defined in [I-D.ietf-vcarddav-vcardrev] section
   10.3.1.

         +-----------+--------------+---------+------------------------+
         | Namespace | Property     | Status  | Reference              |
         +-----------+--------------+---------+------------------------+
         |           | BIRTH BIRTHPLACE   | Current | RFCXXXX, section 2.1   |
         |           | DEATH DEATHPLACE   | Current | RFCXXXX, section 2.2   |
         |           | DDAY DEATHDATE    | Current | RFCXXXX, section 2.3   |
         +-----------+--------------+---------+------------------------+

5.  Acknowledgements

   The author of this draft would like thank the authors of
   draft-ietf-vcarddav-vcardrev-13, because much of the text is copied
   from there.

6.  Normative References

   [I-D.ietf-vcarddav-vcardrev]
              Perreault, S. and P. Resnick, S., "vCard Format Specification", draft-ietf-vcarddav-vcardrev-15
              draft-ietf-vcarddav-vcardrev-22 (work in progress), December 2010.
              May 2011.

   [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.

Authors' Addresses

   Kepeng Li
   Huawei Technologies
   Huawei Base, Bantian, Longgang District
   Shenzhen, Guangdong  518129
   P. R. China

   Phone: +86-755-28974289
   Email: likepeng@huawei.com

   Barry Leiba
   Huawei Technologies

   Phone: +1 646 827 0648
   Email: barryleiba@computer.org
   URI:   http://internetmessagingtechnology.org/