draft-iab-rfc7991bis-04.txt   draft-iab-rfc7991bis-latest.txt 
Network Working Group J. Levine, Ed. Network Working Group J. Levine, Ed.
Internet-Draft Temporary RFC Series Project Internet-Draft Temporary RFC Series Project Manager
Obsoletes: 7991 (if approved) Manager Obsoletes: 7991 (if approved) May 2, 2023
Intended status: Informational April 11, 2002 Intended status: Informational
Expires: October 13, 2002 Expires: November 3, 2023
The "xml2rfc" version 3 Vocabulary The "xml2rfc" version 3 Vocabulary
draft-iab-rfc7991bis-04 draft-iab-rfc7991bis-05
Status of This Memo
This Internet-Draft is submitted to IETF in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on October 13, 2002.
Copyright Notice
Copyright (c) 2002 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents in effect on the date of
publication of this document (http://trustee.ietf.org/license-info).
Please review these documents carefully, as they describe your rights
and restrictions with respect to this document.
Abstract Abstract
This document defines the "xml2rfc" version 3 vocabulary: an XML- This document defines the "xml2rfc" version 3 vocabulary: an XML-
based language used for writing RFCs and Internet-Drafts. It is based language used for writing RFCs and Internet-Drafts. It is
heavily derived from the version 2 vocabulary that is also under heavily derived from the version 2 vocabulary that is also under
discussion. This document obsoletes the earlier v3 grammar described discussion. This document obsoletes the earlier v3 grammar described
in RFC 7991, which in turn obsoleted the v2 grammar in RFC 7749. in RFC 7991, which in turn obsoleted the v2 grammar in RFC 7749.
Editorial Note Editorial Note
skipping to change at page 2, line 21 skipping to change at page 1, line 33
Discussion of this draft takes place on the rfc-interest@ietf.org Discussion of this draft takes place on the rfc-interest@ietf.org
mailing list, which has its home page at mailing list, which has its home page at
<https://www.ietf.org/mailman/listinfo/rfc-interest>. <https://www.ietf.org/mailman/listinfo/rfc-interest>.
Source code and issues list for this draft can be found at Source code and issues list for this draft can be found at
<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis>. <https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis>.
The changes in this draft are summarized in Appendix E.5. The changes in this draft are summarized in Appendix E.5.
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on November 3, 2023.
Copyright Notice
Copyright (c) 2023 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 6 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1. Expected Updates to the Specification . . . . . . . . . . 6 1.1. Expected Updates to the Specification . . . . . . . . . . 5
1.2. Design Criteria for the Changes in v3 . . . . . . . . . . 6 1.2. Design Criteria for the Changes in v3 . . . . . . . . . . 5
1.3. Differences from RFC 7991 in This Document . . . . . . . 7 1.3. Differences from RFC 7991 in This Document . . . . . . . 6
1.4. Differences from v2 to v3 . . . . . . . . . . . . . . . . 8 1.4. Differences from v2 to v3 . . . . . . . . . . . . . . . . 7
1.4.1. New Elements in v3 . . . . . . . . . . . . . . . . . 8 1.4.1. New Elements in v3 . . . . . . . . . . . . . . . . . 7
1.4.2. New Attributes for Existing Elements . . . . . . . . 9 1.4.2. New Attributes for Existing Elements . . . . . . . . 8
1.4.3. Elements and Attributes Deprecated from Original v3 . 10 1.4.3. Elements and Attributes Deprecated from Original v3 . 9
1.4.4. Elements and Attributes Deprecated from v2 . . . . . 10 1.4.4. Elements and Attributes Deprecated from v2 . . . . . 9
1.4.5. Additional Changes from v2 . . . . . . . . . . . . . 11 1.4.5. Additional Changes from v2 . . . . . . . . . . . . . 10
1.5. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 12 1.5. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 11
2. Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 12 2. Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1. <abstract> . . . . . . . . . . . . . . . . . . . . . . . 13 2.1. <abstract> . . . . . . . . . . . . . . . . . . . . . . . 12
2.2. <address> . . . . . . . . . . . . . . . . . . . . . . . . 13 2.2. <address> . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3. <annotation> . . . . . . . . . . . . . . . . . . . . . . 14 2.3. <annotation> . . . . . . . . . . . . . . . . . . . . . . 13
2.4. <area> . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.4. <area> . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.5. <artset> . . . . . . . . . . . . . . . . . . . . . . . . 15 2.5. <artset> . . . . . . . . . . . . . . . . . . . . . . . . 14
2.6. <artwork> . . . . . . . . . . . . . . . . . . . . . . . . 16 2.6. <artwork> . . . . . . . . . . . . . . . . . . . . . . . . 15
2.7. <aside> . . . . . . . . . . . . . . . . . . . . . . . . . 19 2.7. <aside> . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.8. <author> . . . . . . . . . . . . . . . . . . . . . . . . 20 2.8. <author> . . . . . . . . . . . . . . . . . . . . . . . . 19
2.9. <back> . . . . . . . . . . . . . . . . . . . . . . . . . 22 2.9. <back> . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.10. <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . . 22 2.10. <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.11. <blockquote> . . . . . . . . . . . . . . . . . . . . . . 22 2.11. <blockquote> . . . . . . . . . . . . . . . . . . . . . . 21
2.12. <boilerplate> . . . . . . . . . . . . . . . . . . . . . . 24 2.12. <boilerplate> . . . . . . . . . . . . . . . . . . . . . . 23
2.13. <br> . . . . . . . . . . . . . . . . . . . . . . . . . . 24 2.13. <br> . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.14. <contact> . . . . . . . . . . . . . . . . . . . . . . . . 25 2.14. <contact> . . . . . . . . . . . . . . . . . . . . . . . . 24
2.15. <country> . . . . . . . . . . . . . . . . . . . . . . . . 26 2.15. <country> . . . . . . . . . . . . . . . . . . . . . . . . 25
2.16. <cref> . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.16. <cref> . . . . . . . . . . . . . . . . . . . . . . . . . 25
2.17. <date> . . . . . . . . . . . . . . . . . . . . . . . . . 27 2.17. <date> . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.18. <dd> . . . . . . . . . . . . . . . . . . . . . . . . . . 28 2.18. <dd> . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.19. <displayreference> . . . . . . . . . . . . . . . . . . . 30 2.19. <displayreference> . . . . . . . . . . . . . . . . . . . 29
2.20. <dl> . . . . . . . . . . . . . . . . . . . . . . . . . . 31 2.20. <dl> . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.21. <dt> . . . . . . . . . . . . . . . . . . . . . . . . . . 32 2.21. <dt> . . . . . . . . . . . . . . . . . . . . . . . . . . 31
2.22. <em> . . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.22. <em> . . . . . . . . . . . . . . . . . . . . . . . . . . 31
2.23. <email> . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.23. <email> . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.24. <eref> . . . . . . . . . . . . . . . . . . . . . . . . . 34 2.24. <eref> . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.25. <figure> . . . . . . . . . . . . . . . . . . . . . . . . 35 2.25. <figure> . . . . . . . . . . . . . . . . . . . . . . . . 34
2.26. <front> . . . . . . . . . . . . . . . . . . . . . . . . . 36 2.26. <front> . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.27. <iref> . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.27. <iref> . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.28. <keyword> . . . . . . . . . . . . . . . . . . . . . . . . 38 2.28. <keyword> . . . . . . . . . . . . . . . . . . . . . . . . 37
2.29. <li> . . . . . . . . . . . . . . . . . . . . . . . . . . 38 2.29. <li> . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.30. <link> . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.30. <link> . . . . . . . . . . . . . . . . . . . . . . . . . 38
2.31. <middle> . . . . . . . . . . . . . . . . . . . . . . . . 40 2.31. <middle> . . . . . . . . . . . . . . . . . . . . . . . . 39
2.32. <name> . . . . . . . . . . . . . . . . . . . . . . . . . 40 2.32. <name> . . . . . . . . . . . . . . . . . . . . . . . . . 39
2.33. <note> . . . . . . . . . . . . . . . . . . . . . . . . . 41 2.33. <note> . . . . . . . . . . . . . . . . . . . . . . . . . 40
2.34. <ol> . . . . . . . . . . . . . . . . . . . . . . . . . . 42 2.34. <ol> . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.35. <organization> . . . . . . . . . . . . . . . . . . . . . 44 2.35. <organization> . . . . . . . . . . . . . . . . . . . . . 43
2.36. <phone> . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.36. <phone> . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.37. <postal> . . . . . . . . . . . . . . . . . . . . . . . . 45 2.37. <postal> . . . . . . . . . . . . . . . . . . . . . . . . 44
2.38. <postalLine> . . . . . . . . . . . . . . . . . . . . . . 46 2.38. <postalLine> . . . . . . . . . . . . . . . . . . . . . . 45
2.39. <refcontent> . . . . . . . . . . . . . . . . . . . . . . 46 2.39. <refcontent> . . . . . . . . . . . . . . . . . . . . . . 45
2.40. <reference> . . . . . . . . . . . . . . . . . . . . . . . 47 2.40. <reference> . . . . . . . . . . . . . . . . . . . . . . . 46
2.41. <referencegroup> . . . . . . . . . . . . . . . . . . . . 49 2.41. <referencegroup> . . . . . . . . . . . . . . . . . . . . 48
2.42. <references> . . . . . . . . . . . . . . . . . . . . . . 49 2.42. <references> . . . . . . . . . . . . . . . . . . . . . . 48
2.43. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . . 50 2.43. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . . 49
2.44. <section> . . . . . . . . . . . . . . . . . . . . . . . . 54 2.44. <section> . . . . . . . . . . . . . . . . . . . . . . . . 53
2.45. <seriesInfo> . . . . . . . . . . . . . . . . . . . . . . 57 2.45. <seriesInfo> . . . . . . . . . . . . . . . . . . . . . . 56
2.46. <sourcecode> . . . . . . . . . . . . . . . . . . . . . . 58 2.46. <sourcecode> . . . . . . . . . . . . . . . . . . . . . . 57
2.47. <stream> . . . . . . . . . . . . . . . . . . . . . . . . 61 2.47. <stream> . . . . . . . . . . . . . . . . . . . . . . . . 60
2.48. <strong> . . . . . . . . . . . . . . . . . . . . . . . . 61 2.48. <strong> . . . . . . . . . . . . . . . . . . . . . . . . 60
2.49. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . . 62 2.49. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . . 61
2.50. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . . 63 2.50. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.51. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 2.51. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
2.52. <table> . . . . . . . . . . . . . . . . . . . . . . . . . 66 2.52. <table> . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.53. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . . 67 2.53. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.54. <td> . . . . . . . . . . . . . . . . . . . . . . . . . . 67 2.54. <td> . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.55. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . . 69 2.55. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.56. <th> . . . . . . . . . . . . . . . . . . . . . . . . . . 69 2.56. <th> . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.57. <thead> . . . . . . . . . . . . . . . . . . . . . . . . . 71 2.57. <thead> . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.58. <title> . . . . . . . . . . . . . . . . . . . . . . . . . 72 2.58. <title> . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.59. <toc> . . . . . . . . . . . . . . . . . . . . . . . . . . 72 2.59. <toc> . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.60. <tr> . . . . . . . . . . . . . . . . . . . . . . . . . . 72 2.60. <tr> . . . . . . . . . . . . . . . . . . . . . . . . . . 72
2.61. <tt> . . . . . . . . . . . . . . . . . . . . . . . . . . 73 2.61. <tt> . . . . . . . . . . . . . . . . . . . . . . . . . . 72
2.62. <u> . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 2.62. <u> . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
2.63. <ul> . . . . . . . . . . . . . . . . . . . . . . . . . . 75 2.63. <ul> . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2.64. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . . 77 2.64. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . . 77 2.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . . 76
2.66. <xref> . . . . . . . . . . . . . . . . . . . . . . . . . 77 2.66. <xref> . . . . . . . . . . . . . . . . . . . . . . . . . 76
3. Elements from v2 and original v3 That Have Been Deprecated . 82 3. Elements from v2 and original v3 That Have Been Deprecated . 81
3.1. <c> . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 3.1. <c> . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.2. <city> . . . . . . . . . . . . . . . . . . . . . . . . . 82 3.2. <city> . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.3. <cityarea> . . . . . . . . . . . . . . . . . . . . . . . 82 3.3. <cityarea> . . . . . . . . . . . . . . . . . . . . . . . 82
3.4. <code> . . . . . . . . . . . . . . . . . . . . . . . . . 83 3.4. <code> . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.5. <extaddr> . . . . . . . . . . . . . . . . . . . . . . . . 83 3.5. <extaddr> . . . . . . . . . . . . . . . . . . . . . . . . 82
3.6. <facsimile> . . . . . . . . . . . . . . . . . . . . . . . 83 3.6. <facsimile> . . . . . . . . . . . . . . . . . . . . . . . 82
3.7. <format> . . . . . . . . . . . . . . . . . . . . . . . . 83 3.7. <format> . . . . . . . . . . . . . . . . . . . . . . . . 83
3.8. <list> . . . . . . . . . . . . . . . . . . . . . . . . . 84 3.8. <list> . . . . . . . . . . . . . . . . . . . . . . . . . 83
3.9. <pobox> . . . . . . . . . . . . . . . . . . . . . . . . . 84 3.9. <pobox> . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.10. <postamble> . . . . . . . . . . . . . . . . . . . . . . . 85 3.10. <postamble> . . . . . . . . . . . . . . . . . . . . . . . 84
3.11. <preamble> . . . . . . . . . . . . . . . . . . . . . . . 85 3.11. <preamble> . . . . . . . . . . . . . . . . . . . . . . . 84
3.12. <region> . . . . . . . . . . . . . . . . . . . . . . . . 86 3.12. <region> . . . . . . . . . . . . . . . . . . . . . . . . 85
3.13. <relref> . . . . . . . . . . . . . . . . . . . . . . . . 86 3.13. <relref> . . . . . . . . . . . . . . . . . . . . . . . . 85
3.14. <sortingcode> . . . . . . . . . . . . . . . . . . . . . . 90 3.14. <sortingcode> . . . . . . . . . . . . . . . . . . . . . . 89
3.15. <spanx> . . . . . . . . . . . . . . . . . . . . . . . . . 90 3.15. <spanx> . . . . . . . . . . . . . . . . . . . . . . . . . 90
3.16. <street> . . . . . . . . . . . . . . . . . . . . . . . . 91 3.16. <street> . . . . . . . . . . . . . . . . . . . . . . . . 90
3.17. <texttable> . . . . . . . . . . . . . . . . . . . . . . . 91 3.17. <texttable> . . . . . . . . . . . . . . . . . . . . . . . 90
3.18. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . . 92 3.18. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . . 92
3.19. <vspace> . . . . . . . . . . . . . . . . . . . . . . . . 93 3.19. <vspace> . . . . . . . . . . . . . . . . . . . . . . . . 93
4. SVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 4. SVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
5. Use of CDATA Structures and Escaping . . . . . . . . . . . . 94 5. Use of CDATA Structures and Escaping . . . . . . . . . . . . 93
6. Internationalization Considerations . . . . . . . . . . . . . 94 6. Internationalization Considerations . . . . . . . . . . . . . 94
7. Security Considerations . . . . . . . . . . . . . . . . . . . 94 7. Security Considerations . . . . . . . . . . . . . . . . . . . 94
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 95 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 95
8.1. Internet Media Type Registration . . . . . . . . . . . . 95 8.1. Internet Media Type Registration . . . . . . . . . . . . 95
8.2. Link Relation Registration . . . . . . . . . . . . . . . 97 8.2. Link Relation Registration . . . . . . . . . . . . . . . 96
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 97 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 96
9.1. Normative References . . . . . . . . . . . . . . . . . . 97 9.1. Normative References . . . . . . . . . . . . . . . . . . 96
9.2. Informative References . . . . . . . . . . . . . . . . . 97 9.2. Informative References . . . . . . . . . . . . . . . . . 97
9.3. Editorial References . . . . . . . . . . . . . . . . . . 101 9.3. Editorial References . . . . . . . . . . . . . . . . . . 101
Appendix A. Front-Page ("Boilerplate") Generation . . . . . . . 101 Appendix A. Front-Page ("Boilerplate") Generation . . . . . . . 103
A.1. The "category" Attribute . . . . . . . . . . . . . . . . 101 A.1. The "category" Attribute . . . . . . . . . . . . . . . . 103
A.2. The "ipr" Attribute . . . . . . . . . . . . . . . . . . . 102 A.2. The "ipr" Attribute . . . . . . . . . . . . . . . . . . . 103
A.2.1. Current Values: "*trust200902" . . . . . . . . . . . 102 A.2.1. Current Values: "*trust200902" . . . . . . . . . . . 103
A.2.2. Historic Values . . . . . . . . . . . . . . . . . . . 104 A.2.2. Historic Values . . . . . . . . . . . . . . . . . . . 105
A.3. The "submissionType" Attribute . . . . . . . . . . . . . 104 A.3. The "submissionType" Attribute . . . . . . . . . . . . . 106
A.4. The "consensus" Attribute . . . . . . . . . . . . . . . . 105 A.4. The "consensus" Attribute . . . . . . . . . . . . . . . . 106
Appendix B. The v3 Format and Processing Tools . . . . . . . . . 105 Appendix B. The v3 Format and Processing Tools . . . . . . . . . 107
B.1. Including External Text with XInclude . . . . . . . . . . 107 B.1. Including External Text with XInclude . . . . . . . . . . 108
B.2. Anchors and IDs . . . . . . . . . . . . . . . . . . . . . 108 B.2. Anchors and IDs . . . . . . . . . . . . . . . . . . . . . 109
B.2.1. Overlapping Values . . . . . . . . . . . . . . . . . 108 B.2.1. Overlapping Values . . . . . . . . . . . . . . . . . 110
B.3. Attributes Controlled by the Prep Tool . . . . . . . . . 110 B.3. Attributes Controlled by the Prep Tool . . . . . . . . . 111
Appendix C. RELAX NG Schema . . . . . . . . . . . . . . . . . . 111 Appendix C. RELAX NG Schema . . . . . . . . . . . . . . . . . . 113
Appendix D. Schema Differences from v2 . . . . . . . . . . . . . 135 Appendix D. Schema Differences from v2 . . . . . . . . . . . . . 136
Appendix E. Change Log . . . . . . . . . . . . . . . . . . . . . 159 Appendix E. Change Log . . . . . . . . . . . . . . . . . . . . . 160
E.1. Since draft-iab-rfc7991bis-00 . . . . . . . . . . . . . . 159 E.1. Since draft-iab-rfc7991bis-00 . . . . . . . . . . . . . . 160
E.2. Since draft-iab-rfc7991bis-01 . . . . . . . . . . . . . . 159 E.2. Since draft-iab-rfc7991bis-01 . . . . . . . . . . . . . . 161
E.3. Since draft-iab-rfc7991bis-02 . . . . . . . . . . . . . . 160 E.3. Since draft-iab-rfc7991bis-02 . . . . . . . . . . . . . . 162
E.4. Since draft-iab-rfc7991bis-03 . . . . . . . . . . . . . . 160 E.4. Since draft-iab-rfc7991bis-03 . . . . . . . . . . . . . . 162
E.5. Since draft-iab-rfc7991bis-04 . . . . . . . . . . . . . . 161 E.5. Since draft-iab-rfc7991bis-04 . . . . . . . . . . . . . . 164
Appendix F. IAB Members at the Time of Approval . . . . . . . . 163 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Appendix G. Acknowledgments . . . . . . . . . . . . . . . . . . 163 IAB Members at the Time of Approval . . . . . . . . . . . . . . . 189
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 189
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 189
1. Introduction 1. Introduction
This document describes the updated version 3 ("v3") of the "xml2rfc" This document describes the updated version 3 ("v3") of the "xml2rfc"
vocabulary: an XML-based language ("Extensible Markup Language" vocabulary: an XML-based language ("Extensible Markup Language"
[XML]) used for writing RFCs [RFC7322] and Internet-Drafts [IDGUIDE]. [XML]) used for writing RFCs [RFC7322] and Internet-Drafts [IDGUIDE].
This document obsoletes [RFC7991], [RFC7991] obsoleted the version 2 This document obsoletes [RFC7991], [RFC7991] obsoleted the version 2
vocabulary ("v2") [RFC7749], which contains the extended language vocabulary ("v2") [RFC7749], which contains the extended language
definition. [RFC7749] obsoleted the original version ("v1") definition. [RFC7749] obsoleted the original version ("v1")
skipping to change at page 8, line 25 skipping to change at page 7, line 27
1.4. Differences from v2 to v3 1.4. Differences from v2 to v3
This is a (hopefully) complete list of all the technical changes This is a (hopefully) complete list of all the technical changes
between [RFC7749] and this document. between [RFC7749] and this document.
1.4.1. New Elements in v3 1.4.1. New Elements in v3
o Add <dl>, <ul>, and <ol> as new ways to make lists. This is a o Add <dl>, <ul>, and <ol> as new ways to make lists. This is a
significant change from v2 in that the child under these elements significant change from v2 in that the child under these elements
is <li>, not <t>. <li> has a model of either containing one or is <li>, not <t>. <li> has a model of either containing one or
more <t> elements, or containing the flowing text normally found more <t> elements, or containing the flowing text normally found
in <t>. These lists are children of <section>s and other lists in <t>. These lists are children of <section>s and other lists
instead of <t>. instead of <t>.
o Add <strong>, <em>, <tt>, <sub>, and <sup> for character o Add <strong>, <em>, <tt>, <sub>, and <sup> for character
formatting. formatting.
o Add <aside> for incidental text that will be indented when o Add <aside> for incidental text that will be indented when
displayed. displayed.
skipping to change at page 16, line 28 skipping to change at page 15, line 28
graphics or (2) prose that describes the included image in sufficient graphics or (2) prose that describes the included image in sufficient
detail. detail.
In [RFC7749], the <artwork> element was also used for source code and In [RFC7749], the <artwork> element was also used for source code and
formal languages; in v3, this is now done with <sourcecode>. formal languages; in v3, this is now done with <sourcecode>.
There are at least five ways to include SVG in artwork in Internet- There are at least five ways to include SVG in artwork in Internet-
Drafts: Drafts:
o Inline, by including all of the SVG in the content of the element, o Inline, by including all of the SVG in the content of the element,
such as: <artwork type="svg"><svg such as: <artwork type="svg"><svg xmlns="http://www.w3.org/2000/
xmlns="http://www.w3.org/2000/svg..."> svg...">
o Inline, but using XInclude (see Appendix B.1), such as: <artwork o Inline, but using XInclude (see Appendix B.1), such as: <artwork
type="svg"><xi:include href=...> type="svg"><xi:include href=...>
o As a data: URI, such as: <artwork type="svg" src="data:image/ o As a data: URI, such as: <artwork type="svg" src="data:image/
svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3..."> svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3...">
o As a URI to an external entity, such as: <artwork type="svg" o As a URI to an external entity, such as: <artwork type="svg"
src="http://www.example.com/..."> src="http://www.example.com/...">
skipping to change at page 24, line 44 skipping to change at page 23, line 40
this element must have the "numbered" attribute set to "false". this element must have the "numbered" attribute set to "false".
This element appears as a child element of <front> (Section 2.26). This element appears as a child element of <front> (Section 2.26).
Content model: Content model:
One or more <section> elements (Section 2.44) One or more <section> elements (Section 2.44)
2.13. <br> 2.13. <br>
[[anchor7: Forces a line break. Since the layout and column widths [[CREF1: Forces a line break. Since the layout and column widths of
of a document vary from one rendering to another, authors should use a document vary from one rendering to another, authors should use
this element sparingly and consider its effect in all of the likely this element sparingly and consider its effect in all of the likely
renderings. In some cases a U+200B, ZERO WIDTH SPACE character as a renderings. In some cases a U+200B, ZERO WIDTH SPACE character as a
hint as a place where a block of text might be broken is a better hint as a place where a block of text might be broken is a better
choice.]] choice.]]
This element appears as a child element of <blockquote> This element appears as a child element of <blockquote>
(Section 2.11), <cref> (Section 2.16), <dd> (Section 2.18), <dt> (Section 2.11), <cref> (Section 2.16), <dd> (Section 2.18), <dt>
(Section 2.21), <em> (Section 2.22), <li> (Section 2.29), <name> (Section 2.21), <em> (Section 2.22), <li> (Section 2.29), <name>
(Section 2.32), <strong> (Section 2.48), <t> (Section 2.51), <td> (Section 2.32), <strong> (Section 2.48), <t> (Section 2.51), <td>
(Section 2.54), <th> (Section 2.56), <title> (Section 2.58), and <tt> (Section 2.54), <th> (Section 2.56), <title> (Section 2.58), and <tt>
(Section 2.61). (Section 2.61).
Content model: this element does not have any contents. Content model: this element does not have any contents.
2.14. <contact> 2.14. <contact>
skipping to change at page 28, line 26 skipping to change at page 27, line 18
When the prep tool is used to create Internet-Drafts, it will When the prep tool is used to create Internet-Drafts, it will
reject a submitted Internet-Draft that has a <date> element in the reject a submitted Internet-Draft that has a <date> element in the
boilerplate for itself that is anything other than today. That boilerplate for itself that is anything other than today. That
is, the tool will not allow a submitter to specify a date other is, the tool will not allow a submitter to specify a date other
than the day of submission. To avoid this problem, authors might than the day of submission. To avoid this problem, authors might
simply not include a <date> element in the boilerplate. simply not include a <date> element in the boilerplate.
Bibliographic references: In dates in <reference> elements, the date Bibliographic references: In dates in <reference> elements, the date
information can have prose text for the month or year. For information can have prose text for the month or year. For
example, vague dates (year="ca. 2000"), date ranges (year="2012- example, vague dates (year="ca. 2000"), date ranges
2013"), non-specific months (month="Second quarter"), and so on (year="2012-2013"), non-specific months (month="Second quarter"),
are allowed. and so on are allowed.
This element appears as a child element of <front> (Section 2.26). This element appears as a child element of <front> (Section 2.26).
Content model: only text content. Content model: only text content.
2.17.1. "day" Attribute 2.17.1. "day" Attribute
The day of publication. The day of publication.
2.17.2. "month" Attribute 2.17.2. "month" Attribute
skipping to change at page 31, line 52 skipping to change at page 30, line 44
and following lines of the item (the first line starts with the term, and following lines of the item (the first line starts with the term,
and is not indented). The indentation amount is interpreted as and is not indented). The indentation amount is interpreted as
characters when rendering plain-text documents, and en-space units characters when rendering plain-text documents, and en-space units
when rendering in formats that have richer typographic support such when rendering in formats that have richer typographic support such
as HTML or PDF. One en-space is assumed to be the length of 0.5 em- as HTML or PDF. One en-space is assumed to be the length of 0.5 em-
space in CSS units. space in CSS units.
2.20.3. "newline" Attribute 2.20.3. "newline" Attribute
The "newline" attribute defines whether or not the term appears on The "newline" attribute defines whether or not the term appears on
the same line as the definition. newline="false" indicates that the the same line as the definition. newline="false" indicates that the
term is to the left of the definition, while newline="true" indicates term is to the left of the definition, while newline="true" indicates
that the term will be on a separate line. that the term will be on a separate line.
Allowed values: Allowed values:
o "false" (default) o "false" (default)
o "true" o "true"
2.20.4. "spacing" Attribute 2.20.4. "spacing" Attribute
skipping to change at page 42, line 24 skipping to change at page 41, line 24
o "true" o "true"
o "false" (default) o "false" (default)
2.33.2. "title" Attribute 2.33.2. "title" Attribute
Deprecated. Use <name> instead. Deprecated. Use <name> instead.
2.34. <ol> 2.34. <ol>
An ordered list. The labels on the items will be either a number or An ordered list. The labels on the items will be either a number or
a letter, depending on the value of the style attribute. a letter, depending on the value of the type attribute.
This element appears as a child element of <abstract> (Section 2.1), This element appears as a child element of <abstract> (Section 2.1),
<aside> (Section 2.7), <blockquote> (Section 2.11), <dd> <aside> (Section 2.7), <blockquote> (Section 2.11), <dd>
(Section 2.18), <li> (Section 2.29), <note> (Section 2.33), <section> (Section 2.18), <li> (Section 2.29), <note> (Section 2.33), <section>
(Section 2.44), <td> (Section 2.54), and <th> (Section 2.56). (Section 2.44), <td> (Section 2.54), and <th> (Section 2.56).
Content model: Content model:
One or more <li> elements (Section 2.29) One or more <li> elements (Section 2.29)
skipping to change at page 53, line 41 skipping to change at page 52, line 46
Allowed values: Allowed values:
o "IETF" (default) o "IETF" (default)
o "IAB" o "IAB"
o "IRTF" o "IRTF"
o "independent" o "independent"
o "editorial"
2.43.13. "symRefs" Attribute 2.43.13. "symRefs" Attribute
Specifies whether or not a formatter is requested to use symbolic Specifies whether or not a formatter is requested to use symbolic
references (such as "[RFC2119]"). If the value for this is "false", references (such as "[RFC2119]"). If the value for this is "false",
the references come out as numbers (such as "[3]"). the references come out as numbers (such as "[3]").
Allowed values: Allowed values:
o "true" (default) o "true" (default)
o "false" o "false"
2.43.14. "tocDepth" Attribute 2.43.14. "tocDepth" Attribute
Specifies the number of levels of headings that a formatter is Specifies the number of levels of headings that a formatter is
requested to include in the table of contents; the default is "3". requested to include in the table of contents; the default is "3".
2.43.15. "tocInclude" Attribute 2.43.15. "tocInclude" Attribute
Specifies whether or not a formatter is requested to include a table Specifies whether or not a formatter is requested to include a table
skipping to change at page 58, line 25 skipping to change at page 57, line 31
The identifier within the series specified by the "name" attribute. The identifier within the series specified by the "name" attribute.
For BCPs, FYIs, RFCs, and STDs, this is the number within the series. For BCPs, FYIs, RFCs, and STDs, this is the number within the series.
For Internet-Drafts, it is the full draft name (ending with the two- For Internet-Drafts, it is the full draft name (ending with the two-
digit version number). For DOIs, the value is given, such as digit version number). For DOIs, the value is given, such as
"10.17487/rfc1149", as described in [RFC7669]. "10.17487/rfc1149", as described in [RFC7669].
The name in the value should be the document name without any file The name in the value should be the document name without any file
extension. For Internet-Drafts, the value for this attribute should extension. For Internet-Drafts, the value for this attribute should
be "draft-ietf-somewg-someprotocol-07", not be "draft-ietf-somewg-someprotocol-07", not "draft-ietf-somewg-
"draft-ietf-somewg-someprotocol-07.txt". someprotocol-07.txt".
2.46. <sourcecode> 2.46. <sourcecode>
This element allows the inclusion of source code into the document. This element allows the inclusion of source code into the document.
When rendered, source code is always shown in a monospace font. When When rendered, source code is always shown in a monospace font. When
<sourcecode> is a child of <figure> or <section>, it provides full <sourcecode> is a child of <figure> or <section>, it provides full
control of horizontal whitespace and line breaks. When formatted, it control of horizontal whitespace and line breaks. When formatted, it
is indented relative to the left margin of the enclosing element. It is indented relative to the left margin of the enclosing element. It
is thus useful for source code and formal languages (such as ABNF is thus useful for source code and formal languages (such as ABNF
skipping to change at page 59, line 19 skipping to change at page 58, line 26
Content model: only text content. Content model: only text content.
2.46.1. "anchor" Attribute 2.46.1. "anchor" Attribute
Document-wide unique identifier for this source code. Document-wide unique identifier for this source code.
2.46.2. "markers" Attribute 2.46.2. "markers" Attribute
Specifies whether or not the soure code should be displayed between Specifies whether or not the soure code should be displayed between
"<CODE BEGINS>"/"<CODE ENDS>" markers, as described in <https:// "<CODE BEGINS>"/"<CODE ENDS>" markers, as described in
www.ietf.org/about/groups/iesg/statements/copyright-2009-09-08/>. <https://www.ietf.org/about/groups/iesg/statements/copyright-
Note that adding markers is not needed for the languages listed under 2009-09-08/>. Note that adding markers is not needed for the
"Code Components" on languages listed under "Code Components" on
<https://trustee.ietf.org/trust-legal-provisions.html>. <https://trustee.ietf.org/trust-legal-provisions.html>.
Additionally, if the "name" attribute is present, if will be Additionally, if the "name" attribute is present, if will be
displayed after "<CODE BEGINS>", as described in Section 3.2 of displayed after "<CODE BEGINS>", as described in Section 3.2 of
[RFC8407]. [RFC8407].
Allowed values: Allowed values:
o "true" o "true"
skipping to change at page 60, line 45 skipping to change at page 60, line 4
o pseudocode o pseudocode
o python o python
o rnc o rnc
o xml o xml
o yang o yang
The RFC Series Editor will maintain a complete list of the preferred The RFC Series Editor will maintain a complete list of the preferred
values on the RFC Editor web site, and that list is expected to be values on the RFC Editor web site, and that list is expected to be
updated over time. Thus, a consumer of v3 XML should not cause a updated over time. Thus, a consumer of v3 XML should be prepared for
failure when it encounters an unexpected type or no type is an unexpected type or no type at all.
specified.
2.47. <stream> 2.47. <stream>
[[anchor8: The document stream, one of IETF, IAB, IRTF, or The document stream, one of IETF, IAB, IRTF, independent, or
independent.]] editorial.
This element appears as a child element of <reference> This element appears as a child element of <reference>
(Section 2.40). (Section 2.40).
This element appears as a child element of <reference> This element appears as a child element of <reference>
(Section 2.40). (Section 2.40).
Content model: Content model:
[[anchor9: Missing template for optional.]] Text
2.48. <strong> 2.48. <strong>
Indicates text that is semantically strong. Text enclosed within Indicates text that is semantically strong. Text enclosed within
this element will be displayed as bold after processing. This this element will be displayed as bold after processing. This
element can be combined with other character formatting elements, and element can be combined with other character formatting elements, and
the formatting will be additive. the formatting will be additive.
This element appears as a child element of <annotation> This element appears as a child element of <annotation>
(Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.16), (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.16),
skipping to change at page 72, line 34 skipping to change at page 71, line 40
2.58.1. "abbrev" Attribute 2.58.1. "abbrev" Attribute
Specifies an abbreviated variant of the document title. Specifies an abbreviated variant of the document title.
2.58.2. "ascii" Attribute 2.58.2. "ascii" Attribute
The ASCII equivalent of the title. The ASCII equivalent of the title.
2.59. <toc> 2.59. <toc>
[[anchor10: This element contains the Table of Contents. It is This element contains the Table of Contents. It is created
created automatically by the preptool based on the "tocInclude" and automatically by the preptool based on the "tocInclude" and
"tocDepth" attributes of the <rfc> element. Document authors should "tocDepth" attributes of the <rfc> element and the section headers.
create it.]] In prepared drafts, it has no effect on document rendering and
contains no useful information. In prepared RFCs, it is used as the
source for the table of contents.
This element appears as a child element of <front> (Section 2.26). This element appears as a child element of <front> (Section 2.26).
Content model: Content model:
Optional <section> elements (Section 2.44) Optional <section> elements (Section 2.44)
2.60. <tr> 2.60. <tr>
A row of a table. A row of a table.
skipping to change at page 82, line 42 skipping to change at page 81, line 48
o <xref> elements (Section 2.66) o <xref> elements (Section 2.66)
3.2. <city> 3.2. <city>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.2.1. "ascii" attribute 3.2.1. "ascii" Attribute
The ASCII equivalent of the city name. The ASCII equivalent of the city name.
3.3. <cityarea> 3.3. <cityarea>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.3.1. "ascii" attribute 3.3.1. "ascii" Attribute
The ASCII equivalent of the city area name. The ASCII equivalent of the city area name.
3.4. <code> 3.4. <code>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.4.1. "ascii" attribute 3.4.1. "ascii" Attribute
The ASCII equivalent of the postal code. The ASCII equivalent of the postal code.
3.5. <extaddr> 3.5. <extaddr>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.5.1. "ascii" attribute 3.5.1. "ascii" Attribute
ASCII equivalent for extaddr. ASCII equivalent for extaddr.
3.6. <facsimile> 3.6. <facsimile>
Deprecated. The <email> element is a much more useful way to get in Deprecated. The <email> element is a much more useful way to get in
touch with authors. touch with authors.
This element appears as a child element of <address> (Section 2.2). This element appears as a child element of <address> (Section 2.2).
skipping to change at page 84, line 5 skipping to change at page 83, line 15
3.7. <format> 3.7. <format>
Deprecated. If the goal is to provide a single URI for a reference, Deprecated. If the goal is to provide a single URI for a reference,
use the "target" attribute in <reference> instead. use the "target" attribute in <reference> instead.
This element appears as a child element of <reference> This element appears as a child element of <reference>
(Section 2.40). (Section 2.40).
Content model: this element does not have any contents. Content model: this element does not have any contents.
3.7.1. "octets" attribute 3.7.1. "octets" Attribute
Deprecated. Deprecated.
3.7.2. "target" attribute 3.7.2. "target" Attribute
Deprecated. Deprecated.
3.7.3. "type" attribute (Mandatory) 3.7.3. "type" Attribute (Mandatory)
Deprecated. Deprecated.
3.8. <list> 3.8. <list>
Deprecated. Instead, use <dl> for list/@style "hanging"; <ul> for Deprecated. Instead, use <dl> for list/@style "hanging"; <ul> for
list/@style "empty" or "symbols"; and <ol> for list/@style "letters", list/@style "empty" or "symbols"; and <ol> for list/@style "letters",
"numbers", "counter", or "format". "numbers", "counter", or "format".
Content model: Content model:
One or more <t> elements (Section 2.51) One or more <t> elements (Section 2.51)
3.8.1. "counter" attribute 3.8.1. "counter" Attribute
Deprecated. The functionality of this attribute has been replaced Deprecated. The functionality of this attribute has been replaced
with <ol>/@start. with <ol>/@start.
3.8.2. "hangIndent" attribute 3.8.2. "hangIndent" Attribute
Deprecated. Use <dl> instead. Deprecated. Use <dl> instead.
3.8.3. "style" attribute 3.8.3. "style" Attribute
Deprecated. Deprecated.
3.9. <pobox> 3.9. <pobox>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.9.1. "ascii" attribute 3.9.1. "ascii" Attribute
ASCII equivalent for pobox. ASCII equivalent for pobox.
3.10. <postamble> 3.10. <postamble>
Deprecated. Instead, use a regular paragraph after the figure or Deprecated. Instead, use a regular paragraph after the figure or
table. table.
This element appears as a child element of <figure> (Section 2.25) This element appears as a child element of <figure> (Section 2.25)
and <texttable> (Section 3.17). and <texttable> (Section 3.17).
skipping to change at page 86, line 28 skipping to change at page 85, line 41
o <xref> elements (Section 2.66) o <xref> elements (Section 2.66)
3.12. <region> 3.12. <region>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.12.1. "ascii" attribute 3.12.1. "ascii" Attribute
The ASCII equivalent of the region name. The ASCII equivalent of the region name.
3.13. <relref> 3.13. <relref>
Deprecated, use <xref> instead. Deprecated, use <xref> instead.
Represents a link to a specific part of a document that appears in a Represents a link to a specific part of a document that appears in a
<reference> element. Formatters that have links (such as HTML and <reference> element. Formatters that have links (such as HTML and
PDF) render <relref> elements as external hyperlinks to the specified PDF) render <relref> elements as external hyperlinks to the specified
skipping to change at page 87, line 30 skipping to change at page 86, line 40
This element appears as a child element of <annotation> This element appears as a child element of <annotation>
(Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.16), (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.16),
<dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li> <dd> (Section 2.18), <dt> (Section 2.21), <em> (Section 2.22), <li>
(Section 2.29), <name> (Section 2.32), <preamble> (Section 3.11), (Section 2.29), <name> (Section 2.32), <preamble> (Section 3.11),
<strong> (Section 2.48), <sub> (Section 2.49), <sup> (Section 2.50), <strong> (Section 2.48), <sub> (Section 2.49), <sup> (Section 2.50),
<t> (Section 2.51), <td> (Section 2.54), <th> (Section 2.56), and <t> (Section 2.51), <td> (Section 2.54), <th> (Section 2.56), and
<tt> (Section 2.61). <tt> (Section 2.61).
Content model: only text content. Content model: only text content.
3.13.1. "displayFormat" attribute 3.13.1. "displayFormat" Attribute
This attribute is used to signal formatters what the desired format This attribute is used to signal formatters what the desired format
of the relative reference should be. Formatters for document types of the relative reference should be. Formatters for document types
that have linking capability should wrap each part of the displayed that have linking capability should wrap each part of the displayed
text in hyperlinks. If there is content in the <relref> element, text in hyperlinks. If there is content in the <relref> element,
formatters will ignore the value of this attribute. formatters will ignore the value of this attribute.
"of" "of"
A formatter should display the relative reference as the word A formatter should display the relative reference as the word
skipping to change at page 90, line 4 skipping to change at page 89, line 19
<a href="http://www.rfc-editor.org/info/rfc9999#s-2.4"> <a href="http://www.rfc-editor.org/info/rfc9999#s-2.4">
Section 2.4</a> of Section 2.4</a> of
[<a href="#RFC9999">RFC9999</a>] [<a href="#RFC9999">RFC9999</a>]
for an overview. for an overview.
Allowed values: Allowed values:
o "of" (default) o "of" (default)
o "comma" o "comma"
o "parens" o "parens"
o "bare" o "bare"
3.13.2. "relative" attribute 3.13.2. "relative" Attribute
Specifies a relative reference from the URI in the target reference. Specifies a relative reference from the URI in the target reference.
This value must include whatever leading character is needed to This value must include whatever leading character is needed to
create the relative reference; typically, this is "#" for HTML create the relative reference; typically, this is "#" for HTML
documents. documents.
3.13.3. "section" attribute (Mandatory) 3.13.3. "section" Attribute (Mandatory)
Specifies a section of the target reference. If the reference is not Specifies a section of the target reference. If the reference is not
an RFC or Internet-Draft in the v3 format, it is an error. an RFC or Internet-Draft in the v3 format, it is an error.
3.13.4. "target" attribute (Mandatory) 3.13.4. "target" Attribute (Mandatory)
The anchor of the reference for this element. If this value is not The anchor of the reference for this element. If this value is not
an anchor to a <reference> or <referencegroup> element, it is an an anchor to a <reference> or <referencegroup> element, it is an
error. If the reference at the target has no URI, it is an error. error. If the reference at the target has no URI, it is an error.
3.14. <sortingcode> 3.14. <sortingcode>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.14.1. "ascii" attribute 3.14.1. "ascii" Attribute
ASCII equivalent for sortingcode. ASCII equivalent for sortingcode.
3.15. <spanx> 3.15. <spanx>
Deprecated. Deprecated.
This element appears as a child element of <annotation> This element appears as a child element of <annotation>
(Section 2.3), <c> (Section 3.1), <postamble> (Section 3.10), (Section 2.3), <c> (Section 3.1), <postamble> (Section 3.10),
<preamble> (Section 3.11), and <t> (Section 2.51). <preamble> (Section 3.11), and <t> (Section 2.51).
Content model: only text content. Content model: only text content.
3.15.1. "style" attribute 3.15.1. "style" Attribute
Deprecated. Instead of <spanx style="emph">, use <em>; instead of Deprecated. Instead of <spanx style="emph">, use <em>; instead of
<spanx style="strong">, use <strong>; instead of <spanx <spanx style="strong">, use <strong>; instead of <spanx
style="verb">, use <tt>. style="verb">, use <tt>.
3.15.2. "xml:space" attribute 3.15.2. "xml:space" Attribute
Deprecated. Deprecated.
Allowed values: Allowed values:
o "default" o "default"
o "preserve" (default) o "preserve" (default)
3.16. <street> 3.16. <street>
Deprecated, use <postalLine> instead. Deprecated, use <postalLine> instead.
This element appears as a child element of <postal> (Section 2.37). This element appears as a child element of <postal> (Section 2.37).
Content model: only text content. Content model: only text content.
3.16.1. "ascii" attribute 3.16.1. "ascii" Attribute
The ASCII equivalent of the street address. The ASCII equivalent of the street address.
3.17. <texttable> 3.17. <texttable>
Deprecated. Use <table> instead. Deprecated. Use <table> instead.
This element appears as a child element of <section> (Section 2.44). This element appears as a child element of <section> (Section 2.44).
Content model: Content model:
skipping to change at page 92, line 5 skipping to change at page 91, line 19
1. One optional <name> element (Section 2.32) 1. One optional <name> element (Section 2.32)
2. One optional <preamble> element (Section 3.11) 2. One optional <preamble> element (Section 3.11)
3. One or more <ttcol> elements (Section 3.18) 3. One or more <ttcol> elements (Section 3.18)
4. Optional <c> elements (Section 3.1) 4. Optional <c> elements (Section 3.1)
5. One optional <postamble> element (Section 3.10) 5. One optional <postamble> element (Section 3.10)
3.17.1. "align" attribute 3.17.1. "align" Attribute
Deprecated. Deprecated.
Allowed values: Allowed values:
o "left" o "left"
o "center" (default) o "center" (default)
o "right" o "right"
3.17.2. "anchor" attribute 3.17.2. "anchor" Attribute
Deprecated. Deprecated.
3.17.3. "style" attribute 3.17.3. "style" Attribute
Deprecated. Deprecated.
Allowed values: Allowed values:
o "all" o "all"
o "none" o "none"
o "headers" o "headers"
o "full" (default) o "full" (default)
3.17.4. "suppress-title" attribute 3.17.4. "suppress-title" Attribute
Deprecated. Deprecated.
Allowed values: Allowed values:
o "true" o "true"
o "false" (default) o "false" (default)
3.17.5. "title" attribute 3.17.5. "title" Attribute
Deprecated. Deprecated.
3.18. <ttcol> 3.18. <ttcol>
Deprecated. Instead, use <tr>, <td>, and <th>. Deprecated. Instead, use <tr>, <td>, and <th>.
This element appears as a child element of <texttable> This element appears as a child element of <texttable>
(Section 3.17). (Section 3.17).
skipping to change at page 93, line 22 skipping to change at page 92, line 40
o <cref> elements (Section 2.16) o <cref> elements (Section 2.16)
o <eref> elements (Section 2.24) o <eref> elements (Section 2.24)
o <iref> elements (Section 2.27) o <iref> elements (Section 2.27)
o <xref> elements (Section 2.66) o <xref> elements (Section 2.66)
o Text o Text
3.18.1. "align" attribute 3.18.1. "align" Attribute
Deprecated. Deprecated.
Allowed values: Allowed values:
o "left" (default) o "left" (default)
o "center" o "center"
o "right" o "right"
3.18.2. "width" attribute 3.18.2. "width" Attribute
Deprecated. Deprecated.
3.19. <vspace> 3.19. <vspace>
Deprecated. In earlier versions of this format, <vspace> was often Deprecated. In earlier versions of this format, <vspace> was often
used to get an extra blank line in a list element; in the v3 used to get an extra blank line in a list element; in the v3
vocabulary, that can be done instead by using multiple <t> elements vocabulary, that can be done instead by using multiple <t> elements
inside the <li> element. Other uses have no direct replacement. inside the <li> element. Other uses have no direct replacement.
This element appears as a child element of <t> (Section 2.51). This element appears as a child element of <t> (Section 2.51).
Content model: this element does not have any contents. Content model: this element does not have any contents.
3.19.1. "blankLines" attribute 3.19.1. "blankLines" Attribute
Deprecated. Deprecated.
4. SVG 4. SVG
The discussion of the use of SVG can be found in [RFC7996]. This The discussion of the use of SVG can be found in [RFC7996]. This
element is part of the namespace "http://www.w3.org/2000/svg". element is part of the namespace "http://www.w3.org/2000/svg".
5. Use of CDATA Structures and Escaping 5. Use of CDATA Structures and Escaping
skipping to change at page 97, line 31 skipping to change at page 96, line 47
is also different than "previous" in that this relation is used for is also different than "previous" in that this relation is used for
converted resources, not those that are part of a sequence of converted resources, not those that are part of a sequence of
resources. resources.
Application Data: None Application Data: None
9. References 9. References
9.1. Normative References 9.1. Normative References
[BCP14] Bradner, S., "Key words for use in RFCs to Indicate [BCP14] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997, Requirement Levels", BCP 14, RFC 2119, March 1997,
<http://www.rfc-editor.org/info/bcp14>. <http://www.rfc-editor.org/info/bcp14>.
[RFC7991] Hoffman, P., "The "xml2rfc" Version 3 Vocabulary", [RFC7991] Hoffman, P., "The "xml2rfc" Version 3 Vocabulary",
RFC 7991, December 2016, RFC 7991, DOI 10.17487/RFC7991, December 2016,
<https://www.rfc-editor.org/info/rfc7991>. <https://www.rfc-editor.org/info/rfc7991>.
[XML] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, [XML] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E., and
E., and F. Yergeau, "Extensible Markup Language F. Yergeau, "Extensible Markup Language (XML) 1.0 (Fifth
(XML) 1.0 (Fifth Edition)", W3C Recommendation REC- Edition)", W3C Recommendation REC-xml-20081126, November
xml-20081126, November 2008, 2008, <https://www.w3.org/TR/2008/REC-xml-20081126/>.
<https://www.w3.org/TR/2008/REC-xml-20081126/>.
Latest version available at Latest version available at <http://www.w3.org/TR/xml>.
<http://www.w3.org/TR/xml>.
9.2. Informative References 9.2. Informative References
[IDGUIDE] Housley, R., "Guidelines to Authors of Internet- [IDGUIDE] Housley, R., "Guidelines to Authors of Internet-Drafts",
Drafts", December 2010, December 2010,
<https://www.ietf.org/id-info/guidelines.html>. <https://www.ietf.org/id-info/guidelines.html>.
[LINKRELATIONS] IANA, "Link Relations", <https://www.iana.org/ [LINKRELATIONS]
assignments/link-relations/link-relations.xhtml>. IANA, "Link Relations", <https://www.iana.org/assignments/
link-relations/link-relations.xhtml>.
[RFC2026] Bradner, S., "The Internet Standards Process -- [RFC2026] Bradner, S., "The Internet Standards Process -- Revision
Revision 3", BCP 9, RFC 2026, October 1996, 3", BCP 9, RFC 2026, DOI 10.17487/RFC2026, October 1996,
<https://www.rfc-editor.org/info/rfc2026>. <https://www.rfc-editor.org/info/rfc2026>.
[RFC2397] Masinter, L., "The "data" URL scheme", RFC 2397, [RFC2397] Masinter, L., "The "data" URL scheme", RFC 2397,
August 1998, DOI 10.17487/RFC2397, August 1998,
<https://www.rfc-editor.org/info/rfc2397>. <https://www.rfc-editor.org/info/rfc2397>.
[RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629,
RFC 2629, June 1999, DOI 10.17487/RFC2629, June 1999,
<https://www.rfc-editor.org/info/rfc2629>. <https://www.rfc-editor.org/info/rfc2629>.
[RFC3339] Klyne, G. and C. Newman, "Date and Time on the [RFC3339] Klyne, G. and C. Newman, "Date and Time on the Internet:
Internet: Timestamps", RFC 3339, July 2002, Timestamps", RFC 3339, DOI 10.17487/RFC3339, July 2002,
<https://www.rfc-editor.org/info/rfc3339>. <https://www.rfc-editor.org/info/rfc3339>.
[RFC3470] Hollenbeck, S., Rose, M., and L. Masinter, [RFC3470] Hollenbeck, S., Rose, M., and L. Masinter, "Guidelines for
"Guidelines for the Use of Extensible Markup the Use of Extensible Markup Language (XML) within IETF
Language (XML) within IETF Protocols", BCP 70, Protocols", BCP 70, RFC 3470, DOI 10.17487/RFC3470,
RFC 3470, January 2003, January 2003, <https://www.rfc-editor.org/info/rfc3470>.
<https://www.rfc-editor.org/info/rfc3470>.
[RFC3667] Bradner, S., "IETF Rights in Contributions", [RFC3667] Bradner, S., "IETF Rights in Contributions", RFC 3667,
RFC 3667, February 2004, DOI 10.17487/RFC3667, February 2004,
<https://www.rfc-editor.org/info/rfc3667>. <https://www.rfc-editor.org/info/rfc3667>.
[RFC3966] Schulzrinne, H., "The tel URI for Telephone [RFC3966] Schulzrinne, H., "The tel URI for Telephone Numbers",
Numbers", RFC 3966, December 2004, RFC 3966, DOI 10.17487/RFC3966, December 2004,
<https://www.rfc-editor.org/info/rfc3966>. <https://www.rfc-editor.org/info/rfc3966>.
[RFC3978] Bradner, S., Ed., "IETF Rights in Contributions", [RFC3978] Bradner, S., Ed., "IETF Rights in Contributions",
RFC 3978, March 2005, RFC 3978, DOI 10.17487/RFC3978, March 2005,
<https://www.rfc-editor.org/info/rfc3978>. <https://www.rfc-editor.org/info/rfc3978>.
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
"Uniform Resource Identifier (URI): Generic Syntax", Resource Identifier (URI): Generic Syntax", STD 66,
STD 66, RFC 3986, January 2005, RFC 3986, DOI 10.17487/RFC3986, January 2005,
<https://www.rfc-editor.org/info/rfc3986>. <https://www.rfc-editor.org/info/rfc3986>.
[RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
Syntax Specifications: ABNF", STD 68, RFC 5234, Specifications: ABNF", STD 68, RFC 5234,
January 2008, DOI 10.17487/RFC5234, January 2008,
<https://www.rfc-editor.org/info/rfc5234>. <https://www.rfc-editor.org/info/rfc5234>.
[RFC5378] Bradner, S., Ed. and J. Contreras, Ed., "Rights [RFC5378] Bradner, S., Ed. and J. Contreras, Ed., "Rights
Contributors Provide to the IETF Trust", BCP 78, Contributors Provide to the IETF Trust", BCP 78, RFC 5378,
RFC 5378, November 2008, DOI 10.17487/RFC5378, November 2008,
<https://www.rfc-editor.org/info/rfc5378>. <https://www.rfc-editor.org/info/rfc5378>.
[RFC6068] Duerst, M., Masinter, L., and J. Zawinski, "The [RFC6068] Duerst, M., Masinter, L., and J. Zawinski, "The 'mailto'
'mailto' URI Scheme", RFC 6068, October 2010, URI Scheme", RFC 6068, DOI 10.17487/RFC6068, October 2010,
<https://www.rfc-editor.org/info/rfc6068>. <https://www.rfc-editor.org/info/rfc6068>.
[RFC6266] Reschke, J., "Use of the Content-Disposition Header [RFC6266] Reschke, J., "Use of the Content-Disposition Header Field
Field in the Hypertext Transfer Protocol (HTTP)", in the Hypertext Transfer Protocol (HTTP)", RFC 6266,
RFC 6266, June 2011, DOI 10.17487/RFC6266, June 2011,
<https://www.rfc-editor.org/info/rfc6266>. <https://www.rfc-editor.org/info/rfc6266>.
[RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type [RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type
Specifications and Registration Procedures", BCP 13, Specifications and Registration Procedures", BCP 13,
RFC 6838, January 2013, RFC 6838, DOI 10.17487/RFC6838, January 2013,
<https://www.rfc-editor.org/info/rfc6838>. <https://www.rfc-editor.org/info/rfc6838>.
[RFC6949] Flanagan, H. and N. Brownlee, "RFC Series Format [RFC6949] Flanagan, H. and N. Brownlee, "RFC Series Format
Requirements and Future Development", RFC 6949, Requirements and Future Development", RFC 6949,
May 2013, <https://www.rfc-editor.org/info/rfc6949>. DOI 10.17487/RFC6949, May 2013,
<https://www.rfc-editor.org/info/rfc6949>.
[RFC7303] Thompson, H. and C. Lilley, "XML Media Types", [RFC7303] Thompson, H. and C. Lilley, "XML Media Types", RFC 7303,
RFC 7303, July 2014, DOI 10.17487/RFC7303, July 2014,
<https://www.rfc-editor.org/info/rfc7303>. <https://www.rfc-editor.org/info/rfc7303>.
[RFC7322] Flanagan, H. and S. Ginoza, "RFC Style Guide", [RFC7322] Flanagan, H. and S. Ginoza, "RFC Style Guide", RFC 7322,
RFC 7322, September 2014, DOI 10.17487/RFC7322, September 2014,
<https://www.rfc-editor.org/info/rfc7322>. <https://www.rfc-editor.org/info/rfc7322>.
[RFC7669] Levine, J., "Assigning Digital Object Identifiers to [RFC7669] Levine, J., "Assigning Digital Object Identifiers to
RFCs", RFC 7669, October 2015, RFCs", RFC 7669, DOI 10.17487/RFC7669, October 2015,
<https://www.rfc-editor.org/info/rfc7669>. <https://www.rfc-editor.org/info/rfc7669>.
[RFC7749] Reschke, J., "The "xml2rfc" Version 2 Vocabulary", [RFC7749] Reschke, J., "The "xml2rfc" Version 2 Vocabulary",
RFC 7749, February 2016, RFC 7749, DOI 10.17487/RFC7749, February 2016,
<https://www.rfc-editor.org/info/rfc7749>. <https://www.rfc-editor.org/info/rfc7749>.
[RFC7841] Halpern, J., Ed., Daigle, L., Ed., and O. Kolkman, [RFC7841] Halpern, J., Ed., Daigle, L., Ed., and O. Kolkman, Ed.,
Ed., "RFC Streams, Headers, and Boilerplates", "RFC Streams, Headers, and Boilerplates", RFC 7841,
RFC 7841, May 2016, DOI 10.17487/RFC7841, May 2016,
<https://www.rfc-editor.org/info/rfc7841>. <https://www.rfc-editor.org/info/rfc7841>.
[RFC7996] Brownlee, N., "SVG Drawings for RFCs: SVG 1.2 RFC", [RFC7996] Brownlee, N., "SVG Drawings for RFCs: SVG 1.2 RFC",
RFC 7996, December 2016, RFC 7996, DOI 10.17487/RFC7996, December 2016,
<https://www.rfc-editor.org/info/rfc7996>. <https://www.rfc-editor.org/info/rfc7996>.
[RFC7997] Flanagan, H., Ed., "The Use of Non-ASCII Characters [RFC7997] Flanagan, H., Ed., "The Use of Non-ASCII Characters in
in RFCs", RFC 7997, December 2016, RFCs", RFC 7997, DOI 10.17487/RFC7997, December 2016,
<https://www.rfc-editor.org/info/rfc7997>. <https://www.rfc-editor.org/info/rfc7997>.
[RFC7998] Hoffman, P. and J. Hildebrand, ""xml2rfc" Version 3 [RFC7998] Hoffman, P. and J. Hildebrand, ""xml2rfc" Version 3
Preparation Tool Description", RFC 7998, Preparation Tool Description", RFC 7998,
December 2016, DOI 10.17487/RFC7998, December 2016,
<https://www.rfc-editor.org/info/rfc7998>. <https://www.rfc-editor.org/info/rfc7998>.
[RFC8407] Bierman, A., "Guidelines for Authors and Reviewers [RFC8407] Bierman, A., "Guidelines for Authors and Reviewers of
of Documents Containing YANG Data Models", BCP 216, Documents Containing YANG Data Models", BCP 216, RFC 8407,
RFC 8407, October 2018, DOI 10.17487/RFC8407, October 2018,
<https://www.rfc-editor.org/info/rfc8407>. <https://www.rfc-editor.org/info/rfc8407>.
[RNC] Clark, J., "RELAX NG Compact Syntax", The [RNC] Clark, J., "RELAX NG Compact Syntax", The Organization for
Organization for the Advancement of Structured the Advancement of Structured Information Standards
Information Standards (OASIS) , November 2002, <http (OASIS) , November 2002, <https://www.oasis-
s://www.oasis-open.org/committees/relax-ng/ open.org/committees/relax-ng/compact-20021121.html>.
compact-20021121.html>.
[RNG] ISO/IEC, "Information Technology - Document Schema [RNG] ISO/IEC, "Information Technology - Document Schema
Definition Languages (DSDL) - Part 2: Regular- Definition Languages (DSDL) - Part 2: Regular-Grammar-
Grammar-Based Validation - RELAX NG (Second Based Validation - RELAX NG (Second Edition)", ISO/
Edition)", ISO/IEC 19757-2:2008(E), December 2008. IEC 19757-2:2008(E), December 2008.
A useful source of RNG-related information is A useful source of RNG-related information is
<http://relaxng.org/>. <http://relaxng.org/>.
[TLP1.0] IETF Trust, "Legal Provisions Relating to IETF [TLP1.0] IETF Trust, "Legal Provisions Relating to IETF Documents",
Documents", November 2008, <http://trustee.ietf.org/ November 2008,
license-info/IETF-TLP-1.htm>. <http://trustee.ietf.org/license-info/IETF-TLP-1.htm>.
[TLP2.0] IETF Trust, "Legal Provisions Relating to IETF [TLP2.0] IETF Trust, "Legal Provisions Relating to IETF Documents",
Documents", February 2009, <http://trustee.ietf.org/ February 2009,
license-info/IETF-TLP-2.htm>. <http://trustee.ietf.org/license-info/IETF-TLP-2.htm>.
[TLP3.0] IETF Trust, "Legal Provisions Relating to IETF [TLP3.0] IETF Trust, "Legal Provisions Relating to IETF Documents",
Documents", September 2009, <http:// September 2009,
trustee.ietf.org/license-info/IETF-TLP-3.htm>. <http://trustee.ietf.org/license-info/IETF-TLP-3.htm>.
[TLP4.0] IETF Trust, "Legal Provisions Relating to IETF [TLP4.0] IETF Trust, "Legal Provisions Relating to IETF Documents",
Documents", December 2009, <http://trustee.ietf.org/ December 2009,
license-info/IETF-TLP-4.htm>. <http://trustee.ietf.org/license-info/IETF-TLP-4.htm>.
[TLP5.0] IETF Trust, "Legal Provisions Relating to IETF [TLP5.0] IETF Trust, "Legal Provisions Relating to IETF Documents",
Documents", March 2015, <http://trustee.ietf.org/ March 2015,
license-info/IETF-TLP-5.htm>. <http://trustee.ietf.org/license-info/IETF-TLP-5.htm>.
[UAX24] The Unicode Consortium, "UAX #24: Unicode Script [UAX24] The Unicode Consortium, "UAX #24: Unicode Script
Property", <http://www.unicode.org/reports/tr24/>. Property", <http://www.unicode.org/reports/tr24/>.
[UNICODE] The Unicode Consortium, "The Unicode Standard", [UNICODE] The Unicode Consortium, "The Unicode Standard",
<http://www.unicode.org/versions/latest/>. <http://www.unicode.org/versions/latest/>.
[USASCII] American National Standards Institute, "Coded [USASCII] American National Standards Institute, "Coded Character
Character Set -- 7-bit American Standard Code for Set -- 7-bit American Standard Code for Information
Information Interchange", ANSI X3.4, 1986. Interchange", ANSI X3.4, 1986.
[XInclude] Marsh, J., Orchard, D., and D. Veillard, "XML [XInclude]
Inclusions (XInclude) Version 1.0 (Second Edition)", Marsh, J., Orchard, D., and D. Veillard, "XML Inclusions
W3C Recommendation REC-xinclude-20061115, (XInclude) Version 1.0 (Second Edition)", W3C
November 2006, <https://www.w3.org/TR/xinclude/ Recommendation REC-xinclude-20061115, November 2006,
REC-xinclude-20061115/>. <https://www.w3.org/TR/xinclude/REC-xinclude-20061115/>.
Latest version available at Latest version available at <http://www.w3.org/TR/
<http://www.w3.org/TR/xinclude/>. xinclude/>.
[XPOINTER] Grosso, P., Maler, E., Marsh, J., and N. Walsh, [XPOINTER]
"XPointer Framework", W3C Recommendation REC-xptr- Grosso, P., Maler, E., Marsh, J., and N. Walsh, "XPointer
framework-20030325, March 2003, <http://www.w3.org/ Framework", W3C Recommendation REC-xptr-framework-
TR/2003/REC-xptr-framework-20030325/>. 20030325, March 2003,
<http://www.w3.org/TR/2003/REC-xptr-framework-20030325/>.
Latest version available at Latest version available at <http://www.w3.org/TR/xptr-
<http://www.w3.org/TR/xptr-framework/>. framework/>.
9.3. Editorial References 9.3. Editorial References
[IMPNOTES] Levkowetz, H., "Implementation notes for RFC7991, [IMPNOTES]
"The 'xml2rfc' Version 3 Vocabulary"", Levkowetz, H., "Implementation notes for RFC7991, "The
draft-levkowetz-xml2rfc-v3-implementation-notes-10 'xml2rfc' Version 3 Vocabulary"", draft-levkowetz-xml2rfc-
(work in progress), October 2019. v3-implementation-notes-10 (work in progress), October
2019.
URIs 9.4. URIs
[1] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [1] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/34
bis/issues/34>
[2] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [2] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/50
bis/pull/50>
[3] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [3] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/35
bis/issues/35>
[4] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [4] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/51
bis/pull/51>
[5] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [5] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/37
bis/issues/37>
[6] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [6] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/56
bis/pull/56>
[7] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [7] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/38
bis/issues/38>
[8] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [8] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/62
bis/pull/62>
[9] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [9] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/39
bis/issues/39>
[10] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [10] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/63
bis/pull/63>
[11] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [11] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/9
bis/issues/9>
[12] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [12] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/40
bis/issues/40>
[13] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [13] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/68
bis/pull/68>
[14] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [14] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/32
bis/issues/32>
[15] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [15] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/40
bis/pull/69>
[16] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [16] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/69
bis/issues/47>
[17] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [17] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/47
bis/pull/70>
[18] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [18] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/70
bis/issues/76>
[19] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [19] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/76
bis/pull/89>
[20] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [20] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/89
bis/pull/92>
[21] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [21] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/47
bis/pull/93>
[22] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [22] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/69
bis/pull/95>
[23] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [23] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/92
bis/pull/96>
[24] <https://github.com/rfc-format/draft-iab-xml2rfc-v3- [24] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/93
bis/pull/97>
[25] <https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/ [25] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/95
108>
[26] <https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/ [26] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/96
111>
[27] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/97
[28] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/108
[29] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/108
[30] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/108
[31] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
issues/111
Appendix A. Front-Page ("Boilerplate") Generation Appendix A. Front-Page ("Boilerplate") Generation
The values listed here will be defined by the RFC Series Editor. The values listed here will be defined by the RFC Series Editor.
Those listed here are believed to be the current values in use. Those listed here are believed to be the current values in use.
A.1. The "category" Attribute A.1. The "category" Attribute
For RFCs, the "category" attribute (Section 2.43.1) determines the For RFCs, the "category" attribute (Section 2.43.1) determines the
"maturity level" (see Section 4 of [RFC2026]). The allowed values "maturity level" (see Section 4 of [RFC2026]). The allowed values
skipping to change at page 104, line 22 skipping to change at page 104, line 4
"IETF", which is the default). Other values, such as "independent", "IETF", which is the default). Other values, such as "independent",
suppress this part of the text. suppress this part of the text.
A.2.1. Current Values: "*trust200902" A.2.1. Current Values: "*trust200902"
The name for these values refers to version 2.0 of the IETF Trust's The name for these values refers to version 2.0 of the IETF Trust's
"Legal Provisions Relating to IETF Documents", sometimes simply "Legal Provisions Relating to IETF Documents", sometimes simply
called the "TLP", which went into effect on February 15, 2009 called the "TLP", which went into effect on February 15, 2009
[TLP2.0]. Updates to the document were published on September 12, [TLP2.0]. Updates to the document were published on September 12,
2009 [TLP3.0] and on December 28, 2009 [TLP4.0], modifying the 2009 [TLP3.0] and on December 28, 2009 [TLP4.0], modifying the
license for code components (see license for code components (see <http://trustee.ietf.org/license-
<http://trustee.ietf.org/license-info/> for further information). info/> for further information). The actual text is located in
The actual text is located in Section 6 ("Text to Be Included in IETF Section 6 ("Text to Be Included in IETF Documents") of these
Documents") of these documents. documents.
The prep tool automatically produces the "correct" text, depending on The prep tool automatically produces the "correct" text, depending on
the document's date information (see above): the document's date information (see above):
+----------+--------------------------------+ +----------+--------------------------------+
| TLP | starting with publication date | | TLP | starting with publication date |
+----------+--------------------------------+ +----------+--------------------------------+
| [TLP3.0] | 2009-11-01 | | [TLP3.0] | 2009-11-01 |
| [TLP4.0] | 2010-04-01 | | [TLP4.0] | 2010-04-01 |
+----------+--------------------------------+ +----------+--------------------------------+
skipping to change at page 105, line 36 skipping to change at page 105, line 23
10, 2008. The person(s) controlling the copyright in some of this 10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process. modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) Without obtaining an adequate license from the person(s)
controlling the copyright in such materials, this document may not controlling the copyright in such materials, this document may not
be modified outside the IETF Standards Process, and derivative be modified outside the IETF Standards Process, and derivative
works of it may not be created outside the IETF Standards Process, works of it may not be created outside the IETF Standards Process,
except to format it for publication as an RFC or to translate it except to format it for publication as an RFC or to translate it
into languages other than English. into languages other than English.
See Section 4 of See Section 4 of <http://trustee.ietf.org/docs/IETF-Copyright-
<http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf> for further FAQ.pdf> for further information about when to use this value.
information about when to use this value.
Note: this text appears under "Copyright Notice", unless the Note: this text appears under "Copyright Notice", unless the
document was published before November 2009, in which case it document was published before November 2009, in which case it
appears under "Status of This Memo". appears under "Status of This Memo".
A.2.2. Historic Values A.2.2. Historic Values
A.2.2.1. Historic Values: "*trust200811" A.2.2.1. Historic Values: "*trust200811"
The attribute values "trust200811", "noModificationTrust200811", and The attribute values "trust200811", "noModificationTrust200811", and
skipping to change at page 108, line 6 skipping to change at page 107, line 43
and changes many attribute values, and creates a file that is a and changes many attribute values, and creates a file that is a
"prepared document". The prepared document is a valid v3 "prepared document". The prepared document is a valid v3
document. The prep tool is described in [RFC7998]. document. The prep tool is described in [RFC7998].
The prep tool is expected to have many modes: The prep tool is expected to have many modes:
* RFC mode -- The mode used by the RFC Editor to process the * RFC mode -- The mode used by the RFC Editor to process the
input from one of the RFC streams and to process XML produced input from one of the RFC streams and to process XML produced
during the RFC editing process. The restrictions on the during the RFC editing process. The restrictions on the
canonical XML for RFCs, as well as how the non-canonical canonical XML for RFCs, as well as how the non-canonical
formats will look, are described at <https:// formats will look, are described at <https://www.rfc-
www.rfc-editor.org/rse/wiki/ editor.org/rse/wiki/doku.php?id=design:format-and-content-
doku.php?id=design:format-and-content-rfcs>. rfcs>.
* Draft mode -- The mode used by the Internet-Draft submission * Draft mode -- The mode used by the Internet-Draft submission
tool. The restrictions for the XML from this mode will be tool. The restrictions for the XML from this mode will be
described later. described later.
* Diagnostic mode -- A mode that can be used by document authors * Diagnostic mode -- A mode that can be used by document authors
to look for errors or warnings before they submit their to look for errors or warnings before they submit their
documents for publication. documents for publication.
* Consolidation mode -- Produces output where no external * Consolidation mode -- Produces output where no external
skipping to change at page 110, line 49 skipping to change at page 110, line 34
sections can only have those anchor values. sections can only have those anchor values.
The following rules prevent this overlap: The following rules prevent this overlap:
o "pn" for regular sections always has the format "s-nnn", where o "pn" for regular sections always has the format "s-nnn", where
"nnn" is the section number, or the appendix identifier (which "nnn" is the section number, or the appendix identifier (which
starts with a letter). For example, this would be "s-2.1.3" for starts with a letter). For example, this would be "s-2.1.3" for
Section 2.1.3 and "s-a" for Appendix A. For the <abstract> Section 2.1.3 and "s-a" for Appendix A. For the <abstract>
element, it is always "s-abstract". For the <note> element, it is element, it is always "s-abstract". For the <note> element, it is
always "s-note-nnn", where "nnn" is a sequential value. For always "s-note-nnn", where "nnn" is a sequential value. For
sections in the <boilerplate> element, it is always sections in the <boilerplate> element, it is always "s-
"s-boilerplate-nnn", where "nnn" is a sequential value. boilerplate-nnn", where "nnn" is a sequential value.
o "pn" for <references> elements has the format "s-nnn". It is o "pn" for <references> elements has the format "s-nnn". It is
important to note that "nnn" is a number, not letters, even though important to note that "nnn" is a number, not letters, even though
the <references> appear in the back. It is the number that is one the <references> appear in the back. It is the number that is one
higher than the highest top-level section number in <middle>. If higher than the highest top-level section number in <middle>. If
there are two or more <references>, "nnn" will include a dot as if there are two or more <references>, "nnn" will include a dot as if
the <references> are a subsection of a section that is numbered the <references> are a subsection of a section that is numbered
one higher than the highest top-level section number in <middle>. one higher than the highest top-level section number in <middle>.
o "pn" for <figure> elements always has the format "f-nnn", where o "pn" for <figure> elements always has the format "f-nnn", where
skipping to change at page 111, line 28 skipping to change at page 111, line 11
"ttt" is the slugified item (plus a hyphen and the slugified "ttt" is the slugified item (plus a hyphen and the slugified
subitem if there is a subitem), and "nnn" is the instance of that subitem if there is a subitem), and "nnn" is the instance of that
item/subitem pair. For example, this would be "i-foo-1" for item/subitem pair. For example, this would be "i-foo-1" for
"<iref item='foo'>" and "i-foo-bar-1" for "<iref item='foo' "<iref item='foo'>" and "i-foo-bar-1" for "<iref item='foo'
subitem='bar'>". subitem='bar'>".
o "pn" for <table> elements always has the format "t-nnn", where o "pn" for <table> elements always has the format "t-nnn", where
"nnn" is the table number. For example, this would be "t-5" for "nnn" is the table number. For example, this would be "t-5" for
Table 5. Table 5.
o "pn" for all elements not listed above always has the format o "pn" for all elements not listed above always has the format "p-
"p-nnn-mmm", where "nnn" is the section number and "mmm" is the nnn-mmm", where "nnn" is the section number and "mmm" is the
relative position in the section. For example, this would be relative position in the section. For example, this would be
"p-2.1.3-7" for the seventh part number in Section 2.1.3. "p-2.1.3-7" for the seventh part number in Section 2.1.3.
o "slugifiedName" always has the format "n-ttt", where "ttt" is the o "slugifiedName" always has the format "n-ttt", where "ttt" is the
text of the name after slugification. For example, this would be text of the name after slugification. For example, this would be
"n-protocol-overview" for the name "Protocol Overview". The "n-protocol-overview" for the name "Protocol Overview". The
actual conversions done in slugification will be specified at a actual conversions done in slugification will be specified at a
later time. later time.
o Anchors must never overlap with any of the above. The easiest way o Anchors must never overlap with any of the above. The easiest way
skipping to change at page 161, line 15 skipping to change at page 160, line 48
Appendix E. Change Log Appendix E. Change Log
This section is to be removed before publishing as an RFC. This section is to be removed before publishing as an RFC.
The entries for -01 and -02 try to summarize the changes until the The entries for -01 and -02 try to summarize the changes until the
end of 2019; changes that ought to be reviewed are labeled this way: end of 2019; changes that ought to be reviewed are labeled this way:
[[TBRxxx: see ...]]. [[TBRxxx: see ...]].
E.1. Since draft-iab-rfc7991bis-00 E.1. Since draft-iab-rfc7991bis-00
o Allow both "src" attribute and content on <artwork> again o Allow both "src" attribute and content on <artwork> again (#34
(#34 [1], PR50 [2]) [1], PR50 [2])
o Allow <blockquote> in <li> (#35 [3], PR51 [4]) o Allow <blockquote> in <li> (#35 [3], PR51 [4])
o Remove <br> element (#37 [5], PR56 [6], Section 3.1.5 of o Remove <br> element (#37 [5], PR56 [6], Section 3.1.5 of
[IMPNOTES]) [IMPNOTES])
o Replace "hanging" attribute on <dl> by "newline" (#38 [7], o Replace "hanging" attribute on <dl> by "newline" (#38 [7], PR62
PR62 [8], Section 3.1.6 of [IMPNOTES]) [8], Section 3.1.6 of [IMPNOTES])
o Add "indent" attribute to <dl> #39 [9], PR63 [10], Section 3.1.7 o Add "indent" attribute to <dl> #39 [9], PR63 [10], Section 3.1.7
of [IMPNOTES]) of [IMPNOTES])
o Revise <table> and caption alignment (#9 [11] and #40 [12], o Revise <table> and caption alignment (#9 [11] and #40 [12], PR68
PR68 [13], Section 3.1.8 of [IMPNOTES]) [13], Section 3.1.8 of [IMPNOTES])
E.2. Since draft-iab-rfc7991bis-01 E.2. Since draft-iab-rfc7991bis-01
o Extend the list of allowed child elements of <name> (#32 [14] and o Extend the list of allowed child elements of <name> (#32 [14] and
#40 [12], PR69 [15], Section 3.1.11 of [IMPNOTES]) #40 [15], PR69 [16], Section 3.1.11 of [IMPNOTES])
o Allow <references> elements to be nested (#47 [16], PR70 [17], o Allow <references> elements to be nested (#47 [17], PR70 [18],
Section 3.1.6 of [IMPNOTES]) [[TBR135: see <https://github.com/ Section 3.1.6 of [IMPNOTES]) [[TBR135: see <https://github.com/
rfc-format/draft-iab-xml2rfc-v3-bis/issues/135>]] rfc-format/draft-iab-xml2rfc-v3-bis/issues/135>]]
o Added <artset> (#76 [18], PR89 [19], Section 3.1.1 of [IMPNOTES]) o Added <artset> (#76 [19], PR89 [20], Section 3.1.1 of [IMPNOTES])
[[TBR136: see <https://github.com/rfc-format/ [[TBR136: see <https://github.com/rfc-format/draft-iab-xml2rfc-v3-
draft-iab-xml2rfc-v3-bis/issues/136>]] bis/issues/136>]]
o Remove <list> from <aside>, add <table> to <blockquote> (#47 [16], o Remove <list> from <aside>, add <table> to <blockquote> (#47 [21],
PR69 [15], Section 3.1.4 of [IMPNOTES]) PR69 [22], Section 3.1.4 of [IMPNOTES])
o Remove <iref> from <table> (PR92 [20], Section 3.1.9 of o Remove <iref> from <table> (PR92 [23], Section 3.1.9 of
[IMPNOTES]) [[TBR94: see <https://github.com/rfc-format/ [IMPNOTES]) [[TBR94: see <https://github.com/rfc-format/draft-iab-
draft-iab-xml2rfc-v3-bis/issues/94>]] xml2rfc-v3-bis/issues/94>]]
o Add attributes "asciiAbbrev" and "showOnFrontPage" to o Add attributes "asciiAbbrev" and "showOnFrontPage" to
<organization> (PR93 [21], Section 3.1.12 of [IMPNOTES]) <organization> (PR93 [24], Section 3.1.12 of [IMPNOTES])
o Rename "quoteTitle" attribute to "quote-title" (PR95 [22], Section o Rename "quoteTitle" attribute to "quote-title" (PR95 [25],
3.1.14 of [IMPNOTES]) [[TBR48: see <https://github.com/rfc-format/ Section 3.1.14 of [IMPNOTES]) [[TBR48: see <https://github.com/
draft-iab-xml2rfc-v3-bis/issues/48>]] rfc-format/draft-iab-xml2rfc-v3-bis/issues/48>]]
o Add target attribute to <referencegroup> (PR96 [23], Section o Add target attribute to <referencegroup> (PR96 [26],
3.1.15 of [IMPNOTES]) Section 3.1.15 of [IMPNOTES])
o Introduce new child elements of <postal> (PR97 [24], Section o Introduce new child elements of <postal> (PR97 [27],
3.1.13 of [IMPNOTES]) [[TBR137: see <https://github.com/ Section 3.1.13 of [IMPNOTES]) [[TBR137: see <https://github.com/
rfc-format/draft-iab-xml2rfc-v3-bis/issues/137>]] rfc-format/draft-iab-xml2rfc-v3-bis/issues/137>]]
o Undeprecate <seriesInfo> inside <reference>, and remove special o Undeprecate <seriesInfo> inside <reference>, and remove special
cases related to it appearing inside <front> (PR108 [25], Section cases related to it appearing inside <front> (PR108 [28],
3.1.21.3 of [IMPNOTES]) Section 3.1.21.3 of [IMPNOTES])
o State that descendants of unnumbered sections are unnumbered by o State that descendants of unnumbered sections are unnumbered by
default (PR108 [25]) default (PR108 [29])
o Restore original definition of name attribute on <seriesInfo> o Restore original definition of name attribute on <seriesInfo>
(PR108 [25], Section 3.1.21.2 of [IMPNOTES]) (PR108 [30], Section 3.1.21.2 of [IMPNOTES])
o Regenerate Section 3 based on current grammar (#111 [26]) o Regenerate Section 3 based on current grammar (#111 [31])
o Author is now John Levine. o Author is now John Levine.
E.3. Since draft-iab-rfc7991bis-02 E.3. Since draft-iab-rfc7991bis-02
o Update Acknowledgements. o Update Acknowledgements.
E.4. Since draft-iab-rfc7991bis-03 E.4. Since draft-iab-rfc7991bis-03
o Allow multiple <email> elements inside <address> o Allow multiple <email> elements inside <address>
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3- (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
bis/issues/4>) issues/4>)
o Add "markers" attribute to <sourcecode> element o Add "markers" attribute to <sourcecode> element
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3- (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
bis/issues/8>) issues/8>)
o Add missing include directive for SVG grammar (<https:// o Add missing include directive for SVG grammar
github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/11>) (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
issues/11>)
o Remove incorrect text about deprecation of "alt" attribute on o Remove incorrect text about deprecation of "alt" attribute on
<artwork>, add more prose for several other deprecations on this <artwork>, add more prose for several other deprecations on this
element (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ element (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
issues/12>) issues/12>)
o Undeprecate <xref> format "none" (<https://github.com/rfc-format/ o Undeprecate <xref> format "none" (<https://github.com/rfc-format/
draft-iab-xml2rfc-v3-bis/issues/17>) draft-iab-xml2rfc-v3-bis/issues/17>)
o Editorial fixes in Appendix B.1 (<https://github.com/rfc-format/ o Editorial fixes in Appendix B.1 (<https://github.com/rfc-format/
draft-iab-xml2rfc-v3-bis/issues/18>) draft-iab-xml2rfc-v3-bis/issues/18>)
o State that xreffing a hidden <cref> is an error (<https:// o State that xreffing a hidden <cref> is an error
github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/74>) (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
issues/74>)
o Fix prose and default value for <dl> element's "newline" attribute o Fix prose and default value for <dl> element's "newline" attribute
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3- (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/
bis/issues/77>) issues/77>)
o Add <contact> as a block-level element for styling contributor o Add <contact> as a block-level element for styling contributor
information (<https://github.com/rfc-format/ information (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-
draft-iab-xml2rfc-v3-bis/issues/81>) bis/issues/81>)
o Allow <blockquote> inside <aside> (<https://github.com/rfc-format/ o Allow <blockquote> inside <aside> (<https://github.com/rfc-format/
draft-iab-xml2rfc-v3-bis/issues/84>) draft-iab-xml2rfc-v3-bis/issues/84>)
o In <rfc>'s description of the "consensus" attribute, link to o In <rfc>'s description of the "consensus" attribute, link to
Appendix A.4 (<https://github.com/rfc-format/ Appendix A.4 (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-
draft-iab-xml2rfc-v3-bis/issues/88>) bis/issues/88>)
o Undeprecate metadata attributes on <rfc> (<https://github.com/
rfc-format/draft-iab-xml2rfc-v3-bis/issues/122>)
o Add "brackets" attribute on <eref> (<https://github.com/ o Undeprecate metadata attributes on <rfc> (<https://github.com/rfc-
rfc-format/draft-iab-xml2rfc-v3-bis/issues/146>) format/draft-iab-xml2rfc-v3-bis/issues/122>)
E.5. Since draft-iab-rfc7991bis-04 o Add "brackets" attribute on <eref> (<https://github.com/rfc-
format/draft-iab-xml2rfc-v3-bis/issues/146>)
o Add <stream> subelement o Add <stream> subelement
o Add <u> element o Add <u> element
o Add <br> element o Add <br> element
o Add <toc> element o Add <toc> element
o Add <anchor> element to <author> o Add <anchor> element to <author>
skipping to change at page 165, line 7 skipping to change at page 164, line 41
o Update description of prep tool generated attributes. o Update description of prep tool generated attributes.
o Turn quote-title back into quoteTitle o Turn quote-title back into quoteTitle
o Remove deprecated <list> from <t>. o Remove deprecated <list> from <t>.
o Clarify that <artwork> in <artset> must have "type" attribute. o Clarify that <artwork> in <artset> must have "type" attribute.
o Move discussion to rfc-i o Move discussion to rfc-i
Appendix F. IAB Members at the Time of Approval E.5. Since draft-iab-rfc7991bis-04
The IAB members at the time this memo was approved were (in
alphabetical order):
[[ A list will go here just before publication as an RFC ]]
Appendix G. Acknowledgments
Thanks to everybody who reviewed this document and provided feedback
and/or specification text. Thanks especially go to Paul Hoffman for
preparing the original version of this document, to Julian Reschke
for editing [RFC7749] and to those who provided feedback on that
document.
Many of the changes between this document and RFC 7991 came from the
diligent work of Henrik Levkowetz.
We also thank Marshall T. Rose for both the original design and the o add editorial stream
reference implementation of the "xml2rfc" processor.
Index Index
A A
Attributes
abbrev 43, 71
align 16, 34, 65, 67, 70, 91-92
alt 16, 35
anchor 12, 14, 16, 19, 23-24, 26, 29-31, 35, 38, 41, 47-49,
54, 58, 64, 66, 68, 70-73, 75, 91
ascii 25, 32, 44-45, 71, 73, 81-82, 84-85, 90
asciiAbbrev 44
asciiFullname 20, 24
asciiInitials 20, 24
asciiName 56
asciiSurname 20, 24
asciiValue 56
bare 75
blankLines 93
brackets 33
category 50
cite 23
colspan 68, 70
consensus 50
counter 83
day 27
display 26
displayFormat 86
docName 50
empty 75
format 73, 77
fullname 20, 24
group 41
hangIndent 83
hangText 64
height 17, 35
href 39
indent 30, 41, 64, 75
indexInclude 51
initials 20, 24
ipr 51
iprExtract 51
item 36
keepWithNext 64
keepWithPrevious 64
markers 58
month 27
name 17, 56, 58
newline 30
number 51
numbered 55
obsoletes 51
octets 83
pageno 79
prepTime 52
primary 37
quote-title 47
quotedFrom 23
quoteTitle 47
rel 39
relative 79, 89
removeInRFC 41, 55
role 20
rowspan 68, 70
section 79, 89
sectionFormat 79
seriesNo 52
showOnFrontPage 44
sortRefs 52
source 26
spacing 31, 42, 75
src 17, 35, 59
start 42
status 56
stream 57
style 83, 90-91
subitem 37
submissionType 52
suppress-title 35, 92
surname 20, 25
symRefs 52
target 29, 34, 48, 81, 83, 89
title 35, 41, 49, 55, 92
to 29
toc 55
tocDepth 53
tocInclude 53
type 17, 42, 59, 83
updates 53
value 57
version 53
width 18, 35, 93
xml:space 18, 90
year 27
abbrev attribute abbrev attribute
in organization element 44 in organization element 43
in title element 72 in title element 71
abstract element 13, 113 abstract element 12, 113
anchor attribute 13 anchor attribute 12
inside front 37 inside front 36
address element 13, 113 address element 12, 113
inside author 20 inside author 19
inside contact 25 inside contact 24
align attribute align attribute
in artwork element 17 in artwork element 16
in figure element 34
in table element 65
in td element 67
in texttable element 91
in th element 70
in ttcol element 92
alt attribute
in artwork element 16
in figure element 35 in figure element 35
anchor attribute
in abstract element 12
in artset element 14
in artwork element 16
in aside element 19
in author element 19
in blockquote element 23
in contact element 24
in cref element 26
in dd element 29
in dl element 30
in dt element 31
in figure element 35
in li element 38
in ol element 41
in reference element 47
in referencegroup element 48
in references element 49
in section element 54
in sourcecode element 58
in t element 64
in table element 66 in table element 66
in tbody element 66
in td element 68 in td element 68
in texttable element 92 in texttable element 91
in th element 71 in tfoot element 68
in ttcol element 93 in th element 70
alt attribute
in artwork element 17
in figure element 36
anchor attribute
in abstract element 13
in artset element 15
in artwork element 17
in aside element 20
in author element 21
in blockquote element 24
in contact element 25
in cref element 27
in dd element 30
in dl element 31
in dt element 32
in figure element 36
in li element 39
in ol element 42
in reference element 48
in referencegroup element 49
in references element 50
in section element 55
in sourcecode element 59
in t element 65
in table element 67
in tbody element 67
in td element 69
in texttable element 92
in tfoot element 69
in th element 71
in thead element 71 in thead element 71
in tr element 73 in tr element 72
in u element 74 in u element 73
in ul element 76 in ul element 75
annotation element 14, 113 annotation element 13, 113
inside reference 48 inside reference 47
application/rfc+xml Media Type 95 application/rfc+xml Media Type 95
area element 15, 113 area element 14, 113
inside front 37 inside front 36
artset element 15, 113 artset element 14, 113
anchor attribute 15 anchor attribute 14
inside aside 19 inside aside 18
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 27
inside figure 35 inside figure 34
inside li 39 inside li 37
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
artwork element 16, 113 artwork element 15, 113
align attribute 17 align attribute 16
alt attribute 17 alt attribute 16
anchor attribute 17 anchor attribute 16
height attribute 18 height attribute 17
inside artset 15 inside artset 14
inside aside 19 inside aside 18
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside figure 35 inside figure 34
inside li 39 inside li 37
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
name attribute 18 name attribute 17
src attribute 18 src attribute 17
type attribute 18 type attribute 17
width attribute 19 width attribute 18
xml:space attribute 19 xml:space attribute 18
ascii attribute ascii attribute
in city element 82 in city element 81
in cityarea element 83 in cityarea element 82
in code element 83 in code element 82
in country element 26 in country element 25
in email element 33 in email element 32
in extaddr element 83 in extaddr element 82
in organization element 45 in organization element 44
in pobox element 84 in pobox element 84
in postalLine element 46 in postalLine element 45
in region element 86 in region element 85
in sortingcode element 90 in sortingcode element 90
in street element 91 in street element 90
in title element 72 in title element 71
in u element 74 in u element 73
asciiAbbrev attribute asciiAbbrev attribute
in organization element 45 in organization element 44
asciiFullname attribute asciiFullname attribute
in author element 21 in author element 20
in contact element 25 in contact element 24
asciiInitials attribute asciiInitials attribute
in author element 21 in author element 20
in contact element 25 in contact element 24
asciiName attribute asciiName attribute
in seriesInfo element 57 in seriesInfo element 56
asciiSurname attribute asciiSurname attribute
in author element 21 in author element 20
in contact element 25 in contact element 24
asciiValue attribute asciiValue attribute
in seriesInfo element 57 in seriesInfo element 56
aside element 19, 113 aside element 18, 113
anchor attribute 20 anchor attribute 19
inside dd 29 inside dd 28
inside li 39 inside li 37
inside section 55 inside section 54
Attributes author element 19, 113
abbrev 44, 72 anchor attribute 19
align 17, 35, 66, 68, 71, 92-93 asciiFullname attribute 20
alt 17, 36 asciiInitials attribute 20
anchor 13, 15, 17, 20-21, 24-25, 27, 30-32, 36, 39, 42, 48-50, asciiSurname attribute 20
55, 59, 65, 67, 69, 71, 73-74, 76, 92 fullname attribute 20
ascii 26, 33, 45-46, 72, 74, 82-84, 86, 90-91 initials attribute 20
asciiAbbrev 45 inside front 36
asciiFullname 21, 25 inside section 54
asciiInitials 21, 25 role attribute 20
asciiName 57 surname attribute 20
asciiSurname 21, 25
asciiValue 57
bare 76
blankLines 93
brackets 35
category 51
cite 24
colspan 69, 71
consensus 51
counter 84
day 28
display 27
displayFormat 87
docName 51
empty 76
format 74, 78
fullname 21, 25
group 42
hangIndent 84
hangText 65
height 18, 36
href 40
indent 31, 42, 65, 76
indexInclude 52
initials 21, 26
ipr 52
iprExtract 52
item 38
keepWithNext 65
keepWithPrevious 65
markers 59
month 28
name 18, 57, 59
newline 31
number 52
numbered 55
obsoletes 52
octets 84
pageno 80
prepTime 52
primary 38
quote-title 48
quotedFrom 24
quoteTitle 48
rel 40
relative 80, 90
removeInRFC 42, 56
role 21
rowspan 69, 71
section 80, 90
sectionFormat 80
seriesNo 53
showOnFrontPage 45
sortRefs 53
source 27
spacing 32, 43, 76
src 18, 36, 59
start 43
status 57
stream 57
style 84, 90, 92
subitem 38
submissionType 53
suppress-title 36, 92
surname 21, 26
symRefs 53
target 30, 35, 49, 81, 84, 90
title 36, 42, 50, 56, 92
to 31
toc 56
tocDepth 54
tocInclude 54
type 18, 43, 60, 84
updates 54
value 58
version 54
width 19, 36, 93
xml:space 19, 91
year 28
author element 20, 113
anchor attribute 21
asciiFullname attribute 21
asciiInitials attribute 21
asciiSurname attribute 21
fullname attribute 21
initials attribute 21
inside front 37
inside section 55
role attribute 21
surname attribute 21
B B
back element 22, 113 back element 20, 113
inside rfc 51 inside rfc 50
bare attribute bare attribute
in ul element 76 in ul element 75
bcp14 element 22, 113 bcp14 element 21, 113
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 85 inside preamble 85
inside refcontent 47 inside refcontent 46
inside strong 61 inside strong 60
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 72
blankLines attribute blankLines attribute
in vspace element 93 in vspace element 93
blockquote element 22, 113 blockquote element 21, 113
anchor attribute 24 anchor attribute 23
cite attribute 24 cite attribute 23
inside aside 19 inside aside 18
inside dd 29 inside dd 28
inside li 39 inside li 37
inside section 55 inside section 54
quotedFrom attribute 24 quotedFrom attribute 23
boilerplate element 24, 113 boilerplate element 23, 113
inside front 37 inside front 36
br element 24, 113 br element 23, 113
inside blockquote 23 inside blockquote 22
inside cref 26 inside cref 25
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside strong 61 inside strong 60
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside title 72 inside title 71
inside tt 73 inside tt 72
brackets attribute brackets attribute
in eref element 35 in eref element 33
C C
c element 82, 113 c element 81, 113
inside texttable 91 inside texttable 91
category attribute category attribute
in rfc element 51 in rfc element 50
cite attribute cite attribute
in blockquote element 24 in blockquote element 23
city element 82, 113 city element 81, 113
ascii attribute 82 ascii attribute 81
inside postal 46 inside postal 45
cityarea element 82, 113 cityarea element 82, 113
ascii attribute 83 ascii attribute 82
inside postal 46 inside postal 45
code element 83, 113 code element 82, 113
ascii attribute 83 ascii attribute 82
inside postal 46 inside postal 45
colspan attribute colspan attribute
in td element 69 in td element 68
in th element 71 in th element 70
consensus attribute consensus attribute
in rfc element 51 in rfc element 50
contact element 25, 113 contact element 24, 113
anchor attribute 25 anchor attribute 24
asciiFullname attribute 25 asciiFullname attribute 24
asciiInitials attribute 25 asciiInitials attribute 24
asciiSurname attribute 25 asciiSurname attribute 24
fullname attribute 25 fullname attribute 24
initials attribute 26 initials attribute 24
inside section 55 inside section 54
inside t 64 inside t 63
surname attribute 26 surname attribute 25
counter attribute counter attribute
in list element 84 in list element 83
country element 26, 113 country element 25, 113
ascii attribute 26 ascii attribute 25
inside postal 46 inside postal 45
cref element 26, 113 cref element 25, 113
anchor attribute 27 anchor attribute 26
display attribute 27 display attribute 26
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside c 82 inside c 81
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside postamble 85 inside postamble 84
inside preamble 85 inside preamble 85
inside strong 61 inside strong 60
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 72
inside ttcol 93 inside ttcol 92
source attribute 27 source attribute 26
D D
date element 27, 113 date element 26, 113
day attribute 28 day attribute 27
inside front 37 inside front 36
month attribute 28 month attribute 27
year attribute 28 year attribute 27
day attribute day attribute
in date element 28 in date element 27
dd element 28, 113 dd element 27, 113
anchor attribute 30 anchor attribute 29
inside dl 31 inside dl 30
display attribute display attribute
in cref element 27 in cref element 26
displayFormat attribute displayFormat attribute
in relref element 87 in relref element 86
displayreference element 30, 113 displayreference element 29, 113
inside back 22 inside back 21
target attribute 30 target attribute 29
to attribute 31 to attribute 29
dl element 31, 113 dl element 30, 113
anchor attribute 31 anchor attribute 30
indent attribute 31 indent attribute 30
inside abstract 13 inside abstract 12
inside aside 19 inside aside 18
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside li 39 inside li 38
inside note 41 inside note 40
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
newline attribute 31 newline attribute 30
spacing attribute 32 spacing attribute 31
docName attribute docName attribute
in rfc element 51 in rfc element 50
dt element 32, 113 dt element 31, 113
anchor attribute 32 anchor attribute 31
inside dl 31 inside dl 30
E E
Elements Elements
abstract 13, 37 abstract 12, 36
address 13, 20, 25 address 12, 19, 24
annotation 14, 48 annotation 13, 47
area 15, 37 area 14, 36
artset 15, 19, 23, 29, 35, 39, 55, 67, 70 artset 14, 18, 22, 27, 34, 37, 54, 66, 69
artwork 15-16, 19, 23, 29, 35, 39, 55, 67, 70 artwork 14-15, 18, 22, 28, 34, 37, 54, 66, 69
aside 19, 29, 39, 55 aside 18, 28, 37, 54
author 20, 37, 55 author 19, 36, 54
back 22, 51 back 20, 50
bcp14 14, 22-23, 29, 32-33, 39, 41, 47, 61-64, 68, 70, 73, 85 bcp14 13, 21-22, 28, 31-32, 38, 40, 46, 60-63, 67, 69, 72, 85
blockquote 19, 22, 29, 39, 55 blockquote 18, 21, 28, 37, 54
boilerplate 24, 37 boilerplate 23, 36
br 23-24, 26, 29, 32-33, 39, 41, 61, 64, 68, 70, 72-73 br 22-23, 25, 28, 31-32, 38, 40, 60, 63, 67, 69, 71-72
c 82, 91 c 81, 91
city 46, 82 city 45, 81
cityarea 46, 82 cityarea 45, 82
code 46, 83 code 45, 82
contact 25, 55, 64 contact 24, 54, 63
country 26, 46 country 25, 45
cref 14, 23, 26, 29, 32-33, 39, 41, 61-64, 68, 70, 73, 82, 85, cref 13, 22, 25, 28, 31-32, 38, 40, 60-63, 67, 69, 72, 81,
93 84-85, 92
date 27, 37 date 26, 36
dd 28, 31 dd 27, 30
displayreference 22, 30 displayreference 21, 29
dl 13, 19, 23, 29, 31, 39, 41, 55, 67, 70 dl 12, 18, 22, 28, 30, 38, 40, 54, 66, 69
dt 31-32 dt 30-31
em 14, 23, 26, 29, 32-33, 39, 41, 47, 61-64, 68, 70, 73, 78, em 13, 22, 25, 28, 31, 38, 40, 46, 60-63, 67, 69, 72, 77, 85
85 email 13, 32
email 14, 33 eref 13, 22, 25, 28, 31-32, 38, 40, 61-63, 67, 69, 72, 81,
eref 14, 23, 27, 29, 32-34, 39, 41, 61-64, 68, 70, 73, 82, 85, 84-85, 92
93 extaddr 45, 82
extaddr 46, 83 facsimile 13, 82
facsimile 14, 83 figure 18, 22, 28, 34, 38, 54, 66, 69
figure 19, 23, 29, 35, 39, 55, 67, 70 format 47, 83
format 48, 83 front 35, 47, 50
front 36, 48, 50 iref 13, 18, 22, 28, 31-32, 34, 36, 38, 40, 54, 61-63, 65, 67,
iref 14, 20, 23, 29, 32-33, 35, 37, 39, 41, 55, 61-64, 66, 68, 69, 73, 81, 84-85, 92
70, 73, 82, 85, 93 keyword 36-37
keyword 37-38 li 37, 41, 75
li 38, 42, 75 link 38, 50
link 39, 50 list 83
list 84 middle 39, 50
middle 40, 51 name 34, 39-40, 49, 54, 65, 91
name 35, 40-41, 50, 55, 66, 91 note 36, 40
note 37, 41 ol 12, 18, 22, 28, 38, 40-41, 54, 66, 69
ol 13, 20, 23, 29, 39, 41-42, 55, 67, 70 organization 19, 24, 43
organization 20, 25, 44 phone 13, 44
phone 14, 45 pobox 45, 84
pobox 46, 84 postal 13, 44
postal 14, 45 postalLine 45
postalLine 46 postamble 34, 84, 91
postamble 35, 85, 91 preamble 34, 84, 91
preamble 35, 85, 91 refcontent 45, 47
refcontent 46, 48 reference 46, 48-49
reference 47, 49-50 referencegroup 48-49
referencegroup 49-50 references 21, 48-49
references 22, 49-50 region 45, 85
region 46, 86 relref 13, 22, 25, 28, 31-32, 38, 40, 61-63, 67, 69, 73, 85
relref 14, 23, 27, 30, 32-33, 39, 41, 62-64, 68, 70, 73, 86 rfc 49
rfc 50 section 21, 23, 39, 53-54, 71
section 22, 24, 40, 54-55, 72 seriesInfo 36, 47, 56
seriesInfo 37, 48, 57 sortingcode 45, 89
sortingcode 46, 90 sourcecode 22, 28, 34, 38, 54, 57, 66, 69
sourcecode 23, 29, 35, 39, 55, 58, 67, 70 spanx 13, 63, 81, 84-85, 90
spanx 14, 64, 82, 85-86, 90 stream 46, 60
stream 48, 61 street 45, 90
street 46, 91 strong 13, 22, 25, 28, 31-32, 38, 40, 46, 60, 62-63, 67, 69,
strong 14, 23, 27, 30, 32-33, 39, 41, 47, 61-64, 68, 70, 73, 73, 77, 85
78, 86 sub 13, 22, 26, 28, 31-32, 38, 40, 46, 61-63, 67, 69, 73, 77,
sub 14, 23, 27, 30, 32-33, 39, 41, 47, 62-64, 68, 70, 73, 78, 85
86 sup 13, 22, 26, 29, 31-32, 38, 40, 46, 61-63, 67, 70, 73, 77,
sup 14, 24, 27, 30, 32-33, 39, 41, 47, 62-64, 68, 70, 74, 78, 85
86 svg 16
svg 17 t 12, 19, 22, 28, 38, 40, 54, 63, 66, 69, 83
t 13, 20, 23, 29, 39, 41, 55, 64, 67, 70, 84 table 19, 28, 38, 54, 65
table 20, 29, 39, 55, 66 tbody 65-66
tbody 66-67 td 66, 72
td 67, 73 texttable 54, 90
texttable 55, 91 tfoot 65, 68
tfoot 66, 69 th 68, 72
th 69, 73 thead 65, 70
thead 66, 71 title 36, 71
title 37, 72 toc 36, 71
toc 37, 72 tr 66, 68, 71-72
tr 67, 69, 71-72 tt 13, 22, 26, 29, 31-32, 38, 40, 46, 61-63, 67, 70, 72, 77,
tt 14, 24, 27, 30, 32-33, 39, 41, 47, 62-64, 68, 70, 73, 78, 85
86
ttcol 91-92 ttcol 91-92
u 15, 24, 30, 39, 64, 68, 70, 74, 86 u 14, 23, 29, 38, 64, 67, 70, 73, 85
ul 13, 20, 23, 29, 39, 41, 55, 67, 70, 75 ul 12, 19, 22, 28, 38, 40, 54, 67, 69, 74
uri 14, 77 uri 13, 76
vspace 64, 93 vspace 64, 93
workgroup 37, 77 workgroup 36, 76
xref 15, 24, 27, 30, 32-33, 39, 41, 62-65, 68, 71, 74, 77, 82, xref 14, 23, 26, 29, 31-32, 38, 40, 61-64, 67, 70, 73, 76, 81,
85-86, 93 84-85, 92
em element 33, 113 em element 31, 113
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside cref 26 inside cref 25
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 85 inside preamble 85
inside refcontent 47 inside refcontent 46
inside strong 61 inside strong 60
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 72
inside xref 78 inside xref 77
email element 33, 113
ascii attribute 33 email element 32, 113
inside address 14 ascii attribute 32
inside address 13
empty attribute empty attribute
in ul element 76 in ul element 75
eref element 34, 113 eref element 32, 113
brackets attribute 35 brackets attribute 33
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside c 82 inside c 81
inside cref 27 inside cref 25
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside postamble 85 inside postamble 84
inside preamble 85 inside preamble 85
inside strong 61 inside strong 61
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 72
inside ttcol 93 inside ttcol 92
target attribute 35 target attribute 34
extaddr element 83, 113 extaddr element 82, 113
ascii attribute 83 ascii attribute 82
inside postal 46 inside postal 45
F F
facsimile element 83, 113 facsimile element 82, 113
inside address 14 inside address 13
figure element 35, 113 figure element 34, 113
align attribute 35 align attribute 34
alt attribute 36 alt attribute 35
anchor attribute 36 anchor attribute 35
height attribute 36 height attribute 35
inside aside 19 inside aside 18
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside li 39 inside li 38
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
src attribute 36 src attribute 35
suppress-title attribute 36 suppress-title attribute 35
title attribute 36 title attribute 35
width attribute 36 width attribute 35
format attribute format attribute
in u element 74 in u element 73
in xref element 78 in xref element 77
format element 83, 113 format element 83, 113
inside reference 48 inside reference 47
octets attribute 84 octets attribute 83
target attribute 84 target attribute 83
type attribute 84 type attribute 83
front element 36, 113 front element 35, 113
inside reference 48 inside reference 47
inside rfc 50 inside rfc 50
fullname attribute fullname attribute
in author element 21 in author element 20
in contact element 25 in contact element 24
G G
group attribute group attribute
in ol element 42 in ol element 41
H H
hangIndent attribute hangIndent attribute
in list element 84 in list element 83
hangText attribute hangText attribute
in t element 65 in t element 64
height attribute height attribute
in artwork element 18 in artwork element 17
in figure element 36 in figure element 35
href attribute href attribute
in link element 40 in link element 39
I I
indent attribute indent attribute
in dl element 31 in dl element 30
in ol element 42 in ol element 41
in t element 65 in t element 64
in ul element 76 in ul element 75
indexInclude attribute indexInclude attribute
in rfc element 52 in rfc element 51
initials attribute initials attribute
in author element 21 in author element 20
in contact element 26 in contact element 24
ipr attribute ipr attribute
"*2026" 106 "*2026" 106
"*3667" 106 "*3667" 105
"*3978" 106 "*3978" 105
"*trust200811" 105 "*trust200811" 105
"*trust200902" 104 "*trust200902" 103
"noDerivativesTrust200902" 105 "noDerivativesTrust200902" 104
"noModificationTrust200902" 104 "noModificationTrust200902" 104
"pre5378Trust200902" 105 "pre5378Trust200902" 105
"trust200902" 104 "trust200902" 104
in rfc element 52 in rfc element 51
iprExtract attribute iprExtract attribute
in rfc element 52 in rfc element 51
iref element 37, 113 iref element 36, 113
inside annotation 14 inside annotation 13
inside aside 20 inside aside 18
inside blockquote 23 inside blockquote 22
inside c 82 inside c 81
inside dd 29 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside figure 35 inside figure 34
inside li 39 inside li 38
inside name 41 inside name 40
inside postamble 85 inside postamble 84
inside preamble 85 inside preamble 85
inside section 55 inside section 54
inside strong 61 inside strong 61
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside table 66 inside table 65
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 73
inside ttcol 93 inside ttcol 92
item attribute 38 item attribute 36
primary attribute 38 primary attribute 37
subitem attribute 38 subitem attribute 37
item attribute item attribute
in iref element 38 in iref element 36
K K
keepWithNext attribute keepWithNext attribute
in t element 65 in t element 64
keepWithPrevious attribute keepWithPrevious attribute
in t element 65 in t element 64
keyword element 38, 113 keyword element 37, 113
inside front 37 inside front 36
L L
li element 38, 113 li element 37, 113
anchor attribute 39 anchor attribute 38
inside ol 42 inside ol 41
inside ul 75 inside ul 75
link element 39, 113 link element 38, 113
href attribute 40 href attribute 39
inside rfc 50 inside rfc 50
rel attribute 40 rel attribute 39
list element 84, 113 list element 83, 113
counter attribute 84 counter attribute 83
hangIndent attribute 84 hangIndent attribute 83
style attribute 84 style attribute 83
M M
markers attribute
in sourcecode element 59
Media Type Media Type
application/rfc+xml 95 application/rfc+xml 95
middle element 40, 113 markers attribute
inside rfc 51 in sourcecode element 58
middle element 39, 113
inside rfc 50
month attribute month attribute
in date element 28 in date element 27
N N
name attribute name attribute
in artwork element 18 in artwork element 17
in seriesInfo element 57 in seriesInfo element 56
in sourcecode element 59 in sourcecode element 58
name element 40, 113 name element 39, 113
inside figure 35 inside figure 34
inside note 41 inside note 40
inside references 50 inside references 49
inside section 55 inside section 54
inside table 66 inside table 65
inside texttable 91 inside texttable 91
newline attribute newline attribute
in dl element 31 in dl element 30
note element 41, 113 note element 40, 113
inside front 37 inside front 36
removeInRFC attribute 42 removeInRFC attribute 41
title attribute 42 title attribute 41
number attribute number attribute
in rfc element 52 in rfc element 51
numbered attribute numbered attribute
in section element 55 in section element 55
O O
obsoletes attribute obsoletes attribute
in rfc element 52 in rfc element 51
octets attribute octets attribute
in format element 84 in format element 83
ol element 42, 113 ol element 41, 113
anchor attribute 42 anchor attribute 41
group attribute 42 group attribute 41
indent attribute 42 indent attribute 41
inside abstract 13 inside abstract 12
inside aside 20 inside aside 18
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside li 39 inside li 38
inside note 41 inside note 40
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
spacing attribute 43 spacing attribute 42
start attribute 43 start attribute 42
type attribute 43 type attribute 42
organization element 43, 113
organization element 44, 113 abbrev attribute 43
abbrev attribute 44 ascii attribute 44
ascii attribute 45 asciiAbbrev attribute 44
asciiAbbrev attribute 45 inside author 19
inside author 20 inside contact 24
inside contact 25 showOnFrontPage attribute 44
showOnFrontPage attribute 45
P P
pageno attribute pageno attribute
in xref element 80 in xref element 79
phone element 45, 113 phone element 44, 113
inside address 14 inside address 13
pobox element 84, 113 pobox element 84, 113
ascii attribute 84 ascii attribute 84
inside postal 46 inside postal 45
postal element 45, 113 postal element 44, 113
inside address 14 inside address 13
postalLine element 46, 113 postalLine element 45, 113
ascii attribute 46 ascii attribute 45
inside postal 46 inside postal 45
postamble element 85, 113 postamble element 84, 113
inside figure 35 inside figure 34
inside texttable 91 inside texttable 91
preamble element 85, 113 preamble element 84, 113
inside figure 35 inside figure 34
inside texttable 91 inside texttable 91
prepTime attribute prepTime attribute
in rfc element 52 in rfc element 52
primary attribute primary attribute
in iref element 38 in iref element 37
Q Q
quote-title attribute quote-title attribute
in reference element 48 in reference element 47
quotedFrom attribute
in blockquote element 24
quoteTitle attribute quoteTitle attribute
in reference element 48 in reference element 47
quotedFrom attribute
in blockquote element 23
R R
refcontent element 46, 113 refcontent element 45, 113
inside reference 48 inside reference 47
reference element 47, 113 reference element 46, 113
anchor attribute 47
inside referencegroup 48
inside references 49
quote-title attribute 47
quoteTitle attribute 47
target attribute 48
referencegroup element 48, 113
anchor attribute 48 anchor attribute 48
inside referencegroup 49 inside references 49
inside references 50 target attribute 48
quote-title attribute 48 references element 48, 113
quoteTitle attribute 48
target attribute 49
referencegroup element 49, 113
anchor attribute 49 anchor attribute 49
inside references 50 inside back 21
target attribute 49 inside references 49
references element 49, 113 title attribute 49
anchor attribute 50 region element 85, 113
inside back 22 ascii attribute 85
inside references 50 inside postal 45
title attribute 50
region element 86, 113
ascii attribute 86
inside postal 46
rel attribute rel attribute
in link element 40 in link element 39
relative attribute relative attribute
in relref element 90 in relref element 89
in xref element 80 in xref element 79
relref element 86, 113 relref element 85, 113
displayFormat attribute 87 displayFormat attribute 86
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside cref 27 inside cref 25
inside dd 30 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 86 inside preamble 85
inside strong 62 inside strong 61
inside sub 62 inside sub 61
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 73
relative attribute 90 relative attribute 89
section attribute 90 section attribute 89
target attribute 90 target attribute 89
removeInRFC attribute removeInRFC attribute
in note element 42 in note element 41
in section element 56 in section element 55
rfc element 50, 113 rfc element 49, 113
category attribute 51 category attribute 50
consensus attribute 51 consensus attribute 50
docName attribute 51 docName attribute 50
indexInclude attribute 52 indexInclude attribute 51
ipr attribute 52 ipr attribute 51
iprExtract attribute 52 iprExtract attribute 51
number attribute 52 number attribute 51
obsoletes attribute 52 obsoletes attribute 51
prepTime attribute 52 prepTime attribute 52
seriesNo attribute 53 seriesNo attribute 52
sortRefs attribute 53 sortRefs attribute 52
submissionType attribute 53 submissionType attribute 52
symRefs attribute 53 symRefs attribute 52
tocDepth attribute 54 tocDepth attribute 53
tocInclude attribute 54 tocInclude attribute 53
updates attribute 54 updates attribute 53
version attribute 54 version attribute 53
role attribute role attribute
in author element 21 in author element 20
rowspan attribute rowspan attribute
in td element 69 in td element 68
in th element 71 in th element 70
S S
section attribute section attribute
in relref element 90 in relref element 89
in xref element 80 in xref element 79
section element 54, 113 section element 53, 113
anchor attribute 55 anchor attribute 54
inside back 22 inside back 21
inside boilerplate 24 inside boilerplate 23
inside middle 40 inside middle 39
inside section 55 inside section 54
inside toc 72 inside toc 71
numbered attribute 55 numbered attribute 55
removeInRFC attribute 56 removeInRFC attribute 55
title attribute 56 title attribute 55
toc attribute 56 toc attribute 55
sectionFormat attribute sectionFormat attribute
in xref element 80 in xref element 79
seriesInfo element 57, 113 seriesInfo element 56, 113
asciiName attribute 57 asciiName attribute 56
asciiValue attribute 57 asciiValue attribute 56
inside front 37 inside front 36
inside reference 48 inside reference 47
name attribute 57 name attribute 56
status attribute 57 status attribute 56
stream attribute 57 stream attribute 57
value attribute 58 value attribute 57
seriesNo attribute seriesNo attribute
in rfc element 53 in rfc element 52
showOnFrontPage attribute showOnFrontPage attribute
in organization element 45 in organization element 44
sortingcode element 90, 113
ascii attribute 90
inside postal 46
sortRefs attribute sortRefs attribute
in rfc element 53 in rfc element 52
sortingcode element 89, 113
ascii attribute 90
inside postal 45
source attribute source attribute
in cref element 27 in cref element 26
sourcecode element 58, 113 sourcecode element 57, 113
anchor attribute 59 anchor attribute 58
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside figure 35 inside figure 34
inside li 39 inside li 38
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
markers attribute 59 markers attribute 58
name attribute 59 name attribute 58
src attribute 59 src attribute 59
type attribute 60 type attribute 59
spacing attribute spacing attribute
in dl element 32 in dl element 31
in ol element 43 in ol element 42
in ul element 76 in ul element 75
spanx element 90, 113 spanx element 90, 113
inside annotation 14 inside annotation 13
inside c 82 inside c 81
inside postamble 85 inside postamble 84
inside preamble 86 inside preamble 85
inside t 64 inside t 63
style attribute 90 style attribute 90
xml:space attribute 91 xml:space attribute 90
src attribute src attribute
in artwork element 18 in artwork element 17
in figure element 36 in figure element 35
in sourcecode element 59 in sourcecode element 59
start attribute start attribute
in ol element 43 in ol element 42
status attribute status attribute
in seriesInfo element 57 in seriesInfo element 56
stream attribute stream attribute
in seriesInfo element 57 in seriesInfo element 57
stream element 61, 113 stream element 60, 113
inside reference 48 inside reference 46
street element 91, 113 street element 90, 113
ascii attribute 91 ascii attribute 90
inside postal 46 inside postal 45
strong element 60, 113
strong element 61, 113 inside annotation 13
inside annotation 14 inside blockquote 22
inside blockquote 23 inside cref 25
inside cref 27 inside dd 28
inside dd 30 inside dt 31
inside dt 32 inside em 32
inside em 33 inside li 38
inside li 39 inside name 40
inside name 41 inside preamble 85
inside preamble 86 inside refcontent 46
inside refcontent 47
inside sub 62 inside sub 62
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 73
inside xref 78 inside xref 77
style attribute style attribute
in list element 84 in list element 83
in spanx element 90 in spanx element 90
in texttable element 92 in texttable element 91
sub element 62, 113 sub element 61, 113
inside annotation 14 inside annotation 13
inside blockquote 23 inside blockquote 22
inside cref 27 inside cref 26
inside dd 30 inside dd 28
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 86 inside preamble 85
inside refcontent 47 inside refcontent 46
inside strong 62 inside strong 61
inside sub 62 inside sub 62
inside sup 63 inside sup 62
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 69
inside tt 73 inside tt 73
inside xref 78 inside xref 77
subitem attribute subitem attribute
in iref element 38 in iref element 37
submissionType attribute submissionType attribute
in rfc element 53 in rfc element 52
sup element 63, 113 sup element 62, 113
inside annotation 14 inside annotation 13
inside blockquote 24 inside blockquote 22
inside cref 27 inside cref 26
inside dd 30 inside dd 29
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 86 inside preamble 85
inside refcontent 47 inside refcontent 46
inside strong 62 inside strong 61
inside sub 63 inside sub 62
inside sup 63 inside sup 63
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 70
inside tt 74 inside tt 73
inside xref 78 inside xref 77
suppress-title attribute suppress-title attribute
in figure element 36 in figure element 35
in texttable element 92 in texttable element 92
surname attribute surname attribute
in author element 21 in author element 20
in contact element 26 in contact element 25
svg element svg element
inside artwork 17 inside artwork 16
symRefs attribute symRefs attribute
in rfc element 53 in rfc element 52
T T
t element 64, 113 t element 63, 113
anchor attribute 65 anchor attribute 64
hangText attribute 65 hangText attribute 64
indent attribute 65 indent attribute 64
inside abstract 13 inside abstract 12
inside aside 20 inside aside 19
inside blockquote 23 inside blockquote 22
inside dd 29 inside dd 28
inside li 39 inside li 38
inside list 84 inside list 83
inside note 41 inside note 40
inside section 55 inside section 54
inside td 67 inside td 66
inside th 70 inside th 69
keepWithNext attribute 65 keepWithNext attribute 64
keepWithPrevious attribute 65 keepWithPrevious attribute 64
table element 66, 113 table element 65, 113
align attribute 66 align attribute 65
anchor attribute 67 anchor attribute 66
inside aside 20 inside aside 19
inside dd 29 inside dd 28
inside li 39 inside li 38
inside section 55 inside section 54
target attribute target attribute
in displayreference element 30 in displayreference element 29
in eref element 35 in eref element 34
in format element 84 in format element 83
in reference element 49 in reference element 48
in referencegroup element 49 in referencegroup element 48
in relref element 90 in relref element 89
in xref element 81 in xref element 81
tbody element 67, 113 tbody element 66, 113
anchor attribute 67 anchor attribute 66
inside table 66 inside table 65
td element 67, 113 td element 66, 113
align attribute 68 align attribute 67
anchor attribute 69 anchor attribute 68
colspan attribute 69 colspan attribute 68
inside tr 73 inside tr 72
rowspan attribute 69 rowspan attribute 68
texttable element 91, 113 texttable element 90, 113
align attribute 92 align attribute 91
anchor attribute 92 anchor attribute 91
inside section 55 inside section 54
style attribute 92 style attribute 91
suppress-title attribute 92 suppress-title attribute 92
title attribute 92 title attribute 92
tfoot element 69, 113 tfoot element 68, 113
anchor attribute 69 anchor attribute 68
inside table 66 inside table 65
th element 69, 113 th element 68, 113
align attribute 71 align attribute 70
anchor attribute 71 anchor attribute 70
colspan attribute 71 colspan attribute 70
inside tr 73 inside tr 72
rowspan attribute 71 rowspan attribute 70
thead element 71, 113 thead element 70, 113
anchor attribute 71 anchor attribute 71
inside table 66 inside table 65
title attribute title attribute
in figure element 36 in figure element 35
in note element 42 in note element 41
in references element 50 in references element 49
in section element 56 in section element 55
in texttable element 92 in texttable element 92
title element 72, 113 title element 71, 113
abbrev attribute 72 abbrev attribute 71
ascii attribute 72 ascii attribute 71
inside front 37 inside front 36
to attribute to attribute
in displayreference element 31 in displayreference element 29
toc attribute toc attribute
in section element 56 in section element 55
toc element 72, 113 toc element 71, 113
inside front 37 inside front 36
tocDepth attribute tocDepth attribute
in rfc element 54 in rfc element 53
tocInclude attribute tocInclude attribute
in rfc element 54 in rfc element 53
tr element 72, 113 tr element 72, 113
anchor attribute 73 anchor attribute 72
inside tbody 67 inside tbody 66
inside tfoot 69 inside tfoot 68
inside thead 71 inside thead 71
tt element 73, 113 tt element 72, 113
inside annotation 14 inside annotation 13
inside blockquote 24 inside blockquote 22
inside cref 27 inside cref 26
inside dd 30 inside dd 29
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside preamble 86 inside preamble 85
inside refcontent 47 inside refcontent 46
inside strong 62 inside strong 61
inside sub 63 inside sub 62
inside sup 63 inside sup 63
inside t 64 inside t 63
inside td 68 inside td 67
inside th 70 inside th 70
inside xref 78 inside xref 77
ttcol element 92, 113 ttcol element 92, 113
align attribute 93 align attribute 92
inside texttable 91 inside texttable 91
width attribute 93 width attribute 93
type attribute type attribute
in artwork element 18 in artwork element 17
in format element 84 in format element 83
in ol element 43 in ol element 42
in sourcecode element 60 in sourcecode element 59
U U
u element 74, 113 u element 73, 113
anchor attribute 74 anchor attribute 73
ascii attribute 74 ascii attribute 73
format attribute 74 format attribute 73
inside annotation 15 inside annotation 14
inside blockquote 24
inside dd 30
inside li 39
inside preamble 86
inside t 64
inside td 68
inside th 70
ul element 75, 113
anchor attribute 76
bare attribute 76
empty attribute 76
indent attribute 76
inside abstract 13
inside aside 20
inside blockquote 23 inside blockquote 23
inside dd 29 inside dd 29
inside li 39 inside li 38
inside note 41 inside preamble 85
inside section 55 inside t 64
inside td 67 inside td 67
inside th 70 inside th 70
spacing attribute 76 ul element 74, 113
anchor attribute 75
bare attribute 75
empty attribute 75
indent attribute 75
inside abstract 12
inside aside 19
inside blockquote 22
inside dd 28
inside li 38
inside note 40
inside section 54
inside td 67
inside th 69
spacing attribute 75
updates attribute updates attribute
in rfc element 54 in rfc element 53
uri element 77, 113 uri element 76, 113
inside address 14 inside address 13
V V
value attribute value attribute
in seriesInfo element 58 in seriesInfo element 57
version attribute version attribute
in rfc element 54 in rfc element 53
vspace element 93, 113 vspace element 93, 113
blankLines attribute 93 blankLines attribute 93
inside t 64 inside t 64
W W
width attribute width attribute
in artwork element 19 in artwork element 18
in figure element 36 in figure element 35
in ttcol element 93 in ttcol element 93
workgroup element 77, 113 workgroup element 76, 113
inside front 37 inside front 36
X X
xml:space attribute xml:space attribute
in artwork element 19 in artwork element 18
in spanx element 91 in spanx element 90
xref element 77, 113 xref element 76, 113
format attribute 78 format attribute 77
inside annotation 15 inside annotation 14
inside blockquote 24 inside blockquote 23
inside c 82 inside c 81
inside cref 27 inside cref 26
inside dd 30 inside dd 29
inside dt 32 inside dt 31
inside em 33 inside em 32
inside li 39 inside li 38
inside name 41 inside name 40
inside postamble 85 inside postamble 84
inside preamble 86 inside preamble 85
inside strong 62 inside strong 61
inside sub 63 inside sub 62
inside sup 64 inside sup 63
inside t 65 inside t 64
inside td 68 inside td 67
inside th 71 inside th 70
inside tt 74 inside tt 73
inside ttcol 93 inside ttcol 92
pageno attribute 80 pageno attribute 79
relative attribute 80 relative attribute 79
section attribute 80 section attribute 79
sectionFormat attribute 80 sectionFormat attribute 79
target attribute 81 target attribute 81
xref formats xref formats
counter 78 counter 77
default 78 default 78
none 79 none 78
title 79 title 78
Y Y
year attribute year attribute
in date element 28 in date element 27
IAB Members at the Time of Approval
The IAB members at the time this memo was approved were (in
alphabetical order):
[[ A list will go here just before publication as an RFC ]]
Acknowledgments
Thanks to everybody who reviewed this document and provided feedback
and/or specification text. Thanks especially go to Paul Hoffman for
preparing the original version of this document, to Julian Reschke
for editing [RFC7749] and to those who provided feedback on that
document.
Many of the changes between this document and RFC 7991 came from the
diligent work of Henrik Levkowetz.
We also thank Marshall T. Rose for both the original design and the
reference implementation of the "xml2rfc" processor.
Author's Address Author's Address
John Levine (editor) John Levine (editor)
Temporary RFC Series Project Manager Temporary RFC Series Project Manager
EMail: rse@rfc-editor.org EMail: rse@rfc-editor.org
 End of changes. 311 change blocks. 
1452 lines changed or deleted 1440 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/