asciidoctor-rfc 0.8.0 → 0.8.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (137) hide show
  1. checksums.yaml +4 -4
  2. data/.hound.yml +3 -0
  3. data/.rubocop.ribose.yml +65 -0
  4. data/.rubocop.tb.yml +640 -0
  5. data/.rubocop.yml +13 -30
  6. data/.travis.yml +8 -3
  7. data/CODE_OF_CONDUCT.md +46 -0
  8. data/Gemfile +8 -1
  9. data/LICENSE +21 -17
  10. data/README.adoc +471 -52
  11. data/asciidoctor-rfc.gemspec +14 -13
  12. data/lib/asciidoctor-rfc.rb +4 -4
  13. data/lib/asciidoctor/rfc/common/base.rb +304 -58
  14. data/lib/asciidoctor/rfc/common/front.rb +3 -3
  15. data/lib/asciidoctor/rfc/v2/base.rb +71 -82
  16. data/lib/asciidoctor/rfc/v2/blocks.rb +33 -10
  17. data/lib/asciidoctor/rfc/v2/converter.rb +0 -3
  18. data/lib/asciidoctor/rfc/v2/inline_anchor.rb +35 -20
  19. data/lib/asciidoctor/rfc/v2/lists.rb +11 -13
  20. data/lib/asciidoctor/rfc/v2/table.rb +11 -9
  21. data/lib/asciidoctor/rfc/v2/validate.rb +18 -724
  22. data/lib/asciidoctor/rfc/v3/base.rb +75 -102
  23. data/lib/asciidoctor/rfc/v3/blocks.rb +7 -9
  24. data/lib/asciidoctor/rfc/v3/converter.rb +0 -1
  25. data/lib/asciidoctor/rfc/v3/front.rb +14 -7
  26. data/lib/asciidoctor/rfc/v3/inline_anchor.rb +12 -9
  27. data/lib/asciidoctor/rfc/v3/lists.rb +31 -45
  28. data/lib/asciidoctor/rfc/v3/table.rb +2 -2
  29. data/lib/asciidoctor/rfc/v3/validate.rb +19 -2153
  30. data/lib/asciidoctor/rfc/v3/validate.rng +1 -1
  31. data/lib/asciidoctor/rfc/version.rb +1 -1
  32. data/rfc2629-other.ent +61 -0
  33. data/rfc2629-xhtml.ent +165 -0
  34. data/rfc2629.dtd +312 -0
  35. data/spec/asciidoctor/rfc/v2/biblio_spec.rb +9 -0
  36. data/spec/asciidoctor/rfc/v2/comments_spec.rb +67 -1
  37. data/spec/asciidoctor/rfc/v2/crossref_spec.rb +127 -5
  38. data/spec/asciidoctor/rfc/v2/date_spec.rb +24 -28
  39. data/spec/asciidoctor/rfc/v2/dlist_spec.rb +5 -5
  40. data/spec/asciidoctor/rfc/v2/image_spec.rb +2 -2
  41. data/spec/asciidoctor/rfc/v2/inline_formatting_spec.rb +28 -0
  42. data/spec/asciidoctor/rfc/v2/listing_spec.rb +2 -2
  43. data/spec/asciidoctor/rfc/v2/literal_spec.rb +4 -4
  44. data/spec/asciidoctor/rfc/v2/preamble_spec.rb +1 -1
  45. data/spec/asciidoctor/rfc/v2/quote_spec.rb +1 -1
  46. data/spec/asciidoctor/rfc/v2/references_spec.rb +210 -3
  47. data/spec/asciidoctor/rfc/v2/section_spec.rb +33 -0
  48. data/spec/asciidoctor/rfc/v2/table_spec.rb +40 -1
  49. data/spec/asciidoctor/rfc/v2/text_spec.rb +71 -14
  50. data/spec/asciidoctor/rfc/v2/ulist_spec.rb +1 -1
  51. data/spec/asciidoctor/rfc/v3/biblio_spec.rb +13 -0
  52. data/spec/asciidoctor/rfc/v3/comments_spec.rb +71 -0
  53. data/spec/asciidoctor/rfc/v3/crossref_spec.rb +7 -0
  54. data/spec/asciidoctor/rfc/v3/dlist_spec.rb +4 -4
  55. data/spec/asciidoctor/rfc/v3/literal_spec.rb +1 -1
  56. data/spec/asciidoctor/rfc/v3/preamble_spec.rb +1 -1
  57. data/spec/asciidoctor/rfc/v3/references_spec.rb +208 -3
  58. data/spec/asciidoctor/rfc/v3/series_info_spec.rb +1 -1
  59. data/spec/asciidoctor/rfc/v3/table_spec.rb +70 -1
  60. data/spec/examples/README.adoc +42 -6
  61. data/spec/examples/biblio-insert-v2.adoc +29 -0
  62. data/spec/examples/biblio-insert-v3.adoc +30 -0
  63. data/spec/examples/davies-template-bare-06.adoc +1 -0
  64. data/spec/examples/draft-iab-html-rfc-bis.xml.adoc +2300 -0
  65. data/spec/examples/draft-iab-html-rfc-bis.xml.orig +1999 -0
  66. data/spec/examples/draft-iab-html-rfc-bis.xml.txt +2298 -0
  67. data/spec/examples/draft-iab-rfc-framework-bis.xml.adoc +662 -0
  68. data/spec/examples/draft-iab-rfc-framework-bis.xml.orig +476 -0
  69. data/spec/examples/draft-ietf-core-block-xx.mkd.adoc +8 -33
  70. data/spec/examples/hoffmanv2.xml.adoc +4 -0
  71. data/spec/examples/mib-doc-template-xml-06.adoc +6 -8
  72. data/spec/examples/refs-v2-database.xml +86 -0
  73. data/spec/examples/refs-v2.adoc +49 -0
  74. data/spec/examples/refs-v2.xml +50 -0
  75. data/spec/examples/refs-v2/AsciiDoc.xml +8 -0
  76. data/spec/examples/refs-v2/AsciiMathML.xml +8 -0
  77. data/spec/examples/refs-v2/IETF-BibXML.xml +9 -0
  78. data/spec/examples/refs-v2/MathJax.xml +8 -0
  79. data/spec/examples/refs-v2/NroffEdit.xml +8 -0
  80. data/spec/examples/refs-v2/TeX-LaTeX.xml +8 -0
  81. data/spec/examples/refs-v2/abarth +17 -0
  82. data/spec/examples/refs-v2/asciidoctor-bibliography.xml +19 -0
  83. data/spec/examples/refs-v2/asciidoctor-manual.xml +11 -0
  84. data/spec/examples/refs-v2/asciidoctor-rfc.xml +18 -0
  85. data/spec/examples/refs-v2/asciidoctor.xml +10 -0
  86. data/spec/examples/refs-v2/draftr.xml +8 -0
  87. data/spec/examples/refs-v2/kramdown-rfc2629.xml +8 -0
  88. data/spec/examples/refs-v2/lyx2rfc.xml +8 -0
  89. data/spec/examples/refs-v2/mmark.xml +9 -0
  90. data/spec/examples/refs-v2/pandoc2rfc.xml +8 -0
  91. data/spec/examples/refs-v2/reference.RFC.2119.xml +7 -0
  92. data/spec/examples/refs-v2/reference.RFC.5385.xml +7 -0
  93. data/spec/examples/refs-v2/reference.RFC.7328.xml +7 -0
  94. data/spec/examples/refs-v2/reference.RFC.7749.xml +7 -0
  95. data/spec/examples/refs-v2/reference.RFC.7763.xml +7 -0
  96. data/spec/examples/refs-v2/reference.RFC.7764.xml +7 -0
  97. data/spec/examples/refs-v2/reference.RFC.7990.xml +7 -0
  98. data/spec/examples/refs-v2/reference.RFC.7991.xml +7 -0
  99. data/spec/examples/refs-v3-database.xml +137 -0
  100. data/spec/examples/refs-v3.adoc +57 -0
  101. data/spec/examples/refs-v3.xml +90 -0
  102. data/spec/examples/refs-v3/AsciiDoc.xml +8 -0
  103. data/spec/examples/refs-v3/AsciiMathML.xml +8 -0
  104. data/spec/examples/refs-v3/IETF-BibXML.xml +9 -0
  105. data/spec/examples/refs-v3/MathJax.xml +8 -0
  106. data/spec/examples/refs-v3/NroffEdit.xml +8 -0
  107. data/spec/examples/refs-v3/TeX-LaTeX.xml +8 -0
  108. data/spec/examples/refs-v3/abarth +17 -0
  109. data/spec/examples/refs-v3/asciidoctor-bibliography.xml +19 -0
  110. data/spec/examples/refs-v3/asciidoctor-manual.xml +11 -0
  111. data/spec/examples/refs-v3/asciidoctor-rfc.xml +18 -0
  112. data/spec/examples/refs-v3/asciidoctor.xml +10 -0
  113. data/spec/examples/refs-v3/draftr.xml +8 -0
  114. data/spec/examples/refs-v3/kramdown-rfc2629.xml +8 -0
  115. data/spec/examples/refs-v3/lyx2rfc.xml +8 -0
  116. data/spec/examples/refs-v3/mathrefs.xml +19 -0
  117. data/spec/examples/refs-v3/mmark.xml +9 -0
  118. data/spec/examples/refs-v3/pandoc2rfc.xml +8 -0
  119. data/spec/examples/refs-v3/reference.RFC.2119.xml +7 -0
  120. data/spec/examples/refs-v3/reference.RFC.5385.xml +7 -0
  121. data/spec/examples/refs-v3/reference.RFC.7328.xml +7 -0
  122. data/spec/examples/refs-v3/reference.RFC.7749.xml +7 -0
  123. data/spec/examples/refs-v3/reference.RFC.7763.xml +7 -0
  124. data/spec/examples/refs-v3/reference.RFC.7764.xml +7 -0
  125. data/spec/examples/refs-v3/reference.RFC.7990.xml +7 -0
  126. data/spec/examples/refs-v3/reference.RFC.7991.xml +7 -0
  127. data/spec/examples/rfc2100.md.adoc +57 -44
  128. data/spec/examples/rfc3514.md.adoc +1 -1
  129. data/spec/examples/rfc6350.adoc +701 -695
  130. data/spec/examples/rfc6350.txt.orig +3372 -0
  131. data/spec/examples/rfc6350_refs.xml +774 -0
  132. data/spec/examples/rfc748.md.adoc +1 -1
  133. data/spec/examples/rfc7511.md.adoc +3 -3
  134. data/spec/examples/skel.mkd.adoc +1 -0
  135. data/spec/examples/stupid-s.mkd.adoc +4 -4
  136. metadata +94 -8
  137. data/spec/examples/rfc6350.bib +0 -763
