MAY"> MUST"> MUST NOT"> OPTIONAL"> RECOMMENDED"> REQUIRED"> SHALL"> SHALL NOT"> SHOULD"> SHOULD NOT"> ]> greenbytes GmbH

Hafenweg 16 MuensterNW48155 Germany julian.reschke@greenbytes.de http://greenbytes.de/tech/webdav/

This document defines the 'XML2RFC' vocabulary; an XML-based (Extensible Markup Language) language used for writing Internet Drafts and RFCs. Discussion of this draft takes place on the XML2RFC mailing list (xml2rfc@ietf.org), which has its home page at .

This document defines the 'XML2RFC' vocabulary; an XML language () used for writing Internet Drafts and RFCs. It obsoletes , which contained the original language definition, and which was subsequently extended.

Need to fill in element and attribute descriptions.

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

one or more <t> elements ()

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

one optional <postal> element () one optional <phone> element () one optional <facsimile> element () one optional <email> element () one optional <uri> element ()

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

In any order: text <xref> elements () <eref> elements () <iref> elements () <cref> elements () <spanx> elements ()

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

text

This element appears as child element of: <figure> ().

(optional) Allowed values: "default" "preserve" (default)

(optional)

(optional)

(optional)

(optional) Allowed values: "left" (default) "center" "right"

(optional)

(optional)

(optional)

text

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

(optional)

(optional)

(optional)

(optional) Allowed values: "editor"

one optional <organization> element () one optional <address> element ()

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

optional <references> elements () optional <section> elements ()

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

In any order: text <xref> elements () <eref> elements () <iref> elements () <cref> elements () <spanx> elements ()

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

text

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

text

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

text

This element appears as child element of: <annotation> (), <c> (), <postamble> (), <preamble> (), and <t> ().

(optional)

(optional)

text

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

(optional)

(optional)

(optional)

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

text

This element appears as child element of: <annotation> (), <c> (), <postamble> (), <preamble> (), and <t> ().

(mandatory)

text

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

text

This element appears as child element of: <section> (), and <t> ().

(optional)

(optional)

(optional) Allowed values: "true" "false" (default)

(optional)

(optional) Allowed values: "left" (default) "center" "right"

(optional)

(optional)

(optional)

optional <iref> elements () one optional <preamble> element () one <artwork> element () one optional <postamble> element ()

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

(optional)

(mandatory)

(optional)

This element appears as child element of: <reference> (), and <rfc> ().

one <title> element () one or more <author> elements () one <date> element () optional <area> elements () optional <workgroup> elements () optional <keyword> elements () one optional <abstract> element () optional <note> elements ()

This element appears as child element of: <annotation> (), <c> (), <figure> (), <postamble> (), <preamble> (), <section> (), and <t> ().

(mandatory)

(optional)

(optional) Allowed values: "true" "false" (default)

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

text

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

(optional)

(optional)

(optional)

one or more <t> elements ()

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

one or more <section> elements ()

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

(mandatory)

one or more <t> elements ()

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

(optional)

text

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

text

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

one or more <street> elements () In any order: <city> elements () <region> elements () <code> elements () <country> elements ()

This element appears as child element of: <figure> (), and <texttable> ().

In any order: text <xref> elements () <eref> elements () <iref> elements () <cref> elements () <spanx> elements ()

This element appears as child element of: <figure> (), and <texttable> ().

In any order: text <xref> elements () <eref> elements () <iref> elements () <cref> elements () <spanx> elements ()

This element appears as child element of: <references> ().

(optional)

(optional)

one <front> element () optional <seriesInfo> elements () optional <format> elements () optional <annotation> elements ()

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

(optional)

one or more <reference> elements ()

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

text

(optional)

(optional)

(optional)

(optional) Allowed values: "std" "bcp" "info" "exp" "historic"

(optional) Allowed values: "no" "yes"

(optional)

