Changeset 308 for rfc2629xslt/rfc2629xslt.xml

Timestamp:

10/08/08 14:19:14 (14 years ago)

Author:

julian.reschke@…

Message:

update to latest version of rfc2629.xslt, annotate spec with intended maturity level

File:

• rfc2629xslt/rfc2629xslt.xml (modified) (9 diffs)

rfc2629xslt/rfc2629xslt.xml

@@ -30 +30 @@
         </author>
      
-    <date month="July" year="2008"/>
+    <date month="August" year="2008"/>
     <keyword>RFC2629</keyword>
     <keyword>xml2rfc</keyword>
@@ -55 +55 @@
     <t>outputting HTML (<xref target="output.html"/>) and XHTML (<xref target="output.xhtml"/>),</t>
     <t>outputting CHM (Compiled Microsoft Help, <xref target="output.chm"/>),</t>
-    <t>outputting PDF through XSL-FO (<xref target="output.pdf"/>) and</t>
+    <t>outputting PDF through XSL-FO (<xref target="output.pdf"/>),</t>
+    <t>extensions to the xml2rfc vocabulary (<xref target="extensions"/>).</t>
     <t>various utilities (<xref target="utilities"/>).</t>
   </list>
 </t>
+<t>
+  The full distribution is available at <eref target="http://greenbytes.de/tech/webdav/rfc2629xslt.zip"/>.
+</t>
 </section>
 
@@ -68 +72 @@
 <section title="Extension elements">
 <t>
-  In addition, <spanx style="verb">rfc2629.xslt</spanx> supports a set of extension elements, using elements
-  and attributes in the namespace "http://greenbytes.de/2002/rfcedit". They
-  are used for
-  <list style="symbols">
-    <t>simple issue tracking and change tracking and</t>
-    <t>adding additional metadata to the generated documents (such as HTML LINK
-    elements to related documents, see <xref target="html.link"/>).</t>
-  </list>
-</t>
-<t>
-  Note that these extensions are experimental. Please email the author in case
+  <spanx style="verb">rfc2629.xslt</spanx> supports two kind of extension 
+  elements, using different XML namespaces.
+</t>
+<t>
+  The first set contains (hopefully) generally useful extensions, see
+  <xref target="extensions"/>.
+</t>
+<t>
+  The second set is used for change and issue tracking and currently is not
+  documented here. Please email the author in case
   you're interested in using these extensions.
 </t>
@@ -969 +972 @@
 </section>
 
+<section title="Extensions to Xml2rfc &lt;rfc&gt; element" anchor="ext-rfc2629.rfc">
+<t>
+  The extension attributes below are allowed on the standard &lt;rfc&gt; element:
+  <list style="symbols">
+    <t>grddl:transformation can be used to reference a GRDDL transform.</t>
+    <t>x:maturiy-level can be used to specify the IETF Standards Track
+    Maturity Level of "proposed", "draft" or "internet" (see <xref target="RFC2026" x:fmt="of" x:sec="4.1"/>).</t>
+  </list>
+</t>
+</section>
+
 <section title="Extensions to Xml2rfc &lt;section&gt; element" anchor="ext-rfc2629.section">
 <t>
@@ -1042 +1056 @@
   If the document is supposed to be published on the IETF standards track,
   the desired level can be specified using the parameter <spanx style='verb'>intended-level</spanx>
-  as 'PROPOSED', 'DRAFT' or 'STANDARD'.
+  as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified
+  inside the document using the attribute x:maturity-level on the &lt;rfc> element.
 </t>
 <t>
@@ -1250 +1265 @@
 <references title="Informative References">
 
+<reference anchor='RFC2026'>
+  <front>
+    <title abbrev='Internet Standards Process'>The Internet Standards Process -- Revision 3</title>
+    <author initials='S.' surname='Bradner' fullname='Scott O. Bradner'>
+      <organization>Harvard University</organization>
+      <address>
+        <email>sob@harvard.edu</email>
+      </address>
+    </author>
+    <date year='1996' month='October' />
+  </front>
+  <seriesInfo name='BCP' value='9' />
+  <seriesInfo name='RFC' value='2026' />
+</reference>
+
 <reference anchor="RFC2119">
   <front>
     <title abbrev="RFC Key Words">Key words for use in RFCs to Indicate Requirement Levels</title>
     <author initials="S." surname="Bradner" fullname="Scott Bradner">
-    <organization>Harvard University</organization>
-    <address>
-      <email>sob@harvard.edu</email>
-    </address></author>
+      <organization>Harvard University</organization>
+      <address>
+        <email>sob@harvard.edu</email>
+      </address>
+    </author>
     <date month="March" year="1997"/>
   </front>
@@ -1738 +1769 @@
 <spanx># Extend attribute set for &lt;rfc></spanx>
 attlist.rfc &amp;=
-  attribute grddl:transformation { ATEXT }?
+  attribute grddl:transformation { ATEXT }?,
+  attribute x:maturity-level { "proposed" | "draft" | "internet" }
 
 <spanx># Extend attribute set for &lt;section> (see <xref target="ext-rfc2629.section"/>)</spanx>
@@ -2035 +2067 @@
      Initial release.
 </t>
-<t hangText="2003-11-16">
-     Initial release.
-</t>
 <t hangText="2004-05-11">
      Add document status; print references type.
@@ -2068 +2097 @@
 <t hangText="2008-07-12">
     Add XSLT2-based link target checking.
+</t>
+<t hangText="2008-08-10">
+    Change keywords for "intended-level" to proposed/draft/internet,
+    optionall extract intended level from /rfc/@x:maturity-level attribute.
 </t>
     </list></t>