idnits 2.17.1 

draft-iab-rfc7991bis-00.txt:

  Checking boilerplate required by RFC 5378 and the IETF Trust (see
  https://trustee.ietf.org/license-info):
  ----------------------------------------------------------------------------

  -- The document has an IETF Trust Provisions (28 Dec 2009) Section 6.c(i)
     Publication Limitation clause.

  -- The document has an IETF Trust Provisions (28 Dec 2009) Section 6.c(ii)
     Publication Limitation clause.  If this document is intended for
     submission to the IESG for publication, this constitutes an error.


  Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt:
  ----------------------------------------------------------------------------

     No issues found here.

  Checking nits according to https://www.ietf.org/id-info/checklist :
  ----------------------------------------------------------------------------

  -- The draft header indicates that this document obsoletes RFC7991, but the
     abstract doesn't seem to directly say this.  It does mention RFC7991
     though, so this could be OK.


  Miscellaneous warnings:
  ----------------------------------------------------------------------------

  == The copyright year in the IETF Trust and authors Copyright Line does not
     match the current year

  == The document seems to lack the recommended RFC 2119 boilerplate, even if
     it appears to use RFC 2119 keywords. 

     (The document does seem to have the reference to RFC 2119 which the
     ID-Checklist requires).
  == The document seems to contain a disclaimer for pre-RFC5378 work, but was
     first submitted on or after 10 November 2008.  The disclaimer is usually
     necessary only for documents that revise or obsolete older RFCs, and that
     take significant amounts of text from those RFCs.  If you can contact all
     authors of the source material and they are willing to grant the BCP78
     rights to the IETF Trust, you can and should remove the disclaimer. 
     Otherwise, the disclaimer is needed and you can ignore this comment. 
     (See the Legal Provisions document at
     https://trustee.ietf.org/license-info for more information.)

  -- The document date (October 17, 2018) is 2011 days in the past.  Is this
     intentional?

  -- Found something which looks like a code comment -- if you have code
     sections in the document, please surround them with '<CODE BEGINS>' and
     '<CODE ENDS>' lines.


  Checking references for intended status: Informational
  ----------------------------------------------------------------------------

  == Missing Reference: 'April1' is mentioned on line 1966, but not defined

  -- Obsolete informational reference (is this intentional?): RFC 2629
     (Obsoleted by RFC 7749)

  -- Obsolete informational reference (is this intentional?): RFC 3667
     (Obsoleted by RFC 3978)

  -- Obsolete informational reference (is this intentional?): RFC 3978
     (Obsoleted by RFC 5378)

  -- Obsolete informational reference (is this intentional?): RFC 7749
     (Obsoleted by RFC 7991)


     Summary: 0 errors (**), 0 flaws (~~), 4 warnings (==), 9 comments (--).

     Run idnits with the --verbose option for more detailed information about
     the items above.
--------------------------------------------------------------------------------


2	Network Working Group                                         P. Hoffman
3	Internet-Draft                                                     ICANN
4	Obsoletes: 7991 (if approved)                           October 17, 2018
5	Intended status: Informational
6	Expires: April 20, 2019

8	                   The "xml2rfc" version 3 Vocabulary
9	                        draft-iab-rfc7991bis-00

11	Abstract

13	   This document defines the "xml2rfc" version 3 vocabulary: an XML-
14	   based language used for writing RFCs and Internet-Drafts.  It is
15	   heavily derived from the version 2 vocabulary that is also under
16	   discussion.  This document obsoletes the earlier v3 grammar described
17	   in RFC 7991, which in turn obsoleted the v2 grammar in RFC 7749.

19	Editorial Note (To be removed by RFC Editor)

21	   Discussion of this draft takes place on the xml2rfc-dev@ietf.org
22	   mailing list, which has its home page at
23	   <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>.

25	Status of This Memo

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

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

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

40	   This Internet-Draft will expire on April 20, 2019.

42	Copyright Notice

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

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

57	Table of Contents

59	   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   5
60	     1.1.  Expected Updates to the Specification . . . . . . . . . .   5
61	     1.2.  Design Criteria for the Changes in v3 . . . . . . . . . .   5
62	     1.3.  Differences from RFC 7991 in This Document  . . . . . . .   6
63	     1.4.  Differences from v2 to v3 . . . . . . . . . . . . . . . .   6
64	       1.4.1.  New Elements in v3  . . . . . . . . . . . . . . . . .   6
65	       1.4.2.  New Attributes for Existing Elements  . . . . . . . .   7
66	       1.4.3.  Elements and Attributes Deprecated from v2  . . . . .   8
67	       1.4.4.  Additional Changes from v2  . . . . . . . . . . . . .   9
68	     1.5.  Syntax Notation . . . . . . . . . . . . . . . . . . . . .  10
69	   2.  Elements  . . . . . . . . . . . . . . . . . . . . . . . . . .  10
70	     2.1.  <abstract>  . . . . . . . . . . . . . . . . . . . . . . .  11
71	     2.2.  <address> . . . . . . . . . . . . . . . . . . . . . . . .  11
72	     2.3.  <annotation>  . . . . . . . . . . . . . . . . . . . . . .  12
73	     2.4.  <area>  . . . . . . . . . . . . . . . . . . . . . . . . .  13
74	     2.5.  <artwork> . . . . . . . . . . . . . . . . . . . . . . . .  13
75	     2.6.  <aside> . . . . . . . . . . . . . . . . . . . . . . . . .  16
76	     2.7.  <author>  . . . . . . . . . . . . . . . . . . . . . . . .  17
77	     2.8.  <back>  . . . . . . . . . . . . . . . . . . . . . . . . .  19
78	     2.9.  <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . .  19
79	     2.10. <blockquote>  . . . . . . . . . . . . . . . . . . . . . .  19
80	     2.11. <boilerplate> . . . . . . . . . . . . . . . . . . . . . .  21
81	     2.12. <br>  . . . . . . . . . . . . . . . . . . . . . . . . . .  21
82	     2.13. <city>  . . . . . . . . . . . . . . . . . . . . . . . . .  22
83	     2.14. <code>  . . . . . . . . . . . . . . . . . . . . . . . . .  22
84	     2.15. <country> . . . . . . . . . . . . . . . . . . . . . . . .  22
85	     2.16. <cref>  . . . . . . . . . . . . . . . . . . . . . . . . .  22
86	     2.17. <date>  . . . . . . . . . . . . . . . . . . . . . . . . .  24
87	     2.18. <dd>  . . . . . . . . . . . . . . . . . . . . . . . . . .  25
88	     2.19. <displayreference>  . . . . . . . . . . . . . . . . . . .  26
89	     2.20. <dl>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
90	     2.21. <dt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  28
91	     2.22. <em>  . . . . . . . . . . . . . . . . . . . . . . . . . .  29
92	     2.23. <email> . . . . . . . . . . . . . . . . . . . . . . . . .  30
93	     2.24. <eref>  . . . . . . . . . . . . . . . . . . . . . . . . .  30
94	     2.25. <figure>  . . . . . . . . . . . . . . . . . . . . . . . .  31
95	     2.26. <front> . . . . . . . . . . . . . . . . . . . . . . . . .  33
96	     2.27. <iref>  . . . . . . . . . . . . . . . . . . . . . . . . .  34
97	     2.28. <keyword> . . . . . . . . . . . . . . . . . . . . . . . .  35
98	     2.29. <li>  . . . . . . . . . . . . . . . . . . . . . . . . . .  35
99	     2.30. <link>  . . . . . . . . . . . . . . . . . . . . . . . . .  36
100	     2.31. <middle>  . . . . . . . . . . . . . . . . . . . . . . . .  37
101	     2.32. <name>  . . . . . . . . . . . . . . . . . . . . . . . . .  37
102	     2.33. <note>  . . . . . . . . . . . . . . . . . . . . . . . . .  38
103	     2.34. <ol>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
104	     2.35. <organization>  . . . . . . . . . . . . . . . . . . . . .  41
105	     2.36. <phone> . . . . . . . . . . . . . . . . . . . . . . . . .  41
106	     2.37. <postal>  . . . . . . . . . . . . . . . . . . . . . . . .  42
107	     2.38. <postalLine>  . . . . . . . . . . . . . . . . . . . . . .  42
108	     2.39. <refcontent>  . . . . . . . . . . . . . . . . . . . . . .  43
109	     2.40. <reference> . . . . . . . . . . . . . . . . . . . . . . .  43
110	     2.41. <referencegroup>  . . . . . . . . . . . . . . . . . . . .  44
111	     2.42. <references>  . . . . . . . . . . . . . . . . . . . . . .  45
112	     2.43. <region>  . . . . . . . . . . . . . . . . . . . . . . . .  46
113	     2.44. <relref>  . . . . . . . . . . . . . . . . . . . . . . . .  46
114	     2.45. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . .  49
115	     2.46. <section> . . . . . . . . . . . . . . . . . . . . . . . .  53
116	     2.47. <seriesInfo>  . . . . . . . . . . . . . . . . . . . . . .  55
117	     2.48. <sourcecode>  . . . . . . . . . . . . . . . . . . . . . .  57
118	     2.49. <street>  . . . . . . . . . . . . . . . . . . . . . . . .  59
119	     2.50. <strong>  . . . . . . . . . . . . . . . . . . . . . . . .  59
120	     2.51. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . .  60
121	     2.52. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . .  61
122	     2.53. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . .  62
123	     2.54. <table> . . . . . . . . . . . . . . . . . . . . . . . . .  64
124	     2.55. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . .  64
125	     2.56. <td>  . . . . . . . . . . . . . . . . . . . . . . . . . .  65
126	     2.57. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . .  67
127	     2.58. <th>  . . . . . . . . . . . . . . . . . . . . . . . . . .  67
128	     2.59. <thead> . . . . . . . . . . . . . . . . . . . . . . . . .  69
129	     2.60. <title> . . . . . . . . . . . . . . . . . . . . . . . . .  69
130	     2.61. <tr>  . . . . . . . . . . . . . . . . . . . . . . . . . .  70
131	     2.62. <tt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  70
132	     2.63. <ul>  . . . . . . . . . . . . . . . . . . . . . . . . . .  71
133	     2.64. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . .  72
134	     2.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . .  72
135	     2.66. <xref>  . . . . . . . . . . . . . . . . . . . . . . . . .  72
136	   3.  Elements from v2 That Have Been Deprecated  . . . . . . . . .  75
137	     3.1.  <c> . . . . . . . . . . . . . . . . . . . . . . . . . . .  75
138	     3.2.  <facsimile> . . . . . . . . . . . . . . . . . . . . . . .  76
139	     3.3.  <format>  . . . . . . . . . . . . . . . . . . . . . . . .  76
140	     3.4.  <list>  . . . . . . . . . . . . . . . . . . . . . . . . .  76
141	     3.5.  <postamble> . . . . . . . . . . . . . . . . . . . . . . .  77
142	     3.6.  <preamble>  . . . . . . . . . . . . . . . . . . . . . . .  78
143	     3.7.  <spanx> . . . . . . . . . . . . . . . . . . . . . . . . .  78
144	     3.8.  <texttable> . . . . . . . . . . . . . . . . . . . . . . .  79
145	     3.9.  <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . .  80
146	     3.10. <vspace>  . . . . . . . . . . . . . . . . . . . . . . . .  81
147	   4.  SVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  81
148	   5.  Use of CDATA Structures and Escaping  . . . . . . . . . . . .  81
149	   6.  Internationalization Considerations . . . . . . . . . . . . .  82
150	   7.  Security Considerations . . . . . . . . . . . . . . . . . . .  82
151	   8.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  83
152	     8.1.  Internet Media Type Registration  . . . . . . . . . . . .  83
153	     8.2.  Link Relation Registration  . . . . . . . . . . . . . . .  84
154	   9.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  85
155	     9.1.  Normative References  . . . . . . . . . . . . . . . . . .  85
156	     9.2.  Informative References  . . . . . . . . . . . . . . . . .  85
157	   Appendix A.  Front-Page ("Boilerplate") Generation  . . . . . . .  89
158	     A.1.  The "ipr" Attribute . . . . . . . . . . . . . . . . . . .  89
159	       A.1.1.  Current Values: "*trust200902"  . . . . . . . . . . .  89
160	       A.1.2.  Historic Values . . . . . . . . . . . . . . . . . . .  91
161	     A.2.  The "submissionType" Attribute  . . . . . . . . . . . . .  92
162	     A.3.  The "consensus" Attribute . . . . . . . . . . . . . . . .  92
163	   Appendix B.  The v3 Format and Processing Tools . . . . . . . . .  93
164	     B.1.  Including External Text with XInclude . . . . . . . . . .  94
165	     B.2.  Anchors and IDs . . . . . . . . . . . . . . . . . . . . .  95
166	       B.2.1.  Overlapping Values  . . . . . . . . . . . . . . . . .  96
167	     B.3.  Attributes Controlled by the Prep Tool  . . . . . . . . .  97
168	   Appendix C.  RELAX NG Schema  . . . . . . . . . . . . . . . . . .  98
169	   Appendix D.  Schema Differences from v2 . . . . . . . . . . . . . 118
170	   Appendix E.  IAB Members at the Time of Approval  . . . . . . . . 138
171	   Appendix F.  Acknowledgments  . . . . . . . . . . . . . . . . . . 138
172	   Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

174	1.  Introduction

176	   This document describes version 3 ("v3") of the "xml2rfc" vocabulary:
177	   an XML-based language ("Extensible Markup Language" [XML]) used for
178	   writing RFCs [RFC7322] and Internet-Drafts [IDGUIDE].

180	   This document obsoletes [RFC7991], [RFC7991] obsoleted the version 2
181	   vocabulary ("v2") [RFC7749], which contains the extended language
182	   definition.  [RFC7749] obsolted the original version ("v1")
183	   [RFC2629].  This document directly copies the material from [RFC7749]
184	   where possible.

186	   The v3 format will be used as part of the new RFC Series format
187	   described in [RFC6949].  The new format will be handled by one or
188	   more new tools for preparing the XML and converting it to other
189	   representations.  Features of the expected tools are described in
190	   Appendix B.  That section defines some terms used throughout this
191	   document, such as "prep tool" and "formatter".

193	   Note that the vocabulary contains certain constructs that might not
194	   be used when generating the final text; however, they can provide
195	   useful data for other uses (such as index generation, populating a
196	   keyword database, or syntax checks).

198	   In this document, the term "format" is used when describing types of
199	   documents, primarily XML and HTML.  The term "representation" is used
200	   when talking about a specific instantiation of a format, such as an
201	   XML document or an HTML document that was created by an XML document.

203	1.1.  Expected Updates to the Specification

205	   Non-interoperable changes in later versions of this specification are
206	   likely based on experience gained in implementing the new publication
207	   toolsets.  Revised documents will be published capturing those
208	   changes as the toolsets are completed.  Other implementers must not
209	   expect those changes to remain backwards-compatible with the details
210	   described in this document.

212	1.2.  Design Criteria for the Changes in v3

214	   The design criteria of the changes from v2 to v3 are as follows:

216	   o  The intention is that starting and editing a v3 document will be
217	      easier than for a v2 document.

219	   o  There will be good v2-to-v3 conversion tools for when an author
220	      wants to change versions.

222	   o  There are no current plans to make v3 XML the required submission
223	      format for drafts or RFCs.  That might happen eventually, but it
224	      is likely to be years away.

226	   There is a desire to keep as much of the v2 grammar as makes sense
227	   within the above design criteria and not to make gratuitous changes
228	   to the v2 grammar.  Another way to say this is "we would rather
229	   encourage backwards compatibility but not be constrained by it."
230	   Still, the goal of starting and editing a v3 document being easier
231	   than for a v2 document is more important than backwards compatibility
232	   with v2, given the latter two design criteria.

234	   v3 is upwards compatible with v2, meaning that a v2 document is meant
235	   to be a valid v3 document as well.  However, some features of v2 are
236	   deprecated in v3 in favor of new elements.  Deprecated features are
237	   listed in Section 1.4.3 and are described in [RFC7749].

239	1.3.  Differences from RFC 7991 in This Document

241	   This is a (hopefully) complete list of all the technical changes
242	   between [RFC7991] and this document.

244	   o  Changed the text about what this draft obsoletes and updates.

246	   o  [[ More will be added here as the draft progresses. ]]

248	1.4.  Differences from v2 to v3

250	   This is a (hopefully) complete list of all the technical changes
251	   between [RFC7749] and this document.

253	1.4.1.  New Elements in v3

255	   o  Add <dl>, <ul>, and <ol> as new ways to make lists.  This is a
256	      significant change from v2 in that the child under these elements
257	      is <li>, not <t>. <li> has a model of either containing one or
258	      more <t> elements, or containing the flowing text normally found
259	      in <t>.  These lists are children of <section>s and other lists
260	      instead of <t>.

262	   o  Add <strong>, <em>, <tt>, <sub>, and <sup> for character
263	      formatting.

265	   o  Add <aside> for incidental text that will be indented when
266	      displayed.

268	   o  Add <sourcecode> to differentiate from <artwork>.

270	   o  Add <table>, <thead>, <tbody>, <tfoot>, <tr>, <td>, and <th> to
271	      give table functionality like that in HTML.

273	   o  Add <boilerplate> to hold the automatically generated boilerplate
274	      text.

276	   o  Add <blockquote> to indicate a quotation as in a paragraph-like
277	      format.

279	   o  Add <name> to sections, notes, figures, and texttables to allow
280	      character formatting (fixed-width font) in their titles and to
281	      allow references in the names.

283	   o  Add <postalLine>, free text that represents one line of the
284	      address.

286	   o  Add <displayreference> to allow display of more mnemonic anchor
287	      names for automatically included references.

289	   o  Add <refcontent> to allow better control of text in a reference.

291	   o  Add <referencegroup> to allow referencing multi-RFC documents such
292	      as STDs and BCPs.

294	   o  Add <relref> to allow referencing specific sections or anchors in
295	      references.

297	   o  Add <link> to point to a resource related to the RFC.

299	   o  Add <br> to allow line breaks (but not blank lines) in the
300	      generated output for table cells.

302	   o  Add <svg> to allow easy inclusion of SVG drawings in <artwork>.

304	1.4.2.  New Attributes for Existing Elements

306	   o  Add "sortRefs", "symRefs", "tocDepth", and "tocInclude" attributes
307	      to <rfc> to cover Processing Instructions (PIs) that were in v2
308	      that are still needed in the grammar.  Add "prepTime" to indicate
309	      the time that the XML went through a preparation step.  Add
310	      "version" to indicate the version of xml2rfc vocabulary used in
311	      the document.  Add "scripts" to indicate which scripts are needed
312	      to render the document.  Add "expiresDate" when an Internet-Draft
313	      expires.

315	   o  Add "ascii" attributes to <email>, <organization>, <street>,
316	      <city>, <region>, <country>, and <code>.  Also add
317	      "asciiFullname", "asciiInitials", and "asciiSurname" to <author>.

319	      This allows an author to specify their information in their native
320	      scripts as the primary entry and still allow the ASCII-equivalent
321	      values to appear in the processed documents.

323	   o  Add "anchor" attributes to many block elements to allow them to be
324	      linked with <relref> and <xref>.

326	   o  Add the "section", "relative", and "sectionFormat" attributes to
327	      <xref>.

329	   o  Add the "numbered" and "removeInRFC" attributes to <section>.

331	   o  Add the "removeInRFC" attribute to <note>.

333	   o  Add "pn" to <artwork>, <aside>, <blockquote>, <boilerplate>, <dt>,
334	      <figure>, <iref>, <li>, <references>, <section>, <sourcecode>,
335	      <t>, and <table> to hold automatically generated numbers for items
336	      in a section that don't have their own numbering (namely figures
337	      and tables).

339	   o  Add "display" to <cref> to indicate to tools whether or not to
340	      display the comment.

342	   o  Add "keepWithNext" and "keepWithPrevious" to <t> as a hint to
343	      tools that do pagination that they should try to keep the
344	      paragraph with the next/previous element.

346	1.4.3.  Elements and Attributes Deprecated from v2

348	   Deprecated elements and attributes are legacy vocabulary from v2 that
349	   are supported for input to v3 tools.  They are likely to be removed
350	   from those tools in the future.  Deprecated attributes are still
351	   listed in Section 2, and deprecated elements are listed in Section 3.
352	   See Appendix B for more information on tools and how they will handle
353	   deprecated features.

355	   o  Deprecate <list> in favor of <dl>, <ul>, and <ol>.

357	   o  Deprecate <spanx>; replace it with <strong>, <em>, and <tt>.

359	   o  Deprecate <vspace> because the major use for it, creating pseudo-
360	      paragraph-breaks in lists, is now handled properly.

362	   o  Deprecate <texttable>, <ttcol>, and <c>; replace them with the new
363	      table elements (<table> and the elements that can be contained
364	      within it).

366	   o  Deprecate <facsimile> because it is rarely used.

368	   o  Deprecate <format> because it is not useful and has caused
369	      surprise for authors in the past.  If the goal is to provide a
370	      single URI (Uniform Resource Identifier) for a reference, use the
371	      "target" attribute in <reference> instead.

373	   o  Deprecate <preamble> and <postamble> in favor of simply using <t>
374	      before or after the figure.  This also deprecates the "align"
375	      attribute in <figure>.

377	   o  Deprecate the "title" attribute in <section>, <note>, <figure>,
378	      <references>, and <texttable> in favor of the new <name>.

380	   o  Deprecate the "alt" and "src" attributes in <figure> because they
381	      overlap with the attributes in <artwork>.

383	   o  Deprecate the "xml:space" attribute in <artwork> because there was
384	      only one useful value.  Deprecate the "height" and "width"
385	      attributes in both <artwork> and <figure> because they are not
386	      needed for the new output formats.

388	   o  Deprecate the "pageno" attribute in <xref> because it was unused
389	      in v2.  Deprecate the "none" values for the "format" attribute in
390	      <xref> because it makes no sense semantically.

392	1.4.4.  Additional Changes from v2

394	   o  Allow non-ASCII characters in the format; the characters that are
395	      actually allowed will be determined by the RFC Series Editor.

397	   o  Allow <artwork> and <sourcecode> to be used on their own in
398	      <section> (no longer confine them to a figure).

400	   o  Give more specifics of handling the "type" attribute in <artwork>.

402	   o  Allow <strong>, <em>, <tt>, <eref>, and <xref> in <cref>.

404	   o  Allow the sub-elements inside a <reference> to be in any order.

406	   o  Turn off the autogeneration of anchors in <cref> because there is
407	      no use case for them that cannot be achieved in other ways.

409	   o  Allow more than one <artwork>, or more than one <sourcecode>, in
410	      <figure>.

412	   o  In <front>, make <date> optional.

414	   o  In <date>, add restrictions to the "date" and "year" attributes
415	      when used in the <front> for the document's boilerplate text.

417	   o  In <postal>, allow the sub-elements to be in any order.  Also
418	      allow the inclusion of the new <postalLine> instead of the older
419	      elements.

421	   o  In <section>, restrict the names of the anchors that can be used
422	      on some types of sections.

424	   o  Make <seriesInfo> a child of <front>, and deprecated it as a child
425	      of <reference>.  This also deprecates some of the attributes from
426	      <rfc> and moves them into <seriesInfo>.

428	   o  <t> now only contains non-block elements, so it no longer contains
429	      <figure> elements.

431	   o  Do not generate the grammar from a DTD, but instead get it
432	      directly from the RELAX Next Generation (RNG) grammar [RNG].

434	1.5.  Syntax Notation

436	   The XML vocabulary here is defined in prose, based on the RELAX NG
437	   schema [RNC] contained in Appendix C (specified in RELAX NG Compact
438	   Notation (RNC)).

440	   Note that the schema can be used for automated validity checks, but
441	   certain constraints are only described in prose (example: the
442	   conditionally required presence of the "abbrev" attribute).

444	2.  Elements

446	   The sections below describe all elements and their attributes.

448	   Note that attributes not labeled "mandatory" are optional.

450	   Many elements have an optional "anchor" attribute.  In all cases, the
451	   value of the "anchor" attribute needs to be a valid XML "Name"
452	   (Section 2.3 of [XML]), additionally constrained to US-ASCII
453	   characters [USASCII].  Thus, the character repertoire consists of
454	   "A-Z", "a-z", "0-9", "_", "-", ".", and ":", where "0-9", ".", and
455	   "-" are disallowed as start characters.  Anchors are described in
456	   more detail in Appendix B.2.

458	   Tools interpreting the XML described here will collapse horizontal
459	   whitespace and line breaks to a single whitespace (except inside
460	   <artwork> and <sourcecode>) and will trim leading and trailing
461	   whitespace.  Tab characters (U+0009) inside <artwork> and
462	   <sourcecode> are prohibited.

464	   Some of the elements have attributes that are not described in this
465	   section because those attributes are specific to the prep tool.
466	   People writing tools to process this format should read all of the
467	   appendices for a complete description of these attributes.

469	   Every element in the v3 vocabulary can have an "xml:lang" attribute,
470	   an "xml:base" attribute, or both.  The xml:lang attribute specifies
471	   the language used in the element.  This is sometimes useful for
472	   renderers that display different fonts for ideographic characters
473	   used in China and Japan.  The xml:base attribute is sometimes added
474	   to an XML file when doing XML-to-XML conversion where the base file
475	   has XInclude attributes (see Appendix B.1).

477	2.1.  <abstract>

479	   Contains the Abstract of the document.  See [RFC7322] for more
480	   information on restrictions for the Abstract.

482	   This element appears as a child element of <front> (Section 2.26).

484	   Content model:

486	   In any order, but at least one of:

488	   o  <dl> elements (Section 2.20)

490	   o  <ol> elements (Section 2.34)

492	   o  <t> elements (Section 2.53)

494	   o  <ul> elements (Section 2.63)

496	2.1.1.  "anchor" Attribute

498	   Document-wide unique identifier for the Abstract.

500	2.2.  <address>

502	   Provides address information for the author.

504	   This element appears as a child element of <author> (Section 2.7).

506	   Content model:

508	   In this order:

510	   1.  One optional <postal> element (Section 2.37)

512	   2.  One optional <phone> element (Section 2.36)

514	   3.  One optional <facsimile> element (Section 3.2)

516	   4.  One optional <email> element (Section 2.23)

518	   5.  One optional <uri> element (Section 2.64)

520	2.3.  <annotation>

522	   Provides additional prose augmenting a bibliographic reference.  This
523	   text is intended to be shown after the rest of the generated
524	   reference text.

526	   This element appears as a child element of <reference>
527	   (Section 2.40).

529	   Content model:

531	   In any order:

533	   o  Text

535	   o  <bcp14> elements (Section 2.9)

537	   o  <cref> elements (Section 2.16)

539	   o  <em> elements (Section 2.22)

541	   o  <eref> elements (Section 2.24)

543	   o  <iref> elements (Section 2.27)

545	   o  <relref> elements (Section 2.44)

547	   o  <spanx> elements (Section 3.7)

549	   o  <strong> elements (Section 2.50)

551	   o  <sub> elements (Section 2.51)

553	   o  <sup> elements (Section 2.52)

555	   o  <tt> elements (Section 2.62)
556	   o  <xref> elements (Section 2.66)

558	2.4.  <area>

560	   Provides information about the IETF area to which this document
561	   relates (currently not used when generating documents).

563	   The value ought to be either the full name or the abbreviation of one
564	   of the IETF areas as listed on <http://www.ietf.org/iesg/area.html>.
565	   A list of full names and abbreviations will be kept by the RFC Series
566	   Editor.

568	   This element appears as a child element of <front> (Section 2.26).

570	   Content model: only text content.

572	2.5.  <artwork>

574	   This element allows the inclusion of "artwork" in the document.
575	   <artwork> provides full control of horizontal whitespace and line
576	   breaks; thus, it is used for a variety of things, such as diagrams
577	   ("line art") and protocol unit diagrams.  Tab characters (U+0009)
578	   inside of this element are prohibited.

580	   Alternatively, the "src" attribute allows referencing an external
581	   graphics file, such as a vector drawing in SVG or a bitmap graphic
582	   file, using a URI.  In this case, the textual content acts as a
583	   fallback for output representations that do not support graphics;
584	   thus, it ought to contain either (1) a "line art" variant of the
585	   graphics or (2) prose that describes the included image in sufficient
586	   detail.

588	   In [RFC7749], the <artwork> element was also used for source code and
589	   formal languages; in v3, this is now done with <sourcecode>.

591	   There are at least five ways to include SVG in artwork in Internet-
592	   Drafts:

594	   o  Inline, by including all of the SVG in the content of the element,
595	      such as: <artwork type="svg"><svg
596	      xmlns="http://www.w3.org/2000/svg...">

598	   o  Inline, but using XInclude (see Appendix B.1), such as: <artwork
599	      type="svg"><xi:include href=...>

601	   o  As a data: URI, such as: <artwork type="svg" src="data:image/
602	      svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3...">

604	   o  As a URI to an external entity, such as: <artwork type="svg"
605	      src="http://www.example.com/...">

607	   o  As a local file, such as: <artwork type="svg" src="diagram12.svg">

609	   The use of SVG in Internet-Drafts and RFCs is covered in much more
610	   detail in [RFC7996].

612	   The above methods for inclusion of SVG art can also be used for
613	   including text artwork, but using a data: URI is probably confusing
614	   for text artwork.

616	   Formatters that do pagination should attempt to keep artwork on a
617	   single page.  This is to prevent artwork that is split across pages
618	   from looking like two separate pieces of artwork.

620	   See Section 5 for a description of how to deal with issues of using
621	   "&" and "<" characters in artwork.

623	   This element appears as a child element of <aside> (Section 2.6),
624	   <blockquote> (Section 2.10), <dd> (Section 2.18), <figure>
625	   (Section 2.25), <li> (Section 2.29), <section> (Section 2.46), <td>
626	   (Section 2.56), and <th> (Section 2.58).

628	   Content model:

630	   Either:

632	      Text

634	   Or:

636	      <svg> elements (Section 4)

638	2.5.1.  "align" Attribute

640	   Controls whether the artwork appears left justified (default),
641	   centered, or right justified.  Artwork is aligned relative to the
642	   left margin of the document.

644	   Allowed values:

646	   o  "left" (default)

648	   o  "center"

650	   o  "right"

652	2.5.2.  "alt" Attribute

654	   Alternative text description of the artwork (which is more than just
655	   a summary or caption).  When the art comes from the "src" attribute
656	   and the format of that artwork supports alternate text, the
657	   alternative text comes from the text of the artwork itself, not from
658	   this attribute.  The contents of this attribute are important to
659	   readers who are visually impaired, as well as those reading on
660	   devices that cannot show the artwork well, or at all.

662	2.5.3.  "anchor" Attribute

664	   Document-wide unique identifier for this artwork.

666	2.5.4.  "height" Attribute

668	   Deprecated.

670	2.5.5.  "name" Attribute

672	   A filename suitable for the contents (such as for extraction to a
673	   local file).  This attribute can be helpful for other kinds of tools
674	   (such as automated syntax checkers, which work by extracting the
675	   artwork).  Note that the "name" attribute does not need to be unique
676	   for <artwork> elements in a document.  If multiple <artwork> elements
677	   have the same "name" attribute, a processing tool might assume that
678	   the elements are all fragments of a single file, and the tool can
679	   collect those fragments for later processing.  See Section 7 for a
680	   discussion of possible problems with the value of this attribute.

682	2.5.6.  "src" Attribute

684	   The URI reference of a graphics file [RFC3986], or the name of a file
685	   on the local disk.  This can be a "data" URI [RFC2397] that contains
686	   the contents of the graphics file.  Note that the inclusion of art
687	   with the "src" attribute depends on the capabilities of the
688	   processing tool reading the XML document.  Tools need to be able to
689	   handle the file: URI, and they should be able to handle http: and
690	   https: URIs as well.  The prep tool will be able to handle reading
691	   the "src" attribute.

693	   If no URI scheme is given in the attribute, the attribute is
694	   considered to be a local filename relative to the current directory.
695	   Processing tools must be careful to not accept dangerous values for
696	   the filename, particularly those that contain absolute references
697	   outside the current directory.  Document creators should think hard
698	   before using relative URIs due to possible later problems if files
699	   move around on the disk.  Also, documents should most likely use
700	   explicit URI schemes wherever possible.

702	   In some cases, the prep tool may remove the "src" attribute after
703	   processing its value.  See [RFC7998] for a description of this.

705	   It is an error to have both a "src" attribute and content in the
706	   <artwork> element.

708	2.5.7.  "type" Attribute

710	   Specifies the type of the artwork.  The value of this attribute is
711	   free text with certain values designated as preferred.

713	   The preferred values for <artwork> types are:

715	   o  ascii-art

717	   o  binary-art

719	   o  call-flow

721	   o  hex-dump

723	   o  svg

725	   The RFC Series Editor will maintain a complete list of the preferred
726	   values on the RFC Editor web site, and that list is expected to be
727	   updated over time.  Thus, a consumer of v3 XML should not cause a
728	   failure when it encounters an unexpected type or no type is
729	   specified.  The table will also indicate which type of art can appear
730	   in plain-text output (for example, type="svg" cannot).

732	2.5.8.  "width" Attribute

734	   Deprecated.

736	2.5.9.  "xml:space" Attribute

738	   Deprecated.

740	2.6.  <aside>

742	   This element is a container for content that is semantically less
743	   important or tangential to the content that surrounds it.

745	   This element appears as a child element of <section> (Section 2.46).

747	   Content model:

749	   In any order:

751	   o  <artwork> elements (Section 2.5)

753	   o  <dl> elements (Section 2.20)

755	   o  <figure> elements (Section 2.25)

757	   o  <iref> elements (Section 2.27)

759	   o  <list> elements (Section 3.4)

761	   o  <ol> elements (Section 2.34)

763	   o  <t> elements (Section 2.53)

765	   o  <table> elements (Section 2.54)

767	   o  <ul> elements (Section 2.63)

769	2.6.1.  "anchor" Attribute

771	   Document-wide unique identifier for this aside.

773	2.7.  <author>

775	   Provides information about a document's author.  This is used both
776	   for the document itself (at the beginning of the document) and for
777	   referenced documents.

779	   The <author> elements contained within the document's <front> element
780	   are used to fill the boilerplate and also to generate the "Author's
781	   Address" section (see [RFC7322]).

783	   Note that an "author" can also be just an organization (by not
784	   specifying any of the "name" attributes, but adding the
785	   <organization> child element).

787	   Furthermore, the "role" attribute can be used to mark an author as
788	   "editor".  This is reflected both on the front page and in the
789	   "Author's Address" section, as well as in bibliographic references.
790	   Note that this specification does not define a precise meaning for
791	   the term "editor".

793	   This element appears as a child element of <front> (Section 2.26).

795	   Content model:

797	   In this order:

799	   1.  One optional <organization> element (Section 2.35)

801	   2.  One optional <address> element (Section 2.2)

803	2.7.1.  "asciiFullname" Attribute

805	   The ASCII equivalent of the author's full name.

807	2.7.2.  "asciiInitials" Attribute

809	   The ASCII equivalent of the author's initials, to be used in
810	   conjunction with the separately specified asciiSurname.

812	2.7.3.  "asciiSurname" Attribute

814	   The ASCII equivalent of the author's surname, to be used in
815	   conjunction with the separately specified asciiInitials.

817	2.7.4.  "fullname" Attribute

819	   The full name (used in the automatically generated "Author's Address"
820	   section).  Although this attribute is optional, if one or more of the
821	   "asciiFullname", "asciiInitials", or "asciiSurname" attributes have
822	   values, the "fullname" attribute is required.

824	2.7.5.  "initials" Attribute

826	   An abbreviated variant of the given name(s), to be used in
827	   conjunction with the separately specified surname.  It usually
828	   appears on the front page, in footers, and in references.

830	   Some processors will post-process the value -- for instance, when it
831	   only contains a single letter (in which case they might add a
832	   trailing dot).  Relying on this kind of post-processing can lead to
833	   results varying across formatters and thus ought to be avoided.

835	2.7.6.  "role" Attribute

837	   Specifies the role the author had in creating the document.

839	   Allowed values:

841	   o  "editor"

843	2.7.7.  "surname" Attribute

845	   The author's surname, to be used in conjunction with the separately
846	   specified initials.  It usually appears on the front page, in
847	   footers, and in references.

849	2.8.  <back>

851	   Contains the "back" part of the document: the references and
852	   appendices.  In <back>, <section> elements indicate appendices.

854	   This element appears as a child element of <rfc> (Section 2.45).

856	   Content model:

858	   In this order:

860	   1.  Optional <displayreference> elements (Section 2.19)

862	   2.  Optional <references> elements (Section 2.42)

864	   3.  Optional <section> elements (Section 2.46)

866	2.9.  <bcp14>

868	   Marks text that are phrases defined in [BCP14] such as "MUST",
869	   "SHOULD NOT", and so on.  When shown in some of the output
870	   representations, the text in this element might be highlighted.  The
871	   use of this element is optional.

873	   This element is only to be used around the actual phrase from BCP 14,
874	   not the full definition of a requirement.  For example, it is correct
875	   to say "The packet <bcp14>MUST</bcp14> be dropped.", but it is not
876	   correct to say "<bcp14>The packet MUST be dropped.</bcp14>".

878	   This element appears as a child element of <annotation>
879	   (Section 2.3), <blockquote> (Section 2.10), <dd> (Section 2.18), <dt>
880	   (Section 2.21), <em> (Section 2.22), <li> (Section 2.29), <preamble>
881	   (Section 3.6), <refcontent> (Section 2.39), <strong> (Section 2.50),
882	   <sub> (Section 2.51), <sup> (Section 2.52), <t> (Section 2.53), <td>
883	   (Section 2.56), <th> (Section 2.58), and <tt> (Section 2.62).

885	   Content model: only text content.

887	2.10.  <blockquote>

889	   Specifies that a block of text is a quotation.

891	   This element appears as a child element of <section> (Section 2.46).

893	   Content model:

895	   Either:

897	      In any order, but at least one of:

899	      *  <artwork> elements (Section 2.5)

901	      *  <dl> elements (Section 2.20)

903	      *  <figure> elements (Section 2.25)

905	      *  <ol> elements (Section 2.34)

907	      *  <sourcecode> elements (Section 2.48)

909	      *  <t> elements (Section 2.53)

911	      *  <ul> elements (Section 2.63)

913	   Or:

915	      In any order, but at least one of:

917	      *  Text

919	      *  <bcp14> elements (Section 2.9)

921	      *  <cref> elements (Section 2.16)

923	      *  <em> elements (Section 2.22)

925	      *  <eref> elements (Section 2.24)

927	      *  <iref> elements (Section 2.27)

929	      *  <relref> elements (Section 2.44)

931	      *  <strong> elements (Section 2.50)

933	      *  <sub> elements (Section 2.51)
934	      *  <sup> elements (Section 2.52)

936	      *  <tt> elements (Section 2.62)

938	      *  <xref> elements (Section 2.66)

940	2.10.1.  "anchor" Attribute

942	   Document-wide unique identifier for this quotation.

944	2.10.2.  "cite" Attribute

946	   The source of the citation.  This must be a URI.  If the "quotedFrom"
947	   attribute is given, this URI will be used by processing tools as the
948	   link for the text of that attribute.

950	2.10.3.  "quotedFrom" Attribute

952	   Name of person or document the text in this element is quoted from.
953	   A formatter should render this as visible text at the end of the
954	   quotation.

956	2.11.  <boilerplate>

958	   Holds the boilerplate text for the document.  This element is filled
959	   in by the prep tool.

961	   This element contains <section> elements.  Every <section> element in
962	   this element must have the "numbered" attribute set to "false".

964	   This element appears as a child element of <front> (Section 2.26).

966	   Content model:

968	   One or more <section> elements (Section 2.46)

970	2.12.  <br>

972	   Indicates that a line break should be inserted in the generated
973	   output by a formatting tool.  Multiple successive instances of this
974	   element are ignored.

976	   This element appears as a child element of <td> (Section 2.56) and
977	   <th> (Section 2.58).

979	   Content model: this element does not have any contents.

981	2.13.  <city>

983	   Gives the city name in a postal address.

985	   This element appears as a child element of <postal> (Section 2.37).

987	   Content model: only text content.

989	2.13.1.  "ascii" Attribute

991	   The ASCII equivalent of the city name.

993	2.14.  <code>

995	   Gives the postal region code.

997	   This element appears as a child element of <postal> (Section 2.37).

999	   Content model: only text content.

1001	2.14.1.  "ascii" Attribute

1003	   The ASCII equivalent of the postal code.

1005	2.15.  <country>

1007	   Gives the country name or code in a postal address.

1009	   This element appears as a child element of <postal> (Section 2.37).

1011	   Content model: only text content.

1013	2.15.1.  "ascii" Attribute

1015	   The ASCII equivalent of the country name.

1017	2.16.  <cref>

1019	   Represents a comment.

1021	   Comments can be used in a document while it is work in progress.
1022	   They might appear either inline and visually highlighted, at the end
1023	   of the document, or not at all, depending on the formatting tool.

1025	   This element appears as a child element of <annotation>
1026	   (Section 2.3), <blockquote> (Section 2.10), <c> (Section 3.1), <dd>
1027	   (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
1028	   (Section 2.29), <name> (Section 2.32), <postamble> (Section 3.5),
1029	   <preamble> (Section 3.6), <strong> (Section 2.50), <sub>
1030	   (Section 2.51), <sup> (Section 2.52), <t> (Section 2.53), <td>
1031	   (Section 2.56), <th> (Section 2.58), <tt> (Section 2.62), and <ttcol>
1032	   (Section 3.9).

1034	   Content model:

1036	   In any order:

1038	   o  Text

1040	   o  <em> elements (Section 2.22)

1042	   o  <eref> elements (Section 2.24)

1044	   o  <relref> elements (Section 2.44)

1046	   o  <strong> elements (Section 2.50)

1048	   o  <sub> elements (Section 2.51)

1050	   o  <sup> elements (Section 2.52)

1052	   o  <tt> elements (Section 2.62)

1054	   o  <xref> elements (Section 2.66)

1056	2.16.1.  "anchor" Attribute

1058	   Document-wide unique identifier for this comment.

1060	2.16.2.  "display" Attribute

1062	   Suggests whether or not the comment should be displayed by formatting
1063	   tools.  This might be set to "false" if you want to keep a comment in
1064	   a document after the contents of the comment have already been dealt
1065	   with.

1067	   Allowed values:

1069	   o  "true" (default)

1071	   o  "false"

1073	2.16.3.  "source" Attribute

1075	   Holds the "source" of a comment, such as the name or the initials of
1076	   the person who made the comment.

1078	2.17.  <date>

1080	   Provides information about the publication date.  This element is
1081	   used for two cases: the boilerplate of the document being produced,
1082	   and inside bibliographic references that use the <front> element.

1084	   Boilerplate for Internet-Drafts and RFCs:  This element defines the
1085	      date of publication for the current document (Internet-Draft or
1086	      RFC).  When producing Internet-Drafts, the prep tool uses this
1087	      date to compute the expiration date (see [IDGUIDE]).  When one or
1088	      more of "year", "month", or "day" are left out, the prep tool will
1089	      attempt to use the current system date if the attributes that are
1090	      present are consistent with that date.

1092	      In dates in <rfc> elements, the month must be a number or a month
1093	      in English.  The prep tool will silently change text month names
1094	      to numbers.  Similarly, the year must be a four-digit number.

1096	      When the prep tool is used to create Internet-Drafts, it will
1097	      reject a submitted Internet-Draft that has a <date> element in the
1098	      boilerplate for itself that is anything other than today.  That
1099	      is, the tool will not allow a submitter to specify a date other
1100	      than the day of submission.  To avoid this problem, authors might
1101	      simply not include a <date> element in the boilerplate.

1103	   Bibliographic references:  In dates in <reference> elements, the date
1104	      information can have prose text for the month or year.  For
1105	      example, vague dates (year="ca. 2000"), date ranges (year="2012-
1106	      2013"), non-specific months (month="Second quarter"), and so on
1107	      are allowed.

1109	   This element appears as a child element of <front> (Section 2.26).

1111	   Content model: this element does not have any contents.

1113	2.17.1.  "day" Attribute

1115	   The day of publication.

1117	2.17.2.  "month" Attribute

1119	   The month or months of publication.

1121	2.17.3.  "year" Attribute

1123	   The year or years of publication.

1125	2.18.  <dd>

1127	   The definition part of an entry in a definition list.

1129	   This element appears as a child element of <dl> (Section 2.20).

1131	   Content model:

1133	   Either:

1135	      In any order, but at least one of:

1137	      *  <artwork> elements (Section 2.5)

1139	      *  <dl> elements (Section 2.20)

1141	      *  <figure> elements (Section 2.25)

1143	      *  <ol> elements (Section 2.34)

1145	      *  <sourcecode> elements (Section 2.48)

1147	      *  <t> elements (Section 2.53)

1149	      *  <ul> elements (Section 2.63)

1151	   Or:

1153	      In any order, but at least one of:

1155	      *  Text

1157	      *  <bcp14> elements (Section 2.9)

1159	      *  <cref> elements (Section 2.16)

1161	      *  <em> elements (Section 2.22)

1163	      *  <eref> elements (Section 2.24)
1164	      *  <iref> elements (Section 2.27)

1166	      *  <relref> elements (Section 2.44)

1168	      *  <strong> elements (Section 2.50)

1170	      *  <sub> elements (Section 2.51)

1172	      *  <sup> elements (Section 2.52)

1174	      *  <tt> elements (Section 2.62)

1176	      *  <xref> elements (Section 2.66)

1178	2.18.1.  "anchor" Attribute

1180	   Document-wide unique identifier for this definition.

1182	2.19.  <displayreference>

1184	   This element gives a mapping between the anchor of a reference and a
1185	   name that will be displayed instead.  This allows authors to display
1186	   more mnemonic anchor names for automatically included references.
1187	   The mapping in this element only applies to <xref> elements whose
1188	   format is "default".  For example, if the reference uses the anchor
1189	   "RFC6949", the following would cause that anchor in the body of
1190	   displayed documents to be "RFC-dev":

1192	   <displayreference target="RFC6949" to="RFC-dev"/>

1194	   If a reference section is sorted, this element changes the sort
1195	   order.

1197	   It is expected that this element will only be valid in input
1198	   documents.  It will likely be removed by prep tools when preparing a
1199	   final version after those tools have replaced all of the associated
1200	   anchors, targets, and "derivedContent" attributes.

1202	   This element appears as a child element of <back> (Section 2.8).

1204	   Content model: this element does not have any contents.

1206	2.19.1.  "target" Attribute (Mandatory)

1208	   This attribute must be the name of an anchor in a <reference> or
1209	   <referencegroup> element.

1211	2.19.2.  "to" Attribute (Mandatory)

1213	   This attribute is a name that will be displayed as the anchor instead
1214	   of the anchor that is given in the <reference> element.  The string
1215	   given must start with one of the following characters: 0-9, a-z, or
1216	   A-Z.  The other characters in the string must be 0-9, a-z, A-Z, "-",
1217	   ".", or "_".

1219	2.20.  <dl>

1221	   A definition list.  Each entry has a pair of elements: a term (<dt>)
1222	   and a definition (<dd>).  (This is slightly different and simpler
1223	   than the model used in HTML, which allows for multiple terms for a
1224	   single definition.)

1226	   This element appears as a child element of <abstract> (Section 2.1),
1227	   <aside> (Section 2.6), <blockquote> (Section 2.10), <dd>
1228	   (Section 2.18), <li> (Section 2.29), <note> (Section 2.33), <section>
1229	   (Section 2.46), <td> (Section 2.56), and <th> (Section 2.58).

1231	   Content model:

1233	   One or more sequences of:

1235	   1.  One <dt> element

1237	   2.  One <dd> element

1239	2.20.1.  "anchor" Attribute

1241	   Document-wide unique identifier for the list.

1243	2.20.2.  "hanging" Attribute

1245	   The "hanging" attribute defines whether or not the term appears on
1246	   the same line as the definition. hanging="true" indicates that the
1247	   term is to the left of the definition, while hanging="false"
1248	   indicates that the term will be on a separate line.

1250	   Allowed values:

1252	   o  "false"

1254	   o  "true" (default)

1256	2.20.3.  "spacing" Attribute

1258	   Defines whether or not there is a blank line between entries.
1259	   spacing="normal" indicates a single blank line, while
1260	   spacing="compact" indicates no space between.

1262	   Allowed values:

1264	   o  "normal" (default)

1266	   o  "compact"

1268	2.21.  <dt>

1270	   The term being defined in a definition list.

1272	   This element appears as a child element of <dl> (Section 2.20).

1274	   Content model:

1276	   In any order:

1278	   o  Text

1280	   o  <bcp14> elements (Section 2.9)

1282	   o  <cref> elements (Section 2.16)

1284	   o  <em> elements (Section 2.22)

1286	   o  <eref> elements (Section 2.24)

1288	   o  <iref> elements (Section 2.27)

1290	   o  <relref> elements (Section 2.44)

1292	   o  <strong> elements (Section 2.50)

1294	   o  <sub> elements (Section 2.51)

1296	   o  <sup> elements (Section 2.52)

1298	   o  <tt> elements (Section 2.62)

1300	   o  <xref> elements (Section 2.66)

1302	2.21.1.  "anchor" Attribute

1304	   Document-wide unique identifier for this term.

1306	2.22.  <em>

1308	   Indicates text that is semantically emphasized.  Text enclosed within
1309	   this element will be displayed as italic after processing.  This
1310	   element can be combined with other character formatting elements, and
1311	   the formatting will be additive.

1313	   This element appears as a child element of <annotation>
1314	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
1315	   <dd> (Section 2.18), <dt> (Section 2.21), <li> (Section 2.29),
1316	   <preamble> (Section 3.6), <refcontent> (Section 2.39), <strong>
1317	   (Section 2.50), <sub> (Section 2.51), <sup> (Section 2.52), <t>
1318	   (Section 2.53), <td> (Section 2.56), <th> (Section 2.58), and <tt>
1319	   (Section 2.62).

1321	   Content model:

1323	   In any order:

1325	   o  Text

1327	   o  <bcp14> elements (Section 2.9)

1329	   o  <cref> elements (Section 2.16)

1331	   o  <eref> elements (Section 2.24)

1333	   o  <iref> elements (Section 2.27)

1335	   o  <relref> elements (Section 2.44)

1337	   o  <strong> elements (Section 2.50)

1339	   o  <sub> elements (Section 2.51)

1341	   o  <sup> elements (Section 2.52)

1343	   o  <tt> elements (Section 2.62)

1345	   o  <xref> elements (Section 2.66)

1347	2.23.  <email>

1349	   Provides an email address.

1351	   The value is expected to be the addr-spec defined in Section 2 of
1352	   [RFC6068].

1354	   This element appears as a child element of <address> (Section 2.2).

1356	   Content model: only text content.

1358	2.23.1.  "ascii" Attribute

1360	   The ASCII equivalent of the author's email address.  This is only
1361	   used if the email address has any internationalized components.

1363	2.24.  <eref>

1365	   Represents an "external" link (as specified in the "target"
1366	   attribute).  This is useful for embedding URIs in the body of a
1367	   document.

1369	   If the <eref> element has non-empty text content, formatters should
1370	   use the content as the displayed text that is linked.  Otherwise, the
1371	   formatter should use the value of the "target" attribute as the
1372	   displayed text.  Formatters will link the displayed text to the value
1373	   of the "target" attribute in a manner appropriate for the output
1374	   format.

1376	   For example, with an input of:

1378	         This is described at
1379	         <eref target="http://www.example.com/reports/r12.html"/>.

1381	   An HTML formatter might generate:

1383	         This is described at
1384	         <a href="http://www.example.com/reports/r12.html">
1385	         http://www.example.com/reports/r12.html</a>.

1387	   With an input of:

1389	         This is described
1390	         <eref target="http://www.example.com/reports/r12.html">
1391	         in this interesting report</eref>.

1393	   An HTML formatter might generate:

1395	         This is described
1396	         <a href="http://www.example.com/reports/r12.html">
1397	         in this interesting report</a>.

1399	   This element appears as a child element of <annotation>
1400	   (Section 2.3), <blockquote> (Section 2.10), <c> (Section 3.1), <cref>
1401	   (Section 2.16), <dd> (Section 2.18), <dt> (Section 2.21), <em>
1402	   (Section 2.22), <li> (Section 2.29), <name> (Section 2.32),
1403	   <postamble> (Section 3.5), <preamble> (Section 3.6), <strong>
1404	   (Section 2.50), <sub> (Section 2.51), <sup> (Section 2.52), <t>
1405	   (Section 2.53), <td> (Section 2.56), <th> (Section 2.58), <tt>
1406	   (Section 2.62), and <ttcol> (Section 3.9).

1408	   Content model: only text content.

1410	2.24.1.  "target" Attribute (Mandatory)

1412	   URI of the link target [RFC3986].  This must begin with a scheme name
1413	   (such as "https://") and thus not be relative to the URL of the
1414	   current document.

1416	2.25.  <figure>

1418	   Contains a figure with a caption with the figure number.  If the
1419	   element contains a <name> element, the caption will also show that
1420	   name.

1422	   This element appears as a child element of <aside> (Section 2.6),
1423	   <blockquote> (Section 2.10), <dd> (Section 2.18), <li>
1424	   (Section 2.29), <section> (Section 2.46), <td> (Section 2.56), and
1425	   <th> (Section 2.58).

1427	   Content model:

1429	   In this order:

1431	   1.  One optional <name> element (Section 2.32)

1433	   2.  Optional <iref> elements (Section 2.27)

1435	   3.  One optional <preamble> element (Section 3.6)

1437	   4.  In any order, but at least one of:

1439	       *  <artwork> elements (Section 2.5)
1440	       *  <sourcecode> elements (Section 2.48)

1442	   5.  One optional <postamble> element (Section 3.5)

1444	2.25.1.  "align" Attribute

1446	   Deprecated.

1448	   Note: does not affect title or <artwork> alignment.

1450	   Allowed values:

1452	   o  "left" (default)

1454	   o  "center"

1456	   o  "right"

1458	2.25.2.  "alt" Attribute

1460	   Deprecated.  If the goal is to provide a single URI for a reference,
1461	   use the "target" attribute in <reference> instead.

1463	2.25.3.  "anchor" Attribute

1465	   Document-wide unique identifier for this figure.

1467	2.25.4.  "height" Attribute

1469	   Deprecated.

1471	2.25.5.  "src" Attribute

1473	   Deprecated.

1475	2.25.6.  "suppress-title" Attribute

1477	   Deprecated.

1479	   Allowed values:

1481	   o  "true"

1483	   o  "false" (default)

1485	2.25.7.  "title" Attribute

1487	   Deprecated.  Use <name> instead.

1489	2.25.8.  "width" Attribute

1491	   Deprecated.

1493	2.26.  <front>

1495	   Represents the "front matter": metadata (such as author information),
1496	   the Abstract, and additional notes.

1498	   A <front> element may have more than one <seriesInfo> element.  A
1499	   <seriesInfo> element determines the document number (for RFCs) or
1500	   name (for Internet-Drafts).  Another <seriesInfo> element determines
1501	   the "maturity level" (defined in [RFC2026]), using values of "std"
1502	   for "Standards Track", "bcp" for "BCP", "info" for "Informational",
1503	   "exp" for "Experimental", and "historic" for "Historic".  The "name"
1504	   attributes of those multiple <seriesInfo> elements interact as
1505	   described in Section 2.47.

1507	   This element appears as a child element of <reference> (Section 2.40)
1508	   and <rfc> (Section 2.45).

1510	   Content model:

1512	   In this order:

1514	   1.   One <title> element (Section 2.60)

1516	   2.   Optional <seriesInfo> elements (Section 2.47)

1518	   3.   One or more <author> elements (Section 2.7)

1520	   4.   One optional <date> element (Section 2.17)

1522	   5.   Optional <area> elements (Section 2.4)

1524	   6.   Optional <workgroup> elements (Section 2.65)

1526	   7.   Optional <keyword> elements (Section 2.28)

1528	   8.   One optional <abstract> element (Section 2.1)

1530	   9.   Optional <note> elements (Section 2.33)
1531	   10.  One optional <boilerplate> element (Section 2.11)

1533	2.27.  <iref>

1535	   Provides terms for the document's index.

1537	   Index entries can be either regular entries (when just the "item"
1538	   attribute is given) or nested entries (by specifying "subitem" as
1539	   well), grouped under a regular entry.

1541	   Index entries generally refer to the exact place where the <iref>
1542	   element occurred.  An exception is the occurrence as a child element
1543	   of <section>, in which case the whole section is considered to be
1544	   relevant for that index entry.  In some formats, index entries of
1545	   this type might be displayed as ranges.

1547	   When the prep tool is creating index content, it collects the items
1548	   in a case-sensitive fashion for both the item and subitem level.

1550	   This element appears as a child element of <annotation>
1551	   (Section 2.3), <aside> (Section 2.6), <blockquote> (Section 2.10),
1552	   <c> (Section 3.1), <dd> (Section 2.18), <dt> (Section 2.21), <em>
1553	   (Section 2.22), <figure> (Section 2.25), <li> (Section 2.29),
1554	   <postamble> (Section 3.5), <preamble> (Section 3.6), <section>
1555	   (Section 2.46), <strong> (Section 2.50), <sub> (Section 2.51), <sup>
1556	   (Section 2.52), <t> (Section 2.53), <table> (Section 2.54), <td>
1557	   (Section 2.56), <th> (Section 2.58), <tt> (Section 2.62), and <ttcol>
1558	   (Section 3.9).

1560	   Content model: this element does not have any contents.

1562	2.27.1.  "item" Attribute (Mandatory)

1564	   The item to include.

1566	2.27.2.  "primary" Attribute

1568	   Setting this to "true" declares the occurrence as "primary", which
1569	   might cause it to be highlighted in the index.  There is no
1570	   restriction on the number of occurrences that can be "primary".

1572	   Allowed values:

1574	   o  "true"

1576	   o  "false" (default)

1578	2.27.3.  "subitem" Attribute

1580	   The subitem to include.

1582	2.28.  <keyword>

1584	   Specifies a keyword applicable to the document.

1586	   Note that each element should only contain a single keyword; for
1587	   multiple keywords, the element can simply be repeated.

1589	   Keywords are used both in the RFC Index and in the metadata of
1590	   generated document representations.

1592	   This element appears as a child element of <front> (Section 2.26).

1594	   Content model: only text content.

1596	2.29.  <li>

1598	   A list element, used in <ol> and <ul>.

1600	   This element appears as a child element of <ol> (Section 2.34) and
1601	   <ul> (Section 2.63).

1603	   Content model:

1605	   Either:

1607	      In any order, but at least one of:

1609	      *  <artwork> elements (Section 2.5)

1611	      *  <dl> elements (Section 2.20)

1613	      *  <figure> elements (Section 2.25)

1615	      *  <ol> elements (Section 2.34)

1617	      *  <sourcecode> elements (Section 2.48)

1619	      *  <t> elements (Section 2.53)

1621	      *  <ul> elements (Section 2.63)

1623	   Or:

1625	      In any order, but at least one of:

1627	      *  Text

1629	      *  <bcp14> elements (Section 2.9)

1631	      *  <cref> elements (Section 2.16)

1633	      *  <em> elements (Section 2.22)

1635	      *  <eref> elements (Section 2.24)

1637	      *  <iref> elements (Section 2.27)

1639	      *  <relref> elements (Section 2.44)

1641	      *  <strong> elements (Section 2.50)

1643	      *  <sub> elements (Section 2.51)

1645	      *  <sup> elements (Section 2.52)

1647	      *  <tt> elements (Section 2.62)

1649	      *  <xref> elements (Section 2.66)

1651	2.29.1.  "anchor" Attribute

1653	   Document-wide unique identifier for this list item.

1655	2.30.  <link>

1657	   A link to an external document that is related to the RFC.

1659	   The following are the supported types of external documents that can
1660	   be pointed to in a <link> element:

1662	   o  The current International Standard Serial Number (ISSN) for the
1663	      RFC Series.  The value for the "rel" attribute is "item".  The
1664	      link should use the form "urn:issn:".

1666	   o  The Digital Object Identifier (DOI) for this document.  The value
1667	      for the "rel" attribute is "describedBy".  The link should use the
1668	      form specified in [RFC7669]; this is expected to change in the
1669	      future.

1671	   o  The Internet-Draft that was submitted to the RFC Editor to become
1672	      the published RFC.  The value for the "rel" attribute is
1673	      "convertedFrom".  The link should be to an IETF-controlled web
1674	      site that retains copies of Internet-Drafts.

1676	   o  A representation of the document offered by the document author.
1677	      The value for the "rel" attribute is "alternate".  The link can be
1678	      to a personally run web site.

1680	   In RFC production mode, the prep tool needs to check the values for
1681	   <link> before an RFC is published.  In draft production mode, the
1682	   prep tool might remove some <link> elements during the draft
1683	   submission process.

1685	   This element appears as a child element of <rfc> (Section 2.45).

1687	   Content model: this element does not have any contents.

1689	2.30.1.  "href" Attribute (Mandatory)

1691	   The URI of the external document.

1693	2.30.2.  "rel" Attribute

1695	   The relationship of the external document to this one.  The
1696	   relationships are taken from the "Link Relations" registry maintained
1697	   by IANA [LINKRELATIONS].

1699	2.31.  <middle>

1701	   Represents the main content of the document.

1703	   This element appears as a child element of <rfc> (Section 2.45).

1705	   Content model:

1707	   One or more <section> elements (Section 2.46)

1709	2.32.  <name>

1711	   The name of the section, note, figure, or texttable.  This name can
1712	   indicate markup of flowing text (for example, including references or
1713	   making some characters use a fixed-width font).

1715	   This element appears as a child element of <figure> (Section 2.25),
1716	   <note> (Section 2.33), <references> (Section 2.42), <section>
1717	   (Section 2.46), <table> (Section 2.54), and <texttable>
1718	   (Section 3.8).

1720	   Content model:

1722	   In any order:

1724	   o  Text

1726	   o  <cref> elements (Section 2.16)

1728	   o  <eref> elements (Section 2.24)

1730	   o  <relref> elements (Section 2.44)

1732	   o  <tt> elements (Section 2.62)

1734	   o  <xref> elements (Section 2.66)

1736	2.33.  <note>

1738	   Creates an unnumbered, titled block of text that appears after the
1739	   Abstract.

1741	   It is usually used for additional information to reviewers (Working
1742	   Group information, mailing list, ...) or for additional publication
1743	   information such as "IESG Notes".

1745	   This element appears as a child element of <front> (Section 2.26).

1747	   Content model:

1749	   In this order:

1751	   1.  One optional <name> element (Section 2.32)

1753	   2.  In any order, but at least one of:

1755	       *  <dl> elements (Section 2.20)

1757	       *  <ol> elements (Section 2.34)

1759	       *  <t> elements (Section 2.53)

1761	       *  <ul> elements (Section 2.63)

1763	2.33.1.  "removeInRFC" Attribute

1765	   If set to "true", this note is marked in the prep tool with text
1766	   indicating that it should be removed before the document is published
1767	   as an RFC.  That text will be "This note is to be removed before
1768	   publishing as an RFC."

1770	   Allowed values:

1772	   o  "true"

1774	   o  "false" (default)

1776	2.33.2.  "title" Attribute

1778	   Deprecated.  Use <name> instead.

1780	2.34.  <ol>

1782	   An ordered list.  The labels on the items will be either a number or
1783	   a letter, depending on the value of the style attribute.

1785	   This element appears as a child element of <abstract> (Section 2.1),
1786	   <aside> (Section 2.6), <blockquote> (Section 2.10), <dd>
1787	   (Section 2.18), <li> (Section 2.29), <note> (Section 2.33), <section>
1788	   (Section 2.46), <td> (Section 2.56), and <th> (Section 2.58).

1790	   Content model:

1792	   One or more <li> elements (Section 2.29)

1794	2.34.1.  "anchor" Attribute

1796	   Document-wide unique identifier for the list.

1798	2.34.2.  "group" Attribute

1800	   When the prep tool sees an <ol> element with a "group" attribute that
1801	   has already been seen, it continues the numbering of the list from
1802	   where the previous list with the same group name left off.  If an
1803	   <ol> element has both a "group" attribute and a "start" attribute,
1804	   the group's numbering is reset to the given start value.

1806	2.34.3.  "spacing" Attribute

1808	   Defines whether or not there is a blank line between entries.
1809	   spacing="normal" indicates a single blank line, while
1810	   spacing="compact" indicates no space between.

1812	   Allowed values:

1814	   o  "normal" (default)

1816	   o  "compact"

1818	2.34.4.  "start" Attribute

1820	   The ordinal value at which to start the list.  This defaults to "1"
1821	   and must be an integer of 0 or greater.

1823	2.34.5.  "type" Attribute

1825	   The type of the labels on list items.  If the length of the type
1826	   value is 1, the meaning is the same as it is for HTML:

1828	   a  Lowercase letters (a, b, c, ...)

1830	   A  Uppercase letters (A, B, C, ...)

1832	   1  Decimal numbers (1, 2, 3, ...)

1834	   i  Lowercase Roman numerals (i, ii, iii, ...)

1836	   I  Uppercase Roman numerals (I, II, III, ...)

1838	   For types "a" and "A", after the 26th entry, the numbering starts at
1839	   "aa"/"AA", then "ab"/"AB", and so on.

1841	   If the length of the type value is greater than 1, the value must
1842	   contain a percent-encoded indicator and other text.  The value is a
1843	   free-form text that allows counter values to be inserted using a
1844	   "percent-letter" format.  For instance, "[REQ%d]" generates labels of
1845	   the form "[REQ1]", where "%d" inserts the item number as a decimal
1846	   number.

1848	   The following formats are supported:

1850	   %c Lowercase letters (a, b, c, ...)

1852	   %C Uppercase letters (A, B, C, ...)

1854	   %d Decimal numbers (1, 2, 3, ...)

1856	   %i Lowercase Roman numerals (i, ii, iii, ...)
1857	   %I Uppercase Roman numerals (I, II, III, ...)

1859	   %% Represents a percent sign

1861	   Other formats are reserved for future use.  Only one percent encoding
1862	   other than "%%" is allowed in a type string.

1864	   It is an error for the type string to be empty.  For bulleted lists,
1865	   use the <ul> element.  For lists that have neither bullets nor
1866	   numbers, use the <ul> element with the 'empty="true"' attribute.

1868	   If no type attribute is given, the default type is the same as
1869	   "type='%d.'".

1871	2.35.  <organization>

1873	   Specifies the affiliation [RFC7322] of an author.

1875	   This information appears both in the "Author's Address" section and
1876	   on the front page (see [RFC7322] for more information).  If the value
1877	   is long, an abbreviated variant can be specified in the "abbrev"
1878	   attribute.

1880	   This element appears as a child element of <author> (Section 2.7).

1882	   Content model: only text content.

1884	2.35.1.  "abbrev" Attribute

1886	   Abbreviated variant.

1888	2.35.2.  "ascii" Attribute

1890	   The ASCII equivalent of the organization's name.

1892	2.36.  <phone>

1894	   Represents a phone number.

1896	   The value is expected to be the scheme-specific part of a "tel" URI
1897	   (and so does not include the prefix "tel:"), using the "global-
1898	   number-digits" syntax.  See Section 3 of [RFC3966] for details.

1900	   This element appears as a child element of <address> (Section 2.2).

1902	   Content model: only text content.

1904	2.37.  <postal>

1906	   Contains optional child elements providing postal information.  These
1907	   elements will be displayed in an order that is specific to
1908	   formatters.  A postal address can contain only a set of <street>,
1909	   <city>, <region>, <code>, and <country> elements, or only an ordered
1910	   set of <postalLine> elements, but not both.

1912	   This element appears as a child element of <address> (Section 2.2).

1914	   Content model:

1916	   Either:

1918	      In any order:

1920	      *  <city> elements (Section 2.13)

1922	      *  <code> elements (Section 2.14)

1924	      *  <country> elements (Section 2.15)

1926	      *  <region> elements (Section 2.43)

1928	      *  <street> elements (Section 2.49)

1930	   Or:

1932	      One or more <postalLine> elements (Section 2.38)

1934	2.38.  <postalLine>

1936	   Represents one line of a postal address.  When more than one
1937	   <postalLine> is given, the prep tool emits them in the order given.

1939	   This element appears as a child element of <postal> (Section 2.37).

1941	   Content model: only text content.

1943	2.38.1.  "ascii" Attribute

1945	   The ASCII equivalent of the text in the address line.

1947	2.39.  <refcontent>

1949	   Text that should appear between the title and the date of a
1950	   reference.  The purpose of this element is to prevent the need to
1951	   abuse <seriesInfo> to get such text in a reference.

1953	   For example:

1955	   <reference anchor="April1">
1956	     <front>
1957	       <title>On Being A Fool</title>
1958	       <author initials="K." surname="Phunny" fullname="Knot Phunny"/>
1959	       <date year="2000" month="April"/>
1960	     </front>
1961	     <refcontent>Self-published pamphlet</refcontent>
1962	   </reference>

1964	   would render as:

1966	      [April1]     Phunny, K., "On Being A Fool", Self-published
1967	                   pamphlet, April 2000.

1969	   This element appears as a child element of <reference>
1970	   (Section 2.40).

1972	   Content model:

1974	   In any order:

1976	   o  Text

1978	   o  <bcp14> elements (Section 2.9)

1980	   o  <em> elements (Section 2.22)

1982	   o  <strong> elements (Section 2.50)

1984	   o  <sub> elements (Section 2.51)

1986	   o  <sup> elements (Section 2.52)

1988	   o  <tt> elements (Section 2.62)

1990	2.40.  <reference>

1992	   Represents a bibliographic reference.

1994	   This element appears as a child element of <referencegroup>
1995	   (Section 2.41) and <references> (Section 2.42).

1997	   Content model:

1999	   In this order:

2001	   1.  One <front> element (Section 2.26)

2003	   2.  In any order:

2005	       *  <annotation> elements (Section 2.3)

2007	       *  <format> elements (Section 3.3)

2009	       *  <refcontent> elements (Section 2.39)

2011	       *  <seriesInfo> elements (Section 2.47; deprecated in this
2012	          context)

2014	2.40.1.  "anchor" Attribute (Mandatory)

2016	   Document-wide unique identifier for this reference.  Usually, this
2017	   will be used both to "label" the reference in the "References"
2018	   section and as an identifier in links to this reference entry.

2020	2.40.2.  "quoteTitle" Attribute

2022	   Specifies whether or not the title in the reference should be quoted.
2023	   This can be used to prevent quoting, such as on errata.

2025	   Allowed values:

2027	   o  "true" (default)

2029	   o  "false"

2031	2.40.3.  "target" Attribute

2033	   Holds the URI for the reference.

2035	2.41.  <referencegroup>

2037	   Represents a list of bibliographic references that will be
2038	   represented as a single reference.  This is most often used to
2039	   reference STDs and BCPs, where a single reference (such as "BCP 9")
2040	   may encompass more than one RFC.

2042	   This element appears as a child element of <references>
2043	   (Section 2.42).

2045	   Content model:

2047	   One or more <reference> elements (Section 2.40)

2049	2.41.1.  "anchor" Attribute (Mandatory)

2051	   Document-wide unique identifier for this reference group.  Usually,
2052	   this will be used both to "label" the reference group in the
2053	   "References" section and as an identifier in links to this reference
2054	   entry.

2056	2.42.  <references>

2058	   Contains a set of bibliographic references.

2060	   In the early days of the RFC Series, there was only one "References"
2061	   section per RFC.  This convention was later changed to group
2062	   references into two sets, "Normative" and "Informative", as described
2063	   in [RFC7322].  This vocabulary supports the split with the <name>
2064	   child element.  In general, the title should be either "Normative
2065	   References" or "Informative References".

2067	   This element appears as a child element of <back> (Section 2.8).

2069	   Content model:

2071	   In this order:

2073	   1.  One optional <name> element (Section 2.32)

2075	   2.  In any order:

2077	       *  <reference> elements (Section 2.40)

2079	       *  <referencegroup> elements (Section 2.41)

2081	2.42.1.  "anchor" Attribute

2083	   An optional user-supplied identifier for this set of references.

2085	2.42.2.  "title" Attribute

2087	   Deprecated.  Use <name> instead.

2089	2.43.  <region>

2091	   Provides the region name in a postal address.

2093	   This element appears as a child element of <postal> (Section 2.37).

2095	   Content model: only text content.

2097	2.43.1.  "ascii" Attribute

2099	   The ASCII equivalent of the region name.

2101	2.44.  <relref>

2103	   Represents a link to a specific part of a document that appears in a
2104	   <reference> element.  Formatters that have links (such as HTML and
2105	   PDF) render <relref> elements as external hyperlinks to the specified
2106	   part of the reference, creating the link target by combining the base
2107	   URI from the <reference> element with the "relative" attribute from
2108	   this element.  The "target" attribute is required, and it must be the
2109	   anchor of a <reference> element.

2111	   The "section" attribute is required, and the "relative" attribute is
2112	   optional.  If the reference is not an RFC or Internet-Draft that is
2113	   in the v3 format, the element needs to have a "relative" attribute;
2114	   in this case, the value of the "section" attribute is ignored.

2116	   An example of the <relref> element with text content might be:

2118	         See
2119	         <relref section="2.3" target="RFC9999" displayFormat="bare">
2120	         the protocol overview</relref>
2121	         for more information.

2123	   An HTML formatter might generate:

2125	         See
2126	         <a href="http://www.rfc-editor.org/rfc/rfc9999.html#s-2.3">
2127	         the protocol overview</a>
2128	         for more information.

2130	   Note that the URL in the above example might be different when the
2131	   RFC Editor deploys the v3 format.

2133	   This element appears as a child element of <annotation>
2134	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
2135	   <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
2136	   (Section 2.29), <name> (Section 2.32), <preamble> (Section 3.6),
2137	   <strong> (Section 2.50), <sub> (Section 2.51), <sup> (Section 2.52),
2138	   <t> (Section 2.53), <td> (Section 2.56), <th> (Section 2.58), and
2139	   <tt> (Section 2.62).

2141	   Content model: only text content.

2143	2.44.1.  "displayFormat" Attribute

2145	   This attribute is used to signal formatters what the desired format
2146	   of the relative reference should be.  Formatters for document types
2147	   that have linking capability should wrap each part of the displayed
2148	   text in hyperlinks.  If there is content in the <relref> element,
2149	   formatters will ignore the value of this attribute.

2151	   "of"

2153	      A formatter should display the relative reference as the word
2154	      "Section" followed by a space, the contents of the "section"
2155	      attribute followed by a space, the word "of", another space, and
2156	      the value from the "target" attribute enclosed in square brackets.

2158	      For example, with an input of:

2160	         See
2161	         <relref section="2.3" target="RFC9999" displayFormat="of"/>
2162	         for an overview.

2164	      An HTML formatter might generate:

2166	         See
2167	         <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3">
2168	         Section 2.3</a> of
2169	         [<a href="#RFC9999">RFC9999</a>]
2170	         for an overview.

2172	      Note that "displayFormat='of'" is the default for <relref>, so it
2173	      does not need to be given in a <relref> element if that format is
2174	      desired.

2176	   "comma"

2178	      A formatter should display the relative reference as the value
2179	      from the "target" attribute enclosed in square brackets, a comma,
2180	      a space, the word "Section" followed by a space, and the "section"
2181	      attribute.

2183	      For example, with an input of:

2185	         See
2186	         <relref section="2.3" target="RFC9999" displayFormat="comma"/>,
2187	         for an overview.

2189	      An HTML formatter might generate:

2191	         See
2192	         [<a href="#RFC9999">RFC9999</a>],
2193	         <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3">
2194	         Section 2.3</a>, for an overview.

2196	   "parens"

2198	      A formatter should display the relative reference as the value
2199	      from the "target" attribute enclosed in square brackets, a space,
2200	      a left parenthesis, the word "Section" followed by a space, the
2201	      "section" attribute, and a right parenthesis.

2203	      For example, with an input of:

2205	         See
2206	         <relref section="2.3" target="RFC9999" displayFormat="parens"/>
2207	         for an overview.

2209	      An HTML formatter might generate:

2211	         See
2212	         [<a href="#RFC9999">RFC9999</a>]
2213	         (<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3">
2214	         Section 2.3</a>)
2215	         for an overview.

2217	   "bare"

2219	      A formatter should display the relative reference as the contents
2220	      of the "section" attribute and nothing else.  This is useful when
2221	      there are multiple relative references to a single base reference.

2223	      For example:

2225	         See Sections
2226	         <relref section="2.3" target="RFC9999" displayFormat="bare"/>
2227	         and
2228	         <relref section="2.4" target="RFC9999" displayFormat="of"/>
2229	         for an overview.

2231	      An HTML formatter might generate:

2233	         See Sections
2234	         <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3">
2235	         2.3</a>
2236	         and
2237	         <a href="http://www.rfc-editor.org/info/rfc9999#s-2.4">
2238	         Section 2.4</a> of
2239	         [<a href="#RFC9999">RFC9999</a>]
2240	         for an overview.

2242	   Allowed values:

2244	   o  "of" (default)

2246	   o  "comma"

2248	   o  "parens"

2250	   o  "bare"

2252	2.44.2.  "relative" Attribute

2254	   Specifies a relative reference from the URI in the target reference.
2255	   This value must include whatever leading character is needed to
2256	   create the relative reference; typically, this is "#" for HTML
2257	   documents.

2259	2.44.3.  "section" Attribute (Mandatory)

2261	   Specifies a section of the target reference.  If the reference is not
2262	   an RFC or Internet-Draft in the v3 format, it is an error.

2264	2.44.4.  "target" Attribute (Mandatory)

2266	   The anchor of the reference for this element.  If this value is not
2267	   an anchor to a <reference> or <referencegroup> element, it is an
2268	   error.  If the reference at the target has no URI, it is an error.

2270	2.45.  <rfc>

2272	   This is the root element of the xml2rfc vocabulary.

2274	   Content model:

2276	   In this order:

2278	   1.  Optional <link> elements (Section 2.30)

2280	   2.  One <front> element (Section 2.26)

2282	   3.  One <middle> element (Section 2.31)

2284	   4.  One optional <back> element (Section 2.8)

2286	2.45.1.  "category" Attribute

2288	   Deprecated; instead, use the "name" attribute in <seriesInfo>.

2290	2.45.2.  "consensus" Attribute

2292	   Affects the generated boilerplate.  Note that the values of "no" and
2293	   "yes" are deprecated and are replaced by "false" (the default) and
2294	   "true".

2296	   See [RFC7841] for more information.

2298	   Allowed values:

2300	   o  "no"

2302	   o  "yes"

2304	   o  "false" (default)

2306	   o  "true"

2308	2.45.3.  "docName" Attribute

2310	   Deprecated; instead, use the "value" attribute in <seriesInfo>.

2312	2.45.4.  "indexInclude" Attribute

2314	   Specifies whether or not a formatter is requested to include an index
2315	   in generated files.  If the source file has no <iref> elements, an
2316	   index is never generated.  This option is useful for generating
2317	   documents where the source document has <iref> elements but the
2318	   author no longer wants an index.

2320	   Allowed values:

2322	   o  "true" (default)

2324	   o  "false"

2326	2.45.5.  "ipr" Attribute

2328	   Represents the Intellectual Property status of the document.  See
2329	   Appendix A.1 for details.

2331	2.45.6.  "iprExtract" Attribute

2333	   Identifies a single section within the document for which extraction
2334	   "as is" is explicitly allowed (only relevant for historic values of
2335	   the "ipr" attribute).

2337	2.45.7.  "number" Attribute

2339	   Deprecated; instead, use the "value" attribute in <seriesInfo>.

2341	2.45.8.  "obsoletes" Attribute

2343	   A comma-separated list of RFC numbers or Internet-Draft names.

2345	   The prep tool will parse the attribute value so that incorrect
2346	   references can be detected.

2348	2.45.9.  "prepTime" Attribute

2350	   The date that the XML was processed by a prep tool.  This is included
2351	   in the XML file just before it is saved to disk.  The value is
2352	   formatted using the "date-time" format defined in Section 5.6 of
2353	   [RFC3339].  The "time-offset" should be "Z".

2355	2.45.10.  "seriesNo" Attribute

2357	   Deprecated; instead, use the "value" attribute in <seriesInfo>.

2359	2.45.11.  "sortRefs" Attribute

2361	   Specifies whether or not the prep tool will sort the references in
2362	   each reference section.

2364	   Allowed values:

2366	   o  "true"

2368	   o  "false" (default)

2370	2.45.12.  "submissionType" Attribute

2372	   The document stream, as described in [RFC7841].  (The RFC Series
2373	   Editor may change the list of allowed values in the future.)

2375	   Allowed values:

2377	   o  "IETF" (default)

2379	   o  "IAB"

2381	   o  "IRTF"

2383	   o  "independent"

2385	2.45.13.  "symRefs" Attribute

2387	   Specifies whether or not a formatter is requested to use symbolic
2388	   references (such as "[RFC2119]").  If the value for this is "false",
2389	   the references come out as numbers (such as "[3]").

2391	   Allowed values:

2393	   o  "true" (default)

2395	   o  "false"

2397	2.45.14.  "tocDepth" Attribute

2399	   Specifies the number of levels of headings that a formatter is
2400	   requested to include in the table of contents; the default is "3".

2402	2.45.15.  "tocInclude" Attribute

2404	   Specifies whether or not a formatter is requested to include a table
2405	   of contents in generated files.

2407	   Allowed values:

2409	   o  "true" (default)

2411	   o  "false"

2413	2.45.16.  "updates" Attribute

2415	   A comma-separated list of RFC numbers or Internet-Draft names.

2417	   The prep tool will parse the attribute value so that incorrect
2418	   references can be detected.

2420	2.45.17.  "version" Attribute

2422	   Specifies the version of xml2rfc syntax used in this document.  The
2423	   only expected value (for now) is "3".

2425	2.46.  <section>

2427	   Represents a section (when inside a <middle> element) or an appendix
2428	   (when inside a <back> element).

2430	   Subsections are created by nesting <section> elements inside
2431	   <section> elements.  Sections are allowed to be empty.

2433	   This element appears as a child element of <back> (Section 2.8),
2434	   <boilerplate> (Section 2.11), <middle> (Section 2.31), and <section>
2435	   (Section 2.46).

2437	   Content model:

2439	   In this order:

2441	   1.  One optional <name> element (Section 2.32)

2443	   2.  In any order:

2445	       *  <artwork> elements (Section 2.5)

2447	       *  <aside> elements (Section 2.6)

2449	       *  <blockquote> elements (Section 2.10)

2451	       *  <dl> elements (Section 2.20)

2453	       *  <figure> elements (Section 2.25)

2455	       *  <iref> elements (Section 2.27)

2457	       *  <ol> elements (Section 2.34)

2459	       *  <sourcecode> elements (Section 2.48)

2461	       *  <t> elements (Section 2.53)

2463	       *  <table> elements (Section 2.54)
2464	       *  <texttable> elements (Section 3.8)

2466	       *  <ul> elements (Section 2.63)

2468	   3.  Optional <section> elements (Section 2.46)

2470	2.46.1.  "anchor" Attribute

2472	   Document-wide unique identifier for this section.

2474	2.46.2.  "numbered" Attribute

2476	   If set to "false", the formatter is requested to not display a
2477	   section number.  The prep tool will verify that such a section is not
2478	   followed by a numbered section in this part of the document and will
2479	   verify that the section is a top-level section.

2481	   Allowed values:

2483	   o  "true" (default)

2485	   o  "false"

2487	2.46.3.  "removeInRFC" Attribute

2489	   If set to "true", this note is marked in the prep tool with text
2490	   indicating that it should be removed before the document is published
2491	   as an RFC.  That text will be "This note is to be removed before
2492	   publishing as an RFC."

2494	   Allowed values:

2496	   o  "true"

2498	   o  "false" (default)

2500	2.46.4.  "title" Attribute

2502	   Deprecated.  Use <name> instead.

2504	2.46.5.  "toc" Attribute

2506	   Indicates to a formatter whether or not the section is to be included
2507	   in a table of contents, if such a table of contents is produced.
2508	   This only takes effect if the level of the section would have
2509	   appeared in the table of contents based on the "tocDepth" attribute
2510	   of the <rfc> element, and of course only if the table of contents is
2511	   being created based on the "tocInclude" attribute of the <rfc>
2512	   element.  If this is set to "exclude", any section below this one
2513	   will be excluded as well.  The "default" value indicates inclusion of
2514	   the section if it would be included by the tocDepth attribute of the
2515	   <rfc> element.

2517	   Allowed values:

2519	   o  "include"

2521	   o  "exclude"

2523	   o  "default" (default)

2525	2.47.  <seriesInfo>

2527	   Specifies the document series in which this document appears, and
2528	   also specifies an identifier within that series.

2530	   A processing tool determines whether it is working on an RFC or an
2531	   Internet-Draft by inspecting the "name" attribute of a <seriesInfo>
2532	   element inside the <front> element inside the <rfc> element, looking
2533	   for "RFC" or "Internet-Draft".  (Specifying neither value in any of
2534	   the <seriesInfo> elements can be useful for producing other types of
2535	   documents but is out of scope for this specification.)

2537	   It is invalid to have multiple <seriesInfo> elements inside the same
2538	   <front> element containing the same "name" value.  Some combinations
2539	   of <seriesInfo> "name" attribute values make no sense, such as having
2540	   both <seriesInfo name="rfc"/> and <seriesInfo name="Internet-Draft"/>
2541	   in the same <front> element.

2543	   This element appears as a child element of <front> (Section 2.26) and
2544	   <reference> (Section 2.40; deprecated in this context).

2546	   Content model: this element does not have any contents.

2548	2.47.1.  "asciiName" Attribute

2550	   The ASCII equivalent of the name field.

2552	2.47.2.  "asciiValue" Attribute

2554	   The ASCII equivalent of the value field.

2556	2.47.3.  "name" Attribute (Mandatory)

2558	   The name of the series.  The currently known values are "RFC",
2559	   "Internet-Draft", and "DOI".  The RFC Series Editor may change this
2560	   list in the future.

2562	   Some of the values for "name" interact as follows:

2564	   o  If a <front> element contains a <seriesInfo> element with a name
2565	      of "Internet-Draft", it can also have at most one additional
2566	      <seriesInfo> element with a "status" attribute whose value is of
2567	      "standard", "full-standard", "bcp", "fyi", "informational",
2568	      "experimental", or "historic" to indicate the intended status of
2569	      this Internet-Draft, if it were to be later published as an RFC.
2570	      If such an additional <seriesInfo> element has one of those
2571	      statuses, the name needs to be "".

2573	   o  If a <front> element contains a <seriesInfo> element with a name
2574	      of "RFC", it can also have at most one additional <seriesInfo>
2575	      element with a "status" attribute whose value is of "full-
2576	      standard", "bcp", or "fyi" to indicate the current status of this
2577	      RFC.  If such an additional <seriesInfo> element has one of those
2578	      statuses, the "value" attribute for that name needs to be the
2579	      number within that series.  That <front> element might also
2580	      contain an additional <seriesInfo> element with the status of
2581	      "info", "exp", or "historic" and a name of "" to indicate the
2582	      status of the RFC.

2584	   o  A <front> element that has a <seriesInfo> element that has the
2585	      name "Internet-Draft" cannot also have a <seriesInfo> element that
2586	      has the name "RFC".

2588	   o  The <seriesInfo> element can contain the DOI for the referenced
2589	      document.  This cannot be used when the <seriesInfo> element is an
2590	      eventual child element of an <rfc> element -- only as an eventual
2591	      child of a <reference> element.  The "value" attribute should use
2592	      the form specified in [RFC7669].

2594	2.47.4.  "status" Attribute

2596	   The status of this document.  The currently known values are
2597	   "standard", "informational", "experimental", "bcp", "fyi", and "full-
2598	   standard".  The RFC Series Editor may change this list in the future.

2600	2.47.5.  "stream" Attribute

2602	   The stream (as described in [RFC7841]) that originated the document.
2603	   (The RFC Series Editor may change this list in the future.)
2604	   Allowed values:

2606	   o  "IETF" (default)

2608	   o  "IAB"

2610	   o  "IRTF"

2612	   o  "independent"

2614	2.47.6.  "value" Attribute (Mandatory)

2616	   The identifier within the series specified by the "name" attribute.

2618	   For BCPs, FYIs, RFCs, and STDs, this is the number within the series.
2619	   For Internet-Drafts, it is the full draft name (ending with the two-
2620	   digit version number).  For DOIs, the value is given, such as
2621	   "10.17487/rfc1149", as described in [RFC7669].

2623	   The name in the value should be the document name without any file
2624	   extension.  For Internet-Drafts, the value for this attribute should
2625	   be "draft-ietf-somewg-someprotocol-07", not
2626	   "draft-ietf-somewg-someprotocol-07.txt".

2628	2.48.  <sourcecode>

2630	   This element allows the inclusion of source code into the document.

2632	   When rendered, source code is always shown in a monospace font.  When
2633	   <sourcecode> is a child of <figure> or <section>, it provides full
2634	   control of horizontal whitespace and line breaks.  When formatted, it
2635	   is indented relative to the left margin of the enclosing element.  It
2636	   is thus useful for source code and formal languages (such as ABNF
2637	   [RFC5234] or the RNC notation used in this document).  (When
2638	   <sourcecode> is a child of other elements, it flows with the text
2639	   that surrounds it.)  Tab characters (U+0009) inside of this element
2640	   are prohibited.

2642	   For artwork such as character-based art, diagrams of message layouts,
2643	   and so on, use the <artwork> element instead.

2645	   Output formatters that do pagination should attempt to keep source
2646	   code on a single page.  This is to prevent source code that is split
2647	   across pages from looking like two separate pieces of code.

2649	   See Section 5 for a description of how to deal with issues of using
2650	   "&" and "<" characters in source code.

2652	   This element appears as a child element of <blockquote>
2653	   (Section 2.10), <dd> (Section 2.18), <figure> (Section 2.25), <li>
2654	   (Section 2.29), <section> (Section 2.46), <td> (Section 2.56), and
2655	   <th> (Section 2.58).

2657	   Content model: only text content.

2659	2.48.1.  "anchor" Attribute

2661	   Document-wide unique identifier for this source code.

2663	2.48.2.  "name" Attribute

2665	   A filename suitable for the contents (such as for extraction to a
2666	   local file).  This attribute can be helpful for other kinds of tools
2667	   (such as automated syntax checkers, which work by extracting the
2668	   source code).  Note that the "name" attribute does not need to be
2669	   unique for <artwork> elements in a document.  If multiple
2670	   <sourcecode> elements have the same "name" attribute, a formatter
2671	   might assume that the elements are all fragments of a single file,
2672	   and such a formatter can collect those fragments for later
2673	   processing.

2675	2.48.3.  "src" Attribute

2677	   The URI reference of a source file [RFC3986].

2679	   It is an error to have both a "src" attribute and content in the
2680	   <sourcecode> element.

2682	2.48.4.  "type" Attribute

2684	   Specifies the type of the source code.  The value of this attribute
2685	   is free text with certain values designated as preferred.

2687	   The preferred values for <sourcecode> types are:

2689	   o  abnf

2691	   o  asn.1

2693	   o  bash

2695	   o  c++

2697	   o  c
2698	   o  cbor

2700	   o  dtd

2702	   o  java

2704	   o  javascript

2706	   o  json

2708	   o  mib

2710	   o  perl

2712	   o  pseudocode

2714	   o  python

2716	   o  rnc

2718	   o  xml

2720	   o  yang

2722	   The RFC Series Editor will maintain a complete list of the preferred
2723	   values on the RFC Editor web site, and that list is expected to be
2724	   updated over time.  Thus, a consumer of v3 XML should not cause a
2725	   failure when it encounters an unexpected type or no type is
2726	   specified.

2728	2.49.  <street>

2730	   Provides a street address.

2732	   This element appears as a child element of <postal> (Section 2.37).

2734	   Content model: only text content.

2736	2.49.1.  "ascii" Attribute

2738	   The ASCII equivalent of the street address.

2740	2.50.  <strong>

2742	   Indicates text that is semantically strong.  Text enclosed within
2743	   this element will be displayed as bold after processing.  This
2744	   element can be combined with other character formatting elements, and
2745	   the formatting will be additive.

2747	   This element appears as a child element of <annotation>
2748	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
2749	   <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
2750	   (Section 2.29), <preamble> (Section 3.6), <refcontent>
2751	   (Section 2.39), <sub> (Section 2.51), <sup> (Section 2.52), <t>
2752	   (Section 2.53), <td> (Section 2.56), <th> (Section 2.58), and <tt>
2753	   (Section 2.62).

2755	   Content model:

2757	   In any order:

2759	   o  Text

2761	   o  <bcp14> elements (Section 2.9)

2763	   o  <cref> elements (Section 2.16)

2765	   o  <em> elements (Section 2.22)

2767	   o  <eref> elements (Section 2.24)

2769	   o  <iref> elements (Section 2.27)

2771	   o  <relref> elements (Section 2.44)

2773	   o  <sub> elements (Section 2.51)

2775	   o  <sup> elements (Section 2.52)

2777	   o  <tt> elements (Section 2.62)

2779	   o  <xref> elements (Section 2.66)

2781	2.51.  <sub>

2783	   Causes the text to be displayed as subscript, approximately half a
2784	   letter-height lower than normal text.  This element can be combined
2785	   with other character formatting elements, and the formatting will be
2786	   additive.

2788	   This element appears as a child element of <annotation>
2789	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
2790	   <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
2791	   (Section 2.29), <preamble> (Section 3.6), <refcontent>
2792	   (Section 2.39), <strong> (Section 2.50), <t> (Section 2.53), <td>
2793	   (Section 2.56), <th> (Section 2.58), and <tt> (Section 2.62).

2795	   Content model:

2797	   In any order:

2799	   o  Text

2801	   o  <bcp14> elements (Section 2.9)

2803	   o  <cref> elements (Section 2.16)

2805	   o  <em> elements (Section 2.22)

2807	   o  <eref> elements (Section 2.24)

2809	   o  <iref> elements (Section 2.27)

2811	   o  <relref> elements (Section 2.44)

2813	   o  <strong> elements (Section 2.50)

2815	   o  <tt> elements (Section 2.62)

2817	   o  <xref> elements (Section 2.66)

2819	2.52.  <sup>

2821	   Causes the text to be displayed as superscript, approximately half a
2822	   letter-height higher than normal text.  This element can be combined
2823	   with other character formatting elements, and the formatting will be
2824	   additive.

2826	   This element appears as a child element of <annotation>
2827	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
2828	   <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
2829	   (Section 2.29), <preamble> (Section 3.6), <refcontent>
2830	   (Section 2.39), <strong> (Section 2.50), <t> (Section 2.53), <td>
2831	   (Section 2.56), <th> (Section 2.58), and <tt> (Section 2.62).

2833	   Content model:

2835	   In any order:

2837	   o  Text

2839	   o  <bcp14> elements (Section 2.9)

2841	   o  <cref> elements (Section 2.16)
2842	   o  <em> elements (Section 2.22)

2844	   o  <eref> elements (Section 2.24)

2846	   o  <iref> elements (Section 2.27)

2848	   o  <relref> elements (Section 2.44)

2850	   o  <strong> elements (Section 2.50)

2852	   o  <tt> elements (Section 2.62)

2854	   o  <xref> elements (Section 2.66)

2856	2.53.  <t>

2858	   Contains a paragraph of text.

2860	   This element appears as a child element of <abstract> (Section 2.1),
2861	   <aside> (Section 2.6), <blockquote> (Section 2.10), <dd>
2862	   (Section 2.18), <li> (Section 2.29), <list> (Section 3.4), <note>
2863	   (Section 2.33), <section> (Section 2.46), <td> (Section 2.56), and
2864	   <th> (Section 2.58).

2866	   Content model:

2868	   In any order:

2870	   o  Text

2872	   o  <bcp14> elements (Section 2.9)

2874	   o  <cref> elements (Section 2.16)

2876	   o  <em> elements (Section 2.22)

2878	   o  <eref> elements (Section 2.24)

2880	   o  <iref> elements (Section 2.27)

2882	   o  <list> elements (Section 3.4)

2884	   o  <relref> elements (Section 2.44)

2886	   o  <spanx> elements (Section 3.7)

2888	   o  <strong> elements (Section 2.50)
2889	   o  <sub> elements (Section 2.51)

2891	   o  <sup> elements (Section 2.52)

2893	   o  <tt> elements (Section 2.62)

2895	   o  <vspace> elements (Section 3.10)

2897	   o  <xref> elements (Section 2.66)

2899	2.53.1.  "anchor" Attribute

2901	   Document-wide unique identifier for this paragraph.

2903	2.53.2.  "hangText" Attribute

2905	   Deprecated.  Instead, use <dd> inside of a definition list (<dl>).

2907	2.53.3.  "keepWithNext" Attribute

2909	   Acts as a hint to the output formatters that do pagination to do a
2910	   best-effort attempt to keep the paragraph with the next element,
2911	   whatever that happens to be.  For example, the HTML output @media
2912	   print CSS ("CSS" refers to Cascading Style Sheets) might translate
2913	   this to page-break-after: avoid.  For PDF, the paginator could
2914	   attempt to keep the paragraph with the next element.  Note: this
2915	   attribute is strictly a hint and not always actionable.

2917	   Allowed values:

2919	   o  "false" (default)

2921	   o  "true"

2923	2.53.4.  "keepWithPrevious" Attribute

2925	   Acts as a hint to the output formatters that do pagination to do a
2926	   best-effort attempt to keep the paragraph with the previous element,
2927	   whatever that happens to be.  For example, the HTML output @media
2928	   print CSS might translate this to page-break-before: avoid.  For PDF,
2929	   the paginator could attempt to keep the paragraph with the previous
2930	   element.  Note: this attribute is strictly a hint and not always
2931	   actionable.

2933	   Allowed values:

2935	   o  "false" (default)

2937	   o  "true"

2939	2.54.  <table>

2941	   Contains a table with a caption with the table number.  If the
2942	   element contains a <name> element, the caption will also show that
2943	   name.

2945	   Inside the <table> element is, optionally, a <thead> element to
2946	   contain the rows that will be the table's heading and, optionally, a
2947	   <tfoot> element to contain the rows of the table's footer.  If the
2948	   XML is converted to a representation that has page breaks (such as
2949	   PDFs or printed HTML), the header and footer are meant to appear on
2950	   each page.

2952	   This element appears as a child element of <aside> (Section 2.6) and
2953	   <section> (Section 2.46).

2955	   Content model:

2957	   In this order:

2959	   1.  One optional <name> element (Section 2.32)

2961	   2.  Optional <iref> elements (Section 2.27)

2963	   3.  One optional <thead> element (Section 2.59)

2965	   4.  One or more <tbody> elements (Section 2.55)

2967	   5.  One optional <tfoot> element (Section 2.57)

2969	2.54.1.  "anchor" Attribute

2971	   Document-wide unique identifier for this table.

2973	2.55.  <tbody>

2975	   A container for a set of body rows for a table.

2977	   This element appears as a child element of <table> (Section 2.54).

2979	   Content model:

2981	   One or more <tr> elements (Section 2.61)

2983	2.55.1.  "anchor" Attribute

2985	   Document-wide unique identifier for the tbody.

2987	2.56.  <td>

2989	   A cell in a table row.

2991	   This element appears as a child element of <tr> (Section 2.61).

2993	   Content model:

2995	   Either:

2997	      In any order, but at least one of:

2999	      *  <artwork> elements (Section 2.5)

3001	      *  <dl> elements (Section 2.20)

3003	      *  <figure> elements (Section 2.25)

3005	      *  <ol> elements (Section 2.34)

3007	      *  <sourcecode> elements (Section 2.48)

3009	      *  <t> elements (Section 2.53)

3011	      *  <ul> elements (Section 2.63)

3013	   Or:

3015	      In any order:

3017	      *  Text

3019	      *  <bcp14> elements (Section 2.9)

3021	      *  <br> elements (Section 2.12)

3023	      *  <cref> elements (Section 2.16)

3025	      *  <em> elements (Section 2.22)
3026	      *  <eref> elements (Section 2.24)

3028	      *  <iref> elements (Section 2.27)

3030	      *  <relref> elements (Section 2.44)

3032	      *  <strong> elements (Section 2.50)

3034	      *  <sub> elements (Section 2.51)

3036	      *  <sup> elements (Section 2.52)

3038	      *  <tt> elements (Section 2.62)

3040	      *  <xref> elements (Section 2.66)

3042	2.56.1.  "align" Attribute

3044	   Controls whether the content of the cell appears left justified
3045	   (default), centered, or right justified.  Note that "center" or
3046	   "right" will probably only work well in cells with plain text; any
3047	   other elements might make the contents render badly.

3049	   Allowed values:

3051	   o  "left" (default)

3053	   o  "center"

3055	   o  "right"

3057	2.56.2.  "anchor" Attribute

3059	   Document-wide unique identifier for the cell.

3061	2.56.3.  "colspan" Attribute

3063	   The number of columns that the cell is to span.  For example, setting
3064	   "colspan='3'" indicates that the cell occupies the same horizontal
3065	   space as three cells of a row without any "colspan" attributes.

3067	2.56.4.  "rowspan" Attribute

3069	   The number of rows that the cell is to span.  For example, setting
3070	   "rowspan='3'" indicates that the cell occupies the same vertical
3071	   space as three rows.

3073	2.57.  <tfoot>

3075	   A container for a set of footer rows for a table.

3077	   This element appears as a child element of <table> (Section 2.54).

3079	   Content model:

3081	   One or more <tr> elements (Section 2.61)

3083	2.57.1.  "anchor" Attribute

3085	   Document-wide unique identifier for the tfoot.

3087	2.58.  <th>

3089	   A cell in a table row.  When rendered, this will normally come out in
3090	   boldface; other than that, there is no difference between this and
3091	   the <td> element.

3093	   This element appears as a child element of <tr> (Section 2.61).

3095	   Content model:

3097	   Either:

3099	      In any order, but at least one of:

3101	      *  <artwork> elements (Section 2.5)

3103	      *  <dl> elements (Section 2.20)

3105	      *  <figure> elements (Section 2.25)

3107	      *  <ol> elements (Section 2.34)

3109	      *  <sourcecode> elements (Section 2.48)

3111	      *  <t> elements (Section 2.53)

3113	      *  <ul> elements (Section 2.63)

3115	   Or:

3117	      In any order:

3119	      *  Text

3121	      *  <bcp14> elements (Section 2.9)

3123	      *  <br> elements (Section 2.12)

3125	      *  <cref> elements (Section 2.16)

3127	      *  <em> elements (Section 2.22)

3129	      *  <eref> elements (Section 2.24)

3131	      *  <iref> elements (Section 2.27)

3133	      *  <relref> elements (Section 2.44)

3135	      *  <strong> elements (Section 2.50)

3137	      *  <sub> elements (Section 2.51)

3139	      *  <sup> elements (Section 2.52)

3141	      *  <tt> elements (Section 2.62)

3143	      *  <xref> elements (Section 2.66)

3145	2.58.1.  "align" Attribute

3147	   Controls whether the content of the cell appears left justified
3148	   (default), centered, or right justified.  Note that "center" or
3149	   "right" will probably only work well in cells with plain text; any
3150	   other elements might make the contents render badly.

3152	   Allowed values:

3154	   o  "left" (default)

3156	   o  "center"

3158	   o  "right"

3160	2.58.2.  "anchor" Attribute

3162	   Document-wide unique identifier for the row.

3164	2.58.3.  "colspan" Attribute

3166	   The number of columns that the cell is to span.  For example, setting
3167	   "colspan='3'" indicates that the cell occupies the same horizontal
3168	   space as three cells of a row without any "colspan" attributes.

3170	2.58.4.  "rowspan" Attribute

3172	   The number of rows that the cell is to span.  For example, setting
3173	   "rowspan='3'" indicates that the cell occupies the same vertical
3174	   space as three rows.

3176	2.59.  <thead>

3178	   A container for a set of header rows for a table.

3180	   This element appears as a child element of <table> (Section 2.54).

3182	   Content model:

3184	   One or more <tr> elements (Section 2.61)

3186	2.59.1.  "anchor" Attribute

3188	   Document-wide unique identifier for the thead.

3190	2.60.  <title>

3192	   Represents the document title.

3194	   When this element appears in the <front> element of the current
3195	   document, the title might also appear in page headers or footers.  If
3196	   it is long (~40 characters), the "abbrev" attribute can be used to
3197	   specify an abbreviated variant.

3199	   This element appears as a child element of <front> (Section 2.26).

3201	   Content model: only text content.

3203	2.60.1.  "abbrev" Attribute

3205	   Specifies an abbreviated variant of the document title.

3207	2.60.2.  "ascii" Attribute

3209	   The ASCII equivalent of the title.

3211	2.61.  <tr>

3213	   A row of a table.

3215	   This element appears as a child element of <tbody> (Section 2.55),
3216	   <tfoot> (Section 2.57), and <thead> (Section 2.59).

3218	   Content model:

3220	   In any order, but at least one of:

3222	   o  <td> elements (Section 2.56)

3224	   o  <th> elements (Section 2.58)

3226	2.61.1.  "anchor" Attribute

3228	   Document-wide unique identifier for the row.

3230	2.62.  <tt>

3232	   Causes the text to be displayed in a constant-width font.  This
3233	   element can be combined with other character formatting elements, and
3234	   the formatting will be additive.

3236	   This element appears as a child element of <annotation>
3237	   (Section 2.3), <blockquote> (Section 2.10), <cref> (Section 2.16),
3238	   <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
3239	   (Section 2.29), <name> (Section 2.32), <preamble> (Section 3.6),
3240	   <refcontent> (Section 2.39), <strong> (Section 2.50), <sub>
3241	   (Section 2.51), <sup> (Section 2.52), <t> (Section 2.53), <td>
3242	   (Section 2.56), and <th> (Section 2.58).

3244	   Content model:

3246	   In any order:

3248	   o  Text

3250	   o  <bcp14> elements (Section 2.9)

3252	   o  <cref> elements (Section 2.16)
3253	   o  <em> elements (Section 2.22)

3255	   o  <eref> elements (Section 2.24)

3257	   o  <iref> elements (Section 2.27)

3259	   o  <relref> elements (Section 2.44)

3261	   o  <strong> elements (Section 2.50)

3263	   o  <sub> elements (Section 2.51)

3265	   o  <sup> elements (Section 2.52)

3267	   o  <xref> elements (Section 2.66)

3269	2.63.  <ul>

3271	   An unordered list.  The labels on the items will be symbols picked by
3272	   the formatter.

3274	   This element appears as a child element of <abstract> (Section 2.1),
3275	   <aside> (Section 2.6), <blockquote> (Section 2.10), <dd>
3276	   (Section 2.18), <li> (Section 2.29), <note> (Section 2.33), <section>
3277	   (Section 2.46), <td> (Section 2.56), and <th> (Section 2.58).

3279	   Content model:

3281	   One or more <li> elements (Section 2.29)

3283	2.63.1.  "anchor" Attribute

3285	   Document-wide unique identifier for the list.

3287	2.63.2.  "empty" Attribute

3289	   Defines whether or not the label is empty. empty="true" indicates
3290	   that no label will be shown.

3292	   Allowed values:

3294	   o  "false" (default)

3296	   o  "true"

3298	2.63.3.  "spacing" Attribute

3300	   Defines whether or not there is a blank line between entries.
3301	   spacing="normal" indicates a single blank line, while
3302	   spacing="compact" indicates no space between.

3304	   Allowed values:

3306	   o  "normal" (default)

3308	   o  "compact"

3310	2.64.  <uri>

3312	   Contains a web address associated with the author.

3314	   The contents should be a valid URI; this most likely will be an
3315	   "http:" or "https:" URI.

3317	   This element appears as a child element of <address> (Section 2.2).

3319	   Content model: only text content.

3321	2.65.  <workgroup>

3323	   This element is used to specify the Working Group (IETF) or Research
3324	   Group (IRTF) from which the document originates, if any.  The
3325	   recommended format is the official name of the Working Group (with
3326	   some capitalization).

3328	   In Internet-Drafts, this is used in the upper left corner of the
3329	   boilerplate, replacing the "Network Working Group" string.
3330	   Formatting software can append the words "Working Group" or "Research
3331	   Group", depending on the "submissionType" property of the <rfc>
3332	   element (Section 2.45.12).

3334	   This element appears as a child element of <front> (Section 2.26).

3336	   Content model: only text content.

3338	2.66.  <xref>

3340	   A reference to an anchor in this document.  Formatters that have
3341	   links (such as HTML and PDF) are likely to render <xref> elements as
3342	   internal hyperlinks.  This element is useful for referring to
3343	   references in the "References" section, to specific sections of this
3344	   document, to specific figures, and so on.  The "target" attribute is
3345	   required.

3347	   This element appears as a child element of <annotation>
3348	   (Section 2.3), <blockquote> (Section 2.10), <c> (Section 3.1), <cref>
3349	   (Section 2.16), <dd> (Section 2.18), <dt> (Section 2.21), <em>
3350	   (Section 2.22), <li> (Section 2.29), <name> (Section 2.32),
3351	   <postamble> (Section 3.5), <preamble> (Section 3.6), <strong>
3352	   (Section 2.50), <sub> (Section 2.51), <sup> (Section 2.52), <t>
3353	   (Section 2.53), <td> (Section 2.56), <th> (Section 2.58), <tt>
3354	   (Section 2.62), and <ttcol> (Section 3.9).

3356	   Content model: only text content.

3358	2.66.1.  "format" Attribute

3360	   This attribute signals to formatters what the desired format of the
3361	   reference should be.  Formatters for document types that have linking
3362	   capability should wrap the displayed text in hyperlinks.

3364	   "counter"

3366	      The "derivedContent" attribute will contain just a counter.  This
3367	      is used for targets that are <section>, <figure>, <table>, or
3368	      items in an ordered list.  Using "format='counter'" where the
3369	      target is any other type of element is an error.

3371	      For example, with an input of:

3373	         <section anchor="overview">Protocol Overview</section>
3374	         . . .
3375	         See Section <xref target="overview" format="counter"/>
3376	         for an overview.

3378	      An HTML formatter might generate:

3380	      See Section <a href="#overview">1.7</a> for an overview.

3382	   "default"

3384	      If the element has no content, the "derivedContent" attribute will
3385	      contain a text fragment that describes the referenced part
3386	      completely, such as "XML" for a target that is a <reference>, or
3387	      "Section 2" or "Table 4" for a target to a non-reference.  (If the
3388	      element has content, the "derivedContent" attribute is filled with
3389	      the content.)

3391	      For example, with an input of:

3393	         <section anchor="overview">Protocol Overview</section>
3394	         . . .

3396	         See <xref target="overview"/> for an overview.

3398	      An HTML formatter might generate:

3400	      See <a href="#overview">Section 1.7</a> for an overview.

3402	   "none"

3404	      Deprecated.

3406	   "title"

3408	      If the target is a <reference> element, the "derivedContent"
3409	      attribute will contain the name of the reference, extracted from
3410	      the <title> child of the <front> child of the reference.  Or, if
3411	      the target element has a <name> child element, the
3412	      "derivedContent" attribute will contain the text content of that
3413	      <name> element concatenated with the text content of each
3414	      descendant node of <name> (that is, stripping out all of the XML
3415	      markup, leaving only the text).  Or, if the target element does
3416	      not contain a <name> child element, the "derivedContent" attribute
3417	      will contain the name of the "anchor" attribute of that element
3418	      with no other adornment.

3420	   Allowed values:

3422	   o  "default" (default)

3424	   o  "title"

3426	   o  "counter"

3428	   o  "none"

3430	2.66.2.  "pageno" Attribute

3432	   Deprecated.

3434	   Allowed values:

3436	   o  "true"

3438	   o  "false" (default)

3440	2.66.3.  "target" Attribute (Mandatory)

3442	   Identifies the document component being referenced.  The value needs
3443	   to match the value of the "anchor" attribute of an element in the
3444	   document; otherwise, it is an error.

3446	3.  Elements from v2 That Have Been Deprecated

3448	   This section lists the elements from v2 that have been deprecated.
3449	   Note that some elements in v3 have attributes from v2 that are
3450	   deprecated; those are not listed here.

3452	3.1.  <c>

3454	   Deprecated.  Instead, use <tr>, <td>, and <th>.

3456	   This element appears as a child element of <texttable> (Section 3.8).

3458	   Content model:

3460	   In any order:

3462	   o  Text

3464	   o  <bcp14> elements (Section 2.9)

3466	   o  <cref> elements (Section 2.16)

3468	   o  <em> elements (Section 2.22)

3470	   o  <eref> elements (Section 2.24)

3472	   o  <iref> elements (Section 2.27)

3474	   o  <spanx> elements (Section 3.7)

3476	   o  <strong> elements (Section 2.50)

3478	   o  <sub> elements (Section 2.51)

3480	   o  <sup> elements (Section 2.52)

3482	   o  <tt> elements (Section 2.62)

3484	   o  <xref> elements (Section 2.66)

3486	3.2.  <facsimile>

3488	   Deprecated.  The <email> element is a much more useful way to get in
3489	   touch with authors.

3491	   This element appears as a child element of <address> (Section 2.2).

3493	   Content model: only text content.

3495	3.3.  <format>

3497	   Deprecated.  If the goal is to provide a single URI for a reference,
3498	   use the "target" attribute in <reference> instead.

3500	   This element appears as a child element of <reference>
3501	   (Section 2.40).

3503	   Content model: this element does not have any contents.

3505	3.3.1.  "octets" Attribute

3507	   Deprecated.

3509	3.3.2.  "target" Attribute

3511	   Deprecated.

3513	3.3.3.  "type" Attribute (Mandatory)

3515	   Deprecated.

3517	3.4.  <list>

3519	   Deprecated.  Instead, use <dl> for list/@style "hanging"; <ul> for
3520	   list/@style "empty" or "symbols"; and <ol> for list/@style "letters",
3521	   "numbers", "counter", or "format".

3523	   This element appears as a child element of <t> (Section 2.53).

3525	   Content model:

3527	   One or more <t> elements (Section 2.53)

3529	3.4.1.  "counter" Attribute

3531	   Deprecated.  The functionality of this attribute has been replaced
3532	   with <ol>/@start.

3534	3.4.2.  "hangIndent" Attribute

3536	   Deprecated.  Use <dl> instead.

3538	3.4.3.  "style" Attribute

3540	   Deprecated.

3542	3.5.  <postamble>

3544	   Deprecated.  Instead, use a regular paragraph after the figure or
3545	   table.

3547	   This element appears as a child element of <figure> (Section 2.25)
3548	   and <texttable> (Section 3.8).

3550	   Content model:

3552	   In any order:

3554	   o  Text

3556	   o  <bcp14> elements (Section 2.9)

3558	   o  <cref> elements (Section 2.16)

3560	   o  <em> elements (Section 2.22)

3562	   o  <eref> elements (Section 2.24)

3564	   o  <iref> elements (Section 2.27)

3566	   o  <spanx> elements (Section 3.7)

3568	   o  <strong> elements (Section 2.50)

3570	   o  <sub> elements (Section 2.51)

3572	   o  <sup> elements (Section 2.52)

3574	   o  <tt> elements (Section 2.62)

3576	   o  <xref> elements (Section 2.66)

3578	3.6.  <preamble>

3580	   Deprecated.  Instead, use a regular paragraph before the figure or
3581	   table.

3583	   This element appears as a child element of <figure> (Section 2.25)
3584	   and <texttable> (Section 3.8).

3586	   Content model:

3588	   In any order:

3590	   o  Text

3592	   o  <bcp14> elements (Section 2.9)

3594	   o  <cref> elements (Section 2.16)

3596	   o  <em> elements (Section 2.22)

3598	   o  <eref> elements (Section 2.24)

3600	   o  <iref> elements (Section 2.27)

3602	   o  <spanx> elements (Section 3.7)

3604	   o  <strong> elements (Section 2.50)

3606	   o  <sub> elements (Section 2.51)

3608	   o  <sup> elements (Section 2.52)

3610	   o  <tt> elements (Section 2.62)

3612	   o  <xref> elements (Section 2.66)

3614	3.7.  <spanx>

3616	   Deprecated.

3618	   This element appears as a child element of <annotation>
3619	   (Section 2.3), <c> (Section 3.1), <postamble> (Section 3.5),
3620	   <preamble> (Section 3.6), and <t> (Section 2.53).

3622	   Content model: only text content.

3624	3.7.1.  "style" Attribute

3626	   Deprecated.  Instead of <spanx style="emph">, use <em>; instead of
3627	   <spanx style="strong">, use <strong>; instead of <spanx
3628	   style="verb">, use <tt>.

3630	3.7.2.  "xml:space" Attribute

3632	   Deprecated.

3634	   Allowed values:

3636	   o  "default"

3638	   o  "preserve" (default)

3640	3.8.  <texttable>

3642	   Deprecated.  Use <table> instead.

3644	   This element appears as a child element of <aside> (Section 2.6) and
3645	   <section> (Section 2.46).

3647	   Content model:

3649	   In this order:

3651	   1.  One optional <name> element (Section 2.32)

3653	   2.  One optional <preamble> element (Section 3.6)

3655	   3.  One or more <ttcol> elements (Section 3.9)

3657	   4.  Optional <c> elements (Section 3.1)

3659	   5.  One optional <postamble> element (Section 3.5)

3661	3.8.1.  "align" Attribute

3663	   Deprecated.

3665	   Allowed values:

3667	   o  "left"

3669	   o  "center" (default)
3670	   o  "right"

3672	3.8.2.  "anchor" Attribute

3674	   Deprecated.

3676	3.8.3.  "style" Attribute

3678	   Deprecated.

3680	3.8.4.  "suppress-title" Attribute

3682	   Deprecated.

3684	   Allowed values:

3686	   o  "true"

3688	   o  "false" (default)

3690	3.8.5.  "title" Attribute

3692	   Deprecated.

3694	3.9.  <ttcol>

3696	   Deprecated.  Instead, use <tr>, <td>, and <th>.

3698	   This element appears as a child element of <texttable> (Section 3.8).

3700	   Content model:

3702	   In any order:

3704	   o  Text

3706	   o  <cref> elements (Section 2.16)

3708	   o  <eref> elements (Section 2.24)

3710	   o  <iref> elements (Section 2.27)

3712	   o  <xref> elements (Section 2.66)

3714	3.9.1.  "align" Attribute

3716	   Deprecated.

3718	   Allowed values:

3720	   o  "left" (default)

3722	   o  "center"

3724	   o  "right"

3726	3.9.2.  "width" Attribute

3728	   Deprecated.

3730	3.10.  <vspace>

3732	   Deprecated.  In earlier versions of this format, <vspace> was often
3733	   used to get an extra blank line in a list element; in the v3
3734	   vocabulary, that can be done instead by using multiple <t> elements
3735	   inside the <li> element.  Other uses have no direct replacement.

3737	   This element appears as a child element of <t> (Section 2.53).

3739	   Content model: this element does not have any contents.

3741	3.10.1.  "blankLines" Attribute

3743	   Deprecated.

3745	4.  SVG

3747	   The discussion of the use of SVG can be found in [RFC7996].  This
3748	   element is part of the namespace "http://www.w3.org/2000/svg".

3750	5.  Use of CDATA Structures and Escaping

3752	   A common problem authors have with <artwork> and <sourcecode>
3753	   elements is that the XML processor returns errors if the text in the
3754	   artwork contains either the "&" or "<" character, or the string
3755	   "]]>".  To avoid these problems, the "&" and "<" characters may be
3756	   escaped using the strings "&amp;" and "&lt;", respectively; the "]]>"
3757	   string can be represented as "]]&gt;".  Alternatively, they may be
3758	   surrounded in a CDATA structure: "<![CDATA[]]>".  For example:

3760	   Desired output:
3761	      allowed-chars = "." | "," | "&" | "<" | ">" | "|"

3763	   Using escaping:
3764	   <sourcecode>
3765	      allowed-chars = "." | "," | "&amp;" | "&lt;" | "&gt;" | "|"
3766	   </sourcecode>

3768	   Using CDATA:
3769	   <sourcecode>
3770	   <![CDATA[   allowed-chars = "." | "," | "&" | "<" | ">" | "|"]]>
3771	   </sourcecode>

3773	   Using CDATA is not a panacea, but it does help prevent having to use
3774	   escapes in places where using escapes can cause other problems, such
3775	   as difficulty of inclusion from other documents.

3777	6.  Internationalization Considerations

3779	   This format is based on [XML] and thus does not have any issues
3780	   representing arbitrary Unicode [UNICODE] characters in text content.
3781	   The RFC Series Editor may restrict some of the characters that can be
3782	   used in a particular RFC; the rules for such restrictions are covered
3783	   in [RFC7997].

3785	7.  Security Considerations

3787	   The "name" attribute of the <artwork> element (Section 2.5.5) can be
3788	   used to derive a filename for saving to a local file system.
3789	   Trusting this kind of information without pre-processing is a known
3790	   security risk; see Section 4.3 of [RFC6266] for more information.

3792	   The "src" attribute of the <artwork> element can be used to read
3793	   files from the local system.  Processing tools must be careful to not
3794	   accept dangerous values for the filename, particularly those that
3795	   contain absolute references outside the current directory.

3797	   The "type" attribute of the <artwork> and <sourcecode> elements is
3798	   meant to encourage formatters to automatically extract known types of
3799	   content from an RFC or Internet-Draft.  While extraction is probably
3800	   safe, those tools might also think that they could further process
3801	   the extracted content, such as by rendering artwork or executing
3802	   code.  Doing so without first sanity-checking the extracted content
3803	   is clearly a terrible idea from a security perspective.  More
3804	   generally, a tool that is reading XML input needs to be suspicious of
3805	   any content that it intends to post-process.

3807	   When there is an external reference to a URL, a processor or renderer
3808	   should fetch the content into a sandbox and should have only a
3809	   localized impact on the document processing and rendering.

3811	   All security considerations related to XML processing are relevant as
3812	   well (see Section 7 of [RFC3470]).

3814	8.  IANA Considerations

3816	8.1.  Internet Media Type Registration

3818	   IANA maintains the registry of Internet Media Types [RFC6838] at
3819	   <https://www.iana.org/assignments/media-types>.

3821	   This document updates the specification for the Internet Media Type
3822	   "application/rfc+xml" from the one in [RFC7749].  The following has
3823	   been registered with IANA.

3825	   Type name:  application

3827	   Subtype name:  rfc+xml

3829	   Required parameters:  There are no required parameters.

3831	   Optional parameters:  "charset": This parameter has identical
3832	      semantics to the charset parameter of the "application/xml" Media
3833	      Type specified in Section 9.1 of [RFC7303].

3835	   Encoding considerations:  Identical to those of "application/xml" as
3836	      described in Section 9.1 of [RFC7303].

3838	   Security considerations:  As defined in Section 7.  In addition, as
3839	      this Media Type uses the "+xml" convention, it inherits the
3840	      security considerations described in Section 10 of [RFC7303].

3842	   Interoperability considerations:  Different implementations of this
3843	      format have had interoperability issues.  It is not expected that
3844	      publication of this application will cause those implementations
3845	      to be fixed.

3847	   Published specification:  This specification.

3849	   Applications that use this Media Type:  Applications that transform
3850	      xml2rfc to output representations such as plain text or HTML, plus
3851	      additional analysis tools.

3853	   Fragment identifier considerations:  The "anchor" attribute is used
3854	      for assigning document-wide unique identifiers that can be used as
3855	      shorthand pointers, as described in [XPOINTER].

3857	   Additional information:

3859	      Deprecated alias names for this type:  None

3861	      Magic number(s):  As specified for "application/xml" in [RFC7303].

3863	      File extension(s):  .xml or .rfcxml when disambiguation from other
3864	         XML files is needed

3866	      Macintosh file type code(s):  TEXT

3868	   Person & email address to contact for further information:  See the
3869	      Author's Address section of RFC 7991.

3871	   Intended usage:  COMMON

3873	   Restrictions on usage:  None

3875	   Author:  See the Author's Address section of RFC 7991.

3877	   Change controller:  RFC Series Editor (rse@rfc-editor.org)

3879	8.2.  Link Relation Registration

3881	   IANA has registered "convertedFrom" in the "Link Relation Types"
3882	   registry [LINKRELATIONS].

3884	   Relation Name: convertedFrom

3886	   Description: The document linked to was later converted to the
3887	   document that contains this link relation.  For example, an RFC can
3888	   have a link to the Internet-Draft that became the RFC; in that case,
3889	   the link relation would be "convertedFrom".

3891	   Reference: This document.

3893	   Notes: This relation is different than "predecessor-version" in that
3894	   "predecessor-version" is for items in a version control system.  It
3895	   is also different than "previous" in that this relation is used for
3896	   converted resources, not those that are part of a sequence of
3897	   resources.

3899	   Application Data: None

3901	9.  References

3903	9.1.  Normative References

3905	   [BCP14]          Bradner, S., "Key words for use in RFCs to Indicate
3906	                    Requirement Levels", BCP 14, RFC 2119, March 1997,
3907	                    <http://www.rfc-editor.org/info/bcp14>.

3909	   [RFC7991]        Hoffman, P., "The "xml2rfc" Version 3 Vocabulary",
3910	                    RFC 7991, DOI 10.17487/RFC7991, December 2016,
3911	                    <https://www.rfc-editor.org/info/rfc7991>.

3913	   [XML]            Bray, T., Paoli, J., Sperberg-McQueen, C., Maler,
3914	                    E., and F. Yergeau, "Extensible Markup Language
3915	                    (XML) 1.0 (Fifth Edition)", W3C Recommendation REC-
3916	                    xml-20081126, November 2008,
3917	                    <https://www.w3.org/TR/2008/REC-xml-20081126/>.

3919	                    Latest version available at
3920	                    <http://www.w3.org/TR/xml>.

3922	9.2.  Informative References

3924	   [IDGUIDE]        Housley, R., "Guidelines to Authors of Internet-
3925	                    Drafts", December 2010,
3926	                    <https://www.ietf.org/id-info/guidelines.html>.

3928	   [LINKRELATIONS]  IANA, "Link Relations", <https://www.iana.org/
3929	                    assignments/link-relations/link-relations.xhtml>.

3931	   [RFC2026]        Bradner, S., "The Internet Standards Process --
3932	                    Revision 3", BCP 9, RFC 2026, DOI 10.17487/RFC2026,
3933	                    October 1996,
3934	                    <https://www.rfc-editor.org/info/rfc2026>.

3936	   [RFC2397]        Masinter, L., "The "data" URL scheme", RFC 2397,
3937	                    DOI 10.17487/RFC2397, August 1998,
3938	                    <https://www.rfc-editor.org/info/rfc2397>.

3940	   [RFC2629]        Rose, M., "Writing I-Ds and RFCs using XML",
3941	                    RFC 2629, DOI 10.17487/RFC2629, June 1999,
3942	                    <https://www.rfc-editor.org/info/rfc2629>.

3944	   [RFC3339]        Klyne, G. and C. Newman, "Date and Time on the
3945	                    Internet: Timestamps", RFC 3339, DOI 10.17487/
3946	                    RFC3339, July 2002,
3947	                    <https://www.rfc-editor.org/info/rfc3339>.

3949	   [RFC3470]        Hollenbeck, S., Rose, M., and L. Masinter,
3950	                    "Guidelines for the Use of Extensible Markup
3951	                    Language (XML) within IETF Protocols", BCP 70,
3952	                    RFC 3470, DOI 10.17487/RFC3470, January 2003,
3953	                    <https://www.rfc-editor.org/info/rfc3470>.

3955	   [RFC3667]        Bradner, S., "IETF Rights in Contributions",
3956	                    RFC 3667, DOI 10.17487/RFC3667, February 2004,
3957	                    <https://www.rfc-editor.org/info/rfc3667>.

3959	   [RFC3966]        Schulzrinne, H., "The tel URI for Telephone
3960	                    Numbers", RFC 3966, DOI 10.17487/RFC3966,
3961	                    December 2004,
3962	                    <https://www.rfc-editor.org/info/rfc3966>.

3964	   [RFC3978]        Bradner, S., Ed., "IETF Rights in Contributions",
3965	                    RFC 3978, DOI 10.17487/RFC3978, March 2005,
3966	                    <https://www.rfc-editor.org/info/rfc3978>.

3968	   [RFC3986]        Berners-Lee, T., Fielding, R., and L. Masinter,
3969	                    "Uniform Resource Identifier (URI): Generic Syntax",
3970	                    STD 66, RFC 3986, DOI 10.17487/RFC3986,
3971	                    January 2005,
3972	                    <https://www.rfc-editor.org/info/rfc3986>.

3974	   [RFC5234]        Crocker, D., Ed. and P. Overell, "Augmented BNF for
3975	                    Syntax Specifications: ABNF", STD 68, RFC 5234,
3976	                    DOI 10.17487/RFC5234, January 2008,
3977	                    <https://www.rfc-editor.org/info/rfc5234>.

3979	   [RFC5378]        Bradner, S., Ed. and J. Contreras, Ed., "Rights
3980	                    Contributors Provide to the IETF Trust", BCP 78,
3981	                    RFC 5378, DOI 10.17487/RFC5378, November 2008,
3982	                    <https://www.rfc-editor.org/info/rfc5378>.

3984	   [RFC6068]        Duerst, M., Masinter, L., and J. Zawinski, "The
3985	                    'mailto' URI Scheme", RFC 6068, DOI 10.17487/
3986	                    RFC6068, October 2010,
3987	                    <https://www.rfc-editor.org/info/rfc6068>.

3989	   [RFC6266]        Reschke, J., "Use of the Content-Disposition Header
3990	                    Field in the Hypertext Transfer Protocol (HTTP)",
3991	                    RFC 6266, DOI 10.17487/RFC6266, June 2011,
3992	                    <https://www.rfc-editor.org/info/rfc6266>.

3994	   [RFC6838]        Freed, N., Klensin, J., and T. Hansen, "Media Type
3995	                    Specifications and Registration Procedures", BCP 13,
3996	                    RFC 6838, DOI 10.17487/RFC6838, January 2013,
3997	                    <https://www.rfc-editor.org/info/rfc6838>.

3999	   [RFC6949]        Flanagan, H. and N. Brownlee, "RFC Series Format
4000	                    Requirements and Future Development", RFC 6949,
4001	                    DOI 10.17487/RFC6949, May 2013,
4002	                    <https://www.rfc-editor.org/info/rfc6949>.

4004	   [RFC7303]        Thompson, H. and C. Lilley, "XML Media Types",
4005	                    RFC 7303, DOI 10.17487/RFC7303, July 2014,
4006	                    <https://www.rfc-editor.org/info/rfc7303>.

4008	   [RFC7322]        Flanagan, H. and S. Ginoza, "RFC Style Guide",
4009	                    RFC 7322, DOI 10.17487/RFC7322, September 2014,
4010	                    <https://www.rfc-editor.org/info/rfc7322>.

4012	   [RFC7669]        Levine, J., "Assigning Digital Object Identifiers to
4013	                    RFCs", RFC 7669, DOI 10.17487/RFC7669, October 2015,
4014	                    <https://www.rfc-editor.org/info/rfc7669>.

4016	   [RFC7749]        Reschke, J., "The "xml2rfc" Version 2 Vocabulary",
4017	                    RFC 7749, DOI 10.17487/RFC7749, February 2016,
4018	                    <https://www.rfc-editor.org/info/rfc7749>.

4020	   [RFC7841]        Halpern, J., Ed., Daigle, L., Ed., and O. Kolkman,
4021	                    Ed., "RFC Streams, Headers, and Boilerplates",
4022	                    RFC 7841, DOI 10.17487/RFC7841, May 2016,
4023	                    <https://www.rfc-editor.org/info/rfc7841>.

4025	   [RFC7996]        Brownlee, N., "SVG Drawings for RFCs: SVG 1.2 RFC",
4026	                    RFC 7996, DOI 10.17487/RFC7996, December 2016,
4027	                    <https://www.rfc-editor.org/info/rfc7996>.

4029	   [RFC7997]        Flanagan, H., Ed., "The Use of Non-ASCII Characters
4030	                    in RFCs", RFC 7997, DOI 10.17487/RFC7997,
4031	                    December 2016,
4032	                    <https://www.rfc-editor.org/info/rfc7997>.

4034	   [RFC7998]        Hoffman, P. and J. Hildebrand, ""xml2rfc" Version 3
4035	                    Preparation Tool Description", RFC 7998,
4036	                    DOI 10.17487/RFC7998, December 2016,
4037	                    <https://www.rfc-editor.org/info/rfc7998>.

4039	   [RNC]            Clark, J., "RELAX NG Compact Syntax", The
4040	                    Organization for the Advancement of Structured
4041	                    Information Standards (OASIS) , November 2002, <http
4042	                    s://www.oasis-open.org/committees/relax-ng/
4043	                    compact-20021121.html>.

4045	   [RNG]            ISO/IEC, "Information Technology - Document Schema
4046	                    Definition Languages (DSDL) - Part 2: Regular-
4047	                    Grammar-Based Validation - RELAX NG (Second
4048	                    Edition)", ISO/IEC 19757-2:2008(E), December 2008.

4050	                    A useful source of RNG-related information is
4051	                    <http://relaxng.org/>.

4053	   [TLP1.0]         IETF Trust, "Legal Provisions Relating to IETF
4054	                    Documents", November 2008, <http://trustee.ietf.org/
4055	                    license-info/IETF-TLP-1.htm>.

4057	   [TLP2.0]         IETF Trust, "Legal Provisions Relating to IETF
4058	                    Documents", February 2009, <http://trustee.ietf.org/
4059	                    license-info/IETF-TLP-2.htm>.

4061	   [TLP3.0]         IETF Trust, "Legal Provisions Relating to IETF
4062	                    Documents", September 2009, <http://
4063	                    trustee.ietf.org/license-info/IETF-TLP-3.htm>.

4065	   [TLP4.0]         IETF Trust, "Legal Provisions Relating to IETF
4066	                    Documents", December 2009, <http://trustee.ietf.org/
4067	                    license-info/IETF-TLP-4.htm>.

4069	   [TLP5.0]         IETF Trust, "Legal Provisions Relating to IETF
4070	                    Documents", March 2015, <http://trustee.ietf.org/
4071	                    license-info/IETF-TLP-5.htm>.

4073	   [UAX24]          The Unicode Consortium, "UAX #24: Unicode Script
4074	                    Property", <http://www.unicode.org/reports/tr24/>.

4076	   [UNICODE]        The Unicode Consortium, "The Unicode Standard",
4077	                    <http://www.unicode.org/versions/latest/>.

4079	   [USASCII]        American National Standards Institute, "Coded
4080	                    Character Set -- 7-bit American Standard Code for
4081	                    Information Interchange", ANSI X3.4, 1986.

4083	   [XInclude]       Marsh, J., Orchard, D., and D. Veillard, "XML
4084	                    Inclusions (XInclude) Version 1.0 (Second Edition)",
4085	                    W3C Recommendation REC-xinclude-20061115,
4086	                    November 2006, <https://www.w3.org/TR/xinclude/
4087	                    REC-xinclude-20061115/>.

4089	                    Latest version available at
4090	                    <http://www.w3.org/TR/xinclude/>.

4092	   [XPOINTER]       Grosso, P., Maler, E., Marsh, J., and N. Walsh,
4093	                    "XPointer Framework", W3C Recommendation REC-xptr-
4094	                    framework-20030325, March 2003, <http://www.w3.org/
4095	                    TR/2003/REC-xptr-framework-20030325/>.

4097	                    Latest version available at
4098	                    <http://www.w3.org/TR/xptr-framework/>.

4100	Appendix A.  Front-Page ("Boilerplate") Generation

4102	   The values listed here will be defined by the RFC Series Editor.
4103	   Those listed here are believed to be the current values in use.

4105	A.1.  The "ipr" Attribute

4107	   This attribute value can take a long list of values, each of which
4108	   describes an IPR policy for the document (Section 2.45.5).  The
4109	   values are not the result of a grand design, but they remain simply
4110	   for historic reasons.  Of these values, only a few are currently in
4111	   use; all others are supported by various tools for backwards
4112	   compatibility with old source files.

4114	      Note: Some variations of the boilerplate are selected based on the
4115	      document's date; therefore, it is important to specify the "year",
4116	      "month", and "day" attributes of the <date> element when archiving
4117	      the XML source of an Internet-Draft on the day of submission.

4119	   _Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION.  IF YOU
4120	   NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER._ For further information,
4121	   refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>.

4123	   For the current "Copyright Notice" text, the submissionType attribute
4124	   of the <rfc> element (Section 2.45.12) determines whether a statement
4125	   about "Code Components" is inserted (which is the case for the value
4126	   "IETF", which is the default).  Other values, such as "independent",
4127	   suppress this part of the text.

4129	A.1.1.  Current Values: "*trust200902"

4131	   The name for these values refers to version 2.0 of the IETF Trust's
4132	   "Legal Provisions Relating to IETF Documents", sometimes simply
4133	   called the "TLP", which went into effect on February 15, 2009
4134	   [TLP2.0].  Updates to the document were published on September 12,
4135	   2009 [TLP3.0] and on December 28, 2009 [TLP4.0], modifying the
4136	   license for code components (see
4137	   <http://trustee.ietf.org/license-info/> for further information).
4138	   The actual text is located in Section 6 ("Text to Be Included in IETF
4139	   Documents") of these documents.

4141	   The prep tool automatically produces the "correct" text, depending on
4142	   the document's date information (see above):

4144	   +----------+--------------------------------+
4145	   | TLP      | starting with publication date |
4146	   +----------+--------------------------------+
4147	   | [TLP3.0] | 2009-11-01                     |
4148	   | [TLP4.0] | 2010-04-01                     |
4149	   +----------+--------------------------------+

4151	      The TLP was again updated in March 2015 [TLP5.0], but the changes
4152	      made in that version do not affect the boilerplate text.

4154	A.1.1.1.  trust200902

4156	   This value should be used unless one of the more specific
4157	   "*trust200902" values is a better fit.  It produces the text in
4158	   Sections 6.a and 6.b of the TLP.

4160	A.1.1.2.  noModificationTrust200902

4162	   This produces the additional text from Section 6.c.i of the TLP:

4164	      This document may not be modified, and derivative works of it may
4165	      not be created, except to format it for publication as an RFC or
4166	      to translate it into languages other than English.

4168	      Note: this clause is incompatible with RFCs that are published on
4169	      the Standards Track.

4171	A.1.1.3.  noDerivativesTrust200902

4173	   This produces the additional text from Section 6.c.ii of the TLP:

4175	      This document may not be modified, and derivative works of it may
4176	      not be created, and it may not be published except as an Internet-
4177	      Draft.

4179	      Note: this clause is incompatible with RFCs.

4181	A.1.1.4.  pre5378Trust200902

4183	   This produces the additional text from Section 6.c.iii of the TLP,
4184	   frequently called the "pre-5378 escape clause" referring to changes
4185	   introduced in [RFC5378]:

4187	      This document may contain material from IETF Documents or IETF
4188	      Contributions published or made publicly available before November
4189	      10, 2008.  The person(s) controlling the copyright in some of this
4190	      material may not have granted the IETF Trust the right to allow
4191	      modifications of such material outside the IETF Standards Process.
4192	      Without obtaining an adequate license from the person(s)
4193	      controlling the copyright in such materials, this document may not
4194	      be modified outside the IETF Standards Process, and derivative
4195	      works of it may not be created outside the IETF Standards Process,
4196	      except to format it for publication as an RFC or to translate it
4197	      into languages other than English.

4199	   See Section 4 of
4200	   <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf> for further
4201	   information about when to use this value.

4203	      Note: this text appears under "Copyright Notice", unless the
4204	      document was published before November 2009, in which case it
4205	      appears under "Status of This Memo".

4207	A.1.2.  Historic Values

4209	A.1.2.1.  Historic Values: "*trust200811"

4211	   The attribute values "trust200811", "noModificationTrust200811", and
4212	   "noDerivativesTrust200811" are similar to their "trust200902"
4213	   counterparts, except that they use text specified in [TLP1.0].

4215	A.1.2.2.  Historic Values: "*3978"

4217	   The attribute values "full3978", "noModification3978", and
4218	   "noDerivatives3978" are similar to their counterparts above, except
4219	   that they use text specified in [RFC3978].

4221	A.1.2.3.  Historic Values: "*3667"

4223	   The attribute values "full3667", "noModification3667", and
4224	   "noDerivatives3667" are similar to their counterparts above, except
4225	   that they use text specified in [RFC3667].

4227	A.1.2.4.  Historic Values: "*2026"

4229	   The attribute values "full2026" and "noDerivativeWorks2026" are
4230	   similar to their counterparts above, except that they use text
4231	   specified in Section 10 of [RFC2026].

4233	   The special value "none" was also used back then; it denied the IETF
4234	   any rights beyond publication as an Internet-Draft.

4236	A.2.  The "submissionType" Attribute

4238	   The RFC Editor publishes documents from different "document streams",
4239	   of which the "IETF stream" is the most prominent.  Other streams are
4240	   the "Independent Submissions stream" (used for things such as
4241	   discussion of Internet-related technologies that are not part of the
4242	   IETF agenda), the "IAB stream" (Internet Architecture Board), and the
4243	   "IRTF stream" (Internet Research Task Force).

4245	   The values for the attribute are "IETF" (the default value),
4246	   "independent", "IAB", and "IRTF".

4248	   Historically, this attribute did not affect the final appearance of
4249	   RFCs, except for subtle differences in copyright notices.  Nowadays
4250	   (as of [RFC7841]), the stream name appears in the first line of the
4251	   front page, and it also affects the text in the "Status of This Memo"
4252	   section.

4254	   For current documents, setting the "submissionType" attribute will
4255	   have the following effect:

4257	   o  For RFCs, the stream name appears in the upper left corner of the
4258	      first page (in Internet-Drafts, this is either "Network Working
4259	      Group" or the value of the <workgroup> element).

4261	   o  For RFCs, it affects the whole "Status of This Memo" section (see
4262	      Section 3.2 of [RFC7841]).

4264	   o  For all RFCs and Internet-Drafts, it determines whether the
4265	      "Copyright Notice" section mentions the Copyright on Code
4266	      Components (see Section 6 of the TLP ("Text to Be Included in IETF
4267	      Documents")).

4269	A.3.  The "consensus" Attribute

4271	   For some of the publication streams (see Appendix A.2), the "Status
4272	   of This Memo" section depends on whether there was a consensus to
4273	   publish (again, see Section 3.4 of [RFC7841]).

4275	   The consensus attribute can be used to supply this information.  The
4276	   acceptable values are "true" (the default) and "false"; "yes" and
4277	   "no" from v2 are deprecated.

4279	   The effect of this value for the various streams is:

4281	   o  "independent": none.

4283	   o  "IAB": mention that there was an IAB consensus.

4285	   o  "IETF": mention that there was an IETF consensus.

4287	   o  "IRTF": mention that there was a research group consensus (where
4288	      the name of the research group is extracted from the <workgroup>
4289	      element).

4291	Appendix B.  The v3 Format and Processing Tools

4293	   This section describes topics that are specific to v3 processing
4294	   tools.  Note that there is some discussion of tools in the main body
4295	   of the document as well.  For example, some elements have
4296	   descriptions of how a processing tool might create output from the
4297	   element.

4299	   The expected design of the tools that will be used with v3 documents
4300	   includes:

4302	   o  A "prep tool" that takes a v3 document, makes many checks, adds
4303	      and changes many attribute values, and creates a file that is a
4304	      "prepared document".  The prepared document is a valid v3
4305	      document.  The prep tool is described in [RFC7998].

4307	      The prep tool is expected to have many modes:

4309	      *  RFC mode -- The mode used by the RFC Editor to process the
4310	         input from one of the RFC streams and to process XML produced
4311	         during the RFC editing process.  The restrictions on the
4312	         canonical XML for RFCs, as well as how the non-canonical
4313	         formats will look, are described at <https://
4314	         www.rfc-editor.org/rse/wiki/
4315	         doku.php?id=design:format-and-content-rfcs>.

4317	      *  Draft mode -- The mode used by the Internet-Draft submission
4318	         tool.  The restrictions for the XML from this mode will be
4319	         described later.

4321	      *  Diagnostic mode -- A mode that can be used by document authors
4322	         to look for errors or warnings before they submit their
4323	         documents for publication.

4325	      *  Consolidation mode -- Produces output where no external
4326	         resources are required to render the file output.  This
4327	         includes expanding the XInclude entities and DTD entities in
4328	         place, and changing all elements that have "src" attributes
4329	         with external links into either "data:" URI or content for the
4330	         element, as specified in [RFC7998].

4332	   o  Formatting tools that will create HTML, PDF, plain text, and
4333	      possibly other output formats.  These formatters will be created
4334	      by the IETF, but others can create such tools as well.  The IETF
4335	      tools are expected to take prepared documents as input.

4337	   There may also be processing tools that are meant to run on the
4338	   computers of authors.  These tools may be used to produce interim
4339	   versions of the non-canonical representations so that authors can see
4340	   how their XML might later be rendered, to create documents in
4341	   representations different than those supported by the RFC Editor, to
4342	   possibly create documents that are not meant to be Internet-Drafts or
4343	   RFCs, and to convert XML that has external information into XML that
4344	   has that external information included.

4346	   The prep tool is expected to have clear error reporting, giving more
4347	   context than just a line number.  For example, the error messages
4348	   should differentiate between errors in XML and those from the v3
4349	   format.

4351	   In v2, the grammar was specified as a DTD.  In v3, the grammar is
4352	   specified only as RELAX Next Generation (RNG).  This means that tools
4353	   need to work from the RNG, not from a DTD.  Some of the features of
4354	   the v3 grammar cannot be specified as a DTD.

4356	B.1.  Including External Text with XInclude

4358	   All tools for the v3 format are expected to support XInclude
4359	   [XInclude].  XInclude specifies a processing model and syntax for
4360	   general-purpose inclusion of information that is either on the
4361	   Internet or local to the user's computer.

4363	   In the v3 syntax, XInclude is expressed as the <xi:include> element.
4364	   To use this element, you need to include the "xi" namespace in the
4365	   <rfc> element; that is, you need to specify

4367	   xmlns:xi="http://www.w3.org/2001/XInclude"

4369	   as one of the attributes in the <rfc> element.

4371	   The most common way to use <xi:include> is to pull in references that
4372	   are already formed as XML.  Currently, this can be done from
4373	   xml2rfc.tools.ietf.org, but later this is expected to be from the RFC
4374	   Editor.  For example, if a document has three normative references,
4375	   all RFCs, the document might contain:

4377	   <references>
4378	       <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/
4379	          bibxml/reference.RFC.2119.xml"/>
4380	       <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/
4381	          bibxml/reference.RFC.4869.xml"/>
4382	       <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/
4383	          bibxml/reference.RFC.7169.xml"/>
4384	   </references>

4386	   <xi:include> can be used anywhere an XML element could be used (but
4387	   not where free text is used).  For example, if three Internet-Drafts
4388	   are all including a particular paragraph or section verbatim, that
4389	   text can be kept either in a file or somewhere on the web and can be
4390	   included with <xi:include>.  An example of pulling something from the
4391	   local disk would be:

4393	   <x:include href="file://home/chris/ietf/drafts/commontext.xml"/>

4395	   In general, XInclude should be used instead of ENTITY references and
4396	   XML Processing Instructions (PIs) that allow external inclusions.

4398	B.2.  Anchors and IDs

4400	   People writing and reading Internet-Drafts and RFCs often want to
4401	   make reference to specific locations in those documents.  In the case
4402	   of RFC authors, it is common to want to reference another part of
4403	   their document, such as "see Section 3.2 of this document."  Readers,
4404	   on the other hand, want to reference parts of documents that they
4405	   didn't write, such as "see Section 3.2 of RFC 6949."  The XML
4406	   vocabulary in this document attempts to support both sets of people.

4408	   Authors can leave anchors in a document that can later be used for
4409	   references with the "anchor" attribute.  Anchors can be included in
4410	   the numerous elements.  The author can then refer to that anchor in
4411	   the "target" attribute of the <xref> element.

4413	   Readers can refer to any element that has an "anchor" attribute by
4414	   that attribute.  Note, however, that most of the time, elements won't
4415	   have anchors.  In the common case, the reader wants to refer to an
4416	   element that does not have an "anchor" attribute, but that element
4417	   has a "pn" attribute.

4419	   Processing tools add the "pn" attribute to many elements during
4420	   processing.  This attribute and its value are automatically generated
4421	   by the tool if the attribute is not there; if the attribute is
4422	   already there, the tool may replace the value.

4424	B.2.1.  Overlapping Values

4426	   In the HTML representation of this XML vocabulary, both anchors and
4427	   "pn" attributes will be used in the "id" attributes of elements.
4428	   Thus, there can be no overlap between the names entered in "anchor"
4429	   attributes, in "slugifiedName" attributes, and those that are
4430	   generated for the "pn" attributes.  Also, there are some values for
4431	   the "anchor" values that are reserved for sections, and those
4432	   sections can only have those anchor values.

4434	   The following rules prevent this overlap:

4436	   o  "pn" for regular sections always has the format "s-nnn", where
4437	      "nnn" is the section number, or the appendix identifier (which
4438	      starts with a letter).  For example, this would be "s-2.1.3" for
4439	      Section 2.1.3 and "s-a" for Appendix A.  For the <abstract>
4440	      element, it is always "s-abstract".  For the <note> element, it is
4441	      always "s-note-nnn", where "nnn" is a sequential value.  For
4442	      sections in the <boilerplate> element, it is always
4443	      "s-boilerplate-nnn", where "nnn" is a sequential value.

4445	   o  "pn" for <references> elements has the format "s-nnn".  It is
4446	      important to note that "nnn" is a number, not letters, even though
4447	      the <references> appear in the back.  It is the number that is one
4448	      higher than the highest top-level section number in <middle>.  If
4449	      there are two or more <references>, "nnn" will include a dot as if
4450	      the <references> are a subsection of a section that is numbered
4451	      one higher than the highest top-level section number in <middle>.

4453	   o  "pn" for <figure> elements always has the format "f-nnn", where
4454	      "nnn" is the figure number.  For example, this would be "f-5" for
4455	      Figure 5.

4457	   o  "pn" for <iref> elements always has the format "i-ttt-nnn", where
4458	      "ttt" is the slugified item (plus a hyphen and the slugified
4459	      subitem if there is a subitem), and "nnn" is the instance of that
4460	      item/subitem pair.  For example, this would be "i-foo-1" for
4461	      "<iref item='foo'>" and "i-foo-bar-1" for "<iref item='foo'
4462	      subitem='bar'>".

4464	   o  "pn" for <table> elements always has the format "t-nnn", where
4465	      "nnn" is the table number.  For example, this would be "t-5" for
4466	      Table 5.

4468	   o  "pn" for all elements not listed above always has the format
4469	      "p-nnn-mmm", where "nnn" is the section number and "mmm" is the
4470	      relative position in the section.  For example, this would be
4471	      "p-2.1.3-7" for the seventh part number in Section 2.1.3.

4473	   o  "slugifiedName" always has the format "n-ttt", where "ttt" is the
4474	      text of the name after slugification.  For example, this would be
4475	      "n-protocol-overview" for the name "Protocol Overview".  The
4476	      actual conversions done in slugification will be specified at a
4477	      later time.

4479	   o  Anchors must never overlap with any of the above.  The easiest way
4480	      to assure that is to not pick an anchor name that starts with a
4481	      single letter followed by a hyphen.  If an anchor does overlap
4482	      with one of the types of names above, the processing tool will
4483	      reject the document.

4485	B.3.  Attributes Controlled by the Prep Tool

4487	   Many elements in the v3 vocabulary have new attributes whose role is
4488	   to hold values generated by the prep tool.  These attributes can
4489	   exist in documents that are input to the prep tool; however, any of
4490	   these attributes might be added, removed, or changed by the prep
4491	   tool.  Thus, it is explicitly unsafe for a document author to include
4492	   these attributes and expect that their values will survive processing
4493	   by the prep tool.

4495	   The attributes that are controlled by the prep tool are:

4497	   o  The "pn" attribute in any element -- The number for this item
4498	      within the section.  The numbering is shared with other elements
4499	      of a section.  The "pn" attribute is added to many block-level
4500	      elements inside sections.

4502	   o  <artwork> originalSrc -- This attribute is filled with the
4503	      original value of the "src" attribute if that attribute is removed
4504	      by the prep tool.

4506	   o  <figure> originalSrc -- This attribute is filled with the original
4507	      value of the "src" attribute if that attribute is removed by the
4508	      prep tool.

4510	   o  <name> "slugifiedName" attribute -- This attribute is filled with
4511	      a "slugified" version of the text in the element.  This attribute
4512	      can be used in the output formats for elements that have both
4513	      names and numbers.

4515	   o  <relref> "derivedLink" attribute -- This attribute is filled with
4516	      the link that is derived from combining the URI from the reference
4517	      and the relative part that is either a copy of the "relative"
4518	      attribute or a section number derived from the "section"
4519	      attribute.

4521	   o  <rfc> "expiresDate" attribute -- This attribute is filled with the
4522	      date that an Internet-Draft expires.  The date is in the format
4523	      yyyy-mm-dd.

4525	   o  <rfc> "mode" attribute -- This attribute is filled with a string
4526	      that indicates what mode the prep tool was in when it processed
4527	      the XML, such as whether it was processing a file to become an
4528	      Internet-Draft or an RFC.

4530	   o  <rfc> "scripts" attribute -- This attribute is filled with a list
4531	      of scripts needed to render this document.  The list is comma-
4532	      separated, with no spaces allowed.  The order is unimportant.  The
4533	      names come from [UAX24].  For example, if the document has Chinese
4534	      characters in it, the value might be "Common,Latin,Han".

4536	   o  <sourcecode> "originalSrc" attribute -- This attribute is filled
4537	      with the original value of the "src" attribute if that attribute
4538	      is removed by the prep tool.

4540	   o  <xref> "derivedContent" attribute -- This attribute is filled in
4541	      if there is no content in the <xref> element.  The value for this
4542	      attribute is based on the value in the "displayFormat" attribute.
4543	      Examples of how this value is filled can be found in
4544	      Section 2.66.1.

4546	   In addition, note that the contents of the <boilerplate> element are
4547	   controlled by the prep tool.

4549	Appendix C.  RELAX NG Schema

4551	   The following is the RELAX NG schema for the v3 format.

4553	   namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0"

4555	   # xml2rfc Version 3 grammar

4557	   rfc =
4558	     element rfc {
4559	       attribute xml:base { text }?,
4560	       attribute xml:lang { text }?,
4561	       attribute number { text }?,
4562	       [ a:defaultValue = "" ] attribute obsoletes { text }?,
4563	       [ a:defaultValue = "" ] attribute updates { text }?,
4564	       attribute category { text }?,
4565	       attribute mode { text }?,
4566	       [ a:defaultValue = "false" ]
4567	       attribute consensus { "no" | "yes" | "false" | "true" }?,
4568	       attribute seriesNo { text }?,
4569	       attribute ipr { text }?,
4570	       attribute iprExtract { xsd:IDREF }?,
4571	       [ a:defaultValue = "IETF" ]
4572	       attribute submissionType {
4573	         "IETF" | "IAB" | "IRTF" | "independent"
4574	       }?,
4575	       attribute docName { text }?,
4576	       [ a:defaultValue = "false" ]
4577	       attribute sortRefs { "true" | "false" }?,
4578	       [ a:defaultValue = "true" ]
4579	       attribute symRefs { "true" | "false" }?,
4580	       [ a:defaultValue = "true" ]
4581	       attribute tocInclude { "true" | "false" }?,
4582	       [ a:defaultValue = "3" ] attribute tocDepth { text }?,
4583	       attribute prepTime { text }?,
4584	       [ a:defaultValue = "true" ]
4585	       attribute indexInclude { "true" | "false" }?,
4586	       attribute version { text }?,
4587	       [ a:defaultValue = "Common,Latin" ] attribute scripts { text }?,
4588	       attribute expiresDate { text }?,
4589	       link*,
4590	       front,
4591	       middle,
4592	       back?
4593	     }

4595	   link =
4596	     element link {
4597	       attribute xml:base { text }?,
4598	       attribute xml:lang { text }?,
4599	       attribute href { text },
4600	       attribute rel { text }?
4601	     }

4603	   front =
4604	     element front {
4605	       attribute xml:base { text }?,
4606	       attribute xml:lang { text }?,
4607	       title,
4608	       seriesInfo*,
4609	       author+,
4610	       date?,
4611	       area*,
4612	       workgroup*,
4613	       keyword*,
4614	       abstract?,
4615	       note*,
4616	       boilerplate?
4617	     }

4619	   title =
4620	     element title {
4621	       attribute xml:base { text }?,
4622	       attribute xml:lang { text }?,
4623	       attribute abbrev { text }?,
4624	       attribute ascii { text }?,
4625	       text
4626	     }

4628	   author =
4629	     element author {
4630	       attribute xml:base { text }?,
4631	       attribute xml:lang { text }?,
4632	       attribute initials { text }?,
4633	       attribute asciiInitials { text }?,
4634	       attribute surname { text }?,
4635	       attribute asciiSurname { text }?,
4636	       attribute fullname { text }?,
4637	       attribute role { "editor" }?,
4638	       attribute asciiFullname { text }?,
4639	       organization?,
4640	       address?
4641	     }

4643	   organization =
4644	     element organization {
4645	       attribute xml:base { text }?,
4646	       attribute xml:lang { text }?,
4647	       attribute abbrev { text }?,
4648	       attribute ascii { text }?,
4649	       text
4650	     }

4652	   address =
4653	     element address {
4654	       attribute xml:base { text }?,
4655	       attribute xml:lang { text }?,
4656	       postal?,
4657	       phone?,
4658	       facsimile?,
4659	       email?,
4660	       uri?
4661	     }

4663	   postal =
4664	     element postal {
4665	       attribute xml:base { text }?,
4666	       attribute xml:lang { text }?,
4667	       ((city | code | country | region | street)* | postalLine+)
4668	     }

4670	   street =
4671	     element street {
4672	       attribute xml:base { text }?,
4673	       attribute xml:lang { text }?,
4674	       attribute ascii { text }?,
4675	       text
4676	     }

4678	   city =
4679	     element city {
4680	       attribute xml:base { text }?,
4681	       attribute xml:lang { text }?,
4682	       attribute ascii { text }?,
4683	       text
4684	     }

4686	   region =
4687	     element region {
4688	       attribute xml:base { text }?,
4689	       attribute xml:lang { text }?,
4690	       attribute ascii { text }?,
4691	       text
4692	     }

4694	   code =
4695	     element code {
4696	       attribute xml:base { text }?,
4697	       attribute xml:lang { text }?,
4698	       attribute ascii { text }?,
4699	       text
4700	     }

4702	   country =
4703	     element country {
4704	       attribute xml:base { text }?,
4705	       attribute xml:lang { text }?,
4706	       attribute ascii { text }?,
4707	       text
4708	     }

4710	   postalLine =
4711	     element postalLine {
4712	       attribute xml:base { text }?,
4713	       attribute xml:lang { text }?,
4714	       attribute ascii { text }?,
4715	       text
4716	     }

4718	   phone =
4719	     element phone {
4720	       attribute xml:base { text }?,
4721	       attribute xml:lang { text }?,
4722	       text
4723	     }

4725	   facsimile =
4726	     element facsimile {
4727	       attribute xml:base { text }?,
4728	       attribute xml:lang { text }?,
4729	       text
4730	     }

4732	   email =
4733	     element email {
4734	       attribute xml:base { text }?,
4735	       attribute xml:lang { text }?,
4736	       attribute ascii { text }?,
4737	       text
4738	     }

4740	   uri =
4741	     element uri {
4742	       attribute xml:base { text }?,
4743	       attribute xml:lang { text }?,
4744	       text
4745	     }

4747	   date =
4748	     element date {
4749	       attribute xml:base { text }?,
4750	       attribute xml:lang { text }?,
4751	       attribute day { text }?,
4752	       attribute month { text }?,
4753	       attribute year { text }?,
4754	       empty
4755	     }

4757	   area =
4758	     element area {
4759	       attribute xml:base { text }?,
4760	       attribute xml:lang { text }?,
4761	       text
4762	     }

4764	   workgroup =
4765	     element workgroup {
4766	       attribute xml:base { text }?,
4767	       attribute xml:lang { text }?,
4768	       text
4769	     }

4771	   keyword =
4772	     element keyword {
4773	       attribute xml:base { text }?,
4774	       attribute xml:lang { text }?,
4775	       text
4776	     }

4778	   abstract =
4779	     element abstract {
4780	       attribute xml:base { text }?,
4781	       attribute xml:lang { text }?,
4782	       attribute anchor { xsd:ID }?,
4783	       attribute pn { text }?,
4784	       (dl | ol | t | ul)+
4785	     }

4787	   note =
4788	     element note {
4789	       attribute xml:base { text }?,
4790	       attribute xml:lang { text }?,
4791	       attribute title { text }?,
4792	       attribute pn { text }?,
4793	       [ a:defaultValue = "false" ]
4794	       attribute removeInRFC { "true" | "false" }?,
4795	       name?,
4796	       (dl | ol | t | ul)+
4797	     }

4799	   boilerplate =
4800	     element boilerplate {
4801	       attribute xml:base { text }?,
4802	       attribute xml:lang { text }?,
4803	       section+
4804	     }

4806	   middle =
4807	     element middle {
4808	       attribute xml:base { text }?,
4809	       attribute xml:lang { text }?,
4810	       section+
4811	     }

4813	   section =
4814	     element section {
4815	       attribute xml:base { text }?,
4816	       attribute xml:lang { text }?,
4817	       attribute anchor { xsd:ID }?,
4818	       attribute pn { text }?,
4819	       attribute title { text }?,
4820	       [ a:defaultValue = "true" ]
4821	       attribute numbered { "true" | "false" }?,
4822	       [ a:defaultValue = "default" ]
4823	       attribute toc { "include" | "exclude" | "default" }?,
4824	       [ a:defaultValue = "false" ]
4825	       attribute removeInRFC { "true" | "false" }?,
4826	       name?,
4827	       (artwork
4828	        | aside
4829	        | blockquote
4830	        | dl
4831	        | figure
4832	        | iref
4833	        | ol
4834	        | sourcecode
4835	        | t
4836	        | table
4837	        | texttable
4838	        | ul)*,
4839	       section*
4840	     }

4842	   name =
4843	     element name {
4844	       attribute xml:base { text }?,
4845	       attribute xml:lang { text }?,
4846	       attribute slugifiedName { text }?,
4847	       (text | cref | eref | relref | tt | xref)*
4848	     }

4850	   t =
4851	     element t {
4852	       attribute xml:base { text }?,
4853	       attribute xml:lang { text }?,
4854	       attribute anchor { xsd:ID }?,
4855	       attribute pn { text }?,
4856	       attribute hangText { text }?,
4857	       [ a:defaultValue = "false" ]
4858	       attribute keepWithNext { "false" | "true" }?,
4859	       [ a:defaultValue = "false" ]
4860	       attribute keepWithPrevious { "false" | "true" }?,
4861	       (text
4862	        | bcp14
4863	        | cref
4864	        | em
4865	        | eref
4866	        | iref
4867	        | \list
4868	        | relref
4869	        | spanx
4870	        | strong
4871	        | sub
4872	        | sup
4873	        | tt
4874	        | vspace
4875	        | xref)*
4876	     }

4878	   aside =
4879	     element aside {
4880	       attribute xml:base { text }?,
4881	       attribute xml:lang { text }?,
4882	       attribute anchor { xsd:ID }?,
4883	       attribute pn { text }?,
4884	       (artwork | dl | figure | iref | \list | ol | t | table | ul)*
4885	     }

4887	   blockquote =
4888	     element blockquote {
4889	       attribute xml:base { text }?,
4890	       attribute xml:lang { text }?,
4891	       attribute anchor { xsd:ID }?,
4892	       attribute pn { text }?,
4893	       attribute cite { text }?,
4894	       attribute quotedFrom { text }?,
4895	       ((artwork | dl | figure | ol | sourcecode | t | ul)+
4896	        | (text
4897	           | bcp14
4898	           | cref
4899	           | em
4900	           | eref
4901	           | iref
4902	           | relref
4903	           | strong
4904	           | sub
4905	           | sup
4906	           | tt
4907	           | xref)+)
4908	     }

4910	   \list =
4911	     element list {
4912	       attribute xml:base { text }?,
4913	       attribute xml:lang { text }?,
4914	       [ a:defaultValue = "empty" ] attribute style { text }?,
4915	       attribute hangIndent { text }?,
4916	       attribute counter { text }?,
4917	       attribute pn { text }?,
4918	       t+
4919	     }

4921	   ol =
4922	     element ol {
4923	       attribute xml:base { text }?,
4924	       attribute xml:lang { text }?,
4925	       attribute anchor { xsd:ID }?,
4926	       [ a:defaultValue = "1" ] attribute type { text }?,
4927	       [ a:defaultValue = "1" ] attribute start { text }?,
4928	       attribute group { text }?,
4929	       [ a:defaultValue = "normal" ]
4930	       attribute spacing { "normal" | "compact" }?,
4931	       attribute pn { text }?,
4932	       li+
4933	     }

4935	   ul =
4936	     element ul {
4937	       attribute xml:base { text }?,
4938	       attribute xml:lang { text }?,
4939	       attribute anchor { xsd:ID }?,
4940	       [ a:defaultValue = "normal" ]
4941	       attribute spacing { "normal" | "compact" }?,
4942	       ([ a:defaultValue = "false" ]
4943	        attribute empty { "false" | "true" },
4944	        attribute pn { text }?)?,
4945	       li+
4946	     }

4948	   li =
4949	     element li {
4950	       attribute xml:base { text }?,
4951	       attribute xml:lang { text }?,
4952	       attribute anchor { xsd:ID }?,
4953	       attribute pn { text }?,
4954	       ((artwork | dl | figure | ol | sourcecode | t | ul)+
4955	        | (text
4956	           | bcp14
4957	           | cref
4958	           | em
4959	           | eref
4960	           | iref
4961	           | relref
4962	           | strong
4963	           | sub
4964	           | sup
4965	           | tt
4966	           | xref)+)
4967	     }

4969	   dl =
4970	     element dl {
4971	       attribute xml:base { text }?,
4972	       attribute xml:lang { text }?,
4973	       attribute anchor { xsd:ID }?,
4974	       [ a:defaultValue = "normal" ]
4975	       attribute spacing { "normal" | "compact" }?,
4976	       [ a:defaultValue = "true" ]
4977	       attribute hanging { "false" | "true" }?,
4978	       attribute pn { text }?,
4979	       (dt, dd)+
4980	     }

4982	   dt =
4983	     element dt {
4984	       attribute xml:base { text }?,
4985	       attribute xml:lang { text }?,
4986	       attribute anchor { xsd:ID }?,
4987	       attribute pn { text }?,
4988	       (text
4989	        | bcp14
4990	        | cref
4991	        | em
4992	        | eref
4993	        | iref
4994	        | relref
4995	        | strong
4996	        | sub
4997	        | sup
4998	        | tt
4999	        | xref)*

5001	     }

5003	   dd =
5004	     element dd {
5005	       attribute xml:base { text }?,
5006	       attribute xml:lang { text }?,
5007	       attribute anchor { xsd:ID }?,
5008	       attribute pn { text }?,
5009	       ((artwork | dl | figure | ol | sourcecode | t | ul)+
5010	        | (text
5011	           | bcp14
5012	           | cref
5013	           | em
5014	           | eref
5015	           | iref
5016	           | relref
5017	           | strong
5018	           | sub
5019	           | sup
5020	           | tt
5021	           | xref)+)
5022	     }

5024	   xref =
5025	     element xref {
5026	       attribute xml:base { text }?,
5027	       attribute xml:lang { text }?,
5028	       attribute target { xsd:IDREF },
5029	       [ a:defaultValue = "false" ]
5030	       attribute pageno { "true" | "false" }?,
5031	       [ a:defaultValue = "default" ]
5032	       attribute format { "default" | "title" | "counter" | "none" }?,
5033	       attribute derivedContent { text }?,
5034	       text
5035	     }

5037	   relref =
5038	     element relref {
5039	       attribute xml:base { text }?,
5040	       attribute xml:lang { text }?,
5041	       attribute target { xsd:IDREF },
5042	       [ a:defaultValue = "of" ]
5043	       attribute displayFormat { "of" | "comma" | "parens" | "bare" }?,
5044	       attribute section { text },
5045	       attribute relative { text }?,
5046	       attribute derivedLink { text }?,
5047	       text
5048	     }

5050	   eref =
5051	     element eref {
5052	       attribute xml:base { text }?,
5053	       attribute xml:lang { text }?,
5054	       attribute target { text },
5055	       text
5056	     }

5058	   iref =
5059	     element iref {
5060	       attribute xml:base { text }?,
5061	       attribute xml:lang { text }?,
5062	       attribute item { text },
5063	       [ a:defaultValue = "" ] attribute subitem { text }?,
5064	       [ a:defaultValue = "false" ]
5065	       attribute primary { "true" | "false" }?,
5066	       attribute pn { text }?,
5067	       empty
5068	     }

5070	   cref =
5071	     element cref {
5072	       attribute xml:base { text }?,
5073	       attribute xml:lang { text }?,
5074	       attribute anchor { xsd:ID }?,
5075	       attribute source { text }?,
5076	       [ a:defaultValue = "true" ]
5077	       attribute display { "true" | "false" }?,
5078	       (text | em | eref | relref | strong | sub | sup | tt | xref)*
5079	     }

5081	   tt =
5082	     element tt {
5083	       attribute xml:base { text }?,
5084	       attribute xml:lang { text }?,
5085	       (text
5086	        | bcp14
5087	        | cref
5088	        | em
5089	        | eref
5090	        | iref
5091	        | relref
5092	        | strong
5093	        | sub
5094	        | sup
5095	        | xref)*
5096	     }

5098	   strong =
5099	     element strong {
5100	       attribute xml:base { text }?,
5101	       attribute xml:lang { text }?,
5102	       (text
5103	        | bcp14
5104	        | cref
5105	        | em
5106	        | eref
5107	        | iref
5108	        | relref
5109	        | sub
5110	        | sup
5111	        | tt
5112	        | xref)*
5113	     }

5115	   em =
5116	     element em {
5117	       attribute xml:base { text }?,
5118	       attribute xml:lang { text }?,
5119	       (text
5120	        | bcp14
5121	        | cref
5122	        | eref
5123	        | iref
5124	        | relref
5125	        | strong
5126	        | sub
5127	        | sup
5128	        | tt
5129	        | xref)*
5130	     }

5132	   sub =
5133	     element sub {
5134	       attribute xml:base { text }?,
5135	       attribute xml:lang { text }?,
5136	       (text
5137	        | bcp14
5138	        | cref
5139	        | em
5140	        | eref
5141	        | iref
5142	        | relref
5143	        | strong
5144	        | tt
5145	        | xref)*

5147	     }

5149	   sup =
5150	     element sup {
5151	       attribute xml:base { text }?,
5152	       attribute xml:lang { text }?,
5153	       (text
5154	        | bcp14
5155	        | cref
5156	        | em
5157	        | eref
5158	        | iref
5159	        | relref
5160	        | strong
5161	        | tt
5162	        | xref)*
5163	     }

5165	   spanx =
5166	     element spanx {
5167	       attribute xml:base { text }?,
5168	       attribute xml:lang { text }?,
5169	       [ a:defaultValue = "preserve" ]
5170	       attribute xml:space { "default" | "preserve" }?,
5171	       [ a:defaultValue = "emph" ] attribute style { text }?,
5172	       text
5173	     }

5175	   vspace =
5176	     element vspace {
5177	       attribute xml:base { text }?,
5178	       attribute xml:lang { text }?,
5179	       [ a:defaultValue = "0" ] attribute blankLines { text }?,
5180	       empty
5181	     }

5183	   figure =
5184	     element figure {
5185	       attribute xml:base { text }?,
5186	       attribute xml:lang { text }?,
5187	       attribute anchor { xsd:ID }?,
5188	       attribute pn { text }?,
5189	       [ a:defaultValue = "" ] attribute title { text }?,
5190	       [ a:defaultValue = "false" ]
5191	       attribute suppress-title { "true" | "false" }?,
5192	       attribute src { text }?,
5193	       attribute originalSrc { text }?,
5194	       [ a:defaultValue = "left" ]
5195	       attribute align { "left" | "center" | "right" }?,
5196	       [ a:defaultValue = "" ] attribute alt { text }?,
5197	       [ a:defaultValue = "" ] attribute width { text }?,
5198	       [ a:defaultValue = "" ] attribute height { text }?,
5199	       name?,
5200	       iref*,
5201	       preamble?,
5202	       (artwork | sourcecode)+,
5203	       postamble?
5204	     }

5206	   table =
5207	     element table {
5208	       attribute xml:base { text }?,
5209	       attribute xml:lang { text }?,
5210	       attribute anchor { xsd:ID }?,
5211	       attribute pn { text }?,
5212	       name?,
5213	       iref*,
5214	       thead?,
5215	       tbody+,
5216	       tfoot?
5217	     }

5219	   preamble =
5220	     element preamble {
5221	       attribute xml:base { text }?,
5222	       attribute xml:lang { text }?,
5223	       (text
5224	        | bcp14
5225	        | cref
5226	        | em
5227	        | eref
5228	        | iref
5229	        | relref
5230	        | spanx
5231	        | strong
5232	        | sub
5233	        | sup
5234	        | tt
5235	        | xref)*
5236	     }

5238	   artwork =
5239	     element artwork {
5240	       attribute xml:base { text }?,
5241	       attribute xml:lang { text }?,
5242	       attribute anchor { xsd:ID }?,
5243	       attribute pn { text }?,
5244	       attribute xml:space { text }?,
5245	       [ a:defaultValue = "" ] attribute name { text }?,
5246	       [ a:defaultValue = "" ] attribute type { text }?,
5247	       attribute src { text }?,
5248	       [ a:defaultValue = "left" ]
5249	       attribute align { "left" | "center" | "right" }?,
5250	       [ a:defaultValue = "" ] attribute alt { text }?,
5251	       [ a:defaultValue = "" ] attribute width { text }?,
5252	       [ a:defaultValue = "" ] attribute height { text }?,
5253	       attribute originalSrc { text }?,
5254	       (text* | svg)
5255	     }
5256	   # TODO: replace with link to RSE site, or provide an inline version
5257	   include "svg.rnc"

5259	   sourcecode =
5260	     element sourcecode {
5261	       attribute xml:base { text }?,
5262	       attribute xml:lang { text }?,
5263	       attribute anchor { xsd:ID }?,
5264	       attribute pn { text }?,
5265	       [ a:defaultValue = "" ] attribute name { text }?,
5266	       [ a:defaultValue = "" ] attribute type { text }?,
5267	       attribute src { text }?,
5268	       attribute originalSrc { text }?,
5269	       text
5270	     }

5272	   thead =
5273	     element thead {
5274	       attribute xml:base { text }?,
5275	       attribute xml:lang { text }?,
5276	       attribute anchor { xsd:ID }?,
5277	       tr+
5278	     }

5280	   tbody =
5281	     element tbody {
5282	       attribute xml:base { text }?,
5283	       attribute xml:lang { text }?,
5284	       attribute anchor { xsd:ID }?,
5285	       tr+
5286	     }

5288	   tfoot =
5289	     element tfoot {
5290	       attribute xml:base { text }?,
5291	       attribute xml:lang { text }?,
5292	       attribute anchor { xsd:ID }?,
5293	       tr+
5294	     }

5296	   tr =
5297	     element tr {
5298	       attribute xml:base { text }?,
5299	       attribute xml:lang { text }?,
5300	       attribute anchor { xsd:ID }?,
5301	       (td | th)+
5302	     }

5304	   td =
5305	     element td {
5306	       attribute xml:base { text }?,
5307	       attribute xml:lang { text }?,
5308	       attribute anchor { xsd:ID }?,
5309	       [ a:defaultValue = "0" ] attribute colspan { text }?,
5310	       [ a:defaultValue = "0" ] attribute rowspan { text }?,
5311	       [ a:defaultValue = "left" ]
5312	       attribute align { "left" | "center" | "right" }?,
5313	       ((artwork | dl | figure | ol | sourcecode | t | ul)+
5314	        | (text
5315	           | bcp14
5316	           | br
5317	           | cref
5318	           | em
5319	           | eref
5320	           | iref
5321	           | relref
5322	           | strong
5323	           | sub
5324	           | sup
5325	           | tt
5326	           | xref)*)
5327	     }

5329	   th =
5330	     element th {
5331	       attribute xml:base { text }?,
5332	       attribute xml:lang { text }?,
5333	       attribute anchor { xsd:ID }?,
5334	       [ a:defaultValue = "0" ] attribute colspan { text }?,
5335	       [ a:defaultValue = "0" ] attribute rowspan { text }?,
5336	       [ a:defaultValue = "left" ]
5337	       attribute align { "left" | "center" | "right" }?,
5338	       ((artwork | dl | figure | ol | sourcecode | t | ul)+
5339	        | (text
5340	           | bcp14
5341	           | br
5342	           | cref
5343	           | em
5344	           | eref
5345	           | iref
5346	           | relref
5347	           | strong
5348	           | sub
5349	           | sup
5350	           | tt
5351	           | xref)*)
5352	     }

5354	   postamble =
5355	     element postamble {
5356	       attribute xml:base { text }?,
5357	       attribute xml:lang { text }?,
5358	       (text | cref | eref | iref | spanx | xref)*
5359	     }

5361	   texttable =
5362	     element texttable {
5363	       attribute xml:base { text }?,
5364	       attribute xml:lang { text }?,
5365	       attribute anchor { xsd:ID }?,
5366	       [ a:defaultValue = "" ] attribute title { text }?,
5367	       [ a:defaultValue = "false" ]
5368	       attribute suppress-title { "true" | "false" }?,
5369	       [ a:defaultValue = "center" ]
5370	       attribute align { "left" | "center" | "right" }?,
5371	       [ a:defaultValue = "full" ]
5372	       attribute style { "all" | "none" | "headers" | "full" }?,
5373	       name?,
5374	       preamble?,
5375	       ttcol+,
5376	       c*,
5377	       postamble?
5378	     }

5380	   ttcol =
5381	     element ttcol {
5382	       attribute xml:base { text }?,
5383	       attribute xml:lang { text }?,
5384	       attribute width { text }?,
5385	       [ a:defaultValue = "left" ]
5386	       attribute align { "left" | "center" | "right" }?,
5387	       (cref | eref | iref | xref | text)*
5388	     }

5390	   c =
5391	     element c {
5392	       attribute xml:base { text }?,
5393	       attribute xml:lang { text }?,
5394	       (text | cref | eref | iref | spanx | xref)*
5395	     }

5397	   bcp14 =
5398	     element bcp14 {
5399	       attribute xml:base { text }?,
5400	       attribute xml:lang { text }?,
5401	       text
5402	     }

5404	   br =
5405	     element br {
5406	       attribute xml:base { text }?,
5407	       attribute xml:lang { text }?,
5408	       empty
5409	     }

5411	   back =
5412	     element back {
5413	       attribute xml:base { text }?,
5414	       attribute xml:lang { text }?,
5415	       displayreference*,
5416	       references*,
5417	       section*
5418	     }

5420	   displayreference =
5421	     element displayreference {
5422	       attribute xml:base { text }?,
5423	       attribute xml:lang { text }?,
5424	       attribute target { xsd:IDREF },
5425	       attribute to { text }
5426	     }

5428	   references =
5429	     element references {
5430	       attribute xml:base { text }?,
5431	       attribute xml:lang { text }?,
5432	       attribute pn { text }?,
5433	       attribute anchor { xsd:ID }?,
5434	       attribute title { text }?,
5435	       name?,
5436	       (reference | referencegroup)*
5437	     }

5439	   reference =
5440	     element reference {
5441	       attribute xml:base { text }?,
5442	       attribute xml:lang { text }?,
5443	       attribute anchor { xsd:ID },
5444	       attribute target { text }?,
5445	       [ a:defaultValue = "true" ]
5446	       attribute quoteTitle { "true" | "false" }?,
5447	       front,
5448	       (annotation | format | refcontent | seriesInfo)*
5449	     }

5451	   referencegroup =
5452	     element referencegroup {
5453	       attribute xml:base { text }?,
5454	       attribute xml:lang { text }?,
5455	       attribute anchor { xsd:ID },
5456	       reference+
5457	     }

5459	   seriesInfo =
5460	     element seriesInfo {
5461	       attribute xml:base { text }?,
5462	       attribute xml:lang { text }?,
5463	       attribute name { text },
5464	       attribute value { text },
5465	       attribute asciiName { text }?,
5466	       attribute asciiValue { text }?,
5467	       attribute status { text }?,
5468	       [ a:defaultValue = "IETF" ]
5469	       attribute stream { "IETF" | "IAB" | "IRTF" | "independent" }?,
5470	       empty
5471	     }

5473	   format =
5474	     element format {
5475	       attribute xml:base { text }?,
5476	       attribute xml:lang { text }?,
5477	       attribute target { text }?,
5478	       attribute type { text },
5479	       attribute octets { text }?,
5480	       empty
5481	     }

5483	   annotation =
5484	     element annotation {
5485	       attribute xml:base { text }?,
5486	       attribute xml:lang { text }?,
5487	       (text
5488	        | bcp14
5489	        | cref
5490	        | em
5491	        | eref
5492	        | iref
5493	        | relref
5494	        | spanx
5495	        | strong
5496	        | sub
5497	        | sup
5498	        | tt
5499	        | xref)*
5500	     }

5502	   refcontent =
5503	     element refcontent {
5504	       attribute xml:base { text }?,
5505	       attribute xml:lang { text }?,
5506	       (text | bcp14 | em | strong | sub | sup | tt)*
5507	     }
5508	   start |= rfc

5510	Appendix D.  Schema Differences from v2

5512	   The following is a non-normative comparison of the v3 format to the
5513	   v2 format.  A "-" indicates lines removed from the v2 schema, and a
5514	   "+" indicates lines added to the v3 schema.

5516	     namespace a =
5517	     "http://relaxng.org/ns/compatibility/annotations/1.0"

5519	   + # xml2rfc Version 3 grammar
5520	     rfc =
5521	       element rfc {
5522	   +     attribute xml:base { text }?,
5523	   +     attribute xml:lang { text }?,
5524	         attribute number { text }?,
5525	         [ a:defaultValue = "" ] attribute obsoletes { text }?,
5526	         [ a:defaultValue = "" ] attribute updates { text }?,
5527	   -     attribute category { "std" | "bcp" | "info" | "exp" |
5528	   - "historic" }?,
5529	   -     attribute consensus { "no" | "yes" }?,
5530	   +     attribute category { text }?,
5531	   +     attribute mode { text }?,
5532	   +     [ a:defaultValue = "false" ]
5533	   +     attribute consensus { "no" | "yes" | "false" | "true" }?,
5534	         attribute seriesNo { text }?,
5535	   -     attribute ipr {
5536	   -       "full2026"
5537	   -       | "noDerivativeWorks2026"
5538	   -       | "none"
5539	   -       | "full3667"
5540	   -       | "noModification3667"
5541	   -       | "noDerivatives3667"
5542	   -       | "full3978"
5543	   -       | "noModification3978"
5544	   -       | "noDerivatives3978"
5545	   -       | "trust200811"
5546	   -       | "noModificationTrust200811"
5547	   -       | "noDerivativesTrust200811"
5548	   -       | "trust200902"
5549	   -       | "noModificationTrust200902"
5550	   -       | "noDerivativesTrust200902"
5551	   -       | "pre5378Trust200902"
5552	   -     }?,
5553	   +     attribute ipr { text }?,
5554	         attribute iprExtract { xsd:IDREF }?,
5555	         [ a:defaultValue = "IETF" ]
5556	         attribute submissionType {
5557	           "IETF" | "IAB" | "IRTF" | "independent"
5558	         }?,
5559	         attribute docName { text }?,
5560	   -     [ a:defaultValue = "en" ] attribute xml:lang { text }?,
5561	   +     [ a:defaultValue = "false" ]
5562	   +     attribute sortRefs { "true" | "false" }?,
5563	   +     [ a:defaultValue = "true" ]
5564	   +     attribute symRefs { "true" | "false" }?,
5565	   +     [ a:defaultValue = "true" ]
5566	   +     attribute tocInclude { "true" | "false" }?,
5567	   +     [ a:defaultValue = "3" ] attribute tocDepth { text }?,
5568	   +     attribute prepTime { text }?,
5569	   +     [ a:defaultValue = "true" ]
5570	   +     attribute indexInclude { "true" | "false" }?,
5571	   +     attribute version { text }?,
5572	   +     [ a:defaultValue = "Common,Latin" ] attribute scripts { text
5573	   + }?,
5574	   +     attribute expiresDate { text }?,
5575	   +     link*,
5576	         front,
5577	         middle,
5578	         back?
5579	       }
5580	   + link =
5581	   +   element link {
5582	   +     attribute xml:base { text }?,
5583	   +     attribute xml:lang { text }?,
5584	   +     attribute href { text },
5585	   +     attribute rel { text }?
5586	   +   }
5587	     front =
5588	       element front {
5589	   -     title, author+, date, area*, workgroup*, keyword*, abstract?,
5590	   - note*
5591	   +     attribute xml:base { text }?,
5592	   +     attribute xml:lang { text }?,
5593	   +     title,
5594	   +     seriesInfo*,
5595	   +     author+,
5596	   +     date?,
5597	   +     area*,
5598	   +     workgroup*,
5599	   +     keyword*,
5600	   +     abstract?,
5601	   +     note*,
5602	   +     boilerplate?
5603	       }
5604	     title =
5605	       element title {
5606	   +     attribute xml:base { text }?,
5607	   +     attribute xml:lang { text }?,
5608	         attribute abbrev { text }?,
5609	   +     attribute ascii { text }?,
5610	         text
5611	       }
5612	     author =
5613	       element author {
5614	   +     attribute xml:base { text }?,
5615	   +     attribute xml:lang { text }?,
5616	         attribute initials { text }?,
5617	   +     attribute asciiInitials { text }?,
5618	         attribute surname { text }?,
5619	   +     attribute asciiSurname { text }?,
5620	         attribute fullname { text }?,
5621	         attribute role { "editor" }?,
5622	   +     attribute asciiFullname { text }?,
5623	         organization?,
5624	         address?

5626	       }
5627	     organization =
5628	       element organization {
5629	   +     attribute xml:base { text }?,
5630	   +     attribute xml:lang { text }?,
5631	         attribute abbrev { text }?,
5632	   +     attribute ascii { text }?,
5633	   +     text
5634	   +   }
5635	   + address =
5636	   +   element address {
5637	   +     attribute xml:base { text }?,
5638	   +     attribute xml:lang { text }?,
5639	   +     postal?,
5640	   +     phone?,
5641	   +     facsimile?,
5642	   +     email?,
5643	   +     uri?
5644	   +   }
5645	   + postal =
5646	   +   element postal {
5647	   +     attribute xml:base { text }?,
5648	   +     attribute xml:lang { text }?,
5649	   +     ((city | code | country | region | street)* | postalLine+)
5650	   +   }
5651	   + street =
5652	   +   element street {
5653	   +     attribute xml:base { text }?,
5654	   +     attribute xml:lang { text }?,
5655	   +     attribute ascii { text }?,
5656	   +     text
5657	   +   }
5658	   + city =
5659	   +   element city {
5660	   +     attribute xml:base { text }?,
5661	   +     attribute xml:lang { text }?,
5662	   +     attribute ascii { text }?,
5663	   +     text
5664	   +   }
5665	   + region =
5666	   +   element region {
5667	   +     attribute xml:base { text }?,
5668	   +     attribute xml:lang { text }?,
5669	   +     attribute ascii { text }?,
5670	   +     text
5671	   +   }
5672	   + code =
5673	   +   element code {
5674	   +     attribute xml:base { text }?,
5675	   +     attribute xml:lang { text }?,
5676	   +     attribute ascii { text }?,
5677	   +     text
5678	   +   }
5679	   + country =
5680	   +   element country {
5681	   +     attribute xml:base { text }?,
5682	   +     attribute xml:lang { text }?,
5683	   +     attribute ascii { text }?,
5684	   +     text
5685	   +   }
5686	   + postalLine =
5687	   +   element postalLine {
5688	   +     attribute xml:base { text }?,
5689	   +     attribute xml:lang { text }?,
5690	   +     attribute ascii { text }?,
5691	   +     text
5692	   +   }
5693	   + phone =
5694	   +   element phone {
5695	   +     attribute xml:base { text }?,
5696	   +     attribute xml:lang { text }?,
5697	   +     text
5698	   +   }
5699	   + facsimile =
5700	   +   element facsimile {
5701	   +     attribute xml:base { text }?,
5702	   +     attribute xml:lang { text }?,
5703	   +     text
5704	   +   }
5705	   + email =
5706	   +   element email {
5707	   +     attribute xml:base { text }?,
5708	   +     attribute xml:lang { text }?,
5709	   +     attribute ascii { text }?,
5710	   +     text
5711	   +   }
5712	   + uri =
5713	   +   element uri {
5714	   +     attribute xml:base { text }?,
5715	   +     attribute xml:lang { text }?,
5716	         text
5717	       }
5718	   - address = element address { postal?, phone?, facsimile?, email?,
5719	   - uri? }
5720	   - postal = element postal { street+, (city | region | code |
5721	   - country)* }
5722	   - street = element street { text }
5723	   - city = element city { text }
5724	   - region = element region { text }
5725	   - code = element code { text }
5726	   - country = element country { text }
5727	   - phone = element phone { text }
5728	   - facsimile = element facsimile { text }
5729	   - email = element email { text }
5730	   - uri = element uri { text }
5731	     date =
5732	       element date {
5733	   +     attribute xml:base { text }?,
5734	   +     attribute xml:lang { text }?,
5735	         attribute day { text }?,
5736	         attribute month { text }?,
5737	         attribute year { text }?,
5738	         empty
5739	       }
5740	   - area = element area { text }
5741	   - workgroup = element workgroup { text }
5742	   - keyword = element keyword { text }
5743	   - abstract = element abstract { t+ }
5744	   + area =
5745	   +   element area {
5746	   +     attribute xml:base { text }?,
5747	   +     attribute xml:lang { text }?,
5748	   +     text
5749	   +   }
5750	   + workgroup =
5751	   +   element workgroup {
5752	   +     attribute xml:base { text }?,
5753	   +     attribute xml:lang { text }?,
5754	   +     text
5755	   +   }
5756	   + keyword =
5757	   +   element keyword {
5758	   +     attribute xml:base { text }?,
5759	   +     attribute xml:lang { text }?,
5760	   +     text
5761	   +   }
5762	   + abstract =
5763	   +   element abstract {
5764	   +     attribute xml:base { text }?,
5765	   +     attribute xml:lang { text }?,
5766	   +     attribute anchor { xsd:ID }?,
5767	   +     attribute pn { text }?,
5768	   +     (dl | ol | t | ul)+
5769	   +   }
5770	     note =
5771	       element note {
5772	   -     attribute title { text },
5773	   -     t+
5774	   +     attribute xml:base { text }?,
5775	   +     attribute xml:lang { text }?,
5776	   +     attribute title { text }?,
5777	   +     attribute pn { text }?,
5778	   +     [ a:defaultValue = "false" ]
5779	   +     attribute removeInRFC { "true" | "false" }?,
5780	   +     name?,
5781	   +     (dl | ol | t | ul)+
5782	   +   }
5783	   + boilerplate =
5784	   +   element boilerplate {
5785	   +     attribute xml:base { text }?,
5786	   +     attribute xml:lang { text }?,
5787	   +     section+
5788	   +   }
5789	   + middle =
5790	   +   element middle {
5791	   +     attribute xml:base { text }?,
5792	   +     attribute xml:lang { text }?,
5793	   +     section+
5794	       }
5795	   - middle = element middle { section+ }
5796	     section =
5797	       element section {
5798	   +     attribute xml:base { text }?,
5799	   +     attribute xml:lang { text }?,
5800	         attribute anchor { xsd:ID }?,
5801	   -     attribute title { text },
5802	   +     attribute pn { text }?,
5803	   +     attribute title { text }?,
5804	   +     [ a:defaultValue = "true" ]
5805	   +     attribute numbered { "true" | "false" }?,
5806	         [ a:defaultValue = "default" ]
5807	         attribute toc { "include" | "exclude" | "default" }?,
5808	   -     (t | figure | texttable | iref)*,
5809	   +     [ a:defaultValue = "false" ]
5810	   +     attribute removeInRFC { "true" | "false" }?,
5811	   +     name?,
5812	   +     (artwork
5813	   +      | aside
5814	   +      | blockquote
5815	   +      | dl
5816	   +      | figure
5817	   +      | iref
5818	   +      | ol
5819	   +      | sourcecode
5820	   +      | t
5821	   +      | table
5822	   +      | texttable
5823	   +      | ul)*,
5824	         section*
5825	       }
5826	   + name =
5827	   +   element name {
5828	   +     attribute xml:base { text }?,
5829	   +     attribute xml:lang { text }?,
5830	   +     attribute slugifiedName { text }?,
5831	   +     (text | cref | eref | relref | tt | xref)*
5832	   +   }
5833	     t =
5834	       element t {
5835	   +     attribute xml:base { text }?,
5836	   +     attribute xml:lang { text }?,
5837	         attribute anchor { xsd:ID }?,
5838	   +     attribute pn { text }?,
5839	         attribute hangText { text }?,
5840	   +     [ a:defaultValue = "false" ]
5841	   +     attribute keepWithNext { "false" | "true" }?,
5842	   +     [ a:defaultValue = "false" ]
5843	   +     attribute keepWithPrevious { "false" | "true" }?,
5844	         (text
5845	   -      | \list
5846	   -      | figure
5847	   -      | xref
5848	   +      | bcp14
5849	   +      | cref
5850	   +      | em
5851	          | eref
5852	          | iref
5853	   -      | cref
5854	   +      | \list
5855	   +      | relref
5856	          | spanx
5857	   -      | vspace)*
5858	   +      | strong
5859	   +      | sub
5860	   +      | sup
5861	   +      | tt
5862	   +      | vspace
5863	   +      | xref)*
5864	   +   }
5865	   + aside =
5866	   +   element aside {
5867	   +     attribute xml:base { text }?,
5868	   +     attribute xml:lang { text }?,
5869	   +     attribute anchor { xsd:ID }?,
5870	   +     attribute pn { text }?,
5871	   +     (artwork | dl | figure | iref | \list | ol | t | table | ul)*
5872	   +   }
5873	   + blockquote =
5874	   +   element blockquote {
5875	   +     attribute xml:base { text }?,
5876	   +     attribute xml:lang { text }?,
5877	   +     attribute anchor { xsd:ID }?,
5878	   +     attribute pn { text }?,
5879	   +     attribute cite { text }?,
5880	   +     attribute quotedFrom { text }?,
5881	   +     ((artwork | dl | figure | ol | sourcecode | t | ul)+
5882	   +      | (text
5883	   +         | bcp14
5884	   +         | cref
5885	   +         | em
5886	   +         | eref
5887	   +         | iref
5888	   +         | relref
5889	   +         | strong
5890	   +         | sub
5891	   +         | sup
5892	   +         | tt
5893	   +         | xref)+)
5894	       }
5895	     \list =
5896	       element list {
5897	   -     attribute style { text }?,
5898	   +     attribute xml:base { text }?,
5899	   +     attribute xml:lang { text }?,
5900	   +     [ a:defaultValue = "empty" ] attribute style { text }?,
5901	         attribute hangIndent { text }?,
5902	         attribute counter { text }?,
5903	   +     attribute pn { text }?,
5904	         t+
5905	       }
5906	   + ol =
5907	   +   element ol {
5908	   +     attribute xml:base { text }?,
5909	   +     attribute xml:lang { text }?,
5910	   +     attribute anchor { xsd:ID }?,
5911	   +     [ a:defaultValue = "1" ] attribute type { text }?,
5912	   +     [ a:defaultValue = "1" ] attribute start { text }?,
5913	   +     attribute group { text }?,
5914	   +     [ a:defaultValue = "normal" ]
5915	   +     attribute spacing { "normal" | "compact" }?,
5916	   +     attribute pn { text }?,
5917	   +     li+
5918	   +   }
5919	   + ul =
5920	   +   element ul {
5921	   +     attribute xml:base { text }?,
5922	   +     attribute xml:lang { text }?,
5923	   +     attribute anchor { xsd:ID }?,
5924	   +     [ a:defaultValue = "normal" ]
5925	   +     attribute spacing { "normal" | "compact" }?,
5926	   +     ([ a:defaultValue = "false" ]
5927	   +      attribute empty { "false" | "true" },
5928	   +      attribute pn { text }?)?,
5929	   +     li+
5930	   +   }
5931	   + li =
5932	   +   element li {
5933	   +     attribute xml:base { text }?,
5934	   +     attribute xml:lang { text }?,
5935	   +     attribute anchor { xsd:ID }?,
5936	   +     attribute pn { text }?,
5937	   +     ((artwork | dl | figure | ol | sourcecode | t | ul)+
5938	   +      | (text
5939	   +         | bcp14
5940	   +         | cref
5941	   +         | em
5942	   +         | eref
5943	   +         | iref
5944	   +         | relref
5945	   +         | strong
5946	   +         | sub
5947	   +         | sup
5948	   +         | tt
5949	   +         | xref)+)
5950	   +   }
5951	   + dl =
5952	   +   element dl {
5953	   +     attribute xml:base { text }?,
5954	   +     attribute xml:lang { text }?,
5955	   +     attribute anchor { xsd:ID }?,
5956	   +     [ a:defaultValue = "normal" ]
5957	   +     attribute spacing { "normal" | "compact" }?,
5958	   +     [ a:defaultValue = "true" ]
5959	   +     attribute hanging { "false" | "true" }?,
5960	   +     attribute pn { text }?,
5961	   +     (dt, dd)+
5962	   +   }
5963	   + dt =
5964	   +   element dt {
5965	   +     attribute xml:base { text }?,
5966	   +     attribute xml:lang { text }?,
5967	   +     attribute anchor { xsd:ID }?,
5968	   +     attribute pn { text }?,
5969	   +     (text
5970	   +      | bcp14
5971	   +      | cref
5972	   +      | em
5973	   +      | eref
5974	   +      | iref
5975	   +      | relref
5976	   +      | strong
5977	   +      | sub
5978	   +      | sup
5979	   +      | tt
5980	   +      | xref)*
5981	   +   }
5982	   + dd =
5983	   +   element dd {
5984	   +     attribute xml:base { text }?,
5985	   +     attribute xml:lang { text }?,
5986	   +     attribute anchor { xsd:ID }?,
5987	   +     attribute pn { text }?,
5988	   +     ((artwork | dl | figure | ol | sourcecode | t | ul)+
5989	   +      | (text
5990	   +         | bcp14
5991	   +         | cref
5992	   +         | em
5993	   +         | eref
5994	   +         | iref
5995	   +         | relref
5996	   +         | strong
5997	   +         | sub
5998	   +         | sup
5999	   +         | tt
6000	   +         | xref)+)
6001	   +   }
6002	     xref =
6003	       element xref {
6004	   +     attribute xml:base { text }?,
6005	   +     attribute xml:lang { text }?,
6006	         attribute target { xsd:IDREF },
6007	   -     [ a:defaultValue = "false" ] attribute pageno { "true" |
6008	   - "false" }?,
6009	   +     [ a:defaultValue = "false" ]
6010	   +     attribute pageno { "true" | "false" }?,
6011	         [ a:defaultValue = "default" ]
6012	   -     attribute format { "counter" | "title" | "none" | "default"
6013	   +     attribute format { "default" | "title" | "counter" | "none"
6014	   + }?,
6015	   +     attribute derivedContent { text }?,
6016	   +     text
6017	   +   }
6018	   + relref =
6019	   +   element relref {
6020	   +     attribute xml:base { text }?,
6021	   +     attribute xml:lang { text }?,
6022	   +     attribute target { xsd:IDREF },
6023	   +     [ a:defaultValue = "of" ]
6024	   +     attribute displayFormat { "of" | "comma" | "parens" | "bare"
6025	     }?,
6026	   +     attribute section { text },
6027	   +     attribute relative { text }?,
6028	   +     attribute derivedLink { text }?,
6029	         text
6030	       }
6031	     eref =
6032	       element eref {
6033	   +     attribute xml:base { text }?,
6034	   +     attribute xml:lang { text }?,
6035	         attribute target { text },
6036	         text
6037	       }
6038	     iref =
6039	       element iref {
6040	   +     attribute xml:base { text }?,
6041	   +     attribute xml:lang { text }?,
6042	         attribute item { text },
6043	         [ a:defaultValue = "" ] attribute subitem { text }?,
6044	         [ a:defaultValue = "false" ]
6045	         attribute primary { "true" | "false" }?,
6046	   +     attribute pn { text }?,
6047	         empty
6048	       }
6049	     cref =
6050	       element cref {
6051	   +     attribute xml:base { text }?,
6052	   +     attribute xml:lang { text }?,
6053	         attribute anchor { xsd:ID }?,
6054	         attribute source { text }?,
6055	   -     text
6056	   +     [ a:defaultValue = "true" ]
6057	   +     attribute display { "true" | "false" }?,
6058	   +     (text | em | eref | relref | strong | sub | sup | tt | xref)*
6059	   +   }
6060	   + tt =
6061	   +   element tt {
6062	   +     attribute xml:base { text }?,
6063	   +     attribute xml:lang { text }?,
6064	   +     (text
6065	   +      | bcp14
6066	   +      | cref
6067	   +      | em
6068	   +      | eref
6069	   +      | iref
6070	   +      | relref
6071	   +      | strong
6072	   +      | sub
6073	   +      | sup
6074	   +      | xref)*
6075	   +   }
6076	   + strong =
6077	   +   element strong {
6078	   +     attribute xml:base { text }?,
6079	   +     attribute xml:lang { text }?,
6080	   +     (text
6081	   +      | bcp14
6082	   +      | cref
6083	   +      | em
6084	   +      | eref
6085	   +      | iref
6086	   +      | relref
6087	   +      | sub
6088	   +      | sup
6089	   +      | tt
6090	   +      | xref)*
6091	   +   }
6092	   + em =
6093	   +   element em {
6094	   +     attribute xml:base { text }?,
6095	   +     attribute xml:lang { text }?,
6096	   +     (text
6097	   +      | bcp14
6098	   +      | cref
6099	   +      | eref
6100	   +      | iref
6101	   +      | relref
6102	   +      | strong
6103	   +      | sub
6104	   +      | sup
6105	   +      | tt
6106	   +      | xref)*
6107	   +   }
6108	   + sub =
6109	   +   element sub {
6110	   +     attribute xml:base { text }?,
6111	   +     attribute xml:lang { text }?,
6112	   +     (text
6113	   +      | bcp14
6114	   +      | cref
6115	   +      | em
6116	   +      | eref
6117	   +      | iref
6118	   +      | relref
6119	   +      | strong
6120	   +      | tt
6121	   +      | xref)*
6122	   +   }
6123	   + sup =
6124	   +   element sup {
6125	   +     attribute xml:base { text }?,
6126	   +     attribute xml:lang { text }?,
6127	   +     (text
6128	   +      | bcp14
6129	   +      | cref
6130	   +      | em
6131	   +      | eref
6132	   +      | iref
6133	   +      | relref
6134	   +      | strong
6135	   +      | tt
6136	   +      | xref)*
6137	       }
6138	     spanx =
6139	       element spanx {
6140	   +     attribute xml:base { text }?,
6141	   +     attribute xml:lang { text }?,
6142	         [ a:defaultValue = "preserve" ]
6143	         attribute xml:space { "default" | "preserve" }?,
6144	         [ a:defaultValue = "emph" ] attribute style { text }?,
6145	         text
6146	       }
6147	     vspace =
6148	       element vspace {
6149	   +     attribute xml:base { text }?,
6150	   +     attribute xml:lang { text }?,
6151	         [ a:defaultValue = "0" ] attribute blankLines { text }?,
6152	         empty
6153	       }

6155	     figure =
6156	       element figure {
6157	   +     attribute xml:base { text }?,
6158	   +     attribute xml:lang { text }?,
6159	         attribute anchor { xsd:ID }?,
6160	   +     attribute pn { text }?,
6161	         [ a:defaultValue = "" ] attribute title { text }?,
6162	         [ a:defaultValue = "false" ]
6163	         attribute suppress-title { "true" | "false" }?,
6164	         attribute src { text }?,
6165	   +     attribute originalSrc { text }?,
6166	         [ a:defaultValue = "left" ]
6167	         attribute align { "left" | "center" | "right" }?,
6168	         [ a:defaultValue = "" ] attribute alt { text }?,
6169	         [ a:defaultValue = "" ] attribute width { text }?,
6170	         [ a:defaultValue = "" ] attribute height { text }?,
6171	   +     name?,
6172	         iref*,
6173	         preamble?,
6174	   -     artwork,
6175	   +     (artwork | sourcecode)+,
6176	         postamble?
6177	       }
6178	   + table =
6179	   +   element table {
6180	   +     attribute xml:base { text }?,
6181	   +     attribute xml:lang { text }?,
6182	   +     attribute anchor { xsd:ID }?,
6183	   +     attribute pn { text }?,
6184	   +     name?,
6185	   +     iref*,
6186	   +     thead?,
6187	   +     tbody+,
6188	   +     tfoot?
6189	   +   }
6190	     preamble =
6191	   -   element preamble { (text | xref | eref | iref | cref | spanx)* }
6192	   +   element preamble {
6193	   +     attribute xml:base { text }?,
6194	   +     attribute xml:lang { text }?,
6195	   +     (text
6196	   +      | bcp14
6197	   +      | cref
6198	   +      | em
6199	   +      | eref
6200	   +      | iref
6201	   +      | relref
6202	   +      | spanx
6203	   +      | strong
6204	   +      | sub
6205	   +      | sup
6206	   +      | tt
6207	   +      | xref)*
6208	   +   }
6209	     artwork =
6210	       element artwork {
6211	   -     [ a:defaultValue = "preserve" ]
6212	   -     attribute xml:space { "default" | "preserve" }?,
6213	   +     attribute xml:base { text }?,
6214	   +     attribute xml:lang { text }?,
6215	   +     attribute anchor { xsd:ID }?,
6216	   +     attribute pn { text }?,
6217	   +     attribute xml:space { text }?,
6218	         [ a:defaultValue = "" ] attribute name { text }?,
6219	         [ a:defaultValue = "" ] attribute type { text }?,
6220	         attribute src { text }?,
6221	         [ a:defaultValue = "left" ]
6222	         attribute align { "left" | "center" | "right" }?,
6223	         [ a:defaultValue = "" ] attribute alt { text }?,
6224	         [ a:defaultValue = "" ] attribute width { text }?,
6225	         [ a:defaultValue = "" ] attribute height { text }?,
6226	   -     text*
6227	   +     attribute originalSrc { text }?,
6228	   +     (text* | svg)
6229	   +   }
6230	   + # TODO: replace with link to RSE site, or provide an inline
6231	   + version
6232	   + include "svg.rnc"
6233	   + sourcecode =
6234	   +   element sourcecode {
6235	   +     attribute xml:base { text }?,
6236	   +     attribute xml:lang { text }?,
6237	   +     attribute anchor { xsd:ID }?,
6238	   +     attribute pn { text }?,
6239	   +     [ a:defaultValue = "" ] attribute name { text }?,
6240	   +     [ a:defaultValue = "" ] attribute type { text }?,
6241	   +     attribute src { text }?,
6242	   +     attribute originalSrc { text }?,
6243	   +     text
6244	   +   }
6245	   + thead =
6246	   +   element thead {
6247	   +     attribute xml:base { text }?,
6248	   +     attribute xml:lang { text }?,
6249	   +     attribute anchor { xsd:ID }?,
6250	   +     tr+
6251	   +   }
6252	   + tbody =
6253	   +   element tbody {
6254	   +     attribute xml:base { text }?,
6255	   +     attribute xml:lang { text }?,
6256	   +     attribute anchor { xsd:ID }?,
6257	   +     tr+
6258	   +   }
6259	   + tfoot =
6260	   +   element tfoot {
6261	   +     attribute xml:base { text }?,
6262	   +     attribute xml:lang { text }?,
6263	   +     attribute anchor { xsd:ID }?,
6264	   +     tr+
6265	   +   }
6266	   + tr =
6267	   +   element tr {
6268	   +     attribute xml:base { text }?,
6269	   +     attribute xml:lang { text }?,
6270	   +     attribute anchor { xsd:ID }?,
6271	   +     (td | th)+
6272	   +   }
6273	   + td =
6274	   +   element td {
6275	   +     attribute xml:base { text }?,
6276	   +     attribute xml:lang { text }?,
6277	   +     attribute anchor { xsd:ID }?,
6278	   +     [ a:defaultValue = "0" ] attribute colspan { text }?,
6279	   +     [ a:defaultValue = "0" ] attribute rowspan { text }?,
6280	   +     [ a:defaultValue = "left" ]
6281	   +     attribute align { "left" | "center" | "right" }?,
6282	   +     ((artwork | dl | figure | ol | sourcecode | t | ul)+
6283	   +      | (text
6284	   +         | bcp14
6285	   +         | br
6286	   +         | cref
6287	   +         | em
6288	   +         | eref
6289	   +         | iref
6290	   +         | relref
6291	   +         | strong
6292	   +         | sub
6293	   +         | sup
6294	   +         | tt
6295	   +         | xref)*)
6296	   +   }
6297	   + th =
6298	   +   element th {
6299	   +     attribute xml:base { text }?,
6300	   +     attribute xml:lang { text }?,
6301	   +     attribute anchor { xsd:ID }?,
6302	   +     [ a:defaultValue = "0" ] attribute colspan { text }?,
6303	   +     [ a:defaultValue = "0" ] attribute rowspan { text }?,
6304	   +     [ a:defaultValue = "left" ]
6305	   +     attribute align { "left" | "center" | "right" }?,
6306	   +     ((artwork | dl | figure | ol | sourcecode | t | ul)+
6307	   +      | (text
6308	   +         | bcp14
6309	   +         | br
6310	   +         | cref
6311	   +         | em
6312	   +         | eref
6313	   +         | iref
6314	   +         | relref
6315	   +         | strong
6316	   +         | sub
6317	   +         | sup
6318	   +         | tt
6319	   +         | xref)*)
6320	       }
6321	     postamble =
6322	   -   element postamble { (text | xref | eref | iref | cref | spanx)*
6323	   +   element postamble {
6324	   +     attribute xml:base { text }?,
6325	   +     attribute xml:lang { text }?,
6326	   +     (text | cref | eref | iref | spanx | xref)*
6327	     }
6328	     texttable =
6329	       element texttable {
6330	   +     attribute xml:base { text }?,
6331	   +     attribute xml:lang { text }?,
6332	         attribute anchor { xsd:ID }?,
6333	         [ a:defaultValue = "" ] attribute title { text }?,
6334	         [ a:defaultValue = "false" ]
6335	         attribute suppress-title { "true" | "false" }?,
6336	         [ a:defaultValue = "center" ]
6337	         attribute align { "left" | "center" | "right" }?,
6338	         [ a:defaultValue = "full" ]
6339	         attribute style { "all" | "none" | "headers" | "full" }?,
6340	   +     name?,
6341	         preamble?,
6342	         ttcol+,
6343	         c*,
6344	         postamble?
6345	       }
6346	     ttcol =
6347	       element ttcol {
6348	   +     attribute xml:base { text }?,
6349	   +     attribute xml:lang { text }?,
6350	         attribute width { text }?,
6351	         [ a:defaultValue = "left" ]
6352	         attribute align { "left" | "center" | "right" }?,
6353	   +     (cref | eref | iref | xref | text)*
6354	   +   }
6355	   + c =
6356	   +   element c {
6357	   +     attribute xml:base { text }?,
6358	   +     attribute xml:lang { text }?,
6359	   +     (text | cref | eref | iref | spanx | xref)*
6360	   +   }
6361	   + bcp14 =
6362	   +   element bcp14 {
6363	   +     attribute xml:base { text }?,
6364	   +     attribute xml:lang { text }?,
6365	         text
6366	       }
6367	   - c = element c { (text | xref | eref | iref | cref | spanx)* }
6368	   - back = element back { references*, section* }
6369	   + br =
6370	   +   element br {
6371	   +     attribute xml:base { text }?,
6372	   +     attribute xml:lang { text }?,
6373	   +     empty
6374	   +   }
6375	   + back =
6376	   +   element back {
6377	   +     attribute xml:base { text }?,
6378	   +     attribute xml:lang { text }?,
6379	   +     displayreference*,
6380	   +     references*,
6381	   +     section*
6382	   +   }
6383	   + displayreference =
6384	   +   element displayreference {
6385	   +     attribute xml:base { text }?,
6386	   +     attribute xml:lang { text }?,
6387	   +     attribute target { xsd:IDREF },
6388	   +     attribute to { text }
6389	   +   }
6390	     references =
6391	       element references {
6392	   -     [ a:defaultValue = "References" ] attribute title { text }?,
6393	   -     reference+
6394	   +     attribute xml:base { text }?,
6395	   +     attribute xml:lang { text }?,
6396	   +     attribute pn { text }?,
6397	   +     attribute anchor { xsd:ID }?,
6398	   +     attribute title { text }?,
6399	   +     name?,
6400	   +     (reference | referencegroup)*
6401	       }
6402	     reference =
6403	       element reference {
6404	   +     attribute xml:base { text }?,
6405	   +     attribute xml:lang { text }?,
6406	         attribute anchor { xsd:ID },
6407	         attribute target { text }?,
6408	   +     [ a:defaultValue = "true" ]
6409	   +     attribute quoteTitle { "true" | "false" }?,
6410	         front,
6411	   -     seriesInfo*,
6412	   -     format*,
6413	   -     annotation*
6414	   +     (annotation | format | refcontent | seriesInfo)*
6415	   +   }
6416	   + referencegroup =
6417	   +   element referencegroup {
6418	   +     attribute xml:base { text }?,
6419	   +     attribute xml:lang { text }?,
6420	   +     attribute anchor { xsd:ID },
6421	   +     reference+
6422	       }
6423	     seriesInfo =
6424	       element seriesInfo {
6425	   +     attribute xml:base { text }?,
6426	   +     attribute xml:lang { text }?,
6427	         attribute name { text },
6428	         attribute value { text },
6429	   +     attribute asciiName { text }?,
6430	   +     attribute asciiValue { text }?,
6431	   +     attribute status { text }?,
6432	   +     [ a:defaultValue = "IETF" ]
6433	   +     attribute stream { "IETF" | "IAB" | "IRTF" | "independent" }?,
6434	         empty
6435	       }
6436	     format =
6437	       element format {
6438	   +     attribute xml:base { text }?,
6439	   +     attribute xml:lang { text }?,
6440	         attribute target { text }?,
6441	         attribute type { text },
6442	         attribute octets { text }?,
6443	         empty
6444	       }
6445	     annotation =
6446	   -   element annotation { (text | xref | eref | iref | cref |
6447	   - spanx)* }
6448	   - start = rfc
6449	   +   element annotation {
6450	   +     attribute xml:base { text }?,
6451	   +     attribute xml:lang { text }?,
6452	   +     (text
6453	   +      | bcp14
6454	   +      | cref
6455	   +      | em
6456	   +      | eref
6457	   +      | iref
6458	   +      | relref
6459	   +      | spanx
6460	   +      | strong
6461	   +      | sub
6462	   +      | sup
6463	   +      | tt
6464	   +      | xref)*
6465	   +   }
6466	   + refcontent =
6467	   +   element refcontent {
6468	   +     attribute xml:base { text }?,
6469	   +     attribute xml:lang { text }?,
6470	   +     (text | bcp14 | em | strong | sub | sup | tt)*
6471	   +   }
6472	   + start |= rfc

6474	Appendix E.  IAB Members at the Time of Approval

6476	   The IAB members at the time this memo was approved were (in
6477	   alphabetical order):

6479	   [[ A list will go here just before publication as an RFC ]]

6481	Appendix F.  Acknowledgments

6483	   Thanks to everybody who reviewed this document and provided feedback
6484	   and/or specification text.  Thanks especially go to Julian Reschke
6485	   for editing [RFC7749] and those who provided feedback on that
6486	   document.

6488	   We also thank Marshall T. Rose for both the original design and the
6489	   reference implementation of the "xml2rfc" processor.

6491	Index

6493	   A
6494	      abbrev attribute
6495	         in organization element  41
6496	         in title element  69
6497	      abstract element  11, 98
6498	         anchor attribute  11
6499	         inside front  33
6500	      address element  11, 98
6501	         inside author  18
6502	      align attribute
6503	         in artwork element  14
6504	         in figure element  32
6505	         in td element  66
6506	         in texttable element  79
6507	         in th element  68
6508	         in ttcol element  81
6509	      alt attribute
6510	         in artwork element  15
6511	         in figure element  32
6512	      anchor attribute
6513	         in abstract element  11
6514	         in artwork element  15
6515	         in aside element  17
6516	         in blockquote element  21
6517	         in cref element  23
6518	         in dd element  26
6519	         in dl element  27
6520	         in dt element  29
6521	         in figure element  32
6522	         in li element  36
6523	         in ol element  39
6524	         in reference element  44
6525	         in referencegroup element  45
6526	         in references element  45
6527	         in section element  54
6528	         in sourcecode element  58
6529	         in t element  63
6530	         in table element  64
6531	         in tbody element  65
6532	         in td element  66
6533	         in texttable element  80
6534	         in tfoot element  67
6535	         in th element  69
6536	         in thead element  69
6537	         in tr element  70
6538	         in ul element  71

6540	      annotation element  12, 98
6541	         inside reference  44
6542	      application/rfc+xml Media Type  83
6543	      area element  13, 98
6544	         inside front  33
6545	      artwork element  13, 98
6546	         align attribute  14
6547	         alt attribute  15
6548	         anchor attribute  15
6549	         height attribute  15
6550	         inside aside  17
6551	         inside blockquote  20
6552	         inside dd  25
6553	         inside figure  31
6554	         inside li  35
6555	         inside section  53
6556	         inside td  65
6557	         inside th  67
6558	         name attribute  15
6559	         src attribute  15
6560	         type attribute  16
6561	         width attribute  16
6562	         xml:space attribute  16
6563	      ascii attribute
6564	         in city element  22
6565	         in code element  22
6566	         in country element  22
6567	         in email element  30
6568	         in organization element  41
6569	         in postalLine element  42
6570	         in region element  46
6571	         in street element  59
6572	         in title element  70
6573	      asciiFullname attribute
6574	         in author element  18
6575	      asciiInitials attribute
6576	         in author element  18
6577	      asciiName attribute
6578	         in seriesInfo element  55
6579	      asciiSurname attribute
6580	         in author element  18
6581	      asciiValue attribute
6582	         in seriesInfo element  55
6583	      aside element  16, 98
6584	         anchor attribute  17
6585	         inside section  53
6586	      Attributes
6587	         abbrev  41, 69
6588	         align  14, 32, 66, 68, 79, 81
6589	         alt  15, 32
6590	         anchor  11, 15, 17, 21, 23, 26-27, 29, 32, 36, 39, 44-45, 54,
6591	            58, 63-67, 69-71, 80
6592	         ascii  22, 30, 41-42, 46, 59, 70
6593	         asciiFullname  18
6594	         asciiInitials  18
6595	         asciiName  55
6596	         asciiSurname  18
6597	         asciiValue  55
6598	         blankLines  81
6599	         category  50
6600	         cite  21
6601	         colspan  66, 69
6602	         consensus  50
6603	         counter  76
6604	         day  24
6605	         display  23
6606	         displayFormat  47
6607	         docName  50
6608	         empty  71
6609	         format  73
6610	         fullname  18
6611	         group  39
6612	         hangIndent  77
6613	         hanging  27
6614	         hangText  63
6615	         height  15, 32
6616	         href  37
6617	         indexInclude  50
6618	         initials  18
6619	         ipr  51
6620	         iprExtract  51
6621	         item  34
6622	         keepWithNext  63
6623	         keepWithPrevious  63
6624	         month  24
6625	         name  15, 56, 58
6626	         number  51
6627	         numbered  54
6628	         obsoletes  51
6629	         octets  76
6630	         pageno  74
6631	         prepTime  51
6632	         primary  34
6633	         quotedFrom  21
6634	         quoteTitle  44
6635	         rel  37
6636	         relative  49
6637	         removeInRFC  39, 54
6638	         role  18
6639	         rowspan  66, 69
6640	         section  49
6641	         seriesNo  51
6642	         sortRefs  51
6643	         source  24
6644	         spacing  28, 39, 72
6645	         src  15, 32, 58
6646	         start  40
6647	         status  56
6648	         stream  56
6649	         style  77, 79-80
6650	         subitem  35
6651	         submissionType  52
6652	         suppress-title  32, 80
6653	         surname  19
6654	         symRefs  52
6655	         target  26, 31, 44, 49, 75-76
6656	         title  33, 39, 46, 54, 80
6657	         to  27
6658	         toc  54
6659	         tocDepth  52
6660	         tocInclude  52
6661	         type  16, 40, 58, 76
6662	         updates  52
6663	         value  57
6664	         version  53
6665	         width  16, 33, 81
6666	         xml:space  16, 79
6667	         year  25
6668	      author element  17, 98
6669	         asciiFullname attribute  18
6670	         asciiInitials attribute  18
6671	         asciiSurname attribute  18
6672	         fullname attribute  18
6673	         initials attribute  18
6674	         inside front  33
6675	         role attribute  18
6676	         surname attribute  19

6678	   B
6679	      back element  19, 98
6680	         inside rfc  50
6681	      bcp14 element  19, 98
6682	         inside annotation  12
6683	         inside blockquote  20
6684	         inside c  75
6685	         inside dd  25
6686	         inside dt  28
6687	         inside em  29
6688	         inside li  36
6689	         inside postamble  77
6690	         inside preamble  78
6691	         inside refcontent  43
6692	         inside strong  60
6693	         inside sub  61
6694	         inside sup  61
6695	         inside t  62
6696	         inside td  65
6697	         inside th  68
6698	         inside tt  70
6699	      blankLines attribute
6700	         in vspace element  81
6701	      blockquote element  19, 98
6702	         anchor attribute  21
6703	         cite attribute  21
6704	         inside section  53
6705	         quotedFrom attribute  21
6706	      boilerplate element  21, 98
6707	         inside front  34
6708	      br element  21, 98
6709	         inside td  65
6710	         inside th  68

6712	   C
6713	      c element  75, 98
6714	         inside texttable  79
6715	      category attribute
6716	         in rfc element  50
6717	      cite attribute
6718	         in blockquote element  21
6719	      city element  22, 98
6720	         ascii attribute  22
6721	         inside postal  42
6722	      code element  22, 98
6723	         ascii attribute  22
6724	         inside postal  42
6725	      colspan attribute
6726	         in td element  66
6727	         in th element  69
6728	      consensus attribute
6729	         in rfc element  50
6730	      counter attribute
6731	         in list element  76

6733	      country element  22, 98
6734	         ascii attribute  22
6735	         inside postal  42
6736	      cref element  22, 98
6737	         anchor attribute  23
6738	         display attribute  23
6739	         inside annotation  12
6740	         inside blockquote  20
6741	         inside c  75
6742	         inside dd  25
6743	         inside dt  28
6744	         inside em  29
6745	         inside li  36
6746	         inside name  38
6747	         inside postamble  77
6748	         inside preamble  78
6749	         inside strong  60
6750	         inside sub  61
6751	         inside sup  61
6752	         inside t  62
6753	         inside td  65
6754	         inside th  68
6755	         inside tt  70
6756	         inside ttcol  80
6757	         source attribute  24

6759	   D
6760	      date element  24, 98
6761	         day attribute  24
6762	         inside front  33
6763	         month attribute  24
6764	         year attribute  25
6765	      day attribute
6766	         in date element  24
6767	      dd element  25, 98
6768	         anchor attribute  26
6769	         inside dl  27
6770	      display attribute
6771	         in cref element  23
6772	      displayFormat attribute
6773	         in relref element  47
6774	      displayreference element  26, 98
6775	         inside back  19
6776	         target attribute  26
6777	         to attribute  27
6778	      dl element  27, 98
6779	         anchor attribute  27
6780	         hanging attribute  27
6781	         inside abstract  11
6782	         inside aside  17
6783	         inside blockquote  20
6784	         inside dd  25
6785	         inside li  35
6786	         inside note  38
6787	         inside section  53
6788	         inside td  65
6789	         inside th  67
6790	         spacing attribute  28
6791	      docName attribute
6792	         in rfc element  50
6793	      dt element  28, 98
6794	         anchor attribute  29
6795	         inside dl  27

6797	   E
6798	      Elements
6799	         abstract  11, 33
6800	         address  11, 18
6801	         annotation  12, 44
6802	         area  13, 33
6803	         artwork  13, 17, 20, 25, 31, 35, 53, 65, 67
6804	         aside  16, 53
6805	         author  17, 33
6806	         back  19, 50
6807	         bcp14  12, 19-20, 25, 28-29, 36, 43, 60-62, 65, 68, 70, 75,
6808	            77-78
6809	         blockquote  19, 53
6810	         boilerplate  21, 34
6811	         br  21, 65, 68
6812	         c  75, 79
6813	         city  22, 42
6814	         code  22, 42
6815	         country  22, 42
6816	         cref  12, 20, 22, 25, 28-29, 36, 38, 60-62, 65, 68, 70, 75,
6817	            77-78, 80
6818	         date  24, 33
6819	         dd  25, 27
6820	         displayreference  19, 26
6821	         dl  11, 17, 20, 25, 27, 35, 38, 53, 65, 67
6822	         dt  27-28
6823	         em  12, 20, 23, 25, 28-29, 36, 43, 60-62, 65, 68, 71, 75, 77-78
6824	         email  12, 30
6825	         eref  12, 20, 23, 25, 28-30, 36, 38, 60-62, 66, 68, 71, 75,
6826	            77-78, 80
6827	         facsimile  12, 76
6828	         figure  17, 20, 25, 31, 35, 53, 65, 67
6829	         format  44, 76
6830	         front  33, 44, 50
6831	         iref  12, 17, 20, 26, 28-29, 31, 34, 36, 53, 60-62, 64, 66, 68,
6832	            71, 75, 77-78, 80
6833	         keyword  33, 35
6834	         li  35, 39, 71
6835	         link  36, 50
6836	         list  17, 62, 76
6837	         middle  37, 50
6838	         name  31, 37-38, 45, 53, 64, 79
6839	         note  33, 38
6840	         ol  11, 17, 20, 25, 35, 38-39, 53, 65, 67
6841	         organization  18, 41
6842	         phone  12, 41
6843	         postal  12, 42
6844	         postalLine  42
6845	         postamble  32, 77, 79
6846	         preamble  31, 78-79
6847	         refcontent  43-44
6848	         reference  43, 45
6849	         referencegroup  44-45
6850	         references  19, 45
6851	         region  42, 46
6852	         relref  12, 20, 23, 26, 28-29, 36, 38, 46, 60-62, 66, 68, 71
6853	         rfc  49
6854	         section  19, 21, 37, 53-54
6855	         seriesInfo  33, 44, 55
6856	         sourcecode  20, 25, 32, 35, 53, 57, 65, 67
6857	         spanx  12, 62, 75, 77-78
6858	         street  42, 59
6859	         strong  12, 20, 23, 26, 28-29, 36, 43, 59, 61-62, 66, 68, 71,
6860	            75, 77-78
6861	         sub  12, 20, 23, 26, 28-29, 36, 43, 60, 63, 66, 68, 71, 75,
6862	            77-78
6863	         sup  12, 21, 23, 26, 28-29, 36, 43, 60-61, 63, 66, 68, 71, 75,
6864	            77-78
6865	         svg  14
6866	         t  11, 17, 20, 25, 35, 38, 53, 62, 65, 67, 76
6867	         table  17, 53, 64
6868	         tbody  64
6869	         td  65, 70
6870	         texttable  54, 79
6871	         tfoot  64, 67
6872	         th  67, 70
6873	         thead  64, 69
6874	         title  33, 69
6875	         tr  64, 67, 69-70
6876	         tt  12, 21, 23, 26, 28-29, 36, 38, 43, 60-63, 66, 68, 70, 75,
6877	            77-78
6878	         ttcol  79-80
6879	         ul  11, 17, 20, 25, 35, 38, 54, 65, 67, 71
6880	         uri  12, 72
6881	         vspace  63, 81
6882	         workgroup  33, 72
6883	         xref  13, 21, 23, 26, 28-29, 36, 38, 60-63, 66, 68, 71-72, 75,
6884	            77-78, 80
6885	      em element  29, 98
6886	         inside annotation  12
6887	         inside blockquote  20
6888	         inside c  75
6889	         inside cref  23
6890	         inside dd  25
6891	         inside dt  28
6892	         inside li  36
6893	         inside postamble  77
6894	         inside preamble  78
6895	         inside refcontent  43
6896	         inside strong  60
6897	         inside sub  61
6898	         inside sup  62
6899	         inside t  62
6900	         inside td  65
6901	         inside th  68
6902	         inside tt  71
6903	      email element  30, 98
6904	         ascii attribute  30
6905	         inside address  12
6906	      empty attribute
6907	         in ul element  71
6908	      eref element  30, 98
6909	         inside annotation  12
6910	         inside blockquote  20
6911	         inside c  75
6912	         inside cref  23
6913	         inside dd  25
6914	         inside dt  28
6915	         inside em  29
6916	         inside li  36
6917	         inside name  38
6918	         inside postamble  77
6919	         inside preamble  78
6920	         inside strong  60
6921	         inside sub  61
6922	         inside sup  62
6923	         inside t  62
6924	         inside td  66
6925	         inside th  68
6926	         inside tt  71
6927	         inside ttcol  80
6928	         target attribute  31

6930	   F
6931	      facsimile element  76, 98
6932	         inside address  12
6933	      figure element  31, 98
6934	         align attribute  32
6935	         alt attribute  32
6936	         anchor attribute  32
6937	         height attribute  32
6938	         inside aside  17
6939	         inside blockquote  20
6940	         inside dd  25
6941	         inside li  35
6942	         inside section  53
6943	         inside td  65
6944	         inside th  67
6945	         src attribute  32
6946	         suppress-title attribute  32
6947	         title attribute  33
6948	         width attribute  33
6949	      format attribute
6950	         in xref element  73
6951	      format element  76, 98
6952	         inside reference  44
6953	         octets attribute  76
6954	         target attribute  76
6955	         type attribute  76
6956	      front element  33, 98
6957	         inside reference  44
6958	         inside rfc  50
6959	      fullname attribute
6960	         in author element  18

6962	   G
6963	      group attribute
6964	         in ol element  39

6966	   H
6967	      hangIndent attribute
6968	         in list element  77
6969	      hanging attribute
6970	         in dl element  27
6971	      hangText attribute
6972	         in t element  63

6974	      height attribute
6975	         in artwork element  15
6976	         in figure element  32
6977	      href attribute
6978	         in link element  37

6980	   I
6981	      indexInclude attribute
6982	         in rfc element  50
6983	      initials attribute
6984	         in author element  18
6985	      ipr attribute
6986	         "*2026"  91
6987	         "*3667"  91
6988	         "*3978"  91
6989	         "*trust200811"  91
6990	         "*trust200902"  89
6991	         "noDerivativesTrust200902"  90
6992	         "noModificationTrust200902"  90
6993	         "pre5378Trust200902"  90
6994	         "trust200902"  90
6995	         in rfc element  51
6996	      iprExtract attribute
6997	         in rfc element  51
6998	      iref element  34, 98
6999	         inside annotation  12
7000	         inside aside  17
7001	         inside blockquote  20
7002	         inside c  75
7003	         inside dd  26
7004	         inside dt  28
7005	         inside em  29
7006	         inside figure  31
7007	         inside li  36
7008	         inside postamble  77
7009	         inside preamble  78
7010	         inside section  53
7011	         inside strong  60
7012	         inside sub  61
7013	         inside sup  62
7014	         inside t  62
7015	         inside table  64
7016	         inside td  66
7017	         inside th  68
7018	         inside tt  71
7019	         inside ttcol  80
7020	         item attribute  34
7021	         primary attribute  34
7022	         subitem attribute  35
7023	      item attribute
7024	         in iref element  34

7026	   K
7027	      keepWithNext attribute
7028	         in t element  63
7029	      keepWithPrevious attribute
7030	         in t element  63
7031	      keyword element  35, 98
7032	         inside front  33

7034	   L
7035	      li element  35, 98
7036	         anchor attribute  36
7037	         inside ol  39
7038	         inside ul  71
7039	      link element  36, 98
7040	         href attribute  37
7041	         inside rfc  50
7042	         rel attribute  37
7043	      list element  76, 98
7044	         counter attribute  76
7045	         hangIndent attribute  77
7046	         inside aside  17
7047	         inside t  62
7048	         style attribute  77

7050	   M
7051	      Media Type
7052	         application/rfc+xml  83
7053	      middle element  37, 98
7054	         inside rfc  50
7055	      month attribute
7056	         in date element  24

7058	   N
7059	      name attribute
7060	         in artwork element  15
7061	         in seriesInfo element  56
7062	         in sourcecode element  58
7063	      name element  37, 98
7064	         inside figure  31
7065	         inside note  38
7066	         inside references  45
7067	         inside section  53
7068	         inside table  64
7069	         inside texttable  79

7071	      note element  38, 98
7072	         inside front  33
7073	         removeInRFC attribute  39
7074	         title attribute  39
7075	      number attribute
7076	         in rfc element  51
7077	      numbered attribute
7078	         in section element  54

7080	   O
7081	      obsoletes attribute
7082	         in rfc element  51
7083	      octets attribute
7084	         in format element  76
7085	      ol element  39, 98
7086	         anchor attribute  39
7087	         group attribute  39
7088	         inside abstract  11
7089	         inside aside  17
7090	         inside blockquote  20
7091	         inside dd  25
7092	         inside li  35
7093	         inside note  38
7094	         inside section  53
7095	         inside td  65
7096	         inside th  67
7097	         spacing attribute  39
7098	         start attribute  40
7099	         type attribute  40
7100	      organization element  41, 98
7101	         abbrev attribute  41
7102	         ascii attribute  41
7103	         inside author  18

7105	   P
7106	      pageno attribute
7107	         in xref element  74
7108	      phone element  41, 98
7109	         inside address  12
7110	      postal element  42, 98
7111	         inside address  12
7112	      postalLine element  42, 98
7113	         ascii attribute  42
7114	         inside postal  42
7115	      postamble element  77, 98
7116	         inside figure  32
7117	         inside texttable  79
7118	      preamble element  78, 98
7119	         inside figure  31
7120	         inside texttable  79
7121	      prepTime attribute
7122	         in rfc element  51
7123	      primary attribute
7124	         in iref element  34

7126	   Q
7127	      quotedFrom attribute
7128	         in blockquote element  21
7129	      quoteTitle attribute
7130	         in reference element  44

7132	   R
7133	      refcontent element  43, 98
7134	         inside reference  44
7135	      reference element  43, 98
7136	         anchor attribute  44
7137	         inside referencegroup  45
7138	         inside references  45
7139	         quoteTitle attribute  44
7140	         target attribute  44
7141	      referencegroup element  44, 98
7142	         anchor attribute  45
7143	         inside references  45
7144	      references element  45, 98
7145	         anchor attribute  45
7146	         inside back  19
7147	         title attribute  46
7148	      region element  46, 98
7149	         ascii attribute  46
7150	         inside postal  42
7151	      rel attribute
7152	         in link element  37
7153	      relative attribute
7154	         in relref element  49
7155	      relref element  46, 98
7156	         displayFormat attribute  47
7157	         inside annotation  12
7158	         inside blockquote  20
7159	         inside cref  23
7160	         inside dd  26
7161	         inside dt  28
7162	         inside em  29
7163	         inside li  36
7164	         inside name  38
7165	         inside strong  60
7166	         inside sub  61
7167	         inside sup  62
7168	         inside t  62
7169	         inside td  66
7170	         inside th  68
7171	         inside tt  71
7172	         relative attribute  49
7173	         section attribute  49
7174	         target attribute  49
7175	      removeInRFC attribute
7176	         in note element  39
7177	         in section element  54
7178	      rfc element  49, 98
7179	         category attribute  50
7180	         consensus attribute  50
7181	         docName attribute  50
7182	         indexInclude attribute  50
7183	         ipr attribute  51
7184	         iprExtract attribute  51
7185	         number attribute  51
7186	         obsoletes attribute  51
7187	         prepTime attribute  51
7188	         seriesNo attribute  51
7189	         sortRefs attribute  51
7190	         submissionType attribute  52
7191	         symRefs attribute  52
7192	         tocDepth attribute  52
7193	         tocInclude attribute  52
7194	         updates attribute  52
7195	         version attribute  53
7196	      role attribute
7197	         in author element  18
7198	      rowspan attribute
7199	         in td element  66
7200	         in th element  69

7202	   S
7203	      section attribute
7204	         in relref element  49
7205	      section element  53, 98
7206	         anchor attribute  54
7207	         inside back  19
7208	         inside boilerplate  21
7209	         inside middle  37
7210	         inside section  54
7211	         numbered attribute  54
7212	         removeInRFC attribute  54
7213	         title attribute  54
7214	         toc attribute  54

7216	      seriesInfo element  55, 98
7217	         asciiName attribute  55
7218	         asciiValue attribute  55
7219	         inside front  33
7220	         inside reference  44
7221	         name attribute  56
7222	         status attribute  56
7223	         stream attribute  56
7224	         value attribute  57
7225	      seriesNo attribute
7226	         in rfc element  51
7227	      sortRefs attribute
7228	         in rfc element  51
7229	      source attribute
7230	         in cref element  24
7231	      sourcecode element  57, 98
7232	         anchor attribute  58
7233	         inside blockquote  20
7234	         inside dd  25
7235	         inside figure  32
7236	         inside li  35
7237	         inside section  53
7238	         inside td  65
7239	         inside th  67
7240	         name attribute  58
7241	         src attribute  58
7242	         type attribute  58
7243	      spacing attribute
7244	         in dl element  28
7245	         in ol element  39
7246	         in ul element  72
7247	      spanx element  78, 98
7248	         inside annotation  12
7249	         inside c  75
7250	         inside postamble  77
7251	         inside preamble  78
7252	         inside t  62
7253	         style attribute  79
7254	         xml:space attribute  79
7255	      src attribute
7256	         in artwork element  15
7257	         in figure element  32
7258	         in sourcecode element  58
7259	      start attribute
7260	         in ol element  40
7261	      status attribute
7262	         in seriesInfo element  56
7263	      stream attribute
7264	         in seriesInfo element  56
7265	      street element  59, 98
7266	         ascii attribute  59
7267	         inside postal  42
7268	      strong element  59, 98
7269	         inside annotation  12
7270	         inside blockquote  20
7271	         inside c  75
7272	         inside cref  23
7273	         inside dd  26
7274	         inside dt  28
7275	         inside em  29
7276	         inside li  36
7277	         inside postamble  77
7278	         inside preamble  78
7279	         inside refcontent  43
7280	         inside sub  61
7281	         inside sup  62
7282	         inside t  62
7283	         inside td  66
7284	         inside th  68
7285	         inside tt  71
7286	      style attribute
7287	         in list element  77
7288	         in spanx element  79
7289	         in texttable element  80
7290	      sub element  60, 98
7291	         inside annotation  12
7292	         inside blockquote  20
7293	         inside c  75
7294	         inside cref  23
7295	         inside dd  26
7296	         inside dt  28
7297	         inside em  29
7298	         inside li  36
7299	         inside postamble  77
7300	         inside preamble  78
7301	         inside refcontent  43
7302	         inside strong  60
7303	         inside t  63
7304	         inside td  66
7305	         inside th  68
7306	         inside tt  71
7307	      subitem attribute
7308	         in iref element  35
7309	      submissionType attribute
7310	         in rfc element  52
7311	      sup element  61, 98
7312	         inside annotation  12
7313	         inside blockquote  21
7314	         inside c  75
7315	         inside cref  23
7316	         inside dd  26
7317	         inside dt  28
7318	         inside em  29
7319	         inside li  36
7320	         inside postamble  77
7321	         inside preamble  78
7322	         inside refcontent  43
7323	         inside strong  60
7324	         inside t  63
7325	         inside td  66
7326	         inside th  68
7327	         inside tt  71
7328	      suppress-title attribute
7329	         in figure element  32
7330	         in texttable element  80
7331	      surname attribute
7332	         in author element  19
7333	      svg element
7334	         inside artwork  14
7335	      symRefs attribute
7336	         in rfc element  52

7338	   T
7339	      t element  62, 98
7340	         anchor attribute  63
7341	         hangText attribute  63
7342	         inside abstract  11
7343	         inside aside  17
7344	         inside blockquote  20
7345	         inside dd  25
7346	         inside li  35
7347	         inside list  76
7348	         inside note  38
7349	         inside section  53
7350	         inside td  65
7351	         inside th  67
7352	         keepWithNext attribute  63
7353	         keepWithPrevious attribute  63
7354	      table element  64, 98
7355	         anchor attribute  64
7356	         inside aside  17
7357	         inside section  53
7358	      target attribute
7359	         in displayreference element  26
7360	         in eref element  31
7361	         in format element  76
7362	         in reference element  44
7363	         in relref element  49
7364	         in xref element  75
7365	      tbody element  64, 98
7366	         anchor attribute  65
7367	         inside table  64
7368	      td element  65, 98
7369	         align attribute  66
7370	         anchor attribute  66
7371	         colspan attribute  66
7372	         inside tr  70
7373	         rowspan attribute  66
7374	      texttable element  79, 98
7375	         align attribute  79
7376	         anchor attribute  80
7377	         inside section  54
7378	         style attribute  80
7379	         suppress-title attribute  80
7380	         title attribute  80
7381	      tfoot element  67, 98
7382	         anchor attribute  67
7383	         inside table  64
7384	      th element  67, 98
7385	         align attribute  68
7386	         anchor attribute  69
7387	         colspan attribute  69
7388	         inside tr  70
7389	         rowspan attribute  69
7390	      thead element  69, 98
7391	         anchor attribute  69
7392	         inside table  64
7393	      title attribute
7394	         in figure element  33
7395	         in note element  39
7396	         in references element  46
7397	         in section element  54
7398	         in texttable element  80
7399	      title element  69, 98
7400	         abbrev attribute  69
7401	         ascii attribute  70
7402	         inside front  33
7403	      to attribute
7404	         in displayreference element  27
7405	      toc attribute
7406	         in section element  54
7407	      tocDepth attribute
7408	         in rfc element  52
7409	      tocInclude attribute
7410	         in rfc element  52
7411	      tr element  70, 98
7412	         anchor attribute  70
7413	         inside tbody  64
7414	         inside tfoot  67
7415	         inside thead  69
7416	      tt element  70, 98
7417	         inside annotation  12
7418	         inside blockquote  21
7419	         inside c  75
7420	         inside cref  23
7421	         inside dd  26
7422	         inside dt  28
7423	         inside em  29
7424	         inside li  36
7425	         inside name  38
7426	         inside postamble  77
7427	         inside preamble  78
7428	         inside refcontent  43
7429	         inside strong  60
7430	         inside sub  61
7431	         inside sup  62
7432	         inside t  63
7433	         inside td  66
7434	         inside th  68
7435	      ttcol element  80, 98
7436	         align attribute  81
7437	         inside texttable  79
7438	         width attribute  81
7439	      type attribute
7440	         in artwork element  16
7441	         in format element  76
7442	         in ol element  40
7443	         in sourcecode element  58

7445	   U
7446	      ul element  71, 98
7447	         anchor attribute  71
7448	         empty attribute  71
7449	         inside abstract  11
7450	         inside aside  17
7451	         inside blockquote  20
7452	         inside dd  25
7453	         inside li  35
7454	         inside note  38
7455	         inside section  54
7456	         inside td  65
7457	         inside th  67
7458	         spacing attribute  72
7459	      updates attribute
7460	         in rfc element  52
7461	      uri element  72, 98
7462	         inside address  12

7464	   V
7465	      value attribute
7466	         in seriesInfo element  57
7467	      version attribute
7468	         in rfc element  53
7469	      vspace element  81, 98
7470	         blankLines attribute  81
7471	         inside t  63

7473	   W
7474	      width attribute
7475	         in artwork element  16
7476	         in figure element  33
7477	         in ttcol element  81
7478	      workgroup element  72, 98
7479	         inside front  33

7481	   X
7482	      xml:space attribute
7483	         in artwork element  16
7484	         in spanx element  79
7485	      xref element  72, 98
7486	         format attribute  73
7487	         inside annotation  13
7488	         inside blockquote  21
7489	         inside c  75
7490	         inside cref  23
7491	         inside dd  26
7492	         inside dt  28
7493	         inside em  29
7494	         inside li  36
7495	         inside name  38
7496	         inside postamble  77
7497	         inside preamble  78
7498	         inside strong  60
7499	         inside sub  61
7500	         inside sup  62
7501	         inside t  63
7502	         inside td  66
7503	         inside th  68
7504	         inside tt  71
7505	         inside ttcol  80
7506	         pageno attribute  74
7507	         target attribute  75
7508	      xref formats
7509	         counter  73
7510	         default  73
7511	         none  74
7512	         title  74

7514	   Y
7515	      year attribute
7516	         in date element  25

7518	Author's Address

7520	   Paul Hoffman
7521	   ICANN

7523	   EMail: paul.hoffman@icann.org