(optional) Allowed values: "full2026" "noDerivativeWorks2026" "none" "full3667" "noModification3667" "noDerivatives3667" "full3978" "noModification3978" "noDerivatives3978" "trust200811" "noModificationTrust200811" "noDerivativesTrust200811" "trust200902" "noModificationTrust200902" "noDerivativesTrust200902" "pre5378Trust200902"

(optional)

(optional) Allowed values: "IETF" (default) "IAB" "IRTF" "independent"

(optional)

(optional)

one <front> element () one <middle> element () one optional <back> element ()

This element appears as child element of: <back> (), <middle> (), and <section> ().

(optional)

(mandatory)

(optional) Allowed values: "include" "exclude" "default" (default)

In any order: <t> elements () <figure> elements () <texttable> elements () <iref> elements () optional <section> elements ()

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

(mandatory)

(mandatory)

This element appears as child element of: <annotation> (), <c> (), <postamble> (), <preamble> (), and <t> ().

(optional) Allowed values: "default" "preserve" (default)

(optional)

text

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

text

This element appears as child element of: <abstract> (), <list> (), <note> (), and <section> ().

(optional)

(optional)

In any order: text <list> elements () <figure> elements () <xref> elements () <eref> elements () <iref> elements () <cref> elements () <spanx> elements () <vspace> elements ()

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

(optional)

(optional)

(optional) Allowed values: "true" "false" (default)

(optional) Allowed values: "left" "center" (default) "right"

(optional) Allowed values: "all" "none" "headers" "full" (default)

one optional <preamble> element () one or more <ttcol> elements () optional <c> elements () one optional <postamble> element ()

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

(optional)

text

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

(optional)

(optional) Allowed values: "left" (default) "center" "right"

text

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

text

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

(optional)

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

text

This element appears as child element of: <annotation> (), <c> (), <postamble> (), <preamble> (), and <t> ().

(mandatory)

(optional) Allowed values: "true" "false" (default)

(optional) Allowed values: "counter" "title" "none" "default" (default)

text

Register application/xml2rfc+xml.

We thank Marshall T. Rose for both the original design and the reference implementation of the "xml2rfc" formatter.

Latest version available at .

The <appendix> element has been removed; to generate an appendix, place a <section> inside <back>.

Many attributes have lost their "default" value; this is to avoid having document semantics differ based on whether a DTD was specified and evaluated. Processors will handle absent values the way the default value was specified before.

<artwork>: Has a set of new attributes: "name", "type", "src", "align", "alt", "width", and "height". () <author>: The <organization> element is now optional. The "role" attribute was added. () <date>: All attributes are now optional. () <figure>: Has a set of new attributes: "suppress-title", "src", "align", "alt", "width", and "height". () <iref>: Has a new "primary" attribute. () <list>: The "style" attribute isn't restricted to a set of enumerated values anymore. The "hangIndent" and "counter" attributes have been added. () <rfc>: The "ipr" attribute has gained additional values. The attributes "consensus", "iprExtract", "submissionType", and "xml:lang" have been added. () <reference>: <annotation> allows adding prose to a reference. () <references>: Can now appear multiple times, and carry a "title" attribute (so that normative and informative references can be split). () <section>: The new "toc" attribute controls whether it will appear in the Table Of Contents. <iref> can now appear as direct child element. () <t>: The "anchor" attribute can now be used as well, however there are restrictions on how they can be referred to. ()

The following elements have been added: <annotation> (), <c> (), <cref> (), <format> (), <spanx> (), <texttable> ().

