draft-iab-rfc7991bis-03.txt | draft-iab-rfc7991bis-latest.txt | |||
---|---|---|---|---|
Network Working Group J. Levine, Ed. | Network Working Group J. Levine, Ed. | |||
Internet-Draft Temporary RFC Series Project Manager | Internet-Draft Temporary RFC Series Project Manager | |||
Obsoletes: 7991 (if approved) March 9, 2020 | Obsoletes: 7991 (if approved) February 23, 2021 | |||
Intended status: Informational | Intended status: Informational | |||
Expires: September 10, 2020 | Expires: August 27, 2021 | |||
The "xml2rfc" version 3 Vocabulary | The "xml2rfc" version 3 Vocabulary | |||
draft-iab-rfc7991bis-03 | draft-iab-rfc7991bis-03 | |||
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 (To be removed by RFC Editor) | Editorial Note | |||
This note is to be removed before publishing as an RFC. | ||||
Discussion of this draft takes place on the xml2rfc-dev@ietf.org | Discussion of this draft takes place on the xml2rfc-dev@ietf.org | |||
mailing list, which has its home page at | mailing list, which has its home page at | |||
<https://www.ietf.org/mailman/listinfo/xml2rfc-dev>. | <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>. | |||
Source code and issues list for this draft can be found at | ||||
<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis>. | ||||
The changes in this draft are summarized in Appendix E.4. | ||||
Status of This Memo | Status of This Memo | |||
This Internet-Draft is submitted in full conformance with the | This Internet-Draft is submitted in full conformance with the | |||
provisions of BCP 78 and BCP 79. | provisions of BCP 78 and BCP 79. | |||
Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
Drafts is at https://datatracker.ietf.org/drafts/current/. | Drafts is at https://datatracker.ietf.org/drafts/current/. | |||
Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
This Internet-Draft will expire on September 10, 2020. | This Internet-Draft will expire on August 27, 2021. | |||
Copyright Notice | Copyright Notice | |||
Copyright (c) 2020 IETF Trust and the persons identified as the | Copyright (c) 2021 IETF Trust and the persons identified as the | |||
document authors. All rights reserved. | document authors. All rights reserved. | |||
This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
Provisions Relating to IETF Documents | Provisions Relating to IETF Documents | |||
(https://trustee.ietf.org/license-info) in effect on the date of | (https://trustee.ietf.org/license-info) in effect on the date of | |||
publication of this document. Please review these documents | publication of this document. Please review these documents | |||
carefully, as they describe your rights and restrictions with respect | carefully, as they describe your rights and restrictions with respect | |||
to this document. | to this document. | |||
Table of Contents | Table of Contents | |||
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 4 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
1.1. Expected Updates to the Specification . . . . . . . . . . 5 | 1.1. Expected Updates to the Specification . . . . . . . . . . 5 | |||
1.2. Design Criteria for the Changes in v3 . . . . . . . . . . 5 | 1.2. Design Criteria for the Changes in v3 . . . . . . . . . . 5 | |||
1.3. Differences from RFC 7991 in This Document . . . . . . . 6 | 1.3. Differences from RFC 7991 in This Document . . . . . . . 6 | |||
1.4. Differences from v2 to v3 . . . . . . . . . . . . . . . . 6 | 1.4. Differences from v2 to v3 . . . . . . . . . . . . . . . . 7 | |||
1.4.1. New Elements in v3 . . . . . . . . . . . . . . . . . 6 | 1.4.1. New Elements in v3 . . . . . . . . . . . . . . . . . 7 | |||
1.4.2. New Attributes for Existing Elements . . . . . . . . 7 | 1.4.2. New Attributes for Existing Elements . . . . . . . . 8 | |||
1.4.3. Elements and Attributes Deprecated from v2 . . . . . 8 | 1.4.3. Elements and Attributes Deprecated from v2 . . . . . 9 | |||
1.4.4. Additional Changes from v2 . . . . . . . . . . . . . 9 | 1.4.4. Additional Changes from v2 . . . . . . . . . . . . . 10 | |||
1.5. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 10 | 1.5. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 11 | |||
2. Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | 2. Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 11 | |||
2.1. <abstract> . . . . . . . . . . . . . . . . . . . . . . . 11 | 2.1. <abstract> . . . . . . . . . . . . . . . . . . . . . . . 11 | |||
2.2. <address> . . . . . . . . . . . . . . . . . . . . . . . . 11 | 2.2. <address> . . . . . . . . . . . . . . . . . . . . . . . . 12 | |||
2.3. <annotation> . . . . . . . . . . . . . . . . . . . . . . 12 | 2.3. <annotation> . . . . . . . . . . . . . . . . . . . . . . 12 | |||
2.4. <area> . . . . . . . . . . . . . . . . . . . . . . . . . 13 | 2.4. <area> . . . . . . . . . . . . . . . . . . . . . . . . . 13 | |||
2.5. <artset> . . . . . . . . . . . . . . . . . . . . . . . . 13 | 2.5. <artset> . . . . . . . . . . . . . . . . . . . . . . . . 14 | |||
2.6. <artwork> . . . . . . . . . . . . . . . . . . . . . . . . 14 | 2.6. <artwork> . . . . . . . . . . . . . . . . . . . . . . . . 14 | |||
2.7. <aside> . . . . . . . . . . . . . . . . . . . . . . . . . 17 | 2.7. <aside> . . . . . . . . . . . . . . . . . . . . . . . . . 18 | |||
2.8. <author> . . . . . . . . . . . . . . . . . . . . . . . . 18 | 2.8. <author> . . . . . . . . . . . . . . . . . . . . . . . . 18 | |||
2.9. <back> . . . . . . . . . . . . . . . . . . . . . . . . . 19 | 2.9. <back> . . . . . . . . . . . . . . . . . . . . . . . . . 20 | |||
2.10. <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . . 20 | 2.10. <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . . 20 | |||
2.11. <blockquote> . . . . . . . . . . . . . . . . . . . . . . 20 | 2.11. <blockquote> . . . . . . . . . . . . . . . . . . . . . . 21 | |||
2.12. <boilerplate> . . . . . . . . . . . . . . . . . . . . . . 22 | 2.12. <boilerplate> . . . . . . . . . . . . . . . . . . . . . . 23 | |||
2.13. <city> . . . . . . . . . . . . . . . . . . . . . . . . . 22 | 2.13. <city> . . . . . . . . . . . . . . . . . . . . . . . . . 23 | |||
2.14. <cityarea> . . . . . . . . . . . . . . . . . . . . . . . 22 | 2.14. <cityarea> . . . . . . . . . . . . . . . . . . . . . . . 23 | |||
2.15. <code> . . . . . . . . . . . . . . . . . . . . . . . . . 23 | 2.15. <code> . . . . . . . . . . . . . . . . . . . . . . . . . 23 | |||
2.16. <country> . . . . . . . . . . . . . . . . . . . . . . . . 23 | 2.16. <contact> . . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
2.17. <cref> . . . . . . . . . . . . . . . . . . . . . . . . . 23 | 2.17. <country> . . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
2.18. <date> . . . . . . . . . . . . . . . . . . . . . . . . . 24 | 2.18. <cref> . . . . . . . . . . . . . . . . . . . . . . . . . 25 | |||
2.19. <dd> . . . . . . . . . . . . . . . . . . . . . . . . . . 25 | 2.19. <date> . . . . . . . . . . . . . . . . . . . . . . . . . 26 | |||
2.20. <displayreference> . . . . . . . . . . . . . . . . . . . 27 | 2.20. <dd> . . . . . . . . . . . . . . . . . . . . . . . . . . 27 | |||
2.21. <dl> . . . . . . . . . . . . . . . . . . . . . . . . . . 28 | 2.21. <displayreference> . . . . . . . . . . . . . . . . . . . 29 | |||
2.22. <dt> . . . . . . . . . . . . . . . . . . . . . . . . . . 29 | 2.22. <dl> . . . . . . . . . . . . . . . . . . . . . . . . . . 29 | |||
2.23. <em> . . . . . . . . . . . . . . . . . . . . . . . . . . 30 | 2.23. <dt> . . . . . . . . . . . . . . . . . . . . . . . . . . 31 | |||
2.24. <email> . . . . . . . . . . . . . . . . . . . . . . . . . 31 | 2.24. <em> . . . . . . . . . . . . . . . . . . . . . . . . . . 31 | |||
2.25. <eref> . . . . . . . . . . . . . . . . . . . . . . . . . 31 | 2.25. <email> . . . . . . . . . . . . . . . . . . . . . . . . . 32 | |||
2.26. <extaddr> . . . . . . . . . . . . . . . . . . . . . . . . 32 | 2.26. <eref> . . . . . . . . . . . . . . . . . . . . . . . . . 33 | |||
2.27. <figure> . . . . . . . . . . . . . . . . . . . . . . . . 32 | 2.27. <extaddr> . . . . . . . . . . . . . . . . . . . . . . . . 34 | |||
2.28. <front> . . . . . . . . . . . . . . . . . . . . . . . . . 34 | 2.28. <figure> . . . . . . . . . . . . . . . . . . . . . . . . 34 | |||
2.29. <iref> . . . . . . . . . . . . . . . . . . . . . . . . . 35 | 2.29. <front> . . . . . . . . . . . . . . . . . . . . . . . . . 36 | |||
2.30. <keyword> . . . . . . . . . . . . . . . . . . . . . . . . 36 | 2.30. <iref> . . . . . . . . . . . . . . . . . . . . . . . . . 37 | |||
2.31. <li> . . . . . . . . . . . . . . . . . . . . . . . . . . 36 | 2.31. <keyword> . . . . . . . . . . . . . . . . . . . . . . . . 38 | |||
2.32. <link> . . . . . . . . . . . . . . . . . . . . . . . . . 38 | 2.32. <li> . . . . . . . . . . . . . . . . . . . . . . . . . . 38 | |||
2.33. <middle> . . . . . . . . . . . . . . . . . . . . . . . . 39 | 2.33. <link> . . . . . . . . . . . . . . . . . . . . . . . . . 40 | |||
2.34. <name> . . . . . . . . . . . . . . . . . . . . . . . . . 39 | 2.34. <middle> . . . . . . . . . . . . . . . . . . . . . . . . 41 | |||
2.35. <note> . . . . . . . . . . . . . . . . . . . . . . . . . 40 | 2.35. <name> . . . . . . . . . . . . . . . . . . . . . . . . . 41 | |||
2.36. <ol> . . . . . . . . . . . . . . . . . . . . . . . . . . 41 | 2.36. <note> . . . . . . . . . . . . . . . . . . . . . . . . . 42 | |||
2.37. <organization> . . . . . . . . . . . . . . . . . . . . . 43 | 2.37. <ol> . . . . . . . . . . . . . . . . . . . . . . . . . . 43 | |||
2.38. <phone> . . . . . . . . . . . . . . . . . . . . . . . . . 43 | 2.38. <organization> . . . . . . . . . . . . . . . . . . . . . 45 | |||
2.39. <pobox> . . . . . . . . . . . . . . . . . . . . . . . . . 44 | 2.39. <phone> . . . . . . . . . . . . . . . . . . . . . . . . . 45 | |||
2.40. <postal> . . . . . . . . . . . . . . . . . . . . . . . . 44 | 2.40. <pobox> . . . . . . . . . . . . . . . . . . . . . . . . . 46 | |||
2.41. <postalLine> . . . . . . . . . . . . . . . . . . . . . . 45 | 2.41. <postal> . . . . . . . . . . . . . . . . . . . . . . . . 46 | |||
2.42. <refcontent> . . . . . . . . . . . . . . . . . . . . . . 45 | 2.42. <postalLine> . . . . . . . . . . . . . . . . . . . . . . 47 | |||
2.43. <reference> . . . . . . . . . . . . . . . . . . . . . . . 46 | 2.43. <refcontent> . . . . . . . . . . . . . . . . . . . . . . 47 | |||
2.44. <referencegroup> . . . . . . . . . . . . . . . . . . . . 47 | 2.44. <reference> . . . . . . . . . . . . . . . . . . . . . . . 48 | |||
2.45. <references> . . . . . . . . . . . . . . . . . . . . . . 47 | 2.45. <referencegroup> . . . . . . . . . . . . . . . . . . . . 49 | |||
2.46. <region> . . . . . . . . . . . . . . . . . . . . . . . . 49 | 2.46. <references> . . . . . . . . . . . . . . . . . . . . . . 49 | |||
2.47. <relref> . . . . . . . . . . . . . . . . . . . . . . . . 49 | 2.47. <region> . . . . . . . . . . . . . . . . . . . . . . . . 51 | |||
2.48. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . . 53 | 2.48. <relref> . . . . . . . . . . . . . . . . . . . . . . . . 51 | |||
2.49. <section> . . . . . . . . . . . . . . . . . . . . . . . . 56 | 2.49. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . . 55 | |||
2.50. <seriesInfo> . . . . . . . . . . . . . . . . . . . . . . 58 | 2.50. <section> . . . . . . . . . . . . . . . . . . . . . . . . 59 | |||
2.51. <sortingcode> . . . . . . . . . . . . . . . . . . . . . . 60 | 2.51. <seriesInfo> . . . . . . . . . . . . . . . . . . . . . . 61 | |||
2.52. <sourcecode> . . . . . . . . . . . . . . . . . . . . . . 61 | 2.52. <sortingcode> . . . . . . . . . . . . . . . . . . . . . . 63 | |||
2.53. <street> . . . . . . . . . . . . . . . . . . . . . . . . 63 | 2.53. <sourcecode> . . . . . . . . . . . . . . . . . . . . . . 63 | |||
2.54. <strong> . . . . . . . . . . . . . . . . . . . . . . . . 63 | 2.54. <street> . . . . . . . . . . . . . . . . . . . . . . . . 65 | |||
2.55. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . . 64 | 2.55. <strong> . . . . . . . . . . . . . . . . . . . . . . . . 66 | |||
2.56. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . . 65 | 2.56. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . . 67 | |||
2.57. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 | 2.57. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . . 67 | |||
2.58. <table> . . . . . . . . . . . . . . . . . . . . . . . . . 67 | 2.58. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 | |||
2.59. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . . 68 | 2.59. <table> . . . . . . . . . . . . . . . . . . . . . . . . . 70 | |||
2.60. <td> . . . . . . . . . . . . . . . . . . . . . . . . . . 68 | 2.60. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . . 71 | |||
2.61. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . . 70 | 2.61. <td> . . . . . . . . . . . . . . . . . . . . . . . . . . 71 | |||
2.62. <th> . . . . . . . . . . . . . . . . . . . . . . . . . . 71 | 2.62. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . . 73 | |||
2.63. <thead> . . . . . . . . . . . . . . . . . . . . . . . . . 73 | 2.63. <th> . . . . . . . . . . . . . . . . . . . . . . . . . . 74 | |||
2.64. <title> . . . . . . . . . . . . . . . . . . . . . . . . . 73 | 2.64. <thead> . . . . . . . . . . . . . . . . . . . . . . . . . 76 | |||
2.65. <tr> . . . . . . . . . . . . . . . . . . . . . . . . . . 73 | 2.65. <title> . . . . . . . . . . . . . . . . . . . . . . . . . 76 | |||
2.66. <tt> . . . . . . . . . . . . . . . . . . . . . . . . . . 74 | 2.66. <tr> . . . . . . . . . . . . . . . . . . . . . . . . . . 76 | |||
2.67. <ul> . . . . . . . . . . . . . . . . . . . . . . . . . . 75 | 2.67. <tt> . . . . . . . . . . . . . . . . . . . . . . . . . . 77 | |||
2.68. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . . 76 | 2.68. <ul> . . . . . . . . . . . . . . . . . . . . . . . . . . 78 | |||
2.69. <workgroup> . . . . . . . . . . . . . . . . . . . . . . . 76 | 2.69. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . . 78 | |||
2.70. <xref> . . . . . . . . . . . . . . . . . . . . . . . . . 76 | 2.70. <workgroup> . . . . . . . . . . . . . . . . . . . . . . . 79 | |||
3. Elements from v2 That Have Been Deprecated . . . . . . . . . 78 | 2.71. <xref> . . . . . . . . . . . . . . . . . . . . . . . . . 79 | |||
3.1. <c> . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 | ||||
3.2. <facsimile> . . . . . . . . . . . . . . . . . . . . . . . 79 | 3. Elements from v2 That Have Been Deprecated . . . . . . . . . 82 | |||
3.3. <format> . . . . . . . . . . . . . . . . . . . . . . . . 79 | 3.1. <c> . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 | |||
3.4. <list> . . . . . . . . . . . . . . . . . . . . . . . . . 80 | 3.2. <facsimile> . . . . . . . . . . . . . . . . . . . . . . . 82 | |||
3.5. <postamble> . . . . . . . . . . . . . . . . . . . . . . . 80 | 3.3. <format> . . . . . . . . . . . . . . . . . . . . . . . . 82 | |||
3.6. <preamble> . . . . . . . . . . . . . . . . . . . . . . . 81 | 3.4. <list> . . . . . . . . . . . . . . . . . . . . . . . . . 83 | |||
3.7. <spanx> . . . . . . . . . . . . . . . . . . . . . . . . . 82 | 3.5. <postamble> . . . . . . . . . . . . . . . . . . . . . . . 83 | |||
3.8. <texttable> . . . . . . . . . . . . . . . . . . . . . . . 82 | 3.6. <preamble> . . . . . . . . . . . . . . . . . . . . . . . 84 | |||
3.9. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . . 84 | 3.7. <spanx> . . . . . . . . . . . . . . . . . . . . . . . . . 85 | |||
3.10. <vspace> . . . . . . . . . . . . . . . . . . . . . . . . 84 | 3.8. <texttable> . . . . . . . . . . . . . . . . . . . . . . . 85 | |||
4. SVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 | 3.9. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . . 87 | |||
5. Use of CDATA Structures and Escaping . . . . . . . . . . . . 85 | 3.10. <vspace> . . . . . . . . . . . . . . . . . . . . . . . . 87 | |||
6. Internationalization Considerations . . . . . . . . . . . . . 85 | 4. SVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 | |||
7. Security Considerations . . . . . . . . . . . . . . . . . . . 86 | 5. Use of CDATA Structures and Escaping . . . . . . . . . . . . 88 | |||
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 86 | 6. Internationalization Considerations . . . . . . . . . . . . . 88 | |||
8.1. Internet Media Type Registration . . . . . . . . . . . . 86 | 7. Security Considerations . . . . . . . . . . . . . . . . . . . 89 | |||
8.2. Link Relation Registration . . . . . . . . . . . . . . . 88 | 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 89 | |||
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 88 | 8.1. Internet Media Type Registration . . . . . . . . . . . . 89 | |||
9.1. Normative References . . . . . . . . . . . . . . . . . . 88 | 8.2. Link Relation Registration . . . . . . . . . . . . . . . 91 | |||
9.2. Informative References . . . . . . . . . . . . . . . . . 88 | 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 91 | |||
Appendix A. Front-Page ("Boilerplate") Generation . . . . . . . 93 | 9.1. Normative References . . . . . . . . . . . . . . . . . . 91 | |||
A.1. The "ipr" Attribute . . . . . . . . . . . . . . . . . . . 93 | 9.2. Informative References . . . . . . . . . . . . . . . . . 91 | |||
A.1.1. Current Values: "*trust200902" . . . . . . . . . . . 93 | 9.3. Editorial References . . . . . . . . . . . . . . . . . . 95 | |||
A.1.2. Historic Values . . . . . . . . . . . . . . . . . . . 95 | Appendix A. Front-Page ("Boilerplate") Generation . . . . . . . 98 | |||
A.2. The "submissionType" Attribute . . . . . . . . . . . . . 95 | A.1. The "category" Attribute . . . . . . . . . . . . . . . . 98 | |||
A.3. The "consensus" Attribute . . . . . . . . . . . . . . . . 96 | A.2. The "ipr" Attribute . . . . . . . . . . . . . . . . . . . 98 | |||
Appendix B. The v3 Format and Processing Tools . . . . . . . . . 97 | A.2.1. Current Values: "*trust200902" . . . . . . . . . . . 98 | |||
B.1. Including External Text with XInclude . . . . . . . . . . 98 | A.2.2. Historic Values . . . . . . . . . . . . . . . . . . . 100 | |||
B.2. Anchors and IDs . . . . . . . . . . . . . . . . . . . . . 99 | A.3. The "submissionType" Attribute . . . . . . . . . . . . . 101 | |||
B.2.1. Overlapping Values . . . . . . . . . . . . . . . . . 100 | A.4. The "consensus" Attribute . . . . . . . . . . . . . . . . 101 | |||
B.3. Attributes Controlled by the Prep Tool . . . . . . . . . 101 | Appendix B. The v3 Format and Processing Tools . . . . . . . . . 102 | |||
Appendix C. RELAX NG Schema . . . . . . . . . . . . . . . . . . 102 | B.1. Including External Text with XInclude . . . . . . . . . . 103 | |||
Appendix D. Schema Differences from v2 . . . . . . . . . . . . . 124 | B.2. Anchors and IDs . . . . . . . . . . . . . . . . . . . . . 104 | |||
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 | B.2.1. Overlapping Values . . . . . . . . . . . . . . . . . 105 | |||
IAB Members at the Time of Approval . . . . . . . . . . . . . . . 167 | B.3. Attributes Controlled by the Prep Tool . . . . . . . . . 106 | |||
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 167 | Appendix C. RELAX NG Schema . . . . . . . . . . . . . . . . . . 107 | |||
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 168 | Appendix D. Schema Differences from v2 . . . . . . . . . . . . . 129 | |||
Appendix E. Change Log . . . . . . . . . . . . . . . . . . . . . 151 | ||||
E.1. Since draft-iab-rfc7991bis-00 . . . . . . . . . . . . . . 151 | ||||
E.2. Since draft-iab-rfc7991bis-01 . . . . . . . . . . . . . . 152 | ||||
E.3. Since draft-iab-rfc7991bis-02 . . . . . . . . . . . . . . 153 | ||||
E.4. Since draft-iab-rfc7991bis-03 . . . . . . . . . . . . . . 153 | ||||
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 | ||||
IAB Members at the Time of Approval . . . . . . . . . . . . . . . 177 | ||||
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 177 | ||||
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 177 | ||||
1. Introduction | 1. Introduction | |||
This document describes version 3 ("v3") of the "xml2rfc" vocabulary: | This document describes version 3 ("v3") of the "xml2rfc" vocabulary: | |||
an XML-based language ("Extensible Markup Language" [XML]) used for | an XML-based language ("Extensible Markup Language" [XML]) used for | |||
writing RFCs [RFC7322] and Internet-Drafts [IDGUIDE]. | 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] obsolted the original version ("v1") | definition. [RFC7749] obsolted the original version ("v1") | |||
skipping to change at page 6, line 33 ¶ | skipping to change at page 6, line 50 ¶ | |||
o Added the "align" attribute to <table>. Made the table title | o Added the "align" attribute to <table>. Made the table title | |||
centered under the table. | centered under the table. | |||
o The <name> element now allows many more elements inside of it. | o The <name> element now allows many more elements inside of it. | |||
o Redefined <references> to allow <references> within it. In the | o Redefined <references> to allow <references> within it. In the | |||
typical case, an outer <references> will be used to hold an inner | typical case, an outer <references> will be used to hold an inner | |||
<references> for normative references and an inner <references> to | <references> for normative references and an inner <references> to | |||
hold informative references. | hold informative references. | |||
o Un-deprecated metadata attributes on the <rfc> element (with the | ||||
intent to restore v2 semantics of <seriesInfo> as well). | ||||
o Added <contact> element. | ||||
o Allowed multiple <email> elements in <address>. | ||||
o Added "markers" attribute to <sourcecode> element. | ||||
o Added "brackets" attribute to <eref> element. | ||||
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 | |||
skipping to change at page 9, line 32 ¶ | skipping to change at page 10, line 11 ¶ | |||
o Deprecate the "alt" and "src" attributes in <figure> because they | o Deprecate the "alt" and "src" attributes in <figure> because they | |||
overlap with the attributes in <artwork>. | overlap with the attributes in <artwork>. | |||
o Deprecate the "xml:space" attribute in <artwork> because there was | o Deprecate the "xml:space" attribute in <artwork> because there was | |||
only one useful value. Deprecate the "height" and "width" | only one useful value. Deprecate the "height" and "width" | |||
attributes in both <artwork> and <figure> because they are not | attributes in both <artwork> and <figure> because they are not | |||
needed for the new output formats. | needed for the new output formats. | |||
o Deprecate the "pageno" attribute in <xref> because it was unused | o Deprecate the "pageno" attribute in <xref> because it was unused | |||
in v2. Deprecate the "none" values for the "format" attribute in | in v2. | |||
<xref> because it makes no sense semantically. | ||||
1.4.4. Additional Changes from v2 | 1.4.4. Additional Changes from v2 | |||
o Allow non-ASCII characters in the format; the characters that are | o Allow non-ASCII characters in the format; the characters that are | |||
actually allowed will be determined by the RFC Series Editor. | actually allowed will be determined by the RFC Series Editor. | |||
o Allow <artwork> and <sourcecode> to be used on their own in | o Allow <artwork> and <sourcecode> to be used on their own in | |||
<section> (no longer confine them to a figure). | <section> (no longer confine them to a figure). | |||
o Give more specifics of handling the "type" attribute in <artwork>. | o Give more specifics of handling the "type" attribute in <artwork>. | |||
skipping to change at page 10, line 21 ¶ | skipping to change at page 10, line 46 ¶ | |||
when used in the <front> for the document's boilerplate text. | when used in the <front> for the document's boilerplate text. | |||
o In <postal>, allow the sub-elements to be in any order. Also | o In <postal>, allow the sub-elements to be in any order. Also | |||
allow the inclusion of the new <postalLine> instead of the older | allow the inclusion of the new <postalLine> instead of the older | |||
elements. | elements. | |||
o In <section>, restrict the names of the anchors that can be used | o In <section>, restrict the names of the anchors that can be used | |||
on some types of sections. | on some types of sections. | |||
o Make <seriesInfo> a child of <front>, and deprecated it as a child | o Make <seriesInfo> a child of <front>, and deprecated it as a child | |||
of <reference>. This also deprecates some of the attributes from | of <reference>. | |||
<rfc> and moves them into <seriesInfo>. | ||||
o <t> now only contains non-block elements, so it no longer contains | o <t> now only contains non-block elements, so it no longer contains | |||
<figure> elements. | <figure> elements. | |||
o Do not generate the grammar from a DTD, but instead get it | o Do not generate the grammar from a DTD, but instead get it | |||
directly from the RELAX Next Generation (RNG) grammar [RNG]. | directly from the RELAX Next Generation (RNG) grammar [RNG]. | |||
1.5. Syntax Notation | 1.5. Syntax Notation | |||
The XML vocabulary here is defined in prose, based on the RELAX NG | The XML vocabulary here is defined in prose, based on the RELAX NG | |||
skipping to change at page 11, line 29 ¶ | skipping to change at page 12, line 5 ¶ | |||
renderers that display different fonts for ideographic characters | renderers that display different fonts for ideographic characters | |||
used in China and Japan. The xml:base attribute is sometimes added | used in China and Japan. The xml:base attribute is sometimes added | |||
to an XML file when doing XML-to-XML conversion where the base file | to an XML file when doing XML-to-XML conversion where the base file | |||
has XInclude attributes (see Appendix B.1). | has XInclude attributes (see Appendix B.1). | |||
2.1. <abstract> | 2.1. <abstract> | |||
Contains the Abstract of the document. See [RFC7322] for more | Contains the Abstract of the document. See [RFC7322] for more | |||
information on restrictions for the Abstract. | information on restrictions for the Abstract. | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: | Content model: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
o <dl> elements (Section 2.21) | o <dl> elements (Section 2.22) | |||
o <ol> elements (Section 2.36) | o <ol> elements (Section 2.37) | |||
o <t> elements (Section 2.57) | o <t> elements (Section 2.58) | |||
o <ul> elements (Section 2.67) | o <ul> elements (Section 2.68) | |||
2.1.1. "anchor" Attribute | 2.1.1. "anchor" Attribute | |||
Document-wide unique identifier for the Abstract. | Document-wide unique identifier for the Abstract. | |||
2.2. <address> | 2.2. <address> | |||
Provides address information for the author. | Provides address information for the author. | |||
This element appears as a child element of <author> (Section 2.8). | This element appears as a child element of <author> (Section 2.8) and | |||
<contact> (Section 2.16). | ||||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <postal> element (Section 2.40) | 1. One optional <postal> element (Section 2.41) | |||
2. One optional <phone> element (Section 2.38) | 2. One optional <phone> element (Section 2.39) | |||
3. One optional <facsimile> element (Section 3.2) | 3. One optional <facsimile> element (Section 3.2) | |||
4. One optional <email> element (Section 2.24) | 4. Optional <email> elements (Section 2.25) | |||
5. One optional <uri> element (Section 2.68) | 5. One optional <uri> element (Section 2.69) | |||
2.3. <annotation> | 2.3. <annotation> | |||
Provides additional prose augmenting a bibliographic reference. This | Provides additional prose augmenting a bibliographic reference. This | |||
text is intended to be shown after the rest of the generated | text is intended to be shown after the rest of the generated | |||
reference text. | reference text. | |||
This element appears as a child element of <reference> | This element appears as a child element of <reference> | |||
(Section 2.43). | (Section 2.44). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <spanx> elements (Section 3.7) | o <spanx> elements (Section 3.7) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | ||||
o <xref> elements (Section 2.70) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.71) | ||||
2.4. <area> | 2.4. <area> | |||
Provides information about the IETF area to which this document | Provides information about the IETF area to which this document | |||
relates (currently not used when generating documents). | relates (currently not used when generating documents). | |||
The value ought to be either the full name or the abbreviation of one | The value ought to be either the full name or the abbreviation of one | |||
of the IETF areas as listed on <http://www.ietf.org/iesg/area.html>. | of the IETF areas as listed on <http://www.ietf.org/iesg/area.html>. | |||
A list of full names and abbreviations will be kept by the RFC Series | A list of full names and abbreviations will be kept by the RFC Series | |||
Editor. | Editor. | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: only text content. | Content model: only text content. | |||
2.5. <artset> | 2.5. <artset> | |||
This element allows for the support of alternative artwork formats. | This element allows for the support of alternative artwork formats. | |||
This will allow the renderer to pick the most appropriate <artwork> | This will allow the renderer to pick the most appropriate <artwork> | |||
instance for its format from the alternatives present within an | instance for its format from the alternatives present within an | |||
<artset> element. | <artset> element. | |||
If more than one <artwork> element is found within an <artset> | If more than one <artwork> element is found within an <artset> | |||
element, with the same "type" attribute, the rendere could select the | element, with the same "type" attribute, the rendere could select the | |||
first one, or possibly choose between the alternative instances based | first one, or possibly choose between the alternative instances based | |||
on the output format and some quality of the alternative instances | on the output format and some quality of the alternative instances | |||
that made one more suitable than the other for that particular | that made one more suitable than the other for that particular | |||
format, such as size, aspect ration, etc. | format, such as size, aspect ration, etc. | |||
This element appears as a child element of <aside> (Section 2.7), | This element appears as a child element of <aside> (Section 2.7), | |||
<blockquote> (Section 2.11), <dd> (Section 2.19), <figure> | <blockquote> (Section 2.11), <dd> (Section 2.20), <figure> | |||
(Section 2.27), <li> (Section 2.31), <section> (Section 2.49), <td> | (Section 2.28), <li> (Section 2.32), <section> (Section 2.50), <td> | |||
(Section 2.60), and <th> (Section 2.62). | (Section 2.61), and <th> (Section 2.63). | |||
Content model: | Content model: | |||
One or more <artwork> elements (Section 2.6) | One or more <artwork> elements (Section 2.6) | |||
2.5.1. "anchor" Attribute | 2.5.1. "anchor" Attribute | |||
Same as for the <artwork> element (Section 2.6). | Same as for the <artwork> element (Section 2.6). | |||
2.6. <artwork> | 2.6. <artwork> | |||
skipping to change at page 15, line 10 ¶ | skipping to change at page 15, line 36 ¶ | |||
Formatters that do pagination should attempt to keep artwork on a | Formatters that do pagination should attempt to keep artwork on a | |||
single page. This is to prevent artwork that is split across pages | single page. This is to prevent artwork that is split across pages | |||
from looking like two separate pieces of artwork. | from looking like two separate pieces of artwork. | |||
See Section 5 for a description of how to deal with issues of using | See Section 5 for a description of how to deal with issues of using | |||
"&" and "<" characters in artwork. | "&" and "<" characters in artwork. | |||
This element appears as a child element of <artset> (Section 2.5), | This element appears as a child element of <artset> (Section 2.5), | |||
<aside> (Section 2.7), <blockquote> (Section 2.11), <dd> | <aside> (Section 2.7), <blockquote> (Section 2.11), <dd> | |||
(Section 2.19), <figure> (Section 2.27), <li> (Section 2.31), | (Section 2.20), <figure> (Section 2.28), <li> (Section 2.32), | |||
<section> (Section 2.49), <td> (Section 2.60), and <th> | <section> (Section 2.50), <td> (Section 2.61), and <th> | |||
(Section 2.62). | (Section 2.63). | |||
Content model: | Content model: | |||
Either: | Either: | |||
Text | Text | |||
Or: | Or: | |||
<svg> elements (Section 4) | <svg> elements (Section 4) | |||
skipping to change at page 17, line 32 ¶ | skipping to change at page 18, line 18 ¶ | |||
2.6.9. "xml:space" Attribute | 2.6.9. "xml:space" Attribute | |||
Deprecated. | Deprecated. | |||
2.7. <aside> | 2.7. <aside> | |||
This element is a container for content that is semantically less | This element is a container for content that is semantically less | |||
important or tangential to the content that surrounds it. | important or tangential to the content that surrounds it. | |||
This element appears as a child element of <section> (Section 2.49). | This element appears as a child element of <section> (Section 2.50). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o <artset> elements (Section 2.5) | o <artset> elements (Section 2.5) | |||
o <artwork> elements (Section 2.6) | o <artwork> elements (Section 2.6) | |||
o <dl> elements (Section 2.21) | o <dl> elements (Section 2.22) | |||
o <figure> elements (Section 2.27) | o <figure> elements (Section 2.28) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <ol> elements (Section 2.36) | o <ol> elements (Section 2.37) | |||
o <t> elements (Section 2.57) | o <t> elements (Section 2.58) | |||
o <table> elements (Section 2.58) | ||||
o <ul> elements (Section 2.67) | o <table> elements (Section 2.59) | |||
o <ul> elements (Section 2.68) | ||||
2.7.1. "anchor" Attribute | 2.7.1. "anchor" Attribute | |||
Document-wide unique identifier for this aside. | Document-wide unique identifier for this aside. | |||
2.8. <author> | 2.8. <author> | |||
Provides information about a document's author. This is used both | Provides information about a document's author. This is used both | |||
for the document itself (at the beginning of the document) and for | for the document itself (at the beginning of the document) and for | |||
referenced documents. | referenced documents. | |||
skipping to change at page 18, line 32 ¶ | skipping to change at page 19, line 19 ¶ | |||
Note that an "author" can also be just an organization (by not | Note that an "author" can also be just an organization (by not | |||
specifying any of the "name" attributes, but adding the | specifying any of the "name" attributes, but adding the | |||
<organization> child element). | <organization> child element). | |||
Furthermore, the "role" attribute can be used to mark an author as | Furthermore, the "role" attribute can be used to mark an author as | |||
"editor". This is reflected both on the front page and in the | "editor". This is reflected both on the front page and in the | |||
"Author's Address" section, as well as in bibliographic references. | "Author's Address" section, as well as in bibliographic references. | |||
Note that this specification does not define a precise meaning for | Note that this specification does not define a precise meaning for | |||
the term "editor". | the term "editor". | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <organization> element (Section 2.37) | 1. One optional <organization> element (Section 2.38) | |||
2. One optional <address> element (Section 2.2) | 2. One optional <address> element (Section 2.2) | |||
2.8.1. "asciiFullname" Attribute | 2.8.1. "asciiFullname" Attribute | |||
The ASCII equivalent of the author's full name. | The ASCII equivalent of the author's full name. | |||
2.8.2. "asciiInitials" Attribute | 2.8.2. "asciiInitials" Attribute | |||
The ASCII equivalent of the author's initials, to be used in | The ASCII equivalent of the author's initials, to be used in | |||
skipping to change at page 19, line 47 ¶ | skipping to change at page 20, line 35 ¶ | |||
The author's surname, to be used in conjunction with the separately | The author's surname, to be used in conjunction with the separately | |||
specified initials. It usually appears on the front page, in | specified initials. It usually appears on the front page, in | |||
footers, and in references. | footers, and in references. | |||
2.9. <back> | 2.9. <back> | |||
Contains the "back" part of the document: the references and | Contains the "back" part of the document: the references and | |||
appendices. In <back>, <section> elements indicate appendices. | appendices. In <back>, <section> elements indicate appendices. | |||
This element appears as a child element of <rfc> (Section 2.48). | This element appears as a child element of <rfc> (Section 2.49). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. Optional <displayreference> elements (Section 2.20) | 1. Optional <displayreference> elements (Section 2.21) | |||
2. One <references> element (Section 2.45) | 2. One <references> element (Section 2.46) | |||
3. Optional <section> elements (Section 2.49) | 3. Optional <section> elements (Section 2.50) | |||
2.10. <bcp14> | 2.10. <bcp14> | |||
Marks text that are phrases defined in [BCP14] such as "MUST", | Marks text that are phrases defined in [BCP14] such as "MUST", | |||
"SHOULD NOT", and so on. When shown in some of the output | "SHOULD NOT", and so on. When shown in some of the output | |||
representations, the text in this element might be highlighted. The | representations, the text in this element might be highlighted. The | |||
use of this element is optional. | use of this element is optional. | |||
This element is only to be used around the actual phrase from BCP 14, | This element is only to be used around the actual phrase from BCP 14, | |||
not the full definition of a requirement. For example, it is correct | not the full definition of a requirement. For example, it is correct | |||
to say "The packet <bcp14>MUST</bcp14> be dropped.", but it is not | to say "The packet <bcp14>MUST</bcp14> be dropped.", but it is not | |||
correct to say "<bcp14>The packet MUST be dropped.</bcp14>". | correct to say "<bcp14>The packet MUST be dropped.</bcp14>". | |||
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), <dd> (Section 2.19), <dt> | (Section 2.3), <blockquote> (Section 2.11), <dd> (Section 2.20), <dt> | |||
(Section 2.22), <em> (Section 2.23), <li> (Section 2.31), <name> | (Section 2.23), <em> (Section 2.24), <li> (Section 2.32), <name> | |||
(Section 2.34), <preamble> (Section 3.6), <refcontent> | (Section 2.35), <preamble> (Section 3.6), <refcontent> | |||
(Section 2.42), <strong> (Section 2.54), <sub> (Section 2.55), <sup> | (Section 2.43), <strong> (Section 2.55), <sub> (Section 2.56), <sup> | |||
(Section 2.56), <t> (Section 2.57), <td> (Section 2.60), <th> | (Section 2.57), <t> (Section 2.58), <td> (Section 2.61), <th> | |||
(Section 2.62), and <tt> (Section 2.66). | (Section 2.63), and <tt> (Section 2.67). | |||
Content model: only text content. | Content model: only text content. | |||
2.11. <blockquote> | 2.11. <blockquote> | |||
Specifies that a block of text is a quotation. | Specifies that a block of text is a quotation. | |||
This element appears as a child element of <li> (Section 2.31) and | This element appears as a child element of <li> (Section 2.32) and | |||
<section> (Section 2.49). | <section> (Section 2.50). | |||
Content model: | Content model: | |||
Either: | Either: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <dl> elements (Section 2.21) | * <dl> elements (Section 2.22) | |||
* <figure> elements (Section 2.27) | ||||
* <ol> elements (Section 2.36) | * <figure> elements (Section 2.28) | |||
* <sourcecode> elements (Section 2.52) | * <ol> elements (Section 2.37) | |||
* <t> elements (Section 2.57) | * <sourcecode> elements (Section 2.53) | |||
* <table> elements (Section 2.58) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <table> elements (Section 2.59) | |||
* <ul> elements (Section 2.68) | ||||
Or: | Or: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* Text | * Text | |||
* <bcp14> elements (Section 2.10) | * <bcp14> elements (Section 2.10) | |||
* <cref> elements (Section 2.17) | * <cref> elements (Section 2.18) | |||
* <em> elements (Section 2.23) | * <em> elements (Section 2.24) | |||
* <eref> elements (Section 2.25) | * <eref> elements (Section 2.26) | |||
* <iref> elements (Section 2.29) | * <iref> elements (Section 2.30) | |||
* <relref> elements (Section 2.47) | * <relref> elements (Section 2.48) | |||
* <strong> elements (Section 2.54) | * <strong> elements (Section 2.55) | |||
* <sub> elements (Section 2.55) | * <sub> elements (Section 2.56) | |||
* <sup> elements (Section 2.56) | * <sup> elements (Section 2.57) | |||
* <tt> elements (Section 2.66) | * <tt> elements (Section 2.67) | |||
* <xref> elements (Section 2.70) | * <xref> elements (Section 2.71) | |||
2.11.1. "anchor" Attribute | 2.11.1. "anchor" Attribute | |||
Document-wide unique identifier for this quotation. | Document-wide unique identifier for this quotation. | |||
2.11.2. "cite" Attribute | 2.11.2. "cite" Attribute | |||
The source of the citation. This must be a URI. If the "quotedFrom" | The source of the citation. This must be a URI. If the "quotedFrom" | |||
attribute is given, this URI will be used by processing tools as the | attribute is given, this URI will be used by processing tools as the | |||
link for the text of that attribute. | link for the text of that attribute. | |||
skipping to change at page 22, line 29 ¶ | skipping to change at page 23, line 13 ¶ | |||
quotation. | quotation. | |||
2.12. <boilerplate> | 2.12. <boilerplate> | |||
Holds the boilerplate text for the document. This element is filled | Holds the boilerplate text for the document. This element is filled | |||
in by the prep tool. | in by the prep tool. | |||
This element contains <section> elements. Every <section> element in | This element contains <section> elements. Every <section> element in | |||
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.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: | Content model: | |||
One or more <section> elements (Section 2.49) | One or more <section> elements (Section 2.50) | |||
2.13. <city> | 2.13. <city> | |||
Gives the city name in a postal address. | Gives the city name in a postal address. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.13.1. "ascii" Attribute | 2.13.1. "ascii" Attribute | |||
The ASCII equivalent of the city name. | The ASCII equivalent of the city name. | |||
2.14. <cityarea> | 2.14. <cityarea> | |||
TBD | TBD | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.14.1. "ascii" Attribute | 2.14.1. "ascii" Attribute | |||
The ASCII equivalent of the city area name. | The ASCII equivalent of the city area name. | |||
2.15. <code> | 2.15. <code> | |||
Gives the postal region code. | Gives the postal region code. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.15.1. "ascii" Attribute | 2.15.1. "ascii" Attribute | |||
The ASCII equivalent of the postal code. | The ASCII equivalent of the postal code. | |||
2.16. <country> | 2.16. <contact> | |||
Provides information about a contact, such as a contributor to be | ||||
mentioned in an "Acknowledgements" section. | ||||
This element appears as a child element of <section> (Section 2.50). | ||||
Content model: | ||||
In this order: | ||||
1. One optional <organization> element (Section 2.38) | ||||
2. One optional <address> element (Section 2.2) | ||||
2.16.1. "asciiFullname" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.1). | ||||
2.16.2. "asciiInitials" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.2). | ||||
2.16.3. "asciiSurname" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.3). | ||||
2.16.4. "fullname" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.4). | ||||
2.16.5. "initials" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.5). | ||||
2.16.6. "surname" Attribute | ||||
See the corresponding attribute on <author> element (Section 2.8.7). | ||||
2.17. <country> | ||||
Gives the country name or code in a postal address. | Gives the country name or code in a postal address. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.16.1. "ascii" Attribute | 2.17.1. "ascii" Attribute | |||
The ASCII equivalent of the country name. | The ASCII equivalent of the country name. | |||
2.17. <cref> | 2.18. <cref> | |||
Represents a comment. | Represents a comment. | |||
Comments can be used in a document while it is work in progress. | Comments can be used in a document while it is work in progress. | |||
They might appear either inline and visually highlighted, at the end | They might appear either inline and visually highlighted, at the end | |||
of the document, or not at all, depending on the formatting tool. | of the document, or not at all, depending on the formatting tool. | |||
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), <c> (Section 3.1), <dd> | (Section 2.3), <blockquote> (Section 2.11), <c> (Section 3.1), <dd> | |||
(Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <postamble> (Section 3.5), | (Section 2.32), <name> (Section 2.35), <postamble> (Section 3.5), | |||
<preamble> (Section 3.6), <strong> (Section 2.54), <sub> | <preamble> (Section 3.6), <strong> (Section 2.55), <sub> | |||
(Section 2.55), <sup> (Section 2.56), <t> (Section 2.57), <td> | (Section 2.56), <sup> (Section 2.57), <t> (Section 2.58), <td> | |||
(Section 2.60), <th> (Section 2.62), <tt> (Section 2.66), and <ttcol> | (Section 2.61), <th> (Section 2.63), <tt> (Section 2.67), and <ttcol> | |||
(Section 3.9). | (Section 3.9). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.17.1. "anchor" Attribute | 2.18.1. "anchor" Attribute | |||
Document-wide unique identifier for this comment. | Document-wide unique identifier for this comment. | |||
2.17.2. "display" Attribute | 2.18.2. "display" Attribute | |||
Suggests whether or not the comment should be displayed by formatting | Suggests whether or not the comment should be displayed by formatting | |||
tools. This might be set to "false" if you want to keep a comment in | tools. This might be set to "false" if you want to keep a comment in | |||
a document after the contents of the comment have already been dealt | a document after the contents of the comment have already been dealt | |||
with. | with. | |||
Cross-referencing (Section 2.71) a comment with "display" set to | ||||
"false" is an error. | ||||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.17.3. "source" Attribute | 2.18.3. "source" Attribute | |||
Holds the "source" of a comment, such as the name or the initials of | Holds the "source" of a comment, such as the name or the initials of | |||
the person who made the comment. | the person who made the comment. | |||
2.18. <date> | 2.19. <date> | |||
Provides information about the publication date. This element is | Provides information about the publication date. This element is | |||
used for two cases: the boilerplate of the document being produced, | used for two cases: the boilerplate of the document being produced, | |||
and inside bibliographic references that use the <front> element. | and inside bibliographic references that use the <front> element. | |||
Boilerplate for Internet-Drafts and RFCs: This element defines the | Boilerplate for Internet-Drafts and RFCs: This element defines the | |||
date of publication for the current document (Internet-Draft or | date of publication for the current document (Internet-Draft or | |||
RFC). When producing Internet-Drafts, the prep tool uses this | RFC). When producing Internet-Drafts, the prep tool uses this | |||
date to compute the expiration date (see [IDGUIDE]). When one or | date to compute the expiration date (see [IDGUIDE]). When one or | |||
more of "year", "month", or "day" are left out, the prep tool will | more of "year", "month", or "day" are left out, the prep tool will | |||
skipping to change at page 25, line 30 ¶ | skipping to change at page 27, line 13 ¶ | |||
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 | example, vague dates (year="ca. 2000"), date ranges | |||
(year="2012-2013"), non-specific months (month="Second quarter"), | (year="2012-2013"), non-specific months (month="Second quarter"), | |||
and so on are allowed. | and so on are allowed. | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
2.18.1. "day" Attribute | 2.19.1. "day" Attribute | |||
The day of publication. | The day of publication. | |||
2.18.2. "month" Attribute | 2.19.2. "month" Attribute | |||
The month or months of publication. | The month or months of publication. | |||
2.18.3. "year" Attribute | 2.19.3. "year" Attribute | |||
The year or years of publication. | The year or years of publication. | |||
2.19. <dd> | 2.20. <dd> | |||
The definition part of an entry in a definition list. | The definition part of an entry in a definition list. | |||
This element appears as a child element of <dl> (Section 2.21). | This element appears as a child element of <dl> (Section 2.22). | |||
Content model: | Content model: | |||
Either: | Either: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <dl> elements (Section 2.21) | * <dl> elements (Section 2.22) | |||
* <figure> elements (Section 2.27) | ||||
* <ol> elements (Section 2.36) | * <figure> elements (Section 2.28) | |||
* <sourcecode> elements (Section 2.52) | * <ol> elements (Section 2.37) | |||
* <sourcecode> elements (Section 2.53) | ||||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
Or: | Or: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* Text | * Text | |||
* <bcp14> elements (Section 2.10) | * <bcp14> elements (Section 2.10) | |||
* <cref> elements (Section 2.17) | * <cref> elements (Section 2.18) | |||
* <em> elements (Section 2.23) | * <em> elements (Section 2.24) | |||
* <eref> elements (Section 2.25) | * <eref> elements (Section 2.26) | |||
* <iref> elements (Section 2.29) | * <iref> elements (Section 2.30) | |||
* <relref> elements (Section 2.47) | * <relref> elements (Section 2.48) | |||
* <strong> elements (Section 2.54) | * <strong> elements (Section 2.55) | |||
* <sub> elements (Section 2.55) | * <sub> elements (Section 2.56) | |||
* <sup> elements (Section 2.56) | ||||
* <tt> elements (Section 2.66) | * <sup> elements (Section 2.57) | |||
* <xref> elements (Section 2.70) | * <tt> elements (Section 2.67) | |||
2.19.1. "anchor" Attribute | * <xref> elements (Section 2.71) | |||
2.20.1. "anchor" Attribute | ||||
Document-wide unique identifier for this definition. | Document-wide unique identifier for this definition. | |||
2.20. <displayreference> | 2.21. <displayreference> | |||
This element gives a mapping between the anchor of a reference and a | This element gives a mapping between the anchor of a reference and a | |||
name that will be displayed instead. This allows authors to display | name that will be displayed instead. This allows authors to display | |||
more mnemonic anchor names for automatically included references. | more mnemonic anchor names for automatically included references. | |||
The mapping in this element only applies to <xref> elements whose | The mapping in this element only applies to <xref> elements whose | |||
format is "default". For example, if the reference uses the anchor | format is "default". For example, if the reference uses the anchor | |||
"RFC6949", the following would cause that anchor in the body of | "RFC6949", the following would cause that anchor in the body of | |||
displayed documents to be "RFC-dev": | displayed documents to be "RFC-dev": | |||
<displayreference target="RFC6949" to="RFC-dev"/> | <displayreference target="RFC6949" to="RFC-dev"/> | |||
skipping to change at page 27, line 38 ¶ | skipping to change at page 29, line 29 ¶ | |||
It is expected that this element will only be valid in input | It is expected that this element will only be valid in input | |||
documents. It will likely be removed by prep tools when preparing a | documents. It will likely be removed by prep tools when preparing a | |||
final version after those tools have replaced all of the associated | final version after those tools have replaced all of the associated | |||
anchors, targets, and "derivedContent" attributes. | anchors, targets, and "derivedContent" attributes. | |||
This element appears as a child element of <back> (Section 2.9). | This element appears as a child element of <back> (Section 2.9). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
2.20.1. "target" Attribute (Mandatory) | 2.21.1. "target" Attribute (Mandatory) | |||
This attribute must be the name of an anchor in a <reference> or | This attribute must be the name of an anchor in a <reference> or | |||
<referencegroup> element. | <referencegroup> element. | |||
2.20.2. "to" Attribute (Mandatory) | 2.21.2. "to" Attribute (Mandatory) | |||
This attribute is a name that will be displayed as the anchor instead | This attribute is a name that will be displayed as the anchor instead | |||
of the anchor that is given in the <reference> element. The string | of the anchor that is given in the <reference> element. The string | |||
given must start with one of the following characters: 0-9, a-z, or | given must start with one of the following characters: 0-9, a-z, or | |||
A-Z. The other characters in the string must be 0-9, a-z, A-Z, "-", | A-Z. The other characters in the string must be 0-9, a-z, A-Z, "-", | |||
".", or "_". | ".", or "_". | |||
2.21. <dl> | 2.22. <dl> | |||
A definition list. Each entry has a pair of elements: a term (<dt>) | A definition list. Each entry has a pair of elements: a term (<dt>) | |||
and a definition (<dd>). (This is slightly different and simpler | and a definition (<dd>). (This is slightly different and simpler | |||
than the model used in HTML, which allows for multiple terms for a | than the model used in HTML, which allows for multiple terms for a | |||
single definition.) | single definition.) | |||
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.19), <li> (Section 2.31), <note> (Section 2.35), <section> | (Section 2.20), <li> (Section 2.32), <note> (Section 2.36), <section> | |||
(Section 2.49), <td> (Section 2.60), and <th> (Section 2.62). | (Section 2.50), <td> (Section 2.61), and <th> (Section 2.63). | |||
Content model: | Content model: | |||
One or more sequences of: | One or more sequences of: | |||
1. One <dt> element | 1. One <dt> element | |||
2. One <dd> element | 2. One <dd> element | |||
2.21.1. "anchor" Attribute | 2.22.1. "anchor" Attribute | |||
Document-wide unique identifier for the list. | Document-wide unique identifier for the list. | |||
2.21.2. "indent" Attribute | 2.22.2. "indent" Attribute | |||
Indicates the indentation to be used for the rendering of the second | Indicates the indentation to be used for the rendering of the second | |||
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.21.3. "newline" Attribute | 2.22.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="true" indicates that the | the same line as the definition. newline="false" indicates that the | |||
term is to the left of the definition, while newline="false" | term is to the left of the definition, while newline="true" indicates | |||
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" | o "false" (default) | |||
o "true" (default) | o "true" | |||
2.21.4. "spacing" Attribute | 2.22.4. "spacing" Attribute | |||
Defines whether or not there is a blank line between entries. | Defines whether or not there is a blank line between entries. | |||
spacing="normal" indicates a single blank line, while | spacing="normal" indicates a single blank line, while | |||
spacing="compact" indicates no space between. | spacing="compact" indicates no space between. | |||
Allowed values: | Allowed values: | |||
o "normal" (default) | o "normal" (default) | |||
o "compact" | o "compact" | |||
2.22. <dt> | 2.23. <dt> | |||
The term being defined in a definition list. | The term being defined in a definition list. | |||
This element appears as a child element of <dl> (Section 2.21). | This element appears as a child element of <dl> (Section 2.22). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.22.1. "anchor" Attribute | 2.23.1. "anchor" Attribute | |||
Document-wide unique identifier for this term. | Document-wide unique identifier for this term. | |||
2.23. <em> | 2.24. <em> | |||
Indicates text that is semantically emphasized. Text enclosed within | Indicates text that is semantically emphasized. Text enclosed within | |||
this element will be displayed as italic after processing. This | this element will be displayed as italic 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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <li> (Section 2.31), <name> | <dd> (Section 2.20), <dt> (Section 2.23), <li> (Section 2.32), <name> | |||
(Section 2.34), <preamble> (Section 3.6), <refcontent> | (Section 2.35), <preamble> (Section 3.6), <refcontent> | |||
(Section 2.42), <strong> (Section 2.54), <sub> (Section 2.55), <sup> | (Section 2.43), <strong> (Section 2.55), <sub> (Section 2.56), <sup> | |||
(Section 2.56), <t> (Section 2.57), <td> (Section 2.60), <th> | (Section 2.57), <t> (Section 2.58), <td> (Section 2.61), <th> | |||
(Section 2.62), and <tt> (Section 2.66). | (Section 2.63), and <tt> (Section 2.67). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.24. <email> | 2.25. <email> | |||
Provides an email address. | Provides an email address. | |||
The value is expected to be the addr-spec defined in Section 2 of | The value is expected to be the addr-spec defined in Section 2 of | |||
[RFC6068]. | [RFC6068]. | |||
This element appears as a child element of <address> (Section 2.2). | This element appears as a child element of <address> (Section 2.2). | |||
Content model: only text content. | Content model: only text content. | |||
2.24.1. "ascii" Attribute | 2.25.1. "ascii" Attribute | |||
The ASCII equivalent of the author's email address. This is only | The ASCII equivalent of the author's email address. This is only | |||
used if the email address has any internationalized components. | used if the email address has any internationalized components. | |||
2.25. <eref> | 2.26. <eref> | |||
Represents an "external" link (as specified in the "target" | Represents an "external" link (as specified in the "target" | |||
attribute). This is useful for embedding URIs in the body of a | attribute). This is useful for embedding URIs in the body of a | |||
document. | document. | |||
If the <eref> element has non-empty text content, formatters should | If the <eref> element has non-empty text content, formatters should | |||
use the content as the displayed text that is linked. Otherwise, the | use the content as the displayed text that is linked. Otherwise, the | |||
formatter should use the value of the "target" attribute as the | formatter should use the value of the "target" attribute as the | |||
displayed text. Formatters will link the displayed text to the value | displayed text. Formatters will link the displayed text to the value | |||
of the "target" attribute in a manner appropriate for the output | of the "target" attribute in a manner appropriate for the output | |||
format. | format. | |||
For example, with an input of: | For example, with an input of: | |||
This is described at | This is described at | |||
<eref target="http://www.example.com/reports/r12.html"/>. | <eref target="http://www.example.com/reports/r12.html"/>. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
This is described at | This is described at | |||
<a href="http://www.example.com/reports/r12.html"> | <a href="http://www.example.com/reports/r12.html"> | |||
http://www.example.com/reports/r12.html</a>. | http://www.example.com/reports/r12.html</a>. | |||
With an input of: | With an input of: | |||
This is described | This is described | |||
<eref target="http://www.example.com/reports/r12.html"> | <eref target="http://www.example.com/reports/r12.html"> | |||
in this interesting report</eref>. | in this interesting report</eref>. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
This is described | This is described | |||
<a href="http://www.example.com/reports/r12.html"> | <a href="http://www.example.com/reports/r12.html"> | |||
in this interesting report</a>. | in this interesting report</a>. | |||
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), <c> (Section 3.1), <cref> | (Section 2.3), <blockquote> (Section 2.11), <c> (Section 3.1), <cref> | |||
(Section 2.17), <dd> (Section 2.19), <dt> (Section 2.22), <em> | (Section 2.18), <dd> (Section 2.20), <dt> (Section 2.23), <em> | |||
(Section 2.23), <li> (Section 2.31), <name> (Section 2.34), | (Section 2.24), <li> (Section 2.32), <name> (Section 2.35), | |||
<postamble> (Section 3.5), <preamble> (Section 3.6), <strong> | <postamble> (Section 3.5), <preamble> (Section 3.6), <strong> | |||
(Section 2.54), <sub> (Section 2.55), <sup> (Section 2.56), <t> | (Section 2.55), <sub> (Section 2.56), <sup> (Section 2.57), <t> | |||
(Section 2.57), <td> (Section 2.60), <th> (Section 2.62), <tt> | (Section 2.58), <td> (Section 2.61), <th> (Section 2.63), <tt> | |||
(Section 2.66), and <ttcol> (Section 3.9). | (Section 2.67), and <ttcol> (Section 3.9). | |||
Content model: only text content. | Content model: only text content. | |||
2.25.1. "target" Attribute (Mandatory) | 2.26.1. "brackets" Attribute | |||
Determines whether the formatter should automatically enclose the URI | ||||
in angle brackets ("angle") or not (default of "none"). | ||||
Allowed values: | ||||
o "none" (default) | ||||
o "angle" | ||||
2.26.2. "target" Attribute (Mandatory) | ||||
URI of the link target [RFC3986]. This must begin with a scheme name | URI of the link target [RFC3986]. This must begin with a scheme name | |||
(such as "https://") and thus not be relative to the URL of the | (such as "https://") and thus not be relative to the URL of the | |||
current document. | current document. | |||
2.26. <extaddr> | 2.27. <extaddr> | |||
TBD | TBD | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.26.1. "ascii" Attribute | 2.27.1. "ascii" Attribute | |||
ASCII equivalent for extaddr. | ASCII equivalent for extaddr. | |||
2.27. <figure> | 2.28. <figure> | |||
Contains a figure with a caption with the figure number. If the | Contains a figure with a caption with the figure number. If the | |||
element contains a <name> element, the caption will also show that | element contains a <name> element, the caption will also show that | |||
name. | name. | |||
This element appears as a child element of <aside> (Section 2.7), | This element appears as a child element of <aside> (Section 2.7), | |||
<blockquote> (Section 2.11), <dd> (Section 2.19), <li> | <blockquote> (Section 2.11), <dd> (Section 2.20), <li> | |||
(Section 2.31), <section> (Section 2.49), <td> (Section 2.60), and | (Section 2.32), <section> (Section 2.50), <td> (Section 2.61), and | |||
<th> (Section 2.62). | <th> (Section 2.63). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. Optional <iref> elements (Section 2.29) | ||||
2. Optional <iref> elements (Section 2.30) | ||||
3. One optional <preamble> element (Section 3.6) | 3. One optional <preamble> element (Section 3.6) | |||
4. In any order, but at least one of: | 4. In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <sourcecode> elements (Section 2.52) | * <sourcecode> elements (Section 2.53) | |||
5. One optional <postamble> element (Section 3.5) | 5. One optional <postamble> element (Section 3.5) | |||
2.27.1. "align" Attribute | 2.28.1. "align" Attribute | |||
Deprecated. | Deprecated. | |||
Note: does not affect title or <artwork> alignment. | Note: does not affect title or <artwork> alignment. | |||
Allowed values: | Allowed values: | |||
o "left" (default) | o "left" (default) | |||
o "center" | o "center" | |||
o "right" | o "right" | |||
2.27.2. "alt" Attribute | 2.28.2. "alt" Attribute | |||
Deprecated. If the goal is to provide a single URI for a reference, | Deprecated - use "alt" attribute on <artwork> element instead | |||
use the "target" attribute in <reference> instead. | (Section 2.6.2). | |||
2.27.3. "anchor" Attribute | 2.28.3. "anchor" Attribute | |||
Document-wide unique identifier for this figure. | Document-wide unique identifier for this figure. | |||
2.27.4. "height" Attribute | 2.28.4. "height" Attribute | |||
Deprecated. | Deprecated - use "height" attribute on <artwork> element instead | |||
(Section 2.6.4). | ||||
2.27.5. "src" Attribute | 2.28.5. "src" Attribute | |||
Deprecated. | Deprecated - use "src" attribute on <artwork> element instead | |||
(Section 2.6.6). | ||||
2.27.6. "suppress-title" Attribute | 2.28.6. "suppress-title" Attribute | |||
Deprecated. | Deprecated. | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.27.7. "title" Attribute | 2.28.7. "title" Attribute | |||
Deprecated. Use <name> instead. | Deprecated. Use <name> instead. | |||
2.27.8. "width" Attribute | 2.28.8. "width" Attribute | |||
Deprecated. | Deprecated - use "width" attribute on <artwork> element instead | |||
(Section 2.6.8). | ||||
2.28. <front> | 2.29. <front> | |||
Represents the "front matter": metadata (such as author information), | Represents the "front matter": metadata (such as author information), | |||
the Abstract, and additional notes. | the Abstract, and additional notes. | |||
A <front> element may have more than one <seriesInfo> element. A | This element appears as a child element of <reference> (Section 2.44) | |||
<seriesInfo> element determines the document number (for RFCs) or | and <rfc> (Section 2.49). | |||
name (for Internet-Drafts). Another <seriesInfo> element determines | ||||
the "maturity level" (defined in [RFC2026]), using values of "std" | ||||
for "Standards Track", "bcp" for "BCP", "info" for "Informational", | ||||
"exp" for "Experimental", and "historic" for "Historic". The "name" | ||||
attributes of those multiple <seriesInfo> elements interact as | ||||
described in Section 2.50. | ||||
This element appears as a child element of <reference> (Section 2.43) | ||||
and <rfc> (Section 2.48). | ||||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One <title> element (Section 2.64) | 1. One <title> element (Section 2.65) | |||
2. Optional <seriesInfo> elements (Section 2.50) | 2. Optional <seriesInfo> elements (Section 2.51) | |||
3. One or more <author> elements (Section 2.8) | 3. One or more <author> elements (Section 2.8) | |||
4. One optional <date> element (Section 2.18) | ||||
5. Optional <area> elements (Section 2.4) | 4. One optional <date> element (Section 2.19) | |||
6. Optional <workgroup> elements (Section 2.69) | 5. Optional <area> elements (Section 2.4) | |||
7. Optional <keyword> elements (Section 2.30) | 6. Optional <workgroup> elements (Section 2.70) | |||
7. Optional <keyword> elements (Section 2.31) | ||||
8. One optional <abstract> element (Section 2.1) | 8. One optional <abstract> element (Section 2.1) | |||
9. Optional <note> elements (Section 2.35) | 9. Optional <note> elements (Section 2.36) | |||
10. One optional <boilerplate> element (Section 2.12) | 10. One optional <boilerplate> element (Section 2.12) | |||
2.29. <iref> | 2.30. <iref> | |||
Provides terms for the document's index. | Provides terms for the document's index. | |||
Index entries can be either regular entries (when just the "item" | Index entries can be either regular entries (when just the "item" | |||
attribute is given) or nested entries (by specifying "subitem" as | attribute is given) or nested entries (by specifying "subitem" as | |||
well), grouped under a regular entry. | well), grouped under a regular entry. | |||
Index entries generally refer to the exact place where the <iref> | Index entries generally refer to the exact place where the <iref> | |||
element occurred. An exception is the occurrence as a child element | element occurred. An exception is the occurrence as a child element | |||
of <section>, in which case the whole section is considered to be | of <section>, in which case the whole section is considered to be | |||
relevant for that index entry. In some formats, index entries of | relevant for that index entry. In some formats, index entries of | |||
this type might be displayed as ranges. | this type might be displayed as ranges. | |||
When the prep tool is creating index content, it collects the items | When the prep tool is creating index content, it collects the items | |||
in a case-sensitive fashion for both the item and subitem level. | in a case-sensitive fashion for both the item and subitem level. | |||
This element appears as a child element of <annotation> | This element appears as a child element of <annotation> | |||
(Section 2.3), <aside> (Section 2.7), <blockquote> (Section 2.11), | (Section 2.3), <aside> (Section 2.7), <blockquote> (Section 2.11), | |||
<c> (Section 3.1), <dd> (Section 2.19), <dt> (Section 2.22), <em> | <c> (Section 3.1), <dd> (Section 2.20), <dt> (Section 2.23), <em> | |||
(Section 2.23), <figure> (Section 2.27), <li> (Section 2.31), <name> | (Section 2.24), <figure> (Section 2.28), <li> (Section 2.32), <name> | |||
(Section 2.34), <postamble> (Section 3.5), <preamble> (Section 3.6), | (Section 2.35), <postamble> (Section 3.5), <preamble> (Section 3.6), | |||
<section> (Section 2.49), <strong> (Section 2.54), <sub> | <section> (Section 2.50), <strong> (Section 2.55), <sub> | |||
(Section 2.55), <sup> (Section 2.56), <t> (Section 2.57), <td> | (Section 2.56), <sup> (Section 2.57), <t> (Section 2.58), <td> | |||
(Section 2.60), <th> (Section 2.62), <tt> (Section 2.66), and <ttcol> | (Section 2.61), <th> (Section 2.63), <tt> (Section 2.67), and <ttcol> | |||
(Section 3.9). | (Section 3.9). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
2.29.1. "item" Attribute (Mandatory) | 2.30.1. "item" Attribute (Mandatory) | |||
The item to include. | The item to include. | |||
2.29.2. "primary" Attribute | 2.30.2. "primary" Attribute | |||
Setting this to "true" declares the occurrence as "primary", which | Setting this to "true" declares the occurrence as "primary", which | |||
might cause it to be highlighted in the index. There is no | might cause it to be highlighted in the index. There is no | |||
restriction on the number of occurrences that can be "primary". | restriction on the number of occurrences that can be "primary". | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.29.3. "subitem" Attribute | 2.30.3. "subitem" Attribute | |||
The subitem to include. | The subitem to include. | |||
2.30. <keyword> | 2.31. <keyword> | |||
Specifies a keyword applicable to the document. | Specifies a keyword applicable to the document. | |||
Note that each element should only contain a single keyword; for | Note that each element should only contain a single keyword; for | |||
multiple keywords, the element can simply be repeated. | multiple keywords, the element can simply be repeated. | |||
Keywords are used both in the RFC Index and in the metadata of | Keywords are used both in the RFC Index and in the metadata of | |||
generated document representations. | generated document representations. | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: only text content. | Content model: only text content. | |||
2.31. <li> | 2.32. <li> | |||
A list element, used in <ol> and <ul>. | A list element, used in <ol> and <ul>. | |||
This element appears as a child element of <ol> (Section 2.36) and | This element appears as a child element of <ol> (Section 2.37) and | |||
<ul> (Section 2.67). | <ul> (Section 2.68). | |||
Content model: | Content model: | |||
Either: | Either: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <blockquote> elements (Section 2.11) | ||||
* <dl> elements (Section 2.21) | * <blockquote> elements (Section 2.11) | |||
* <figure> elements (Section 2.27) | * <dl> elements (Section 2.22) | |||
* <ol> elements (Section 2.36) | * <figure> elements (Section 2.28) | |||
* <sourcecode> elements (Section 2.52) | * <ol> elements (Section 2.37) | |||
* <sourcecode> elements (Section 2.53) | ||||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
Or: | Or: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* Text | * Text | |||
* <bcp14> elements (Section 2.10) | * <bcp14> elements (Section 2.10) | |||
* <cref> elements (Section 2.17) | * <cref> elements (Section 2.18) | |||
* <em> elements (Section 2.23) | * <em> elements (Section 2.24) | |||
* <eref> elements (Section 2.25) | * <eref> elements (Section 2.26) | |||
* <iref> elements (Section 2.29) | * <iref> elements (Section 2.30) | |||
* <relref> elements (Section 2.47) | * <relref> elements (Section 2.48) | |||
* <strong> elements (Section 2.54) | * <strong> elements (Section 2.55) | |||
* <sub> elements (Section 2.55) | * <sub> elements (Section 2.56) | |||
* <sup> elements (Section 2.56) | * <sup> elements (Section 2.57) | |||
* <tt> elements (Section 2.66) | * <tt> elements (Section 2.67) | |||
* <xref> elements (Section 2.70) | * <xref> elements (Section 2.71) | |||
2.31.1. "anchor" Attribute | 2.32.1. "anchor" Attribute | |||
Document-wide unique identifier for this list item. | Document-wide unique identifier for this list item. | |||
2.32. <link> | 2.33. <link> | |||
A link to an external document that is related to the RFC. | A link to an external document that is related to the RFC. | |||
The following are the supported types of external documents that can | The following are the supported types of external documents that can | |||
be pointed to in a <link> element: | be pointed to in a <link> element: | |||
o The current International Standard Serial Number (ISSN) for the | o The current International Standard Serial Number (ISSN) for the | |||
RFC Series. The value for the "rel" attribute is "item". The | RFC Series. The value for the "rel" attribute is "item". The | |||
link should use the form "urn:issn:". | link should use the form "urn:issn:". | |||
skipping to change at page 38, line 39 ¶ | skipping to change at page 40, line 35 ¶ | |||
o A representation of the document offered by the document author. | o A representation of the document offered by the document author. | |||
The value for the "rel" attribute is "alternate". The link can be | The value for the "rel" attribute is "alternate". The link can be | |||
to a personally run web site. | to a personally run web site. | |||
In RFC production mode, the prep tool needs to check the values for | In RFC production mode, the prep tool needs to check the values for | |||
<link> before an RFC is published. In draft production mode, the | <link> before an RFC is published. In draft production mode, the | |||
prep tool might remove some <link> elements during the draft | prep tool might remove some <link> elements during the draft | |||
submission process. | submission process. | |||
This element appears as a child element of <rfc> (Section 2.48). | This element appears as a child element of <rfc> (Section 2.49). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
2.32.1. "href" Attribute (Mandatory) | 2.33.1. "href" Attribute (Mandatory) | |||
The URI of the external document. | The URI of the external document. | |||
2.32.2. "rel" Attribute | 2.33.2. "rel" Attribute | |||
The relationship of the external document to this one. The | The relationship of the external document to this one. The | |||
relationships are taken from the "Link Relations" registry maintained | relationships are taken from the "Link Relations" registry maintained | |||
by IANA [LINKRELATIONS]. | by IANA [LINKRELATIONS]. | |||
2.33. <middle> | 2.34. <middle> | |||
Represents the main content of the document. | Represents the main content of the document. | |||
This element appears as a child element of <rfc> (Section 2.48). | This element appears as a child element of <rfc> (Section 2.49). | |||
Content model: | Content model: | |||
One or more <section> elements (Section 2.49) | One or more <section> elements (Section 2.50) | |||
2.34. <name> | 2.35. <name> | |||
The name of the section, note, figure, or texttable. This name can | The name of the section, note, figure, or texttable. This name can | |||
indicate markup of flowing text (for example, including references or | indicate markup of flowing text (for example, including references or | |||
making some characters use a fixed-width font). | making some characters use a fixed-width font). | |||
This element appears as a child element of <figure> (Section 2.27), | This element appears as a child element of <figure> (Section 2.28), | |||
<note> (Section 2.35), <references> (Section 2.45), <section> | <note> (Section 2.36), <references> (Section 2.46), <section> | |||
(Section 2.49), <table> (Section 2.58), and <texttable> | (Section 2.50), <table> (Section 2.59), and <texttable> | |||
(Section 3.8). | (Section 3.8). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.35. <note> | 2.36. <note> | |||
Creates an unnumbered, titled block of text that appears after the | Creates an unnumbered, titled block of text that appears after the | |||
Abstract. | Abstract. | |||
It is usually used for additional information to reviewers (Working | It is usually used for additional information to reviewers (Working | |||
Group information, mailing list, ...) or for additional publication | Group information, mailing list, ...) or for additional publication | |||
information such as "IESG Notes". | information such as "IESG Notes". | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. In any order, but at least one of: | 2. In any order, but at least one of: | |||
* <dl> elements (Section 2.21) | * <dl> elements (Section 2.22) | |||
* <ol> elements (Section 2.36) | * <ol> elements (Section 2.37) | |||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
2.35.1. "removeInRFC" Attribute | 2.36.1. "removeInRFC" Attribute | |||
If set to "true", this note is marked in the prep tool with text | If set to "true", this note is marked in the prep tool with text | |||
indicating that it should be removed before the document is published | indicating that it should be removed before the document is published | |||
as an RFC. That text will be "This note is to be removed before | as an RFC. That text will be "This note is to be removed before | |||
publishing as an RFC." | publishing as an RFC." | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.35.2. "title" Attribute | 2.36.2. "title" Attribute | |||
Deprecated. Use <name> instead. | Deprecated. Use <name> instead. | |||
2.36. <ol> | 2.37. <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 style 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.19), <li> (Section 2.31), <note> (Section 2.35), <section> | (Section 2.20), <li> (Section 2.32), <note> (Section 2.36), <section> | |||
(Section 2.49), <td> (Section 2.60), and <th> (Section 2.62). | (Section 2.50), <td> (Section 2.61), and <th> (Section 2.63). | |||
Content model: | Content model: | |||
One or more <li> elements (Section 2.31) | One or more <li> elements (Section 2.32) | |||
2.36.1. "anchor" Attribute | 2.37.1. "anchor" Attribute | |||
Document-wide unique identifier for the list. | Document-wide unique identifier for the list. | |||
2.36.2. "group" Attribute | 2.37.2. "group" Attribute | |||
When the prep tool sees an <ol> element with a "group" attribute that | When the prep tool sees an <ol> element with a "group" attribute that | |||
has already been seen, it continues the numbering of the list from | has already been seen, it continues the numbering of the list from | |||
where the previous list with the same group name left off. If an | where the previous list with the same group name left off. If an | |||
<ol> element has both a "group" attribute and a "start" attribute, | <ol> element has both a "group" attribute and a "start" attribute, | |||
the group's numbering is reset to the given start value. | the group's numbering is reset to the given start value. | |||
2.36.3. "spacing" Attribute | 2.37.3. "spacing" Attribute | |||
Defines whether or not there is a blank line between entries. | Defines whether or not there is a blank line between entries. | |||
spacing="normal" indicates a single blank line, while | spacing="normal" indicates a single blank line, while | |||
spacing="compact" indicates no space between. | spacing="compact" indicates no space between. | |||
Allowed values: | Allowed values: | |||
o "normal" (default) | o "normal" (default) | |||
o "compact" | o "compact" | |||
2.36.4. "start" Attribute | 2.37.4. "start" Attribute | |||
The ordinal value at which to start the list. This defaults to "1" | The ordinal value at which to start the list. This defaults to "1" | |||
and must be an integer of 0 or greater. | and must be an integer of 0 or greater. | |||
2.36.5. "type" Attribute | 2.37.5. "type" Attribute | |||
The type of the labels on list items. If the length of the type | The type of the labels on list items. If the length of the type | |||
value is 1, the meaning is the same as it is for HTML: | value is 1, the meaning is the same as it is for HTML: | |||
a Lowercase letters (a, b, c, ...) | a Lowercase letters (a, b, c, ...) | |||
A Uppercase letters (A, B, C, ...) | A Uppercase letters (A, B, C, ...) | |||
1 Decimal numbers (1, 2, 3, ...) | 1 Decimal numbers (1, 2, 3, ...) | |||
skipping to change at page 43, line 5 ¶ | skipping to change at page 45, line 5 ¶ | |||
Other formats are reserved for future use. Only one percent encoding | Other formats are reserved for future use. Only one percent encoding | |||
other than "%%" is allowed in a type string. | other than "%%" is allowed in a type string. | |||
It is an error for the type string to be empty. For bulleted lists, | It is an error for the type string to be empty. For bulleted lists, | |||
use the <ul> element. For lists that have neither bullets nor | use the <ul> element. For lists that have neither bullets nor | |||
numbers, use the <ul> element with the 'empty="true"' attribute. | numbers, use the <ul> element with the 'empty="true"' attribute. | |||
If no type attribute is given, the default type is the same as | If no type attribute is given, the default type is the same as | |||
"type='%d.'". | "type='%d.'". | |||
2.37. <organization> | 2.38. <organization> | |||
Specifies the affiliation [RFC7322] of an author. | Specifies the affiliation [RFC7322] of an author. | |||
This information appears both in the "Author's Address" section and | This information appears both in the "Author's Address" section and | |||
on the front page (see [RFC7322] for more information). If the value | on the front page (see [RFC7322] for more information). If the value | |||
is long, an abbreviated variant can be specified in the "abbrev" | is long, an abbreviated variant can be specified in the "abbrev" | |||
attribute. | attribute. | |||
This element appears as a child element of <author> (Section 2.8). | This element appears as a child element of <author> (Section 2.8) and | |||
<contact> (Section 2.16). | ||||
Content model: only text content. | Content model: only text content. | |||
2.37.1. "abbrev" Attribute | 2.38.1. "abbrev" Attribute | |||
Abbreviated variant. | Abbreviated variant. | |||
2.37.2. "ascii" Attribute | 2.38.2. "ascii" Attribute | |||
The ASCII equivalent of the organization's name. | The ASCII equivalent of the organization's name. | |||
2.37.3. "asciiAbbrev" Attribute | 2.38.3. "asciiAbbrev" Attribute | |||
To support abbreviated organization names in both ASCII and non-ASCII | To support abbreviated organization names in both ASCII and non-ASCII | |||
contexts. | contexts. | |||
2.37.4. "showOnFrontPage" Attribute | 2.38.4. "showOnFrontPage" Attribute | |||
To support turning off listing organization with author name. | To support turning off listing organization with author name. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.38. <phone> | 2.39. <phone> | |||
Represents a phone number. | Represents a phone number. | |||
The value is expected to be the scheme-specific part of a "tel" URI | The value is expected to be the scheme-specific part of a "tel" URI | |||
(and so does not include the prefix "tel:"), using the "global- | (and so does not include the prefix "tel:"), using the "global- | |||
number-digits" syntax. See Section 3 of [RFC3966] for details. | number-digits" syntax. See Section 3 of [RFC3966] for details. | |||
This element appears as a child element of <address> (Section 2.2). | This element appears as a child element of <address> (Section 2.2). | |||
Content model: only text content. | Content model: only text content. | |||
2.39. <pobox> | 2.40. <pobox> | |||
TBD | TBD | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.39.1. "ascii" Attribute | 2.40.1. "ascii" Attribute | |||
ASCII equivalent for pobox. | ASCII equivalent for pobox. | |||
2.40. <postal> | 2.41. <postal> | |||
Contains optional child elements providing postal information. These | Contains optional child elements providing postal information. These | |||
elements will be displayed in an order that is specific to | elements will be displayed in an order that is specific to | |||
formatters. A postal address can contain only a set of <street>, | formatters. A postal address can contain only a set of <street>, | |||
<city>, <region>, <code>, and <country> elements, or only an ordered | <city>, <region>, <code>, and <country> elements, or only an ordered | |||
set of <postalLine> elements, but not both. | set of <postalLine> elements, but not both. | |||
This element appears as a child element of <address> (Section 2.2). | This element appears as a child element of <address> (Section 2.2). | |||
Content model: | Content model: | |||
skipping to change at page 44, line 39 ¶ | skipping to change at page 46, line 39 ¶ | |||
Either: | Either: | |||
In any order: | In any order: | |||
* <city> elements (Section 2.13) | * <city> elements (Section 2.13) | |||
* <cityarea> elements (Section 2.14) | * <cityarea> elements (Section 2.14) | |||
* <code> elements (Section 2.15) | * <code> elements (Section 2.15) | |||
* <country> elements (Section 2.16) | * <country> elements (Section 2.17) | |||
* <extaddr> elements (Section 2.26) | * <extaddr> elements (Section 2.27) | |||
* <pobox> elements (Section 2.39) | * <pobox> elements (Section 2.40) | |||
* <region> elements (Section 2.46) | * <region> elements (Section 2.47) | |||
* <sortingcode> elements (Section 2.51) | * <sortingcode> elements (Section 2.52) | |||
* <street> elements (Section 2.53) | * <street> elements (Section 2.54) | |||
Or: | Or: | |||
One or more <postalLine> elements (Section 2.41) | One or more <postalLine> elements (Section 2.42) | |||
2.41. <postalLine> | 2.42. <postalLine> | |||
Represents one line of a postal address. When more than one | Represents one line of a postal address. When more than one | |||
<postalLine> is given, the prep tool emits them in the order given. | <postalLine> is given, the prep tool emits them in the order given. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.41.1. "ascii" Attribute | 2.42.1. "ascii" Attribute | |||
The ASCII equivalent of the text in the address line. | The ASCII equivalent of the text in the address line. | |||
2.42. <refcontent> | 2.43. <refcontent> | |||
Text that should appear between the title and the date of a | Text that should appear between the title and the date of a | |||
reference. The purpose of this element is to prevent the need to | reference. The purpose of this element is to prevent the need to | |||
abuse <seriesInfo> to get such text in a reference. | abuse <seriesInfo> to get such text in a reference. | |||
For example: | For example: | |||
<reference anchor="April1"> | <reference anchor="April1"> | |||
<front> | <front> | |||
<title>On Being A Fool</title> | <title>On Being A Fool</title> | |||
<author initials="K." surname="Phunny" fullname="Knot Phunny"/> | <author initials="K." surname="Phunny" fullname="Knot Phunny"/> | |||
<date year="2000" month="April"/> | <date year="2000" month="April"/> | |||
</front> | </front> | |||
<refcontent>Self-published pamphlet</refcontent> | <refcontent>Self-published pamphlet</refcontent> | |||
</reference> | </reference> | |||
would render as: | would render as: | |||
[April1] Phunny, K., "On Being A Fool", Self-published | [April1] Phunny, K., "On Being A Fool", Self-published | |||
pamphlet, April 2000. | pamphlet, April 2000. | |||
This element appears as a child element of <reference> | This element appears as a child element of <reference> | |||
(Section 2.43). | (Section 2.44). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
2.43. <reference> | 2.44. <reference> | |||
Represents a bibliographic reference. | Represents a bibliographic reference. | |||
This element appears as a child element of <referencegroup> | This element appears as a child element of <referencegroup> | |||
(Section 2.44) and <references> (Section 2.45). | (Section 2.45) and <references> (Section 2.46). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One <front> element (Section 2.28) | 1. One <front> element (Section 2.29) | |||
2. In any order: | 2. In any order: | |||
* <annotation> elements (Section 2.3) | * <annotation> elements (Section 2.3) | |||
* <format> elements (Section 3.3) | * <format> elements (Section 3.3) | |||
* <refcontent> elements (Section 2.42) | * <refcontent> elements (Section 2.43) | |||
* <seriesInfo> elements (Section 2.50) | * <seriesInfo> elements (Section 2.51) | |||
2.43.1. "anchor" Attribute (Mandatory) | 2.44.1. "anchor" Attribute (Mandatory) | |||
Document-wide unique identifier for this reference. Usually, this | Document-wide unique identifier for this reference. Usually, this | |||
will be used both to "label" the reference in the "References" | will be used both to "label" the reference in the "References" | |||
section and as an identifier in links to this reference entry. | section and as an identifier in links to this reference entry. | |||
2.43.2. "quote-title" Attribute | 2.44.2. "quote-title" Attribute | |||
Specifies whether or not the title in the reference should be quoted. | Specifies whether or not the title in the reference should be quoted. | |||
This can be used to prevent quoting, such as on errata. | This can be used to prevent quoting, such as on errata. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.43.3. "target" Attribute | 2.44.3. "target" Attribute | |||
Holds the URI for the reference. | Holds the URI for the reference. | |||
2.44. <referencegroup> | 2.45. <referencegroup> | |||
Represents a list of bibliographic references that will be | Represents a list of bibliographic references that will be | |||
represented as a single reference. This is most often used to | represented as a single reference. This is most often used to | |||
reference STDs and BCPs, where a single reference (such as "BCP 9") | reference STDs and BCPs, where a single reference (such as "BCP 9") | |||
may encompass more than one RFC. | may encompass more than one RFC. | |||
This element appears as a child element of <references> | This element appears as a child element of <references> | |||
(Section 2.45). | (Section 2.46). | |||
Content model: | Content model: | |||
One or more <reference> elements (Section 2.43) | One or more <reference> elements (Section 2.44) | |||
2.44.1. "anchor" Attribute (Mandatory) | 2.45.1. "anchor" Attribute (Mandatory) | |||
Document-wide unique identifier for this reference group. Usually, | Document-wide unique identifier for this reference group. Usually, | |||
this will be used both to "label" the reference group in the | this will be used both to "label" the reference group in the | |||
"References" section and as an identifier in links to this reference | "References" section and as an identifier in links to this reference | |||
entry. | entry. | |||
2.44.2. "target" Attribute | 2.45.2. "target" Attribute | |||
Holds the URI for the reference. | Holds the URI for the reference. | |||
Holds the URI for the reference. | Holds the URI for the reference. | |||
2.45. <references> | 2.46. <references> | |||
Contains a set of bibliographic references. | Contains a set of bibliographic references. | |||
In the early days of the RFC Series, there was only one "References" | In the early days of the RFC Series, there was only one "References" | |||
section per RFC. This convention was later changed to group | section per RFC. This convention was later changed to group | |||
references into two sets, "Normative" and "Informative", as described | references into two sets, "Normative" and "Informative", as described | |||
in [RFC7322]. This vocabulary supports the split with the <name> | in [RFC7322]. This vocabulary supports the split with the <name> | |||
child element. In general, the title should be either "Normative | child element. In general, the title should be either "Normative | |||
References" or "Informative References". | References" or "Informative References". | |||
This element appears as a child element of <back> (Section 2.9) and | This element appears as a child element of <back> (Section 2.9) and | |||
<references> (Section 2.45). | <references> (Section 2.46). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. Either: | 2. Either: | |||
* One or more <references> elements (Section 2.45) | * One or more <references> elements (Section 2.46) | |||
Or: | Or: | |||
* In any order: | * In any order: | |||
+ <reference> elements (Section 2.43) | + <reference> elements (Section 2.44) | |||
+ <referencegroup> elements (Section 2.44) | + <referencegroup> elements (Section 2.45) | |||
2.45.1. "anchor" Attribute | 2.46.1. "anchor" Attribute | |||
An optional user-supplied identifier for this set of references. | An optional user-supplied identifier for this set of references. | |||
2.45.2. "title" Attribute | 2.46.2. "title" Attribute | |||
Deprecated. Use <name> instead. | Deprecated. Use <name> instead. | |||
2.46. <region> | 2.47. <region> | |||
Provides the region name in a postal address. | Provides the region name in a postal address. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.46.1. "ascii" Attribute | 2.47.1. "ascii" Attribute | |||
The ASCII equivalent of the region name. | The ASCII equivalent of the region name. | |||
2.47. <relref> | 2.48. <relref> | |||
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 | |||
part of the reference, creating the link target by combining the base | part of the reference, creating the link target by combining the base | |||
URI from the <reference> element with the "relative" attribute from | URI from the <reference> element with the "relative" attribute from | |||
this element. The "target" attribute is required, and it must be the | this element. The "target" attribute is required, and it must be the | |||
anchor of a <reference> element. | anchor of a <reference> element. | |||
The "section" attribute is required, and the "relative" attribute is | The "section" attribute is required, and the "relative" attribute is | |||
optional. If the reference is not an RFC or Internet-Draft that is | optional. If the reference is not an RFC or Internet-Draft that is | |||
in the v3 format, the element needs to have a "relative" attribute; | in the v3 format, the element needs to have a "relative" attribute; | |||
in this case, the value of the "section" attribute is ignored. | in this case, the value of the "section" attribute is ignored. | |||
An example of the <relref> element with text content might be: | An example of the <relref> element with text content might be: | |||
See | See | |||
<relref section="2.3" target="RFC9999" displayFormat="bare"> | <relref section="2.3" target="RFC9999" displayFormat="bare"> | |||
the protocol overview</relref> | the protocol overview</relref> | |||
for more information. | for more information. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See | See | |||
<a href="http://www.rfc-editor.org/rfc/rfc9999.html#s-2.3"> | <a href="http://www.rfc-editor.org/rfc/rfc9999.html#s-2.3"> | |||
the protocol overview</a> | the protocol overview</a> | |||
for more information. | for more information. | |||
Note that the URL in the above example might be different when the | Note that the URL in the above example might be different when the | |||
RFC Editor deploys the v3 format. | RFC Editor deploys the v3 format. | |||
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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | <dd> (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <preamble> (Section 3.6), | (Section 2.32), <name> (Section 2.35), <preamble> (Section 3.6), | |||
<strong> (Section 2.54), <sub> (Section 2.55), <sup> (Section 2.56), | <strong> (Section 2.55), <sub> (Section 2.56), <sup> (Section 2.57), | |||
<t> (Section 2.57), <td> (Section 2.60), <th> (Section 2.62), and | <t> (Section 2.58), <td> (Section 2.61), <th> (Section 2.63), and | |||
<tt> (Section 2.66). | <tt> (Section 2.67). | |||
Content model: only text content. | Content model: only text content. | |||
2.47.1. "displayFormat" Attribute | 2.48.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 | |||
"Section" followed by a space, the contents of the "section" | "Section" followed by a space, the contents of the "section" | |||
attribute followed by a space, the word "of", another space, and | attribute followed by a space, the word "of", another space, and | |||
the value from the "target" attribute enclosed in square brackets. | the value from the "target" attribute enclosed in square brackets. | |||
For example, with an input of: | For example, with an input of: | |||
See | See | |||
<relref section="2.3" target="RFC9999" displayFormat="of"/> | <relref section="2.3" target="RFC9999" displayFormat="of"/> | |||
for an overview. | for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See | See | |||
<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | |||
Section 2.3</a> of | Section 2.3</a> of | |||
[<a href="#RFC9999">RFC9999</a>] | [<a href="#RFC9999">RFC9999</a>] | |||
for an overview. | for an overview. | |||
Note that "displayFormat='of'" is the default for <relref>, so it | Note that "displayFormat='of'" is the default for <relref>, so it | |||
does not need to be given in a <relref> element if that format is | does not need to be given in a <relref> element if that format is | |||
desired. | desired. | |||
"comma" | "comma" | |||
A formatter should display the relative reference as the value | A formatter should display the relative reference as the value | |||
from the "target" attribute enclosed in square brackets, a comma, | from the "target" attribute enclosed in square brackets, a comma, | |||
a space, the word "Section" followed by a space, and the "section" | a space, the word "Section" followed by a space, and the "section" | |||
attribute. | attribute. | |||
For example, with an input of: | For example, with an input of: | |||
See | See | |||
<relref section="2.3" target="RFC9999" displayFormat="comma"/>, | <relref section="2.3" target="RFC9999" displayFormat="comma"/>, | |||
for an overview. | for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See | See | |||
[<a href="#RFC9999">RFC9999</a>], | [<a href="#RFC9999">RFC9999</a>], | |||
<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | |||
Section 2.3</a>, for an overview. | Section 2.3</a>, for an overview. | |||
"parens" | "parens" | |||
A formatter should display the relative reference as the value | A formatter should display the relative reference as the value | |||
from the "target" attribute enclosed in square brackets, a space, | from the "target" attribute enclosed in square brackets, a space, | |||
a left parenthesis, the word "Section" followed by a space, the | a left parenthesis, the word "Section" followed by a space, the | |||
"section" attribute, and a right parenthesis. | "section" attribute, and a right parenthesis. | |||
For example, with an input of: | For example, with an input of: | |||
See | See | |||
<relref section="2.3" target="RFC9999" displayFormat="parens"/> | <relref section="2.3" target="RFC9999" displayFormat="parens"/> | |||
for an overview. | for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See | See | |||
[<a href="#RFC9999">RFC9999</a>] | [<a href="#RFC9999">RFC9999</a>] | |||
(<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | (<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | |||
Section 2.3</a>) | Section 2.3</a>) | |||
for an overview. | for an overview. | |||
"bare" | "bare" | |||
A formatter should display the relative reference as the contents | A formatter should display the relative reference as the contents | |||
of the "section" attribute and nothing else. This is useful when | of the "section" attribute and nothing else. This is useful when | |||
there are multiple relative references to a single base reference. | there are multiple relative references to a single base reference. | |||
For example: | For example: | |||
See Sections | See Sections | |||
<relref section="2.3" target="RFC9999" displayFormat="bare"/> | <relref section="2.3" target="RFC9999" displayFormat="bare"/> | |||
and | and | |||
<relref section="2.4" target="RFC9999" displayFormat="of"/> | <relref section="2.4" target="RFC9999" displayFormat="of"/> | |||
for an overview. | for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See Sections | See Sections | |||
<a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | <a href="http://www.rfc-editor.org/info/rfc9999#s-2.3"> | |||
2.3</a> | 2.3</a> | |||
and | and | |||
<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" | |||
2.47.2. "relative" Attribute | 2.48.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. | |||
2.47.3. "section" Attribute (Mandatory) | 2.48.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. | |||
2.47.4. "target" Attribute (Mandatory) | 2.48.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. | |||
2.48. <rfc> | 2.49. <rfc> | |||
This is the root element of the xml2rfc vocabulary. | This is the root element of the xml2rfc vocabulary. | |||
Processors distinguish between RFC mode ("number" attribute being | ||||
present) and Internet-Draft mode ("docName" present and "number" | ||||
absent): when both are present, "number" takes precedence. Setting | ||||
neither "number" nor "docName" can be useful for producing other | ||||
types of documents but is out of scope for this specification. | ||||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. Optional <link> elements (Section 2.32) | 1. Optional <link> elements (Section 2.33) | |||
2. One <front> element (Section 2.28) | 2. One <front> element (Section 2.29) | |||
3. One <middle> element (Section 2.33) | 3. One <middle> element (Section 2.34) | |||
4. One optional <back> element (Section 2.9) | 4. One optional <back> element (Section 2.9) | |||
2.48.1. "category" Attribute | 2.49.1. "category" Attribute | |||
Deprecated; instead, use the "name" attribute in <seriesInfo>. | Document category (see Appendix A.1). | |||
2.48.2. "consensus" Attribute | Allowed values: | |||
o "std" | ||||
o "bcp" | ||||
o "info" | ||||
o "exp" | ||||
o "historic" | ||||
2.49.2. "consensus" Attribute | ||||
Affects the generated boilerplate. Note that the values of "no" and | Affects the generated boilerplate. Note that the values of "no" and | |||
"yes" are deprecated and are replaced by "false" (the default) and | "yes" are deprecated and are replaced by "false" (the default) and | |||
"true". | "true". | |||
See [RFC7841] for more information. | See [RFC7841] and Appendix A.4 for more information. | |||
Allowed values: | Allowed values: | |||
o "no" | o "no" | |||
o "yes" | o "yes" | |||
o "false" (default) | o "false" (default) | |||
o "true" | o "true" | |||
2.48.3. "docName" Attribute | 2.49.3. "docName" Attribute | |||
Deprecated; instead, use the "value" attribute in <seriesInfo>. | For Internet-Drafts, this specifies the draft name (which appears | |||
below the title). | ||||
2.48.4. "indexInclude" Attribute | If both the "docName" and "number" attributes are given, the latter | |||
takes precedence (and the draft name indicates the Internet-Draft | ||||
from which the document was produced). | ||||
Note that the file extension is not part of the draft, so in general | ||||
it should end with the current draft number ("-", plus two digits). | ||||
Furthermore, it is good practice to disambiguate current editor | ||||
copies from submitted drafts (for instance, by replacing the draft | ||||
number with the string "latest"). | ||||
See Section 7 of [IDGUIDE] for further information. | ||||
2.49.4. "indexInclude" Attribute | ||||
Specifies whether or not a formatter is requested to include an index | Specifies whether or not a formatter is requested to include an index | |||
in generated files. If the source file has no <iref> elements, an | in generated files. If the source file has no <iref> elements, an | |||
index is never generated. This option is useful for generating | index is never generated. This option is useful for generating | |||
documents where the source document has <iref> elements but the | documents where the source document has <iref> elements but the | |||
author no longer wants an index. | author no longer wants an index. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
skipping to change at page 54, line 20 ¶ | skipping to change at page 57, line 4 ¶ | |||
Specifies whether or not a formatter is requested to include an index | Specifies whether or not a formatter is requested to include an index | |||
in generated files. If the source file has no <iref> elements, an | in generated files. If the source file has no <iref> elements, an | |||
index is never generated. This option is useful for generating | index is never generated. This option is useful for generating | |||
documents where the source document has <iref> elements but the | documents where the source document has <iref> elements but the | |||
author no longer wants an index. | author no longer wants an index. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.48.5. "ipr" Attribute | 2.49.5. "ipr" Attribute | |||
Represents the Intellectual Property status of the document. See | Represents the Intellectual Property status of the document. See | |||
Appendix A.1 for details. | Appendix A.2 for details. | |||
2.48.6. "iprExtract" Attribute | 2.49.6. "iprExtract" Attribute | |||
Identifies a single section within the document for which extraction | Identifies a single section within the document for which extraction | |||
"as is" is explicitly allowed (only relevant for historic values of | "as is" is explicitly allowed (only relevant for historic values of | |||
the "ipr" attribute). | the "ipr" attribute). | |||
2.48.7. "number" Attribute | 2.49.7. "number" Attribute | |||
Used to determine wheher to produce an RFC or an Internet-Draft. | The number of the RFC to be produced. | |||
2.48.8. "obsoletes" Attribute | 2.49.8. "obsoletes" Attribute | |||
A comma-separated list of RFC numbers or Internet-Draft names. | A comma-separated list of RFC numbers or Internet-Draft names. | |||
The prep tool will parse the attribute value so that incorrect | The prep tool will parse the attribute value so that incorrect | |||
references can be detected. | references can be detected. | |||
2.48.9. "prepTime" Attribute | 2.49.9. "prepTime" Attribute | |||
The date that the XML was processed by a prep tool. This is included | The date that the XML was processed by a prep tool. This is included | |||
in the XML file just before it is saved to disk. The value is | in the XML file just before it is saved to disk. The value is | |||
formatted using the "date-time" format defined in Section 5.6 of | formatted using the "date-time" format defined in Section 5.6 of | |||
[RFC3339]. The "time-offset" should be "Z". | [RFC3339]. The "time-offset" should be "Z". | |||
2.48.10. "seriesNo" Attribute | 2.49.10. "seriesNo" Attribute | |||
Deprecated; instead, use the "value" attribute in <seriesInfo>. | Number within a document series. | |||
2.48.11. "sortRefs" Attribute | The document series is defined by the "category" attribute; | |||
"seriesNo" is only applicable to the values "info" ("FYI" series), | ||||
"std" ("STD" series), and "bcp" ("BCP" series). | ||||
2.49.11. "sortRefs" Attribute | ||||
Specifies whether or not the prep tool will sort the references in | Specifies whether or not the prep tool will sort the references in | |||
each reference section. | each reference section. | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.48.12. "submissionType" Attribute | 2.49.12. "submissionType" Attribute | |||
The document stream, as described in [RFC7841]. (The RFC Series | The document stream, as described in [RFC7841]. (The RFC Series | |||
Editor may change the list of allowed values in the future.) | Editor may change the list of allowed values in the future.) | |||
Allowed values: | Allowed values: | |||
o "IETF" (default) | o "IETF" (default) | |||
o "IAB" | o "IAB" | |||
o "IRTF" | o "IRTF" | |||
o "independent" | o "independent" | |||
2.48.13. "symRefs" Attribute | 2.49.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.48.14. "tocDepth" Attribute | 2.49.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.48.15. "tocInclude" Attribute | 2.49.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 | |||
of contents in generated files. | of contents in generated files. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.48.16. "updates" Attribute | 2.49.16. "updates" Attribute | |||
A comma-separated list of RFC numbers or Internet-Draft names. | A comma-separated list of RFC numbers or Internet-Draft names. | |||
The prep tool will parse the attribute value so that incorrect | The prep tool will parse the attribute value so that incorrect | |||
references can be detected. | references can be detected. | |||
2.48.17. "version" Attribute | 2.49.17. "version" Attribute | |||
Specifies the version of xml2rfc syntax used in this document. The | Specifies the version of xml2rfc syntax used in this document. The | |||
only expected value (for now) is "3". | only expected value (for now) is "3". | |||
2.49. <section> | 2.50. <section> | |||
Represents a section (when inside a <middle> element) or an appendix | Represents a section (when inside a <middle> element) or an appendix | |||
(when inside a <back> element). | (when inside a <back> element). | |||
Subsections are created by nesting <section> elements inside | Subsections are created by nesting <section> elements inside | |||
<section> elements. Sections are allowed to be empty. | <section> elements. Sections are allowed to be empty. | |||
This element appears as a child element of <back> (Section 2.9), | This element appears as a child element of <back> (Section 2.9), | |||
<boilerplate> (Section 2.12), <middle> (Section 2.33), and <section> | <boilerplate> (Section 2.12), <middle> (Section 2.34), and <section> | |||
(Section 2.49). | (Section 2.50). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. In any order: | 2. In any order: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <aside> elements (Section 2.7) | * <aside> elements (Section 2.7) | |||
* <blockquote> elements (Section 2.11) | * <blockquote> elements (Section 2.11) | |||
* <dl> elements (Section 2.21) | * <contact> elements (Section 2.16) | |||
* <figure> elements (Section 2.27) | * <dl> elements (Section 2.22) | |||
* <iref> elements (Section 2.29) | * <figure> elements (Section 2.28) | |||
* <iref> elements (Section 2.30) | ||||
* <ol> elements (Section 2.36) | * <ol> elements (Section 2.37) | |||
* <sourcecode> elements (Section 2.52) | * <sourcecode> elements (Section 2.53) | |||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <table> elements (Section 2.58) | * <table> elements (Section 2.59) | |||
* <texttable> elements (Section 3.8) | * <texttable> elements (Section 3.8) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
3. Optional <section> elements (Section 2.49) | 3. Optional <section> elements (Section 2.50) | |||
2.49.1. "anchor" Attribute | 2.50.1. "anchor" Attribute | |||
Document-wide unique identifier for this section. | Document-wide unique identifier for this section. | |||
2.49.2. "numbered" Attribute | 2.50.2. "numbered" Attribute | |||
If set to "false", the formatter is requested to not display a | If set to "false", the formatter is requested to not display a | |||
section number. The prep tool will verify that such a section is not | section number. The prep tool will verify that such a section is not | |||
followed by a numbered section in this part of the document and will | followed by a numbered section in this part of the document and will | |||
verify that the section is a top-level section. Descendant sections | verify that the section is a top-level section. Descendant sections | |||
of unnumbered sections are unnumbered by definition. | of unnumbered sections are unnumbered by definition. | |||
Allowed values: | Allowed values: | |||
o "true" (default) | o "true" (default) | |||
o "false" | o "false" | |||
2.49.3. "removeInRFC" Attribute | 2.50.3. "removeInRFC" Attribute | |||
If set to "true", this note is marked in the prep tool with text | If set to "true", this note is marked in the prep tool with text | |||
indicating that it should be removed before the document is published | indicating that it should be removed before the document is published | |||
as an RFC. That text will be "This note is to be removed before | as an RFC. That text will be "This note is to be removed before | |||
publishing as an RFC." | publishing as an RFC." | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.49.4. "title" Attribute | 2.50.4. "title" Attribute | |||
Deprecated. Use <name> instead. | Deprecated. Use <name> instead. | |||
2.49.5. "toc" Attribute | 2.50.5. "toc" Attribute | |||
Indicates to a formatter whether or not the section is to be included | Indicates to a formatter whether or not the section is to be included | |||
in a table of contents, if such a table of contents is produced. | in a table of contents, if such a table of contents is produced. | |||
This only takes effect if the level of the section would have | This only takes effect if the level of the section would have | |||
appeared in the table of contents based on the "tocDepth" attribute | appeared in the table of contents based on the "tocDepth" attribute | |||
of the <rfc> element, and of course only if the table of contents is | of the <rfc> element, and of course only if the table of contents is | |||
being created based on the "tocInclude" attribute of the <rfc> | being created based on the "tocInclude" attribute of the <rfc> | |||
element. If this is set to "exclude", any section below this one | element. If this is set to "exclude", any section below this one | |||
will be excluded as well. The "default" value indicates inclusion of | will be excluded as well. The "default" value indicates inclusion of | |||
the section if it would be included by the tocDepth attribute of the | the section if it would be included by the tocDepth attribute of the | |||
<rfc> element. | <rfc> element. | |||
Allowed values: | Allowed values: | |||
o "include" | o "include" | |||
o "exclude" | o "exclude" | |||
o "default" (default) | o "default" (default) | |||
2.50. <seriesInfo> | 2.51. <seriesInfo> | |||
Specifies the document series in which this document appears, and | Specifies the document series in which this document appears, and | |||
also specifies an identifier within that series. | also specifies an identifier within that series. | |||
A processing tool determines whether it is working on an RFC or an | This element appears as a child element of <front> (Section 2.29) and | |||
Internet-Draft by inspecting the "name" attribute of a <seriesInfo> | <reference> (Section 2.44). | |||
element inside the <front> element inside the <rfc> element, looking | ||||
for "RFC" or "Internet-Draft". (Specifying neither value in any of | ||||
the <seriesInfo> elements can be useful for producing other types of | ||||
documents but is out of scope for this specification.) | ||||
It is invalid to have multiple <seriesInfo> elements inside the same | ||||
<front> element containing the same "name" value. Some combinations | ||||
of <seriesInfo> "name" attribute values make no sense, such as having | ||||
both <seriesInfo name="rfc"/> and <seriesInfo name="Internet-Draft"/> | ||||
in the same <front> element. | ||||
This element appears as a child element of <front> (Section 2.28) and | ||||
<reference> (Section 2.43). | ||||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
2.50.1. "asciiName" Attribute | 2.51.1. "asciiName" Attribute | |||
The ASCII equivalent of the name field. | The ASCII equivalent of the name field. | |||
2.50.2. "asciiValue" Attribute | 2.51.2. "asciiValue" Attribute | |||
The ASCII equivalent of the value field. | The ASCII equivalent of the value field. | |||
2.50.3. "name" Attribute (Mandatory) | 2.51.3. "name" Attribute (Mandatory) | |||
Some series names might trigger specific processing (such as for | Some series names might trigger specific processing (such as for | |||
autogenerating links, inserting descriptions such as "work in | autogenerating links, inserting descriptions such as "work in | |||
progress", or additional functionality like reference diagnostics). | progress", or additional functionality like reference diagnostics). | |||
Examples for IETF-related series names are "BCP", "FYI", "Internet- | Examples for IETF-related series names are "BCP", "FYI", "Internet- | |||
Draft", "RFC", and "STD". | Draft", "RFC", and "STD". | |||
Some of the values for "name" interact as follows: | Some of the values for "name" interact as follows: | |||
o A <front> element that has a <seriesInfo> element that has the | o A <front> element that has a <seriesInfo> element that has the | |||
name "Internet-Draft" cannot also have a <seriesInfo> element that | name "Internet-Draft" cannot also have a <seriesInfo> element that | |||
has the name "RFC". | has the name "RFC". | |||
o The <seriesInfo> element can contain the DOI for the referenced | o The <seriesInfo> element can contain the DOI for the referenced | |||
document. This cannot be used when the <seriesInfo> element is an | document. This cannot be used when the <seriesInfo> element is an | |||
eventual child element of an <rfc> element -- only as an eventual | eventual child element of an <rfc> element -- only as an eventual | |||
child of a <reference> element. The "value" attribute should use | child of a <reference> element. The "value" attribute should use | |||
the form specified in [RFC7669]. | the form specified in [RFC7669]. | |||
2.50.4. "status" Attribute | 2.51.4. "status" Attribute | |||
The status of this document. The currently known values are | The status of this document. The currently known values are | |||
"standard", "informational", "experimental", "bcp", "fyi", and "full- | "standard", "informational", "experimental", "bcp", "fyi", and "full- | |||
standard". The RFC Series Editor may change this list in the future. | standard". The RFC Series Editor may change this list in the future. | |||
2.50.5. "stream" Attribute | 2.51.5. "stream" Attribute | |||
The stream (as described in [RFC7841]) that originated the document. | The stream (as described in [RFC7841]) that originated the document. | |||
(The RFC Series Editor may change this list in the future.) | (The RFC Series Editor may change this list in the future.) | |||
Allowed values: | Allowed values: | |||
o "IETF" (default) | o "IETF" (default) | |||
o "IAB" | o "IAB" | |||
o "IRTF" | o "IRTF" | |||
o "independent" | o "independent" | |||
2.50.6. "value" Attribute (Mandatory) | 2.51.6. "value" Attribute (Mandatory) | |||
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 "draft-ietf-somewg- | be "draft-ietf-somewg-someprotocol-07", not "draft-ietf-somewg- | |||
someprotocol-07.txt". | someprotocol-07.txt". | |||
2.51. <sortingcode> | 2.52. <sortingcode> | |||
A sorting code is related to postal codes in that it is used in | A sorting code is related to postal codes in that it is used in | |||
addresses to allow sorting, for example to route mail to a certain | addresses to allow sorting, for example to route mail to a certain | |||
postal centre or to distinguish streets with the same name in two | postal centre or to distinguish streets with the same name in two | |||
different areas of the same settlement. | different areas of the same settlement. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.51.1. "ascii" Attribute | 2.52.1. "ascii" Attribute | |||
ASCII equivalent for sortingcode. | ASCII equivalent for sortingcode. | |||
2.52. <sourcecode> | 2.53. <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 | |||
[RFC5234] or the RNC notation used in this document). (When | [RFC5234] or the RNC notation used in this document). (When | |||
<sourcecode> is a child of other elements, it flows with the text | <sourcecode> is a child of other elements, it flows with the text | |||
skipping to change at page 61, line 30 ¶ | skipping to change at page 63, line 47 ¶ | |||
and so on, use the <artwork> element instead. | and so on, use the <artwork> element instead. | |||
Output formatters that do pagination should attempt to keep source | Output formatters that do pagination should attempt to keep source | |||
code on a single page. This is to prevent source code that is split | code on a single page. This is to prevent source code that is split | |||
across pages from looking like two separate pieces of code. | across pages from looking like two separate pieces of code. | |||
See Section 5 for a description of how to deal with issues of using | See Section 5 for a description of how to deal with issues of using | |||
"&" and "<" characters in source code. | "&" and "<" characters in source code. | |||
This element appears as a child element of <blockquote> | This element appears as a child element of <blockquote> | |||
(Section 2.11), <dd> (Section 2.19), <figure> (Section 2.27), <li> | (Section 2.11), <dd> (Section 2.20), <figure> (Section 2.28), <li> | |||
(Section 2.31), <section> (Section 2.49), <td> (Section 2.60), and | (Section 2.32), <section> (Section 2.50), <td> (Section 2.61), and | |||
<th> (Section 2.62). | <th> (Section 2.63). | |||
Content model: only text content. | Content model: only text content. | |||
2.52.1. "anchor" Attribute | 2.53.1. "anchor" Attribute | |||
Document-wide unique identifier for this source code. | Document-wide unique identifier for this source code. | |||
2.52.2. "name" Attribute | 2.53.2. "markers" Attribute | |||
Specifies whether or not the soure code should be displayed between | ||||
"<CODE BEGINS>"/"<CODE ENDS>" markers, as described in | ||||
<https://www.ietf.org/about/groups/iesg/statements/copyright- | ||||
2009-09-08/>. Note that adding markers is not needed for the | ||||
languages listed under "Code Components" on | ||||
<https://trustee.ietf.org/trust-legal-provisions.html>. | ||||
Additionally, if the "name" attribute is present, if will be | ||||
displayed after "<CODE BEGINS>", as described in Section 3.2 of | ||||
[RFC8407]. | ||||
Allowed values: | ||||
o "true" | ||||
o "false" | ||||
2.53.3. "name" Attribute | ||||
A filename suitable for the contents (such as for extraction to a | A filename suitable for the contents (such as for extraction to a | |||
local file). This attribute can be helpful for other kinds of tools | local file). This attribute can be helpful for other kinds of tools | |||
(such as automated syntax checkers, which work by extracting the | (such as automated syntax checkers, which work by extracting the | |||
source code). Note that the "name" attribute does not need to be | source code). Note that the "name" attribute does not need to be | |||
unique for <artwork> elements in a document. If multiple | unique for <artwork> elements in a document. If multiple | |||
<sourcecode> elements have the same "name" attribute, a formatter | <sourcecode> elements have the same "name" attribute, a formatter | |||
might assume that the elements are all fragments of a single file, | might assume that the elements are all fragments of a single file, | |||
and such a formatter can collect those fragments for later | and such a formatter can collect those fragments for later | |||
processing. | processing. | |||
2.52.3. "src" Attribute | 2.53.4. "src" Attribute | |||
The URI reference of a source file [RFC3986]. | The URI reference of a source file [RFC3986]. | |||
It is an error to have both a "src" attribute and content in the | It is an error to have both a "src" attribute and content in the | |||
<sourcecode> element. | <sourcecode> element. | |||
2.52.4. "type" Attribute | 2.53.5. "type" Attribute | |||
Specifies the type of the source code. The value of this attribute | Specifies the type of the source code. The value of this attribute | |||
is free text with certain values designated as preferred. | is free text with certain values designated as preferred. | |||
The preferred values for <sourcecode> types are: | The preferred values for <sourcecode> types are: | |||
o abnf | o abnf | |||
o asn.1 | o asn.1 | |||
skipping to change at page 63, line 4 ¶ | skipping to change at page 65, line 38 ¶ | |||
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 not cause a | |||
failure when it encounters an unexpected type or no type is | failure when it encounters an unexpected type or no type is | |||
specified. | specified. | |||
2.53. <street> | 2.54. <street> | |||
Provides a street address. | Provides a street address. | |||
This element appears as a child element of <postal> (Section 2.40). | This element appears as a child element of <postal> (Section 2.41). | |||
Content model: only text content. | Content model: only text content. | |||
2.53.1. "ascii" Attribute | 2.54.1. "ascii" Attribute | |||
The ASCII equivalent of the street address. | The ASCII equivalent of the street address. | |||
2.54. <strong> | 2.55. <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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | <dd> (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <preamble> (Section 3.6), | (Section 2.32), <name> (Section 2.35), <preamble> (Section 3.6), | |||
<refcontent> (Section 2.42), <sub> (Section 2.55), <sup> | <refcontent> (Section 2.43), <sub> (Section 2.56), <sup> | |||
(Section 2.56), <t> (Section 2.57), <td> (Section 2.60), <th> | (Section 2.57), <t> (Section 2.58), <td> (Section 2.61), <th> | |||
(Section 2.62), and <tt> (Section 2.66). | (Section 2.63), and <tt> (Section 2.67). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | ||||
o <sub> elements (Section 2.55) | o <relref> elements (Section 2.48) | |||
o <sup> elements (Section 2.56) | o <sub> elements (Section 2.56) | |||
o <tt> elements (Section 2.66) | o <sup> elements (Section 2.57) | |||
o <xref> elements (Section 2.70) | o <tt> elements (Section 2.67) | |||
2.55. <sub> | o <xref> elements (Section 2.71) | |||
2.56. <sub> | ||||
Causes the text to be displayed as subscript, approximately half a | Causes the text to be displayed as subscript, approximately half a | |||
letter-height lower than normal text. This element can be combined | letter-height lower than normal text. This element can be combined | |||
with other character formatting elements, and the formatting will be | with other character formatting elements, and the formatting will be | |||
additive. | 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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | <dd> (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <preamble> (Section 3.6), | (Section 2.32), <name> (Section 2.35), <preamble> (Section 3.6), | |||
<refcontent> (Section 2.42), <strong> (Section 2.54), <t> | <refcontent> (Section 2.43), <strong> (Section 2.55), <t> | |||
(Section 2.57), <td> (Section 2.60), <th> (Section 2.62), and <tt> | (Section 2.58), <td> (Section 2.61), <th> (Section 2.63), and <tt> | |||
(Section 2.66). | (Section 2.67). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.56. <sup> | 2.57. <sup> | |||
Causes the text to be displayed as superscript, approximately half a | Causes the text to be displayed as superscript, approximately half a | |||
letter-height higher than normal text. This element can be combined | letter-height higher than normal text. This element can be combined | |||
with other character formatting elements, and the formatting will be | with other character formatting elements, and the formatting will be | |||
additive. | 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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | <dd> (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <preamble> (Section 3.6), | (Section 2.32), <name> (Section 2.35), <preamble> (Section 3.6), | |||
<refcontent> (Section 2.42), <strong> (Section 2.54), <t> | <refcontent> (Section 2.43), <strong> (Section 2.55), <t> | |||
(Section 2.57), <td> (Section 2.60), <th> (Section 2.62), and <tt> | (Section 2.58), <td> (Section 2.61), <th> (Section 2.63), and <tt> | |||
(Section 2.66). | (Section 2.67). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.57. <t> | 2.58. <t> | |||
Contains a paragraph of text. | Contains a paragraph of text. | |||
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.19), <li> (Section 2.31), <list> (Section 3.4), <note> | (Section 2.20), <li> (Section 2.32), <list> (Section 3.4), <note> | |||
(Section 2.35), <section> (Section 2.49), <td> (Section 2.60), and | (Section 2.36), <section> (Section 2.50), <td> (Section 2.61), and | |||
<th> (Section 2.62). | <th> (Section 2.63). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.18) | ||||
o <cref> elements (Section 2.17) | o <em> elements (Section 2.24) | |||
o <em> elements (Section 2.23) | ||||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <list> elements (Section 3.4) | o <list> elements (Section 3.4) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <spanx> elements (Section 3.7) | o <spanx> elements (Section 3.7) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <vspace> elements (Section 3.10) | o <vspace> elements (Section 3.10) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
2.57.1. "anchor" Attribute | 2.58.1. "anchor" Attribute | |||
Document-wide unique identifier for this paragraph. | Document-wide unique identifier for this paragraph. | |||
2.57.2. "hangText" Attribute | 2.58.2. "hangText" Attribute | |||
Deprecated. Instead, use <dd> inside of a definition list (<dl>). | Deprecated. Instead, use <dd> inside of a definition list (<dl>). | |||
2.57.3. "keepWithNext" Attribute | 2.58.3. "keepWithNext" Attribute | |||
Acts as a hint to the output formatters that do pagination to do a | Acts as a hint to the output formatters that do pagination to do a | |||
best-effort attempt to keep the paragraph with the next element, | best-effort attempt to keep the paragraph with the next element, | |||
whatever that happens to be. For example, the HTML output @media | whatever that happens to be. For example, the HTML output @media | |||
print CSS ("CSS" refers to Cascading Style Sheets) might translate | print CSS ("CSS" refers to Cascading Style Sheets) might translate | |||
this to page-break-after: avoid. For PDF, the paginator could | this to page-break-after: avoid. For PDF, the paginator could | |||
attempt to keep the paragraph with the next element. Note: this | attempt to keep the paragraph with the next element. Note: this | |||
attribute is strictly a hint and not always actionable. | attribute is strictly a hint and not always actionable. | |||
Allowed values: | Allowed values: | |||
skipping to change at page 67, line 11 ¶ | skipping to change at page 70, line 4 ¶ | |||
best-effort attempt to keep the paragraph with the next element, | best-effort attempt to keep the paragraph with the next element, | |||
whatever that happens to be. For example, the HTML output @media | whatever that happens to be. For example, the HTML output @media | |||
print CSS ("CSS" refers to Cascading Style Sheets) might translate | print CSS ("CSS" refers to Cascading Style Sheets) might translate | |||
this to page-break-after: avoid. For PDF, the paginator could | this to page-break-after: avoid. For PDF, the paginator could | |||
attempt to keep the paragraph with the next element. Note: this | attempt to keep the paragraph with the next element. Note: this | |||
attribute is strictly a hint and not always actionable. | attribute is strictly a hint and not always actionable. | |||
Allowed values: | Allowed values: | |||
o "false" (default) | o "false" (default) | |||
o "true" | o "true" | |||
2.57.4. "keepWithPrevious" Attribute | 2.58.4. "keepWithPrevious" Attribute | |||
Acts as a hint to the output formatters that do pagination to do a | Acts as a hint to the output formatters that do pagination to do a | |||
best-effort attempt to keep the paragraph with the previous element, | best-effort attempt to keep the paragraph with the previous element, | |||
whatever that happens to be. For example, the HTML output @media | whatever that happens to be. For example, the HTML output @media | |||
print CSS might translate this to page-break-before: avoid. For PDF, | print CSS might translate this to page-break-before: avoid. For PDF, | |||
the paginator could attempt to keep the paragraph with the previous | the paginator could attempt to keep the paragraph with the previous | |||
element. Note: this attribute is strictly a hint and not always | element. Note: this attribute is strictly a hint and not always | |||
actionable. | actionable. | |||
Allowed values: | Allowed values: | |||
o "false" (default) | o "false" (default) | |||
o "true" | o "true" | |||
2.58. <table> | 2.59. <table> | |||
Contains a table with a caption with the table number. If the | Contains a table with a caption with the table number. If the | |||
element contains a <name> element, the caption will also show that | element contains a <name> element, the caption will also show that | |||
name. | name. | |||
Inside the <table> element is, optionally, a <thead> element to | Inside the <table> element is, optionally, a <thead> element to | |||
contain the rows that will be the table's heading and, optionally, a | contain the rows that will be the table's heading and, optionally, a | |||
<tfoot> element to contain the rows of the table's footer. If the | <tfoot> element to contain the rows of the table's footer. If the | |||
XML is converted to a representation that has page breaks (such as | XML is converted to a representation that has page breaks (such as | |||
PDFs or printed HTML), the header and footer are meant to appear on | PDFs or printed HTML), the header and footer are meant to appear on | |||
each page. | each page. | |||
This element appears as a child element of <aside> (Section 2.7), | This element appears as a child element of <aside> (Section 2.7), | |||
<blockquote> (Section 2.11), and <section> (Section 2.49). | <blockquote> (Section 2.11), and <section> (Section 2.50). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. One optional <thead> element (Section 2.63) | ||||
3. One or more <tbody> elements (Section 2.59) | 2. One optional <thead> element (Section 2.64) | |||
4. One optional <tfoot> element (Section 2.61) | 3. One or more <tbody> elements (Section 2.60) | |||
2.58.1. "align" Attribute | 4. One optional <tfoot> element (Section 2.62) | |||
2.59.1. "align" Attribute | ||||
Controls whether the table appears left justified, centered | Controls whether the table appears left justified, centered | |||
(default), or right justified. The caption will be centered under | (default), or right justified. The caption will be centered under | |||
the table, and the combined table and caption will be aligned | the table, and the combined table and caption will be aligned | |||
according to the "align" attribute. | according to the "align" attribute. | |||
Allowed values: | Allowed values: | |||
o "left" | o "left" | |||
o "center" (default) | o "center" (default) | |||
o "right" | o "right" | |||
2.58.2. "anchor" Attribute | 2.59.2. "anchor" Attribute | |||
Document-wide unique identifier for this table. | Document-wide unique identifier for this table. | |||
2.59. <tbody> | 2.60. <tbody> | |||
A container for a set of body rows for a table. | A container for a set of body rows for a table. | |||
This element appears as a child element of <table> (Section 2.58). | This element appears as a child element of <table> (Section 2.59). | |||
Content model: | Content model: | |||
One or more <tr> elements (Section 2.65) | One or more <tr> elements (Section 2.66) | |||
2.59.1. "anchor" Attribute | 2.60.1. "anchor" Attribute | |||
Document-wide unique identifier for the tbody. | Document-wide unique identifier for the tbody. | |||
2.60. <td> | 2.61. <td> | |||
A cell in a table row. | A cell in a table row. | |||
This element appears as a child element of <tr> (Section 2.65). | This element appears as a child element of <tr> (Section 2.66). | |||
Content model: | Content model: | |||
Either: | Either: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <dl> elements (Section 2.21) | * <dl> elements (Section 2.22) | |||
* <figure> elements (Section 2.27) | * <figure> elements (Section 2.28) | |||
* <ol> elements (Section 2.36) | * <ol> elements (Section 2.37) | |||
* <sourcecode> elements (Section 2.52) | * <sourcecode> elements (Section 2.53) | |||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
Or: | Or: | |||
In any order: | In any order: | |||
* Text | * Text | |||
* <bcp14> elements (Section 2.10) | * <bcp14> elements (Section 2.10) | |||
* <cref> elements (Section 2.17) | * <cref> elements (Section 2.18) | |||
* <em> elements (Section 2.23) | * <em> elements (Section 2.24) | |||
* <eref> elements (Section 2.25) | * <eref> elements (Section 2.26) | |||
* <iref> elements (Section 2.29) | * <iref> elements (Section 2.30) | |||
* <relref> elements (Section 2.47) | * <relref> elements (Section 2.48) | |||
* <strong> elements (Section 2.54) | * <strong> elements (Section 2.55) | |||
* <sub> elements (Section 2.55) | * <sub> elements (Section 2.56) | |||
* <sup> elements (Section 2.56) | * <sup> elements (Section 2.57) | |||
* <tt> elements (Section 2.66) | ||||
* <xref> elements (Section 2.70) | * <tt> elements (Section 2.67) | |||
2.60.1. "align" Attribute | * <xref> elements (Section 2.71) | |||
2.61.1. "align" Attribute | ||||
Controls whether the content of the cell appears left justified | Controls whether the content of the cell appears left justified | |||
(default), centered, or right justified. Note that "center" or | (default), centered, or right justified. Note that "center" or | |||
"right" will probably only work well in cells with plain text; any | "right" will probably only work well in cells with plain text; any | |||
other elements might make the contents render badly. | other elements might make the contents render badly. | |||
Allowed values: | Allowed values: | |||
o "left" (default) | o "left" (default) | |||
o "center" | o "center" | |||
o "right" | o "right" | |||
2.60.2. "anchor" Attribute | 2.61.2. "anchor" Attribute | |||
Document-wide unique identifier for the cell. | Document-wide unique identifier for the cell. | |||
2.60.3. "colspan" Attribute | 2.61.3. "colspan" Attribute | |||
The number of columns that the cell is to span. For example, setting | The number of columns that the cell is to span. For example, setting | |||
"colspan='3'" indicates that the cell occupies the same horizontal | "colspan='3'" indicates that the cell occupies the same horizontal | |||
space as three cells of a row without any "colspan" attributes. | space as three cells of a row without any "colspan" attributes. | |||
2.60.4. "rowspan" Attribute | 2.61.4. "rowspan" Attribute | |||
The number of rows that the cell is to span. For example, setting | The number of rows that the cell is to span. For example, setting | |||
"rowspan='3'" indicates that the cell occupies the same vertical | "rowspan='3'" indicates that the cell occupies the same vertical | |||
space as three rows. | space as three rows. | |||
2.61. <tfoot> | 2.62. <tfoot> | |||
A container for a set of footer rows for a table. | A container for a set of footer rows for a table. | |||
This element appears as a child element of <table> (Section 2.58). | This element appears as a child element of <table> (Section 2.59). | |||
Content model: | Content model: | |||
One or more <tr> elements (Section 2.65) | One or more <tr> elements (Section 2.66) | |||
2.61.1. "anchor" Attribute | 2.62.1. "anchor" Attribute | |||
Document-wide unique identifier for the tfoot. | Document-wide unique identifier for the tfoot. | |||
2.62. <th> | 2.63. <th> | |||
A cell in a table row. When rendered, this will normally come out in | A cell in a table row. When rendered, this will normally come out in | |||
boldface; other than that, there is no difference between this and | boldface; other than that, there is no difference between this and | |||
the <td> element. | the <td> element. | |||
This element appears as a child element of <tr> (Section 2.65). | This element appears as a child element of <tr> (Section 2.66). | |||
Content model: | Content model: | |||
Either: | Either: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
* <artset> elements (Section 2.5) | * <artset> elements (Section 2.5) | |||
* <artwork> elements (Section 2.6) | * <artwork> elements (Section 2.6) | |||
* <dl> elements (Section 2.21) | * <dl> elements (Section 2.22) | |||
* <figure> elements (Section 2.27) | * <figure> elements (Section 2.28) | |||
* <ol> elements (Section 2.36) | * <ol> elements (Section 2.37) | |||
* <sourcecode> elements (Section 2.52) | * <sourcecode> elements (Section 2.53) | |||
* <t> elements (Section 2.57) | * <t> elements (Section 2.58) | |||
* <ul> elements (Section 2.67) | * <ul> elements (Section 2.68) | |||
Or: | Or: | |||
In any order: | In any order: | |||
* Text | * Text | |||
* <bcp14> elements (Section 2.10) | * <bcp14> elements (Section 2.10) | |||
* <cref> elements (Section 2.17) | ||||
* <em> elements (Section 2.23) | * <cref> elements (Section 2.18) | |||
* <eref> elements (Section 2.25) | * <em> elements (Section 2.24) | |||
* <eref> elements (Section 2.26) | ||||
* <iref> elements (Section 2.29) | * <iref> elements (Section 2.30) | |||
* <relref> elements (Section 2.47) | * <relref> elements (Section 2.48) | |||
* <strong> elements (Section 2.54) | * <strong> elements (Section 2.55) | |||
* <sub> elements (Section 2.55) | * <sub> elements (Section 2.56) | |||
* <sup> elements (Section 2.56) | * <sup> elements (Section 2.57) | |||
* <tt> elements (Section 2.66) | * <tt> elements (Section 2.67) | |||
* <xref> elements (Section 2.70) | * <xref> elements (Section 2.71) | |||
2.62.1. "align" Attribute | 2.63.1. "align" Attribute | |||
Controls whether the content of the cell appears left justified | Controls whether the content of the cell appears left justified | |||
(default), centered, or right justified. Note that "center" or | (default), centered, or right justified. Note that "center" or | |||
"right" will probably only work well in cells with plain text; any | "right" will probably only work well in cells with plain text; any | |||
other elements might make the contents render badly. | other elements might make the contents render badly. | |||
Allowed values: | Allowed values: | |||
o "left" (default) | o "left" (default) | |||
o "center" | o "center" | |||
o "right" | o "right" | |||
2.62.2. "anchor" Attribute | 2.63.2. "anchor" Attribute | |||
Document-wide unique identifier for the row. | Document-wide unique identifier for the row. | |||
2.62.3. "colspan" Attribute | 2.63.3. "colspan" Attribute | |||
The number of columns that the cell is to span. For example, setting | The number of columns that the cell is to span. For example, setting | |||
"colspan='3'" indicates that the cell occupies the same horizontal | "colspan='3'" indicates that the cell occupies the same horizontal | |||
space as three cells of a row without any "colspan" attributes. | space as three cells of a row without any "colspan" attributes. | |||
2.62.4. "rowspan" Attribute | 2.63.4. "rowspan" Attribute | |||
The number of rows that the cell is to span. For example, setting | The number of rows that the cell is to span. For example, setting | |||
"rowspan='3'" indicates that the cell occupies the same vertical | "rowspan='3'" indicates that the cell occupies the same vertical | |||
space as three rows. | space as three rows. | |||
2.63. <thead> | 2.64. <thead> | |||
A container for a set of header rows for a table. | A container for a set of header rows for a table. | |||
This element appears as a child element of <table> (Section 2.58). | This element appears as a child element of <table> (Section 2.59). | |||
Content model: | Content model: | |||
One or more <tr> elements (Section 2.65) | One or more <tr> elements (Section 2.66) | |||
2.63.1. "anchor" Attribute | 2.64.1. "anchor" Attribute | |||
Document-wide unique identifier for the thead. | Document-wide unique identifier for the thead. | |||
2.64. <title> | 2.65. <title> | |||
Represents the document title. | Represents the document title. | |||
When this element appears in the <front> element of the current | When this element appears in the <front> element of the current | |||
document, the title might also appear in page headers or footers. If | document, the title might also appear in page headers or footers. If | |||
it is long (~40 characters), the "abbrev" attribute can be used to | it is long (~40 characters), the "abbrev" attribute can be used to | |||
specify an abbreviated variant. | specify an abbreviated variant. | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: only text content. | Content model: only text content. | |||
2.64.1. "abbrev" Attribute | 2.65.1. "abbrev" Attribute | |||
Specifies an abbreviated variant of the document title. | Specifies an abbreviated variant of the document title. | |||
2.64.2. "ascii" Attribute | 2.65.2. "ascii" Attribute | |||
The ASCII equivalent of the title. | The ASCII equivalent of the title. | |||
2.65. <tr> | 2.66. <tr> | |||
A row of a table. | A row of a table. | |||
This element appears as a child element of <tbody> (Section 2.59), | This element appears as a child element of <tbody> (Section 2.60), | |||
<tfoot> (Section 2.61), and <thead> (Section 2.63). | <tfoot> (Section 2.62), and <thead> (Section 2.64). | |||
Content model: | Content model: | |||
In any order, but at least one of: | In any order, but at least one of: | |||
o <td> elements (Section 2.60) | o <td> elements (Section 2.61) | |||
o <th> elements (Section 2.63) | ||||
o <th> elements (Section 2.62) | ||||
2.65.1. "anchor" Attribute | 2.66.1. "anchor" Attribute | |||
Document-wide unique identifier for the row. | Document-wide unique identifier for the row. | |||
2.66. <tt> | 2.67. <tt> | |||
Causes the text to be displayed in a constant-width font. This | Causes the text to be displayed in a constant-width font. 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.17), | (Section 2.3), <blockquote> (Section 2.11), <cref> (Section 2.18), | |||
<dd> (Section 2.19), <dt> (Section 2.22), <em> (Section 2.23), <li> | <dd> (Section 2.20), <dt> (Section 2.23), <em> (Section 2.24), <li> | |||
(Section 2.31), <name> (Section 2.34), <preamble> (Section 3.6), | (Section 2.32), <name> (Section 2.35), <preamble> (Section 3.6), | |||
<refcontent> (Section 2.42), <strong> (Section 2.54), <sub> | <refcontent> (Section 2.43), <strong> (Section 2.55), <sub> | |||
(Section 2.55), <sup> (Section 2.56), <t> (Section 2.57), <td> | (Section 2.56), <sup> (Section 2.57), <t> (Section 2.58), <td> | |||
(Section 2.60), and <th> (Section 2.62). | (Section 2.61), and <th> (Section 2.63). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.55) | o <sub> elements (Section 2.56) | |||
o <sup> elements (Section 2.56) | ||||
o <xref> elements (Section 2.70) | o <sup> elements (Section 2.57) | |||
2.67. <ul> | o <xref> elements (Section 2.71) | |||
2.68. <ul> | ||||
An unordered list. The labels on the items will be symbols picked by | An unordered list. The labels on the items will be symbols picked by | |||
the formatter. | the formatter. | |||
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.19), <li> (Section 2.31), <note> (Section 2.35), <section> | (Section 2.20), <li> (Section 2.32), <note> (Section 2.36), <section> | |||
(Section 2.49), <td> (Section 2.60), and <th> (Section 2.62). | (Section 2.50), <td> (Section 2.61), and <th> (Section 2.63). | |||
Content model: | Content model: | |||
One or more <li> elements (Section 2.31) | One or more <li> elements (Section 2.32) | |||
2.67.1. "anchor" Attribute | 2.68.1. "anchor" Attribute | |||
Document-wide unique identifier for the list. | Document-wide unique identifier for the list. | |||
2.67.2. "empty" Attribute | 2.68.2. "empty" Attribute | |||
Defines whether or not the label is empty. empty="true" indicates | Defines whether or not the label is empty. empty="true" indicates | |||
that no label will be shown. | that no label will be shown. | |||
Allowed values: | Allowed values: | |||
o "false" (default) | o "false" (default) | |||
o "true" | o "true" | |||
2.67.3. "spacing" Attribute | 2.68.3. "spacing" Attribute | |||
Defines whether or not there is a blank line between entries. | Defines whether or not there is a blank line between entries. | |||
spacing="normal" indicates a single blank line, while | spacing="normal" indicates a single blank line, while | |||
spacing="compact" indicates no space between. | spacing="compact" indicates no space between. | |||
Allowed values: | Allowed values: | |||
o "normal" (default) | o "normal" (default) | |||
o "compact" | o "compact" | |||
2.68. <uri> | 2.69. <uri> | |||
Contains a web address associated with the author. | Contains a web address associated with the author. | |||
The contents should be a valid URI; this most likely will be an | The contents should be a valid URI; this most likely will be an | |||
"http:" or "https:" URI. | "http:" or "https:" URI. | |||
This element appears as a child element of <address> (Section 2.2). | This element appears as a child element of <address> (Section 2.2). | |||
Content model: only text content. | Content model: only text content. | |||
2.69. <workgroup> | 2.70. <workgroup> | |||
This element is used to specify the Working Group (IETF) or Research | This element is used to specify the Working Group (IETF) or Research | |||
Group (IRTF) from which the document originates, if any. The | Group (IRTF) from which the document originates, if any. The | |||
recommended format is the official name of the Working Group (with | recommended format is the official name of the Working Group (with | |||
some capitalization). | some capitalization). | |||
In Internet-Drafts, this is used in the upper left corner of the | In Internet-Drafts, this is used in the upper left corner of the | |||
boilerplate, replacing the "Network Working Group" string. | boilerplate, replacing the "Network Working Group" string. | |||
Formatting software can append the words "Working Group" or "Research | Formatting software can append the words "Working Group" or "Research | |||
Group", depending on the "submissionType" property of the <rfc> | Group", depending on the "submissionType" property of the <rfc> | |||
element (Section 2.48.12). | element (Section 2.49.12). | |||
This element appears as a child element of <front> (Section 2.28). | This element appears as a child element of <front> (Section 2.29). | |||
Content model: only text content. | Content model: only text content. | |||
2.70. <xref> | 2.71. <xref> | |||
A reference to an anchor in this document. Formatters that have | A reference to an anchor in this document. Formatters that have | |||
links (such as HTML and PDF) are likely to render <xref> elements as | links (such as HTML and PDF) are likely to render <xref> elements as | |||
internal hyperlinks. This element is useful for referring to | internal hyperlinks. This element is useful for referring to | |||
references in the "References" section, to specific sections of this | references in the "References" section, to specific sections of this | |||
document, to specific figures, and so on. The "target" attribute is | document, to specific figures, and so on. The "target" attribute is | |||
required. | required. | |||
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), <c> (Section 3.1), <cref> | (Section 2.3), <blockquote> (Section 2.11), <c> (Section 3.1), <cref> | |||
(Section 2.17), <dd> (Section 2.19), <dt> (Section 2.22), <em> | (Section 2.18), <dd> (Section 2.20), <dt> (Section 2.23), <em> | |||
(Section 2.23), <li> (Section 2.31), <name> (Section 2.34), | (Section 2.24), <li> (Section 2.32), <name> (Section 2.35), | |||
<postamble> (Section 3.5), <preamble> (Section 3.6), <strong> | <postamble> (Section 3.5), <preamble> (Section 3.6), <strong> | |||
(Section 2.54), <sub> (Section 2.55), <sup> (Section 2.56), <t> | (Section 2.55), <sub> (Section 2.56), <sup> (Section 2.57), <t> | |||
(Section 2.57), <td> (Section 2.60), <th> (Section 2.62), <tt> | (Section 2.58), <td> (Section 2.61), <th> (Section 2.63), <tt> | |||
(Section 2.66), and <ttcol> (Section 3.9). | (Section 2.67), and <ttcol> (Section 3.9). | |||
Content model: only text content. | Content model: only text content. | |||
2.70.1. "format" Attribute | 2.71.1. "format" Attribute | |||
This attribute signals to formatters what the desired format of the | This attribute signals to formatters what the desired format of the | |||
reference should be. Formatters for document types that have linking | reference should be. Formatters for document types that have linking | |||
capability should wrap the displayed text in hyperlinks. | capability should wrap the displayed text in hyperlinks. | |||
"counter" | "counter" | |||
The "derivedContent" attribute will contain just a counter. This | The "derivedContent" attribute will contain just a counter. This | |||
is used for targets that are <section>, <figure>, <table>, or | is used for targets that are <section>, <figure>, <table>, or | |||
items in an ordered list. Using "format='counter'" where the | items in an ordered list. Using "format='counter'" where the | |||
target is any other type of element is an error. | target is any other type of element is an error. | |||
For example, with an input of: | For example, with an input of: | |||
<section anchor="overview">Protocol Overview</section> | <section anchor="overview">Protocol Overview</section> | |||
. . . | . . . | |||
See Section <xref target="overview" format="counter"/> | See Section <xref target="overview" format="counter"/> | |||
for an overview. | for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See Section <a href="#overview">1.7</a> for an overview. | See Section <a href="#overview">1.7</a> for an overview. | |||
"default" | "default" | |||
If the element has no content, the "derivedContent" attribute will | If the element has no content, the "derivedContent" attribute will | |||
contain a text fragment that describes the referenced part | contain a text fragment that describes the referenced part | |||
completely, such as "XML" for a target that is a <reference>, or | completely, such as "XML" for a target that is a <reference>, or | |||
"Section 2" or "Table 4" for a target to a non-reference. (If the | "Section 2" or "Table 4" for a target to a non-reference. (If the | |||
element has content, the "derivedContent" attribute is filled with | element has content, the "derivedContent" attribute is filled with | |||
the content.) | the content.) | |||
For example, with an input of: | For example, with an input of: | |||
<section anchor="overview">Protocol Overview</section> | <section anchor="overview">Protocol Overview</section> | |||
. . . | . . . | |||
See <xref target="overview"/> for an overview. | See <xref target="overview"/> for an overview. | |||
An HTML formatter might generate: | An HTML formatter might generate: | |||
See <a href="#overview">Section 1.7</a> for an overview. | See <a href="#overview">Section 1.7</a> for an overview. | |||
"none" | "none" | |||
Deprecated. | ||||
There will be no autogenerated text at all (this format only makes | ||||
sense if the <xref> element has text content). | ||||
For example, with an input of: | ||||
<section anchor="overview">Protocol Overview</section> | ||||
. . . | ||||
See <xref target="overview" format="none">section above</xref> | ||||
for an overview. | ||||
An HTML formatter might generate: | ||||
See <a href="#overview">section above</a> for an overview. | ||||
"title" | "title" | |||
If the target is a <reference> element, the "derivedContent" | If the target is a <reference> element, the "derivedContent" | |||
attribute will contain the name of the reference, extracted from | attribute will contain the name of the reference, extracted from | |||
the <title> child of the <front> child of the reference. Or, if | the <title> child of the <front> child of the reference. Or, if | |||
the target element has a <name> child element, the | the target element has a <name> child element, the | |||
"derivedContent" attribute will contain the text content of that | "derivedContent" attribute will contain the text content of that | |||
<name> element concatenated with the text content of each | <name> element concatenated with the text content of each | |||
descendant node of <name> (that is, stripping out all of the XML | descendant node of <name> (that is, stripping out all of the XML | |||
markup, leaving only the text). Or, if the target element does | markup, leaving only the text). Or, if the target element does | |||
skipping to change at page 78, line 29 ¶ | skipping to change at page 81, line 39 ¶ | |||
Allowed values: | Allowed values: | |||
o "default" (default) | o "default" (default) | |||
o "title" | o "title" | |||
o "counter" | o "counter" | |||
o "none" | o "none" | |||
2.70.2. "pageno" Attribute | 2.71.2. "pageno" Attribute | |||
Deprecated. | Deprecated. | |||
Allowed values: | Allowed values: | |||
o "true" | o "true" | |||
o "false" (default) | o "false" (default) | |||
2.70.3. "target" Attribute (Mandatory) | 2.71.3. "target" Attribute (Mandatory) | |||
Identifies the document component being referenced. The value needs | Identifies the document component being referenced. The value needs | |||
to match the value of the "anchor" attribute of an element in the | to match the value of the "anchor" attribute of an element in the | |||
document; otherwise, it is an error. | document; otherwise, it is an error. | |||
3. Elements from v2 That Have Been Deprecated | 3. Elements from v2 That Have Been Deprecated | |||
This section lists the elements from v2 that have been deprecated. | This section lists the elements from v2 that have been deprecated. | |||
Note that some elements in v3 have attributes from v2 that are | Note that some elements in v3 have attributes from v2 that are | |||
deprecated; those are not listed here. | deprecated; those are not listed here. | |||
skipping to change at page 79, line 17 ¶ | skipping to change at page 82, line 29 ¶ | |||
Deprecated. Instead, use <tr>, <td>, and <th>. | Deprecated. Instead, use <tr>, <td>, and <th>. | |||
This element appears as a child element of <texttable> (Section 3.8). | This element appears as a child element of <texttable> (Section 3.8). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <spanx> elements (Section 3.7) | o <spanx> elements (Section 3.7) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
3.2. <facsimile> | 3.2. <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). | |||
Content model: only text content. | Content model: only text content. | |||
3.3. <format> | 3.3. <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.43). | (Section 2.44). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
3.3.1. "octets" attribute | 3.3.1. "octets" attribute | |||
Deprecated. | Deprecated. | |||
3.3.2. "target" attribute | 3.3.2. "target" attribute | |||
Deprecated. | Deprecated. | |||
skipping to change at page 80, line 19 ¶ | skipping to change at page 83, line 28 ¶ | |||
3.3.3. "type" attribute (Mandatory) | 3.3.3. "type" attribute (Mandatory) | |||
Deprecated. | Deprecated. | |||
3.4. <list> | 3.4. <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". | |||
This element appears as a child element of <t> (Section 2.57). | This element appears as a child element of <t> (Section 2.58). | |||
Content model: | Content model: | |||
One or more <t> elements (Section 2.57) | One or more <t> elements (Section 2.58) | |||
3.4.1. "counter" attribute | 3.4.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.4.2. "hangIndent" attribute | 3.4.2. "hangIndent" attribute | |||
Deprecated. Use <dl> instead. | Deprecated. Use <dl> instead. | |||
3.4.3. "style" attribute | 3.4.3. "style" attribute | |||
Deprecated. | Deprecated. | |||
3.5. <postamble> | 3.5. <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.27) | This element appears as a child element of <figure> (Section 2.28) | |||
and <texttable> (Section 3.8). | and <texttable> (Section 3.8). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <eref> elements (Section 2.25) | ||||
o <iref> elements (Section 2.29) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.30) | ||||
o <spanx> elements (Section 3.7) | o <spanx> elements (Section 3.7) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
3.6. <preamble> | 3.6. <preamble> | |||
Deprecated. Instead, use a regular paragraph before the figure or | Deprecated. Instead, use a regular paragraph before the figure or | |||
table. | table. | |||
This element appears as a child element of <figure> (Section 2.27) | This element appears as a child element of <figure> (Section 2.28) | |||
and <texttable> (Section 3.8). | and <texttable> (Section 3.8). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o Text | o Text | |||
o <bcp14> elements (Section 2.10) | o <bcp14> elements (Section 2.10) | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <em> elements (Section 2.23) | o <em> elements (Section 2.24) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <relref> elements (Section 2.47) | o <relref> elements (Section 2.48) | |||
o <spanx> elements (Section 3.7) | o <spanx> elements (Section 3.7) | |||
o <strong> elements (Section 2.54) | o <strong> elements (Section 2.55) | |||
o <sub> elements (Section 2.56) | ||||
o <sub> elements (Section 2.55) | ||||
o <sup> elements (Section 2.56) | o <sup> elements (Section 2.57) | |||
o <tt> elements (Section 2.66) | o <tt> elements (Section 2.67) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
3.7. <spanx> | 3.7. <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.5), | (Section 2.3), <c> (Section 3.1), <postamble> (Section 3.5), | |||
<preamble> (Section 3.6), and <t> (Section 2.57). | <preamble> (Section 3.6), and <t> (Section 2.58). | |||
Content model: only text content. | Content model: only text content. | |||
3.7.1. "style" attribute | 3.7.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.7.2. "xml:space" attribute | 3.7.2. "xml:space" attribute | |||
skipping to change at page 82, line 35 ¶ | skipping to change at page 85, line 42 ¶ | |||
Allowed values: | Allowed values: | |||
o "default" | o "default" | |||
o "preserve" (default) | o "preserve" (default) | |||
3.8. <texttable> | 3.8. <texttable> | |||
Deprecated. Use <table> instead. | Deprecated. Use <table> instead. | |||
This element appears as a child element of <section> (Section 2.49). | This element appears as a child element of <section> (Section 2.50). | |||
Content model: | Content model: | |||
In this order: | In this order: | |||
1. One optional <name> element (Section 2.34) | 1. One optional <name> element (Section 2.35) | |||
2. One optional <preamble> element (Section 3.6) | 2. One optional <preamble> element (Section 3.6) | |||
3. One or more <ttcol> elements (Section 3.9) | 3. One or more <ttcol> elements (Section 3.9) | |||
4. Optional <c> elements (Section 3.1) | 4. Optional <c> elements (Section 3.1) | |||
5. One optional <postamble> element (Section 3.5) | 5. One optional <postamble> element (Section 3.5) | |||
3.8.1. "align" attribute | 3.8.1. "align" attribute | |||
Deprecated. | Deprecated. | |||
skipping to change at page 84, line 15 ¶ | skipping to change at page 87, line 19 ¶ | |||
3.9. <ttcol> | 3.9. <ttcol> | |||
Deprecated. Instead, use <tr>, <td>, and <th>. | Deprecated. Instead, use <tr>, <td>, and <th>. | |||
This element appears as a child element of <texttable> (Section 3.8). | This element appears as a child element of <texttable> (Section 3.8). | |||
Content model: | Content model: | |||
In any order: | In any order: | |||
o <cref> elements (Section 2.17) | o <cref> elements (Section 2.18) | |||
o <eref> elements (Section 2.25) | o <eref> elements (Section 2.26) | |||
o <iref> elements (Section 2.29) | o <iref> elements (Section 2.30) | |||
o <xref> elements (Section 2.70) | o <xref> elements (Section 2.71) | |||
o Text | o Text | |||
3.9.1. "align" attribute | 3.9.1. "align" attribute | |||
Deprecated. | Deprecated. | |||
Allowed values: | Allowed values: | |||
o "left" (default) | o "left" (default) | |||
skipping to change at page 84, line 48 ¶ | skipping to change at page 87, line 52 ¶ | |||
Deprecated. | Deprecated. | |||
3.10. <vspace> | 3.10. <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.57). | This element appears as a child element of <t> (Section 2.58). | |||
Content model: this element does not have any contents. | Content model: this element does not have any contents. | |||
3.10.1. "blankLines" attribute | 3.10.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 | |||
skipping to change at page 91, line 14 ¶ | skipping to change at page 94, line 14 ¶ | |||
[RFC7997] Flanagan, H., Ed., "The Use of Non-ASCII Characters in | [RFC7997] Flanagan, H., Ed., "The Use of Non-ASCII Characters in | |||
RFCs", RFC 7997, DOI 10.17487/RFC7997, 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, | |||
DOI 10.17487/RFC7998, 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 of | ||||
Documents Containing YANG Data Models", BCP 216, RFC 8407, | ||||
DOI 10.17487/RFC8407, October 2018, | ||||
<https://www.rfc-editor.org/info/rfc8407>. | ||||
[RNC] Clark, J., "RELAX NG Compact Syntax", The Organization for | [RNC] Clark, J., "RELAX NG Compact Syntax", The Organization for | |||
the Advancement of Structured Information Standards | the Advancement of Structured Information Standards | |||
(OASIS) , November 2002, <https://www.oasis- | (OASIS) , November 2002, <https://www.oasis- | |||
open.org/committees/relax-ng/compact-20021121.html>. | open.org/committees/relax-ng/compact-20021121.html>. | |||
[RNG] ISO/IEC, "Information Technology - Document Schema | [RNG] ISO/IEC, "Information Technology - Document Schema | |||
Definition Languages (DSDL) - Part 2: Regular-Grammar- | Definition Languages (DSDL) - Part 2: Regular-Grammar- | |||
Based Validation - RELAX NG (Second Edition)", ISO/ | Based Validation - RELAX NG (Second Edition)", ISO/ | |||
IEC 19757-2:2008(E), December 2008. | IEC 19757-2:2008(E), December 2008. | |||
skipping to change at page 93, line 5 ¶ | skipping to change at page 95, line 33 ¶ | |||
[XPOINTER] | [XPOINTER] | |||
Grosso, P., Maler, E., Marsh, J., and N. Walsh, "XPointer | Grosso, P., Maler, E., Marsh, J., and N. Walsh, "XPointer | |||
Framework", W3C Recommendation REC-xptr-framework- | Framework", W3C Recommendation REC-xptr-framework- | |||
20030325, March 2003, | 20030325, March 2003, | |||
<http://www.w3.org/TR/2003/REC-xptr-framework-20030325/>. | <http://www.w3.org/TR/2003/REC-xptr-framework-20030325/>. | |||
Latest version available at <http://www.w3.org/TR/xptr- | Latest version available at <http://www.w3.org/TR/xptr- | |||
framework/>. | framework/>. | |||
9.3. Editorial References | ||||
[IMPNOTES] | ||||
Levkowetz, H., "Implementation notes for RFC7991, "The | ||||
'xml2rfc' Version 3 Vocabulary"", draft-levkowetz-xml2rfc- | ||||
v3-implementation-notes-10 (work in progress), October | ||||
2019. | ||||
9.4. URIs | ||||
[1] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/34 | ||||
[2] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/50 | ||||
[3] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/35 | ||||
[4] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/51 | ||||
[5] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/37 | ||||
[6] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/56 | ||||
[7] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/38 | ||||
[8] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/62 | ||||
[9] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/39 | ||||
[10] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/63 | ||||
[11] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/9 | ||||
[12] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/40 | ||||
[13] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/68 | ||||
[14] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/32 | ||||
[15] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/40 | ||||
[16] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/69 | ||||
[17] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/47 | ||||
[18] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/70 | ||||
[19] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/76 | ||||
[20] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/89 | ||||
[21] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/47 | ||||
[22] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/69 | ||||
[23] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/92 | ||||
[24] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/93 | ||||
[25] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/95 | ||||
[26] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/96 | ||||
[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 "ipr" Attribute | A.1. The "category" Attribute | |||
For RFCs, the "category" attribute (Section 2.49.1) determines the | ||||
"maturity level" (see Section 4 of [RFC2026]). The allowed values | ||||
are "std" for "Standards Track", "bcp" for "BCP", "info" for | ||||
"Informational", "exp" for "Experimental", and "historic" for | ||||
"Historic". | ||||
For Internet-Drafts, the "category" attribute is not needed; when | ||||
supplied, it will appear as "Intended Status". Supplying this | ||||
information can be useful to reviewers. | ||||
A.2. The "ipr" Attribute | ||||
This attribute value can take a long list of values, each of which | This attribute value can take a long list of values, each of which | |||
describes an IPR policy for the document (Section 2.48.5). The | describes an IPR policy for the document (Section 2.49.5). The | |||
values are not the result of a grand design, but they remain simply | values are not the result of a grand design, but they remain simply | |||
for historic reasons. Of these values, only a few are currently in | for historic reasons. Of these values, only a few are currently in | |||
use; all others are supported by various tools for backwards | use; all others are supported by various tools for backwards | |||
compatibility with old source files. | compatibility with old source files. | |||
Note: Some variations of the boilerplate are selected based on the | Note: Some variations of the boilerplate are selected based on the | |||
document's date; therefore, it is important to specify the "year", | document's date; therefore, it is important to specify the "year", | |||
"month", and "day" attributes of the <date> element when archiving | "month", and "day" attributes of the <date> element when archiving | |||
the XML source of an Internet-Draft on the day of submission. | the XML source of an Internet-Draft on the day of submission. | |||
_Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU | _Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU | |||
NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER._ For further information, | NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER._ For further information, | |||
refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>. | refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>. | |||
For the current "Copyright Notice" text, the submissionType attribute | For the current "Copyright Notice" text, the submissionType attribute | |||
of the <rfc> element (Section 2.48.12) determines whether a statement | of the <rfc> element (Section 2.49.12) determines whether a statement | |||
about "Code Components" is inserted (which is the case for the value | about "Code Components" is inserted (which is the case for the value | |||
"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.1.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 <http://trustee.ietf.org/license- | license for code components (see <http://trustee.ietf.org/license- | |||
info/> for further information). The actual text is located in | info/> for further information). The actual text is located in | |||
Section 6 ("Text to Be Included in IETF Documents") of these | Section 6 ("Text to Be Included in IETF Documents") of these | |||
documents. | documents. | |||
skipping to change at page 94, line 15 ¶ | skipping to change at page 99, line 22 ¶ | |||
+----------+--------------------------------+ | +----------+--------------------------------+ | |||
| 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 | | |||
+----------+--------------------------------+ | +----------+--------------------------------+ | |||
The TLP was again updated in March 2015 [TLP5.0], but the changes | The TLP was again updated in March 2015 [TLP5.0], but the changes | |||
made in that version do not affect the boilerplate text. | made in that version do not affect the boilerplate text. | |||
A.1.1.1. trust200902 | A.2.1.1. trust200902 | |||
This value should be used unless one of the more specific | This value should be used unless one of the more specific | |||
"*trust200902" values is a better fit. It produces the text in | "*trust200902" values is a better fit. It produces the text in | |||
Sections 6.a and 6.b of the TLP. | Sections 6.a and 6.b of the TLP. | |||
A.1.1.2. noModificationTrust200902 | A.2.1.2. noModificationTrust200902 | |||
This produces the additional text from Section 6.c.i of the TLP: | This produces the additional text from Section 6.c.i of the TLP: | |||
This document may not be modified, and derivative works of it may | This document may not be modified, and derivative works of it may | |||
not be created, except to format it for publication as an RFC or | not be created, except to format it for publication as an RFC or | |||
to translate it into languages other than English. | to translate it into languages other than English. | |||
Note: this clause is incompatible with RFCs that are published on | Note: this clause is incompatible with RFCs that are published on | |||
the Standards Track. | the Standards Track. | |||
A.1.1.3. noDerivativesTrust200902 | A.2.1.3. noDerivativesTrust200902 | |||
This produces the additional text from Section 6.c.ii of the TLP: | This produces the additional text from Section 6.c.ii of the TLP: | |||
This document may not be modified, and derivative works of it may | This document may not be modified, and derivative works of it may | |||
not be created, and it may not be published except as an Internet- | not be created, and it may not be published except as an Internet- | |||
Draft. | Draft. | |||
Note: this clause is incompatible with RFCs. | Note: this clause is incompatible with RFCs. | |||
A.1.1.4. pre5378Trust200902 | A.2.1.4. pre5378Trust200902 | |||
This produces the additional text from Section 6.c.iii of the TLP, | This produces the additional text from Section 6.c.iii of the TLP, | |||
frequently called the "pre-5378 escape clause" referring to changes | frequently called the "pre-5378 escape clause" referring to changes | |||
introduced in [RFC5378]: | introduced in [RFC5378]: | |||
This document may contain material from IETF Documents or IETF | This document may contain material from IETF Documents or IETF | |||
Contributions published or made publicly available before November | Contributions published or made publicly available before November | |||
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. | |||
skipping to change at page 95, line 4 ¶ | skipping to change at page 100, line 16 ¶ | |||
This produces the additional text from Section 6.c.iii of the TLP, | This produces the additional text from Section 6.c.iii of the TLP, | |||
frequently called the "pre-5378 escape clause" referring to changes | frequently called the "pre-5378 escape clause" referring to changes | |||
introduced in [RFC5378]: | introduced in [RFC5378]: | |||
This document may contain material from IETF Documents or IETF | This document may contain material from IETF Documents or IETF | |||
Contributions published or made publicly available before November | Contributions published or made publicly available before November | |||
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 <http://trustee.ietf.org/docs/IETF-Copyright- | See Section 4 of <http://trustee.ietf.org/docs/IETF-Copyright- | |||
FAQ.pdf> for further information about when to use this value. | FAQ.pdf> for further 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.1.2. Historic Values | A.2.2. Historic Values | |||
A.1.2.1. Historic Values: "*trust200811" | A.2.2.1. Historic Values: "*trust200811" | |||
The attribute values "trust200811", "noModificationTrust200811", and | The attribute values "trust200811", "noModificationTrust200811", and | |||
"noDerivativesTrust200811" are similar to their "trust200902" | "noDerivativesTrust200811" are similar to their "trust200902" | |||
counterparts, except that they use text specified in [TLP1.0]. | counterparts, except that they use text specified in [TLP1.0]. | |||
A.1.2.2. Historic Values: "*3978" | A.2.2.2. Historic Values: "*3978" | |||
The attribute values "full3978", "noModification3978", and | The attribute values "full3978", "noModification3978", and | |||
"noDerivatives3978" are similar to their counterparts above, except | "noDerivatives3978" are similar to their counterparts above, except | |||
that they use text specified in [RFC3978]. | that they use text specified in [RFC3978]. | |||
A.1.2.3. Historic Values: "*3667" | A.2.2.3. Historic Values: "*3667" | |||
The attribute values "full3667", "noModification3667", and | The attribute values "full3667", "noModification3667", and | |||
"noDerivatives3667" are similar to their counterparts above, except | "noDerivatives3667" are similar to their counterparts above, except | |||
that they use text specified in [RFC3667]. | that they use text specified in [RFC3667]. | |||
A.1.2.4. Historic Values: "*2026" | A.2.2.4. Historic Values: "*2026" | |||
The attribute values "full2026" and "noDerivativeWorks2026" are | The attribute values "full2026" and "noDerivativeWorks2026" are | |||
similar to their counterparts above, except that they use text | similar to their counterparts above, except that they use text | |||
specified in Section 10 of [RFC2026]. | specified in Section 10 of [RFC2026]. | |||
The special value "none" was also used back then; it denied the IETF | The special value "none" was also used back then; it denied the IETF | |||
any rights beyond publication as an Internet-Draft. | any rights beyond publication as an Internet-Draft. | |||
A.2. The "submissionType" Attribute | A.3. The "submissionType" Attribute | |||
The RFC Editor publishes documents from different "document streams", | The RFC Editor publishes documents from different "document streams", | |||
of which the "IETF stream" is the most prominent. Other streams are | of which the "IETF stream" is the most prominent. Other streams are | |||
the "Independent Submissions stream" (used for things such as | the "Independent Submissions stream" (used for things such as | |||
discussion of Internet-related technologies that are not part of the | discussion of Internet-related technologies that are not part of the | |||
IETF agenda), the "IAB stream" (Internet Architecture Board), and the | IETF agenda), the "IAB stream" (Internet Architecture Board), and the | |||
"IRTF stream" (Internet Research Task Force). | "IRTF stream" (Internet Research Task Force). | |||
The values for the attribute are "IETF" (the default value), | The values for the attribute are "IETF" (the default value), | |||
"independent", "IAB", and "IRTF". | "independent", "IAB", and "IRTF". | |||
skipping to change at page 96, line 32 ¶ | skipping to change at page 101, line 47 ¶ | |||
Group" or the value of the <workgroup> element). | Group" or the value of the <workgroup> element). | |||
o For RFCs, it affects the whole "Status of This Memo" section (see | o For RFCs, it affects the whole "Status of This Memo" section (see | |||
Section 3.2 of [RFC7841]). | Section 3.2 of [RFC7841]). | |||
o For all RFCs and Internet-Drafts, it determines whether the | o For all RFCs and Internet-Drafts, it determines whether the | |||
"Copyright Notice" section mentions the Copyright on Code | "Copyright Notice" section mentions the Copyright on Code | |||
Components (see Section 6 of the TLP ("Text to Be Included in IETF | Components (see Section 6 of the TLP ("Text to Be Included in IETF | |||
Documents")). | Documents")). | |||
A.3. The "consensus" Attribute | A.4. The "consensus" Attribute | |||
For some of the publication streams (see Appendix A.2), the "Status | For some of the publication streams (see Appendix A.3), the "Status | |||
of This Memo" section depends on whether there was a consensus to | of This Memo" section depends on whether there was a consensus to | |||
publish (again, see Section 3.4 of [RFC7841]). | publish (again, see Section 3.4 of [RFC7841]). | |||
The consensus attribute can be used to supply this information. The | The consensus attribute can be used to supply this information. The | |||
acceptable values are "true" (the default) and "false"; "yes" and | acceptable values are "true" (the default) and "false"; "yes" and | |||
"no" from v2 are deprecated. | "no" from v2 are deprecated. | |||
The effect of this value for the various streams is: | The effect of this value for the various streams is: | |||
o "independent": none. | o "independent": none. | |||
skipping to change at page 98, line 39 ¶ | skipping to change at page 104, line 4 ¶ | |||
B.1. Including External Text with XInclude | B.1. Including External Text with XInclude | |||
All tools for the v3 format are expected to support XInclude | All tools for the v3 format are expected to support XInclude | |||
[XInclude]. XInclude specifies a processing model and syntax for | [XInclude]. XInclude specifies a processing model and syntax for | |||
general-purpose inclusion of information that is either on the | general-purpose inclusion of information that is either on the | |||
Internet or local to the user's computer. | Internet or local to the user's computer. | |||
In the v3 syntax, XInclude is expressed as the <xi:include> element. | In the v3 syntax, XInclude is expressed as the <xi:include> element. | |||
To use this element, you need to include the "xi" namespace in the | To use this element, you need to include the "xi" namespace in the | |||
<rfc> element; that is, you need to specify | <rfc> element; that is, you need to specify | |||
xmlns:xi="http://www.w3.org/2001/XInclude" | xmlns:xi="http://www.w3.org/2001/XInclude" | |||
as one of the attributes in the <rfc> element. | as one of the attributes in the <rfc> element. | |||
The most common way to use <xi:include> is to pull in references that | The most common way to use <xi:include> is to pull in references that | |||
are already formed as XML. Currently, this can be done from | are already formed as XML. Currently, this can be done from | |||
xml2rfc.tools.ietf.org, but later this is expected to be from the RFC | xml2rfc.tools.ietf.org, but later this is expected to be from the RFC | |||
Editor. For example, if a document has three normative references, | Editor. For example, if a document has three normative references, | |||
all RFCs, the document might contain: | all RFCs, the document might contain: | |||
<references> | <references> | |||
<xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | |||
bibxml/reference.RFC.2119.xml"/> | bibxml/reference.RFC.2119.xml"/> | |||
<xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | |||
bibxml/reference.RFC.4869.xml"/> | bibxml/reference.RFC.4869.xml"/> | |||
<xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | <xi:include href="http://xml2rfc.tools.ietf.org/public/rfc/ | |||
bibxml/reference.RFC.7169.xml"/> | bibxml/reference.RFC.7169.xml"/> | |||
</references> | </references> | |||
(the line breaks in the example above have been added for readability | ||||
and need to be removed in practice) | ||||
<xi:include> can be used anywhere an XML element could be used (but | <xi:include> can be used anywhere an XML element could be used (but | |||
not where free text is used). For example, if three Internet-Drafts | not where free text is used). For example, if three Internet-Drafts | |||
are all including a particular paragraph or section verbatim, that | are all including a particular paragraph or section verbatim, that | |||
text can be kept either in a file or somewhere on the web and can be | text can be kept either in a file or somewhere on the web and can be | |||
included with <xi:include>. An example of pulling something from the | included with <xi:include>. An example of pulling something from the | |||
local disk would be: | local disk would be: | |||
<x:include href="file://home/chris/ietf/drafts/commontext.xml"/> | <xi:include href="file://home/chris/ietf/drafts/commontext.xml"/> | |||
In general, XInclude should be used instead of ENTITY references and | In general, XInclude should be used instead of ENTITY references and | |||
XML Processing Instructions (PIs) that allow external inclusions. | XML Processing Instructions (PIs) that allow external inclusions. | |||
B.2. Anchors and IDs | B.2. Anchors and IDs | |||
People writing and reading Internet-Drafts and RFCs often want to | People writing and reading Internet-Drafts and RFCs often want to | |||
make reference to specific locations in those documents. In the case | make reference to specific locations in those documents. In the case | |||
of RFC authors, it is common to want to reference another part of | of RFC authors, it is common to want to reference another part of | |||
their document, such as "see Section 3.2 of this document." Readers, | their document, such as "see Section 3.2 of this document." Readers, | |||
skipping to change at page 102, line 28 ¶ | skipping to change at page 107, line 39 ¶ | |||
characters in it, the value might be "Common,Latin,Han". | characters in it, the value might be "Common,Latin,Han". | |||
o <sourcecode> "originalSrc" attribute -- This attribute is filled | o <sourcecode> "originalSrc" attribute -- This attribute is filled | |||
with the original value of the "src" attribute if that attribute | with the original value of the "src" attribute if that attribute | |||
is removed by the prep tool. | is removed by the prep tool. | |||
o <xref> "derivedContent" attribute -- This attribute is filled in | o <xref> "derivedContent" attribute -- This attribute is filled in | |||
if there is no content in the <xref> element. The value for this | if there is no content in the <xref> element. The value for this | |||
attribute is based on the value in the "displayFormat" attribute. | attribute is based on the value in the "displayFormat" attribute. | |||
Examples of how this value is filled can be found in | Examples of how this value is filled can be found in | |||
Section 2.70.1. | Section 2.71.1. | |||
In addition, note that the contents of the <boilerplate> element are | In addition, note that the contents of the <boilerplate> element are | |||
controlled by the prep tool. | controlled by the prep tool. | |||
Appendix C. RELAX NG Schema | Appendix C. RELAX NG Schema | |||
The following is the RELAX NG schema for the v3 format. | The following is the RELAX NG schema for the v3 format. | |||
namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" | namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" | |||
skipping to change at page 102, line 40 ¶ | skipping to change at page 108, line 4 ¶ | |||
In addition, note that the contents of the <boilerplate> element are | In addition, note that the contents of the <boilerplate> element are | |||
controlled by the prep tool. | controlled by the prep tool. | |||
Appendix C. RELAX NG Schema | Appendix C. RELAX NG Schema | |||
The following is the RELAX NG schema for the v3 format. | The following is the RELAX NG schema for the v3 format. | |||
namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" | namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" | |||
# xml2rfc Version 3 grammar | # xml2rfc Version 3 grammar | |||
rfc = | rfc = | |||
element rfc { | element rfc { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute number { text }?, | attribute number { text }?, | |||
[ a:defaultValue = "" ] attribute obsoletes { text }?, | [ a:defaultValue = "" ] attribute obsoletes { text }?, | |||
[ a:defaultValue = "" ] attribute updates { text }?, | [ a:defaultValue = "" ] attribute updates { text }?, | |||
attribute category { text }?, | attribute category { | |||
"std" | "bcp" | "info" | "exp" | "historic" | ||||
}?, | ||||
attribute mode { text }?, | attribute mode { text }?, | |||
[ a:defaultValue = "false" ] | [ a:defaultValue = "false" ] | |||
attribute consensus { "no" | "yes" | "false" | "true" }?, | attribute consensus { "no" | "yes" | "false" | "true" }?, | |||
attribute seriesNo { text }?, | attribute seriesNo { text }?, | |||
attribute ipr { text }?, | attribute ipr { text }?, | |||
attribute iprExtract { xsd:IDREF }?, | attribute iprExtract { xsd:IDREF }?, | |||
[ a:defaultValue = "IETF" ] | [ a:defaultValue = "IETF" ] | |||
attribute submissionType { | attribute submissionType { | |||
"IETF" | "IAB" | "IRTF" | "independent" | "IETF" | "IAB" | "IRTF" | "independent" | |||
}?, | }?, | |||
skipping to change at page 104, line 31 ¶ | skipping to change at page 109, line 45 ¶ | |||
attribute asciiInitials { text }?, | attribute asciiInitials { text }?, | |||
attribute surname { text }?, | attribute surname { text }?, | |||
attribute asciiSurname { text }?, | attribute asciiSurname { text }?, | |||
attribute fullname { text }?, | attribute fullname { text }?, | |||
attribute role { "editor" }?, | attribute role { "editor" }?, | |||
attribute asciiFullname { text }?, | attribute asciiFullname { text }?, | |||
organization?, | organization?, | |||
address? | address? | |||
} | } | |||
contact = | ||||
element contact { | ||||
attribute xml:base { text }?, | ||||
attribute xml:lang { text }?, | ||||
attribute initials { text }?, | ||||
attribute asciiInitials { text }?, | ||||
attribute surname { text }?, | ||||
attribute asciiSurname { text }?, | ||||
attribute fullname { text }?, | ||||
attribute asciiFullname { text }?, | ||||
organization?, | ||||
address? | ||||
} | ||||
organization = | organization = | |||
element organization { | element organization { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute abbrev { text }?, | attribute abbrev { text }?, | |||
attribute ascii { text }?, | attribute ascii { text }?, | |||
attribute asciiAbbrev { text }?, | attribute asciiAbbrev { text }?, | |||
[ a:defaultValue = "true" ] | [ a:defaultValue = "true" ] | |||
attribute showOnFrontPage { "true" | "false" }?, | attribute showOnFrontPage { "true" | "false" }?, | |||
text | text | |||
} | } | |||
address = | address = | |||
element address { | element address { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
postal?, | postal?, | |||
phone?, | phone?, | |||
facsimile?, | facsimile?, | |||
email?, | email*, | |||
uri? | uri? | |||
} | } | |||
postal = | postal = | |||
element postal { | element postal { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
((city | ((city | |||
| cityarea | | cityarea | |||
| code | | code | |||
| country | | country | |||
skipping to change at page 109, line 23 ¶ | skipping to change at page 114, line 51 ¶ | |||
attribute numbered { "true" | "false" }?, | attribute numbered { "true" | "false" }?, | |||
[ a:defaultValue = "default" ] | [ a:defaultValue = "default" ] | |||
attribute toc { "include" | "exclude" | "default" }?, | attribute toc { "include" | "exclude" | "default" }?, | |||
[ a:defaultValue = "false" ] | [ a:defaultValue = "false" ] | |||
attribute removeInRFC { "true" | "false" }?, | attribute removeInRFC { "true" | "false" }?, | |||
name?, | name?, | |||
(artset | (artset | |||
| artwork | | artwork | |||
| aside | | aside | |||
| blockquote | | blockquote | |||
| contact | ||||
| dl | | dl | |||
| figure | | figure | |||
| iref | | iref | |||
| ol | | ol | |||
| sourcecode | | sourcecode | |||
| t | | t | |||
| table | | table | |||
| texttable | | texttable | |||
| ul)*, | | ul)*, | |||
section* | section* | |||
skipping to change at page 112, line 50 ¶ | skipping to change at page 118, line 32 ¶ | |||
| xref)+) | | xref)+) | |||
} | } | |||
dl = | dl = | |||
element dl { | element dl { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute anchor { xsd:ID }?, | attribute anchor { xsd:ID }?, | |||
[ a:defaultValue = "normal" ] | [ a:defaultValue = "normal" ] | |||
attribute spacing { "normal" | "compact" }?, | attribute spacing { "normal" | "compact" }?, | |||
[ a:defaultValue = "true" ] | [ a:defaultValue = "false" ] | |||
attribute newline { "false" | "true" }?, | attribute newline { "false" | "true" }?, | |||
[ a:defaultValue = "0" ] attribute indent { text }?, | [ a:defaultValue = "0" ] attribute indent { text }?, | |||
attribute pn { text }?, | attribute pn { text }?, | |||
(dt, dd)+ | (dt, dd)+ | |||
} | } | |||
dt = | dt = | |||
element dt { | element dt { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute anchor { xsd:ID }?, | attribute anchor { xsd:ID }?, | |||
skipping to change at page 114, line 32 ¶ | skipping to change at page 120, line 14 ¶ | |||
attribute section { text }, | attribute section { text }, | |||
attribute relative { text }?, | attribute relative { text }?, | |||
attribute derivedLink { text }?, | attribute derivedLink { text }?, | |||
text | text | |||
} | } | |||
eref = | eref = | |||
element eref { | element eref { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
[ a:defaultValue = "none" ] | ||||
attribute brackets { "none" | "angle" }?, | ||||
attribute target { text }, | attribute target { text }, | |||
text | text | |||
} | } | |||
iref = | iref = | |||
element iref { | element iref { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute item { text }, | attribute item { text }, | |||
[ a:defaultValue = "" ] attribute subitem { text }?, | [ a:defaultValue = "" ] attribute subitem { text }?, | |||
skipping to change at page 118, line 51 ¶ | skipping to change at page 124, line 35 ¶ | |||
[ a:defaultValue = "" ] attribute type { text }?, | [ a:defaultValue = "" ] attribute type { text }?, | |||
attribute src { text }?, | attribute src { text }?, | |||
[ a:defaultValue = "left" ] | [ a:defaultValue = "left" ] | |||
attribute align { "left" | "center" | "right" }?, | attribute align { "left" | "center" | "right" }?, | |||
[ a:defaultValue = "" ] attribute alt { text }?, | [ a:defaultValue = "" ] attribute alt { text }?, | |||
[ a:defaultValue = "" ] attribute width { text }?, | [ a:defaultValue = "" ] attribute width { text }?, | |||
[ a:defaultValue = "" ] attribute height { text }?, | [ a:defaultValue = "" ] attribute height { text }?, | |||
attribute originalSrc { text }?, | attribute originalSrc { text }?, | |||
(text* | svg) | (text* | svg) | |||
} | } | |||
# TODO: replace with link to RSE site, or provide an inline version | a:documentation [ "svg element: see Appendix A of [RFC7996]." ] | |||
include "svg.rnc" | include "SVG-1.2-RFC.rnc" | |||
sourcecode = | sourcecode = | |||
element sourcecode { | element sourcecode { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
attribute xml:lang { text }?, | attribute xml:lang { text }?, | |||
attribute anchor { xsd:ID }?, | attribute anchor { xsd:ID }?, | |||
attribute pn { text }?, | attribute pn { text }?, | |||
[ a:defaultValue = "" ] attribute markers { "true" | "false" }?, | ||||
[ a:defaultValue = "" ] attribute name { text }?, | [ a:defaultValue = "" ] attribute name { text }?, | |||
[ a:defaultValue = "" ] attribute type { text }?, | [ a:defaultValue = "" ] attribute type { text }?, | |||
attribute src { text }?, | attribute src { text }?, | |||
attribute originalSrc { text }?, | attribute originalSrc { text }?, | |||
text | text | |||
} | } | |||
thead = | thead = | |||
element thead { | element thead { | |||
attribute xml:base { text }?, | attribute xml:base { text }?, | |||
skipping to change at page 124, line 28 ¶ | skipping to change at page 130, line 16 ¶ | |||
rfc = | rfc = | |||
element rfc { | element rfc { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute number { text }?, | attribute number { text }?, | |||
[ a:defaultValue = "" ] attribute obsoletes { text }?, | [ a:defaultValue = "" ] attribute obsoletes { text }?, | |||
[ a:defaultValue = "" ] attribute updates { text }?, | [ a:defaultValue = "" ] attribute updates { text }?, | |||
- attribute category { "std" | "bcp" | "info" | "exp" | | - attribute category { "std" | "bcp" | "info" | "exp" | | |||
- "historic" }?, | - "historic" }?, | |||
- attribute consensus { "no" | "yes" }?, | - attribute consensus { "no" | "yes" }?, | |||
+ attribute category { text }?, | - attribute seriesNo { text }?, | |||
+ attribute mode { text }?, | ||||
+ [ a:defaultValue = "false" ] | ||||
+ attribute consensus { "no" | "yes" | "false" | "true" }?, | ||||
attribute seriesNo { text }?, | ||||
- attribute ipr { | - attribute ipr { | |||
- "full2026" | - "full2026" | |||
- | "noDerivativeWorks2026" | - | "noDerivativeWorks2026" | |||
- | "none" | - | "none" | |||
- | "full3667" | - | "full3667" | |||
- | "noModification3667" | - | "noModification3667" | |||
- | "noDerivatives3667" | - | "noDerivatives3667" | |||
- | "full3978" | - | "full3978" | |||
- | "noModification3978" | - | "noModification3978" | |||
- | "noDerivatives3978" | - | "noDerivatives3978" | |||
- | "trust200811" | - | "trust200811" | |||
- | "noModificationTrust200811" | - | "noModificationTrust200811" | |||
- | "noDerivativesTrust200811" | - | "noDerivativesTrust200811" | |||
- | "trust200902" | - | "trust200902" | |||
- | "noModificationTrust200902" | - | "noModificationTrust200902" | |||
- | "noDerivativesTrust200902" | - | "noDerivativesTrust200902" | |||
- | "pre5378Trust200902" | - | "pre5378Trust200902" | |||
- }?, | + attribute category { | |||
+ "std" | "bcp" | "info" | "exp" | "historic" | ||||
}?, | ||||
+ attribute mode { text }?, | ||||
+ [ a:defaultValue = "false" ] | ||||
+ attribute consensus { "no" | "yes" | "false" | "true" }?, | ||||
+ attribute seriesNo { text }?, | ||||
+ attribute ipr { text }?, | + attribute ipr { text }?, | |||
attribute iprExtract { xsd:IDREF }?, | attribute iprExtract { xsd:IDREF }?, | |||
[ a:defaultValue = "IETF" ] | [ a:defaultValue = "IETF" ] | |||
attribute submissionType { | attribute submissionType { | |||
"IETF" | "IAB" | "IRTF" | "independent" | "IETF" | "IAB" | "IRTF" | "independent" | |||
}?, | }?, | |||
attribute docName { text }?, | attribute docName { text }?, | |||
- [ a:defaultValue = "en" ] attribute xml:lang { text }?, | - [ a:defaultValue = "en" ] attribute xml:lang { text }?, | |||
+ [ a:defaultValue = "false" ] | + [ a:defaultValue = "false" ] | |||
+ attribute sortRefs { "true" | "false" }?, | + attribute sortRefs { "true" | "false" }?, | |||
skipping to change at page 126, line 26 ¶ | skipping to change at page 132, line 14 ¶ | |||
element author { | element author { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute initials { text }?, | attribute initials { text }?, | |||
+ attribute asciiInitials { text }?, | + attribute asciiInitials { text }?, | |||
attribute surname { text }?, | attribute surname { text }?, | |||
+ attribute asciiSurname { text }?, | + attribute asciiSurname { text }?, | |||
attribute fullname { text }?, | attribute fullname { text }?, | |||
attribute role { "editor" }?, | attribute role { "editor" }?, | |||
+ attribute asciiFullname { text }?, | + attribute asciiFullname { text }?, | |||
+ organization?, | ||||
+ address? | ||||
+ } | ||||
+ contact = | ||||
+ element contact { | ||||
+ attribute xml:base { text }?, | ||||
+ attribute xml:lang { text }?, | ||||
+ attribute initials { text }?, | ||||
+ attribute asciiInitials { text }?, | ||||
+ attribute surname { text }?, | ||||
+ attribute asciiSurname { text }?, | ||||
+ attribute fullname { text }?, | ||||
+ attribute asciiFullname { text }?, | ||||
organization?, | organization?, | |||
address? | address? | |||
} | } | |||
organization = | organization = | |||
element organization { | element organization { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute abbrev { text }?, | attribute abbrev { text }?, | |||
+ attribute ascii { text }?, | + attribute ascii { text }?, | |||
+ attribute asciiAbbrev { text }?, | + attribute asciiAbbrev { text }?, | |||
skipping to change at page 126, line 47 ¶ | skipping to change at page 132, line 48 ¶ | |||
+ attribute showOnFrontPage { "true" | "false" }?, | + attribute showOnFrontPage { "true" | "false" }?, | |||
+ text | + text | |||
+ } | + } | |||
+ address = | + address = | |||
+ element address { | + element address { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ postal?, | + postal?, | |||
+ phone?, | + phone?, | |||
+ facsimile?, | + facsimile?, | |||
+ email?, | + email*, | |||
+ uri? | + uri? | |||
+ } | + } | |||
+ postal = | + postal = | |||
+ element postal { | + element postal { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ ((city | + ((city | |||
+ | cityarea | + | cityarea | |||
+ | code | + | code | |||
+ | country | + | country | |||
skipping to change at page 130, line 51 ¶ | skipping to change at page 137, line 4 ¶ | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ section+ | + section+ | |||
} | } | |||
- middle = element middle { section+ } | - middle = element middle { section+ } | |||
section = | section = | |||
element section { | element section { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute anchor { xsd:ID }?, | attribute anchor { xsd:ID }?, | |||
- attribute title { text }, | - attribute title { text }, | |||
+ attribute pn { text }?, | + attribute pn { text }?, | |||
+ attribute title { text }?, | + attribute title { text }?, | |||
+ [ a:defaultValue = "true" ] | + [ a:defaultValue = "true" ] | |||
+ attribute numbered { "true" | "false" }?, | + attribute numbered { "true" | "false" }?, | |||
[ a:defaultValue = "default" ] | [ a:defaultValue = "default" ] | |||
attribute toc { "include" | "exclude" | "default" }?, | attribute toc { "include" | "exclude" | "default" }?, | |||
- (t | figure | texttable | iref)*, | - (t | figure | texttable | iref)*, | |||
+ [ a:defaultValue = "false" ] | + [ a:defaultValue = "false" ] | |||
+ attribute removeInRFC { "true" | "false" }?, | + attribute removeInRFC { "true" | "false" }?, | |||
+ name?, | + name?, | |||
+ (artset | + (artset | |||
+ | artwork | + | artwork | |||
+ | aside | + | aside | |||
+ | blockquote | + | blockquote | |||
+ | contact | ||||
+ | dl | + | dl | |||
+ | figure | + | figure | |||
+ | iref | + | iref | |||
+ | ol | + | ol | |||
+ | sourcecode | + | sourcecode | |||
+ | t | + | t | |||
+ | table | + | table | |||
+ | texttable | + | texttable | |||
+ | ul)*, | + | ul)*, | |||
section* | section* | |||
skipping to change at page 134, line 43 ¶ | skipping to change at page 140, line 45 ¶ | |||
+ | tt | + | tt | |||
+ | xref)+) | + | xref)+) | |||
+ } | + } | |||
+ dl = | + dl = | |||
+ element dl { | + element dl { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ attribute anchor { xsd:ID }?, | + attribute anchor { xsd:ID }?, | |||
+ [ a:defaultValue = "normal" ] | + [ a:defaultValue = "normal" ] | |||
+ attribute spacing { "normal" | "compact" }?, | + attribute spacing { "normal" | "compact" }?, | |||
+ [ a:defaultValue = "true" ] | + [ a:defaultValue = "false" ] | |||
+ attribute newline { "false" | "true" }?, | + attribute newline { "false" | "true" }?, | |||
+ [ a:defaultValue = "0" ] attribute indent { text }?, | + [ a:defaultValue = "0" ] attribute indent { text }?, | |||
+ attribute pn { text }?, | + attribute pn { text }?, | |||
+ (dt, dd)+ | + (dt, dd)+ | |||
+ } | + } | |||
+ dt = | + dt = | |||
+ element dt { | + element dt { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ attribute anchor { xsd:ID }?, | + attribute anchor { xsd:ID }?, | |||
skipping to change at page 135, line 50 ¶ | skipping to change at page 142, line 4 ¶ | |||
xref = | xref = | |||
element xref { | element xref { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute target { xsd:IDREF }, | attribute target { xsd:IDREF }, | |||
- [ a:defaultValue = "false" ] attribute pageno { "true" | | - [ a:defaultValue = "false" ] attribute pageno { "true" | | |||
- "false" }?, | - "false" }?, | |||
+ [ a:defaultValue = "false" ] | + [ a:defaultValue = "false" ] | |||
+ attribute pageno { "true" | "false" }?, | + attribute pageno { "true" | "false" }?, | |||
[ a:defaultValue = "default" ] | [ a:defaultValue = "default" ] | |||
- attribute format { "counter" | "title" | "none" | "default" | - attribute format { "counter" | "title" | "none" | "default" | |||
+ attribute format { "default" | "title" | "counter" | "none" | + attribute format { "default" | "title" | "counter" | "none" | |||
}?, | + }?, | |||
+ attribute derivedContent { text }?, | + attribute derivedContent { text }?, | |||
+ text | + text | |||
+ } | + } | |||
+ relref = | + relref = | |||
+ element relref { | + element relref { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ attribute target { xsd:IDREF }, | + attribute target { xsd:IDREF }, | |||
+ [ a:defaultValue = "of" ] | + [ a:defaultValue = "of" ] | |||
+ attribute displayFormat { "of" | "comma" | "parens" | "bare" | + attribute displayFormat { "of" | "comma" | "parens" | "bare" | |||
+ }?, | }?, | |||
+ attribute section { text }, | + attribute section { text }, | |||
+ attribute relative { text }?, | + attribute relative { text }?, | |||
+ attribute derivedLink { text }?, | + attribute derivedLink { text }?, | |||
text | text | |||
} | } | |||
eref = | eref = | |||
element eref { | element eref { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ [ a:defaultValue = "none" ] | ||||
+ attribute brackets { "none" | "angle" }?, | ||||
attribute target { text }, | attribute target { text }, | |||
text | text | |||
} | } | |||
iref = | iref = | |||
element iref { | element iref { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
attribute item { text }, | attribute item { text }, | |||
[ a:defaultValue = "" ] attribute subitem { text }?, | [ a:defaultValue = "" ] attribute subitem { text }?, | |||
[ a:defaultValue = "false" ] | [ a:defaultValue = "false" ] | |||
skipping to change at page 140, line 36 ¶ | skipping to change at page 146, line 40 ¶ | |||
attribute src { text }?, | attribute src { text }?, | |||
[ a:defaultValue = "left" ] | [ a:defaultValue = "left" ] | |||
attribute align { "left" | "center" | "right" }?, | attribute align { "left" | "center" | "right" }?, | |||
[ a:defaultValue = "" ] attribute alt { text }?, | [ a:defaultValue = "" ] attribute alt { text }?, | |||
[ a:defaultValue = "" ] attribute width { text }?, | [ a:defaultValue = "" ] attribute width { text }?, | |||
[ a:defaultValue = "" ] attribute height { text }?, | [ a:defaultValue = "" ] attribute height { text }?, | |||
- text* | - text* | |||
+ attribute originalSrc { text }?, | + attribute originalSrc { text }?, | |||
+ (text* | svg) | + (text* | svg) | |||
+ } | + } | |||
+ # TODO: replace with link to RSE site, or provide an inline | + a:documentation [ "svg element: see Appendix A of [RFC7996]." ] | |||
+ version | + include "SVG-1.2-RFC.rnc" | |||
+ include "svg.rnc" | ||||
+ sourcecode = | + sourcecode = | |||
+ element sourcecode { | + element sourcecode { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ attribute anchor { xsd:ID }?, | + attribute anchor { xsd:ID }?, | |||
+ attribute pn { text }?, | + attribute pn { text }?, | |||
+ [ a:defaultValue = "" ] attribute markers { "true" | "false" | ||||
+ }?, | ||||
+ [ a:defaultValue = "" ] attribute name { text }?, | + [ a:defaultValue = "" ] attribute name { text }?, | |||
+ [ a:defaultValue = "" ] attribute type { text }?, | + [ a:defaultValue = "" ] attribute type { text }?, | |||
+ attribute src { text }?, | + attribute src { text }?, | |||
+ attribute originalSrc { text }?, | + attribute originalSrc { text }?, | |||
+ text | + text | |||
+ } | + } | |||
+ thead = | + thead = | |||
+ element thead { | + element thead { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
skipping to change at page 145, line 34 ¶ | skipping to change at page 151, line 38 ¶ | |||
+ | xref)* | + | xref)* | |||
+ } | + } | |||
+ refcontent = | + refcontent = | |||
+ element refcontent { | + element refcontent { | |||
+ attribute xml:base { text }?, | + attribute xml:base { text }?, | |||
+ attribute xml:lang { text }?, | + attribute xml:lang { text }?, | |||
+ (text | bcp14 | em | strong | sub | sup | tt)* | + (text | bcp14 | em | strong | sub | sup | tt)* | |||
+ } | + } | |||
+ start |= rfc | + start |= rfc | |||
Appendix E. Change Log | ||||
This section is to be removed before publishing as an RFC. | ||||
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: | ||||
[[TBRxxx: see ...]]. | ||||
E.1. Since draft-iab-rfc7991bis-00 | ||||
o Allow both "src" attribute and content on <artwork> again (#34 | ||||
[1], PR50 [2]) | ||||
o Allow <blockquote> in <li> (#35 [3], PR51 [4]) | ||||
o Remove <br> element (#37 [5], PR56 [6], Section 3.1.5 of | ||||
[IMPNOTES]) | ||||
o Replace "hanging" attribute on <dl> by "newline" (#38 [7], PR62 | ||||
[8], Section 3.1.6 of [IMPNOTES]) | ||||
o Add "indent" attribute to <dl> #39 [9], PR63 [10], Section 3.1.7 | ||||
of [IMPNOTES]) | ||||
o Revise <table> and caption alignment (#9 [11] and #40 [12], PR68 | ||||
[13], Section 3.1.8 of [IMPNOTES]) | ||||
E.2. Since draft-iab-rfc7991bis-01 | ||||
o Extend the list of allowed child elements of <name> (#32 [14] and | ||||
#40 [15], PR69 [16], Section 3.1.11 of [IMPNOTES]) | ||||
o Allow <references> elements to be nested (#47 [17], PR70 [18], | ||||
Section 3.1.6 of [IMPNOTES]) [[TBR135: see <https://github.com/ | ||||
rfc-format/draft-iab-xml2rfc-v3-bis/issues/135>]] | ||||
o Added <artset> (#76 [19], PR89 [20], Section 3.1.1 of [IMPNOTES]) | ||||
[[TBR136: see <https://github.com/rfc-format/draft-iab-xml2rfc-v3- | ||||
bis/issues/136>]] | ||||
o Remove <list> from <aside>, add <table> to <blockquote> (#47 [21], | ||||
PR69 [22], Section 3.1.4 of [IMPNOTES]) | ||||
o Remove <iref> from <table> (PR92 [23], Section 3.1.9 of | ||||
[IMPNOTES]) [[TBR94: see <https://github.com/rfc-format/draft-iab- | ||||
xml2rfc-v3-bis/issues/94>]] | ||||
o Add attributes "asciiAbbrev" and "showOnFrontPage" to | ||||
<organization> (PR93 [24], Section 3.1.12 of [IMPNOTES]) | ||||
o Rename "quoteTitle" attribute to "quote-title" (PR95 [25], | ||||
Section 3.1.14 of [IMPNOTES]) [[TBR48: see <https://github.com/ | ||||
rfc-format/draft-iab-xml2rfc-v3-bis/issues/48>]] | ||||
o Add target attribute to <referencegroup> (PR96 [26], | ||||
Section 3.1.15 of [IMPNOTES]) | ||||
o Introduce new child elements of <postal> (PR97 [27], | ||||
Section 3.1.13 of [IMPNOTES]) [[TBR137: see <https://github.com/ | ||||
rfc-format/draft-iab-xml2rfc-v3-bis/issues/137>]] | ||||
o Undeprecate <seriesInfo> inside <reference>, and remove special | ||||
cases related to it appearing inside <front> (PR108 [28], | ||||
Section 3.1.21.3 of [IMPNOTES]) | ||||
o State that descendants of unnumbered sections are unnumbered by | ||||
default (PR108 [29]) | ||||
o Restore original definition of name attribute on <seriesInfo> | ||||
(PR108 [30], Section 3.1.21.2 of [IMPNOTES]) | ||||
o Regenerate Section 3 based on current grammar (#111 [31]) | ||||
o Author is now John Levine. | ||||
E.3. Since draft-iab-rfc7991bis-02 | ||||
o Update Acknowledgements. | ||||
E.4. Since draft-iab-rfc7991bis-03 | ||||
o Allow multiple <email> elements inside <address> | ||||
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/4>) | ||||
o Add "markers" attribute to <sourcecode> element | ||||
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/8>) | ||||
o Add missing include directive for SVG grammar | ||||
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/11>) | ||||
o Remove incorrect text about deprecation of "alt" attribute on | ||||
<artwork>, add more prose for several other deprecations on this | ||||
element (<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/12>) | ||||
o Undeprecate <xref> format "none" (<https://github.com/rfc-format/ | ||||
draft-iab-xml2rfc-v3-bis/issues/17>) | ||||
o Editorial fixes in Appendix B.1 (<https://github.com/rfc-format/ | ||||
draft-iab-xml2rfc-v3-bis/issues/18>) | ||||
o State that xreffing a hidden <cref> is an error | ||||
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/74>) | ||||
o Fix prose and default value for <dl> element's "newline" attribute | ||||
(<https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/ | ||||
issues/77>) | ||||
o Add <contact> as a block-level element for styling contributor | ||||
information (<https://github.com/rfc-format/draft-iab-xml2rfc-v3- | ||||
bis/issues/81>) | ||||
o In <rfc>'s description of the "consensus" attribute, link to | ||||
Appendix A.4 (<https://github.com/rfc-format/draft-iab-xml2rfc-v3- | ||||
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/rfc- | ||||
format/draft-iab-xml2rfc-v3-bis/issues/146>) | ||||
Index | Index | |||
A | A | |||
Attributes | Attributes | |||
abbrev 43, 73 | abbrev 45, 76 | |||
align 15, 33, 68, 70, 72, 83-84 | align 16, 35, 71, 73, 75, 86-87 | |||
alt 15, 33 | alt 16, 35 | |||
anchor 11, 13, 15, 18, 22, 24, 27-28, 30, 33, 38, 41, 46-48, | anchor 12, 14, 16, 18, 22, 26, 28, 30-31, 35, 39, 43, 48-50, | |||
57, 61, 66, 68, 70-75, 83 | 60, 64, 69, 71, 73, 75-78, 86 | |||
ascii 22-23, 31-32, 43-45, 49, 60, 63, 73 | ascii 23-25, 32, 34, 45-47, 51, 63, 66, 76 | |||
asciiAbbrev 43 | asciiAbbrev 45 | |||
asciiFullname 18 | asciiFullname 19, 24 | |||
asciiInitials 18 | asciiInitials 19, 24 | |||
asciiName 59 | asciiName 61 | |||
asciiSurname 19 | asciiSurname 19, 24 | |||
asciiValue 59 | asciiValue 61 | |||
blankLines 85 | blankLines 88 | |||
category 53 | brackets 34 | |||
category 55 | ||||
cite 22 | cite 22 | |||
colspan 70, 72 | colspan 73, 75 | |||
consensus 53 | consensus 56 | |||
counter 80 | counter 83 | |||
day 25 | day 27 | |||
display 24 | display 26 | |||
displayFormat 50 | displayFormat 52 | |||
docName 54 | docName 56 | |||
empty 75 | empty 78 | |||
format 77 | format 79 | |||
fullname 19 | fullname 19, 24 | |||
group 41 | group 43 | |||
hangIndent 80 | hangIndent 83 | |||
hangText 66 | hangText 69 | |||
height 16, 33 | height 16, 35 | |||
href 38 | href 40 | |||
indent 28 | indent 30 | |||
indexInclude 54 | indexInclude 56 | |||
initials 19 | initials 20, 24 | |||
ipr 54 | ipr 57 | |||
iprExtract 54 | iprExtract 57 | |||
item 35 | item 37 | |||
keepWithNext 66 | keepWithNext 69 | |||
keepWithPrevious 67 | keepWithPrevious 70 | |||
month 25 | markers 64 | |||
name 16, 59, 61 | month 27 | |||
newline 28 | name 16, 61, 64 | |||
number 54 | newline 30 | |||
numbered 57 | number 57 | |||
obsoletes 54 | numbered 60 | |||
octets 79 | obsoletes 57 | |||
pageno 78 | octets 83 | |||
prepTime 54 | pageno 81 | |||
primary 36 | prepTime 57 | |||
quote-title 47 | primary 37 | |||
quote-title 49 | ||||
quotedFrom 22 | quotedFrom 22 | |||
rel 38 | rel 40 | |||
relative 52 | relative 54 | |||
removeInRFC 40, 58 | removeInRFC 42, 60 | |||
role 19 | role 20 | |||
rowspan 70, 73 | rowspan 73, 75 | |||
section 53 | section 55 | |||
seriesNo 55 | seriesNo 57 | |||
showOnFrontPage 43 | showOnFrontPage 45 | |||
sortRefs 55 | sortRefs 57 | |||
source 24 | source 26 | |||
spacing 29, 41, 75 | spacing 30, 43, 78 | |||
src 16, 34, 62 | src 17, 36, 64 | |||
start 41 | start 43 | |||
status 59 | status 62 | |||
stream 60 | stream 62 | |||
style 80, 82-83 | style 83, 85-86 | |||
subitem 36 | subitem 38 | |||
submissionType 55 | submissionType 58 | |||
suppress-title 34, 83 | suppress-title 36, 86 | |||
surname 19 | surname 20, 24 | |||
symRefs 55 | symRefs 58 | |||
target 27, 32, 47, 53, 78, 80 | target 29, 34, 49, 55, 82-83 | |||
title 34, 41, 48, 58, 83 | title 36, 43, 50, 61, 87 | |||
to 27 | to 29 | |||
toc 58 | toc 61 | |||
tocDepth 55 | tocDepth 58 | |||
tocInclude 56 | tocInclude 58 | |||
type 16, 42, 62, 80 | type 17, 44, 64, 83 | |||
updates 56 | updates 59 | |||
value 60 | value 62 | |||
version 56 | version 59 | |||
width 17, 34, 84 | width 18, 36, 87 | |||
xml:space 17, 82 | xml:space 18, 85 | |||
year 25 | year 27 | |||
abbrev attribute | abbrev attribute | |||
in organization element 43 | in organization element 45 | |||
in title element 73 | in title element 76 | |||
abstract element 11, 102 | abstract element 11, 107 | |||
anchor attribute 11 | anchor attribute 12 | |||
inside front 35 | inside front 37 | |||
address element 11, 102 | address element 12, 107 | |||
inside author 18 | inside author 19 | |||
inside contact 24 | ||||
align attribute | align attribute | |||
in artwork element 15 | in artwork element 16 | |||
in figure element 33 | in figure element 35 | |||
in table element 68 | in table element 71 | |||
in td element 70 | in td element 73 | |||
in texttable element 83 | in texttable element 86 | |||
in th element 72 | in th element 75 | |||
in ttcol element 84 | in ttcol element 87 | |||
alt attribute | alt attribute | |||
in artwork element 15 | in artwork element 16 | |||
in figure element 33 | in figure element 35 | |||
anchor attribute | anchor attribute | |||
in abstract element 11 | in abstract element 12 | |||
in artset element 13 | in artset element 14 | |||
in artwork element 15 | in artwork element 16 | |||
in aside element 18 | in aside element 18 | |||
in blockquote element 22 | in blockquote element 22 | |||
in cref element 24 | in cref element 26 | |||
in dd element 27 | in dd element 28 | |||
in dl element 28 | in dl element 30 | |||
in dt element 30 | in dt element 31 | |||
in figure element 33 | in figure element 35 | |||
in li element 38 | in li element 39 | |||
in ol element 41 | in ol element 43 | |||
in reference element 46 | in reference element 48 | |||
in referencegroup element 47 | in referencegroup element 49 | |||
in references element 48 | in references element 50 | |||
in section element 57 | in section element 60 | |||
in sourcecode element 61 | in sourcecode element 64 | |||
in t element 66 | in t element 69 | |||
in table element 68 | in table element 71 | |||
in tbody element 68 | in tbody element 71 | |||
in td element 70 | in td element 73 | |||
in texttable element 83 | in texttable element 86 | |||
in tfoot element 71 | in tfoot element 73 | |||
in th element 72 | in th element 75 | |||
in thead element 73 | in thead element 76 | |||
in tr element 74 | in tr element 77 | |||
in ul element 75 | in ul element 78 | |||
annotation element 12, 102 | annotation element 12, 107 | |||
inside reference 46 | inside reference 48 | |||
application/rfc+xml Media Type 86 | application/rfc+xml Media Type 89 | |||
area element 13, 102 | area element 13, 107 | |||
inside front 35 | inside front 36 | |||
artset element 13, 102 | artset element 14, 107 | |||
anchor attribute 13 | anchor attribute 14 | |||
inside aside 17 | inside aside 18 | |||
inside blockquote 20 | inside blockquote 21 | |||
inside dd 26 | inside dd 27 | |||
inside figure 33 | inside figure 35 | |||
inside li 36 | inside li 38 | |||
inside section 56 | inside section 59 | |||
inside td 69 | inside td 71 | |||
inside th 71 | inside th 74 | |||
artwork element 14, 102 | artwork element 14, 107 | |||
align attribute 15 | align attribute 16 | |||
alt attribute 15 | alt attribute 16 | |||
anchor attribute 15 | anchor attribute 16 | |||
height attribute 16 | height attribute 16 | |||
inside artset 13 | inside artset 14 | |||
inside aside 17 | inside aside 18 | |||
inside blockquote 20 | inside blockquote 21 | |||
inside dd 26 | inside dd 27 | |||
inside figure 33 | inside figure 35 | |||
inside li 36 | inside li 38 | |||
inside section 56 | inside section 59 | |||
inside td 69 | inside td 72 | |||
inside th 71 | inside th 74 | |||
name attribute 16 | name attribute 16 | |||
src attribute 16 | src attribute 17 | |||
type attribute 16 | type attribute 17 | |||
width attribute 17 | width attribute 18 | |||
xml:space attribute 17 | xml:space attribute 18 | |||
ascii attribute | ascii attribute | |||
in city element 22 | in city element 23 | |||
in cityarea element 23 | in cityarea element 23 | |||
in code element 23 | in code element 24 | |||
in country element 23 | in country element 25 | |||
in email element 31 | in email element 32 | |||
in extaddr element 32 | in extaddr element 34 | |||
in organization element 43 | in organization element 45 | |||
in pobox element 44 | in pobox element 46 | |||
in postalLine element 45 | in postalLine element 47 | |||
in region element 49 | in region element 51 | |||
in sortingcode element 60 | in sortingcode element 63 | |||
in street element 63 | in street element 66 | |||
in title element 73 | in title element 76 | |||
asciiAbbrev attribute | asciiAbbrev attribute | |||
in organization element 43 | in organization element 45 | |||
asciiFullname attribute | asciiFullname attribute | |||
in author element 18 | in author element 19 | |||
in contact element 24 | ||||
asciiInitials attribute | asciiInitials attribute | |||
in author element 18 | in author element 19 | |||
in contact element 24 | ||||
asciiName attribute | asciiName attribute | |||
in seriesInfo element 59 | in seriesInfo element 61 | |||
asciiSurname attribute | asciiSurname attribute | |||
in author element 19 | in author element 19 | |||
in contact element 24 | ||||
asciiValue attribute | asciiValue attribute | |||
in seriesInfo element 59 | in seriesInfo element 61 | |||
aside element 17, 102 | aside element 18, 107 | |||
anchor attribute 18 | anchor attribute 18 | |||
inside section 57 | inside section 59 | |||
author element 18, 102 | author element 18, 107 | |||
asciiFullname attribute 18 | asciiFullname attribute 19 | |||
asciiInitials attribute 18 | asciiInitials attribute 19 | |||
asciiSurname attribute 19 | asciiSurname attribute 19 | |||
fullname attribute 19 | fullname attribute 19 | |||
initials attribute 19 | initials attribute 20 | |||
inside front 34 | inside front 36 | |||
role attribute 19 | role attribute 20 | |||
surname attribute 19 | surname attribute 20 | |||
B | B | |||
back element 19, 102 | back element 20, 107 | |||
inside rfc 53 | inside rfc 55 | |||
bcp14 element 20, 102 | bcp14 element 20, 107 | |||
inside annotation 12 | inside annotation 13 | |||
inside blockquote 21 | inside blockquote 22 | |||
inside dd 26 | inside dd 28 | |||
inside dt 29 | inside dt 31 | |||
inside em 30 | inside em 32 | |||
inside li 37 | inside li 39 | |||
inside name 39 | inside name 41 | |||
inside preamble 81 | inside preamble 84 | |||
inside refcontent 46 | inside refcontent 48 | |||
inside strong 63 | inside strong 66 | |||
inside sub 64 | inside sub 67 | |||
inside sup 65 | inside sup 68 | |||
inside t 66 | inside t 68 | |||
inside td 69 | inside td 72 | |||
inside th 71 | inside th 74 | |||
inside tt 74 | inside tt 77 | |||
blankLines attribute | blankLines attribute | |||
in vspace element 85 | in vspace element 88 | |||
blockquote element 20, 102 | blockquote element 21, 107 | |||
anchor attribute 22 | anchor attribute 22 | |||
cite attribute 22 | cite attribute 22 | |||
inside li 37 | inside li 38 | |||
inside section 57 | inside section 59 | |||
quotedFrom attribute 22 | quotedFrom attribute 22 | |||
boilerplate element 22, 102 | boilerplate element 23, 107 | |||
inside front 35 | inside front 37 | |||
brackets attribute | ||||
in eref element 34 | ||||
C | C | |||
c element 79, 102 | c element 82, 107 | |||
inside texttable 82 | inside texttable 86 | |||
category attribute | category attribute | |||
in rfc element 53 | in rfc element 55 | |||
cite attribute | cite attribute | |||
in blockquote element 22 | in blockquote element 22 | |||
city element 22, 102 | city element 23, 107 | |||
ascii attribute 22 | ||||
inside postal 44 | ||||
cityarea element 22, 102 | ||||
ascii attribute 23 | ascii attribute 23 | |||
inside postal 44 | inside postal 46 | |||
code element 23, 102 | cityarea element 23, 107 | |||
ascii attribute 23 | ascii attribute 23 | |||
inside postal 44 | inside postal 46 | |||
code element 23, 107 | ||||
ascii attribute 24 | ||||
inside postal 46 | ||||
colspan attribute | colspan attribute | |||
in td element 70 | in td element 73 | |||
in th element 72 | in th element 75 | |||
consensus attribute | consensus attribute | |||
in rfc element 53 | in rfc element 56 | |||
contact element 24, 107 | ||||
asciiFullname attribute 24 | ||||
asciiInitials attribute 24 | ||||
asciiSurname attribute 24 | ||||
fullname attribute 24 | ||||
initials attribute 24 | ||||
inside section 59 | ||||
surname attribute 24 | ||||
counter attribute | counter attribute | |||
in list element 80 | in list element 83 | |||
country element 23, 102 | country element 24, 107 | |||
ascii attribute 23 | ascii attribute 25 | |||
inside postal 44 | inside postal 46 | |||
cref element 23, 102 | cref element 25, 107 | |||
anchor attribute 24 | anchor attribute 26 | |||
display attribute 24 | display attribute 26 | |||
inside annotation 12 | inside annotation 13 | |||
inside blockquote 21 | inside blockquote 22 | |||
inside c 79 | inside c 82 | |||
inside dd 26 | inside dd 28 | |||
inside dt 29 | inside dt 31 | |||
inside em 30 | inside em 32 | |||
inside li 37 | inside li 39 | |||
inside name 39 | inside name 41 | |||
inside postamble 80 | inside postamble 84 | |||
inside preamble 81 | inside preamble 84 | |||
inside strong 63 | inside strong 66 | |||
inside sub 64 | inside sub 67 | |||
inside sup 65 | inside sup 68 | |||
inside t 66 | inside t 69 | |||
inside td 69 | inside td 72 | |||
inside th 72 | inside th 74 | |||
inside tt 74 | inside tt 77 | |||
inside ttcol 84 | inside ttcol 87 | |||
source attribute 24 | source attribute 26 | |||
D | D | |||
date element 24, 102 | date element 26, 107 | |||
day attribute 25 | day attribute 27 | |||
inside front 35 | inside front 36 | |||
month attribute 25 | month attribute 27 | |||
year attribute 25 | year attribute 27 | |||
day attribute | day attribute | |||
in date element 25 | in date element 27 | |||
dd element 25, 102 | dd element 27, 107 | |||
anchor attribute 27 | anchor attribute 28 | |||
inside dl 28 | inside dl 30 | |||
display attribute | display attribute | |||
in cref element 24 | in cref element 26 | |||
displayFormat attribute | displayFormat attribute | |||
in relref element 50 | in relref element 52 | |||
displayreference element 27, 102 | displayreference element 29, 107 | |||
inside back 20 | inside back 20 | |||
target attribute 27 | target attribute 29 | |||
to attribute 27 | to attribute 29 | |||
dl element 28, 102 | dl element 29, 107 | |||
anchor attribute 28 | ||||
indent attribute 28 | ||||
inside abstract 11 | ||||
inside aside 17 | ||||
inside blockquote 20 | ||||
inside dd 26 | ||||
inside li 37 | ||||
inside note 40 | ||||
inside section 57 | ||||
inside td 69 | ||||
inside th 71 | ||||
newline attribute 28 | ||||
spacing attribute 29 | ||||
docName attribute | ||||
in rfc element 54 | ||||
dt element 29, 102 | ||||
anchor attribute 30 | anchor attribute 30 | |||
inside dl 28 | indent attribute 30 | |||
inside abstract 12 | ||||
inside aside 18 | ||||
inside blockquote 21 | ||||
inside dd 27 | ||||
inside li 38 | ||||
inside note 42 | ||||
inside section 59 | ||||
inside td 72 | ||||
inside th 74 | ||||
newline attribute 30 | ||||
spacing attribute 30 | ||||
docName attribute | ||||
in rfc element 56 | ||||
dt element 31, 107 | ||||
anchor attribute 31 | ||||
inside dl 30 | ||||
E | E | |||
Elements | Elements | |||
abstract 11, 35 | abstract 11, 37 | |||
address 11, 18 | address 12, 19, 24 | |||
annotation 12, 46 | annotation 12, 48 | |||
area 13, 35 | area 13, 36 | |||
artset 13, 17, 20, 26, 33, 36, 56, 69, 71 | artset 14, 18, 21, 27, 35, 38, 59, 71, 74 | |||
artwork 13-14, 17, 20, 26, 33, 36, 56, 69, 71 | artwork 14, 18, 21, 27, 35, 38, 59, 72, 74 | |||
aside 17, 57 | aside 18, 59 | |||
author 18, 34 | author 18, 36 | |||
back 19, 53 | back 20, 55 | |||
bcp14 12, 20-21, 26, 29-30, 37, 39, 46, 63-66, 69, 71, 74, 81 | bcp14 13, 20, 22, 28, 31-32, 39, 41, 48, 66-68, 72, 74, 77, 84 | |||
blockquote 20, 37, 57 | blockquote 21, 38, 59 | |||
boilerplate 22, 35 | boilerplate 23, 37 | |||
c 79, 82 | c 82, 86 | |||
city 22, 44 | city 23, 46 | |||
cityarea 22, 44 | cityarea 23, 46 | |||
code 23, 44 | code 23, 46 | |||
country 23, 44 | contact 24, 59 | |||
cref 12, 21, 23, 26, 29-30, 37, 39, 63-66, 69, 72, 74, 79-81, | country 24, 46 | |||
cref 13, 22, 25, 28, 31-32, 39, 41, 66-69, 72, 74, 77, 82, 84, | ||||
87 | ||||
date 26, 36 | ||||
dd 27, 30 | ||||
displayreference 20, 29 | ||||
dl 12, 18, 21, 27, 29, 38, 42, 59, 72, 74 | ||||
dt 30-31 | ||||
em 13, 22, 25, 28, 31, 39, 41, 48, 66-69, 72, 74, 77, 84 | ||||
email 12, 32 | ||||
eref 13, 22, 25, 28, 31-33, 39, 41, 66-69, 72, 75, 77, 82, 84, | ||||
87 | ||||
extaddr 34, 46 | ||||
facsimile 12, 82 | ||||
figure 18, 21, 27, 34, 38, 59, 72, 74 | ||||
format 48, 82 | ||||
front 36, 48, 55 | ||||
iref 13, 18, 22, 28, 31-32, 34, 37, 39, 41, 60, 66-69, 72, 75, | ||||
77, 82, 84, 87 | ||||
keyword 37-38 | ||||
li 38, 43, 78 | ||||
link 40, 55 | ||||
list 69, 83 | ||||
middle 41, 55 | ||||
name 34, 41-42, 50, 59, 70, 85 | ||||
note 37, 42 | ||||
ol 12, 18, 21, 27, 38, 42-43, 60, 72, 74 | ||||
organization 19, 24, 45 | ||||
phone 12, 45 | ||||
pobox 46 | ||||
postal 12, 46 | ||||
postalLine 47 | ||||
postamble 35, 83, 86 | ||||
preamble 35, 84-85 | ||||
refcontent 47-48 | ||||
reference 48-50 | ||||
referencegroup 49-50 | ||||
references 20, 49-50 | ||||
region 46, 51 | ||||
relref 13, 22, 25, 28, 31-32, 39, 41, 51, 66-69, 72, 75, 77, | ||||
84 | 84 | |||
date 24, 35 | rfc 55 | |||
dd 25, 28 | section 20, 23, 41, 59-60 | |||
displayreference 20, 27 | seriesInfo 36, 48, 61 | |||
dl 11, 17, 20, 26, 28, 37, 40, 57, 69, 71 | sortingcode 46, 63 | |||
dt 28-29 | sourcecode 21, 28, 35, 39, 60, 63, 72, 74 | |||
em 12, 21, 24, 26, 29-30, 37, 39, 46, 63-66, 69, 72, 74, 81 | spanx 13, 69, 82, 84-85 | |||
email 12, 31 | street 46, 65 | |||
eref 12, 21, 24, 26, 29-31, 37, 39, 63-66, 69, 72, 74, 79, 81, | strong 13, 22, 25, 28, 31-32, 39, 41, 48, 66-69, 72, 75, 77, | |||
84 | 84 | |||
extaddr 32, 44 | sub 13, 22, 25, 28, 31-32, 39, 41, 48, 66-67, 69, 72, 75, 77, | |||
facsimile 12, 79 | 85 | |||
figure 17, 21, 26, 32, 37, 57, 69, 71 | sup 13, 22, 25, 28, 31-32, 39, 41, 48, 66-67, 69, 72, 75, 77, | |||
format 46, 79 | 85 | |||
front 34, 46, 53 | ||||
iref 12, 17, 21, 26, 29-30, 33, 35, 37, 39, 57, 63-66, 69, 72, | ||||
74, 79, 81, 84 | ||||
keyword 35-36 | ||||
li 36, 41, 75 | ||||
link 38, 53 | ||||
list 66, 80 | ||||
middle 39, 53 | ||||
name 33, 39-40, 48, 56, 67, 82 | ||||
note 35, 40 | ||||
ol 11, 17, 21, 26, 37, 40-41, 57, 69, 71 | ||||
organization 18, 43 | ||||
phone 12, 43 | ||||
pobox 44 | ||||
postal 12, 44 | ||||
postalLine 45 | ||||
postamble 33, 80, 82 | ||||
preamble 33, 81-82 | ||||
refcontent 45-46 | ||||
reference 46-48 | ||||
referencegroup 47-48 | ||||
references 20, 47-48 | ||||
region 44, 49 | ||||
relref 12, 21, 24, 26, 29-30, 37, 39, 49, 64-66, 69, 72, 74, | ||||
81 | ||||
rfc 53 | ||||
section 20, 22, 39, 56-57 | ||||
seriesInfo 34, 46, 58 | ||||
sortingcode 44, 60 | ||||
sourcecode 21, 26, 33, 37, 57, 61, 69, 71 | ||||
spanx 12, 66, 79, 81-82 | ||||
street 44, 63 | ||||
strong 12, 21, 24, 26, 29-30, 37, 39, 46, 63-66, 69, 72, 74, | ||||
81 | ||||
sub 12, 21, 24, 26, 29-30, 37, 39, 46, 64, 66, 69, 72, 74, 81 | ||||
sup 12, 21, 24, 27, 29-30, 37, 39, 46, 64-66, 69, 72, 75, 81 | ||||
svg 15 | svg 15 | |||
t 11, 17, 21, 26, 37, 40, 57, 65, 69, 71, 80 | t 12, 18, 21, 28, 39, 42, 60, 68, 72, 74, 83 | |||
table 18, 21, 57, 67 | table 18, 21, 60, 70 | |||
tbody 68 | tbody 70-71 | |||
td 68, 74 | td 71, 76 | |||
texttable 57, 82 | texttable 60, 85 | |||
tfoot 68, 70 | tfoot 70, 73 | |||
th 71, 74 | th 74, 77 | |||
thead 68, 73 | thead 70, 76 | |||
title 34, 73 | title 36, 76 | |||
tr 68, 70, 73 | tr 71, 73, 76 | |||
tt 13, 21, 24, 27, 29-30, 37, 39, 46, 64-66, 70, 72, 74, 81 | tt 13, 22, 25, 28, 31-32, 39, 41, 48, 66-69, 72, 75, 77, 85 | |||
ttcol 82, 84 | ttcol 86-87 | |||
ul 11, 18, 21, 26, 37, 40, 57, 69, 71, 75 | ul 12, 18, 21, 28, 39, 42, 60, 72, 74, 78 | |||
uri 12, 76 | uri 12, 78 | |||
vspace 66, 84 | vspace 69, 87 | |||
workgroup 35, 76 | workgroup 36, 79 | |||
xref 13, 21, 24, 27, 29-30, 37, 39, 64-66, 70, 72, 75-76, 79, | xref 13, 22, 25, 28, 31-32, 39, 41, 66-69, 72, 75, 77, 79, 82, | |||
81, 84 | 84-85, 87 | |||
em element 30, 102 | em element 31, 107 | |||
inside annotation 12 | inside annotation 13 | |||
inside blockquote 21 | inside blockquote 22 | |||
inside cref 24 | inside cref 25 | |||
inside dd 26 | inside dd 28 | |||
inside dt 29 | inside dt 31 | |||
inside li 37 | inside li 39 | |||
inside name 39 | inside name 41 | |||
inside preamble 81 | inside preamble 84 | |||
inside refcontent 46 | inside refcontent 48 | |||
inside strong 63 | inside strong 66 | |||
inside sub 64 | inside sub 67 | |||
inside sup 65 | inside sup 68 | |||
inside t 66 | inside t 69 | |||
inside td 69 | inside td 72 | |||
inside th 72 | inside th 74 | |||
inside tt 74 | inside tt 77 | |||
email element 31, 102 | email element 32, 107 | |||
ascii attribute 31 | ascii attribute 32 | |||
inside address 12 | inside address 12 | |||
empty attribute | empty attribute | |||
in ul element 75 | in ul element 78 | |||
eref element 31, 102 | eref element 33, 107 | |||
inside annotation 12 | brackets attribute 34 | |||
inside blockquote 21 | inside annotation 13 | |||
inside c 79 | inside blockquote 22 | |||
inside cref 24 | inside c 82 | |||
inside dd 26 | inside cref 25 | |||
inside dt 29 | inside dd 28 | |||
inside em 30 | inside dt 31 | |||
inside li 37 | inside em 32 | |||
inside name 39 | inside li 39 | |||
inside postamble 81 | inside name 41 | |||
inside preamble 81 | inside postamble 84 | |||
inside strong 63 | inside preamble 84 | |||
inside sub 64 | inside strong 66 | |||
inside sup 65 | inside sub 67 | |||
inside t 66 | inside sup 68 | |||
inside td 69 | inside t 69 | |||
inside th 72 | inside td 72 | |||
inside tt 74 | inside th 75 | |||
inside ttcol 84 | inside tt 77 | |||
target attribute 32 | inside ttcol 87 | |||
extaddr element 32, 102 | target attribute 34 | |||
ascii attribute 32 | extaddr element 34, 107 | |||
inside postal 44 | ascii attribute 34 | |||
inside postal 46 | ||||
F | F | |||
facsimile element 79, 102 | facsimile element 82, 107 | |||
inside address 12 | inside address 12 | |||
figure element 32, 102 | figure element 34, 107 | |||
align attribute 33 | align attribute 35 | |||
alt attribute 33 | alt attribute 35 | |||
anchor attribute 33 | anchor attribute 35 | |||
height attribute 33 | height attribute 35 | |||
inside aside 17 | inside aside 18 | |||
inside blockquote 21 | inside blockquote 21 | |||
inside dd 26 | inside dd 27 | |||
inside li 37 | inside li 38 | |||
inside section 57 | inside section 59 | |||
inside td 69 | inside td 72 | |||
inside th 71 | inside th 74 | |||
src attribute 34 | src attribute 36 | |||
suppress-title attribute 34 | suppress-title attribute 36 | |||
title attribute 34 | title attribute 36 | |||
width attribute 34 | width attribute 36 | |||
format attribute | format attribute | |||
in xref element 77 | in xref element 79 | |||
format element 79, 102 | format element 82, 107 | |||
inside reference 46 | inside reference 48 | |||
octets attribute 79 | octets attribute 83 | |||
target attribute 80 | target attribute 83 | |||
type attribute 80 | type attribute 83 | |||
front element 34, 102 | front element 36, 107 | |||
inside reference 46 | inside reference 48 | |||
inside rfc 53 | inside rfc 55 | |||
fullname attribute | fullname attribute | |||
in author element 19 | in author element 19 | |||
in contact element 24 | ||||
G | G | |||
group attribute | group attribute | |||
in ol element 41 | in ol element 43 | |||
H | H | |||
hangIndent attribute | hangIndent attribute | |||
in list element 80 | in list element 83 | |||
hangText attribute | hangText attribute | |||
in t element 66 | in t element 69 | |||
height attribute | height attribute | |||
in artwork element 16 | in artwork element 16 | |||
in figure element 33 | in figure element 35 | |||
href attribute | href attribute | |||
in link element 38 | in link element 40 | |||
I | I | |||
indent attribute | indent attribute | |||
in dl element 28 | in dl element 30 | |||
indexInclude attribute | indexInclude attribute | |||
in rfc element 54 | in rfc element 56 | |||
initials attribute | initials attribute | |||
in author element 19 | in author element 20 | |||
in contact element 24 | ||||
ipr attribute | ipr attribute | |||
"*2026" 95 | "*2026" 101 | |||
"*3667" 95 | "*3667" 100 | |||
"*3978" 95 | "*3978" 100 | |||
"*trust200811" 95 | "*trust200811" 100 | |||
"*trust200902" 93 | "*trust200902" 98 | |||
"noDerivativesTrust200902" 94 | "noDerivativesTrust200902" 99 | |||
"noModificationTrust200902" 94 | "noModificationTrust200902" 99 | |||
"pre5378Trust200902" 94 | "pre5378Trust200902" 100 | |||
"trust200902" 94 | "trust200902" 99 | |||
in rfc element 54 | in rfc element 57 | |||
iprExtract attribute | iprExtract attribute | |||
in rfc element 54 | in rfc element 57 | |||
iref element 35, 102 | iref element 37, 107 | |||
inside annotation 12 | inside annotation 13 | |||
inside aside 17 | inside aside 18 | |||
inside blockquote 21 | inside blockquote 22 | |||
inside c 79 | inside c 82 | |||
inside dd 26 | inside dd 28 | |||
inside dt 29 | inside dt 31 | |||
inside em 30 | inside em 32 | |||
inside figure 33 | inside figure 34 | |||
inside li 37 | inside li 39 | |||
inside name 39 | inside name 41 | |||
inside postamble 81 | inside postamble 84 | |||
inside preamble 81 | inside preamble 84 | |||
inside section 57 | inside section 60 | |||
inside strong 63 | inside strong 66 | |||
inside sub 64 | inside sub 67 | |||
inside sup 65 | inside sup 68 | |||
inside t 66 | inside t 69 | |||
inside td 69 | inside td 72 | |||
inside th 72 | inside th 75 | |||
inside tt 74 | inside tt 77 | |||
inside ttcol 84 | inside ttcol 87 | |||
item attribute 35 | item attribute 37 | |||
primary attribute 36 | primary attribute 37 | |||
subitem attribute 36 | subitem attribute 38 | |||
item attribute | item attribute | |||
in iref element 35 | in iref element 37 | |||
K | K | |||
keepWithNext attribute | keepWithNext attribute | |||
in t element 66 | in t element 69 | |||
keepWithPrevious attribute | keepWithPrevious attribute | |||
in t element 67 | in t element 70 | |||
keyword element 36, 102 | keyword element 38, 107 | |||
inside front 35 | inside front 37 | |||
L | L | |||
li element 36, 102 | li element 38, 107 | |||
anchor attribute 38 | anchor attribute 39 |