idnits 2.17.1 

draft-hoffman-xml2rfc-08.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 RFC2629, but the
     abstract doesn't seem to directly say this.  It does mention RFC2629
     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 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 (May 14, 2014) is 3628 days in the past.  Is this
     intentional?


  Checking references for intended status: Proposed Standard
  ----------------------------------------------------------------------------

     (See RFCs 3967 and 4897 for information about using normative references
     to lower-maturity documents in RFCs)

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

  -- Possible downref: Non-RFC (?) normative reference: ref. 'XML'

  -- Possible downref: Normative reference to a draft: ref. 'XML2RFCv2' 

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

  -- Obsolete informational reference (is this intentional?): RFC 3023
     (Obsoleted by RFC 7303)

  -- Obsolete informational reference (is this intentional?): RFC 5741
     (Obsoleted by RFC 7841)


     Summary: 0 errors (**), 0 flaws (~~), 3 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                                            VPN Consortium
4	Obsoletes: 2629 (if approved)                               May 14, 2014
5	Intended status: Standards Track
6	Expires: November 15, 2014

8	                   The 'XML2RFC' version 3 Vocabulary
9	                        draft-hoffman-xml2rfc-08

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 v2 grammar described in RFC
17	   2629 and its expected followup, draft-reschke-xml2rfc.

19	Editorial Note (To be removed by RFC Editor)

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

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 November 15, 2014.

42	Copyright Notice

44	   Copyright (c) 2014 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.  Design Criteria for the Changes in v3 . . . . . . . . . .   5
61	     1.2.  Differences from v2 to v3 . . . . . . . . . . . . . . . .   6
62	       1.2.1.  New Elements in v3  . . . . . . . . . . . . . . . . .   6
63	       1.2.2.  New Attributes for Existing Elements  . . . . . . . .   7
64	       1.2.3.  Elements and Attributes Deprecated from v2  . . . . .   7
65	       1.2.4.  Additional Changes from v2  . . . . . . . . . . . . .   8
66	     1.3.  Syntax Notation . . . . . . . . . . . . . . . . . . . . .   9
67	   2.  Elements  . . . . . . . . . . . . . . . . . . . . . . . . . .   9
68	     2.1.  <abstract>  . . . . . . . . . . . . . . . . . . . . . . .   9
69	     2.2.  <address> . . . . . . . . . . . . . . . . . . . . . . . .   9
70	     2.3.  <annotation>  . . . . . . . . . . . . . . . . . . . . . .  10
71	     2.4.  <area>  . . . . . . . . . . . . . . . . . . . . . . . . .  11
72	     2.5.  <artwork> . . . . . . . . . . . . . . . . . . . . . . . .  11
73	     2.6.  <aside> . . . . . . . . . . . . . . . . . . . . . . . . .  14
74	     2.7.  <author>  . . . . . . . . . . . . . . . . . . . . . . . .  14
75	     2.8.  <b> . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
76	     2.9.  <back>  . . . . . . . . . . . . . . . . . . . . . . . . .  16
77	     2.10. <blockquote>  . . . . . . . . . . . . . . . . . . . . . .  17
78	     2.11. <c> . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
79	     2.12. <city>  . . . . . . . . . . . . . . . . . . . . . . . . .  18
80	     2.13. <code>  . . . . . . . . . . . . . . . . . . . . . . . . .  18
81	     2.14. <country> . . . . . . . . . . . . . . . . . . . . . . . .  19
82	     2.15. <cref>  . . . . . . . . . . . . . . . . . . . . . . . . .  19
83	     2.16. <date>  . . . . . . . . . . . . . . . . . . . . . . . . .  20
84	     2.17. <dd>  . . . . . . . . . . . . . . . . . . . . . . . . . .  21
85	     2.18. <displayreference>  . . . . . . . . . . . . . . . . . . .  22
86	     2.19. <dl>  . . . . . . . . . . . . . . . . . . . . . . . . . .  22
87	     2.20. <dt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  23
88	     2.21. <em>  . . . . . . . . . . . . . . . . . . . . . . . . . .  24
89	     2.22. <email> . . . . . . . . . . . . . . . . . . . . . . . . .  25
90	     2.23. <eref>  . . . . . . . . . . . . . . . . . . . . . . . . .  25
91	     2.24. <facsimile> . . . . . . . . . . . . . . . . . . . . . . .  26
92	     2.25. <figure>  . . . . . . . . . . . . . . . . . . . . . . . .  26
93	     2.26. <format>  . . . . . . . . . . . . . . . . . . . . . . . .  28
94	     2.27. <front> . . . . . . . . . . . . . . . . . . . . . . . . .  28
95	     2.28. <i> . . . . . . . . . . . . . . . . . . . . . . . . . . .  29
96	     2.29. <iref>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
97	     2.30. <keyword> . . . . . . . . . . . . . . . . . . . . . . . .  30
98	     2.31. <li>  . . . . . . . . . . . . . . . . . . . . . . . . . .  31
99	     2.32. <link>  . . . . . . . . . . . . . . . . . . . . . . . . .  32
100	     2.33. <list>  . . . . . . . . . . . . . . . . . . . . . . . . .  33
101	     2.34. <middle>  . . . . . . . . . . . . . . . . . . . . . . . .  33
102	     2.35. <note>  . . . . . . . . . . . . . . . . . . . . . . . . .  33
103	     2.36. <ol>  . . . . . . . . . . . . . . . . . . . . . . . . . .  34
104	     2.37. <organization>  . . . . . . . . . . . . . . . . . . . . .  35
105	     2.38. <phone> . . . . . . . . . . . . . . . . . . . . . . . . .  36
106	     2.39. <postal>  . . . . . . . . . . . . . . . . . . . . . . . .  36
107	     2.40. <postalLine>  . . . . . . . . . . . . . . . . . . . . . .  37
108	     2.41. <postamble> . . . . . . . . . . . . . . . . . . . . . . .  37
109	     2.42. <preamble>  . . . . . . . . . . . . . . . . . . . . . . .  38
110	     2.43. <refcontent>  . . . . . . . . . . . . . . . . . . . . . .  39
111	     2.44. <reference> . . . . . . . . . . . . . . . . . . . . . . .  40
112	     2.45. <references>  . . . . . . . . . . . . . . . . . . . . . .  40
113	     2.46. <region>  . . . . . . . . . . . . . . . . . . . . . . . .  41
114	     2.47. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . .  41
115	     2.48. <section> . . . . . . . . . . . . . . . . . . . . . . . .  46
116	     2.49. <seriesInfo>  . . . . . . . . . . . . . . . . . . . . . .  48
117	     2.50. <sourcecode>  . . . . . . . . . . . . . . . . . . . . . .  48
118	     2.51. <spanx> . . . . . . . . . . . . . . . . . . . . . . . . .  50
119	     2.52. <street>  . . . . . . . . . . . . . . . . . . . . . . . .  51
120	     2.53. <strong>  . . . . . . . . . . . . . . . . . . . . . . . .  51
121	     2.54. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . .  52
122	     2.55. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . .  53
123	     2.56. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . .  54
124	     2.57. <texttable> . . . . . . . . . . . . . . . . . . . . . . .  55
125	     2.58. <title> . . . . . . . . . . . . . . . . . . . . . . . . .  57
126	     2.59. <titleelement>  . . . . . . . . . . . . . . . . . . . . .  57
127	     2.60. <tt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  58
128	     2.61. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . .  59
129	     2.62. <ul>  . . . . . . . . . . . . . . . . . . . . . . . . . .  59
130	     2.63. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . .  60
131	     2.64. <vspace>  . . . . . . . . . . . . . . . . . . . . . . . .  60
132	     2.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . .  61
133	     2.66. <xref>  . . . . . . . . . . . . . . . . . . . . . . . . .  61
134	   3.  Internationalization Considerations . . . . . . . . . . . . .  64
135	   4.  Security Considerations . . . . . . . . . . . . . . . . . . .  64
136	   5.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  64
137	     5.1.  Internet Media Type Registration  . . . . . . . . . . . .  64
138	     5.2.  Link Relation Registration  . . . . . . . . . . . . . . .  66
139	   6.  Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .  66
140	   7.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  66
141	     7.1.  Normative References  . . . . . . . . . . . . . . . . . .  66
142	     7.2.  Informative References  . . . . . . . . . . . . . . . . .  67
143	   Appendix A.  Front Page Generation  . . . . . . . . . . . . . . .  69
144	     A.1.  The /rfc/@category Attribute  . . . . . . . . . . . . . .  69
145	     A.2.  The /rfc/@ipr Attribute . . . . . . . . . . . . . . . . .  69
146	       A.2.1.  Current Values: '*trust200902'  . . . . . . . . . . .  70
147	       A.2.2.  Historic Values . . . . . . . . . . . . . . . . . . .  71
148	   Appendix B.  The v3 Format and Processors . . . . . . . . . . . .  72
149	     B.1.  Including External Text . . . . . . . . . . . . . . . . .  73
150	   Appendix C.  Format and Content of RFCs (Future)  . . . . . . . .  74
151	     C.1.  Canonical RFCs  . . . . . . . . . . . . . . . . . . . . .  74
152	     C.2.  Non-canonical RFC Representations . . . . . . . . . . . .  75
153	   Appendix D.  Format and Content of Internet Drafts (Future) . . .  75
154	     D.1.  The Draft Processor . . . . . . . . . . . . . . . . . . .  75
155	     D.2.  Processor Instructions  . . . . . . . . . . . . . . . . .  76
156	   Appendix E.  Relax NG Schema  . . . . . . . . . . . . . . . . . .  77
157	   Appendix F.  Schema Differences from v2 . . . . . . . . . . . . .  88
158	   Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

160	1.  Introduction

162	   This document describes version 3 ('v3') of the 'XML2RFC' vocabulary;
163	   an XML-based language ('Extensible Markup Language', [XML]) used for
164	   writing RFCs ([RFCSTYLE]) and Internet-Drafts ([IDGUIDE]).

166	   This document obsoletes the version ("v2") vocabulary [XML2RFCv2],
167	   which contains the extended language definition.  That document in
168	   turn obsoletes the original version ("v1") [RFC2629].  This document
169	   directly copies the material from [XML2RFCv2] where possible; as that
170	   document makes its way toward RFC publication, this document will
171	   incorporate as many of the changes as possible. [[anchor2: More needs
172	   to be said here about what "obsoletes" means in this case.]]

174	   The v3 format will be used as part of the new RFC series described in
175	   [RFC6949].  The new format will be handled by one or more new
176	   processors for checking the XML and converting it to other
177	   representations.  Features of the expected processors are described
178	   in Appendix B.

180	   Note that the vocabulary contains certain constructs that might not
181	   affect the rendering of the final text; however, they can provide
182	   useful data for other uses (such index generation, populating a
183	   keyword database, or syntax checks).

185	   The following is a hopefully-complete list of all the technical
186	   changes between [XML2RFCv2] and this document, as well as the design
187	   criteria for those changes.  Note that the list is for the current
188	   version of this document only.  There are additional changes that are
189	   expected to the v3 vocabulary that are being discussed.  Also note
190	   that changes to the design choices for the differences are also
191	   expected.

193	1.1.  Design Criteria for the Changes in v3

195	   The design criteria of the changes from v2 to v3 are:

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

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

203	   o  There are no current plans to make v3 XML the required submission
204	      representation for drafts or RFCs.  That might happen eventually,
205	      but it is likely to be years away.

207	   There is a desire to keep as much of the v2 grammar as makes sense
208	   within the above design criteria and not to make gratuitous changes
209	   to the v2 grammar.  Another way to say this is "we would rather
210	   encourage backward compatibility but not be constrained by it".
211	   Still, the goal of starting and editing a v3 document being easier
212	   than for a v2 document is more important than backwards compatibility
213	   with v2, given the latter two design criteria.

215	   v3 is upwards compatible with v2, meaning that a v2 document is meant
216	   to be a valid v3 document as well.  However, some features of v2 are
217	   deprecated in v3 in favor of new elements.  Deprecated features are
218	   listed in Section 1.2.3, and are described in [XML2RFCv2], not in
219	   this document.

221	1.2.  Differences from v2 to v3

223	   The format changes in v3 are listed in the following subsections.

225	1.2.1.  New Elements in v3

227	   o  Add <dl>, <ul>, and <ol> as new ways to make lists.  This is a
228	      significant change from v2 in that the child under these elements
229	      is <li>, not <t>. <li> has a model of either containing one or
230	      more <t> elements, or containing the flowing text normally found
231	      in <t>.

233	   o  Add <strong>, <b>, <em>, <i>, <tt>, <sub>, and <sup> for character
234	      formatting.

236	   o  Add <aside> for incidental text that will be indented when
237	      displayed.

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

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

244	   o  Add <titleelement> to sections, figures, and texttables to allow
245	      character formatting (fixed-width font) in their titles, and to
246	      allow references.

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

251	   o  Add <displayreference> to allow display of more mneumonic anchor
252	      names for automatically-included references.

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

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

258	1.2.2.  New Attributes for Existing Elements

260	   o  Add "sortRefs", "symRefs", "tocDepth", and "tocInclude" attributes
261	      to <rfc> to cover processor instructions (PIs) that were in v2
262	      that are still needed in the grammar.

264	   o  Add "ascii" attributes to <author>, <email>, <organization>,
265	      <street>, <city>, <region> and <code>.  This allows an author to
266	      specify their information in their native scripts as the primary
267	      entry and still allow the ASCII-equivalent values to appear in the
268	      processed documents.

270	   o  Add "xml:lang" attribute to <artwork>, <postal>, and <author>.
271	      This is sometimes useful for renderers which display different
272	      fonts for ideographic characters used in China and Japan.

274	   o  Add the "section", "relative", and "sectionFormat" attributes to
275	      <xref>.

277	   o  Add the "numbered" and "removeinrfc" attributes to <section>.

279	   o  Add "autogeneratedBoilerplateText", "autogeneratedSectionNumber",
280	      "autogeneratedFigureNumber", and "autogeneratedTableNumber"
281	      attributes to <rfc>, <section>, <figure>, and <texttable>,
282	      respectively.

284	1.2.3.  Elements and Attributes Deprecated from v2

286	   Deprecated elements and attributes are legacy vocabulary from v2 that
287	   are supported for input to v3 processors.  They are likely to be
288	   removed from those processors in the future.  See Appendix B for more
289	   information on processors and how they will handle deprecated
290	   features.

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

294	   o  Deprecate <spanx>; replace it with <strong>, <b>, <em>, <i>, and
295	      <tt>.

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

300	   o  Deprecate <facsimile> because it is rarely used and is not
301	      actually useful; <email> is a much more useful way to get in touch
302	      with authors.

304	   o  Deprecate <format> because it is not useful and has caused
305	      surprise for authors in the past.  If the goal is to provide a
306	      single URI for a reference, use the "target" attribute on
307	      <reference> instead.

309	   o  Deprecate the "title" attribute in <section>, <figure>, and
310	      <texttable> in favor of the new <titleelement>.

312	   o  Deprecate the "alt", "height", "src", and "width" attributes in
313	      <figure> because they overlap with the attributes in <artwork>.

315	   o  Deprecate the "xml:space" attribute in <artwork> because there was
316	      only one useful value.  Deprecate "height" and "width" attribute.

318	   o  Deprecate the "pageno" attribute in <xref> because it was unused
319	      in v2.  Deprecate the "none" and "title" values for the "format"
320	      attribute in <xref> because the former makes no sense semantically
321	      and the latter because it has unpredictable output.

323	1.2.4.  Additional Changes from v2

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

328	   o  Allow <artwork> to be used on its own in <section> (no longer
329	      confine it to a figure).

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

333	   o  In <address>, allow the sub-elements to be in any order.

335	   o  Allow <strong>, <b>, <em>, <i>, <tt>, <eref>, and <xref> in
336	      <cref>.

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

340	   o  Turned off the auto-generation of anchors in <cref> because there
341	      is no use case for them that cannot be achieved in other ways.

343	   o  Allow more than one <artwork>, or more than one <sourcecode>, in
344	      <figure>.

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

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

352	   o  In <ttcol>, allow <xref>, <eref>, <iref>, and <cref> as optional
353	      children.

355	   o  Do not generate the grammar from a DTD, but instead get it
356	      directly from the Relax Next Generation (RNG) grammar [RNG].

358	1.3.  Syntax Notation

360	   The XML vocabulary here is defined in prose, based on the Relax NG
361	   schema ([RNC]) contained in Appendix E (specified in Relax NG Compact
362	   Notation, "RNC").

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

368	2.  Elements

370	   The sections below describe all elements and their attributes.

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

374	   Many elements have an optional "anchor" attribute.  In all cases, the
375	   value of the "anchor" attribute needs to be a valid XML "Name"
376	   (Section 2.3 of [XML]).  In short, it is a text string with no spaces
377	   or colons; hyphens and underscores are allowed.

379	2.1.  <abstract>

381	   Contains the abstract of the document.  See [RFCSTYLE] for more
382	   information on restrictions for the abstract.

384	   This element appears as child element of: <front> (Section 2.27).

386	   Content model:

388	   One or more <t> elements (Section 2.56)

390	2.2.  <address>

392	   Provides address information for the author.

394	   This element appears as child element of: <author> (Section 2.7).

396	   Content model:

398	   In any order:

400	   o  <postal> elements (Section 2.39)

402	   o  <phone> elements (Section 2.38)

404	   o  <facsimile> elements (Section 2.24)

406	   o  <email> elements (Section 2.22)

408	   o  <uri> elements (Section 2.63)

410	2.3.  <annotation>

412	   Provides additional prose augmenting a bibliographical reference.

414	   For instance:

416	   <annotation>
417	     Latest version available at <eref
418	     target='http://www.w3.org/TR/xml'/>.
419	   </annotation>

421	   ...will generate the text used in the reference for [XML].

423	   This element appears as child element of: <reference> (Section 2.44).

425	   Content model:

427	   In any order:

429	   o  Text

431	   o  <xref> elements (Section 2.66)

433	   o  <eref> elements (Section 2.23)

435	   o  <iref> elements (Section 2.29)

437	   o  <cref> elements (Section 2.15)

439	   o  <spanx> elements (Section 2.51)

441	   o  <tt> elements (Section 2.60)

443	   o  <strong> elements (Section 2.53)

445	   o  <b> elements (Section 2.8)
446	   o  <em> elements (Section 2.21)

448	   o  <i> elements (Section 2.28)

450	   o  <sub> elements (Section 2.54)

452	   o  <sup> elements (Section 2.55)

454	2.3.1.  'ascii' attribute

456	   The ASCII equivalent of the annotation.

458	2.4.  <area>

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

463	   The value ought to be either the fullname or the abbreviation of one
464	   of the IETF areas as listed on <http://www.ietf.org/iesg/area.html>.
465	   The list at the time that this document is being published is:
466	   "Applications", "app", "General", "gen", "Internet", "int",
467	   "Operations and Management", "ops", "Real-time Applications and
468	   Infrastructure", "rai", "Routing", "rtg", "Security", "sec",
469	   "Transport", "tsv", but that list will likely change over time.

471	   This element appears as child element of: <front> (Section 2.27).

473	   Content model: only text content.

475	2.5.  <artwork>

477	   This element allows the inclusion of "artwork" into the document.

479	   <artwork> provides full control of horizontal whitespace and line
480	   breaks, and thus is used for a variety of things, such as:

482	   o  diagrams ("line art"),

484	   o  complex tables, or

486	   o  protocol unit diagrams.

488	   Alternatively, the "src" attribute allows referencing an external
489	   graphics file, such as a bitmap or a vector drawing, using a URI.  In
490	   this case, the textual content acts as fallback for output
491	   representations that do not support graphics, and thus ought to
492	   contain either a "line art" variant of the graphics, or otherwise
493	   prose that describes the included image in sufficient detail.

495	   If the artwork includes either "&" or "<" characters, or the string
496	   "]]>" those characters need to be encoded using escaping or CDATA
497	   block(s); see <sourcecode> for a fuller description of these
498	   solutions.

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

503	   This element appears as child element of: <aside> (Section 2.6),
504	   <blockquote> (Section 2.10), <dd> (Section 2.17), <figure>
505	   (Section 2.25), <li> (Section 2.31), <section> (Section 2.48), and
506	   <t> (Section 2.56).

508	   Content model:

510	   Text

512	2.5.1.  'align' attribute

514	   Controls whether the artwork appears left (default), centered, or
515	   right.

517	   Allowed values:

519	   o  "left" (default)

521	   o  "center"

523	   o  "right"

525	2.5.2.  'alt' attribute

527	   Alternative text description of the artwork (not just the caption).

529	2.5.3.  'height' attribute

531	   Deprecated.