The list below is just a starting point. Allow multiple paragraphs in list items; eliminating the need to use <vspace> (see ). Make the <date> element optional; all of its content is optional already. Deprecate or remove the <format> element; right now it's not used for the generation of the plain text document anyway. Allow <reference>s that identify a document set such as a STD. Allow overriding the "anchor" attribute of an included <reference> element. Add a way to add prose to a reference that avoids abuse of <seriesInfo>. Extend <xref> so that subsection/anchors can be specified (see ). Remove the "pageno" attribute which seems to be both undocumented and non-functional. Extend <figure> to support different types of artwork (such as by specifying certain type attribute values, see ), and also avoid having to markup code (such as ABNF) as "artwork". Also, it would be good if "code components" could be marked as such. Finally, even in preformatted text use of markup could be useful to support (a) references, or (b) highlighting the important bits (). If contact information is changed to allow non-ASCII characters: add a place for a ASCII fallback (probably just for the author names). The content model for <postal> ought to be more strict to allow at most one of <city>, <region>, <code>, and <country>. Cleanup the set of overlapping attributes between <figure> and <artwork>.

With comments being stripped; using "diff -C100" to add change marks:

(from )

<!ENTITY % NUMBER "CDATA"> <!ENTITY % NUMBERS "CDATA"> <!ENTITY % DAY "CDATA"> <!ENTITY % MONTH "CDATA"> <!ENTITY % YEAR "CDATA"> <!ENTITY % URI "CDATA"> <!ENTITY % ATEXT "CDATA"> <!ENTITY % CTEXT "#PCDATA"> <!ENTITY % TEXT "#PCDATA"> <!ELEMENT rfc (front,middle,back?)> <!ATTLIST rfc number %NUMBER; #IMPLIED obsoletes %NUMBERS; '' updates %NUMBERS; '' ! category (std|bcp|info|exp|historic) 'info' seriesNo %NUMBER; #IMPLIED ! ipr (full2026|noDerivativeWorks2026|none) #IMPLIED ! docName %ATEXT; #IMPLIED> <!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,abstract?, note*)> <!ELEMENT title (%CTEXT;)> <!ATTLIST title abbrev %ATEXT; #IMPLIED> ! <!ELEMENT author (organization,address?)> <!ATTLIST author initials %ATEXT; #IMPLIED surname %ATEXT; #IMPLIED ! fullname %ATEXT; #IMPLIED> <!ELEMENT organization (%CTEXT;)> <!ATTLIST organization abbrev %ATEXT; #IMPLIED> <!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)> <!ELEMENT postal (street+,(city|region|code|country)*)> <!ELEMENT street (%CTEXT;)> <!ELEMENT city (%CTEXT;)> <!ELEMENT region (%CTEXT;)> <!ELEMENT code (%CTEXT;)> <!ELEMENT country (%CTEXT;)> <!ELEMENT phone (%CTEXT;)> <!ELEMENT facsimile (%CTEXT;)> <!ELEMENT email (%CTEXT;)> <!ELEMENT uri (%CTEXT;)> <!ELEMENT date EMPTY> <!ATTLIST date day %DAY; #IMPLIED ! month %MONTH; #REQUIRED ! year %YEAR; #REQUIRED> <!ELEMENT area (%CTEXT;)> <!ELEMENT workgroup (%CTEXT;)> <!ELEMENT keyword (%CTEXT;)> <!ELEMENT abstract (t)+> <!ELEMENT note (t)+> <!ATTLIST note title %ATEXT; #REQUIRED> <!ELEMENT middle (section)+> ! <!ELEMENT section (t|figure|section)*> <!ATTLIST section anchor ID #IMPLIED ! title %ATEXT; #REQUIRED> ! <!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|vspace)*> <!ATTLIST t hangText %ATEXT; #IMPLIED> <!ELEMENT list (t)+> <!ATTLIST list ! style (numbers|symbols|hanging|empty) 'empty'> <!ELEMENT xref (%CTEXT;)> <!ATTLIST xref target IDREF #REQUIRED ! pageno (true|false) 'false'> <!ELEMENT eref (%CTEXT;)> <!ATTLIST eref target %URI; #REQUIRED> <!ELEMENT iref EMPTY> <!ATTLIST iref item %ATEXT; #REQUIRED ! subitem %ATEXT; ''> <!ELEMENT vspace EMPTY> <!ATTLIST vspace blankLines %NUMBER; '0'> ! <!ELEMENT figure (preamble?,artwork,postamble?)> <!ATTLIST figure anchor ID #IMPLIED ! title %ATEXT; ''> ! <!ELEMENT preamble (%TEXT;|xref|eref|iref)*> <!ELEMENT artwork (%TEXT;)*> <!ATTLIST artwork ! xml:space (default|preserve) 'preserve'> ! <!ELEMENT postamble (%TEXT;|xref|eref|iref)*> ! <!ELEMENT back (references?,section*)> <!ELEMENT references (reference)+> ! <!ELEMENT reference (front,seriesInfo*)> <!ATTLIST reference anchor ID #IMPLIED target %URI; #IMPLIED> <!ELEMENT seriesInfo EMPTY> <!ATTLIST seriesInfo name %ATEXT; #REQUIRED value %ATEXT; #REQUIRED>

