source: rfc2629xslt/rfc2629xslt.txt @ 981

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

bump up document dates, update to latest version of rfc2629.xslt

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