idnits 2.17.1 draft-reschke-xml2rfc-02.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- -- The document has an IETF Trust Provisions (28 Dec 2009) Section 6.c(i) Publication Limitation clause. -- The document has an IETF Trust Provisions (28 Dec 2009) Section 6.c(ii) Publication Limitation clause. If this document is intended for submission to the IESG for publication, this constitutes an error. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** There are 9 instances of too long lines in the document, the longest one being 2 characters in excess of 72. -- The draft header indicates that this document obsoletes RFC2629, but the abstract doesn't seem to mention this, which it should. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document seems to contain a disclaimer for pre-RFC5378 work, but was first submitted on or after 10 November 2008. The disclaimer is usually necessary only for documents that revise or obsolete older RFCs, and that take significant amounts of text from those RFCs. If you can contact all authors of the source material and they are willing to grant the BCP78 rights to the IETF Trust, you can and should remove the disclaimer. Otherwise, the disclaimer is needed and you can ignore this comment. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (November 26, 2013) is 3804 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Possible downref: Non-RFC (?) normative reference: ref. 'XML' -- Obsolete informational reference (is this intentional?): RFC 2629 (Obsoleted by RFC 7749) -- Obsolete informational reference (is this intentional?): RFC 5741 (Obsoleted by RFC 7841) Summary: 1 error (**), 0 flaws (~~), 2 warnings (==), 7 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group J. Reschke 3 Internet-Draft greenbytes 4 Obsoletes: 2629 (if approved) November 26, 2013 5 Intended status: Standards Track 6 Expires: May 30, 2014 8 The 'XML2RFC' version 2 Vocabulary 9 draft-reschke-xml2rfc-02 11 Abstract 13 This document defines the 'XML2RFC' version 2 vocabulary; an XML- 14 based language used for writing Internet-Drafts and RFCs. This 15 vocabulary is used for current processing of XML into RFCs. A future 16 version of this vocabulary will be used as the canonical version of 17 RFCs. 19 Editorial Note (To be removed by RFC Editor) 21 Discussion of this draft takes place on the XML2RFC mailing list 22 (xml2rfc@ietf.org), which has its home page at 23 . 25 Status of This Memo 27 This Internet-Draft is submitted in full conformance with the 28 provisions of BCP 78 and BCP 79. 30 Internet-Drafts are working documents of the Internet Engineering 31 Task Force (IETF). Note that other groups may also distribute 32 working documents as Internet-Drafts. The list of current Internet- 33 Drafts is at http://datatracker.ietf.org/drafts/current/. 35 Internet-Drafts are draft documents valid for a maximum of six months 36 and may be updated, replaced, or obsoleted by other documents at any 37 time. It is inappropriate to use Internet-Drafts as reference 38 material or to cite them other than as "work in progress." 40 This Internet-Draft will expire on May 30, 2014. 42 Copyright Notice 44 Copyright (c) 2013 IETF Trust and the persons identified as the 45 document authors. All rights reserved. 47 This document is subject to BCP 78 and the IETF Trust's Legal 48 Provisions Relating to IETF Documents 49 (http://trustee.ietf.org/license-info) in effect on the date of 50 publication of this document. Please review these documents 51 carefully, as they describe your rights and restrictions with respect 52 to this document. Code Components extracted from this document must 53 include Simplified BSD License text as described in Section 4.e of 54 the Trust Legal Provisions and are provided without warranty as 55 described in the Simplified BSD License. 57 Table of Contents 59 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 60 1.1. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 4 61 2. Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 62 2.1. . . . . . . . . . . . . . . . . . . . . . . . . 4 63 2.2.
. . . . . . . . . . . . . . . . . . . . . . . . 5 64 2.3. . . . . . . . . . . . . . . . . . . . . . . . 5 65 2.4. . . . . . . . . . . . . . . . . . . . . . . . . . . 6 66 2.5. . . . . . . . . . . . . . . . . . . . . . . . . 7 67 2.6. . . . . . . . . . . . . . . . . . . . . . . . . . 10 68 2.7. . . . . . . . . . . . . . . . . . . . . . . . . . . 11 69 2.8. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 70 2.9. . . . . . . . . . . . . . . . . . . . . . . . . . . 13 71 2.10. . . . . . . . . . . . . . . . . . . . . . . . . . . 13 72 2.11. . . . . . . . . . . . . . . . . . . . . . . . . 13 73 2.12. . . . . . . . . . . . . . . . . . . . . . . . . . . 14 74 2.13. . . . . . . . . . . . . . . . . . . . . . . . . . . 14 75 2.14. . . . . . . . . . . . . . . . . . . . . . . . . . 16 76 2.15. . . . . . . . . . . . . . . . . . . . . . . . . . . 16 77 2.16. . . . . . . . . . . . . . . . . . . . . . . . 17 78 2.17.
. . . . . . . . . . . . . . . . . . . . . . . . . 17 79 2.18. . . . . . . . . . . . . . . . . . . . . . . . . . 19 80 2.19. . . . . . . . . . . . . . . . . . . . . . . . . . 20 81 2.20. . . . . . . . . . . . . . . . . . . . . . . . . . . 21 82 2.21. . . . . . . . . . . . . . . . . . . . . . . . . 22 83 2.22. . . . . . . . . . . . . . . . . . . . . . . . . . . 23 84 2.23. . . . . . . . . . . . . . . . . . . . . . . . . . 24 85 2.24. . . . . . . . . . . . . . . . . . . . . . . . . . . 24 86 2.25. . . . . . . . . . . . . . . . . . . . . . . 25 87 2.26. . . . . . . . . . . . . . . . . . . . . . . . . . 25 88 2.27. . . . . . . . . . . . . . . . . . . . . . . . . . 26 89 2.28. . . . . . . . . . . . . . . . . . . . . . . . 26 90 2.29. . . . . . . . . . . . . . . . . . . . . . . . . 27 91 2.30. . . . . . . . . . . . . . . . . . . . . . . . 28 92 2.31. . . . . . . . . . . . . . . . . . . . . . . . 29 93 2.32. . . . . . . . . . . . . . . . . . . . . . . . . . 30 94 2.33. . . . . . . . . . . . . . . . . . . . . . . . . . . 30 95 2.34.
. . . . . . . . . . . . . . . . . . . . . . . . 34 96 2.35. . . . . . . . . . . . . . . . . . . . . . . . 36 97 2.36. . . . . . . . . . . . . . . . . . . . . . . . . . 37 98 2.37. . . . . . . . . . . . . . . . . . . . . . . . . . 38 99 2.38. . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 100 2.39. . . . . . . . . . . . . . . . . . . . . . . . 39 101 2.40. . . . . . . . . . . . . . . . . . . . . . . . . . 41 102 2.41. <ttcol> . . . . . . . . . . . . . . . . . . . . . . . . . 42 103 2.42. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . . 43 104 2.43. <vspace> . . . . . . . . . . . . . . . . . . . . . . . . . 43 105 2.44. <workgroup> . . . . . . . . . . . . . . . . . . . . . . . 44 106 2.45. <xref> . . . . . . . . . . . . . . . . . . . . . . . . . . 44 107 3. Special Unicode Code Points . . . . . . . . . . . . . . . . . 45 108 4. Internationalization Considerations . . . . . . . . . . . . . 46 109 5. Security Considerations . . . . . . . . . . . . . . . . . . . 46 110 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 46 111 7. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 46 112 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 46 113 8.1. Normative References . . . . . . . . . . . . . . . . . . . 46 114 8.2. Informative References . . . . . . . . . . . . . . . . . . 46 115 Appendix A. Front Page Generation . . . . . . . . . . . . . . . . 47 116 A.1. The /rfc/@category Attribute . . . . . . . . . . . . . . . 48 117 A.2. The /rfc/@ipr Attribute . . . . . . . . . . . . . . . . . 48 118 A.2.1. Current Values: '*trust200902' . . . . . . . . . . . . 48 119 A.2.2. Historic Values . . . . . . . . . . . . . . . . . . . 50 120 Appendix B. Changes from RFC 2629 ('v1') . . . . . . . . . . . . 51 121 B.1. Removed Elements . . . . . . . . . . . . . . . . . . . . . 51 122 B.2. Changed Defaults . . . . . . . . . . . . . . . . . . . . . 51 123 B.3. Changed Elements . . . . . . . . . . . . . . . . . . . . . 51 124 B.4. New Elements . . . . . . . . . . . . . . . . . . . . . . . 52 125 Appendix C. Relax NG Schema . . . . . . . . . . . . . . . . . . . 52 126 Appendix D. Proposed Future Changes for 'v3' . . . . . . . . . . 57 127 D.1. Contact Information . . . . . . . . . . . . . . . . . . . 57 128 D.2. Figures . . . . . . . . . . . . . . . . . . . . . . . . . 58 129 D.3. Linking . . . . . . . . . . . . . . . . . . . . . . . . . 58 130 D.4. Lists . . . . . . . . . . . . . . . . . . . . . . . . . . 58 131 D.5. References . . . . . . . . . . . . . . . . . . . . . . . . 59 132 D.6. Archival Considerations . . . . . . . . . . . . . . . . . 59 133 D.7. Document Metadata . . . . . . . . . . . . . . . . . . . . 59 134 D.8. Misc. . . . . . . . . . . . . . . . . . . . . . . . . . . 59 135 Appendix E. Comparison Of Vocabularies (to be removed before 136 publication as RFC) . . . . . . . . . . . . . . . . . 60 137 E.1. RFC 2629 ('v1') RelaxNG Grammar . . . . . . . . . . . . . 60 138 E.2. Current ('v2') RelaxNG Grammar . . . . . . . . . . . . . . 63 139 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 141 1. Introduction 143 This document describes version 2 ('v2') of the 'XML2RFC' vocabulary; 144 an XML (Extensible Markup Language) language ([XML]) used for writing 145 RFCs ([RFCSTYLE]) and Internet-Drafts ([IDGUIDE]). 147 It obsoletes the original version ("v1") [RFC2629], which contained 148 the original language definition, and which was subsequently extended 149 ("v2"). Furthermore, it discusses potential extensions in a future 150 revision ("v3"). 152 Note that not the vocabulary contains certain constructs that might 153 not be used when generating the final text; however, they can provide 154 useful data for other uses (such index generation, populating a 155 keyword database, or syntax checks). 157 1.1. Syntax Notation 159 The XML vocabulary here is defined in prose, based on the Relax NG 160 schema ([RNC]) contained in Appendix C (specified in Relax NG Compact 161 Notation, "RNC"). 163 Each element description also contains the RNC fragment for that 164 specific element in a slightly simplified form (for instance, leaving 165 out defaults). This is included as alternative for readers who 166 prefer formal syntax over prose. [[anchor2: This information is 167 redundant with the prose *and* repeated in the index; I'd like to 168 hear feedback whether it's more useful than distracting.]] 170 Note that the schema can be used for automated validity checks, but 171 certain constraints are only described in prose (example: the 172 conditionally required presence of the "abbrev" attribute). 174 2. Elements 176 [[anchor3: In the section below, some elements/attributes do not have 177 a prose description yet. This is because this is work-in-progress; 178 feedback with accurate descriptions is appreciated.]] 180 2.1. <abstract> 182 Contains the abstract of the document. The abstract ought to be 183 self-contained and thus should not contain references or unexpanded 184 abbreviations. See Section 4.3 of [RFCSTYLE] for more information. 186 This element appears as child element of: <front> (Section 2.19). 188 Content model: 190 One or more <t> elements (Section 2.38) 192 2.1.1. Grammar 194 abstract = 195 element abstract { 196 t+ 197 } 199 2.2. <address> 201 Provides address information for the author. 203 This element appears as child element of: <author> (Section 2.6). 205 Content model: 207 1. One optional <postal> element (Section 2.27) 209 2. One optional <phone> element (Section 2.26) 211 3. One optional <facsimile> element (Section 2.16) 213 4. One optional <email> element (Section 2.14) 215 5. One optional <uri> element (Section 2.42) 217 2.2.1. Grammar 219 address = 220 element address { 221 postal?, 222 phone?, 223 facsimile?, 224 email?, 225 uri? 226 } 228 2.3. <annotation> 230 Provides additional prose augmenting a bibliographical reference. 232 For instance: 234 <annotation> 235 Latest version available at <eref 236 target='http://www.w3.org/TR/xml'/>. 237 </annotation> 239 ...will generate the text used in the reference for [XML]. 241 This element appears as child element of: <reference> (Section 2.30). 243 Content model: 245 In any order: 247 o Text 249 o <xref> elements (Section 2.45) 251 o <eref> elements (Section 2.15) 253 o <iref> elements (Section 2.20) 255 o <cref> elements (Section 2.12) 257 o <spanx> elements (Section 2.36) 259 2.3.1. Grammar 261 annotation = 262 element annotation { 263 (TEXT 264 | xref 265 | eref 266 | iref 267 | cref 268 | spanx)* 269 } 271 2.4. <area> 273 Provides information about the IETF area this document applies to 274 (currently not used when generating documents). 276 This element appears as child element of: <front> (Section 2.19). 278 Content model: only text content. 280 2.4.1. Grammar 282 area = 283 element area { 284 CTEXT 285 } 287 2.5. <artwork> 289 This element allows the inclusion of "artwork" into the document. 291 <artwork> is the only element in the vocabulary that provides full 292 control of horizontal whitespace and line breaks, and thus is used 293 for a variety of things, such as: 295 o diagrams ("line art"), 297 o source code, 299 o formal languages (such as ABNF or the RNC notation used in this 300 document), 302 o complex tables, or 304 o protocol unit diagrams. 306 Alternatively, the "src" attribute allows referencing an external 307 graphics file, such as a bitmap or a vector drawing. In this case, 308 the textual content ought to contain either a "line art" variant of 309 the graphics, or otherwise prose that describes the included image in 310 sufficient detail. Note that RFCs occasionally are published with 311 enhanced diagrams; a recent example is [RFC5598]. 313 This element appears as child element of: <figure> (Section 2.17). 315 Content model: 317 Text 319 2.5.1. Attributes 321 2.5.1.1. align 323 (optional) 325 Controls whether the artwork appears left (default), centered, or 326 right. 328 Allowed values: 330 o "left" (default) 332 o "center" 334 o "right" 336 2.5.1.2. alt 338 (optional) 340 Alternative text description of the artwork (not just the caption). 342 2.5.1.3. height 344 (optional) 346 The suggested height of the graphics included using the "src" 347 attribute. 349 This attribute is format-dependent and ought to be avoided. 351 When generating HTML output, current implementations copy the 352 attribute "as is". For other output formats it is usually ignored. 354 2.5.1.4. name 356 (optional) 358 A filename suitable for the contents (such as for extraction to a 359 local file). 361 This attribute generally isn't used for document generation, but it 362 can be helpful for other kinds of tools (such as automated syntax 363 checkers which work by extracting the source code). 365 2.5.1.5. src 367 (optional) 369 The URI of a graphics file. 371 Note that this can be a "data" URI ([RFC2397]) as well, in which case 372 the graphics file essentially is in-lined. 374 2.5.1.6. type 376 (optional) 378 Specifies the type of the artwork. 380 The value either is a well-known keyword (such as "abnf"), or an 381 Internet Media Type (see [RFC2046]). 383 How it is used depends on context and application. For instance, a 384 formatter can attempt to syntax-highlight code in certain known 385 languages. 387 2.5.1.7. width 389 (optional) 391 The suggested width of the graphics included using the "src" 392 attribute. 394 This attribute is format-dependent and ought to be avoided. 396 When generating HTML output, current implementations copy the 397 attribute "as is". For other output formats it is usually ignored. 399 2.5.1.8. xml:space 401 (optional) 403 Determines whitespace handling. 405 "preserve" is both the default value and the only meaningful setting 406 anyway (because that's what the <artwork> element is for). 408 See also Section 2.10 of [XML]. 410 Allowed values: 412 o "default" 414 o "preserve" (default) 416 2.5.2. Grammar 417 artwork = 418 element artwork { 419 attribute xml:space ( "default" | "preserve" )?, 420 attribute name { ATEXT }?, 421 attribute type { ATEXT }?, 422 attribute src { URI }?, 423 attribute align ( "left" | "center" | "right" )?, 424 attribute alt { ATEXT }?, 425 attribute width { ATEXT }?, 426 attribute height { ATEXT }?, 427 TEXT* 428 } 430 2.6. <author> 432 Provides information about a document author. 434 The <author> elements contained within the document's <front> element 435 are used to fill the boilerplate, and also to generate the "Author's 436 Address" section (see Section 4.9 of [RFCSTYLE]). 438 Note that an "author" can also be just an organization (by not 439 specifying any of the name attributes, but adding the <organization> 440 child element). 442 Furthermore, the "role" attribute can be used to mark an author as 443 "editor". This is reflected both on the front page and in 444 bibliographical references. Note that this specification does not 445 define a precise meaning for the term "editor". 447 See Section "Authors vs. Contributors" of [RFCPOLICY] for more 448 information. 450 This element appears as child element of: <front> (Section 2.19). 452 Content model: 454 1. One optional <organization> element (Section 2.25) 456 2. One optional <address> element (Section 2.2) 458 2.6.1. Attributes 460 2.6.1.1. fullname 462 (optional) 464 The full name (used in the automatically generated "Author's Address" 465 section). 467 2.6.1.2. initials 469 (optional) 471 Author initials (used on the front page and in references). 473 Initials should be provided as a whitespace separated list of pairs 474 of a letter and a dot. 476 2.6.1.3. role 478 (optional) 480 Specifies the role the author had in creating the document. 482 Allowed values: 484 o "editor" 486 2.6.1.4. surname 488 (optional) 490 The author's surname. 492 2.6.2. Grammar 494 author = 495 element author { 496 attribute initials { ATEXT }?, 497 attribute surname { ATEXT }?, 498 attribute fullname { ATEXT }?, 499 attribute role { "editor" }?, 500 organization?, 501 address? 502 } 504 2.7. <back> 506 Contains the "back" part of the document: the references and 507 appendices. 509 This element appears as child element of: <rfc> (Section 2.33). 511 Content model: 513 1. Optional <references> elements (Section 2.31) 515 2. Optional <section> elements (Section 2.34) 517 2.7.1. Grammar 519 back = 520 element back { 521 references*, 522 section* 523 } 525 2.8. <c> 527 Provides the content of a cell in a table. 529 This element appears as child element of: <texttable> (Section 2.39). 531 Content model: 533 In any order: 535 o Text 537 o <xref> elements (Section 2.45) 539 o <eref> elements (Section 2.15) 541 o <iref> elements (Section 2.20) 543 o <cref> elements (Section 2.12) 545 o <spanx> elements (Section 2.36) 547 2.8.1. Grammar 549 c = 550 element c { 551 (TEXT 552 | xref 553 | eref 554 | iref 555 | cref 556 | spanx)* 557 } 559 2.9. <city> 561 Gives the city name in a postal address. 563 This element appears as child element of: <postal> (Section 2.27). 565 Content model: only text content. 567 2.9.1. Grammar 569 city = 570 element city { 571 CTEXT 572 } 574 2.10. <code> 576 Gives the postal region code. 578 This element appears as child element of: <postal> (Section 2.27). 580 Content model: only text content. 582 2.10.1. Grammar 584 code = 585 element code { 586 CTEXT 587 } 589 2.11. <country> 591 Gives the country in a postal address. 593 This element appears as child element of: <postal> (Section 2.27). 595 Content model: only text content. 597 2.11.1. Grammar 599 country = 600 element country { 601 CTEXT 602 } 604 2.12. <cref> 606 Represents a comment. 608 Comments can be used in a document while it is work-in-progress. 609 They usually appear either visually highlighted, at the end of the 610 document (depending on file format and settings of the formatter), or 611 not at all (when generating an RFC). 613 This element appears as child element of: <annotation> (Section 2.3), 614 <c> (Section 2.8), <postamble> (Section 2.28), <preamble> 615 (Section 2.29), and <t> (Section 2.38). 617 Content model: only text content. 619 2.12.1. Attributes 621 2.12.1.1. anchor 623 (optional) 625 [[element.cref.attribute.anchor.missing: attribute description 626 missing]] 628 2.12.1.2. source 630 (optional) 632 Holds the "source" of a comment, such as the name or the initials of 633 the person who made the comment. 635 2.12.2. Grammar 637 cref = 638 element cref { 639 attribute anchor { xsd:ID }?, 640 attribute source { ATEXT }?, 641 CTEXT 642 } 644 2.13. <date> 646 Provides information about the publication date. 648 Note that this element is used both for the boilerplate of the 649 document being produced, and also inside bibliographic references. 651 In the first case, it defines the publication date, which, when 652 producing Internet-Drafts, will be used for computing the expiration 653 date (see Section 8 of [IDGUIDE]). When "year", "month" or "day" are 654 left out, the processor will attempt to use the current system date 655 if the attributes that are specified do match the system date. Note 656 that month names need to match the full (English) month name 657 ("January", "February", "March", "April", "May, "June", "July", 658 "August", "September", "October", "November", or "December") in order 659 for expiration calculations to work. 661 In the second case, the date information will be embedded as-is into 662 the reference text. Therefore, also vague dates ("ca. 2000"), date 663 ranges, and so on, are allowed. 665 This element appears as child element of: <front> (Section 2.19). 667 Content model: this element does not have any contents. 669 2.13.1. Attributes 671 2.13.1.1. day 673 (optional) 675 Day of publication. 677 2.13.1.2. month 679 (optional) 681 Month of publication. 683 2.13.1.3. year 685 (optional) 687 Year of publication. 689 2.13.2. Grammar 691 date = 692 element date { 693 attribute day { DAY }?, 694 attribute month { MONTH }?, 695 attribute year { YEAR }?, 696 empty 697 } 699 2.14. <email> 701 Provides an email address. 703 The value is expected to be the scheme-specific part of a "mailto" 704 URI (so does not include the prefix "mailto:"). See Section 2 of 705 [RFC6068] for details. 707 This element appears as child element of: <address> (Section 2.2). 709 Content model: only text content. 711 2.14.1. Grammar 713 email = 714 element email { 715 CTEXT 716 } 718 2.15. <eref> 720 Represents an "external" link (as specified in the "target" 721 attribute). 723 If the element has text content, that content will be used. 724 Otherwise, the value of the target attribute will be inserted in 725 angle brackets ([RFC3986], Appendix C). 727 This element appears as child element of: <annotation> (Section 2.3), 728 <c> (Section 2.8), <postamble> (Section 2.28), <preamble> 729 (Section 2.29), and <t> (Section 2.38). 731 Content model: only text content. 733 2.15.1. Attributes 735 2.15.1.1. target 737 (mandatory) 739 URI of the link target (see Section 3 of [RFC3986]). 741 2.15.2. Grammar 742 eref = 743 element eref { 744 attribute target { URI }, 745 CTEXT 746 } 748 2.16. <facsimile> 750 Represents the phone number of a fax machine. 752 The value is expected to be the scheme-specific part of a "tel" URI 753 (so does not include the prefix "tel:"), using the "global numbers" 754 syntax. See Section 3 of [RFC3966] for details. 756 This element appears as child element of: <address> (Section 2.2). 758 Content model: only text content. 760 2.16.1. Grammar 762 facsimile = 763 element facsimile { 764 CTEXT 765 } 767 2.17. <figure> 769 [[element.figure.missing: element description missing]] 771 This element appears as child element of: <section> (Section 2.34), 772 and <t> (Section 2.38). 774 Content model: 776 1. Optional <iref> elements (Section 2.20) 778 2. One optional <preamble> element (Section 2.29) 780 3. One <artwork> element (Section 2.5) 782 4. One optional <postamble> element (Section 2.28) 784 2.17.1. Attributes 786 2.17.1.1. align 788 (optional) 790 [[element.figure.attribute.align.missing: attribute description 791 missing]] 793 Allowed values: 795 o "left" (default) 797 o "center" 799 o "right" 801 2.17.1.2. alt 803 (optional) 805 [[element.figure.attribute.alt.missing: attribute description 806 missing]] 808 2.17.1.3. anchor 810 (optional) 812 [[element.figure.attribute.anchor.missing: attribute description 813 missing]] 815 2.17.1.4. height 817 (optional) 819 [[element.figure.attribute.height.missing: attribute description 820 missing]] 822 2.17.1.5. src 824 (optional) 826 [[element.figure.attribute.src.missing: attribute description 827 missing]] 829 2.17.1.6. suppress-title 831 (optional) 833 Figures that have an "anchor" attribute will automatically get an 834 autogenerated title (such as "Figure 1"). Setting this attribute to 835 "false" will prevent this. 837 Allowed values: 839 o "true" 841 o "false" (default) 843 2.17.1.7. title 845 (optional) 847 [[element.figure.attribute.title.missing: attribute description 848 missing]] 850 2.17.1.8. width 852 (optional) 854 [[element.figure.attribute.width.missing: attribute description 855 missing]] 857 2.17.2. Grammar 859 figure = 860 element figure { 861 attribute anchor { xsd:ID }?, 862 attribute title { ATEXT }?, 863 attribute suppress-title ( "true" | "false" )?, 864 attribute src { URI }?, 865 attribute align ( "left" | "center" | "right" )?, 866 attribute alt { ATEXT }?, 867 attribute width { ATEXT }?, 868 attribute height { ATEXT }?, 869 iref*, 870 preamble?, 871 artwork, 872 postamble? 873 } 875 2.18. <format> 877 Provides a link to an additional format variant for a reference. 879 Note that these additional links are neither used in published RFCs, 880 nor supported by all tools. If the goal is to provide a single URI 881 for a reference, the "target" attribute on <reference> can be used 882 instead. 884 This element appears as child element of: <reference> (Section 2.30). 886 Content model: this element does not have any contents. 888 2.18.1. Attributes 890 2.18.1.1. octets 892 (optional) 894 Octet length of linked-to document. 896 2.18.1.2. target 898 (optional) 900 URI of document. 902 [[anchor11: Why is this optional?]] 904 2.18.1.3. type 906 (mandatory) 908 The type of the linked-to document, such as "TXT", "HTML", or "PDF". 910 2.18.2. Grammar 912 format = 913 element format { 914 attribute target { URI }?, 915 attribute type { ATEXT }, 916 attribute octets { NUMBER }?, 917 empty 918 } 920 2.19. <front> 922 Represent the "front matter": metadata (such as author information), 923 abstract, and additional notes. 925 This element appears as child element of: <reference> (Section 2.30), 926 and <rfc> (Section 2.33). 928 Content model: 930 1. One <title> element (Section 2.40) 932 2. One or more <author> elements (Section 2.6) 934 3. One <date> element (Section 2.13) 935 4. Optional <area> elements (Section 2.4) 937 5. Optional <workgroup> elements (Section 2.44) 939 6. Optional <keyword> elements (Section 2.21) 941 7. One optional <abstract> element (Section 2.1) 943 8. Optional <note> elements (Section 2.24) 945 2.19.1. Grammar 947 front = 948 element front { 949 title, 950 author+, 951 date, 952 area*, 953 workgroup*, 954 keyword*, 955 abstract?, 956 note* 957 } 959 2.20. <iref> 961 Provides terms for the document's index. 963 Index entries can be either single items (when just the "item" 964 attribute is given) or nested items (by specifying "subitem" as 965 well). 967 For instance: 969 <iref item="Grammar" subitem="item"/> 971 will produce an index entry for "Grammar, item". 973 This element appears as child element of: <annotation> (Section 2.3), 974 <c> (Section 2.8), <figure> (Section 2.17), <postamble> 975 (Section 2.28), <preamble> (Section 2.29), <section> (Section 2.34), 976 and <t> (Section 2.38). 978 Content model: this element does not have any contents. 980 2.20.1. Attributes 982 2.20.1.1. item 984 (mandatory) 986 The item to include. 988 2.20.1.2. primary 990 (optional) 992 Setting this to "true" declares the occurrence as "primary", which 993 might cause it to be highlighted in the index. 995 Allowed values: 997 o "true" 999 o "false" (default) 1001 2.20.1.3. subitem 1003 (optional) 1005 The subitem to include. 1007 2.20.2. Grammar 1009 iref = 1010 element iref { 1011 attribute item { ATEXT }, 1012 attribute subitem { ATEXT }?, 1013 attribute primary ( "true" | "false" )?, 1014 empty 1015 } 1017 2.21. <keyword> 1019 Specifies a keyword applicable to the document. 1021 Note that each element should only contain a single keyword; for 1022 multiple keywords, the element can simply be repeated. 1024 Keywords are used both in the RFC Index and in the metadata of 1025 generated document formats. 1027 This element appears as child element of: <front> (Section 2.19). 1029 Content model: only text content. 1031 2.21.1. Grammar 1033 keyword = 1034 element keyword { 1035 CTEXT 1036 } 1038 2.22. <list> 1040 Delineates a text list. 1042 This element appears as child element of: <t> (Section 2.38). 1044 Content model: 1046 One or more <t> elements (Section 2.38) 1048 2.22.1. Attributes 1050 2.22.1.1. counter 1052 (optional) 1054 [[element.list.attribute.counter.missing: attribute description 1055 missing]] 1057 2.22.1.2. hangIndent 1059 (optional) 1061 [[element.list.attribute.hangIndent.missing: attribute description 1062 missing]] 1064 2.22.1.3. style 1066 (optional) 1068 [[element.list.attribute.style.missing: attribute description 1069 missing]] 1071 2.22.2. Grammar 1072 \list = 1073 element \list { 1074 attribute style { ATEXT }?, 1075 attribute hangIndent { NUMBER }?, 1076 attribute counter { ATEXT }?, 1077 t+ 1078 } 1080 2.23. <middle> 1082 Represents the main content of the document. 1084 This element appears as child element of: <rfc> (Section 2.33). 1086 Content model: 1088 One or more <section> elements (Section 2.34) 1090 2.23.1. Grammar 1092 middle = 1093 element middle { 1094 section+ 1095 } 1097 2.24. <note> 1099 Creates an unnumbered section that appears after the abstract. 1101 It is usually used for additional information to reviewers (working 1102 group information, mailing list, ...), or for additional publication 1103 information such as "IESG Notes". 1105 This element appears as child element of: <front> (Section 2.19). 1107 Content model: 1109 One or more <t> elements (Section 2.38) 1111 2.24.1. Attributes 1113 2.24.1.1. title 1115 (mandatory) 1117 The title of the note. 1119 2.24.2. Grammar 1121 note = 1122 element note { 1123 attribute title { ATEXT }, 1124 t+ 1125 } 1127 2.25. <organization> 1129 Specifies the affiliation of an author. 1131 This information appears in both the "Author's Address" section and 1132 on the front page ([RFCSTYLE], Section 4.1.2). If the value is long, 1133 an abbreviated variant can be specified in the "abbrev" attribute. 1135 This element appears as child element of: <author> (Section 2.6). 1137 Content model: only text content. 1139 2.25.1. Attributes 1141 2.25.1.1. abbrev 1143 (optional) 1145 Abbreviated variant. 1147 2.25.2. Grammar 1149 organization = 1150 element organization { 1151 attribute abbrev { ATEXT }?, 1152 CTEXT 1153 } 1155 2.26. <phone> 1157 Represents a phone number. 1159 The value is expected to be the scheme-specific part of a "tel" URI 1160 (so does not include the prefix "tel:"), using the "global numbers" 1161 syntax. See Section 3 of [RFC3966] for details. 1163 This element appears as child element of: <address> (Section 2.2). 1165 Content model: only text content. 1167 2.26.1. Grammar 1169 phone = 1170 element phone { 1171 CTEXT 1172 } 1174 2.27. <postal> 1176 Contains child elements providing postal information. 1178 This element appears as child element of: <address> (Section 2.2). 1180 Content model: 1182 1. One or more <street> elements (Section 2.37) 1184 2. In any order: 1186 * <city> elements (Section 2.9) 1188 * <region> elements (Section 2.32) 1190 * <code> elements (Section 2.10) 1192 * <country> elements (Section 2.11) 1194 2.27.1. Grammar 1196 postal = 1197 element postal { 1198 street+, 1199 (city 1200 | region 1201 | code 1202 | country)* 1203 } 1205 2.28. <postamble> 1207 Gives text that appears at the bottom of a figure or table. 1209 This element appears as child element of: <figure> (Section 2.17), 1210 and <texttable> (Section 2.39). 1212 Content model: 1214 In any order: 1216 o Text 1218 o <xref> elements (Section 2.45) 1220 o <eref> elements (Section 2.15) 1222 o <iref> elements (Section 2.20) 1224 o <cref> elements (Section 2.12) 1226 o <spanx> elements (Section 2.36) 1228 2.28.1. Grammar 1230 postamble = 1231 element postamble { 1232 (TEXT 1233 | xref 1234 | eref 1235 | iref 1236 | cref 1237 | spanx)* 1238 } 1240 2.29. <preamble> 1242 Gives text that appears at the top of a figure or table. 1244 This element appears as child element of: <figure> (Section 2.17), 1245 and <texttable> (Section 2.39). 1247 Content model: 1249 In any order: 1251 o Text 1253 o <xref> elements (Section 2.45) 1255 o <eref> elements (Section 2.15) 1257 o <iref> elements (Section 2.20) 1259 o <cref> elements (Section 2.12) 1261 o <spanx> elements (Section 2.36) 1263 2.29.1. Grammar 1265 preamble = 1266 element preamble { 1267 (TEXT 1268 | xref 1269 | eref 1270 | iref 1271 | cref 1272 | spanx)* 1273 } 1275 2.30. <reference> 1277 Represents a bibliographical reference. 1279 This element appears as child element of: <references> 1280 (Section 2.31). 1282 Content model: 1284 1. One <front> element (Section 2.19) 1286 2. Optional <seriesInfo> elements (Section 2.35) 1288 3. Optional <format> elements (Section 2.18) 1290 4. Optional <annotation> elements (Section 2.3) 1292 2.30.1. Attributes 1294 2.30.1.1. anchor 1296 (optional) 1298 [[element.reference.attribute.anchor.missing: attribute description 1299 missing]] 1301 2.30.1.2. target 1303 (optional) 1305 Holds the URI for the reference. 1307 Note that depending on the <seriesInfo> element, a URI might not be 1308 needed, nor desirable, as it can be automatically generated (for 1309 instance, for RFCs). 1311 2.30.2. Grammar 1313 reference = 1314 element reference { 1315 attribute anchor { xsd:ID }?, 1316 attribute target { URI }?, 1317 front, 1318 seriesInfo*, 1319 format*, 1320 annotation* 1321 } 1323 2.31. <references> 1325 Contains a set of bibliographical references. 1327 In the early days of the RFC series, there was only one "References" 1328 section per RFC. This convention was later changed to group 1329 references into two sets, "Normative" and "Informative"; see item x 1330 of Section 4.8 of [RFCSTYLE]). This vocabulary supports the split 1331 with the "title" attribute. 1333 This element appears as child element of: <back> (Section 2.7). 1335 Content model: 1337 One or more <reference> elements (Section 2.30) 1339 2.31.1. Attributes 1341 2.31.1.1. title 1343 (optional) 1345 Provides the title for the References section (defaulting to 1346 "References"). 1348 In general, the title should be either "Normative References" or 1349 "Informative References". 1351 2.31.2. Grammar 1353 references = 1354 element references { 1355 attribute title { ATEXT }?, 1356 reference+ 1357 } 1359 2.32. <region> 1361 Provides the region name in a postal address. 1363 This element appears as child element of: <postal> (Section 2.27). 1365 Content model: only text content. 1367 2.32.1. Grammar 1369 region = 1370 element region { 1371 CTEXT 1372 } 1374 2.33. <rfc> 1376 This is the root element of the xml2rfc vocabulary. 1378 Processors distinguish between RFC mode ("number" attribute being 1379 present) and Internet-Draft mode ("docName" attribute being present): 1380 it is invalid to specify both. Setting neither "number" nor 1381 "docName" can be useful for producing other types of document but is 1382 out-of-scope for this specification. 1384 Content model: 1386 1. One <front> element (Section 2.19) 1388 2. One <middle> element (Section 2.23) 1390 3. One optional <back> element (Section 2.7) 1392 2.33.1. Attributes 1394 2.33.1.1. category 1396 (optional) 1398 Document category (see Appendix A.1). 1400 Allowed values: 1402 o "std" 1404 o "bcp" 1405 o "info" 1407 o "exp" 1409 o "historic" 1411 2.33.1.2. consensus 1413 (optional) 1415 Affects the generated boilerplate. 1417 See [RFC5741] for more information. 1419 Allowed values: 1421 o "no" 1423 o "yes" 1425 2.33.1.3. docName 1427 (optional) 1429 For Internet-Drafts, this specifies the draft name (which appears 1430 below the title). 1432 Note that the file extension is not part of the draft, so in general 1433 it should end with the current draft number ("-", plus two digits). 1435 Furthermore, it is good practice to disambiguate current editor 1436 copies from submitted drafts (for instance, by replacing the draft 1437 number with the string "latest"). 1439 See Section 7 of [IDGUIDE] for further information. 1441 2.33.1.4. ipr 1443 (optional) 1445 Represents the Intellectual Property status of the document. See 1446 Appendix A.2 for details. 1448 Allowed values: 1450 o "full2026" 1451 o "noDerivativeWorks2026" 1453 o "none" 1455 o "full3667" 1457 o "noModification3667" 1459 o "noDerivatives3667" 1461 o "full3978" 1463 o "noModification3978" 1465 o "noDerivatives3978" 1467 o "trust200811" 1469 o "noModificationTrust200811" 1471 o "noDerivativesTrust200811" 1473 o "trust200902" 1475 o "noModificationTrust200902" 1477 o "noDerivativesTrust200902" 1479 o "pre5378Trust200902" 1481 2.33.1.5. iprExtract 1483 (optional) 1485 Identifies a Section within the document for which extraction "as-is" 1486 is explicitly allowed (only relevant for historic values of the "ipr" 1487 attribute). 1489 2.33.1.6. number 1491 (optional) 1493 The number of the RFC to be produced. 1495 2.33.1.7. obsoletes 1497 (optional) 1498 A comma-separated list of RFC _numbers_ or Internet-Draft names. 1500 2.33.1.8. seriesNo 1502 (optional) 1504 When producing a document within document series (such as "STD"): the 1505 number within that series. 1507 2.33.1.9. submissionType 1509 (optional) 1511 The document stream. 1513 See Section 2 of [RFC5741] for details. 1515 Allowed values: 1517 o "IETF" (default) 1519 o "IAB" 1521 o "IRTF" 1523 o "independent" 1525 2.33.1.10. updates 1527 (optional) 1529 A comma-separated list of RFC _numbers_ or Internet-Draft names. 1531 2.33.1.11. xml:lang 1533 (optional) 1535 The natural language used in the document (defaults to "en"). 1537 See Section 2.12 of [XML] for more information. 1539 2.33.2. Grammar 1540 rfc = 1541 element rfc { 1542 attribute number { NUMBER }?, 1543 attribute obsoletes { NUMBERS }?, 1544 attribute updates { NUMBERS }?, 1545 attribute category ( "std" | "bcp" | "info" | "exp" | "historic" )?, 1546 attribute consensus ( "no" | "yes" )?, 1547 attribute seriesNo { NUMBER }?, 1548 attribute ipr ( 1549 "full2026" 1550 | "noDerivativeWorks2026" 1551 | "none" 1552 | "full3667" 1553 | "noModification3667" 1554 | "noDerivatives3667" 1555 | "full3978" 1556 | "noModification3978" 1557 | "noDerivatives3978" 1558 | "trust200811" 1559 | "noModificationTrust200811" 1560 | "noDerivativesTrust200811" 1561 | "trust200902" 1562 | "noModificationTrust200902" 1563 | "noDerivativesTrust200902" 1564 | "pre5378Trust200902" 1565 )?, 1566 attribute iprExtract { xsd:IDREF }?, 1567 attribute submissionType ( "IETF" | "IAB" | "IRTF" | "independent" )?, 1568 attribute docName { ATEXT }?, 1569 attribute xml:lang { ATEXT }?, 1570 front, 1571 middle, 1572 back? 1573 } 1575 2.34. <section> 1577 Represents a section (when inside a <middle> element) or an appendix 1578 (when inside a <back> element). 1580 Sub-sections are created by nesting <section> elements inside 1581 <section> elements. 1583 This element appears as child element of: <back> (Section 2.7), 1584 <middle> (Section 2.23), and <section> (Section 2.34). 1586 Content model: 1588 1. In any order: 1590 * <t> elements (Section 2.38) 1592 * <figure> elements (Section 2.17) 1594 * <texttable> elements (Section 2.39) 1596 * <iref> elements (Section 2.20) 1598 2. Optional <section> elements (Section 2.34) 1600 2.34.1. Attributes 1602 2.34.1.1. anchor 1604 (optional) 1606 [[element.section.attribute.anchor.missing: attribute description 1607 missing]] 1609 2.34.1.2. title 1611 (mandatory) 1613 The title of the section. 1615 2.34.1.3. toc 1617 (optional) 1619 Determines whether the section is included in the Table Of Contents. 1621 [[anchor20: Need to consider inheritance.]] 1623 Allowed values: 1625 o "include" 1627 o "exclude" 1629 o "default" (default) 1631 2.34.2. Grammar 1632 section = 1633 element section { 1634 attribute anchor { xsd:ID }?, 1635 attribute title { ATEXT }, 1636 attribute toc ( "include" | "exclude" | "default" )?, 1637 (t 1638 | figure 1639 | texttable 1640 | iref)*, 1641 section* 1642 } 1644 2.35. <seriesInfo> 1646 Specifies the document series in which this document appears, and 1647 also specifies an identifier within that series. 1649 This element appears as child element of: <reference> (Section 2.30). 1651 Content model: this element does not have any contents. 1653 2.35.1. Attributes 1655 2.35.1.1. name 1657 (mandatory) 1659 The name of the series. 1661 The following names trigger specific processing (such as for auto- 1662 generating links, and adding descriptions such as "work in 1663 progress"): "BCP", "FYI", "Internet-Draft", "RFC", and "STD". 1665 2.35.1.2. value 1667 (mandatory) 1669 The identifier within the series specified by the "name" attribute. 1671 For BCPs, FYIs, RFCs, and STDs this is the number within the series. 1672 For Internet-Drafts, it is the full draft name (ending with the two- 1673 digit version number). 1675 2.35.2. Grammar 1676 seriesInfo = 1677 element seriesInfo { 1678 attribute name { ATEXT }, 1679 attribute value { ATEXT }, 1680 empty 1681 } 1683 2.36. <spanx> 1685 [[element.spanx.missing: element description missing]] 1687 This element appears as child element of: <annotation> (Section 2.3), 1688 <c> (Section 2.8), <postamble> (Section 2.28), <preamble> 1689 (Section 2.29), and <t> (Section 2.38). 1691 Content model: only text content. 1693 2.36.1. Attributes 1695 2.36.1.1. style 1697 (optional) 1699 [[element.spanx.attribute.style.missing: attribute description 1700 missing]] 1702 2.36.1.2. xml:space 1704 (optional) 1706 Determines whitespace handling. 1708 The default value is "preserve", but that value isn't really suitable 1709 for the use cases <spanx> is defined for (so this might change in 1710 future versions). 1712 See also Section 2.10 of [XML]. 1714 Allowed values: 1716 o "default" 1718 o "preserve" (default) 1720 2.36.2. Grammar 1722 spanx = 1723 element spanx { 1724 attribute xml:space ( "default" | "preserve" )?, 1725 attribute style { ATEXT }?, 1726 CTEXT 1727 } 1729 2.37. <street> 1731 Provides a street address. 1733 This element appears as child element of: <postal> (Section 2.27). 1735 Content model: only text content. 1737 2.37.1. Grammar 1739 street = 1740 element street { 1741 CTEXT 1742 } 1744 2.38. <t> 1746 Contains a paragraph of text. 1748 This element appears as child element of: <abstract> (Section 2.1), 1749 <list> (Section 2.22), <note> (Section 2.24), and <section> 1750 (Section 2.34). 1752 Content model: 1754 In any order: 1756 o Text 1758 o <list> elements (Section 2.22) 1760 o <figure> elements (Section 2.17) 1762 o <xref> elements (Section 2.45) 1764 o <eref> elements (Section 2.15) 1766 o <iref> elements (Section 2.20) 1767 o <cref> elements (Section 2.12) 1769 o <spanx> elements (Section 2.36) 1771 o <vspace> elements (Section 2.43) 1773 2.38.1. Attributes 1775 2.38.1.1. anchor 1777 (optional) 1779 [[element.t.attribute.anchor.missing: attribute description missing]] 1781 2.38.1.2. hangText 1783 (optional) 1785 [[element.t.attribute.hangText.missing: attribute description 1786 missing]] 1788 2.38.2. Grammar 1790 t = 1791 element t { 1792 attribute anchor { xsd:ID }?, 1793 attribute hangText { ATEXT }?, 1794 (TEXT 1795 | \list 1796 | figure 1797 | xref 1798 | eref 1799 | iref 1800 | cref 1801 | spanx 1802 | vspace)* 1803 } 1805 2.39. <texttable> 1807 Contains a table, consisting of an optional preamble, a header line, 1808 rows, and an optional postamble. 1810 This element appears as child element of: <section> (Section 2.34). 1812 Content model: 1814 1. One optional <preamble> element (Section 2.29) 1816 2. One or more <ttcol> elements (Section 2.41) 1818 3. Optional <c> elements (Section 2.8) 1820 4. One optional <postamble> element (Section 2.28) 1822 2.39.1. Attributes 1824 2.39.1.1. align 1826 (optional) 1828 Determines the horizontal alignment of the table. 1830 Allowed values: 1832 o "left" 1834 o "center" (default) 1836 o "right" 1838 2.39.1.2. anchor 1840 (optional) 1842 [[element.texttable.attribute.anchor.missing: attribute description 1843 missing]] 1845 2.39.1.3. style 1847 (optional) 1849 [[element.texttable.attribute.style.missing: attribute description 1850 missing]] 1852 Allowed values: 1854 o "all" 1856 o "none" 1858 o "headers" 1860 o "full" (default) 1862 2.39.1.4. suppress-title 1864 (optional) 1866 [[element.texttable.attribute.suppress-title.missing: attribute 1867 description missing]] 1869 Allowed values: 1871 o "true" 1873 o "false" (default) 1875 2.39.1.5. title 1877 (optional) 1879 [[element.texttable.attribute.title.missing: attribute description 1880 missing]] 1882 2.39.2. Grammar 1884 texttable = 1885 element texttable { 1886 attribute anchor { xsd:ID }?, 1887 attribute title { ATEXT }?, 1888 attribute suppress-title ( "true" | "false" )?, 1889 attribute align ( "left" | "center" | "right" )?, 1890 attribute style ( "all" | "none" | "headers" | "full" )?, 1891 preamble?, 1892 ttcol+, 1893 c*, 1894 postamble? 1895 } 1897 2.40. <title> 1899 Represents the document title. 1901 When this element appears in the <front> element of the current 1902 document, the title might also appear in page headers or footers. If 1903 it's long (~40 characters), the "abbrev" attribute is used to 1904 specified an abbreviated variant. 1906 This element appears as child element of: <front> (Section 2.19). 1908 Content model: only text content. 1910 2.40.1. Attributes 1912 2.40.1.1. abbrev 1914 (optional) 1916 Specifies an abbreviated variant of the document title. 1918 2.40.2. Grammar 1920 title = 1921 element title { 1922 attribute abbrev { ATEXT }?, 1923 CTEXT 1924 } 1926 2.41. <ttcol> 1928 Contains a column heading in a table. 1930 This element appears as child element of: <texttable> (Section 2.39). 1932 Content model: only text content. 1934 2.41.1. Attributes 1936 2.41.1.1. align 1938 (optional) 1940 Determines the horizontal alignment within the table column. 1942 Allowed values: 1944 o "left" (default) 1946 o "center" 1948 o "right" 1950 2.41.1.2. width 1952 (optional) 1954 [[element.ttcol.attribute.width.missing: attribute description 1955 missing]] 1957 2.41.2. Grammar 1959 ttcol = 1960 element ttcol { 1961 attribute width { ATEXT }?, 1962 attribute align ( "left" | "center" | "right" )?, 1963 CTEXT 1964 } 1966 2.42. <uri> 1968 Contains a web address associated with the author. 1970 The contents should be a valid URI (see Section 3 of [RFC3986]). 1972 This element appears as child element of: <address> (Section 2.2). 1974 Content model: only text content. 1976 2.42.1. Grammar 1978 uri = 1979 element uri { 1980 CTEXT 1981 } 1983 2.43. <vspace> 1985 [[element.vspace.missing: element description missing]] 1987 This element appears as child element of: <t> (Section 2.38). 1989 Content model: this element does not have any contents. 1991 2.43.1. Attributes 1993 2.43.1.1. blankLines 1995 (optional) 1997 [[element.vspace.attribute.blankLines.missing: attribute description 1998 missing]] 2000 2.43.2. Grammar 2001 vspace = 2002 element vspace { 2003 attribute blankLines { NUMBER }?, 2004 empty 2005 } 2007 2.44. <workgroup> 2009 This element is used to specify the Working Group the document 2010 originates from, if any. The recommended format is the official name 2011 of the Working Group (with some capitalization), plus the string 2012 "Working Group". 2014 In Internet-Drafts, this is used in the upper left corner of the 2015 boilerplate, replacing the "Network Working Group" string. 2017 This element appears as child element of: <front> (Section 2.19). 2019 Content model: only text content. 2021 2.44.1. Grammar 2023 workgroup = 2024 element workgroup { 2025 CTEXT 2026 } 2028 2.45. <xref> 2030 [[element.xref.missing: element description missing]] 2032 This element appears as child element of: <annotation> (Section 2.3), 2033 <c> (Section 2.8), <postamble> (Section 2.28), <preamble> 2034 (Section 2.29), and <t> (Section 2.38). 2036 Content model: only text content. 2038 2.45.1. Attributes 2040 2.45.1.1. format 2042 (optional) 2044 [[element.xref.attribute.format.missing: attribute description 2045 missing]] 2047 Allowed values: 2049 o "counter" 2051 o "title" 2053 o "none" 2055 o "default" (default) 2057 2.45.1.2. pageno 2059 (optional) 2061 Unused. 2063 It's unclear what the purpose of this attribute is; processors seem 2064 to ignore it and it never was documented. 2066 Allowed values: 2068 o "true" 2070 o "false" (default) 2072 2.45.1.3. target 2074 (mandatory) 2076 [[element.xref.attribute.target.missing: attribute description 2077 missing]] 2079 2.45.2. Grammar 2081 xref = 2082 element xref { 2083 attribute target { xsd:IDREF }, 2084 attribute pageno ( "true" | "false" )?, 2085 attribute format ( "counter" | "title" | "none" | "default" )?, 2086 CTEXT 2087 } 2089 3. Special Unicode Code Points 2091 [[anchor29: Explain those code points where the processors implement 2092 something special, such as "nbsp".]] 2094 4. Internationalization Considerations 2096 [[anchor30: TBD]] 2098 5. Security Considerations 2100 [[anchor31: TBD]] 2102 6. IANA Considerations 2104 [[anchor32: Register application/xml2rfc+xml.]] 2106 7. Acknowledgments 2108 Thanks to everybody who reviewed this document and provided feedback 2109 and/or specification text, in particular Brian Carpenter and Paul 2110 Hoffman. 2112 We also thank Marshall T. Rose for both the original design and the 2113 reference implementation of the "xml2rfc" formatter. 2115 8. References 2117 8.1. Normative References 2119 [XML] Maler, E., Yergeau, F., Paoli, J., Sperberg-McQueen, M., 2120 and T. Bray, "Extensible Markup Language (XML) 1.0 2121 (Fifth Edition)", W3C Recommendation REC-xml-20081126, 2122 November 2008, 2123 <http://www.w3.org/TR/2008/REC-xml-20081126/>. 2125 Latest version available at <http://www.w3.org/TR/xml>. 2127 8.2. Informative References 2129 [IDGUIDE] Housley, R., "Guidelines to Authors of Internet- 2130 Drafts", December 2010, 2131 <http://www.ietf.org/id-info/guidelines.html>. 2133 [RFC2026] Bradner, S., "The Internet Standards Process -- 2134 Revision 3", BCP 9, RFC 2026, October 1996. 2136 [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet 2137 Mail Extensions (MIME) Part Two: Media Types", RFC 2046, 2138 November 1996. 2140 [RFC2397] Masinter, L., "The "data" URL scheme", RFC 2397, 2141 August 1998. 2143 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 2144 June 1999. 2146 [RFC3966] Schulzrinne, H., "The tel URI for Telephone Numbers", 2147 RFC 3966, December 2004. 2149 [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, 2150 "Uniform Resource Identifier (URI): Generic Syntax", 2151 STD 66, RFC 3986, January 2005. 2153 [RFC5598] Crocker, D., "Internet Mail Architecture", RFC 5598, 2154 July 2009. 2156 PDF version: <http://www.rfc-editor.org/rfc/rfc5598.pdf> 2158 [RFC5741] Daigle, L. and O. Kolkman, "RFC Streams, Headers, and 2159 Boilerplates", RFC 5741, December 2009. 2161 [RFC6068] Duerst, M., Masinter, L., and J. Zawinski, "The 'mailto' 2162 URI Scheme", RFC 6068, October 2010. 2164 [RFCPOLICY] RFC Editor, "RFC Editorial Guidelines and Procedures", 2165 February 2012, <http://www.rfc-editor.org/policy.html>. 2167 [RFCSTYLE] Braden, R., Ginoza, S., and A. Hagens, "RFC Document 2168 Style (draft 09)", September 2009, 2169 <http://www.rfc-editor.org/rfc-style-guide/rfc-style>. 2171 [RNC] Clark, J., "RELAX NG Compact Syntax", OASIS , 2172 November 2002, <http://www.oasis-open.org/committees/ 2173 relax-ng/compact-20021121.html>. 2175 [TLP2.0] IETF Trust, "Legal Provisions Relating to IETF 2176 Documents", February 2009, <http://trustee.ietf.org/ 2177 license-info/IETF-Trust-License-Policy-20090215.htm>. 2179 [TLP3.0] IETF Trust, "Legal Provisions Relating to IETF 2180 Documents", September 2009, <http://trustee.ietf.org/ 2181 license-info/IETF-Trust-License-Policy-20090912.htm>. 2183 [TLP4.0] IETF Trust, "Legal Provisions Relating to IETF 2184 Documents", December 2009, <http://trustee.ietf.org/ 2185 license-info/IETF-Trust-License-Policy-20091228.htm>. 2187 Appendix A. Front Page Generation 2188 A.1. The /rfc/@category Attribute 2190 For RFCs, the "category" determines the "maturity level" (see Section 2191 4 of [RFC2026]). The allowed values are "std" for "Standards Track", 2192 "bcp" for "BCP", "info" for "Informational", "exp" for 2193 "Experimental", and "historic" for - surprise - "Historic". 2195 For Internet-Drafts, the category attribute is not needed, but will 2196 appear on the front page as "Intended Status". Supplying this 2197 information can be useful to reviewers. 2199 A.2. The /rfc/@ipr Attribute 2201 This attribute value can take a long list of values, each of which 2202 describes an IPR policy for the document. This attribute's values 2203 are not the result of a grand plan, but remain simply for historic 2204 reasons. Of these values, only a few are currently in use; all 2205 others are supported by the various tools for backwards compatibility 2206 with old source files. 2208 Note: some variations of the boilerplate are selected based on the 2209 document's date; therefore it is important to specify the "year", 2210 "month" and "day" attributes of the "<date>" element when 2211 archiving the XML source of an Internet-Draft on the day of 2212 submission. 2214 _Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU 2215 NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER._ For further information, 2216 refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>. 2218 For the current "Status Of This Memo" text, the "submissionType" 2219 attribute determines whether a statement about "Code Components" is 2220 inserted (which is the case for the value "IETF", which is the 2221 default). Other values, such as "independent", suppress this part of 2222 the text. 2224 A.2.1. Current Values: '*trust200902' 2226 The name for these values refers to the "IETF TRUST Legal Provisions 2227 Relating to IETF Documents", sometimes simply called the "TLP, that 2228 went into effect on February 15, 2009 ([TLP2.0]). Updates to this 2229 document were published on September 12, 2009 ([TLP3.0]) and on 2230 December 28, 2009 ([TLP4.0]), modifying the license for code 2231 components (see <http://trustee.ietf.org/license-info/> for further 2232 information). The actual text is located in Section 6 ("Text To Be 2233 Included in IETF Documents") of these documents. 2235 The tools will automatically produce the "correct" text depending on 2236 the document's date information (see above): 2238 +----------+--------------------------------+ 2239 | TLP | starting with publication date | 2240 +----------+--------------------------------+ 2241 | [TLP3.0] | 2009-11-01 | 2242 | [TLP4.0] | 2010-04-01 | 2243 +----------+--------------------------------+ 2245 A.2.1.1. trust200902 2247 This should be the default, unless one of the more specific 2248 '*trust200902' values is a better fit. It produces the text in 2249 Sections 6.a and 6.b of the TLP. 2251 A.2.1.2. noModificationTrust200902 2253 This produces additional text from Section 6.c.i of the TLP: 2255 This document may not be modified, and derivative works of it may 2256 not be created, except to format it for publication as an RFC or 2257 to translate it into languages other than English. 2259 Note: this clause is incompatible with RFCs that are published on 2260 the Standards Track. 2262 A.2.1.3. noDerivativesTrust200902 2264 This produces the additional text from Section 6.c.ii of the TLP: 2266 This document may not be modified, and derivative works of it may 2267 not be created, and it may not be published except as an Internet- 2268 Draft. 2270 Note: this clause is incompatible with RFCs that are published on 2271 the Standards Track. 2273 A.2.1.4. pre5378Trust200902 2275 This produces the additional text from Section 6.c.iii of the TLP, 2276 frequently called the "pre-5378 escape clause": 2278 This document may contain material from IETF Documents or IETF 2279 Contributions published or made publicly available before November 2280 10, 2008. The person(s) controlling the copyright in some of this 2281 material may not have granted the IETF Trust the right to allow 2282 modifications of such material outside the IETF Standards Process. 2283 Without obtaining an adequate license from the person(s) 2284 controlling the copyright in such materials, this document may not 2285 be modified outside the IETF Standards Process, and derivative 2286 works of it may not be created outside the IETF Standards Process, 2287 except to format it for publication as an RFC or to translate it 2288 into languages other than English. 2290 See Section 4 of 2291 <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf> for further 2292 information about when to use this value. 2294 Note: this text appears under "Copyright Notice", unless the 2295 document was published before November 2009, in which case it 2296 appears under "Status Of This Memo". 2298 A.2.2. Historic Values 2300 A.2.2.1. Historic Values: '*trust200811' 2302 The attribute values "trust200811", "noModificationTrust200811" and 2303 "noDerivativesTrust200811" are similar to their "trust200902" 2304 counterparts, except that they use text specified in <http:// 2305 trustee.ietf.org/license-info/archive/ 2306 IETF-Trust-License-Policy_11-10-08.pdf>. 2308 A.2.2.2. Historic Values: '*3978' 2310 The attribute values "full3978", "noModification3978" and 2311 "noDerivatives3978" are similar to their counterparts above, except 2312 that they use text specified in RFC 3978 (March 2005). 2314 A.2.2.3. Historic Values: '*3667' 2316 The attribute values "full3667", "noModification3667" and 2317 "noDerivatives3667" are similar to their counterparts above, except 2318 that they use text specified in RFC 3667 (February 2004). 2320 A.2.2.4. Historic Values: '*2026' 2322 The attribute values "full2026" and "noDerivativeWorks2026" are 2323 similar to their counterparts above, except that they use text 2324 specified in RFC 2026 (October 1996). 2326 The special value "none" was also used back then, and denied the IETF 2327 any rights beyond publication as Internet-Draft. 2329 Appendix B. Changes from RFC 2629 ('v1') 2331 B.1. Removed Elements 2333 The <appendix> element has been removed; to generate an appendix, 2334 place a <section> inside <back>. 2336 B.2. Changed Defaults 2338 Many attributes have lost their "default" value; this is to avoid 2339 having document semantics differ based on whether a DTD was specified 2340 and evaluated. Processors will handle absent values the way the 2341 default value was specified before. 2343 B.3. Changed Elements 2345 <artwork>: Has a set of new attributes: "name", "type", "src", 2346 "align", "alt", "width", and "height". (Section 2.5) 2348 <author>: The <organization> element is now optional. The "role" 2349 attribute was added. (Section 2.6) 2351 <date>: All attributes are now optional. (Section 2.13) 2353 <figure>: Has a set of new attributes: "suppress-title", "src", 2354 "align", "alt", "width", and "height". (Section 2.17) 2356 <iref>: Has a new "primary" attribute. (Section 2.20) 2358 <list>: The "style" attribute isn't restricted to a set of enumerated 2359 values anymore. The "hangIndent" and "counter" attributes have been 2360 added. (Section 2.22) 2362 <rfc>: The "ipr" attribute has gained additional values. The 2363 attributes "consensus", "iprExtract", "submissionType", and "xml: 2364 lang" have been added. (Section 2.33) 2366 <reference>: <annotation> allows adding prose to a reference. 2367 (Section 2.30) 2369 <references>: Can now appear multiple times, and carry a "title" 2370 attribute (so that normative and informative references can be 2371 split). (Section 2.31) 2373 <section>: The new "toc" attribute controls whether it will appear in 2374 the Table Of Contents. <iref> can now appear as direct child element. 2375 (Section 2.34) 2376 <t>: The "anchor" attribute can now be used as well, however there 2377 are restrictions on how they can be referred to. (Section 2.38) 2379 B.4. New Elements 2381 The following elements have been added: <annotation> (Section 2.3), 2382 <c> (Section 2.8), <cref> (Section 2.12), <format> (Section 2.18), 2383 <spanx> (Section 2.36), <texttable> (Section 2.39). 2385 Appendix C. Relax NG Schema 2387 namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" 2389 NUMBER = string 2390 NUMBERS = string 2391 DAY = string 2392 MONTH = string 2393 YEAR = string 2394 URI = string 2395 ATEXT = string 2396 CTEXT = text 2397 TEXT = text 2398 rfc = 2399 element rfc { 2400 attribute number { NUMBER }?, 2401 [ a:defaultValue = "" ] attribute obsoletes { NUMBERS }?, 2402 [ a:defaultValue = "" ] attribute updates { NUMBERS }?, 2403 attribute category { "std" | "bcp" | "info" | "exp" | "historic" 2404 }?, 2405 attribute consensus { "no" | "yes" }?, 2406 attribute seriesNo { NUMBER }?, 2407 attribute ipr { 2408 "full2026" 2409 | "noDerivativeWorks2026" 2410 | "none" 2411 | "full3667" 2412 | "noModification3667" 2413 | "noDerivatives3667" 2414 | "full3978" 2415 | "noModification3978" 2416 | "noDerivatives3978" 2417 | "trust200811" 2418 | "noModificationTrust200811" 2419 | "noDerivativesTrust200811" 2420 | "trust200902" 2421 | "noModificationTrust200902" 2422 | "noDerivativesTrust200902" 2423 | "pre5378Trust200902" 2424 }?, 2425 attribute iprExtract { xsd:IDREF }?, 2426 [ a:defaultValue = "IETF" ] 2427 attribute submissionType { 2428 "IETF" | "IAB" | "IRTF" | "independent" 2429 }?, 2430 attribute docName { ATEXT }?, 2431 [ a:defaultValue = "en" ] attribute xml:lang { ATEXT }?, 2432 front, 2433 middle, 2434 back? 2435 } 2436 front = 2437 element front { 2438 title, author+, date, area*, workgroup*, keyword*, abstract?, 2439 note* 2440 } 2441 title = 2442 element title { 2443 attribute abbrev { ATEXT }?, 2444 CTEXT 2445 } 2446 author = 2447 element author { 2448 attribute initials { ATEXT }?, 2449 attribute surname { ATEXT }?, 2450 attribute fullname { ATEXT }?, 2451 attribute role { "editor" }?, 2452 organization?, 2453 address? 2454 } 2455 organization = 2456 element organization { 2457 attribute abbrev { ATEXT }?, 2458 CTEXT 2459 } 2460 address = element address { postal?, phone?, facsimile?, email?, 2461 uri? } 2462 postal = element postal { street+, (city | region | code | country)* 2463 } 2464 street = element street { CTEXT } 2465 city = element city { CTEXT } 2466 region = element region { CTEXT } 2467 code = element code { CTEXT } 2468 country = element country { CTEXT } 2469 phone = element phone { CTEXT } 2470 facsimile = element facsimile { CTEXT } 2471 email = element email { CTEXT } 2472 uri = element uri { CTEXT } 2473 date = 2474 element date { 2475 attribute day { DAY }?, 2476 attribute month { MONTH }?, 2477 attribute year { YEAR }?, 2478 empty 2479 } 2480 area = element area { CTEXT } 2481 workgroup = element workgroup { CTEXT } 2482 keyword = element keyword { CTEXT } 2483 abstract = element abstract { t+ } 2484 note = 2485 element note { 2486 attribute title { ATEXT }, 2487 t+ 2488 } 2489 middle = element middle { section+ } 2490 section = 2491 element section { 2492 attribute anchor { xsd:ID }?, 2493 attribute title { ATEXT }, 2494 [ a:defaultValue = "default" ] 2495 attribute toc { "include" | "exclude" | "default" }?, 2496 (t | figure | texttable | iref)*, 2497 section* 2498 } 2499 t = 2500 element t { 2501 attribute anchor { xsd:ID }?, 2502 attribute hangText { ATEXT }?, 2503 (TEXT 2504 | \list 2505 | figure 2506 | xref 2507 | eref 2508 | iref 2509 | cref 2510 | spanx 2511 | vspace)* 2512 } 2513 \list = 2514 element list { 2515 attribute style { ATEXT }?, 2516 attribute hangIndent { NUMBER }?, 2517 attribute counter { ATEXT }?, 2518 t+ 2520 } 2521 xref = 2522 element xref { 2523 attribute target { xsd:IDREF }, 2524 [ a:defaultValue = "false" ] attribute pageno { "true" | "false" 2525 }?, 2526 [ a:defaultValue = "default" ] 2527 attribute format { "counter" | "title" | "none" | "default" }?, 2528 CTEXT 2529 } 2530 eref = 2531 element eref { 2532 attribute target { URI }, 2533 CTEXT 2534 } 2535 iref = 2536 element iref { 2537 attribute item { ATEXT }, 2538 [ a:defaultValue = "" ] attribute subitem { ATEXT }?, 2539 [ a:defaultValue = "false" ] 2540 attribute primary { "true" | "false" }?, 2541 empty 2542 } 2543 cref = 2544 element cref { 2545 attribute anchor { xsd:ID }?, 2546 attribute source { ATEXT }?, 2547 CTEXT 2548 } 2549 spanx = 2550 element spanx { 2551 [ a:defaultValue = "preserve" ] 2552 attribute xml:space { "default" | "preserve" }?, 2553 [ a:defaultValue = "emph" ] attribute style { ATEXT }?, 2554 CTEXT 2555 } 2556 vspace = 2557 element vspace { 2558 [ a:defaultValue = "0" ] attribute blankLines { NUMBER }?, 2559 empty 2560 } 2561 figure = 2562 element figure { 2563 attribute anchor { xsd:ID }?, 2564 [ a:defaultValue = "" ] attribute title { ATEXT }?, 2565 [ a:defaultValue = "false" ] 2566 attribute suppress-title { "true" | "false" }?, 2567 attribute src { URI }?, 2569 [ a:defaultValue = "left" ] 2570 attribute align { "left" | "center" | "right" }?, 2571 [ a:defaultValue = "" ] attribute alt { ATEXT }?, 2572 [ a:defaultValue = "" ] attribute width { ATEXT }?, 2573 [ a:defaultValue = "" ] attribute height { ATEXT }?, 2574 iref*, 2575 preamble?, 2576 artwork, 2577 postamble? 2578 } 2579 preamble = 2580 element preamble { (TEXT | xref | eref | iref | cref | spanx)* } 2581 artwork = 2582 element artwork { 2583 [ a:defaultValue = "preserve" ] 2584 attribute xml:space { "default" | "preserve" }?, 2585 [ a:defaultValue = "" ] attribute name { ATEXT }?, 2586 [ a:defaultValue = "" ] attribute type { ATEXT }?, 2587 attribute src { URI }?, 2588 [ a:defaultValue = "left" ] 2589 attribute align { "left" | "center" | "right" }?, 2590 [ a:defaultValue = "" ] attribute alt { ATEXT }?, 2591 [ a:defaultValue = "" ] attribute width { ATEXT }?, 2592 [ a:defaultValue = "" ] attribute height { ATEXT }?, 2593 TEXT* 2594 } 2595 postamble = 2596 element postamble { (TEXT | xref | eref | iref | cref | spanx)* } 2597 texttable = 2598 element texttable { 2599 attribute anchor { xsd:ID }?, 2600 [ a:defaultValue = "" ] attribute title { ATEXT }?, 2601 [ a:defaultValue = "false" ] 2602 attribute suppress-title { "true" | "false" }?, 2603 [ a:defaultValue = "center" ] 2604 attribute align { "left" | "center" | "right" }?, 2605 [ a:defaultValue = "full" ] 2606 attribute style { "all" | "none" | "headers" | "full" }?, 2607 preamble?, 2608 ttcol+, 2609 c*, 2610 postamble? 2611 } 2612 ttcol = 2613 element ttcol { 2614 attribute width { ATEXT }?, 2615 [ a:defaultValue = "left" ] 2616 attribute align { "left" | "center" | "right" }?, 2617 CTEXT 2618 } 2619 c = element c { (TEXT | xref | eref | iref | cref | spanx)* } 2620 back = element back { references*, section* } 2621 references = 2622 element references { 2623 [ a:defaultValue = "References" ] attribute title { ATEXT }?, 2624 reference+ 2625 } 2626 reference = 2627 element reference { 2628 attribute anchor { xsd:ID }?, 2629 attribute target { URI }?, 2630 front, 2631 seriesInfo*, 2632 format*, 2633 annotation* 2634 } 2635 seriesInfo = 2636 element seriesInfo { 2637 attribute name { ATEXT }, 2638 attribute value { ATEXT }, 2639 empty 2640 } 2641 format = 2642 element format { 2643 attribute target { URI }?, 2644 attribute type { ATEXT }, 2645 attribute octets { NUMBER }?, 2646 empty 2647 } 2648 annotation = 2649 element annotation { (TEXT | xref | eref | iref | cref | spanx)* } 2650 start = rfc 2652 Appendix D. Proposed Future Changes for 'v3' 2654 [[anchor40: The list below is just a starting point, see 2655 <https://www.rfc-editor.org/rse/wiki/doku.php?id=design:xml-tags> for 2656 more.]] 2658 D.1. Contact Information 2660 If contact information is changed to allow non-ASCII characters: add 2661 a place for a ASCII fallback (probably just for the author names). 2663 The content model for <postal> ought to be more strict to allow at 2664 most one of <city>, <region>, <code>, and <country>. 2666 It should be possible to have multiple <uri> elements. 2668 <facsimile> looks outdated, while a container for IM (messaging) URIs 2669 is missing. Maybe this area needs to be aligned with vCard. 2671 Section 4.8 of [RFCSTYLE] hints at a "Contributors" Section that 2672 could supply contact information similar to the one in the auto- 2673 generated "Authors' Address" Section. Consider how to capture 2674 contributor contact information (probably not using <author> to avoid 2675 confusion). Furthermore, consider ways to augment the contact 2676 information section with prose. 2678 D.2. Figures 2680 Cleanup the set of overlapping attributes between <figure> and 2681 <artwork>. 2683 For artwork that consists of a sequence of items (such as messages in 2684 a protocol example), it would be good if a <figure> element could 2685 contain multiple <artwork> elements (to assist code to find good 2686 places for page breaks). 2688 Extend <figure> to support different types of artwork (such as by 2689 specifying certain type attribute values, see <http://greenbytes.de/ 2690 tech/webdav/rfc2629xslt/rfc2629xslt.html#artwork.types>), and also 2691 avoid having to markup code (such as ABNF) as "artwork". 2693 It would be good if "code components" could be marked as such. 2695 Finally, even in preformatted text use of markup could be useful to 2696 support (a) references, or (b) highlighting the important bits (<http 2697 ://greenbytes.de/tech/webdav/rfc2629xslt/ 2698 rfc2629xslt.html#ext-rfc2629.artwork>). 2700 D.3. Linking 2702 Extend <xref> so that subsection/anchors can be specified (see <http: 2703 //greenbytes.de/tech/webdav/rfc2629xslt/ 2704 rfc2629xslt.html#ext-rfc2629.xref>). Remove the "pageno" attribute 2705 which seems to be both undocumented and non-functional. 2707 D.4. Lists 2709 Allow multiple paragraphs in list items; eliminating the need to use 2710 <vspace> (see <http://greenbytes.de/tech/webdav/rfc2629xslt/ 2711 rfc2629xslt.html#ext.element.lt>). 2713 D.5. References 2715 Allow overriding the "anchor" attribute of an included <reference> 2716 element. 2718 Add a way to add prose to a reference that avoids abuse of 2719 <seriesInfo>. 2721 Allow <reference>s that identify a document set such as a BCP. 2723 Deprecate or remove the <format> element; right now it's not used for 2724 the generation of the plain text document anyway. 2726 It is unclear why the "anchor" attribute is optional. 2728 D.6. Archival Considerations 2730 When this vocabulary becomes the canonical RFC format, it will need 2731 to be able to capture all generated information, such as section/ 2732 figure/table numbers, plus any auto-generated boilerplate (copyright 2733 statements etc.). 2735 D.7. Document Metadata 2737 Extend the concept of language tagging to at least examples and 2738 contact information to address potential japanese/chinese font 2739 confusion. 2741 Provide a way to indicate the intended level on the standards track. 2743 Include feedback information in a way so that generated documents can 2744 provide usable feedback links (see <http://greenbytes.de/tech/webdav/ 2745 rfc2629xslt/rfc2629xslt.html#ext.element.feedback>). 2747 D.8. Misc. 2749 Make the <date> element optional; all of its content is optional 2750 already. 2752 <spanx> has both a weird whitespace model ("preserve") and 2753 problematic styling. Consider to deprecate it in favor of elements 2754 such as <em> and <code> (where the name "code" is already in use for 2755 region codes). 2757 Indented paragraphs currently can be created by abusing the <list>. 2758 It would be good to have a special element for this purpose. 2760 Provide a special element for generating citations. 2762 The content model for <cref> should be extended to allow more flow 2763 elements, such as <xref> and <eref>. 2765 Appendix E. Comparison Of Vocabularies (to be removed before 2766 publication as RFC) 2768 With comments being stripped; using "diff -C100" to add change marks. 2770 E.1. RFC 2629 ('v1') RelaxNG Grammar 2772 (from Appendix B of [RFC2629], converted using "trang" into Relag NG 2773 Compact Notation [RNC]) 2775 namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" 2777 NUMBER = string 2778 NUMBERS = string 2779 DAY = string 2780 MONTH = string 2781 YEAR = string 2782 URI = string 2783 ATEXT = string 2784 CTEXT = text 2785 TEXT = text 2786 rfc = 2787 element rfc { 2788 attribute number { NUMBER }?, 2789 [ a:defaultValue = "" ] attribute obsoletes { NUMBERS }?, 2790 [ a:defaultValue = "" ] attribute updates { NUMBERS }?, 2791 - [ a:defaultValue = "info" ] 2792 attribute category { "std" | "bcp" | "info" | "exp" | "historic" }?, 2793 attribute seriesNo { NUMBER }?, 2794 ! attribute ipr { "full2026" | "noDerivativeWorks2026" | "none" }?, 2795 attribute docName { ATEXT }?, 2796 front, 2797 middle, 2798 back? 2799 } 2800 front = 2801 element front { 2802 title, author+, date, area*, workgroup*, keyword*, abstract?, note* 2803 } 2804 title = 2805 element title { 2806 attribute abbrev { ATEXT }?, 2807 CTEXT 2808 } 2809 author = 2810 element author { 2811 attribute initials { ATEXT }?, 2812 attribute surname { ATEXT }?, 2813 attribute fullname { ATEXT }?, 2814 ! organization, 2815 address? 2816 } 2817 organization = 2818 element organization { 2819 attribute abbrev { ATEXT }?, 2820 CTEXT 2821 } 2822 address = element address { postal?, phone?, facsimile?, email?, uri? } 2823 postal = element postal { street+, (city | region | code | country)* } 2824 street = element street { CTEXT } 2825 city = element city { CTEXT } 2826 region = element region { CTEXT } 2827 code = element code { CTEXT } 2828 country = element country { CTEXT } 2829 phone = element phone { CTEXT } 2830 facsimile = element facsimile { CTEXT } 2831 email = element email { CTEXT } 2832 uri = element uri { CTEXT } 2833 date = 2834 element date { 2835 attribute day { DAY }?, 2836 ! attribute month { MONTH }, 2837 ! attribute year { YEAR }, 2838 empty 2839 } 2840 area = element area { CTEXT } 2841 workgroup = element workgroup { CTEXT } 2842 keyword = element keyword { CTEXT } 2843 abstract = element abstract { t+ } 2844 note = 2845 element note { 2846 attribute title { ATEXT }, 2847 t+ 2848 } 2849 middle = element middle { section+ } 2850 section = 2851 element section { 2852 attribute anchor { xsd:ID }?, 2853 attribute title { ATEXT }, 2854 ! (t | figure | section)* 2855 } 2856 t = 2857 element t { 2858 attribute hangText { ATEXT }?, 2859 ! (TEXT | \list | figure | xref | eref | iref | vspace)* 2860 } 2861 \list = 2862 element list { 2863 ! [ a:defaultValue = "empty" ] 2864 ! attribute style { "numbers" | "symbols" | "hanging" | "empty" }?, 2865 t+ 2866 } 2867 xref = 2868 element xref { 2869 attribute target { xsd:IDREF }, 2870 [ a:defaultValue = "false" ] attribute pageno { "true" | "false" }?, 2871 CTEXT 2872 } 2873 eref = 2874 element eref { 2875 attribute target { URI }, 2876 CTEXT 2877 } 2878 iref = 2879 element iref { 2880 attribute item { ATEXT }, 2881 [ a:defaultValue = "" ] attribute subitem { ATEXT }?, 2882 empty 2883 } 2884 vspace = 2885 element vspace { 2886 [ a:defaultValue = "0" ] attribute blankLines { NUMBER }?, 2887 empty 2888 } 2889 figure = 2890 element figure { 2891 attribute anchor { xsd:ID }?, 2892 [ a:defaultValue = "" ] attribute title { ATEXT }?, 2893 preamble?, 2894 artwork, 2895 postamble? 2896 } 2897 ! preamble = element preamble { (TEXT | xref | eref | iref)* } 2898 artwork = 2899 element artwork { 2900 [ a:defaultValue = "preserve" ] 2901 attribute xml:space { "default" | "preserve" }?, 2902 TEXT* 2903 } 2904 ! postamble = element postamble { (TEXT | xref | eref | iref)* } 2905 ! back = element back { references?, section* } 2906 ! references = element references { reference+ } 2907 reference = 2908 element reference { 2909 attribute anchor { xsd:ID }?, 2910 attribute target { URI }?, 2911 front, 2912 ! seriesInfo* 2913 } 2914 seriesInfo = 2915 element seriesInfo { 2916 attribute name { ATEXT }, 2917 attribute value { ATEXT }, 2918 empty 2919 } 2920 start = rfc 2922 E.2. Current ('v2') RelaxNG Grammar 2924 namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" 2926 NUMBER = string 2927 NUMBERS = string 2928 DAY = string 2929 MONTH = string 2930 YEAR = string 2931 URI = string 2932 ATEXT = string 2933 CTEXT = text 2934 TEXT = text 2935 rfc = 2936 element rfc { 2937 attribute number { NUMBER }?, 2938 [ a:defaultValue = "" ] attribute obsoletes { NUMBERS }?, 2939 [ a:defaultValue = "" ] attribute updates { NUMBERS }?, 2940 attribute category { "std" | "bcp" | "info" | "exp" | "historic" }?, 2941 + attribute consensus { "no" | "yes" }?, 2942 attribute seriesNo { NUMBER }?, 2943 ! attribute ipr { 2944 ! "full2026" 2945 ! | "noDerivativeWorks2026" 2946 ! | "none" 2947 ! | "full3667" 2948 ! | "noModification3667" 2949 ! | "noDerivatives3667" 2950 ! | "full3978" 2951 ! | "noModification3978" 2952 ! | "noDerivatives3978" 2953 ! | "trust200811" 2954 ! | "noModificationTrust200811" 2955 ! | "noDerivativesTrust200811" 2956 ! | "trust200902" 2957 ! | "noModificationTrust200902" 2958 ! | "noDerivativesTrust200902" 2959 ! | "pre5378Trust200902" 2960 ! }?, 2961 ! attribute iprExtract { xsd:IDREF }?, 2962 ! [ a:defaultValue = "IETF" ] 2963 ! attribute submissionType { 2964 ! "IETF" | "IAB" | "IRTF" | "independent" 2965 ! }?, 2966 attribute docName { ATEXT }?, 2967 + [ a:defaultValue = "en" ] attribute xml:lang { ATEXT }?, 2968 front, 2969 middle, 2970 back? 2971 } 2972 front = 2973 element front { 2974 title, author+, date, area*, workgroup*, keyword*, abstract?, note* 2975 } 2976 title = 2977 element title { 2978 attribute abbrev { ATEXT }?, 2979 CTEXT 2980 } 2981 author = 2982 element author { 2983 attribute initials { ATEXT }?, 2984 attribute surname { ATEXT }?, 2985 attribute fullname { ATEXT }?, 2986 ! attribute role { "editor" }?, 2987 ! organization?, 2988 address? 2989 } 2990 organization = 2991 element organization { 2992 attribute abbrev { ATEXT }?, 2993 CTEXT 2994 } 2995 address = element address { postal?, phone?, facsimile?, email?, uri? } 2996 postal = element postal { street+, (city | region | code | country)* } 2997 street = element street { CTEXT } 2998 city = element city { CTEXT } 2999 region = element region { CTEXT } 3000 code = element code { CTEXT } 3001 country = element country { CTEXT } 3002 phone = element phone { CTEXT } 3003 facsimile = element facsimile { CTEXT } 3004 email = element email { CTEXT } 3005 uri = element uri { CTEXT } 3006 date = 3007 element date { 3008 attribute day { DAY }?, 3009 ! attribute month { MONTH }?, 3010 ! attribute year { YEAR }?, 3011 empty 3012 } 3013 area = element area { CTEXT } 3014 workgroup = element workgroup { CTEXT } 3015 keyword = element keyword { CTEXT } 3016 abstract = element abstract { t+ } 3017 note = 3018 element note { 3019 attribute title { ATEXT }, 3020 t+ 3021 } 3022 middle = element middle { section+ } 3023 section = 3024 element section { 3025 attribute anchor { xsd:ID }?, 3026 attribute title { ATEXT }, 3027 ! [ a:defaultValue = "default" ] 3028 ! attribute toc { "include" | "exclude" | "default" }?, 3029 ! (t | figure | texttable | iref)*, 3030 ! section* 3031 } 3032 t = 3033 element t { 3034 + attribute anchor { xsd:ID }?, 3035 attribute hangText { ATEXT }?, 3036 ! (TEXT 3037 ! | \list 3038 ! | figure 3039 ! | xref 3040 ! | eref 3041 ! | iref 3042 ! | cref 3043 ! | spanx 3044 ! | vspace)* 3045 } 3046 \list = 3047 element list { 3048 ! attribute style { ATEXT }?, 3049 ! attribute hangIndent { NUMBER }?, 3050 ! attribute counter { ATEXT }?, 3051 t+ 3052 } 3053 xref = 3054 element xref { 3055 attribute target { xsd:IDREF }, 3056 [ a:defaultValue = "false" ] attribute pageno { "true" | "false" }?, 3057 + [ a:defaultValue = "default" ] 3058 + attribute format { "counter" | "title" | "none" | "default" }?, 3059 CTEXT 3060 } 3061 eref = 3062 element eref { 3063 attribute target { URI }, 3064 CTEXT 3065 } 3066 iref = 3067 element iref { 3068 attribute item { ATEXT }, 3069 [ a:defaultValue = "" ] attribute subitem { ATEXT }?, 3070 + [ a:defaultValue = "false" ] 3071 + attribute primary { "true" | "false" }?, 3072 empty 3073 } 3074 + cref = 3075 + element cref { 3076 + attribute anchor { xsd:ID }?, 3077 + attribute source { ATEXT }?, 3078 + CTEXT 3079 + } 3080 + spanx = 3081 + element spanx { 3082 + [ a:defaultValue = "preserve" ] 3083 + attribute xml:space { "default" | "preserve" }?, 3084 + [ a:defaultValue = "emph" ] attribute style { ATEXT }?, 3085 + CTEXT 3086 + } 3087 vspace = 3088 element vspace { 3089 [ a:defaultValue = "0" ] attribute blankLines { NUMBER }?, 3090 empty 3091 } 3092 figure = 3093 element figure { 3094 attribute anchor { xsd:ID }?, 3095 [ a:defaultValue = "" ] attribute title { ATEXT }?, 3096 + [ a:defaultValue = "false" ] 3097 + attribute suppress-title { "true" | "false" }?, 3098 + attribute src { URI }?, 3099 + [ a:defaultValue = "left" ] 3100 + attribute align { "left" | "center" | "right" }?, 3101 + [ a:defaultValue = "" ] attribute alt { ATEXT }?, 3102 + [ a:defaultValue = "" ] attribute width { ATEXT }?, 3103 + [ a:defaultValue = "" ] attribute height { ATEXT }?, 3104 + iref*, 3105 preamble?, 3106 artwork, 3107 postamble? 3108 } 3109 ! preamble = 3110 ! element preamble { (TEXT | xref | eref | iref | cref | spanx)* } 3111 artwork = 3112 element artwork { 3113 [ a:defaultValue = "preserve" ] 3114 attribute xml:space { "default" | "preserve" }?, 3115 + [ a:defaultValue = "" ] attribute name { ATEXT }?, 3116 + [ a:defaultValue = "" ] attribute type { ATEXT }?, 3117 + attribute src { URI }?, 3118 + [ a:defaultValue = "left" ] 3119 + attribute align { "left" | "center" | "right" }?, 3120 + [ a:defaultValue = "" ] attribute alt { ATEXT }?, 3121 + [ a:defaultValue = "" ] attribute width { ATEXT }?, 3122 + [ a:defaultValue = "" ] attribute height { ATEXT }?, 3123 TEXT* 3124 } 3125 ! postamble = 3126 ! element postamble { (TEXT | xref | eref | iref | cref | spanx)* } 3127 ! texttable = 3128 ! element texttable { 3129 ! attribute anchor { xsd:ID }?, 3130 ! [ a:defaultValue = "" ] attribute title { ATEXT }?, 3131 ! [ a:defaultValue = "false" ] 3132 ! attribute suppress-title { "true" | "false" }?, 3133 ! [ a:defaultValue = "center" ] 3134 ! attribute align { "left" | "center" | "right" }?, 3135 ! [ a:defaultValue = "full" ] 3136 ! attribute style { "all" | "none" | "headers" | "full" }?, 3137 ! preamble?, 3138 ! ttcol+, 3139 ! c*, 3140 ! postamble? 3141 ! } 3142 ! ttcol = 3143 ! element ttcol { 3144 ! attribute width { ATEXT }?, 3145 ! [ a:defaultValue = "left" ] 3146 ! attribute align { "left" | "center" | "right" }?, 3147 ! CTEXT 3148 ! } 3149 ! c = element c { (TEXT | xref | eref | iref | cref | spanx)* } 3150 ! back = element back { references*, section* } 3151 ! references = 3152 ! element references { 3153 ! [ a:defaultValue = "References" ] attribute title { ATEXT }?, 3154 ! reference+ 3155 ! } 3156 reference = 3157 element reference { 3158 attribute anchor { xsd:ID }?, 3159 attribute target { URI }?, 3160 front, 3161 ! seriesInfo*, 3162 ! format*, 3163 ! annotation* 3164 } 3165 seriesInfo = 3166 element seriesInfo { 3167 attribute name { ATEXT }, 3168 attribute value { ATEXT }, 3169 empty 3170 } 3171 + format = 3172 + element format { 3173 + attribute target { URI }?, 3174 + attribute type { ATEXT }, 3175 + attribute octets { NUMBER }?, 3176 + empty 3177 + } 3178 + annotation = 3179 + element annotation { (TEXT | xref | eref | iref | cref | spanx)* } 3180 start = rfc 3182 Index 3184 A 3185 abbrev attribute 3186 in organization element 25 3187 in title element 42 3188 abstract element 4 3189 inside front 21 3190 address element 5 3191 inside author 10 3192 align attribute 3193 in artwork element 7 3194 in figure element 17 3195 in texttable element 40 3196 in ttcol element 42 3197 alt attribute 3198 in artwork element 8 3199 in figure element 18 3200 anchor attribute 3201 in cref element 14 3202 in figure element 18 3203 in reference element 28 3204 in section element 35 3205 in t element 39 3206 in texttable element 40 3207 annotation element 5 3208 inside reference 28 3209 area element 6 3210 inside front 21 3211 artwork element 7 3212 align attribute 7 3213 alt attribute 8 3214 height attribute 8 3215 inside figure 17 3216 name attribute 8 3217 src attribute 8 3218 type attribute 9 3219 width attribute 9 3220 xml:space attribute 9 3221 Attributes 3222 abbrev 25, 42 3223 align 7, 17, 40, 42 3224 alt 8, 18 3225 anchor 14, 18, 28, 35, 39-40 3226 blankLines 43 3227 category 30 3228 consensus 31 3229 counter 23 3230 day 15 3231 docName 31 3232 format 44 3233 fullname 10 3234 hangIndent 23 3235 hangText 39 3236 height 8, 18 3237 initials 11 3238 ipr 31 3239 iprExtract 32 3240 item 22 3241 month 15 3242 name 8, 36 3243 number 32 3244 obsoletes 32 3245 octets 20 3246 pageno 45 3247 primary 22 3248 role 11 3249 seriesNo 33 3250 source 14 3251 src 8, 18 3252 style 23, 37, 40 3253 subitem 22 3254 submissionType 33 3255 suppress-title 18, 41 3256 surname 11 3257 target 16, 20, 28, 45 3258 title 19, 24, 29, 35, 41 3259 toc 35 3260 type 9, 20 3261 updates 33 3262 value 36 3263 width 9, 19, 42 3264 xml:lang 33 3265 xml:space 9, 37 3266 year 15 3267 author element 10 3268 fullname attribute 10 3269 initials attribute 11 3270 inside front 20 3271 role attribute 11 3272 surname attribute 11 3274 B 3275 back element 11 3276 inside rfc 30 3277 blankLines attribute 3278 in vspace element 43 3280 C 3281 c element 12 3282 inside texttable 40 3283 category attribute 3284 in rfc element 30 3285 city element 13 3286 inside postal 26 3287 code element 13 3288 inside postal 26 3289 consensus attribute 3290 in rfc element 31 3291 counter attribute 3292 in list element 23 3293 country element 13 3294 inside postal 26 3295 cref element 14 3296 anchor attribute 14 3297 inside annotation 6 3298 inside c 12 3299 inside postamble 27 3300 inside preamble 27 3301 inside t 39 3302 source attribute 14 3304 D 3305 date element 14 3306 day attribute 15 3307 inside front 20 3308 month attribute 15 3309 year attribute 15 3310 day attribute 3311 in date element 15 3312 docName attribute 3313 in rfc element 31 3315 E 3316 Elements 3317 abstract 4, 21 3318 address 5, 10 3319 annotation 5, 28 3320 area 6, 21 3321 artwork 7, 17 3322 author 10, 20 3323 back 11, 30 3324 c 12, 40 3325 city 13, 26 3326 code 13, 26 3327 country 13, 26 3328 cref 6, 12, 14, 27, 39 3329 date 14, 20 3330 email 5, 16 3331 eref 6, 12, 16, 27, 38 3332 facsimile 5, 17 3333 figure 17, 35, 38 3334 format 19, 28 3335 front 20, 28, 30 3336 iref 6, 12, 17, 21, 27, 35, 38 3337 keyword 21-22 3338 list 23, 38 3339 middle 24, 30 3340 note 21, 24 3341 organization 10, 25 3342 phone 5, 25 3343 postal 5, 26 3344 postamble 17, 26, 40 3345 preamble 17, 27, 40 3346 reference 28-29 3347 references 12, 29 3348 region 26, 30 3349 rfc 30 3350 section 12, 24, 34-35 3351 seriesInfo 28, 36 3352 spanx 6, 12, 27, 37, 39 3353 street 26, 38 3354 t 5, 23-24, 35, 38 3355 texttable 35, 39 3356 title 20, 41 3357 ttcol 40, 42 3358 uri 5, 43 3359 vspace 39, 43 3360 workgroup 21, 44 3361 xref 6, 12, 27, 38, 44 3362 email element 16 3363 inside address 5 3364 eref element 16 3365 inside annotation 6 3366 inside c 12 3367 inside postamble 27 3368 inside preamble 27 3369 inside t 38 3370 target attribute 16 3372 F 3373 facsimile element 17 3374 inside address 5 3375 figure element 17 3376 align attribute 17 3377 alt attribute 18 3378 anchor attribute 18 3379 height attribute 18 3380 inside section 35 3381 inside t 38 3382 src attribute 18 3383 suppress-title attribute 18 3384 title attribute 19 3385 width attribute 19 3387 format attribute 3388 in xref element 44 3389 format element 19 3390 inside reference 28 3391 octets attribute 20 3392 target attribute 20 3393 type attribute 20 3394 front element 20 3395 inside reference 28 3396 inside rfc 30 3397 fullname attribute 3398 in author element 10 3400 H 3401 hangIndent attribute 3402 in list element 23 3403 hangText attribute 3404 in t element 39 3405 height attribute 3406 in artwork element 8 3407 in figure element 18 3409 I 3410 initials attribute 3411 in author element 11 3412 ipr attribute 3413 '*2026' 50 3414 '*3667' 50 3415 '*3978' 50 3416 '*trust200811' 50 3417 '*trust200902' 48 3418 'noDerivativesTrust200902' 49 3419 'noModificationTrust200902' 49 3420 'pre5378Trust200902' 49 3421 'trust200902' 49 3422 in rfc element 31 3423 iprExtract attribute 3424 in rfc element 32 3425 iref element 21 3426 inside annotation 6 3427 inside c 12 3428 inside figure 17 3429 inside postamble 27 3430 inside preamble 27 3431 inside section 35 3432 inside t 38 3433 item attribute 22 3434 primary attribute 22 3435 subitem attribute 22 3436 item attribute 3437 in iref element 22 3439 K 3440 keyword element 22 3441 inside front 21 3443 L 3444 list element 23 3445 counter attribute 23 3446 hangIndent attribute 23 3447 inside t 38 3448 style attribute 23 3450 M 3451 middle element 24 3452 inside rfc 30 3453 month attribute 3454 in date element 15 3456 N 3457 name attribute 3458 in artwork element 8 3459 in seriesInfo element 36 3460 note element 24 3461 inside front 21 3462 title attribute 24 3463 number attribute 3464 in rfc element 32 3466 O 3467 obsoletes attribute 3468 in rfc element 32 3469 octets attribute 3470 in format element 20 3471 organization element 25 3472 abbrev attribute 25 3473 inside author 10 3475 P 3476 pageno attribute 3477 in xref element 45 3478 phone element 25 3479 inside address 5 3480 postal element 26 3481 inside address 5 3482 postamble element 26 3483 inside figure 17 3484 inside texttable 40 3485 preamble element 27 3486 inside figure 17 3487 inside texttable 40 3488 primary attribute 3489 in iref element 22 3491 R 3492 reference element 28 3493 anchor attribute 28 3494 inside references 29 3495 target attribute 28 3496 references element 29 3497 inside back 12 3498 title attribute 29 3499 region element 30 3500 inside postal 26 3501 rfc element 30 3502 category attribute 30 3503 consensus attribute 31 3504 docName attribute 31 3505 ipr attribute 31 3506 iprExtract attribute 32 3507 number attribute 32 3508 obsoletes attribute 32 3509 seriesNo attribute 33 3510 submissionType attribute 33 3511 updates attribute 33 3512 xml:lang attribute 33 3513 role attribute 3514 in author element 11 3516 S 3517 section element 34 3518 anchor attribute 35 3519 inside back 12 3520 inside middle 24 3521 inside section 35 3522 title attribute 35 3523 toc attribute 35 3524 seriesInfo element 36 3525 inside reference 28 3526 name attribute 36 3527 value attribute 36 3528 seriesNo attribute 3529 in rfc element 33 3530 source attribute 3531 in cref element 14 3532 spanx element 37 3533 inside annotation 6 3534 inside c 12 3535 inside postamble 27 3536 inside preamble 27 3537 inside t 39 3538 style attribute 37 3539 xml:space attribute 37 3540 src attribute 3541 in artwork element 8 3542 in figure element 18 3543 street element 38 3544 inside postal 26 3545 style attribute 3546 in list element 23 3547 in spanx element 37 3548 in texttable element 40 3549 subitem attribute 3550 in iref element 22 3551 submissionType attribute 3552 in rfc element 33 3553 suppress-title attribute 3554 in figure element 18 3555 in texttable element 41 3556 surname attribute 3557 in author element 11 3559 T 3560 t element 38 3561 anchor attribute 39 3562 hangText attribute 39 3563 inside abstract 5 3564 inside list 23 3565 inside note 24 3566 inside section 35 3567 target attribute 3568 in eref element 16 3569 in format element 20 3570 in reference element 28 3571 in xref element 45 3572 texttable element 39 3573 align attribute 40 3574 anchor attribute 40 3575 inside section 35 3576 style attribute 40 3577 suppress-title attribute 41 3578 title attribute 41 3580 title attribute 3581 in figure element 19 3582 in note element 24 3583 in references element 29 3584 in section element 35 3585 in texttable element 41 3586 title element 41 3587 abbrev attribute 42 3588 inside front 20 3589 toc attribute 3590 in section element 35 3591 ttcol element 42 3592 align attribute 42 3593 inside texttable 40 3594 width attribute 42 3595 type attribute 3596 in artwork element 9 3597 in format element 20 3599 U 3600 updates attribute 3601 in rfc element 33 3602 uri element 43 3603 inside address 5 3605 V 3606 value attribute 3607 in seriesInfo element 36 3608 vspace element 43 3609 blankLines attribute 43 3610 inside t 39 3612 W 3613 width attribute 3614 in artwork element 9 3615 in figure element 19 3616 in ttcol element 42 3617 workgroup element 44 3618 inside front 21 3620 X 3621 xml:lang attribute 3622 in rfc element 33 3623 xml:space attribute 3624 in artwork element 9 3625 in spanx element 37 3626 xref element 44 3627 format attribute 44 3628 inside annotation 6 3629 inside c 12 3630 inside postamble 27 3631 inside preamble 27 3632 inside t 38 3633 pageno attribute 45 3634 target attribute 45 3636 Y 3637 year attribute 3638 in date element 15 3640 Author's Address 3642 Julian F. Reschke 3643 greenbytes GmbH 3644 Hafenweg 16 3645 Muenster, NW 48155 3646 Germany 3648 EMail: julian.reschke@greenbytes.de 3649 URI: http://greenbytes.de/tech/webdav/