source: rfc2629xslt/rfc2629xslt.txt @ 704

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

Bump up document dates, update to latest versions of rfc2629.xslt and xml2rfc.tcl

  • Property svn:eol-style set to native
File size: 114.9 KB
Line 
1
2
3
4RFC2629 through XSLT                                          J. Reschke
5                                                              greenbytes
6                                                          September 2009
7
8
9            Transforming RFC2629-formatted XML through XSLT
10
11
12Table of Contents
13
14   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
15   2.  Supported RFC2629 elements . . . . . . . . . . . . . . . . . .  4
16     2.1.   Extension elements  . . . . . . . . . . . . . . . . . . .  4
17   3.  Processing Instructions  . . . . . . . . . . . . . . . . . . .  5
18     3.1.   Supported xml2rfc-compatible PIs  . . . . . . . . . . . .  6
19     3.2.   Unsupported xml2rfc-compatible PIs  . . . . . . . . . . .  7
20     3.3.   Extension PIs . . . . . . . . . . . . . . . . . . . . . .  8
21   4.  Anchors  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
22   5.  Supported XSLT engines . . . . . . . . . . . . . . . . . . . . 14
23     5.1.   Standalone Engines  . . . . . . . . . . . . . . . . . . . 14
24     5.2.   In-Browser Engines  . . . . . . . . . . . . . . . . . . . 14
25   6.  Transforming to HTML . . . . . . . . . . . . . . . . . . . . . 16
26     6.1.   HTML compliance . . . . . . . . . . . . . . . . . . . . . 16
27     6.2.   Standard HTML LINK elements . . . . . . . . . . . . . . . 16
28     6.3.   Standard HTML metadata  . . . . . . . . . . . . . . . . . 17
29     6.4.   Dublin Core (RFC2731) metadata  . . . . . . . . . . . . . 17
30     6.5.   Experimental hCard support  . . . . . . . . . . . . . . . 17
31   7.  Transforming to XHTML  . . . . . . . . . . . . . . . . . . . . 18
32   8.  Transforming to CHM (Microsoft Compiled Help)  . . . . . . . . 19
33   9.  Transforming to PDF  . . . . . . . . . . . . . . . . . . . . . 20
34     9.1.   Via XSL-FO  . . . . . . . . . . . . . . . . . . . . . . . 20
35       9.1.1.  Extension feature matrix . . . . . . . . . . . . . . . 20
36       9.1.2.  Example: producing output for Apache FOP . . . . . . . 21
37     9.2.   Via X(HTML) . . . . . . . . . . . . . . . . . . . . . . . 21
38   10. Generic Extensions . . . . . . . . . . . . . . . . . . . . . . 22
39     10.1.  <abnf-char-sequence> element  . . . . . . . . . . . . . . 22
40     10.2.  <anchor-alias> element  . . . . . . . . . . . . . . . . . 22
41     10.3.  <bcp14> element . . . . . . . . . . . . . . . . . . . . . 22
42     10.4.  <bb> element  . . . . . . . . . . . . . . . . . . . . . . 23
43     10.5.  <bc> element  . . . . . . . . . . . . . . . . . . . . . . 23
44     10.6.  <blockquote> element  . . . . . . . . . . . . . . . . . . 23
45     10.7.  <boilerplate> element . . . . . . . . . . . . . . . . . . 23
46     10.8.  <bt> element  . . . . . . . . . . . . . . . . . . . . . . 24
47     10.9.  <dfn> element . . . . . . . . . . . . . . . . . . . . . . 24
48     10.10. <h> element . . . . . . . . . . . . . . . . . . . . . . . 24
49     10.11. <highlight> element . . . . . . . . . . . . . . . . . . . 24
50     10.12. <length-of> element . . . . . . . . . . . . . . . . . . . 24
51     10.13. <link> element  . . . . . . . . . . . . . . . . . . . . . 24
52
53
54
55Reschke                                                         [Page 1]
56
57Documentation             RFC2629 through XSLT            September 2009
58
59
60     10.14. <lt> element  . . . . . . . . . . . . . . . . . . . . . . 25
61     10.15. <note> element  . . . . . . . . . . . . . . . . . . . . . 25
62     10.16. <parse-xml> element . . . . . . . . . . . . . . . . . . . 25
63     10.17. <q> element . . . . . . . . . . . . . . . . . . . . . . . 25
64     10.18. <ref> element . . . . . . . . . . . . . . . . . . . . . . 25
65     10.19. <source> element  . . . . . . . . . . . . . . . . . . . . 26
66     10.20. <sup> element . . . . . . . . . . . . . . . . . . . . . . 26
67     10.21. Extensions to Xml2rfc <artwork> element . . . . . . . . . 26
68     10.22. Extensions to Xml2rfc <iref> element  . . . . . . . . . . 26
69     10.23. Extensions to Xml2rfc <list> element  . . . . . . . . . . 27
70     10.24. Extensions to Xml2rfc <rfc> element . . . . . . . . . . . 27
71     10.25. Extensions to Xml2rfc <section> element . . . . . . . . . 27
72     10.26. Extensions to Xml2rfc <xref> element  . . . . . . . . . . 27
73   11. Utilities  . . . . . . . . . . . . . . . . . . . . . . . . . . 29
74     11.1.  Checking References . . . . . . . . . . . . . . . . . . . 29
75     11.2.  Generating Graphs from References . . . . . . . . . . . . 31
76     11.3.  Producing reference entries for books . . . . . . . . . . 31
77     11.4.  Down-converting to RFC2629bis DTD . . . . . . . . . . . . 32
78     11.5.  Extracting artwork  . . . . . . . . . . . . . . . . . . . 32
79     11.6.  GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 33
80   12. Informative References . . . . . . . . . . . . . . . . . . . . 34
81   Appendix A.  RELAX NG Compact Schema . . . . . . . . . . . . . . . 36
82   Appendix B.  Implementation Notes  . . . . . . . . . . . . . . . . 46
83     B.1.   Recognized type attributes for <artwork> element  . . . . 46
84   Appendix C.  Examples  . . . . . . . . . . . . . . . . . . . . . . 47
85     C.1.   Using the 'Internal Subset' . . . . . . . . . . . . . . . 47
86     C.2.   Customization . . . . . . . . . . . . . . . . . . . . . . 47
87   Appendix D.  License . . . . . . . . . . . . . . . . . . . . . . . 49
88   Appendix E.  Change Logs . . . . . . . . . . . . . . . . . . . . . 50
89     E.1.   Package . . . . . . . . . . . . . . . . . . . . . . . . . 50
90     E.2.   amazon-asin.xslt  . . . . . . . . . . . . . . . . . . . . 51
91     E.3.   check-references.xslt . . . . . . . . . . . . . . . . . . 51
92     E.4.   gen-reference-graph.xslt  . . . . . . . . . . . . . . . . 51
93     E.5.   rfc2629.xslt  . . . . . . . . . . . . . . . . . . . . . . 52
94     E.6.   rfc2629toFO.xslt  . . . . . . . . . . . . . . . . . . . . 63
95     E.7.   xsl11toAn.xslt  . . . . . . . . . . . . . . . . . . . . . 64
96     E.8.   xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 64
97     E.9.   xsl11toFop-0.95.xslt  . . . . . . . . . . . . . . . . . . 64
98     E.10.  xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 64
99   Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
100   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 74
101
102
103
104
105
106
107
108
109
110
111Reschke                                                         [Page 2]
112
113Documentation             RFC2629 through XSLT            September 2009
114
115
1161.  Introduction
117
118   This document describes a set of XSLT transformations that can be
119   used to transform RFC2629-compliant XML (see [RFC2629]) to various
120   output formats, such as HTML and PDF.  The main topics are
121
122   o  compliance to the xml2rfc XML element set (Section 2),
123
124   o  support for xml2rfc processing instructions (Section 3),
125
126   o  the names of anchor elements generated in HTML and PDF output
127      (Section 4),
128
129   o  various XSLT engines that can be used (Section 5),
130
131   o  outputting HTML (Section 6) and XHTML (Section 7),
132
133   o  outputting CHM (Compiled Microsoft Help, Section 8),
134
135   o  outputting PDF (Section 9),
136
137   o  extensions to the xml2rfc vocabulary (Section 10).
138
139   o  various utilities (Section 11).
140
141   The full distribution is available at
142   <http://greenbytes.de/tech/webdav/rfc2629xslt.zip>.
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167Reschke                                                         [Page 3]
168
169Documentation             RFC2629 through XSLT            September 2009
170
171
1722.  Supported RFC2629 elements
173
174   "rfc2629.xslt" supports both all RFC2629 grammar elements and the
175   extensions implemented in xml2rfc 1.33.
176
1772.1.  Extension elements
178
179   "rfc2629.xslt" supports two kind of extension elements, using
180   different XML namespaces.
181
182   The first set contains (hopefully) generally useful extensions, see
183   Section 10.
184
185   The second set is used for change and issue tracking and currently is
186   not documented here.  Please email the author in case you're
187   interested in using these extensions.
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223Reschke                                                         [Page 4]
224
225Documentation             RFC2629 through XSLT            September 2009
226
227
2283.  Processing Instructions
229
230   All PIs can be set as XSLT parameter as well, overriding any value
231   that is found in the source file to be transformed.
232
233   Using processing instructions:
234
235   <?rfc toc="yes"?>
236   <?rfc-ext support-rfc2731="no"?>
237
238   Using XSLT parameters (Saxon):
239
240   java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \
241     xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html
242
243   Using XSLT parameters (xsltproc):
244
245   xsltproc --param xml2rfc-toc '"yes"' \
246      --param xml2rfc-ext-support-rfc2731 '"no"' \
247      rfc2629.xslt source.xml > result.html
248
249   (note the required quoting of string parameters)
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279Reschke                                                         [Page 5]
280
281Documentation             RFC2629 through XSLT            September 2009
282
283
2843.1.  Supported xml2rfc-compatible PIs
285
286   +------+--------------+------------------+------------+-------------+
287   | PI   | PI           | XSLT parameter   | default    | comment     |
288   | targ | pseudo-attri | name             |            |             |
289   | et   | bute         |                  |            |             |
290   +------+--------------+------------------+------------+-------------+
291   | rfc  | background   | xml2rfc-backgrou | (not set)  |             |
292   |      |              | nd               |            |             |
293   |      |              |                  |            |             |
294   | rfc  | compact      | xml2rfc-compact  | "no"       | only        |
295   |      |              |                  |            | applies to  |
296   |      |              |                  |            | HTML output |
297   |      |              |                  |            | method when |
298   |      |              |                  |            | printing    |
299   |      |              |                  |            |             |
300   | rfc  | comments     | xml2rfc-comments | (not set)  |             |
301   |      |              |                  |            |             |
302   | rfc  | editing      | xml2rfc-editing  | "no"       |             |
303   |      |              |                  |            |             |
304   | rfc  | footer       | xml2rfc-footer   | (not set)  |             |
305   |      |              |                  |            |             |
306   | rfc  | header       | xml2rfc-header   | (not set)  |             |
307   |      |              |                  |            |             |
308   | rfc  | inline       | xml2rfc-inline   | (not set)  |             |
309   |      |              |                  |            |             |
310   | rfc  | iprnotified  | xml2rfc-iprnotif | "no"       |             |
311   |      |              | ied              |            |             |
312   |      |              |                  |            |             |
313   | rfc  | linkmailto   | xml2rfc-linkmail | "yes"      |             |
314   |      |              | to               |            |             |
315   |      |              |                  |            |             |
316   | rfc  | private      | xml2rfc-private  | (not set)  |             |
317   |      |              |                  |            |             |
318   | rfc  | refparent    | xml2rfc-private  | "Reference | Title for   |
319   |      |              |                  | s"         | References  |
320   |      |              |                  |            | sections    |
321   |      |              |                  |            | when        |
322   |      |              |                  |            | automatical |
323   |      |              |                  |            | ly inserted |
324   |      |              |                  |            |             |
325   | rfc  | rfcedstyle   | xml2rfc-rfcedsty | (not set)  | (limited    |
326   |      |              | le               |            | support)    |
327   |      |              |                  |            |             |
328   | rfc  | sortrefs     | xml2rfc-sortrefs | "no"       |             |
329   |      |              |                  |            |             |
330
331
332
333
334
335Reschke                                                         [Page 6]
336
337Documentation             RFC2629 through XSLT            September 2009
338
339
340   | rfc  | symrefs      | xml2rfc-symrefs  | "yes"      | The default |
341   |      |              |                  |            | has changed |
342   |      |              |                  |            | from "no"   |
343   |      |              |                  |            | to "yes" as |
344   |      |              |                  |            | of June 6,  |
345   |      |              |                  |            | 2007 and    |
346   |      |              |                  |            | xml2rfc     |
347   |      |              |                  |            | 1.33pre4.   |
348   |      |              |                  |            |             |
349   | rfc  | toc          | xml2rfc-toc      | "no"       |             |
350   |      |              |                  |            |             |
351   | rfc  | tocdepth     | xml2rfc-tocdepth | 99         |             |
352   |      |              |                  |            |             |
353   | rfc  | topblock     | xml2rfc-topblock | "yes"      |             |
354   +------+--------------+------------------+------------+-------------+
355
3563.2.  Unsupported xml2rfc-compatible PIs
357
358   +--------+------------------+---------------------------------------+
359   | PI     | PI               | comment                               |
360   | target | pseudo-attribute |                                       |
361   +--------+------------------+---------------------------------------+
362   | rfc    | include          | incompatible with XML/XSLT processing |
363   |        |                  | model, please use external entities   |
364   |        |                  | instead                               |
365   |        |                  |                                       |
366   | rfc    | needLines        |                                       |
367   |        |                  |                                       |
368   | rfc    | slides           |                                       |
369   |        |                  |                                       |
370   | rfc    | strict           |                                       |
371   |        |                  |                                       |
372   | rfc    | subcompact       |                                       |
373   |        |                  |                                       |
374   | rfc    | tocindent        | (defaults to "yes")                   |
375   |        |                  |                                       |
376   | rfc    | tocompact        |                                       |
377   +--------+------------------+---------------------------------------+
378
379
380
381
382
383
384
385
386
387
388
389
390
391Reschke                                                         [Page 7]
392
393Documentation             RFC2629 through XSLT            September 2009
394
395
3963.3.  Extension PIs
397
398   +------+-----------------+-----------------------+------+-----------+
399   | PI   | PI              | XSLT parameter name   | defa | descripti |
400   | targ | pseudo-attribut |                       | ult  | on        |
401   | et   | e               |                       |      |           |
402   +------+-----------------+-----------------------+------+-----------+
403   | rfc- | allow-markup-in | xml2rfc-allow-markup- | "no" | Enables   |
404   | ext  | -artwork        | in-artwork            |      | support   |
405   |      |                 |                       |      | for       |
406   |      |                 |                       |      | specific  |
407   |      |                 |                       |      | elements  |
408   |      |                 |                       |      | inside    |
409   |      |                 |                       |      | abstract  |
410   |      |                 |                       |      | elements  |
411   |      |                 |                       |      | (using    |
412   |      |                 |                       |      | this      |
413   |      |                 |                       |      | extension |
414   |      |                 |                       |      | makes the |
415   |      |                 |                       |      | document  |
416   |      |                 |                       |      | incompati |
417   |      |                 |                       |      | ble to    |
418   |      |                 |                       |      | the       |
419   |      |                 |                       |      | RFC2629bi |
420   |      |                 |                       |      | s DTD;    |
421   |      |                 |                       |      | see       |
422   |      |                 |                       |      | descripti |
423   |      |                 |                       |      | on of     |
424   |      |                 |                       |      | conversio |
425   |      |                 |                       |      | n XSLT in |
426   |      |                 |                       |      | Section 1 |
427   |      |                 |                       |      | 1.4).     |
428   |      |                 |                       |      |           |
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447Reschke                                                         [Page 8]
448
449Documentation             RFC2629 through XSLT            September 2009
450
451
452   | rfc- | authors-section | xml2rfc-ext-authors-s |      | When      |
453   | ext  |                 | ection                |      | "end",    |
454   |      |                 |                       |      | place the |
455   |      |                 |                       |      | authors   |
456   |      |                 |                       |      | section   |
457   |      |                 |                       |      | at the    |
458   |      |                 |                       |      | end (just |
459   |      |                 |                       |      | before    |
460   |      |                 |                       |      | the       |
461   |      |                 |                       |      | copyright |
462   |      |                 |                       |      | statement |
463   |      |                 |                       |      | s). This  |
464   |      |                 |                       |      | seems to  |
465   |      |                 |                       |      | be the    |
466   |      |                 |                       |      | preferred |
467   |      |                 |                       |      | order in  |
468   |      |                 |                       |      | the       |
469   |      |                 |                       |      | newest    |
470   |      |                 |                       |      | RFCs.     |
471   |      |                 |                       |      |           |
472   | rfc- | duplex          | xml2rfc-ext-duplex    | no   | When set  |
473   | ext  |                 |                       |      | to "yes", |
474   |      |                 |                       |      | format    |
475   |      |                 |                       |      | the PDF   |
476   |      |                 |                       |      | output    |
477   |      |                 |                       |      | for       |
478   |      |                 |                       |      | doublesid |
479   |      |                 |                       |      | ed        |
480   |      |                 |                       |      | printing. |
481   |      |                 |                       |      |           |
482   | rfc- | include-referen | xml2rfc-ext-include-r |      | When set  |
483   | ext  | ces-in-index    | eferences-in-index    |      | to "yes", |
484   |      |                 |                       |      | index     |
485   |      |                 |                       |      | entries   |
486   |      |                 |                       |      | are       |
487   |      |                 |                       |      | generated |
488   |      |                 |                       |      | for all   |
489   |      |                 |                       |      | reference |
490   |      |                 |                       |      | s.        |
491   |      |                 |                       |      |           |
492
493
494
495
496
497
498
499
500
501
502
503Reschke                                                         [Page 9]
504
505Documentation             RFC2629 through XSLT            September 2009
506
507
508   | rfc- | justification   | xml2rfc-ext-justifica | "nev | "never":  |
509   | ext  |                 | tion                  | er"  | never     |
510   |      |                 |                       |      | emit      |
511   |      |                 |                       |      | justified |
512   |      |                 |                       |      | text,     |
513   |      |                 |                       |      | "always": |
514   |      |                 |                       |      | always    |
515   |      |                 |                       |      | emit      |
516   |      |                 |                       |      | justified |
517   |      |                 |                       |      | text,     |
518   |      |                 |                       |      | "print":  |
519   |      |                 |                       |      | only emit |
520   |      |                 |                       |      | justified |
521   |      |                 |                       |      | text for  |
522   |      |                 |                       |      | print     |
523   |      |                 |                       |      | media.    |
524   |      |                 |                       |      |           |
525   | rfc- | parse-xml-in-ar | xml2rfc-parse-xml-in- | "no" | May be    |
526   | ext  | twork           | artwork               |      | used to   |
527   |      |                 |                       |      | enable    |
528   |      |                 |                       |      | parsing   |
529   |      |                 |                       |      | of XML    |
530   |      |                 |                       |      | content   |
531   |      |                 |                       |      | in        |
532   |      |                 |                       |      | figures   |
533   |      |                 |                       |      | (MSXML    |
534   |      |                 |                       |      | only).    |
535   |      |                 |                       |      |           |
536   | rfc- | support-rfc2731 | xml2rfc-ext-support-r | "yes | Decides   |
537   | ext  |                 | fc2731                | "    | whether   |
538   |      |                 |                       |      | the HTML  |
539   |      |                 |                       |      | transform |
540   |      |                 |                       |      | ation     |
541   |      |                 |                       |      | should    |
542   |      |                 |                       |      | generate  |
543   |      |                 |                       |      | META tags |
544   |      |                 |                       |      | according |
545   |      |                 |                       |      | Section 6 |
546   |      |                 |                       |      | .4.       |
547   |      |                 |                       |      |           |
548
549
550
551
552
553
554
555
556
557
558
559Reschke                                                        [Page 10]
560
561Documentation             RFC2629 through XSLT            September 2009
562
563
564   | rfc- | sec-no-trailing | xml2rfc-ext-sec-no-tr |      | When set  |
565   | ext  | -dots           | ailing-dots           |      | to "yes", |
566   |      |                 |                       |      | add       |
567   |      |                 |                       |      | trailing  |
568   |      |                 |                       |      | dots to   |
569   |      |                 |                       |      | section   |
570   |      |                 |                       |      | numbers.  |
571   |      |                 |                       |      | This      |
572   |      |                 |                       |      | seems to  |
573   |      |                 |                       |      | be the    |
574   |      |                 |                       |      | preferred |
575   |      |                 |                       |      | format in |
576   |      |                 |                       |      | the       |
577   |      |                 |                       |      | newest    |
578   |      |                 |                       |      | RFCs.     |
579   +------+-----------------+-----------------------+------+-----------+
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615Reschke                                                        [Page 11]
616
617Documentation             RFC2629 through XSLT            September 2009
618
619
6204.  Anchors
621
622   The transformation automatically generates anchors that are supposed
623   to be stable and predictable and that can be used to identify
624   specific parts of the document.  Anchors are generated both in HTML
625   and XSL-FO content (but the latter will only be used for PDF output
626   when the XSL-FO engine supports producing PDF anchors).
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671Reschke                                                        [Page 12]
672
673Documentation             RFC2629 through XSLT            September 2009
674
675
676                 The following anchors get auto-generated:
677
678     +-----------------------+---------------------------------------+
679     | Anchor name           | Description                           |
680     +-----------------------+---------------------------------------+
681     | rfc.abstract          | Abstract                              |
682     |                       |                                       |
683     | rfc.authors           | Authors section                       |
684     |                       |                                       |
685     | rfc.copyright         | Copyright section                     |
686     |                       |                                       |
687     | rfc.copyrightnotice   | Copyright notice                      |
688     |                       |                                       |
689     | rfc.figure._n_        | Figures (titled)                      |
690     |                       |                                       |
691     | rfc.figure.u._n_      | Figures (untitled)                    |
692     |                       |                                       |
693     | rfc.index             | Index                                 |
694     |                       |                                       |
695     | rfc.ipr               | Intellectual Property                 |
696     |                       |                                       |
697     | rfc.iref._n_          | Internal references                   |
698     |                       |                                       |
699     | rfc.note._n_          | Notes (from front section)            |
700     |                       |                                       |
701     | rfc.references        | References                            |
702     |                       |                                       |
703     | rfc.references._n_    | Additional references                 |
704     |                       |                                       |
705     | rfc.section._n_       | Section _n_                           |
706     |                       |                                       |
707     | rfc.section._n_.p._m_ | Section _n_, paragraph _m_            |
708     |                       |                                       |
709     | rfc.status            | Status of memo                        |
710     |                       |                                       |
711     | rfc.table._n_         | Tables (titled)                       |
712     |                       |                                       |
713     | rfc.table.u._n_       | Tables (untitled)                     |
714     |                       |                                       |
715     | rfc.toc               | Table of contents                     |
716     |                       |                                       |
717     | rfc.xref._name_._n_   | References to reference _n_ to _name_ |
718     +-----------------------+---------------------------------------+
719
720
721
722
723
724
725
726
727Reschke                                                        [Page 13]
728
729Documentation             RFC2629 through XSLT            September 2009
730
731
7325.  Supported XSLT engines
733
734   The transformation requires a non-standard extension function (see
735   exsl:node-set [1]) which is however widely available.  XSLT
736   processors that do not support this extension (or a functional
737   equivalent) currently are not supported.
738
7395.1.  Standalone Engines
740
741   The following XSLT engines are believed to work well:
742
743   o  Windows: MSXML3 and MSXML4 (<http://msdn.microsoft.com/xml>;
744      command line processor "msxsl" is available from Microsoft
745      Download Center [2])
746
747   o  Java: Saxon (<http://saxon.sourceforge.net/>)
748
749   o  Java: Xalan (<http://xml.apache.org/xalan-j/>)
750
751   o  C/C++: xsltproc (libxslt) (<http://xmlsoft.org/XSLT/>, make sure
752      that you have a current version)
753
7545.2.  In-Browser Engines
755
756   The following browsers seem to work fine:
757
758   o  Internet Explorer 5.5 (Windows version, if MSXML3 is installed)
759
760   o  Internet Explorer 6 and newer
761
762   o  Firefox 3.0 and newer
763
764
765      *  Be aware that XSLT execution can be suppressed using
766         NoScript [3]
767
768      *  Firefox does not load external DTDs nor external entities, see
769         Mozilla Bug 22942 [4], thus entities like &nbsp; need to be
770         declared in the internal subset (Appendix C.1)
771
772   o  Safari 3 (starting with version 3.0.4)
773
774   o  Google Chrome (beta available)
775
776   o  Opera 10 (beta version available)
777
778   The following browsers are known not to work properly:
779
780
781
782
783Reschke                                                        [Page 14]
784
785Documentation             RFC2629 through XSLT            September 2009
786
787
788   o  Firefox 1.*/2.*: (missing extension function - see change request
789      at Mozilla BugZilla 193678 [5])
790
791   o  Opera 9.21: execution fails, potentially to a somewhat complex
792      XPath expression (reported to Opera as bug 245725).
793
794   o  Opera 9.5 and 9.6: transformation appears to work, but CSS isn't
795      getting applied (reported to Opera as bug 337388 on 2008-06-12).
796
797   o  Safari 2.* supports client-side XSLT as of MacOS X 10.4, but
798      misses required extension functions.  A problem with stylesheets
799      producing non-ASCII output (such as NBSP characters) has been
800      fixed as of OSX 10.4.4.  Both problems have been reported through
801      Apple's bug tracking system, see <http://drakken.dbc.mtview.ca.us/
802      pipermail/xml2rfc/2005-May/002073.html> and
803      <http://bugs.webkit.org/show_bug.cgi?id=4079>.
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839Reschke                                                        [Page 15]
840
841Documentation             RFC2629 through XSLT            September 2009
842
843
8446.  Transforming to HTML
845
846   Transformation to HTML can be done inside the browser if it supports
847   XSLT.  To enable this, add the following processing instruction to
848   the start of the source file:
849
850     <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
851
852   (and ensure that "rfc2629.xslt" is present).
853
8546.1.  HTML compliance
855
856   The transformation result is supposed to conform to the HTML 4.01
857   strict DTD [HTML].  This can be checked using the W3C's online
858   validator at <http://validator.w3.org>.
859
8606.2.  Standard HTML LINK elements
861
862   LINK elements exist since HTML 2.0.  They can be used to embed
863   content-independant links inside the document.  Unfortunately, only
864   few user agents support this element.  Firefox users may want to
865   check the Link Widgets [6] extension.
866
867                 The following LINK elements are produced:
868
869   +-----------+-------------------------------------------------------+
870   | LINK type | description                                           |
871   +-----------+-------------------------------------------------------+
872   | alternate | for RFCs, a link to the authorative ASCII version on  |
873   |           | the IETF web site                                     |
874   |           |                                                       |
875   | appendic  | pointer to all top-level appendics                    |
876   |           |                                                       |
877   | author    | pointer to "authors" section                          |
878   |           |                                                       |
879   | chapter   | pointer to all top-level sections                     |
880   |           |                                                       |
881   | contents  | pointer to table of contents                          |
882   |           |                                                       |
883   | copyright | pointer to copyright statement                        |
884   |           |                                                       |
885   | index     | pointer to index                                      |
886   +-----------+-------------------------------------------------------+
887
888   The figure below shows how Mozilla Firefox 1.0 displays the Site
889   Navigation Bar for rfc2396.xml.
890
891
892
893
894
895Reschke                                                        [Page 16]
896
897Documentation             RFC2629 through XSLT            September 2009
898
899
9006.3.  Standard HTML metadata
901
902          The following standard HTML META elements are produced:
903
904      +-----------+-------------------------------------------------+
905      | META name | description                                     |
906      +-----------+-------------------------------------------------+
907      | generator | from XSLT engine version and stylesheet version |
908      |           |                                                 |
909      | keywords  | from keyword elements in front section          |
910      +-----------+-------------------------------------------------+
911
9126.4.  Dublin Core (RFC2731) metadata
913
914   Unless turned off using the "rfc-ext support-rfc2731" processing
915   instruction, the transformation will generate metadata according to
916   [RFC2731] and [DC-HTML].
917
918                The following DCMI properties are produced:
919
920   +-------------------------+-----------------------------------------+
921   | META name               | description                             |
922   +-------------------------+-----------------------------------------+
923   | DC.Creator              | from author information in front        |
924   |                         | section                                 |
925   |                         |                                         |
926   | DC.Date.Issued          | from date information in front section  |
927   |                         |                                         |
928   | DC.Description.Abstract | from abstract                           |
929   |                         |                                         |
930   | DC.Identifier           | document URN [RFC2648] from "docName"   |
931   |                         | attribute                               |
932   |                         |                                         |
933   | DC.isPartOf             | RFC ISSN (for RFCs)                     |
934   |                         |                                         |
935   | DC.Relation.Replaces    | from "obsoletes" attribute              |
936   +-------------------------+-----------------------------------------+
937
9386.5.  Experimental hCard support
939
940   The generated author information is formatted in hCard [7] format.
941
942
943
944
945
946
947
948
949
950
951Reschke                                                        [Page 17]
952
953Documentation             RFC2629 through XSLT            September 2009
954
955
9567.  Transforming to XHTML
957
958   Transforming to XHTML requires slightly different XSLT output options
959   and is implemented by the derived transformation script
960   "rfc2629toXHTML.xslt".
961
962      Note: Microsoft Internet Explorer does _not_ support XHTML.
963      Therefore it usually makes more sense to generate plain old HTML.
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007Reschke                                                        [Page 18]
1008
1009Documentation             RFC2629 through XSLT            September 2009
1010
1011
10128.  Transforming to CHM (Microsoft Compiled Help)
1013
1014   To generate a CHM file using Microsoft's HTML Help Compiler (hhc),
1015   three files are required in addition to the HTML file.
1016
1017   1.  hhc - table of contents file (HTML)
1018
1019   2.  hhk - index file (HTML)
1020
1021   3.  hhp - project file (plain text)
1022
1023   The three files are generated with three specific transformations,
1024   each requiring the additional XSLT parameter "basename" to specify
1025   the filename prefix.
1026
1027   Example:
1028
1029   saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616  > rfc2616.hhp
1030   saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616  > rfc2616.hhc
1031   saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616  > rfc2616.hhk
1032   hhc rfc2616.hhp
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063Reschke                                                        [Page 19]
1064
1065Documentation             RFC2629 through XSLT            September 2009
1066
1067
10689.  Transforming to PDF
1069
10709.1.  Via XSL-FO
1071
1072   Transformation to XSL-FO [XSL-FO] format is available through
1073   "rfc2629toFO.xslt" (which includes "rfc2629.xslt", so keep both in
1074   the same folder).
1075
1076   Compared to HTML user agents, XSL-FO engines unfortunately either
1077   come as open source (for instance, Apache FOP) or feature-complete
1078   (for instance, AntennaHouse XSL Formatter), but not both at the same
1079   time.
1080
1081   As Apache FOP needs special workarounds (page breaking, table
1082   layout), and some popular extensions aren't standardized yet, the
1083   translation produces a generic output (hopefully) conforming to
1084   [XSL-FO].  Specific backends ("xsl11toFop-0.95xslt",
1085   "xsl11toXep.xslt", "xsl11toAn.xslt") then provide post-processing for
1086   the individual processors.
1087
1088      Note: the output is currently targeted at Apache FOP 0.95.
1089
10909.1.1.  Extension feature matrix
1091
1092   +------------+-------------+------------+-------------+-------------+
1093   |            | PDF anchors |     PDF    |     PDF     |    Index    |
1094   |            |             |  bookmarks |   document  |   cleanup   |
1095   |            |             |            | information |             |
1096   +------------+-------------+------------+-------------+-------------+
1097   | XSL 1.1    | no, but can |     yes    |   no, but   |     yes     |
1098   | WD [8]     |      be     |            |   uses XEP  |             |
1099   |            | auto-genera |            |    output   |             |
1100   |            |   ted from  |            |  extensions |             |
1101   |            |     "id"    |            |             |             |
1102   |            |  attributes |            |             |             |
1103   |            |             |            |             |             |
1104   | Antenna    |      no     |  yes [10]  |   yes [10]  |   yes [10]  |
1105   | House XSL  |             |  (from XSL |  (from XEP  |  (just page |
1106   | formatter  |             |     1.1    |   document  |  duplicate  |
1107   | [9]        |             | bookmarks) |    info)    | elimination |
1108   |            |             |            |             |  , from XSL |
1109   |            |             |            |             |   1.1 page  |
1110   |            |             |            |             |    index)   |
1111   |            |             |            |             |             |
1112   | Apache     |     yes     |  yes (from |     yes     |      no     |
1113   | FOP [11]   |             |   XSL 1.1  |             |             |
1114   |            |             | bookmarks) |             |             |
1115   |            |             |            |             |             |
1116
1117
1118
1119Reschke                                                        [Page 20]
1120
1121Documentation             RFC2629 through XSLT            September 2009
1122
1123
1124   | RenderX    |      no     |  yes [13]  |   yes [13]  |   yes [13]  |
1125   | XEP [12]   |             |  (from XSL |             |  (from XSL  |
1126   |            |             |     1.1    |             |   1.1 page  |
1127   |            |             | bookmarks) |             |    index)   |
1128   +------------+-------------+------------+-------------+-------------+
1129
11309.1.2.  Example: producing output for Apache FOP
1131
1132   Example:
1133
1134   saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo
1135   saxon tmp.fo xsl11toFop-0.95.xslt > rfc2629.fo
1136
11379.2.  Via X(HTML)
1138
1139   PDF output can also be produced directly from (X)HTML.  One simple
1140   approach is to rely on the browser's printing function, and to use a
1141   printer driver that produces PDF.  Depending on the brower's CSS
1142   capabilities, the output will behave properly with respect to table
1143   breaks etc.
1144
1145   An alternative is PrinceXML (see <http://www.princexml.com/>), which
1146   can produce PDF directly from (X)HTML input, based on the CSS
1147   printing information.
1148
1149   For instance, PDF output with text justification turned on can be
1150   produced with:
1151
1152   saxon input.xml rfc2629toXHTML.xslt xml2rfc-ext-justification=print \
1153     > output.xhtml
1154   prince output.xhtml output.pdf
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175Reschke                                                        [Page 21]
1176
1177Documentation             RFC2629 through XSLT            September 2009
1178
1179
118010.  Generic Extensions
1181
1182   This section documents extensions implemented in "rfc2629.xslt",
1183   using the extension namespace "http://purl.org/net/xml2rfc/ext".
1184
118510.1.  <abnf-char-sequence> element
1186
1187   Converts the contained quoted string into a hex-encoded character
1188   sequence, for use in case-sensitive ABNF productions.
1189
1190   For instance, "<x:abnf-char-sequence>"HTTP"</x:abnf-char-sequence>"
1191   gets converted to "%x48.54.54.50".
1192
119310.2.  <anchor-alias> element
1194
1195   Using its "value" attribute, this element allows the definition of an
1196   internal link target alias for the enclosing element.  This alias can
1197   then be used with the <ref> element for intra-document references.
1198
1199   Note that the anchor alias is not subject to the naming constraints
1200   that apply to anchor elements (which are XML names).
1201
120210.3.  <bcp14> element
1203
1204   This element marks the content as being one of the normative keywords
1205   defined in [RFC2119].
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231Reschke                                                        [Page 22]
1232
1233Documentation             RFC2629 through XSLT            September 2009
1234
1235
1236   The DOCTYPE definition below allows using these keywords using XML
1237   entity expansion: such as in "...server &MUST; accept...".
1238
1239   <!DOCTYPE rfc [
1240    <!ENTITY MAY "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1241      >MAY</bcp14>">
1242    <!ENTITY MUST "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1243      >MUST</bcp14>">
1244    <!ENTITY MUST-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1245      >MUST NOT</bcp14>">
1246    <!ENTITY OPTIONAL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1247      >OPTIONAL</bcp14>">
1248    <!ENTITY RECOMMENDED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1249      >RECOMMENDED</bcp14>">
1250    <!ENTITY REQUIRED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1251      >REQUIRED</bcp14>">
1252    <!ENTITY SHALL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1253      >SHALL</bcp14>">
1254    <!ENTITY SHALL-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1255      >SHALL NOT</bcp14>">
1256    <!ENTITY SHOULD "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1257      >SHOULD</bcp14>">
1258    <!ENTITY SHOULD-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1259      >SHOULD NOT</bcp14>">]>
1260
126110.4.  <bb> element
1262
1263   Marking up a string as <bb> indicates that it represents the bottom
1264   line of a box drawing, replacing the "+" and "-" characters
1265   accordingly.
1266
126710.5.  <bc> element
1268
1269   Marking up a string as <bc> indicates that it represents a center
1270   line of a box drawing, replacing the "|" character accordingly.
1271
127210.6.  <blockquote> element
1273
1274   This element is like the "blockquote" element in [HTML] (note this is
1275   a block-level element!).  It should contain one or more <t> child
1276   elements.
1277
127810.7.  <boilerplate> element
1279
1280   Can be used to include boilerplate (status, copyright, ...) into the
1281   front or back section. <section> elements within <x:boilerplate>
1282   appear as unnumbered sections in the output.
1283
1284
1285
1286
1287Reschke                                                        [Page 23]
1288
1289Documentation             RFC2629 through XSLT            September 2009
1290
1291
1292   _This element currently can not be "down-translated" for use in
1293   xml2rfc!_
1294
129510.8.  <bt> element
1296
1297   Marking up a string as <bt> indicates that it represents the top line
1298   of a box drawing, replacing the "+" and "-" characters accordingly.
1299
130010.9.  <dfn> element
1301
1302   This element is like the "dfn" element in [HTML].
1303
130410.10.  <h> element
1305
1306   This element is like the "h" element in [XHTML2].
1307
130810.11.  <highlight> element
1309
1310   Used to highlight text passages, currently only allowed in <artwork>.
1311
1312   Note: this is stripped when generating input for xml2rfc, so please
1313   use with care.
1314
131510.12.  <length-of> element
1316
1317   This element can be used to insert the length of another formatted
1318   section (in decimal).
1319
1320   Example: computing the Content-Length header value
1321
1322   <artwork>
1323   ...
1324   Content-Length: <x:length-of target="req"/>
1325
1326   <x:span anchor="req">123456789
1327   <x:span><artwork/>
1328
1329   The lenght computation counts line ends as two characters (CRLF).
1330
1331   Note that indentation characters in artwork _will_ be counted.  The
1332   "indented" attribute allows to specify the amount of indentation to
1333   be substracted from the computed length.
1334
133510.13.  <link> element
1336
1337   This element can be added as a top-level child element below <rfc> to
1338   indicate additional link information.  It's currently used only when
1339   generating HTML output, in which case an HTML <link> element with
1340
1341
1342
1343Reschke                                                        [Page 24]
1344
1345Documentation             RFC2629 through XSLT            September 2009
1346
1347
1348   identical attributes gets generated.
1349
1350   Example: generating HTML link element
1351
1352           <x:link xmlns="http://purl.org/net/xml2rfc/ext"
1353               rel="Bookmark"
1354               title="IETF WEBDAV Working Group"
1355               href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/>
1356
135710.14.  <lt> element
1358
1359   Used for grouping multiple <t> elements into a single list item.
1360
136110.15.  <note> element
1362
1363   Can be used to add a note, usually indented by a few characters.  It
1364   should contain one or more <t> child elements.
1365
136610.16.  <parse-xml> element
1367
1368   This element instructs the processor to parse the contents as XML and
1369   to warn when there's a problem (requires either MSXML or Saxon8 or
1370   newer).
1371
137210.17.  <q> element
1373
1374   This element is like the "q" element in [HTML].
1375
137610.18.  <ref> element
1377
1378   This element is a simplified variant of the <xref> element, in that
1379   no "target" attribute needs to be specified, instead the text
1380   contents acts as identifier.  That in itself wouldn't be terribly
1381   useful, but together with the <anchor-alias>, it allows referring to
1382   other parts of the document with minimal additional markup.
1383
1384   For instance, given an alias definition such as
1385
1386         <section title="Test" anchor="test">
1387           <x:anchor-alias value="alias1"/>
1388           <x:anchor-alias value="alias 2"/>
1389           ...
1390         </section>
1391
1392   the following simple references
1393
1394         <x:ref>test</x:ref>
1395         <x:ref>alias1</x:ref>
1396
1397
1398
1399Reschke                                                        [Page 25]
1400
1401Documentation             RFC2629 through XSLT            September 2009
1402
1403
1404         <x:ref>alias 2</x:ref>
1405
1406   are equivalent to...:
1407
1408         <xref target="test">test</xref>
1409         <xref target="test">alias1</xref>
1410         <xref target="test">alias 2</xref>
1411
141210.19.  <source> element
1413
1414   Can be used to enhance a <reference> with information about the
1415   location for the XML source.  This can be used by the <xref>
1416   processing code to automatically extract the target section number.
1417
1418   For example:
1419
1420         ...
1421         <xref target="RFC2616" x:fmt="of" x:rel="#PUT" />
1422         ...
1423
1424         <reference target="RFC2616"/>
1425           ...
1426           <x:source href="rfc2616.xml"/>
1427           ...
1428
142910.20.  <sup> element
1430
1431   This element is like the "sup" element in [HTML].
1432
1433   Note: the down conversion to RFC2629 format replaces "x^y" by "x^y".
1434
143510.21.  Extensions to Xml2rfc <artwork> element
1436
1437   Sometimes, artwork occurs inside lists.  To get it indent properly in
1438   xml2rfc's text output, it needs to be indented in the source.  This
1439   is sub-optimal, as this whitespace will also appear in the HTML
1440   output, where it's already indented due to HTML's semantics.
1441
1442   As a workaround, a "x:indent-with" attribute can be specified,
1443   containing a string that will be prepended to each line when
1444   "clean-for-DTD.xslt" is run (see Section 11.4).
1445
144610.22.  Extensions to Xml2rfc <iref> element
1447
1448   The extension attribute below is allowed on the standard <iref>
1449   element:
1450
1451
1452
1453
1454
1455Reschke                                                        [Page 26]
1456
1457Documentation             RFC2629 through XSLT            September 2009
1458
1459
1460   o  x:for-anchor specifies that the <iref> will also be automatically
1461      inserted whenever the specified anchor is cross-referenced -- this
1462      may save entering lots of <iref> instances.  As a special case, a
1463      value of "" (empty string) refers to the anchor attribute of the
1464      closest ancestor.
1465
146610.23.  Extensions to Xml2rfc <list> element
1467
1468   The extension attribute below is allowed on the standard <list>
1469   element:
1470
1471   o  x:indent specifies the amount of indentation for list items in
1472      hanging lists.  This can be useful when the output format, such as
1473      XSL-FO, does not support automatical formatting.  The value takes
1474      an XSL-FO width, such as "5em".  The default is _length of longest
1475      label in characters_ times _0.8em_.
1476
1477   Also, the <list> element can take <x:lt> child elements instead of
1478   <t>, allowing to insert multiple paragraphs into a single list item.
1479
148010.24.  Extensions to Xml2rfc <rfc> element
1481
1482   The extension attributes below are allowed on the standard <rfc>
1483   element:
1484
1485   o  grddl:transformation can be used to reference a GRDDL transform.
1486
1487   o  x:maturiy-level can be used to specify the IETF Standards Track
1488      Maturity Level of "proposed", "draft" or "internet" (see Section
1489      4.1 of [RFC2026]).
1490
149110.25.  Extensions to Xml2rfc <section> element
1492
1493   The extension attribute below is allowed on the standard <list>
1494   element:
1495
1496   o  x:fixed-section-number can be used to specify a fixed section
1497      number.  This can be useful when formatting historic documents
1498      that used a different numbering style.
1499
150010.26.  Extensions to Xml2rfc <xref> element
1501
1502   Three extension attributes are allowed on the standard <xref>
1503   element:
1504
1505   1.  x:sec can be specified to point to a specific section of the
1506       referenced document,
1507
1508
1509
1510
1511Reschke                                                        [Page 27]
1512
1513Documentation             RFC2629 through XSLT            September 2009
1514
1515
1516   2.  x:rel may specify a relative reference to use when linking into
1517       the referenced document (if linking by section number is not
1518       available),
1519
1520   3.  x:fmt defines the text format to be used.
1521
1522   The following formats are defined for the x:fmt attribute:
1523
1524   , (Comma)  [_reference_], Section _sec_
1525
1526   () [_reference_] (Section _sec_)
1527
1528   anchor  Like the default format, but without brackets.
1529
1530   of Section _sec_ of [_reference_]
1531
1532   number  _sec_
1533
1534   none  No output (can be used to have xrefs to references without
1535      having them rendered as such)
1536
1537   sec  Section _sec_
1538
1539   These extensions are currently only supported for <xref> elements
1540   without child nodes.
1541
1542   If the processor knows how to reference the target section, it will
1543   generate a link directly to the target section, such as in [RFC2119],
1544   Section 5.
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567Reschke                                                        [Page 28]
1568
1569Documentation             RFC2629 through XSLT            September 2009
1570
1571
157211.  Utilities
1573
157411.1.  Checking References
1575
1576   "check-references.xslt" can be used to check all references to RFC-
1577   and ID-series IETF publications and to W3C publications (note this
1578   script requires local copies of
1579   <ftp://ftp.isi.edu/in-notes/rfc-index.xml> and
1580   <http://www.w3.org/2002/01/tr-automation/tr.rdf> and will use the XML
1581   status information provided at <http://tools.ietf.org/>).
1582
1583   If the document is supposed to be published on the IETF standards
1584   track, the desired level can be specified using the parameter
1585   "intended-level" as 'proposed', 'draft' or 'internet'.
1586   Alternatively, it can be specified inside the document using the
1587   attribute x:maturity-level on the <rfc> element.
1588
1589   Note: Downward references should be annotated using the <annotate>
1590   element, containing an <xref> to [BCP97].
1591
1592   When an XSLT 2.0 processor is used, links in the document can be
1593   checked as well using the "link-check" paramerer ('yes' or 'no').
1594   Note that this only works for http links to documents of tytpe
1595   text/*.
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623Reschke                                                        [Page 29]
1624
1625Documentation             RFC2629 through XSLT            September 2009
1626
1627
1628   For instance, as of 2008-07-12, the script produces for
1629   <http://greenbytes.de/tech/webdav/rfc2518.xml>:
1630
1631   > saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \
1632     link-check=yes
1633
1634   Normative References:
1635   ISO-11578: not checked
1636   ISO-639: not checked
1637   ISO-8601: not checked
1638   REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006
1639   REC-xml-names-19990114: [FirstEdition] obsoleted by
1640    REC-xml-names-20060816
1641   RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282
1642   RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616
1643   RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617
1644   RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok
1645   RFC2141: [PROPOSED STANDARD] ok
1646   RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok
1647   RFC2396: [DRAFT STANDARD] obsoleted by RFC3986
1648   RFC2279: [DRAFT STANDARD] obsoleted by RFC3629
1649
1650   Informational References:
1651   REC-PICS-labels-961031: [REC] ok
1652   RFC1807: [INFORMATIONAL] ok
1653   RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok
1654   RFC2291: [INFORMATIONAL] ok
1655   RFC2376: [INFORMATIONAL] obsoleted by RFC3023
1656   RFC2413: [INFORMATIONAL] obsoleted by RFC5013
1657   USMARC: not checked
1658   WF: not checked
1659
1660   Link Targets
1661   <http://www.w3.org/TR/1998/REC-xml-19980210>: ok
1662   <http://www.w3.org/TR/1999/REC-xml-names-19990114>: ok
1663   <http://www.dlib.org/dlib/july96/lagoze/07lagoze.html>: ok
1664   <http://www.w3.org/pub/WWW/TR/REC-PICS-labels-961031.html>: ok
1665
1666   Recognized formats in the <seriesInfo> element are:
1667
1668   o  for RFCs, the name attribute must be "RFC", and the value
1669      attribute must be the number of the RFC,
1670
1671   o  for Internet Drafs, the name attribute must be "ID" or "Internet-
1672      Draft", and the value attribute must be the file name of the draft
1673      (including the two-digit running number, but excluding a file
1674      extension),
1675
1676
1677
1678
1679Reschke                                                        [Page 30]
1680
1681Documentation             RFC2629 through XSLT            September 2009
1682
1683
1684   o  for W3C documents, the name attribute must be "W3C", must start
1685      with "W3C ", or must start with "World Wide Web Consortium ", and
1686      the value attribute must be the "shorthand" name of the
1687      specification, such as "REC-xml-19980210".
1688
168911.2.  Generating Graphs from References
1690
1691   "gen-reference-graph.xslt" generates a graph of RFC dependencies,
1692   using the same base data as in "check-references.xslt" (see
1693   Section 11.1).  Its output is a "dot" file, to be processed by
1694   GraphViz (see <http://www.graphviz.org/>).
1695
1696   The picture below shows the RFC dependencies in RFC2629.
1697
1698
169911.3.  Producing reference entries for books
1700
1701   "amazon-asin.xslt" uses the Amazon web services to generate a
1702   <reference> element for a given ASIN (ISBN).
1703
1704   For instance:
1705
1706   <?xml version="1.0" encoding="utf-8"?>
1707   <references>
1708    <reference target="urn:isbn:0134516591">
1709      <front>
1710        <title>Simple Book, The: An Introduction to Internet Management,
1711                  Revised Second Edition</title>
1712        <author surname="Rose"
1713                   fullname="Marshall T. Rose" initials="M. T. ">
1714          <organization/>
1715        </author>
1716        <author surname="Marshall"
1717                   fullname="Rose T. Marshall" initials="R. T.">
1718          <organization/>
1719        </author>
1720        <date year="1996" month="March"/>
1721      </front>
1722      <seriesInfo name="Prentice Hall" value=""/>
1723    </reference>
1724   </references>
1725
1726   Note that the resulting XML usually requires checking, in this case
1727   Amazon's database is playing tricks with Marshall's name...
1728
1729
1730
1731
1732
1733
1734
1735Reschke                                                        [Page 31]
1736
1737Documentation             RFC2629 through XSLT            September 2009
1738
1739
174011.4.  Down-converting to RFC2629bis DTD
1741
1742   "clean-for-DTD.xslt" can be used to down-convert some extensions to a
1743   format that is supported by the base xml2rfc distribution.  Note that
1744   these extensions are experimental (feedback appreciated).
1745
1746   The following mappings are done:
1747
1748   o  <iref> elements inside <artwork> elements are moved in front of
1749      the enclosing <figure> element.
1750
1751   o  <xref> elements inside <artwork> are expanded just like in regular
1752      text (that is, the markup is stripped, but the element is replaced
1753      by the applicable replacement text).
1754
1755   o  <x:anchor-alias> elements get stripped.
1756
1757   o  <x:bcp14> elements get stripped.
1758
1759   o  <x:bb>, <x:bc> and <x:bt> elements get stripped.
1760
1761   o  <x:blockquote> elements get converted to indented text (through a
1762      <list> element).
1763
1764   o  <x:dfn> elements get stripped.
1765
1766   o  <x:h> elements get stripped.
1767
1768   o  <x:link> elements get stripped.
1769
1770   o  <x:note> elements get converted to indented text (through a <list>
1771      element).
1772
1773   o  <x:q> elements get stripped, with apostrophes added around the
1774      text.
1775
1776   o  <x:ref> elements get replaced by <xref> elements, targetting
1777      either the anchor or another anchor with matching <x:anchor-alias>
1778      child element.
1779
178011.5.  Extracting artwork
1781
1782   With "extract-artwork.xslt", artwork elements named through the
1783   "name" attribute can be extracted.  This can be used to automatically
1784   check their syntax (for instance, when ABNFs appear within a figure
1785   element).
1786
1787
1788
1789
1790
1791Reschke                                                        [Page 32]
1792
1793Documentation             RFC2629 through XSLT            September 2009
1794
1795
1796   For instance:
1797   saxon rfc3986.xml extract-artwork.xslt name=uri.abnf
1798
1799   In addition, artwork of a specific type can be extracted, such as
1800   with:
1801   saxon rfc3986.xml extract-artwork.xslt type=abnf
1802
180311.6.  GRRDL
1804
1805   "rfc2629grddl.xslt" extracts RDF information.  This is experimental
1806   work-in-progress.  See <http://www.w3.org/TR/grddl/> for more
1807   information.
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847Reschke                                                        [Page 33]
1848
1849Documentation             RFC2629 through XSLT            September 2009
1850
1851
185212.  Informative References
1853
1854   [BCP97]    Klensin, J. and S. Hartman, "Handling Normative References
1855              to Standards-Track Documents", BCP 97, RFC 4897,
1856              June 2007.
1857
1858   [DC-HTML]  Johnston, P. and A. Powell, "Expressing Dublin Core
1859              metadata using HTML/XHTML meta and link elements", Dublin
1860              Core Metadata Initiative , August 2008,
1861              <http://dublincore.org/documents/2008/08/04/dc-html/>.
1862
1863   [HTML]     Raggett, D., Hors, A., and I. Jacobs, "HTML 4.01
1864              Specification", W3C REC-html401-19991224, December 1999,
1865              <http://www.w3.org/TR/html401/>.
1866
1867   [RFC2026]  Bradner, S., "The Internet Standards Process -- Revision
1868              3", BCP 9, RFC 2026, October 1996.
1869
1870   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
1871              Requirement Levels", BCP 14, RFC 2119, March 1997.
1872
1873   [RFC2616]  Fielding, R., Gettys, J., Mogul, J., Nielsen, H.,
1874              Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
1875              Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.
1876
1877   [RFC2629]  Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629,
1878              June 1999.
1879
1880   [RFC2648]  Moats, R., "A URN Namespace for IETF Documents", RFC 2648,
1881              August 1999.
1882
1883   [RFC2731]  Kunze, J., "Encoding Dublin Core Metadata in HTML",
1884              RFC 2731, December 1999.
1885
1886   [RFC5234]  Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
1887              Specifications: ABNF", STD 68, RFC 5234, January 2008.
1888
1889   [RNC]      Clark, J., "RELAX NG Compact Syntax", OASIS , Nov 2002, <h
1890              ttp://www.oasis-open.org/committees/relax-ng/
1891              compact-20021121.html>.
1892
1893   [XHTML2]   Axelsson, J., Birbeck, M., Dubinko, M., Epperson, B.,
1894              Ishikawa, M., McCarron, S., Navarro, A., and S. Pemberton,
1895              "XHTML[TM] 2.0", W3C WD-xhtml2-20060726, July 2006,
1896              <http://www.w3.org/TR/xhtml2>.
1897
1898   [XML]      Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E., and
1899              F. Yergeau, "Extensible Markup Language (XML) 1.0 (Fifth
1900
1901
1902
1903Reschke                                                        [Page 34]
1904
1905Documentation             RFC2629 through XSLT            September 2009
1906
1907
1908              Edition)", W3C REC-xml-20081126, November 2008,
1909              <http://www.w3.org/TR/2008/REC-xml-20081126/>.
1910
1911   [XSL-FO]   Berglund, A., "Extensible Stylesheet Language (XSL)
1912              Version 1.1", W3C REC-xsl11-20061205, Dec 2006,
1913              <http://www.w3.org/TR/2006/REC-xsl11-20061205/>.
1914
1915   [1]   <http://www.exslt.org/exsl/functions/node-set/
1916         exsl.node-set.html>
1917
1918   [2]   <http://www.microsoft.com/downloads/
1919         details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41>
1920
1921   [3]   <https://addons.mozilla.org/de/firefox/addon/722>
1922
1923   [4]   <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>
1924
1925   [5]   <http://bugzilla.mozilla.org/show_bug.cgi?id=193678>
1926
1927   [6]   <https://addons.mozilla.org/firefox/2933/>
1928
1929   [7]   <http://microformats.org/wiki/hcard>
1930
1931   [8]   <http://www.w3.org/TR/2003/WD-xsl11-20031217/>
1932
1933   [9]   <http://www.antennahouse.com/>
1934
1935   [10]  <http://www.antennahouse.com/XSL20/axf-extension.htm>
1936
1937   [11]  <http://xml.apache.org/fop/>
1938
1939   [12]  <http://xep.xattic.com/>
1940
1941   [13]  <http://xep.xattic.com/xep/spec.html>
1942
1943   [14]  <http://www.thaiopensource.com/relaxng/jing.html>
1944
1945   [15]  <http://dpcarlisle.blogspot.com/2007/05/
1946         exslt-node-set-function.html>
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959Reschke                                                        [Page 35]
1960
1961Documentation             RFC2629 through XSLT            September 2009
1962
1963
1964Appendix A.  RELAX NG Compact Schema
1965
1966   The RelaxNG schema ([RNC]) below can be used to validate input
1967   documents (for instance, with Jing [14]).
1968
1969   _Note that this is work in progress, and doesn't yet cover all
1970   extensions completely._
1971
1972  # WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR.
1973
1974  # Define our extension namespace
1975  namespace x = "http://purl.org/net/xml2rfc/ext"
1976
1977  # Define GRDDL namespace
1978  namespace grddl = "http://www.w3.org/2003/g/data-view#"
1979
1980  # Define RDF namespace
1981  namespace rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
1982
1983  # Include rfc2629bis RNC grammar
1984  include "rfc2629.rnc" {
1985
1986    # Redefine <artwork> to allow markup
1987    artwork =
1988      element artwork {
1989        attlist.artwork,
1990        (TEXT
1991          | eref
1992          | iref
1993          | spanx
1994          | xref
1995          | x_abnf-char-sequence
1996          | x_bb
1997          | x_bc
1998          | x_bt
1999          | x_highlight
2000          | x_length-of
2001          | x_parse-xml
2002          | x_ref
2003          | x_span
2004          | x_x)*
2005      }
2006
2007    # Redefine <back> to allow boilerplate
2008    back =
2009      element back {
2010        attlist.back,
2011        references*,
2012
2013
2014
2015Reschke                                                        [Page 36]
2016
2017Documentation             RFC2629 through XSLT            September 2009
2018
2019
2020        section*,
2021        x_boilerplate?
2022      }
2023
2024    # Redefine <c> to allow our extension elements
2025    c =
2026      element c {
2027        attlist.c,
2028        (TEXT
2029          | xref
2030          | eref
2031          | iref
2032          | cref
2033          | spanx
2034          | x_ref)*
2035      }
2036
2037    # Redefine <cref> to allow more child elements
2038    cref =
2039      element cref {
2040        attlist.cref,
2041        (TEXT
2042          | eref
2043          | xref)*
2044      }
2045
2046    # Redefine <front> to allow boilerplate
2047    front =
2048      element front {
2049        attlist.front,
2050        title,
2051        author+,
2052        date,
2053        area*,
2054        workgroup*,
2055        keyword*,
2056        x_boilerplate?,
2057        abstract?,
2058        note*
2059      }
2060
2061    # Redefine <list> element to allow <x:lt> child elements
2062    \list =
2063      element list {
2064        attlist.list,
2065        (t+ | x_lt+)
2066      }
2067
2068
2069
2070
2071Reschke                                                        [Page 37]
2072
2073Documentation             RFC2629 through XSLT            September 2009
2074
2075
2076    # Redefine <preamble> to allow our extension elements
2077    preamble =
2078      element preamble {
2079        attlist.preamble,
2080        (TEXT
2081          | xref
2082          | eref
2083          | iref
2084          | cref
2085          | spanx
2086          | x_anchor-alias)*
2087      }
2088
2089    # Redefine <postamble> to allow our extension elements
2090    postamble =
2091      element postamble {
2092        attlist.postamble,
2093        (TEXT
2094          | xref
2095          | eref
2096          | iref
2097          | cref
2098          | spanx
2099          | x_bcp14)*
2100      }
2101
2102    # Redefine <reference> to allow our extension elements
2103    reference =
2104      element reference {
2105        attlist.reference,
2106        front,
2107        seriesInfo*,
2108        format*,
2109        annotation*,
2110        x_source?
2111      }
2112
2113    # Redefine <rfc> to allow our extension elements
2114    rfc =
2115      element rfc {
2116        attlist.rfc,
2117        x_link*,
2118        x_assign-section-number*,
2119        front,
2120        middle,
2121        back?
2122      }
2123
2124
2125
2126
2127Reschke                                                        [Page 38]
2128
2129Documentation             RFC2629 through XSLT            September 2009
2130
2131
2132    # Redefine <section> to allow our extension elements
2133    section =
2134      element section {
2135        attlist.section,
2136        (t
2137         | figure
2138         | texttable
2139         | iref
2140         | section
2141         | x_anchor-alias
2142         | x_blockquote
2143         | x_include-author
2144         | x_note
2145         | rdf_Description)*
2146      }
2147
2148    # Redefine <spanx> to allow some markup
2149    spanx =
2150      element spanx {
2151        attlist.spanx,
2152        (TEXT
2153          | iref
2154          | xref
2155          | x_ref)*
2156      }
2157
2158    # Redefine <t> to allow our extension elements
2159    t =
2160      element t {
2161        attlist.t,
2162        (TEXT
2163         | \list
2164         | figure
2165         | xref
2166         | eref
2167         | iref
2168         | cref
2169         | spanx
2170         | vspace
2171         | x_abnf-char-sequence
2172         | x_anchor-alias
2173         | x_bcp14
2174         | x_dfn
2175         | x_h
2176         | x_q
2177         | x_ref
2178         | x_sup)*
2179      }
2180
2181
2182
2183Reschke                                                        [Page 39]
2184
2185Documentation             RFC2629 through XSLT            September 2009
2186
2187
2188  }
2189
2190  # Allow x:indent-with attribute on <artwork>
2191  attlist.artwork &=
2192    attribute x:indent-with { ATEXT }?
2193
2194  # Allow anchor attribute on <author>
2195  attlist.author &=
2196    attribute anchor { xsd:ID }?
2197
2198    # Extend attribute set for <iref> (see Section 10.22)
2199  attlist.iref &=
2200    attribute x:for-anchor { ATEXT }?
2201
2202  # Extend attribute set for <list> (see Section 10.23)
2203  attlist.list &=
2204    attribute x:indent { ATEXT }?
2205
2206  # Extend attribute set for <preamble>
2207  attlist.preamble &=
2208    attribute anchor { xsd:ID }?
2209
2210  # Extend attribute set for <rfc>
2211  attlist.rfc &=
2212    attribute grddl:transformation { ATEXT }?,
2213    attribute x:maturity-level { "proposed" | "draft" | "internet" }?
2214
2215  # Extend attribute set for <section> (see Section 10.25)
2216  attlist.section &=
2217    attribute x:fixed-section-number { ATEXT }?
2218
2219  # Allow anchor attribute on <spanx>
2220  attlist.spanx &=
2221    attribute anchor { xsd:ID }?
2222
2223  # Extend attribute set for <xref> (see Section 10.26)
2224  attlist.xref &=
2225    attribute x:fmt  { "()" | "," | "anchor" | "of" | "number" | "sec" |
2226                       "none" }?,
2227    attribute x:rel  { ATEXT }?,
2228    attribute x:sec  { ATEXT }?
2229
2230  # Conversion to ABNF char sequence (see Section 10.1)
2231  x_abnf-char-sequence =
2232    element x:abnf-char-sequence {
2233      TEXT
2234    }
2235
2236
2237
2238
2239Reschke                                                        [Page 40]
2240
2241Documentation             RFC2629 through XSLT            September 2009
2242
2243
2244  # Aliasing of anchors (see Section 10.2)
2245  x_anchor-alias =
2246    element x:anchor-alias {
2247      attribute value { TEXT },
2248      empty
2249    }
2250
2251  # Including Author information
2252  # (experimental)
2253  x_include-author =
2254    element x:include-author {
2255      attribute target { xsd:IDREF }
2256    }
2257
2258  # Setting section numbers for internally generated sections
2259  # (experimental)
2260  x_assign-section-number =
2261    element x:assign-section-number {
2262      attribute builtin-target { "authors" },
2263      attribute number { TEXT },
2264      empty
2265    }
2266
2267  # Bottom line of box drawing (see Section 10.4)
2268  x_bb =
2269    element x:bb {
2270      (TEXT
2271        | iref
2272        | xref
2273        | x_bb
2274        | x_bc
2275        | x_bt
2276        | x_ref)*
2277    }
2278
2279  # Center line of box drawing (see Section 10.5)
2280  x_bc =
2281    element x:bc {
2282      (TEXT
2283        | iref
2284        | xref
2285        | x_bb
2286        | x_bc
2287        | x_bt
2288        | x_ref)*
2289    }
2290
2291  # BCP14/RFC2119 keywords (see Section 10.3)
2292
2293
2294
2295Reschke                                                        [Page 41]
2296
2297Documentation             RFC2629 through XSLT            September 2009
2298
2299
2300  x_bcp14 =
2301    element x:bcp14 {
2302      "MAY"
2303      | "MUST"
2304      | "MUST NOT"
2305      | "NOT RECOMMENDED"
2306      | "OPTIONAL"
2307      | "RECOMMENDED"
2308      | "REQUIRED"
2309      | "SHALL"
2310      | "SHALL NOT"
2311      | "SHOULD"
2312      | "SHOULD NOT"
2313    }
2314
2315  # Blockquote (see Section 10.6)
2316  x_blockquote =
2317    element x:blockquote {
2318      attribute cite { URI }?,
2319      t+
2320    }
2321
2322  # Boilerplate (see Section 10.6)
2323  x_boilerplate =
2324    element x:boilerplate {
2325      section+
2326    }
2327
2328  # Top line of box drawing (see Section 10.8)
2329  x_bt =
2330    element x:bt {
2331      (TEXT
2332        | iref
2333        | xref
2334        | x_bb
2335        | x_bc
2336        | x_bt
2337        | x_ref)*
2338    }
2339
2340  # Definition (see Section 10.9)
2341  x_dfn =
2342    element x:dfn {
2343      attribute anchor { xsd:ID }?,
2344      (TEXT
2345        | iref)*
2346    }
2347
2348
2349
2350
2351Reschke                                                        [Page 42]
2352
2353Documentation             RFC2629 through XSLT            September 2009
2354
2355
2356  # Heading (see Section 10.10)
2357  x_h =
2358    element x:h {
2359      TEXT
2360    }
2361
2362  # Heading (see Section 10.11)
2363  x_highlight =
2364    element x:highlight {
2365      TEXT
2366    }
2367
2368  # Length Measurement (see Section 10.12)
2369  x_length-of =
2370    element x:length-of {
2371      attribute indented { NUMBER }?,
2372      attribute target { xsd:IDREF },
2373      empty
2374    }
2375
2376  # Link (see Section 10.13)
2377  x_link =
2378    element x:link {
2379      attribute href { URI },
2380      attribute title { TEXT }?,
2381      attribute rel { TEXT },
2382      empty
2383    }
2384
2385  # Extended list item (see Section 10.14)
2386  x_lt =
2387    element x:lt {
2388      attribute anchor { xsd:ID }?,
2389      attribute hangText { TEXT }?,
2390      t+
2391    }
2392
2393  # Note (see Section 10.15)
2394  x_note =
2395    element x:note {
2396      t+
2397    }
2398
2399  # Signal XML content (see Section 10.16)
2400  x_parse-xml =
2401    element x:parse-xml {
2402      TEXT
2403    }
2404
2405
2406
2407Reschke                                                        [Page 43]
2408
2409Documentation             RFC2629 through XSLT            September 2009
2410
2411
2412  # Inline quote (see Section 10.17)
2413  x_q =
2414    element x:q {
2415      TEXT
2416    }
2417
2418  # Anchor reference (see Section 10.18)
2419  x_ref =
2420    element x:ref {
2421      attribute anchor { xsd:ID }?,
2422      TEXT
2423    }
2424
2425  # source information (see Section 10.19)
2426  x_source =
2427    element x:source {
2428      attribute basename { ATEXT }?,
2429      attribute href { URI },
2430      empty
2431    }
2432
2433  # superscript (see Section 10.20)
2434  x_sup =
2435    element x:sup {
2436      TEXT
2437    }
2438
2439  # Inline Span
2440  x_span =
2441    element x:span {
2442      attribute anchor { xsd:ID }?,
2443      (TEXT
2444        | x_parse-xml)*
2445    }
2446
2447  # Nop (for alignment in source)
2448  x_x =
2449    element x:x {
2450      empty
2451    }
2452
2453  # Embed RDF statements
2454  rdf_Description =
2455    element rdf:Description {
2456      rdf_content
2457    }
2458
2459  rdf_content =
2460
2461
2462
2463Reschke                                                        [Page 44]
2464
2465Documentation             RFC2629 through XSLT            September 2009
2466
2467
2468    ( TEXT | element * { rdf_content })*
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519Reschke                                                        [Page 45]
2520
2521Documentation             RFC2629 through XSLT            September 2009
2522
2523
2524Appendix B.  Implementation Notes
2525
2526B.1.  Recognized type attributes for <artwork> element
2527
2528   Specific values in the <artwork> element's "type" attribute are
2529   recognized and cause a different visual style to be used:
2530
2531   +-------------------------------------+-----------------------------+
2532   | Media Type                          | Comment                     |
2533   +-------------------------------------+-----------------------------+
2534   | abnf                                | ABNF as per [RFC5234]       |
2535   |                                     |                             |
2536   | abnf2616                            | ABNF as per [RFC2616],      |
2537   |                                     | Section 2.1                 |
2538   |                                     |                             |
2539   | application/relax-ng-compact-syntax | Relax NG Compact Syntax as  |
2540   |                                     | per [RNC]                   |
2541   |                                     |                             |
2542   | application/xml-dtd                 | XML DTD                     |
2543   |                                     |                             |
2544   | message/http; msgtype="request"     | HTTP message, as per        |
2545   |                                     | [RFC2616], Section 19.1     |
2546   |                                     |                             |
2547   | message/http; msgtype="response"    | HTTP message, as per        |
2548   |                                     | [RFC2616], Section 19.1     |
2549   +-------------------------------------+-----------------------------+
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575Reschke                                                        [Page 46]
2576
2577Documentation             RFC2629 through XSLT            September 2009
2578
2579
2580Appendix C.  Examples
2581
2582C.1.  Using the 'Internal Subset'
2583
2584   The prolog of the XML document can both be used to refer to an
2585   external DTD, and also to define internal entities (Section 2.8 of
2586   [XML]):
2587
2588   <?xml version="1.0"?>
2589   <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
2590
2591   <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
2592
2593     <!-- use "&MAY;" for a BCP 14 "MAY", see Section 10.3 -->
2594     <!ENTITY MAY
2595     "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY</bcp14>">
2596
2597     <!-- re-declare "&nbsp;" as code point 160 (non-breaking space) -->
2598     <!-- you may need this for UAs that do not read external DTDs -->
2599     <!ENTITY nbsp
2600     "&#160;">
2601
2602     <!-- allow later RFC2616 reference using "&rfc2616;" -->
2603     "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml">
2604
2605   ]>
2606
2607   Note: including entities from a remote site will not work in Firefox,
2608   see <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>.
2609
2610C.2.  Customization
2611
2612   The XSLT code can be customized by creating a custom XSLT file that
2613   uses <xsl:import> to include the original code, and just overrides
2614   particular rules.
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631Reschke                                                        [Page 47]
2632
2633Documentation             RFC2629 through XSLT            September 2009
2634
2635
2636   For instance, the code below overrides several attributes in
2637   "rfc2629toFO.xslt", changing the color, spacing and font family for
2638   headers.
2639
2640   <xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
2641                  version="1.0">
2642
2643     <xsl:import href="rfc2629toFO.xslt"/>
2644
2645     <xsl:attribute-set name="h1">
2646       <xsl:attribute name="color">darkblue</xsl:attribute>
2647       <xsl:attribute name="font-family">sans-serif</xsl:attribute>
2648       <xsl:attribute name="space-before">24pt</xsl:attribute>
2649     </xsl:attribute-set>
2650
2651     <xsl:attribute-set name="h2">
2652       <xsl:attribute name="color">darkblue</xsl:attribute>
2653       <xsl:attribute name="font-family">sans-serif</xsl:attribute>
2654       <xsl:attribute name="space-before">18pt</xsl:attribute>
2655       <xsl:attribute name="space-after">3pt</xsl:attribute>
2656     </xsl:attribute-set>
2657
2658     <xsl:attribute-set name="h3">
2659       <xsl:attribute name="color">darkblue</xsl:attribute>
2660       <xsl:attribute name="font-family">sans-serif</xsl:attribute>
2661       <xsl:attribute name="space-before">16pt</xsl:attribute>
2662       <xsl:attribute name="space-after">2pt</xsl:attribute>
2663     </xsl:attribute-set>
2664
2665   </xsl:transform>
2666
2667      Note: the name for the attribute sets may change in the future as
2668      more working is done with respect to customizability.  In any
2669      case, overriding the settings in a separate file will be easier to
2670      maintain.  Please contact the author if you find yourself trying
2671      to override style definitions that currently do not use attribute
2672      sets.
2673
2674      Note: the CSS style information used in "rfc2629.xslt" can be
2675      overriden in a similar (but less granular) way: just overwrite the
2676      template called "insertCss".  As for XSL-FO, the class names may
2677      change in future.
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687Reschke                                                        [Page 48]
2688
2689Documentation             RFC2629 through XSLT            September 2009
2690
2691
2692Appendix D.  License
2693
2694   Copyright (c) 2006-2009, Julian Reschke
2695   (julian.reschke@greenbytes.de)
2696
2697   All rights reserved.
2698
2699   Redistribution and use in source and binary forms, with or without
2700   modification, are permitted provided that the following conditions
2701   are met:
2702
2703   o  Redistributions of source code must retain the above copyright
2704      notice, this list of conditions and the following disclaimer.
2705
2706   o  Redistributions in binary form must reproduce the above copyright
2707      notice, this list of conditions and the following disclaimer in
2708      the documentation and/or other materials provided with the
2709      distribution.
2710
2711   o  Neither the name of Julian Reschke nor the names of its
2712      contributors may be used to endorse or promote products derived
2713      from this software without specific prior written permission.
2714
2715   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
2716   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
2717   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
2718   A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
2719   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2720   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
2721   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2722   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2723   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2724   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
2725   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743Reschke                                                        [Page 49]
2744
2745Documentation             RFC2629 through XSLT            September 2009
2746
2747
2748Appendix E.  Change Logs
2749
2750E.1.  Package
2751
2752   2006-01-01  Switch to BSD License.
2753
2754   2007-01-12  Update to xml2rfc v1.33pre2.
2755
2756   2007-03-31  Update to xml2rfc v1.33pre3.
2757
2758   2007-05-01  Add XSLT test cases.
2759
2760   2008-07-18  Experimental support for inlined rdf:Description elements
2761      (ignored by the formatter, extracted by rfc2629grddl).
2762
2763   2008-12-04  Update to xml2rfc v1.34pre2.
2764
2765   2009-02-24  Experimental support for February 2009 boilerplate
2766      changes, and for the x:boilerplate element.
2767
2768   2009-07-08  Support new boilerplate ordering in RFCs published since
2769      July 2009.  Fix problems with one-column text tables.
2770
2771   2009-07-19  When possible, calculate the actual Expiry date for
2772      Internet Drafts (full date must be available).
2773
2774   2009-08-01  For '$xml2rfc-ext-authors-section='end'", move the index
2775      in front of the authors section.
2776
2777   2009-08-04  Consider /rfc/@ipr="pre5378Trust200902" when producing
2778      RFCs, not IDs.
2779
2780   2009-08-29  Support alignment for artwork containing images (as
2781      opposed to, well, artwork).
2782
2783   2009-09-01  Allow xref in cref (as extension).
2784
2785   2009-09-14  Refactor handling of processing instructions.
2786
2787   2009-09-24  Fix typo in Status Of This Memo, present since November
2788      2008.  Fix formatting of iprExtract attribute.  Starting with
2789      Internet Draft publication dates after 2009-11-30: use new Trust
2790      Legal Provisions text; for Internet Drafts: move Abstract up, and
2791      move "pre5378" escape clause to the Copyright Notice.  Add support
2792      for refparent PI.  For RFCs: use new TLP text as of September
2793      2009.  Incorporate xml2rfc v1.34pre4.
2794
2795
2796
2797
2798
2799Reschke                                                        [Page 50]
2800
2801Documentation             RFC2629 through XSLT            September 2009
2802
2803
2804E.2.  amazon-asin.xslt
2805
2806   2003-11-16  Initial release.
2807
2808   2005-04-02  Fix two DTD issues.
2809
2810E.3.  check-references.xslt
2811
2812   2003-11-16  Initial release.
2813
2814   2004-05-11  Add document status; print references type.
2815
2816   2005-01-01  Add experimental check for ID status.
2817
2818   2005-04-01  Add fixes from Bill Fenner.
2819
2820   2005-12-03  Add checks against local copy of
2821      <http://www.w3.org/2002/01/tr-automation/tr.rdf>.
2822
2823   2006-07-22  Add checks for standards levels.
2824
2825   2006-08-06  "check-ietf-references.xslt" replaced by "check-
2826      references.xslt".
2827
2828   2007-01-04  Use information online at <http://tools.ietf.org/> to
2829      retrieve Internet-Draft status information.
2830
2831   2007-06-16  Fix bug looking up ref type when inside change markup.
2832
2833   2008-06-14  Enhance output when draft was updated, and then published
2834      as RFC.
2835
2836   2008-07-12  Add XSLT2-based link target checking.
2837
2838   2008-08-10  Change keywords for "intended-level" to proposed/draft/
2839      internet, optionall extract intended level from /rfc/@
2840      x:maturity-level attribute.
2841
2842E.4.  gen-reference-graph.xslt
2843
2844   2006-09-03  New.
2845
2846   2007-06-07  Use Carlisle method [15] to define exslt:node-set in
2847      msxsml (which means that the stylesheet can now be used with MSXML
2848      as well).
2849
2850
2851
2852
2853
2854
2855Reschke                                                        [Page 51]
2856
2857Documentation             RFC2629 through XSLT            September 2009
2858
2859
2860   2007-10-15  Use W3C data from tr.rdf as well (experimental).
2861
2862E.5.  rfc2629.xslt
2863
2864   2001-03-28  Code rearranged, generate numbered section anchors for
2865      paragraphs (t) as well.  Fixes in index handling.
2866
2867   2001-04-12  Moved HTML output into XHTML namespace.
2868
2869   2001-10-02  Fixed default location for RFCs and numbering of section
2870      references.  Support ?rfc editing processing instruction.
2871
2872   2001-10-07  Made telephone number links active.
2873
2874   2001-10-08  Support for vspace element.
2875
2876   2001-10-09  Experimental support for rfc-issue PI.
2877
2878   2001-11-11  Support rfc private PI.  Removed bogus code reporting the
2879      WG in the header.
2880
2881   2001-11-11  Support rfc private PI.  Removed bogus code reporting the
2882      WG in the header.
2883
2884   2001-12-17  Support title attribute on references element
2885
2886   2002-01-05  Support for list/@style="@format"
2887
2888   2002-01-09  Display "closed" RFC issues as deleted
2889
2890   2002-01-14  Experimentally and optionally parse XML encountered in
2891      artwork elements (requires MSXSL).
2892
2893   2002-01-27  Some cleanup.  Moved RFC issues from PIs into namespaced
2894      elements.
2895
2896   2002-01-29  Added support for sortrefs PI.  Added support for figure
2897      names.
2898
2899   2002-02-07  Highlight parts of artwork which are too wide (72
2900      characters).
2901
2902   2002-02-12  Code rearrangement for static texts.  Fixes for section
2903      numbering.  TOC generation rewritten.
2904
2905
2906
2907
2908
2909
2910
2911Reschke                                                        [Page 52]
2912
2913Documentation             RFC2629 through XSLT            September 2009
2914
2915
2916   2002-02-15  Support for irefs in sections; support iref @primary=true
2917
2918   2002-03-03  Moved anchor prefix into a constant.  Added sanity checks
2919      on user anchor names.
2920
2921   2002-03-23  Bugfix in detection of matching org names when creating
2922      the header.  Fixed sorting in subitems.
2923
2924   2002-04-02  Fix TOC link HTML generation when no TOC is generated
2925      (created broken HTML table code).
2926
2927   2002-04-03  Made rendering of references more tolerant re: missing
2928      parts.
2929
2930   2002-04-08  Fixed reference numbering when references are split into
2931      separate sections.
2932
2933   2002-04-16  Fix default namespace (shouldn't be set for HTML output
2934      method).
2935
2936   2002-04-19  Lowercase internal CSS selectors for Mozilla compliance.
2937      Do not put TOC into ul element.
2938
2939   2002-04-21  Make numbered list inside numbered lists use alphanumeric
2940      numbering.
2941
2942   2002-05-05  Updated issue/editing support.
2943
2944   2002-05-15  Bugfix for section numbering after introduction of ed:
2945      replace
2946
2947   2002-06-21  When producing private documents, do not include document
2948      status, copyright etc.
2949
2950   2002-07-08  Fix xrefs to Appendices.
2951
2952   2002-07-19  Make artwork lightyellow for easier reading. (fielding)
2953
2954   2002-10-09  Translate references title to anchor name to avoid non-
2955      uri characters. (fielding)
2956
2957   2002-10-13  Support for tocdepth PI.
2958
2959   2002-11-03  Added temporariry workaround for Mozilla/Transformiix
2960      result tree fragment problem. (search for
2961      'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')
2962
2963
2964
2965
2966
2967Reschke                                                        [Page 53]
2968
2969Documentation             RFC2629 through XSLT            September 2009
2970
2971
2972   2002-12-25  xref code: attempt to uppercase "section" and "appendix"
2973      when at the start of a sentence.
2974
2975   2003-02-02  fixed code for vspace blankLines="0", enhanced display
2976      for list with "format" style, got rid of HTML blockquote elements,
2977      added support for "hangIndent"
2978
2979   2003-04-10  experimental support for appendix and spanx elements
2980
2981   2003-04-19  fixed counting of list numbers in "format %" styles (one
2982      counter per unique format string).  Added more spanx styles.
2983
2984   2003-05-02  experimental texttable support
2985
2986   2003-05-02  Make mailto links optional (default = none) (jre: default
2987      and PI name changed) (fielding)
2988
2989   2003-05-04  experimental support for HTML link elements; fix default
2990      for table header alignment default
2991
2992   2003-05-06  support for "background" PI.
2993
2994   2003-05-11  change %c format to lowercase alphabetic. add support for
2995      keyword elements (generate META tag). fix various HTML conformance
2996      problems. added experimental support for role attribute. do not
2997      number paragraphs in unnumbered sections. update boilerplate
2998      texts. support for "iprnotified" PI. bugfix list numbering. strip
2999      whitespace when building tel: URIs.
3000
3001   2003-05-12  more conformance fixes (layout moved into CSS, move lists
3002      and figures out of para content, do not use tables for list
3003      formatting)
3004
3005   2003-05-13  add DC.Creator meta tag, refactoring
3006
3007   2003-05-16  put nbsps between "section" and section number (xref).
3008
3009   2003-05-18  author summary: add missing comma.
3010
3011   2003-06-06  fix index generation bug (transposed characters in key
3012      generation).  Enhance sentence start detection (xref starting a
3013      section was using lowercase "section").
3014
3015   2003-06-22  exp. support for xref/@format.  Add missing support for
3016      eref w/o content. exp. support for annotations in reference
3017      elements.  Code cleanup reference table formatting.
3018
3019
3020
3021
3022
3023Reschke                                                        [Page 54]
3024
3025Documentation             RFC2629 through XSLT            September 2009
3026
3027
3028   2003-07-09  Another fix for DC.Creator meta tag creation based on
3029      RFC2731
3030
3031   2003-07-24  Fix namespace name for DC.Creator.
3032
3033   2003-08-06  Cleanup node-set support (only use exslt (saxon, xalan,
3034      libxslt) extension functions; remove Transformix workarounds that
3035      stopped to work in Moz 1.4)
3036
3037   2003-08-09  Generate HTML lang tag.
3038
3039   2003-08-10  Map spanx/verb to HTML "samp" element.  Fix author name
3040      display in references (reverse surname/initials for last author),
3041      add "Ed.".  Fix internal bookmark generation.
3042
3043   2003-08-17  Add DCMI dates, identifiers and abstract.  Add PI to
3044      suppress DCMI generation.  Do not add TOC entry to Copyright
3045      Statement when there is none.  Align RFC2629 PI names and
3046      parameter names.  Change style for inline URIs generated by eref.
3047      Add header and footer support.  Enhance CSS paging properties.
3048      Support topblock PI.  Added hooks for proper XHTML generation
3049      through separate XSLT.  Enhance warning and error messages.  Add
3050      support for artwork image display.  Table formatting fixes
3051      (borders, thead continuation).
3052
3053   2003-08-18  Add workaround for MSXML4 node-set and Mozilla node-set
3054      issues (fallback just displays are warning).
3055
3056   2003-10-06  Add workaround for broken pre/ins handling in Mozilla
3057      (see <http://bugzilla.mozilla.org/show_bug.cgi?id=204401>).  Make
3058      use of cite attribute on ed:replace.  CSS cleanup.
3059
3060   2003-10-08  Fix minor issue detecting the same org for the header
3061      (caused by IE's non-standard whitespace handling).  Fix default
3062      handling for /rfc/@category.
3063
3064   2003-11-09  Inherit ed:entered-by from ancestor elements.  Change CSS
3065      color for inserted text to green.  Generate issues-list anchor.
3066      Do not complain about missing targets when the xref element is
3067      below ed:del.  Remove code that attempted to distinguish section/
3068      Section when producing links - always use uppercase.  Fix date
3069      rendering for issue resolutions.
3070
3071   2003-11-29  Fix color values for table backgrounds for issue
3072      rendering.  Change rendering of issue links to use inline-styles.
3073      Add colored issue markers to issues.
3074
3075
3076
3077
3078
3079Reschke                                                        [Page 55]
3080
3081Documentation             RFC2629 through XSLT            September 2009
3082
3083
3084   2003-12-13  Fix inheritance of ed:entered-by attribute.  Display note
3085      elements inside change tracking as well.
3086
3087   2004-01-18  When PI compact = 'yes', make most CSS print page breaks
3088      conditional.
3089
3090   2004-02-20  Support for RFC3667 IPR changes (xml2rfc 1.22); see <http
3091      ://lists.xml.resource.org/pipermail/xml2rfc/2004-February/
3092      001088.html>.
3093
3094   2004-03-11  Add "(if approved)" to "updates" and "obsoletes" unless
3095      the document has an RFC number.
3096
3097   2004-04-01  Fix RFC3667 output, see <http://lists.xml.resource.org/
3098      pipermail/xml2rfc/2004-April/001208.html>.
3099
3100   2004-04-04  Add support for section/top attribute.  Move references
3101      into plain section container.
3102
3103   2004-04-06  Do not emit identical para anchors for deleted content.
3104
3105   2004-04-14  Fix references TOC generation when there are no
3106      references.
3107
3108   2004-04-24  Fix RFC3667 output, see
3109      <http://xml.resource.org/pipermail/xml2rfc/2004-April/
3110      001246.html>.
3111
3112   2004-05-09  Add custom support for generating compound index
3113      documents.  Add anchors for each Index letter.  Add experimental
3114      cref support.  Fix conditional page breaks before References
3115      section.
3116
3117   2004-05-16  Refactor external index generation.
3118
3119   2004-05-20  Rewrite anchor generation for comments.
3120
3121   2004-05-22  Enhance issues rendering (add links to changes).
3122
3123   2004-05-30  Allow single quote as delimiter in processing
3124      instructions as well.  Move block-level issue pointers to floats.
3125      Disable issue pointers for print media.  Add "purple numbers".
3126      Add hrefs to section headings.  Add non-printing index key letter
3127      list to start of index.
3128
3129
3130
3131
3132
3133
3134
3135Reschke                                                        [Page 56]
3136
3137Documentation             RFC2629 through XSLT            September 2009
3138
3139
3140   2004-06-01  Use &#xb6; instead of # for PNs.
3141
3142   2004-07-18  Add support for list style=letters (thanks Roy F.).  Make
3143      PNs optional; add new PI.
3144
3145   2004-09-05  Fix index links into unnumbered sections.  Bring IPR
3146      boilerplate in-line with xml2rfc 1.25.  Add experimental CSS3
3147      paged media support.  Various HTML fixes.
3148
3149   2004-09-21  Enhance checking of artwork width.
3150
3151   2004-09-26  Add check for unused references.  Uppercase letters in
3152      list style letters when nested into another list.
3153
3154   2004-10-10  Fix internal change track pointers.
3155
3156   2004-11-01  Allow change tracking on references (as a whole).
3157      Rewrite artwork handling so that it allows change tracking inside
3158      artwork.  Also allow a subset of text markup inside artwork, such
3159      as xrefs (note this requires post-processing the source to make it
3160      compliant to RFC2629bis).
3161
3162   2004-11-03  Enhanced placement of iref anchors.
3163
3164   2004-11-06  Index: display irefs that appeared (with primary=true)
3165      inside artwork elements in a monospaced font.
3166
3167   2004-11-14  Add special code so that changes in section titles can be
3168      change-tracked.
3169
3170   2005-01-14  Bugfixes for HtmlToXhtml converter.
3171
3172   2005-01-22  Enhance generation of HTML h* elements (for Mozilla
3173      Outliner).
3174
3175   2005-01-31  Put vertical space around top-level TOC entries in TOC.
3176      Switch to pt-based CSS.  Re-arrange top section.  Make hr elements
3177      reflect new-page settings in TXT output (compact-PI).  Fix page
3178      number in footer (CSS print) and add some more experimental
3179      support for paged media (tested with Prince 4.1 alpha).  Rewrite
3180      TOC and Index generation to generate HTML lists.  Cleanup id
3181      generation for paragraphs.  Reduce whitespace in output.  Fix
3182      vspace implementation.  Use right/left dqoutes and copyright sign
3183      where appropriate.
3184
3185
3186
3187
3188
3189
3190
3191Reschke                                                        [Page 57]
3192
3193Documentation             RFC2629 through XSLT            September 2009
3194
3195
3196   2005-02-04  Add <link> element to references section.  Fix newly
3197      introduced bug in references processing.
3198
3199   2005-02-05  Integrate various fixes/enhancements by Roy Fielding:
3200      spelling of "Authors' Addresses", comma setting in references,
3201      position of "Authors" section, optionally place authors addresses
3202      at end (PI), trailing dots in section numbers, switch to verdana
3203      default font in CSS.  Add experimental support for centered
3204      artwork.
3205
3206   2005-02-09  Fixes in spacing and links of references section titles.
3207      Enhance sorting in references when change tracking is in place.
3208      Re-add figure centering support.  Add missing 2nd part of
3209      "Author's Adresses" fix.
3210
3211   2005-02-25  Align section number format with xml2rfc1.29.
3212
3213   2005-03-28  Get rid of table elements in Author's section.  Add
3214      experimental hCard (<http://developers.technorati.com/wiki/hCard>)
3215      support.
3216
3217   2005-04-03  Add RFC3978-style IPR statement support.
3218      (fenner@research.att.com)
3219
3220   2005-04-11  Cleanup author display. hCard related fixes.
3221
3222   2005-05-07  Minor fixes to allow change tracking in doc title.  Add
3223      experimental support for table border styles.  CSS cleanup.
3224
3225   2005-06-18  Implement missing support for references to texttables.
3226
3227   2005-09-25  Use (-moz-)column-count when printing the index.
3228
3229   2005-10-04  Report missing element templates with xsl:message.
3230
3231   2005-10-15  Process t/@anchor.
3232
3233   2005-10-23  More workarounds for Mozilla's broken del/ins handling
3234      (this time for figures).
3235
3236   2005-10-27  lowercase hCard class names
3237
3238   2005-11-22  Enhance diagnostics for XML-in-artwork extension
3239
3240   2005-11-26  Fix formatting of section numbers for sections inserted
3241      into <back>.
3242
3243
3244
3245
3246
3247Reschke                                                        [Page 58]
3248
3249Documentation             RFC2629 through XSLT            September 2009
3250
3251
3252   2005-12-12  Fix some validity problems when change tracking occured
3253      inside lists.
3254
3255   2005-12-18  Add change tracking inside the index.
3256
3257   2006-02-04  Add prev/next links to highlighted changes (change
3258      tracking extension).
3259
3260   2006-02-10  Catch errors instantiating MSXML component.
3261
3262   2006-02-11  References: add "work in progress" for Internet Drafts.
3263
3264   2006-02-27  Fix front matter (lowercase Internet-Draft, say "Intended
3265      status" for non-RFC documents).  Start work on experimental
3266      extension for simplified internal links.
3267
3268   2006-03-19  Tweaks to IESG Copyright stuff; support submissionType
3269      attribute.  Fix duplicate reference anchors in HTML output.
3270      Reduce HTML Tidy warnings.  Fix reference to normative ASCII
3271      version (now requires trailing ".txt").  Tweaks to hCard
3272      generation.  Started to move non-issue-tracking extensions into
3273      namespace "http://purl.org/net/xml2rfc/ext".
3274
3275   2006-03-27  Moved "simple reference" extension into namespace
3276      "http://purl.org/net/xml2rfc/ext" and add documentation.  HTML
3277      conformance enhancements.
3278
3279   2006-04-02  Cleanup special code for automated XHTML XSLT generation.
3280
3281   2006-04-21  Generate <CITE> elements where appropiate.  Introduce
3282      x:blockquote, x:dfn, x:h and x:q elements.
3283
3284   2006-05-06  Introduce x:bcp14 element.
3285
3286   2006-05-14  Fix content model for x:blockquote.
3287
3288   2006-06-18  Add box drawing support (x:bt, x:bc, x:bb).
3289
3290   2006-06-20  HTML validity fixes (legal chars in anchors in index).
3291
3292   2006-06-24  Reduce leading empty lines in artwork.  Move <dt> style
3293      info into CSS.
3294
3295   2006-07-14  Fix rendering of multiple street address entries (missing
3296      line break).
3297
3298
3299
3300
3301
3302
3303Reschke                                                        [Page 59]
3304
3305Documentation             RFC2629 through XSLT            September 2009
3306
3307
3308   2006-07-24  Add extension for deep linking into RFCs, do not generate
3309      empty list items in TOC output, avoid empty <dt> elements for list
3310      items without hangText attribute.
3311
3312   2006-08-01  Allow @anchor on more elements; start work on Relax NG
3313      grammar for extensions.  Reduce generated style elements (use CSS
3314      classes instead).  Consistently use "id" instead of "name".
3315      Change default target for RFC links to
3316      "http://tools.ietf.org/html/rfcNNNN".
3317
3318   2006-08-06  Include appendices defined in <appendix> elements in TOC
3319      (please consider them deprecated anyhow!).  Generate links to
3320      "http://tools.ietf.org/html/draft-*" for Internet Drafts.  Replace
3321      x:frag by x:rel, allowing any kind of relative reference instead
3322      of just fragments.
3323
3324   2006-08-30  Reduce textual differences between HTML output and what
3325      xml2rfc produces in TXT output mode (section refs/reference
3326      targets).  Add small workaround for Opera 9.0.1's problem with
3327      node-set().
3328
3329   2006-10-29  Fix problem generating internal links to change markup
3330      within references section.  Enhancements when generating numbered
3331      references for deleted references.  Allow inclusion of references
3332      into the index (through include-references-in-index extension).
3333      Fix a bug that caused the newer version of the IETF boilerplate to
3334      be produced rather than the pre-RFC3667 one.  Update to RFC4287
3335      boilerplate.
3336
3337   2006-11-11  Add extension attribute x:for-anchor to <iref> handling.
3338
3339   2006-11-26  Experimental (and limited) support for <x:lt>.
3340
3341   2006-12-04  Fix bugs in processing documents that have both the ipr
3342      and the number attribute set on the rfc root element.  Add support
3343      for x:fmt='none' on xrefs.  Add different pre style based on
3344      artwork type attributes (experimental).
3345
3346   2006-12-13  Add x:fmt='anchor' for xref elements.
3347
3348   2007-01-07  Fix root template for compatibility for the exslt:node-
3349      set implementation in Firefox3.
3350
3351   2007-01-29  Avoid empty table entry in front matter when organization
3352      is not specified for an author.
3353
3354
3355
3356
3357
3358
3359Reschke                                                        [Page 60]
3360
3361Documentation             RFC2629 through XSLT            September 2009
3362
3363
3364   2007-02-10  Allow change tracking in table rows.
3365
3366   2007-03-09  Add hcard profile URI (<http://www.w3.org/2006/03/hcard>)
3367      to head element.  Add warning for misplaced <t> elements (after
3368      section).
3369
3370   2007-03-21  Fix internal linking from reference entries in index for
3371      some xref types.  Minor CSS tweaks contributed by MTR.  Allow
3372      turning on text justification through a PI.  Improve iref anchor
3373      generation to generate less instable anchors.
3374
3375   2007-03-28  Fixes for numbering of ed:inserted references sections.
3376
3377   2007-05-04  Do not generate anchors for edits in deleted sections.
3378      Enhance HTML conformance.
3379
3380   2007-05-19  Enhance diagnostics when using Saxon (needs Saxon's "-l"
3381      command line parameter to keep line number information).  Add
3382      warning when symref PI is missing (default will change in the
3383      future).  Add support for overriding computed section numbers
3384      (when formatting historic documents).
3385
3386   2007-06-07  Change default for symrefs PI to "yes" (see change in
3387      xml2rfc 1.33pre4).  Warn about docName attributes that appear to
3388      contain a file extension.
3389
3390   2007-06-26  Workaround author/@initials values without trailing dot,
3391      as in xml2rfc.tcl.
3392
3393   2007-07-14  Enhance index generation for references that use @x:sec
3394      attribute.
3395
3396   2007-09-09  Fix: sortrefs is a nop when symrefs=no.
3397
3398   2007-10-17  Work in progress: add support for referencing sections in
3399      sibling documents by anchor name.
3400
3401   2007-10-17  Work in progress (continued): support for referencing
3402      sections in sibling documents by anchor name.
3403
3404   2007-12-31  Emit warning when updating/obsoleting stuff that's not
3405      referenced.
3406
3407   2008-02-03  Support xml2rfc-1.33pre5's suppress-title attribute on
3408      texttable and figure.
3409
3410
3411
3412
3413
3414
3415Reschke                                                        [Page 61]
3416
3417Documentation             RFC2629 through XSLT            September 2009
3418
3419
3420   2008-02-06  Extension: allow <eref> below <cref>.
3421
3422   2008-02-17  Extensions: add x:span and x:length-of.
3423
3424   2008-02-20  Add new RFC boilerplate (as changed in 2007-08).
3425
3426   2008-02-27  Improve diagnostics for artwork width problems; add
3427      defaulting of publication dates (requires XSLT processor
3428      supporting exslt:date, or msxml).
3429
3430   2008-02-29  Enhance CSS for link elements in the front header, update
3431      rules for generating "Acknowledgment" statement.
3432
3433   2008-03-01  Use line numbers in diagnostics in Saxon8/9 as well.
3434
3435   2008-03-02  Fix a bug in the logic choosing the boilerplate,
3436      resulting in obsolete text being inserted into IDs.
3437
3438   2008-04-01  Add support for superscript element.
3439
3440   2008-06-28  Add sanity checks for email addresses, allow multiple
3441      email elements.
3442
3443   2008-07-06  Add x:abnf-char-sequence.
3444
3445   2008-08-21  Add x:note.
3446
3447   2008-09-06  Add experimental support for SVG images.
3448
3449   2008-09-17  Add experimental support for x:author.  Fix xref/@
3450      format=none.
3451
3452   2008-10-10  Fix a huge bug, causing text content after an XML comment
3453      to be ignored.
3454
3455   2009-02-24  Use table/caption when needed.
3456
3457   2009-03-07  Fix bug that caused text to disappear in the output in
3458      presence of processing instructions.
3459
3460   2009-03-12  Make inlined comments bookmarkable.
3461
3462   2009-04-09  Upgrade to DC-HTML from RFC 2731 (affects head/@profile).
3463
3464   2009-07-08  Remove table/@summary in output; the value getting
3465      inserted was just repeating stuff that appeared in the preamble.
3466
3467
3468
3469
3470
3471Reschke                                                        [Page 62]
3472
3473Documentation             RFC2629 through XSLT            September 2009
3474
3475
3476   2009-08-01  Implement table alignment (HTML output only for now).
3477
3478   2009-08-18  Replicate Dublin Core "abstract" metadata into meta/@
3479      name=description (search engines do use it).
3480
3481   2009-09-02  Fix default/left alignment of table columns, remove silly
3482      table summmary attributes.
3483
3484   2009-09-24  Support double-sided layout using CSS page:left/right
3485      selectors.
3486
3487E.6.  rfc2629toFO.xslt
3488
3489   2003-11-16  Initial release.
3490
3491   2003-11-29  Enhance handling of unknown list styles.
3492
3493   2004-04-04  Update reference section handling.
3494
3495   2004-04-17  Use XSL-WD-1.1-style fo:bookmark and index handling and
3496      add postprocessors for existing implementations.  Unify PDF info
3497      generation by using XEP (postprocessors) will convert.
3498
3499   2004-04-20  Add experimental cref support.
3500
3501   2004-06-14  Set correct index-item defaults.
3502
3503   2004-07-18  Add list style=letters.
3504
3505   2004-09-03  Make URLs in text break where they are allowed to break
3506      by inserting zero-width spaces.
3507
3508   2004-09-26  Fix letter-style inside nested lists.
3509
3510   2004-10-31  Update handling of artwork.
3511
3512   2004-11-13  Fix handling of references inside ed:* markup.  Fix
3513      whitespace handling in artwork.
3514
3515   2004-11-27  Irefs in artwork generate monospaced entries in index.
3516
3517   2005-01-31  Fix TOC generation that was broken after changes in main
3518      XSLT.
3519
3520   2005-02-05  Bring in sync with cosmetic changes in rfc2629.xslt.
3521
3522
3523
3524
3525
3526
3527Reschke                                                        [Page 63]
3528
3529Documentation             RFC2629 through XSLT            September 2009
3530
3531
3532   2005-05-07  Minor fix for change tracking in document title.  Support
3533      for table styles.
3534
3535   2005-06-18  Fix references to tables.
3536
3537   2005-10-15  Process t/@anchor.
3538
3539   2006-02-11  References: add "work in progress" for Internet Drafts.
3540
3541   2006-06-02  Use XSL 1.1 WD Feb 2006.
3542
3543   2007-03-21  Support optional text justification.
3544
3545   2007-05-19  Various improvements in spacing; also allow overriding
3546      the automatic list indentation via list/x:indent.
3547
3548   2009-04-08  Fix spacing in headers; add support for formatting for
3549      double-sided printing.
3550
3551   2009-08-01  Remove surplus empty pages when not generating double-
3552      sided output.
3553
3554E.7.  xsl11toAn.xslt
3555
3556   2004-05-17  Initial release.
3557
3558   2006-06-02  Use XSL 1.1 WD Feb 2006.
3559
3560E.8.  xsl11toFop.xslt
3561
3562   2004-05-17  Initial release.
3563
3564   2006-06-02  Use XSL 1.1 WD Feb 2006.
3565
3566E.9.  xsl11toFop-0.95.xslt
3567
3568   2009-09-12  Support for FOP 0.20.5 and FOP 0.93 removed.  Please use
3569      FOP 0.95.
3570
3571   2008-03-15  Add a workaround to the fo:inline workaround (sigh).
3572
3573E.10.  xsl11toXep.xslt
3574
3575   2004-05-17  Initial release.
3576
3577
3578
3579
3580
3581
3582
3583Reschke                                                        [Page 64]
3584
3585Documentation             RFC2629 through XSLT            September 2009
3586
3587
3588   2004-09-04  Fix xep:index-item attributes.
3589
3590   2006-06-02  Use XSL 1.1 WD Feb 2006.
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
3620
3621
3622
3623
3624
3625
3626
3627
3628
3629
3630
3631
3632
3633
3634
3635
3636
3637
3638
3639Reschke                                                        [Page 65]
3640
3641Documentation             RFC2629 through XSLT            September 2009
3642
3643
3644Index
3645
3646   A
3647      abnf-char-sequence Extension Element  22, 36
3648      allow-markup-in-artwork PI pseudo-attribute  8
3649      alternate HTML LINK element  16
3650      anchor-alias Extension Element  22, 36
3651      Anchors
3652         rfc.abstract  13
3653         rfc.authors  13
3654         rfc.copyright  13
3655         rfc.copyrightnotice  13
3656         rfc.figure.n  13
3657         rfc.figure.u.n  13
3658         rfc.index  13
3659         rfc.ipr  13
3660         rfc.iref.n  13
3661         rfc.note.n  13
3662         rfc.references  13
3663         rfc.section.n  13
3664         rfc.section.n.p.m  13
3665         rfc.status  13
3666         rfc.toc  13
3667         rfc.xref.name.n  13
3668      AntennaHouse XSL Formatter  20
3669      Apache FOP  20
3670      appendix HTML LINK element  16
3671      assign-section-number Extension Element  36
3672      author HTML LINK element  16
3673      authors-section PI pseudo-attribute  8
3674
3675   B
3676      background PI pseudo-attribute  6
3677      bb Extension Element  23, 36
3678      bc Extension Element  23, 36
3679      bcp14 Extension Element  22, 36
3680      blockquote Extension Element  23, 36
3681      boilerplate Extension Element  23, 36
3682      bt Extension Element  24, 36
3683
3684   C
3685      chapter HTML LINK element  16
3686      CHM format  19
3687      comments PI pseudo-attribute  6
3688      compact PI pseudo-attribute  6
3689      contents HTML LINK element  16
3690      copyright HTML LINK element  16
3691      Creator DCMI property  17
3692
3693
3694
3695Reschke                                                        [Page 66]
3696
3697Documentation             RFC2629 through XSLT            September 2009
3698
3699
3700   D
3701      Date.Issued DCMI property  17
3702      DCMI properties
3703         Creator  17
3704         Date.Issued  17
3705         Description.Abstract  17
3706         Identifier  17
3707         isPartOf  17
3708         Relation.Replaces  17
3709      Description.Abstract DCMI property  17
3710      dfn Extension Element  24, 36
3711      duplex PI pseudo-attribute  8
3712
3713   E
3714      editing PI pseudo-attribute  6
3715      Extension Elements
3716         abnf-char-sequence  22, 36
3717         anchor-alias  22, 36
3718         assign-section-number  36
3719         bb  23, 36
3720         bc  23, 36
3721         bcp14  22, 36
3722         blockquote  23, 36
3723         boilerplate  23, 36
3724         bt  24, 36
3725         dfn  24, 36
3726         h  24, 36
3727         highlight  24, 36
3728         include-author  36
3729         length-of  24, 36
3730         link  24, 36
3731         lt  25, 36
3732         note  25, 36
3733         parse-xml  25, 36
3734         q  25, 36
3735         rdf:Description  36
3736         ref  25, 36
3737         source  26, 36
3738         span  36
3739         sup  26, 36
3740         x  36
3741
3742   F
3743      Firefox
3744         1.*/2.*  15
3745         3.*  14
3746      footer PI pseudo-attribute  6
3747
3748
3749
3750
3751Reschke                                                        [Page 67]
3752
3753Documentation             RFC2629 through XSLT            September 2009
3754
3755
3756   G
3757      generator HTML META element  17
3758      Google Chrome  14
3759      Grammar  36
3760
3761   H
3762      h Extension Element  24, 36
3763      header PI pseudo-attribute  6
3764      highlight Extension Element  24, 36
3765      HTML compliance  16
3766      HTML LINK elements
3767         alternate  16
3768         appendix  16
3769         author  16
3770         chapter  16
3771         contents  16
3772         copyright  16
3773         index  16
3774      HTML META elements
3775         generator  17
3776         keywords  17
3777
3778   I
3779      Identifier DCMI property  17
3780      include PI pseudo-attribute  7
3781      include-author Extension Element  36
3782      include-references-in-index PI pseudo-attribute  8
3783      index HTML LINK element  16
3784      inline PI pseudo-attribute  6
3785      Internet Explorer 5.5  14
3786      Internet Explorer 6  14
3787      Internet Explorer 7  14
3788      Internet Explorer 8  14
3789      iprnotified PI pseudo-attribute  6
3790      isPartOf DCMI property  17
3791
3792   J
3793      justification PI pseudo-attribute  8
3794
3795   K
3796      keywords HTML META element  17
3797
3798   L
3799      length-of Extension Element  24, 36
3800      link Extension Element  24, 36
3801      linkmailto PI pseudo-attribute  6
3802      lt Extension Element  25, 36
3803
3804
3805
3806
3807Reschke                                                        [Page 68]
3808
3809Documentation             RFC2629 through XSLT            September 2009
3810
3811
3812   M
3813      Microsoft Help  19
3814      Mozilla  14-15
3815      MSXML3  14
3816      MSXML4  14
3817
3818   N
3819      needLines PI pseudo-attribute  7
3820      NoScript  14
3821      note Extension Element  25, 36
3822
3823   O
3824      Opera  14-15
3825
3826   P
3827      Parameters
3828         xml2rfc-background  6
3829         xml2rfc-comments  6
3830         xml2rfc-compact  6
3831         xml2rfc-editing  6
3832         xml2rfc-ext-allow-markup-in-artwork  8
3833         xml2rfc-ext-authors-section  8
3834         xml2rfc-ext-duplex  8
3835         xml2rfc-ext-include-references-in-index  8
3836         xml2rfc-ext-justification  8
3837         xml2rfc-ext-parse-xml-in-artwork  8
3838         xml2rfc-ext-sec-no-trailing-dots  8
3839         xml2rfc-ext-support-rfc2731  8
3840         xml2rfc-footer  6
3841         xml2rfc-header  6
3842         xml2rfc-inline  6
3843         xml2rfc-iprnotified  6
3844         xml2rfc-linkmailto  6
3845         xml2rfc-private  6
3846         xml2rfc-refparent  6
3847         xml2rfc-rfcedstyle  6
3848         xml2rfc-sortrefs  6
3849         xml2rfc-symrefs  6
3850         xml2rfc-toc  6
3851         xml2rfc-tocdepth  6
3852         xml2rfc-topblock  6
3853      parse-xml Extension Element  25, 36
3854      parse-xml-in-artwork PI pseudo-attribute  8
3855      private PI pseudo-attribute  6
3856      Processing Instruction pseudo attributes
3857         allow-markup-in-artwork  8
3858         authors-section  8
3859         background  6
3860
3861
3862
3863Reschke                                                        [Page 69]
3864
3865Documentation             RFC2629 through XSLT            September 2009
3866
3867
3868         comments  6
3869         compact  6
3870         duplex  8
3871         editing  6
3872         footer  6
3873         header  6
3874         ijustification  8
3875         include  7
3876         include-references-in-index  8
3877         inline  6
3878         iprnotified  6
3879         linkmailto  6
3880         needLines  7
3881         parse-xml-in-artwork  8
3882         private  6
3883         refparent  6
3884         rfcedstyle  6
3885         sec-no-trailing-dots  8
3886         slides  7
3887         sortrefs  6
3888         strict  7
3889         subcompact  7
3890         support-rfc2731  8
3891         symrefs  6
3892         toc  6
3893         tocdepth  6
3894         tocindent  7
3895         tocompact  7
3896         topblock  6
3897
3898   Q
3899      q Extension Element  25, 36
3900
3901   R
3902      rdf:Description Extension Element  36
3903      ref Extension Element  25, 36
3904      refparent PI pseudo-attribute  6
3905      Relation.Replaces DCMI property  17
3906      RELAX NG Compact Schema  36
3907      rfc.abstract anchor  13
3908      rfc.authors anchor  13
3909      rfc.copyright anchor  13
3910      rfc.copyrightnotice anchor  13
3911      rfc.figure.n anchor  13
3912      rfc.figure.u.n anchor  13
3913      rfc.index anchor  13
3914      rfc.ipr anchor  13
3915      rfc.iref.n anchor  13
3916
3917
3918
3919Reschke                                                        [Page 70]
3920
3921Documentation             RFC2629 through XSLT            September 2009
3922
3923
3924      rfc.note.n anchor  13
3925      rfc.references anchor  13
3926      rfc.references.n anchor  13
3927      rfc.section.n anchor  13
3928      rfc.section.n.p.m anchor  13
3929      rfc.status anchor  13
3930      rfc.toc anchor  13
3931      rfc.xref.name.n anchor  13
3932      rfcedstyle PI pseudo-attribute  6
3933
3934   S
3935      Safari  14-15
3936         3.*  14
3937      Saxon  14
3938      Schema  36
3939      sec-no-trailing-dots PI pseudo-attribute  8
3940      slides PI pseudo-attribute  7
3941      sortrefs PI pseudo-attribute  6
3942      source Extension Element  26, 36
3943      span Extension Element  36
3944      strict PI pseudo-attribute  7
3945      subcompact PI pseudo-attribute  7
3946      sup Extension Element  26, 36
3947      support-rfc2731 PI pseudo-attribute  8
3948      symrefs PI pseudo-attribute  6
3949
3950   T
3951      toc PI pseudo-attribute  6
3952      tocdepth PI pseudo-attribute  6
3953      tocindent PI pseudo-attribute  7
3954      tocompact PI pseudo-attribute  7
3955      topblock PI pseudo-attribute  6
3956
3957   X
3958      x Extension Element  36
3959      Xalan  14
3960      xml-stylesheet PI  16
3961      xml2rfc-background parameter  6
3962      xml2rfc-comments parameter  6
3963      xml2rfc-editing parameter  6
3964      xml2rfc-ext-allow-markup-in-artwork parameter  8
3965      xml2rfc-ext-authors-section parameter  8
3966      xml2rfc-ext-duplex  8
3967      xml2rfc-ext-include-references-in-index parameter  8
3968      xml2rfc-ext-justification parameter  8
3969      xml2rfc-ext-parse-xml-in-artwork parameter  8
3970      xml2rfc-ext-sec-no-trailing-dots parameter  8
3971      xml2rfc-ext-support-rfc2731 parameter  8
3972
3973
3974
3975Reschke                                                        [Page 71]
3976
3977Documentation             RFC2629 through XSLT            September 2009
3978
3979
3980      xml2rfc-footer parameter  6
3981      xml2rfc-header parameter  6
3982      xml2rfc-inline parameter  6
3983      xml2rfc-iprnotified parameter  6
3984      xml2rfc-linkmailto parameter  6
3985      xml2rfc-private parameter  6
3986      xml2rfc-refparent parameter  6
3987      xml2rfc-rfcedstyle parameter  6
3988      xml2rfc-sortrefs parameter  6
3989      xml2rfc-symrefs parameter  6
3990      xml2rfc-toc parameter  6
3991      xml2rfc-tocdepth parameter  6
3992      xml2rfc-topblock parameter  6
3993      xsltproc  14
3994         passing parameters  5
3995
3996
3997
3998
3999
4000
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
4024
4025
4026
4027
4028
4029
4030
4031Reschke                                                        [Page 72]
4032
4033Documentation             RFC2629 through XSLT            September 2009
4034
4035
4036Author's Address
4037
4038   Julian F. Reschke
4039   greenbytes GmbH
4040   Hafenweg 16
4041   Muenster, NW  48155
4042   Germany
4043
4044   Phone: +49 251 2807760
4045   Email: julian.reschke@greenbytes.de
4046   URI:   http://greenbytes.de/tech/webdav/
4047
4048
4049
4050
4051
4052
4053
4054
4055
4056
4057
4058
4059
4060
4061
4062
4063
4064
4065
4066
4067
4068
4069
4070
4071
4072
4073
4074
4075
4076
4077
4078
4079
4080
4081
4082
4083
4084
4085
4086
4087Reschke                                                        [Page 73]
4088
Note: See TracBrowser for help on using the repository browser.