<!ENTITY % NUMBER "CDATA"> <!ENTITY % NUMBERS "CDATA"> <!ENTITY % DAY "CDATA"> <!ENTITY % MONTH "CDATA"> <!ENTITY % YEAR "CDATA"> <!ENTITY % URI "CDATA"> <!ENTITY % ATEXT "CDATA"> <!ENTITY % CTEXT "#PCDATA"> <!ENTITY % TEXT "#PCDATA"> <!ELEMENT rfc (front,middle,back?)> <!ATTLIST rfc number %NUMBER; #IMPLIED obsoletes %NUMBERS; '' updates %NUMBERS; '' ! category (std|bcp|info|exp|historic) #IMPLIED ! consensus (no|yes) #IMPLIED seriesNo %NUMBER; #IMPLIED ! ipr (full2026|noDerivativeWorks2026|none|full3667|noModification3667 ! |noDerivatives3667|full3978|noModification3978|noDerivatives3978 ! |trust200811|noModificationTrust200811|noDerivativesTrust200811 ! |trust200902|noModificationTrust200902|noDerivativesTrust200902 ! |pre5378Trust200902) #IMPLIED ! iprExtract IDREF #IMPLIED ! submissionType (IETF|IAB|IRTF|independent) 'IETF' ! docName %ATEXT; #IMPLIED ! xml:lang %ATEXT; 'en'> <!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,abstract?, note*)> <!ELEMENT title (%CTEXT;)> <!ATTLIST title abbrev %ATEXT; #IMPLIED> ! <!ELEMENT author (organization?,address?)> <!ATTLIST author initials %ATEXT; #IMPLIED surname %ATEXT; #IMPLIED ! fullname %ATEXT; #IMPLIED ! role (editor) #IMPLIED> <!ELEMENT organization (%CTEXT;)> <!ATTLIST organization abbrev %ATEXT; #IMPLIED> <!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)> <!ELEMENT postal (street+,(city|region|code|country)*)> <!ELEMENT street (%CTEXT;)> <!ELEMENT city (%CTEXT;)> <!ELEMENT region (%CTEXT;)> <!ELEMENT code (%CTEXT;)> <!ELEMENT country (%CTEXT;)> <!ELEMENT phone (%CTEXT;)> <!ELEMENT facsimile (%CTEXT;)> <!ELEMENT email (%CTEXT;)> <!ELEMENT uri (%CTEXT;)> <!ELEMENT date EMPTY> <!ATTLIST date day %DAY; #IMPLIED ! month %MONTH; #IMPLIED ! year %YEAR; #IMPLIED> <!ELEMENT area (%CTEXT;)> <!ELEMENT workgroup (%CTEXT;)> <!ELEMENT keyword (%CTEXT;)> <!ELEMENT abstract (t)+> <!ELEMENT note (t)+> <!ATTLIST note title %ATEXT; #REQUIRED> <!ELEMENT middle (section)+> ! <!ELEMENT section ((t|figure|texttable|iref)*,section*)> <!ATTLIST section anchor ID #IMPLIED ! title %ATEXT; #REQUIRED ! toc (include|exclude|default) 'default'> ! <!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|cref|spanx|vspace)*> <!ATTLIST t + anchor ID #IMPLIED hangText %ATEXT; #IMPLIED> <!ELEMENT list (t)+> <!ATTLIST list ! style %ATEXT; #IMPLIED ! hangIndent %NUMBER; #IMPLIED ! counter %ATEXT; #IMPLIED> <!ELEMENT xref (%CTEXT;)> <!ATTLIST xref target IDREF #REQUIRED ! pageno (true|false) 'false' ! format (counter|title|none|default) 'default'> <!ELEMENT eref (%CTEXT;)> <!ATTLIST eref target %URI; #REQUIRED> <!ELEMENT iref EMPTY> <!ATTLIST iref item %ATEXT; #REQUIRED ! subitem %ATEXT; '' ! primary (true|false) 'false'> ! ! <!ELEMENT cref (%CTEXT;)> ! ! <!ATTLIST cref ! anchor ID #IMPLIED ! source %ATEXT; #IMPLIED> ! ! <!ELEMENT spanx (%CTEXT;)> ! ! <!ATTLIST spanx ! xml:space (default|preserve) 'preserve' ! style %ATEXT; 'emph'> <!ELEMENT vspace EMPTY> <!ATTLIST vspace blankLines %NUMBER; '0'> ! <!ELEMENT figure (iref*,preamble?,artwork,postamble?)> <!ATTLIST figure anchor ID #IMPLIED ! title %ATEXT; '' ! suppress-title (true|false) 'false' ! src %URI; #IMPLIED ! align (left|center|right) 'left' ! alt %ATEXT; '' ! width %ATEXT; '' ! height %ATEXT; ''> ! <!ELEMENT preamble (%TEXT;|xref|eref|iref|cref|spanx)*> <!ELEMENT artwork (%TEXT;)*> <!ATTLIST artwork ! xml:space (default|preserve) 'preserve' ! name %ATEXT; '' ! type %ATEXT; '' ! src %URI; #IMPLIED ! align (left|center|right) 'left' ! alt %ATEXT; '' ! width %ATEXT; '' ! height %ATEXT; ''> ! <!ELEMENT postamble (%TEXT;|xref|eref|iref|cref|spanx)*> ! <!ELEMENT texttable (preamble?,ttcol+,c*,postamble?)> ! ! <!ATTLIST texttable ! anchor ID #IMPLIED ! title %ATEXT; '' ! suppress-title (true|false) 'false' ! align (left|center|right) 'center' ! style (all|none|headers|full) 'full'> ! ! <!ELEMENT ttcol (%CTEXT;)> ! ! <!ATTLIST ttcol ! width %ATEXT; #IMPLIED ! align (left|center|right) 'left'> ! ! <!ELEMENT c (%TEXT;|xref|eref|iref|cref|spanx)*> ! ! <!ELEMENT back (references*,section*)> <!ELEMENT references (reference)+> ! <!ATTLIST references ! title %ATEXT; 'References'> ! ! <!ELEMENT reference (front,seriesInfo*,format*,annotation*)> <!ATTLIST reference anchor ID #IMPLIED target %URI; #IMPLIED> <!ELEMENT seriesInfo EMPTY> <!ATTLIST seriesInfo name %ATEXT; #REQUIRED value %ATEXT; #REQUIRED> + + <!ELEMENT format EMPTY> + + <!ATTLIST format + target %URI; #IMPLIED + type %ATEXT; #REQUIRED + octets %NUMBER; #IMPLIED> + + <!ELEMENT annotation (%TEXT;|xref|eref|iref|cref|spanx)*>