533	2.5.4.  'name' attribute

535	   A filename suitable for the contents (such as for extraction to a
536	   local file).

538	   This attribute generally isn't used for document generation, but it
539	   can be helpful for other kinds of tools (such as automated syntax
540	   checkers which work by extracting the artwork).

542	2.5.5.  'src' attribute

544	   The URI of a graphics file.

546	   Note that this can be a "data" URI ([RFC2397]) as well, in which case
547	   the graphics file is wholly part of the XML file.

549	   [[anchor7: Add an example of in-lined SVG here.]]

551	2.5.6.  'type' attribute

553	   Specifies the type of the artwork.  The value of this attribute is
554	   free text with certain values designated as preferred.  A private
555	   processor (as described in Appendix B) might add type-specific
556	   formatting to artwork with the preferred values.  If a processor
557	   encounters a value for "type" that is not one of the preferred
558	   values, it can issue a warning but should still use the artwork as if
559	   it had no "type" attribute.

561	   The preferred values for <artwork> types are:

563	   o  ascii-art

565	   o  call-flow

567	   o  hex-dump

569	   o  svg

571	   The RFC Editor will maintain a complete list of the preferred values
572	   on its web site, and that list is expected to be updated over time.
573	   Thus, a consumer of v3 XML should not cause a failure when it
574	   encounters an unexpected type.

576	2.5.7.  'width' attribute

578	   Deprecated.

580	2.5.8.  'xml:lang' attribute

582	   Allows specification of the language used.  This is sometimes useful
583	   for renderers which display different fonts for ideographic
584	   characters used in China and Japan.

586	2.5.9.  'xml:space' attribute

588	   Deprecated.

590	2.6.  <aside>

592	   This element is a container for content that is semantically less
593	   important or tangential to the content that surrounds it.  The
594	   elements inside this container are indented from both margins when
595	   displayed.

597	   This element appears as child element of: <section> (Section 2.48).

599	   Content model:

601	   In any order:

603	   o  <t> elements (Section 2.56)

605	   o  <figure> elements (Section 2.25)

607	   o  <texttable> elements (Section 2.57)

609	   o  <iref> elements (Section 2.29)

611	   o  <artwork> elements (Section 2.5)

613	   o  <sourcecode> elements (Section 2.50)

615	2.7.  <author>

617	   Provides information about a document's author.  This is used both
618	   for the document itself (at the beginning of the document) and for
619	   referenced documents (inside of <reference>).

621	   The <author> elements contained within the document's <front> element
622	   are used to fill the boilerplate, and also to generate the "Author's
623	   Address" section (see [RFCSTYLE]).

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

629	   Furthermore, the "role" attribute can be used to mark an author as
630	   "editor".  This is reflected both on the front page and in
631	   bibliographical references.  Note that this specification does not
632	   define a precise meaning for the term "editor".  For RFCs, it is the
633	   stream that determines who is listed as authors or editors.

635	   See Section "Authors vs. Contributors" of [RFCPOLICY] for more
636	   information.

638	   This element appears as child element of: <front> (Section 2.27).

640	   Content model:

642	   In this order:

644	   1.  One optional <organization> element (Section 2.37)

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

648	2.7.1.  'ascii' attribute

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

652	2.7.2.  'fullname' attribute

654	   The full name (used in the automatically generated "Author's Address"
655	   section).

657	2.7.3.  'initials' attribute

659	   Author initials (used on the front page and in references).

661	   The value contains one or more initials, each followed by a period.

663	2.7.4.  'role' attribute

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

667	   Allowed values:

669	   o  "editor"

671	2.7.5.  'surname' attribute

673	   The author's surname.

675	2.7.6.  'xml:lang' attribute

677	   Allows specification of the language used.  This is sometimes useful
678	   for renderers which display different fonts for CJK characters.

680	2.8.  <b>

682	   Causes the text to be displayed in bold.  It is almost always a
683	   better idea to use the <strong> element instead.  This element can be
684	   combined with other character formatting elements, and the formatting
685	   will be additive.

