source: rfc2629xslt/rfc2629xslt.xml @ 308

Last change on this file since 308 was 308, checked in by julian.reschke@…, 11 years ago

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

  • Property svn:eol-style set to native
File size: 103.3 KB
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
3
4<?rfc header="Documentation"?>
5<?rfc private="RFC2629 through XSLT"?>
6<?rfc toc="yes"?>
7<!-- <?rfc topblock="no"?>  -->
8<?rfc strict="yes"?>
9<?rfc symrefs="yes"?>
10<?rfc sortrefs="yes"?>
11<?rfc-ext allow-markup-in-artwork="yes" ?>
12<?rfc-ext include-references-in-index="yes" ?>
13
14<rfc xmlns:x="http://purl.org/net/xml2rfc/ext">
15        <front>
16        <title abbrev="RFC2629 through XSLT">Transforming RFC2629-formatted XML through XSLT</title>
17
18        <author initials="J. F." surname="Reschke" fullname="Julian F. Reschke">
19                <organization abbrev="greenbytes">greenbytes GmbH</organization>
20        <address>
21                <postal>
22                <street>Hafenweg 16</street>
23            <city>Muenster</city><region>NW</region><code>48155</code>
24                <country>Germany</country>
25                </postal>
26                  <phone>+49 251 2807760</phone>       
27                  <email>julian.reschke@greenbytes.de</email>   
28                  <uri>http://greenbytes.de/tech/webdav/</uri> 
29                </address>
30        </author>
31     
32    <date month="August" year="2008"/>
33    <keyword>RFC2629</keyword>
34    <keyword>xml2rfc</keyword>
35    <keyword>XSLT</keyword>
36    <keyword>hCard</keyword>
37    <keyword>XSL-FO</keyword>
38    <keyword>PDF</keyword>
39    <keyword>GRDDL</keyword>
40    <keyword>Dublin Core</keyword>
41        </front>
42
43        <middle>
44
45<section title="Introduction">
46<t>
47  This document describes a set of XSLT transformations that can be used to
48  transform RFC2629-compliant XML (see <xref target="RFC2629"/>) to various
49  output formats, such as HTML and PDF. The main topics are 
50  <list style="symbols">
51    <t>compliance to the xml2rfc XML element set (<xref target="supported.elements"/>),</t>
52    <t>support for xml2rfc processing instructions (<xref target="processing.instructions"/>),</t>
53    <t>the names of anchor elements generated in HTML and PDF output (<xref target="anchors"/>),</t>
54    <t>various XSLT engines that can be used (<xref target="xslt.engines"/>),</t>
55    <t>outputting HTML (<xref target="output.html"/>) and XHTML (<xref target="output.xhtml"/>),</t>
56    <t>outputting CHM (Compiled Microsoft Help, <xref target="output.chm"/>),</t>
57    <t>outputting PDF through XSL-FO (<xref target="output.pdf"/>),</t>
58    <t>extensions to the xml2rfc vocabulary (<xref target="extensions"/>).</t>
59    <t>various utilities (<xref target="utilities"/>).</t>
60  </list>
61</t>
62<t>
63  The full distribution is available at <eref target="http://greenbytes.de/tech/webdav/rfc2629xslt.zip"/>.
64</t>
65</section>
66
67<section title="Supported RFC2629 elements" anchor="supported.elements">
68<t>
69  <spanx style="verb">rfc2629.xslt</spanx> supports both all RFC2629 grammar elements and the extensions
70  implemented in xml2rfc 1.21.
71</t>
72<section title="Extension elements">
73<t>
74  <spanx style="verb">rfc2629.xslt</spanx> supports two kind of extension
75  elements, using different XML namespaces.
76</t>
77<t>
78  The first set contains (hopefully) generally useful extensions, see
79  <xref target="extensions"/>.
80</t>
81<t>
82  The second set is used for change and issue tracking and currently is not
83  documented here. Please email the author in case
84  you're interested in using these extensions.
85</t>
86</section>
87</section>
88
89<section title="Processing Instructions" anchor="processing.instructions">
90<t>
91  All PIs can be set as XSLT parameter as well, overriding any value that
92  is found in the source file to be transformed.
93</t>
94<figure>
95<preamble>Using processing instructions:</preamble>
96<artwork type="example">
97&lt;?rfc toc="yes"?>
98&lt;?rfc-ext support-rfc2731="no"?>
99</artwork>
100</figure>
101<figure>
102<preamble>Using XSLT parameters (Saxon):</preamble>
103<artwork type="example">
104java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \
105  xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html
106</artwork>
107</figure>
108<figure>
109<preamble>Using XSLT parameters (xsltproc):</preamble>
110<artwork type="example">
111xsltproc --param xml2rfc-toc '"yes"' \
112   --param xml2rfc-ext-support-rfc2731 '"no"' \
113   rfc2629.xslt source.xml > result.html
114</artwork>
115<postamble>(note the required quoting of string parameters)<iref item="xsltproc" subitem="passing parameters"/></postamble>
116</figure>
117
118<section title="Supported xml2rfc-compatible PIs">
119<texttable>
120  <ttcol>PI target</ttcol>
121  <ttcol>PI pseudo-attribute</ttcol>
122  <ttcol>XSLT parameter name</ttcol>
123  <ttcol>default</ttcol>
124  <ttcol>comment</ttcol>
125
126  <c>rfc</c>
127  <c>background<iref item="background PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="background"/></c>
128  <c>xml2rfc-background<iref item="xml2rfc-background parameter"/> <iref item="Parameters" subitem="xml2rfc-background"/></c>
129  <c>(not set)</c>
130  <c/>
131 
132  <c>rfc</c>
133  <c>compact<iref item="compact PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="compact"/></c>
134  <c>xml2rfc-compact<iref item="xml2rfc-editing parameter"/> <iref item="Parameters" subitem="xml2rfc-compact"/></c>
135  <c>"no"</c>
136  <c>only applies to HTML output method when printing</c>
137
138  <c>rfc</c>
139  <c>comments<iref item="comments PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="comments"/></c>
140  <c>xml2rfc-comments<iref item="xml2rfc-comments parameter"/> <iref item="Parameters" subitem="xml2rfc-comments"/></c>
141  <c>(not set)</c>
142  <c/>
143
144  <c>rfc</c>
145  <c>editing<iref item="editing PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="editing"/></c>
146  <c>xml2rfc-editing<iref item="xml2rfc-editing parameter"/> <iref item="Parameters" subitem="xml2rfc-editing"/></c>
147  <c>"no"</c>
148  <c/>
149 
150  <c>rfc</c>
151  <c>footer<iref item="footer PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="footer"/></c>
152  <c>xml2rfc-footer<iref item="xml2rfc-footer parameter"/> <iref item="Parameters" subitem="xml2rfc-footer"/></c>
153  <c>(not set)</c>
154  <c/>
155 
156  <c>rfc</c>
157  <c>header<iref item="header PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="header"/></c>
158  <c>xml2rfc-header<iref item="xml2rfc-header parameter"/> <iref item="Parameters" subitem="xml2rfc-header"/></c>
159  <c>(not set)</c>
160  <c/>
161
162  <c>rfc</c>
163  <c>inline<iref item="inline PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="inline"/></c>
164  <c>xml2rfc-inline<iref item="xml2rfc-inline parameter"/> <iref item="Parameters" subitem="xml2rfc-inline"/></c>
165  <c>(not set)</c>
166  <c/>
167
168  <c>rfc</c>
169  <c>iprnotified<iref item="iprnotified PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="iprnotified"/></c>
170  <c>xml2rfc-iprnotified<iref item="xml2rfc-iprnotified parameter"/> <iref item="Parameters" subitem="xml2rfc-iprnotified"/></c>
171  <c>"no"</c>
172  <c/>
173
174  <c>rfc</c>
175  <c>linkmailto<iref item="linkmailto PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="linkmailto"/></c>
176  <c>xml2rfc-linkmailto<iref item="xml2rfc-linkmailto parameter"/> <iref item="Parameters" subitem="xml2rfc-linkmailto"/></c>
177  <c>"yes"</c>
178  <c/>
179 
180  <c>rfc</c>
181  <c>private<iref item="private PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="private"/></c>
182  <c>xml2rfc-private<iref item="xml2rfc-private parameter"/> <iref item="Parameters" subitem="xml2rfc-private"/></c>
183  <c>(not set)</c>
184  <c/>
185 
186  <c>rfc</c>
187  <c>sortrefs<iref item="sortrefs PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="sortrefs"/></c>
188  <c>xml2rfc-sortrefs<iref item="xml2rfc-sortrefs parameter"/> <iref item="Parameters" subitem="xml2rfc-sortrefs"/></c>
189  <c>"no"</c>
190  <c/>
191 
192  <c>rfc</c>
193  <c>symrefs<iref item="symrefs PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="symrefs"/></c>
194  <c>xml2rfc-symrefs<iref item="xml2rfc-symrefs parameter"/> <iref item="Parameters" subitem="xml2rfc-symrefs"/></c>
195  <c>"yes"</c>
196  <c>The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</c>
197 
198  <c>rfc</c>
199  <c>toc<iref item="toc PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="toc"/></c>
200  <c>xml2rfc-toc<iref item="xml2rfc-toc parameter"/> <iref item="Parameters" subitem="xml2rfc-toc"/></c>
201  <c>"no"</c>
202  <c/>
203 
204  <c>rfc</c>
205  <c>tocdepth<iref item="tocdepth PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="tocdepth"/></c>
206  <c>xml2rfc-tocdepth<iref item="xml2rfc-tocdepth parameter"/> <iref item="Parameters" subitem="xml2rfc-tocdepth"/></c>
207  <c>99</c>
208  <c/>
209
210  <c>rfc</c>
211  <c>topblock<iref item="topblock PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="topblock"/></c>
212  <c>xml2rfc-topblock<iref item="xml2rfc-topblock parameter"/> <iref item="Parameters" subitem="xml2rfc-topblock"/></c>
213  <c>"yes"</c>
214  <c/>
215
216</texttable>
217</section>
218
219<section title="Unsupported xml2rfc-compatible PIs">
220<texttable>
221  <ttcol>PI target</ttcol>
222  <ttcol>PI pseudo-attribute</ttcol>
223  <ttcol>comment</ttcol>
224
225  <c>rfc</c>
226  <c>include<iref item="include PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="include"/></c>
227  <c>incompatible with XML/XSLT processing model</c>
228
229  <c>rfc</c>
230  <c>needLines<iref item="needLines PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="needLines"/></c>
231  <c/>
232
233  <c>rfc</c>
234  <c>slides<iref item="slides PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="slides"/></c>
235  <c/>
236
237  <c>rfc</c>
238  <c>strict<iref item="strict PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="strict"/></c>
239  <c/>
240
241  <c>rfc</c>
242  <c>subcompact<iref item="subcompact PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="subcompact"/></c>
243  <c/>
244
245  <c>rfc</c>
246  <c>tocindent<iref item="tocindent PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="tocindent"/></c>
247  <c>(defaults to "yes")</c>
248
249 <c>rfc</c>
250  <c>tocompact<iref item="tocompact PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="tocompact"/></c>
251  <c/>
252
253</texttable>
254</section>
255
256<section title="Extension PIs">
257<texttable>
258  <ttcol>PI target</ttcol>
259  <ttcol>PI pseudo-attribute</ttcol>
260  <ttcol>XSLT parameter name</ttcol>
261  <ttcol>default</ttcol>
262  <ttcol>description</ttcol>
263
264  <c>rfc-ext</c>
265  <c>allow-markup-in-artwork<iref item="allow-markup-in-artwork PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="allow-markup-in-artwork"/></c>
266  <c>xml2rfc-allow-markup-in-artwork<iref item="xml2rfc-ext-allow-markup-in-artwork parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-allow-markup-in-artwork"/></c>
267  <c>"no"</c>
268  <c>Enables support for specific elements inside abstract elements (using this extension
269  makes the document incompatible to the RFC2629bis DTD; see description of
270  conversion XSLT in <xref target="clean-for-dtd"/>).</c>
271
272  <c>rfc-ext</c>
273  <c>authors-section<iref item="authors-section PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="authors-section"/></c>
274  <c>xml2rfc-ext-authors-section<iref item="xml2rfc-ext-authors-section parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-authors-section"/></c>
275  <c></c>
276  <c>When "end", place the authors section at the end (just before the
277  copyright statements). This seems to be the preferred order in the
278  newest RFCs.</c>
279
280  <c>rfc-ext</c>
281  <c>include-references-in-index<iref item="include-references-in-index PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="include-references-in-index"/></c>
282  <c>xml2rfc-ext-include-references-in-index<iref item="xml2rfc-ext-include-references-in-index parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-include-references-in-index"/></c>
283  <c></c>
284  <c>When set to "yes", index entries are generated for all references.</c>
285
286  <c>rfc-ext</c>
287  <c>justification<iref item="justification PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="ijustification"/></c>
288  <c>xml2rfc-ext-justification<iref item="xml2rfc-ext-justification parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-justification"/></c>
289  <c>"never"</c>
290  <c>"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</c>
291
292  <c>rfc-ext</c>
293  <c>parse-xml-in-artwork<iref item="parse-xml-in-artwork PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="parse-xml-in-artwork"/></c>
294  <c>xml2rfc-parse-xml-in-artwork<iref item="xml2rfc-ext-parse-xml-in-artwork parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-parse-xml-in-artwork"/></c>
295  <c>"no"</c>
296  <c>May be used to enable parsing of XML content in figures (MSXML only).</c>
297
298  <c>rfc-ext</c>
299  <c>support-rfc2731<iref item="support-rfc2731 PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="support-rfc2731"/></c>
300  <c>xml2rfc-ext-support-rfc2731<iref item="xml2rfc-ext-support-rfc2731 parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-support-rfc2731"/></c>
301  <c>"yes"</c>
302  <c>Decides whether the HTML transformation should generate META tags according <xref target="rfc2731.properties"/>.</c>
303
304  <c>rfc-ext</c>
305  <c>sec-no-trailing-dots<iref item="sec-no-trailing-dots PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="sec-no-trailing-dots"/></c>
306  <c>xml2rfc-ext-sec-no-trailing-dots<iref item="xml2rfc-ext-sec-no-trailing-dots parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-sec-no-trailing-dots"/></c>
307  <c></c>
308  <c>When set to "yes", add trailing dots to section numbers. This seems to be the preferred format in the
309  newest RFCs.</c>
310
311</texttable>
312</section>
313
314</section>
315
316<section title="Anchors" anchor="anchors">
317<t>
318  The transformation automatically generates anchors that are supposed to
319  be stable and predictable and that can be used to identify specific
320  parts of the document. Anchors are generated both in HTML and XSL-FO
321  content (but the latter will only be used for PDF output when the XSL-FO
322  engine supports producing PDF anchors).
323</t>
324<texttable>
325<preamble>The following anchors get auto-generated:</preamble>
326<ttcol>Anchor name</ttcol><ttcol>Description</ttcol>
327
328  <c>rfc.abstract <iref item="rfc.abstract anchor"/><iref item="Anchors" subitem="rfc.abstract"/></c><c>Abstract</c>
329  <c>rfc.authors <iref item="rfc.authors anchor"/><iref item="Anchors" subitem="rfc.authors"/></c><c>Authors section</c>
330  <c>rfc.copyright <iref item="rfc.copyright anchor"/><iref item="Anchors" subitem="rfc.copyright"/></c><c>Copyright section</c>
331  <c>rfc.copyrightnotice <iref item="rfc.copyrightnotice anchor"/><iref item="Anchors" subitem="rfc.copyrightnotice"/></c><c>Copyright notice</c>
332  <c>rfc.figure.<spanx>n</spanx> <iref item="rfc.figure.n anchor"/><iref item="Anchors" subitem="rfc.figure.n"/></c><c>Figures (titled)</c>
333  <c>rfc.figure.u.<spanx>n</spanx> <iref item="rfc.figure.u.n anchor"/><iref item="Anchors" subitem="rfc.figure.u.n"/></c><c>Figures (untitled)</c>
334  <c>rfc.index <iref item="rfc.index anchor"/><iref item="Anchors" subitem="rfc.index"/></c><c>Index</c>
335  <c>rfc.ipr <iref item="rfc.ipr anchor"/><iref item="Anchors" subitem="rfc.ipr"/></c><c>Intellectual Property</c>
336  <c>rfc.iref.<spanx>n</spanx> <iref item="rfc.iref.n anchor"/><iref item="Anchors" subitem="rfc.iref.n"/></c><c>Internal references</c>
337  <c>rfc.note.<spanx>n</spanx> <iref item="rfc.note.n anchor"/><iref item="Anchors" subitem="rfc.note.n"/></c><c>Notes (from front section)</c>
338  <c>rfc.references <iref item="rfc.references anchor"/><iref item="Anchors" subitem="rfc.references"/></c><c>References</c>
339  <c>rfc.references.<spanx>n</spanx> <iref item="rfc.references.n anchor"/><iref item="Anchors" subitem="rfc.references"/></c><c>Additional references</c>
340  <c>rfc.section.<spanx>n</spanx> <iref item="rfc.section.n anchor"/><iref item="Anchors" subitem="rfc.section.n"/></c><c>Section <spanx>n</spanx></c>
341  <c>rfc.section.<spanx>n</spanx>.p.<spanx>m</spanx> <iref item="rfc.section.n.p.m anchor"/><iref item="Anchors" subitem="rfc.section.n.p.m"/></c><c>Section <spanx>n</spanx>, paragraph <spanx>m</spanx></c>
342  <c>rfc.status <iref item="rfc.status anchor"/><iref item="Anchors" subitem="rfc.status"/></c><c>Status of memo</c>
343  <c>rfc.table.<spanx>n</spanx> <iref item="rfc.figure.n anchor"/><iref item="Anchors" subitem="rfc.figure.n"/></c><c>Tables (titled)</c>
344  <c>rfc.table.u.<spanx>n</spanx> <iref item="rfc.figure.u.n anchor"/><iref item="Anchors" subitem="rfc.figure.u.n"/></c><c>Tables (untitled)</c>
345  <c>rfc.toc <iref item="rfc.toc anchor"/><iref item="Anchors" subitem="rfc.toc"/></c><c>Table of contents</c>
346  <c>rfc.xref.<spanx>name</spanx>.<spanx>n</spanx> <iref item="rfc.xref.name.n anchor"/><iref item="Anchors" subitem="rfc.xref.name.n"/></c><c>References to reference <spanx>n</spanx> to <spanx>name</spanx></c>
347
348</texttable>
349</section>
350
351<section title="Supported XSLT engines" anchor="xslt.engines">
352<t>
353  The transformation requires a non-standard extension function (see <eref target="http://www.exslt.org/exsl/functions/node-set/exsl.node-set.html">
354  exsl:node-set</eref>)
355  which is however widely available. XSLT processors that do not support this
356  extension (or a functional equivalent) currently are not supported.
357</t>
358<section title="Standalone Engines">
359<t>
360  The following XSLT engines are believed to work well:
361  <list style="symbols">
362    <t><iref item="MSXML3"/><iref item="MSXML4"/>MSXML3 and MSXML4 (<eref target="http://msdn.microsoft.com/xml"/>; these processors
363    do not support exsl:node-set(), but have a similar proprietary extension)</t>
364    <t><iref item="Saxon"/>Saxon (<eref target="http://saxon.sourceforge.net/"/>)</t>
365    <t><iref item="Xalan"/>Xalan (<eref target="http://xml.apache.org/xalan-j/"/>)</t>
366    <t><iref item="xsltproc"/>xsltproc (libxslt) (<eref target="http://xmlsoft.org/XSLT/"/>, make sure that you
367    have a current version)</t>
368  </list>
369</t>
370</section>
371
372<section title="In-Browser Engines">
373<t>
374  The following browsers seem to work fine:
375  <list style="symbols">
376    <t><iref item="Internet Explorer 5.5"/>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</t>
377    <t><iref item="Internet Explorer 6"/>Internet Explorer 6</t>
378    <t><iref item="Internet Explorer 7"/>Internet Explorer 7</t>
379    <t anchor="firefox3"><iref item="Mozilla"/><iref item="Firefox" subitem="3.*"/>Firefox 3.* (release candidate available)</t>
380    <t><iref item="Safari"/><iref item="Safari" subitem="3.*"/>Safari 3 (starting with version 3.0.4)</t>
381  </list>
382</t>
383<t>
384  The following browsers are known not to work properly:
385  <list style="symbols">
386    <t anchor="firefox12"><iref item="Mozilla"/><iref item="Firefox" subitem="1.*/2.*"/>Firefox 1.*/2.* (missing extension function - see change request at Mozilla BugZilla
387    <eref target="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</eref>)</t>
388    <t anchor="opera"><iref item="Opera"/>Opera 9.21: execution fails, potentially
389    to a somewhat complex XPath expression (reported to Opera as bug 245725). Opera 9.5:
390    transformation appears to work, but CSS isn't getting applied (repored to Opera as bug 337388 on 2008-06-12).</t>
391    <t anchor="safari"><iref item="Safari"/>Safari 2.* supports client-side XSLT as of MacOS X 10.4,
392    but misses required extension functions. A problem
393    with stylesheets producing non-ASCII output (such as NBSP characters)
394    has been fixed as of OSX 10.4.4. Both
395    problems have been reported through Apple's bug tracking system, see
396    <eref target="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html"/> and
397    <eref target="http://bugs.webkit.org/show_bug.cgi?id=4079"/>.
398    </t>
399  </list>
400</t>
401</section>
402
403</section>
404
405<section title="Transforming to HTML" anchor="output.html">
406<t>
407  Transformation to HTML can be done inside the browser if it supports
408  XSLT. To enable this, add the following processing instruction to
409  the start of the source file:
410</t>
411<iref item="xml-stylesheet PI"/>
412<figure><artwork type="example">
413  &lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
414</artwork></figure>
415<t>
416  (and ensure that <spanx style="verb">rfc2629.xslt</spanx> is present).
417</t>
418
419<section title="HTML compliance">
420<t>
421  The transformation result is supposed to conform to the HTML 4.01 strict
422  DTD <xref target="HTML"/>. This can be checked using the W3C's online
423  validator at <eref target="http://validator.w3.org" /><iref item="HTML compliance"/>.
424</t>
425</section>
426
427<section title="Standard HTML LINK elements" anchor="html.link">
428<t>
429  LINK elements exist since HTML 2.0. They can be used to embed content-independant
430  links inside the document. Unfortunately, only few user agents
431  support this element. Firefox users may want to check the
432  <eref target="https://addons.mozilla.org/firefox/2933/">Link Widgets</eref>
433  extension.
434</t>
435<texttable>
436<preamble>The following LINK elements are produced:</preamble>
437
438  <ttcol>LINK type</ttcol>
439  <ttcol>description</ttcol>
440 
441  <c>alternate<iref item="alternate HTML LINK element"/><iref item="HTML LINK elements" subitem="alternate"/></c><c>for RFCs, a link to the authorative ASCII version on the IETF web site</c>
442  <c>appendic<iref item="appendix HTML LINK element"/><iref item="HTML LINK elements" subitem="appendix"/></c><c>pointer to all top-level appendics</c>
443  <c>author<iref item="author HTML LINK element"/><iref item="HTML LINK elements" subitem="author"/></c><c>pointer to "authors" section</c>
444  <c>chapter<iref item="chapter HTML LINK element"/><iref item="HTML LINK elements" subitem="chapter"/></c><c>pointer to all top-level sections</c>
445  <c>contents<iref item="contents HTML LINK element"/><iref item="HTML LINK elements" subitem="contents"/></c><c>pointer to table of contents</c>
446  <c>copyright<iref item="copyright HTML LINK element"/><iref item="HTML LINK elements" subitem="copyright"/></c><c>pointer to copyright statement</c>
447  <c>index<iref item="index HTML LINK element"/><iref item="HTML LINK elements" subitem="index"/></c><c>pointer to index</c>
448
449</texttable>
450<figure>
451<preamble>
452The figure below shows how Mozilla Firefox 1.0 displays the Site Navigation Bar
453for rfc2396.xml.
454</preamble>
455<artwork src="rfc2629xslt-fig1.png" height="235" width="509" type="image/png">
456(LINK elements displayed in Mozilla Firefox for RFC2396.xml)
457</artwork>
458</figure>
459
460</section>
461
462
463<section title="Standard HTML metadata">
464<texttable>
465<preamble>The following standard HTML META elements are produced:</preamble>
466
467  <ttcol>META name</ttcol>
468  <ttcol>description</ttcol>
469 
470  <c>generator<iref item="generator HTML META element"/><iref item="HTML META elements" subitem="generator"/></c><c>from XSLT engine version and stylesheet version</c>
471  <c>keywords<iref item="keywords HTML META element"/><iref item="HTML META elements" subitem="keywords"/></c><c>from keyword elements in front section</c>
472
473</texttable>
474</section>
475
476
477<section title="Dublin Core (RFC2731) metadata" anchor="rfc2731.properties">
478<t>
479  Unless turned off using the "rfc-ext support-rfc2731" processing
480  instruction, the transformation will generate metadata according to
481  <xref target="RFC2731"/>.
482</t>
483<texttable>
484<preamble>The following DCMI properties are produced:</preamble>
485
486  <ttcol>META name</ttcol>
487  <ttcol>description</ttcol>
488 
489  <c>DC.Creator<iref item="Creator DCMI property"/><iref item="DCMI properties" subitem="Creator"/></c><c>from author information in front section</c>
490  <c>DC.Date.Issued<iref item="Date.Issued DCMI property"/><iref item="DCMI properties" subitem="Date.Issued"/></c><c>from date information in front section</c>
491  <c>DC.Description.Abstract<iref item="Description.Abstract DCMI property"/><iref item="DCMI properties" subitem="Description.Abstract"/></c><c>from abstract</c>
492  <c>DC.Identifier<iref item="Identifier DCMI property"/><iref item="DCMI properties" subitem="Identifier"/></c><c>document URN <xref target="RFC2648" /> from "docName" attribute</c>
493  <c>DC.Relation.Replaces<iref item="Relation.Replaces DCMI property"/><iref item="DCMI properties" subitem="Relation.Replaces"/></c><c>from "obsoletes" attribute</c>
494
495</texttable>
496</section>
497
498<section title="Experimental hCard support" anchor="hcard">
499<t>
500  The generated author information is formatted in <eref target="http://microformats.org/wiki/hcard">hCard</eref>
501  format.
502</t>
503</section>
504
505
506</section>
507
508<section title="Transforming to XHTML" anchor="output.xhtml">
509<t>
510  Transforming to XHTML requires slightly different XSLT output options and
511  is implemented by the derived transformation script <spanx style="verb">rfc2629toXHTML.xslt</spanx>.
512</t>
513<t><list><t>
514  <x:h>Note:</x:h> Microsoft Internet Explorer does <spanx>not</spanx> support XHTML.
515  Therefore it usually makes more sense to generate plain old HTML.
516</t></list></t>
517</section>
518
519<section title="Transforming to CHM (Microsoft Compiled Help)" anchor="output.chm">
520<t>
521  <iref item="CHM format"/>
522  <iref item="Microsoft Help"/>
523  To generate a CHM file using Microsoft's HTML Help Compiler (hhc), three
524  files are required in addition to the HTML file.
525  <list style="numbers">
526    <t>hhc - table of contents file (HTML)</t>
527    <t>hhk - index file (HTML)</t>
528    <t>hhp - project file (plain text)</t>
529  </list> 
530</t>
531<t>
532  The three files are generated with three specific transformations, each
533  requiring the additional XSLT parameter "basename" to specify the filename
534  prefix.
535</t>
536<figure>
537<preamble>Example:</preamble>
538<artwork type="example">
539saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616  > rfc2616.hhp
540saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616  > rfc2616.hhc
541saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616  > rfc2616.hhk
542hhc rfc2616.hhp
543</artwork>
544</figure>
545</section>
546
547<section title="Transforming to PDF via XSL-FO" anchor="output.pdf">
548
549<section title="Via XSL-FO" anchor="output.pdf.fop">
550<t>
551  Transformation to XSL-FO <xref target="XSL-FO"/> format is available through
552  <spanx style="verb">rfc2629toFO.xslt</spanx> (which includes <spanx style="verb">rfc2629.xslt</spanx>, so keep both in the
553  same folder).
554</t>
555<t>
556  Compared to HTML user agents, XSL-FO engines unfortunately either come
557  as open source (for instance, <iref item="Apache FOP"/>Apache FOP) or
558  feature-complete (for instance, <iref item="AntennaHouse XSL Formatter"/>
559  AntennaHouse XSL Formatter), but not both at the same time.
560</t>
561<t>
562  As Apache FOP needs special workarounds (page breaking, table layout), and
563  some popular extensions aren't standardized yet, the translation produces
564  a generic output (hopefully) conforming to <xref target="XSL-FO"/>.
565  Specific backends (<spanx style="verb">xsl11toFop.xslt</spanx>,
566  <spanx style="verb">xsl11toXep.xslt</spanx>, <spanx style="verb">xsl11toAn.xslt</spanx>)
567  then provide post-processing for the individual processors.
568</t>
569<t>
570  <list>
571    <t>
572      <x:h>Note:</x:h>
573      the output is currently targeted at Apache FOP 0.20.5
574      (<eref target="http://xmlgraphics.apache.org/fop/0.20.5/"/>), not the
575      newer versions.
576    </t>
577  </list>
578</t>
579
580<section title="Extension feature matrix">
581<texttable>
582  <ttcol/>
583  <ttcol align="center" width="20%">PDF anchors</ttcol>
584  <ttcol align="center" width="20%">PDF bookmarks</ttcol>
585  <ttcol align="center" width="20%">PDF document information</ttcol>
586  <ttcol align="center" width="20%">Index cleanup</ttcol>
587 
588  <c><eref target="http://www.w3.org/TR/2003/WD-xsl11-20031217/">XSL 1.1 WD</eref></c>
589  <c>no, but can be auto-generated from "id" attributes</c> 
590  <c><eref target="http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e12873">yes</eref></c>
591  <c>no, but uses XEP output extensions</c>
592  <c><eref target="http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e12534">yes</eref></c>
593
594  <c><eref target="http://www.antennahouse.com/">Antenna House XSL formatter</eref></c>
595  <c>no</c>
596  <c><eref target="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</eref> (from XSL 1.1 bookmarks)</c>
597  <c><eref target="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</eref> (from XEP document info)</c>
598  <c><eref target="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</eref> (just page duplicate elimination, from XSL 1.1 page index)</c>
599
600  <c><eref target="http://xml.apache.org/fop/">Apache FOP</eref></c>
601  <c><eref target="http://xml.apache.org/fop/extensions.html#named-destinations">yes</eref></c>
602  <c><eref target="http://xml.apache.org/fop/extensions.html#bookmarks">yes</eref> (from XSL 1.1 bookmarks)</c>
603  <c>no</c>
604  <c>no</c>
605
606  <c><eref target="http://xep.xattic.com/">RenderX XEP</eref></c>
607  <c>no</c>
608  <c><eref target="http://xep.xattic.com/xep/spec.html">yes</eref> (from XSL 1.1 bookmarks)</c>
609  <c><eref target="http://xep.xattic.com/xep/spec.html">yes</eref></c>
610  <c><eref target="http://xep.xattic.com/xep/spec.html">yes</eref> (from XSL 1.1 page index)</c>
611
612</texttable>
613</section>
614
615<section title="Example: producing output for Apache FOP">
616<figure>
617<preamble>Example:</preamble>
618<artwork type="example">
619saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo
620saxon tmp.fo xsl11toFop.xslt > rfc2629.fo
621</artwork>
622</figure>
623</section>
624</section>
625
626<section title="Via X(HTML)" anchor="output.pdf.html">
627<t>
628  PDF output can also be produced directly from (X)HTML. One simple approach
629  is to rely on the browser's printing function, and to use a printer driver
630  that produces PDF. Depending on the brower's CSS capabilities, the output
631  will behave properly with respect to table breaks etc.
632</t>
633<t>
634  An alternative is PrinceXML (see <eref target="http://www.princexml.com/"/>),
635  which can produce PDF directly from (X)HTML input, based on the CSS printing
636  information.
637</t>
638<figure>
639  <preamble>
640    For instance, PDF output with text justification turned on can be
641    produced with:
642  </preamble>
643  <artwork type="example">
644saxon input.xml rfc2629toXHTML.xslt xml2rfc-ext-justification=print \
645  > output.xhtml
646prince output.xhtml output.pdf</artwork>
647</figure>
648</section>
649
650</section>
651
652<section title="Generic Extensions" anchor="extensions">
653<t>
654  This section documents extensions implemented in
655  <spanx style="verb">rfc2629.xslt</spanx>, using the extension
656  namespace "http://purl.org/net/xml2rfc/ext".
657</t>
658
659<section title="&lt;abnf-char-sequence> element" anchor="ext.element.abnf-char-sequence">
660  <iref item="Extension Elements" subitem="abnf-char-sequence" primary="true"/>
661  <iref item="abnf-char-sequence Extension Element" primary="true"/>
662  <x:anchor-alias value="abnf-char-sequence"/>
663  <t>
664    Converts the contained quoted string into a hex-encoded character
665    sequence, for use in case-sensitive ABNF productions.
666  </t>
667  <t>
668    For instance, "&lt;x:abnf-char-sequence>"HTTP"&lt;/x:abnf-char-sequence>"
669    gets converted to "<x:abnf-char-sequence>"HTTP"</x:abnf-char-sequence>".
670  </t>
671</section>
672
673<section title="&lt;anchor-alias> element" anchor="ext.element.anchor-alias">
674  <iref item="Extension Elements" subitem="anchor-alias" primary="true"/>
675  <iref item="anchor-alias Extension Element" primary="true"/>
676  <x:anchor-alias value="anchor-alias"/>
677  <t>
678    Using its "value" attribute, this element allows the definition of an
679    internal link target alias for the enclosing element. This alias can
680    then be used with the &lt;<x:ref>ref</x:ref>> element for intra-document
681    references.
682  </t>
683  <t>
684    Note that the anchor alias is not subject to the naming constraints that
685    apply to anchor elements (which are <eref target="http://www.w3.org/TR/REC-xml/#NT-Name">XML
686    names</eref>).
687  </t>
688</section>
689
690<section title="&lt;bcp14> element" anchor="ext.element.bcp14">
691  <iref item="Extension Elements" subitem="bcp14" primary="true"/>
692  <iref item="bcp14 Extension Element" primary="true"/>
693  <x:anchor-alias value="bcp14"/>
694  <t>
695    This element marks the content as being one of the normative keywords
696    defined in <xref target="RFC2119"/>.
697  </t>
698  <figure>
699    <preamble>
700      The DOCTYPE definition below allows using these keywords using XML
701      entity expansion: such as in "...server &amp;MUST; accept...".
702    </preamble>
703    <artwork type="example">
704&lt;!DOCTYPE rfc [
705 &lt;!ENTITY MAY "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
706   >MAY&lt;/bcp14>">
707 &lt;!ENTITY MUST "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
708   >MUST&lt;/bcp14>">
709 &lt;!ENTITY MUST-NOT "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
710   >MUST NOT&lt;/bcp14>">
711 &lt;!ENTITY OPTIONAL "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
712   >OPTIONAL&lt;/bcp14>">
713 &lt;!ENTITY RECOMMENDED "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
714   >RECOMMENDED&lt;/bcp14>">
715 &lt;!ENTITY REQUIRED "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
716   >REQUIRED&lt;/bcp14>">
717 &lt;!ENTITY SHALL "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
718   >SHALL&lt;/bcp14>">
719 &lt;!ENTITY SHALL-NOT "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
720   >SHALL NOT&lt;/bcp14>">
721 &lt;!ENTITY SHOULD "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
722   >SHOULD&lt;/bcp14>">
723 &lt;!ENTITY SHOULD-NOT "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
724   >SHOULD NOT&lt;/bcp14>">]></artwork>
725  </figure>
726</section>
727
728<section title="&lt;bb> element" anchor="ext.element.bb">
729  <iref item="Extension Elements" subitem="bb" primary="true"/>
730  <iref item="bb Extension Element" primary="true"/>
731  <x:anchor-alias value="bb"/>
732  <t>
733    Marking up a string as &lt;bb> indicates that it represents the bottom
734    line of a box drawing, replacing the "+" and "-" characters accordingly.
735  </t>
736</section>
737
738<section title="&lt;bc> element" anchor="ext.element.bc">
739  <iref item="Extension Elements" subitem="bc" primary="true"/>
740  <iref item="bc Extension Element" primary="true"/>
741  <x:anchor-alias value="bc"/>
742  <t>
743    Marking up a string as &lt;bc> indicates that it represents a center
744    line of a box drawing, replacing the "|" character accordingly.
745  </t>
746</section>
747
748<section title="&lt;blockquote> element" anchor="ext.element.blockquote">
749  <iref item="Extension Elements" subitem="blockquote" primary="true"/>
750  <iref item="blockquote Extension Element" primary="true"/>
751  <x:anchor-alias value="blockquote"/>
752  <t>
753    This element is like the "<eref target="http://www.w3.org/TR/html401/struct/text.html#edef-BLOCKQUOTE">blockquote</eref>" element in <xref target="HTML"/> 
754    (note this is a block-level element!). It should contain one or more
755    &lt;t> child elements.
756  </t>
757</section>
758
759<section title="&lt;bt> element" anchor="ext.element.bt">
760  <iref item="Extension Elements" subitem="bt" primary="true"/>
761  <iref item="bt Extension Element" primary="true"/>
762  <x:anchor-alias value="bt"/>
763  <t>
764    Marking up a string as &lt;bt> indicates that it represents the top
765    line of a box drawing, replacing the "+" and "-" characters accordingly.
766  </t>
767</section>
768
769<section title="&lt;dfn> element" anchor="ext.element.dfn">
770  <iref item="Extension Elements" subitem="dfn" primary="true"/>
771  <iref item="dfn Extension Element" primary="true"/>
772  <x:anchor-alias value="dfn"/>
773  <t>
774    This element is like the "<eref target="http://www.w3.org/TR/html401/struct/text.html#edef-DFN">dfn</eref>" element in <xref target="HTML"/>.
775  </t>
776</section>
777
778<section title="&lt;h> element" anchor="ext.element.h">
779  <iref item="Extension Elements" subitem="h" primary="true"/>
780  <iref item="h Extension Element" primary="true"/>
781  <x:anchor-alias value="h"/>
782  <t>
783    This element is like the "<eref target="http://www.w3.org/TR/2006/WD-xhtml2-20060726/mod-structural.html#edef_structural_h">h</eref>" element in <xref target="XHTML2"/>.
784  </t>
785</section>
786
787<section title="&lt;length-of> element" anchor="ext.element.length-of">
788  <iref item="Extension Elements" subitem="length-of" primary="true"/>
789  <iref item="length-of Extension Element" primary="true"/>
790  <x:anchor-alias value="length-of"/>
791  <t>
792    This element can be used to insert the length of another formatted
793    section (in decimal).
794  </t>
795  <figure>
796    <preamble>Example: computing the Content-Length header value</preamble>
797    <artwork type="example">
798&lt;artwork>
799...
800Content-Length: &lt;x:length-of target="req"/>
801 
802&lt;x:span anchor="req">123456789
803&lt;x:span>&lt;artwork/>
804</artwork>
805  </figure>
806  <t>
807    The lenght computation counts line ends as two characters (CRLF).
808  </t>
809  <t>
810    Note that indentation characters in artwork <spanx>will</spanx> be
811    counted. The "indented" attribute allows to specify the amount of
812    indentation to be substracted from the computed length.
813  </t>
814</section>
815
816<section title="&lt;link> element" anchor="ext.element.link">
817  <iref item="Extension Elements" subitem="link" primary="true"/>
818  <iref item="link Extension Element" primary="true"/>
819  <x:anchor-alias value="link"/>
820  <t>
821    This element can be added as a top-level child element below
822    &lt;rfc> to indicate additional link information. It's currently
823    used only when generating HTML output, in which case an HTML
824    <eref target="http://www.w3.org/TR/html4/struct/links.html#edef-LINK">&lt;link></eref> element with identical attributes gets generated.
825  </t>
826  <figure>
827    <preamble>Example: generating HTML link element</preamble>
828    <artwork type="example">
829        &lt;x:link xmlns="http://purl.org/net/xml2rfc/ext"
830            rel="Bookmark"
831            title="IETF WEBDAV Working Group"
832            href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/></artwork>
833  </figure>
834</section>
835
836<section title="&lt;lt> element" anchor="ext.element.lt">
837  <iref item="Extension Elements" subitem="lt" primary="true"/>
838  <iref item="lt Extension Element" primary="true"/>
839  <x:anchor-alias value="lt"/>
840  <t>
841    Used for grouping multiple &lt;t&gt; elements into a single list item.
842  </t>
843</section>
844
845<section title="&lt;parse-xml> element" anchor="ext.element.parse-xml">
846  <iref item="Extension Elements" subitem="parse-xml" primary="true"/>
847  <iref item="parse-xml Extension Element" primary="true"/>
848  <x:anchor-alias value="parse-xml"/>
849  <t>
850    This element instructs the processor to parse the contents as XML and
851    to warn when there's a problem (requires either MSXML or Saxon8 or newer).
852  </t>
853</section>
854
855<section title="&lt;q> element" anchor="ext.element.q">
856  <iref item="Extension Elements" subitem="q" primary="true"/>
857  <iref item="q Extension Element" primary="true"/>
858  <x:anchor-alias value="q"/>
859  <t>
860    This element is like the "<eref target="http://www.w3.org/TR/html401/struct/text.html#edef-Q">q</eref>" element in <xref target="HTML"/>.
861  </t>
862</section>
863
864<section title="&lt;ref> element" anchor="ext.element.ref">
865  <iref item="Extension Elements" subitem="ref" primary="true"/>
866  <iref item="ref Extension Element" primary="true"/>
867  <x:anchor-alias value="ref"/>
868  <t>
869    This element is a simplified variant of the &lt;xref> element, in that
870    no "target" attribute needs to be specified, instead the text contents
871    acts as identifier.  That in itself wouldn't be terribly useful,
872    but together with the &lt;<x:ref>anchor-alias</x:ref>>, it allows
873    referring to other parts of the document with minimal additional markup.
874  </t>
875  <t>
876    For instance, given an alias definition such as
877  </t>
878  <figure>
879    <artwork type="example">
880      &lt;section title="Test" anchor="test">
881        &lt;x:anchor-alias value="alias1"/>
882        &lt;x:anchor-alias value="alias 2"/>
883        ...
884      &lt;/section></artwork>
885  </figure>
886  <t>
887    the following simple references
888  </t>
889  <figure>
890    <artwork type="example">
891      &lt;x:ref>test&lt;/x:ref>
892      &lt;x:ref>alias1&lt;/x:ref>
893      &lt;x:ref>alias 2&lt;/x:ref></artwork>
894  </figure>
895  <t>
896    are equivalent to...:
897  </t>
898  <figure>
899    <artwork type="example">
900      &lt;xref target="test">test&lt;/xref>
901      &lt;xref target="test">alias1&lt;/xref>
902      &lt;xref target="test">alias 2&lt;/xref></artwork>
903  </figure>
904</section>
905
906<section title="&lt;source> element" anchor="ext.element.source">
907  <iref item="Extension Elements" subitem="source" primary="true"/>
908  <iref item="source Extension Element" primary="true"/>
909  <x:anchor-alias value="source"/>
910  <t>
911    Can be used to enhance a &lt;reference> with information about the
912    location for the XML source. This can be used by the &lt;xref>
913    processing code to automatically extract the target section number.
914  </t>
915  <figure>
916    <preamble>
917      For example:
918    </preamble>
919    <artwork type="example">
920      ...
921      &lt;xref target="RFC2616" x:fmt="of" x:rel="#PUT" />
922      ...
923   
924      &lt;reference target="RFC2616"/>
925        ...
926        &lt;x:source href="rfc2616.xml"/>
927        ...
928    </artwork>
929  </figure>
930</section>
931
932<section title="&lt;sup> element" anchor="ext.element.sup">
933  <iref item="Extension Elements" subitem="sup" primary="true"/>
934  <iref item="sup Extension Element" primary="true"/>
935  <x:anchor-alias value="sup"/>
936  <t>
937    This element is like the "<eref target="http://www.w3.org/TR/html401/struct/text.html#edef-SUP">sup</eref>" element in <xref target="HTML"/>.
938  </t>
939  <t>
940    Note: the down conversion to RFC2629 format replaces
941    "x<x:sup>y</x:sup>" by "x^y".
942  </t>
943</section>
944
945<section title="Extensions to Xml2rfc &lt;iref&gt; element" anchor="ext-rfc2629.iref">
946<t>
947  The extension attribute below is allowed on the standard &lt;iref&gt; element:
948  <list style="symbols">
949    <t>x:for-anchor specifies that the &lt;iref&gt; will also be automatically
950    inserted whenever the specified anchor is cross-referenced -- this may
951    save entering lots of &lt;iref&gt; instances. As a special case, a value of
952    "" (empty string) refers to the anchor attribute of the closest ancestor.</t>
953  </list>
954</t>
955</section>
956
957<section title="Extensions to Xml2rfc &lt;list&gt; element" anchor="ext-rfc2629.list">
958<t>
959  The extension attribute below is allowed on the standard &lt;list&gt; element:
960  <list style="symbols">
961    <t>x:indent specifies the amount of indentation for list items in hanging
962    lists. This can be useful when the output format, such as XSL-FO, does not
963    support automatical formatting. The value takes an XSL-FO width, such as "5em".
964    The default is <spanx>length of longest label in characters</spanx> times
965    <spanx>0.8em</spanx>.</t>
966  </list>
967</t>
968<t>
969  Also, the &lt;list&gt; element can take &lt;x:<x:ref>lt</x:ref>&gt; child elements instead of
970  &lt;t&gt;, allowing to insert multiple paragraphs into a single list item.
971</t>
972</section>
973
974<section title="Extensions to Xml2rfc &lt;rfc&gt; element" anchor="ext-rfc2629.rfc">
975<t>
976  The extension attributes below are allowed on the standard &lt;rfc&gt; element:
977  <list style="symbols">
978    <t>grddl:transformation can be used to reference a GRDDL transform.</t>
979    <t>x:maturiy-level can be used to specify the IETF Standards Track
980    Maturity Level of "proposed", "draft" or "internet" (see <xref target="RFC2026" x:fmt="of" x:sec="4.1"/>).</t>
981  </list>
982</t>
983</section>
984
985<section title="Extensions to Xml2rfc &lt;section&gt; element" anchor="ext-rfc2629.section">
986<t>
987  The extension attribute below is allowed on the standard &lt;list&gt; element:
988  <list style="symbols">
989    <t>x:fixed-section-number can be used to specify a fixed section number.
990    This can be useful when formatting historic documents that used a different
991    numbering style.</t>
992  </list>
993</t>
994</section>
995
996<section title="Extensions to Xml2rfc &lt;xref&gt; element" anchor="ext-rfc2629.xref">
997<t>
998  Three extension attributes are allowed on the standard &lt;xref&gt; element:
999  <list style="numbers">
1000    <t>x:sec can be specified to point to a specific section of the referenced document,</t>
1001    <t>x:rel may specify a relative reference to use when linking into the referenced document (if linking by section number is not available),</t>
1002    <t>x:fmt defines the text format to be used.</t>
1003  </list>
1004</t>
1005<t>
1006  The following formats are defined for the x:fmt attribute:
1007  <list style="hanging">
1008    <t hangText=", (Comma)">
1009      [<spanx>reference</spanx>], Section <spanx>sec</spanx>
1010    </t>
1011    <t hangText="()">
1012      [<spanx>reference</spanx>] (Section <spanx>sec</spanx>)
1013    </t>
1014    <t hangText="anchor">
1015      Like the default format, but without brackets.
1016    </t>
1017    <t hangText="of">
1018      Section <spanx>sec</spanx> of [<spanx>reference</spanx>]
1019    </t>
1020    <t hangText="number">
1021      <spanx>sec</spanx>
1022    </t>
1023    <t hangText="none">
1024      No output (can be used to have xrefs to references without
1025      having them rendered as such)
1026    </t>
1027    <t hangText="sec">
1028      Section <spanx>sec</spanx>
1029    </t>
1030  </list>
1031</t>
1032<t>
1033  These extensions are currently only supported for &lt;xref&gt; elements without
1034  child nodes.
1035</t>
1036<t>
1037  If the processor knows how to reference the target section, it will generate
1038  a link directly to the target section, such as in <xref target="RFC2119" x:fmt="," x:sec="5"/>.
1039</t>
1040</section>
1041
1042</section>
1043
1044<section title="Utilities" anchor="utilities">
1045
1046<section title="Checking References" anchor="checking-references">
1047<t>
1048  <spanx style="verb">check-references.xslt</spanx> can be used to check
1049  all references to RFC- and ID-series IETF publications and to W3C publications (note
1050  this script requires local copies of
1051  <eref target="ftp://ftp.isi.edu/in-notes/rfc-index.xml"/> and
1052  <eref target="http://www.w3.org/2002/01/tr-automation/tr.rdf"/> and
1053  will use the XML status information provided at <eref target="http://tools.ietf.org/"/>).
1054</t>
1055<t>
1056  If the document is supposed to be published on the IETF standards track,
1057  the desired level can be specified using the parameter <spanx style='verb'>intended-level</spanx>
1058  as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified
1059  inside the document using the attribute x:maturity-level on the &lt;rfc> element.
1060</t>
1061<t>
1062  <x:h>Note:</x:h> Downward references should be
1063  annotated using the &lt;annotate> element, containing an &lt;xref> to
1064  <xref target="BCP97"/>.
1065</t>
1066<t>
1067  When an XSLT 2.0 processor is used, links in the document can be checked as well
1068  using the <spanx style='verb'>link-check</spanx> paramerer ('yes' or 'no').
1069  Note that this only works for http links to documents of tytpe text/*.
1070</t>
1071<figure>
1072<preamble>
1073For instance, as of 2008-07-12, the script produces for <eref target="http://greenbytes.de/tech/webdav/rfc2518.xml"/>:
1074</preamble>
1075<artwork type="example">
1076> saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \
1077  link-check=yes
1078
1079Normative References:
1080ISO-11578: not checked
1081ISO-639: not checked
1082ISO-8601: not checked
1083REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006
1084REC-xml-names-19990114: [FirstEdition] obsoleted by
1085 REC-xml-names-20060816
1086RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282
1087RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616
1088RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617
1089RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok
1090RFC2141: [PROPOSED STANDARD] ok
1091RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok
1092RFC2396: [DRAFT STANDARD] obsoleted by RFC3986
1093RFC2279: [DRAFT STANDARD] obsoleted by RFC3629
1094
1095Informational References:
1096REC-PICS-labels-961031: [REC] ok
1097RFC1807: [INFORMATIONAL] ok
1098RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok
1099RFC2291: [INFORMATIONAL] ok
1100RFC2376: [INFORMATIONAL] obsoleted by RFC3023
1101RFC2413: [INFORMATIONAL] obsoleted by RFC5013
1102USMARC: not checked
1103WF: not checked
1104
1105Link Targets
1106&lt;http://www.w3.org/TR/1998/REC-xml-19980210>: ok
1107&lt;http://www.w3.org/TR/1999/REC-xml-names-19990114>: ok
1108&lt;http://www.dlib.org/dlib/july96/lagoze/07lagoze.html>: ok
1109&lt;http://www.w3.org/pub/WWW/TR/REC-PICS-labels-961031.html>: ok
1110</artwork></figure>
1111<t>
1112  Recognized formats in the &lt;seriesInfo> element are:
1113  <list style="symbols">
1114    <t>for RFCs, the name attribute must be "RFC", and the value attribute must
1115    be the number of the RFC,</t>
1116    <t>for Internet Drafs, the name attribute must be "ID" or "Internet-Draft", and the value attribute must
1117    be the file name of the draft (including the two-digit running number, but excluding a file extension),</t>
1118    <t>for W3C documents, the name attribute must be "W3C", must start with "W3C&#160;", or
1119    must start with "World Wide Web Consortium&#160;", and the value attribute
1120    must be the "shorthand" name of the specification, such as "REC-xml-19980210".</t>
1121  </list>
1122</t>
1123
1124</section>
1125
1126<section title="Generating Graphs from References">
1127<t>
1128  <spanx style="verb">gen-reference-graph.xslt</spanx> generates a graph
1129  of RFC dependencies, using the same base data as in <spanx style="verb">check-references.xslt</spanx>
1130  (see <xref target="checking-references"/>). Its output is a "dot" file,
1131  to be processed by GraphViz (see <eref target="http://www.graphviz.org/"/>).
1132</t>
1133<figure>
1134<preamble>
1135The picture below shows the RFC dependencies in RFC2629.
1136</preamble>
1137<artwork src="rfc2629xslt-fig2.png" type="image/png">
1138(PNG output obtained from GraphViz)
1139</artwork>
1140</figure>
1141</section>
1142
1143<section title="Producing reference entries for books">
1144<t>
1145  <spanx style="verb">amazon-asin.xslt</spanx> uses the Amazon web services
1146  to generate a &lt;reference> element for a given ASIN (ISBN).
1147</t>
1148<figure>
1149<preamble>For instance:</preamble>
1150<artwork type="example">
1151&lt;?xml version="1.0" encoding="utf-8"?>
1152&lt;references>
1153 &lt;reference target="urn:isbn:0134516591">
1154   &lt;front>
1155     &lt;title>Simple Book, The: An Introduction to Internet Management,
1156               Revised Second Edition&lt;/title>
1157     &lt;author surname="Rose"
1158                fullname="Marshall T. Rose" initials="M. T. ">
1159       &lt;organization/>
1160     &lt;/author>
1161     &lt;author surname="Marshall"
1162                fullname="Rose T. Marshall" initials="R. T.">
1163       &lt;organization/>
1164     &lt;/author>
1165     &lt;date year="1996" month="March"/>
1166   &lt;/front>
1167   &lt;seriesInfo name="Prentice Hall" value=""/>
1168 &lt;/reference>
1169&lt;/references>
1170</artwork></figure>
1171<t>
1172  Note that the resulting XML usually requires checking, in this case Amazon's
1173  database is playing tricks with Marshall's name...
1174</t>
1175</section>
1176
1177<section title="Down-converting to RFC2629bis DTD" anchor="clean-for-dtd">
1178<t>
1179  <spanx style="verb">clean-for-DTD.xslt</spanx> can be used to down-convert
1180  some extensions to a format that is supported by the base xml2rfc
1181  distribution.  Note that these extensions are experimental (feedback
1182  appreciated).
1183</t>
1184<t>
1185  The following mappings are done:
1186  <list style="symbols">
1187    <t>
1188      &lt;iref> elements inside &lt;artwork> elements are moved in front
1189      of the enclosing &lt;figure> element.
1190    </t>
1191    <t>
1192      &lt;xref> elements inside &lt;artwork> are expanded just like in
1193      regular text (that is, the markup is stripped, but the element
1194      is replaced by the applicable replacement text).
1195    </t>
1196    <t>
1197      &lt;x:<x:ref>anchor-alias</x:ref>> elements get stripped.
1198    </t>
1199    <t>
1200      &lt;x:<x:ref>bcp14</x:ref>> elements get stripped.
1201    </t>
1202    <t>
1203      &lt;x:<x:ref>bb</x:ref>>, &lt;x:<x:ref>bc</x:ref>> and &lt;x:<x:ref>bt</x:ref>> elements get stripped.
1204    </t>
1205    <t>
1206      &lt;x:<x:ref>blockquote</x:ref>> elements get converted to
1207      indented text (through a &lt;list> element).
1208    </t>
1209    <t>
1210      &lt;x:<x:ref>dfn</x:ref>> elements get stripped.
1211    </t>
1212    <t>
1213      &lt;x:<x:ref>h</x:ref>> elements get stripped.
1214    </t>
1215    <t>
1216      &lt;x:<x:ref>link</x:ref>> elements get stripped.
1217    </t>
1218    <t>
1219      &lt;x:<x:ref>q</x:ref>> elements get stripped, with apostrophes
1220      added around the text.
1221    </t>
1222    <t>
1223      &lt;x:<x:ref>ref</x:ref>> elements get replaced by &lt;xref>
1224      elements, targetting either the anchor or another anchor with
1225      matching &lt;x:<x:ref>anchor-alias</x:ref>> child element.
1226    </t>
1227  </list>
1228</t>
1229</section>
1230
1231<section title="Extracting artwork" anchor="extract-artwork">
1232<t>
1233  With <spanx style="verb">extract-artwork.xslt</spanx>, artwork elements
1234  named through the "name" attribute can be extracted. This can be used
1235  to automatically check their syntax (for instance, when ABNFs appear
1236  within a figure element).
1237</t>
1238<figure><preamble>For instance:</preamble>
1239<artwork type="example">saxon rfc3986.xml extract-artwork.xslt name=uri.abnf
1240</artwork>
1241</figure>
1242<t>
1243  In addition, artwork of a specific type can be extracted, such as with:
1244</t>
1245<figure>
1246<artwork type="example">saxon rfc3986.xml extract-artwork.xslt type=abnf
1247</artwork>
1248</figure>
1249</section>
1250
1251<section title="GRRDL" anchor="grddl">
1252<t>
1253  <spanx style="verb">rfc2629grddl.xslt</spanx> extracts RDF
1254  information. This is experimental work-in-progress. See
1255  <eref target="http://www.w3.org/TR/grddl/"/> for more information.
1256</t>
1257</section>
1258</section>
1259
1260 
1261
1262</middle>
1263
1264<back>
1265<references title="Informative References">
1266
1267<reference anchor='RFC2026'>
1268  <front>
1269    <title abbrev='Internet Standards Process'>The Internet Standards Process -- Revision 3</title>
1270    <author initials='S.' surname='Bradner' fullname='Scott O. Bradner'>
1271      <organization>Harvard University</organization>
1272      <address>
1273        <email>sob@harvard.edu</email>
1274      </address>
1275    </author>
1276    <date year='1996' month='October' />
1277  </front>
1278  <seriesInfo name='BCP' value='9' />
1279  <seriesInfo name='RFC' value='2026' />
1280</reference>
1281
1282<reference anchor="RFC2119">
1283  <front>
1284    <title abbrev="RFC Key Words">Key words for use in RFCs to Indicate Requirement Levels</title>
1285    <author initials="S." surname="Bradner" fullname="Scott Bradner">
1286      <organization>Harvard University</organization>
1287      <address>
1288        <email>sob@harvard.edu</email>
1289      </address>
1290    </author>
1291    <date month="March" year="1997"/>
1292  </front>
1293  <seriesInfo name="BCP" value="14"/>
1294  <seriesInfo name="RFC" value="2119"/>
1295</reference>
1296
1297<reference anchor="RFC2616">
1298  <front>
1299  <title abbrev="HTTP/1.1">Hypertext Transfer Protocol -- HTTP/1.1</title>
1300  <author initials="R.T." surname="Fielding" fullname="Roy T. Fielding">
1301  <organization>University of California, Irvine, Information and Computer Science</organization>
1302  <address>
1303  <postal>
1304  <street/>
1305  <city>Irvine</city>
1306  <region>CA</region>
1307  <code>92697-3425</code>
1308  <country>US</country></postal>
1309  <phone>+1 949 824 1715</phone>
1310  <email>fielding@ics.uci.edu</email></address></author>
1311  <author initials="J." surname="Gettys" fullname="James Gettys">
1312  <organization>World Wide Web Consortium, MIT Laboratory for Computer Science</organization>
1313  <address>
1314  <postal>
1315  <street>545 Technology Square</street>
1316  <city>Cambridge</city>
1317  <region>MA</region>
1318  <code>02139</code>
1319  <country>US</country></postal>
1320  <phone/>
1321  <facsimile>+1 617 258 8682</facsimile>
1322  <email>jg@w3.org</email></address></author>
1323  <author initials="J.C." surname="Mogul" fullname="Jeffrey C. Mogul">
1324  <organization>Compaq Computer Corporation, Western Research Laboratory</organization>
1325  <address>
1326  <postal>
1327  <street>250 University Avenue</street>
1328  <city>Palo Alto</city>
1329  <region>CA</region>
1330  <code>94301</code>
1331  <country>US</country></postal>
1332  <phone/>
1333  <email>mogul@wrl.dec.com</email></address></author>
1334  <author initials="H.F." surname="Nielsen" fullname="Henrik Frystyk Nielsen">
1335  <organization>World Wide Web Consortium, MIT Laboratory for Computer Science</organization>
1336  <address>
1337  <postal>
1338  <street>545 Technology Square</street>
1339  <city>Cambridge</city>
1340  <region>MA</region>
1341  <code>02139</code>
1342  <country>US</country></postal>
1343  <phone/>
1344  <facsimile>+1 617 258 8682</facsimile>
1345  <email>frystyk@w3.org</email></address></author>
1346  <author initials="L." surname="Masinter" fullname="Larry Masinter">
1347  <organization>Xerox Corporation</organization>
1348  <address>
1349  <postal>
1350  <street>3333 Coyote Hill Road</street>
1351  <city>Palo Alto</city>
1352  <region>CA</region>
1353  <code>94034</code>
1354  <country>US</country></postal>
1355  <phone/>
1356  <email>masinter@parc.xerox.com</email></address></author>
1357  <author initials="P.J." surname="Leach" fullname="Paul J. Leach">
1358  <organization>Microsoft Corporation</organization>
1359  <address>
1360  <postal>
1361  <street>1 Microsoft Way</street>
1362  <city>Redmond</city>
1363  <region>WA</region>
1364  <code>98052</code>
1365  <country>US</country></postal>
1366  <phone/>
1367  <email>paulle@microsoft.com</email></address></author>
1368  <author initials="T." surname="Berners-Lee" fullname="Tim Berners-Lee">
1369  <organization>World Wide Web Consortium, MIT Laboratory for Computer Science</organization>
1370  <address>
1371  <postal>
1372  <street>545 Technology Square</street>
1373  <city>Cambridge</city>
1374  <region>MA</region>
1375  <code>02139</code>
1376  <country>US</country></postal>
1377  <phone>+1 617 258 8682</phone>
1378  <facsimile/>
1379  <email>timbl@w3.org</email></address></author>
1380  <date month="June" year="1999"/>
1381  </front>
1382  <seriesInfo name="RFC" value="2616"/>
1383</reference>
1384
1385<reference anchor='RFC2629'>
1386  <front>
1387    <title>Writing I-Ds and RFCs using XML</title>
1388    <author initials='M.T.' surname='Rose' fullname='Marshall T. Rose'>
1389      <organization>Invisible Worlds, Inc.</organization>
1390      <address>
1391        <postal>
1392          <street>660 York Street</street>
1393          <city>San Francisco</city>
1394          <region>CA</region>
1395          <code>94110</code>
1396          <country>US</country>
1397        </postal>
1398        <phone>+1 415 695 3975</phone>
1399        <email>mrose@not.invisible.net</email>
1400        <uri>http://invisible.net/</uri>
1401      </address>
1402    </author>
1403    <date month='June' year='1999' />
1404  </front>
1405  <seriesInfo name='RFC' value='2629' />
1406</reference>
1407
1408<reference anchor='RFC2648'>
1409  <front>
1410    <title>A URN Namespace for IETF Documents</title>
1411    <author initials='R.' surname='Moats' fullname='Ryan Moats'>
1412      <organization>AT&amp;T</organization>
1413      <address>
1414      <postal>
1415        <street>15621 Drexel Circle</street>
1416        <city>Omaha</city>
1417        <region>NE</region>
1418        <code>68135-2358</code>
1419        <country>US</country>
1420      </postal>
1421      <email>jayhawk@att.com</email></address>
1422    </author>
1423    <date month='August' year='1999' />
1424  </front>
1425  <seriesInfo name='RFC' value='2648' />
1426</reference>
1427
1428<reference anchor='RFC2731'>
1429  <front>
1430    <title>Encoding Dublin Core Metadata in HTML</title>
1431    <author initials='J.A.' surname='Kunze' fullname='John A. Kunze'>
1432      <organization>University of California, San Francisco,  Center for Knowledge Management</organization>
1433      <address>
1434        <postal>
1435          <street>530 Parnassus Ave</street>
1436          <street>Box 0840</street>
1437          <city>San Francisco</city>
1438          <region>CA</region>
1439          <code>94143-0840</code>
1440          <country>US</country>
1441        </postal>
1442        <facsimile>+1 415 476 4653</facsimile>
1443        <email>jak@ckm.ucsf.edu</email>
1444      </address>
1445    </author>
1446    <date month='December' year='1999' />
1447  </front>
1448  <seriesInfo name='RFC' value='2731' />
1449</reference>
1450
1451<reference anchor="RFC5234">
1452  <front>
1453    <title abbrev="ABNF for Syntax Specifications">Augmented BNF for Syntax Specifications: ABNF</title>
1454    <author initials="D." surname="Crocker" fullname="Dave Crocker" role="editor">
1455      <organization>Brandenburg InternetWorking</organization>
1456      <address>
1457      <postal>
1458      <street>675 Spruce Dr.</street>
1459      <city>Sunnyvale</city>
1460      <region>CA</region>
1461      <code>94086</code>
1462      <country>US</country></postal>
1463      <phone>+1.408.246.8253</phone>
1464      <email>dcrocker@bbiw.net</email></address> 
1465    </author>
1466    <author initials="P." surname="Overell" fullname="Paul Overell">
1467      <organization>THUS plc.</organization>
1468      <address>
1469      <postal>
1470      <street>1/2 Berkeley Square</street>
1471      <street>99 Berkely Street</street>
1472      <city>Glasgow</city>
1473      <code>G3 7HR</code>
1474      <country>UK</country></postal>
1475      <email>paul.overell@thus.net</email></address>
1476    </author>
1477    <date month="January" year="2008"/>
1478  </front>
1479  <seriesInfo name="STD" value="68"/>
1480  <seriesInfo name="RFC" value="5234"/>
1481</reference>
1482
1483<reference anchor="HTML" target="http://www.w3.org/TR/html401/">
1484  <front>
1485    <title>HTML 4.01 Specification</title>
1486    <author initials="D." surname="Raggett" fullname="David Raggett">
1487      <organization>W3C</organization>
1488      <address>
1489        <email>dsr@w3.org</email>
1490      </address>
1491    </author>
1492    <author initials="A." surname="Hors" fullname="Arnaud Le Hors">
1493      <organization>W3C</organization>
1494    </author>
1495    <author initials="I." surname="Jacobs" fullname="Ian Jacobs">
1496      <organization>W3C</organization>
1497    </author>
1498    <date month="December" day="24" year="1999" />
1499  </front>
1500  <seriesInfo name="W3C" value="REC-html401-19991224" />
1501</reference>
1502
1503<reference anchor="XHTML2" target="http://www.w3.org/TR/xhtml2">
1504  <front>
1505    <title>XHTML&#8482; 2.0</title>
1506    <author initials="J." surname="Axelsson" fullname="Jonny Axelsson">
1507      <organization>Opera Software</organization>
1508    </author>
1509    <author initials="M." surname="Birbeck" fullname="Mark Birbeck">
1510      <organization>x-port.net</organization>
1511    </author>
1512    <author initials="M." surname="Dubinko" fullname="Micah Dubinko">
1513      <organization></organization>
1514    </author>
1515    <author initials="B." surname="Epperson" fullname="Beth Epperson">
1516      <organization>Websense</organization>
1517    </author>
1518    <author initials="M." surname="Ishikawa" fullname="Masayasu Ishikawa">
1519      <organization>W3C</organization>
1520    </author>
1521    <author initials="S." surname="McCarron" fullname="Shane McCarron">
1522      <organization>Applied Testing and Technology</organization>
1523    </author>
1524    <author initials="A." surname="Navarro" fullname="Ann Navarro">
1525      <organization>WebGeek, Inc.</organization>
1526    </author>
1527    <author initials="S." surname="Pemberton" fullname="Steven Pemberton">
1528      <organization>CWI</organization>
1529    </author>
1530    <date month="July" day="26" year="2006" />
1531  </front>
1532  <seriesInfo name="W3C" value="WD-xhtml2-20060726" />
1533</reference>
1534
1535<reference anchor="XSL-FO" target="http://www.w3.org/TR/2006/REC-xsl11-20061205/">
1536  <front>
1537    <title>Extensible Stylesheet Language (XSL) Version 1.1</title>
1538    <author initials="A." surname="Berglund" fullname="Anders Berglund">
1539      <organization>IBM</organization>
1540      <address>
1541        <email>alrb@us.ibm.com</email>
1542      </address>
1543    </author>
1544    <date month="Dec" day="5" year="2006" />
1545  </front>
1546  <seriesInfo name="W3C" value="REC-xsl11-20061205" />
1547</reference>
1548
1549<reference anchor="RNC" target="http://www.oasis-open.org/committees/relax-ng/compact-20021121.html">
1550  <front>
1551    <title>RELAX NG Compact Syntax</title>
1552    <author initials="J." surname="Clark" fullname="James Clark">
1553      <organization/>
1554      <address>
1555        <email>jjc@jclark.com</email>
1556      </address>
1557    </author>
1558    <date month="Nov" day="21" year="2002" />
1559  </front>
1560  <seriesInfo name="OASIS" value=""/>
1561</reference>
1562
1563<reference anchor='BCP97'>
1564  <front>
1565    <title>Handling Normative References to Standards-Track Documents</title>
1566    <author initials='J.' surname='Klensin' fullname='J. Klensin'>
1567      <organization />
1568      <address>
1569        <email>klensin+ietf@jck.com</email>
1570      </address>
1571    </author>
1572    <author initials='S.' surname='Hartman' fullname='S. Hartman'>
1573      <organization>MIT</organization>
1574      <address>
1575        <email>hartmans-ietf@mit.edu</email>
1576      </address>
1577    </author>
1578    <date year='2007' month='June' />
1579  </front>
1580  <seriesInfo name='BCP' value='97' />
1581  <seriesInfo name='RFC' value='4897' />
1582</reference>
1583</references>
1584
1585  <section title="RELAX NG Compact Schema" anchor="grammar">
1586  <iref item="Grammar" primary="true"/>
1587  <iref item="Schema" primary="true"/>
1588  <iref item="RELAX NG Compact Schema" primary="true"/>
1589  <t>
1590    The RelaxNG schema (<xref target="RNC"/>) below can be used to validate
1591    input documents (for instance, with <eref target="http://www.thaiopensource.com/relaxng/jing.html">Jing</eref>).
1592  </t>
1593  <t>
1594    <spanx>Note that this is work in progress, and doesn't yet cover all
1595    extensions completely.</spanx>
1596  </t>
1597  <figure>
1598    <artwork type="application/relax-ng-compact-syntax" name="rfc2629-ext.rnc" x:extraction-note="# Automatically extracted from rfc2629xslt.xml. DO NOT EDIT!&#10;">
1599<spanx># WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR.</spanx>
1600
1601<spanx># Define our extension namespace</spanx>
1602namespace x = "http://purl.org/net/xml2rfc/ext"
1603
1604<spanx># Define GRDDL namespace</spanx>
1605namespace grddl = "http://www.w3.org/2003/g/data-view#"
1606
1607<spanx># Define RDF namespace</spanx>
1608namespace rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
1609
1610<spanx># Include rfc2629bis RNC grammar</spanx>
1611include "rfc2629.rnc" {
1612 
1613  <spanx># Redefine &lt;artwork> to allow markup</spanx>
1614  artwork =
1615    element artwork {
1616      attlist.artwork,
1617      (TEXT
1618        <spanx style="strong">| eref</spanx> 
1619        <spanx style="strong">| iref</spanx> 
1620        <spanx style="strong">| spanx</spanx> 
1621        <spanx style="strong">| xref</spanx>
1622        <spanx style="strong">| <x:ref>x_abnf-char-sequence</x:ref></spanx>
1623        <spanx style="strong">| <x:ref>x_bb</x:ref></spanx>
1624        <spanx style="strong">| <x:ref>x_bc</x:ref></spanx>
1625        <spanx style="strong">| <x:ref>x_bt</x:ref></spanx>
1626        <spanx style="strong">| <x:ref>x_length-of</x:ref></spanx>
1627        <spanx style="strong">| <x:ref>x_parse-xml</x:ref></spanx>
1628        <spanx style="strong">| <x:ref>x_ref</x:ref></spanx>
1629        <spanx style="strong">| <x:ref>x_span</x:ref></spanx>
1630        <spanx style="strong">| <x:ref>x_x</x:ref></spanx>)*
1631    }
1632
1633  <spanx># Redefine &lt;c> to allow our extension elements</spanx>
1634  c =
1635    element c {
1636      attlist.c,
1637      (TEXT
1638        | xref
1639        | eref
1640        | iref
1641        | cref
1642        | spanx
1643        <spanx style="strong">| <x:ref>x_ref</x:ref></spanx>)*
1644    }
1645
1646  <spanx># Redefine &lt;cref> to allow more child elements</spanx>
1647  cref =
1648    element cref {
1649      attlist.cref,
1650      (TEXT
1651        | eref)*
1652    }
1653
1654  <spanx># Redefine &lt;list> element to allow &lt;x:<x:ref>lt</x:ref>> child elements</spanx>
1655  \list =
1656    element list {
1657      attlist.list,
1658      (t+ <spanx style="strong">| <x:ref>x_lt</x:ref>+</spanx>)
1659    }   
1660   
1661  <spanx># Redefine &lt;preamble> to allow our extension elements</spanx>
1662  preamble =
1663    element preamble {
1664      attlist.preamble,
1665      (TEXT
1666        | xref
1667        | eref
1668        | iref
1669        | cref
1670        | spanx
1671        <spanx style="strong">| <x:ref>x_anchor-alias</x:ref></spanx>)*
1672    }
1673
1674  <spanx># Redefine &lt;postamble> to allow our extension elements</spanx>
1675  postamble =
1676    element postamble {
1677      attlist.postamble,
1678      (TEXT
1679        | xref
1680        | eref
1681        | iref
1682        | cref
1683        | spanx
1684        <spanx style="strong">| <x:ref>x_bcp14</x:ref></spanx>)*
1685    }
1686
1687  <spanx># Redefine &lt;reference> to allow our extension elements</spanx>
1688  reference =
1689    element reference {
1690      attlist.reference,
1691      front,
1692      seriesInfo*,
1693      format*,
1694      annotation*,
1695      <spanx style="strong"><x:ref>x_source</x:ref>?</spanx>
1696    }
1697
1698  <spanx># Redefine &lt;rfc> to allow our extension elements</spanx>
1699  rfc =
1700    element rfc {
1701      attlist.rfc,
1702      <spanx style="strong"><x:ref>x_link</x:ref>*,</spanx>
1703      <spanx style="strong"><x:ref>x_assign-section-number</x:ref>*,</spanx>
1704      front,
1705      middle,
1706      back?
1707    }
1708
1709  <spanx># Redefine &lt;section> to allow our extension elements</spanx>
1710  section =
1711    element section {
1712      attlist.section,
1713      (t
1714       | figure
1715       | texttable
1716       | iref
1717       | section
1718       <spanx style="strong">| <x:ref>x_anchor-alias</x:ref></spanx>
1719       <spanx style="strong">| <x:ref>x_blockquote</x:ref></spanx>
1720       <spanx style="strong">| <x:ref>rdf_Description</x:ref></spanx>)*
1721    }
1722
1723  <spanx># Redefine &lt;spanx> to allow some markup</spanx>
1724  spanx =
1725    element spanx {
1726      attlist.spanx,
1727      (TEXT
1728        <spanx style="strong">| iref</spanx>
1729        <spanx style="strong">| xref</spanx>
1730        <spanx style="strong">| <x:ref>x_ref</x:ref></spanx>)*
1731    }
1732
1733  <spanx># Redefine &lt;t> to allow our extension elements</spanx>
1734  t =
1735    element t {
1736      attlist.t,
1737      (TEXT
1738       | \list
1739       | figure
1740       | xref
1741       | eref
1742       | iref
1743       | cref
1744       | spanx
1745       | vspace
1746       <spanx style="strong">| <x:ref>x_abnf-char-sequence</x:ref></spanx>
1747       <spanx style="strong">| <x:ref>x_anchor-alias</x:ref></spanx>
1748       <spanx style="strong">| <x:ref>x_bcp14</x:ref></spanx>
1749       <spanx style="strong">| <x:ref>x_dfn</x:ref></spanx>
1750       <spanx style="strong">| <x:ref>x_h</x:ref></spanx>
1751       <spanx style="strong">| <x:ref>x_q</x:ref></spanx>
1752       <spanx style="strong">| <x:ref>x_ref</x:ref></spanx>
1753       <spanx style="strong">| <x:ref>x_sup</x:ref></spanx>)*
1754    }
1755}
1756
1757<spanx># Extend attribute set for &lt;iref> (see <xref target="ext-rfc2629.iref"/>)</spanx>
1758attlist.iref &amp;=
1759  attribute x:for-anchor { ATEXT }?
1760
1761<spanx># Extend attribute set for &lt;list> (see <xref target="ext-rfc2629.list"/>)</spanx>
1762attlist.list &amp;=
1763  attribute x:indent { ATEXT }?
1764
1765<spanx># Extend attribute set for &lt;preamble></spanx>
1766attlist.preamble &amp;=
1767  attribute anchor { xsd:ID }?
1768
1769<spanx># Extend attribute set for &lt;rfc></spanx>
1770attlist.rfc &amp;=
1771  attribute grddl:transformation { ATEXT }?,
1772  attribute x:maturity-level { "proposed" | "draft" | "internet" }
1773
1774<spanx># Extend attribute set for &lt;section> (see <xref target="ext-rfc2629.section"/>)</spanx>
1775attlist.section &amp;=
1776  attribute x:fixed-section-number { ATEXT }?
1777
1778<spanx># Allow anchor attribute on &lt;spanx></spanx>
1779attlist.spanx &amp;=
1780  attribute anchor { xsd:ID }?
1781
1782<spanx># Extend attribute set for &lt;xref> (see <xref target="ext-rfc2629.xref"/>)</spanx>
1783attlist.xref &amp;=
1784  attribute x:fmt  { "()" | "," | "anchor" | "of" | "number" | "sec" |
1785                     "none" }?,
1786  attribute x:rel  { ATEXT }?,
1787  attribute x:sec  { ATEXT }?
1788
1789<spanx anchor="x_abnf-char-sequence"><iref item="abnf-char-sequence Extension Element"/><iref item="Extension Elements" subitem="abnf-char-sequence"
1790/># Conversion to ABNF char sequence (see <xref target="ext.element.abnf-char-sequence"/>)</spanx>
1791<x:ref>x_abnf-char-sequence</x:ref> =
1792  element x:abnf-char-sequence {
1793    TEXT
1794  }
1795
1796<spanx anchor="x_anchor-alias"><iref item="anchor-alias Extension Element"/><iref item="Extension Elements" subitem="anchor-alias"
1797/># Aliasing of anchors (see <xref target="ext.element.anchor-alias"/>)</spanx>
1798<x:ref>x_anchor-alias</x:ref> =
1799  element x:anchor-alias {
1800    attribute value { TEXT },
1801    empty
1802  }
1803
1804<spanx anchor="x_assign-section-number"><iref item="assign-section-number Extension Element"/><iref item="Extension Elements" subitem="assign-section-number"
1805/># Setting section numbers for internally generated sections
1806# (experimental)</spanx>
1807<x:ref>x_assign-section-number</x:ref> =
1808  element x:assign-section-number {
1809    attribute builtin-target { "authors" },
1810    attribute number { TEXT },
1811    empty
1812  }
1813
1814<spanx anchor="x_bb"><iref item="bb Extension Element"/><iref item="Extension Elements" subitem="bb"
1815/># Bottom line of box drawing (see <xref target="ext.element.bb"/>)</spanx>
1816<x:ref>x_bb</x:ref> =
1817  element x:bb {
1818    (TEXT
1819      | iref
1820      | xref
1821      | <x:ref>x_bb</x:ref>
1822      | <x:ref>x_bc</x:ref>
1823      | <x:ref>x_bt</x:ref>
1824      | <x:ref>x_ref</x:ref>)*
1825  }
1826
1827<spanx anchor="x_bc"><iref item="bc Extension Element"/><iref item="Extension Elements" subitem="bc"
1828/># Center line of box drawing (see <xref target="ext.element.bc"/>)</spanx>
1829<x:ref>x_bc</x:ref> =
1830  element x:bc {
1831    (TEXT
1832      | iref
1833      | xref
1834      | <x:ref>x_bb</x:ref>
1835      | <x:ref>x_bc</x:ref>
1836      | <x:ref>x_bt</x:ref>
1837      | <x:ref>x_ref</x:ref>)*
1838  }
1839
1840<spanx anchor="x_bcp14"><iref item="bcp14 Extension Element"/><iref item="Extension Elements" subitem="bcp14"
1841/># BCP14/RFC2119 keywords (see <xref target="ext.element.bcp14"/>)</spanx>
1842<x:ref>x_bcp14</x:ref> =
1843  element x:bcp14 {
1844    "MAY"
1845    | "MUST"
1846    | "MUST NOT"
1847    | "NOT RECOMMENDED"
1848    | "OPTIONAL"
1849    | "RECOMMENDED"
1850    | "REQUIRED"
1851    | "SHALL"
1852    | "SHALL NOT"
1853    | "SHOULD"
1854    | "SHOULD NOT"
1855  }
1856 
1857<spanx anchor="x_blockquote"><iref item="blockquote Extension Element"/><iref item="Extension Elements" subitem="blockquote"
1858/># Blockquote (see <xref target="ext.element.blockquote"/>)</spanx>
1859<x:ref>x_blockquote</x:ref> =
1860  element x:blockquote {
1861    attribute cite { URI }?,
1862    t+
1863  }
1864
1865<spanx anchor="x_bt"><iref item="bt Extension Element"/><iref item="Extension Elements" subitem="bt"
1866/># Top line of box drawing (see <xref target="ext.element.bt"/>)</spanx>
1867<x:ref>x_bt</x:ref> =
1868  element x:bt {
1869    (TEXT
1870      | iref
1871      | xref
1872      | <x:ref>x_bb</x:ref>
1873      | <x:ref>x_bc</x:ref>
1874      | <x:ref>x_bt</x:ref>
1875      | <x:ref>x_ref</x:ref>)*
1876  }
1877
1878<spanx anchor="x_dfn"><iref item="dfn Extension Element"/><iref item="Extension Elements" subitem="dfn"
1879/># Definition (see <xref target="ext.element.dfn"/>)</spanx>
1880<x:ref>x_dfn</x:ref> =
1881  element x:dfn {
1882    attribute anchor { xsd:ID }?,
1883    (TEXT
1884      | iref)*
1885  }
1886 
1887<spanx anchor="x_h"><iref item="h Extension Element"/><iref item="Extension Elements" subitem="h"
1888/># Heading (see <xref target="ext.element.h"/>)</spanx>
1889<x:ref>x_h</x:ref> =
1890  element x:h {
1891    TEXT
1892  }
1893
1894<spanx anchor="x_length-of"><iref item="length-of Extension Element"/><iref item="Extension Elements" subitem="length-of"
1895/># Length Measurement (see <xref target="ext.element.length-of"/>)</spanx>
1896<x:ref>x_length-of</x:ref> =
1897  element x:length-of {
1898    attribute indented { NUMBER }?,
1899    attribute target { xsd:IDREF },
1900    empty
1901  }
1902
1903<spanx anchor="x_link"><iref item="link Extension Element"/><iref item="Extension Elements" subitem="link"
1904/># Link (see <xref target="ext.element.link"/>)</spanx>
1905<x:ref>x_link</x:ref> =
1906  element x:link {
1907    attribute href { URI },
1908    attribute title { TEXT }?,
1909    attribute rel { TEXT },
1910    empty
1911  }
1912 
1913<spanx anchor="x_lt"><iref item="lt Extension Element"/><iref item="Extension Elements" subitem="lt"
1914/># Extended list item (see <xref target="ext.element.lt"/>)</spanx>
1915<x:ref>x_lt</x:ref> =
1916  element x:lt {
1917    attribute anchor { xsd:ID }?,
1918    attribute hangText { TEXT }?,
1919    t+
1920  }
1921
1922<spanx anchor="x_parse-xml"><iref item="parse-xml Extension Element"/><iref item="Extension Elements" subitem="parse-xml"
1923/># Signal XML content (see <xref target="ext.element.parse-xml"/>)</spanx>
1924<x:ref>x_parse-xml</x:ref> =
1925  element x:parse-xml {
1926    TEXT
1927  }
1928
1929<spanx anchor="x_q"><iref item="q Extension Element"/><iref item="Extension Elements" subitem="q"
1930/># Inline quote (see <xref target="ext.element.q"/>)</spanx>
1931<x:ref>x_q</x:ref> =
1932  element x:q {
1933    TEXT
1934  }
1935
1936<spanx anchor="x_ref"><iref item="ref Extension Element"/><iref item="Extension Elements" subitem="ref"
1937/># Anchor reference (see <xref target="ext.element.ref"/>)</spanx> 
1938<x:ref>x_ref</x:ref> =
1939  element x:ref {
1940    TEXT
1941  }
1942
1943<spanx anchor="x_source"><iref item="source Extension Element"/><iref item="Extension Elements" subitem="source"
1944/># source information (see <xref target="ext.element.source"/>)</spanx> 
1945<x:ref>x_source</x:ref> =
1946  element x:source {
1947    attribute basename { ATEXT }?,
1948    attribute href { URI },
1949    empty
1950  }
1951
1952<spanx anchor="x_sup"><iref item="sup Extension Element"/><iref item="Extension Elements" subitem="sup"
1953/># superscript (see <xref target="ext.element.sup"/>)</spanx>
1954<x:ref>x_sup</x:ref> =
1955  element x:sup {
1956    TEXT
1957  }
1958
1959<spanx anchor="x_span"><iref item="span Extension Element"/><iref item="Extension Elements" subitem="span"
1960/># Inline Span <!--(see <xref target="ext.element.span"/>)--></spanx>
1961<x:ref>x_span</x:ref> =
1962  element x:span {
1963    attribute anchor { xsd:ID }?,
1964    (TEXT
1965      | <x:ref>x_parse-xml</x:ref>)*
1966  }
1967
1968<spanx anchor="x_x"><iref item="x Extension Element"/><iref item="Extension Elements" subitem="x"
1969/># Nop (for alignment in source)</spanx>
1970<x:ref>x_x</x:ref> =
1971  element x:x {
1972    empty
1973  }
1974
1975<spanx anchor="rdf_Description"><iref item="rdf:Description Extension Element"/><iref item="Extension Elements" subitem="rdf:Description"
1976/># Nop (for alignment in source)</spanx>
1977<x:ref>rdf_Description</x:ref> =
1978  element rdf:Description {
1979    rdf_content
1980  }
1981 
1982rdf_content =
1983  ( TEXT | element * { rdf_content })*
1984</artwork></figure>
1985  </section>
1986 
1987  <section title="Implementation Notes">
1988 
1989  <section title="Recognized type attributes for &lt;artwork> element">
1990  <t>
1991    Specific values in the &lt;artwork> element's "type" attribute are
1992    recognized and cause a different visual style to be used:
1993  </t>
1994  <texttable>
1995    <ttcol>Media Type</ttcol>
1996    <ttcol>Comment</ttcol>
1997   
1998    <c>abnf</c><c>ABNF as per <xref target="RFC5234"/></c>
1999    <c>abnf2616</c><c>ABNF as per <xref target="RFC2616" x:fmt="," x:sec="2.1" /></c>
2000    <c>application/relax-ng-compact-syntax</c><c>Relax NG Compact Syntax as per <xref target="RNC"/></c>
2001    <c>application/xml-dtd</c><c>XML DTD</c>
2002    <c>message/http; msgtype="request"</c><c>HTTP message, as per <xref target="RFC2616" x:fmt="," x:sec="19.1" /></c>
2003    <c>message/http; msgtype="response"</c><c>HTTP message, as per <xref target="RFC2616" x:fmt="," x:sec="19.1" /></c>
2004  </texttable>
2005  </section>
2006 
2007  </section>
2008 
2009  <section title="License" anchor="license">
2010  <t>
2011Copyright (c) 2006-2008, Julian Reschke (julian.reschke@greenbytes.de)
2012  </t>
2013  <t>
2014All rights reserved.
2015  </t>
2016  <t>
2017Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
2018  <list style="symbols">
2019    <t>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</t>
2020    <t>Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</t>
2021    <t>Neither the name of Julian Reschke nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</t>
2022  </list>
2023  </t>
2024  <t>
2025THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2026  </t>
2027  </section>
2028
2029  <section title="Change Logs">
2030   
2031 
2032    <section title="Package">
2033      <t><list style="hanging">
2034<t hangText="2006-01-01">
2035    Switch to BSD License.
2036</t>
2037<t hangText="2007-01-12">
2038    Update to xml2rfc v1.33pre2.
2039</t>
2040<t hangText="2007-03-31">
2041    Update to xml2rfc v1.33pre3.
2042</t>
2043<t hangText="2007-05-01">
2044    Add XSLT test cases.
2045</t>
2046<t hangText="2008-07-18">
2047    Experimental support for inlined rdf:Description elements (ignored
2048    by the formatter, extracted by rfc2629grddl).
2049</t>
2050      </list></t>
2051    </section>
2052   
2053    <section title="amazon-asin.xslt">
2054    <t><list style="hanging">
2055<t hangText="2003-11-16">
2056     Initial release.
2057</t>
2058<t hangText="2005-04-02">
2059     Fix two DTD issues.
2060</t>
2061    </list></t>
2062    </section>
2063
2064    <section title="check-references.xslt">
2065    <t><list style="hanging">
2066<t hangText="2003-11-16">
2067     Initial release.
2068</t>
2069<t hangText="2004-05-11">
2070     Add document status; print references type.
2071</t>
2072<t hangText="2005-01-01">
2073     Add experimental check for ID status.
2074</t>
2075<t hangText="2005-04-01">
2076     Add fixes from Bill Fenner.
2077</t>
2078<t hangText="2005-12-03">
2079    Add checks against local copy of <eref target="http://www.w3.org/2002/01/tr-automation/tr.rdf"/>
2080</t>
2081<t hangText="2006-07-22">
2082    Add checks for standards levels.
2083</t>
2084<t hangText="2006-08-06">
2085    "check-ietf-references.xslt" replaced by "check-references.xslt".
2086</t>
2087<t hangText="2007-01-04">
2088    Use information online at <eref target="http://tools.ietf.org/"/> to
2089    retrieve Internet-Draft status information.
2090</t>
2091<t hangText="2007-06-16">
2092    Fix bug looking up ref type when inside change markup.
2093</t>
2094<t hangText="2008-06-14">
2095    Enhance output when draft was updated, and then published as RFC.
2096</t>
2097<t hangText="2008-07-12">
2098    Add XSLT2-based link target checking.
2099</t>
2100<t hangText="2008-08-10">
2101    Change keywords for "intended-level" to proposed/draft/internet,
2102    optionall extract intended level from /rfc/@x:maturity-level attribute.
2103</t>
2104    </list></t>
2105    </section>
2106   
2107    <section title="gen-reference-graph.xslt">
2108    <t><list style="hanging">
2109<t hangText="2006-09-03">
2110  New.
2111</t>
2112<t hangText="2007-06-07">
2113  Use <eref target="http://dpcarlisle.blogspot.com/2007/05/exslt-node-set-function.html">Carlisle method</eref> to define exslt:node-set in
2114  msxsml (which means that the stylesheet can now be used with MSXML as well).
2115</t>
2116<t hangText="2007-10-15">
2117  Use W3C data from tr.rdf as well (experimental).
2118</t>
2119    </list></t>
2120    </section>
2121
2122    <section title="rfc2629.xslt">
2123      <t><list style="hanging">
2124<t hangText="2001-03-28">
2125    Code rearranged, generate numbered section anchors for paragraphs (t)
2126    as well. Fixes in index handling.
2127</t>
2128<t hangText="2001-04-12">
2129    Moved HTML output into XHTML namespace.
2130</t>
2131<t hangText="2001-10-02">
2132    Fixed default location for RFCs and numbering of section references.
2133    Support ?rfc editing processing instruction.
2134</t>
2135<t hangText="2001-10-07">
2136    Made telephone number links active.
2137</t>
2138<t hangText="2001-10-08">
2139    Support for vspace element.
2140</t>
2141<t hangText="2001-10-09">
2142    Experimental support for rfc-issue PI.
2143</t>
2144<t hangText="2001-11-11">
2145    Support rfc private PI. Removed bogus code reporting the WG in the header.
2146</t>
2147<t hangText="2001-11-11">
2148    Support rfc private PI. Removed bogus code reporting the WG in the header.
2149</t>
2150<t hangText="2001-12-17">
2151    Support title attribute on references element
2152</t>
2153<t hangText="2002-01-05">
2154    Support for list/@style="@format"
2155</t>
2156<t hangText="2002-01-09">
2157    Display "closed" RFC issues as deleted
2158</t>
2159<t hangText="2002-01-14">
2160    Experimentally and optionally parse XML encountered in artwork elements
2161    (requires MSXSL).
2162</t>
2163<t hangText="2002-01-27">
2164    Some cleanup. Moved RFC issues from PIs into namespaced elements.
2165</t>
2166<t hangText="2002-01-29">
2167    Added support for sortrefs PI. Added support for figure names.
2168</t>
2169<t hangText="2002-02-07">
2170    Highlight parts of artwork which are too wide (72 characters).
2171</t>
2172<t hangText="2002-02-12">
2173    Code rearrangement for static texts. Fixes for section numbering.
2174    TOC generation rewritten.
2175</t>
2176<t hangText="2002-02-15">
2177    Support for irefs in sections; support iref @primary=true
2178</t>
2179<t hangText="2002-03-03">
2180    Moved anchor prefix into a constant. Added sanity checks on user anchor
2181    names.
2182</t>
2183<t hangText="2002-03-23">
2184    Bugfix in detection of matching org names when creating the header. Fixed
2185    sorting in subitems.
2186</t>
2187<t hangText="2002-04-02">
2188    Fix TOC link HTML generation when no TOC is generated (created broken
2189    HTML table code).
2190</t>
2191<t hangText="2002-04-03">
2192    Made rendering of references more tolerant re: missing parts.
2193</t>
2194<t hangText="2002-04-08">
2195    Fixed reference numbering when references are split into separate sections.
2196</t>
2197<t hangText="2002-04-16">
2198    Fix default namespace (shouldn't be set for HTML output method).
2199</t>
2200<t hangText="2002-04-19">
2201    Lowercase internal CSS selectors for Mozilla compliance. Do not put TOC
2202    into ul element.
2203</t>
2204<t hangText="2002-04-21">
2205    Make numbered list inside numbered lists use alphanumeric numbering.
2206</t>
2207<t hangText="2002-05-05">
2208    Updated issue/editing support.
2209</t>
2210<t hangText="2002-05-15">
2211    Bugfix for section numbering after introduction of ed:replace
2212</t>
2213<t hangText="2002-06-21">
2214    When producing private documents, do not include document status, copyright etc.
2215</t>
2216<t hangText="2002-07-08">
2217    Fix xrefs to Appendices.
2218</t>
2219<t hangText="2002-07-19">
2220    Make artwork lightyellow for easier reading. (fielding)
2221</t>
2222<t hangText="2002-10-09">
2223    Translate references title to anchor name to avoid non-uri characters. (fielding)
2224</t>
2225<t hangText="2002-10-13">
2226    Support for tocdepth PI.
2227</t>
2228<t hangText="2002-11-03">
2229    Added temporariry workaround for Mozilla/Transformiix result tree fragment problem.
2230    (search for 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')
2231</t>
2232<t hangText="2002-12-25">
2233    xref code: attempt to uppercase "section" and "appendix" when at the start
2234    of a sentence.
2235</t>
2236<t hangText="2003-02-02">
2237    fixed code for vspace blankLines="0", enhanced display for list with "format" style,
2238    got rid of HTML blockquote elements, added support for "hangIndent"
2239</t>
2240<t hangText="2003-04-10">
2241    experimental support for appendix and spanx elements
2242</t>
2243<t hangText="2003-04-19">
2244    fixed counting of list numbers in "format %" styles (one counter
2245    per unique format string). Added more spanx styles.
2246</t>
2247<t hangText="2003-05-02">
2248    experimental texttable support
2249</t>
2250<t hangText="2003-05-02">
2251    Make mailto links optional (default = none) (jre: default and PI name changed) (fielding)
2252</t>
2253<t hangText="2003-05-04">
2254    experimental support for HTML link elements; fix default for table header
2255    alignment default
2256</t>
2257<t hangText="2003-05-06">
2258    support for "background" PI.
2259</t>
2260<t hangText="2003-05-11">
2261    change %c format to lowercase alphabetic. add support for keyword
2262    elements (generate META tag). fix various HTML conformance problems.
2263    added experimental support for role attribute. do not number paragraphs
2264    in unnumbered sections. update boilerplate texts. support for
2265    "iprnotified" PI. bugfix list numbering. strip whitespace when
2266    building tel: URIs.
2267</t>
2268<t hangText="2003-05-12">
2269    more conformance fixes (layout moved into CSS, move lists and figures
2270    out of para content, do not use tables for list formatting)
2271</t>
2272<t hangText="2003-05-13">
2273    add DC.Creator meta tag, refactoring
2274</t>
2275<t hangText="2003-05-16">
2276    put nbsps between "section" and section number (xref).
2277</t>
2278<t hangText="2003-05-18">
2279    author summary: add missing comma.
2280</t>
2281<t hangText="2003-06-06">
2282    fix index generation bug (transposed characters in key generation). Enhance
2283    sentence start detection (xref starting a section was using lowercase
2284    "section").
2285</t>
2286<t hangText="2003-06-22">
2287    exp. support for xref/@format. Add missing support for eref w/o content.
2288    exp. support for annotations in reference elements. Code cleanup
2289    reference table formatting.
2290</t>
2291<t hangText="2003-07-09">
2292    Another fix for DC.Creator meta tag creation based on RFC2731
2293</t>
2294<t hangText="2003-07-24">
2295    Fix namespace name for DC.Creator.
2296</t>
2297<t hangText="2003-08-06">
2298    Cleanup node-set support (only use exslt (saxon, xalan, libxslt) extension
2299    functions; remove Transformix workarounds that stopped to work in Moz 1.4)
2300</t>
2301<t hangText="2003-08-09">
2302    Generate HTML lang tag.
2303</t>
2304<t hangText="2003-08-10">
2305    Map spanx/verb to HTML "samp" element. Fix author name display in
2306    references (reverse surname/initials for last author), add "Ed.".
2307    Fix internal bookmark generation.
2308</t>
2309<t hangText="2003-08-17">
2310    Add DCMI dates, identifiers and abstract. Add PI to suppress DCMI
2311    generation.  Do not add TOC entry to Copyright Statement when there is
2312    none. Align RFC2629 PI names and parameter names. Change style for
2313    inline URIs generated by eref. Add header and footer support.
2314    Enhance CSS paging properties. Support topblock PI. Added hooks for
2315    proper XHTML generation through separate XSLT. Enhance warning and
2316    error messages. Add support for artwork image display. Table formatting
2317    fixes (borders, thead continuation).
2318</t>
2319<t hangText="2003-08-18">
2320    Add workaround for MSXML4 node-set and Mozilla node-set issues (fallback
2321    just displays are warning).
2322</t>
2323<t hangText="2003-10-06">
2324    Add workaround for broken pre/ins handling in Mozilla
2325    (see <eref target="http://bugzilla.mozilla.org/show_bug.cgi?id=204401"/>). Make use
2326    of cite attribute on ed:replace. CSS cleanup.
2327</t>
2328<t hangText="2003-10-08">
2329    Fix minor issue detecting the same org for the header (caused by IE's
2330    non-standard whitespace handling). Fix default handling for /rfc/@category.
2331</t>
2332<t hangText="2003-11-09">
2333    Inherit ed:entered-by from ancestor elements. Change CSS color for inserted
2334    text to green. Generate issues-list anchor. Do not complain about missing
2335    targets when the xref element is below ed:del. Remove code that attempted
2336    to distinguish section/Section when producing links - always use
2337    uppercase. Fix date rendering for issue resolutions.
2338</t>
2339<t hangText="2003-11-29">
2340    Fix color values for table backgrounds for issue rendering. Change
2341    rendering of issue links to use inline-styles. Add colored issue markers to
2342    issues.
2343</t>
2344<t hangText="2003-12-13">
2345    Fix inheritance of ed:entered-by attribute. Display note elements inside
2346    change tracking as well.
2347</t>
2348<t hangText="2004-01-18">
2349    When PI compact = 'yes', make most CSS print page breaks conditional.
2350</t>
2351<t hangText="2004-02-20">
2352    Support for RFC3667 IPR changes (xml2rfc 1.22); see
2353    <eref target="http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html"/>.
2354</t>
2355<t hangText="2004-03-11">
2356    Add "(if approved)" to "updates" and "obsoletes" unless the document has
2357    an RFC number.
2358</t>
2359<t hangText="2004-04-01">
2360    Fix RFC3667 output, see <eref target="http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html"/>.
2361</t>
2362<t hangText="2004-04-04">
2363    Add support for section/top attribute. Move references into plain
2364    section container.
2365</t>
2366<t hangText="2004-04-06">
2367    Do not emit identical para anchors for deleted content.
2368</t>
2369<t hangText="2004-04-14">
2370    Fix references TOC generation when there are no references.
2371</t>
2372<t hangText="2004-04-24">
2373    Fix RFC3667 output, see <eref target="http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html"/>.
2374</t>
2375<t hangText="2004-05-09">
2376    Add custom support for generating compound index documents. Add anchors
2377    for each Index letter. Add experimental cref support. Fix conditional page
2378    breaks before References section.
2379</t>
2380<t hangText="2004-05-16">
2381    Refactor external index generation.
2382</t>
2383<t hangText="2004-05-20">
2384    Rewrite anchor generation for comments.
2385</t>
2386<t hangText="2004-05-22">
2387    Enhance issues rendering (add links to changes).
2388</t>
2389<t hangText="2004-05-30">
2390    Allow single quote as delimiter in processing instructions as well. Move
2391    block-level issue pointers to floats. Disable issue pointers for print
2392    media. Add "purple numbers". Add hrefs to section headings. Add non-printing
2393    index key letter list to start of index.
2394</t>
2395<t hangText="2004-06-01">
2396    Use &amp;#xb6; instead of # for PNs.
2397</t>
2398<t hangText="2004-07-18">
2399    Add support for list style=letters (thanks Roy F.). Make PNs optional;
2400    add new PI.
2401</t>
2402<t hangText="2004-09-05">
2403    Fix index links into unnumbered sections.  Bring IPR boilerplate in-line
2404    with xml2rfc 1.25.  Add experimental CSS3 paged media support.  Various
2405    HTML fixes.
2406</t>
2407<t hangText="2004-09-21">
2408    Enhance checking of artwork width.
2409</t>
2410<t hangText="2004-09-26">
2411    Add check for unused references. Uppercase letters in list style letters
2412    when nested into another list.
2413</t>
2414<t hangText="2004-10-10">
2415    Fix internal change track pointers.
2416</t>
2417<t hangText="2004-11-01">
2418    Allow change tracking on references (as a whole).  Rewrite artwork handling
2419    so that it allows change tracking inside artwork.  Also allow a subset of
2420    text markup inside artwork, such as xrefs (note this requires post-processing
2421    the source to make it compliant to RFC2629bis).
2422</t>
2423<t hangText="2004-11-03">
2424    Enhanced placement of iref anchors.
2425</t>
2426<t hangText="2004-11-06">
2427    Index: display irefs that appeared (with primary=true) inside artwork elements
2428    in a monospaced font.
2429</t>
2430<t hangText="2004-11-14">
2431    Add special code so that changes in section titles can be change-tracked.
2432</t>
2433<t hangText="2005-01-14">
2434    Bugfixes for HtmlToXhtml converter.
2435</t>
2436<t hangText="2005-01-22">
2437    Enhance generation of HTML h* elements (for Mozilla Outliner).
2438</t>
2439<t hangText="2005-01-31">
2440    Put vertical space around top-level TOC entries in TOC.  Switch to
2441    pt-based CSS. Re-arrange top section. Make hr elements reflect new-page
2442    settings in TXT output (compact-PI).  Fix page number in footer (CSS
2443    print) and add some more experimental support for paged media (tested
2444    with Prince 4.1 alpha).  Rewrite TOC and Index generation to generate HTML
2445    lists.  Cleanup id generation for paragraphs.  Reduce whitespace in output.
2446    Fix vspace implementation. Use right/left dqoutes and copyright sign
2447    where appropriate.
2448</t>
2449<t hangText="2005-02-04">
2450    Add &lt;link> element to references section.  Fix newly introduced bug
2451    in references processing.
2452</t>
2453<t hangText="2005-02-05">
2454    Integrate various fixes/enhancements by Roy Fielding: spelling of
2455    "Authors' Addresses", comma setting in references, position of "Authors"
2456    section, optionally place authors addresses at end (PI), trailing dots
2457    in section numbers, switch to verdana default font in CSS.  Add
2458    experimental support for centered artwork.
2459</t>
2460<t hangText="2005-02-09">
2461    Fixes in spacing and links of references section titles.  Enhance sorting
2462    in references when change tracking is in place.  Re-add figure centering
2463    support.  Add missing 2nd part of "Author's Adresses" fix.
2464</t>
2465<t hangText="2005-02-25">
2466    Align section number format with xml2rfc1.29.
2467</t>
2468<t hangText="2005-03-28">
2469    Get rid of table elements in Author's section.  Add experimental hCard
2470    (<eref target="http://developers.technorati.com/wiki/hCard"/>) support.
2471</t>
2472<t hangText="2005-04-03">
2473    Add RFC3978-style IPR statement support. (fenner@research.att.com)
2474</t>
2475<t hangText="2005-04-11">
2476    Cleanup author display. hCard related fixes.
2477</t>
2478<t hangText="2005-05-07">
2479    Minor fixes to allow change tracking in doc title.  Add experimental
2480    support for table border styles. CSS cleanup.
2481</t>
2482<t hangText="2005-06-18">
2483    Implement missing support for references to texttables.
2484</t>
2485<t hangText="2005-09-25">
2486    Use (-moz-)column-count when printing the index.
2487</t>
2488<t hangText="2005-10-04">
2489    Report missing element templates with xsl:message.
2490</t>
2491<t hangText="2005-10-15">
2492    Process t/@anchor.
2493</t>
2494<t hangText="2005-10-23">
2495    More workarounds for Mozilla's broken del/ins handling (this time for
2496    figures).
2497</t>
2498<t hangText="2005-10-27">
2499    lowercase hCard class names
2500</t>
2501<t hangText="2005-11-22">
2502    Enhance diagnostics for XML-in-artwork extension
2503</t>
2504<t hangText="2005-11-26">
2505    Fix formatting of section numbers for sections inserted into &lt;back>.
2506</t>
2507<t hangText="2005-12-12">
2508    Fix some validity problems when change tracking occured inside lists.
2509</t>
2510<t hangText="2005-12-18">
2511    Add change tracking inside the index.
2512</t>
2513<t hangText="2006-02-04">
2514    Add prev/next links to highlighted changes (change tracking extension).
2515</t>
2516<t hangText="2006-02-10">
2517    Catch errors instantiating MSXML component.
2518</t>
2519<t hangText="2006-02-11">
2520    References: add "work in progress" for Internet Drafts.
2521</t>
2522<t hangText="2006-02-27">
2523    Fix front matter (lowercase Internet-Draft, say "Intended status" for
2524    non-RFC documents). Start work on experimental extension for 
2525    simplified internal links.
2526</t>
2527<t hangText="2006-03-19">
2528    Tweaks to IESG Copyright stuff; support submissionType attribute.
2529    Fix duplicate reference anchors in HTML output.  Reduce HTML Tidy warnings.
2530    Fix reference to normative ASCII version (now requires trailing ".txt").
2531    Tweaks to hCard generation.  Started to move non-issue-tracking
2532    extensions into namespace "http://purl.org/net/xml2rfc/ext".
2533</t>
2534<t hangText="2006-03-27">
2535    Moved "simple reference" extension into namespace "http://purl.org/net/xml2rfc/ext"
2536    and add documentation.  HTML conformance enhancements.
2537</t>
2538<t hangText="2006-04-02">
2539    Cleanup special code for automated XHTML XSLT generation.
2540</t>
2541<t hangText="2006-04-21">
2542    Generate &lt;CITE> elements where appropiate.
2543    Introduce x:blockquote, x:dfn, x:h and x:q elements.
2544</t>
2545<t hangText="2006-05-06">
2546    Introduce x:bcp14 element.
2547</t>
2548<t hangText="2006-05-14">
2549  Fix content model for x:blockquote.
2550</t>
2551<t hangText="2006-06-18">
2552  Add box drawing support (x:bt, x:bc, x:bb).
2553</t>
2554<t hangText="2006-06-20">
2555  HTML validity fixes (legal chars in anchors in index).
2556</t>
2557<t hangText="2006-06-24">
2558  Reduce leading empty lines in artwork. Move &lt;dt> style info into CSS.
2559</t>
2560<t hangText="2006-07-14">
2561  Fix rendering of multiple street address entries (missing line break).
2562</t>
2563<t hangText="2006-07-24">
2564  Add extension for deep linking into RFCs, do not generate empty list
2565  items in TOC output, avoid empty &lt;dt> elements for list items
2566  without hangText attribute.
2567</t>
2568<t hangText="2006-08-01">
2569  Allow @anchor on more elements; start work on Relax NG grammar for
2570  extensions. Reduce generated style elements (use CSS classes instead).
2571  Consistently use "id" instead of "name". Change default target for RFC
2572  links to "http://tools.ietf.org/html/rfcNNNN".
2573</t>
2574<t hangText="2006-08-06">
2575  Include appendices defined in &lt;appendix> elements in TOC (please
2576  consider them deprecated anyhow!). Generate links to
2577  "http://tools.ietf.org/html/draft-*" for Internet Drafts.
2578  Replace x:frag by x:rel, allowing any kind of relative reference instead
2579  of just fragments.
2580</t>
2581<t hangText="2006-08-30">
2582  Reduce textual differences between HTML output and what xml2rfc produces
2583  in TXT output mode (section refs/reference targets). Add small workaround
2584  for Opera 9.0.1's problem with node-set().
2585</t>
2586<t hangText="2006-10-29">
2587  Fix problem generating internal links to change markup within references
2588  section. Enhancements when generating numbered references for deleted
2589  references.
2590  Allow inclusion of references into the index (through include-references-in-index
2591  extension).
2592  Fix a bug that caused the newer version of the IETF boilerplate to be
2593  produced rather than the pre-RFC3667 one.
2594  Update to RFC4287 boilerplate.
2595</t>
2596<t hangText="2006-11-11">
2597  Add extension attribute x:for-anchor to &lt;iref&gt; handling.
2598</t>
2599<t hangText="2006-11-26">
2600  Experimental (and limited) support for &lt;x:lt&gt;.
2601</t>
2602<t hangText="2006-12-04">
2603  Fix bugs in processing documents that have both the ipr and the number attribute
2604  set on the rfc root element. Add support for x:fmt='none' on xrefs.
2605  Add different pre style based on artwork type attributes (experimental).
2606</t>
2607<t hangText="2006-12-13">
2608  Add x:fmt='anchor' for xref elements.
2609</t>
2610<t hangText="2007-01-07">
2611  Fix root template for compatibility for the exslt:node-set implementation
2612  in Firefox3.
2613</t>
2614<t hangText="2007-01-29">
2615  Avoid empty table entry in front matter when organization is not specified
2616  for an author.
2617</t>
2618<t hangText="2007-02-10">
2619  Allow change tracking in table rows.
2620</t>
2621<t hangText="2007-03-09">
2622  Add hcard profile URI (<eref target="http://www.w3.org/2006/03/hcard"/>) to head element.
2623  Add warning for misplaced &lt;t> elements (after section).
2624</t>
2625<t hangText="2007-03-21">
2626  Fix internal linking from reference entries in index for some xref types.
2627  Minor CSS tweaks contributed by MTR. Allow turning on text justification through
2628  a PI. Improve iref anchor generation to generate less instable anchors.
2629</t>
2630<t hangText="2007-03-28">
2631  Fixes for numbering of ed:inserted references sections.
2632</t>
2633<t hangText="2007-05-04">
2634  Do not generate anchors for edits in deleted sections. Enhance HTML
2635  conformance.
2636</t>
2637<t hangText="2007-05-19">
2638  Enhance diagnostics when using Saxon (needs Saxon's "-l" command line
2639  parameter to keep line number information). Add warning when symref PI
2640  is missing (default will change in the future).
2641  Add support for overriding computed section numbers (when formatting
2642  historic documents).
2643</t>
2644<t hangText="2007-06-07">
2645  Change default for symrefs PI to "yes" (see change in xml2rfc 1.33pre4).
2646  Warn about docName attributes that appear to contain a file extension.
2647</t>
2648<t hangText="2007-06-26">
2649  Workaround author/@initials values without trailing dot, as in xml2rfc.tcl.
2650</t>
2651<t hangText="2007-07-14">
2652  Enhance index generation for references that use @x:sec attribute.
2653</t>
2654<t hangText="2007-09-09">
2655  Fix: sortrefs is a nop when symrefs=no.
2656</t>
2657<t hangText="2007-10-17">
2658  Work in progress: add support for referencing sections in sibling
2659  documents by anchor name.
2660</t>
2661<t hangText="2007-10-17">
2662  Work in progress (continued): support for referencing sections in sibling
2663  documents by anchor name.
2664</t>
2665<t hangText="2007-12-31">
2666  Emit warning when updating/obsoleting stuff that's not referenced.
2667</t>
2668<t hangText="2008-02-03">
2669  Support xml2rfc-1.33pre5's suppress-title attribute on texttable and figure.
2670</t>
2671<t hangText="2008-02-06">
2672  Extension: allow &lt;eref> below &lt;cref>.
2673</t>
2674<t hangText="2008-02-17">
2675  Extensions: add x:span and x:length-of.
2676</t>
2677<t hangText="2008-02-20">
2678  Add new RFC boilerplate (as changed in 2007-08).
2679</t>
2680<t hangText="2008-02-27">
2681  Improve diagnostics for artwork width problems; add defaulting of publication
2682  dates (requires XSLT processor supporting exslt:date, or msxml).
2683</t>
2684<t hangText="2008-02-29">
2685  Enhance CSS for link elements in the front header, update rules for
2686  generating "Acknowledgment" statement.
2687</t>
2688<t hangText="2008-03-01">
2689  Use line numbers in diagnostics in Saxon8/9 as well.
2690</t>
2691<t hangText="2008-03-02">
2692  Fix a bug in the logic choosing the boilerplate, resulting in obsolete
2693  text being inserted into IDs.
2694</t>
2695<t hangText="2008-04-01">
2696  Add support for superscript element.
2697</t>
2698<t hangText="2008-06-28">
2699  Add sanity checks for email addresses, allow multiple email elements.
2700</t>
2701<t hangText="2008-07-06">
2702  Add x:abnf-char-sequence.
2703</t>
2704      </list></t>
2705    </section>
2706    <section title="rfc2629toFO.xslt">
2707      <t><list style="hanging">
2708<t hangText="2003-11-16">
2709    Initial release.
2710</t>
2711<t hangText="2003-11-29">
2712    Enhance handling of unknown list styles.
2713</t>
2714<t hangText="2004-04-04">
2715    Update reference section handling.
2716</t>
2717<t hangText="2004-04-17">
2718    Use XSL-WD-1.1-style fo:bookmark and index handling and add postprocessors for
2719    existing implementations. Unify PDF info generation by using XEP (postprocessors)
2720    will convert.
2721</t>
2722<t hangText="2004-04-20">
2723    Add experimental cref support.
2724</t>
2725<t hangText="2004-06-14">
2726    Set correct index-item defaults.
2727</t>
2728<t hangText="2004-07-18">
2729    Add list style=letters.
2730</t>
2731<t hangText="2004-09-03">
2732    Make URLs in text break where they are allowed to break by inserting
2733    zero-width spaces.
2734</t>
2735<t hangText="2004-09-26">
2736    Fix letter-style inside nested lists.
2737</t>
2738<t hangText="2004-10-31">
2739    Update handling of artwork.
2740</t>
2741<t hangText="2004-11-13">
2742    Fix handling of references inside ed:* markup.  Fix whitespace handling
2743    in artwork.
2744</t>
2745<t hangText="2004-11-27">
2746    Irefs in artwork generate monospaced entries in index.
2747</t>
2748<t hangText="2005-01-31">
2749    Fix TOC generation that was broken after changes in main XSLT.
2750</t>
2751<t hangText="2005-02-05">
2752    Bring in sync with cosmetic changes in rfc2629.xslt.
2753</t>
2754<t hangText="2005-05-07">
2755    Minor fix for change tracking in document title.  Support for table
2756    styles.
2757</t>
2758<t hangText="2005-06-18">
2759    Fix references to tables.
2760</t>
2761<t hangText="2005-10-15">
2762    Process t/@anchor.
2763</t>
2764<t hangText="2006-02-11">
2765    References: add "work in progress" for Internet Drafts.
2766</t>
2767<t hangText="2006-06-02">
2768    Use XSL 1.1 WD Feb 2006.
2769</t>
2770<t hangText="2007-03-21">
2771    Support optional text justification.
2772</t>
2773<t hangText="2007-05-19">
2774    Various improvements in spacing; also allow overriding the automatic
2775    list indentation via list/x:indent.
2776</t>
2777     </list></t>
2778    </section>
2779
2780    <section title="xsl11toAn.xslt">
2781    <t><list style="hanging">
2782<t hangText="2004-05-17">
2783     Initial release.
2784</t>
2785<t hangText="2006-06-02">
2786    Use XSL 1.1 WD Feb 2006.
2787</t>
2788    </list></t>
2789    </section>
2790
2791    <section title="xsl11toFop.xslt">
2792    <t><list style="hanging">
2793<t hangText="2004-05-17">
2794     Initial release.
2795</t>
2796<t hangText="2006-06-02">
2797    Use XSL 1.1 WD Feb 2006.
2798</t>
2799    </list></t>
2800    </section>
2801
2802    <section title="xsl11toFop-0.93.xslt">
2803    <t><list style="hanging">
2804<t hangText="2008-03-15">
2805    Add a workaround to the fo:inline workaround (sigh).
2806</t>
2807    </list></t>
2808    </section>
2809
2810    <section title="xsl11toXep.xslt">
2811    <t><list style="hanging">
2812<t hangText="2004-05-17">
2813     Initial release.
2814</t>
2815<t hangText="2004-09-04">
2816     Fix xep:index-item attributes.
2817</t>
2818<t hangText="2006-06-02">
2819    Use XSL 1.1 WD Feb 2006.
2820</t>
2821    </list></t>
2822    </section>
2823  </section>
2824
2825</back>
2826</rfc>
Note: See TracBrowser for help on using the repository browser.