@@ -0,0 +1,3372 @@
1
+
2
+
3
+ Internet Engineering Task Force (IETF) S. Perreault
4
+ Request for Comments: 6350 Viagenie
5
+ Obsoletes: 2425, 2426, 4770 August 2011
6
+ Updates: 2739
7
+ Category: Standards Track
8
+ ISSN: 2070-1721
9
+
10
+ vCard Format Specification
11
+
12
+ Abstract
13
+
14
+ This document defines the vCard data format for representing and
15
+ exchanging a variety of information about individuals and other
16
+ entities (e.g., formatted and structured name and delivery addresses,
17
+ email address, multiple telephone numbers, photograph, logo, audio
18
+ clips, etc.). This document obsoletes RFCs 2425, 2426, and 4770, and
19
+ updates RFC 2739.
20
+
21
+ Status of This Memo
22
+
23
+ This is an Internet Standards Track document.
24
+
25
+ This document is a product of the Internet Engineering Task Force
26
+ (IETF). It represents the consensus of the IETF community. It has
27
+ received public review and has been approved for publication by the
28
+ Internet Engineering Steering Group (IESG). Further information on
29
+ Internet Standards is available in Section 2 of RFC 5741.
30
+
31
+ Information about the current status of this document, any errata,
32
+ and how to provide feedback on it may be obtained at
33
+ http://www.rfc-editor.org/info/rfc6350.
34
+
35
+ Copyright Notice
36
+
37
+ Copyright (c) 2011 IETF Trust and the persons identified as the
38
+ document authors. All rights reserved.
39
+
40
+ This document is subject to BCP 78 and the IETF Trust's Legal
41
+ Provisions Relating to IETF Documents
42
+ (http://trustee.ietf.org/license-info) in effect on the date of
43
+ publication of this document. Please review these documents
44
+ carefully, as they describe your rights and restrictions with respect
45
+ to this document. Code Components extracted from this document must
46
+ include Simplified BSD License text as described in Section 4.e of
47
+ the Trust Legal Provisions and are provided without warranty as
48
+ described in the Simplified BSD License.
49
+
50
+ This document may contain material from IETF Documents or IETF
51
+ Contributions published or made publicly available before November
52
+ 10, 2008. The person(s) controlling the copyright in some of this
53
+ material may not have granted the IETF Trust the right to allow
54
+ modifications of such material outside the IETF Standards Process.
55
+ Without obtaining an adequate license from the person(s) controlling
56
+ the copyright in such materials, this document may not be modified
57
+ outside the IETF Standards Process, and derivative works of it may
58
+ not be created outside the IETF Standards Process, except to format
59
+ it for publication as an RFC or to translate it into languages other
60
+ than English.
61
+
62
+ Table of Contents
63
+
64
+ 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5
65
+ 2. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 5
66
+ 3. vCard Format Specification . . . . . . . . . . . . . . . . . . 5
67
+ 3.1. Charset . . . . . . . . . . . . . . . . . . . . . . . . . 5
68
+ 3.2. Line Delimiting and Folding . . . . . . . . . . . . . . . 5
69
+ 3.3. ABNF Format Definition . . . . . . . . . . . . . . . . . . 6
70
+ 3.4. Property Value Escaping . . . . . . . . . . . . . . . . . 9
71
+ 4. Property Value Data Types . . . . . . . . . . . . . . . . . . 9
72
+ 4.1. TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
73
+ 4.2. URI . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
74
+ 4.3. DATE, TIME, DATE-TIME, DATE-AND-OR-TIME, and TIMESTAMP . . 12
75
+ 4.3.1. DATE . . . . . . . . . . . . . . . . . . . . . . . . . 12
76
+ 4.3.2. TIME . . . . . . . . . . . . . . . . . . . . . . . . . 13
77
+ 4.3.3. DATE-TIME . . . . . . . . . . . . . . . . . . . . . . 13
78
+ 4.3.4. DATE-AND-OR-TIME . . . . . . . . . . . . . . . . . . . 14
79
+ 4.3.5. TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . 14
80
+ 4.4. BOOLEAN . . . . . . . . . . . . . . . . . . . . . . . . . 14
81
+ 4.5. INTEGER . . . . . . . . . . . . . . . . . . . . . . . . . 15
82
+ 4.6. FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . 15
83
+ 4.7. UTC-OFFSET . . . . . . . . . . . . . . . . . . . . . . . . 15
84
+ 4.8. LANGUAGE-TAG . . . . . . . . . . . . . . . . . . . . . . . 16
85
+ 5. Property Parameters . . . . . . . . . . . . . . . . . . . . . 16
86
+ 5.1. LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . 16
87
+ 5.2. VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . 16
88
+ 5.3. PREF . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
89
+ 5.4. ALTID . . . . . . . . . . . . . . . . . . . . . . . . . . 18
90
+ 5.5. PID . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
91
+ 5.6. TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
92
+ 5.7. MEDIATYPE . . . . . . . . . . . . . . . . . . . . . . . . 20
93
+ 5.8. CALSCALE . . . . . . . . . . . . . . . . . . . . . . . . . 20
94
+ 5.9. SORT-AS . . . . . . . . . . . . . . . . . . . . . . . . . 21
95
+ 5.10. GEO . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
96
+ 5.11. TZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
97
+
98
+ 6. vCard Properties . . . . . . . . . . . . . . . . . . . . . . . 23
99
+ 6.1. General Properties . . . . . . . . . . . . . . . . . . . . 23
100
+ 6.1.1. BEGIN . . . . . . . . . . . . . . . . . . . . . . . . 23
101
+ 6.1.2. END . . . . . . . . . . . . . . . . . . . . . . . . . 23
102
+ 6.1.3. SOURCE . . . . . . . . . . . . . . . . . . . . . . . . 24
103
+ 6.1.4. KIND . . . . . . . . . . . . . . . . . . . . . . . . . 25
104
+ 6.1.5. XML . . . . . . . . . . . . . . . . . . . . . . . . . 27
105
+ 6.2. Identification Properties . . . . . . . . . . . . . . . . 28
106
+ 6.2.1. FN . . . . . . . . . . . . . . . . . . . . . . . . . . 28
107
+ 6.2.2. N . . . . . . . . . . . . . . . . . . . . . . . . . . 29
108
+ 6.2.3. NICKNAME . . . . . . . . . . . . . . . . . . . . . . . 29
109
+ 6.2.4. PHOTO . . . . . . . . . . . . . . . . . . . . . . . . 30
110
+ 6.2.5. BDAY . . . . . . . . . . . . . . . . . . . . . . . . . 30
111
+ 6.2.6. ANNIVERSARY . . . . . . . . . . . . . . . . . . . . . 31
112
+ 6.2.7. GENDER . . . . . . . . . . . . . . . . . . . . . . . . 32
113
+ 6.3. Delivery Addressing Properties . . . . . . . . . . . . . . 32
114
+ 6.3.1. ADR . . . . . . . . . . . . . . . . . . . . . . . . . 32
115
+ 6.4. Communications Properties . . . . . . . . . . . . . . . . 34
116
+ 6.4.1. TEL . . . . . . . . . . . . . . . . . . . . . . . . . 34
117
+ 6.4.2. EMAIL . . . . . . . . . . . . . . . . . . . . . . . . 36
118
+ 6.4.3. IMPP . . . . . . . . . . . . . . . . . . . . . . . . . 36
119
+ 6.4.4. LANG . . . . . . . . . . . . . . . . . . . . . . . . . 37
120
+ 6.5. Geographical Properties . . . . . . . . . . . . . . . . . 37
121
+ 6.5.1. TZ . . . . . . . . . . . . . . . . . . . . . . . . . . 37
122
+ 6.5.2. GEO . . . . . . . . . . . . . . . . . . . . . . . . . 38
123
+ 6.6. Organizational Properties . . . . . . . . . . . . . . . . 39
124
+ 6.6.1. TITLE . . . . . . . . . . . . . . . . . . . . . . . . 39
125
+ 6.6.2. ROLE . . . . . . . . . . . . . . . . . . . . . . . . . 39
126
+ 6.6.3. LOGO . . . . . . . . . . . . . . . . . . . . . . . . . 40
127
+ 6.6.4. ORG . . . . . . . . . . . . . . . . . . . . . . . . . 40
128
+ 6.6.5. MEMBER . . . . . . . . . . . . . . . . . . . . . . . . 41
129
+ 6.6.6. RELATED . . . . . . . . . . . . . . . . . . . . . . . 42
130
+ 6.7. Explanatory Properties . . . . . . . . . . . . . . . . . . 43
131
+ 6.7.1. CATEGORIES . . . . . . . . . . . . . . . . . . . . . . 43
132
+ 6.7.2. NOTE . . . . . . . . . . . . . . . . . . . . . . . . . 44
133
+ 6.7.3. PRODID . . . . . . . . . . . . . . . . . . . . . . . . 44
134
+ 6.7.4. REV . . . . . . . . . . . . . . . . . . . . . . . . . 45
135
+ 6.7.5. SOUND . . . . . . . . . . . . . . . . . . . . . . . . 45
136
+ 6.7.6. UID . . . . . . . . . . . . . . . . . . . . . . . . . 46
137
+ 6.7.7. CLIENTPIDMAP . . . . . . . . . . . . . . . . . . . . . 47
138
+ 6.7.8. URL . . . . . . . . . . . . . . . . . . . . . . . . . 47
139
+ 6.7.9. VERSION . . . . . . . . . . . . . . . . . . . . . . . 48
140
+ 6.8. Security Properties . . . . . . . . . . . . . . . . . . . 48
141
+ 6.8.1. KEY . . . . . . . . . . . . . . . . . . . . . . . . . 48
142
+ 6.9. Calendar Properties . . . . . . . . . . . . . . . . . . . 49
143
+ 6.9.1. FBURL . . . . . . . . . . . . . . . . . . . . . . . . 49
144
+ 6.9.2. CALADRURI . . . . . . . . . . . . . . . . . . . . . . 50
145
+ 6.9.3. CALURI . . . . . . . . . . . . . . . . . . . . . . . . 50
146
+
147
+ 6.10. Extended Properties and Parameters . . . . . . . . . . . . 51
148
+ 7. Synchronization . . . . . . . . . . . . . . . . . . . . . . . 51
149
+ 7.1. Mechanisms . . . . . . . . . . . . . . . . . . . . . . . . 51
150
+ 7.1.1. Matching vCard Instances . . . . . . . . . . . . . . . 51
151
+ 7.1.2. Matching Property Instances . . . . . . . . . . . . . 52
152
+ 7.1.3. PID Matching . . . . . . . . . . . . . . . . . . . . . 52
153
+ 7.2. Example . . . . . . . . . . . . . . . . . . . . . . . . . 53
154
+ 7.2.1. Creation . . . . . . . . . . . . . . . . . . . . . . . 53
155
+ 7.2.2. Initial Sharing . . . . . . . . . . . . . . . . . . . 53
156
+ 7.2.3. Adding and Sharing a Property . . . . . . . . . . . . 54
157
+ 7.2.4. Simultaneous Editing . . . . . . . . . . . . . . . . . 54
158
+ 7.2.5. Global Context Simplification . . . . . . . . . . . . 56
159
+ 8. Example: Author's vCard . . . . . . . . . . . . . . . . . . . 56
160
+ 9. Security Considerations . . . . . . . . . . . . . . . . . . . 57
161
+ 10. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 58
162
+ 10.1. Media Type Registration . . . . . . . . . . . . . . . . . 58
163
+ 10.2. Registering New vCard Elements . . . . . . . . . . . . . . 59
164
+ 10.2.1. Registration Procedure . . . . . . . . . . . . . . . . 59
165
+ 10.2.2. Vendor Namespace . . . . . . . . . . . . . . . . . . . 60
166
+ 10.2.3. Registration Template for Properties . . . . . . . . . 61
167
+ 10.2.4. Registration Template for Parameters . . . . . . . . . 61
168
+ 10.2.5. Registration Template for Value Data Types . . . . . . 62
169
+ 10.2.6. Registration Template for Values . . . . . . . . . . . 62
170
+ 10.3. Initial vCard Elements Registries . . . . . . . . . . . . 63
171
+ 10.3.1. Properties Registry . . . . . . . . . . . . . . . . . 64
172
+ 10.3.2. Parameters Registry . . . . . . . . . . . . . . . . . 65
173
+ 10.3.3. Value Data Types Registry . . . . . . . . . . . . . . 65
174
+ 10.3.4. Values Registries . . . . . . . . . . . . . . . . . . 66
175
+ 11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 69
176
+ 12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 69
177
+ 12.1. Normative References . . . . . . . . . . . . . . . . . . . 69
178
+ 12.2. Informative References . . . . . . . . . . . . . . . . . . 71
179
+ Appendix A. Differences from RFCs 2425 and 2426 . . . . . . . . . 73
180
+ A.1. New Structure . . . . . . . . . . . . . . . . . . . . . . 73
181
+ A.2. Removed Features . . . . . . . . . . . . . . . . . . . . . 73
182
+ A.3. New Properties and Parameters . . . . . . . . . . . . . . 73
183
+
184
+ 1. Introduction
185
+
186
+ Electronic address books have become ubiquitous. Their increased
187
+ presence on portable, connected devices as well as the diversity of
188
+ platforms that exchange contact data call for a standard. This memo
189
+ defines the vCard format, which allows the capture and exchange of
190
+ information normally stored within an address book or directory
191
+ application.
192
+
193
+ A high-level overview of the differences from RFCs 2425 and 2426 can
194
+ be found in Appendix A.
195
+
196
+ 2. Conventions
197
+
198
+ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
199
+ "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
200
+ "OPTIONAL" in this document are to be interpreted as described in
201
+ [RFC2119].
202
+
203
+ 3. vCard Format Specification
204
+
205
+ The text/vcard MIME content type (hereafter known as "vCard"; see
206
+ Section 10.1) contains contact information, typically pertaining to a
207
+ single contact or group of contacts. The content consists of one or
208
+ more lines in the format given below.
209
+
210
+ 3.1. Charset
211
+
212
+ The charset (see [RFC3536] for internationalization terminology) for
213
+ vCard is UTF-8 as defined in [RFC3629]. There is no way to override
214
+ this. It is invalid to specify a value other than "UTF-8" in the
215
+ "charset" MIME parameter (see Section 10.1).
216
+
217
+ 3.2. Line Delimiting and Folding
218
+
219
+ Individual lines within vCard are delimited by the [RFC5322] line
220
+ break, which is a CRLF sequence (U+000D followed by U+000A). Long
221
+ logical lines of text can be split into a multiple-physical-line
222
+ representation using the following folding technique. Content lines
223
+ SHOULD be folded to a maximum width of 75 octets, excluding the line
224
+ break. Multi-octet characters MUST remain contiguous. The rationale
225
+ for this folding process can be found in [RFC5322], Section 2.1.1.
226
+
227
+ A logical line MAY be continued on the next physical line anywhere
228
+ between two characters by inserting a CRLF immediately followed by a
229
+ single white space character (space (U+0020) or horizontal tab
230
+ (U+0009)). The folded line MUST contain at least one character. Any
231
+ sequence of CRLF followed immediately by a single white space
232
+
233
+ character is ignored (removed) when processing the content type. For
234
+ example, the line:
235
+
236
+ NOTE:This is a long description that exists on a long line.
237
+
238
+ can be represented as:
239
+
240
+ NOTE:This is a long description
241
+ that exists on a long line.
242
+
243
+ It could also be represented as:
244
+
245
+ NOTE:This is a long descrip
246
+ tion that exists o
247
+ n a long line.
248
+
249
+ The process of moving from this folded multiple-line representation
250
+ of a property definition to its single-line representation is called
251
+ unfolding. Unfolding is accomplished by regarding CRLF immediately
252
+ followed by a white space character (namely, HTAB (U+0009) or SPACE
253
+ (U+0020)) as equivalent to no characters at all (i.e., the CRLF and
254
+ single white space character are removed).
255
+
256
+ Note: It is possible for very simple implementations to generate
257
+ improperly folded lines in the middle of a UTF-8 multi-octet
258
+ sequence. For this reason, implementations SHOULD unfold lines in
259
+ such a way as to properly restore the original sequence.
260
+
261
+ Note: Unfolding is done differently than in [RFC5322]. Unfolding
262
+ in [RFC5322] only removes the CRLF, not the space following it.
263
+
264
+ Folding is done after any content encoding of a type value.
265
+ Unfolding is done before any decoding of a type value in a content
266
+ line.
267
+
268
+ 3.3. ABNF Format Definition
269
+
270
+ The following ABNF uses the notation of [RFC5234], which also defines
271
+ CRLF, WSP, DQUOTE, VCHAR, ALPHA, and DIGIT.
272
+
273
+ vcard-entity = 1*vcard
274
+
275
+ vcard = "BEGIN:VCARD" CRLF
276
+ "VERSION:4.0" CRLF
277
+ 1*contentline
278
+ "END:VCARD" CRLF
279
+ ; A vCard object MUST include the VERSION and FN properties.
280
+ ; VERSION MUST come immediately after BEGIN:VCARD.
281
+
282
+ contentline = [group "."] name *(";" param) ":" value CRLF
283
+ ; When parsing a content line, folded lines must first
284
+ ; be unfolded according to the unfolding procedure
285
+ ; described in Section 3.2.
286
+ ; When generating a content line, lines longer than 75
287
+ ; characters SHOULD be folded according to the folding
288
+ ; procedure described in Section 3.2.
289
+
290
+ group = 1*(ALPHA / DIGIT / "-")
291
+ name = "SOURCE" / "KIND" / "FN" / "N" / "NICKNAME"
292
+ / "PHOTO" / "BDAY" / "ANNIVERSARY" / "GENDER" / "ADR" / "TEL"
293
+ / "EMAIL" / "IMPP" / "LANG" / "TZ" / "GEO" / "TITLE" / "ROLE"
294
+ / "LOGO" / "ORG" / "MEMBER" / "RELATED" / "CATEGORIES"
295
+ / "NOTE" / "PRODID" / "REV" / "SOUND" / "UID" / "CLIENTPIDMAP"
296
+ / "URL" / "KEY" / "FBURL" / "CALADRURI" / "CALURI" / "XML"
297
+ / iana-token / x-name
298
+ ; Parsing of the param and value is based on the "name" as
299
+ ; defined in ABNF sections below.
300
+ ; Group and name are case-insensitive.
301
+
302
+ iana-token = 1*(ALPHA / DIGIT / "-")
303
+ ; identifier registered with IANA
304
+
305
+ x-name = "x-" 1*(ALPHA / DIGIT / "-")
306
+ ; Names that begin with "x-" or "X-" are
307
+ ; reserved for experimental use, not intended for released
308
+ ; products, or for use in bilateral agreements.
309
+
310
+ param = language-param / value-param / pref-param / pid-param
311
+ / type-param / geo-parameter / tz-parameter / sort-as-param
312
+ / calscale-param / any-param
313
+ ; Allowed parameters depend on property name.
314
+
315
+ param-value = *SAFE-CHAR / DQUOTE *QSAFE-CHAR DQUOTE
316
+
317
+ any-param = (iana-token / x-name) "=" param-value *("," param-value)
318
+
319
+ NON-ASCII = UTF8-2 / UTF8-3 / UTF8-4
320
+ ; UTF8-{2,3,4} are defined in [RFC3629]
321
+
322
+ QSAFE-CHAR = WSP / "!" / %x23-7E / NON-ASCII
323
+ ; Any character except CTLs, DQUOTE
324
+
325
+ SAFE-CHAR = WSP / "!" / %x23-39 / %x3C-7E / NON-ASCII
326
+ ; Any character except CTLs, DQUOTE, ";", ":"
327
+
328
+ VALUE-CHAR = WSP / VCHAR / NON-ASCII
329
+ ; Any textual character
330
+
331
+ A line that begins with a white space character is a continuation of
332
+ the previous line, as described in Section 3.2. The white space
333
+ character and immediately preceeding CRLF should be discarded when
334
+ reconstructing the original line. Note that this line-folding
335
+ convention differs from that found in [RFC5322], in that the sequence
336
+ <CRLF><WSP> found anywhere in the content indicates a continued line
337
+ and should be removed.
338
+
339
+ Property names and parameter names are case-insensitive (e.g., the
340
+ property name "fn" is the same as "FN" and "Fn"). Parameter values
341
+ MAY be case-sensitive or case-insensitive, depending on their
342
+ definition. Parameter values that are not explicitly defined as
343
+ being case-sensitive are case-insensitive. Based on experience with
344
+ vCard 3 interoperability, it is RECOMMENDED that property and
345
+ parameter names be upper-case on output.
346
+
347
+ The group construct is used to group related properties together.
348
+ The group name is a syntactic convention used to indicate that all
349
+ property names prefaced with the same group name SHOULD be grouped
350
+ together when displayed by an application. It has no other
351
+ significance. Implementations that do not understand or support
352
+ grouping MAY simply strip off any text before a "." to the left of
353
+ the type name and present the types and values as normal.
354
+
355
+ Property cardinalities are indicated using the following notation,
356
+ which is based on ABNF (see [RFC5234], Section 3.6):
357
+
358
+ +-------------+--------------------------------------------------+
359
+ | Cardinality | Meaning |
360
+ +-------------+--------------------------------------------------+
361
+ | 1 | Exactly one instance per vCard MUST be present. |
362
+ | *1 | Exactly one instance per vCard MAY be present. |
363
+ | 1* | One or more instances per vCard MUST be present. |
364
+ | * | One or more instances per vCard MAY be present. |
365
+ +-------------+--------------------------------------------------+
366
+
367
+ Properties defined in a vCard instance may have multiple values
368
+ depending on the property cardinality. The general rule for encoding
369
+ multi-valued properties is to simply create a new content line for
370
+ each value (including the property name). However, it should be
371
+ noted that some value types support encoding multiple values in a
372
+ single content line by separating the values with a comma ",". This
373
+ approach has been taken for several of the content types defined
374
+ below (date, time, integer, float).
375
+
376
+ 3.4. Property Value Escaping
377
+
378
+ Some properties may contain one or more values delimited by a COMMA
379
+ character (U+002C). Therefore, a COMMA character in a value MUST be
380
+ escaped with a BACKSLASH character (U+005C), even for properties that
381
+ don't allow multiple instances (for consistency).
382
+
383
+ Some properties (e.g., N and ADR) comprise multiple fields delimited
384
+ by a SEMICOLON character (U+003B). Therefore, a SEMICOLON in a field
385
+ of such a "compound" property MUST be escaped with a BACKSLASH
386
+ character. SEMICOLON characters in non-compound properties MAY be
387
+ escaped. On input, an escaped SEMICOLON character is never a field
388
+ separator. An unescaped SEMICOLON character may be a field
389
+ separator, depending on the property in which it appears.
390
+
391
+ Furthermore, some fields of compound properties may contain a list of
392
+ values delimited by a COMMA character. Therefore, a COMMA character
393
+ in one of a field's values MUST be escaped with a BACKSLASH
394
+ character, even for fields that don't allow multiple values (for
395
+ consistency). Compound properties allowing multiple instances MUST
396
+ NOT be encoded in a single content line.
397
+
398
+ Finally, BACKSLASH characters in values MUST be escaped with a
399
+ BACKSLASH character. NEWLINE (U+000A) characters in values MUST be
400
+ encoded by two characters: a BACKSLASH followed by either an 'n'
401
+ (U+006E) or an 'N' (U+004E).
402
+
403
+ In all other cases, escaping MUST NOT be used.
404
+
405
+ 4. Property Value Data Types
406
+
407
+ Standard value types are defined below.
408
+
409
+ value = text
410
+ / text-list
411
+ / date-list
412
+ / time-list
413
+ / date-time-list
414
+ / date-and-or-time-list
415
+ / timestamp-list
416
+ / boolean
417
+ / integer-list
418
+ / float-list
419
+ / URI ; from Section 3 of [RFC3986]
420
+ / utc-offset
421
+ / Language-Tag
422
+ / iana-valuespec
423
+ ; Actual value type depends on property name and VALUE parameter.
424
+
425
+ text = *TEXT-CHAR
426
+
427
+ TEXT-CHAR = "\\" / "\," / "\n" / WSP / NON-ASCII
428
+ / %x21-2B / %x2D-5B / %x5D-7E
429
+ ; Backslashes, commas, and newlines must be encoded.
430
+
431
+ component = "\\" / "\," / "\;" / "\n" / WSP / NON-ASCII
432
+ / %x21-2B / %x2D-3A / %x3C-5B / %x5D-7E
433
+ list-component = component *("," component)
434
+
435
+ text-list = text *("," text)
436
+ date-list = date *("," date)
437
+ time-list = time *("," time)
438
+ date-time-list = date-time *("," date-time)
439
+ date-and-or-time-list = date-and-or-time *("," date-and-or-time)
440
+ timestamp-list = timestamp *("," timestamp)
441
+ integer-list = integer *("," integer)
442
+ float-list = float *("," float)
443
+
444
+ boolean = "TRUE" / "FALSE"
445
+ integer = [sign] 1*DIGIT
446
+ float = [sign] 1*DIGIT ["." 1*DIGIT]
447
+
448
+ sign = "+" / "-"
449
+
450
+ year = 4DIGIT ; 0000-9999
451
+ month = 2DIGIT ; 01-12
452
+ day = 2DIGIT ; 01-28/29/30/31 depending on month and leap year
453
+ hour = 2DIGIT ; 00-23
454
+ minute = 2DIGIT ; 00-59
455
+ second = 2DIGIT ; 00-58/59/60 depending on leap second
456
+ zone = utc-designator / utc-offset
457
+ utc-designator = %x5A ; uppercase "Z"
458
+
459
+ date = year [month day]
460
+ / year "-" month
461
+ / "--" month [day]
462
+ / "--" "-" day
463
+ date-noreduc = year month day
464
+ / "--" month day
465
+ / "--" "-" day
466
+ date-complete = year month day
467
+
468
+ time = hour [minute [second]] [zone]
469
+ / "-" minute [second] [zone]
470
+ / "-" "-" second [zone]
471
+ time-notrunc = hour [minute [second]] [zone]
472
+ time-complete = hour minute second [zone]
473
+
474
+ time-designator = %x54 ; uppercase "T"
475
+ date-time = date-noreduc time-designator time-notrunc
476
+ timestamp = date-complete time-designator time-complete
477
+
478
+ date-and-or-time = date-time / date / time-designator time
479
+
480
+ utc-offset = sign hour [minute]
481
+
482
+ Language-Tag = <Language-Tag, defined in [RFC5646], Section 2.1>
483
+
484
+ iana-valuespec = <value-spec, see Section 12>
485
+ ; a publicly defined valuetype format, registered
486
+ ; with IANA, as defined in Section 12 of this
487
+ ; document.
488
+
489
+ 4.1. TEXT
490
+
491
+ "text": The "text" value type should be used to identify values that
492
+ contain human-readable text. As for the language, it is controlled
493
+ by the LANGUAGE property parameter defined in Section 5.1.
494
+
495
+ Examples for "text":
496
+
497
+ this is a text value
498
+ this is one value,this is another
499
+ this is a single value\, with a comma encoded
500
+
501
+ A formatted text line break in a text value type MUST be represented
502
+ as the character sequence backslash (U+005C) followed by a Latin
503
+ small letter n (U+006E) or a Latin capital letter N (U+004E), that
504
+ is, "\n" or "\N".
505
+
506
+ For example, a multiple line NOTE value of:
507
+
508
+ Mythical Manager
509
+ Hyjinx Software Division
510
+ BabsCo, Inc.
511
+
512
+ could be represented as:
513
+
514
+ NOTE:Mythical Manager\nHyjinx Software Division\n
515
+ BabsCo\, Inc.\n
516
+
517
+ demonstrating the \n literal formatted line break technique, the
518
+ CRLF-followed-by-space line folding technique, and the backslash
519
+ escape technique.
520
+
521
+ 4.2. URI
522
+
523
+ "uri": The "uri" value type should be used to identify values that
524
+ are referenced by a Uniform Resource Identifier (URI) instead of
525
+ encoded in-line. These value references might be used if the value
526
+ is too large, or otherwise undesirable to include directly. The
527
+ format for the URI is as defined in Section 3 of [RFC3986]. Note
528
+ that the value of a property of type "uri" is what the URI points to,
529
+ not the URI itself.
530
+
531
+ Examples for "uri":
532
+
533
+ http://www.example.com/my/picture.jpg
534
+ ldap://ldap.example.com/cn=babs%20jensen
535
+
536
+ 4.3. DATE, TIME, DATE-TIME, DATE-AND-OR-TIME, and TIMESTAMP
537
+
538
+ "date", "time", "date-time", "date-and-or-time", and "timestamp":
539
+ Each of these value types is based on the definitions in
540
+ [ISO.8601.2004]. Multiple such values can be specified using the
541
+ comma-separated notation.
542
+
543
+ Only the basic format is supported.
544
+
545
+ 4.3.1. DATE
546
+
547
+ A calendar date as specified in [ISO.8601.2004], Section 4.1.2.
548
+
549
+ Reduced accuracy, as specified in [ISO.8601.2004], Sections 4.1.2.3
550
+ a) and b), but not c), is permitted.
551
+
552
+ Expanded representation, as specified in [ISO.8601.2004], Section
553
+ 4.1.4, is forbidden.
554
+
555
+ Truncated representation, as specified in [ISO.8601.2000], Sections
556
+ 5.2.1.3 d), e), and f), is permitted.
557
+
558
+ Examples for "date":
559
+
560
+ 19850412
561
+ 1985-04
562
+ 1985
563
+ --0412
564
+ ---12
565
+
566
+ Note the use of YYYY-MM in the second example above. YYYYMM is
567
+ disallowed to prevent confusion with YYMMDD. Note also that
568
+ YYYY-MM-DD is disallowed since we are using the basic format instead
569
+ of the extended format.
570
+
571
+ 4.3.2. TIME
572
+
573
+ A time of day as specified in [ISO.8601.2004], Section 4.2.
574
+
575
+ Reduced accuracy, as specified in [ISO.8601.2004], Section 4.2.2.3,
576
+ is permitted.
577
+
578
+ Representation with decimal fraction, as specified in
579
+ [ISO.8601.2004], Section 4.2.2.4, is forbidden.
580
+
581
+ The midnight hour is always represented by 00, never 24 (see
582
+ [ISO.8601.2004], Section 4.2.3).
583
+
584
+ Truncated representation, as specified in [ISO.8601.2000], Sections
585
+ 5.3.1.4 a), b), and c), is permitted.
586
+
587
+ Examples for "time":
588
+
589
+ 102200
590
+ 1022
591
+ 10
592
+ -2200
593
+ --00
594
+ 102200Z
595
+ 102200-0800
596
+
597
+ 4.3.3. DATE-TIME
598
+
599
+ A date and time of day combination as specified in [ISO.8601.2004],
600
+ Section 4.3.
601
+
602
+ Truncation of the date part, as specified in [ISO.8601.2000], Section
603
+ 5.4.2 c), is permitted.
604
+
605
+ Examples for "date-time":
606
+
607
+ 19961022T140000
608
+ --1022T1400
609
+ ---22T14
610
+
611
+ 4.3.4. DATE-AND-OR-TIME
612
+
613
+ Either a DATE-TIME, a DATE, or a TIME value. To allow unambiguous
614
+ interpretation, a stand-alone TIME value is always preceded by a "T".
615
+
616
+ Examples for "date-and-or-time":
617
+
618
+ 19961022T140000
619
+ --1022T1400
620
+ ---22T14
621
+ 19850412
622
+ 1985-04
623
+ 1985
624
+ --0412
625
+ ---12
626
+ T102200
627
+ T1022
628
+ T10
629
+ T-2200
630
+ T--00
631
+ T102200Z
632
+ T102200-0800
633
+
634
+ 4.3.5. TIMESTAMP
635
+
636
+ A complete date and time of day combination as specified in
637
+ [ISO.8601.2004], Section 4.3.2.
638
+
639
+ Examples for "timestamp":
640
+
641
+ 19961022T140000
642
+ 19961022T140000Z
643
+ 19961022T140000-05
644
+ 19961022T140000-0500
645
+
646
+ 4.4. BOOLEAN
647
+
648
+ "boolean": The "boolean" value type is used to express boolean
649
+ values. These values are case-insensitive.
650
+
651
+ Examples:
652
+
653
+ TRUE
654
+ false
655
+ True
656
+
657
+ 4.5. INTEGER
658
+
659
+ "integer": The "integer" value type is used to express signed
660
+ integers in decimal format. If sign is not specified, the value is
661
+ assumed positive "+". Multiple "integer" values can be specified
662
+ using the comma-separated notation. The maximum value is
663
+ 9223372036854775807, and the minimum value is -9223372036854775808.
664
+ These limits correspond to a signed 64-bit integer using two's-
665
+ complement arithmetic.
666
+
667
+ Examples:
668
+
669
+ 1234567890
670
+ -1234556790
671
+ +1234556790,432109876
672
+
673
+ 4.6. FLOAT
674
+
675
+ "float": The "float" value type is used to express real numbers. If
676
+ sign is not specified, the value is assumed positive "+". Multiple
677
+ "float" values can be specified using the comma-separated notation.
678
+ Implementations MUST support a precision equal or better than that of
679
+ the IEEE "binary64" format [IEEE.754.2008].
680
+
681
+ Note: Scientific notation is disallowed. Implementers wishing to
682
+ use their favorite language's %f formatting should be careful.
683
+
684
+ Examples:
685
+
686
+ 20.30
687
+ 1000000.0000001
688
+ 1.333,3.14
689
+
690
+ 4.7. UTC-OFFSET
691
+
692
+ "utc-offset": The "utc-offset" value type specifies that the property
693
+ value is a signed offset from UTC. This value type can be specified
694
+ in the TZ property.
695
+
696
+ The value type is an offset from Coordinated Universal Time (UTC).
697
+ It is specified as a positive or negative difference in units of
698
+ hours and minutes (e.g., +hhmm). The time is specified as a 24-hour
699
+ clock. Hour values are from 00 to 23, and minute values are from 00
700
+ to 59. Hour and minutes are 2 digits with high-order zeroes required
701
+ to maintain digit count. The basic format for ISO 8601 UTC offsets
702
+ MUST be used.
703
+
704
+ 4.8. LANGUAGE-TAG
705
+
706
+ "language-tag": A single language tag, as defined in [RFC5646].
707
+
708
+ 5. Property Parameters
709
+
710
+ A property can have attributes associated with it. These "property
711
+ parameters" contain meta-information about the property or the
712
+ property value. In some cases, the property parameter can be multi-
713
+ valued in which case the property parameter value elements are
714
+ separated by a COMMA (U+002C).
715
+
716
+ Property parameter value elements that contain the COLON (U+003A),
717
+ SEMICOLON (U+003B), or COMMA (U+002C) character separators MUST be
718
+ specified as quoted-string text values. Property parameter values
719
+ MUST NOT contain the DQUOTE (U+0022) character. The DQUOTE character
720
+ is used as a delimiter for parameter values that contain restricted
721
+ characters or URI text.
722
+
723
+ Applications MUST ignore x-param and iana-param values they don't
724
+ recognize.
725
+
726
+ 5.1. LANGUAGE
727
+
728
+ The LANGUAGE property parameter is used to identify data in multiple
729
+ languages. There is no concept of "default" language, except as
730
+ specified by any "Content-Language" MIME header parameter that is
731
+ present [RFC3282]. The value of the LANGUAGE property parameter is a
732
+ language tag as defined in Section 2 of [RFC5646].
733
+
734
+ Examples:
735
+
736
+ ROLE;LANGUAGE=tr:hoca
737
+
738
+ ABNF:
739
+
740
+ language-param = "LANGUAGE=" Language-Tag
741
+ ; Language-Tag is defined in section 2.1 of RFC 5646
742
+
743
+ 5.2. VALUE
744
+
745
+ The VALUE parameter is OPTIONAL, used to identify the value type
746
+ (data type) and format of the value. The use of these predefined
747
+ formats is encouraged even if the value parameter is not explicitly
748
+ used. By defining a standard set of value types and their formats,
749
+ existing parsing and processing code can be leveraged. The
750
+
751
+ predefined data type values MUST NOT be repeated in COMMA-separated
752
+ value lists except within the N, NICKNAME, ADR, and CATEGORIES
753
+ properties.
754
+
755
+ ABNF:
756
+
757
+ value-param = "VALUE=" value-type
758
+
759
+ value-type = "text"
760
+ / "uri"
761
+ / "date"
762
+ / "time"
763
+ / "date-time"
764
+ / "date-and-or-time"
765
+ / "timestamp"
766
+ / "boolean"
767
+ / "integer"
768
+ / "float"
769
+ / "utc-offset"
770
+ / "language-tag"
771
+ / iana-token ; registered as described in section 12
772
+ / x-name
773
+
774
+ 5.3. PREF
775
+
776
+ The PREF parameter is OPTIONAL and is used to indicate that the
777
+ corresponding instance of a property is preferred by the vCard
778
+ author. Its value MUST be an integer between 1 and 100 that
779
+ quantifies the level of preference. Lower values correspond to a
780
+ higher level of preference, with 1 being most preferred.
781
+
782
+ When the parameter is absent, the default MUST be to interpret the
783
+ property instance as being least preferred.
784
+
785
+ Note that the value of this parameter is to be interpreted only in
786
+ relation to values assigned to other instances of the same property
787
+ in the same vCard. A given value, or the absence of a value, MUST
788
+ NOT be interpreted on its own.
789
+
790
+ This parameter MAY be applied to any property that allows multiple
791
+ instances.
792
+
793
+ ABNF:
794
+
795
+ pref-param = "PREF=" (1*2DIGIT / "100")
796
+ ; An integer between 1 and 100.
797
+
798
+ 5.4. ALTID
799
+
800
+ The ALTID parameter is used to "tag" property instances as being
801
+ alternative representations of the same logical property. For
802
+ example, translations of a property in multiple languages generates
803
+ multiple property instances having different LANGUAGE (Section 5.1)
804
+ parameter that are tagged with the same ALTID value.
805
+
806
+ This parameter's value is treated as an opaque string. Its sole
807
+ purpose is to be compared for equality against other ALTID parameter
808
+ values.
809
+
810
+ Two property instances are considered alternative representations of
811
+ the same logical property if and only if their names as well as the
812
+ value of their ALTID parameters are identical. Property instances
813
+ without the ALTID parameter MUST NOT be considered an alternative
814
+ representation of any other property instance. Values for the ALTID
815
+ parameter are not globally unique: they MAY be reused for different
816
+ property names.
817
+
818
+ Property instances having the same ALTID parameter value count as 1
819
+ toward cardinality. Therefore, since N (Section 6.2.2) has
820
+ cardinality *1 and TITLE (Section 6.6.1) has cardinality *, these
821
+ three examples would be legal:
822
+
823
+ N;ALTID=1;LANGUAGE=jp:<U+5C71><U+7530>;<U+592A><U+90CE>;;;
824
+ N;ALTID=1;LANGUAGE=en:Yamada;Taro;;;
825
+ (<U+XXXX> denotes a UTF8-encoded Unicode character.)
826
+
827
+ TITLE;ALTID=1;LANGUAGE=fr:Patron
828
+ TITLE;ALTID=1;LANGUAGE=en:Boss
829
+
830
+ TITLE;ALTID=1;LANGUAGE=fr:Patron
831
+ TITLE;ALTID=1;LANGUAGE=en:Boss
832
+ TITLE;ALTID=2;LANGUAGE=en:Chief vCard Evangelist
833
+
834
+ while this one would not:
835
+
836
+ N;ALTID=1;LANGUAGE=jp:<U+5C71><U+7530>;<U+592A><U+90CE>;;;
837
+ N:Yamada;Taro;;;
838
+ (Two instances of the N property.)
839
+
840
+ and these three would be legal but questionable:
841
+
842
+ TITLE;ALTID=1;LANGUAGE=fr:Patron
843
+ TITLE;ALTID=2;LANGUAGE=en:Boss
844
+ (Should probably have the same ALTID value.)
845
+
846
+ TITLE;ALTID=1;LANGUAGE=fr:Patron
847
+ TITLE:LANGUAGE=en:Boss
848
+ (Second line should probably have ALTID=1.)
849
+
850
+ N;ALTID=1;LANGUAGE=jp:<U+5C71><U+7530>;<U+592A><U+90CE>;;;
851
+ N;ALTID=1;LANGUAGE=en:Yamada;Taro;;;
852
+ N;ALTID=1;LANGUAGE=en:Smith;John;;;
853
+ (The last line should probably have ALTID=2. But that would be
854
+ illegal because N has cardinality *1.)
855
+
856
+ The ALTID property MAY also be used in may contexts other than with
857
+ the LANGUAGE parameter. Here's an example with two representations
858
+ of the same photo in different file formats:
859
+
860
+ PHOTO;ALTID=1:data:image/jpeg;base64,...
861
+ PHOTO;ALTID=1;data:image/jp2;base64,...
862
+
863
+ ABNF:
864
+
865
+ altid-param = "ALTID=" param-value
866
+
867
+ 5.5. PID
868
+
869
+ The PID parameter is used to identify a specific property among
870
+ multiple instances. It plays a role analogous to the UID property
871
+ (Section 6.7.6) on a per-property instead of per-vCard basis. It MAY
872
+ appear more than once in a given property. It MUST NOT appear on
873
+ properties that may have only one instance per vCard. Its value is
874
+ either a single small positive integer or a pair of small positive
875
+ integers separated by a dot. Multiple values may be encoded in a
876
+ single PID parameter by separating the values with a comma ",". See
877
+ Section 7 for more details on its usage.
878
+
879
+ ABNF:
880
+
881
+ pid-param = "PID=" pid-value *("," pid-value)
882
+ pid-value = 1*DIGIT ["." 1*DIGIT]
883
+
884
+ 5.6. TYPE
885
+
886
+ The TYPE parameter has multiple, different uses. In general, it is a
887
+ way of specifying class characteristics of the associated property.
888
+ Most of the time, its value is a comma-separated subset of a
889
+ predefined enumeration. In this document, the following properties
890
+ make use of this parameter: FN, NICKNAME, PHOTO, ADR, TEL, EMAIL,
891
+ IMPP, LANG, TZ, GEO, TITLE, ROLE, LOGO, ORG, RELATED, CATEGORIES,
892
+
893
+ NOTE, SOUND, URL, KEY, FBURL, CALADRURI, and CALURI. The TYPE
894
+ parameter MUST NOT be applied on other properties defined in this
895
+ document.
896
+
897
+ The "work" and "home" values act like tags. The "work" value implies
898
+ that the property is related to an individual's work place, while the
899
+ "home" value implies that the property is related to an individual's
900
+ personal life. When neither "work" nor "home" is present, it is
901
+ implied that the property is related to both an individual's work
902
+ place and personal life in the case that the KIND property's value is
903
+ "individual", or to none in other cases.
904
+
905
+ ABNF:
906
+
907
+ type-param = "TYPE=" type-value *("," type-value)
908
+
909
+ type-value = "work" / "home" / type-param-tel
910
+ / type-param-related / iana-token / x-name
911
+ ; This is further defined in individual property sections.
912
+
913
+ 5.7. MEDIATYPE
914
+
915
+ The MEDIATYPE parameter is used with properties whose value is a URI.
916
+ Its use is OPTIONAL. It provides a hint to the vCard consumer
917
+ application about the media type [RFC2046] of the resource identified
918
+ by the URI. Some URI schemes do not need this parameter. For
919
+ example, the "data" scheme allows the media type to be explicitly
920
+ indicated as part of the URI [RFC2397]. Another scheme, "http",
921
+ provides the media type as part of the URI resolution process, with
922
+ the Content-Type HTTP header [RFC2616]. The MEDIATYPE parameter is
923
+ intended to be used with URI schemes that do not provide such
924
+ functionality (e.g., "ftp" [RFC1738]).
925
+
926
+ ABNF:
927
+
928
+ mediatype-param = "MEDIATYPE=" mediatype
929
+ mediatype = type-name "/" subtype-name *( ";" attribute "=" value )
930
+ ; "attribute" and "value" are from [RFC2045]
931
+ ; "type-name" and "subtype-name" are from [RFC4288]
932
+
933
+ 5.8. CALSCALE
934
+
935
+ The CALSCALE parameter is identical to the CALSCALE property in
936
+ iCalendar (see [RFC5545], Section 3.7.1). It is used to define the
937
+ calendar system in which a date or date-time value is expressed. The
938
+ only value specified by iCalendar is "gregorian", which stands for
939
+ the Gregorian system. It is the default when the parameter is
940
+ absent. Additional values may be defined in extension documents and
941
+
942
+ registered with IANA (see Section 10.3.4). A vCard implementation
943
+ MUST ignore properties with a CALSCALE parameter value that it does
944
+ not understand.
945
+
946
+ ABNF:
947
+
948
+ calscale-param = "CALSCALE=" calscale-value
949
+
950
+ calscale-value = "gregorian" / iana-token / x-name
951
+
952
+ 5.9. SORT-AS
953
+
954
+ The "sort-as" parameter is used to specify the string to be used for
955
+ national-language-specific sorting. Without this information,
956
+ sorting algorithms could incorrectly sort this vCard within a
957
+ sequence of sorted vCards. When this property is present in a vCard,
958
+ then the given strings are used for sorting the vCard.
959
+
960
+ This parameter's value is a comma-separated list that MUST have as
961
+ many or fewer elements as the corresponding property value has
962
+ components. This parameter's value is case-sensitive.
963
+
964
+ ABNF:
965
+
966
+ sort-as-param = "SORT-AS=" sort-as-value
967
+
968
+ sort-as-value = param-value *("," param-value)
969
+
970
+ Examples: For the case of surname and given name sorting, the
971
+ following examples define common sort string usage with the N
972
+ property.
973
+
974
+ FN:Rene van der Harten
975
+ N;SORT-AS="Harten,Rene":van der Harten;Rene,J.;Sir;R.D.O.N.
976
+
977
+ FN:Robert Pau Shou Chang
978
+ N;SORT-AS="Pau Shou Chang,Robert":Shou Chang;Robert,Pau;;
979
+
980
+ FN:Osamu Koura
981
+ N;SORT-AS="Koura,Osamu":Koura;Osamu;;
982
+
983
+ FN:Oscar del Pozo
984
+ N;SORT-AS="Pozo,Oscar":del Pozo Triscon;Oscar;;
985
+
986
+ FN:Chistine d'Aboville
987
+ N;SORT-AS="Aboville,Christine":d'Aboville;Christine;;
988
+
989
+ FN:H. James de Mann
990
+ N;SORT-AS="Mann,James":de Mann;Henry,James;;
991
+
992
+ If sorted by surname, the results would be:
993
+
994
+ Christine d'Aboville
995
+ Rene van der Harten
996
+ Osamu Koura
997
+ H. James de Mann
998
+ Robert Pau Shou Chang
999
+ Oscar del Pozo
1000
+
1001
+ If sorted by given name, the results would be:
1002
+
1003
+ Christine d'Aboville
1004
+ H. James de Mann
1005
+ Osamu Koura
1006
+ Oscar del Pozo
1007
+ Rene van der Harten
1008
+ Robert Pau Shou Chang
1009
+
1010
+ 5.10. GEO
1011
+
1012
+ The GEO parameter can be used to indicate global positioning
1013
+ information that is specific to an address. Its value is the same as
1014
+ that of the GEO property (see Section 6.5.2).
1015
+
1016
+ ABNF:
1017
+
1018
+ geo-parameter = "GEO=" DQUOTE URI DQUOTE
1019
+
1020
+ 5.11. TZ
1021
+
1022
+ The TZ parameter can be used to indicate time zone information that
1023
+ is specific to an address. Its value is the same as that of the TZ
1024
+ property.
1025
+
1026
+ ABNF:
1027
+
1028
+ tz-parameter = "TZ=" (param-value / DQUOTE URI DQUOTE)
1029
+
1030
+ 6. vCard Properties
1031
+
1032
+ What follows is an enumeration of the standard vCard properties.
1033
+
1034
+ 6.1. General Properties
1035
+
1036
+ 6.1.1. BEGIN
1037
+
1038
+ Purpose: To denote the beginning of a syntactic entity within a
1039
+ text/vcard content-type.
1040
+
1041
+ Value type: text
1042
+
1043
+ Cardinality: 1
1044
+
1045
+ Special notes: The content entity MUST begin with the BEGIN property
1046
+ with a value of "VCARD". The value is case-insensitive.
1047
+
1048
+ The BEGIN property is used in conjunction with the END property to
1049
+ delimit an entity containing a related set of properties within a
1050
+ text/vcard content-type. This construct can be used instead of
1051
+ including multiple vCards as body parts inside of a multipart/
1052
+ alternative MIME message. It is provided for applications that
1053
+ wish to define content that can contain multiple entities within
1054
+ the same text/vcard content-type or to define content that can be
1055
+ identifiable outside of a MIME environment.
1056
+
1057
+ ABNF:
1058
+
1059
+ BEGIN-param = 0" " ; no parameter allowed
1060
+ BEGIN-value = "VCARD"
1061
+
1062
+ Example:
1063
+
1064
+ BEGIN:VCARD
1065
+
1066
+ 6.1.2. END
1067
+
1068
+ Purpose: To denote the end of a syntactic entity within a text/vcard
1069
+ content-type.
1070
+
1071
+ Value type: text
1072
+
1073
+ Cardinality: 1
1074
+
1075
+ Special notes: The content entity MUST end with the END type with a
1076
+ value of "VCARD". The value is case-insensitive.
1077
+
1078
+ The END property is used in conjunction with the BEGIN property to
1079
+ delimit an entity containing a related set of properties within a
1080
+ text/vcard content-type. This construct can be used instead of or
1081
+ in addition to wrapping separate sets of information inside
1082
+ additional MIME headers. It is provided for applications that
1083
+ wish to define content that can contain multiple entities within
1084
+ the same text/vcard content-type or to define content that can be
1085
+ identifiable outside of a MIME environment.
1086
+
1087
+ ABNF:
1088
+
1089
+ END-param = 0" " ; no parameter allowed
1090
+ END-value = "VCARD"
1091
+
1092
+ Example:
1093
+
1094
+ END:VCARD
1095
+
1096
+ 6.1.3. SOURCE
1097
+
1098
+ Purpose: To identify the source of directory information contained
1099
+ in the content type.
1100
+
1101
+ Value type: uri
1102
+
1103
+ Cardinality: *
1104
+
1105
+ Special notes: The SOURCE property is used to provide the means by
1106
+ which applications knowledgable in the given directory service
1107
+ protocol can obtain additional or more up-to-date information from
1108
+ the directory service. It contains a URI as defined in [RFC3986]
1109
+ and/or other information referencing the vCard to which the
1110
+ information pertains. When directory information is available
1111
+ from more than one source, the sending entity can pick what it
1112
+ considers to be the best source, or multiple SOURCE properties can
1113
+ be included.
1114
+
1115
+ ABNF:
1116
+
1117
+ SOURCE-param = "VALUE=uri" / pid-param / pref-param / altid-param
1118
+ / mediatype-param / any-param
1119
+ SOURCE-value = URI
1120
+
1121
+ Examples:
1122
+
1123
+ SOURCE:ldap://ldap.example.com/cn=Babs%20Jensen,%20o=Babsco,%20c=US
1124
+
1125
+ SOURCE:http://directory.example.com/addressbooks/jdoe/
1126
+ Jean%20Dupont.vcf
1127
+
1128
+ 6.1.4. KIND
1129
+
1130
+ Purpose: To specify the kind of object the vCard represents.
1131
+
1132
+ Value type: A single text value.
1133
+
1134
+ Cardinality: *1
1135
+
1136
+ Special notes: The value may be one of the following:
1137
+
1138
+ "individual" for a vCard representing a single person or entity.
1139
+ This is the default kind of vCard.
1140
+
1141
+ "group" for a vCard representing a group of persons or entities.
1142
+ The group's member entities can be other vCards or other types
1143
+ of entities, such as email addresses or web sites. A group
1144
+ vCard will usually contain MEMBER properties to specify the
1145
+ members of the group, but it is not required to. A group vCard
1146
+ without MEMBER properties can be considered an abstract
1147
+ grouping, or one whose members are known empirically (perhaps
1148
+ "IETF Participants" or "Republican U.S. Senators").
1149
+
1150
+ All properties in a group vCard apply to the group as a whole,
1151
+ and not to any particular MEMBER. For example, an EMAIL
1152
+ property might specify the address of a mailing list associated
1153
+ with the group, and an IMPP property might refer to a group
1154
+ chat room.
1155
+
1156
+ "org" for a vCard representing an organization. An organization
1157
+ vCard will not (in fact, MUST NOT) contain MEMBER properties,
1158
+ and so these are something of a cross between "individual" and
1159
+ "group". An organization is a single entity, but not a person.
1160
+ It might represent a business or government, a department or
1161
+ division within a business or government, a club, an
1162
+ association, or the like.
1163
+
1164
+ All properties in an organization vCard apply to the
1165
+ organization as a whole, as is the case with a group vCard.
1166
+ For example, an EMAIL property might specify the address of a
1167
+ contact point for the organization.
1168
+
1169
+ "location" for a named geographical place. A location vCard will
1170
+ usually contain a GEO property, but it is not required to. A
1171
+ location vCard without a GEO property can be considered an
1172
+ abstract location, or one whose definition is known empirically
1173
+ (perhaps "New England" or "The Seashore").
1174
+
1175
+ All properties in a location vCard apply to the location
1176
+ itself, and not with any entity that might exist at that
1177
+ location. For example, in a vCard for an office building, an
1178
+ ADR property might give the mailing address for the building,
1179
+ and a TEL property might specify the telephone number of the
1180
+ receptionist.
1181
+
1182
+ An x-name. vCards MAY include private or experimental values for
1183
+ KIND. Remember that x-name values are not intended for general
1184
+ use and are unlikely to interoperate.
1185
+
1186
+ An iana-token. Additional values may be registered with IANA (see
1187
+ Section 10.3.4). A new value's specification document MUST
1188
+ specify which properties make sense for that new kind of vCard
1189
+ and which do not.
1190
+
1191
+ Implementations MUST support the specific string values defined
1192
+ above. If this property is absent, "individual" MUST be assumed
1193
+ as the default. If this property is present but the
1194
+ implementation does not understand its value (the value is an
1195
+ x-name or iana-token that the implementation does not support),
1196
+ the implementation SHOULD act in a neutral way, which usually
1197
+ means treating the vCard as though its kind were "individual".
1198
+ The presence of MEMBER properties MAY, however, be taken as an
1199
+ indication that the unknown kind is an extension of "group".
1200
+
1201
+ Clients often need to visually distinguish contacts based on what
1202
+ they represent, and the KIND property provides a direct way for
1203
+ them to do so. For example, when displaying contacts in a list,
1204
+ an icon could be displayed next to each one, using distinctive
1205
+ icons for the different kinds; a client might use an outline of a
1206
+ single person to represent an "individual", an outline of multiple
1207
+ people to represent a "group", and so on. Alternatively, or in
1208
+ addition, a client might choose to segregate different kinds of
1209
+ vCards to different panes, tabs, or selections in the user
1210
+ interface.
1211
+
1212
+ Some clients might also make functional distinctions among the
1213
+ kinds, ignoring "location" vCards for some purposes and
1214
+ considering only "location" vCards for others.
1215
+
1216
+ When designing those sorts of visual and functional distinctions,
1217
+ client implementations have to decide how to fit unsupported kinds
1218
+ into the scheme. What icon is used for them? The one for
1219
+ "individual"? A unique one, such as an icon of a question mark?
1220
+ Which tab do they go into? It is beyond the scope of this
1221
+ specification to answer these questions, but these are things
1222
+ implementers need to consider.
1223
+
1224
+ ABNF:
1225
+
1226
+ KIND-param = "VALUE=text" / any-param
1227
+ KIND-value = "individual" / "group" / "org" / "location"
1228
+ / iana-token / x-name
1229
+
1230
+ Example:
1231
+
1232
+ This represents someone named Jane Doe working in the marketing
1233
+ department of the North American division of ABC Inc.
1234
+
1235
+ BEGIN:VCARD
1236
+ VERSION:4.0
1237
+ KIND:individual
1238
+ FN:Jane Doe
1239
+ ORG:ABC\, Inc.;North American Division;Marketing
1240
+ END:VCARD
1241
+
1242
+ This represents the department itself, commonly known as ABC
1243
+ Marketing.
1244
+
1245
+ BEGIN:VCARD
1246
+ VERSION:4.0
1247
+ KIND:org
1248
+ FN:ABC Marketing
1249
+ ORG:ABC\, Inc.;North American Division;Marketing
1250
+ END:VCARD
1251
+
1252
+ 6.1.5. XML
1253
+
1254
+ Purpose: To include extended XML-encoded vCard data in a plain
1255
+ vCard.
1256
+
1257
+ Value type: A single text value.
1258
+
1259
+ Cardinality: *
1260
+
1261
+ Special notes: The content of this property is a single XML 1.0
1262
+ [W3C.REC-xml-20081126] element whose namespace MUST be explicitly
1263
+ specified using the xmlns attribute and MUST NOT be the vCard 4
1264
+
1265
+ namespace ("urn:ietf:params:xml:ns:vcard-4.0"). (This implies
1266
+ that it cannot duplicate a standard vCard property.) The element
1267
+ is to be interpreted as if it was contained in a <vcard> element,
1268
+ as defined in [RFC6351].
1269
+
1270
+ The fragment is subject to normal line folding and escaping, i.e.,
1271
+ replace all backslashes with "\\", then replace all newlines with
1272
+ "\n", then fold long lines.
1273
+
1274
+ Support for this property is OPTIONAL, but implementations of this
1275
+ specification MUST preserve instances of this property when
1276
+ propagating vCards.
1277
+
1278
+ See [RFC6351] for more information on the intended use of this
1279
+ property.
1280
+
1281
+ ABNF:
1282
+
1283
+ XML-param = "VALUE=text" / altid-param
1284
+ XML-value = text
1285
+
1286
+ 6.2. Identification Properties
1287
+
1288
+ These types are used to capture information associated with the
1289
+ identification and naming of the entity associated with the vCard.
1290
+
1291
+ 6.2.1. FN
1292
+
1293
+ Purpose: To specify the formatted text corresponding to the name of
1294
+ the object the vCard represents.
1295
+
1296
+ Value type: A single text value.
1297
+
1298
+ Cardinality: 1*
1299
+
1300
+ Special notes: This property is based on the semantics of the X.520
1301
+ Common Name attribute [CCITT.X520.1988]. The property MUST be
1302
+ present in the vCard object.
1303
+
1304
+ ABNF:
1305
+
1306
+ FN-param = "VALUE=text" / type-param / language-param / altid-param
1307
+ / pid-param / pref-param / any-param
1308
+ FN-value = text
1309
+
1310
+ Example:
1311
+
1312
+ FN:Mr. John Q. Public\, Esq.
1313
+
1314
+ 6.2.2. N
1315
+
1316
+ Purpose: To specify the components of the name of the object the
1317
+ vCard represents.
1318
+
1319
+ Value type: A single structured text value. Each component can have
1320
+ multiple values.
1321
+
1322
+ Cardinality: *1
1323
+
1324
+ Special note: The structured property value corresponds, in
1325
+ sequence, to the Family Names (also known as surnames), Given
1326
+ Names, Additional Names, Honorific Prefixes, and Honorific
1327
+ Suffixes. The text components are separated by the SEMICOLON
1328
+ character (U+003B). Individual text components can include
1329
+ multiple text values separated by the COMMA character (U+002C).
1330
+ This property is based on the semantics of the X.520 individual
1331
+ name attributes [CCITT.X520.1988]. The property SHOULD be present
1332
+ in the vCard object when the name of the object the vCard
1333
+ represents follows the X.520 model.
1334
+
1335
+ The SORT-AS parameter MAY be applied to this property.
1336
+
1337
+ ABNF:
1338
+
1339
+ N-param = "VALUE=text" / sort-as-param / language-param
1340
+ / altid-param / any-param
1341
+ N-value = list-component 4(";" list-component)
1342
+
1343
+ Examples:
1344
+
1345
+ N:Public;John;Quinlan;Mr.;Esq.
1346
+
1347
+ N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.
1348
+
1349
+ 6.2.3. NICKNAME
1350
+
1351
+ Purpose: To specify the text corresponding to the nickname of the
1352
+ object the vCard represents.
1353
+
1354
+ Value type: One or more text values separated by a COMMA character
1355
+ (U+002C).
1356
+
1357
+ Cardinality: *
1358
+
1359
+ Special note: The nickname is the descriptive name given instead of
1360
+ or in addition to the one belonging to the object the vCard
1361
+ represents. It can also be used to specify a familiar form of a
1362
+ proper name specified by the FN or N properties.
1363
+
1364
+ ABNF:
1365
+
1366
+ NICKNAME-param = "VALUE=text" / type-param / language-param
1367
+ / altid-param / pid-param / pref-param / any-param
1368
+ NICKNAME-value = text-list
1369
+
1370
+ Examples:
1371
+
1372
+ NICKNAME:Robbie
1373
+
1374
+ NICKNAME:Jim,Jimmie
1375
+
1376
+ NICKNAME;TYPE=work:Boss
1377
+
1378
+ 6.2.4. PHOTO
1379
+
1380
+ Purpose: To specify an image or photograph information that
1381
+ annotates some aspect of the object the vCard represents.
1382
+
1383
+ Value type: A single URI.
1384
+
1385
+ Cardinality: *
1386
+
1387
+ ABNF:
1388
+
1389
+ PHOTO-param = "VALUE=uri" / altid-param / type-param
1390
+ / mediatype-param / pref-param / pid-param / any-param
1391
+ PHOTO-value = URI
1392
+
1393
+ Examples:
1394
+
1395
+ PHOTO:http://www.example.com/pub/photos/jqpublic.gif
1396
+
1397
+ PHOTO:data:image/jpeg;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhv
1398
+ AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
1399
+ ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
1400
+ <...remainder of base64-encoded data...>
1401
+
1402
+ 6.2.5. BDAY
1403
+
1404
+ Purpose: To specify the birth date of the object the vCard
1405
+ represents.
1406
+
1407
+ Value type: The default is a single date-and-or-time value. It can
1408
+ also be reset to a single text value.
1409
+
1410
+ Cardinality: *1
1411
+
1412
+ ABNF:
1413
+
1414
+ BDAY-param = BDAY-param-date / BDAY-param-text
1415
+ BDAY-value = date-and-or-time / text
1416
+ ; Value and parameter MUST match.
1417
+
1418
+ BDAY-param-date = "VALUE=date-and-or-time"
1419
+ BDAY-param-text = "VALUE=text" / language-param
1420
+
1421
+ BDAY-param =/ altid-param / calscale-param / any-param
1422
+ ; calscale-param can only be present when BDAY-value is
1423
+ ; date-and-or-time and actually contains a date or date-time.
1424
+
1425
+ Examples:
1426
+
1427
+ BDAY:19960415
1428
+ BDAY:--0415
1429
+ BDAY;19531015T231000Z
1430
+ BDAY;VALUE=text:circa 1800
1431
+
1432
+ 6.2.6. ANNIVERSARY
1433
+
1434
+ Purpose: The date of marriage, or equivalent, of the object the
1435
+ vCard represents.
1436
+
1437
+ Value type: The default is a single date-and-or-time value. It can
1438
+ also be reset to a single text value.
1439
+
1440
+ Cardinality: *1
1441
+
1442
+ ABNF:
1443
+
1444
+ ANNIVERSARY-param = "VALUE=" ("date-and-or-time" / "text")
1445
+ ANNIVERSARY-value = date-and-or-time / text
1446
+ ; Value and parameter MUST match.
1447
+
1448
+ ANNIVERSARY-param =/ altid-param / calscale-param / any-param
1449
+ ; calscale-param can only be present when ANNIVERSARY-value is
1450
+ ; date-and-or-time and actually contains a date or date-time.
1451
+
1452
+ Examples:
1453
+
1454
+ ANNIVERSARY:19960415
1455
+
1456
+ 6.2.7. GENDER
1457
+
1458
+ Purpose: To specify the components of the sex and gender identity of
1459
+ the object the vCard represents.
1460
+
1461
+ Value type: A single structured value with two components. Each
1462
+ component has a single text value.
1463
+
1464
+ Cardinality: *1
1465
+
1466
+ Special notes: The components correspond, in sequence, to the sex
1467
+ (biological), and gender identity. Each component is optional.
1468
+
1469
+ Sex component: A single letter. M stands for "male", F stands
1470
+ for "female", O stands for "other", N stands for "none or not
1471
+ applicable", U stands for "unknown".
1472
+
1473
+ Gender identity component: Free-form text.
1474
+
1475
+ ABNF:
1476
+
1477
+ GENDER-param = "VALUE=text" / any-param
1478
+ GENDER-value = sex [";" text]
1479
+
1480
+ sex = "" / "M" / "F" / "O" / "N" / "U"
1481
+
1482
+ Examples:
1483
+
1484
+ GENDER:M
1485
+ GENDER:F
1486
+ GENDER:M;Fellow
1487
+ GENDER:F;grrrl
1488
+ GENDER:O;intersex
1489
+ GENDER:;it's complicated
1490
+
1491
+ 6.3. Delivery Addressing Properties
1492
+
1493
+ These types are concerned with information related to the delivery
1494
+ addressing or label for the vCard object.
1495
+
1496
+ 6.3.1. ADR
1497
+
1498
+ Purpose: To specify the components of the delivery address for the
1499
+ vCard object.
1500
+
1501
+ Value type: A single structured text value, separated by the
1502
+ SEMICOLON character (U+003B).
1503
+
1504
+ Cardinality: *
1505
+
1506
+ Special notes: The structured type value consists of a sequence of
1507
+ address components. The component values MUST be specified in
1508
+ their corresponding position. The structured type value
1509
+ corresponds, in sequence, to
1510
+ the post office box;
1511
+ the extended address (e.g., apartment or suite number);
1512
+ the street address;
1513
+ the locality (e.g., city);
1514
+ the region (e.g., state or province);
1515
+ the postal code;
1516
+ the country name (full name in the language specified in
1517
+ Section 5.1).
1518
+
1519
+ When a component value is missing, the associated component
1520
+ separator MUST still be specified.
1521
+
1522
+ Experience with vCard 3 has shown that the first two components
1523
+ (post office box and extended address) are plagued with many
1524
+ interoperability issues. To ensure maximal interoperability,
1525
+ their values SHOULD be empty.
1526
+
1527
+ The text components are separated by the SEMICOLON character
1528
+ (U+003B). Where it makes semantic sense, individual text
1529
+ components can include multiple text values (e.g., a "street"
1530
+ component with multiple lines) separated by the COMMA character
1531
+ (U+002C).
1532
+
1533
+ The property can include the "PREF" parameter to indicate the
1534
+ preferred delivery address when more than one address is
1535
+ specified.
1536
+
1537
+ The GEO and TZ parameters MAY be used with this property.
1538
+
1539
+ The property can also include a "LABEL" parameter to present a
1540
+ delivery address label for the address. Its value is a plain-text
1541
+ string representing the formatted address. Newlines are encoded
1542
+ as \n, as they are for property values.
1543
+
1544
+ ABNF:
1545
+
1546
+ label-param = "LABEL=" param-value
1547
+
1548
+ ADR-param = "VALUE=text" / label-param / language-param
1549
+ / geo-parameter / tz-parameter / altid-param / pid-param
1550
+ / pref-param / type-param / any-param
1551
+
1552
+ ADR-value = ADR-component-pobox ";" ADR-component-ext ";"
1553
+ ADR-component-street ";" ADR-component-locality ";"
1554
+ ADR-component-region ";" ADR-component-code ";"
1555
+ ADR-component-country
1556
+ ADR-component-pobox = list-component
1557
+ ADR-component-ext = list-component
1558
+ ADR-component-street = list-component
1559
+ ADR-component-locality = list-component
1560
+ ADR-component-region = list-component
1561
+ ADR-component-code = list-component
1562
+ ADR-component-country = list-component
1563
+
1564
+ Example: In this example, the post office box and the extended
1565
+ address are absent.
1566
+
1567
+ ADR;GEO="geo:12.3457,78.910";LABEL="Mr. John Q. Public, Esq.\n
1568
+ Mail Drop: TNE QB\n123 Main Street\nAny Town, CA 91921-1234\n
1569
+ U.S.A.":;;123 Main Street;Any Town;CA;91921-1234;U.S.A.
1570
+
1571
+ 6.4. Communications Properties
1572
+
1573
+ These properties describe information about how to communicate with
1574
+ the object the vCard represents.
1575
+
1576
+ 6.4.1. TEL
1577
+
1578
+ Purpose: To specify the telephone number for telephony communication
1579
+ with the object the vCard represents.
1580
+
1581
+ Value type: By default, it is a single free-form text value (for
1582
+ backward compatibility with vCard 3), but it SHOULD be reset to a
1583
+ URI value. It is expected that the URI scheme will be "tel", as
1584
+ specified in [RFC3966], but other schemes MAY be used.
1585
+
1586
+ Cardinality: *
1587
+
1588
+ Special notes: This property is based on the X.520 Telephone Number
1589
+ attribute [CCITT.X520.1988].
1590
+
1591
+ The property can include the "PREF" parameter to indicate a
1592
+ preferred-use telephone number.
1593
+
1594
+ The property can include the parameter "TYPE" to specify intended
1595
+ use for the telephone number. The predefined values for the TYPE
1596
+ parameter are:
1597
+
1598
+ +-----------+-------------------------------------------------------+
1599
+ | Value | Description |
1600
+ +-----------+-------------------------------------------------------+
1601
+ | text | Indicates that the telephone number supports text |
1602
+ | | messages (SMS). |
1603
+ | voice | Indicates a voice telephone number. |
1604
+ | fax | Indicates a facsimile telephone number. |
1605
+ | cell | Indicates a cellular or mobile telephone number. |
1606
+ | video | Indicates a video conferencing telephone number. |
1607
+ | pager | Indicates a paging device telephone number. |
1608
+ | textphone | Indicates a telecommunication device for people with |
1609
+ | | hearing or speech difficulties. |
1610
+ +-----------+-------------------------------------------------------+
1611
+
1612
+ The default type is "voice". These type parameter values can be
1613
+ specified as a parameter list (e.g., TYPE=text;TYPE=voice) or as a
1614
+ value list (e.g., TYPE="text,voice"). The default can be
1615
+ overridden to another set of values by specifying one or more
1616
+ alternate values. For example, the default TYPE of "voice" can be
1617
+ reset to a VOICE and FAX telephone number by the value list
1618
+ TYPE="voice,fax".
1619
+
1620
+ If this property's value is a URI that can also be used for
1621
+ instant messaging, the IMPP (Section 6.4.3) property SHOULD be
1622
+ used in addition to this property.
1623
+
1624
+ ABNF:
1625
+
1626
+ TEL-param = TEL-text-param / TEL-uri-param
1627
+ TEL-value = TEL-text-value / TEL-uri-value
1628
+ ; Value and parameter MUST match.
1629
+
1630
+ TEL-text-param = "VALUE=text"
1631
+ TEL-text-value = text
1632
+
1633
+ TEL-uri-param = "VALUE=uri" / mediatype-param
1634
+ TEL-uri-value = URI
1635
+
1636
+ TEL-param =/ type-param / pid-param / pref-param / altid-param
1637
+ / any-param
1638
+
1639
+ type-param-tel = "text" / "voice" / "fax" / "cell" / "video"
1640
+ / "pager" / "textphone" / iana-token / x-name
1641
+ ; type-param-tel MUST NOT be used with a property other than TEL.
1642
+
1643
+ Example:
1644
+
1645
+ TEL;VALUE=uri;PREF=1;TYPE="voice,home":tel:+1-555-555-5555;ext=5555
1646
+ TEL;VALUE=uri;TYPE=home:tel:+33-01-23-45-67
1647
+
1648
+ 6.4.2. EMAIL
1649
+
1650
+ Purpose: To specify the electronic mail address for communication
1651
+ with the object the vCard represents.
1652
+
1653
+ Value type: A single text value.
1654
+
1655
+ Cardinality: *
1656
+
1657
+ Special notes: The property can include tye "PREF" parameter to
1658
+ indicate a preferred-use email address when more than one is
1659
+ specified.
1660
+
1661
+ Even though the value is free-form UTF-8 text, it is likely to be
1662
+ interpreted by a Mail User Agent (MUA) as an "addr-spec", as
1663
+ defined in [RFC5322], Section 3.4.1. Readers should also be aware
1664
+ of the current work toward internationalized email addresses
1665
+ [RFC5335bis].
1666
+
1667
+ ABNF:
1668
+
1669
+ EMAIL-param = "VALUE=text" / pid-param / pref-param / type-param
1670
+ / altid-param / any-param
1671
+ EMAIL-value = text
1672
+
1673
+ Example:
1674
+
1675
+ EMAIL;TYPE=work:jqpublic@xyz.example.com
1676
+
1677
+ EMAIL;PREF=1:jane_doe@example.com
1678
+
1679
+ 6.4.3. IMPP
1680
+
1681
+ Purpose: To specify the URI for instant messaging and presence
1682
+ protocol communications with the object the vCard represents.
1683
+
1684
+ Value type: A single URI.
1685
+
1686
+ Cardinality: *
1687
+
1688
+ Special notes: The property may include the "PREF" parameter to
1689
+ indicate that this is a preferred address and has the same
1690
+ semantics as the "PREF" parameter in a TEL property.
1691
+
1692
+ If this property's value is a URI that can be used for voice
1693
+ and/or video, the TEL property (Section 6.4.1) SHOULD be used in
1694
+ addition to this property.
1695
+
1696
+ This property is adapted from [RFC4770], which is made obsolete by
1697
+ this document.
1698
+
1699
+ ABNF:
1700
+
1701
+ IMPP-param = "VALUE=uri" / pid-param / pref-param / type-param
1702
+ / mediatype-param / altid-param / any-param
1703
+ IMPP-value = URI
1704
+
1705
+ Example:
1706
+
1707
+ IMPP;PREF=1:xmpp:alice@example.com
1708
+
1709
+ 6.4.4. LANG
1710
+
1711
+ Purpose: To specify the language(s) that may be used for contacting
1712
+ the entity associated with the vCard.
1713
+
1714
+ Value type: A single language-tag value.
1715
+
1716
+ Cardinality: *
1717
+
1718
+ ABNF:
1719
+
1720
+ LANG-param = "VALUE=language-tag" / pid-param / pref-param
1721
+ / altid-param / type-param / any-param
1722
+ LANG-value = Language-Tag
1723
+
1724
+ Example:
1725
+
1726
+ LANG;TYPE=work;PREF=1:en
1727
+ LANG;TYPE=work;PREF=2:fr
1728
+ LANG;TYPE=home:fr
1729
+
1730
+ 6.5. Geographical Properties
1731
+
1732
+ These properties are concerned with information associated with
1733
+ geographical positions or regions associated with the object the
1734
+ vCard represents.
1735
+
1736
+ 6.5.1. TZ
1737
+
1738
+ Purpose: To specify information related to the time zone of the
1739
+ object the vCard represents.
1740
+
1741
+ Value type: The default is a single text value. It can also be
1742
+ reset to a single URI or utc-offset value.
1743
+
1744
+ Cardinality: *
1745
+
1746
+ Special notes: It is expected that names from the public-domain
1747
+ Olson database [TZ-DB] will be used, but this is not a
1748
+ restriction. See also [IANA-TZ].
1749
+
1750
+ Efforts are currently being directed at creating a standard URI
1751
+ scheme for expressing time zone information. Usage of such a
1752
+ scheme would ensure a high level of interoperability between
1753
+ implementations that support it.
1754
+
1755
+ Note that utc-offset values SHOULD NOT be used because the UTC
1756
+ offset varies with time -- not just because of the usual daylight
1757
+ saving time shifts that occur in may regions, but often entire
1758
+ regions will "re-base" their overall offset. The actual offset
1759
+ may be +/- 1 hour (or perhaps a little more) than the one given.
1760
+
1761
+ ABNF:
1762
+
1763
+ TZ-param = "VALUE=" ("text" / "uri" / "utc-offset")
1764
+ TZ-value = text / URI / utc-offset
1765
+ ; Value and parameter MUST match.
1766
+
1767
+ TZ-param =/ altid-param / pid-param / pref-param / type-param
1768
+ / mediatype-param / any-param
1769
+
1770
+ Examples:
1771
+
1772
+ TZ:Raleigh/North America
1773
+
1774
+ TZ;VALUE=utc-offset:-0500
1775
+ ; Note: utc-offset format is NOT RECOMMENDED.
1776
+
1777
+ 6.5.2. GEO
1778
+
1779
+ Purpose: To specify information related to the global positioning of
1780
+ the object the vCard represents.
1781
+
1782
+ Value type: A single URI.
1783
+
1784
+ Cardinality: *
1785
+
1786
+ Special notes: The "geo" URI scheme [RFC5870] is particularly well
1787
+ suited for this property, but other schemes MAY be used.
1788
+
1789
+ ABNF:
1790
+
1791
+ GEO-param = "VALUE=uri" / pid-param / pref-param / type-param
1792
+ / mediatype-param / altid-param / any-param
1793
+ GEO-value = URI
1794
+
1795
+ Example:
1796
+
1797
+ GEO:geo:37.386013,-122.082932
1798
+
1799
+ 6.6. Organizational Properties
1800
+
1801
+ These properties are concerned with information associated with
1802
+ characteristics of the organization or organizational units of the
1803
+ object that the vCard represents.
1804
+
1805
+ 6.6.1. TITLE
1806
+
1807
+ Purpose: To specify the position or job of the object the vCard
1808
+ represents.
1809
+
1810
+ Value type: A single text value.
1811
+
1812
+ Cardinality: *
1813
+
1814
+ Special notes: This property is based on the X.520 Title attribute
1815
+ [CCITT.X520.1988].
1816
+
1817
+ ABNF:
1818
+
1819
+ TITLE-param = "VALUE=text" / language-param / pid-param
1820
+ / pref-param / altid-param / type-param / any-param
1821
+ TITLE-value = text
1822
+
1823
+ Example:
1824
+
1825
+ TITLE:Research Scientist
1826
+
1827
+ 6.6.2. ROLE
1828
+
1829
+ Purpose: To specify the function or part played in a particular
1830
+ situation by the object the vCard represents.
1831
+
1832
+ Value type: A single text value.
1833
+
1834
+ Cardinality: *
1835
+
1836
+ Special notes: This property is based on the X.520 Business Category
1837
+ explanatory attribute [CCITT.X520.1988]. This property is
1838
+ included as an organizational type to avoid confusion with the
1839
+ semantics of the TITLE property and incorrect usage of that
1840
+ property when the semantics of this property is intended.
1841
+
1842
+ ABNF:
1843
+
1844
+ ROLE-param = "VALUE=text" / language-param / pid-param / pref-param
1845
+ / type-param / altid-param / any-param
1846
+ ROLE-value = text
1847
+
1848
+ Example:
1849
+
1850
+ ROLE:Project Leader
1851
+
1852
+ 6.6.3. LOGO
1853
+
1854
+ Purpose: To specify a graphic image of a logo associated with the
1855
+ object the vCard represents.
1856
+
1857
+ Value type: A single URI.
1858
+
1859
+ Cardinality: *
1860
+
1861
+ ABNF:
1862
+
1863
+ LOGO-param = "VALUE=uri" / language-param / pid-param / pref-param
1864
+ / type-param / mediatype-param / altid-param / any-param
1865
+ LOGO-value = URI
1866
+
1867
+ Examples:
1868
+
1869
+ LOGO:http://www.example.com/pub/logos/abccorp.jpg
1870
+
1871
+ LOGO:data:image/jpeg;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvc
1872
+ AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
1873
+ ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
1874
+ <...the remainder of base64-encoded data...>
1875
+
1876
+ 6.6.4. ORG
1877
+
1878
+ Purpose: To specify the organizational name and units associated
1879
+ with the vCard.
1880
+
1881
+ Value type: A single structured text value consisting of components
1882
+ separated by the SEMICOLON character (U+003B).
1883
+
1884
+ Cardinality: *
1885
+
1886
+ Special notes: The property is based on the X.520 Organization Name
1887
+ and Organization Unit attributes [CCITT.X520.1988]. The property
1888
+ value is a structured type consisting of the organization name,
1889
+ followed by zero or more levels of organizational unit names.
1890
+
1891
+ The SORT-AS parameter MAY be applied to this property.
1892
+
1893
+ ABNF:
1894
+
1895
+ ORG-param = "VALUE=text" / sort-as-param / language-param
1896
+ / pid-param / pref-param / altid-param / type-param
1897
+ / any-param
1898
+ ORG-value = component *(";" component)
1899
+
1900
+ Example: A property value consisting of an organizational name,
1901
+ organizational unit #1 name, and organizational unit #2 name.
1902
+
1903
+ ORG:ABC\, Inc.;North American Division;Marketing
1904
+
1905
+ 6.6.5. MEMBER
1906
+
1907
+ Purpose: To include a member in the group this vCard represents.
1908
+
1909
+ Value type: A single URI. It MAY refer to something other than a
1910
+ vCard object. For example, an email distribution list could
1911
+ employ the "mailto" URI scheme [RFC6068] for efficiency.
1912
+
1913
+ Cardinality: *
1914
+
1915
+ Special notes: This property MUST NOT be present unless the value of
1916
+ the KIND property is "group".
1917
+
1918
+ ABNF:
1919
+
1920
+ MEMBER-param = "VALUE=uri" / pid-param / pref-param / altid-param
1921
+ / mediatype-param / any-param
1922
+ MEMBER-value = URI
1923
+
1924
+ Examples:
1925
+
1926
+ BEGIN:VCARD
1927
+ VERSION:4.0
1928
+ KIND:group
1929
+ FN:The Doe family
1930
+ MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
1931
+ MEMBER:urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519
1932
+ END:VCARD
1933
+ BEGIN:VCARD
1934
+ VERSION:4.0
1935
+ FN:John Doe
1936
+ UID:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
1937
+ END:VCARD
1938
+ BEGIN:VCARD
1939
+ VERSION:4.0
1940
+ FN:Jane Doe
1941
+ UID:urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519
1942
+ END:VCARD
1943
+
1944
+ BEGIN:VCARD
1945
+ VERSION:4.0
1946
+ KIND:group
1947
+ FN:Funky distribution list
1948
+ MEMBER:mailto:subscriber1@example.com
1949
+ MEMBER:xmpp:subscriber2@example.com
1950
+ MEMBER:sip:subscriber3@example.com
1951
+ MEMBER:tel:+1-418-555-5555
1952
+ END:VCARD
1953
+
1954
+ 6.6.6. RELATED
1955
+
1956
+ Purpose: To specify a relationship between another entity and the
1957
+ entity represented by this vCard.
1958
+
1959
+ Value type: A single URI. It can also be reset to a single text
1960
+ value. The text value can be used to specify textual information.
1961
+
1962
+ Cardinality: *
1963
+
1964
+ Special notes: The TYPE parameter MAY be used to characterize the
1965
+ related entity. It contains a comma-separated list of values that
1966
+ are registered with IANA as described in Section 10.2. The
1967
+ registry is pre-populated with the values defined in [xfn]. This
1968
+ document also specifies two additional values:
1969
+
1970
+ agent: an entity who may sometimes act on behalf of the entity
1971
+ associated with the vCard.
1972
+
1973
+ emergency: indicates an emergency contact
1974
+
1975
+ ABNF:
1976
+
1977
+ RELATED-param = RELATED-param-uri / RELATED-param-text
1978
+ RELATED-value = URI / text
1979
+ ; Parameter and value MUST match.
1980
+
1981
+ RELATED-param-uri = "VALUE=uri" / mediatype-param
1982
+ RELATED-param-text = "VALUE=text" / language-param
1983
+
1984
+ RELATED-param =/ pid-param / pref-param / altid-param / type-param
1985
+ / any-param
1986
+
1987
+ type-param-related = related-type-value *("," related-type-value)
1988
+ ; type-param-related MUST NOT be used with a property other than
1989
+ ; RELATED.
1990
+
1991
+ related-type-value = "contact" / "acquaintance" / "friend" / "met"
1992
+ / "co-worker" / "colleague" / "co-resident"
1993
+ / "neighbor" / "child" / "parent"
1994
+ / "sibling" / "spouse" / "kin" / "muse"
1995
+ / "crush" / "date" / "sweetheart" / "me"
1996
+ / "agent" / "emergency"
1997
+
1998
+ Examples:
1999
+
2000
+ RELATED;TYPE=friend:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
2001
+ RELATED;TYPE=contact:http://example.com/directory/jdoe.vcf
2002
+ RELATED;TYPE=co-worker;VALUE=text:Please contact my assistant Jane
2003
+ Doe for any inquiries.
2004
+
2005
+ 6.7. Explanatory Properties
2006
+
2007
+ These properties are concerned with additional explanations, such as
2008
+ that related to informational notes or revisions specific to the
2009
+ vCard.
2010
+
2011
+ 6.7.1. CATEGORIES
2012
+
2013
+ Purpose: To specify application category information about the
2014
+ vCard, also known as "tags".
2015
+
2016
+ Value type: One or more text values separated by a COMMA character
2017
+ (U+002C).
2018
+
2019
+ Cardinality: *
2020
+
2021
+ ABNF:
2022
+
2023
+ CATEGORIES-param = "VALUE=text" / pid-param / pref-param
2024
+ / type-param / altid-param / any-param
2025
+ CATEGORIES-value = text-list
2026
+
2027
+ Example:
2028
+
2029
+ CATEGORIES:TRAVEL AGENT
2030
+
2031
+ CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY
2032
+
2033
+ 6.7.2. NOTE
2034
+
2035
+ Purpose: To specify supplemental information or a comment that is
2036
+ associated with the vCard.
2037
+
2038
+ Value type: A single text value.
2039
+
2040
+ Cardinality: *
2041
+
2042
+ Special notes: The property is based on the X.520 Description
2043
+ attribute [CCITT.X520.1988].
2044
+
2045
+ ABNF:
2046
+
2047
+ NOTE-param = "VALUE=text" / language-param / pid-param / pref-param
2048
+ / type-param / altid-param / any-param
2049
+ NOTE-value = text
2050
+
2051
+ Example:
2052
+
2053
+ NOTE:This fax number is operational 0800 to 1715
2054
+ EST\, Mon-Fri.
2055
+
2056
+ 6.7.3. PRODID
2057
+
2058
+ Purpose: To specify the identifier for the product that created the
2059
+ vCard object.
2060
+
2061
+ Type value: A single text value.
2062
+
2063
+ Cardinality: *1
2064
+
2065
+ Special notes: Implementations SHOULD use a method such as that
2066
+ specified for Formal Public Identifiers in [ISO9070] or for
2067
+ Universal Resource Names in [RFC3406] to ensure that the text
2068
+ value is unique.
2069
+
2070
+ ABNF:
2071
+
2072
+ PRODID-param = "VALUE=text" / any-param
2073
+ PRODID-value = text
2074
+
2075
+ Example:
2076
+
2077
+ PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
2078
+
2079
+ 6.7.4. REV
2080
+
2081
+ Purpose: To specify revision information about the current vCard.
2082
+
2083
+ Value type: A single timestamp value.
2084
+
2085
+ Cardinality: *1
2086
+
2087
+ Special notes: The value distinguishes the current revision of the
2088
+ information in this vCard for other renditions of the information.
2089
+
2090
+ ABNF:
2091
+
2092
+ REV-param = "VALUE=timestamp" / any-param
2093
+ REV-value = timestamp
2094
+
2095
+ Example:
2096
+
2097
+ REV:19951031T222710Z
2098
+
2099
+ 6.7.5. SOUND
2100
+
2101
+ Purpose: To specify a digital sound content information that
2102
+ annotates some aspect of the vCard. This property is often used
2103
+ to specify the proper pronunciation of the name property value of
2104
+ the vCard.
2105
+
2106
+ Value type: A single URI.
2107
+
2108
+ Cardinality: *
2109
+
2110
+ ABNF:
2111
+
2112
+ SOUND-param = "VALUE=uri" / language-param / pid-param / pref-param
2113
+ / type-param / mediatype-param / altid-param
2114
+ / any-param
2115
+ SOUND-value = URI
2116
+
2117
+ Example:
2118
+
2119
+ SOUND:CID:JOHNQPUBLIC.part8.19960229T080000.xyzMail@example.com
2120
+
2121
+ SOUND:data:audio/basic;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIh
2122
+ AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
2123
+ ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
2124
+ <...the remainder of base64-encoded data...>
2125
+
2126
+ 6.7.6. UID
2127
+
2128
+ Purpose: To specify a value that represents a globally unique
2129
+ identifier corresponding to the entity associated with the vCard.
2130
+
2131
+ Value type: A single URI value. It MAY also be reset to free-form
2132
+ text.
2133
+
2134
+ Cardinality: *1
2135
+
2136
+ Special notes: This property is used to uniquely identify the object
2137
+ that the vCard represents. The "uuid" URN namespace defined in
2138
+ [RFC4122] is particularly well suited to this task, but other URI
2139
+ schemes MAY be used. Free-form text MAY also be used.
2140
+
2141
+ ABNF:
2142
+
2143
+ UID-param = UID-uri-param / UID-text-param
2144
+ UID-value = UID-uri-value / UID-text-value
2145
+ ; Value and parameter MUST match.
2146
+
2147
+ UID-uri-param = "VALUE=uri"
2148
+ UID-uri-value = URI
2149
+
2150
+ UID-text-param = "VALUE=text"
2151
+ UID-text-value = text
2152
+
2153
+ UID-param =/ any-param
2154
+
2155
+ Example:
2156
+
2157
+ UID:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
2158
+
2159
+ 6.7.7. CLIENTPIDMAP
2160
+
2161
+ Purpose: To give a global meaning to a local PID source identifier.
2162
+
2163
+ Value type: A semicolon-separated pair of values. The first field
2164
+ is a small integer corresponding to the second field of a PID
2165
+ parameter instance. The second field is a URI. The "uuid" URN
2166
+ namespace defined in [RFC4122] is particularly well suited to this
2167
+ task, but other URI schemes MAY be used.
2168
+
2169
+ Cardinality: *
2170
+
2171
+ Special notes: PID source identifiers (the source identifier is the
2172
+ second field in a PID parameter instance) are small integers that
2173
+ only have significance within the scope of a single vCard
2174
+ instance. Each distinct source identifier present in a vCard MUST
2175
+ have an associated CLIENTPIDMAP. See Section 7 for more details
2176
+ on the usage of CLIENTPIDMAP.
2177
+
2178
+ PID source identifiers MUST be strictly positive. Zero is not
2179
+ allowed.
2180
+
2181
+ As a special exception, the PID parameter MUST NOT be applied to
2182
+ this property.
2183
+
2184
+ ABNF:
2185
+
2186
+ CLIENTPIDMAP-param = any-param
2187
+ CLIENTPIDMAP-value = 1*DIGIT ";" URI
2188
+
2189
+ Example:
2190
+
2191
+ TEL;PID=3.1,4.2;VALUE=uri:tel:+1-555-555-5555
2192
+ EMAIL;PID=4.1,5.2:jdoe@example.com
2193
+ CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
2194
+ CLIENTPIDMAP:2;urn:uuid:d89c9c7a-2e1b-4832-82de-7e992d95faa5
2195
+
2196
+ 6.7.8. URL
2197
+
2198
+ Purpose: To specify a uniform resource locator associated with the
2199
+ object to which the vCard refers. Examples for individuals
2200
+ include personal web sites, blogs, and social networking site
2201
+ identifiers.
2202
+
2203
+ Cardinality: *
2204
+
2205
+ Value type: A single uri value.
2206
+
2207
+ ABNF:
2208
+
2209
+ URL-param = "VALUE=uri" / pid-param / pref-param / type-param
2210
+ / mediatype-param / altid-param / any-param
2211
+ URL-value = URI
2212
+
2213
+ Example:
2214
+
2215
+ URL:http://example.org/restaurant.french/~chezchic.html
2216
+
2217
+ 6.7.9. VERSION
2218
+
2219
+ Purpose: To specify the version of the vCard specification used to
2220
+ format this vCard.
2221
+
2222
+ Value type: A single text value.
2223
+
2224
+ Cardinality: 1
2225
+
2226
+ Special notes: This property MUST be present in the vCard object,
2227
+ and it must appear immediately after BEGIN:VCARD. The value MUST
2228
+ be "4.0" if the vCard corresponds to this specification. Note
2229
+ that earlier versions of vCard allowed this property to be placed
2230
+ anywhere in the vCard object, or even to be absent.
2231
+
2232
+ ABNF:
2233
+
2234
+ VERSION-param = "VALUE=text" / any-param
2235
+ VERSION-value = "4.0"
2236
+
2237
+ Example:
2238
+
2239
+ VERSION:4.0
2240
+
2241
+ 6.8. Security Properties
2242
+
2243
+ These properties are concerned with the security of communication
2244
+ pathways or access to the vCard.
2245
+
2246
+ 6.8.1. KEY
2247
+
2248
+ Purpose: To specify a public key or authentication certificate
2249
+ associated with the object that the vCard represents.
2250
+
2251
+ Value type: A single URI. It can also be reset to a text value.
2252
+
2253
+ Cardinality: *
2254
+
2255
+ ABNF:
2256
+
2257
+ KEY-param = KEY-uri-param / KEY-text-param
2258
+ KEY-value = KEY-uri-value / KEY-text-value
2259
+ ; Value and parameter MUST match.
2260
+
2261
+ KEY-uri-param = "VALUE=uri" / mediatype-param
2262
+ KEY-uri-value = URI
2263
+
2264
+ KEY-text-param = "VALUE=text"
2265
+ KEY-text-value = text
2266
+
2267
+ KEY-param =/ altid-param / pid-param / pref-param / type-param
2268
+ / any-param
2269
+
2270
+ Examples:
2271
+
2272
+ KEY:http://www.example.com/keys/jdoe.cer
2273
+
2274
+ KEY;MEDIATYPE=application/pgp-keys:ftp://example.com/keys/jdoe
2275
+
2276
+ KEY:data:application/pgp-keys;base64,MIICajCCAdOgAwIBAgICBE
2277
+ UwDQYJKoZIhvcNAQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05l
2278
+ <... remainder of base64-encoded data ...>
2279
+
2280
+ 6.9. Calendar Properties
2281
+
2282
+ These properties are further specified in [RFC2739].
2283
+
2284
+ 6.9.1. FBURL
2285
+
2286
+ Purpose: To specify the URI for the busy time associated with the
2287
+ object that the vCard represents.
2288
+
2289
+ Value type: A single URI value.
2290
+
2291
+ Cardinality: *
2292
+
2293
+ Special notes: Where multiple FBURL properties are specified, the
2294
+ default FBURL property is indicated with the PREF parameter. The
2295
+ FTP [RFC1738] or HTTP [RFC2616] type of URI points to an iCalendar
2296
+ [RFC5545] object associated with a snapshot of the next few weeks
2297
+ or months of busy time data. If the iCalendar object is
2298
+ represented as a file or document, its file extension should be
2299
+ ".ifb".
2300
+
2301
+ ABNF:
2302
+
2303
+ FBURL-param = "VALUE=uri" / pid-param / pref-param / type-param
2304
+ / mediatype-param / altid-param / any-param
2305
+ FBURL-value = URI
2306
+
2307
+ Examples:
2308
+
2309
+ FBURL;PREF=1:http://www.example.com/busy/janedoe
2310
+ FBURL;MEDIATYPE=text/calendar:ftp://example.com/busy/project-a.ifb
2311
+
2312
+ 6.9.2. CALADRURI
2313
+
2314
+ Purpose: To specify the calendar user address [RFC5545] to which a
2315
+ scheduling request [RFC5546] should be sent for the object
2316
+ represented by the vCard.
2317
+
2318
+ Value type: A single URI value.
2319
+
2320
+ Cardinality: *
2321
+
2322
+ Special notes: Where multiple CALADRURI properties are specified,
2323
+ the default CALADRURI property is indicated with the PREF
2324
+ parameter.
2325
+
2326
+ ABNF:
2327
+
2328
+ CALADRURI-param = "VALUE=uri" / pid-param / pref-param / type-param
2329
+ / mediatype-param / altid-param / any-param
2330
+ CALADRURI-value = URI
2331
+
2332
+ Example:
2333
+
2334
+ CALADRURI;PREF=1:mailto:janedoe@example.com
2335
+ CALADRURI:http://example.com/calendar/jdoe
2336
+
2337
+ 6.9.3. CALURI
2338
+
2339
+ Purpose: To specify the URI for a calendar associated with the
2340
+ object represented by the vCard.
2341
+
2342
+ Value type: A single URI value.
2343
+
2344
+ Cardinality: *
2345
+
2346
+ Special notes: Where multiple CALURI properties are specified, the
2347
+ default CALURI property is indicated with the PREF parameter. The
2348
+ property should contain a URI pointing to an iCalendar [RFC5545]
2349
+
2350
+ object associated with a snapshot of the user's calendar store.
2351
+ If the iCalendar object is represented as a file or document, its
2352
+ file extension should be ".ics".
2353
+
2354
+ ABNF:
2355
+
2356
+ CALURI-param = "VALUE=uri" / pid-param / pref-param / type-param
2357
+ / mediatype-param / altid-param / any-param
2358
+ CALURI-value = URI
2359
+
2360
+ Examples:
2361
+
2362
+ CALURI;PREF=1:http://cal.example.com/calA
2363
+ CALURI;MEDIATYPE=text/calendar:ftp://ftp.example.com/calA.ics
2364
+
2365
+ 6.10. Extended Properties and Parameters
2366
+
2367
+ The properties and parameters defined by this document can be
2368
+ extended. Non-standard, private properties and parameters with a
2369
+ name starting with "X-" may be defined bilaterally between two
2370
+ cooperating agents without outside registration or standardization.
2371
+
2372
+ 7. Synchronization
2373
+
2374
+ vCard data often needs to be synchronized between devices. In this
2375
+ context, synchronization is defined as the intelligent merging of two
2376
+ representations of the same object. vCard 4.0 includes mechanisms to
2377
+ aid this process.
2378
+
2379
+ 7.1. Mechanisms
2380
+
2381
+ Two mechanisms are available: the UID property is used to match
2382
+ multiple instances of the same vCard, while the PID parameter is used
2383
+ to match multiple instances of the same property.
2384
+
2385
+ The term "matching" is used here to mean recognizing that two
2386
+ instances are in fact representations of the same object. For
2387
+ example, a single vCard that is shared with someone results in two
2388
+ vCard instances. After they have evolved separately, they still
2389
+ represent the same object, and therefore may be matched by a
2390
+ synchronization engine.
2391
+
2392
+ 7.1.1. Matching vCard Instances
2393
+
2394
+ vCard instances for which the UID properties (Section 6.7.6) are
2395
+ equivalent MUST be matched. Equivalence is determined as specified
2396
+ in [RFC3986], Section 6.
2397
+
2398
+ In all other cases, vCard instances MAY be matched at the discretion
2399
+ of the synchronization engine.
2400
+
2401
+ 7.1.2. Matching Property Instances
2402
+
2403
+ Property instances belonging to unmatched vCards MUST NOT be matched.
2404
+
2405
+ Property instances whose name (e.g., EMAIL, TEL, etc.) is not the
2406
+ same MUST NOT be matched.
2407
+
2408
+ Property instances whose name is CLIENTPIDMAP are handled separately
2409
+ and MUST NOT be matched. The synchronization MUST ensure that there
2410
+ is consistency of CLIENTPIDMAPs among matched vCard instances.
2411
+
2412
+ Property instances belonging to matched vCards, whose name is the
2413
+ same, and whose maximum cardinality is 1, MUST be matched.
2414
+
2415
+ Property instances belonging to matched vCards, whose name is the
2416
+ same, and whose PID parameters match, MUST be matched. See
2417
+ Section 7.1.3 for details on PID matching.
2418
+
2419
+ In all other cases, property instances MAY be matched at the
2420
+ discretion of the synchronization engine.
2421
+
2422
+ 7.1.3. PID Matching
2423
+
2424
+ Two PID values for which the first fields are equivalent represent
2425
+ the same local value.
2426
+
2427
+ Two PID values representing the same local value and for which the
2428
+ second fields point to CLIENTPIDMAP properties whose second field
2429
+ URIs are equivalent (as specified in [RFC3986], Section 6) also
2430
+ represent the same global value.
2431
+
2432
+ PID parameters for which at least one pair of their values represent
2433
+ the same global value MUST be matched.
2434
+
2435
+ In all other cases, PID parameters MAY be matched at the discretion
2436
+ of the synchronization engine.
2437
+
2438
+ For example, PID value "5.1", in the first vCard below, and PID value
2439
+ "5.2", in the second vCard below, represent the same global value.
2440
+
2441
+ BEGIN:VCARD
2442
+ VERSION:4.0
2443
+ EMAIL;PID=4.2,5.1:jdoe@example.com
2444
+ CLIENTPIDMAP:1;urn:uuid:3eef374e-7179-4196-a914-27358c3e6527
2445
+ CLIENTPIDMAP:2;urn:uuid:42bcd5a7-1699-4514-87b4-056edf68e9cc
2446
+ END:VCARD
2447
+
2448
+ BEGIN:VCARD
2449
+ VERSION:4.0
2450
+ EMAIL;PID=5.1,5.2:john@example.com
2451
+ CLIENTPIDMAP:1;urn:uuid:0c75c629-6a8d-4d5e-a07f-1bb35846854d
2452
+ CLIENTPIDMAP:2;urn:uuid:3eef374e-7179-4196-a914-27358c3e6527
2453
+ END:VCARD
2454
+
2455
+ 7.2. Example
2456
+
2457
+ 7.2.1. Creation
2458
+
2459
+ The following simple vCard is first created on a given device.
2460
+
2461
+ BEGIN:VCARD
2462
+ VERSION:4.0
2463
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2464
+ FN;PID=1.1:J. Doe
2465
+ N:Doe;J.;;;
2466
+ EMAIL;PID=1.1:jdoe@example.com
2467
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2468
+ END:VCARD
2469
+
2470
+ This new vCard is assigned the UID
2471
+ "urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1" by the creating
2472
+ device. The FN and EMAIL properties are assigned the same local
2473
+ value of 1, and this value is given global context by associating it
2474
+ with "urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556", which
2475
+ represents the creating device. We are at liberty to reuse the same
2476
+ local value since instances of different properties will never be
2477
+ matched. The N property has no PID because it is forbidden by its
2478
+ maximum cardinality of 1.
2479
+
2480
+ 7.2.2. Initial Sharing
2481
+
2482
+ This vCard is shared with a second device. Upon inspecting the UID
2483
+ property, the second device understands that this is a new vCard
2484
+ (i.e., unmatched) and thus the synchronization results in a simple
2485
+ copy.
2486
+
2487
+ 7.2.3. Adding and Sharing a Property
2488
+
2489
+ A new phone number is created on the first device, then the vCard is
2490
+ shared with the second device. This is what the second device
2491
+ receives:
2492
+
2493
+ BEGIN:VCARD
2494
+ VERSION:4.0
2495
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2496
+ FN;PID=1.1:J. Doe
2497
+ N:Doe;J.;;;
2498
+ EMAIL;PID=1.1:jdoe@example.com
2499
+ TEL;PID=1.1;VALUE=uri:tel:+1-555-555-5555
2500
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2501
+ END:VCARD
2502
+
2503
+ Upon inspecting the UID property, the second device matches the vCard
2504
+ it received to the vCard that it already has stored. It then starts
2505
+ comparing the properties of the two vCards in same-named pairs.
2506
+
2507
+ The FN properties are matched because the PID parameters have the
2508
+ same global value. Since the property value is the same, no update
2509
+ takes place.
2510
+
2511
+ The N properties are matched automatically because their maximum
2512
+ cardinality is 1. Since the property value is the same, no update
2513
+ takes place.
2514
+
2515
+ The EMAIL properties are matched because the PID parameters have the
2516
+ same global value. Since the property value is the same, no update
2517
+ takes place.
2518
+
2519
+ The TEL property in the new vCard is not matched to any in the stored
2520
+ vCard because no property in the stored vCard has the same name.
2521
+ Therefore, this property is copied from the new vCard to the stored
2522
+ vCard.
2523
+
2524
+ The CLIENTPIDMAP property is handled separately by the
2525
+ synchronization engine. It ensures that it is consistent with the
2526
+ stored one. If it was not, the results would be up to the
2527
+ synchronization engine, and thus undefined by this document.
2528
+
2529
+ 7.2.4. Simultaneous Editing
2530
+
2531
+ A new email address and a new phone number are added to the vCard on
2532
+ each of the two devices, and then a new synchronization event
2533
+ happens. Here are the vCards that are communicated to each other:
2534
+
2535
+ BEGIN:VCARD
2536
+ VERSION:4.0
2537
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2538
+ FN;PID=1.1:J. Doe
2539
+ N:Doe;J.;;;
2540
+ EMAIL;PID=1.1:jdoe@example.com
2541
+ EMAIL;PID=2.1:boss@example.com
2542
+ TEL;PID=1.1;VALUE=uri:tel:+1-555-555-5555
2543
+ TEL;PID=2.1;VALUE=uri:tel:+1-666-666-6666
2544
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2545
+ END:VCARD
2546
+
2547
+ BEGIN:VCARD
2548
+ VERSION:4.0
2549
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2550
+ FN;PID=1.1:J. Doe
2551
+ N:Doe;J.;;;
2552
+ EMAIL;PID=1.1:jdoe@example.com
2553
+ EMAIL;PID=2.2:ceo@example.com
2554
+ TEL;PID=1.1;VALUE=uri:tel:+1-555-555-5555
2555
+ TEL;PID=2.2;VALUE=uri:tel:+1-666-666-6666
2556
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2557
+ CLIENTPIDMAP:2;urn:uuid:1f762d2b-03c4-4a83-9a03-75ff658a6eee
2558
+ END:VCARD
2559
+
2560
+ On the first device, the same PID source identifier (1) is reused for
2561
+ the new EMAIL and TEL properties. On the second device, a new source
2562
+ identifier (2) is generated, and a corresponding CLIENTPIDMAP
2563
+ property is created. It contains the second device's identifier,
2564
+ "urn:uuid:1f762d2b-03c4-4a83-9a03-75ff658a6eee".
2565
+
2566
+ The new EMAIL properties are unmatched on both sides since the PID
2567
+ global value is new in both cases. The sync thus results in a copy
2568
+ on both sides.
2569
+
2570
+ Although the situation appears to be the same for the TEL properties,
2571
+ in this case, the synchronization engine is particularly smart and
2572
+ matches the two new TEL properties even though their PID global
2573
+ values are different. Note that in this case, the rules of
2574
+ Section 7.1.2 state that two properties MAY be matched at the
2575
+ discretion of the synchronization engine. Therefore, the two
2576
+ properties are merged.
2577
+
2578
+ All this results in the following vCard, which is stored on both
2579
+ devices:
2580
+
2581
+ BEGIN:VCARD
2582
+ VERSION:4.0
2583
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2584
+ FN:J. Doe
2585
+ N:Doe;J.;;;
2586
+ EMAIL;PID=1.1:jdoe@example.com
2587
+ EMAIL;PID=2.1:boss@example.com
2588
+ EMAIL;PID=2.2:ceo@example.com
2589
+ TEL;PID=1.1;VALUE=uri:tel:+1-555-555-5555
2590
+ TEL;PID=2.1,2.2;VALUE=uri:tel:+1-666-666-6666
2591
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2592
+ CLIENTPIDMAP:2;urn:uuid:1f762d2b-03c4-4a83-9a03-75ff658a6eee
2593
+ END:VCARD
2594
+
2595
+ 7.2.5. Global Context Simplification
2596
+
2597
+ The two devices finish their synchronization procedure by simplifying
2598
+ their global contexts. Since they haven't talked to any other
2599
+ device, the following vCard is for all purposes equivalent to the
2600
+ above. It is also shorter.
2601
+
2602
+ BEGIN:VCARD
2603
+ VERSION:4.0
2604
+ UID:urn:uuid:4fbe8971-0bc3-424c-9c26-36c3e1eff6b1
2605
+ FN:J. Doe
2606
+ N:Doe;J.;;;
2607
+ EMAIL;PID=1.1:jdoe@example.com
2608
+ EMAIL;PID=2.1:boss@example.com
2609
+ EMAIL;PID=3.1:ceo@example.com
2610
+ TEL;PID=1.1;VALUE=uri:tel:+1-555-555-5555
2611
+ TEL;PID=2.1;VALUE=uri:tel:+1-666-666-6666
2612
+ CLIENTPIDMAP:1;urn:uuid:53e374d9-337e-4727-8803-a1e9c14e0556
2613
+ END:VCARD
2614
+
2615
+ The details of global context simplification are unspecified by this
2616
+ document. They are left up to the synchronization engine. This
2617
+ example is merely intended to illustrate the possibility, which
2618
+ investigating would be, in the author's opinion, worthwhile.
2619
+
2620
+ 8. Example: Author's vCard
2621
+
2622
+ BEGIN:VCARD
2623
+ VERSION:4.0
2624
+ FN:Simon Perreault
2625
+ N:Perreault;Simon;;;ing. jr,M.Sc.
2626
+ BDAY:--0203
2627
+ ANNIVERSARY:20090808T1430-0500
2628
+ GENDER:M
2629
+
2630
+ LANG;PREF=1:fr
2631
+ LANG;PREF=2:en
2632
+ ORG;TYPE=work:Viagenie
2633
+ ADR;TYPE=work:;Suite D2-630;2875 Laurier;
2634
+ Quebec;QC;G1V 2M2;Canada
2635
+ TEL;VALUE=uri;TYPE="work,voice";PREF=1:tel:+1-418-656-9254;ext=102
2636
+ TEL;VALUE=uri;TYPE="work,cell,voice,video,text":tel:+1-418-262-6501
2637
+ EMAIL;TYPE=work:simon.perreault@viagenie.ca
2638
+ GEO;TYPE=work:geo:46.772673,-71.282945
2639
+ KEY;TYPE=work;VALUE=uri:
2640
+ http://www.viagenie.ca/simon.perreault/simon.asc
2641
+ TZ:-0500
2642
+ URL;TYPE=home:http://nomis80.org
2643
+ END:VCARD
2644
+
2645
+ 9. Security Considerations
2646
+
2647
+ o Internet mail is often used to transport vCards and is subject to
2648
+ many well-known security attacks, including monitoring, replay,
2649
+ and forgery. Care should be taken by any directory service in
2650
+ allowing information to leave the scope of the service itself,
2651
+ where any access controls or confidentiality can no longer be
2652
+ guaranteed. Applications should also take care to display
2653
+ directory data in a "safe" environment.
2654
+
2655
+ o vCards can carry cryptographic keys or certificates, as described
2656
+ in Section 6.8.1.
2657
+
2658
+ o vCards often carry information that can be sensitive (e.g.,
2659
+ birthday, address, and phone information). Although vCards have
2660
+ no inherent authentication or confidentiality provisions, they can
2661
+ easily be carried by any security mechanism that transfers MIME
2662
+ objects to address authentication or confidentiality (e.g., S/MIME
2663
+ [RFC5751], OpenPGP [RFC4880]). In cases where the confidentiality
2664
+ or authenticity of information contained in vCard is a concern,
2665
+ the vCard SHOULD be transported using one of these secure
2666
+ mechanisms. The KEY property (Section 6.8.1) can be used to
2667
+ transport the public key used by these mechanisms.
2668
+
2669
+ o The information in a vCard may become out of date. In cases where
2670
+ the vitality of data is important to an originator of a vCard, the
2671
+ SOURCE property (Section 6.1.3) SHOULD be specified. In addition,
2672
+ the "REV" type described in Section 6.7.4 can be specified to
2673
+ indicate the last time that the vCard data was updated.
2674
+
2675
+ o Many vCard properties may be used to transport URIs. Please refer
2676
+ to [RFC3986], Section 7, for considerations related to URIs.
2677
+
2678
+ 10. IANA Considerations
2679
+
2680
+ 10.1. Media Type Registration
2681
+
2682
+ IANA has registered the following Media Type (in
2683
+ <http://www.iana.org/>) and marked the text/directory Media Type as
2684
+ DEPRECATED.
2685
+
2686
+ To: ietf-types@iana.org
2687
+
2688
+ Subject: Registration of media type text/vcard
2689
+
2690
+ Type name: text
2691
+
2692
+ Subtype name: vcard
2693
+
2694
+ Required parameters: none
2695
+
2696
+ Optional parameters: version
2697
+
2698
+ The "version" parameter is to be interpreted identically as the
2699
+ VERSION vCard property. If this parameter is present, all vCards
2700
+ in a text/vcard body part MUST have a VERSION property with value
2701
+ identical to that of this MIME parameter.
2702
+
2703
+ "charset": as defined for text/plain [RFC2046]; encodings other
2704
+ than UTF-8 [RFC3629] MUST NOT be used.
2705
+
2706
+ Encoding considerations: 8bit
2707
+
2708
+ Security considerations: See Section 9.
2709
+
2710
+ Interoperability considerations: The text/vcard media type is
2711
+ intended to identify vCard data of any version. There are older
2712
+ specifications of vCard [RFC2426][vCard21] still in common use.
2713
+ While these formats are similar, they are not strictly compatible.
2714
+ In general, it is necessary to inspect the value of the VERSION
2715
+ property (see Section 6.7.9) for identifying the standard to which
2716
+ a given vCard object conforms.
2717
+
2718
+ In addition, the following media types are known to have been used
2719
+ to refer to vCard data. They should be considered deprecated in
2720
+ favor of text/vcard.
2721
+
2722
+ * text/directory
2723
+ * text/directory; profile=vcard
2724
+ * text/x-vcard
2725
+
2726
+ Published specification: RFC 6350
2727
+
2728
+ Applications that use this media type: They are numerous, diverse,
2729
+ and include mail user agents, instant messaging clients, address
2730
+ book applications, directory servers, and customer relationship
2731
+ management software.
2732
+
2733
+ Additional information:
2734
+
2735
+ Magic number(s):
2736
+
2737
+ File extension(s): .vcf .vcard
2738
+
2739
+ Macintosh file type code(s):
2740
+
2741
+ Person & email address to contact for further information: vCard
2742
+ discussion mailing list <vcarddav@ietf.org>
2743
+
2744
+ Intended usage: COMMON
2745
+
2746
+ Restrictions on usage: none
2747
+
2748
+ Author: Simon Perreault
2749
+
2750
+ Change controller: IETF
2751
+
2752
+ 10.2. Registering New vCard Elements
2753
+
2754
+ This section defines the process for registering new or modified
2755
+ vCard elements (i.e., properties, parameters, value data types, and
2756
+ values) with IANA.
2757
+
2758
+ 10.2.1. Registration Procedure
2759
+
2760
+ The IETF has created a mailing list, vcarddav@ietf.org, which can be
2761
+ used for public discussion of vCard element proposals prior to
2762
+ registration. Use of the mailing list is strongly encouraged. The
2763
+ IESG has appointed a designated expert who will monitor the
2764
+ vcarddav@ietf.org mailing list and review registrations.
2765
+
2766
+ Registration of new vCard elements MUST be reviewed by the designated
2767
+ expert and published in an RFC. A Standards Track RFC is REQUIRED
2768
+ for the registration of new value data types that modify existing
2769
+ properties. A Standards Track RFC is also REQUIRED for registration
2770
+ of vCard elements that modify vCard elements previously documented in
2771
+ a Standards Track RFC.
2772
+
2773
+ The registration procedure begins when a completed registration
2774
+ template, defined in the sections below, is sent to vcarddav@ietf.org
2775
+ and iana@iana.org. Within two weeks, the designated expert is
2776
+ expected to tell IANA and the submitter of the registration whether
2777
+ the registration is approved, approved with minor changes, or
2778
+ rejected with cause. When a registration is rejected with cause, it
2779
+ can be re-submitted if the concerns listed in the cause are
2780
+ addressed. Decisions made by the designated expert can be appealed
2781
+ to the IESG Applications Area Director, then to the IESG. They
2782
+ follow the normal appeals procedure for IESG decisions.
2783
+
2784
+ Once the registration procedure concludes successfully, IANA creates
2785
+ or modifies the corresponding record in the vCard registry. The
2786
+ completed registration template is discarded.
2787
+
2788
+ An RFC specifying new vCard elements MUST include the completed
2789
+ registration templates, which MAY be expanded with additional
2790
+ information. These completed templates are intended to go in the
2791
+ body of the document, not in the IANA Considerations section.
2792
+
2793
+ Finally, note that there is an XML representation for vCard defined
2794
+ in [RFC6351]. An XML representation SHOULD be defined for new vCard
2795
+ elements.
2796
+
2797
+ 10.2.2. Vendor Namespace
2798
+
2799
+ The vendor namespace is used for vCard elements associated with
2800
+ commercially available products. "Vendor" or "producer" are
2801
+ construed as equivalent and very broadly in this context.
2802
+
2803
+ A registration may be placed in the vendor namespace by anyone who
2804
+ needs to interchange files associated with the particular product.
2805
+ However, the registration formally belongs to the vendor or
2806
+ organization handling the vCard elements in the namespace being
2807
+ registered. Changes to the specification will be made at their
2808
+ request, as discussed in subsequent sections.
2809
+
2810
+ vCard elements belonging to the vendor namespace will be
2811
+ distinguished by the "VND-" prefix. This is followed by an IANA-
2812
+ registered Private Enterprise Number (PEN), a dash, and a vCard
2813
+ element designation of the vendor's choosing (e.g., "VND-123456-
2814
+ MUDPIE").
2815
+
2816
+ While public exposure and review of vCard elements to be registered
2817
+ in the vendor namespace are not required, using the vcarddav@ietf.org
2818
+ mailing list for review is strongly encouraged to improve the quality
2819
+ of those specifications. Registrations in the vendor namespace may
2820
+ be submitted directly to the IANA.
2821
+
2822
+ 10.2.3. Registration Template for Properties
2823
+
2824
+ A property is defined by completing the following template.
2825
+
2826
+ Namespace: Empty for the global namespace, "VND-NNNN-" for a vendor-
2827
+ specific property (where NNNN is replaced by the vendor's PEN).
2828
+
2829
+ Property name: The name of the property.
2830
+
2831
+ Purpose: The purpose of the property. Give a short but clear
2832
+ description.
2833
+
2834
+ Value type: Any of the valid value types for the property value
2835
+ needs to be specified. The default value type also needs to be
2836
+ specified.
2837
+
2838
+ Cardinality: See Section 6.
2839
+
2840
+ Property parameters: Any of the valid property parameters for the
2841
+ property MUST be specified.
2842
+
2843
+ Description: Any special notes about the property, how it is to be
2844
+ used, etc.
2845
+
2846
+ Format definition: The ABNF for the property definition needs to be
2847
+ specified.
2848
+
2849
+ Example(s): One or more examples of instances of the property need
2850
+ to be specified.
2851
+
2852
+ 10.2.4. Registration Template for Parameters
2853
+
2854
+ A parameter is defined by completing the following template.
2855
+
2856
+ Namespace: Empty for the global namespace, "VND-NNNN-" for a vendor-
2857
+ specific property (where NNNN is replaced by the vendor's PEN).
2858
+
2859
+ Parameter name: The name of the parameter.
2860
+
2861
+ Purpose: The purpose of the parameter. Give a short but clear
2862
+ description.
2863
+
2864
+ Description: Any special notes about the parameter, how it is to be
2865
+ used, etc.
2866
+
2867
+ Format definition: The ABNF for the parameter definition needs to be
2868
+ specified.
2869
+
2870
+ Example(s): One or more examples of instances of the parameter need
2871
+ to be specified.
2872
+
2873
+ 10.2.5. Registration Template for Value Data Types
2874
+
2875
+ A value data type is defined by completing the following template.
2876
+
2877
+ Value name: The name of the value type.
2878
+
2879
+ Purpose: The purpose of the value type. Give a short but clear
2880
+ description.
2881
+
2882
+ Description: Any special notes about the value type, how it is to be
2883
+ used, etc.
2884
+
2885
+ Format definition: The ABNF for the value type definition needs to
2886
+ be specified.
2887
+
2888
+ Example(s): One or more examples of instances of the value type need
2889
+ to be specified.
2890
+
2891
+ 10.2.6. Registration Template for Values
2892
+
2893
+ A value is defined by completing the following template.
2894
+
2895
+ Value: The value literal.
2896
+
2897
+ Purpose: The purpose of the value. Give a short but clear
2898
+ description.
2899
+
2900
+ Conformance: The vCard properties and/or parameters that can take
2901
+ this value needs to be specified.
2902
+
2903
+ Example(s): One or more examples of instances of the value need to
2904
+ be specified.
2905
+
2906
+ The following is a fictitious example of a registration of a vCard
2907
+ value:
2908
+
2909
+ Value: supervisor
2910
+
2911
+ Purpose: It means that the related entity is the direct hierarchical
2912
+ superior (i.e., supervisor or manager) of the entity this vCard
2913
+ represents.
2914
+
2915
+ Conformance: This value can be used with the "TYPE" parameter
2916
+ applied on the "RELATED" property.
2917
+
2918
+ Example(s):
2919
+
2920
+ RELATED;TYPE=supervisor:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
2921
+
2922
+ 10.3. Initial vCard Elements Registries
2923
+
2924
+ The IANA has created and will maintain the following registries for
2925
+ vCard elements with pointers to appropriate reference documents. The
2926
+ registries are grouped together under the heading "vCard Elements".
2927
+
2928
+ 10.3.1. Properties Registry
2929
+
2930
+ The following table has been used to initialize the properties
2931
+ registry.
2932
+
2933
+ +-----------+--------------+-------------------------+
2934
+ | Namespace | Property | Reference |
2935
+ +-----------+--------------+-------------------------+
2936
+ | | SOURCE | RFC 6350, Section 6.1.3 |
2937
+ | | KIND | RFC 6350, Section 6.1.4 |
2938
+ | | XML | RFC 6350, Section 6.1.5 |
2939
+ | | FN | RFC 6350, Section 6.2.1 |
2940
+ | | N | RFC 6350, Section 6.2.2 |
2941
+ | | NICKNAME | RFC 6350, Section 6.2.3 |
2942
+ | | PHOTO | RFC 6350, Section 6.2.4 |
2943
+ | | BDAY | RFC 6350, Section 6.2.5 |
2944
+ | | ANNIVERSARY | RFC 6350, Section 6.2.6 |
2945
+ | | GENDER | RFC 6350, Section 6.2.7 |
2946
+ | | ADR | RFC 6350, Section 6.3.1 |
2947
+ | | TEL | RFC 6350, Section 6.4.1 |
2948
+ | | EMAIL | RFC 6350, Section 6.4.2 |
2949
+ | | IMPP | RFC 6350, Section 6.4.3 |
2950
+ | | LANG | RFC 6350, Section 6.4.4 |
2951
+ | | TZ | RFC 6350, Section 6.5.1 |
2952
+ | | GEO | RFC 6350, Section 6.5.2 |
2953
+ | | TITLE | RFC 6350, Section 6.6.1 |
2954
+ | | ROLE | RFC 6350, Section 6.6.2 |
2955
+ | | LOGO | RFC 6350, Section 6.6.3 |
2956
+ | | ORG | RFC 6350, Section 6.6.4 |
2957
+ | | MEMBER | RFC 6350, Section 6.6.5 |
2958
+ | | RELATED | RFC 6350, Section 6.6.6 |
2959
+ | | CATEGORIES | RFC 6350, Section 6.7.1 |
2960
+ | | NOTE | RFC 6350, Section 6.7.2 |
2961
+ | | PRODID | RFC 6350, Section 6.7.3 |
2962
+ | | REV | RFC 6350, Section 6.7.4 |
2963
+ | | SOUND | RFC 6350, Section 6.7.5 |
2964
+ | | UID | RFC 6350, Section 6.7.6 |
2965
+ | | CLIENTPIDMAP | RFC 6350, Section 6.7.7 |
2966
+ | | URL | RFC 6350, Section 6.7.8 |
2967
+ | | VERSION | RFC 6350, Section 6.7.9 |
2968
+ | | KEY | RFC 6350, Section 6.8.1 |
2969
+ | | FBURL | RFC 6350, Section 6.9.1 |
2970
+ | | CALADRURI | RFC 6350, Section 6.9.2 |
2971
+ | | CALURI | RFC 6350, Section 6.9.3 |
2972
+ +-----------+--------------+-------------------------+
2973
+
2974
+ 10.3.2. Parameters Registry
2975
+
2976
+ The following table has been used to initialize the parameters
2977
+ registry.
2978
+
2979
+ +-----------+-----------+------------------------+
2980
+ | Namespace | Parameter | Reference |
2981
+ +-----------+-----------+------------------------+
2982
+ | | LANGUAGE | RFC 6350, Section 5.1 |
2983
+ | | VALUE | RFC 6350, Section 5.2 |
2984
+ | | PREF | RFC 6350, Section 5.3 |
2985
+ | | ALTID | RFC 6350, Section 5.4 |
2986
+ | | PID | RFC 6350, Section 5.5 |
2987
+ | | TYPE | RFC 6350, Section 5.6 |
2988
+ | | MEDIATYPE | RFC 6350, Section 5.7 |
2989
+ | | CALSCALE | RFC 6350, Section 5.8 |
2990
+ | | SORT-AS | RFC 6350, Section 5.9 |
2991
+ | | GEO | RFC 6350, Section 5.10 |
2992
+ | | TZ | RFC 6350, Section 5.11 |
2993
+ +-----------+-----------+------------------------+
2994
+
2995
+ 10.3.3. Value Data Types Registry
2996
+
2997
+ The following table has been used to initialize the parameters
2998
+ registry.
2999
+
3000
+ +------------------+-------------------------+
3001
+ | Value Data Type | Reference |
3002
+ +------------------+-------------------------+
3003
+ | BOOLEAN | RFC 6350, Section 4.4 |
3004
+ | DATE | RFC 6350, Section 4.3.1 |
3005
+ | DATE-AND-OR-TIME | RFC 6350, Section 4.3.4 |
3006
+ | DATE-TIME | RFC 6350, Section 4.3.3 |
3007
+ | FLOAT | RFC 6350, Section 4.6 |
3008
+ | INTEGER | RFC 6350, Section 4.5 |
3009
+ | LANGUAGE-TAG | RFC 6350, Section 4.8 |
3010
+ | TEXT | RFC 6350, Section 4.1 |
3011
+ | TIME | RFC 6350, Section 4.3.2 |
3012
+ | TIMESTAMP | RFC 6350, Section 4.3.5 |
3013
+ | URI | RFC 6350, Section 4.2 |
3014
+ | UTC-OFFSET | RFC 6350, Section 4.7 |
3015
+ +------------------+-------------------------+
3016
+
3017
+ 10.3.4. Values Registries
3018
+
3019
+ Separate tables are used for property and parameter values.
3020
+
3021
+ The following table is to be used to initialize the property values
3022
+ registry.
3023
+
3024
+ +----------+------------+-------------------------+
3025
+ | Property | Value | Reference |
3026
+ +----------+------------+-------------------------+
3027
+ | BEGIN | VCARD | RFC 6350, Section 6.1.1 |
3028
+ | END | VCARD | RFC 6350, Section 6.1.2 |
3029
+ | KIND | individual | RFC 6350, Section 6.1.4 |
3030
+ | KIND | group | RFC 6350, Section 6.1.4 |
3031
+ | KIND | org | RFC 6350, Section 6.1.4 |
3032
+ | KIND | location | RFC 6350, Section 6.1.4 |
3033
+ +----------+------------+-------------------------+
3034
+
3035
+ The following table has been used to initialize the parameter values
3036
+ registry.
3037
+
3038
+ +------------------------+-----------+--------------+---------------+
3039
+ | Property | Parameter | Value | Reference |
3040
+ +------------------------+-----------+--------------+---------------+
3041
+ | FN, NICKNAME, PHOTO, | TYPE | work | RFC 6350, |
3042
+ | ADR, TEL, EMAIL, IMPP, | | | Section 5.6 |
3043
+ | LANG, TZ, GEO, TITLE, | | | |
3044
+ | ROLE, LOGO, ORG, | | | |
3045
+ | RELATED, CATEGORIES, | | | |
3046
+ | NOTE, SOUND, URL, KEY, | | | |
3047
+ | FBURL, CALADRURI, and | | | |
3048
+ | CALURI | | | |
3049
+ | FN, NICKNAME, PHOTO, | TYPE | home | RFC 6350, |
3050
+ | ADR, TEL, EMAIL, IMPP, | | | Section 5.6 |
3051
+ | LANG, TZ, GEO, TITLE, | | | |
3052
+ | ROLE, LOGO, ORG, | | | |
3053
+ | RELATED, CATEGORIES, | | | |
3054
+ | NOTE, SOUND, URL, KEY, | | | |
3055
+ | FBURL, CALADRURI, and | | | |
3056
+ | CALURI | | | |
3057
+ | TEL | TYPE | text | RFC 6350, |
3058
+ | | | | Section 6.4.1 |
3059
+ | TEL | TYPE | voice | RFC 6350, |
3060
+ | | | | Section 6.4.1 |
3061
+ | TEL | TYPE | fax | RFC 6350, |
3062
+ | | | | Section 6.4.1 |
3063
+ | TEL | TYPE | cell | RFC 6350, |
3064
+ | | | | Section 6.4.1 |
3065
+ | TEL | TYPE | video | RFC 6350, |
3066
+ | | | | Section 6.4.1 |
3067
+ | TEL | TYPE | pager | RFC 6350, |
3068
+ | | | | Section 6.4.1 |
3069
+ | TEL | TYPE | textphone | RFC 6350, |
3070
+ | | | | Section 6.4.1 |
3071
+ | BDAY, ANNIVERSARY | CALSCALE | gregorian | RFC 6350, |
3072
+ | | | | Section 5.8 |
3073
+ | RELATED | TYPE | contact | RFC 6350, |
3074
+ | | | | Section 6.6.6 |
3075
+ | | | | and [xfn] |
3076
+ | RELATED | TYPE | acquaintance | RFC 6350, |
3077
+ | | | | Section 6.6.6 |
3078
+ | | | | and [xfn] |
3079
+ | RELATED | TYPE | friend | RFC 6350, |
3080
+ | | | | Section 6.6.6 |
3081
+ | | | | and [xfn] |
3082
+ | RELATED | TYPE | met | RFC 6350, |
3083
+ | | | | Section 6.6.6 |
3084
+ | | | | and [xfn] |
3085
+
3086
+ | RELATED | TYPE | co-worker | RFC 6350, |
3087
+ | | | | Section 6.6.6 |
3088
+ | | | | and [xfn] |
3089
+ | RELATED | TYPE | colleague | RFC 6350, |
3090
+ | | | | Section 6.6.6 |
3091
+ | | | | and [xfn] |
3092
+ | RELATED | TYPE | co-resident | RFC 6350, |
3093
+ | | | | Section 6.6.6 |
3094
+ | | | | and [xfn] |
3095
+ | RELATED | TYPE | neighbor | RFC 6350, |
3096
+ | | | | Section 6.6.6 |
3097
+ | | | | and [xfn] |
3098
+ | RELATED | TYPE | child | RFC 6350, |
3099
+ | | | | Section 6.6.6 |
3100
+ | | | | and [xfn] |
3101
+ | RELATED | TYPE | parent | RFC 6350, |
3102
+ | | | | Section 6.6.6 |
3103
+ | | | | and [xfn] |
3104
+ | RELATED | TYPE | sibling | RFC 6350, |
3105
+ | | | | Section 6.6.6 |
3106
+ | | | | and [xfn] |
3107
+ | RELATED | TYPE | spouse | RFC 6350, |
3108
+ | | | | Section 6.6.6 |
3109
+ | | | | and [xfn] |
3110
+ | RELATED | TYPE | kin | RFC 6350, |
3111
+ | | | | Section 6.6.6 |
3112
+ | | | | and [xfn] |
3113
+ | RELATED | TYPE | muse | RFC 6350, |
3114
+ | | | | Section 6.6.6 |
3115
+ | | | | and [xfn] |
3116
+ | RELATED | TYPE | crush | RFC 6350, |
3117
+ | | | | Section 6.6.6 |
3118
+ | | | | and [xfn] |
3119
+ | RELATED | TYPE | date | RFC 6350, |
3120
+ | | | | Section 6.6.6 |
3121
+ | | | | and [xfn] |
3122
+ | RELATED | TYPE | sweetheart | RFC 6350, |
3123
+ | | | | Section 6.6.6 |
3124
+ | | | | and [xfn] |
3125
+ | RELATED | TYPE | me | RFC 6350, |
3126
+ | | | | Section 6.6.6 |
3127
+ | | | | and [xfn] |
3128
+ | RELATED | TYPE | agent | RFC 6350, |
3129
+ | | | | Section 6.6.6 |
3130
+ | RELATED | TYPE | emergency | RFC 6350, |
3131
+ | | | | Section 6.6.6 |
3132
+ +------------------------+-----------+--------------+---------------+
3133
+
3134
+ 11. Acknowledgments
3135
+
3136
+ The authors would like to thank Tim Howes, Mark Smith, and Frank
3137
+ Dawson, the original authors of [RFC2425] and [RFC2426], Pete
3138
+ Resnick, who got this effort started and provided help along the way,
3139
+ as well as the following individuals who have participated in the
3140
+ drafting, review, and discussion of this memo:
3141
+
3142
+ Aki Niemi, Andy Mabbett, Alexander Mayrhofer, Alexey Melnikov, Anil
3143
+ Srivastava, Barry Leiba, Ben Fortuna, Bernard Desruisseaux, Bernie
3144
+ Hoeneisen, Bjoern Hoehrmann, Caleb Richardson, Chris Bryant, Chris
3145
+ Newman, Cyrus Daboo, Daisuke Miyakawa, Dan Brickley, Dan Mosedale,
3146
+ Dany Cauchie, Darryl Champagne, Dave Thewlis, Filip Navara, Florian
3147
+ Zeitz, Helge Hess, Jari Urpalainen, Javier Godoy, Jean-Luc Schellens,
3148
+ Joe Hildebrand, Jose Luis Gayosso, Joseph Smarr, Julian Reschke,
3149
+ Kepeng Li, Kevin Marks, Kevin Wu Won, Kurt Zeilenga, Lisa Dusseault,
3150
+ Marc Blanchet, Mark Paterson, Markus Lorenz, Michael Haardt, Mike
3151
+ Douglass, Nick Levinson, Peter K. Sheerin, Peter Mogensen, Peter
3152
+ Saint-Andre, Renato Iannella, Rohit Khare, Sly Gryphon, Stephane
3153
+ Bortzmeyer, Tantek Celik, and Zoltan Ordogh.
3154
+
3155
+ 12. References
3156
+
3157
+ 12.1. Normative References
3158
+
3159
+ [CCITT.X520.1988]
3160
+ International Telephone and Telegraph Consultative
3161
+ Committee, "Information Technology - Open Systems
3162
+ Interconnection - The Directory: Selected Attribute
3163
+ Types", CCITT Recommendation X.520, November 1988.
3164
+
3165
+ [IEEE.754.2008]
3166
+ Institute of Electrical and Electronics Engineers,
3167
+ "Standard for Binary Floating-Point Arithmetic",
3168
+ IEEE Standard 754, August 2008.
3169
+
3170
+ [ISO.8601.2000]
3171
+ International Organization for Standardization, "Data
3172
+ elements and interchange formats - Information interchange
3173
+ - Representation of dates and times", ISO Standard 8601,
3174
+ December 2000.
3175
+
3176
+ [ISO.8601.2004]
3177
+ International Organization for Standardization, "Data
3178
+ elements and interchange formats - Information interchange
3179
+ - Representation of dates and times", ISO Standard 8601,
3180
+ December 2004.
3181
+
3182
+ [RFC2045] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
3183
+ Extensions (MIME) Part One: Format of Internet Message
3184
+ Bodies", RFC 2045, November 1996.
3185
+
3186
+ [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
3187
+ Extensions (MIME) Part Two: Media Types", RFC 2046,
3188
+ November 1996.
3189
+
3190
+ [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
3191
+ Requirement Levels", BCP 14, RFC 2119, March 1997.
3192
+
3193
+ [RFC2739] Small, T., Hennessy, D., and F. Dawson, "Calendar
3194
+ Attributes for vCard and LDAP", RFC 2739, January 2000.
3195
+
3196
+ [RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO
3197
+ 10646", STD 63, RFC 3629, November 2003.
3198
+
3199
+ [RFC3966] Schulzrinne, H., "The tel URI for Telephone Numbers",
3200
+ RFC 3966, December 2004.
3201
+
3202
+ [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
3203
+ Resource Identifier (URI): Generic Syntax", STD 66,
3204
+ RFC 3986, January 2005.
3205
+
3206
+ [RFC4122] Leach, P., Mealling, M., and R. Salz, "A Universally
3207
+ Unique IDentifier (UUID) URN Namespace", RFC 4122,
3208
+ July 2005.
3209
+
3210
+ [RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and
3211
+ Registration Procedures", BCP 13, RFC 4288, December 2005.
3212
+
3213
+ [RFC5234] Crocker, D. and P. Overell, "Augmented BNF for Syntax
3214
+ Specifications: ABNF", STD 68, RFC 5234, January 2008.
3215
+
3216
+ [RFC5322] Resnick, P., Ed., "Internet Message Format", RFC 5322,
3217
+ October 2008.
3218
+
3219
+ [RFC5545] Desruisseaux, B., "Internet Calendaring and Scheduling
3220
+ Core Object Specification (iCalendar)", RFC 5545,
3221
+ September 2009.
3222
+
3223
+ [RFC5546] Daboo, C., "iCalendar Transport-Independent
3224
+ Interoperability Protocol (iTIP)", RFC 5546,
3225
+ December 2009.
3226
+
3227
+ [RFC5646] Phillips, A. and M. Davis, "Tags for Identifying
3228
+ Languages", BCP 47, RFC 5646, September 2009.
3229
+
3230
+ [RFC5870] Mayrhofer, A. and C. Spanring, "A Uniform Resource
3231
+ Identifier for Geographic Locations ('geo' URI)",
3232
+ RFC 5870, June 2010.
3233
+
3234
+ [RFC6351] Perreault, S., "xCard: vCard XML Representation",
3235
+ RFC 6351, August 2011.
3236
+
3237
+ [W3C.REC-xml-20081126]
3238
+ Maler, E., Yergeau, F., Sperberg-McQueen, C., Paoli, J.,
3239
+ and T. Bray, "Extensible Markup Language (XML) 1.0 (Fifth
3240
+ Edition)", World Wide Web Consortium Recommendation REC-
3241
+ xml-20081126, November 2008,
3242
+ <http://www.w3.org/TR/2008/REC-xml-20081126>.
3243
+
3244
+ [xfn] Celik, T., Mullenweg, M., and E. Meyer, "XFN 1.1 profile",
3245
+ <http://gmpg.org/xfn/11>.
3246
+
3247
+ 12.2. Informative References
3248
+
3249
+ [IANA-TZ] Lear, E. and P. Eggert, "IANA Procedures for Maintaining
3250
+ the Timezone Database", Work in Progress, May 2011.
3251
+
3252
+ [ISO9070] International Organization for Standardization,
3253
+ "Information Processing - SGML support facilities -
3254
+ Registration Procedures for Public Text Owner
3255
+ Identifiers", ISO 9070, April 1991.
3256
+
3257
+ [RFC1738] Berners-Lee, T., Masinter, L., and M. McCahill, "Uniform
3258
+ Resource Locators (URL)", RFC 1738, December 1994.
3259
+
3260
+ [RFC2397] Masinter, L., "The "data" URL scheme", RFC 2397,
3261
+ August 1998.
3262
+
3263
+ [RFC2425] Howes, T., Smith, M., and F. Dawson, "A MIME Content-Type
3264
+ for Directory Information", RFC 2425, September 1998.
3265
+
3266
+ [RFC2426] Dawson, F. and T. Howes, "vCard MIME Directory Profile",
3267
+ RFC 2426, September 1998.
3268
+
3269
+ [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
3270
+ Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
3271
+ Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.
3272
+
3273
+ [RFC3282] Alvestrand, H., "Content Language Headers", RFC 3282,
3274
+ May 2002.
3275
+
3276
+ [RFC3406] Daigle, L., van Gulik, D., Iannella, R., and P. Faltstrom,
3277
+ "Uniform Resource Names (URN) Namespace Definition
3278
+ Mechanisms", BCP 66, RFC 3406, October 2002.
3279
+
3280
+ [RFC3536] Hoffman, P., "Terminology Used in Internationalization in
3281
+ the IETF", RFC 3536, May 2003.
3282
+
3283
+ [RFC4770] Jennings, C. and J. Reschke, Ed., "vCard Extensions for
3284
+ Instant Messaging (IM)", RFC 4770, January 2007.
3285
+
3286
+ [RFC4880] Callas, J., Donnerhacke, L., Finney, H., Shaw, D., and R.
3287
+ Thayer, "OpenPGP Message Format", RFC 4880, November 2007.
3288
+
3289
+ [RFC5335bis]
3290
+ Yang, A. and S. Steele, "Internationalized Email Headers",
3291
+ Work in Progress, July 2011.
3292
+
3293
+ [RFC5751] Ramsdell, B. and S. Turner, "Secure/Multipurpose Internet
3294
+ Mail Extensions (S/MIME) Version 3.2 Message
3295
+ Specification", RFC 5751, January 2010.
3296
+
3297
+ [RFC6068] Duerst, M., Masinter, L., and J. Zawinski, "The 'mailto'
3298
+ URI Scheme", RFC 6068, October 2010.
3299
+
3300
+ [TZ-DB] Olson, A., "Time zone code and data",
3301
+ <ftp://elsie.nci.nih.gov/pub/>.
3302
+
3303
+ [vCard21] Internet Mail Consortium, "vCard - The Electronic Business
3304
+ Card Version 2.1", September 1996.
3305
+
3306
+ Appendix A. Differences from RFCs 2425 and 2426
3307
+
3308
+ This appendix contains a high-level overview of the major changes
3309
+ that have been made in the vCard specification from RFCs 2425 and
3310
+ 2426. It is incomplete, as it only lists the most important changes.
3311
+
3312
+ A.1. New Structure
3313
+
3314
+ o [RFC2425] and [RFC2426] have been merged.
3315
+
3316
+ o vCard is now not only a MIME type but a stand-alone format.
3317
+
3318
+ o A proper MIME type registration form has been included.
3319
+
3320
+ o UTF-8 is now the only possible character set.
3321
+
3322
+ o New vCard elements can be registered from IANA.
3323
+
3324
+ A.2. Removed Features
3325
+
3326
+ o The CONTEXT and CHARSET parameters are no more.
3327
+
3328
+ o The NAME, MAILER, LABEL, and CLASS properties are no more.
3329
+
3330
+ o The "intl", "dom", "postal", and "parcel" TYPE parameter values
3331
+ for the ADR property have been removed.
3332
+
3333
+ o In-line vCards (such as the value of the AGENT property) are no
3334
+ longer supported.
3335
+
3336
+ A.3. New Properties and Parameters
3337
+
3338
+ o The KIND, GENDER, LANG, ANNIVERSARY, XML, and CLIENTPIDMAP
3339
+ properties have been added.
3340
+
3341
+ o [RFC2739], which defines the FBURL, CALADRURI, CAPURI, and CALURI
3342
+ properties, has been merged in.
3343
+
3344
+ o [RFC4770], which defines the IMPP property, has been merged in.
3345
+
3346
+ o The "work" and "home" TYPE parameter values are now applicable to
3347
+ many more properties.
3348
+
3349
+ o The "pref" value of the TYPE parameter is now a parameter of its
3350
+ own, with a positive integer value indicating the level of
3351
+ preference.
3352
+
3353
+ o The ALTID and PID parameters have been added.
3354
+
3355
+ o The MEDIATYPE parameter has been added and replaces the TYPE
3356
+ parameter when it was used for indicating the media type of the
3357
+ property's content.
3358
+
3359
+ Author's Address
3360
+
3361
+ Simon Perreault
3362
+ Viagenie
3363
+ 2875 Laurier, suite D2-630
3364
+ Quebec, QC G1V 2M2
3365
+ Canada
3366
+
3367
+ Phone: +1 418 656 9254
3368
+ EMail: simon.perreault@viagenie.ca
3369
+ URI: http://www.viagenie.ca
3370
+
3371
+ Perreault Standards Track [Page 74]
3372
+