687	   This element appears as child element of: <annotation> (Section 2.3),
688	   <blockquote> (Section 2.10), <c> (Section 2.11), <cref>
689	   (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <em>
690	   (Section 2.21), <i> (Section 2.28), <li> (Section 2.31), <postamble>
691	   (Section 2.41), <preamble> (Section 2.42), <refcontent>
692	   (Section 2.43), <sub> (Section 2.54), <sup> (Section 2.55), <t>
693	   (Section 2.56), and <tt> (Section 2.60).

695	   Content model:

697	   In any order:

699	   o  Text

701	   o  <xref> elements (Section 2.66)

703	   o  <eref> elements (Section 2.23)

705	   o  <iref> elements (Section 2.29)

707	   o  <cref> elements (Section 2.15)

709	   o  <tt> elements (Section 2.60)

711	   o  <em> elements (Section 2.21)

713	   o  <i> elements (Section 2.28)

715	   o  <sub> elements (Section 2.54)

717	   o  <sup> elements (Section 2.55)

719	2.9.  <back>

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

724	   This element appears as child element of: <rfc> (Section 2.47).

726	   Content model:

728	   In this order:

730	   1.  Optional <displayreference> elements (Section 2.18)

732	   2.  Optional <references> elements (Section 2.45)
733	   3.  Optional <section> elements (Section 2.48)

735	2.10.  <blockquote>

737	   Specifies a block of text is a quotation.  The "cite" attribute is
738	   required, and must be a URI.

740	   This element appears as child element of: <section> (Section 2.48).

742	   Content model:

744	   In any order:

746	   o  Text

748	   o  <figure> elements (Section 2.25)

750	   o  <artwork> elements (Section 2.5)

752	   o  <sourcecode> elements (Section 2.50)

754	   o  <tt> elements (Section 2.60)

756	   o  <strong> elements (Section 2.53)

758	   o  <b> elements (Section 2.8)

760	   o  <em> elements (Section 2.21)

762	   o  <i> elements (Section 2.28)

764	   o  <sub> elements (Section 2.54)

766	   o  <sup> elements (Section 2.55)

768	2.10.1.  'anchor' attribute

770	   Document-wide unique identifier for this quotation.

772	2.10.2.  'cite' attribute (mandatory)

774	   The source of the citation.  This must be a URI. [[anchor8: Needs an
775	   example of a cite for a reference that is already in the spec.]]

777	2.11.  <c>

779	   Provides the content of a cell in a table.

781	   This element appears as child element of: <texttable> (Section 2.57).

783	   Content model:

785	   In any order:

787	   o  Text

789	   o  <xref> elements (Section 2.66)

791	   o  <eref> elements (Section 2.23)

793	   o  <iref> elements (Section 2.29)

795	   o  <cref> elements (Section 2.15)

797	   o  <spanx> elements (Section 2.51)

799	   o  <tt> elements (Section 2.60)

801	   o  <strong> elements (Section 2.53)

803	   o  <b> elements (Section 2.8)

805	   o  <em> elements (Section 2.21)

807	   o  <i> elements (Section 2.28)

809	   o  <sub> elements (Section 2.54)

811	   o  <sup> elements (Section 2.55)

813	2.12.  <city>

815	   Gives the city name in a postal address.

817	   This element appears as child element of: <postal> (Section 2.39).

819	   Content model: only text content.

821	2.12.1.  'ascii' attribute

823	   The ASCII equivalent of the city name.

825	2.13.  <code>

827	   Gives the postal region code.

829	   This element appears as child element of: <postal> (Section 2.39).

831	   Content model: only text content.

833	2.13.1.  'ascii' attribute

835	   The ASCII equivalent of the postal code.

837	2.14.  <country>

839	   Gives the country in a postal address.

841	   This element appears as child element of: <postal> (Section 2.39).

843	   Content model: only text content.

845	2.15.  <cref>

847	   Represents a comment.

849	   Comments can be used in a document while it is work-in-progress.
850	   They usually appear either inline and visually highlighted, at the
851	   end of the document (depending on file representation and settings of
852	   the processor), or not at all (when generating an RFC).

854	   This element appears as child element of: <annotation> (Section 2.3),
855	   <b> (Section 2.8), <c> (Section 2.11), <dd> (Section 2.17), <dt>
856	   (Section 2.20), <em> (Section 2.21), <i> (Section 2.28), <li>
857	   (Section 2.31), <postamble> (Section 2.41), <preamble>
858	   (Section 2.42), <strong> (Section 2.53), <sub> (Section 2.54), <sup>
859	   (Section 2.55), <t> (Section 2.56), <titleelement> (Section 2.59),
860	   <tt> (Section 2.60), and <ttcol> (Section 2.61).

862	   Content model:

864	   In any order:

866	   o  Text

868	   o  <xref> elements (Section 2.66)

870	   o  <eref> elements (Section 2.23)

872	   o  <tt> elements (Section 2.60)

874	   o  <strong> elements (Section 2.53)
875	   o  <b> elements (Section 2.8)

877	   o  <em> elements (Section 2.21)

879	   o  <i> elements (Section 2.28)

881	   o  <sub> elements (Section 2.54)

883	   o  <sup> elements (Section 2.55)

885	2.15.1.  'anchor' attribute

887	   Document-wide unique identifier for this comment.

889	2.15.2.  'source' attribute

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

894	2.16.  <date>

896	   Provides information about the publication date.

898	   Note that this element is used both for the boilerplate of the
899	   document being produced, and also inside bibliographic references
900	   that use the <front> element.

902	   In the first case, it defines the date of publication for the current
903	   document (Internet Draft or RFC).  When producing Internet-Drafts,
904	   the Draft Processor uses this date to compute the expiration date
905	   (see [IDGUIDE]).  When "year", "month" or "day" are left out, the
906	   processor will attempt to use the current system date if the
907	   attributes that are specified do match the system date.

909	   Also in the first case, that month names, if given, need to match the
910	   full English month name: "January", "February", "March", "April",
911	   "May, "June", "July", "August", "September", "October", "November",
912	   or "December".

914	   In the second case, the date information can have prose text for the
915	   month or year.  For example, vague dates (year="ca. 2000"), date
916	   ranges (year="2012-2013") non-specific months (month="Second
917	   quarter") and so on, are allowed.

919	   This element appears as child element of: <front> (Section 2.27).

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

923	2.16.1.  'day' attribute

925	   Day of publication; this is a number.

927	2.16.2.  'month' attribute

929	   Month of publication; this is the English name of the month.

931	2.16.3.  'year' attribute

933	   Year of publication.

935	2.17.  <dd>

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

939	   This element appears as child element of: <dl> (Section 2.19).

941	   Content model:

943	   Either:

945	   o  One or more <t> elements (Section 2.56)

947	   Or:

949	   o  One or more sequences of:

951	      1.   One <ol> element

953	      2.   One <ul> element

955	      3.   One <dl> element

957	      4.   One <figure> element

959	      5.   One <artwork> element

961	      6.   One <sourcecode> element

963	      7.   One <xref> element

965	      8.   One <eref> element

967	      9.   One <iref> element

969	      10.  One <cref> element
970	      11.  One <tt> element

972	      12.  One <strong> element

974	      13.  One <b> element

976	      14.  One <em> element

978	      15.  One <i> element

980	      16.  One <sub> element

982	      17.  One <sup> element

984	2.18.  <displayreference>

986	   This element gives a mapping between the anchor of a reference and a
987	   name that will be displayed instead.  This allows authors to display
988	   more mneumonic anchor names for automatically-included references.
989	   For example, if the reference uses the anchor "RFC6949", the
990	   following would cause that anchor in the body of displayed documents
991	   to be "RFC-dev":

993	   <displayreference from="RFC6449" to="RFC-dev"/>

995	   This element appears as child element of: <back> (Section 2.9).

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

999	2.18.1.  'from' attribute (mandatory)

1001	   This attribute must be the name of an anchor in a <reference>
1002	   element.

1004	2.18.2.  'to' attribute (mandatory)

1006	   This attribute is a name that will be displayed as the anchor instead
1007	   of the anchor that is given in the <reference> element.  The string
1008	   given must start with one of the following characters: 0-9, a-z, A-Z.
1009	   The other characters in the string must be 0-9, a-z, A-Z, "-", ".",
1010	   and "_".

1012	2.19.  <dl>

1014	   A definition list.  Each entry has a pair of elements: a term (<dt>)
1015	   and a definition (<dd>).

1017	   [[anchor9: The content model below is wrong in the -05 draft.]]
1018	   This element appears as child element of: <dd> (Section 2.17), <li>
1019	   (Section 2.31), and <t> (Section 2.56).

1021	   Content model:

1023	   One or more sequences of:

1025	   1.  One <dt> element

1027	   2.  One <dd> element

1029	2.19.1.  'hanging' attribute

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

1036	   Allowed values:

1038	   o  "false" (default)

1040	   o  "true"

1042	2.19.2.  'spacing' attribute

1044	   Defines whether or not there is a blank line between entries.
1045	   spacing="normal" indicates a single blank line, while
1046	   spacing="compact" indicates no space between.

1048	   Allowed values:

1050	   o  "normal" (default)

1052	   o  "compact"

1054	2.20.  <dt>

1056	   The term being defined in a definition list.

1058	   This element appears as child element of: <dl> (Section 2.19).

1060	   Content model:

1062	   In any order:

1064	   o  Text
1065	   o  <xref> elements (Section 2.66)

1067	   o  <eref> elements (Section 2.23)

1069	   o  <iref> elements (Section 2.29)

1071	   o  <cref> elements (Section 2.15)

1073	   o  <tt> elements (Section 2.60)

1075	   o  <strong> elements (Section 2.53)

1077	   o  <b> elements (Section 2.8)

1079	   o  <em> elements (Section 2.21)

1081	   o  <i> elements (Section 2.28)

1083	   o  <sub> elements (Section 2.54)

1085	   o  <sup> elements (Section 2.55)

1087	2.21.  <em>

1089	   Indicates text that is semantically empahsized.  This element will be
1090	   displayed as italic after processing.  This element has the same
1091	   effects as <i>.

1093	   This element appears as child element of: <annotation> (Section 2.3),
1094	   <b> (Section 2.8), <blockquote> (Section 2.10), <c> (Section 2.11),
1095	   <cref> (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <li>
1096	   (Section 2.31), <postamble> (Section 2.41), <preamble>
1097	   (Section 2.42), <refcontent> (Section 2.43), <strong> (Section 2.53),
1098	   <sub> (Section 2.54), <sup> (Section 2.55), <t> (Section 2.56), and
1099	   <tt> (Section 2.60).

1101	   Content model:

1103	   In any order:

1105	   o  Text

1107	   o  <xref> elements (Section 2.66)

1109	   o  <eref> elements (Section 2.23)

1111	   o  <iref> elements (Section 2.29)
1112	   o  <cref> elements (Section 2.15)

1114	   o  <tt> elements (Section 2.60)

1116	   o  <strong> elements (Section 2.53)

1118	   o  <b> elements (Section 2.8)

1120	   o  <sub> elements (Section 2.54)

1122	   o  <sup> elements (Section 2.55)

1124	2.22.  <email>

1126	   Provides an email address.

1128	   The value is expected to be the scheme-specific part of a "mailto"
1129	   URI (so does not include the prefix "mailto:").  See Section 2 of
1130	   [RFC6068] for details.

1132	   This element appears as child element of: <address> (Section 2.2).

1134	   Content model: only text content.

1136	2.22.1.  'ascii' attribute

1138	   The ASCII equivalent of the author's email address.  This is only
1139	   used if the email address has one or two internationalized
1140	   components.

1142	2.23.  <eref>

1144	   Represents an "external" link (as specified in the "target"
1145	   attribute).  This can be used for creating linked references, such as
1146	   in HTML output.

1148	   If the element has text content, that content will be used.
1149	   Otherwise, the value of the target attribute will be inserted in
1150	   angle brackets ([RFC3986], Appendix C).

1152	   This element appears as child element of: <annotation> (Section 2.3),
1153	   <b> (Section 2.8), <c> (Section 2.11), <cref> (Section 2.15), <dd>
1154	   (Section 2.17), <dt> (Section 2.20), <em> (Section 2.21), <i>
1155	   (Section 2.28), <li> (Section 2.31), <postamble> (Section 2.41),
1156	   <preamble> (Section 2.42), <strong> (Section 2.53), <sub>
1157	   (Section 2.54), <sup> (Section 2.55), <t> (Section 2.56),
1158	   <titleelement> (Section 2.59), <tt> (Section 2.60), and <ttcol>
1159	   (Section 2.61).

1161	   Content model: only text content.

1163	2.23.1.  'target' attribute (mandatory)

1165	   URI of the link target (see Section 3 of [RFC3986]).

1167	2.24.  <facsimile>

1169	   Deprecated.

1171	   This element appears as child element of: <address> (Section 2.2).

1173	   Content model: only text content.

1175	2.25.  <figure>

1177	   This element is used to represent a figure, consisting of an optional
1178	   preamble, the actual figure, an optional postamble, and an optional
1179	   title.

1181	   This element appears as child element of: <aside> (Section 2.6),
1182	   <blockquote> (Section 2.10), <dd> (Section 2.17), <li>
1183	   (Section 2.31), <section> (Section 2.48), and <t> (Section 2.56).

1185	   Content model:

1187	   In this order:

1189	   1.  One optional <titleelement> element (Section 2.59)

1191	   2.  Optional <iref> elements (Section 2.29)

1193	   3.  One optional <preamble> element (Section 2.42)

1195	   4.  [[anchor10: Missing template for oneOrMore.]]

1197	   5.  One optional <postamble> element (Section 2.41)

1199	2.25.1.  'align' attribute

1201	   Used to change the alignment of <preamble> and <postamble>.

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

1205	   Allowed values:

1207	   o  "left" (default)
1208	   o  "center"

1210	   o  "right"

1212	2.25.2.  'alt' attribute

1214	   Deprecated.

1216	2.25.3.  'anchor' attribute

1218	   Document-wide unique identifier for this figure.

1220	   Furthermore, the presence of this attribute causes the figure to be
1221	   numbered.

1223	2.25.4.  'autogeneratedFigureNumber' attribute

1225	   The number for this figure, if one is generated by the processor.
1226	   This attribute and its value are automatically generated by the RFC
1227	   Processor, and are ignored by other processors.  If the value already
1228	   exists when the RFC Processor is run, it is replaced.

1230	2.25.5.  'height' attribute

1232	   Deprecated.

1234	2.25.6.  'src' attribute

1236	   Deprecated.

1238	2.25.7.  'suppress-title' attribute

1240	   Figures that have an "anchor" attribute will automatically get an
1241	   autogenerated title (such as "Figure 1"), even if the "title"
1242	   attribute and the <titleelement> element is absent.  Setting this
1243	   attribute to "true" will prevent this.

1245	   Allowed values:

1247	   o  "true"

1249	   o  "false" (default)

1251	2.25.8.  'title' attribute

1253	   Deprecated.  Use <titleelement> instead.

1255	2.25.9.  'width' attribute

1257	   Deprecated.

1259	2.26.  <format>

1261	   Deprecated.  If the goal is to provide a single URI for a reference,
1262	   use the "target" attribute on <reference> instead.

1264	   This element appears as child element of: <reference> (Section 2.44).

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

1268	2.26.1.  'octets' attribute

1270	   Deprecated.

1272	2.26.2.  'target' attribute

1274	   Deprecated.

1276	2.26.3.  'type' attribute (mandatory)

1278	   Deprecated.

1280	2.27.  <front>

1282	   Represent the "front matter": metadata (such as author information),
1283	   abstract, and additional notes.

1285	   This element appears as child element of: <reference> (Section 2.44),
1286	   and <rfc> (Section 2.47).

1288	   Content model:

1290	   In this order:

1292	   1.  One <title> element (Section 2.58)

1294	   2.  One or more <author> elements (Section 2.7)

1296	   3.  One optional <date> element (Section 2.16)

1298	   4.  Optional <area> elements (Section 2.4)

1300	   5.  Optional <workgroup> elements (Section 2.65)
1301	   6.  Optional <keyword> elements (Section 2.30)

1303	   7.  One optional <abstract> element (Section 2.1)

1305	   8.  Optional <note> elements (Section 2.35)

1307	2.28.  <i>

1309	   Causes the text to be displayed in italic.  It is almost always a
1310	   better idea to use the <em> element instead.

1312	   This element appears as child element of: <annotation> (Section 2.3),
1313	   <b> (Section 2.8), <blockquote> (Section 2.10), <c> (Section 2.11),
1314	   <cref> (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <li>
1315	   (Section 2.31), <postamble> (Section 2.41), <preamble>
1316	   (Section 2.42), <refcontent> (Section 2.43), <strong> (Section 2.53),
1317	   <sub> (Section 2.54), <sup> (Section 2.55), <t> (Section 2.56), and
1318	   <tt> (Section 2.60).

1320	   Content model:

1322	   In any order:

1324	   o  Text

1326	   o  <xref> elements (Section 2.66)

1328	   o  <eref> elements (Section 2.23)

1330	   o  <iref> elements (Section 2.29)

1332	   o  <cref> elements (Section 2.15)

1334	   o  <tt> elements (Section 2.60)

1336	   o  <strong> elements (Section 2.53)

1338	   o  <b> elements (Section 2.8)

1340	   o  <sub> elements (Section 2.54)

1342	   o  <sup> elements (Section 2.55)

1344	2.29.  <iref>

1346	   Provides terms for the document's index.

1348	   Index entries can be either single items (when just the "item"
1349	   attribute is given) or nested items (by specifying "subitem" as
1350	   well).

1352	   For instance:

1354	   <iref item="Grammar" subitem="item"/>

1356	   will produce an index entry for "Grammar, item".

1358	   This element appears as child element of: <annotation> (Section 2.3),
1359	   <aside> (Section 2.6), <b> (Section 2.8), <c> (Section 2.11), <dd>
1360	   (Section 2.17), <dt> (Section 2.20), <em> (Section 2.21), <figure>
1361	   (Section 2.25), <i> (Section 2.28), <li> (Section 2.31), <postamble>
1362	   (Section 2.41), <preamble> (Section 2.42), <section> (Section 2.48),
1363	   <strong> (Section 2.53), <sub> (Section 2.54), <sup> (Section 2.55),
1364	   <t> (Section 2.56), <titleelement> (Section 2.59), <tt>
1365	   (Section 2.60), and <ttcol> (Section 2.61).

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

1369	2.29.1.  'item' attribute (mandatory)

1371	   The item to include.

1373	2.29.2.  'primary' attribute

1375	   Setting this to "true" declares the occurrence as "primary", which
1376	   might cause it to be highlighted in the index.

1378	   Allowed values:

1380	   o  "true"

1382	   o  "false" (default)

1384	2.29.3.  'subitem' attribute

1386	   The subitem to include.

1388	2.30.  <keyword>

1390	   Specifies a keyword applicable to the document.

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

1395	   Keywords are used both in the RFC Index and in the metadata of
1396	   generated document representations.

1398	   This element appears as child element of: <front> (Section 2.27).

1400	   Content model: only text content.

1402	2.31.  <li>

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

1406	   This element appears as child element of: <ol> (Section 2.36), and
1407	   <ul> (Section 2.62).

1409	   Content model:

1411	   Either:

1413	   o  One or more <t> elements (Section 2.56)

1415	   Or:

1417	   o  One or more sequences of:

1419	      1.   One <ol> element

1421	      2.   One <ul> element

1423	      3.   One <dl> element

1425	      4.   One <figure> element

1427	      5.   One <artwork> element

1429	      6.   One <sourcecode> element

1431	      7.   One <xref> element

1433	      8.   One <eref> element

1435	      9.   One <iref> element

1437	      10.  One <cref> element

1439	      11.  One <tt> element

1441	      12.  One <strong> element

1443	      13.  One <b> element
1444	      14.  One <em> element

1446	      15.  One <i> element

1448	      16.  One <sub> element

1450	      17.  One <sup> element

1452	2.32.  <link>

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

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

1459	   o  The current ISSN for the RFC Series.  The value for the "rel"
1460	      attribute is "isPartOf".  The link should use the form
1461	      "urn:issn:".

1463	   o  The DOI for this document.  The value for the "rel" attribute is
1464	      "describedBy".  The link should use the form "doi:".

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

1471	   o  A representation of the document offered by the document author.
1472	      The value for the "rel" attribute is "alternate".  The link can be
1473	      to a personally-run web site.

1475	   The RFC Processor needs to check the values for <link> before an RFC
1476	   is published.  The Draft Processor might remove some <link> elements
1477	   during the draft submission process.

1479	   This element appears as child element of: <rfc> (Section 2.47).

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

1483	2.32.1.  'href' attribute (mandatory)

1485	   The URI of the external document.

1487	2.32.2.  'rel' attribute

1489	   The relationship of the external document to this one.  The
1490	   relationships are taken from Link Relations registry maintained by
1491	   IANA [LINKRELATIONS].

1493	2.33.  <list>

1495	   Deprecated.  Instead, use <dl> for list/@style "hanging"; <ul> for
1496	   list/@style "empty" or "symbols"; and <ol> for list/@style "letters",
1497	   "numbers", or "format".

1499	   This element appears as child element of: <t> (Section 2.56).

1501	   Content model:

1503	   One or more <t> elements (Section 2.56)

1505	2.33.1.  'counter' attribute

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

1510	2.33.2.  'hangIndent' attribute

1512	   Deprecated.

1514	2.33.3.  'style' attribute

1516	   Deprecated.

1518	2.34.  <middle>

1520	   Represents the main content of the document.

1522	   This element appears as child element of: <rfc> (Section 2.47).

1524	   Content model:

1526	   One or more <section> elements (Section 2.48)

1528	2.35.  <note>

1530	   Creates an unnumbered section that appears after the abstract.

1532	   It is usually used for additional information to reviewers (working
1533	   group information, mailing list, ...), or for additional publication
1534	   information such as "IESG Notes".

1536	   This element appears as child element of: <front> (Section 2.27).

1538	   Content model:

1540	   One or more <t> elements (Section 2.56)

1542	2.35.1.  'title' attribute (mandatory)

1544	   The title of the note.

1546	2.36.  <ol>

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

1551	   This element appears as child element of: <dd> (Section 2.17), <li>
1552	   (Section 2.31), and <t> (Section 2.56).

1554	   Content model:

1556	   One or more <li> elements (Section 2.31)

1558	2.36.1.  'group' attribute

1560	   When a processor sees an <ol> element with a "group" attribute that
1561	   has already been seen, the processor continues the numbering of the
1562	   list from where the previous list with the same group name left off.
1563	   If an <ol> element has both a "group" and "start" attribute, the
1564	   group's numbering is reset to the given start value.

1566	2.36.2.  'spacing' attribute

1568	   Defines whether or not there is a blank line between entries.
1569	   spacing="normal" indicates a single blank line, while
1570	   spacing="compact" indicates no space between.

1572	   Allowed values:

1574	   o  "normal" (default)

1576	   o  "compact"

1578	2.36.3.  'start' attribute

1580	   The ordinal value to start the list at.  This defaults to "1", and
1581	   must be an integer of 0 or greater.

1583	2.36.4.  'style' attribute

1585	   The style of the labels on list items.  If the length of the style
1586	   value is 1, the meaning is the same as it is for HTML:

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

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

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

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

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

1598	   [[anchor11: Need to determine, and then specify, what happens after
1599	   the 26th letter.]]

1601	   If the length of the style value is greater than 1, the value must
1602	   contain a percent-encoded indicator and other text.  The value is a
1603	   free-form text that allows counter values to be inserted using a
1604	   "percent-letter" format.  For instance, "[REQ%d]" generates labels of
1605	   the form "[REQ1]", where "%d" inserts the item number as decimal
1606	   number.

1608	   The following formats are supported:

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

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

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

1616	   %i Lowercase Roman numerals (i, ii, iii, ...)

1618	   %I Uppercase Roman numerals (I, II, III, ...)

1620	   %% Represents a percent sign

1622	   Other formats are reserved for future use.

1624	2.37.  <organization>

1626	   Specifies the affiliation of an author.

1628	   This information appears in both the "Author's Address" section and
1629	   on the front page (see [RFCSTYLE] for more information).  If the
1630	   value is long, an abbreviated variant can be specified in the
1631	   "abbrev" attribute.

1633	   This element appears as child element of: <author> (Section 2.7).

1635	   Content model: only text content.

1637	2.37.1.  'abbrev' attribute

1639	   Abbreviated variant.

1641	2.37.2.  'ascii' attribute

1643	   The ASCII equivalent of the organization's name.

1645	2.38.  <phone>

1647	   Represents a phone number.

1649	   The value is expected to be the scheme-specific part of a "tel" URI
1650	   (so does not include the prefix "tel:"), using the "global numbers"
1651	   syntax.  See Section 3 of [RFC3966] for details.

1653	   This element appears as child element of: <address> (Section 2.2).

1655	   Content model: only text content.

1657	2.39.  <postal>

1659	   Contains optional child elements providing postal information.  These
1660	   elements will be displayed in an order that is processor-specific.  A
1661	   postal address can contain only a set of <street>, <city>, <region>,
1662	   <code>, and <country> elements, or only an ordered set of
1663	   <postalLine> elements, but not both.

1665	   This element appears as child element of: <address> (Section 2.2).

1667	   Content model:

1669	   Either:

1671	   o  In any order:

1673	      *  <street> elements (Section 2.52)

1675	      *  <city> elements (Section 2.12)

1677	      *  <region> elements (Section 2.46)

1679	      *  <code> elements (Section 2.13)

1681	      *  <country> elements (Section 2.14)

1683	   Or:

1685	   o  One or more <postalLine> elements (Section 2.40)

1687	2.39.1.  'xml:lang' attribute

1689	   Allows specification of the language used.  This is sometimes useful
1690	   for renderers which display different fonts for CJK characters.

1692	2.40.  <postalLine>

1694	   Represents one line of a postal address.  When more than one
1695	   <postalLine> is given, the processor emits them in the order given.

1697	   This element appears as child element of: <postal> (Section 2.39).

1699	   Content model: only text content.

1701	2.40.1.  'ascii' attribute

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

1705	2.41.  <postamble>

1707	   Gives text that appears at the bottom of a figure or table.

1709	   This element appears as child element of: <figure> (Section 2.25),
1710	   and <texttable> (Section 2.57).

1712	   Content model:

1714	   In any order:

1716	   o  Text

1718	   o  <xref> elements (Section 2.66)

1720	   o  <eref> elements (Section 2.23)

1722	   o  <iref> elements (Section 2.29)

1724	   o  <cref> elements (Section 2.15)

1726	   o  <spanx> elements (Section 2.51)

1728	   o  <tt> elements (Section 2.60)

1730	   o  <strong> elements (Section 2.53)
1731	   o  <b> elements (Section 2.8)

1733	   o  <em> elements (Section 2.21)

1735	   o  <i> elements (Section 2.28)

1737	   o  <sub> elements (Section 2.54)

1739	   o  <sup> elements (Section 2.55)

1741	2.42.  <preamble>

1743	   Gives text that appears at the top of a figure or table.

1745	   This element appears as child element of: <figure> (Section 2.25),
1746	   and <texttable> (Section 2.57).

1748	   Content model:

1750	   In any order:

1752	   o  Text

1754	   o  <xref> elements (Section 2.66)

1756	   o  <eref> elements (Section 2.23)

1758	   o  <iref> elements (Section 2.29)

1760	   o  <cref> elements (Section 2.15)

1762	   o  <spanx> elements (Section 2.51)

1764	   o  <tt> elements (Section 2.60)

1766	   o  <strong> elements (Section 2.53)

1768	   o  <b> elements (Section 2.8)

1770	   o  <em> elements (Section 2.21)

1772	   o  <i> elements (Section 2.28)

1774	   o  <sub> elements (Section 2.54)

1776	   o  <sup> elements (Section 2.55)

1778	2.43.  <refcontent>

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

1784	   For example:

1786	   <reference anchor="April1">
1787	     <front>
1788	       <title>On Being A Fool</title>
1789	       <author initials="K." surname="Phunny" fullname="Knot Phunny"/>
1790	       <date year="2000" month="April"/>
1791	     </front>
1792	     <refcontent>Self-published pamphlet</refcontent>
1793	   </reference>

1795	   would render as:

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

1800	   This element appears as child element of: <reference> (Section 2.44).

1802	   Content model:

1804	   In any order:

1806	   o  Text

1808	   o  <tt> elements (Section 2.60)

1810	   o  <b> elements (Section 2.8)

1812	   o  <i> elements (Section 2.28)

1814	   o  <em> elements (Section 2.21)

1816	   o  <strong> elements (Section 2.53)

1818	   o  <sub> elements (Section 2.54)

1820	   o  <sup> elements (Section 2.55)

1822	2.43.1.  'ascii' attribute

1824	   The ASCII equivalent of the added text.

1826	2.44.  <reference>

1828	   Represents a bibliographical reference.

1830	   This element appears as child element of: <references>
1831	   (Section 2.45).

1833	   Content model:

1835	   In this order:

1837	   1.  One <front> element (Section 2.27)

1839	   2.  In any order:

1841	       *  <seriesInfo> elements (Section 2.49)

1843	       *  <format> elements (Section 2.26)

1845	       *  <refcontent> elements (Section 2.43)

1847	       *  <annotation> elements (Section 2.3)

1849	2.44.1.  'anchor' attribute (mandatory)

1851	   Document-wide unique identifier for this reference.  Usually, this
1852	   will be used both to "label" the reference in the references section,
1853	   and as an identifier in links to this reference entry.

1855	2.44.2.  'target' attribute

1857	   Holds the URI for the reference.

1859	   Note that depending on the <seriesInfo> element, a URI might not be
1860	   needed, nor desirable, as it can be automatically generated (for
1861	   instance, for RFCs).

1863	2.45.  <references>

1865	   Contains a set of bibliographical references.

1867	   In the early days of the RFC series, there was only one "References"
1868	   section per RFC.  This convention was later changed to group
1869	   references into two sets, "Normative" and "Informative" as described
1870	   in [RFCSTYLE]).  This vocabulary supports the split with the "title"
1871	   attribute.

1873	   This element appears as child element of: <back> (Section 2.9).

1875	   Content model:

1877	   One or more <reference> elements (Section 2.44)

1879	2.45.1.  'title' attribute

1881	   Provides the title for the References section (defaulting to
1882	   "References").

1884	   In general, the title should be either "Normative References" or
1885	   "Informative References".

1887	2.46.  <region>

1889	   Provides the region name in a postal address.

1891	   This element appears as child element of: <postal> (Section 2.39).

1893	   Content model: only text content.

1895	2.46.1.  'ascii' attribute

1897	   The ASCII equivalent of the region name.

1899	2.47.  <rfc>

1901	   This is the root element of the xml2rfc vocabulary.

1903	   Processors distinguish between RFC mode ("number" attribute being
1904	   present) and Internet-Draft mode ("docName" attribute being present):
1905	   it is invalid to specify both.  Setting neither "number" nor
1906	   "docName" can be useful for producing other types of document but is
1907	   out-of-scope for this specification.

1909	   Content model:

1911	   In this order:

1913	   1.  One optional <link> element (Section 2.32)

1915	   2.  One <front> element (Section 2.27)
1916	   3.  One <middle> element (Section 2.34)

1918	   4.  One optional <back> element (Section 2.9)

1920	2.47.1.  'autogeneratedBoilerplateText' attribute

1922	   The full boilerplate text for this document.  This attribute and its
1923	   value are automatically generated by the RFC Processor, and are
1924	   ignored by other processors.  If the value already exists when the
1925	   RFC Processor is run, it is replaced.

1927	2.47.2.  'category' attribute

1929	   Document category (see Appendix A.1).

1931	   Allowed values:

1933	   o  "std"

1935	   o  "bcp"

1937	   o  "info"

1939	   o  "exp"

1941	   o  "historic"

1943	2.47.3.  'consensus' attribute

1945	   Affects the generated boilerplate.

1947	   See [RFC5741] for more information.

1949	   Allowed values:

1951	   o  "no"

1953	   o  "yes"

1955	2.47.4.  'docName' attribute

1957	   Specifies the name or the Internet Draft or private document.  A
1958	   private document is one whose representation is not meant to be an
1959	   Internet Draft or RFC.  If the value for this attribute starts with
1960	   the string "draft-", a processor treats the input as an Internet
1961	   Draft; if the value starts with any other string, a processor treats
1962	   this as a private document.  The name in the value should be the
1963	   document name without any file extension.  That is, the value for
1964	   this attribute should be "draft-ietf-somewg-someprotocol-07", not
1965	   "draft-ietf-somewg-someprotocol-07.txt".

1967	   A processor should give an error if both the "docName" and "number"
1968	   attributes are given in the <rfc> element.

1970	2.47.5.  'ipr' attribute

1972	   Represents the Intellectual Property status of the document.  See
1973	   Appendix A.2 for details.

1975	   Allowed values:

1977	   o  "full2026"

1979	   o  "noDerivativeWorks2026"

1981	   o  "none"

1983	   o  "full3667"

1985	   o  "noModification3667"

1987	   o  "noDerivatives3667"

1989	   o  "full3978"

1991	   o  "noModification3978"

1993	   o  "noDerivatives3978"

1995	   o  "trust200811"

1997	   o  "noModificationTrust200811"

1999	   o  "noDerivativesTrust200811"

2001	   o  "trust200902"

2003	   o  "noModificationTrust200902"

2005	   o  "noDerivativesTrust200902"

2007	   o  "pre5378Trust200902"

2009	2.47.6.  'iprExtract' attribute

2011	   Identifies a Section within the document for which extraction "as-is"
2012	   is explicitly allowed (only relevant for historic values of the "ipr"
2013	   attribute).

2015	2.47.7.  'number' attribute

2017	   The number of the RFC to be produced by a processor.

2019	   A processor should give an error if both the "docName" and "number"
2020	   attributes are given in the <rfc> element.

2022	2.47.8.  'obsoletes' attribute

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

2026	   Processors ought to parse the attribute value, so that incorrect
2027	   references can be detected and, depending on output representation,
2028	   hyperlinks can be generated.  Also, the value ought to be reformatted
2029	   to insert whitespace after each comma if not already present.

2031	2.47.9.  'seriesNo' attribute

2033	   When producing a document within document series (such as "STD"): the
2034	   number within that series.

2036	2.47.10.  'sortRefs' attribute

2038	   Specifies whether or not a processor will sort the references in each
2039	   reference section.

2041	   Allowed values:

2043	   o  "yes"

2045	   o  "no" (default)

2047	2.47.11.  'submissionType' attribute

2049	   The document stream.

2051	   See Section 2 of [RFC5741] for details.

2053	   Allowed values:

2055	   o  "IETF" (default)
2056	   o  "IAB"

2058	   o  "IRTF"

2060	   o  "independent"

2062	2.47.12.  'symRefs' attribute

2064	   Specifies whether or not a processor will use symbolic references
2065	   (such as "[RFC2119]").  If the value for this is "no", the references
2066	   come out as numbers (such as "[3]").

2068	   Allowed values:

2070	   o  "yes" (default)

2072	   o  "no"

2074	2.47.13.  'tocDepth' attribute

2076	   Specifies number of levels of heading for a processor to include in
2077	   the table of contents; the default is "3".

2079	2.47.14.  'tocInclude' attribute

2081	   Specifies whether or not a processor will include a table of contents
2082	   in generated files.

2084	   Allowed values:

2086	   o  "yes" (default)

2088	   o  "no"

2090	2.47.15.  'updates' attribute

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

2094	   Processors ought to parse the attribute value, so that incorrect
2095	   references can be detected and, depending on output representation,
2096	   hyperlinks can be generated.  Also, the value ought to be reformatted
2097	   to insert whitespace after each comma if not already present.

2099	2.47.16.  'xml:lang' attribute

2101	   The natural language used in the document (defaults to "en").

2103	   See Section 2.12 of [XML] for more information.

2105	2.48.  <section>

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

2110	   Sub-sections are created by nesting <section> elements inside
2111	   <section> elements.  Sections are allowed to be empty.

2113	   This element appears as child element of: <back> (Section 2.9),
2114	   <middle> (Section 2.34), and <section> (Section 2.48).

2116	   Content model:

2118	   In this order:

2120	   1.  One optional <titleelement> element (Section 2.59)

2122	   2.  In any order:

2124	       *  <t> elements (Section 2.56)

2126	       *  <aside> elements (Section 2.6)

2128	       *  <blockquote> elements (Section 2.10)

2130	       *  <figure> elements (Section 2.25)

2132	       *  <texttable> elements (Section 2.57)

2134	       *  <iref> elements (Section 2.29)

2136	       *  <artwork> elements (Section 2.5)

2138	       *  <sourcecode> elements (Section 2.50)

2140	   3.  Optional <section> elements (Section 2.48)

2142	2.48.1.  'anchor' attribute

2144	   Document-wide unique identifier for this section.

2146	2.48.2.  'autogeneratedSectionNumber' attribute

2148	   The number for this section, if one is generated by the processor.
2149	   This attribute and its value are automatically generated by the RFC
2150	   Processor, and are ignored by other processors.  If the value already
2151	   exists when the RFC Processor is run, it is replaced.

2153	2.48.3.  'numbered' attribute

2155	   If set to "no", this section does not get a section number.
2156	   Processors will verify that such a section is not followed by a
2157	   numbered section in a part, and will verify that the section is a
2158	   top-level section.

2160	   Allowed values:

2162	   o  "yes" (default)

2164	   o  "no"

2166	2.48.4.  'removeInRFC' attribute

2168	   If set to "yes", this section is marked in the processor with text
2169	   indicating that it should be removed before the document is published
2170	   as an RFC.

2172	   Allowed values:

2174	   o  "yes"

2176	   o  "no" (default)

2178	2.48.5.  'title' attribute

2180	   Deprecated.  Use <titleelement> instead.

2182	2.48.6.  'toc' attribute

2184	   Indicates to a processor whether or not the section is to be included
2185	   in the table of contents.  This only takes effect if the level of the
2186	   section would have appeared in the table of contents based on the
2187	   "tocDepth" attribute of the <rfc> element, and of course only if the
2188	   table of contents is being created based on the "tocInclude"
2189	   attribute of the <rfc> element.  If this is set to "exclude", any
2190	   section below this one will be excluded as well.  The "default" value
2191	   indicates to include the section if it would be included by the
2192	   tocDepth attribute of the <rfc> element.

2194	   Allowed values:

2196	   o  "include"

2198	   o  "exclude"
2199	   o  "default" (default)

2201	2.49.  <seriesInfo>

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

2206	   This element appears as child element of: <reference> (Section 2.44).

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

2210	2.49.1.  'asciiname' attribute

2212	   The ASCII equivalent of the name field.

2214	2.49.2.  'asciivalue' attribute

2216	   The ASCII equivalent of the value field.

2218	2.49.3.  'name' attribute (mandatory)

2220	   The name of the series.

2222	   The following names trigger specific processing (such as for auto-
2223	   generating links, and adding descriptions such as "work in
2224	   progress"): "BCP", "FYI", "Internet-Draft", "RFC", and "STD".

2226	2.49.4.  'value' attribute (mandatory)

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

2230	   For BCPs, FYIs, RFCs, and STDs this is the number within the series.
2231	   For Internet-Drafts, it is the full draft name (ending with the two-
2232	   digit version number).

2234	2.50.  <sourcecode>

2236	   This element allows the inclusion of sourcecode into the document.

2238	   <sourcecode> provides full control of horizontal whitespace and line
2239	   breaks.  It is thus useful for source code and formal languages (such
2240	   as ABNF or the RNC notation used in this document).

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

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

2253	   Desired output:
2254	      allowed-chars = "." | "," | "&" | "<" | ">" | "|"

2256	   Using escaping:
2257	   <sourcecode>
2258	      allowed-chars = "." | "," | "&amp;" | "&lt;" | "&gt;" | "|"
2259	   </sourcecode>

2261	   Using CDATA:
2262	   <sourcecode>
2263	   <![CDATA[   allowed-chars = "." | "," | "&" | "<" | ">" | "|"]]>
2264	   </sourcecode>

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

2270	   This element appears as child element of: <aside> (Section 2.6),
2271	   <blockquote> (Section 2.10), <dd> (Section 2.17), <figure>
2272	   (Section 2.25), <li> (Section 2.31), <section> (Section 2.48), and
2273	   <t> (Section 2.56).

2275	   Content model: only text content.

2277	2.50.1.  'name' attribute

2279	   A filename suitable for the contents (such as for extraction to a
2280	   local file).  This attribute generally isn't used for document
2281	   generation, but it can be helpful for other kinds of tools (such as
2282	   automated syntax checkers which work by extracting the source code).

2284	2.50.2.  'type' attribute

2286	   Specifies the type of the sourcecode.  The value of this attribute is
2287	   free text with certain values designated as preferred.  A private
2288	   processor (as described in Appendix B) might add type-specific
2289	   formatting to sourcecode with the preferred values.  If a processor
2290	   encounters a value for "type" that is not one of the preferred
2291	   values, it can issue a warning but should still use the artwork as if
2292	   it had no "type" attribute.

2294	   The preferred values for <sourcecode> types are:

2296	   o  abnf

2298	   o  asn.1

2300	   o  bash

2302	   o  c++

2304	   o  c

2306	   o  cbor

2308	   o  dtd

2310	   o  java

2312	   o  javascript

2314	   o  json

2316	   o  mib

2318	   o  perl

2320	   o  pseudocode

2322	   o  python

2324	   o  rnc

2326	   o  xml

2328	   The RFC Editor will maintain a complete list of the preferred values
2329	   on its web site, and that list is expected to be updated over time.
2330	   Thus, a consumer of v3 XML should not cause a failure when it
2331	   encounters an unexpected type.

2333	2.51.  <spanx>

2335	   Deprecated.  Use <b>, <i>, and <tt> instead.

2337	   This element appears as child element of: <annotation> (Section 2.3),
2338	   <c> (Section 2.11), <postamble> (Section 2.41), <preamble>
2339	   (Section 2.42), and <t> (Section 2.56).

2341	   Content model: only text content.

2343	2.51.1.  'style' attribute

2345	   Deprecated.

2347	2.51.2.  'xml:space' attribute

2349	   Deprecated.

2351	   Allowed values:

2353	   o  "default"

2355	   o  "preserve" (default)

2357	2.52.  <street>

2359	   Provides a street address.

2361	   This element appears as child element of: <postal> (Section 2.39).

2363	   Content model: only text content.

2365	2.52.1.  'ascii' attribute

2367	   The ASCII equivalent of the street address.

2369	2.53.  <strong>

2371	   Indicates text that is semantically strong.  This element will be
2372	   displayed as bold after processing.  This element has the same
2373	   effects as <b>.  This element can be combined with other character
2374	   formatting elements, and the formatting will be additive.

2376	   This element appears as child element of: <annotation> (Section 2.3),
2377	   <blockquote> (Section 2.10), <c> (Section 2.11), <cref>
2378	   (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <em>
2379	   (Section 2.21), <i> (Section 2.28), <li> (Section 2.31), <postamble>
2380	   (Section 2.41), <preamble> (Section 2.42), <refcontent>
2381	   (Section 2.43), <sub> (Section 2.54), <sup> (Section 2.55), <t>
2382	   (Section 2.56), and <tt> (Section 2.60).

2384	   Content model:

2386	   In any order:

2388	   o  Text
2389	   o  <xref> elements (Section 2.66)

2391	   o  <eref> elements (Section 2.23)

2393	   o  <iref> elements (Section 2.29)

2395	   o  <cref> elements (Section 2.15)

2397	   o  <tt> elements (Section 2.60)

2399	   o  <em> elements (Section 2.21)

2401	   o  <i> elements (Section 2.28)

2403	   o  <sub> elements (Section 2.54)

2405	   o  <sup> elements (Section 2.55)

2407	2.54.  <sub>

2409	   Causes the text to be displayed as subscript, approximately half a
2410	   letter-height lower than normal text.  This element can be combined
2411	   with other character formatting elements, and the formatting will be
2412	   additive.

2414	   This element appears as child element of: <annotation> (Section 2.3),
2415	   <b> (Section 2.8), <blockquote> (Section 2.10), <c> (Section 2.11),
2416	   <cref> (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <em>
2417	   (Section 2.21), <i> (Section 2.28), <li> (Section 2.31), <postamble>
2418	   (Section 2.41), <preamble> (Section 2.42), <refcontent>
2419	   (Section 2.43), <strong> (Section 2.53), <t> (Section 2.56), and <tt>
2420	   (Section 2.60).

2422	   Content model:

2424	   In any order:

2426	   o  Text

2428	   o  <xref> elements (Section 2.66)

2430	   o  <eref> elements (Section 2.23)

2432	   o  <iref> elements (Section 2.29)

2434	   o  <cref> elements (Section 2.15)
2435	   o  <tt> elements (Section 2.60)

2437	   o  <strong> elements (Section 2.53)

2439	   o  <b> elements (Section 2.8)

2441	   o  <em> elements (Section 2.21)

2443	   o  <i> elements (Section 2.28)

2445	2.55.  <sup>

2447	   Causes the text to be displayed as superscript, approximately half a
2448	   letter-height higher than normal text.  This element can be combined
2449	   with other character formatting elements, and the formatting will be
2450	   additive.

2452	   This element appears as child element of: <annotation> (Section 2.3),
2453	   <b> (Section 2.8), <blockquote> (Section 2.10), <c> (Section 2.11),
2454	   <cref> (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <em>
2455	   (Section 2.21), <i> (Section 2.28), <li> (Section 2.31), <postamble>
2456	   (Section 2.41), <preamble> (Section 2.42), <refcontent>
2457	   (Section 2.43), <strong> (Section 2.53), <t> (Section 2.56), and <tt>
2458	   (Section 2.60).

2460	   Content model:

2462	   In any order:

2464	   o  Text

2466	   o  <xref> elements (Section 2.66)

2468	   o  <eref> elements (Section 2.23)

2470	   o  <iref> elements (Section 2.29)

2472	   o  <cref> elements (Section 2.15)

2474	   o  <tt> elements (Section 2.60)

2476	   o  <strong> elements (Section 2.53)

2478	   o  <b> elements (Section 2.8)

2480	   o  <em> elements (Section 2.21)
2481	   o  <i> elements (Section 2.28)

2483	2.56.  <t>

2485	   Contains a paragraph of text.

2487	   This element appears as child element of: <abstract> (Section 2.1),
2488	   <aside> (Section 2.6), <dd> (Section 2.17), <li> (Section 2.31),
2489	   <list> (Section 2.33), <note> (Section 2.35), and <section>
2490	   (Section 2.48).

2492	   Content model:

2494	   In any order:

2496	   o  Text

2498	   o  <list> elements (Section 2.33)

2500	   o  <ol> elements (Section 2.36)

2502	   o  <ul> elements (Section 2.62)

2504	   o  <dl> elements (Section 2.19)

2506	   o  <figure> elements (Section 2.25)

2508	   o  <artwork> elements (Section 2.5)

2510	   o  <sourcecode> elements (Section 2.50)

2512	   o  <xref> elements (Section 2.66)

2514	   o  <eref> elements (Section 2.23)

2516	   o  <iref> elements (Section 2.29)

2518	   o  <cref> elements (Section 2.15)

2520	   o  <spanx> elements (Section 2.51)

2522	   o  <vspace> elements (Section 2.64)

2524	   o  <tt> elements (Section 2.60)

2526	   o  <strong> elements (Section 2.53)
2527	   o  <b> elements (Section 2.8)

2529	   o  <em> elements (Section 2.21)

2531	   o  <i> elements (Section 2.28)

2533	   o  <sub> elements (Section 2.54)

2535	   o  <sup> elements (Section 2.55)

2537	2.56.1.  'anchor' attribute

2539	   Document-wide unique identifier for this paragraph.

2541	2.57.  <texttable>

2543	   Contains a table, consisting of an optional preamble, a header line,
2544	   rows, an optional postamble, and an optional title.

2546	   The number of columns in the table is determined by the number of
2547	   <ttcol> elements.  The number of rows in the table is determined by
2548	   the number of <c> elements divided by the number of columns.  There
2549	   is no requirement that the number of <c> elements be evenly divisible
2550	   by the number of columns.

2552	   This element appears as child element of: <aside> (Section 2.6), and
2553	   <section> (Section 2.48).

2555	   Content model:

2557	   In this order:

2559	   1.  One optional <titleelement> element (Section 2.59)

2561	   2.  One optional <preamble> element (Section 2.42)

2563	   3.  One or more <ttcol> elements (Section 2.61)

2565	   4.  Optional <c> elements (Section 2.11)

2567	   5.  One optional <postamble> element (Section 2.41)

2569	2.57.1.  'align' attribute

2571	   Determines the horizontal alignment of the table.

2573	   Allowed values:

2575	   o  "left"

2577	   o  "center" (default)

2579	   o  "right"

2581	2.57.2.  'anchor' attribute

2583	   Document-wide unique identifier for this table.

2585	   Furthermore, the presence of this attribute causes the table to be
2586	   numbered.

2588	2.57.3.  'autogeneratedTableNumber' attribute

2590	   The number for this table, if one is generated by the processor.
2591	   This attribute and its value are automatically generated by the RFC
2592	   Processor, and are ignored by other processors.  If the value already
2593	   exists when the RFC Processor is run, it is replaced.

2595	2.57.4.  'style' attribute

2597	   Selects which borders should be drawn, where

2599	   o  "all" means borders around all table cells,

2601	   o  "full" is like "all" except no horizontal lines between table rows
2602	      (except below the column titles),

2604	   o  "headers" adds just a separator between column titles and rows,
2605	      and

2607	   o  "none" means no borders at all.

2609	   Allowed values:

2611	   o  "all"

2613	   o  "none"

2615	   o  "headers"

2617	   o  "full" (default)

2619	2.57.5.  'suppress-title' attribute

2621	   Tables that have an "anchor" attribute will automatically get an
2622	   autogenerated title (such as "Table 1"), even if the "title"
2623	   attribute is absent.  Setting this attribute to "true" will prevent
2624	   this.

2626	   Allowed values:

2628	   o  "true"

2630	   o  "false" (default)

2632	2.57.6.  'title' attribute

2634	   Deprecated.  Use <titleelement> instead.

2636	2.58.  <title>

2638	   Represents the document title.

2640	   When this element appears in the <front> element of the current
2641	   document, the title might also appear in page headers or footers.  If
2642	   it's long (~40 characters), the "abbrev" attribute is used to specify
2643	   an abbreviated variant.

2645	   This element appears as child element of: <front> (Section 2.27).

2647	   Content model: only text content.

2649	2.58.1.  'abbrev' attribute

2651	   Specifies an abbreviated variant of the document title.

2653	2.58.2.  'ascii' attribute

2655	   The ASCII equivalent of the title.

2657	2.59.  <titleelement>

2659	   The title of the section, figure, or texttable.  This title can have
2660	   flow markup such as to make some characters use a fixed-width font,
2661	   or to include references.

2663	   This element appears as child element of: <figure> (Section 2.25),
2664	   <section> (Section 2.48), and <texttable> (Section 2.57).

2666	   Content model:

2668	   In any order:

2670	   o  Text

2672	   o  <xref> elements (Section 2.66)

2674	   o  <eref> elements (Section 2.23)

2676	   o  <iref> elements (Section 2.29)

2678	   o  <cref> elements (Section 2.15)

2680	   o  <tt> elements (Section 2.60)

2682	2.60.  <tt>

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

2688	   This element appears as child element of: <annotation> (Section 2.3),
2689	   <b> (Section 2.8), <blockquote> (Section 2.10), <c> (Section 2.11),
2690	   <cref> (Section 2.15), <dd> (Section 2.17), <dt> (Section 2.20), <em>
2691	   (Section 2.21), <i> (Section 2.28), <li> (Section 2.31), <postamble>
2692	   (Section 2.41), <preamble> (Section 2.42), <refcontent>
2693	   (Section 2.43), <strong> (Section 2.53), <sub> (Section 2.54), <sup>
2694	   (Section 2.55), <t> (Section 2.56), and <titleelement>
2695	   (Section 2.59).

2697	   Content model:

2699	   In any order:

2701	   o  Text

2703	   o  <xref> elements (Section 2.66)

2705	   o  <eref> elements (Section 2.23)

2707	   o  <iref> elements (Section 2.29)

2709	   o  <cref> elements (Section 2.15)

2711	   o  <strong> elements (Section 2.53)

2713	   o  <b> elements (Section 2.8)
2714	   o  <em> elements (Section 2.21)

2716	   o  <i> elements (Section 2.28)

2718	   o  <sub> elements (Section 2.54)

2720	   o  <sup> elements (Section 2.55)

2722	2.61.  <ttcol>

2724	   Contains a column heading in a table.

2726	   This element appears as child element of: <texttable> (Section 2.57).

2728	   Content model:

2730	   In any order:

2732	   o  <xref> elements (Section 2.66)

2734	   o  <eref> elements (Section 2.23)

2736	   o  <iref> elements (Section 2.29)

2738	   o  <cref> elements (Section 2.15)

2740	   o  Text

2742	2.61.1.  'align' attribute

2744	   Determines the horizontal alignment within the table column.

2746	   Allowed values:

2748	   o  "left" (default)

2750	   o  "center"

2752	   o  "right"

2754	2.61.2.  'width' attribute

2756	   The desired column width (as integer 0..100 followed by "%").

2758	2.62.  <ul>

2760	   An unordered list.  The labels on the items will be symbols picked by
2761	   the processor.

2763	   This element appears as child element of: <dd> (Section 2.17), <li>
2764	   (Section 2.31), and <t> (Section 2.56).

2766	   Content model:

2768	   One or more <li> elements (Section 2.31)

2770	2.62.1.  'empty' attribute

2772	   Defines whether or not the label is empty. empty="true" indicates
2773	   that no label be shown.

2775	   Allowed values:

2777	   o  "false" (default)

2779	   o  "true"

2781	2.62.2.  'spacing' attribute

2783	   Defines whether or not there is a blank line between entries.
2784	   spacing="normal" indicates a single blank line, while
2785	   spacing="compact" indicates no space between.

2787	   Allowed values:

2789	   o  "normal" (default)

2791	   o  "compact"

2793	2.63.  <uri>

2795	   Contains a web address associated with the author.

2797	   The contents should be a valid URI (see Section 3 of [RFC3986]).

2799	   This element appears as child element of: <address> (Section 2.2).

2801	   Content model: only text content.

2803	2.64.  <vspace>

2805	   Deprecated.

2807	   This element appears as child element of: <t> (Section 2.56).

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

2811	2.64.1.  'blankLines' attribute

2813	   Deprecated.

2815	2.65.  <workgroup>

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

2822	   In Internet-Drafts, this is used in the upper left corner of the
2823	   boilerplate, replacing the "Network Working Group" string.
2824	   Formatting software can append the words "Working Group" or "Research
2825	   Group", depending on the "submissionType" property on the <rfc>
2826	   element (Section 2.47.11).

2828	   This element appears as child element of: <front> (Section 2.27).

2830	   Content model: only text content.

2832	2.66.  <xref>

2834	   Inserts a reference to a different part of a document.

2836	   The generated text depends on whether the <xref> is empty (in which
2837	   case the processor will try to generate a meaningful text fragment),
2838	   and the nature of the referenced document part. [[anchor12: Need to
2839	   say more about the processor output if the element is empyt and if it
2840	   has text.]]

2842	   Any element that allows the "anchor" attribute can be referenced,
2843	   however there are restrictions with respect to the text content being
2844	   generated.  For instance, a <t> can be a reference target, however,
2845	   because paragraphs are not (visibly) numbered, the author will have
2846	   to make sure that the prose is sufficient for a reader to understand
2847	   what is being referred to.

2849	   This element appears as child element of: <annotation> (Section 2.3),
2850	   <b> (Section 2.8), <c> (Section 2.11), <cref> (Section 2.15), <dd>
2851	   (Section 2.17), <dt> (Section 2.20), <em> (Section 2.21), <i>
2852	   (Section 2.28), <li> (Section 2.31), <postamble> (Section 2.41),
2853	   <preamble> (Section 2.42), <strong> (Section 2.53), <sub>
2854	   (Section 2.54), <sup> (Section 2.55), <t> (Section 2.56),
2855	   <titleelement> (Section 2.59), <tt> (Section 2.60), and <ttcol>
2856	   (Section 2.61).

2858	   Content model: only text content.

2860	2.66.1.  'format' attribute

2862	   This attribute is used to control the format of the generated
2863	   reference text.

2865	   "counter"

2867	      Inserts just a counter; this is used for the number of a section,
2868	      figure, or table.  For example:

2870	     <section anchor="overview">Protocol Overview</section>
2871	     . . .
2872	     See Section <xref target="overview" format="counter"/>
2873	     for an overview.

2875	      might generate

2877	     See Section 1.7 for an overview.

2879	   "default"

2881	      Inserts a text fragment that describes the referenced part
2882	      completely, such as "Section 2" or "Table 4" for internal links,
2883	      or "[XML]" for links to references.  For example:

2885	     <section anchor="overview">Protocol Overview</section>
2886	     . . .
2887	     See <xref target="overview"/> for an overview.

2889	      might generate

2891	     See Section 1.7 for an overview.

2893	   "none"

2895	      This attribute value is deprecated.

2897	   "title"

2899	      This attribute value is deprecated.

2901	   Allowed values:

2903	   o  "counter"

2905	   o  "title"
2906	   o  "none"

2908	   o  "default" (default)

2910	2.66.2.  'pageno' attribute

2912	   Deprecated.

2914	   Allowed values:

2916	   o  "true"

2918	   o  "false" (default)

2920	2.66.3.  'relative' attribute

2922	   Specifies a relative reference from the main target. [[anchor13: Need
2923	   more description here about how this will be displayed.]]

2925	2.66.4.  'section' attribute

2927	   Specifies a section for the generated reference.  For example,

2929	        See <xref section="2.3" target="RFC6949"/> for more inforation.

2931	   would generate

2933	        See Section 2.3 of [RFC6949] for more information.

2935	2.66.5.  'sectionFormat' attribute

2937	   The format that the section reference will be displayed in.  The
2938	   acceptable values are:

2940	   o  "of" (default)

2942	   o  "comma"

2944	   o  "parens"

2946	   For example:

2948	     See <xref target="RFC6949" section="2.3" sectionFormat="of"/>
2949	     for more inforation.
2950	     See <xref target="RFC6949" section="2.4" sectionFormat="comma"/>
2951	     for more inforation.
2952	     See <xref target="RFC6949" section="2.5" sectionFormat="parens"/>
2953	     for more inforation.

2955	   would generate

2957	        See Section 2.3 of [RFC6949] for more information.
2958	        See [RFC6949], Section 2.4 for more information.
2959	        See [RFC6949] (Section 2.5) for more information.

2961	2.66.6.  'target' attribute (mandatory)

2963	   Identifies the document component being referenced.

2965	   The value needs to match the value of the "anchor" attribute of
2966	   another element in the document.

2968	3.  Internationalization Considerations

2970	   This format is based on [XML], thus does not have any issues
2971	   representing arbitrary Unicode [UNICODE] characters in text content.
2972	   The RFC Editor may restrict some of the characters that can be used
2973	   in a particular RFC; the rules for such restrictions are covered in
2974	   [[anchor14: some other document to be named later when it is
2975	   stable]].

2977	4.  Security Considerations

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

2984	   The "type" attribute of the <artwork> and <sourcecode> elements is
2985	   meant to encourage processors to automatically extract known types of
2986	   content from an RFC or Internet Draft.  While extraction is probalby
2987	   safe, those processors might also think that they could further
2988	   process the extracted content such as by rendering artwork or
2989	   executing code.  Doing so without first sanity-checking the extracted
2990	   content is clearly a terrible idea from a security perspective.  More
2991	   generally, a processor that is reading RFCs or Internet Drafts needs
2992	   to be suspicious of any content that it intends to post-process.

2994	   Furthermore, all security considerations related to XML processing
2995	   are relevant as well (see Section 7 of [RFC3470]).

2997	5.  IANA Considerations

2999	5.1.  Internet Media Type Registration

3001	   IANA maintains the registry of Internet media types [BCP13] at
3002	   <http://www.iana.org/assignments/media-types>.

3004	   This document updates the specification for the Internet media type
3005	   "application/rfc+xml" from the one in [XML2RFCv2].  The following is
3006	   to be registered with IANA.

3008	   Type name:  application

3010	   Subtype name:  rfc+xml

3012	   Required parameters:  There are no required parameters.

3014	   Optional parameters:  "charset": This parameter has identical
3015	      semantics as the charset parameter of the "application/xml" media
3016	      type specified in [RFC3023].

3018	   Encoding considerations:  Identical to those of "application/xml" as
3019	      described in Section 3.2 of [RFC3023].

3021	   Security considerations:  As defined in Section 4.  In addition, as
3022	      this media type uses the "+xml" convention, it inherits the
3023	      security considerations described in Section 10 of [RFC3023].

3025	   Interoperability considerations:  N/A

3027	   Published specification:  This specification.

3029	   Applications that use this media type:  Applications that either
3030	      transform xml2rfc to output representations such as plain text or
3031	      HTML, plus additional analysis tools.

3033	   Fragment identifier considerations:  The "anchor" attribute is used
3034	      for assigning document-wide unique identifiers that can be uses as
3035	      shorthand pointers, as described in Section 2.8 of [XPOINTER].

3037	   Additional information:

3039	      Deprecated alias names for this type:  None.

3041	      Magic number(s):  As specified for "application/xml" in Section
3042	         3.2 of [RFC3023].

3044	      File extension(s):  .xml

3046	      Macintosh file type code(s):  TEXT

3048	   Person & email address to contact for further information:  See
3049	      Authors Section.

3051	   Intended usage:  COMMON

3053	   Restrictions on usage:  N/A

3055	   Author:  See Authors Section.

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

3059	5.2.  Link Relation Registration

3061	   The following is a proposed addition to [LINKRELATIONS].

3063	   Relation Name: convertedFrom

3065	   Description: The document linked to was later converted to the
3066	   document that contains this link relation.  For example, an RFC can
3067	   have a link to the Internet Draft that became the RFC; in that case,
3068	   the link relation would be "convertedFrom".

3070	   Reference: This document.

3072	   Notes: This relation is different than "predecessor-version" in that
3073	   "predecessor-version" is for items in a version control system.  It
3074	   is also different that "previous" in that this relation is used for
3075	   converted resources, not those that are part of a sequence of
3076	   resources.

3078	   Application Data: none

3080	6.  Acknowledgments

3082	   Thanks to everybody who reviewed this document and provided feedback
3083	   and/or specification text.  Thanks especially go to Julian Reschke
3084	   for editing [XML2RFCv2] and those who provided feedback on that
3085	   document.

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

3090	7.  References

3092	7.1.  Normative References

3094	   [XML]            Maler, E., Yergeau, F., Paoli, J., Sperberg-McQueen,
3095	                    M., and T. Bray, "Extensible Markup Language (XML)
3096	                    1.0 (Fifth Edition)", W3C Recommendation REC-xml-
3097	                    20081126, November 2008,
3098	                    <http://www.w3.org/TR/2008/REC-xml-20081126/>.

3100	                    Latest version available at
3101	                    <http://www.w3.org/TR/xml>.

3103	   [XML2RFCv2]      Reschke, J., "The 'XML2RFC' version 2 Vocabulary",
3104	                    draft-reschke-xml2rfc (work in progress), 2014.

3106	7.2.  Informative References

3108	   [BCP13]          Freed, N., Klensin, J., and T. Hansen, "Media Type
3109	                    Specifications and Registration Procedures", BCP 13,
3110	                    RFC 6838, January 2013.

3112	   [IDGUIDE]        Housley, R., "Guidelines to Authors of Internet-
3113	                    Drafts",
3114	                    <http://www.ietf.org/id-info/guidelines.html>.

3116	   [LINKRELATIONS]  IANA, "Link Relations", <http://www.iana.org/
3117	                    assignments/link-relations/link-relations.xhtml>.

3119	   [RFC2026]        Bradner, S., "The Internet Standards Process --
3120	                    Revision 3", BCP 9, RFC 2026, October 1996.

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

3125	   [RFC2629]        Rose, M., "Writing I-Ds and RFCs using XML",
3126	                    RFC 2629, June 1999.

3128	   [RFC3023]        Murata, M., St. Laurent, S., and D. Kohn, "XML Media
3129	                    Types", RFC 3023, January 2001.

3131	   [RFC3470]        Hollenbeck, S., Rose, M., and L. Masinter,
3132	                    "Guidelines for the Use of Extensible Markup
3133	                    Language (XML) within IETF Protocols", BCP 70,
3134	                    RFC 3470, January 2003.

3136	   [RFC3966]        Schulzrinne, H., "The tel URI for Telephone
3137	                    Numbers", RFC 3966, December 2004.

3139	   [RFC3986]        Berners-Lee, T., Fielding, R., and L. Masinter,
3140	                    "Uniform Resource Identifier (URI): Generic Syntax",
3141	                    STD 66, RFC 3986, January 2005.

3143	   [RFC5741]        Daigle, L. and O. Kolkman, "RFC Streams, Headers,
3144	                    and Boilerplates", RFC 5741, December 2009.

3146	   [RFC6068]        Duerst, M., Masinter, L., and J. Zawinski, "The
3147	                    'mailto' URI Scheme", RFC 6068, October 2010.

3149	   [RFC6266]        Reschke, J., "Use of the Content-Disposition Header
3150	                    Field in the Hypertext Transfer Protocol (HTTP)",
3151	                    RFC 6266, June 2011.

3153	   [RFC6949]        Flanagan, H. and N. Brownlee, "RFC Series Format
3154	                    Requirements and Future Development", RFC 6949,
3155	                    May 2013.

3157	   [RFCPOLICY]      RFC Editor, "RFC Editorial Guidelines and
3158	                    Procedures",
3159	                    <http://www.rfc-editor.org/policy.html>.

3161	   [RFCSTYLE]       Heather, H. and S. Ginoza, "RFC Style Guide",
3162	                    draft-iab-styleguide (work in progress).

3164	   [RNC]            Clark, J., "RELAX NG Compact Syntax", OASIS ,
3165	                    November 2002, <http://www.oasis-open.org/
3166	                    committees/relax-ng/compact-20021121.html>.

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

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

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

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

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

3188	   [UNICODE]        The Unicode Consortium, "The Unicode Standard,
3189	                    Version 6.3.0", September 2013,
3190	                    <http://www.unicode.org/versions/Unicode6.3.0/>.

3192	   [XInclude]       Marsh, J., Orchard, D., and D. Veillard, "XML
3193	                    Inclusions (XInclude) Version 1.0 (Second Edition)",
3194	                    W3C Recommendation REC-xinclude-20061115,
3195	                    November 2006, <http://www.w3.org/TR/xinclude/>.

3197	                    Latest version available at
3198	                    <http://www.w3.org/TR/xinclude/>.

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

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

3208	Appendix A.  Front Page Generation

3210	A.1.  The /rfc/@category Attribute

3212	   For RFCs, the category determines the "maturity level" (see Section 4
3213	   of [RFC2026]).  The allowed values are "std" for "Standards Track",
3214	   "bcp" for "BCP", "info" for "Informational", "exp" for
3215	   "Experimental", and "historic" for "Historic".

3217	   For Internet-Drafts, the category attribute is not needed, but will
3218	   appear on the front page as "Intended Status".  Supplying this
3219	   information can be useful to reviewers.

3221	A.2.  The /rfc/@ipr Attribute

3223	   This attribute value can take a long list of values, each of which
3224	   describes an IPR policy for the document.  This attribute's values
3225	   are not the result of a grand plan, but remain simply for historic
3226	   reasons.  Of these values, only a few are currently in use; all
3227	   others are supported by the various tools for backwards compatibility
3228	   with old source files.

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

3235	   Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION.  IF YOU
3236	   NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER.  For further information,
3237	   refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>.

3239	   For the current "Status Of This Memo" text, the submissionType
3240	   attribute determines whether a statement about "Code Components" is
3241	   inserted (which is the case for the value "IETF", which is the
3242	   default).  Other values, such as "independent", suppress this part of
3243	   the text.

3245	A.2.1.  Current Values: '*trust200902'

3247	   The name for these values refers to the "IETF TRUST Legal Provisions
3248	   Relating to IETF Documents", sometimes simply called the "TLP, that
3249	   went into effect on February 15, 2009 ([TLP2.0]).  Updates to this
3250	   document were published on September 12, 2009 ([TLP3.0]) and on
3251	   December 28, 2009 ([TLP4.0]), modifying the license for code
3252	   components (see <http://trustee.ietf.org/license-info/> for further
3253	   information).  The actual text is located in Section 6 ("Text To Be
3254	   Included in IETF Documents") of these documents.

3256	   The tools will automatically produce the "correct" text depending on
3257	   the document's date information (see above):

3259	   +----------+--------------------------------+
3260	   | TLP      | starting with publication date |
3261	   +----------+--------------------------------+
3262	   | [TLP3.0] | 2009-11-01                     |
3263	   | [TLP4.0] | 2010-04-01                     |
3264	   +----------+--------------------------------+

3266	A.2.1.1.  trust200902

3268	   This should be the default, unless one of the more specific
3269	   '*trust200902' values is a better fit.  It produces the text in
3270	   Sections 6.a and 6.b of the TLP.

3272	A.2.1.2.  noModificationTrust200902

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

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

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

3283	A.2.1.3.  noDerivativesTrust200902

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

3287	      This document may not be modified, and derivative works of it may
3288	      not be created, and it may not be published except as an Internet-
3289	      Draft.

3291	      Note: this clause is incompatible with RFCs.

3293	A.2.1.4.  pre5378Trust200902

3295	   This produces the additional text from Section 6.c.iii of the TLP,
3296	   frequently called the "pre-5378 escape clause":

3298	      This document may contain material from IETF Documents or IETF
3299	      Contributions published or made publicly available before November
3300	      10, 2008.  The person(s) controlling the copyright in some of this
3301	      material may not have granted the IETF Trust the right to allow
3302	      modifications of such material outside the IETF Standards Process.
3303	      Without obtaining an adequate license from the person(s)
3304	      controlling the copyright in such materials, this document may not
3305	      be modified outside the IETF Standards Process, and derivative
3306	      works of it may not be created outside the IETF Standards Process,
3307	      except to format it for publication as an RFC or to translate it
3308	      into languages other than English.

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

3314	      Note: this text appears under "Copyright Notice", unless the
3315	      document was published before November 2009, in which case it
3316	      appears under "Status Of This Memo".

3318	A.2.2.  Historic Values

3320	A.2.2.1.  Historic Values: '*trust200811'

3322	   The attribute values "trust200811", "noModificationTrust200811" and
3323	   "noDerivativesTrust200811" are similar to their "trust200902"
3324	   counterparts, except that they use text specified in <http://
3325	   trustee.ietf.org/license-info/archive/
3326	   IETF-Trust-License-Policy_11-10-08.pdf>.

3328	A.2.2.2.  Historic Values: '*3978'

3330	   The attribute values "full3978", "noModification3978" and
3331	   "noDerivatives3978" are similar to their counterparts above, except
3332	   that they use text specified in RFC 3978 (March 2005).

3334	A.2.2.3.  Historic Values: '*3667'

3336	   The attribute values "full3667", "noModification3667" and
3337	   "noDerivatives3667" are similar to their counterparts above, except
3338	   that they use text specified in RFC 3667 (February 2004).

3340	A.2.2.4.  Historic Values: '*2026'

3342	   The attribute values "full2026" and "noDerivativeWorks2026" are
3343	   similar to their counterparts above, except that they use text
3344	   specified in RFC 2026 (October 1996).

3346	   The special value "none" was also used back then, and denied the IETF
3347	   any rights beyond publication as Internet-Draft.

3349	Appendix B.  The v3 Format and Processors

3351	   This section describes topics that are specific to processors.  Note
3352	   that there is some discussion of processors in the main body of the
3353	   document as well.  For example, some elements have descriptions of
3354	   how a processor might create output from the element.

3356	   A processor has multiple roles.  The processor checks whether or not
3357	   the input is valid XML; it also checks whether or not the input XML
3358	   matches this format.  It may have one or more outputs, depending on
3359	   the way that it is invoked.  It might convert the XML to different
3360	   XML, or to a different representation such as HTML or plain text, or
3361	   do no conversion at all.  It also might give diagnostic warnings
3362	   about how to improve the input.

3364	   In v2, the grammar was specified as a DTD.  In v3, the grammar is
3365	   specified only as Relax Next Generation (RNG).  This means that
3366	   processors need to work from the RNG, not from a DTD.  Some of the
3367	   features of the v3 grammar cannot be specified as a DTD.

3369	   This section differentiates between three types of processors:

3371	   o  RFC Processor -- The processor used by the RFC Editor to process
3372	      the input from one of the RFC streams, and to process XML produced
3373	      during the RFC editing process.

3375	   o  Draft Processor -- The processor used by the Internet Draft
3376	      submission tool.

3378	   o  Private Processors -- There may be processors that are meant to
3379	      run on the computers of authors.  These processors may be used to
3380	      produce interim versions of the non-canonical representations so
3381	      that authors can see how their XML might later be rendered; to
3382	      create documents in representations different than those supported
3383	      by the RFC Editor; to possibly create documents that are not meant
3384	      to be Internet Drafts or RFCs; and to convert XML that has
3385	      external information into XML that has that external information
3386	      included.

3388	   It is expected that a single piece of software will be used for both
3389	   the RFC Processor and the Draft Processor, with different application
3390	   settings to differentiate between them.  It is also expected that the
3391	   same software could be used as a Private Processor; others might
3392	   create Private Processors independently, or using parts of, the
3393	   software used by the RFC Editor.

3395	   The RFC Processor and Draft Processor must have clear error
3396	   reporting, giving more context than just a line number.  For example,
3397	   the error messages will differentiate between errors in XML and those
3398	   from the v3 format.

3400	B.1.  Including External Text

3402	   All XML processors for v3 are expected to support XInclude
3403	   [XInclude].  XInclude specifies a processing model and syntax for
3404	   general purpose inclusion of information that is either on the
3405	   Internet or local to the user's computer.

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

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

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

3415	   The most common way to use <xi:include> is to pull in references that
3416	   are already formed as XML.  Currently, this is done from
3417	   xml.resource.org, but later is expected to be from the RFC Editor.
3418	   For example, if a document has three normative references, all RFCs,
3419	   the document might contain:

3421	   <references>
3422	       <xi:include href="http://xml.resource.org/public/rfc/
3423	          bibxml/reference.RFC.2119.xml"/>
3424	       <xi:include href="http://xml.resource.org/public/rfc/
3425	          bibxml/reference.RFC.4869.xml"/>
3426	       <xi:include href="http://xml.resource.org/public/rfc/
3427	          bibxml/reference.RFC.7169.xml"/>
3428	   </references>
3429	   <xi:include> can be used anywhere an XML element could be used (but
3430	   not where free text is used).  For example, if three Internet Drafts
3431	   are all including a particular paragraph or section verbatim, that
3432	   text can be kept either in a file or somewhere on the web, and be
3433	   included with <xi:include>.  An example of pulling something from the
3434	   local disk would be:

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

3438	   [[anchor21: Need to think a bit more about using xi:include to
3439	   replace src= for artwork or sourcecode.]]

3441	Appendix C.  Format and Content of RFCs (Future)

3443	   [[[ This section describes the format of RFCs in the future.  The
3444	   section is in this document only temporarily: it soon move to its own
3445	   page on the RFC Editor's web site. ]]]

3447	   The v3 format will be used as part of the new RFC series format
3448	   described in [RFC6949].  RFCs will have multiple representations: the
3449	   canonical document will be in XML using the v3 format, and many non-
3450	   canonical representations (such as HTML and text) will be generated
3451	   as well.

3453	C.1.  Canonical RFCs

3455	   The canonical RFCs will not have any markup that uses a deprecated
3456	   feature.  The processor described in Appendix B will have a "convert
3457	   with warnings" mode that will convert a v2 document to a v3 document
3458	   that converts deprecated features wherever possible, issuing warnings
3459	   for where it cannot convert.  The processor will also have a "strict"
3460	   mode that will issue errors if any deprecated features are in the
3461	   input.

3463	   The canonical format for RFCs have a number of restrictions that the
3464	   RFC Processor needs to enforce before a document can be published in
3465	   its final form.  In this "final" mode, the processor will give a hard
3466	   error when an input XML file has:

3468	   o  any element or attribute listed as "deprecated" in the v3
3469	      vocabulary

3471	   o  XML comments

3473	   o  XML Processor Instructions (PIs)

3475	   o  an external DTD
3476	   o  ENTITYs that have a SYSTEM component

3478	   o  <artwork> elements with a "src" attribute that points to a URI
3479	      with a scheme other than "data:"

3481	   o  <cref> elements

3483	   The RFC Processor will have a mode that gives hard errors on all of
3484	   the above other than <cref> elements.  This exception is to allow the
3485	   RPC to insert <cref> elements in the working XML for notes to authors
3486	   in AUTH 48, notes to IANA, and so on.

3488	   The RFC Processor will also generate values for the
3489	   "autogeneratedBoilerplateText" attribute in <rfc>, and
3490	   "autogeneratedSectionNumber", "autogeneratedFigureNumber", and
3491	   "autogeneratedTableNumber" attributes in <section>, <figure>, and
3492	   <texttable> entities, respectively.  These will be filled in by the
3493	   RFC processor so that the canonical XML file has all of the same
3494	   information as the non-canonical representations.

3496	C.2.  Non-canonical RFC Representations

3498	   As described in [RFC6949], the RFC Editor will publish non-canonical
3499	   representations of RFCs.  Those non-canonical representations will be
3500	   derived from the canonical XML.  The generation of these non-
3501	   canonical representations means that there will be much more emphasis
3502	   put on the RFC Processor.

3504	   [[[ Stuff will go on the web page about each non-canonical
3505	   representation. ]]]

3507	Appendix D.  Format and Content of Internet Drafts (Future)

3509	   [[[ This section describes a future where the v3 format will be
3510	   allowed as the input for Internet Draft publication.  The section is
3511	   in this document only temporarily: it soon move to its own page
3512	   managed by someone yet to be determined. ]]]

3514	   [[[ Description of the transition from the current text format to
3515	   also allowing v3 XML. ]]]

3517	   [[[ Description of what will and won't be allowed in input XML. ]]]

3519	D.1.  The Draft Processor

3521	   The Draft Processor will handle input differently than the RFC
3522	   Processor.  For example, some XML that is valid for Internet Drafts
3523	   will not be valid for canonical RFCs, so the Draft Processor can be
3524	   set to give warnings for those features but the RFC Processor can be
3525	   set to give hard errors.

3527	   The Draft Processor will help in the transition from the v2 format to
3528	   the v3 format.  A user could request that the Draft Processor convert
3529	   a v2 document to v3, using the new features of v3 where appropriate,
3530	   and removing the parts that are no longer supported.  The processor
3531	   might be able to fully convert a v2 document to v3, or it might have
3532	   to only give advice on some of the v2 features that could not be
3533	   automatically converted.

3535	   The Draft Processor should have a mode that mimics the RFC
3536	   Processor's restictive mode, but that instead gives warnings instead
3537	   of hard errors.  The Draft Processor should also produce interim
3538	   versions of the non-canonical representations so that authors can see
3539	   how their XML might later be rendered; and to convert documents that
3540	   use the v2 format to v3.

3542	D.2.  Processor Instructions

3544	   In the v2 format, XML PIs were used for a wide variety of tasks,
3545	   including changing some formatting of the text outputs, adding
3546	   information to HTML versions of Internet Drafts, and specifying other
3547	   instructions to processors.  In the v3 format, a much smaller set of
3548	   PIs is supported for the Draft Processor and Private Processors.  It
3549	   is important to note that canonical RFCs will not contain any PIs.

3551	   The following PIs will be supported by the Draft Processor:

3553	   o  editing -- When set ot "yes", causes the processor to insert
3554	      reference numbers throughout the output files to allow ease of
3555	      referral to particular paragraphs or artwork in the text.  The
3556	      default is "no".

3558	   The following PIs will not be supported by the Draft Processor, but
3559	   are included so that Private Processors have a common way of
3560	   referring to them:

3562	   o  comments -- When set to "yes", causes all <cref> elements to be
3563	      rendered in the output files.  The default is "yes".

3565	   o  linefile -- Causes the processor to emit more detailed information
3566	      about which line of which input file caused an error or warning.

3568	   Note that a Private Processor can have PIs not from this list.

3570	Appendix E.  Relax NG Schema

3572	   The following is the RelaxNG schema for the v3 format.

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

3576	   rfc =
3577	     element rfc {
3578	       attribute number { text }?,
3579	       [ a:defaultValue = "" ] attribute obsoletes { text }?,
3580	       [ a:defaultValue = "" ] attribute updates { text }?,
3581	       attribute category { "std" | "bcp" | "info" | "exp" | "historic"
3582	   }?,
3583	       attribute consensus { "no" | "yes" }?,
3584	       attribute seriesNo { text }?,
3585	       attribute ipr {
3586	         "full2026"
3587	         | "noDerivativeWorks2026"
3588	         | "none"
3589	         | "full3667"
3590	         | "noModification3667"
3591	         | "noDerivatives3667"
3592	         | "full3978"
3593	         | "noModification3978"
3594	         | "noDerivatives3978"
3595	         | "trust200811"
3596	         | "noModificationTrust200811"
3597	         | "noDerivativesTrust200811"
3598	         | "trust200902"
3599	         | "noModificationTrust200902"
3600	         | "noDerivativesTrust200902"
3601	         | "pre5378Trust200902"
3602	       }?,
3603	       attribute iprExtract { xsd:IDREF }?,
3604	       [ a:defaultValue = "IETF" ]
3605	       attribute submissionType {
3606	         "IETF" | "IAB" | "IRTF" | "independent"
3607	       }?,
3608	       attribute docName { text }?,
3609	       [ a:defaultValue = "en" ] attribute xml:lang { text }?,
3610	       [ a:defaultValue = "no" ] attribute sortRefs { "yes" | "no" }?,
3611	       [ a:defaultValue = "yes" ] attribute symRefs { "yes" | "no" }?,
3612	       [ a:defaultValue = "yes" ] attribute tocInclude { "yes" | "no"
3613	   }?,
3614	       [ a:defaultValue = "3" ] attribute tocDepth { text }?,
3615	       attribute autogeneratedBoilerplateText { text }?,
3616	       link?,
3617	       front,
3618	       middle,
3619	       back?
3620	     }
3621	   link =
3622	     element link {
3623	       attribute href { text },
3624	       attribute rel { text }?
3625	     }
3626	   front =
3627	     element front {
3628	       title, author+, date?, area*, workgroup*, keyword*, abstract?,
3629	   note*
3630	     }
3631	   title =
3632	     element title {
3633	       attribute abbrev { text }?,
3634	       attribute ascii { text }?,
3635	       text
3636	     }
3637	   author =
3638	     element author {
3639	       attribute initials { text }?,
3640	       attribute surname { text }?,
3641	       attribute fullname { text }?,
3642	       attribute role { "editor" }?,
3643	       [ a:defaultValue = "en" ] attribute xml:lang { text }?,
3644	       attribute ascii { text }?,
3645	       organization?,
3646	       address?
3647	     }
3648	   organization =
3649	     element organization {
3650	       attribute abbrev { text }?,
3651	       attribute ascii { text }?,
3652	       text
3653	     }
3654	   address =
3655	     element address { (postal | phone | facsimile | email | uri)* }
3656	   postal =
3657	     element postal {
3658	       [ a:defaultValue = "en" ] attribute xml:lang { text }?,
3659	       ((street | city | region | code | country)* | postalLine+)
3660	     }
3661	   street =
3662	     element street {
3663	       attribute ascii { text }?,
3664	       text

3666	     }
3667	   city =
3668	     element city {
3669	       attribute ascii { text }?,
3670	       text
3671	     }
3672	   region =
3673	     element region {
3674	       attribute ascii { text }?,
3675	       text
3676	     }
3677	   code =
3678	     element code {
3679	       attribute ascii { text }?,
3680	       text
3681	     }
3682	   country = element country { text }
3683	   postalLine =
3684	     element postalLine {
3685	       attribute ascii { text }?,
3686	       text
3687	     }
3688	   phone = element phone { text }
3689	   facsimile = element facsimile { text }
3690	   email =
3691	     element email {
3692	       attribute ascii { text }?,
3693	       text
3694	     }
3695	   uri = element uri { text }
3696	   date =
3697	     element date {
3698	       attribute day { text }?,
3699	       attribute month { text }?,
3700	       attribute year { text }?,
3701	       empty
3702	     }
3703	   area = element area { text }
3704	   workgroup = element workgroup { text }
3705	   keyword = element keyword { text }
3706	   abstract = element abstract { t+ }
3707	   note =
3708	     element note {
3709	       attribute title { text },
3710	       t+
3711	     }
3712	   middle = element middle { section+ }
3713	   section =
3714	     element section {
3715	       attribute anchor { xsd:ID }?,
3716	       attribute title { text }?,
3717	       [ a:defaultValue = "yes" ] attribute numbered { "yes" | "no" }?,
3718	       [ a:defaultValue = "default" ]
3719	       attribute toc { "include" | "exclude" | "default" }?,
3720	       [ a:defaultValue = "no" ] attribute removeInRFC { "yes" | "no"
3721	   }?,
3722	       attribute autogeneratedSectionNumber { text }?,
3723	       titleelement?,
3724	       (t
3725	        | aside
3726	        | blockquote
3727	        | figure
3728	        | texttable
3729	        | iref
3730	        | artwork
3731	        | sourcecode)*,
3732	       section*
3733	     }
3734	   titleelement =
3735	     element titleelement { (text | xref | eref | iref | cref | tt)* }
3736	   t =
3737	     element t {
3738	       attribute anchor { xsd:ID }?,
3739	       (text
3740	        | \list
3741	        | ol
3742	        | ul
3743	        | dl
3744	        | figure
3745	        | artwork
3746	        | sourcecode
3747	        | xref
3748	        | eref
3749	        | iref
3750	        | cref
3751	        | spanx
3752	        | vspace
3753	        | tt
3754	        | strong
3755	        | b
3756	        | em
3757	        | i
3758	        | sub
3759	        | sup)*
3760	     }
3761	   aside =
3762	     element aside {
3763	       (t | figure | texttable | iref | artwork | sourcecode)*
3764	     }
3765	   blockquote =
3766	     element blockquote {
3767	       attribute anchor { xsd:ID }?,
3768	       attribute cite { text },
3769	       (text
3770	        | figure
3771	        | artwork
3772	        | sourcecode
3773	        | tt
3774	        | strong
3775	        | b
3776	        | em
3777	        | i
3778	        | sub
3779	        | sup)*
3780	     }
3781	   \list =
3782	     element list {
3783	       [ a:defaultValue = "empty" ] attribute style { text }?,
3784	       attribute hangIndent { text }?,
3785	       attribute counter { text }?,
3786	       t+
3787	     }
3788	   ol =
3789	     element ol {
3790	       [ a:defaultValue = "1" ] attribute style { text }?,
3791	       [ a:defaultValue = "1" ] attribute start { text }?,
3792	       attribute group { text }?,
3793	       [ a:defaultValue = "normal" ]
3794	       attribute spacing { "normal" | "compact" }?,
3795	       li+
3796	     }
3797	   ul =
3798	     element ul {
3799	       [ a:defaultValue = "normal" ]
3800	       attribute spacing { "normal" | "compact" }?,
3801	       [ a:defaultValue = "false" ] attribute empty { "false" | "true"
3802	   }?,
3803	       li+
3804	     }
3805	   li =
3806	     element li {
3807	       t+
3808	       | (text,
3809	          ol,
3810	          ul,
3811	          dl,
3812	          figure,
3813	          artwork,
3814	          sourcecode,
3815	          xref,
3816	          eref,
3817	          iref,
3818	          cref,
3819	          tt,
3820	          strong,
3821	          b,
3822	          em,
3823	          i,
3824	          sub,
3825	          sup)+
3826	     }
3827	   dl =
3828	     element dl {
3829	       [ a:defaultValue = "normal" ]
3830	       attribute spacing { "normal" | "compact" }?,
3831	       [ a:defaultValue = "false" ]
3832	       attribute hanging { "false" | "true" }?,
3833	       (dt, dd)+
3834	     }
3835	   dt =
3836	     element dt {
3837	       (text
3838	        | xref
3839	        | eref
3840	        | iref
3841	        | cref
3842	        | tt
3843	        | strong
3844	        | b
3845	        | em
3846	        | i
3847	        | sub
3848	        | sup)*
3849	     }
3850	   dd =
3851	     element dd {
3852	       t+
3853	       | (text,
3854	          ol,
3855	          ul,
3856	          dl,
3857	          figure,
3858	          artwork,
3859	          sourcecode,
3860	          xref,
3861	          eref,
3862	          iref,
3863	          cref,
3864	          tt,
3865	          strong,
3866	          b,
3867	          em,
3868	          i,
3869	          sub,
3870	          sup)+
3871	     }
3872	   xref =
3873	     element xref {
3874	       attribute target { xsd:IDREF },
3875	       [ a:defaultValue = "false" ] attribute pageno { "true" | "false"
3876	   }?,
3877	       [ a:defaultValue = "default" ]
3878	       attribute format { "counter" | "title" | "none" | "default" }?,
3879	       (attribute section { text },
3880	        attribute relative { text }?,
3881	        attribute sectionFormat { text }?)?,
3882	       text
3883	     }
3884	   eref =
3885	     element eref {
3886	       attribute target { text },
3887	       text
3888	     }
3889	   iref =
3890	     element iref {
3891	       attribute item { text },
3892	       [ a:defaultValue = "" ] attribute subitem { text }?,
3893	       [ a:defaultValue = "false" ]
3894	       attribute primary { "true" | "false" }?,
3895	       empty
3896	     }
3897	   cref =
3898	     element cref {
3899	       attribute anchor { xsd:ID }?,
3900	       attribute source { text }?,
3901	       (text | xref | eref | tt | strong | b | em | i | sub | sup)*
3902	     }
3903	   tt =
3904	     element tt {
3905	       (text
3906	        | xref
3907	        | eref
3908	        | iref
3909	        | cref
3910	        | strong
3911	        | b
3912	        | em
3913	        | i
3914	        | sub
3915	        | sup)*
3916	     }
3917	   b =
3918	     element b {
3919	       (text | xref | eref | iref | cref | tt | em | i | sub | sup)*
3920	     }
3921	   strong =
3922	     element strong {
3923	       (text | xref | eref | iref | cref | tt | em | i | sub | sup)*
3924	     }
3925	   i =
3926	     element i {
3927	       (text | xref | eref | iref | cref | tt | strong | b | sub | sup)*
3928	     }
3929	   em =
3930	     element em {
3931	       (text | xref | eref | iref | cref | tt | strong | b | sub | sup)*
3932	     }
3933	   sub =
3934	     element sub {
3935	       (text | xref | eref | iref | cref | tt | strong | b | em | i)*
3936	     }
3937	   sup =
3938	     element sup {
3939	       (text | xref | eref | iref | cref | tt | strong | b | em | i)*
3940	     }
3941	   spanx =
3942	     element spanx {
3943	       [ a:defaultValue = "preserve" ]
3944	       attribute xml:space { "default" | "preserve" }?,
3945	       [ a:defaultValue = "emph" ] attribute style { text }?,
3946	       text
3947	     }
3948	   vspace =
3949	     element vspace {
3950	       [ a:defaultValue = "0" ] attribute blankLines { text }?,
3951	       empty
3952	     }
3953	   figure =
3954	     element figure {
3955	       attribute anchor { xsd:ID }?,
3956	       [ a:defaultValue = "" ] attribute title { text }?,
3957	       [ a:defaultValue = "false" ]
3958	       attribute suppress-title { "true" | "false" }?,
3959	       attribute src { text }?,
3960	       [ a:defaultValue = "left" ]
3961	       attribute align { "left" | "center" | "right" }?,
3962	       [ a:defaultValue = "" ] attribute alt { text }?,
3963	       [ a:defaultValue = "" ] attribute width { text }?,
3964	       [ a:defaultValue = "" ] attribute height { text }?,
3965	       attribute autogeneratedFigureNumber { text }?,
3966	       titleelement?,
3967	       iref*,
3968	       preamble?,
3969	       (artwork | sourcecode)+,
3970	       postamble?
3971	     }
3972	   preamble =
3973	     element preamble {
3974	       (text
3975	        | xref
3976	        | eref
3977	        | iref
3978	        | cref
3979	        | spanx
3980	        | tt
3981	        | strong
3982	        | b
3983	        | em
3984	        | i
3985	        | sub
3986	        | sup)*
3987	     }
3988	   artwork =
3989	     element artwork {
3990	       attribute xml:space { text }?,
3991	       [ a:defaultValue = "" ] attribute name { text }?,
3992	       [ a:defaultValue = "" ] attribute type { text }?,
3993	       attribute src { text }?,
3994	       [ a:defaultValue = "left" ]
3995	       attribute align { "left" | "center" | "right" }?,
3996	       [ a:defaultValue = "" ] attribute alt { text }?,
3997	       [ a:defaultValue = "" ] attribute width { text }?,
3998	       [ a:defaultValue = "" ] attribute height { text }?,
3999	       [ a:defaultValue = "en" ] attribute xml:lang { text }?,
4000	       text*
4001	     }

4003	   sourcecode =
4004	     element sourcecode {
4005	       [ a:defaultValue = "" ] attribute name { text }?,
4006	       [ a:defaultValue = "" ] attribute type { text }?,
4007	       text
4008	     }
4009	   postamble =
4010	     element postamble {
4011	       (text
4012	        | xref
4013	        | eref
4014	        | iref
4015	        | cref
4016	        | spanx
4017	        | tt
4018	        | strong
4019	        | b
4020	        | em
4021	        | i
4022	        | sub
4023	        | sup)*
4024	     }
4025	   texttable =
4026	     element texttable {
4027	       attribute anchor { xsd:ID }?,
4028	       [ a:defaultValue = "" ] attribute title { text }?,
4029	       [ a:defaultValue = "false" ]
4030	       attribute suppress-title { "true" | "false" }?,
4031	       [ a:defaultValue = "center" ]
4032	       attribute align { "left" | "center" | "right" }?,
4033	       [ a:defaultValue = "full" ]
4034	       attribute style { "all" | "none" | "headers" | "full" }?,
4035	       attribute autogeneratedTableNumber { text }?,
4036	       titleelement?,
4037	       preamble?,
4038	       ttcol+,
4039	       c*,
4040	       postamble?
4041	     }
4042	   ttcol =
4043	     element ttcol {
4044	       attribute width { text }?,
4045	       [ a:defaultValue = "left" ]
4046	       attribute align { "left" | "center" | "right" }?,
4047	       (xref | eref | iref | cref | text)*
4048	     }
4049	   c =
4050	     element c {
4051	       (text
4052	        | xref
4053	        | eref
4054	        | iref
4055	        | cref
4056	        | spanx
4057	        | tt
4058	        | strong
4059	        | b
4060	        | em
4061	        | i
4062	        | sub
4063	        | sup)*
4064	     }
4065	   back = element back { displayreference*, references*, section* }
4066	   displayreference =
4067	     element displayreference {
4068	       attribute from { text },
4069	       attribute to { text }
4070	     }
4071	   references =
4072	     element references {
4073	       [ a:defaultValue = "References" ] attribute title { text }?,
4074	       reference+
4075	     }
4076	   reference =
4077	     element reference {
4078	       attribute anchor { xsd:ID },
4079	       attribute target { text }?,
4080	       front,
4081	       (seriesInfo | format | refcontent | annotation)*
4082	     }
4083	   seriesInfo =
4084	     element seriesInfo {
4085	       attribute name { text },
4086	       attribute value { text },
4087	       attribute asciiname { text }?,
4088	       attribute asciivalue { text }?,
4089	       empty
4090	     }
4091	   format =
4092	     element format {
4093	       attribute target { text }?,
4094	       attribute type { text },
4095	       attribute octets { text }?,
4096	       empty
4097	     }
4098	   annotation =
4099	     element annotation {
4100	       attribute ascii { text }?,
4101	       (text
4102	        | xref
4103	        | eref
4104	        | iref
4105	        | cref
4106	        | spanx
4107	        | tt
4108	        | strong
4109	        | b
4110	        | em
4111	        | i
4112	        | sub
4113	        | sup)*
4114	     }
4115	   refcontent =
4116	     element refcontent {
4117	       attribute ascii { text }?,
4118	       (text | tt | b | i | em | strong | sub | sup)*
4119	     }
4120	   start = rfc

4122	Appendix F.  Schema Differences from v2

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

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

4131	     rfc =
4132	       element rfc {
4133	         attribute number { text }?,
4134	         [ a:defaultValue = "" ] attribute obsoletes { text }?,
4135	         [ a:defaultValue = "" ] attribute updates { text }?,
4136	         attribute category { "std" | "bcp" | "info" | "exp" |
4137	     "historic" }?,
4138	         attribute consensus { "no" | "yes" }?,
4139	         attribute seriesNo { text }?,
4140	         attribute ipr {
4141	           "full2026"
4142	           | "noDerivativeWorks2026"
4143	           | "none"
4144	           | "full3667"
4145	           | "noModification3667"
4146	           | "noDerivatives3667"
4147	           | "full3978"
4148	           | "noModification3978"
4149	           | "noDerivatives3978"
4150	           | "trust200811"
4151	           | "noModificationTrust200811"
4152	           | "noDerivativesTrust200811"
4153	           | "trust200902"
4154	           | "noModificationTrust200902"
4155	           | "noDerivativesTrust200902"
4156	           | "pre5378Trust200902"
4157	         }?,
4158	         attribute iprExtract { xsd:IDREF }?,
4159	         [ a:defaultValue = "IETF" ]
4160	         attribute submissionType {
4161	           "IETF" | "IAB" | "IRTF" | "independent"
4162	         }?,
4163	         attribute docName { text }?,
4164	         [ a:defaultValue = "en" ] attribute xml:lang { text }?,
4165	   +     [ a:defaultValue = "no" ] attribute sortRefs { "yes" | "no"
4166	   + }?,
4167	   +     [ a:defaultValue = "yes" ] attribute symRefs { "yes" | "no"
4168	   + }?,
4169	   +     [ a:defaultValue = "yes" ] attribute tocInclude { "yes" |
4170	   + "no" }?,
4171	   +     [ a:defaultValue = "3" ] attribute tocDepth { text }?,
4172	   +     attribute autogeneratedBoilerplateText { text }?,
4173	   +     link?,
4174	         front,
4175	         middle,
4176	         back?
4177	       }
4178	   + link =
4179	   +   element link {
4180	   +     attribute href { text },
4181	   +     attribute rel { text }?
4182	   +   }
4183	     front =
4184	       element front {
4185	   -     title, author+, date, area*, workgroup*, keyword*, abstract?,
4186	   - note*
4187	   +     title, author+, date?, area*, workgroup*, keyword*,
4188	   + abstract?, note*
4189	       }
4190	     title =
4191	       element title {
4192	         attribute abbrev { text }?,

4194	   +     attribute ascii { text }?,
4195	         text
4196	       }
4197	     author =
4198	       element author {
4199	         attribute initials { text }?,
4200	         attribute surname { text }?,
4201	         attribute fullname { text }?,
4202	         attribute role { "editor" }?,
4203	   +     [ a:defaultValue = "en" ] attribute xml:lang { text }?,
4204	   +     attribute ascii { text }?,
4205	         organization?,
4206	         address?
4207	       }
4208	     organization =
4209	       element organization {
4210	         attribute abbrev { text }?,
4211	   +     attribute ascii { text }?,
4212	   +     text
4213	   +   }
4214	   + address =
4215	   +   element address { (postal | phone | facsimile | email | uri)* }
4216	   + postal =
4217	   +   element postal {
4218	   +     [ a:defaultValue = "en" ] attribute xml:lang { text }?,
4219	   +     ((street | city | region | code | country)* | postalLine+)
4220	   +   }
4221	   + street =
4222	   +   element street {
4223	   +     attribute ascii { text }?,
4224	   +     text
4225	   +   }
4226	   + city =
4227	   +   element city {
4228	   +     attribute ascii { text }?,
4229	   +     text
4230	   +   }
4231	   + region =
4232	   +   element region {
4233	   +     attribute ascii { text }?,
4234	   +     text
4235	   +   }
4236	   + code =
4237	   +   element code {
4238	   +     attribute ascii { text }?,
4239	         text
4240	       }
4241	   - address = element address { postal?, phone?, facsimile?, email?,
4242	   - uri? }
4243	   - postal = element postal { street+, (city | region | code |
4244	   - country)* }
4245	   - street = element street { text }
4246	   - city = element city { text }
4247	   - region = element region { text }
4248	   - code = element code { text }
4249	     country = element country { text }
4250	   + postalLine =
4251	   +   element postalLine {
4252	   +     attribute ascii { text }?,
4253	   +     text
4254	   +   }
4255	     phone = element phone { text }
4256	     facsimile = element facsimile { text }
4257	   - email = element email { text }
4258	   + email =
4259	   +   element email {
4260	   +     attribute ascii { text }?,
4261	   +     text
4262	   +   }
4263	     uri = element uri { text }
4264	     date =
4265	       element date {
4266	         attribute day { text }?,
4267	         attribute month { text }?,
4268	         attribute year { text }?,
4269	         empty
4270	       }
4271	     area = element area { text }
4272	     workgroup = element workgroup { text }
4273	     keyword = element keyword { text }
4274	     abstract = element abstract { t+ }
4275	     note =
4276	       element note {
4277	         attribute title { text },
4278	         t+
4279	       }
4280	     middle = element middle { section+ }
4281	     section =
4282	       element section {
4283	         attribute anchor { xsd:ID }?,
4284	   -     attribute title { text },
4285	   +     attribute title { text }?,
4286	   +     [ a:defaultValue = "yes" ] attribute numbered { "yes" | "no"
4287	   + }?,
4288	         [ a:defaultValue = "default" ]
4289	         attribute toc { "include" | "exclude" | "default" }?,

4291	   -     (t | figure | texttable | iref)*,
4292	   +     [ a:defaultValue = "no" ] attribute removeInRFC { "yes" |
4293	   + "no" }?,
4294	   +     attribute autogeneratedSectionNumber { text }?,
4295	   +     titleelement?,
4296	   +     (t
4297	   +      | aside
4298	   +      | blockquote
4299	   +      | figure
4300	   +      | texttable
4301	   +      | iref
4302	   +      | artwork
4303	   +      | sourcecode)*,
4304	         section*
4305	       }
4306	   + titleelement =
4307	   +   element titleelement { (text | xref | eref | iref | cref | tt)*
4308	   + }
4309	     t =
4310	       element t {
4311	         attribute anchor { xsd:ID }?,
4312	   -     attribute hangText { text }?,
4313	         (text
4314	          | \list
4315	   +      | ol
4316	   +      | ul
4317	   +      | dl
4318	          | figure
4319	   +      | artwork
4320	   +      | sourcecode
4321	          | xref
4322	          | eref
4323	          | iref
4324	          | cref
4325	          | spanx
4326	   -      | vspace)*
4327	   +      | vspace
4328	   +      | tt
4329	   +      | strong
4330	   +      | b
4331	   +      | em
4332	   +      | i
4333	   +      | sub
4334	   +      | sup)*
4335	   +   }
4336	   + aside =
4337	   +   element aside {
4338	   +     (t | figure | texttable | iref | artwork | sourcecode)*
4339	   +   }
4340	   + blockquote =
4341	   +   element blockquote {
4342	   +     attribute anchor { xsd:ID }?,
4343	   +     attribute cite { text },
4344	   +     (text
4345	   +      | figure
4346	   +      | artwork
4347	   +      | sourcecode
4348	   +      | tt
4349	   +      | strong
4350	   +      | b
4351	   +      | em
4352	   +      | i
4353	   +      | sub
4354	   +      | sup)*
4355	       }
4356	     \list =
4357	       element list {
4358	   -     attribute style { text }?,
4359	   +     [ a:defaultValue = "empty" ] attribute style { text }?,
4360	         attribute hangIndent { text }?,
4361	         attribute counter { text }?,
4362	         t+
4363	       }
4364	   + ol =
4365	   +   element ol {
4366	   +     [ a:defaultValue = "1" ] attribute style { text }?,
4367	   +     [ a:defaultValue = "1" ] attribute start { text }?,
4368	   +     attribute group { text }?,
4369	   +     [ a:defaultValue = "normal" ]
4370	   +     attribute spacing { "normal" | "compact" }?,
4371	   +     li+
4372	   +   }
4373	   + ul =
4374	   +   element ul {
4375	   +     [ a:defaultValue = "normal" ]
4376	   +     attribute spacing { "normal" | "compact" }?,
4377	   +     [ a:defaultValue = "false" ] attribute empty { "false" |
4378	   + "true" }?,
4379	   +     li+
4380	   +   }
4381	   + li =
4382	   +   element li {
4383	   +     t+
4384	   +     | (text,
4385	   +        ol,
4386	   +        ul,
4387	   +        dl,
4388	   +        figure,
4389	   +        artwork,
4390	   +        sourcecode,
4391	   +        xref,
4392	   +        eref,
4393	   +        iref,
4394	   +        cref,
4395	   +        tt,
4396	   +        strong,
4397	   +        b,
4398	   +        em,
4399	   +        i,
4400	   +        sub,
4401	   +        sup)+
4402	   +   }
4403	   + dl =
4404	   +   element dl {
4405	   +     [ a:defaultValue = "normal" ]
4406	   +     attribute spacing { "normal" | "compact" }?,
4407	   +     [ a:defaultValue = "false" ]
4408	   +     attribute hanging { "false" | "true" }?,
4409	   +     (dt, dd)+
4410	   +   }
4411	   + dt =
4412	   +   element dt {
4413	   +     (text
4414	   +      | xref
4415	   +      | eref
4416	   +      | iref
4417	   +      | cref
4418	   +      | tt
4419	   +      | strong
4420	   +      | b
4421	   +      | em
4422	   +      | i
4423	   +      | sub
4424	   +      | sup)*
4425	   +   }
4426	   + dd =
4427	   +   element dd {
4428	   +     t+
4429	   +     | (text,
4430	   +        ol,
4431	   +        ul,
4432	   +        dl,
4433	   +        figure,
4434	   +        artwork,
4435	   +        sourcecode,
4436	   +        xref,
4437	   +        eref,
4438	   +        iref,
4439	   +        cref,
4440	   +        tt,
4441	   +        strong,
4442	   +        b,
4443	   +        em,
4444	   +        i,
4445	   +        sub,
4446	   +        sup)+
4447	   +   }
4448	     xref =
4449	       element xref {
4450	         attribute target { xsd:IDREF },
4451	         [ a:defaultValue = "false" ] attribute pageno { "true" |
4452	     "false" }?,
4453	         [ a:defaultValue = "default" ]
4454	         attribute format { "counter" | "title" | "none" | "default"
4455	     }?,
4456	   +     (attribute section { text },
4457	   +      attribute relative { text }?,
4458	   +      attribute sectionFormat { text }?)?,
4459	         text
4460	       }
4461	     eref =
4462	       element eref {
4463	         attribute target { text },
4464	         text
4465	       }
4466	     iref =
4467	       element iref {
4468	         attribute item { text },
4469	         [ a:defaultValue = "" ] attribute subitem { text }?,
4470	         [ a:defaultValue = "false" ]
4471	         attribute primary { "true" | "false" }?,
4472	         empty
4473	       }
4474	     cref =
4475	       element cref {
4476	         attribute anchor { xsd:ID }?,
4477	         attribute source { text }?,
4478	   -     text
4479	   +     (text | xref | eref | tt | strong | b | em | i | sub | sup)*
4480	   +   }
4481	   + tt =
4482	   +   element tt {
4483	   +     (text
4484	   +      | xref
4485	   +      | eref
4486	   +      | iref
4487	   +      | cref
4488	   +      | strong
4489	   +      | b
4490	   +      | em
4491	   +      | i
4492	   +      | sub
4493	   +      | sup)*
4494	   +   }
4495	   + b =
4496	   +   element b {
4497	   +     (text | xref | eref | iref | cref | tt | em | i | sub | sup)*
4498	   +   }
4499	   + strong =
4500	   +   element strong {
4501	   +     (text | xref | eref | iref | cref | tt | em | i | sub | sup)*
4502	   +   }
4503	   + i =
4504	   +   element i {
4505	   +     (text | xref | eref | iref | cref | tt | strong | b | sub |
4506	   + sup)*
4507	   +   }
4508	   + em =
4509	   +   element em {
4510	   +     (text | xref | eref | iref | cref | tt | strong | b | sub |
4511	   + sup)*
4512	   +   }
4513	   + sub =
4514	   +   element sub {
4515	   +     (text | xref | eref | iref | cref | tt | strong | b | em | i)*
4516	   +   }
4517	   + sup =
4518	   +   element sup {
4519	   +     (text | xref | eref | iref | cref | tt | strong | b | em | i)*
4520	       }
4521	     spanx =
4522	       element spanx {
4523	         [ a:defaultValue = "preserve" ]
4524	         attribute xml:space { "default" | "preserve" }?,
4525	         [ a:defaultValue = "emph" ] attribute style { text }?,
4526	         text
4527	       }
4528	     vspace =
4529	       element vspace {
4530	         [ a:defaultValue = "0" ] attribute blankLines { text }?,
4531	         empty
4532	       }
4533	     figure =
4534	       element figure {
4535	         attribute anchor { xsd:ID }?,
4536	         [ a:defaultValue = "" ] attribute title { text }?,
4537	         [ a:defaultValue = "false" ]
4538	         attribute suppress-title { "true" | "false" }?,
4539	         attribute src { text }?,
4540	         [ a:defaultValue = "left" ]
4541	         attribute align { "left" | "center" | "right" }?,
4542	         [ a:defaultValue = "" ] attribute alt { text }?,
4543	         [ a:defaultValue = "" ] attribute width { text }?,
4544	         [ a:defaultValue = "" ] attribute height { text }?,
4545	   +     attribute autogeneratedFigureNumber { text }?,
4546	   +     titleelement?,
4547	         iref*,
4548	         preamble?,
4549	   -     artwork,
4550	   +     (artwork | sourcecode)+,
4551	         postamble?
4552	       }
4553	     preamble =
4554	   -   element preamble { (text | xref | eref | iref | cref | spanx)* }
4555	   +   element preamble {
4556	   +     (text
4557	   +      | xref
4558	   +      | eref
4559	   +      | iref
4560	   +      | cref
4561	   +      | spanx
4562	   +      | tt
4563	   +      | strong
4564	   +      | b
4565	   +      | em
4566	   +      | i
4567	   +      | sub
4568	   +      | sup)*
4569	   +   }
4570	     artwork =
4571	       element artwork {
4572	   -     [ a:defaultValue = "preserve" ]
4573	   -     attribute xml:space { "default" | "preserve" }?,
4574	   +     attribute xml:space { text }?,
4575	         [ a:defaultValue = "" ] attribute name { text }?,
4576	         [ a:defaultValue = "" ] attribute type { text }?,
4577	         attribute src { text }?,
4578	         [ a:defaultValue = "left" ]
4579	         attribute align { "left" | "center" | "right" }?,
4580	         [ a:defaultValue = "" ] attribute alt { text }?,
4581	         [ a:defaultValue = "" ] attribute width { text }?,
4582	         [ a:defaultValue = "" ] attribute height { text }?,
4583	   +     [ a:defaultValue = "en" ] attribute xml:lang { text }?,
4584	         text*
4585	       }
4586	   + sourcecode =
4587	   +   element sourcecode {
4588	   +     [ a:defaultValue = "" ] attribute name { text }?,
4589	   +     [ a:defaultValue = "" ] attribute type { text }?,
4590	   +     text
4591	   +   }
4592	     postamble =
4593	   -   element postamble { (text | xref | eref | iref | cref | spanx)*
4594	   +   element postamble {
4595	   +     (text
4596	   +      | xref
4597	   +      | eref
4598	   +      | iref
4599	   +      | cref
4600	   +      | spanx
4601	   +      | tt
4602	   +      | strong
4603	   +      | b
4604	   +      | em
4605	   +      | i
4606	   +      | sub
4607	   +      | sup)*
4608	     }
4609	     texttable =
4610	       element texttable {
4611	         attribute anchor { xsd:ID }?,
4612	         [ a:defaultValue = "" ] attribute title { text }?,
4613	         [ a:defaultValue = "false" ]
4614	         attribute suppress-title { "true" | "false" }?,
4615	         [ a:defaultValue = "center" ]
4616	         attribute align { "left" | "center" | "right" }?,
4617	         [ a:defaultValue = "full" ]
4618	         attribute style { "all" | "none" | "headers" | "full" }?,
4619	   +     attribute autogeneratedTableNumber { text }?,
4620	   +     titleelement?,
4621	         preamble?,
4622	         ttcol+,
4623	         c*,
4624	         postamble?
4625	       }
4626	     ttcol =
4627	       element ttcol {
4628	         attribute width { text }?,
4629	         [ a:defaultValue = "left" ]
4630	         attribute align { "left" | "center" | "right" }?,
4631	   -     text
4632	   +     (xref | eref | iref | cref | text)*
4633	   +   }
4634	   + c =
4635	   +   element c {
4636	   +     (text
4637	   +      | xref
4638	   +      | eref
4639	   +      | iref
4640	   +      | cref
4641	   +      | spanx
4642	   +      | tt
4643	   +      | strong
4644	   +      | b
4645	   +      | em
4646	   +      | i
4647	   +      | sub
4648	   +      | sup)*
4649	   +   }
4650	   + back = element back { displayreference*, references*, section* }
4651	   + displayreference =
4652	   +   element displayreference {
4653	   +     attribute from { text },
4654	   +     attribute to { text }
4655	       }
4656	   - c = element c { (text | xref | eref | iref | cref | spanx)* }
4657	   - back = element back { references*, section* }
4658	     references =
4659	       element references {
4660	         [ a:defaultValue = "References" ] attribute title { text }?,
4661	         reference+
4662	       }
4663	     reference =
4664	       element reference {
4665	         attribute anchor { xsd:ID },
4666	         attribute target { text }?,
4667	         front,
4668	   -     seriesInfo*,
4669	   -     format*,
4670	   -     annotation*
4671	   +     (seriesInfo | format | refcontent | annotation)*
4672	       }
4673	     seriesInfo =
4674	       element seriesInfo {
4675	         attribute name { text },
4676	         attribute value { text },
4677	   +     attribute asciiname { text }?,
4678	   +     attribute asciivalue { text }?,
4679	         empty
4680	       }
4681	     format =
4682	       element format {
4683	         attribute target { text }?,
4684	         attribute type { text },
4685	         attribute octets { text }?,
4686	         empty
4687	       }
4688	     annotation =
4689	   -   element annotation { (text | xref | eref | iref | cref |
4690	   - spanx)* }
4691	   +   element annotation {
4692	   +     attribute ascii { text }?,
4693	   +     (text
4694	   +      | xref
4695	   +      | eref
4696	   +      | iref
4697	   +      | cref
4698	   +      | spanx
4699	   +      | tt
4700	   +      | strong
4701	   +      | b
4702	   +      | em
4703	   +      | i
4704	   +      | sub
4705	   +      | sup)*
4706	   +   }
4707	   + refcontent =
4708	   +   element refcontent {
4709	   +     attribute ascii { text }?,
4710	   +     (text | tt | b | i | em | strong | sub | sup)*
4711	   +   }
4712	     start = rfc

4714	Index

4716	   A
4717	      abbrev attribute
4718	         in organization element  36
4719	         in title element  57
4720	      abstract element  9
4721	         inside front  29

4723	      address element  9
4724	         inside author  15
4725	      align attribute
4726	         in artwork element  12
4727	         in figure element  26
4728	         in texttable element  55
4729	         in ttcol element  59
4730	      alt attribute
4731	         in artwork element  12
4732	         in figure element  27
4733	      anchor attribute
4734	         in blockquote element  17
4735	         in cref element  20
4736	         in figure element  27
4737	         in reference element  40
4738	         in section element  46
4739	         in t element  55
4740	         in texttable element  56
4741	      annotation element  10
4742	         ascii attribute  11
4743	         inside reference  40
4744	      application/rfc+xml Media Type  64
4745	      area element  11
4746	         inside front  28
4747	      artwork element  11
4748	         align attribute  12
4749	         alt attribute  12
4750	         height attribute  12
4751	         inside aside  14
4752	         inside blockquote  17
4753	         inside dd  21
4754	         inside li  31
4755	         inside section  46
4756	         inside t  54
4757	         name attribute  12
4758	         src attribute  13
4759	         type attribute  13
4760	         width attribute  13
4761	         xml:lang attribute  13
4762	         xml:space attribute  13
4763	      ascii attribute
4764	         in annotation element  11
4765	         in author element  15
4766	         in city element  18
4767	         in code element  19
4768	         in email element  25
4769	         in organization element  36
4770	         in postalLine element  37
4771	         in refcontent element  40
4772	         in region element  41
4773	         in street element  51
4774	         in title element  57
4775	      asciiname attribute
4776	         in seriesInfo element  48
4777	      asciivalue attribute
4778	         in seriesInfo element  48
4779	      aside element  14
4780	         inside section  46
4781	      Attributes
4782	         abbrev  36, 57
4783	         align  12, 26, 55, 59
4784	         alt  12, 27
4785	         anchor  17, 20, 27, 40, 46, 55-56
4786	         ascii  11, 15, 18-19, 25, 36-37, 40-41, 51, 57
4787	         asciiname  48
4788	         asciivalue  48
4789	         autogeneratedBoilerplateText  42
4790	         autogeneratedFigureNumber  27
4791	         autogeneratedSectionNumber  46
4792	         autogeneratedTableNumber  56
4793	         blankLines  61
4794	         category  42
4795	         cite  17
4796	         consensus  42
4797	         counter  33
4798	         day  21
4799	         docName  42
4800	         empty  60
4801	         format  62
4802	         from  22
4803	         fullname  15
4804	         group  34
4805	         hangIndent  33
4806	         hanging  23
4807	         height  12, 27
4808	         href  32
4809	         initials  15
4810	         ipr  43
4811	         iprExtract  44
4812	         item  30
4813	         month  21
4814	         name  12, 48-49
4815	         number  44
4816	         numbered  47
4817	         obsoletes  44
4818	         octets  28
4819	         pageno  63
4820	         primary  30
4821	         rel  32
4822	         relative  63
4823	         removeInRFC  47
4824	         role  15
4825	         section  63
4826	         sectionFormat  63
4827	         seriesNo  44
4828	         sortRefs  44
4829	         source  20
4830	         spacing  23, 34, 60
4831	         src  13, 27
4832	         start  34
4833	         style  33-34, 51, 56
4834	         subitem  30
4835	         submissionType  44
4836	         suppress-title  27, 57
4837	         surname  15
4838	         symRefs  45
4839	         target  26, 28, 40, 64
4840	         title  27, 34, 41, 47, 57
4841	         to  22
4842	         toc  47
4843	         tocDepth  45
4844	         tocInclude  45
4845	         type  13, 28, 49
4846	         updates  45
4847	         value  48
4848	         width  13, 28, 59
4849	         xml:lang  13, 15, 37, 45
4850	         xml:space  13, 51
4851	         year  21
4852	      author element  14
4853	         ascii attribute  15
4854	         fullname attribute  15
4855	         initials attribute  15
4856	         inside front  28
4857	         role attribute  15
4858	         surname attribute  15
4859	         xml:lang attribute  15
4860	      autogeneratedBoilerplateText attribute
4861	         in rfc element  42
4862	      autogeneratedFigureNumber attribute
4863	         in figure element  27
4864	      autogeneratedSectionNumber attribute
4865	         in section element  46
4866	      autogeneratedTableNumber attribute
4867	         in texttable element  56

4869	   B
4870	      b element  15
4871	         inside annotation  10
4872	         inside blockquote  17
4873	         inside c  18
4874	         inside cref  20
4875	         inside dd  22
4876	         inside dt  24
4877	         inside em  25
4878	         inside i  29
4879	         inside li  31
4880	         inside postamble  38
4881	         inside preamble  38
4882	         inside refcontent  39
4883	         inside sub  53
4884	         inside sup  53
4885	         inside t  55
4886	         inside tt  58
4887	      back element  16
4888	         inside rfc  42
4889	      blankLines attribute
4890	         in vspace element  61
4891	      blockquote element  17
4892	         anchor attribute  17
4893	         cite attribute  17
4894	         inside section  46

4896	   C
4897	      c element  17
4898	         inside texttable  55
4899	      category attribute
4900	         in rfc element  42
4901	      cite attribute
4902	         in blockquote element  17
4903	      city element  18
4904	         ascii attribute  18
4905	         inside postal  36
4906	      code element  18
4907	         ascii attribute  19
4908	         inside postal  36
4909	      consensus attribute
4910	         in rfc element  42
4911	      counter attribute
4912	         in list element  33
4913	      country element  19
4914	         inside postal  36

4916	      cref element  19
4917	         anchor attribute  20
4918	         inside annotation  10
4919	         inside b  16
4920	         inside c  18
4921	         inside dd  21
4922	         inside dt  24
4923	         inside em  25
4924	         inside i  29
4925	         inside li  31
4926	         inside postamble  37
4927	         inside preamble  38
4928	         inside strong  52
4929	         inside sub  52
4930	         inside sup  53
4931	         inside t  54
4932	         inside titleelement  58
4933	         inside tt  58
4934	         inside ttcol  59
4935	         source attribute  20

4937	   D
4938	      date element  20
4939	         day attribute  21
4940	         inside front  28
4941	         month attribute  21
4942	         year attribute  21
4943	      day attribute
4944	         in date element  21
4945	      dd element  21
4946	         inside dl  23
4947	      displayreference element  22
4948	         from attribute  22
4949	         inside back  16
4950	         to attribute  22
4951	      dl element  22
4952	         hanging attribute  23
4953	         inside dd  21
4954	         inside li  31
4955	         inside t  54
4956	         spacing attribute  23
4957	      docName attribute
4958	         in rfc element  42
4959	      dt element  23
4960	         inside dl  23

4962	   E
4963	      Elements
4964	         abstract  9, 29
4965	         address  9, 15
4966	         annotation  10, 40
4967	         area  11, 28
4968	         artwork  11, 14, 17, 21, 31, 46, 54
4969	         aside  14, 46
4970	         author  14, 28
4971	         b  10, 15, 17-18, 20, 22, 24-25, 29, 31, 38-39, 53, 55, 58
4972	         back  16, 42
4973	         blockquote  17, 46
4974	         c  17, 55
4975	         city  18, 36
4976	         code  18, 36
4977	         country  19, 36
4978	         cref  10, 16, 18-19, 21, 24-25, 29, 31, 37-38, 52-54, 58-59
4979	         date  20, 28
4980	         dd  21, 23
4981	         displayreference  16, 22
4982	         dl  21-22, 31, 54
4983	         dt  23
4984	         em  11, 16-18, 20, 22, 24, 32, 38-39, 52-53, 55, 59
4985	         email  10, 25
4986	         eref  10, 16, 18-19, 21, 24-25, 29, 31, 37-38, 52-54, 58-59
4987	         facsimile  10, 26
4988	         figure  14, 17, 21, 26, 31, 46, 54
4989	         format  28, 40
4990	         front  28, 40-41
4991	         i  11, 16-18, 20, 22, 24, 29, 32, 38-39, 52-55, 59
4992	         iref  10, 14, 16, 18, 21, 24, 26, 29, 31, 37-38, 46, 52-54,
4993	            58-59
4994	         keyword  29-30
4995	         li  31, 34, 60
4996	         link  32, 41
4997	         list  33, 54
4998	         middle  33, 42
4999	         note  29, 33
5000	         ol  21, 31, 34, 54
5001	         organization  15, 35
5002	         phone  10, 36
5003	         postal  10, 36
5004	         postalLine  37
5005	         postamble  26, 37, 55
5006	         preamble  26, 38, 55
5007	         refcontent  39-40
5008	         reference  40-41
5009	         references  16, 40
5010	         region  36, 41
5011	         rfc  41
5012	         section  17, 33, 46
5013	         seriesInfo  40, 48
5014	         sourcecode  14, 17, 21, 31, 46, 48, 54
5015	         spanx  10, 18, 37-38, 50, 54
5016	         street  36, 51
5017	         strong  10, 17-19, 22, 24-25, 29, 31, 37-39, 51, 53-54, 58
5018	         sub  11, 16-18, 20, 22, 24-25, 29, 32, 38-39, 52, 55, 59
5019	         sup  11, 16-18, 20, 22, 24-25, 29, 32, 38-39, 52-53, 55, 59
5020	         t  9, 14, 21, 31, 33, 46, 54
5021	         texttable  14, 46, 55
5022	         title  28, 57
5023	         titleelement  26, 46, 55, 57
5024	         tt  10, 16-19, 22, 24-25, 29, 31, 37-39, 52-54, 58
5025	         ttcol  55, 59
5026	         ul  21, 31, 54, 59
5027	         uri  10, 60
5028	         vspace  54, 60
5029	         workgroup  28, 61
5030	         xref  10, 16, 18-19, 21, 24, 29, 31, 37-38, 52-54, 58-59, 61
5031	      em element  24
5032	         inside annotation  11
5033	         inside b  16
5034	         inside blockquote  17
5035	         inside c  18
5036	         inside cref  20
5037	         inside dd  22
5038	         inside dt  24
5039	         inside li  32
5040	         inside postamble  38
5041	         inside preamble  38
5042	         inside refcontent  39
5043	         inside strong  52
5044	         inside sub  53
5045	         inside sup  53
5046	         inside t  55
5047	         inside tt  59
5048	      email element  25
5049	         ascii attribute  25
5050	         inside address  10
5051	      empty attribute
5052	         in ul element  60
5053	      eref element  25
5054	         inside annotation  10
5055	         inside b  16
5056	         inside c  18
5057	         inside cref  19
5058	         inside dd  21
5059	         inside dt  24
5060	         inside em  24
5061	         inside i  29
5062	         inside li  31
5063	         inside postamble  37
5064	         inside preamble  38
5065	         inside strong  52
5066	         inside sub  52
5067	         inside sup  53
5068	         inside t  54
5069	         inside titleelement  58
5070	         inside tt  58
5071	         inside ttcol  59
5072	         target attribute  26

5074	   F
5075	      facsimile element  26
5076	         inside address  10
5077	      figure element  26
5078	         align attribute  26
5079	         alt attribute  27
5080	         anchor attribute  27
5081	         autogeneratedFigureNumber attribute  27
5082	         height attribute  27
5083	         inside aside  14
5084	         inside blockquote  17
5085	         inside dd  21
5086	         inside li  31
5087	         inside section  46
5088	         inside t  54
5089	         src attribute  27
5090	         suppress-title attribute  27
5091	         title attribute  27
5092	         width attribute  28
5093	      format attribute
5094	         in xref element  62
5095	      format element  28
5096	         inside reference  40
5097	         octets attribute  28
5098	         target attribute  28
5099	         type attribute  28
5100	      from attribute
5101	         in displayreference element  22
5102	      front element  28
5103	         inside reference  40
5104	         inside rfc  41
5105	      fullname attribute
5106	         in author element  15

5108	   G
5109	      group attribute
5110	         in ol element  34

5112	   H
5113	      hangIndent attribute
5114	         in list element  33
5115	      hanging attribute
5116	         in dl element  23
5117	      height attribute
5118	         in artwork element  12
5119	         in figure element  27
5120	      href attribute
5121	         in link element  32

5123	   I
5124	      i element  29
5125	         inside annotation  11
5126	         inside b  16
5127	         inside blockquote  17
5128	         inside c  18
5129	         inside cref  20
5130	         inside dd  22
5131	         inside dt  24
5132	         inside li  32
5133	         inside postamble  38
5134	         inside preamble  38
5135	         inside refcontent  39
5136	         inside strong  52
5137	         inside sub  53
5138	         inside sup  54
5139	         inside t  55
5140	         inside tt  59
5141	      initials attribute
5142	         in author element  15
5143	      ipr attribute
5144	         '*2026'  72
5145	         '*3667'  72
5146	         '*3978'  71
5147	         '*trust200811'  71
5148	         '*trust200902'  70
5149	         'noDerivativesTrust200902'  70
5150	         'noModificationTrust200902'  70
5151	         'pre5378Trust200902'  71
5152	         'trust200902'  70
5153	         in rfc element  43
5154	      iprExtract attribute
5155	         in rfc element  44

5157	      iref element  29
5158	         inside annotation  10
5159	         inside aside  14
5160	         inside b  16
5161	         inside c  18
5162	         inside dd  21
5163	         inside dt  24
5164	         inside em  24
5165	         inside figure  26
5166	         inside i  29
5167	         inside li  31
5168	         inside postamble  37
5169	         inside preamble  38
5170	         inside section  46
5171	         inside strong  52
5172	         inside sub  52
5173	         inside sup  53
5174	         inside t  54
5175	         inside titleelement  58
5176	         inside tt  58
5177	         inside ttcol  59
5178	         item attribute  30
5179	         primary attribute  30
5180	         subitem attribute  30
5181	      item attribute
5182	         in iref element  30

5184	   K
5185	      keyword element  30
5186	         inside front  29

5188	   L
5189	      li element  31
5190	         inside ol  34
5191	         inside ul  60
5192	      link element  32
5193	         href attribute  32
5194	         inside rfc  41
5195	         rel attribute  32
5196	      list element  33
5197	         counter attribute  33
5198	         hangIndent attribute  33
5199	         inside t  54
5200	         style attribute  33

5202	   M
5203	      Media Type
5204	         application/rfc+xml  64

5206	      middle element  33
5207	         inside rfc  42
5208	      month attribute
5209	         in date element  21

5211	   N
5212	      name attribute
5213	         in artwork element  12
5214	         in seriesInfo element  48
5215	         in sourcecode element  49
5216	      note element  33
5217	         inside front  29
5218	         title attribute  34
5219	      number attribute
5220	         in rfc element  44
5221	      numbered attribute
5222	         in section element  47

5224	   O
5225	      obsoletes attribute
5226	         in rfc element  44
5227	      octets attribute
5228	         in format element  28
5229	      ol element  34
5230	         group attribute  34
5231	         inside dd  21
5232	         inside li  31
5233	         inside t  54
5234	         spacing attribute  34
5235	         start attribute  34
5236	         style attribute  34
5237	      organization element  35
5238	         abbrev attribute  36
5239	         ascii attribute  36
5240	         inside author  15

5242	   P
5243	      pageno attribute
5244	         in xref element  63
5245	      phone element  36
5246	         inside address  10
5247	      postal element  36
5248	         inside address  10
5249	         xml:lang attribute  37
5250	      postalLine element  37
5251	         ascii attribute  37
5252	         inside postal  37
5253	      postamble element  37
5254	         inside figure  26
5255	         inside texttable  55
5256	      preamble element  38
5257	         inside figure  26
5258	         inside texttable  55
5259	      primary attribute
5260	         in iref element  30

5262	   R
5263	      refcontent element  39
5264	         ascii attribute  40
5265	         inside reference  40
5266	      reference element  40
5267	         anchor attribute  40
5268	         inside references  41
5269	         target attribute  40
5270	      references element  40
5271	         inside back  16
5272	         title attribute  41
5273	      region element  41
5274	         ascii attribute  41
5275	         inside postal  36
5276	      rel attribute
5277	         in link element  32
5278	      relative attribute
5279	         in xref element  63
5280	      removeInRFC attribute
5281	         in section element  47
5282	      rfc element  41
5283	         autogeneratedBoilerplateText attribute  42
5284	         category attribute  42
5285	         consensus attribute  42
5286	         docName attribute  42
5287	         ipr attribute  43
5288	         iprExtract attribute  44
5289	         number attribute  44
5290	         obsoletes attribute  44
5291	         seriesNo attribute  44
5292	         sortRefs attribute  44
5293	         submissionType attribute  44
5294	         symRefs attribute  45
5295	         tocDepth attribute  45
5296	         tocInclude attribute  45
5297	         updates attribute  45
5298	         xml:lang attribute  45
5299	      role attribute
5300	         in author element  15

5302	   S
5303	      section attribute
5304	         in xref element  63
5305	      section element  46
5306	         anchor attribute  46
5307	         autogeneratedSectionNumber attribute  46
5308	         inside back  17
5309	         inside middle  33
5310	         inside section  46
5311	         numbered attribute  47
5312	         removeInRFC attribute  47
5313	         title attribute  47
5314	         toc attribute  47
5315	      sectionFormat attribute
5316	         in xref element  63
5317	      seriesInfo element  48
5318	         asciiname attribute  48
5319	         asciivalue attribute  48
5320	         inside reference  40
5321	         name attribute  48
5322	         value attribute  48
5323	      seriesNo attribute
5324	         in rfc element  44
5325	      sortRefs attribute
5326	         in rfc element  44
5327	      source attribute
5328	         in cref element  20
5329	      sourcecode element  48
5330	         inside aside  14
5331	         inside blockquote  17
5332	         inside dd  21
5333	         inside li  31
5334	         inside section  46
5335	         inside t  54
5336	         name attribute  49
5337	         type attribute  49
5338	      spacing attribute
5339	         in dl element  23
5340	         in ol element  34
5341	         in ul element  60
5342	      spanx element  50
5343	         inside annotation  10
5344	         inside c  18
5345	         inside postamble  37
5346	         inside preamble  38
5347	         inside t  54
5348	         style attribute  51
5349	         xml:space attribute  51

5351	      src attribute
5352	         in artwork element  13
5353	         in figure element  27
5354	      start attribute
5355	         in ol element  34
5356	      street element  51
5357	         ascii attribute  51
5358	         inside postal  36
5359	      strong element  51
5360	         inside annotation  10
5361	         inside blockquote  17
5362	         inside c  18
5363	         inside cref  19
5364	         inside dd  22
5365	         inside dt  24
5366	         inside em  25
5367	         inside i  29
5368	         inside li  31
5369	         inside postamble  37
5370	         inside preamble  38
5371	         inside refcontent  39
5372	         inside sub  53
5373	         inside sup  53
5374	         inside t  54
5375	         inside tt  58
5376	      style attribute
5377	         in list element  33
5378	         in ol element  34
5379	         in spanx element  51
5380	         in texttable element  56
5381	      sub element  52
5382	         inside annotation  11
5383	         inside b  16
5384	         inside blockquote  17
5385	         inside c  18
5386	         inside cref  20
5387	         inside dd  22
5388	         inside dt  24
5389	         inside em  25
5390	         inside i  29
5391	         inside li  32
5392	         inside postamble  38
5393	         inside preamble  38
5394	         inside refcontent  39
5395	         inside strong  52
5396	         inside t  55
5397	         inside tt  59
5398	      subitem attribute
5399	         in iref element  30
5400	      submissionType attribute
5401	         in rfc element  44
5402	      sup element  53
5403	         inside annotation  11
5404	         inside b  16
5405	         inside blockquote  17
5406	         inside c  18
5407	         inside cref  20
5408	         inside dd  22
5409	         inside dt  24
5410	         inside em  25
5411	         inside i  29
5412	         inside li  32
5413	         inside postamble  38
5414	         inside preamble  38
5415	         inside refcontent  39
5416	         inside strong  52
5417	         inside t  55
5418	         inside tt  59
5419	      suppress-title attribute
5420	         in figure element  27
5421	         in texttable element  57
5422	      surname attribute
5423	         in author element  15
5424	      symRefs attribute
5425	         in rfc element  45

5427	   T
5428	      t element  54
5429	         anchor attribute  55
5430	         inside abstract  9
5431	         inside aside  14
5432	         inside dd  21
5433	         inside li  31
5434	         inside list  33
5435	         inside note  33
5436	         inside section  46
5437	      target attribute
5438	         in eref element  26
5439	         in format element  28
5440	         in reference element  40
5441	         in xref element  64
5442	      texttable element  55
5443	         align attribute  55
5444	         anchor attribute  56
5445	         autogeneratedTableNumber attribute  56
5446	         inside aside  14
5447	         inside section  46
5448	         style attribute  56
5449	         suppress-title attribute  57
5450	         title attribute  57
5451	      title attribute
5452	         in figure element  27
5453	         in note element  34
5454	         in references element  41
5455	         in section element  47
5456	         in texttable element  57
5457	      title element  57
5458	         abbrev attribute  57
5459	         ascii attribute  57
5460	         inside front  28
5461	      titleelement element  57
5462	         inside figure  26
5463	         inside section  46
5464	         inside texttable  55
5465	      to attribute
5466	         in displayreference element  22
5467	      toc attribute
5468	         in section element  47
5469	      tocDepth attribute
5470	         in rfc element  45
5471	      tocInclude attribute
5472	         in rfc element  45
5473	      tt element  58
5474	         inside annotation  10
5475	         inside b  16
5476	         inside blockquote  17
5477	         inside c  18
5478	         inside cref  19
5479	         inside dd  22
5480	         inside dt  24
5481	         inside em  25
5482	         inside i  29
5483	         inside li  31
5484	         inside postamble  37
5485	         inside preamble  38
5486	         inside refcontent  39
5487	         inside strong  52
5488	         inside sub  53
5489	         inside sup  53
5490	         inside t  54
5491	         inside titleelement  58
5492	      ttcol element  59
5493	         align attribute  59
5494	         inside texttable  55
5495	         width attribute  59
5496	      type attribute
5497	         in artwork element  13
5498	         in format element  28
5499	         in sourcecode element  49

5501	   U
5502	      ul element  59
5503	         empty attribute  60
5504	         inside dd  21
5505	         inside li  31
5506	         inside t  54
5507	         spacing attribute  60
5508	      updates attribute
5509	         in rfc element  45
5510	      uri element  60
5511	         inside address  10

5513	   V
5514	      value attribute
5515	         in seriesInfo element  48
5516	      vspace element  60
5517	         blankLines attribute  61
5518	         inside t  54

5520	   W
5521	      width attribute
5522	         in artwork element  13
5523	         in figure element  28
5524	         in ttcol element  59
5525	      workgroup element  61
5526	         inside front  28

5528	   X
5529	      xml:lang attribute
5530	         in artwork element  13
5531	         in author element  15
5532	         in postal element  37
5533	         in rfc element  45
5534	      xml:space attribute
5535	         in artwork element  13
5536	         in spanx element  51
5537	      xref element  61
5538	         format attribute  62
5539	         inside annotation  10
5540	         inside b  16
5541	         inside c  18
5542	         inside cref  19
5543	         inside dd  21
5544	         inside dt  24
5545	         inside em  24
5546	         inside i  29
5547	         inside li  31
5548	         inside postamble  37
5549	         inside preamble  38
5550	         inside strong  52
5551	         inside sub  52
5552	         inside sup  53
5553	         inside t  54
5554	         inside titleelement  58
5555	         inside tt  58
5556	         inside ttcol  59
5557	         pageno attribute  63
5558	         relative attribute  63
5559	         section attribute  63
5560	         sectionFormat attribute  63
5561	         target attribute  64
5562	      xref formats
5563	         counter  62
5564	         default  62
5565	         none  62
5566	         title  62

5568	   Y
5569	      year attribute
5570	         in date element  21

5572	Author's Address

5574	   Paul Hoffman
5575	   VPN Consortium

5577	   EMail: paul.hoffman@vpnc.org