Ignore:
Timestamp:
01/12/10 12:07:53 (10 years ago)
Author:
julian.reschke@…
Message:

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • rfc2629xslt/rfc2629xslt.txt

    r1072 r1095  
    44RFC2629 through XSLT                                          J. Reschke
    55                                                              greenbytes
    6                                                           September 2010
     6                                                       November 29, 2010
    77
    88
     
    3737       9.1.2.  Example: producing output for Apache FOP . . . . . . . 22
    3838     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
     39   10. Transforming to ePub . . . . . . . . . . . . . . . . . . . . . 23
     40   11. Generic Extensions . . . . . . . . . . . . . . . . . . . . . . 24
     41     11.1.  <abnf-char-sequence> element  . . . . . . . . . . . . . . 24
     42     11.2.  <anchor-alias> element  . . . . . . . . . . . . . . . . . 24
     43     11.3.  <bcp14> element . . . . . . . . . . . . . . . . . . . . . 24
     44     11.4.  <bb> element  . . . . . . . . . . . . . . . . . . . . . . 25
     45     11.5.  <bc> element  . . . . . . . . . . . . . . . . . . . . . . 25
     46     11.6.  <blockquote> element  . . . . . . . . . . . . . . . . . . 25
     47     11.7.  <boilerplate> element . . . . . . . . . . . . . . . . . . 25
     48     11.8.  <bt> element  . . . . . . . . . . . . . . . . . . . . . . 26
     49     11.9.  <dfn> element . . . . . . . . . . . . . . . . . . . . . . 26
     50     11.10. <h> element . . . . . . . . . . . . . . . . . . . . . . . 26
     51     11.11. <highlight> element . . . . . . . . . . . . . . . . . . . 26
    5252
    5353
     
    5656
    5757
    58 Documentation             RFC2629 through XSLT            September 2010
    59 
    60 
    61      10.13. <link> element  . . . . . . . . . . . . . . . . . . . . . 25
    62      10.14. <lt> element  . . . . . . . . . . . . . . . . . . . . . . 26
    63      10.15. <note> element  . . . . . . . . . . . . . . . . . . . . . 26
    64      10.16. <parse-xml> element . . . . . . . . . . . . . . . . . . . 26
    65      10.17. <prose> element . . . . . . . . . . . . . . . . . . . . . 26
    66      10.18. <q> element . . . . . . . . . . . . . . . . . . . . . . . 26
    67      10.19. <ref> element . . . . . . . . . . . . . . . . . . . . . . 26
    68      10.20. <source> element . . . . . . . . . . . . . . . . . . . . 27
    69      10.21. <sup> element . . . . . . . . . . . . . . . . . . . . . . 27
    70      10.22. Extensions to Xml2rfc <artwork> element . . . . . . . . . 27
    71      10.23. Extensions to Xml2rfc <iref> element  . . . . . . . . . . 28
    72      10.24. Extensions to Xml2rfc <list> element  . . . . . . . . . . 28
    73      10.25. Extensions to Xml2rfc <rfc> element . . . . . . . . . . . 28
    74      10.26. Extensions to Xml2rfc <section> element . . . . . . . . . 28
    75      10.27. Extensions to Xml2rfc <xref> element  . . . . . . . . . . 29
    76    11. Utilities  . . . . . . . . . . . . . . . . . . . . . . . . . . 30
    77      11.1.  Checking References . . . . . . . . . . . . . . . . . . . 30
    78      11.2.  Generating Graphs from References . . . . . . . . . . . . 32
    79      11.3.  Producing reference entries for books . . . . . . . . . . 32
    80      11.4.  Down-converting to RFC2629bis DTD . . . . . . . . . . . . 33
    81      11.5.  Extracting artwork  . . . . . . . . . . . . . . . . . . . 34
    82      11.6.  GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 34
    83    12. Informative References . . . . . . . . . . . . . . . . . . . . 35
    84    Appendix A.  RELAX NG Compact Schema . . . . . . . . . . . . . . . 37
    85    Appendix B.  Implementation Notes  . . . . . . . . . . . . . . . . 47
    86      B.1.   Recognized type attributes for <artwork> element  . . . . 47
    87    Appendix C.  Examples  . . . . . . . . . . . . . . . . . . . . . . 48
    88      C.1.   Using the 'Internal Subset' . . . . . . . . . . . . . . . 48
    89      C.2.   Customization . . . . . . . . . . . . . . . . . . . . . . 48
    90    Appendix D.  The /rfc/@ipr Attribute . . . . . . . . . . . . . . . 50
    91      D.1.   Current Values: '*trust200902'  . . . . . . . . . . . . . 50
    92        D.1.1.  trust200902  . . . . . . . . . . . . . . . . . . . . . 51
    93        D.1.2.  noModificationTrust200902  . . . . . . . . . . . . . . 51
    94        D.1.3.  noDerivativesTrust200902 . . . . . . . . . . . . . . . 51
    95        D.1.4.  pre5378Trust200902 . . . . . . . . . . . . . . . . . . 51
    96      D.2.   Historic Values . . . . . . . . . . . . . . . . . . . . . 52
    97        D.2.1.  Historic Values: '*trust200811'  . . . . . . . . . . . 52
    98        D.2.2.  Historic Values: '*3978' . . . . . . . . . . . . . . . 52
    99        D.2.3.  Historic Values: '*3667' . . . . . . . . . . . . . . . 52
    100        D.2.4.  Historic Values: '*2026' . . . . . . . . . . . . . . . 52
    101    Appendix E.  License . . . . . . . . . . . . . . . . . . . . . . . 53
    102    Appendix F.  Change Logs . . . . . . . . . . . . . . . . . . . . . 54
    103      F.1.   Package . . . . . . . . . . . . . . . . . . . . . . . . . 54
    104      F.2.   amazon-asin.xslt  . . . . . . . . . . . . . . . . . . . . 55
    105      F.3.   check-references.xslt . . . . . . . . . . . . . . . . . . 55
    106      F.4.   gen-reference-graph.xslt  . . . . . . . . . . . . . . . . 56
    107      F.5.   rfc2629.xslt  . . . . . . . . . . . . . . . . . . . . . . 56
    108      F.6.   rfc2629toFO.xslt  . . . . . . . . . . . . . . . . . . . . 67
     58Documentation             RFC2629 through XSLT             November 2010
     59
     60
     61     11.12. <length-of> element . . . . . . . . . . . . . . . . . . . 26
     62     11.13. <link> element . . . . . . . . . . . . . . . . . . . . . 26
     63     11.14. <lt> element  . . . . . . . . . . . . . . . . . . . . . . 27
     64     11.15. <note> element  . . . . . . . . . . . . . . . . . . . . . 27
     65     11.16. <parse-xml> element . . . . . . . . . . . . . . . . . . . 27
     66     11.17. <prose> element . . . . . . . . . . . . . . . . . . . . . 27
     67     11.18. <q> element . . . . . . . . . . . . . . . . . . . . . . . 27
     68     11.19. <ref> element . . . . . . . . . . . . . . . . . . . . . . 27
     69     11.20. <source> element  . . . . . . . . . . . . . . . . . . . . 28
     70     11.21. <sup> element . . . . . . . . . . . . . . . . . . . . . . 28
     71     11.22. Extensions to Xml2rfc <artwork> element . . . . . . . . . 28
     72     11.23. Extensions to Xml2rfc <iref> element  . . . . . . . . . . 29
     73     11.24. Extensions to Xml2rfc <list> element  . . . . . . . . . . 29
     74     11.25. Extensions to Xml2rfc <rfc> element . . . . . . . . . . . 29
     75     11.26. Extensions to Xml2rfc <section> element . . . . . . . . . 29
     76     11.27. Extensions to Xml2rfc <xref> element . . . . . . . . . . 30
     77   12. Utilities  . . . . . . . . . . . . . . . . . . . . . . . . . . 31
     78     12.1.  Checking References . . . . . . . . . . . . . . . . . . . 31
     79     12.2.  Generating Graphs from References . . . . . . . . . . . . 33
     80     12.3.  Producing reference entries for books . . . . . . . . . . 33
     81     12.4.  Down-converting to RFC2629bis DTD . . . . . . . . . . . . 34
     82     12.5.  Extracting artwork  . . . . . . . . . . . . . . . . . . . 35
     83     12.6.  GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 35
     84   13. Informative References . . . . . . . . . . . . . . . . . . . . 36
     85   Appendix A.  RELAX NG Compact Schema . . . . . . . . . . . . . . . 38
     86   Appendix B.  Implementation Notes  . . . . . . . . . . . . . . . . 48
     87     B.1.   Recognized type attributes for <artwork> element . . . . 48
     88   Appendix C.  Examples  . . . . . . . . . . . . . . . . . . . . . . 49
     89     C.1.   Using the 'Internal Subset' . . . . . . . . . . . . . . . 49
     90     C.2.   Customization . . . . . . . . . . . . . . . . . . . . . . 49
     91   Appendix D.  Producing the IETF 'Boilerplate'  . . . . . . . . . . 51
     92     D.1.   The /rfc/@ipr Attribute . . . . . . . . . . . . . . . . . 51
     93       D.1.1.  Current Values: '*trust200902' . . . . . . . . . . . . 52
     94       D.1.2.  Historic Values  . . . . . . . . . . . . . . . . . . . 53
     95     D.2.   The /rfc/@category Attribute  . . . . . . . . . . . . . . 54
     96     D.3.   The /rfc/@submissionType Attribute  . . . . . . . . . . . 54
     97     D.4.   The /rfc/@consensus Attribute . . . . . . . . . . . . . . 55
     98     D.5.   The /rfc/@number Attribute  . . . . . . . . . . . . . . . 56
     99     D.6.   The /rfc/@docName Attribute . . . . . . . . . . . . . . . 56
     100     D.7.   The /rfc/@obsoletes Attribute . . . . . . . . . . . . . . 56
     101     D.8.   The /rfc/@updates Attribute . . . . . . . . . . . . . . . 56
     102   Appendix E.  License . . . . . . . . . . . . . . . . . . . . . . . 57
     103   Appendix F.  Change Logs . . . . . . . . . . . . . . . . . . . . . 58
     104     F.1.   Package . . . . . . . . . . . . . . . . . . . . . . . . . 58
     105     F.2.   amazon-asin.xslt  . . . . . . . . . . . . . . . . . . . . 59
     106     F.3.   check-references.xslt . . . . . . . . . . . . . . . . . . 59
     107     F.4.   gen-reference-graph.xslt  . . . . . . . . . . . . . . . . 60
     108     F.5.   rfc2629.xslt  . . . . . . . . . . . . . . . . . . . . . . 60
    109109
    110110
     
    113113
    114114
    115 Documentation             RFC2629 through XSLT            September 2010
    116 
    117 
    118      F.7.   xsl11toAn.xslt  . . . . . . . . . . . . . . . . . . . . . 69
    119      F.8.   xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 69
    120      F.9.   xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 69
    121    Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
    122    Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 78
    123 
     115Documentation             RFC2629 through XSLT             November 2010
     116
     117
     118     F.6.   rfc2629toFO.xslt  . . . . . . . . . . . . . . . . . . . . 71
     119     F.7.   xsl11toAn.xslt  . . . . . . . . . . . . . . . . . . . . . 73
     120     F.8.   xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 73
     121     F.9.   xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 73
     122   Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
     123   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 82
    124124
    125125
     
    170170
    171171
    172 Documentation             RFC2629 through XSLT            September 2010
     172Documentation             RFC2629 through XSLT             November 2010
    173173
    174174
     
    194194   o  outputting PDF (Section 9),
    195195
    196    o  extensions to the xml2rfc vocabulary (Section 10).
    197 
    198    o  various utilities (Section 11).
     196   o  extensions to the xml2rfc vocabulary (Section 11).
     197
     198   o  various utilities (Section 12).
    199199
    200200   The full distribution is available at
     
    227227
    228228
    229 Documentation             RFC2629 through XSLT            September 2010
     229Documentation             RFC2629 through XSLT             November 2010
    230230
    231231
     
    241241
    242242   The first set contains (hopefully) generally useful extensions, see
    243    Section 10.
     243   Section 11.
    244244
    245245   The second set is used for change and issue tracking and currently is
     
    284284
    285285
    286 Documentation             RFC2629 through XSLT            September 2010
     286Documentation             RFC2629 through XSLT             November 2010
    287287
    288288
     
    341341
    342342
    343 Documentation             RFC2629 through XSLT            September 2010
     343Documentation             RFC2629 through XSLT             November 2010
    344344
    345345
     
    398398
    399399
    400 Documentation             RFC2629 through XSLT            September 2010
     400Documentation             RFC2629 through XSLT             November 2010
    401401
    402402
     
    455455
    456456
    457 Documentation             RFC2629 through XSLT            September 2010
     457Documentation             RFC2629 through XSLT             November 2010
    458458
    459459
     
    489489   |      |                 |                       |      | n XSLT in |
    490490   |      |                 |                       |      | Section 1 |
    491    |      |                 |                       |      | 1.4).     |
     491   |      |                 |                       |      | 2.4).     |
    492492   |      |                 |                       |      |           |
    493493
     
    512512
    513513
    514 Documentation             RFC2629 through XSLT            September 2010
     514Documentation             RFC2629 through XSLT             November 2010
    515515
    516516
     
    569569
    570570
    571 Documentation             RFC2629 through XSLT            September 2010
     571Documentation             RFC2629 through XSLT             November 2010
    572572
    573573
     
    626626
    627627
    628 Documentation             RFC2629 through XSLT            September 2010
     628Documentation             RFC2629 through XSLT             November 2010
    629629
    630630
     
    683683
    684684
    685 Documentation             RFC2629 through XSLT            September 2010
     685Documentation             RFC2629 through XSLT             November 2010
    686686
    687687
     
    740740
    741741
    742 Documentation             RFC2629 through XSLT            September 2010
     742Documentation             RFC2629 through XSLT             November 2010
    743743
    744744
     
    797797
    798798
    799 Documentation             RFC2629 through XSLT            September 2010
     799Documentation             RFC2629 through XSLT             November 2010
    800800
    801801
     
    854854
    855855
    856 Documentation             RFC2629 through XSLT            September 2010
     856Documentation             RFC2629 through XSLT             November 2010
    857857
    858858
     
    911911
    912912
    913 Documentation             RFC2629 through XSLT            September 2010
     913Documentation             RFC2629 through XSLT             November 2010
    914914
    915915
     
    968968
    969969
    970 Documentation             RFC2629 through XSLT            September 2010
     970Documentation             RFC2629 through XSLT             November 2010
    971971
    972972
     
    10251025
    10261026
    1027 Documentation             RFC2629 through XSLT            September 2010
     1027Documentation             RFC2629 through XSLT             November 2010
    10281028
    10291029
     
    10821082
    10831083
    1084 Documentation             RFC2629 through XSLT            September 2010
     1084Documentation             RFC2629 through XSLT             November 2010
    10851085
    10861086
     
    11391139
    11401140
    1141 Documentation             RFC2629 through XSLT            September 2010
     1141Documentation             RFC2629 through XSLT             November 2010
    11421142
    11431143
     
    11961196
    11971197
    1198 Documentation             RFC2629 through XSLT            September 2010
     1198Documentation             RFC2629 through XSLT             November 2010
    11991199
    12001200
     
    12531253
    12541254
    1255 Documentation             RFC2629 through XSLT            September 2010
    1256 
    1257 
    1258 10.  Generic Extensions
     1255Documentation             RFC2629 through XSLT             November 2010
     1256
     1257
     125810.  Transforming to ePub
     1259
     1260   Experimental transformation to ePub format is available through a set
     1261   of stylesheets, and the Unix Shell script "mkepub.sh" (which requires
     1262   that "zip" and either "saxon" or "xsltproc" are installed).
     1263
     1264   For instance, an epub version of rfc2616.xml can be generated like
     1265   this:
     1266
     1267   mkepub.sh rfc2616.xml
     1268
     1269
     1270
     1271
     1272
     1273
     1274
     1275
     1276
     1277
     1278
     1279
     1280
     1281
     1282
     1283
     1284
     1285
     1286
     1287
     1288
     1289
     1290
     1291
     1292
     1293
     1294
     1295
     1296
     1297
     1298
     1299
     1300
     1301
     1302
     1303
     1304
     1305
     1306
     1307
     1308
     1309Reschke                                                        [Page 23]
     1310
     1311
     1312Documentation             RFC2629 through XSLT             November 2010
     1313
     1314
     131511.  Generic Extensions
    12591316
    12601317   This section documents extensions implemented in "rfc2629.xslt",
    12611318   using the extension namespace "http://purl.org/net/xml2rfc/ext".
    12621319
    1263 10.1.  <abnf-char-sequence> element
     132011.1.  <abnf-char-sequence> element
    12641321
    12651322   Converts the contained quoted string into a hex-encoded character
     
    12691326   gets converted to "%x48.54.54.50".
    12701327
    1271 10.2.  <anchor-alias> element
     132811.2.  <anchor-alias> element
    12721329
    12731330   Using its "value" attribute, this element allows the definition of an
     
    12781335   that apply to anchor elements (which are XML names).
    12791336
    1280 10.3.  <bcp14> element
     133711.3.  <bcp14> element
    12811338
    12821339   This element marks the content as being one of the normative keywords
     
    13071364
    13081365
    1309 Reschke                                                        [Page 23]
    1310 
    1311 
    1312 Documentation             RFC2629 through XSLT            September 2010
     1366Reschke                                                        [Page 24]
     1367
     1368
     1369Documentation             RFC2629 through XSLT             November 2010
    13131370
    13141371
     
    13381395      >SHOULD NOT</bcp14>">]>
    13391396
    1340 10.4.  <bb> element
     139711.4.  <bb> element
    13411398
    13421399   Marking up a string as <bb> indicates that it represents the bottom
     
    13441401   accordingly.
    13451402
    1346 10.5.  <bc> element
     140311.5.  <bc> element
    13471404
    13481405   Marking up a string as <bc> indicates that it represents a center
    13491406   line of a box drawing, replacing the "|" character accordingly.
    13501407
    1351 10.6.  <blockquote> element
     140811.6.  <blockquote> element
    13521409
    13531410   This element is like the "blockquote" element in [HTML] (note this is
     
    13551412   elements.
    13561413
    1357 10.7.  <boilerplate> element
     141411.7.  <boilerplate> element
    13581415
    13591416   Can be used to include boilerplate (status, copyright, ...) into the
     
    13641421
    13651422
    1366 Reschke                                                        [Page 24]
    1367 
    1368 
    1369 Documentation             RFC2629 through XSLT            September 2010
     1423Reschke                                                        [Page 25]
     1424
     1425
     1426Documentation             RFC2629 through XSLT             November 2010
    13701427
    13711428
     
    13731430   xml2rfc!_
    13741431
    1375 10.8.  <bt> element
     143211.8.  <bt> element
    13761433
    13771434   Marking up a string as <bt> indicates that it represents the top line
    13781435   of a box drawing, replacing the "+" and "-" characters accordingly.
    13791436
    1380 10.9.  <dfn> element
     143711.9.  <dfn> element
    13811438
    13821439   This element is like the "dfn" element in [HTML].
    13831440
    1384 10.10.  <h> element
     144111.10.  <h> element
    13851442
    13861443   This element is like the "h" element in [XHTML2].
    13871444
    1388 10.11.  <highlight> element
     144511.11.  <highlight> element
    13891446
    13901447   Used to highlight text passages, currently only allowed in <artwork>.
     
    13931450   use with care.
    13941451
    1395 10.12.  <length-of> element
     145211.12.  <length-of> element
    13961453
    13971454   This element can be used to insert the length of another formatted
     
    14131470   be substracted from the computed length.
    14141471
    1415 10.13.  <link> element
     147211.13.  <link> element
    14161473
    14171474   This element can be added as a top-level child element below <rfc> to
     
    14211478
    14221479
    1423 Reschke                                                        [Page 25]
    1424 
    1425 
    1426 Documentation             RFC2629 through XSLT            September 2010
     1480Reschke                                                        [Page 26]
     1481
     1482
     1483Documentation             RFC2629 through XSLT             November 2010
    14271484
    14281485
     
    14361493               href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/>
    14371494
    1438 10.14.  <lt> element
     149511.14.  <lt> element
    14391496
    14401497   Used for grouping multiple <t> elements into a single list item.
    14411498
    1442 10.15.  <note> element
     149911.15.  <note> element
    14431500
    14441501   Can be used to add a note, usually indented by a few characters.  It
    14451502   should contain one or more <t> child elements.
    14461503
    1447 10.16.  <parse-xml> element
     150411.16.  <parse-xml> element
    14481505
    14491506   This element instructs the processor to parse the contents as XML and
     
    14511508   newer).
    14521509
    1453 10.17.  <prose> element
     151011.17.  <prose> element
    14541511
    14551512   This element can be used inside <reference> to add plain text (before
    14561513   the date, when present).
    14571514
    1458 10.18.  <q> element
     151511.18.  <q> element
    14591516
    14601517   This element is like the "q" element in [HTML].
    14611518
    1462 10.19.  <ref> element
     151911.19.  <ref> element
    14631520
    14641521   This element is a simplified variant of the <xref> element, in that
     
    14781535
    14791536
    1480 Reschke                                                        [Page 26]
    1481 
    1482 
    1483 Documentation             RFC2629 through XSLT            September 2010
     1537Reschke                                                        [Page 27]
     1538
     1539
     1540Documentation             RFC2629 through XSLT             November 2010
    14841541
    14851542
     
    14961553         <xref target="test">alias 2</xref>
    14971554
    1498 10.20.  <source> element
     155511.20.  <source> element
    14991556
    15001557   Can be used to enhance a <reference> with information about the
     
    15131570           ...
    15141571
    1515 10.21.  <sup> element
     157211.21.  <sup> element
    15161573
    15171574   This element is like the "sup" element in [HTML].
     
    15191576   Note: the down conversion to RFC2629 format replaces "x^y" by "x^y".
    15201577
    1521 10.22.  Extensions to Xml2rfc <artwork> element
     157811.22.  Extensions to Xml2rfc <artwork> element
    15221579
    15231580   Sometimes, artwork occurs inside lists.  To get it indent properly in
     
    15281585   As a workaround, a "x:indent-with" attribute can be specified,
    15291586   containing a string that will be prepended to each line when
    1530    "clean-for-DTD.xslt" is run (see Section 11.4).
    1531 
    1532 
    1533 
    1534 
    1535 
    1536 
    1537 Reschke                                                        [Page 27]
    1538 
    1539 
    1540 Documentation             RFC2629 through XSLT            September 2010
    1541 
    1542 
    1543 10.23.  Extensions to Xml2rfc <iref> element
     1587   "clean-for-DTD.xslt" is run (see Section 12.4).
     1588
     1589
     1590
     1591
     1592
     1593
     1594Reschke                                                        [Page 28]
     1595
     1596
     1597Documentation             RFC2629 through XSLT             November 2010
     1598
     1599
     160011.23.  Extensions to Xml2rfc <iref> element
    15441601
    15451602   The extension attribute below is allowed on the standard <iref>
     
    15521609      closest ancestor.
    15531610
    1554 10.24.  Extensions to Xml2rfc <list> element
     161111.24.  Extensions to Xml2rfc <list> element
    15551612
    15561613   The extension attribute below is allowed on the standard <list>
     
    15661623   <t>, allowing to insert multiple paragraphs into a single list item.
    15671624
    1568 10.25.  Extensions to Xml2rfc <rfc> element
     162511.25.  Extensions to Xml2rfc <rfc> element
    15691626
    15701627   The extension attributes below are allowed on the standard <rfc>
     
    15771634      4.1 of [RFC2026]).
    15781635
    1579 10.26.  Extensions to Xml2rfc <section> element
     163611.26.  Extensions to Xml2rfc <section> element
    15801637
    15811638   The extension attribute below is allowed on the standard <list>
     
    15921649
    15931650
    1594 Reschke                                                        [Page 28]
    1595 
    1596 
    1597 Documentation             RFC2629 through XSLT            September 2010
    1598 
    1599 
    1600 10.27.  Extensions to Xml2rfc <xref> element
     1651Reschke                                                        [Page 29]
     1652
     1653
     1654Documentation             RFC2629 through XSLT             November 2010
     1655
     1656
     165711.27.  Extensions to Xml2rfc <xref> element
    16011658
    16021659   Three extension attributes are allowed on the standard <xref>
     
    16491706
    16501707
    1651 Reschke                                                        [Page 29]
    1652 
    1653 
    1654 Documentation             RFC2629 through XSLT            September 2010
    1655 
    1656 
    1657 11.  Utilities
    1658 
    1659 11.1.  Checking References
     1708Reschke                                                        [Page 30]
     1709
     1710
     1711Documentation             RFC2629 through XSLT             November 2010
     1712
     1713
     171412.  Utilities
     1715
     171612.1.  Checking References
    16601717
    16611718   "check-references.xslt" can be used to check all references to RFC-
     
    17061763
    17071764
    1708 Reschke                                                        [Page 30]
    1709 
    1710 
    1711 Documentation             RFC2629 through XSLT            September 2010
     1765Reschke                                                        [Page 31]
     1766
     1767
     1768Documentation             RFC2629 through XSLT             November 2010
    17121769
    17131770
     
    17631820
    17641821
    1765 Reschke                                                        [Page 31]
    1766 
    1767 
    1768 Documentation             RFC2629 through XSLT            September 2010
     1822Reschke                                                        [Page 32]
     1823
     1824
     1825Documentation             RFC2629 through XSLT             November 2010
    17691826
    17701827
     
    17801837      -Dhttp.proxyPort=80".
    17811838
    1782 11.2.  Generating Graphs from References
     183912.2.  Generating Graphs from References
    17831840
    17841841   "gen-reference-graph.xslt" generates a graph of RFC dependencies,
    17851842   using the same base data as in "check-references.xslt" (see
    1786    Section 11.1).  Its output is a "dot" file, to be processed by
     1843   Section 12.1).  Its output is a "dot" file, to be processed by
    17871844   GraphViz (see <http://www.graphviz.org/>).
    17881845
     
    17901847
    17911848
    1792 11.3.  Producing reference entries for books
     184912.3.  Producing reference entries for books
    17931850
    17941851   "amazon-asin.xslt" uses the Amazon web services to generate a
     
    18201877
    18211878
    1822 Reschke                                                        [Page 32]
    1823 
    1824 
    1825 Documentation             RFC2629 through XSLT            September 2010
     1879Reschke                                                        [Page 33]
     1880
     1881
     1882Documentation             RFC2629 through XSLT             November 2010
    18261883
    18271884
     
    18291886   Amazon's database is playing tricks with Marshall's name...
    18301887
    1831 11.4.  Down-converting to RFC2629bis DTD
     188812.4.  Down-converting to RFC2629bis DTD
    18321889
    18331890   "clean-for-DTD.xslt" can be used to down-convert some extensions to a
     
    18771934
    18781935
    1879 Reschke                                                        [Page 33]
    1880 
    1881 
    1882 Documentation             RFC2629 through XSLT            September 2010
    1883 
    1884 
    1885 11.5.  Extracting artwork
     1936Reschke                                                        [Page 34]
     1937
     1938
     1939Documentation             RFC2629 through XSLT             November 2010
     1940
     1941
     194212.5.  Extracting artwork
    18861943
    18871944   With "extract-artwork.xslt", artwork elements named through the
     
    19031960   saxon rfc3986.xml extract-artwork.xslt type=abnf except-name=clschm
    19041961
    1905 11.6.  GRRDL
     196212.6.  GRRDL
    19061963
    19071964   "rfc2629grddl.xslt" extracts RDF information.  This is experimental
     
    19341991
    19351992
    1936 Reschke                                                        [Page 34]
    1937 
    1938 
    1939 Documentation             RFC2629 through XSLT            September 2010
    1940 
    1941 
    1942 12.  Informative References
     1993Reschke                                                        [Page 35]
     1994
     1995
     1996Documentation             RFC2629 through XSLT             November 2010
     1997
     1998
     199913.  Informative References
    19432000
    19442001   [BCP97]    Klensin, J. and S. Hartman, "Handling Normative References
     
    19772034              Specifications: ABNF", STD 68, RFC 5234, January 2008.
    19782035
     2036   [RFC5741]  Daigle, L. and O. Kolkman, "RFC Streams, Headers, and
     2037              Boilerplates", RFC 5741, December 2009.
     2038
    19792039   [RNC]      Clark, J., "RELAX NG Compact Syntax", OASIS , Nov 2002, <h
    19802040              ttp://www.oasis-open.org/committees/relax-ng/
     
    19862046              <http://www.w3.org/TR/xhtml2>.
    19872047
     2048
     2049
     2050Reschke                                                        [Page 36]
     2051
     2052
     2053Documentation             RFC2629 through XSLT             November 2010
     2054
     2055
    19882056   [XML]      Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E., and
    19892057              F. Yergeau, "Extensible Markup Language (XML) 1.0 (Fifth
    1990 
    1991 
    1992 
    1993 Reschke                                                        [Page 35]
    1994 
    1995 
    1996 Documentation             RFC2629 through XSLT            September 2010
    1997 
    1998 
    19992058              Edition)", W3C REC-xml-20081126, November 2008,
    20002059              <http://www.w3.org/TR/2008/REC-xml-20081126/>.
     
    20462105
    20472106
    2048 
    2049 
    2050 Reschke                                                        [Page 36]
    2051 
    2052 
    2053 Documentation             RFC2629 through XSLT            September 2010
     2107Reschke                                                        [Page 37]
     2108
     2109
     2110Documentation             RFC2629 through XSLT             November 2010
    20542111
    20552112
     
    21052162
    21062163
    2107 Reschke                                                        [Page 37]
    2108 
    2109 
    2110 Documentation             RFC2629 through XSLT            September 2010
     2164Reschke                                                        [Page 38]
     2165
     2166
     2167Documentation             RFC2629 through XSLT             November 2010
    21112168
    21122169
     
    21622219
    21632220
    2164 Reschke                                                        [Page 38]
    2165 
    2166 
    2167 Documentation             RFC2629 through XSLT            September 2010
     2221Reschke                                                        [Page 39]
     2222
     2223
     2224Documentation             RFC2629 through XSLT             November 2010
    21682225
    21692226
     
    22192276
    22202277
    2221 Reschke                                                        [Page 39]
    2222 
    2223 
    2224 Documentation             RFC2629 through XSLT            September 2010
     2278Reschke                                                        [Page 40]
     2279
     2280
     2281Documentation             RFC2629 through XSLT             November 2010
    22252282
    22262283
     
    22762333
    22772334
    2278 Reschke                                                        [Page 40]
    2279 
    2280 
    2281 Documentation             RFC2629 through XSLT            September 2010
     2335Reschke                                                        [Page 41]
     2336
     2337
     2338Documentation             RFC2629 through XSLT             November 2010
    22822339
    22832340
     
    22932350    attribute x:annotation { ATEXT }?
    22942351
    2295     # Extend attribute set for <iref> (see Section 10.23)
     2352    # Extend attribute set for <iref> (see Section 11.23)
    22962353  attlist.iref &=
    22972354    attribute x:for-anchor { ATEXT }?
    22982355
    2299   # Extend attribute set for <list> (see Section 10.24)
     2356  # Extend attribute set for <list> (see Section 11.24)
    23002357  attlist.list &=
    23012358    attribute x:indent { ATEXT }?
     
    23102367    attribute x:maturity-level { "proposed" | "draft" | "internet" }?
    23112368
    2312   # Extend attribute set for <section> (see Section 10.26)
     2369  # Extend attribute set for <section> (see Section 11.26)
    23132370  attlist.section &=
    23142371    attribute x:fixed-section-number { ATEXT }?
     
    23262383    attribute x:annotation { ATEXT }?
    23272384
    2328   # Extend attribute set for <xref> (see Section 10.27)
     2385  # Extend attribute set for <xref> (see Section 11.27)
    23292386  attlist.xref &=
    23302387    attribute x:fmt  { "()" | "," | "anchor" | "of" | "number" | "sec" |
     
    23332390
    23342391
    2335 Reschke                                                        [Page 41]
    2336 
    2337 
    2338 Documentation             RFC2629 through XSLT            September 2010
     2392Reschke                                                        [Page 42]
     2393
     2394
     2395Documentation             RFC2629 through XSLT             November 2010
    23392396
    23402397
     
    23422399    attribute x:sec  { ATEXT }?
    23432400
    2344   # Conversion to ABNF char sequence (see Section 10.1)
     2401  # Conversion to ABNF char sequence (see Section 11.1)
    23452402  x_abnf-char-sequence =
    23462403    element x:abnf-char-sequence {
     
    23482405    }
    23492406
    2350   # Aliasing of anchors (see Section 10.2)
     2407  # Aliasing of anchors (see Section 11.2)
    23512408  x_anchor-alias =
    23522409    element x:anchor-alias {
     
    23712428    }
    23722429
    2373   # Bottom line of box drawing (see Section 10.4)
     2430  # Bottom line of box drawing (see Section 11.4)
    23742431  x_bb =
    23752432    element x:bb {
     
    23832440    }
    23842441
    2385   # Center line of box drawing (see Section 10.5)
     2442  # Center line of box drawing (see Section 11.5)
    23862443  x_bc =
    23872444    element x:bc {
     
    23902447
    23912448
    2392 Reschke                                                        [Page 42]
    2393 
    2394 
    2395 Documentation             RFC2629 through XSLT            September 2010
     2449Reschke                                                        [Page 43]
     2450
     2451
     2452Documentation             RFC2629 through XSLT             November 2010
    23962453
    23972454
     
    24052462    }
    24062463
    2407   # BCP14/RFC2119 keywords (see Section 10.3)
     2464  # BCP14/RFC2119 keywords (see Section 11.3)
    24082465  x_bcp14 =
    24092466    element x:bcp14 {
     
    24212478    }
    24222479
    2423   # Blockquote (see Section 10.6)
     2480  # Blockquote (see Section 11.6)
    24242481  x_blockquote =
    24252482    element x:blockquote {
     
    24282485    }
    24292486
    2430   # Boilerplate (see Section 10.6)
     2487  # Boilerplate (see Section 11.6)
    24312488  x_boilerplate =
    24322489    element x:boilerplate {
     
    24342491    }
    24352492
    2436   # Top line of box drawing (see Section 10.8)
     2493  # Top line of box drawing (see Section 11.8)
    24372494  x_bt =
    24382495    element x:bt {
     
    24472504
    24482505
    2449 Reschke                                                        [Page 43]
    2450 
    2451 
    2452 Documentation             RFC2629 through XSLT            September 2010
     2506Reschke                                                        [Page 44]
     2507
     2508
     2509Documentation             RFC2629 through XSLT             November 2010
    24532510
    24542511
    24552512    }
    24562513
    2457   # Definition (see Section 10.9)
     2514  # Definition (see Section 11.9)
    24582515  x_dfn =
    24592516    element x:dfn {
     
    24632520    }
    24642521
    2465   # Heading (see Section 10.10)
     2522  # Heading (see Section 11.10)
    24662523  x_h =
    24672524    element x:h {
     
    24692526    }
    24702527
    2471   # Heading (see Section 10.11)
     2528  # Heading (see Section 11.11)
    24722529  x_highlight =
    24732530    element x:highlight {
     
    24752532    }
    24762533
    2477   # Length Measurement (see Section 10.12)
     2534  # Length Measurement (see Section 11.12)
    24782535  x_length-of =
    24792536    element x:length-of {
     
    24832540    }
    24842541
    2485   # Link (see Section 10.13)
     2542  # Link (see Section 11.13)
    24862543  x_link =
    24872544    element x:link {
     
    24922549    }
    24932550
    2494   # Extended list item (see Section 10.14)
     2551  # Extended list item (see Section 11.14)
    24952552  x_lt =
    24962553    element x:lt {
     
    25002557    }
    25012558
    2502   # Note (see Section 10.15)
    2503 
    2504 
    2505 
    2506 Reschke                                                        [Page 44]
    2507 
    2508 
    2509 Documentation             RFC2629 through XSLT            September 2010
     2559  # Note (see Section 11.15)
     2560
     2561
     2562
     2563Reschke                                                        [Page 45]
     2564
     2565
     2566Documentation             RFC2629 through XSLT             November 2010
    25102567
    25112568
     
    25152572    }
    25162573
    2517   # Signal XML content (see Section 10.16)
     2574  # Signal XML content (see Section 11.16)
    25182575  x_parse-xml =
    25192576    element x:parse-xml {
     
    25222579    }
    25232580
    2524   # Inline prose in a reference (see Section 10.17)
     2581  # Inline prose in a reference (see Section 11.17)
    25252582  x_prose =
    25262583    element x:prose {
     
    25282585    }
    25292586
    2530   # Inline quote (see Section 10.18)
     2587  # Inline quote (see Section 11.18)
    25312588  x_q =
    25322589    element x:q {
     
    25342591    }
    25352592
    2536   # Anchor reference (see Section 10.19)
     2593  # Anchor reference (see Section 11.19)
    25372594  x_ref =
    25382595    element x:ref {
     
    25412598    }
    25422599
    2543   # source information (see Section 10.20)
     2600  # source information (see Section 11.20)
    25442601  x_source =
    25452602    element x:source {
     
    25492606    }
    25502607
    2551   # superscript (see Section 10.21)
     2608  # superscript (see Section 11.21)
    25522609  x_sup =
    25532610    element x:sup {
     
    25612618
    25622619
    2563 Reschke                                                        [Page 45]
    2564 
    2565 
    2566 Documentation             RFC2629 through XSLT            September 2010
     2620Reschke                                                        [Page 46]
     2621
     2622
     2623Documentation             RFC2629 through XSLT             November 2010
    25672624
    25682625
     
    26182675
    26192676
    2620 Reschke                                                        [Page 46]
    2621 
    2622 
    2623 Documentation             RFC2629 through XSLT            September 2010
     2677Reschke                                                        [Page 47]
     2678
     2679
     2680Documentation             RFC2629 through XSLT             November 2010
    26242681
    26252682
     
    26752732
    26762733
    2677 Reschke                                                        [Page 47]
    2678 
    2679 
    2680 Documentation             RFC2629 through XSLT            September 2010
     2734Reschke                                                        [Page 48]
     2735
     2736
     2737Documentation             RFC2629 through XSLT             November 2010
    26812738
    26822739
     
    26942751   <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
    26952752
    2696      <!-- use "&MAY;" for a BCP 14 "MAY", see Section 10.3 -->
     2753     <!-- use "&MAY;" for a BCP 14 "MAY", see Section 11.3 -->
    26972754     <!ENTITY MAY
    26982755     "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY</bcp14>">
     
    27322789
    27332790
    2734 Reschke                                                        [Page 48]
    2735 
    2736 
    2737 Documentation             RFC2629 through XSLT            September 2010
     2791Reschke                                                        [Page 49]
     2792
     2793
     2794Documentation             RFC2629 through XSLT             November 2010
    27382795
    27392796
     
    27892846
    27902847
    2791 Reschke                                                        [Page 49]
    2792 
    2793 
    2794 Documentation             RFC2629 through XSLT            September 2010
    2795 
    2796 
    2797 Appendix D.  The /rfc/@ipr Attribute
    2798 
    2799    The "ipr" specifies what kind of text is generated for the "Status Of
    2800    This Memo" and "Copyright Notice" sections on the front page.  When
    2801    submitting an Internet Draft, the "boilerplate" is checked by
     2848Reschke                                                        [Page 50]
     2849
     2850
     2851Documentation             RFC2629 through XSLT             November 2010
     2852
     2853
     2854Appendix D.  Producing the IETF 'Boilerplate'
     2855
     2856   Various attributes of the "<rfc>" element plus some child elements of
     2857   "<front>" affect the automatically generated parts of the front page,
     2858   such as the tabular information at the beginning, the "Status Of This
     2859   Memo", and the "Copyright Notice".
     2860
     2861   When submitting an Internet Draft, this "boilerplate" is checked by
    28022862   "Idnits" (<http://tools.ietf.org/tools/idnits/>) for compliance with
    2803    the current Intellectual Property rules, and thus it's important to
    2804    set the correct value.
    2805 
    2806    As of the time of this writing, the attribute value can take a long
     2863   the current Intellectual Property rules, and thus it is important to
     2864   set the correct values.
     2865
     2866   Furthermore, the RFC Production Center uses RFC2629-based tools to
     2867   generate the final RFC text, so the more accurate the supplied
     2868   information is, the less additional work is left, and the risk for
     2869   errors in producing the final (and immutable!) document is reduced.
     2870
     2871      Note: this only applies to the case when IETF documents are
     2872      produced.  The "private" processing instruction allows to switch
     2873      off most of the autogeneration logic.
     2874
     2875D.1.  The /rfc/@ipr Attribute
     2876
     2877   As of the time of this writing, this attribute value can take a long
    28072878   list of values.  As frequently, this is not the result of a grand
    28082879   plan, but simply for historic reasons.  Of these values, only a few
     
    28122883      Note: some variations of the boilerplate are selected based on the
    28132884      document's date; therefore it is important to specify the "year",
    2814       "month" and "date" attributes when archiving the XML source of an
    2815       Internet Draft on the day of submission.
     2885      "month" and "day" attributes of the "<date>" element when
     2886      archiving the XML source of an Internet Draft on the day of
     2887      submission.
    28162888
    28172889   _Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION.  IF YOU
     
    28192891   refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>.
    28202892
    2821 D.1.  Current Values: '*trust200902'
     2893   Finally, for the current "Status Of This Memo" text, the
     2894   "submissionType" attribute determines whether a statement about "Code
     2895   Components" is inserted (this is the case for the value "IETF", which
     2896   also happens to be the default).  Other values, such as
     2897   "independent", suppress this part of the text.
     2898
     2899
     2900
     2901
     2902
     2903
     2904
     2905Reschke                                                        [Page 51]
     2906
     2907
     2908Documentation             RFC2629 through XSLT             November 2010
     2909
     2910
     2911D.1.1.  Current Values: '*trust200902'
    28222912
    28232913   The name for these values refers to the "TLP" ("IETF TRUST Legal
     
    28352925   The tools will automatically produce the "right" text depending on
    28362926   the document's date information (see above):
    2837 
    2838 
    2839 
    2840 
    2841 
    2842 
    2843 
    2844 
    2845 
    2846 
    2847 
    2848 Reschke                                                        [Page 50]
    2849 
    2850 
    2851 Documentation             RFC2629 through XSLT            September 2010
    2852 
    28532927
    28542928   +----+----------------------------------------------------+---------+
     
    28662940   +----+----------------------------------------------------+---------+
    28672941
    2868 D.1.1.  trust200902
     2942D.1.1.1.  trust200902
    28692943
    28702944   This should be the default, unless one of the more specific
     
    28722946   Sections 6.a and 6.b of the TLP.
    28732947
    2874 D.1.2.  noModificationTrust200902
     2948D.1.1.2.  noModificationTrust200902
    28752949
    28762950   This produces the additional text from Section 6.c.i of the TLP:
     
    28802954      to translate it into languages other than English.
    28812955
    2882 D.1.3.  noDerivativesTrust200902
     2956
     2957
     2958
     2959
     2960
     2961
     2962Reschke                                                        [Page 52]
     2963
     2964
     2965Documentation             RFC2629 through XSLT             November 2010
     2966
     2967
     2968D.1.1.3.  noDerivativesTrust200902
    28832969
    28842970   This produces the additional text from Section 6.c.ii of the TLP:
     
    28882974      Draft.
    28892975
    2890 D.1.4.  pre5378Trust200902
     2976D.1.1.4.  pre5378Trust200902
    28912977
    28922978   This produces the additional text from Section 6.c.iii of the TLP,
     
    29002986      Without obtaining an adequate license from the person(s)
    29012987      controlling the copyright in such materials, this document may not
    2902 
    2903 
    2904 
    2905 Reschke                                                        [Page 51]
    2906 
    2907 
    2908 Documentation             RFC2629 through XSLT            September 2010
    2909 
    2910 
    29112988      be modified outside the IETF Standards Process, and derivative
    29122989      works of it may not be created outside the IETF Standards Process,
     
    29222999      appears under "Status Of This Memo".
    29233000
    2924 D.2.  Historic Values
    2925 
    2926 D.2.1.  Historic Values: '*trust200811'
     3001D.1.2.  Historic Values
     3002
     3003D.1.2.1.  Historic Values: '*trust200811'
    29273004
    29283005   The attribute values "trust200811", "noModificationTrust200811" and
     
    29323009   IETF-Trust-License-Policy_11-10-08.pdf>.
    29333010
    2934 D.2.2.  Historic Values: '*3978'
     3011D.1.2.2.  Historic Values: '*3978'
    29353012
    29363013   The attribute values "full3978", "noModification3978" and
     
    29383015   that they use text specified in RFC 3978 (March 2005).
    29393016
    2940 D.2.3.  Historic Values: '*3667'
     3017
     3018
     3019Reschke                                                        [Page 53]
     3020
     3021
     3022Documentation             RFC2629 through XSLT             November 2010
     3023
     3024
     3025D.1.2.3.  Historic Values: '*3667'
    29413026
    29423027   The attribute values "full3667", "noModification3667" and
     
    29443029   that they use text specified in RFC 3667 (February 2004).
    29453030
    2946 D.2.4.  Historic Values: '*2026'
     3031D.1.2.4.  Historic Values: '*2026'
    29473032
    29483033   The attribute values "full2026" and "noDerivativeWorks2026" are
     
    29533038   any rights beyond publication as Internet Draft.
    29543039
    2955 
    2956 
    2957 
    2958 
    2959 
    2960 
    2961 
    2962 Reschke                                                        [Page 52]
    2963 
    2964 
    2965 Documentation             RFC2629 through XSLT            September 2010
     3040D.2.  The /rfc/@category Attribute
     3041
     3042   For RFCs, the "category" determines the "maturity level" (see Section
     3043   4 of [RFC2026]).  The allowed values are "std" for "Standards Track",
     3044   "bcp" for "BCP", "info" for "Informational", "exp" for
     3045   "Experimental", and "historic" for - surprise - "Historic".
     3046
     3047   For Internet Drafts, the category attribute is not needed, but _will_
     3048   appear on the front page ("Intended Status").  Supplying this
     3049   information can be useful, because reviewers may want to know.
     3050
     3051      Note: the Standards Track consists of "Proposed Standard", "Draft
     3052      Standards", and "Internet Standard".  These do not appear in the
     3053      boilerplate, thus the category attribute doesn't handle them.
     3054      However, this information can be useful for validity checkers, and
     3055      thus "rfc2629.xslt" supports an extension attribute for that
     3056      purpose (see Section 11.25 for details).
     3057
     3058D.3.  The /rfc/@submissionType Attribute
     3059
     3060   The RFC Editor publishes documents from different "document streams",
     3061   of which the "IETF stream" of course is the most prominent one.
     3062   Other streams are the "independent stream" (used for things like
     3063   administrative information or April 1st RFCs), the "IAB stream"
     3064   (Internet Architecture Board) and the "IRTF stream" (Internet
     3065   Research Task Force).
     3066
     3067   Not surprisingly, the values for the attribute are "IETF" (the
     3068   default value), "independent", "IAB", and "IRTF".
     3069
     3070   _The values "IAB" and "IRTF" are supported by rfc2629.xslt, but not
     3071   yet allowed by the DTD (waiting for release 1.36 of xml2rfc)._
     3072
     3073
     3074
     3075
     3076Reschke                                                        [Page 54]
     3077
     3078
     3079Documentation             RFC2629 through XSLT             November 2010
     3080
     3081
     3082   Historically, this did not affect the final appearance of RFCs,
     3083   except for subtle differences in Copyright notices.  Nowadays (as of
     3084   [RFC5741]), the stream name appears in the first line of the front
     3085   page, and it also affects the text in the "Status Of This Memo"
     3086   section.
     3087
     3088   For current documents, setting "submissionType" attribute will have
     3089   the following effect:
     3090
     3091   o  For RFCs, the stream name appears in the upper left corner of the
     3092      first page (in Internet Drafts, this is either "Network Working
     3093      Group", or the value of the "<workgroup>" element).
     3094
     3095   o  For RFCs, if affects the whole "Status Of This Memo" section (see
     3096      Section 3.2.2 of [RFC5741]).
     3097
     3098   o  For all RFCs and Internet Drafts, it determines whether the
     3099      "Copyright Notice" mentions the Copyright on Code Components (see
     3100      TLP, Section "Text To Be Included in IETF Documents").
     3101
     3102      Note: as of Version 1.35, "xml2rfc" (as opposed to "rfc2629.xslt")
     3103      does _not_ implement support values other than "IETF" or
     3104      "independent".
     3105
     3106D.4.  The /rfc/@consensus Attribute
     3107
     3108   _Supported by rfc2629.xslt, but not yet allowed by the DTD (waiting
     3109   for release 1.36 of xml2rfc)._
     3110
     3111   For some of the publication streams (see Appendix D.3), the "Status
     3112   Of This Memo" section depends on whether there was a consensus to
     3113   publish (again, see Section 3.2.2 of [RFC5741]).
     3114
     3115   The "consensus" attribute ("yes"/"no", defaulting to "yes") can be
     3116   used to supply this information.  The effect for the various streams
     3117   is:
     3118
     3119   o  "independent" and "IAB": none.
     3120
     3121   o  "IETF": mention that there was an IETF consensus.
     3122
     3123   o  "IRTF": mention that there was a research group consensus (where
     3124      the name of the research group is extracted from the "<workgroup>"
     3125      element).
     3126
     3127
     3128
     3129
     3130
     3131
     3132
     3133Reschke                                                        [Page 55]
     3134
     3135
     3136Documentation             RFC2629 through XSLT             November 2010
     3137
     3138
     3139D.5.  The /rfc/@number Attribute
     3140
     3141   For RFCs, this attribute supplies the RFC number.
     3142
     3143D.6.  The /rfc/@docName Attribute
     3144
     3145   For Internet Drafts, this specifies the draft name (which appears
     3146   below the title).  The file extension is _not_ part of the draft, so
     3147   in general it should end with the current draft number ("-", plus two
     3148   digits).
     3149
     3150      Note: "Idnits" (<http://tools.ietf.org/tools/idnits/>) checks the
     3151      in-document draft name for consistency with the filename of the
     3152      submitted document.
     3153
     3154D.7.  The /rfc/@obsoletes Attribute
     3155
     3156   The RFC Editor maintains a database
     3157   (<http://www.rfc-editor.org/rfc.html>) of all RFCs, including
     3158   information about which one obsoletes which.  Upon publication of an
     3159   RFC, this database is updated from the data on the front page.
     3160
     3161   This attribute takes a list of comma-separated RFC _numbers_.  Do
     3162   _not_ put the string "RFC" here.
     3163
     3164D.8.  The /rfc/@updates Attribute
     3165
     3166   This is like "obsoletes", but for the "updates" relation.
     3167
     3168
     3169
     3170
     3171
     3172
     3173
     3174
     3175
     3176
     3177
     3178
     3179
     3180
     3181
     3182
     3183
     3184
     3185
     3186
     3187
     3188
     3189
     3190Reschke                                                        [Page 56]
     3191
     3192
     3193Documentation             RFC2629 through XSLT             November 2010
    29663194
    29673195
     
    30173245
    30183246
    3019 Reschke                                                        [Page 53]
    3020 
    3021 
    3022 Documentation             RFC2629 through XSLT            September 2010
     3247Reschke                                                        [Page 57]
     3248
     3249
     3250Documentation             RFC2629 through XSLT             November 2010
    30233251
    30243252
     
    30743302
    30753303
    3076 Reschke                                                        [Page 54]
    3077 
    3078 
    3079 Documentation             RFC2629 through XSLT            September 2010
     3304Reschke                                                        [Page 58]
     3305
     3306
     3307Documentation             RFC2629 through XSLT             November 2010
    30803308
    30813309
     
    31313359
    31323360
    3133 Reschke                                                        [Page 55]
    3134 
    3135 
    3136 Documentation             RFC2629 through XSLT            September 2010
     3361Reschke                                                        [Page 59]
     3362
     3363
     3364Documentation             RFC2629 through XSLT             November 2010
    31373365
    31383366
     
    31883416
    31893417
    3190 Reschke                                                        [Page 56]
    3191 
    3192 
    3193 Documentation             RFC2629 through XSLT            September 2010
     3418Reschke                                                        [Page 60]
     3419
     3420
     3421Documentation             RFC2629 through XSLT             November 2010
    31943422
    31953423
     
    32453473
    32463474
    3247 Reschke                                                        [Page 57]
    3248 
    3249 
    3250 Documentation             RFC2629 through XSLT            September 2010
     3475Reschke                                                        [Page 61]
     3476
     3477
     3478Documentation             RFC2629 through XSLT             November 2010
    32513479
    32523480
     
    33023530
    33033531
    3304 Reschke                                                        [Page 58]
    3305 
    3306 
    3307 Documentation             RFC2629 through XSLT            September 2010
     3532Reschke                                                        [Page 62]
     3533
     3534
     3535Documentation             RFC2629 through XSLT             November 2010
    33083536
    33093537
     
    33593587
    33603588
    3361 Reschke                                                        [Page 59]
    3362 
    3363 
    3364 Documentation             RFC2629 through XSLT            September 2010
     3589Reschke                                                        [Page 63]
     3590
     3591
     3592Documentation             RFC2629 through XSLT             November 2010
    33653593
    33663594
     
    34163644
    34173645
    3418 Reschke                                                        [Page 60]
    3419 
    3420 
    3421 Documentation             RFC2629 through XSLT            September 2010
     3646Reschke                                                        [Page 64]
     3647
     3648
     3649Documentation             RFC2629 through XSLT             November 2010
    34223650
    34233651
     
    34733701
    34743702
    3475 Reschke                                                        [Page 61]
    3476 
    3477 
    3478 Documentation             RFC2629 through XSLT            September 2010
     3703Reschke                                                        [Page 65]
     3704
     3705
     3706Documentation             RFC2629 through XSLT             November 2010
    34793707
    34803708
     
    35303758
    35313759
    3532 Reschke                                                        [Page 62]
    3533 
    3534 
    3535 Documentation             RFC2629 through XSLT            September 2010
     3760Reschke                                                        [Page 66]
     3761
     3762
     3763Documentation             RFC2629 through XSLT             November 2010
    35363764
    35373765
     
    35873815
    35883816
    3589 Reschke                                                        [Page 63]
    3590 
    3591 
    3592 Documentation             RFC2629 through XSLT            September 2010
     3817Reschke                                                        [Page 67]
     3818
     3819
     3820Documentation             RFC2629 through XSLT             November 2010
    35933821
    35943822
     
    36443872
    36453873
    3646 Reschke                                                        [Page 64]
    3647 
    3648 
    3649 Documentation             RFC2629 through XSLT            September 2010
     3874Reschke                                                        [Page 68]
     3875
     3876
     3877Documentation             RFC2629 through XSLT             November 2010
    36503878
    36513879
     
    37013929
    37023930
    3703 Reschke                                                        [Page 65]
    3704 
    3705 
    3706 Documentation             RFC2629 through XSLT            September 2010
     3931Reschke                                                        [Page 69]
     3932
     3933
     3934Documentation             RFC2629 through XSLT             November 2010
    37073935
    37083936
     
    37583986
    37593987
    3760 Reschke                                                        [Page 66]
    3761 
    3762 
    3763 Documentation             RFC2629 through XSLT            September 2010
     3988Reschke                                                        [Page 70]
     3989
     3990
     3991Documentation             RFC2629 through XSLT             November 2010
    37643992
    37653993
     
    38154043
    38164044
    3817 Reschke                                                        [Page 67]
    3818 
    3819 
    3820 Documentation             RFC2629 through XSLT            September 2010
     4045Reschke                                                        [Page 71]
     4046
     4047
     4048Documentation             RFC2629 through XSLT             November 2010
    38214049
    38224050
     
    38724100
    38734101
    3874 Reschke                                                        [Page 68]
    3875 
    3876 
    3877 Documentation             RFC2629 through XSLT            September 2010
     4102Reschke                                                        [Page 72]
     4103
     4104
     4105Documentation             RFC2629 through XSLT             November 2010
    38784106
    38794107
     
    39294157
    39304158
    3931 Reschke                                                        [Page 69]
    3932 
    3933 
    3934 Documentation             RFC2629 through XSLT            September 2010
     4159Reschke                                                        [Page 73]
     4160
     4161
     4162Documentation             RFC2629 through XSLT             November 2010
    39354163
    39364164
     
    39384166
    39394167   A
    3940       abnf-char-sequence Extension Element  23, 37
     4168      abnf-char-sequence Extension Element  24, 38
    39414169      allow-markup-in-artwork PI pseudo-attribute  9
    39424170      alternate HTML LINK element  17
    3943       anchor-alias Extension Element  23, 37
     4171      anchor-alias Extension Element  24, 38
    39444172      Anchors
    39454173         rfc.abstract  14
     
    39624190      Apache FOP  21
    39634191      appendix HTML LINK element  17
    3964       assign-section-number Extension Element  37
     4192      assign-section-number Extension Element  38
    39654193      author HTML LINK element  17
    39664194      authors-section PI pseudo-attribute  9
     
    39684196   B
    39694197      background PI pseudo-attribute  7
    3970       bb Extension Element  24, 37
    3971       bc Extension Element  24, 37
    3972       bcp14 Extension Element  23, 37
    3973       blockquote Extension Element  24, 37
    3974       boilerplate Extension Element  24, 37
    3975       bt Extension Element  25, 37
     4198      bb Extension Element  25, 38
     4199      bc Extension Element  25, 38
     4200      bcp14 Extension Element  24, 38
     4201      blockquote Extension Element  25, 38
     4202      boilerplate Extension Element  25, 38
     4203      bt Extension Element  26, 38
    39764204
    39774205   C
     
    39864214
    39874215
    3988 Reschke                                                        [Page 70]
    3989 
    3990 
    3991 Documentation             RFC2629 through XSLT            September 2010
     4216Reschke                                                        [Page 74]
     4217
     4218
     4219Documentation             RFC2629 through XSLT             November 2010
    39924220
    39934221
     
    40024230         Relation.Replaces  18
    40034231      Description.Abstract DCMI property  18
    4004       dfn Extension Element  25, 37
     4232      dfn Extension Element  26, 38
    40054233      duplex PI pseudo-attribute  9
    40064234
     
    40084236      editing PI pseudo-attribute  7
    40094237      Extension Elements
    4010          abnf-char-sequence  23, 37
    4011          anchor-alias  23, 37
    4012          assign-section-number  37
    4013          bb  24, 37
    4014          bc  24, 37
    4015          bcp14  23, 37
    4016          blockquote  24, 37
    4017          boilerplate  24, 37
    4018          bt  25, 37
    4019          dfn  25, 37
    4020          h  25, 37
    4021          highlight  25, 37
    4022          include-author  37
    4023          length-of  25, 37
    4024          link  25, 37
    4025          lt  26, 37
    4026          note  26, 37
    4027          parse-xml  26, 37
    4028          prose  26, 37
    4029          q  26, 37
    4030          rdf:Description  37
    4031          ref  26, 37
    4032          source  27, 37
    4033          span  37
    4034          sup  27, 37
    4035          x  37
     4238         abnf-char-sequence  24, 38
     4239         anchor-alias  24, 38
     4240         assign-section-number  38
     4241         bb  25, 38
     4242         bc  25, 38
     4243         bcp14  24, 38
     4244         blockquote  25, 38
     4245         boilerplate  25, 38
     4246         bt  26, 38
     4247         dfn  26, 38
     4248         h  26, 38
     4249         highlight  26, 38
     4250         include-author  38
     4251         length-of  26, 38
     4252         link  26, 38
     4253         lt  27, 38
     4254         note  27, 38
     4255         parse-xml  27, 38
     4256         prose  27, 38
     4257         q  27, 38
     4258         rdf:Description  38
     4259         ref  27, 38
     4260         source  28, 38
     4261         span  38
     4262         sup  28, 38
     4263         x  38
    40364264
    40374265   F
     
    40434271
    40444272
    4045 Reschke                                                        [Page 71]
    4046 
    4047 
    4048 Documentation             RFC2629 through XSLT            September 2010
     4273Reschke                                                        [Page 75]
     4274
     4275
     4276Documentation             RFC2629 through XSLT             November 2010
    40494277
    40504278
     
    40524280      generator HTML META element  18
    40534281      Google Chrome  15
    4054       Grammar  37
     4282      Grammar  38
    40554283
    40564284   H
    4057       h Extension Element  25, 37
     4285      h Extension Element  26, 38
    40584286      header PI pseudo-attribute  7
    4059       highlight Extension Element  25, 37
     4287      highlight Extension Element  26, 38
    40604288      HTML compliance  17
    40614289      HTML LINK elements
     
    40744302      Identifier DCMI property  18
    40754303      include PI pseudo-attribute  8
    4076       include-author Extension Element  37
     4304      include-author Extension Element  38
    40774305      include-references-in-index PI pseudo-attribute  9
    40784306      index HTML LINK element  17
     
    40924320
    40934321   L
    4094       length-of Extension Element  25, 37
    4095       link Extension Element  25, 37
     4322      length-of Extension Element  26, 38
     4323      link Extension Element  26, 38
    40964324      linkmailto PI pseudo-attribute  7
    4097       lt Extension Element  26, 37
    4098 
    4099 
    4100 
    4101 
    4102 Reschke                                                        [Page 72]
    4103 
    4104 
    4105 Documentation             RFC2629 through XSLT            September 2010
     4325      lt Extension Element  27, 38
     4326
     4327
     4328
     4329
     4330Reschke                                                        [Page 76]
     4331
     4332
     4333Documentation             RFC2629 through XSLT             November 2010
    41064334
    41074335
     
    41154343      needLines PI pseudo-attribute  8
    41164344      NoScript  15
    4117       note Extension Element  26, 37
     4345      note Extension Element  27, 38
    41184346
    41194347   O
     
    41474375         xml2rfc-tocdepth  7
    41484376         xml2rfc-topblock  7
    4149       parse-xml Extension Element  26, 37
     4377      parse-xml Extension Element  27, 38
    41504378      parse-xml-in-artwork PI pseudo-attribute  9
    4151       private PI pseudo-attribute  7
     4379      private PI pseudo-attribute  7, 51
    41524380      Processing Instruction pseudo attributes
    41534381         allow-markup-in-artwork  9
     
    41574385
    41584386
    4159 Reschke                                                        [Page 73]
    4160 
    4161 
    4162 Documentation             RFC2629 through XSLT            September 2010
     4387Reschke                                                        [Page 77]
     4388
     4389
     4390Documentation             RFC2629 through XSLT             November 2010
    41634391
    41644392
     
    41774405         needLines  8
    41784406         parse-xml-in-artwork  9
    4179          private  7
     4407         private  7, 51
    41804408         refparent  7
    41814409         rfcedstyle  7
     
    41924420         tocompact  8
    41934421         topblock  7
    4194       prose Extension Element  26, 37
     4422      prose Extension Element  27, 38
    41954423
    41964424   Q
    4197       q Extension Element  26, 37
     4425      q Extension Element  27, 38
    41984426
    41994427   R
    4200       rdf:Description Extension Element  37
    4201       ref Extension Element  26, 37
     4428      rdf:Description Extension Element  38
     4429      ref Extension Element  27, 38
    42024430      refparent PI pseudo-attribute  7
    42034431      Relation.Replaces DCMI property  18
    4204       RELAX NG Compact Schema  37
     4432      RELAX NG Compact Schema  38
    42054433      rfc.abstract anchor  14
    42064434      rfc.authors anchor  14
     
    42144442
    42154443
    4216 Reschke                                                        [Page 74]
    4217 
    4218 
    4219 Documentation             RFC2629 through XSLT            September 2010
     4444Reschke                                                        [Page 78]
     4445
     4446
     4447Documentation             RFC2629 through XSLT             November 2010
    42204448
    42214449
     
    42354463         3.*  15
    42364464      Saxon  15
    4237       Schema  37
     4465      Schema  38
    42384466      sec-no-trailing-dots PI pseudo-attribute  9
    42394467      slides PI pseudo-attribute  8
    42404468      sortrefs PI pseudo-attribute  7
    4241       source Extension Element  27, 37
    4242       span Extension Element  37
     4469      source Extension Element  28, 38
     4470      span Extension Element  38
    42434471      strict PI pseudo-attribute  8
    42444472      subcompact PI pseudo-attribute  8
    4245       sup Extension Element  27, 37
     4473      sup Extension Element  28, 38
    42464474      support-rfc2731 PI pseudo-attribute  9
    42474475      symrefs PI pseudo-attribute  7
     
    42554483
    42564484   X
    4257       x Extension Element  37
     4485      x Extension Element  38
    42584486      Xalan  15
    42594487      xml-stylesheet PI  17
     
    42714499
    42724500
    4273 Reschke                                                        [Page 75]
    4274 
    4275 
    4276 Documentation             RFC2629 through XSLT            September 2010
     4501Reschke                                                        [Page 79]
     4502
     4503
     4504Documentation             RFC2629 through XSLT             November 2010
    42774505
    42784506
     
    43284556
    43294557
    4330 Reschke                                                        [Page 76]
    4331 
    4332 
    4333 Documentation             RFC2629 through XSLT            September 2010
     4558Reschke                                                        [Page 80]
     4559
     4560
     4561Documentation             RFC2629 through XSLT             November 2010
    43344562
    43354563
     
    43854613
    43864614
    4387 Reschke                                                        [Page 77]
    4388 
    4389 
     4615Reschke                                                        [Page 81]
     4616
     4617
Note: See TracChangeset for help on using the changeset viewer.