Changeset 1303 for rfc2629xslt


Ignore:
Timestamp:
Jun 1, 2011, 2:03:44 AM (8 years ago)
Author:
julian.reschke@…
Message:

update rfc2629.xslt, bump up document dates

Location:
rfc2629xslt
Files:
10 edited

Legend:

Unmodified
Added
Removed
  • rfc2629xslt/clean-for-DTD.xslt

    r981 r1303  
    22    Strip rfc2629.xslt extensions, generating XML input for MTR's xml2rfc
    33
    4     Copyright (c) 2006-2010, Julian Reschke (julian.reschke@greenbytes.de)
     4    Copyright (c) 2006-2011, Julian Reschke (julian.reschke@greenbytes.de)
    55    All rights reserved.
    66
     
    388388
    389389<xsl:template name="insert-iref-for-xref">
    390   <xsl:if test="$xml2rfc-ext-include-references-in-index='yesxxx'">
     390  <xsl:if test="$xml2rfc-ext-include-references-in-index='yesxxx' and $xml2rfc-ext-include-index='yes'">
    391391    <xsl:if test="@target=/rfc/back//reference/@anchor">
    392392      <iref item="{@target}"/>
     
    404404  </xsl:if>
    405405</xsl:template>
     406
     407<!-- drop index gen extension -->
     408<xsl:template match="iref" mode="cleanup">
     409  <xsl:if test="$xml2rfc-ext-include-index='yes'">
     410    <iref>
     411      <xsl:apply-templates select="@*|node()" mode="cleanup"/>
     412    </iref>
     413  </xsl:if>
     414</xsl:template>
     415
    406416
    407417<!-- issue tracking extensions -->
  • rfc2629xslt/rfc2629.xslt

    r1276 r1303  
    231231</xsl:param>
    232232
     233<!-- extension for excluding the index -->
     234
     235<xsl:param name="xml2rfc-ext-include-index">
     236  <xsl:call-template name="parse-pis">
     237    <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/>
     238    <xsl:with-param name="attr" select="'include-index'"/>
     239    <xsl:with-param name="default" select="'yes'"/>
     240  </xsl:call-template>
     241</xsl:param>
     242
    233243<!-- extension for excluding DCMI properties in meta tag (RFC2731) -->
    234244
     
    425435    <xsl:call-template name="warning">
    426436      <xsl:with-param name="msg" select="concat('/rfc/@consensus meaningless with a /rfc/@submissionType value of ', /rfc/@submissionType)"/>
    427       <xsl:with-param name="inline" select="'no'"/>
    428437    </xsl:call-template>
    429438  </xsl:if>
     
    561570
    562571<!-- will document have an index -->
    563 <xsl:variable name="has-index" select="//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')" />
     572<xsl:variable name="has-index" select="(//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')) and $xml2rfc-ext-include-index!='no'" />
    564573         
    565574<!-- does the document contain edits? -->
     
    737746      <xsl:if test="string-length($content) > 69 + $indent">
    738747        <xsl:call-template name="warning">
    739           <xsl:with-param name="inline" select="'no'"/>
    740748          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$content"/>' (<xsl:value-of select="string-length($content)"/> characters)</xsl:with-param>
    741749        </xsl:call-template>
     
    753761      <xsl:if test="string-length($start) > $max">
    754762        <xsl:call-template name="warning">
    755           <xsl:with-param name="inline" select="'no'"/>
    756763          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$start"/>' (<xsl:value-of select="string-length($start)"/> characters)</xsl:with-param>
    757764        </xsl:call-template>
     
    10631070            <xsl:call-template name="warning">
    10641071              <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should contain the base name, not the filename (thus no file extension).</xsl:with-param>
    1065               <xsl:with-param name="inline" select="'no'"/>
    10661072            </xsl:call-template>
    10671073            <xsl:value-of select="substring-before($docname,'.')"/>
     
    10781084        <xsl:call-template name="warning">
    10791085          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character '<xsl:value-of select="substring($offending,1,1)"/>'.</xsl:with-param>
    1080           <xsl:with-param name="inline" select="'no'"/>
    10811086        </xsl:call-template>
    10821087      </xsl:if>
     
    10861091        <xsl:call-template name="warning">
    10871092          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character sequence '--'.</xsl:with-param>
    1088           <xsl:with-param name="inline" select="'no'"/>
    10891093        </xsl:call-template>
    10901094      </xsl:if>
     
    10931097        <xsl:call-template name="warning">
    10941098          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should start with 'draft-'.</xsl:with-param>
    1095           <xsl:with-param name="inline" select="'no'"/>
    10961099        </xsl:call-template>
    10971100      </xsl:if>
     
    11091112        <xsl:call-template name="warning">
    11101113          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should end with a two-digit sequence number or 'latest'.</xsl:with-param>
    1111           <xsl:with-param name="inline" select="'no'"/>
    11121114        </xsl:call-template>
    11131115      </xsl:if>
     
    11161118        <xsl:call-template name="warning">
    11171119          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>', excluding sequence number, should have less than 50 characters.</xsl:with-param>
    1118           <xsl:with-param name="inline" select="'no'"/>
    11191120        </xsl:call-template>
    11201121      </xsl:if>
     
    15301531  <xsl:if test="not(ancestor::ed:del) and not(key('xref-item',$anchor))">
    15311532    <xsl:call-template name="warning">
    1532       <xsl:with-param name="inline" select="'no'"/>
    15331533      <xsl:with-param name="msg">unused reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    15341534    </xsl:call-template>
     
    15481548    <xsl:if test="$tst=''">
    15491549      <xsl:call-template name="warning">
    1550         <xsl:with-param name="inline" select="'no'"/>
    15511550        <xsl:with-param name="msg">all references to the normative reference '<xsl:value-of select="@anchor"/>' appear to be informative</xsl:with-param>
    15521551      </xsl:call-template>
     
    16851684        <xsl:if test="(@name='BCP' or @name='FYI' or @name='STD') and preceding-sibling::seriesInfo[@name='RFC']">
    16861685          <xsl:call-template name="warning">
    1687             <xsl:with-param name="inline" select="'no'"/>
    16881686            <xsl:with-param name="msg">RFC number preceding <xsl:value-of select="@name"/> number in reference '<xsl:value-of select="../@anchor"/>'</xsl:with-param>
    16891687          </xsl:call-template>
     
    17011699        <xsl:if test="string(number(front/date/@year)) = 'NaN'">
    17021700          <xsl:call-template name="warning">
    1703             <xsl:with-param name="inline" select="'no'"/>
    17041701            <xsl:with-param name="msg">date/@year should be a number: '<xsl:value-of select="front/date/@year"/>' in reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    17051702          </xsl:call-template>
     
    19531950<xsl:template match="t">
    19541951  <xsl:if test="preceding-sibling::section or preceding-sibling::appendix">
    1955     <xsl:call-template name="warning">
     1952    <xsl:call-template name="inline-warning">
    19561953      <xsl:with-param name="msg">The paragraph below is misplaced; maybe a section is closed in the wrong place: </xsl:with-param>
    19571954      <xsl:with-param name="msg2"><xsl:value-of select="."/></xsl:with-param>
     
    20192016  <xsl:if test="@abbrev and string-length(@abbrev) > 40">
    20202017    <xsl:call-template name="warning">
    2021       <xsl:with-param name="inline" select="'no'"/>
    20222018      <xsl:with-param name="msg">title/@abbrev too long (max 40 characters)</xsl:with-param>
    20232019    </xsl:call-template>
     
    20262022  <xsl:if test="string-length(.) > 40 and (not(@abbrev) or @abbrev='')">
    20272023    <xsl:call-template name="warning">
    2028       <xsl:with-param name="inline" select="'no'"/>
    20292024      <xsl:with-param name="msg">title too long, should supply title/@abbrev attribute with less than 40 characters</xsl:with-param>
    20302025    </xsl:call-template>
     
    20602055  <xsl:if test="self::appendix">
    20612056    <xsl:call-template name="warning">
    2062       <xsl:with-param name="inline" select="'no'"/>
    20632057      <xsl:with-param name="msg">The "appendix" element is deprecated, use "section" inside "back" instead.</xsl:with-param>
    20642058    </xsl:call-template>
     
    22942288        <xsl:if test="not($r-is-normative)">
    22952289          <xsl:call-template name="warning">
    2296             <xsl:with-param name="inline" select="'no'"/>
    22972290            <xsl:with-param name="msg" select="concat('Potentially normative reference to ',@target,' not referenced normatively')"/>
    22982291          </xsl:call-template>
     
    24612454            <xsl:for-each select="$xref">
    24622455              <xsl:call-template name="warning">
    2463                 <xsl:with-param name="inline" select="'no'"/>
    24642456                <xsl:with-param name="msg" select="concat('Potentially normative reference to ',$xref/@target,' not referenced normatively')"/>
    24652457              </xsl:call-template>
     
    26692661
    26702662<xsl:template match="/">
     2663  <xsl:apply-templates select="*" mode="validate"/>
    26712664  <xsl:apply-templates select="*" />
    26722665</xsl:template>
     
    28142807      <xsl:call-template name="warning">
    28152808        <xsl:with-param name="msg" select="concat('/rfc/front/date/@day appears to be missing for a historic draft dated ', $pub-yearmonth)"/>
    2816         <xsl:with-param name="inline" select="'no'"/>
    28172809      </xsl:call-template>
    28182810    </xsl:if>
     
    49924984      <xsl:value-of select="$name"/>
    49934985      <xsl:call-template name="warning">
    4994         <xsl:with-param name="inline" select="'no'"/>
    49954986        <xsl:with-param name="msg" select="concat('In metadata obsoletes/updates, RFC number of draft name is expected - found: ',$name)"/>
    49964987      </xsl:call-template>
     
    50275018      <xsl:if test="not(//references//reference/seriesInfo[@name='Internet-Draft' and @value=$name])">
    50285019        <xsl:call-template name="warning">
    5029           <xsl:with-param name="inline" select="'no'"/>
    50305020          <xsl:with-param name="msg" select="concat('front matter mentions I-D ',$name,' for which there is no reference element')"/>
    50315021        </xsl:call-template>
     
    50355025      <xsl:if test="not(//references//reference/seriesInfo[@name='RFC' and @value=$name])">
    50365026        <xsl:call-template name="warning">
    5037           <xsl:with-param name="inline" select="'no'"/>
    50385027          <xsl:with-param name="msg" select="concat('front matter mentions RFC ',$name,' for which there is no reference element')"/>
    50395028        </xsl:call-template>
     
    51155104    <xsl:otherwise>
    51165105      <xsl:call-template name="warning">
    5117         <xsl:with-param name="inline" select="'no'"/>
    51185106        <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' does not exist.</xsl:with-param>
    51195107      </xsl:call-template>
     
    57015689    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2068' or @value='2616')])">
    57025690      <xsl:call-template name="warning">
    5703         <xsl:with-param name="inline">no</xsl:with-param>
    57045691        <xsl:with-param name="msg">document uses HTTP-style ABNF syntax, but doesn't reference RFC 2068 or 2616.</xsl:with-param>
    57055692      </xsl:call-template>
     
    57095696    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2234' or @value='4234' or @value='5234')])">
    57105697      <xsl:call-template name="warning">
    5711         <xsl:with-param name="inline">no</xsl:with-param>
    57125698        <xsl:with-param name="msg">document uses ABNF syntax, but doesn't reference RFC 2234, 4234 or 5234.</xsl:with-param>
    57135699      </xsl:call-template>
     
    59535939</xsl:template>
    59545940
     5941<xsl:template name="inline-warning">
     5942  <xsl:param name="msg"/>
     5943  <xsl:param name="msg2"/>
     5944  <xsl:call-template name="emit-message">
     5945    <xsl:with-param name="level">WARNING</xsl:with-param>
     5946    <xsl:with-param name="msg" select="$msg"/>
     5947    <xsl:with-param name="msg2" select="$msg2"/>
     5948    <xsl:with-param name="inline" select="'yes'"/>
     5949  </xsl:call-template>
     5950</xsl:template>
     5951
    59555952<xsl:template name="warning">
    59565953  <xsl:param name="msg"/>
     
    59615958    <xsl:with-param name="msg" select="$msg"/>
    59625959    <xsl:with-param name="msg2" select="$msg2"/>
    5963     <xsl:with-param name="inline" select="$inline"/>
     5960    <xsl:with-param name="inline" select="'no'"/>
    59645961  </xsl:call-template>
    59655962</xsl:template>
     
    60716068                  <xsl:otherwise>
    60726069                    <xsl:call-template name="warning">
    6073                       <xsl:with-param name="inline" select="'no'"/>
    60746070                      <xsl:with-param name="msg">Unknown align attribute on ttcol: <xsl:value-of select="$col/@align"/></xsl:with-param>                     
    60756071                    </xsl:call-template>
     
    63196315    <xsl:text>http://greenbytes.de/tech/webdav/rfc2629.xslt, </xsl:text>
    63206316    <!-- when RCS keyword substitution in place, add version info -->
    6321     <xsl:if test="contains('$Revision: 1.547 $',':')">
    6322       <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.547 $', 'Revision: '),'$','')),', ')" />
     6317    <xsl:if test="contains('$Revision: 1.550 $',':')">
     6318      <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.550 $', 'Revision: '),'$','')),', ')" />
    63236319    </xsl:if>
    6324     <xsl:if test="contains('$Date: 2011-04-17 09:42:41 $',':')">
    6325       <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-04-17 09:42:41 $', 'Date: '),'$','')),', ')" />
     6320    <xsl:if test="contains('$Date: 2011-05-30 14:02:12 $',':')">
     6321      <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-05-30 14:02:12 $', 'Date: '),'$','')),', ')" />
    63266322    </xsl:if>
    63276323    <xsl:value-of select="concat('XSLT vendor: ',system-property('xsl:vendor'),' ',system-property('xsl:vendor-url'))" />
     
    63386334    <xsl:if test="contains(.,',')">
    63396335      <xsl:call-template name="warning">
    6340         <xsl:with-param name="inline" select="'no'"/>
    63416336        <xsl:with-param name="msg">keyword element appears to contain a comma-separated list, split into multiple elements instead.</xsl:with-param>
    63426337      </xsl:call-template>
     
    64616456  <xsl:if test="$r!=@initials">
    64626457    <xsl:call-template name="warning">
    6463       <xsl:with-param name="inline" select="'no'"/>
    64646458      <xsl:with-param name="msg">@initials '<xsl:value-of select="@initials"/>': did you mean '<xsl:value-of select="$r"/>'?</xsl:with-param>
    64656459    </xsl:call-template>
     
    65276521  <xsl:if test="string-length($node) != string-length($text)">
    65286522    <xsl:call-template name="warning">
    6529       <xsl:with-param name="inline" select="'no'"/>
    65306523      <xsl:with-param name="msg">excessive whitespace in <xsl:value-of select="$name"/>: '<xsl:value-of select="$node"/>'</xsl:with-param>
    65316524    </xsl:call-template>
     
    65396532  <xsl:if test="string-length(.) != string-length($email) or contains($email,' ')">
    65406533    <xsl:call-template name="warning">
    6541       <xsl:with-param name="inline" select="'no'"/>
    65426534      <xsl:with-param name="msg">excessive whitespace in email address: '<xsl:value-of select="."/>'</xsl:with-param>
    65436535    </xsl:call-template>
     
    65486540      <xsl:when test="starts-with($email,'mailto:')">
    65496541        <xsl:call-template name="warning">
    6550           <xsl:with-param name="inline" select="'no'"/>
    65516542          <xsl:with-param name="msg">email should not include URI scheme: '<xsl:value-of select="."/>'</xsl:with-param>
    65526543        </xsl:call-template>
     
    65676558  <xsl:if test="string-length(.) != string-length($uri) or contains($uri,' ')">
    65686559    <xsl:call-template name="warning">
    6569       <xsl:with-param name="inline" select="'no'"/>
    65706560      <xsl:with-param name="msg">excessive whitespace in URI: '<xsl:value-of select="."/>'</xsl:with-param>
    65716561    </xsl:call-template>
     
    66686658          <xsl:call-template name="warning">
    66696659            <xsl:with-param name="msg">bad PI syntax: <xsl:value-of select="$str2"/></xsl:with-param>
    6670             <xsl:with-param name="inline" select="'no'"/>
    66716660          </xsl:call-template>
    66726661          <xsl:value-of select="$ret"/>
     
    66786667              <xsl:call-template name="warning">
    66796668                <xsl:with-param name="msg">bad PI value syntax: <xsl:value-of select="$remainder"/></xsl:with-param>
    6680                 <xsl:with-param name="inline" select="'no'"/>
    66816669              </xsl:call-template>
    66826670              <xsl:value-of select="$ret"/>
     
    66956683                  <xsl:call-template name="warning">
    66966684                    <xsl:with-param name="msg">pseudo-attribute value needs to be quoted: <xsl:value-of select="$rem"/></xsl:with-param>
    6697                     <xsl:with-param name="inline" select="'no'"/>
    66986685                  </xsl:call-template>
    66996686                  <xsl:value-of select="$ret"/>
     
    67026689                  <xsl:call-template name="warning">
    67036690                    <xsl:with-param name="msg">unmatched quote in: <xsl:value-of select="$rem2"/></xsl:with-param>
    6704                     <xsl:with-param name="inline" select="'no'"/>
    67056691                  </xsl:call-template>
    67066692                  <xsl:value-of select="$ret"/>
     
    67156701                      <xsl:when test="$attrname='authors-section'"/>
    67166702                      <xsl:when test="$attrname='duplex'"/>
     6703                      <xsl:when test="$attrname='include-index'"/>
    67176704                      <xsl:when test="$attrname='include-references-in-index'"/>
    67186705                      <xsl:when test="$attrname='justification'"/>
     
    67246711                        <xsl:call-template name="warning">
    67256712                          <xsl:with-param name="msg">unsupported rfc-ext pseudo-attribute '<xsl:value-of select="$attrname"/>'</xsl:with-param>
    6726                           <xsl:with-param name="inline" select="'no'"/>
    67276713                        </xsl:call-template>
    67286714                      </xsl:otherwise>
     
    67356721                        <xsl:call-template name="warning">
    67366722                          <xsl:with-param name="msg">the rfc include pseudo-attribute is not supported by this processor, see http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#examples.internalsubset for help.</xsl:with-param>
    6737                           <xsl:with-param name="inline" select="'no'"/>
    67386723                        </xsl:call-template>
    67396724                      </xsl:when>
     
    67576742                        <xsl:call-template name="warning">
    67586743                          <xsl:with-param name="msg">duplicate pseudo-attribute <xsl:value-of select="$attr"/>, overwriting value <xsl:value-of select="$ret"/></xsl:with-param>
    6759                           <xsl:with-param name="inline" select="'no'"/>
    67606744                        </xsl:call-template>
    67616745                      </xsl:if>
     
    69486932    <xsl:when test="$current-year!='' and $may-default-dates!='yes'">
    69496933      <xsl:call-template name="warning">
    6950         <xsl:with-param name="inline" select="'no'"/>
    69516934        <xsl:with-param name="msg" select="$may-default-dates"/>
    69526935      </xsl:call-template>
     
    69726955    <xsl:when test="$current-month!='' and $may-default-dates!='yes'">
    69736956      <xsl:call-template name="warning">
    6974         <xsl:with-param name="inline" select="'no'"/>
    69756957        <xsl:with-param name="msg" select="$may-default-dates"/>
    69766958      </xsl:call-template>
     
    70176999    <xsl:otherwise>00</xsl:otherwise>
    70187000  </xsl:choose>
    7019 
    70207001</xsl:param>
    70217002
     7003<!-- simple validation support -->
     7004
     7005<xsl:template match="*" mode="validate">
     7006  <xsl:apply-templates select="@*|*" mode="validate"/>
     7007</xsl:template>
     7008<xsl:template match="@*" mode="validate"/>
     7009
     7010<xsl:template name="warninvalid">
     7011  <xsl:variable name="pname">
     7012    <xsl:if test="namespace-uri(..)!=''">
     7013      <xsl:value-of select="concat('{',namespace-uri(..),'}')"/>
     7014    </xsl:if>
     7015    <xsl:value-of select="local-name(..)"/>
     7016  </xsl:variable>
     7017  <xsl:variable name="cname">
     7018    <xsl:if test="namespace-uri(.)!=''">
     7019      <xsl:value-of select="concat('{',namespace-uri(.),'}')"/>
     7020    </xsl:if>
     7021    <xsl:value-of select="local-name(.)"/>
     7022  </xsl:variable>
     7023  <xsl:call-template name="warning">
     7024    <xsl:with-param name="msg" select="concat($cname,' not allowed inside ',$pname)"/>
     7025  </xsl:call-template>
     7026</xsl:template>
     7027
     7028<!-- figure element -->
     7029<xsl:template match="figure/artwork | figure/ed:replace/ed:*/artwork" mode="validate" priority="9">
     7030  <xsl:apply-templates select="@*|*" mode="validate"/>
     7031</xsl:template>
     7032<xsl:template match="artwork" mode="validate">
     7033  <xsl:call-template name="warninvalid"/>
     7034  <xsl:apply-templates select="@*|*" mode="validate"/>
     7035</xsl:template>
     7036
     7037<!-- list element -->
     7038<xsl:template match="t/list | t/ed:replace/ed:*/list" mode="validate" priority="9">
     7039  <xsl:apply-templates select="@*|*" mode="validate"/>
     7040</xsl:template>
     7041<xsl:template match="list" mode="validate">
     7042  <xsl:call-template name="warninvalid"/>
     7043  <xsl:apply-templates select="@*|*" mode="validate"/>
     7044</xsl:template>
     7045
     7046<!-- t element -->
     7047<xsl:template match="abstract/t | abstract/ed:replace/ed:*/t |
     7048                     list/t | list/ed:replace/ed:*/t |
     7049                     note/t | note/ed:replace/ed:*/t |
     7050                     section/t | section/ed:replace/ed:*/t |
     7051                     x:blockquote/t | x:blockquote/ed:replace/ed:*/t |
     7052                     x:note/t | x:note/ed:replace/ed:*/t |
     7053                     x:lt/t | x:lt/ed:replace/ed:*/t" mode="validate" priority="9">
     7054  <xsl:apply-templates select="@*|*" mode="validate"/>
     7055</xsl:template>
     7056<xsl:template match="t" mode="validate">
     7057  <xsl:call-template name="warninvalid"/>
     7058  <xsl:apply-templates select="@*|*" mode="validate"/>
     7059</xsl:template>
     7060
    70227061</xsl:transform>
  • rfc2629xslt/rfc2629toFO.xslt

    r1145 r1303  
    537537  <xsl:if test="@style!='' and @style!='empty' and @style">
    538538    <xsl:call-template name="warning">
    539       <xsl:with-param name="inline" select="'no'"/>
    540539      <xsl:with-param name="msg">unknown style '<xsl:value-of select="@style"/>' for list, continueing with default format.</xsl:with-param>
    541540    </xsl:call-template>
     
    26012600    <xsl:otherwise>
    26022601      <xsl:call-template name="warning">
    2603         <xsl:with-param name="inline" select="'no'"/>
    26042602        <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' does not exist.</xsl:with-param>
    26052603      </xsl:call-template>
  • rfc2629xslt/rfc2629toXHTML.xslt

    r1276 r1303  
    184184    <xsl:with-param name="attr" select="'trace-parse-xml'"/>
    185185    <xsl:with-param name="default" select="'no'"/>
     186  </xsl:call-template>
     187</xsl:param>
     188
     189<!-- extension for excluding the index -->
     190
     191<xsl:param name="xml2rfc-ext-include-index">
     192  <xsl:call-template name="parse-pis">
     193    <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/>
     194    <xsl:with-param name="attr" select="'include-index'"/>
     195    <xsl:with-param name="default" select="'yes'"/>
    186196  </xsl:call-template>
    187197</xsl:param>
     
    356366    <xsl:call-template name="warning">
    357367      <xsl:with-param name="msg" select="concat('/rfc/@consensus meaningless with a /rfc/@submissionType value of ', /rfc/@submissionType)"/>
    358       <xsl:with-param name="inline" select="'no'"/>
    359368    </xsl:call-template>
    360369  </xsl:if>
     
    429438
    430439<!-- will document have an index -->
    431 <xsl:variable name="has-index" select="//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')"/>
     440<xsl:variable name="has-index" select="(//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')) and $xml2rfc-ext-include-index!='no'"/>
    432441         
    433442<!-- does the document contain edits? -->
     
    605614      <xsl:if test="string-length($content) &gt; 69 + $indent">
    606615        <xsl:call-template name="warning">
    607           <xsl:with-param name="inline" select="'no'"/>
    608616          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$content"/>' (<xsl:value-of select="string-length($content)"/> characters)</xsl:with-param>
    609617        </xsl:call-template>
     
    621629      <xsl:if test="string-length($start) &gt; $max">
    622630        <xsl:call-template name="warning">
    623           <xsl:with-param name="inline" select="'no'"/>
    624631          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$start"/>' (<xsl:value-of select="string-length($start)"/> characters)</xsl:with-param>
    625632        </xsl:call-template>
     
    931938            <xsl:call-template name="warning">
    932939              <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should contain the base name, not the filename (thus no file extension).</xsl:with-param>
    933               <xsl:with-param name="inline" select="'no'"/>
    934940            </xsl:call-template>
    935941            <xsl:value-of select="substring-before($docname,'.')"/>
     
    946952        <xsl:call-template name="warning">
    947953          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character '<xsl:value-of select="substring($offending,1,1)"/>'.</xsl:with-param>
    948           <xsl:with-param name="inline" select="'no'"/>
    949954        </xsl:call-template>
    950955      </xsl:if>
     
    954959        <xsl:call-template name="warning">
    955960          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character sequence '--'.</xsl:with-param>
    956           <xsl:with-param name="inline" select="'no'"/>
    957961        </xsl:call-template>
    958962      </xsl:if>
     
    961965        <xsl:call-template name="warning">
    962966          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should start with 'draft-'.</xsl:with-param>
    963           <xsl:with-param name="inline" select="'no'"/>
    964967        </xsl:call-template>
    965968      </xsl:if>
     
    977980        <xsl:call-template name="warning">
    978981          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should end with a two-digit sequence number or 'latest'.</xsl:with-param>
    979           <xsl:with-param name="inline" select="'no'"/>
    980982        </xsl:call-template>
    981983      </xsl:if>
     
    984986        <xsl:call-template name="warning">
    985987          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>', excluding sequence number, should have less than 50 characters.</xsl:with-param>
    986           <xsl:with-param name="inline" select="'no'"/>
    987988        </xsl:call-template>
    988989      </xsl:if>
     
    13981399  <xsl:if test="not(ancestor::ed:del) and not(key('xref-item',$anchor))">
    13991400    <xsl:call-template name="warning">
    1400       <xsl:with-param name="inline" select="'no'"/>
    14011401      <xsl:with-param name="msg">unused reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    14021402    </xsl:call-template>
     
    14161416    <xsl:if test="$tst=''">
    14171417      <xsl:call-template name="warning">
    1418         <xsl:with-param name="inline" select="'no'"/>
    14191418        <xsl:with-param name="msg">all references to the normative reference '<xsl:value-of select="@anchor"/>' appear to be informative</xsl:with-param>
    14201419      </xsl:call-template>
     
    15531552        <xsl:if test="(@name='BCP' or @name='FYI' or @name='STD') and preceding-sibling::seriesInfo[@name='RFC']">
    15541553          <xsl:call-template name="warning">
    1555             <xsl:with-param name="inline" select="'no'"/>
    15561554            <xsl:with-param name="msg">RFC number preceding <xsl:value-of select="@name"/> number in reference '<xsl:value-of select="../@anchor"/>'</xsl:with-param>
    15571555          </xsl:call-template>
     
    15691567        <xsl:if test="string(number(front/date/@year)) = 'NaN'">
    15701568          <xsl:call-template name="warning">
    1571             <xsl:with-param name="inline" select="'no'"/>
    15721569            <xsl:with-param name="msg">date/@year should be a number: '<xsl:value-of select="front/date/@year"/>' in reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    15731570          </xsl:call-template>
     
    18211818<xsl:template match="t">
    18221819  <xsl:if test="preceding-sibling::section or preceding-sibling::appendix">
    1823     <xsl:call-template name="warning">
     1820    <xsl:call-template name="inline-warning">
    18241821      <xsl:with-param name="msg">The paragraph below is misplaced; maybe a section is closed in the wrong place: </xsl:with-param>
    18251822      <xsl:with-param name="msg2"><xsl:value-of select="."/></xsl:with-param>
     
    18871884  <xsl:if test="@abbrev and string-length(@abbrev) &gt; 40">
    18881885    <xsl:call-template name="warning">
    1889       <xsl:with-param name="inline" select="'no'"/>
    18901886      <xsl:with-param name="msg">title/@abbrev too long (max 40 characters)</xsl:with-param>
    18911887    </xsl:call-template>
     
    18941890  <xsl:if test="string-length(.) &gt; 40 and (not(@abbrev) or @abbrev='')">
    18951891    <xsl:call-template name="warning">
    1896       <xsl:with-param name="inline" select="'no'"/>
    18971892      <xsl:with-param name="msg">title too long, should supply title/@abbrev attribute with less than 40 characters</xsl:with-param>
    18981893    </xsl:call-template>
     
    19281923  <xsl:if test="self::appendix">
    19291924    <xsl:call-template name="warning">
    1930       <xsl:with-param name="inline" select="'no'"/>
    19311925      <xsl:with-param name="msg">The "appendix" element is deprecated, use "section" inside "back" instead.</xsl:with-param>
    19321926    </xsl:call-template>
     
    21622156        <xsl:if test="not($r-is-normative)">
    21632157          <xsl:call-template name="warning">
    2164             <xsl:with-param name="inline" select="'no'"/>
    21652158            <xsl:with-param name="msg" select="concat('Potentially normative reference to ',@target,' not referenced normatively')"/>
    21662159          </xsl:call-template>
     
    23292322            <xsl:for-each select="$xref">
    23302323              <xsl:call-template name="warning">
    2331                 <xsl:with-param name="inline" select="'no'"/>
    23322324                <xsl:with-param name="msg" select="concat('Potentially normative reference to ',$xref/@target,' not referenced normatively')"/>
    23332325              </xsl:call-template>
     
    25372529
    25382530<xsl:template match="/">
     2531  <xsl:apply-templates select="*" mode="validate"/>
    25392532  <xsl:apply-templates select="*"/>
    25402533</xsl:template>
     
    26822675      <xsl:call-template name="warning">
    26832676        <xsl:with-param name="msg" select="concat('/rfc/front/date/@day appears to be missing for a historic draft dated ', $pub-yearmonth)"/>
    2684         <xsl:with-param name="inline" select="'no'"/>
    26852677      </xsl:call-template>
    26862678    </xsl:if>
     
    48484840      <xsl:value-of select="$name"/>
    48494841      <xsl:call-template name="warning">
    4850         <xsl:with-param name="inline" select="'no'"/>
    48514842        <xsl:with-param name="msg" select="concat('In metadata obsoletes/updates, RFC number of draft name is expected - found: ',$name)"/>
    48524843      </xsl:call-template>
     
    48834874      <xsl:if test="not(//references//reference/seriesInfo[@name='Internet-Draft' and @value=$name])">
    48844875        <xsl:call-template name="warning">
    4885           <xsl:with-param name="inline" select="'no'"/>
    48864876          <xsl:with-param name="msg" select="concat('front matter mentions I-D ',$name,' for which there is no reference element')"/>
    48874877        </xsl:call-template>
     
    48914881      <xsl:if test="not(//references//reference/seriesInfo[@name='RFC' and @value=$name])">
    48924882        <xsl:call-template name="warning">
    4893           <xsl:with-param name="inline" select="'no'"/>
    48944883          <xsl:with-param name="msg" select="concat('front matter mentions RFC ',$name,' for which there is no reference element')"/>
    48954884        </xsl:call-template>
     
    49714960    <xsl:otherwise>
    49724961      <xsl:call-template name="warning">
    4973         <xsl:with-param name="inline" select="'no'"/>
    49744962        <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' does not exist.</xsl:with-param>
    49754963      </xsl:call-template>
     
    55565544    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2068' or @value='2616')])">
    55575545      <xsl:call-template name="warning">
    5558         <xsl:with-param name="inline">no</xsl:with-param>
    55595546        <xsl:with-param name="msg">document uses HTTP-style ABNF syntax, but doesn't reference RFC 2068 or 2616.</xsl:with-param>
    55605547      </xsl:call-template>
     
    55645551    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2234' or @value='4234' or @value='5234')])">
    55655552      <xsl:call-template name="warning">
    5566         <xsl:with-param name="inline">no</xsl:with-param>
    55675553        <xsl:with-param name="msg">document uses ABNF syntax, but doesn't reference RFC 2234, 4234 or 5234.</xsl:with-param>
    55685554      </xsl:call-template>
     
    58085794</xsl:template>
    58095795
     5796<xsl:template name="inline-warning">
     5797  <xsl:param name="msg"/>
     5798  <xsl:param name="msg2"/>
     5799  <xsl:call-template name="emit-message">
     5800    <xsl:with-param name="level">WARNING</xsl:with-param>
     5801    <xsl:with-param name="msg" select="$msg"/>
     5802    <xsl:with-param name="msg2" select="$msg2"/>
     5803    <xsl:with-param name="inline" select="'yes'"/>
     5804  </xsl:call-template>
     5805</xsl:template>
     5806
    58105807<xsl:template name="warning">
    58115808  <xsl:param name="msg"/>
     
    58165813    <xsl:with-param name="msg" select="$msg"/>
    58175814    <xsl:with-param name="msg2" select="$msg2"/>
    5818     <xsl:with-param name="inline" select="$inline"/>
     5815    <xsl:with-param name="inline" select="'no'"/>
    58195816  </xsl:call-template>
    58205817</xsl:template>
     
    59265923                  <xsl:otherwise>
    59275924                    <xsl:call-template name="warning">
    5928                       <xsl:with-param name="inline" select="'no'"/>
    59295925                      <xsl:with-param name="msg">Unknown align attribute on ttcol: <xsl:value-of select="$col/@align"/></xsl:with-param>                     
    59305926                    </xsl:call-template>
     
    61746170    <xsl:text>http://greenbytes.de/tech/webdav/rfc2629.xslt, </xsl:text>
    61756171    <!-- when RCS keyword substitution in place, add version info -->
    6176     <xsl:if test="contains('$Revision: 1.547 $',':')">
    6177       <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.547 $', 'Revision: '),'$','')),', ')"/>
     6172    <xsl:if test="contains('$Revision: 1.550 $',':')">
     6173      <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.550 $', 'Revision: '),'$','')),', ')"/>
    61786174    </xsl:if>
    6179     <xsl:if test="contains('$Date: 2011-04-17 09:42:41 $',':')">
    6180       <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-04-17 09:42:41 $', 'Date: '),'$','')),', ')"/>
     6175    <xsl:if test="contains('$Date: 2011-05-30 14:02:12 $',':')">
     6176      <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-05-30 14:02:12 $', 'Date: '),'$','')),', ')"/>
    61816177    </xsl:if>
    61826178    <xsl:value-of select="concat('XSLT vendor: ',system-property('xsl:vendor'),' ',system-property('xsl:vendor-url'))"/>
     
    61936189    <xsl:if test="contains(.,',')">
    61946190      <xsl:call-template name="warning">
    6195         <xsl:with-param name="inline" select="'no'"/>
    61966191        <xsl:with-param name="msg">keyword element appears to contain a comma-separated list, split into multiple elements instead.</xsl:with-param>
    61976192      </xsl:call-template>
     
    63166311  <xsl:if test="$r!=@initials">
    63176312    <xsl:call-template name="warning">
    6318       <xsl:with-param name="inline" select="'no'"/>
    63196313      <xsl:with-param name="msg">@initials '<xsl:value-of select="@initials"/>': did you mean '<xsl:value-of select="$r"/>'?</xsl:with-param>
    63206314    </xsl:call-template>
     
    63826376  <xsl:if test="string-length($node) != string-length($text)">
    63836377    <xsl:call-template name="warning">
    6384       <xsl:with-param name="inline" select="'no'"/>
    63856378      <xsl:with-param name="msg">excessive whitespace in <xsl:value-of select="$name"/>: '<xsl:value-of select="$node"/>'</xsl:with-param>
    63866379    </xsl:call-template>
     
    63946387  <xsl:if test="string-length(.) != string-length($email) or contains($email,' ')">
    63956388    <xsl:call-template name="warning">
    6396       <xsl:with-param name="inline" select="'no'"/>
    63976389      <xsl:with-param name="msg">excessive whitespace in email address: '<xsl:value-of select="."/>'</xsl:with-param>
    63986390    </xsl:call-template>
     
    64036395      <xsl:when test="starts-with($email,'mailto:')">
    64046396        <xsl:call-template name="warning">
    6405           <xsl:with-param name="inline" select="'no'"/>
    64066397          <xsl:with-param name="msg">email should not include URI scheme: '<xsl:value-of select="."/>'</xsl:with-param>
    64076398        </xsl:call-template>
     
    64226413  <xsl:if test="string-length(.) != string-length($uri) or contains($uri,' ')">
    64236414    <xsl:call-template name="warning">
    6424       <xsl:with-param name="inline" select="'no'"/>
    64256415      <xsl:with-param name="msg">excessive whitespace in URI: '<xsl:value-of select="."/>'</xsl:with-param>
    64266416    </xsl:call-template>
     
    65236513          <xsl:call-template name="warning">
    65246514            <xsl:with-param name="msg">bad PI syntax: <xsl:value-of select="$str2"/></xsl:with-param>
    6525             <xsl:with-param name="inline" select="'no'"/>
    65266515          </xsl:call-template>
    65276516          <xsl:value-of select="$ret"/>
     
    65336522              <xsl:call-template name="warning">
    65346523                <xsl:with-param name="msg">bad PI value syntax: <xsl:value-of select="$remainder"/></xsl:with-param>
    6535                 <xsl:with-param name="inline" select="'no'"/>
    65366524              </xsl:call-template>
    65376525              <xsl:value-of select="$ret"/>
     
    65506538                  <xsl:call-template name="warning">
    65516539                    <xsl:with-param name="msg">pseudo-attribute value needs to be quoted: <xsl:value-of select="$rem"/></xsl:with-param>
    6552                     <xsl:with-param name="inline" select="'no'"/>
    65536540                  </xsl:call-template>
    65546541                  <xsl:value-of select="$ret"/>
     
    65576544                  <xsl:call-template name="warning">
    65586545                    <xsl:with-param name="msg">unmatched quote in: <xsl:value-of select="$rem2"/></xsl:with-param>
    6559                     <xsl:with-param name="inline" select="'no'"/>
    65606546                  </xsl:call-template>
    65616547                  <xsl:value-of select="$ret"/>
     
    65706556                      <xsl:when test="$attrname='authors-section'"/>
    65716557                      <xsl:when test="$attrname='duplex'"/>
     6558                      <xsl:when test="$attrname='include-index'"/>
    65726559                      <xsl:when test="$attrname='include-references-in-index'"/>
    65736560                      <xsl:when test="$attrname='justification'"/>
     
    65796566                        <xsl:call-template name="warning">
    65806567                          <xsl:with-param name="msg">unsupported rfc-ext pseudo-attribute '<xsl:value-of select="$attrname"/>'</xsl:with-param>
    6581                           <xsl:with-param name="inline" select="'no'"/>
    65826568                        </xsl:call-template>
    65836569                      </xsl:otherwise>
     
    65906576                        <xsl:call-template name="warning">
    65916577                          <xsl:with-param name="msg">the rfc include pseudo-attribute is not supported by this processor, see http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#examples.internalsubset for help.</xsl:with-param>
    6592                           <xsl:with-param name="inline" select="'no'"/>
    65936578                        </xsl:call-template>
    65946579                      </xsl:when>
     
    66126597                        <xsl:call-template name="warning">
    66136598                          <xsl:with-param name="msg">duplicate pseudo-attribute <xsl:value-of select="$attr"/>, overwriting value <xsl:value-of select="$ret"/></xsl:with-param>
    6614                           <xsl:with-param name="inline" select="'no'"/>
    66156599                        </xsl:call-template>
    66166600                      </xsl:if>
     
    68036787    <xsl:when test="$current-year!='' and $may-default-dates!='yes'">
    68046788      <xsl:call-template name="warning">
    6805         <xsl:with-param name="inline" select="'no'"/>
    68066789        <xsl:with-param name="msg" select="$may-default-dates"/>
    68076790      </xsl:call-template>
     
    68276810    <xsl:when test="$current-month!='' and $may-default-dates!='yes'">
    68286811      <xsl:call-template name="warning">
    6829         <xsl:with-param name="inline" select="'no'"/>
    68306812        <xsl:with-param name="msg" select="$may-default-dates"/>
    68316813      </xsl:call-template>
     
    68726854    <xsl:otherwise>00</xsl:otherwise>
    68736855  </xsl:choose>
    6874 
    68756856</xsl:param>
    68766857
     6858<!-- simple validation support -->
     6859
     6860<xsl:template match="*" mode="validate">
     6861  <xsl:apply-templates select="@*|*" mode="validate"/>
     6862</xsl:template>
     6863<xsl:template match="@*" mode="validate"/>
     6864
     6865<xsl:template name="warninvalid">
     6866  <xsl:variable name="pname">
     6867    <xsl:if test="namespace-uri(..)!=''">
     6868      <xsl:value-of select="concat('{',namespace-uri(..),'}')"/>
     6869    </xsl:if>
     6870    <xsl:value-of select="local-name(..)"/>
     6871  </xsl:variable>
     6872  <xsl:variable name="cname">
     6873    <xsl:if test="namespace-uri(.)!=''">
     6874      <xsl:value-of select="concat('{',namespace-uri(.),'}')"/>
     6875    </xsl:if>
     6876    <xsl:value-of select="local-name(.)"/>
     6877  </xsl:variable>
     6878  <xsl:call-template name="warning">
     6879    <xsl:with-param name="msg" select="concat($cname,' not allowed inside ',$pname)"/>
     6880  </xsl:call-template>
     6881</xsl:template>
     6882
     6883<!-- figure element -->
     6884<xsl:template match="figure/artwork | figure/ed:replace/ed:*/artwork" mode="validate" priority="9">
     6885  <xsl:apply-templates select="@*|*" mode="validate"/>
     6886</xsl:template>
     6887<xsl:template match="artwork" mode="validate">
     6888  <xsl:call-template name="warninvalid"/>
     6889  <xsl:apply-templates select="@*|*" mode="validate"/>
     6890</xsl:template>
     6891
     6892<!-- list element -->
     6893<xsl:template match="t/list | t/ed:replace/ed:*/list" mode="validate" priority="9">
     6894  <xsl:apply-templates select="@*|*" mode="validate"/>
     6895</xsl:template>
     6896<xsl:template match="list" mode="validate">
     6897  <xsl:call-template name="warninvalid"/>
     6898  <xsl:apply-templates select="@*|*" mode="validate"/>
     6899</xsl:template>
     6900
     6901<!-- t element -->
     6902<xsl:template match="abstract/t | abstract/ed:replace/ed:*/t |                      list/t | list/ed:replace/ed:*/t |                      note/t | note/ed:replace/ed:*/t |                      section/t | section/ed:replace/ed:*/t |                      x:blockquote/t | x:blockquote/ed:replace/ed:*/t |                      x:note/t | x:note/ed:replace/ed:*/t |                      x:lt/t | x:lt/ed:replace/ed:*/t" mode="validate" priority="9">
     6903  <xsl:apply-templates select="@*|*" mode="validate"/>
     6904</xsl:template>
     6905<xsl:template match="t" mode="validate">
     6906  <xsl:call-template name="warninvalid"/>
     6907  <xsl:apply-templates select="@*|*" mode="validate"/>
     6908</xsl:template>
     6909
    68776910</xsl:transform>
  • rfc2629xslt/rfc2629xslt.html

    r1276 r1303  
    356356  }
    357357  @top-right {
    358        content: "April 2011";
     358       content: "May 2011";
    359359  }
    360360  @top-center {
     
    383383    }
    384384}
    385 </style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Introduction" href="#rfc.section.1"><link rel="Chapter" title="2 Supported RFC2629 elements" href="#rfc.section.2"><link rel="Chapter" title="3 Processing Instructions" href="#rfc.section.3"><link rel="Chapter" title="4 Anchors" href="#rfc.section.4"><link rel="Chapter" title="5 Supported XSLT engines" href="#rfc.section.5"><link rel="Chapter" title="6 Transforming to HTML" href="#rfc.section.6"><link rel="Chapter" title="7 Transforming to XHTML" href="#rfc.section.7"><link rel="Chapter" title="8 Transforming to CHM (Microsoft Compiled Help)" href="#rfc.section.8"><link rel="Chapter" title="9 Transforming to PDF" href="#rfc.section.9"><link rel="Chapter" title="10 Transforming to ePub" href="#rfc.section.10"><link rel="Chapter" title="11 Generic Extensions" href="#rfc.section.11"><link rel="Chapter" title="12 Utilities" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 Informative References"><link rel="Appendix" title="A RELAX NG Compact Schema" href="#rfc.section.A"><link rel="Appendix" title="B Implementation Notes" href="#rfc.section.B"><link rel="Appendix" title="C Examples" href="#rfc.section.C"><link rel="Appendix" title="D Producing the IETF 'Boilerplate'" href="#rfc.section.D"><link rel="Appendix" title="E License" href="#rfc.section.E"><link rel="Appendix" title="F Change Logs" href="#rfc.section.F"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.547, 2011-04-17 09:42:41, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, xml2rfc, XSLT, hCard, XSL-FO, PDF, GRDDL, epub, Dublin Core"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 through XSLT</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right">April 2011</td></tr></tbody></table><p class="title">Transforming RFC2629-formatted XML through XSLT</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1">Introduction</a></li><li>2.&nbsp;&nbsp;&nbsp;<a href="#supported.elements">Supported RFC2629 elements</a><ul><li>2.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.2.1">Extension elements</a></li></ul></li><li>3.&nbsp;&nbsp;&nbsp;<a href="#processing.instructions">Processing Instructions</a><ul><li>3.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.1">Supported xml2rfc-compatible PIs</a></li><li>3.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.2">Unsupported xml2rfc-compatible PIs</a></li><li>3.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.3">Extension PIs</a></li></ul></li><li>4.&nbsp;&nbsp;&nbsp;<a href="#anchors">Anchors</a></li><li>5.&nbsp;&nbsp;&nbsp;<a href="#xslt.engines">Supported XSLT engines</a><ul><li>5.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.1">Standalone Engines</a></li><li>5.2&nbsp;&nbsp;&nbsp;<a href="#xslt.engines.browser">In-Browser Engines</a></li></ul></li><li>6.&nbsp;&nbsp;&nbsp;<a href="#output.html">Transforming to HTML</a><ul><li>6.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6.1">HTML compliance</a></li><li>6.2&nbsp;&nbsp;&nbsp;<a href="#html.link">Standard HTML LINK elements</a></li><li>6.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6.3">Standard HTML metadata</a></li><li>6.4&nbsp;&nbsp;&nbsp;<a href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></li><li>6.5&nbsp;&nbsp;&nbsp;<a href="#hcard">Experimental hCard support</a></li></ul></li><li>7.&nbsp;&nbsp;&nbsp;<a href="#output.xhtml">Transforming to XHTML</a></li><li>8.&nbsp;&nbsp;&nbsp;<a href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></li><li>9.&nbsp;&nbsp;&nbsp;<a href="#output.pdf">Transforming to PDF</a><ul><li>9.1&nbsp;&nbsp;&nbsp;<a href="#output.pdf.fop">Via XSL-FO</a><ul><li>9.1.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9.1.1">Extension feature matrix</a></li><li>9.1.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9.1.2">Example: producing output for Apache FOP</a></li></ul></li><li>9.2&nbsp;&nbsp;&nbsp;<a href="#output.pdf.html">Via X(HTML)</a></li></ul></li><li>10.&nbsp;&nbsp;&nbsp;<a href="#output.epub">Transforming to ePub</a></li><li>11.&nbsp;&nbsp;&nbsp;<a href="#extensions">Generic Extensions</a><ul><li>11.1&nbsp;&nbsp;&nbsp;<a href="#ext.element.abnf-char-sequence">&lt;abnf-char-sequence&gt; element</a></li><li>11.2&nbsp;&nbsp;&nbsp;<a href="#ext.element.anchor-alias">&lt;anchor-alias&gt; element</a></li><li>11.3&nbsp;&nbsp;&nbsp;<a href="#ext.element.bcp14">&lt;bcp14&gt; element</a></li><li>11.4&nbsp;&nbsp;&nbsp;<a href="#ext.element.bb">&lt;bb&gt; element</a></li><li>11.5&nbsp;&nbsp;&nbsp;<a href="#ext.element.bc">&lt;bc&gt; element</a></li><li>11.6&nbsp;&nbsp;&nbsp;<a href="#ext.element.blockquote">&lt;blockquote&gt; element</a></li><li>11.7&nbsp;&nbsp;&nbsp;<a href="#ext.element.boilerplate">&lt;boilerplate&gt; element</a></li><li>11.8&nbsp;&nbsp;&nbsp;<a href="#ext.element.bt">&lt;bt&gt; element</a></li><li>11.9&nbsp;&nbsp;&nbsp;<a href="#ext.element.dfn">&lt;dfn&gt; element</a></li><li>11.10&nbsp;&nbsp;&nbsp;<a href="#ext.element.h">&lt;h&gt; element</a></li><li>11.11&nbsp;&nbsp;&nbsp;<a href="#ext.element.highlight">&lt;highlight&gt; element</a></li><li>11.12&nbsp;&nbsp;&nbsp;<a href="#ext.element.length-of">&lt;length-of&gt; element</a></li><li>11.13&nbsp;&nbsp;&nbsp;<a href="#ext.element.link">&lt;link&gt; element</a></li><li>11.14&nbsp;&nbsp;&nbsp;<a href="#ext.element.lt">&lt;lt&gt; element</a></li><li>11.15&nbsp;&nbsp;&nbsp;<a href="#ext.element.note">&lt;note&gt; element</a></li><li>11.16&nbsp;&nbsp;&nbsp;<a href="#ext.element.parse-xml">&lt;parse-xml&gt; element</a></li><li>11.17&nbsp;&nbsp;&nbsp;<a href="#ext.element.prose">&lt;prose&gt; element</a></li><li>11.18&nbsp;&nbsp;&nbsp;<a href="#ext.element.q">&lt;q&gt; element</a></li><li>11.19&nbsp;&nbsp;&nbsp;<a href="#ext.element.ref">&lt;ref&gt; element</a></li><li>11.20&nbsp;&nbsp;&nbsp;<a href="#ext.element.source">&lt;source&gt; element</a></li><li>11.21&nbsp;&nbsp;&nbsp;<a href="#ext.element.sup">&lt;sup&gt; element</a></li><li>11.22&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.artwork">Extensions to Xml2rfc &lt;artwork&gt; element</a></li><li>11.23&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.iref">Extensions to Xml2rfc &lt;iref&gt; element</a></li><li>11.24&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.list">Extensions to Xml2rfc &lt;list&gt; element</a></li><li>11.25&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.rfc">Extensions to Xml2rfc &lt;rfc&gt; element</a></li><li>11.26&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.section">Extensions to Xml2rfc &lt;section&gt; element</a></li><li>11.27&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.xref">Extensions to Xml2rfc &lt;xref&gt; element</a></li></ul></li><li>12.&nbsp;&nbsp;&nbsp;<a href="#utilities">Utilities</a><ul><li>12.1&nbsp;&nbsp;&nbsp;<a href="#checking-references">Checking References</a></li><li>12.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.2">Generating Graphs from References</a></li><li>12.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.3">Producing reference entries for books</a></li><li>12.4&nbsp;&nbsp;&nbsp;<a href="#clean-for-dtd">Down-converting to RFC2629bis DTD</a></li><li>12.5&nbsp;&nbsp;&nbsp;<a href="#extract-artwork">Extracting artwork</a></li><li>12.6&nbsp;&nbsp;&nbsp;<a href="#grddl">GRRDL</a></li></ul></li><li>13.&nbsp;&nbsp;&nbsp;<a href="#rfc.references">Informative References</a></li><li><a href="#rfc.authors">Author's Address</a></li><li>A.&nbsp;&nbsp;&nbsp;<a href="#grammar">RELAX NG Compact Schema</a></li><li>B.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.B">Implementation Notes</a><ul><li>B.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.B.1">Recognized type attributes for &lt;artwork&gt; element</a></li></ul></li><li>C.&nbsp;&nbsp;&nbsp;<a href="#examples">Examples</a><ul><li>C.1&nbsp;&nbsp;&nbsp;<a href="#examples.internalsubset">Using the 'Internal Subset'</a></li><li>C.2&nbsp;&nbsp;&nbsp;<a href="#examples.customizing">Customization</a></li></ul></li><li>D.&nbsp;&nbsp;&nbsp;<a href="#boilerplate">Producing the IETF 'Boilerplate'</a><ul><li>D.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr">The /rfc/@ipr Attribute</a><ul><li>D.1.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-current">Current Values: '*trust200902'</a><ul><li>D.1.1.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-trust200902">trust200902</a></li><li>D.1.1.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></li><li>D.1.1.3&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></li><li>D.1.1.4&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></li></ul></li><li>D.1.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-historic">Historic Values</a><ul><li>D.1.2.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></li><li>D.1.2.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-3978">Historic Values: '*3978'</a></li><li>D.1.2.3&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-3667">Historic Values: '*3667'</a></li><li>D.1.2.4&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-2026">Historic Values: '*2026'</a></li></ul></li></ul></li><li>D.2&nbsp;&nbsp;&nbsp;<a href="#attribute-category">The /rfc/@category Attribute</a></li><li>D.3&nbsp;&nbsp;&nbsp;<a href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></li><li>D.4&nbsp;&nbsp;&nbsp;<a href="#attribute-consensus">The /rfc/@consensus Attribute</a></li><li>D.5&nbsp;&nbsp;&nbsp;<a href="#attribute-number">The /rfc/@number Attribute</a></li><li>D.6&nbsp;&nbsp;&nbsp;<a href="#attribute-docname">The /rfc/@docName Attribute</a></li><li>D.7&nbsp;&nbsp;&nbsp;<a href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></li><li>D.8&nbsp;&nbsp;&nbsp;<a href="#attribute-updates">The /rfc/@updates Attribute</a></li></ul></li><li>E.&nbsp;&nbsp;&nbsp;<a href="#license">License</a></li><li>F.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F">Change Logs</a><ul><li>F.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.1">Package</a></li><li>F.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.2">amazon-asin.xslt</a></li><li>F.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.3">check-references.xslt</a></li><li>F.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.4">gen-reference-graph.xslt</a></li><li>F.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.5">rfc2629.xslt</a></li><li>F.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.6">rfc2629toFO.xslt</a></li><li>F.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.7">xsl11toAn.xslt</a></li><li>F.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.8">xsl11toFop.xslt</a></li><li>F.9&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.9">xsl11toXep.xslt</a></li></ul></li><li><a href="#rfc.index">Index</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a>&nbsp;Introduction</h1><p id="rfc.section.1.p.1">This document describes a set of XSLT transformations that can be used to transform RFC2629-compliant XML (see <a href="#RFC2629" id="rfc.xref.RFC2629.1"><cite title="Writing I-Ds and RFCs using XML">[RFC2629]</cite></a>) to various output formats, such as HTML and PDF. The main topics are </p><ul><li>compliance to the xml2rfc XML element set (<a href="#supported.elements" title="Supported RFC2629 elements">Section&nbsp;2</a>),</li><li>support for xml2rfc processing instructions (<a href="#processing.instructions" title="Processing Instructions">Section&nbsp;3</a>),</li><li>the names of anchor elements generated in HTML and PDF output (<a href="#anchors" title="Anchors">Section&nbsp;4</a>),</li><li>various XSLT engines that can be used (<a href="#xslt.engines" title="Supported XSLT engines">Section&nbsp;5</a>),</li><li>outputting HTML (<a href="#output.html" title="Transforming to HTML">Section&nbsp;6</a>) and XHTML (<a href="#output.xhtml" title="Transforming to XHTML">Section&nbsp;7</a>),</li><li>outputting CHM (Compiled Microsoft Help, <a href="#output.chm" title="Transforming to CHM (Microsoft Compiled Help)">Section&nbsp;8</a>),</li><li>outputting PDF (<a href="#output.pdf" title="Transforming to PDF">Section&nbsp;9</a>),</li><li>extensions to the xml2rfc vocabulary (<a href="#extensions" title="Generic Extensions">Section&nbsp;11</a>).</li><li>various utilities (<a href="#utilities" title="Utilities">Section&nbsp;12</a>).</li></ul><p id="rfc.section.1.p.2">The full distribution is available at &lt;<a href="http://greenbytes.de/tech/webdav/rfc2629xslt.zip">http://greenbytes.de/tech/webdav/rfc2629xslt.zip</a>&gt;.</p><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a>&nbsp;<a id="supported.elements" href="#supported.elements">Supported RFC2629 elements</a></h1><p id="rfc.section.2.p.1"> <samp>rfc2629.xslt</samp> supports both all RFC2629 grammar elements and the extensions implemented in xml2rfc 1.36.</p><h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a>&nbsp;Extension elements</h2><p id="rfc.section.2.1.p.1"> <samp>rfc2629.xslt</samp> supports two kind of extension elements, using different XML namespaces.</p><p id="rfc.section.2.1.p.2">The first set contains (hopefully) generally useful extensions, see <a href="#extensions" title="Generic Extensions">Section&nbsp;11</a>.</p><p id="rfc.section.2.1.p.3">The second set is used for change and issue tracking and currently is not documented here. Please email the author in case you're interested in using these extensions.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a>&nbsp;<a id="processing.instructions" href="#processing.instructions">Processing Instructions</a></h1><p id="rfc.section.3.p.1">All PIs can be set as XSLT parameter as well, overriding any value that is found in the source file to be transformed.</p><div id="rfc.figure.u.1"></div> <p>Using processing instructions:</p>  <pre class="text">&lt;?rfc toc="yes"?&gt;
     385</style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Introduction" href="#rfc.section.1"><link rel="Chapter" title="2 Supported RFC2629 elements" href="#rfc.section.2"><link rel="Chapter" title="3 Processing Instructions" href="#rfc.section.3"><link rel="Chapter" title="4 Anchors" href="#rfc.section.4"><link rel="Chapter" title="5 Supported XSLT engines" href="#rfc.section.5"><link rel="Chapter" title="6 Transforming to HTML" href="#rfc.section.6"><link rel="Chapter" title="7 Transforming to XHTML" href="#rfc.section.7"><link rel="Chapter" title="8 Transforming to CHM (Microsoft Compiled Help)" href="#rfc.section.8"><link rel="Chapter" title="9 Transforming to PDF" href="#rfc.section.9"><link rel="Chapter" title="10 Transforming to ePub" href="#rfc.section.10"><link rel="Chapter" title="11 Generic Extensions" href="#rfc.section.11"><link rel="Chapter" title="12 Utilities" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 Informative References"><link rel="Appendix" title="A RELAX NG Compact Schema" href="#rfc.section.A"><link rel="Appendix" title="B Implementation Notes" href="#rfc.section.B"><link rel="Appendix" title="C Examples" href="#rfc.section.C"><link rel="Appendix" title="D Producing the IETF 'Boilerplate'" href="#rfc.section.D"><link rel="Appendix" title="E License" href="#rfc.section.E"><link rel="Appendix" title="F Change Logs" href="#rfc.section.F"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.550, 2011-05-30 14:02:12, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, xml2rfc, XSLT, hCard, XSL-FO, PDF, GRDDL, epub, Dublin Core"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 through XSLT</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right">May 2011</td></tr></tbody></table><p class="title">Transforming RFC2629-formatted XML through XSLT</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1">Introduction</a></li><li>2.&nbsp;&nbsp;&nbsp;<a href="#supported.elements">Supported RFC2629 elements</a><ul><li>2.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.2.1">Extension elements</a></li></ul></li><li>3.&nbsp;&nbsp;&nbsp;<a href="#processing.instructions">Processing Instructions</a><ul><li>3.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.1">Supported xml2rfc-compatible PIs</a></li><li>3.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.2">Unsupported xml2rfc-compatible PIs</a></li><li>3.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.3">Extension PIs</a></li></ul></li><li>4.&nbsp;&nbsp;&nbsp;<a href="#anchors">Anchors</a></li><li>5.&nbsp;&nbsp;&nbsp;<a href="#xslt.engines">Supported XSLT engines</a><ul><li>5.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.1">Standalone Engines</a></li><li>5.2&nbsp;&nbsp;&nbsp;<a href="#xslt.engines.browser">In-Browser Engines</a></li></ul></li><li>6.&nbsp;&nbsp;&nbsp;<a href="#output.html">Transforming to HTML</a><ul><li>6.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6.1">HTML compliance</a></li><li>6.2&nbsp;&nbsp;&nbsp;<a href="#html.link">Standard HTML LINK elements</a></li><li>6.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6.3">Standard HTML metadata</a></li><li>6.4&nbsp;&nbsp;&nbsp;<a href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></li><li>6.5&nbsp;&nbsp;&nbsp;<a href="#hcard">Experimental hCard support</a></li></ul></li><li>7.&nbsp;&nbsp;&nbsp;<a href="#output.xhtml">Transforming to XHTML</a></li><li>8.&nbsp;&nbsp;&nbsp;<a href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></li><li>9.&nbsp;&nbsp;&nbsp;<a href="#output.pdf">Transforming to PDF</a><ul><li>9.1&nbsp;&nbsp;&nbsp;<a href="#output.pdf.fop">Via XSL-FO</a><ul><li>9.1.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9.1.1">Extension feature matrix</a></li><li>9.1.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9.1.2">Example: producing output for Apache FOP</a></li></ul></li><li>9.2&nbsp;&nbsp;&nbsp;<a href="#output.pdf.html">Via X(HTML)</a></li></ul></li><li>10.&nbsp;&nbsp;&nbsp;<a href="#output.epub">Transforming to ePub</a></li><li>11.&nbsp;&nbsp;&nbsp;<a href="#extensions">Generic Extensions</a><ul><li>11.1&nbsp;&nbsp;&nbsp;<a href="#ext.element.abnf-char-sequence">&lt;abnf-char-sequence&gt; element</a></li><li>11.2&nbsp;&nbsp;&nbsp;<a href="#ext.element.anchor-alias">&lt;anchor-alias&gt; element</a></li><li>11.3&nbsp;&nbsp;&nbsp;<a href="#ext.element.bcp14">&lt;bcp14&gt; element</a></li><li>11.4&nbsp;&nbsp;&nbsp;<a href="#ext.element.bb">&lt;bb&gt; element</a></li><li>11.5&nbsp;&nbsp;&nbsp;<a href="#ext.element.bc">&lt;bc&gt; element</a></li><li>11.6&nbsp;&nbsp;&nbsp;<a href="#ext.element.blockquote">&lt;blockquote&gt; element</a></li><li>11.7&nbsp;&nbsp;&nbsp;<a href="#ext.element.boilerplate">&lt;boilerplate&gt; element</a></li><li>11.8&nbsp;&nbsp;&nbsp;<a href="#ext.element.bt">&lt;bt&gt; element</a></li><li>11.9&nbsp;&nbsp;&nbsp;<a href="#ext.element.dfn">&lt;dfn&gt; element</a></li><li>11.10&nbsp;&nbsp;&nbsp;<a href="#ext.element.h">&lt;h&gt; element</a></li><li>11.11&nbsp;&nbsp;&nbsp;<a href="#ext.element.highlight">&lt;highlight&gt; element</a></li><li>11.12&nbsp;&nbsp;&nbsp;<a href="#ext.element.length-of">&lt;length-of&gt; element</a></li><li>11.13&nbsp;&nbsp;&nbsp;<a href="#ext.element.link">&lt;link&gt; element</a></li><li>11.14&nbsp;&nbsp;&nbsp;<a href="#ext.element.lt">&lt;lt&gt; element</a></li><li>11.15&nbsp;&nbsp;&nbsp;<a href="#ext.element.note">&lt;note&gt; element</a></li><li>11.16&nbsp;&nbsp;&nbsp;<a href="#ext.element.parse-xml">&lt;parse-xml&gt; element</a></li><li>11.17&nbsp;&nbsp;&nbsp;<a href="#ext.element.prose">&lt;prose&gt; element</a></li><li>11.18&nbsp;&nbsp;&nbsp;<a href="#ext.element.q">&lt;q&gt; element</a></li><li>11.19&nbsp;&nbsp;&nbsp;<a href="#ext.element.ref">&lt;ref&gt; element</a></li><li>11.20&nbsp;&nbsp;&nbsp;<a href="#ext.element.source">&lt;source&gt; element</a></li><li>11.21&nbsp;&nbsp;&nbsp;<a href="#ext.element.sup">&lt;sup&gt; element</a></li><li>11.22&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.artwork">Extensions to Xml2rfc &lt;artwork&gt; element</a></li><li>11.23&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.iref">Extensions to Xml2rfc &lt;iref&gt; element</a></li><li>11.24&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.list">Extensions to Xml2rfc &lt;list&gt; element</a></li><li>11.25&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.rfc">Extensions to Xml2rfc &lt;rfc&gt; element</a></li><li>11.26&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.section">Extensions to Xml2rfc &lt;section&gt; element</a></li><li>11.27&nbsp;&nbsp;&nbsp;<a href="#ext-rfc2629.xref">Extensions to Xml2rfc &lt;xref&gt; element</a></li></ul></li><li>12.&nbsp;&nbsp;&nbsp;<a href="#utilities">Utilities</a><ul><li>12.1&nbsp;&nbsp;&nbsp;<a href="#checking-references">Checking References</a></li><li>12.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.2">Generating Graphs from References</a></li><li>12.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.3">Producing reference entries for books</a></li><li>12.4&nbsp;&nbsp;&nbsp;<a href="#clean-for-dtd">Down-converting to RFC2629bis DTD</a></li><li>12.5&nbsp;&nbsp;&nbsp;<a href="#extract-artwork">Extracting artwork</a></li><li>12.6&nbsp;&nbsp;&nbsp;<a href="#grddl">GRRDL</a></li></ul></li><li>13.&nbsp;&nbsp;&nbsp;<a href="#rfc.references">Informative References</a></li><li><a href="#rfc.authors">Author's Address</a></li><li>A.&nbsp;&nbsp;&nbsp;<a href="#grammar">RELAX NG Compact Schema</a></li><li>B.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.B">Implementation Notes</a><ul><li>B.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.B.1">Recognized type attributes for &lt;artwork&gt; element</a></li></ul></li><li>C.&nbsp;&nbsp;&nbsp;<a href="#examples">Examples</a><ul><li>C.1&nbsp;&nbsp;&nbsp;<a href="#examples.internalsubset">Using the 'Internal Subset'</a></li><li>C.2&nbsp;&nbsp;&nbsp;<a href="#examples.customizing">Customization</a></li></ul></li><li>D.&nbsp;&nbsp;&nbsp;<a href="#boilerplate">Producing the IETF 'Boilerplate'</a><ul><li>D.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr">The /rfc/@ipr Attribute</a><ul><li>D.1.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-current">Current Values: '*trust200902'</a><ul><li>D.1.1.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-trust200902">trust200902</a></li><li>D.1.1.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></li><li>D.1.1.3&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></li><li>D.1.1.4&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></li></ul></li><li>D.1.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-historic">Historic Values</a><ul><li>D.1.2.1&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></li><li>D.1.2.2&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-3978">Historic Values: '*3978'</a></li><li>D.1.2.3&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-3667">Historic Values: '*3667'</a></li><li>D.1.2.4&nbsp;&nbsp;&nbsp;<a href="#attribute-ipr-2026">Historic Values: '*2026'</a></li></ul></li></ul></li><li>D.2&nbsp;&nbsp;&nbsp;<a href="#attribute-category">The /rfc/@category Attribute</a></li><li>D.3&nbsp;&nbsp;&nbsp;<a href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></li><li>D.4&nbsp;&nbsp;&nbsp;<a href="#attribute-consensus">The /rfc/@consensus Attribute</a></li><li>D.5&nbsp;&nbsp;&nbsp;<a href="#attribute-number">The /rfc/@number Attribute</a></li><li>D.6&nbsp;&nbsp;&nbsp;<a href="#attribute-docname">The /rfc/@docName Attribute</a></li><li>D.7&nbsp;&nbsp;&nbsp;<a href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></li><li>D.8&nbsp;&nbsp;&nbsp;<a href="#attribute-updates">The /rfc/@updates Attribute</a></li></ul></li><li>E.&nbsp;&nbsp;&nbsp;<a href="#license">License</a></li><li>F.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F">Change Logs</a><ul><li>F.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.1">Package</a></li><li>F.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.2">amazon-asin.xslt</a></li><li>F.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.3">check-references.xslt</a></li><li>F.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.4">gen-reference-graph.xslt</a></li><li>F.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.5">rfc2629.xslt</a></li><li>F.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.6">rfc2629toFO.xslt</a></li><li>F.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.7">xsl11toAn.xslt</a></li><li>F.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.8">xsl11toFop.xslt</a></li><li>F.9&nbsp;&nbsp;&nbsp;<a href="#rfc.section.F.9">xsl11toXep.xslt</a></li></ul></li><li><a href="#rfc.index">Index</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a>&nbsp;Introduction</h1><p id="rfc.section.1.p.1">This document describes a set of XSLT transformations that can be used to transform RFC2629-compliant XML (see <a href="#RFC2629" id="rfc.xref.RFC2629.1"><cite title="Writing I-Ds and RFCs using XML">[RFC2629]</cite></a>) to various output formats, such as HTML and PDF. The main topics are </p><ul><li>compliance to the xml2rfc XML element set (<a href="#supported.elements" title="Supported RFC2629 elements">Section&nbsp;2</a>),</li><li>support for xml2rfc processing instructions (<a href="#processing.instructions" title="Processing Instructions">Section&nbsp;3</a>),</li><li>the names of anchor elements generated in HTML and PDF output (<a href="#anchors" title="Anchors">Section&nbsp;4</a>),</li><li>various XSLT engines that can be used (<a href="#xslt.engines" title="Supported XSLT engines">Section&nbsp;5</a>),</li><li>outputting HTML (<a href="#output.html" title="Transforming to HTML">Section&nbsp;6</a>) and XHTML (<a href="#output.xhtml" title="Transforming to XHTML">Section&nbsp;7</a>),</li><li>outputting CHM (Compiled Microsoft Help, <a href="#output.chm" title="Transforming to CHM (Microsoft Compiled Help)">Section&nbsp;8</a>),</li><li>outputting PDF (<a href="#output.pdf" title="Transforming to PDF">Section&nbsp;9</a>),</li><li>extensions to the xml2rfc vocabulary (<a href="#extensions" title="Generic Extensions">Section&nbsp;11</a>).</li><li>various utilities (<a href="#utilities" title="Utilities">Section&nbsp;12</a>).</li></ul><p id="rfc.section.1.p.2">The full distribution is available at &lt;<a href="http://greenbytes.de/tech/webdav/rfc2629xslt.zip">http://greenbytes.de/tech/webdav/rfc2629xslt.zip</a>&gt;.</p><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a>&nbsp;<a id="supported.elements" href="#supported.elements">Supported RFC2629 elements</a></h1><p id="rfc.section.2.p.1"> <samp>rfc2629.xslt</samp> supports both all RFC2629 grammar elements and the extensions implemented in xml2rfc 1.36.</p><h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a>&nbsp;Extension elements</h2><p id="rfc.section.2.1.p.1"> <samp>rfc2629.xslt</samp> supports two kind of extension elements, using different XML namespaces.</p><p id="rfc.section.2.1.p.2">The first set contains (hopefully) generally useful extensions, see <a href="#extensions" title="Generic Extensions">Section&nbsp;11</a>.</p><p id="rfc.section.2.1.p.3">The second set is used for change and issue tracking and currently is not documented here. Please email the author in case you're interested in using these extensions.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a>&nbsp;<a id="processing.instructions" href="#processing.instructions">Processing Instructions</a></h1><p id="rfc.section.3.p.1">All PIs can be set as XSLT parameter as well, overriding any value that is found in the source file to be transformed.</p><div id="rfc.figure.u.1"></div> <p>Using processing instructions:</p>  <pre class="text">&lt;?rfc toc="yes"?&gt;
    386386&lt;?rfc-ext support-rfc2731="no"?&gt;
    387387</pre> <div id="rfc.figure.u.2"></div> <p>Using XSLT parameters (Saxon):</p>  <pre class="text">java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \
     
    390390   --param xml2rfc-ext-support-rfc2731 '"no"' \
    391391   rfc2629.xslt source.xml &gt; result.html
    392 </pre>  <p>(note the required quoting of string parameters)<span id="rfc.iref.x.1"></span></p> <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;Supported xml2rfc-compatible PIs</h2><div id="rfc.table.u.1"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>comment</th></tr></thead><tbody><tr><td class="left">rfc</td><td class="left">background<div id="rfc.iref.b.1"></div><div id="rfc.iref.p.1"></div></td><td class="left">xml2rfc-background<div id="rfc.iref.x.2"></div>  <div id="rfc.iref.p.2"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">compact<div id="rfc.iref.c.1"></div><div id="rfc.iref.p.3"></div></td><td class="left">xml2rfc-compact<div id="rfc.iref.x.3"></div>  <div id="rfc.iref.p.4"></div></td><td class="left">"no"</td><td class="left">only applies to HTML output method when printing</td></tr><tr><td class="left">rfc</td><td class="left">comments<div id="rfc.iref.c.2"></div><div id="rfc.iref.p.5"></div></td><td class="left">xml2rfc-comments<div id="rfc.iref.x.4"></div>  <div id="rfc.iref.p.6"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">editing<div id="rfc.iref.e.1"></div><div id="rfc.iref.p.7"></div></td><td class="left">xml2rfc-editing<div id="rfc.iref.x.5"></div>  <div id="rfc.iref.p.8"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">footer<div id="rfc.iref.f.1"></div><div id="rfc.iref.p.9"></div></td><td class="left">xml2rfc-footer<div id="rfc.iref.x.6"></div>  <div id="rfc.iref.p.10"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">header<div id="rfc.iref.h.1"></div><div id="rfc.iref.p.11"></div></td><td class="left">xml2rfc-header<div id="rfc.iref.x.7"></div>  <div id="rfc.iref.p.12"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">inline<div id="rfc.iref.i.1"></div><div id="rfc.iref.p.13"></div></td><td class="left">xml2rfc-inline<div id="rfc.iref.x.8"></div>  <div id="rfc.iref.p.14"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">iprnotified<div id="rfc.iref.i.2"></div><div id="rfc.iref.p.15"></div></td><td class="left">xml2rfc-iprnotified<div id="rfc.iref.x.9"></div>  <div id="rfc.iref.p.16"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">linkmailto<div id="rfc.iref.l.1"></div><div id="rfc.iref.p.17"></div></td><td class="left">xml2rfc-linkmailto<div id="rfc.iref.x.10"></div>  <div id="rfc.iref.p.18"></div></td><td class="left">"yes"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">private<div id="rfc.iref.p.19"></div><div id="rfc.iref.p.20"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.11"></div>  <div id="rfc.iref.p.21"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">refparent<div id="rfc.iref.r.1"></div><div id="rfc.iref.p.22"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.12"></div>  <div id="rfc.iref.p.23"></div></td><td class="left">"References"</td><td class="left">Title for References sections when automatically inserted</td></tr><tr><td class="left">rfc</td><td class="left">rfcedstyle<div id="rfc.iref.r.2"></div><div id="rfc.iref.p.24"></div></td><td class="left">xml2rfc-rfcedstyle<div id="rfc.iref.x.13"></div>  <div id="rfc.iref.p.25"></div></td><td class="left">(not set)</td><td class="left">(limited support)</td></tr><tr><td class="left">rfc</td><td class="left">sortrefs<div id="rfc.iref.s.1"></div><div id="rfc.iref.p.26"></div></td><td class="left">xml2rfc-sortrefs<div id="rfc.iref.x.14"></div>  <div id="rfc.iref.p.27"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">symrefs<div id="rfc.iref.s.2"></div><div id="rfc.iref.p.28"></div></td><td class="left">xml2rfc-symrefs<div id="rfc.iref.x.15"></div>  <div id="rfc.iref.p.29"></div></td><td class="left">"yes"</td><td class="left">The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</td></tr><tr><td class="left">rfc</td><td class="left">toc<div id="rfc.iref.t.1"></div><div id="rfc.iref.p.30"></div></td><td class="left">xml2rfc-toc<div id="rfc.iref.x.16"></div>  <div id="rfc.iref.p.31"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocdepth<div id="rfc.iref.t.2"></div><div id="rfc.iref.p.32"></div></td><td class="left">xml2rfc-tocdepth<div id="rfc.iref.x.17"></div>  <div id="rfc.iref.p.33"></div></td><td class="left">99</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">topblock<div id="rfc.iref.t.3"></div><div id="rfc.iref.p.34"></div></td><td class="left">xml2rfc-topblock<div id="rfc.iref.x.18"></div>  <div id="rfc.iref.p.35"></div></td><td class="left">"yes"</td><td class="left"></td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;Unsupported xml2rfc-compatible PIs</h2><div id="rfc.table.u.2"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>comment</th></tr></thead><tbody><tr><td class="left">rfc</td><td class="left">include<div id="rfc.iref.i.3"></div><div id="rfc.iref.p.36"></div></td><td class="left">incompatible with XML/XSLT processing model, please use external entities instead</td></tr><tr><td class="left">rfc</td><td class="left">needLines<div id="rfc.iref.n.1"></div><div id="rfc.iref.p.37"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">slides<div id="rfc.iref.s.3"></div><div id="rfc.iref.p.38"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">strict<div id="rfc.iref.s.4"></div><div id="rfc.iref.p.39"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">subcompact<div id="rfc.iref.s.5"></div><div id="rfc.iref.p.40"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocindent<div id="rfc.iref.t.4"></div><div id="rfc.iref.p.41"></div></td><td class="left">(defaults to "yes")</td></tr><tr><td class="left">rfc</td><td class="left">tocompact<div id="rfc.iref.t.5"></div><div id="rfc.iref.p.42"></div></td><td class="left"></td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;Extension PIs</h2><div id="rfc.table.u.3"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>description</th></tr></thead><tbody><tr><td class="left">rfc-ext</td><td class="left">allow-markup-in-artwork<div id="rfc.iref.a.1"></div><div id="rfc.iref.p.43"></div></td><td class="left">xml2rfc-allow-markup-in-artwork<div id="rfc.iref.x.19"></div>  <div id="rfc.iref.p.44"></div></td><td class="left">"no"</td><td class="left">Enables support for specific elements inside abstract elements (using this extension makes the document incompatible to the RFC2629bis DTD; see description of conversion XSLT in <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;12.4</a>).</td></tr><tr><td class="left">rfc-ext</td><td class="left">authors-section<div id="rfc.iref.a.2"></div><div id="rfc.iref.p.45"></div></td><td class="left">xml2rfc-ext-authors-section<div id="rfc.iref.x.20"></div>  <div id="rfc.iref.p.46"></div></td><td class="left"></td><td class="left">When "end", place the authors section at the end (just before the copyright statements). This seems to be the preferred order in the newest RFCs.</td></tr><tr><td class="left">rfc-ext</td><td class="left">duplex<div id="rfc.iref.d.1"></div><div id="rfc.iref.p.47"></div></td><td class="left">xml2rfc-ext-duplex<div id="rfc.iref.x.21"></div>  <div id="rfc.iref.p.48"></div></td><td class="left">no</td><td class="left">When set to "yes", format the PDF output for doublesided printing.</td></tr><tr><td class="left">rfc-ext</td><td class="left">include-references-in-index<div id="rfc.iref.i.4"></div><div id="rfc.iref.p.49"></div></td><td class="left">xml2rfc-ext-include-references-in-index<div id="rfc.iref.x.22"></div>  <div id="rfc.iref.p.50"></div></td><td class="left"></td><td class="left">When set to "yes", index entries are generated for all references.</td></tr><tr><td class="left">rfc-ext</td><td class="left">justification<div id="rfc.iref.j.1"></div><div id="rfc.iref.p.51"></div></td><td class="left">xml2rfc-ext-justification<div id="rfc.iref.x.23"></div>  <div id="rfc.iref.p.52"></div></td><td class="left">"never"</td><td class="left">"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</td></tr><tr><td class="left">rfc-ext</td><td class="left">parse-xml-in-artwork<div id="rfc.iref.p.53"></div><div id="rfc.iref.p.54"></div></td><td class="left">xml2rfc-parse-xml-in-artwork<div id="rfc.iref.x.24"></div>  <div id="rfc.iref.p.55"></div></td><td class="left">"no"</td><td class="left">May be used to enable parsing of XML content in figures (MSXML only).</td></tr><tr><td class="left">rfc-ext</td><td class="left">support-rfc2731<div id="rfc.iref.s.6"></div><div id="rfc.iref.p.56"></div></td><td class="left">xml2rfc-ext-support-rfc2731<div id="rfc.iref.x.25"></div>  <div id="rfc.iref.p.57"></div></td><td class="left">"yes"</td><td class="left">Decides whether the HTML transformation should generate META tags according <a href="#rfc2731.properties" title="Dublin Core (RFC2731) metadata">Section&nbsp;6.4</a>.</td></tr><tr><td class="left">rfc-ext</td><td class="left">sec-no-trailing-dots<div id="rfc.iref.s.7"></div><div id="rfc.iref.p.58"></div></td><td class="left">xml2rfc-ext-sec-no-trailing-dots<div id="rfc.iref.x.26"></div>  <div id="rfc.iref.p.59"></div></td><td class="left"></td><td class="left">When set to "yes", add trailing dots to section numbers. This seems to be the preferred format in the newest RFCs.</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;<a id="anchors" href="#anchors">Anchors</a></h1><p id="rfc.section.4.p.1">The transformation automatically generates anchors that are supposed to be stable and predictable and that can be used to identify specific parts of the document. Anchors are generated both in HTML and XSL-FO content (but the latter will only be used for PDF output when the XSL-FO engine supports producing PDF anchors).</p><div id="rfc.table.u.4"><p>The following anchors get auto-generated:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>Anchor name</th><th>Description</th></tr></thead><tbody><tr><td class="left">rfc.abstract <div id="rfc.iref.r.3"></div><div id="rfc.iref.a.3"></div></td><td class="left">Abstract</td></tr><tr><td class="left">rfc.authors <div id="rfc.iref.r.4"></div><div id="rfc.iref.a.4"></div></td><td class="left">Authors section</td></tr><tr><td class="left">rfc.copyright <div id="rfc.iref.r.5"></div><div id="rfc.iref.a.5"></div></td><td class="left">Copyright section</td></tr><tr><td class="left">rfc.copyrightnotice <div id="rfc.iref.r.6"></div><div id="rfc.iref.a.6"></div></td><td class="left">Copyright notice</td></tr><tr><td class="left">rfc.figure.<em>n</em>  <div id="rfc.iref.r.7"></div><div id="rfc.iref.a.7"></div></td><td class="left">Figures (titled)</td></tr><tr><td class="left">rfc.figure.u.<em>n</em>  <div id="rfc.iref.r.8"></div><div id="rfc.iref.a.8"></div></td><td class="left">Figures (untitled)</td></tr><tr><td class="left">rfc.index <div id="rfc.iref.r.9"></div><div id="rfc.iref.a.9"></div></td><td class="left">Index</td></tr><tr><td class="left">rfc.ipr <div id="rfc.iref.r.10"></div><div id="rfc.iref.a.10"></div></td><td class="left">Intellectual Property</td></tr><tr><td class="left">rfc.iref.<em>n</em>  <div id="rfc.iref.r.11"></div><div id="rfc.iref.a.11"></div></td><td class="left">Internal references</td></tr><tr><td class="left">rfc.note.<em>n</em>  <div id="rfc.iref.r.12"></div><div id="rfc.iref.a.12"></div></td><td class="left">Notes (from front section)</td></tr><tr><td class="left">rfc.references <div id="rfc.iref.r.13"></div><div id="rfc.iref.a.13"></div></td><td class="left">References</td></tr><tr><td class="left">rfc.references.<em>n</em>  <div id="rfc.iref.r.14"></div><div id="rfc.iref.a.14"></div></td><td class="left">Additional references</td></tr><tr><td class="left">rfc.section.<em>n</em>  <div id="rfc.iref.r.15"></div><div id="rfc.iref.a.15"></div></td><td class="left">Section <em>n</em></td></tr><tr><td class="left">rfc.section.<em>n</em>.p.<em>m</em>  <div id="rfc.iref.r.16"></div><div id="rfc.iref.a.16"></div></td><td class="left">Section <em>n</em>, paragraph <em>m</em></td></tr><tr><td class="left">rfc.status <div id="rfc.iref.r.17"></div><div id="rfc.iref.a.17"></div></td><td class="left">Status of memo</td></tr><tr><td class="left">rfc.table.<em>n</em>  <div id="rfc.iref.r.18"></div><div id="rfc.iref.a.18"></div></td><td class="left">Tables (titled)</td></tr><tr><td class="left">rfc.table.u.<em>n</em>  <div id="rfc.iref.r.19"></div><div id="rfc.iref.a.19"></div></td><td class="left">Tables (untitled)</td></tr><tr><td class="left">rfc.toc <div id="rfc.iref.r.20"></div><div id="rfc.iref.a.20"></div></td><td class="left">Table of contents</td></tr><tr><td class="left">rfc.xref.<em>name</em>.<em>n</em>  <div id="rfc.iref.r.21"></div><div id="rfc.iref.a.21"></div></td><td class="left">References to reference <em>n</em> to <em>name</em></td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.5" class="np"><a href="#rfc.section.5">5.</a>&nbsp;<a id="xslt.engines" href="#xslt.engines">Supported XSLT engines</a></h1><p id="rfc.section.5.p.1">The transformation requires a non-standard extension function (see <a href="http://www.exslt.org/exsl/functions/node-set/exsl.node-set.html">exsl:node-set</a>) which is however widely available. XSLT processors that do not support this extension (or a functional equivalent) currently are not supported.</p><h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;Standalone Engines</h2><p id="rfc.section.5.1.p.1">The following XSLT engines are believed to work well: </p><ul><li>Windows: <span id="rfc.iref.m.1"></span><span id="rfc.iref.m.2"></span>MSXML3 and MSXML4 (&lt;<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>&gt;; command line processor "msxsl" is available from <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41">Microsoft Download Center</a>)</li><li>Java: <span id="rfc.iref.s.8"></span>Saxon (&lt;<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>&gt;)</li><li>Java: <span id="rfc.iref.x.27"></span>Xalan (&lt;<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>&gt;)</li><li>C/C++: <span id="rfc.iref.x.28"></span>xsltproc (libxslt) (&lt;<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>&gt;, make sure that you have a current version)</li></ul><h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a id="xslt.engines.browser" href="#xslt.engines.browser">In-Browser Engines</a></h2><p id="rfc.section.5.2.p.1">The following browsers seem to work fine: </p><ul><li><p><span id="rfc.iref.i.5"></span>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</p></li><li><p><span id="rfc.iref.i.6"></span><span id="rfc.iref.i.7"></span><span id="rfc.iref.i.8"></span>Internet Explorer 6 and newer</p></li><li><div id="firefox3"><p><span id="rfc.iref.m.3"></span><span id="rfc.iref.f.2"></span>Firefox 3.0 and newer</p></div><p> </p><ul><li>Be aware that XSLT execution can be suppressed using <span id="rfc.iref.n.2"></span><a href="https://addons.mozilla.org/de/firefox/addon/722">NoScript</a></li><li>Firefox does not load external DTDs nor external entities, see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</a>, thus entities like &amp;nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix&nbsp;C.1</a>)</li><li>There seems to be a new problem in Firefox 4 where it occasionally does the initial rendering with the wrong width (people who can reproduce this problem please comment on &lt;<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=640390">https://bugzilla.mozilla.org/show_bug.cgi?id=640390</a>&gt;.</li></ul></li><li><p><span id="rfc.iref.s.9"></span><span id="rfc.iref.s.10"></span>Safari 3 (starting with version 3.0.4)</p></li><li><p><span id="rfc.iref.g.1"></span>Google Chrome</p></li><li><p><span id="rfc.iref.o.1"></span>Opera (starting with version 10)</p></li></ul><p id="rfc.section.5.2.p.2">The following browsers are known not to work properly: </p><ul><li><div id="firefox12"><p><span id="rfc.iref.m.4"></span><span id="rfc.iref.f.3"></span>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</a>)</p></div></li><li><div id="opera"><p><span id="rfc.iref.o.2"></span>Opera 9.21: execution fails, potentially to a somewhat complex XPath expression (reported to Opera as bug 245725).</p></div></li><li><p>Opera 9.5 and 9.6: transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</p></li><li><div id="safari"><p><span id="rfc.iref.s.11"></span>Safari 2.* supports client-side XSLT as of MacOS X 10.4, but misses required extension functions. A problem with stylesheets producing non-ASCII output (such as NBSP characters) has been fixed as of OSX 10.4.4. Both problems have been reported through Apple's bug tracking system, see &lt;<a href="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html">http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html</a>&gt; and &lt;<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;.</p></div></li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a>&nbsp;<a id="output.html" href="#output.html">Transforming to HTML</a></h1><p id="rfc.section.6.p.1">Transformation to HTML can be done inside the browser if it supports XSLT. To enable this, add the following processing instruction to the start of the source file:</p><div id="rfc.iref.x.29"></div><div id="rfc.figure.u.4"></div><pre class="text">  &lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?&gt;
    393 </pre><p id="rfc.section.6.p.3">(and ensure that <samp>rfc2629.xslt</samp> is present).</p><h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a>&nbsp;HTML compliance</h2><p id="rfc.section.6.1.p.1">The transformation result is supposed to conform to the HTML 4.01 strict DTD <a href="#HTML" id="rfc.xref.HTML.1"><cite title="HTML 4.01 Specification">[HTML]</cite></a>. This can be checked using the W3C's online validator at &lt;<a href="http://validator.w3.org">http://validator.w3.org</a>&gt;<span id="rfc.iref.h.2"></span>.</p><h2 id="rfc.section.6.2"><a href="#rfc.section.6.2">6.2</a>&nbsp;<a id="html.link" href="#html.link">Standard HTML LINK elements</a></h2><p id="rfc.section.6.2.p.1">LINK elements exist since HTML 2.0. They can be used to embed content-independant links inside the document. Unfortunately, only few user agents support this element. Firefox users may want to check the <a href="https://addons.mozilla.org/firefox/2933/">Link Widgets</a> extension.</p><div id="rfc.table.u.5"><p>The following LINK elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>LINK type</th><th>description</th></tr></thead><tbody><tr><td class="left">alternate<div id="rfc.iref.a.22"></div><div id="rfc.iref.h.3"></div></td><td class="left">for RFCs, a link to the authorative ASCII version on the IETF web site</td></tr><tr><td class="left">appendic<div id="rfc.iref.a.23"></div><div id="rfc.iref.h.4"></div></td><td class="left">pointer to all top-level appendics</td></tr><tr><td class="left">author<div id="rfc.iref.a.24"></div><div id="rfc.iref.h.5"></div></td><td class="left">pointer to "authors" section</td></tr><tr><td class="left">chapter<div id="rfc.iref.c.3"></div><div id="rfc.iref.h.6"></div></td><td class="left">pointer to all top-level sections</td></tr><tr><td class="left">contents<div id="rfc.iref.c.4"></div><div id="rfc.iref.h.7"></div></td><td class="left">pointer to table of contents</td></tr><tr><td class="left">copyright<div id="rfc.iref.c.5"></div><div id="rfc.iref.h.8"></div></td><td class="left">pointer to copyright statement</td></tr><tr><td class="left">index<div id="rfc.iref.i.9"></div><div id="rfc.iref.h.9"></div></td><td class="left">pointer to index</td></tr></tbody></table></div><div id="rfc.figure.u.5"></div> <p>The figure below shows how Mozilla Firefox 1.0 displays the Site Navigation Bar for rfc2396.xml.</p>  <p><img src="rfc2629xslt-fig1.png" alt="&#xA;(LINK elements displayed in Mozilla Firefox for RFC2396.xml)&#xA;" width="509" height="235"></p> <h2 id="rfc.section.6.3"><a href="#rfc.section.6.3">6.3</a>&nbsp;Standard HTML metadata</h2><div id="rfc.table.u.6"><p>The following standard HTML META elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td class="left">generator<div id="rfc.iref.g.2"></div><div id="rfc.iref.h.10"></div></td><td class="left">from XSLT engine version and stylesheet version</td></tr><tr><td class="left">keywords<div id="rfc.iref.k.1"></div><div id="rfc.iref.h.11"></div></td><td class="left">from keyword elements in front section</td></tr></tbody></table></div><h2 id="rfc.section.6.4"><a href="#rfc.section.6.4">6.4</a>&nbsp;<a id="rfc2731.properties" href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></h2><p id="rfc.section.6.4.p.1">Unless turned off using the "rfc-ext support-rfc2731" processing instruction, the transformation will generate metadata according to <a href="#RFC2731" id="rfc.xref.RFC2731.1"><cite title="Encoding Dublin Core Metadata in HTML">[RFC2731]</cite></a> and <a href="#DC-HTML" id="rfc.xref.DC-HTML.1"><cite title="Expressing Dublin Core metadata using HTML/XHTML meta and link elements">[DC-HTML]</cite></a>.</p><div id="rfc.table.u.7"><p>The following DCMI properties are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td class="left">DC.Creator<div id="rfc.iref.c.6"></div><div id="rfc.iref.d.2"></div></td><td class="left">from author information in front section</td></tr><tr><td class="left">DC.Date.Issued<div id="rfc.iref.d.3"></div><div id="rfc.iref.d.4"></div></td><td class="left">from date information in front section</td></tr><tr><td class="left">DC.Description.Abstract<div id="rfc.iref.d.5"></div><div id="rfc.iref.d.6"></div></td><td class="left">from abstract</td></tr><tr><td class="left">DC.Identifier<div id="rfc.iref.i.10"></div><div id="rfc.iref.d.7"></div></td><td class="left">document URN <a href="#RFC2648" id="rfc.xref.RFC2648.1"><cite title="A URN Namespace for IETF Documents">[RFC2648]</cite></a> from "docName" attribute</td></tr><tr><td class="left">DC.isPartOf<div id="rfc.iref.i.11"></div><div id="rfc.iref.d.8"></div></td><td class="left">RFC ISSN (for RFCs)</td></tr><tr><td class="left">DC.Relation.Replaces<div id="rfc.iref.r.22"></div><div id="rfc.iref.d.9"></div></td><td class="left">from "obsoletes" attribute</td></tr></tbody></table></div><h2 id="rfc.section.6.5"><a href="#rfc.section.6.5">6.5</a>&nbsp;<a id="hcard" href="#hcard">Experimental hCard support</a></h2><p id="rfc.section.6.5.p.1">The generated author information is formatted in <a href="http://microformats.org/wiki/hcard">hCard</a> format.</p><hr class="noprint"><h1 id="rfc.section.7" class="np"><a href="#rfc.section.7">7.</a>&nbsp;<a id="output.xhtml" href="#output.xhtml">Transforming to XHTML</a></h1><p id="rfc.section.7.p.1">Transforming to XHTML requires slightly different XSLT output options and is implemented by the derived transformation script <samp>rfc2629toXHTML.xslt</samp>.</p><ul class="empty"><li> <b>Note:</b> Microsoft Internet Explorer does <em>not</em> support XHTML. Therefore it usually makes more sense to generate plain old HTML.</li></ul><hr class="noprint"><h1 id="rfc.section.8" class="np"><a href="#rfc.section.8">8.</a>&nbsp;<a id="output.chm" href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></h1><p id="rfc.section.8.p.1"> <span id="rfc.iref.c.7"></span>  <span id="rfc.iref.m.5"></span> To generate a CHM file using Microsoft's HTML Help Compiler (hhc), three files are required in addition to the HTML file. </p><ol><li>hhc - table of contents file (HTML)</li><li>hhk - index file (HTML)</li><li>hhp - project file (plain text)</li></ol><p id="rfc.section.8.p.2">The three files are generated with three specific transformations, each requiring the additional XSLT parameter "basename" to specify the filename prefix.</p><div id="rfc.figure.u.6"></div> <p>Example:</p>  <pre class="text">saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616  &gt; rfc2616.hhp
     392</pre>  <p>(note the required quoting of string parameters)<span id="rfc.iref.x.1"></span></p> <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;Supported xml2rfc-compatible PIs</h2><div id="rfc.table.u.1"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>comment</th></tr></thead><tbody><tr><td class="left">rfc</td><td class="left">background<div id="rfc.iref.b.1"></div><div id="rfc.iref.p.1"></div></td><td class="left">xml2rfc-background<div id="rfc.iref.x.2"></div>  <div id="rfc.iref.p.2"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">compact<div id="rfc.iref.c.1"></div><div id="rfc.iref.p.3"></div></td><td class="left">xml2rfc-compact<div id="rfc.iref.x.3"></div>  <div id="rfc.iref.p.4"></div></td><td class="left">"no"</td><td class="left">only applies to HTML output method when printing</td></tr><tr><td class="left">rfc</td><td class="left">comments<div id="rfc.iref.c.2"></div><div id="rfc.iref.p.5"></div></td><td class="left">xml2rfc-comments<div id="rfc.iref.x.4"></div>  <div id="rfc.iref.p.6"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">editing<div id="rfc.iref.e.1"></div><div id="rfc.iref.p.7"></div></td><td class="left">xml2rfc-editing<div id="rfc.iref.x.5"></div>  <div id="rfc.iref.p.8"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">footer<div id="rfc.iref.f.1"></div><div id="rfc.iref.p.9"></div></td><td class="left">xml2rfc-footer<div id="rfc.iref.x.6"></div>  <div id="rfc.iref.p.10"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">header<div id="rfc.iref.h.1"></div><div id="rfc.iref.p.11"></div></td><td class="left">xml2rfc-header<div id="rfc.iref.x.7"></div>  <div id="rfc.iref.p.12"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">inline<div id="rfc.iref.i.1"></div><div id="rfc.iref.p.13"></div></td><td class="left">xml2rfc-inline<div id="rfc.iref.x.8"></div>  <div id="rfc.iref.p.14"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">iprnotified<div id="rfc.iref.i.2"></div><div id="rfc.iref.p.15"></div></td><td class="left">xml2rfc-iprnotified<div id="rfc.iref.x.9"></div>  <div id="rfc.iref.p.16"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">linkmailto<div id="rfc.iref.l.1"></div><div id="rfc.iref.p.17"></div></td><td class="left">xml2rfc-linkmailto<div id="rfc.iref.x.10"></div>  <div id="rfc.iref.p.18"></div></td><td class="left">"yes"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">private<div id="rfc.iref.p.19"></div><div id="rfc.iref.p.20"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.11"></div>  <div id="rfc.iref.p.21"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">refparent<div id="rfc.iref.r.1"></div><div id="rfc.iref.p.22"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.12"></div>  <div id="rfc.iref.p.23"></div></td><td class="left">"References"</td><td class="left">Title for References sections when automatically inserted</td></tr><tr><td class="left">rfc</td><td class="left">rfcedstyle<div id="rfc.iref.r.2"></div><div id="rfc.iref.p.24"></div></td><td class="left">xml2rfc-rfcedstyle<div id="rfc.iref.x.13"></div>  <div id="rfc.iref.p.25"></div></td><td class="left">(not set)</td><td class="left">(limited support)</td></tr><tr><td class="left">rfc</td><td class="left">sortrefs<div id="rfc.iref.s.1"></div><div id="rfc.iref.p.26"></div></td><td class="left">xml2rfc-sortrefs<div id="rfc.iref.x.14"></div>  <div id="rfc.iref.p.27"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">symrefs<div id="rfc.iref.s.2"></div><div id="rfc.iref.p.28"></div></td><td class="left">xml2rfc-symrefs<div id="rfc.iref.x.15"></div>  <div id="rfc.iref.p.29"></div></td><td class="left">"yes"</td><td class="left">The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</td></tr><tr><td class="left">rfc</td><td class="left">toc<div id="rfc.iref.t.1"></div><div id="rfc.iref.p.30"></div></td><td class="left">xml2rfc-toc<div id="rfc.iref.x.16"></div>  <div id="rfc.iref.p.31"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocdepth<div id="rfc.iref.t.2"></div><div id="rfc.iref.p.32"></div></td><td class="left">xml2rfc-tocdepth<div id="rfc.iref.x.17"></div>  <div id="rfc.iref.p.33"></div></td><td class="left">99</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">topblock<div id="rfc.iref.t.3"></div><div id="rfc.iref.p.34"></div></td><td class="left">xml2rfc-topblock<div id="rfc.iref.x.18"></div>  <div id="rfc.iref.p.35"></div></td><td class="left">"yes"</td><td class="left"></td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;Unsupported xml2rfc-compatible PIs</h2><div id="rfc.table.u.2"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>comment</th></tr></thead><tbody><tr><td class="left">rfc</td><td class="left">include<div id="rfc.iref.i.3"></div><div id="rfc.iref.p.36"></div></td><td class="left">incompatible with XML/XSLT processing model, please use external entities instead</td></tr><tr><td class="left">rfc</td><td class="left">needLines<div id="rfc.iref.n.1"></div><div id="rfc.iref.p.37"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">slides<div id="rfc.iref.s.3"></div><div id="rfc.iref.p.38"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">strict<div id="rfc.iref.s.4"></div><div id="rfc.iref.p.39"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">subcompact<div id="rfc.iref.s.5"></div><div id="rfc.iref.p.40"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocindent<div id="rfc.iref.t.4"></div><div id="rfc.iref.p.41"></div></td><td class="left">(defaults to "yes")</td></tr><tr><td class="left">rfc</td><td class="left">tocompact<div id="rfc.iref.t.5"></div><div id="rfc.iref.p.42"></div></td><td class="left"></td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;Extension PIs</h2><div id="rfc.table.u.3"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>description</th></tr></thead><tbody><tr><td class="left">rfc-ext</td><td class="left">allow-markup-in-artwork<div id="rfc.iref.a.1"></div><div id="rfc.iref.p.43"></div></td><td class="left">xml2rfc-allow-markup-in-artwork<div id="rfc.iref.x.19"></div>  <div id="rfc.iref.p.44"></div></td><td class="left">"no"</td><td class="left">Enables support for specific elements inside abstract elements (using this extension makes the document incompatible to the RFC2629bis DTD; see description of conversion XSLT in <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;12.4</a>).</td></tr><tr><td class="left">rfc-ext</td><td class="left">authors-section<div id="rfc.iref.a.2"></div><div id="rfc.iref.p.45"></div></td><td class="left">xml2rfc-ext-authors-section<div id="rfc.iref.x.20"></div>  <div id="rfc.iref.p.46"></div></td><td class="left"></td><td class="left">When "end", place the authors section at the end (just before the copyright statements). This seems to be the preferred order in the newest RFCs.</td></tr><tr><td class="left">rfc-ext</td><td class="left">duplex<div id="rfc.iref.d.1"></div><div id="rfc.iref.p.47"></div></td><td class="left">xml2rfc-ext-duplex<div id="rfc.iref.x.21"></div>  <div id="rfc.iref.p.48"></div></td><td class="left">no</td><td class="left">When set to "yes", format the PDF output for doublesided printing.</td></tr><tr><td class="left">rfc-ext</td><td class="left">include-index<div id="rfc.iref.i.4"></div><div id="rfc.iref.p.49"></div></td><td class="left">xml2rfc-ext-include-index<div id="rfc.iref.x.22"></div>  <div id="rfc.iref.p.50"></div></td><td class="left">"yes"</td><td class="left">When set to "no", no index will be generated.</td></tr><tr><td class="left">rfc-ext</td><td class="left">include-references-in-index<div id="rfc.iref.i.5"></div><div id="rfc.iref.p.51"></div></td><td class="left">xml2rfc-ext-include-references-in-index<div id="rfc.iref.x.23"></div>  <div id="rfc.iref.p.52"></div></td><td class="left"></td><td class="left">When set to "yes", index entries are generated for all references.</td></tr><tr><td class="left">rfc-ext</td><td class="left">justification<div id="rfc.iref.j.1"></div><div id="rfc.iref.p.53"></div></td><td class="left">xml2rfc-ext-justification<div id="rfc.iref.x.24"></div>  <div id="rfc.iref.p.54"></div></td><td class="left">"never"</td><td class="left">"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</td></tr><tr><td class="left">rfc-ext</td><td class="left">parse-xml-in-artwork<div id="rfc.iref.p.55"></div><div id="rfc.iref.p.56"></div></td><td class="left">xml2rfc-parse-xml-in-artwork<div id="rfc.iref.x.25"></div>  <div id="rfc.iref.p.57"></div></td><td class="left">"no"</td><td class="left">May be used to enable parsing of XML content in figures (MSXML only).</td></tr><tr><td class="left">rfc-ext</td><td class="left">support-rfc2731<div id="rfc.iref.s.6"></div><div id="rfc.iref.p.58"></div></td><td class="left">xml2rfc-ext-support-rfc2731<div id="rfc.iref.x.26"></div>  <div id="rfc.iref.p.59"></div></td><td class="left">"yes"</td><td class="left">Decides whether the HTML transformation should generate META tags according <a href="#rfc2731.properties" title="Dublin Core (RFC2731) metadata">Section&nbsp;6.4</a>.</td></tr><tr><td class="left">rfc-ext</td><td class="left">sec-no-trailing-dots<div id="rfc.iref.s.7"></div><div id="rfc.iref.p.60"></div></td><td class="left">xml2rfc-ext-sec-no-trailing-dots<div id="rfc.iref.x.27"></div>  <div id="rfc.iref.p.61"></div></td><td class="left"></td><td class="left">When set to "yes", add trailing dots to section numbers. This seems to be the preferred format in the newest RFCs.</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;<a id="anchors" href="#anchors">Anchors</a></h1><p id="rfc.section.4.p.1">The transformation automatically generates anchors that are supposed to be stable and predictable and that can be used to identify specific parts of the document. Anchors are generated both in HTML and XSL-FO content (but the latter will only be used for PDF output when the XSL-FO engine supports producing PDF anchors).</p><div id="rfc.table.u.4"><p>The following anchors get auto-generated:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>Anchor name</th><th>Description</th></tr></thead><tbody><tr><td class="left">rfc.abstract <div id="rfc.iref.r.3"></div><div id="rfc.iref.a.3"></div></td><td class="left">Abstract</td></tr><tr><td class="left">rfc.authors <div id="rfc.iref.r.4"></div><div id="rfc.iref.a.4"></div></td><td class="left">Authors section</td></tr><tr><td class="left">rfc.copyright <div id="rfc.iref.r.5"></div><div id="rfc.iref.a.5"></div></td><td class="left">Copyright section</td></tr><tr><td class="left">rfc.copyrightnotice <div id="rfc.iref.r.6"></div><div id="rfc.iref.a.6"></div></td><td class="left">Copyright notice</td></tr><tr><td class="left">rfc.figure.<em>n</em>  <div id="rfc.iref.r.7"></div><div id="rfc.iref.a.7"></div></td><td class="left">Figures (titled)</td></tr><tr><td class="left">rfc.figure.u.<em>n</em>  <div id="rfc.iref.r.8"></div><div id="rfc.iref.a.8"></div></td><td class="left">Figures (untitled)</td></tr><tr><td class="left">rfc.index <div id="rfc.iref.r.9"></div><div id="rfc.iref.a.9"></div></td><td class="left">Index</td></tr><tr><td class="left">rfc.ipr <div id="rfc.iref.r.10"></div><div id="rfc.iref.a.10"></div></td><td class="left">Intellectual Property</td></tr><tr><td class="left">rfc.iref.<em>n</em>  <div id="rfc.iref.r.11"></div><div id="rfc.iref.a.11"></div></td><td class="left">Internal references</td></tr><tr><td class="left">rfc.note.<em>n</em>  <div id="rfc.iref.r.12"></div><div id="rfc.iref.a.12"></div></td><td class="left">Notes (from front section)</td></tr><tr><td class="left">rfc.references <div id="rfc.iref.r.13"></div><div id="rfc.iref.a.13"></div></td><td class="left">References</td></tr><tr><td class="left">rfc.references.<em>n</em>  <div id="rfc.iref.r.14"></div><div id="rfc.iref.a.14"></div></td><td class="left">Additional references</td></tr><tr><td class="left">rfc.section.<em>n</em>  <div id="rfc.iref.r.15"></div><div id="rfc.iref.a.15"></div></td><td class="left">Section <em>n</em></td></tr><tr><td class="left">rfc.section.<em>n</em>.p.<em>m</em>  <div id="rfc.iref.r.16"></div><div id="rfc.iref.a.16"></div></td><td class="left">Section <em>n</em>, paragraph <em>m</em></td></tr><tr><td class="left">rfc.status <div id="rfc.iref.r.17"></div><div id="rfc.iref.a.17"></div></td><td class="left">Status of memo</td></tr><tr><td class="left">rfc.table.<em>n</em>  <div id="rfc.iref.r.18"></div><div id="rfc.iref.a.18"></div></td><td class="left">Tables (titled)</td></tr><tr><td class="left">rfc.table.u.<em>n</em>  <div id="rfc.iref.r.19"></div><div id="rfc.iref.a.19"></div></td><td class="left">Tables (untitled)</td></tr><tr><td class="left">rfc.toc <div id="rfc.iref.r.20"></div><div id="rfc.iref.a.20"></div></td><td class="left">Table of contents</td></tr><tr><td class="left">rfc.xref.<em>name</em>.<em>n</em>  <div id="rfc.iref.r.21"></div><div id="rfc.iref.a.21"></div></td><td class="left">References to reference <em>n</em> to <em>name</em></td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.5" class="np"><a href="#rfc.section.5">5.</a>&nbsp;<a id="xslt.engines" href="#xslt.engines">Supported XSLT engines</a></h1><p id="rfc.section.5.p.1">The transformation requires a non-standard extension function (see <a href="http://www.exslt.org/exsl/functions/node-set/index.html">exsl:node-set</a>) which is however widely available. XSLT processors that do not support this extension (or a functional equivalent, such as msxsl:node-set) currently are not supported.</p><div id="exsl-date-time"><p id="rfc.section.5.p.2">Input documents do not always specify the date completely. In this case, the transformation attempts to let the XSLT engine to compute the system date, using either scripting in Microsoft's XSLT engine, or the <a href="http://www.exslt.org/date/functions/date-time/">exsl:date-time</a> extension function.</p></div><h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;Standalone Engines</h2><p id="rfc.section.5.1.p.1">The following XSLT engines are believed to work well: </p><ul><li>Windows: <span id="rfc.iref.m.1"></span><span id="rfc.iref.m.2"></span>MSXML3 and MSXML4 (&lt;<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>&gt;; command line processor "msxsl" is available from <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41">Microsoft Download Center</a>)</li><li>Java: <span id="rfc.iref.s.8"></span>Saxon (&lt;<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>&gt;)</li><li>Java: <span id="rfc.iref.x.28"></span>Xalan (&lt;<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>&gt;)</li><li>C/C++: <span id="rfc.iref.x.29"></span>xsltproc (libxslt) (&lt;<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>&gt;, make sure that you have a current version)</li></ul><h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a id="xslt.engines.browser" href="#xslt.engines.browser">In-Browser Engines</a></h2><p id="rfc.section.5.2.p.1">The following browsers seem to work fine: </p><ul><li><p><span id="rfc.iref.i.6"></span>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</p></li><li><p><span id="rfc.iref.i.7"></span><span id="rfc.iref.i.8"></span><span id="rfc.iref.i.9"></span><span id="rfc.iref.i.10"></span>Internet Explorer 6 and newer</p></li><li><div id="firefox3"><p><span id="rfc.iref.m.3"></span><span id="rfc.iref.f.2"></span>Firefox 3.0 and newer</p></div><p> </p><ul><li>Be aware that XSLT execution can be suppressed using <span id="rfc.iref.n.2"></span><a href="https://addons.mozilla.org/de/firefox/addon/722">NoScript</a></li><li>Firefox does not load external DTDs nor external entities, see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</a>, thus entities like &amp;nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix&nbsp;C.1</a>)</li><li>There seems to be a new problem in Firefox 4 where it occasionally does the initial rendering with the wrong width (people who can reproduce this problem please comment on &lt;<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=640390">https://bugzilla.mozilla.org/show_bug.cgi?id=640390</a>&gt;.</li><li>Date computation may become available in Firefox 6 (see &lt;<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=603159">https://bugzilla.mozilla.org/show_bug.cgi?id=603159</a>&gt;)</li></ul></li><li><p><span id="rfc.iref.s.9"></span><span id="rfc.iref.s.10"></span>Safari 3 (starting with version 3.0.4)</p><p> </p><ul><li>Date computation not available (see &lt;<a href="https://bugs.webkit.org/show_bug.cgi?id=4079">https://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;)</li></ul></li><li><p><span id="rfc.iref.g.1"></span>Google Chrome</p><p> </p><ul><li>Date computation not available (see &lt;<a href="https://bugs.webkit.org/show_bug.cgi?id=4079">https://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;)</li></ul></li><li><p><span id="rfc.iref.o.1"></span>Opera (starting with version 10)</p><p> </p><ul><li>Date computation not available</li></ul></li></ul><p id="rfc.section.5.2.p.2">The following browsers are known not to work properly: </p><ul><li><div id="firefox12"><p><span id="rfc.iref.m.4"></span><span id="rfc.iref.f.3"></span>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</a>)</p></div></li><li><div id="opera"><p><span id="rfc.iref.o.2"></span>Opera 9.21: execution fails, potentially to a somewhat complex XPath expression (reported to Opera as bug 245725).</p></div></li><li><p>Opera 9.5 and 9.6: transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</p></li><li><div id="safari"><p><span id="rfc.iref.s.11"></span>Safari 2.* supports client-side XSLT as of MacOS X 10.4, but misses required extension functions. A problem with stylesheets producing non-ASCII output (such as NBSP characters) has been fixed as of OSX 10.4.4. Both problems have been reported through Apple's bug tracking system, see &lt;<a href="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html">http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html</a>&gt; and &lt;<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;.</p></div></li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a>&nbsp;<a id="output.html" href="#output.html">Transforming to HTML</a></h1><p id="rfc.section.6.p.1">Transformation to HTML can be done inside the browser if it supports XSLT. To enable this, add the following processing instruction to the start of the source file:</p><div id="rfc.iref.x.30"></div><div id="rfc.figure.u.4"></div><pre class="text">  &lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?&gt;
     393</pre><p id="rfc.section.6.p.3">(and ensure that <samp>rfc2629.xslt</samp> is present).</p><h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a>&nbsp;HTML compliance</h2><p id="rfc.section.6.1.p.1">The transformation result is supposed to conform to the HTML 4.01 strict DTD <a href="#HTML" id="rfc.xref.HTML.1"><cite title="HTML 4.01 Specification">[HTML]</cite></a>. This can be checked using the W3C's online validator at &lt;<a href="http://validator.w3.org">http://validator.w3.org</a>&gt;<span id="rfc.iref.h.2"></span>.</p><h2 id="rfc.section.6.2"><a href="#rfc.section.6.2">6.2</a>&nbsp;<a id="html.link" href="#html.link">Standard HTML LINK elements</a></h2><p id="rfc.section.6.2.p.1">LINK elements exist since HTML 2.0. They can be used to embed content-independant links inside the document. Unfortunately, only few user agents support this element. Firefox users may want to check the <a href="https://addons.mozilla.org/firefox/2933/">Link Widgets</a> extension.</p><div id="rfc.table.u.5"><p>The following LINK elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>LINK type</th><th>description</th></tr></thead><tbody><tr><td class="left">alternate<div id="rfc.iref.a.22"></div><div id="rfc.iref.h.3"></div></td><td class="left">for RFCs, a link to the authorative ASCII version on the IETF web site</td></tr><tr><td class="left">appendic<div id="rfc.iref.a.23"></div><div id="rfc.iref.h.4"></div></td><td class="left">pointer to all top-level appendics</td></tr><tr><td class="left">author<div id="rfc.iref.a.24"></div><div id="rfc.iref.h.5"></div></td><td class="left">pointer to "authors" section</td></tr><tr><td class="left">chapter<div id="rfc.iref.c.3"></div><div id="rfc.iref.h.6"></div></td><td class="left">pointer to all top-level sections</td></tr><tr><td class="left">contents<div id="rfc.iref.c.4"></div><div id="rfc.iref.h.7"></div></td><td class="left">pointer to table of contents</td></tr><tr><td class="left">copyright<div id="rfc.iref.c.5"></div><div id="rfc.iref.h.8"></div></td><td class="left">pointer to copyright statement</td></tr><tr><td class="left">index<div id="rfc.iref.i.11"></div><div id="rfc.iref.h.9"></div></td><td class="left">pointer to index</td></tr></tbody></table></div><div id="rfc.figure.u.5"></div> <p>The figure below shows how Mozilla Firefox 1.0 displays the Site Navigation Bar for rfc2396.xml.</p>  <p><img src="rfc2629xslt-fig1.png" alt="&#xA;(LINK elements displayed in Mozilla Firefox for RFC2396.xml)&#xA;" width="509" height="235"></p> <h2 id="rfc.section.6.3"><a href="#rfc.section.6.3">6.3</a>&nbsp;Standard HTML metadata</h2><div id="rfc.table.u.6"><p>The following standard HTML META elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td class="left">generator<div id="rfc.iref.g.2"></div><div id="rfc.iref.h.10"></div></td><td class="left">from XSLT engine version and stylesheet version</td></tr><tr><td class="left">keywords<div id="rfc.iref.k.1"></div><div id="rfc.iref.h.11"></div></td><td class="left">from keyword elements in front section</td></tr></tbody></table></div><h2 id="rfc.section.6.4"><a href="#rfc.section.6.4">6.4</a>&nbsp;<a id="rfc2731.properties" href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></h2><p id="rfc.section.6.4.p.1">Unless turned off using the "rfc-ext support-rfc2731" processing instruction, the transformation will generate metadata according to <a href="#RFC2731" id="rfc.xref.RFC2731.1"><cite title="Encoding Dublin Core Metadata in HTML">[RFC2731]</cite></a> and <a href="#DC-HTML" id="rfc.xref.DC-HTML.1"><cite title="Expressing Dublin Core metadata using HTML/XHTML meta and link elements">[DC-HTML]</cite></a>.</p><div id="rfc.table.u.7"><p>The following DCMI properties are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td class="left">DC.Creator<div id="rfc.iref.c.6"></div><div id="rfc.iref.d.2"></div></td><td class="left">from author information in front section</td></tr><tr><td class="left">DC.Date.Issued<div id="rfc.iref.d.3"></div><div id="rfc.iref.d.4"></div></td><td class="left">from date information in front section</td></tr><tr><td class="left">DC.Description.Abstract<div id="rfc.iref.d.5"></div><div id="rfc.iref.d.6"></div></td><td class="left">from abstract</td></tr><tr><td class="left">DC.Identifier<div id="rfc.iref.i.12"></div><div id="rfc.iref.d.7"></div></td><td class="left">document URN <a href="#RFC2648" id="rfc.xref.RFC2648.1"><cite title="A URN Namespace for IETF Documents">[RFC2648]</cite></a> from "docName" attribute</td></tr><tr><td class="left">DC.isPartOf<div id="rfc.iref.i.13"></div><div id="rfc.iref.d.8"></div></td><td class="left">RFC ISSN (for RFCs)</td></tr><tr><td class="left">DC.Relation.Replaces<div id="rfc.iref.r.22"></div><div id="rfc.iref.d.9"></div></td><td class="left">from "obsoletes" attribute</td></tr></tbody></table></div><h2 id="rfc.section.6.5"><a href="#rfc.section.6.5">6.5</a>&nbsp;<a id="hcard" href="#hcard">Experimental hCard support</a></h2><p id="rfc.section.6.5.p.1">The generated author information is formatted in <a href="http://microformats.org/wiki/hcard">hCard</a> format.</p><hr class="noprint"><h1 id="rfc.section.7" class="np"><a href="#rfc.section.7">7.</a>&nbsp;<a id="output.xhtml" href="#output.xhtml">Transforming to XHTML</a></h1><p id="rfc.section.7.p.1">Transforming to XHTML requires slightly different XSLT output options and is implemented by the derived transformation script <samp>rfc2629toXHTML.xslt</samp>.</p><ul class="empty"><li> <b>Note:</b> Microsoft Internet Explorer does <em>not</em> support XHTML. Therefore it usually makes more sense to generate plain old HTML.</li></ul><hr class="noprint"><h1 id="rfc.section.8" class="np"><a href="#rfc.section.8">8.</a>&nbsp;<a id="output.chm" href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></h1><p id="rfc.section.8.p.1"> <span id="rfc.iref.c.7"></span>  <span id="rfc.iref.m.5"></span> To generate a CHM file using Microsoft's HTML Help Compiler (hhc), three files are required in addition to the HTML file. </p><ol><li>hhc - table of contents file (HTML)</li><li>hhk - index file (HTML)</li><li>hhp - project file (plain text)</li></ol><p id="rfc.section.8.p.2">The three files are generated with three specific transformations, each requiring the additional XSLT parameter "basename" to specify the filename prefix.</p><div id="rfc.figure.u.6"></div> <p>Example:</p>  <pre class="text">saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616  &gt; rfc2616.hhp
    394394saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616  &gt; rfc2616.hhc
    395395saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616  &gt; rfc2616.hhk
     
    429429            rel="Bookmark"
    430430            title="IETF WEBDAV Working Group"
    431             href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/&gt;</pre> <div id="rfc.iref.e.15"></div><div id="rfc.iref.l.4"></div><h2 id="rfc.section.11.14"><a href="#rfc.section.11.14">11.14</a>&nbsp;<a id="ext.element.lt" href="#ext.element.lt">&lt;lt&gt; element</a></h2><p id="rfc.section.11.14.p.1">Used for grouping multiple &lt;t&gt; elements into a single list item.</p><div id="rfc.iref.e.16"></div><div id="rfc.iref.n.3"></div><h2 id="rfc.section.11.15"><a href="#rfc.section.11.15">11.15</a>&nbsp;<a id="ext.element.note" href="#ext.element.note">&lt;note&gt; element</a></h2><p id="rfc.section.11.15.p.1">Can be used to add a note, usually indented by a few characters. It should contain one or more &lt;t&gt; child elements.</p><div id="rfc.iref.e.17"></div><div id="rfc.iref.p.60"></div><h2 id="rfc.section.11.16"><a href="#rfc.section.11.16">11.16</a>&nbsp;<a id="ext.element.parse-xml" href="#ext.element.parse-xml">&lt;parse-xml&gt; element</a></h2><p id="rfc.section.11.16.p.1">This element instructs the processor to parse the contents as XML and to warn when there's a problem (requires either MSXML or Saxon8 or newer).</p><div id="rfc.iref.e.18"></div><div id="rfc.iref.p.61"></div><h2 id="rfc.section.11.17"><a href="#rfc.section.11.17">11.17</a>&nbsp;<a id="ext.element.prose" href="#ext.element.prose">&lt;prose&gt; element</a></h2><p id="rfc.section.11.17.p.1">This element can be used inside &lt;reference&gt; to add plain text (before the date, when present).</p><div id="rfc.iref.e.19"></div><div id="rfc.iref.q.1"></div><h2 id="rfc.section.11.18"><a href="#rfc.section.11.18">11.18</a>&nbsp;<a id="ext.element.q" href="#ext.element.q">&lt;q&gt; element</a></h2><p id="rfc.section.11.18.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-Q">q</a>" element in <a href="#HTML" id="rfc.xref.HTML.4"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><div id="rfc.iref.e.20"></div><div id="rfc.iref.r.23"></div><h2 id="rfc.section.11.19"><a href="#rfc.section.11.19">11.19</a>&nbsp;<a id="ext.element.ref" href="#ext.element.ref">&lt;ref&gt; element</a></h2><p id="rfc.section.11.19.p.1">This element is a simplified variant of the &lt;xref&gt; element, in that no "target" attribute needs to be specified, instead the text contents acts as identifier. That in itself wouldn't be terribly useful, but together with the &lt;<a href="#ext.element.anchor-alias" class="smpl">anchor-alias</a>&gt;, it allows referring to other parts of the document with minimal additional markup.</p><p id="rfc.section.11.19.p.2">For instance, given an alias definition such as</p><div id="rfc.figure.u.13"></div> <pre class="text">      &lt;section title="Test" anchor="test"&gt;
     431            href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/&gt;</pre> <div id="rfc.iref.e.15"></div><div id="rfc.iref.l.4"></div><h2 id="rfc.section.11.14"><a href="#rfc.section.11.14">11.14</a>&nbsp;<a id="ext.element.lt" href="#ext.element.lt">&lt;lt&gt; element</a></h2><p id="rfc.section.11.14.p.1">Used for grouping multiple &lt;t&gt; elements into a single list item.</p><div id="rfc.iref.e.16"></div><div id="rfc.iref.n.3"></div><h2 id="rfc.section.11.15"><a href="#rfc.section.11.15">11.15</a>&nbsp;<a id="ext.element.note" href="#ext.element.note">&lt;note&gt; element</a></h2><p id="rfc.section.11.15.p.1">Can be used to add a note, usually indented by a few characters. It should contain one or more &lt;t&gt; child elements.</p><div id="rfc.iref.e.17"></div><div id="rfc.iref.p.62"></div><h2 id="rfc.section.11.16"><a href="#rfc.section.11.16">11.16</a>&nbsp;<a id="ext.element.parse-xml" href="#ext.element.parse-xml">&lt;parse-xml&gt; element</a></h2><p id="rfc.section.11.16.p.1">This element instructs the processor to parse the contents as XML and to warn when there's a problem (requires either MSXML or Saxon8 or newer).</p><div id="rfc.iref.e.18"></div><div id="rfc.iref.p.63"></div><h2 id="rfc.section.11.17"><a href="#rfc.section.11.17">11.17</a>&nbsp;<a id="ext.element.prose" href="#ext.element.prose">&lt;prose&gt; element</a></h2><p id="rfc.section.11.17.p.1">This element can be used inside &lt;reference&gt; to add plain text (before the date, when present).</p><div id="rfc.iref.e.19"></div><div id="rfc.iref.q.1"></div><h2 id="rfc.section.11.18"><a href="#rfc.section.11.18">11.18</a>&nbsp;<a id="ext.element.q" href="#ext.element.q">&lt;q&gt; element</a></h2><p id="rfc.section.11.18.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-Q">q</a>" element in <a href="#HTML" id="rfc.xref.HTML.4"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><div id="rfc.iref.e.20"></div><div id="rfc.iref.r.23"></div><h2 id="rfc.section.11.19"><a href="#rfc.section.11.19">11.19</a>&nbsp;<a id="ext.element.ref" href="#ext.element.ref">&lt;ref&gt; element</a></h2><p id="rfc.section.11.19.p.1">This element is a simplified variant of the &lt;xref&gt; element, in that no "target" attribute needs to be specified, instead the text contents acts as identifier. That in itself wouldn't be terribly useful, but together with the &lt;<a href="#ext.element.anchor-alias" class="smpl">anchor-alias</a>&gt;, it allows referring to other parts of the document with minimal additional markup.</p><p id="rfc.section.11.19.p.2">For instance, given an alias definition such as</p><div id="rfc.figure.u.13"></div> <pre class="text">      &lt;section title="Test" anchor="test"&gt;
    432432        &lt;x:anchor-alias value="alias1"/&gt;
    433433        &lt;x:anchor-alias value="alias 2"/&gt;
     
    445445        &lt;x:source href="rfc2616.xml"/&gt;
    446446        ...
    447     </pre> <div id="rfc.iref.e.22"></div><div id="rfc.iref.s.13"></div><h2 id="rfc.section.11.21"><a href="#rfc.section.11.21">11.21</a>&nbsp;<a id="ext.element.sup" href="#ext.element.sup">&lt;sup&gt; element</a></h2><p id="rfc.section.11.21.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-SUP">sup</a>" element in <a href="#HTML" id="rfc.xref.HTML.5"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><p id="rfc.section.11.21.p.2">Note: the down conversion to RFC2629 format replaces "x<sup>y</sup>" by "x^y".</p><h2 id="rfc.section.11.22"><a href="#rfc.section.11.22">11.22</a>&nbsp;<a id="ext-rfc2629.artwork" href="#ext-rfc2629.artwork">Extensions to Xml2rfc &lt;artwork&gt; element</a></h2><p id="rfc.section.11.22.p.1">Sometimes, artwork occurs inside lists. To get it indent properly in xml2rfc's text output, it needs to be indented in the source. This is sub-optimal, as this whitespace will also appear in the HTML output, where it's already indented due to HTML's semantics.</p><p id="rfc.section.11.22.p.2">As a workaround, a "x:indent-with" attribute can be specified, containing a string that will be prepended to each line when <samp>clean-for-DTD.xslt</samp> is run (see <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;12.4</a>).</p><h2 id="rfc.section.11.23"><a href="#rfc.section.11.23">11.23</a>&nbsp;<a id="ext-rfc2629.iref" href="#ext-rfc2629.iref">Extensions to Xml2rfc &lt;iref&gt; element</a></h2><p id="rfc.section.11.23.p.1">The extension attribute below is allowed on the standard &lt;iref&gt; element: </p><ul><li>x:for-anchor specifies that the &lt;iref&gt; will also be automatically inserted whenever the specified anchor is cross-referenced -- this may save entering lots of &lt;iref&gt; instances. As a special case, a value of "" (empty string) refers to the anchor attribute of the closest ancestor.</li></ul><h2 id="rfc.section.11.24"><a href="#rfc.section.11.24">11.24</a>&nbsp;<a id="ext-rfc2629.list" href="#ext-rfc2629.list">Extensions to Xml2rfc &lt;list&gt; element</a></h2><p id="rfc.section.11.24.p.1">The extension attribute below is allowed on the standard &lt;list&gt; element: </p><ul><li>x:indent specifies the amount of indentation for list items in hanging lists. This can be useful when the output format, such as XSL-FO, does not support automatical formatting. The value takes an XSL-FO width, such as "5em". The default is <em>length of longest label in characters</em> times <em>0.8em</em>.</li></ul><p id="rfc.section.11.24.p.2">Also, the &lt;list&gt; element can take &lt;x:<a href="#ext.element.lt" class="smpl">lt</a>&gt; child elements instead of &lt;t&gt;, allowing to insert multiple paragraphs into a single list item.</p><h2 id="rfc.section.11.25"><a href="#rfc.section.11.25">11.25</a>&nbsp;<a id="ext-rfc2629.rfc" href="#ext-rfc2629.rfc">Extensions to Xml2rfc &lt;rfc&gt; element</a></h2><p id="rfc.section.11.25.p.1">The extension attributes below are allowed on the standard &lt;rfc&gt; element: </p><ul><li>grddl:transformation can be used to reference a GRDDL transform.</li><li>x:maturiy-level can be used to specify the IETF Standards Track Maturity Level of "proposed", "draft" or "internet" (see <a href="http://tools.ietf.org/html/rfc2026#section-4.1">Section 4.1</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.1"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>).</li></ul><h2 id="rfc.section.11.26"><a href="#rfc.section.11.26">11.26</a>&nbsp;<a id="ext-rfc2629.section" href="#ext-rfc2629.section">Extensions to Xml2rfc &lt;section&gt; element</a></h2><p id="rfc.section.11.26.p.1">The extension attribute below is allowed on the standard &lt;list&gt; element: </p><ul><li>x:fixed-section-number can be used to specify a fixed section number. This can be useful when formatting historic documents that used a different numbering style.</li></ul><h2 id="rfc.section.11.27"><a href="#rfc.section.11.27">11.27</a>&nbsp;<a id="ext-rfc2629.xref" href="#ext-rfc2629.xref">Extensions to Xml2rfc &lt;xref&gt; element</a></h2><p id="rfc.section.11.27.p.1">Three extension attributes are allowed on the standard &lt;xref&gt; element: </p><ol><li>x:sec can be specified to point to a specific section of the referenced document,</li><li>x:rel may specify a relative reference to use when linking into the referenced document (if linking by section number is not available),</li><li>x:fmt defines the text format to be used.</li></ol><p id="rfc.section.11.27.p.2">The following formats are defined for the x:fmt attribute: </p><dl><dt>, (Comma)</dt><dd>[<em>reference</em>], Section <em>sec</em> </dd><dt>()</dt><dd>[<em>reference</em>] (Section <em>sec</em>)</dd><dt>anchor</dt><dd>Like the default format, but without brackets.</dd><dt>of</dt><dd>Section <em>sec</em> of [<em>reference</em>]</dd><dt>number</dt><dd> <em>sec</em> </dd><dt>none</dt><dd>No output (can be used to have xrefs to references without having them rendered as such)</dd><dt>sec</dt><dd>Section <em>sec</em> </dd></dl><p id="rfc.section.11.27.p.3">These extensions are currently only supported for &lt;xref&gt; elements without child nodes.</p><p id="rfc.section.11.27.p.4">If the processor knows how to reference the target section, it will generate a link directly to the target section, such as in <a href="#RFC2119" id="rfc.xref.RFC2119.2"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>, <a href="http://tools.ietf.org/html/rfc2119#section-5">Section 5</a>.</p><hr class="noprint"><h1 id="rfc.section.12" class="np"><a href="#rfc.section.12">12.</a>&nbsp;<a id="utilities" href="#utilities">Utilities</a></h1><h2 id="rfc.section.12.1"><a href="#rfc.section.12.1">12.1</a>&nbsp;<a id="checking-references" href="#checking-references">Checking References</a></h2><p id="rfc.section.12.1.p.1"> <samp>check-references.xslt</samp> can be used to check all references to RFC- and ID-series IETF publications and to W3C publications (note this script requires local copies of &lt;<a href="ftp://ftp.isi.edu/in-notes/rfc-index.xml">ftp://ftp.isi.edu/in-notes/rfc-index.xml</a>&gt; and &lt;<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>&gt; and will use the XML status information provided at &lt;<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>&gt;).</p><p id="rfc.section.12.1.p.2">If the document is supposed to be published on the IETF standards track, the desired level can be specified using the parameter <samp>intended-level</samp> as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified inside the document using the attribute x:maturity-level on the &lt;rfc&gt; element.</p><p id="rfc.section.12.1.p.3"> <b>Note:</b> Downward references should be annotated using the &lt;annotate&gt; element, containing an &lt;xref&gt; to <a href="#BCP97" id="rfc.xref.BCP97.1"><cite title="Handling Normative References to Standards-Track Documents">[BCP97]</cite></a>.</p><p id="rfc.section.12.1.p.4">When an XSLT 2.0 processor is used, links in the document can be checked as well using the <samp>link-check</samp> paramerer ('yes' or 'no'). Note that this only works for http links to documents of type text/*.</p><div id="rfc.figure.u.17"></div> <p>For instance, as of 2008-07-12, the script produces for &lt;<a href="http://greenbytes.de/tech/webdav/rfc2518.xml">http://greenbytes.de/tech/webdav/rfc2518.xml</a>&gt;:</p>  <pre class="text">&gt; saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \
     447    </pre> <div id="rfc.iref.e.22"></div><div id="rfc.iref.s.13"></div><h2 id="rfc.section.11.21"><a href="#rfc.section.11.21">11.21</a>&nbsp;<a id="ext.element.sup" href="#ext.element.sup">&lt;sup&gt; element</a></h2><p id="rfc.section.11.21.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-SUP">sup</a>" element in <a href="#HTML" id="rfc.xref.HTML.5"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><p id="rfc.section.11.21.p.2">Note: the down conversion to RFC2629 format replaces "x<sup>y</sup>" by "x^y".</p><h2 id="rfc.section.11.22"><a href="#rfc.section.11.22">11.22</a>&nbsp;<a id="ext-rfc2629.artwork" href="#ext-rfc2629.artwork">Extensions to Xml2rfc &lt;artwork&gt; element</a></h2><p id="rfc.section.11.22.p.1">Sometimes, artwork occurs inside lists. To get it indent properly in xml2rfc's text output, it needs to be indented in the source. This is sub-optimal, as this whitespace will also appear in the HTML output, where it's already indented due to HTML's semantics.</p><p id="rfc.section.11.22.p.2">As a workaround, a "x:indent-with" attribute can be specified, containing a string that will be prepended to each line when <samp>clean-for-DTD.xslt</samp> is run (see <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;12.4</a>).</p><h2 id="rfc.section.11.23"><a href="#rfc.section.11.23">11.23</a>&nbsp;<a id="ext-rfc2629.iref" href="#ext-rfc2629.iref">Extensions to Xml2rfc &lt;iref&gt; element</a></h2><p id="rfc.section.11.23.p.1">The extension attribute below is allowed on the standard &lt;iref&gt; element: </p><ul><li>x:for-anchor specifies that the &lt;iref&gt; will also be automatically inserted whenever the specified anchor is cross-referenced -- this may save entering lots of &lt;iref&gt; instances. As a special case, a value of "" (empty string) refers to the anchor attribute of the closest ancestor.</li></ul><h2 id="rfc.section.11.24"><a href="#rfc.section.11.24">11.24</a>&nbsp;<a id="ext-rfc2629.list" href="#ext-rfc2629.list">Extensions to Xml2rfc &lt;list&gt; element</a></h2><p id="rfc.section.11.24.p.1">The extension attribute below is allowed on the standard &lt;list&gt; element: </p><ul><li>x:indent specifies the amount of indentation for list items in hanging lists. This can be useful when the output format, such as XSL-FO, does not support automatical formatting. The value takes an XSL-FO width, such as "5em". The default is <em>length of longest label in characters</em> times <em>0.8em</em>.</li></ul><p id="rfc.section.11.24.p.2">Also, the &lt;list&gt; element can take &lt;x:<a href="#ext.element.lt" class="smpl">lt</a>&gt; child elements instead of &lt;t&gt;, allowing to insert multiple paragraphs into a single list item.</p><h2 id="rfc.section.11.25"><a href="#rfc.section.11.25">11.25</a>&nbsp;<a id="ext-rfc2629.rfc" href="#ext-rfc2629.rfc">Extensions to Xml2rfc &lt;rfc&gt; element</a></h2><p id="rfc.section.11.25.p.1">The extension attributes below are allowed on the standard &lt;rfc&gt; element: </p><ul><li>grddl:transformation can be used to reference a GRDDL transform.</li><li>x:maturity-level can be used to specify the IETF Standards Track Maturity Level of "proposed", "draft" or "internet" (see <a href="http://tools.ietf.org/html/rfc2026#section-4.1">Section 4.1</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.1"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>).</li></ul><h2 id="rfc.section.11.26"><a href="#rfc.section.11.26">11.26</a>&nbsp;<a id="ext-rfc2629.section" href="#ext-rfc2629.section">Extensions to Xml2rfc &lt;section&gt; element</a></h2><p id="rfc.section.11.26.p.1">The extension attribute below is allowed on the standard &lt;list&gt; element: </p><ul><li>x:fixed-section-number can be used to specify a fixed section number. This can be useful when formatting historic documents that used a different numbering style.</li></ul><h2 id="rfc.section.11.27"><a href="#rfc.section.11.27">11.27</a>&nbsp;<a id="ext-rfc2629.xref" href="#ext-rfc2629.xref">Extensions to Xml2rfc &lt;xref&gt; element</a></h2><p id="rfc.section.11.27.p.1">Three extension attributes are allowed on the standard &lt;xref&gt; element: </p><ol><li>x:sec can be specified to point to a specific section of the referenced document,</li><li>x:rel may specify a relative reference to use when linking into the referenced document (if linking by section number is not available),</li><li>x:fmt defines the text format to be used.</li></ol><p id="rfc.section.11.27.p.2">The following formats are defined for the x:fmt attribute: </p><dl><dt>, (Comma)</dt><dd>[<em>reference</em>], Section <em>sec</em> </dd><dt>()</dt><dd>[<em>reference</em>] (Section <em>sec</em>)</dd><dt>anchor</dt><dd>Like the default format, but without brackets.</dd><dt>of</dt><dd>Section <em>sec</em> of [<em>reference</em>]</dd><dt>number</dt><dd> <em>sec</em> </dd><dt>none</dt><dd>No output (can be used to have xrefs to references without having them rendered as such)</dd><dt>sec</dt><dd>Section <em>sec</em> </dd></dl><p id="rfc.section.11.27.p.3">These extensions are currently only supported for &lt;xref&gt; elements without child nodes.</p><p id="rfc.section.11.27.p.4">If the processor knows how to reference the target section, it will generate a link directly to the target section, such as in <a href="#RFC2119" id="rfc.xref.RFC2119.2"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>, <a href="http://tools.ietf.org/html/rfc2119#section-5">Section 5</a>.</p><hr class="noprint"><h1 id="rfc.section.12" class="np"><a href="#rfc.section.12">12.</a>&nbsp;<a id="utilities" href="#utilities">Utilities</a></h1><h2 id="rfc.section.12.1"><a href="#rfc.section.12.1">12.1</a>&nbsp;<a id="checking-references" href="#checking-references">Checking References</a></h2><p id="rfc.section.12.1.p.1"> <samp>check-references.xslt</samp> can be used to check all references to RFC- and ID-series IETF publications and to W3C publications (note this script requires local copies of &lt;<a href="ftp://ftp.isi.edu/in-notes/rfc-index.xml">ftp://ftp.isi.edu/in-notes/rfc-index.xml</a>&gt; and &lt;<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>&gt; and will use the XML status information provided at &lt;<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>&gt;).</p><p id="rfc.section.12.1.p.2">If the document is supposed to be published on the IETF standards track, the desired level can be specified using the parameter <samp>intended-level</samp> as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified inside the document using the attribute x:maturity-level on the &lt;rfc&gt; element (see <a href="#ext-rfc2629.rfc" title="Extensions to Xml2rfc <rfc&gt; element">Section&nbsp;11.25</a>).</p><p id="rfc.section.12.1.p.3"> <b>Note:</b> Downward references should be annotated using the &lt;annotate&gt; element, containing an &lt;xref&gt; to <a href="#BCP97" id="rfc.xref.BCP97.1"><cite title="Handling Normative References to Standards-Track Documents">[BCP97]</cite></a>.</p><p id="rfc.section.12.1.p.4">When an XSLT 2.0 processor is used, links in the document can be checked as well using the <samp>link-check</samp> paramerer ('yes' or 'no'). Note that this only works for http links to documents of type text/*.</p><div id="rfc.figure.u.17"></div> <p>For instance, as of 2008-07-12, the script produces for &lt;<a href="http://greenbytes.de/tech/webdav/rfc2518.xml">http://greenbytes.de/tech/webdav/rfc2518.xml</a>&gt;:</p>  <pre class="text">&gt; saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \
    448448  link-check=yes
    449449
     
    751751  }
    752752
    753 <em id="x_include-author"><span id="rfc.iref.i.12"></span><span id="rfc.iref.e.25"></span># Including Author information
     753<em id="x_include-author"><span id="rfc.iref.i.14"></span><span id="rfc.iref.e.25"></span># Including Author information
    754754# (experimental)</em>
    755755<a href="#x_include-author" class="smpl">x_include-author</a> =
     
    884884  }
    885885
    886 <em id="x_parse-xml"><span id="rfc.iref.p.62"></span><span id="rfc.iref.e.40"></span># Signal XML content (see <a href="#ext.element.parse-xml" title="<parse-xml&gt; element">Section&nbsp;11.16</a>)</em>
     886<em id="x_parse-xml"><span id="rfc.iref.p.64"></span><span id="rfc.iref.e.40"></span># Signal XML content (see <a href="#ext.element.parse-xml" title="<parse-xml&gt; element">Section&nbsp;11.16</a>)</em>
    887887<a href="#x_parse-xml" class="smpl">x_parse-xml</a> =
    888888  element x:parse-xml {
     
    891891  }
    892892
    893 <em id="x_prose"><span id="rfc.iref.p.63"></span><span id="rfc.iref.e.41"></span># Inline prose in a reference (see <a href="#ext.element.prose" title="<prose&gt; element">Section&nbsp;11.17</a>)</em>
     893<em id="x_prose"><span id="rfc.iref.p.65"></span><span id="rfc.iref.e.41"></span># Inline prose in a reference (see <a href="#ext.element.prose" title="<prose&gt; element">Section&nbsp;11.17</a>)</em>
    894894<a href="#x_prose" class="smpl">x_prose</a> =
    895895  element x:prose {
     
    932932  }
    933933
    934 <em id="x_x"><span id="rfc.iref.x.30"></span><span id="rfc.iref.e.47"></span># Nop (for alignment in source)</em>
     934<em id="x_x"><span id="rfc.iref.x.31"></span><span id="rfc.iref.e.47"></span># Nop (for alignment in source)</em>
    935935<a href="#x_x" class="smpl">x_x</a> =
    936936  element x:x {
     
    996996
    997997&lt;/xsl:transform&gt;
    998 </pre><div class="note" id="rfc.section.C.2.p.3"> <p> <b>Note:</b> the name for the attribute sets may change in the future as more working is done with respect to customizability. In any case, overriding the settings in a separate file will be easier to maintain. Please contact the author if you find yourself trying to override style definitions that currently do not use attribute sets.</p>  <p> <b>Note:</b> the CSS style information used in <samp>rfc2629.xslt</samp> can be overriden in a similar (but less granular) way: just overwrite the template called "insertCss". As for XSL-FO, the class names may change in future.</p> </div><hr class="noprint"><h1 id="rfc.section.D" class="np"><a href="#rfc.section.D">D.</a>&nbsp;<a id="boilerplate" href="#boilerplate">Producing the IETF 'Boilerplate'</a></h1><p id="rfc.section.D.p.1">Various attributes of the <samp>&lt;rfc&gt;</samp> element plus some child elements of <samp>&lt;front&gt;</samp> affect the automatically generated parts of the front page, such as the tabular information at the beginning, the "Status Of This Memo", and the "Copyright Notice".</p><p id="rfc.section.D.p.2">When submitting an Internet Draft, this "boilerplate" is checked by "Idnits" (&lt;<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>&gt;) for compliance with the current Intellectual Property rules, and thus it is important to set the correct values.</p><p id="rfc.section.D.p.3">Furthermore, the RFC Production Center uses RFC2629-based tools to generate the final RFC text, so the more accurate the supplied information is, the less additional work is left, and the risk for errors in producing the final (and immutable!) document is reduced.</p><div class="note" id="rfc.section.D.p.4"> <p> <b>Note:</b> this only applies to the case when IETF documents are produced. The "private" processing instruction <span id="rfc.iref.p.64"></span><span id="rfc.iref.p.65"></span> allows to switch off most of the autogeneration logic.</p> </div><h2 id="rfc.section.D.1"><a href="#rfc.section.D.1">D.1</a>&nbsp;<a id="attribute-ipr" href="#attribute-ipr">The /rfc/@ipr Attribute</a></h2><p id="rfc.section.D.1.p.1">As of the time of this writing, this attribute value can take a long list of values. As frequently, this is not the result of a grand plan, but simply for historic reasons. Of these values, only a few are currently in use; all others are supported by the various tools for backwards compatibility with old source files.</p><div class="note" id="rfc.section.D.1.p.2"> <p> <b>Note:</b> some variations of the boilerplate are selected based on the document's date; therefore it is important to specify the "year", "month" and "day" attributes of the <samp>&lt;date&gt;</samp> element when archiving the XML source of an Internet Draft on the day of submission.</p> </div><p id="rfc.section.D.1.p.3"> <em>Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER.</em> For further information, refer to &lt;<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>&gt;.</p><p id="rfc.section.D.1.p.4">Finally, for the current "Status Of This Memo" text, the <samp>submissionType</samp> attribute determines whether a statement about "Code Components" is inserted (this is the case for the value "IETF", which also happens to be the default). Other values, such as "independent", suppress this part of the text.</p><h3 id="rfc.section.D.1.1"><a href="#rfc.section.D.1.1">D.1.1</a>&nbsp;<a id="attribute-ipr-current" href="#attribute-ipr-current">Current Values: '*trust200902'</a></h3><p id="rfc.section.D.1.1.p.1">The name for these values refers to the "TLP" ("IETF TRUST Legal Provisions Relating to IETF Documents"), on effect February 15, 2009 (see &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf</a>&gt;). Updates to this document were published on September 12, 2009 (TLP 3.0, &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>&gt;) and on December 28, 2009 (TLP 4.0, &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>&gt;), modifying the license for code components. The actual text is located in Section 6 ("Text To Be Included in IETF Documents") of these documents.</p><p id="rfc.section.D.1.1.p.2">The tools will automatically produce the "right" text depending on the document's date information (see above):</p><div id="rfc.table.u.10"><table class="tt full left" cellpadding="3" cellspacing="0"><thead><tr><th>TLP</th><th>URI</th><th>starting with publication date</th></tr></thead><tbody><tr><td class="left">3.0</td><td class="left">&lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>&gt;</td><td class="left">2009-11-01</td></tr><tr><td class="left">4.0</td><td class="left">&lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>&gt;</td><td class="left">2010-04-01</td></tr></tbody></table></div><h4 id="rfc.section.D.1.1.1"><a href="#rfc.section.D.1.1.1">D.1.1.1</a>&nbsp;<a id="attribute-ipr-trust200902" href="#attribute-ipr-trust200902">trust200902</a></h4><p id="rfc.section.D.1.1.1.p.1">This should be the default, unless one of the more specific '*trust200902' values is a better fit. It produces the text in Sections 6.a and 6.b of the TLP.</p><h4 id="rfc.section.D.1.1.2"><a href="#rfc.section.D.1.1.2">D.1.1.2</a>&nbsp;<a id="attribute-ipr-noModificationTrust200902" href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></h4><p id="rfc.section.D.1.1.2.p.1">This produces the additional text from Section 6.c.i of the TLP:</p><blockquote id="rfc.section.D.1.1.2.p.2"> <p>This document may not be modified, and derivative works of it may not be created, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><div class="note" id="rfc.section.D.1.1.2.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.3"><a href="#rfc.section.D.1.1.3">D.1.1.3</a>&nbsp;<a id="attribute-ipr-noDerivativesTrust200902" href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></h4><p id="rfc.section.D.1.1.3.p.1">This produces the additional text from Section 6.c.ii of the TLP:</p><blockquote id="rfc.section.D.1.1.3.p.2"> <p>This document may not be modified, and derivative works of it may not be created, and it may not be published except as an Internet-Draft.</p> </blockquote><div class="note" id="rfc.section.D.1.1.3.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.4"><a href="#rfc.section.D.1.1.4">D.1.1.4</a>&nbsp;<a id="attribute-ipr-pre5378Trust200902" href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></h4><p id="rfc.section.D.1.1.4.p.1">This produces the additional text from Section 6.c.iii of the TLP, frequently called the "pre-5378 escape clause":</p><blockquote id="rfc.section.D.1.1.4.p.2"> <p>This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><p id="rfc.section.D.1.1.4.p.3">See Section 4 of &lt;<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>&gt; for further information about when to use this value.</p><div class="note" id="rfc.section.D.1.1.4.p.4"> <p> <b>Note:</b> this text appears under "Copyright Notice", unless the document was published before November 2009, in which case it appears under "Status Of This Memo".</p> </div><h3 id="rfc.section.D.1.2"><a href="#rfc.section.D.1.2">D.1.2</a>&nbsp;<a id="attribute-ipr-historic" href="#attribute-ipr-historic">Historic Values</a></h3><h4 id="rfc.section.D.1.2.1"><a href="#rfc.section.D.1.2.1">D.1.2.1</a>&nbsp;<a id="attribute-ipr-200811" href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></h4><p id="rfc.section.D.1.2.1.p.1">The attribute values "<span id="attribute-ipr-trust200811">trust200811</span>", "<span id="attribute-ipr-noModificationTrust200811">noModificationTrust200811</span>" and "<span id="attribute-ipr-noDerivativesTrust200811">noDerivativesTrust200811</span>" are similar to their "trust200902" counterparts, except that they use text specified in &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf</a>&gt;.</p><h4 id="rfc.section.D.1.2.2"><a href="#rfc.section.D.1.2.2">D.1.2.2</a>&nbsp;<a id="attribute-ipr-3978" href="#attribute-ipr-3978">Historic Values: '*3978'</a></h4><p id="rfc.section.D.1.2.2.p.1">The attribute values "<span id="attribute-ipr-full3978">full3978</span>", "<span id="attribute-ipr-noModification3978">noModification3978</span>" and "<span id="attribute-ipr-noDerivatives3978">noDerivatives3978</span>" are similar to their counterparts above, except that they use text specified in RFC 3978 (March 2005).</p><h4 id="rfc.section.D.1.2.3"><a href="#rfc.section.D.1.2.3">D.1.2.3</a>&nbsp;<a id="attribute-ipr-3667" href="#attribute-ipr-3667">Historic Values: '*3667'</a></h4><p id="rfc.section.D.1.2.3.p.1">The attribute values "<span id="attribute-ipr-full3667">full3667</span>", "<span id="attribute-ipr-noModification3667">noModification3667</span>" and "<span id="attribute-ipr-noDerivatives3667">noDerivatives3667</span>" are similar to their counterparts above, except that they use text specified in RFC 3667 (February 2004).</p><h4 id="rfc.section.D.1.2.4"><a href="#rfc.section.D.1.2.4">D.1.2.4</a>&nbsp;<a id="attribute-ipr-2026" href="#attribute-ipr-2026">Historic Values: '*2026'</a></h4><p id="rfc.section.D.1.2.4.p.1">The attribute values "<span id="attribute-ipr-full2026">full2026</span>" and "<span id="attribute-ipr-noDerivativeWorks2026">noDerivativeWorks2026</span>" are similar to their counterparts above, except that they use text specified in RFC 2026 (October 1996).</p><p id="rfc.section.D.1.2.4.p.2">The special value "<span id="attribute-ipr-none">none</span>" was also used back then, and denied the IETF any rights beyond publication as Internet Draft.</p><h2 id="rfc.section.D.2"><a href="#rfc.section.D.2">D.2</a>&nbsp;<a id="attribute-category" href="#attribute-category">The /rfc/@category Attribute</a></h2><p id="rfc.section.D.2.p.1">For RFCs, the <samp>category</samp> determines the "maturity level" (see <a href="http://tools.ietf.org/html/rfc2026#section-4">Section 4</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.2"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>). The allowed values are "std" for "Standards Track", "bcp" for "BCP", "info" for "Informational", "exp" for "Experimental", and "historic" for - surprise - "Historic".</p><p id="rfc.section.D.2.p.2">For Internet Drafts, the category attribute is not needed, but <em>will</em> appear on the front page ("Intended Status"). Supplying this information can be useful, because reviewers may want to know.</p><div class="note" id="rfc.section.D.2.p.3"> <p> <b>Note:</b> the Standards Track consists of "Proposed Standard", "Draft Standards", and "Internet Standard". These do not appear in the boilerplate, thus the category attribute doesn't handle them. However, this information can be useful for validity checkers, and thus <samp>rfc2629.xslt</samp> supports an extension attribute for that purpose (see <a href="#ext-rfc2629.rfc" title="Extensions to Xml2rfc <rfc&gt; element">Section&nbsp;11.25</a> for details).</p> </div><h2 id="rfc.section.D.3"><a href="#rfc.section.D.3">D.3</a>&nbsp;<a id="attribute-submissiontype" href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></h2><p id="rfc.section.D.3.p.1">The RFC Editor publishes documents from different "document streams", of which the "IETF stream" of course is the most prominent one. Other streams are the "independent stream" (used for things like administrative information or April 1st RFCs), the "IAB stream" (Internet Architecture Board) and the "IRTF stream" (Internet Research Task Force).</p><p id="rfc.section.D.3.p.2">Not surprisingly, the values for the attribute are "IETF" (the default value), "independent", "IAB", and "IRTF".</p><p id="rfc.section.D.3.p.3">Historically, this did not affect the final appearance of RFCs, except for subtle differences in Copyright notices. Nowadays (as of <a href="#RFC5741" id="rfc.xref.RFC5741.1"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>), the stream name appears in the first line of the front page, and it also affects the text in the "Status Of This Memo" section.</p><p id="rfc.section.D.3.p.4">For current documents, setting <samp>submissionType</samp> attribute will have the following effect: </p><ul><li>For RFCs, the stream name appears in the upper left corner of the first page (in Internet Drafts, this is either "Network Working Group", or the value of the <samp>&lt;workgroup&gt;</samp> element).</li><li>For RFCs, if affects the whole "Status Of This Memo" section (see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.2"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</li><li>For all RFCs and Internet Drafts, it determines whether the "Copyright Notice" mentions the Copyright on Code Components (see TLP, Section "Text To Be Included in IETF Documents").</li></ul><h2 id="rfc.section.D.4"><a href="#rfc.section.D.4">D.4</a>&nbsp;<a id="attribute-consensus" href="#attribute-consensus">The /rfc/@consensus Attribute</a></h2><p id="rfc.section.D.4.p.1">For some of the publication streams (see <a href="#attribute-submissiontype" title="The /rfc/@submissionType Attribute">Appendix&nbsp;D.3</a>), the "Status Of This Memo" section depends on whether there was a consensus to publish (again, see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.3"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</p><p id="rfc.section.D.4.p.2">The <samp>consensus</samp> attribute ("yes"/"no", defaulting to "yes") can be used to supply this information. The effect for the various streams is: </p><ul><li>"independent" and "IAB": none.</li><li>"IETF": mention that there was an IETF consensus.</li><li>"IRTF": mention that there was a research group consensus (where the name of the research group is extracted from the <samp>&lt;workgroup&gt;</samp> element).</li></ul><h2 id="rfc.section.D.5"><a href="#rfc.section.D.5">D.5</a>&nbsp;<a id="attribute-number" href="#attribute-number">The /rfc/@number Attribute</a></h2><p id="rfc.section.D.5.p.1">For RFCs, this attribute supplies the RFC number.</p><h2 id="rfc.section.D.6"><a href="#rfc.section.D.6">D.6</a>&nbsp;<a id="attribute-docname" href="#attribute-docname">The /rfc/@docName Attribute</a></h2><p id="rfc.section.D.6.p.1">For Internet Drafts, this specifies the draft name (which appears below the title). The file extension is <em>not</em> part of the draft, so in general it should end with the current draft number ("-", plus two digits).</p><div class="note" id="rfc.section.D.6.p.2"> <p> <b>Note:</b> "Idnits" (&lt;<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>&gt;) checks the in-document draft name for consistency with the filename of the submitted document.</p> </div><h2 id="rfc.section.D.7"><a href="#rfc.section.D.7">D.7</a>&nbsp;<a id="attribute-obsoletes" href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></h2><p id="rfc.section.D.7.p.1">The RFC Editor maintains a database (&lt;<a href="http://www.rfc-editor.org/rfc.html">http://www.rfc-editor.org/rfc.html</a>&gt;) of all RFCs, including information about which one obsoletes which. Upon publication of an RFC, this database is updated from the data on the front page.</p><p id="rfc.section.D.7.p.2">This attribute takes a list of comma-separated RFC <em>numbers</em>. Do <em>not</em> put the string "RFC" here.</p><h2 id="rfc.section.D.8"><a href="#rfc.section.D.8">D.8</a>&nbsp;<a id="attribute-updates" href="#attribute-updates">The /rfc/@updates Attribute</a></h2><p id="rfc.section.D.8.p.1">This is like <samp>obsoletes</samp>, but for the "updates" relation.</p><hr class="noprint"><h1 id="rfc.section.E" class="np"><a href="#rfc.section.E">E.</a>&nbsp;<a id="license" href="#license">License</a></h1><p id="rfc.section.E.p.1">Copyright (c) 2006-2010, Julian Reschke (julian.reschke@greenbytes.de)</p><p id="rfc.section.E.p.2">All rights reserved.</p><p id="rfc.section.E.p.3">Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: </p><ul><li>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</li><li>Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</li><li>Neither the name of Julian Reschke nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</li></ul><p id="rfc.section.E.p.4">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p><hr class="noprint"><h1 id="rfc.section.F" class="np"><a href="#rfc.section.F">F.</a>&nbsp;Change Logs</h1><h2 id="rfc.section.F.1"><a href="#rfc.section.F.1">F.1</a>&nbsp;Package</h2><dl><dt>2006-01-01</dt><dd>Switch to BSD License.</dd><dt>2007-01-12</dt><dd>Update to xml2rfc v1.33pre2.</dd><dt>2007-03-31</dt><dd>Update to xml2rfc v1.33pre3.</dd><dt>2007-05-01</dt><dd>Add XSLT test cases.</dd><dt>2008-07-18</dt><dd>Experimental support for inlined rdf:Description elements (ignored by the formatter, extracted by rfc2629grddl).</dd><dt>2008-12-04</dt><dd>Update to xml2rfc v1.34pre2.</dd><dt>2009-02-24</dt><dd>Experimental support for February 2009 boilerplate changes, and for the x:boilerplate element.</dd><dt>2009-07-08</dt><dd>Support new boilerplate ordering in RFCs published since July 2009. Fix problems with one-column text tables.</dd><dt>2009-07-19</dt><dd>When possible, calculate the actual Expiry date for Internet Drafts (full date must be available).</dd><dt>2009-08-01</dt><dd>For '$xml2rfc-ext-authors-section='end'", move the index in front of the authors section.</dd><dt>2009-08-04</dt><dd>Consider /rfc/@ipr="pre5378Trust200902" when producing RFCs, not IDs.</dd><dt>2009-08-29</dt><dd>Support alignment for artwork containing images (as opposed to, well, artwork).</dd><dt>2009-09-01</dt><dd>Allow xref in cref (as extension).</dd><dt>2009-09-14</dt><dd>Refactor handling of processing instructions.</dd><dt>2009-09-24</dt><dd>Fix typo in Status Of This Memo, present since November 2008. Fix formatting of iprExtract attribute. Starting with Internet Draft publication dates after 2009-11-30: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Add support for refparent PI. For RFCs: use new TLP text as of September 2009. Incorporate xml2rfc v1.34pre4.</dd><dt>2009-10-06</dt><dd>Starting with Internet Draft publication dates after 2009-10-31: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Incorporate xml2rfc v1.34pre5.</dd><dt>2009-10-27</dt><dd>Upgrade to xml2rfc v1.34.</dd><dt>2010-01-08</dt><dd>For RFC generation (not IDs), experimentally support RFC 5741 headers and boilerplate and Trust Legal Provisions 4.0.</dd><dt>2010-03-31</dt><dd>Upgrade to xml2rfc v1.35.</dd><dt>2010-06-27</dt><dd>Be consistent with xml2rfc.tcl in formatting initials (truncate after the first); see &lt;<a href="http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10">http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10</a>&gt;.</dd><dt>2010-08-31</dt><dd>Experimental support for prose in references.</dd><dt>2011-01-27</dt><dd>Update to xml2rfc v1.36pre1.</dd><dt>2011-04-17</dt><dd>Update to xml2rfc v1.36. Add support for more /rfc/@ipr values when producing RFCs.</dd></dl><h2 id="rfc.section.F.2"><a href="#rfc.section.F.2">F.2</a>&nbsp;amazon-asin.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2005-04-02</dt><dd>Fix two DTD issues.</dd></dl><h2 id="rfc.section.F.3"><a href="#rfc.section.F.3">F.3</a>&nbsp;check-references.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2004-05-11</dt><dd>Add document status; print references type.</dd><dt>2005-01-01</dt><dd>Add experimental check for ID status.</dd><dt>2005-04-01</dt><dd>Add fixes from Bill Fenner.</dd><dt>2005-12-03</dt><dd>Add checks against local copy of &lt;<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>&gt;.</dd><dt>2006-07-22</dt><dd>Add checks for standards levels.</dd><dt>2006-08-06</dt><dd>"check-ietf-references.xslt" replaced by "check-references.xslt".</dd><dt>2007-01-04</dt><dd>Use information online at &lt;<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>&gt; to retrieve Internet-Draft status information.</dd><dt>2007-06-16</dt><dd>Fix bug looking up ref type when inside change markup.</dd><dt>2008-06-14</dt><dd>Enhance output when draft was updated, and then published as RFC.</dd><dt>2008-07-12</dt><dd>Add XSLT2-based link target checking.</dd><dt>2008-08-10</dt><dd>Change keywords for "intended-level" to proposed/draft/internet, optionally extract intended level from /rfc/@x:maturity-level attribute.</dd></dl><h2 id="rfc.section.F.4"><a href="#rfc.section.F.4">F.4</a>&nbsp;gen-reference-graph.xslt</h2><dl><dt>2006-09-03</dt><dd>New.</dd><dt>2007-06-07</dt><dd>Use <a href="http://dpcarlisle.blogspot.com/2007/05/exslt-node-set-function.html">Carlisle method</a> to define exslt:node-set in msxsml (which means that the stylesheet can now be used with MSXML as well).</dd><dt>2007-10-15</dt><dd>Use W3C data from tr.rdf as well (experimental).</dd></dl><h2 id="rfc.section.F.5"><a href="#rfc.section.F.5">F.5</a>&nbsp;rfc2629.xslt</h2><dl><dt>2001-03-28</dt><dd>Code rearranged, generate numbered section anchors for paragraphs (t) as well. Fixes in index handling.</dd><dt>2001-04-12</dt><dd>Moved HTML output into XHTML namespace.</dd><dt>2001-10-02</dt><dd>Fixed default location for RFCs and numbering of section references. Support ?rfc editing processing instruction.</dd><dt>2001-10-07</dt><dd>Made telephone number links active.</dd><dt>2001-10-08</dt><dd>Support for vspace element.</dd><dt>2001-10-09</dt><dd>Experimental support for rfc-issue PI.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-12-17</dt><dd>Support title attribute on references element</dd><dt>2002-01-05</dt><dd>Support for list/@style="@format"</dd><dt>2002-01-09</dt><dd>Display "closed" RFC issues as deleted</dd><dt>2002-01-14</dt><dd>Experimentally and optionally parse XML encountered in artwork elements (requires MSXSL).</dd><dt>2002-01-27</dt><dd>Some cleanup. Moved RFC issues from PIs into namespaced elements.</dd><dt>2002-01-29</dt><dd>Added support for sortrefs PI. Added support for figure names.</dd><dt>2002-02-07</dt><dd>Highlight parts of artwork which are too wide (72 characters).</dd><dt>2002-02-12</dt><dd>Code rearrangement for static texts. Fixes for section numbering. TOC generation rewritten.</dd><dt>2002-02-15</dt><dd>Support for irefs in sections; support iref @primary=true</dd><dt>2002-03-03</dt><dd>Moved anchor prefix into a constant. Added sanity checks on user anchor names.</dd><dt>2002-03-23</dt><dd>Bugfix in detection of matching org names when creating the header. Fixed sorting in subitems.</dd><dt>2002-04-02</dt><dd>Fix TOC link HTML generation when no TOC is generated (created broken HTML table code).</dd><dt>2002-04-03</dt><dd>Made rendering of references more tolerant re: missing parts.</dd><dt>2002-04-08</dt><dd>Fixed reference numbering when references are split into separate sections.</dd><dt>2002-04-16</dt><dd>Fix default namespace (shouldn't be set for HTML output method).</dd><dt>2002-04-19</dt><dd>Lowercase internal CSS selectors for Mozilla compliance. Do not put TOC into ul element.</dd><dt>2002-04-21</dt><dd>Make numbered list inside numbered lists use alphanumeric numbering.</dd><dt>2002-05-05</dt><dd>Updated issue/editing support.</dd><dt>2002-05-15</dt><dd>Bugfix for section numbering after introduction of ed:replace</dd><dt>2002-06-21</dt><dd>When producing private documents, do not include document status, copyright etc.</dd><dt>2002-07-08</dt><dd>Fix xrefs to Appendices.</dd><dt>2002-07-19</dt><dd>Make artwork lightyellow for easier reading. (fielding)</dd><dt>2002-10-09</dt><dd>Translate references title to anchor name to avoid non-uri characters. (fielding)</dd><dt>2002-10-13</dt><dd>Support for tocdepth PI.</dd><dt>2002-11-03</dt><dd>Added temporariry workaround for Mozilla/Transformiix result tree fragment problem. (search for 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')</dd><dt>2002-12-25</dt><dd>xref code: attempt to uppercase "section" and "appendix" when at the start of a sentence.</dd><dt>2003-02-02</dt><dd>fixed code for vspace blankLines="0", enhanced display for list with "format" style, got rid of HTML blockquote elements, added support for "hangIndent"</dd><dt>2003-04-10</dt><dd>experimental support for appendix and spanx elements</dd><dt>2003-04-19</dt><dd>fixed counting of list numbers in "format %" styles (one counter per unique format string). Added more spanx styles.</dd><dt>2003-05-02</dt><dd>experimental texttable support</dd><dt>2003-05-02</dt><dd>Make mailto links optional (default = none) (jre: default and PI name changed) (fielding)</dd><dt>2003-05-04</dt><dd>experimental support for HTML link elements; fix default for table header alignment default</dd><dt>2003-05-06</dt><dd>support for "background" PI.</dd><dt>2003-05-11</dt><dd>change %c format to lowercase alphabetic. add support for keyword elements (generate META tag). fix various HTML conformance problems. added experimental support for role attribute. do not number paragraphs in unnumbered sections. update boilerplate texts. support for "iprnotified" PI. bugfix list numbering. strip whitespace when building tel: URIs.</dd><dt>2003-05-12</dt><dd>more conformance fixes (layout moved into CSS, move lists and figures out of para content, do not use tables for list formatting)</dd><dt>2003-05-13</dt><dd>add DC.Creator meta tag, refactoring</dd><dt>2003-05-16</dt><dd>put nbsps between "section" and section number (xref).</dd><dt>2003-05-18</dt><dd>author summary: add missing comma.</dd><dt>2003-06-06</dt><dd>fix index generation bug (transposed characters in key generation). Enhance sentence start detection (xref starting a section was using lowercase "section").</dd><dt>2003-06-22</dt><dd>exp. support for xref/@format. Add missing support for eref w/o content. exp. support for annotations in reference elements. Code cleanup reference table formatting.</dd><dt>2003-07-09</dt><dd>Another fix for DC.Creator meta tag creation based on RFC2731</dd><dt>2003-07-24</dt><dd>Fix namespace name for DC.Creator.</dd><dt>2003-08-06</dt><dd>Cleanup node-set support (only use exslt (saxon, xalan, libxslt) extension functions; remove Transformix workarounds that stopped to work in Moz 1.4)</dd><dt>2003-08-09</dt><dd>Generate HTML lang tag.</dd><dt>2003-08-10</dt><dd>Map spanx/verb to HTML "samp" element. Fix author name display in references (reverse surname/initials for last author), add "Ed.". Fix internal bookmark generation.</dd><dt>2003-08-17</dt><dd>Add DCMI dates, identifiers and abstract. Add PI to suppress DCMI generation. Do not add TOC entry to Copyright Statement when there is none. Align RFC2629 PI names and parameter names. Change style for inline URIs generated by eref. Add header and footer support. Enhance CSS paging properties. Support topblock PI. Added hooks for proper XHTML generation through separate XSLT. Enhance warning and error messages. Add support for artwork image display. Table formatting fixes (borders, thead continuation).</dd><dt>2003-08-18</dt><dd>Add workaround for MSXML4 node-set and Mozilla node-set issues (fallback just displays are warning).</dd><dt>2003-10-06</dt><dd>Add workaround for broken pre/ins handling in Mozilla (see &lt;<a href="http://bugzilla.mozilla.org/show_bug.cgi?id=204401">http://bugzilla.mozilla.org/show_bug.cgi?id=204401</a>&gt;). Make use of cite attribute on ed:replace. CSS cleanup.</dd><dt>2003-10-08</dt><dd>Fix minor issue detecting the same org for the header (caused by IE's non-standard whitespace handling). Fix default handling for /rfc/@category.</dd><dt>2003-11-09</dt><dd>Inherit ed:entered-by from ancestor elements. Change CSS color for inserted text to green. Generate issues-list anchor. Do not complain about missing targets when the xref element is below ed:del. Remove code that attempted to distinguish section/Section when producing links - always use uppercase. Fix date rendering for issue resolutions.</dd><dt>2003-11-29</dt><dd>Fix color values for table backgrounds for issue rendering. Change rendering of issue links to use inline-styles. Add colored issue markers to issues.</dd><dt>2003-12-13</dt><dd>Fix inheritance of ed:entered-by attribute. Display note elements inside change tracking as well.</dd><dt>2004-01-18</dt><dd>When PI compact = 'yes', make most CSS print page breaks conditional.</dd><dt>2004-02-20</dt><dd>Support for RFC3667 IPR changes (xml2rfc 1.22); see &lt;<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html</a>&gt;.</dd><dt>2004-03-11</dt><dd>Add "(if approved)" to "updates" and "obsoletes" unless the document has an RFC number.</dd><dt>2004-04-01</dt><dd>Fix RFC3667 output, see &lt;<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html</a>&gt;.</dd><dt>2004-04-04</dt><dd>Add support for section/top attribute. Move references into plain section container.</dd><dt>2004-04-06</dt><dd>Do not emit identical para anchors for deleted content.</dd><dt>2004-04-14</dt><dd>Fix references TOC generation when there are no references.</dd><dt>2004-04-24</dt><dd>Fix RFC3667 output, see &lt;<a href="http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html">http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html</a>&gt;.</dd><dt>2004-05-09</dt><dd>Add custom support for generating compound index documents. Add anchors for each Index letter. Add experimental cref support. Fix conditional page breaks before References section.</dd><dt>2004-05-16</dt><dd>Refactor external index generation.</dd><dt>2004-05-20</dt><dd>Rewrite anchor generation for comments.</dd><dt>2004-05-22</dt><dd>Enhance issues rendering (add links to changes).</dd><dt>2004-05-30</dt><dd>Allow single quote as delimiter in processing instructions as well. Move block-level issue pointers to floats. Disable issue pointers for print media. Add "purple numbers". Add hrefs to section headings. Add non-printing index key letter list to start of index.</dd><dt>2004-06-01</dt><dd>Use &amp;#xb6; instead of # for PNs.</dd><dt>2004-07-18</dt><dd>Add support for list style=letters (thanks Roy F.). Make PNs optional; add new PI.</dd><dt>2004-09-05</dt><dd>Fix index links into unnumbered sections. Bring IPR boilerplate in-line with xml2rfc 1.25. Add experimental CSS3 paged media support. Various HTML fixes.</dd><dt>2004-09-21</dt><dd>Enhance checking of artwork width.</dd><dt>2004-09-26</dt><dd>Add check for unused references. Uppercase letters in list style letters when nested into another list.</dd><dt>2004-10-10</dt><dd>Fix internal change track pointers.</dd><dt>2004-11-01</dt><dd>Allow change tracking on references (as a whole). Rewrite artwork handling so that it allows change tracking inside artwork. Also allow a subset of text markup inside artwork, such as xrefs (note this requires post-processing the source to make it compliant to RFC2629bis).</dd><dt>2004-11-03</dt><dd>Enhanced placement of iref anchors.</dd><dt>2004-11-06</dt><dd>Index: display irefs that appeared (with primary=true) inside artwork elements in a monospaced font.</dd><dt>2004-11-14</dt><dd>Add special code so that changes in section titles can be change-tracked.</dd><dt>2005-01-14</dt><dd>Bugfixes for HtmlToXhtml converter.</dd><dt>2005-01-22</dt><dd>Enhance generation of HTML h* elements (for Mozilla Outliner).</dd><dt>2005-01-31</dt><dd>Put vertical space around top-level TOC entries in TOC. Switch to pt-based CSS. Re-arrange top section. Make hr elements reflect new-page settings in TXT output (compact-PI). Fix page number in footer (CSS print) and add some more experimental support for paged media (tested with Prince 4.1 alpha). Rewrite TOC and Index generation to generate HTML lists. Cleanup id generation for paragraphs. Reduce whitespace in output. Fix vspace implementation. Use right/left dqoutes and copyright sign where appropriate.</dd><dt>2005-02-04</dt><dd>Add &lt;link&gt; element to references section. Fix newly introduced bug in references processing.</dd><dt>2005-02-05</dt><dd>Integrate various fixes/enhancements by Roy Fielding: spelling of "Authors' Addresses", comma setting in references, position of "Authors" section, optionally place authors addresses at end (PI), trailing dots in section numbers, switch to verdana default font in CSS. Add experimental support for centered artwork.</dd><dt>2005-02-09</dt><dd>Fixes in spacing and links of references section titles. Enhance sorting in references when change tracking is in place. Re-add figure centering support. Add missing 2nd part of "Author's Adresses" fix.</dd><dt>2005-02-25</dt><dd>Align section number format with xml2rfc1.29.</dd><dt>2005-03-28</dt><dd>Get rid of table elements in Author's section. Add experimental hCard (&lt;<a href="http://developers.technorati.com/wiki/hCard">http://developers.technorati.com/wiki/hCard</a>&gt;) support.</dd><dt>2005-04-03</dt><dd>Add RFC3978-style IPR statement support. (fenner@research.att.com)</dd><dt>2005-04-11</dt><dd>Cleanup author display. hCard related fixes.</dd><dt>2005-05-07</dt><dd>Minor fixes to allow change tracking in doc title. Add experimental support for table border styles. CSS cleanup.</dd><dt>2005-06-18</dt><dd>Implement missing support for references to texttables.</dd><dt>2005-09-25</dt><dd>Use (-moz-)column-count when printing the index.</dd><dt>2005-10-04</dt><dd>Report missing element templates with xsl:message.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2005-10-23</dt><dd>More workarounds for Mozilla's broken del/ins handling (this time for figures).</dd><dt>2005-10-27</dt><dd>lowercase hCard class names</dd><dt>2005-11-22</dt><dd>Enhance diagnostics for XML-in-artwork extension</dd><dt>2005-11-26</dt><dd>Fix formatting of section numbers for sections inserted into &lt;back&gt;.</dd><dt>2005-12-12</dt><dd>Fix some validity problems when change tracking occured inside lists.</dd><dt>2005-12-18</dt><dd>Add change tracking inside the index.</dd><dt>2006-02-04</dt><dd>Add prev/next links to highlighted changes (change tracking extension).</dd><dt>2006-02-10</dt><dd>Catch errors instantiating MSXML component.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-02-27</dt><dd>Fix front matter (lowercase Internet-Draft, say "Intended status" for non-RFC documents). Start work on experimental extension for simplified internal links.</dd><dt>2006-03-19</dt><dd>Tweaks to IESG Copyright stuff; support submissionType attribute. Fix duplicate reference anchors in HTML output. Reduce HTML Tidy warnings. Fix reference to normative ASCII version (now requires trailing ".txt"). Tweaks to hCard generation. Started to move non-issue-tracking extensions into namespace "http://purl.org/net/xml2rfc/ext".</dd><dt>2006-03-27</dt><dd>Moved "simple reference" extension into namespace "http://purl.org/net/xml2rfc/ext" and add documentation. HTML conformance enhancements.</dd><dt>2006-04-02</dt><dd>Cleanup special code for automated XHTML XSLT generation.</dd><dt>2006-04-21</dt><dd>Generate &lt;CITE&gt; elements where appropiate. Introduce x:blockquote, x:dfn, x:h and x:q elements.</dd><dt>2006-05-06</dt><dd>Introduce x:bcp14 element.</dd><dt>2006-05-14</dt><dd>Fix content model for x:blockquote.</dd><dt>2006-06-18</dt><dd>Add box drawing support (x:bt, x:bc, x:bb).</dd><dt>2006-06-20</dt><dd>HTML validity fixes (legal chars in anchors in index).</dd><dt>2006-06-24</dt><dd>Reduce leading empty lines in artwork. Move &lt;dt&gt; style info into CSS.</dd><dt>2006-07-14</dt><dd>Fix rendering of multiple street address entries (missing line break).</dd><dt>2006-07-24</dt><dd>Add extension for deep linking into RFCs, do not generate empty list items in TOC output, avoid empty &lt;dt&gt; elements for list items without hangText attribute.</dd><dt>2006-08-01</dt><dd>Allow @anchor on more elements; start work on Relax NG grammar for extensions. Reduce generated style elements (use CSS classes instead). Consistently use "id" instead of "name". Change default target for RFC links to "http://tools.ietf.org/html/rfcNNNN".</dd><dt>2006-08-06</dt><dd>Include appendices defined in &lt;appendix&gt; elements in TOC (please consider them deprecated anyhow!). Generate links to "http://tools.ietf.org/html/draft-*" for Internet Drafts. Replace x:frag by x:rel, allowing any kind of relative reference instead of just fragments.</dd><dt>2006-08-30</dt><dd>Reduce textual differences between HTML output and what xml2rfc produces in TXT output mode (section refs/reference targets). Add small workaround for Opera 9.0.1's problem with node-set().</dd><dt>2006-10-29</dt><dd>Fix problem generating internal links to change markup within references section. Enhancements when generating numbered references for deleted references. Allow inclusion of references into the index (through include-references-in-index extension). Fix a bug that caused the newer version of the IETF boilerplate to be produced rather than the pre-RFC3667 one. Update to RFC4287 boilerplate.</dd><dt>2006-11-11</dt><dd>Add extension attribute x:for-anchor to &lt;iref&gt; handling.</dd><dt>2006-11-26</dt><dd>Experimental (and limited) support for &lt;x:lt&gt;.</dd><dt>2006-12-04</dt><dd>Fix bugs in processing documents that have both the ipr and the number attribute set on the rfc root element. Add support for x:fmt='none' on xrefs. Add different pre style based on artwork type attributes (experimental).</dd><dt>2006-12-13</dt><dd>Add x:fmt='anchor' for xref elements.</dd><dt>2007-01-07</dt><dd>Fix root template for compatibility for the exslt:node-set implementation in Firefox3.</dd><dt>2007-01-29</dt><dd>Avoid empty table entry in front matter when organization is not specified for an author.</dd><dt>2007-02-10</dt><dd>Allow change tracking in table rows.</dd><dt>2007-03-09</dt><dd>Add hcard profile URI (&lt;<a href="http://www.w3.org/2006/03/hcard">http://www.w3.org/2006/03/hcard</a>&gt;) to head element. Add warning for misplaced &lt;t&gt; elements (after section).</dd><dt>2007-03-21</dt><dd>Fix internal linking from reference entries in index for some xref types. Minor CSS tweaks contributed by MTR. Allow turning on text justification through a PI. Improve iref anchor generation to generate less instable anchors.</dd><dt>2007-03-28</dt><dd>Fixes for numbering of ed:inserted references sections.</dd><dt>2007-05-04</dt><dd>Do not generate anchors for edits in deleted sections. Enhance HTML conformance.</dd><dt>2007-05-19</dt><dd>Enhance diagnostics when using Saxon (needs Saxon's "-l" command line parameter to keep line number information). Add warning when symref PI is missing (default will change in the future). Add support for overriding computed section numbers (when formatting historic documents).</dd><dt>2007-06-07</dt><dd>Change default for symrefs PI to "yes" (see change in xml2rfc 1.33pre4). Warn about docName attributes that appear to contain a file extension.</dd><dt>2007-06-26</dt><dd>Workaround author/@initials values without trailing dot, as in xml2rfc.tcl.</dd><dt>2007-07-14</dt><dd>Enhance index generation for references that use @x:sec attribute.</dd><dt>2007-09-09</dt><dd>Fix: sortrefs is a nop when symrefs=no.</dd><dt>2007-10-17</dt><dd>Work in progress: add support for referencing sections in sibling documents by anchor name.</dd><dt>2007-10-17</dt><dd>Work in progress (continued): support for referencing sections in sibling documents by anchor name.</dd><dt>2007-12-31</dt><dd>Emit warning when updating/obsoleting stuff that's not referenced.</dd><dt>2008-02-03</dt><dd>Support xml2rfc-1.33pre5's suppress-title attribute on texttable and figure.</dd><dt>2008-02-06</dt><dd>Extension: allow &lt;eref&gt; below &lt;cref&gt;.</dd><dt>2008-02-17</dt><dd>Extensions: add x:span and x:length-of.</dd><dt>2008-02-20</dt><dd>Add new RFC boilerplate (as changed in 2007-08).</dd><dt>2008-02-27</dt><dd>Improve diagnostics for artwork width problems; add defaulting of publication dates (requires XSLT processor supporting exslt:date, or msxml).</dd><dt>2008-02-29</dt><dd>Enhance CSS for link elements in the front header, update rules for generating "Acknowledgment" statement.</dd><dt>2008-03-01</dt><dd>Use line numbers in diagnostics in Saxon8/9 as well.</dd><dt>2008-03-02</dt><dd>Fix a bug in the logic choosing the boilerplate, resulting in obsolete text being inserted into IDs.</dd><dt>2008-04-01</dt><dd>Add support for superscript element.</dd><dt>2008-06-28</dt><dd>Add sanity checks for email addresses, allow multiple email elements.</dd><dt>2008-07-06</dt><dd>Add x:abnf-char-sequence.</dd><dt>2008-08-21</dt><dd>Add x:note.</dd><dt>2008-09-06</dt><dd>Add experimental support for SVG images.</dd><dt>2008-09-17</dt><dd>Add experimental support for x:author. Fix xref/@format=none.</dd><dt>2008-10-10</dt><dd>Fix a huge bug, causing text content after an XML comment to be ignored.</dd><dt>2009-02-24</dt><dd>Use table/caption when needed.</dd><dt>2009-03-07</dt><dd>Fix bug that caused text to disappear in the output in presence of processing instructions.</dd><dt>2009-03-12</dt><dd>Make inlined comments bookmarkable.</dd><dt>2009-04-09</dt><dd>Upgrade to DC-HTML from RFC 2731 (affects head/@profile).</dd><dt>2009-07-08</dt><dd>Remove table/@summary in output; the value getting inserted was just repeating stuff that appeared in the preamble.</dd><dt>2009-08-01</dt><dd>Implement table alignment (HTML output only for now).</dd><dt>2009-08-18</dt><dd>Replicate Dublin Core "abstract" metadata into meta/@name=description (search engines do use it).</dd><dt>2009-09-02</dt><dd>Fix default/left alignment of table columns, remove silly table summmary attributes.</dd><dt>2009-09-24</dt><dd>Support double-sided layout using CSS page:left/right selectors.</dd><dt>2009-11-27</dt><dd>Generate unordered lists instead of broken definition lists for list style empty.</dd></dl><h2 id="rfc.section.F.6"><a href="#rfc.section.F.6">F.6</a>&nbsp;rfc2629toFO.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2003-11-29</dt><dd>Enhance handling of unknown list styles.</dd><dt>2004-04-04</dt><dd>Update reference section handling.</dd><dt>2004-04-17</dt><dd>Use XSL-WD-1.1-style fo:bookmark and index handling and add postprocessors for existing implementations. Unify PDF info generation by using XEP (postprocessors) will convert.</dd><dt>2004-04-20</dt><dd>Add experimental cref support.</dd><dt>2004-06-14</dt><dd>Set correct index-item defaults.</dd><dt>2004-07-18</dt><dd>Add list style=letters.</dd><dt>2004-09-03</dt><dd>Make URLs in text break where they are allowed to break by inserting zero-width spaces.</dd><dt>2004-09-26</dt><dd>Fix letter-style inside nested lists.</dd><dt>2004-10-31</dt><dd>Update handling of artwork.</dd><dt>2004-11-13</dt><dd>Fix handling of references inside ed:* markup. Fix whitespace handling in artwork.</dd><dt>2004-11-27</dt><dd>Irefs in artwork generate monospaced entries in index.</dd><dt>2005-01-31</dt><dd>Fix TOC generation that was broken after changes in main XSLT.</dd><dt>2005-02-05</dt><dd>Bring in sync with cosmetic changes in rfc2629.xslt.</dd><dt>2005-05-07</dt><dd>Minor fix for change tracking in document title. Support for table styles.</dd><dt>2005-06-18</dt><dd>Fix references to tables.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd><dt>2007-03-21</dt><dd>Support optional text justification.</dd><dt>2007-05-19</dt><dd>Various improvements in spacing; also allow overriding the automatic list indentation via list/x:indent.</dd><dt>2009-04-08</dt><dd>Fix spacing in headers; add support for formatting for double-sided printing.</dd><dt>2009-08-01</dt><dd>Remove surplus empty pages when not generating double-sided output.</dd></dl><h2 id="rfc.section.F.7"><a href="#rfc.section.F.7">F.7</a>&nbsp;xsl11toAn.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><h2 id="rfc.section.F.8"><a href="#rfc.section.F.8">F.8</a>&nbsp;xsl11toFop.xslt</h2><dl><dt>2010-08-25</dt><dd>Switch to Apache FOP 1.0.</dd><dt>2009-09-12</dt><dd>Support for FOP 0.20.5 and FOP 0.93 removed. Please use FOP 0.95.</dd><dt>2008-03-15</dt><dd>Add a workaround to the fo:inline workaround (sigh).</dd></dl><h2 id="rfc.section.F.9"><a href="#rfc.section.F.9">F.9</a>&nbsp;xsl11toXep.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2004-09-04</dt><dd>Fix xep:index-item attributes.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><hr class="noprint"><h1 id="rfc.index" class="np"><a href="#rfc.index">Index</a></h1><p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.B">B</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.J">J</a> <a href="#rfc.index.K">K</a> <a href="#rfc.index.L">L</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.Q">Q</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.T">T</a> <a href="#rfc.index.X">X</a> </p><div class="print2col"><ul class="ind"><li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul><li>abnf-char-sequence Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.27"><b>11.1</b></a>, <a href="#rfc.iref.a.29">A</a></li><li>allow-markup-in-artwork PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.a.1">3.3</a></li><li>alternate HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.22">6.2</a></li><li>anchor-alias Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.28"><b>11.2</b></a>, <a href="#rfc.iref.a.30">A</a></li><li>Anchors&nbsp;&nbsp;<ul><li>rfc.abstract&nbsp;&nbsp;<a href="#rfc.iref.a.3">4</a></li><li>rfc.authors&nbsp;&nbsp;<a href="#rfc.iref.a.4">4</a></li><li>rfc.copyright&nbsp;&nbsp;<a href="#rfc.iref.a.5">4</a></li><li>rfc.copyrightnotice&nbsp;&nbsp;<a href="#rfc.iref.a.6">4</a></li><li>rfc.figure.n&nbsp;&nbsp;<a href="#rfc.iref.a.7">4</a>, <a href="#rfc.iref.a.18">4</a></li><li>rfc.figure.u.n&nbsp;&nbsp;<a href="#rfc.iref.a.8">4</a>, <a href="#rfc.iref.a.19">4</a></li><li>rfc.index&nbsp;&nbsp;<a href="#rfc.iref.a.9">4</a></li><li>rfc.ipr&nbsp;&nbsp;<a href="#rfc.iref.a.10">4</a></li><li>rfc.iref.n&nbsp;&nbsp;<a href="#rfc.iref.a.11">4</a></li><li>rfc.note.n&nbsp;&nbsp;<a href="#rfc.iref.a.12">4</a></li><li>rfc.references&nbsp;&nbsp;<a href="#rfc.iref.a.13">4</a>, <a href="#rfc.iref.a.14">4</a></li><li>rfc.section.n&nbsp;&nbsp;<a href="#rfc.iref.a.15">4</a></li><li>rfc.section.n.p.m&nbsp;&nbsp;<a href="#rfc.iref.a.16">4</a></li><li>rfc.status&nbsp;&nbsp;<a href="#rfc.iref.a.17">4</a></li><li>rfc.toc&nbsp;&nbsp;<a href="#rfc.iref.a.20">4</a></li><li>rfc.xref.name.n&nbsp;&nbsp;<a href="#rfc.iref.a.21">4</a></li></ul></li><li>AntennaHouse XSL Formatter&nbsp;&nbsp;<a href="#rfc.iref.a.26">9.1</a></li><li>Apache FOP&nbsp;&nbsp;<a href="#rfc.iref.a.25">9.1</a></li><li>appendix HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.23">6.2</a></li><li>assign-section-number Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.31">A</a></li><li>author HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.24">6.2</a></li><li>authors-section PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.a.2">3.3</a></li></ul></li><li><a id="rfc.index.B" href="#rfc.index.B"><b>B</b></a><ul><li>background PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.b.1">3.1</a></li><li>bb Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.3"><b>11.4</b></a>, <a href="#rfc.iref.b.8">A</a></li><li>bc Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.4"><b>11.5</b></a>, <a href="#rfc.iref.b.9">A</a></li><li>bcp14 Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.2"><b>11.3</b></a>, <a href="#rfc.iref.b.10">A</a></li><li><em>BCP97</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP97.1">12.1</a>, <a href="#BCP97"><b>13</b></a></li><li>blockquote Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.5"><b>11.6</b></a>, <a href="#rfc.iref.b.11">A</a></li><li>boilerplate Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.6"><b>11.7</b></a>, <a href="#rfc.iref.b.12">A</a></li><li>bt Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.7"><b>11.8</b></a>, <a href="#rfc.iref.b.13">A</a></li></ul></li><li><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul><li>chapter HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.3">6.2</a></li><li>CHM format&nbsp;&nbsp;<a href="#rfc.iref.c.7">8</a></li><li>comments PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.c.2">3.1</a></li><li>compact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.c.1">3.1</a></li><li>contents HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.4">6.2</a></li><li>copyright HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.5">6.2</a></li><li>Creator DCMI property&nbsp;&nbsp;<a href="#rfc.iref.c.6">6.4</a></li></ul></li><li><a id="rfc.index.D" href="#rfc.index.D"><b>D</b></a><ul><li>Date.Issued DCMI property&nbsp;&nbsp;<a href="#rfc.iref.d.3">6.4</a></li><li><em>DC-HTML</em>&nbsp;&nbsp;<a href="#rfc.xref.DC-HTML.1">6.4</a>, <a href="#DC-HTML"><b>13</b></a></li><li>DCMI properties&nbsp;&nbsp;<ul><li>Creator&nbsp;&nbsp;<a href="#rfc.iref.d.2">6.4</a></li><li>Date.Issued&nbsp;&nbsp;<a href="#rfc.iref.d.4">6.4</a></li><li>Description.Abstract&nbsp;&nbsp;<a href="#rfc.iref.d.6">6.4</a></li><li>Identifier&nbsp;&nbsp;<a href="#rfc.iref.d.7">6.4</a></li><li>isPartOf&nbsp;&nbsp;<a href="#rfc.iref.d.8">6.4</a></li><li>Relation.Replaces&nbsp;&nbsp;<a href="#rfc.iref.d.9">6.4</a></li></ul></li><li>Description.Abstract DCMI property&nbsp;&nbsp;<a href="#rfc.iref.d.5">6.4</a></li><li>dfn Extension Element&nbsp;&nbsp;<a href="#rfc.iref.d.10"><b>11.9</b></a>, <a href="#rfc.iref.d.11">A</a></li><li>duplex PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.d.1">3.3</a></li></ul></li><li><a id="rfc.index.E" href="#rfc.index.E"><b>E</b></a><ul><li>editing PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.e.1">3.1</a></li><li>Extension Elements&nbsp;&nbsp;<ul><li>abnf-char-sequence&nbsp;&nbsp;<a href="#rfc.iref.e.2"><b>11.1</b></a>, <a href="#rfc.iref.e.23">A</a></li><li>anchor-alias&nbsp;&nbsp;<a href="#rfc.iref.e.3"><b>11.2</b></a>, <a href="#rfc.iref.e.24">A</a></li><li>assign-section-number&nbsp;&nbsp;<a href="#rfc.iref.e.26">A</a></li><li>bb&nbsp;&nbsp;<a href="#rfc.iref.e.5"><b>11.4</b></a>, <a href="#rfc.iref.e.27">A</a></li><li>bc&nbsp;&nbsp;<a href="#rfc.iref.e.6"><b>11.5</b></a>, <a href="#rfc.iref.e.28">A</a></li><li>bcp14&nbsp;&nbsp;<a href="#rfc.iref.e.4"><b>11.3</b></a>, <a href="#rfc.iref.e.29">A</a></li><li>blockquote&nbsp;&nbsp;<a href="#rfc.iref.e.7"><b>11.6</b></a>, <a href="#rfc.iref.e.30">A</a></li><li>boilerplate&nbsp;&nbsp;<a href="#rfc.iref.e.8"><b>11.7</b></a>, <a href="#rfc.iref.e.31">A</a></li><li>bt&nbsp;&nbsp;<a href="#rfc.iref.e.9"><b>11.8</b></a>, <a href="#rfc.iref.e.32">A</a></li><li>dfn&nbsp;&nbsp;<a href="#rfc.iref.e.10"><b>11.9</b></a>, <a href="#rfc.iref.e.33">A</a></li><li>h&nbsp;&nbsp;<a href="#rfc.iref.e.11"><b>11.10</b></a>, <a href="#rfc.iref.e.34">A</a></li><li>highlight&nbsp;&nbsp;<a href="#rfc.iref.e.12"><b>11.11</b></a>, <a href="#rfc.iref.e.35">A</a></li><li>include-author&nbsp;&nbsp;<a href="#rfc.iref.e.25">A</a></li><li>length-of&nbsp;&nbsp;<a href="#rfc.iref.e.13"><b>11.12</b></a>, <a href="#rfc.iref.e.36">A</a></li><li>link&nbsp;&nbsp;<a href="#rfc.iref.e.14"><b>11.13</b></a>, <a href="#rfc.iref.e.37">A</a></li><li>lt&nbsp;&nbsp;<a href="#rfc.iref.e.15"><b>11.14</b></a>, <a href="#rfc.iref.e.38">A</a></li><li>note&nbsp;&nbsp;<a href="#rfc.iref.e.16"><b>11.15</b></a>, <a href="#rfc.iref.e.39">A</a></li><li>parse-xml&nbsp;&nbsp;<a href="#rfc.iref.e.17"><b>11.16</b></a>, <a href="#rfc.iref.e.40">A</a></li><li>prose&nbsp;&nbsp;<a href="#rfc.iref.e.18"><b>11.17</b></a>, <a href="#rfc.iref.e.41">A</a></li><li>q&nbsp;&nbsp;<a href="#rfc.iref.e.19"><b>11.18</b></a>, <a href="#rfc.iref.e.42">A</a></li><li>rdf:Description&nbsp;&nbsp;<a href="#rfc.iref.e.48">A</a></li><li>ref&nbsp;&nbsp;<a href="#rfc.iref.e.20"><b>11.19</b></a>, <a href="#rfc.iref.e.43">A</a></li><li>source&nbsp;&nbsp;<a href="#rfc.iref.e.21"><b>11.20</b></a>, <a href="#rfc.iref.e.44">A</a></li><li>span&nbsp;&nbsp;<a href="#rfc.iref.e.46">A</a></li><li>sup&nbsp;&nbsp;<a href="#rfc.iref.e.22"><b>11.21</b></a>, <a href="#rfc.iref.e.45">A</a></li><li>x&nbsp;&nbsp;<a href="#rfc.iref.e.47">A</a></li></ul></li></ul></li><li><a id="rfc.index.F" href="#rfc.index.F"><b>F</b></a><ul><li>Firefox&nbsp;&nbsp;<ul><li>1.*/2.*&nbsp;&nbsp;<a href="#rfc.iref.f.3">5.2</a></li><li>3.*&nbsp;&nbsp;<a href="#rfc.iref.f.2">5.2</a></li></ul></li><li>footer PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.f.1">3.1</a></li></ul></li><li><a id="rfc.index.G" href="#rfc.index.G"><b>G</b></a><ul><li>generator HTML META element&nbsp;&nbsp;<a href="#rfc.iref.g.2">6.3</a></li><li>Google Chrome&nbsp;&nbsp;<a href="#rfc.iref.g.1">5.2</a></li><li>Grammar&nbsp;&nbsp;<a href="#rfc.iref.g.3"><b>A</b></a></li></ul></li><li><a id="rfc.index.H" href="#rfc.index.H"><b>H</b></a><ul><li>h Extension Element&nbsp;&nbsp;<a href="#rfc.iref.h.12"><b>11.10</b></a>, <a href="#rfc.iref.h.14">A</a></li><li>header PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.h.1">3.1</a></li><li>highlight Extension Element&nbsp;&nbsp;<a href="#rfc.iref.h.13"><b>11.11</b></a>, <a href="#rfc.iref.h.15">A</a></li><li><em>HTML</em>&nbsp;&nbsp;<a href="#rfc.xref.HTML.1">6.1</a>, <a href="#rfc.xref.HTML.2">11.6</a>, <a href="#rfc.xref.HTML.3">11.9</a>, <a href="#rfc.xref.HTML.4">11.18</a>, <a href="#rfc.xref.HTML.5">11.21</a>, <a href="#HTML"><b>13</b></a></li><li>HTML compliance&nbsp;&nbsp;<a href="#rfc.iref.h.2">6.1</a></li><li>HTML LINK elements&nbsp;&nbsp;<ul><li>alternate&nbsp;&nbsp;<a href="#rfc.iref.h.3">6.2</a></li><li>appendix&nbsp;&nbsp;<a href="#rfc.iref.h.4">6.2</a></li><li>author&nbsp;&nbsp;<a href="#rfc.iref.h.5">6.2</a></li><li>chapter&nbsp;&nbsp;<a href="#rfc.iref.h.6">6.2</a></li><li>contents&nbsp;&nbsp;<a href="#rfc.iref.h.7">6.2</a></li><li>copyright&nbsp;&nbsp;<a href="#rfc.iref.h.8">6.2</a></li><li>index&nbsp;&nbsp;<a href="#rfc.iref.h.9">6.2</a></li></ul></li><li>HTML META elements&nbsp;&nbsp;<ul><li>generator&nbsp;&nbsp;<a href="#rfc.iref.h.10">6.3</a></li><li>keywords&nbsp;&nbsp;<a href="#rfc.iref.h.11">6.3</a></li></ul></li></ul></li><li><a id="rfc.index.I" href="#rfc.index.I"><b>I</b></a><ul><li>Identifier DCMI property&nbsp;&nbsp;<a href="#rfc.iref.i.10">6.4</a></li><li>include PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.3">3.2</a></li><li>include-author Extension Element&nbsp;&nbsp;<a href="#rfc.iref.i.12">A</a></li><li>include-references-in-index PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.4">3.3</a></li><li>index HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.i.9">6.2</a></li><li>inline PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.1">3.1</a></li><li>Internet Explorer 5.5&nbsp;&nbsp;<a href="#rfc.iref.i.5">5.2</a></li><li>Internet Explorer 6&nbsp;&nbsp;<a href="#rfc.iref.i.6">5.2</a></li><li>Internet Explorer 7&nbsp;&nbsp;<a href="#rfc.iref.i.7">5.2</a></li><li>Internet Explorer 8&nbsp;&nbsp;<a href="#rfc.iref.i.8">5.2</a></li><li>iprnotified PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.2">3.1</a></li><li>isPartOf DCMI property&nbsp;&nbsp;<a href="#rfc.iref.i.11">6.4</a></li></ul></li><li><a id="rfc.index.J" href="#rfc.index.J"><b>J</b></a><ul><li>justification PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.j.1">3.3</a></li></ul></li><li><a id="rfc.index.K" href="#rfc.index.K"><b>K</b></a><ul><li>keywords HTML META element&nbsp;&nbsp;<a href="#rfc.iref.k.1">6.3</a></li></ul></li><li><a id="rfc.index.L" href="#rfc.index.L"><b>L</b></a><ul><li>length-of Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.2"><b>11.12</b></a>, <a href="#rfc.iref.l.5">A</a></li><li>link Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.3"><b>11.13</b></a>, <a href="#rfc.iref.l.6">A</a></li><li>linkmailto PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.l.1">3.1</a></li><li>lt Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.4"><b>11.14</b></a>, <a href="#rfc.iref.l.7">A</a></li></ul></li><li><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul><li>Microsoft Help&nbsp;&nbsp;<a href="#rfc.iref.m.5">8</a></li><li>Mozilla&nbsp;&nbsp;<a href="#rfc.iref.m.3">5.2</a>, <a href="#rfc.iref.m.4">5.2</a></li><li>MSXML3&nbsp;&nbsp;<a href="#rfc.iref.m.1">5.1</a></li><li>MSXML4&nbsp;&nbsp;<a href="#rfc.iref.m.2">5.1</a></li></ul></li><li><a id="rfc.index.N" href="#rfc.index.N"><b>N</b></a><ul><li>needLines PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.n.1">3.2</a></li><li>NoScript&nbsp;&nbsp;<a href="#rfc.iref.n.2">5.2</a></li><li>note Extension Element&nbsp;&nbsp;<a href="#rfc.iref.n.3"><b>11.15</b></a>, <a href="#rfc.iref.n.4">A</a></li></ul></li><li><a id="rfc.index.O" href="#rfc.index.O"><b>O</b></a><ul><li>Opera&nbsp;&nbsp;<a href="#rfc.iref.o.1">5.2</a>, <a href="#rfc.iref.o.2">5.2</a></li></ul></li><li><a id="rfc.index.P" href="#rfc.index.P"><b>P</b></a><ul><li>Parameters&nbsp;&nbsp;<ul><li>xml2rfc-background&nbsp;&nbsp;<a href="#rfc.iref.p.2">3.1</a></li><li>xml2rfc-comments&nbsp;&nbsp;<a href="#rfc.iref.p.6">3.1</a></li><li>xml2rfc-compact&nbsp;&nbsp;<a href="#rfc.iref.p.4">3.1</a></li><li>xml2rfc-editing&nbsp;&nbsp;<a href="#rfc.iref.p.8">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.44">3.3</a></li><li>xml2rfc-ext-authors-section&nbsp;&nbsp;<a href="#rfc.iref.p.46">3.3</a></li><li>xml2rfc-ext-duplex&nbsp;&nbsp;<a href="#rfc.iref.p.48">3.3</a></li><li>xml2rfc-ext-include-references-in-index&nbsp;&nbsp;<a href="#rfc.iref.p.50">3.3</a></li><li>xml2rfc-ext-justification&nbsp;&nbsp;<a href="#rfc.iref.p.52">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.55">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots&nbsp;&nbsp;<a href="#rfc.iref.p.59">3.3</a></li><li>xml2rfc-ext-support-rfc2731&nbsp;&nbsp;<a href="#rfc.iref.p.57">3.3</a></li><li>xml2rfc-footer&nbsp;&nbsp;<a href="#rfc.iref.p.10">3.1</a></li><li>xml2rfc-header&nbsp;&nbsp;<a href="#rfc.iref.p.12">3.1</a></li><li>xml2rfc-inline&nbsp;&nbsp;<a href="#rfc.iref.p.14">3.1</a></li><li>xml2rfc-iprnotified&nbsp;&nbsp;<a href="#rfc.iref.p.16">3.1</a></li><li>xml2rfc-linkmailto&nbsp;&nbsp;<a href="#rfc.iref.p.18">3.1</a></li><li>xml2rfc-private&nbsp;&nbsp;<a href="#rfc.iref.p.21">3.1</a></li><li>xml2rfc-refparent&nbsp;&nbsp;<a href="#rfc.iref.p.23">3.1</a></li><li>xml2rfc-rfcedstyle&nbsp;&nbsp;<a href="#rfc.iref.p.25">3.1</a></li><li>xml2rfc-sortrefs&nbsp;&nbsp;<a href="#rfc.iref.p.27">3.1</a></li><li>xml2rfc-symrefs&nbsp;&nbsp;<a href="#rfc.iref.p.29">3.1</a></li><li>xml2rfc-toc&nbsp;&nbsp;<a href="#rfc.iref.p.31">3.1</a></li><li>xml2rfc-tocdepth&nbsp;&nbsp;<a href="#rfc.iref.p.33">3.1</a></li><li>xml2rfc-topblock&nbsp;&nbsp;<a href="#rfc.iref.p.35">3.1</a></li></ul></li><li>parse-xml Extension Element&nbsp;&nbsp;<a href="#rfc.iref.p.60"><b>11.16</b></a>, <a href="#rfc.iref.p.62">A</a></li><li>parse-xml-in-artwork PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.p.53">3.3</a></li><li>private PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.p.19">3.1</a>, <a href="#rfc.iref.p.64">D</a></li><li>Processing Instruction pseudo attributes&nbsp;&nbsp;<ul><li>allow-markup-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.43">3.3</a></li><li>authors-section&nbsp;&nbsp;<a href="#rfc.iref.p.45">3.3</a></li><li>background&nbsp;&nbsp;<a href="#rfc.iref.p.1">3.1</a></li><li>comments&nbsp;&nbsp;<a href="#rfc.iref.p.5">3.1</a></li><li>compact&nbsp;&nbsp;<a href="#rfc.iref.p.3">3.1</a></li><li>duplex&nbsp;&nbsp;<a href="#rfc.iref.p.47">3.3</a></li><li>editing&nbsp;&nbsp;<a href="#rfc.iref.p.7">3.1</a></li><li>footer&nbsp;&nbsp;<a href="#rfc.iref.p.9">3.1</a></li><li>header&nbsp;&nbsp;<a href="#rfc.iref.p.11">3.1</a></li><li>ijustification&nbsp;&nbsp;<a href="#rfc.iref.p.51">3.3</a></li><li>include&nbsp;&nbsp;<a href="#rfc.iref.p.36">3.2</a></li><li>include-references-in-index&nbsp;&nbsp;<a href="#rfc.iref.p.49">3.3</a></li><li>inline&nbsp;&nbsp;<a href="#rfc.iref.p.13">3.1</a></li><li>iprnotified&nbsp;&nbsp;<a href="#rfc.iref.p.15">3.1</a></li><li>linkmailto&nbsp;&nbsp;<a href="#rfc.iref.p.17">3.1</a></li><li>needLines&nbsp;&nbsp;<a href="#rfc.iref.p.37">3.2</a></li><li>parse-xml-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.54">3.3</a></li><li>private&nbsp;&nbsp;<a href="#rfc.iref.p.20">3.1</a>, <a href="#rfc.iref.p.65">D</a></li><li>refparent&nbsp;&nbsp;<a href="#rfc.iref.p.22">3.1</a></li><li>rfcedstyle&nbsp;&nbsp;<a href="#rfc.iref.p.24">3.1</a></li><li>sec-no-trailing-dots&nbsp;&nbsp;<a href="#rfc.iref.p.58">3.3</a></li><li>slides&nbsp;&nbsp;<a href="#rfc.iref.p.38">3.2</a></li><li>sortrefs&nbsp;&nbsp;<a href="#rfc.iref.p.26">3.1</a></li><li>strict&nbsp;&nbsp;<a href="#rfc.iref.p.39">3.2</a></li><li>subcompact&nbsp;&nbsp;<a href="#rfc.iref.p.40">3.2</a></li><li>support-rfc2731&nbsp;&nbsp;<a href="#rfc.iref.p.56">3.3</a></li><li>symrefs&nbsp;&nbsp;<a href="#rfc.iref.p.28">3.1</a></li><li>toc&nbsp;&nbsp;<a href="#rfc.iref.p.30">3.1</a></li><li>tocdepth&nbsp;&nbsp;<a href="#rfc.iref.p.32">3.1</a></li><li>tocindent&nbsp;&nbsp;<a href="#rfc.iref.p.41">3.2</a></li><li>tocompact&nbsp;&nbsp;<a href="#rfc.iref.p.42">3.2</a></li><li>topblock&nbsp;&nbsp;<a href="#rfc.iref.p.34">3.1</a></li></ul></li><li>prose Extension Element&nbsp;&nbsp;<a href="#rfc.iref.p.61"><b>11.17</b></a>, <a href="#rfc.iref.p.63">A</a></li></ul></li><li><a id="rfc.index.Q" href="#rfc.index.Q"><b>Q</b></a><ul><li>q Extension Element&nbsp;&nbsp;<a href="#rfc.iref.q.1"><b>11.18</b></a>, <a href="#rfc.iref.q.2">A</a></li></ul></li><li><a id="rfc.index.R" href="#rfc.index.R"><b>R</b></a><ul><li>rdf:Description Extension Element&nbsp;&nbsp;<a href="#rfc.iref.r.26">A</a></li><li>ref Extension Element&nbsp;&nbsp;<a href="#rfc.iref.r.23"><b>11.19</b></a>, <a href="#rfc.iref.r.25">A</a></li><li>refparent PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.r.1">3.1</a></li><li>Relation.Replaces DCMI property&nbsp;&nbsp;<a href="#rfc.iref.r.22">6.4</a></li><li>RELAX NG Compact Schema&nbsp;&nbsp;<a href="#rfc.iref.r.24"><b>A</b></a></li><li>rfc.abstract anchor&nbsp;&nbsp;<a href="#rfc.iref.r.3">4</a></li><li>rfc.authors anchor&nbsp;&nbsp;<a href="#rfc.iref.r.4">4</a></li><li>rfc.copyright anchor&nbsp;&nbsp;<a href="#rfc.iref.r.5">4</a></li><li>rfc.copyrightnotice anchor&nbsp;&nbsp;<a href="#rfc.iref.r.6">4</a></li><li>rfc.figure.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.7">4</a>, <a href="#rfc.iref.r.18">4</a></li><li>rfc.figure.u.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.8">4</a>, <a href="#rfc.iref.r.19">4</a></li><li>rfc.index anchor&nbsp;&nbsp;<a href="#rfc.iref.r.9">4</a></li><li>rfc.ipr anchor&nbsp;&nbsp;<a href="#rfc.iref.r.10">4</a></li><li>rfc.iref.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.11">4</a></li><li>rfc.note.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.12">4</a></li><li>rfc.references anchor&nbsp;&nbsp;<a href="#rfc.iref.r.13">4</a></li><li>rfc.references.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.14">4</a></li><li>rfc.section.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.15">4</a></li><li>rfc.section.n.p.m anchor&nbsp;&nbsp;<a href="#rfc.iref.r.16">4</a></li><li>rfc.status anchor&nbsp;&nbsp;<a href="#rfc.iref.r.17">4</a></li><li>rfc.toc anchor&nbsp;&nbsp;<a href="#rfc.iref.r.20">4</a></li><li>rfc.xref.name.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.21">4</a></li><li><em>RFC2026</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.1">11.25</a>, <a href="#RFC2026"><b>13</b></a>, <a href="#rfc.xref.RFC2026.2">D.2</a><ul><li><em>Section 4</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.2">D.2</a></li><li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.1">11.25</a></li></ul></li><li><em>RFC2119</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2119.1">11.3</a>, <a href="#rfc.xref.RFC2119.2">11.27</a>, <a href="#RFC2119"><b>13</b></a><ul><li><em>Section 5</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2119.2">11.27</a></li></ul></li><li><em>RFC2616</em>&nbsp;&nbsp;<a href="#RFC2616"><b>13</b></a>, <a href="#rfc.xref.RFC2616.1">B.1</a>, <a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a><ul><li><em>Section 2.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2616.1">B.1</a></li><li><em>Section 19.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a></li></ul></li><li><em>RFC2629</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2629.1">1</a>, <a href="#RFC2629"><b>13</b></a></li><li><em>RFC2648</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2648.1">6.4</a>, <a href="#RFC2648"><b>13</b></a></li><li><em>RFC2731</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2731.1">6.4</a>, <a href="#RFC2731"><b>13</b></a></li><li><em>RFC5234</em>&nbsp;&nbsp;<a href="#RFC5234"><b>13</b></a>, <a href="#rfc.xref.RFC5234.1">B.1</a></li><li><em>RFC5741</em>&nbsp;&nbsp;<a href="#RFC5741"><b>13</b></a>, <a href="#rfc.xref.RFC5741.1">D.3</a>, <a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a><ul><li><em>Section 3.2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a></li></ul></li><li>rfcedstyle PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.r.2">3.1</a></li><li><em>RNC</em>&nbsp;&nbsp;<a href="#RNC"><b>13</b></a>, <a href="#rfc.xref.RNC.1">A</a>, <a href="#rfc.xref.RNC.2">B.1</a></li></ul></li><li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul><li>Safari&nbsp;&nbsp;<a href="#rfc.iref.s.9">5.2</a>, <a href="#rfc.iref.s.11">5.2</a><ul><li>3.*&nbsp;&nbsp;<a href="#rfc.iref.s.10">5.2</a></li></ul></li><li>Saxon&nbsp;&nbsp;<a href="#rfc.iref.s.8">5.1</a></li><li>Schema&nbsp;&nbsp;<a href="#rfc.iref.s.14"><b>A</b></a></li><li>sec-no-trailing-dots PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.7">3.3</a></li><li>slides PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.3">3.2</a></li><li>sortrefs PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.1">3.1</a></li><li>source Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.12"><b>11.20</b></a>, <a href="#rfc.iref.s.15">A</a></li><li>span Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.17">A</a></li><li>strict PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.4">3.2</a></li><li>subcompact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.5">3.2</a></li><li>sup Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.13"><b>11.21</b></a>, <a href="#rfc.iref.s.16">A</a></li><li>support-rfc2731 PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.6">3.3</a></li><li>symrefs PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.2">3.1</a></li></ul></li><li><a id="rfc.index.T" href="#rfc.index.T"><b>T</b></a><ul><li>toc PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.1">3.1</a></li><li>tocdepth PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.2">3.1</a></li><li>tocindent PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.4">3.2</a></li><li>tocompact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.5">3.2</a></li><li>topblock PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.3">3.1</a></li></ul></li><li><a id="rfc.index.X" href="#rfc.index.X"><b>X</b></a><ul><li>x Extension Element&nbsp;&nbsp;<a href="#rfc.iref.x.30">A</a></li><li>Xalan&nbsp;&nbsp;<a href="#rfc.iref.x.27">5.1</a></li><li><em>XHTML2</em>&nbsp;&nbsp;<a href="#rfc.xref.XHTML2.1">11.10</a>, <a href="#XHTML2"><b>13</b></a></li><li><em>XML</em>&nbsp;&nbsp;<a href="#XML"><b>13</b></a>, <a href="#rfc.xref.XML.1">C.1</a><ul><li><em>Section 2.8</em>&nbsp;&nbsp;<a href="#rfc.xref.XML.1">C.1</a></li></ul></li><li>xml-stylesheet PI&nbsp;&nbsp;<a href="#rfc.iref.x.29">6</a></li><li>xml2rfc-background parameter&nbsp;&nbsp;<a href="#rfc.iref.x.2">3.1</a></li><li>xml2rfc-comments parameter&nbsp;&nbsp;<a href="#rfc.iref.x.4">3.1</a></li><li>xml2rfc-editing parameter&nbsp;&nbsp;<a href="#rfc.iref.x.3">3.1</a>, <a href="#rfc.iref.x.5">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork parameter&nbsp;&nbsp;<a href="#rfc.iref.x.19">3.3</a></li><li>xml2rfc-ext-authors-section parameter&nbsp;&nbsp;<a href="#rfc.iref.x.20">3.3</a></li><li>xml2rfc-ext-duplex&nbsp;&nbsp;<a href="#rfc.iref.x.21">3.3</a></li><li>xml2rfc-ext-include-references-in-index parameter&nbsp;&nbsp;<a href="#rfc.iref.x.22">3.3</a></li><li>xml2rfc-ext-justification parameter&nbsp;&nbsp;<a href="#rfc.iref.x.23">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork parameter&nbsp;&nbsp;<a href="#rfc.iref.x.24">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots parameter&nbsp;&nbsp;<a href="#rfc.iref.x.26">3.3</a></li><li>xml2rfc-ext-support-rfc2731 parameter&nbsp;&nbsp;<a href="#rfc.iref.x.25">3.3</a></li><li>xml2rfc-footer parameter&nbsp;&nbsp;<a href="#rfc.iref.x.6">3.1</a></li><li>xml2rfc-header parameter&nbsp;&nbsp;<a href="#rfc.iref.x.7">3.1</a></li><li>xml2rfc-inline parameter&nbsp;&nbsp;<a href="#rfc.iref.x.8">3.1</a></li><li>xml2rfc-iprnotified parameter&nbsp;&nbsp;<a href="#rfc.iref.x.9">3.1</a></li><li>xml2rfc-linkmailto parameter&nbsp;&nbsp;<a href="#rfc.iref.x.10">3.1</a></li><li>xml2rfc-private parameter&nbsp;&nbsp;<a href="#rfc.iref.x.11">3.1</a></li><li>xml2rfc-refparent parameter&nbsp;&nbsp;<a href="#rfc.iref.x.12">3.1</a></li><li>xml2rfc-rfcedstyle parameter&nbsp;&nbsp;<a href="#rfc.iref.x.13">3.1</a></li><li>xml2rfc-sortrefs parameter&nbsp;&nbsp;<a href="#rfc.iref.x.14">3.1</a></li><li>xml2rfc-symrefs parameter&nbsp;&nbsp;<a href="#rfc.iref.x.15">3.1</a></li><li>xml2rfc-toc parameter&nbsp;&nbsp;<a href="#rfc.iref.x.16">3.1</a></li><li>xml2rfc-tocdepth parameter&nbsp;&nbsp;<a href="#rfc.iref.x.17">3.1</a></li><li>xml2rfc-topblock parameter&nbsp;&nbsp;<a href="#rfc.iref.x.18">3.1</a></li><li><em>XSL-FO</em>&nbsp;&nbsp;<a href="#rfc.xref.XSL-FO.1">9.1</a>, <a href="#rfc.xref.XSL-FO.2">9.1</a>, <a href="#XSL-FO"><b>13</b></a></li><li>xsltproc&nbsp;&nbsp;<a href="#rfc.iref.x.28">5.1</a><ul><li>passing parameters&nbsp;&nbsp;<a href="#rfc.iref.x.1">3</a></li></ul></li></ul></li></ul></div></body></html>
     998</pre><div class="note" id="rfc.section.C.2.p.3"> <p> <b>Note:</b> the name for the attribute sets may change in the future as more working is done with respect to customizability. In any case, overriding the settings in a separate file will be easier to maintain. Please contact the author if you find yourself trying to override style definitions that currently do not use attribute sets.</p>  <p> <b>Note:</b> the CSS style information used in <samp>rfc2629.xslt</samp> can be overriden in a similar (but less granular) way: just overwrite the template called "insertCss". As for XSL-FO, the class names may change in future.</p> </div><hr class="noprint"><h1 id="rfc.section.D" class="np"><a href="#rfc.section.D">D.</a>&nbsp;<a id="boilerplate" href="#boilerplate">Producing the IETF 'Boilerplate'</a></h1><p id="rfc.section.D.p.1">Various attributes of the <samp>&lt;rfc&gt;</samp> element plus some child elements of <samp>&lt;front&gt;</samp> affect the automatically generated parts of the front page, such as the tabular information at the beginning, the "Status Of This Memo", and the "Copyright Notice".</p><p id="rfc.section.D.p.2">When submitting an Internet Draft, this "boilerplate" is checked by "Idnits" (&lt;<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>&gt;) for compliance with the current Intellectual Property rules, and thus it is important to set the correct values.</p><p id="rfc.section.D.p.3">Furthermore, the RFC Production Center uses RFC2629-based tools to generate the final RFC text, so the more accurate the supplied information is, the less additional work is left, and the risk for errors in producing the final (and immutable!) document is reduced.</p><div class="note" id="rfc.section.D.p.4"> <p> <b>Note:</b> this only applies to the case when IETF documents are produced. The "private" processing instruction <span id="rfc.iref.p.66"></span><span id="rfc.iref.p.67"></span> allows to switch off most of the autogeneration logic.</p> </div><h2 id="rfc.section.D.1"><a href="#rfc.section.D.1">D.1</a>&nbsp;<a id="attribute-ipr" href="#attribute-ipr">The /rfc/@ipr Attribute</a></h2><p id="rfc.section.D.1.p.1">As of the time of this writing, this attribute value can take a long list of values. As frequently, this is not the result of a grand plan, but simply for historic reasons. Of these values, only a few are currently in use; all others are supported by the various tools for backwards compatibility with old source files.</p><div class="note" id="rfc.section.D.1.p.2"> <p> <b>Note:</b> some variations of the boilerplate are selected based on the document's date; therefore it is important to specify the "year", "month" and "day" attributes of the <samp>&lt;date&gt;</samp> element when archiving the XML source of an Internet Draft on the day of submission.</p> </div><p id="rfc.section.D.1.p.3"> <em>Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER.</em> For further information, refer to &lt;<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>&gt;.</p><p id="rfc.section.D.1.p.4">Finally, for the current "Status Of This Memo" text, the <samp>submissionType</samp> attribute determines whether a statement about "Code Components" is inserted (this is the case for the value "IETF", which also happens to be the default). Other values, such as "independent", suppress this part of the text.</p><h3 id="rfc.section.D.1.1"><a href="#rfc.section.D.1.1">D.1.1</a>&nbsp;<a id="attribute-ipr-current" href="#attribute-ipr-current">Current Values: '*trust200902'</a></h3><p id="rfc.section.D.1.1.p.1">The name for these values refers to the "TLP" ("IETF TRUST Legal Provisions Relating to IETF Documents"), on effect February 15, 2009 (see &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf</a>&gt;). Updates to this document were published on September 12, 2009 (TLP 3.0, &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>&gt;) and on December 28, 2009 (TLP 4.0, &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>&gt;), modifying the license for code components. The actual text is located in Section 6 ("Text To Be Included in IETF Documents") of these documents.</p><p id="rfc.section.D.1.1.p.2">The tools will automatically produce the "right" text depending on the document's date information (see above):</p><div id="rfc.table.u.10"><table class="tt full left" cellpadding="3" cellspacing="0"><thead><tr><th>TLP</th><th>URI</th><th>starting with publication date</th></tr></thead><tbody><tr><td class="left">3.0</td><td class="left">&lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>&gt;</td><td class="left">2009-11-01</td></tr><tr><td class="left">4.0</td><td class="left">&lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>&gt;</td><td class="left">2010-04-01</td></tr></tbody></table></div><h4 id="rfc.section.D.1.1.1"><a href="#rfc.section.D.1.1.1">D.1.1.1</a>&nbsp;<a id="attribute-ipr-trust200902" href="#attribute-ipr-trust200902">trust200902</a></h4><p id="rfc.section.D.1.1.1.p.1">This should be the default, unless one of the more specific '*trust200902' values is a better fit. It produces the text in Sections 6.a and 6.b of the TLP.</p><h4 id="rfc.section.D.1.1.2"><a href="#rfc.section.D.1.1.2">D.1.1.2</a>&nbsp;<a id="attribute-ipr-noModificationTrust200902" href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></h4><p id="rfc.section.D.1.1.2.p.1">This produces the additional text from Section 6.c.i of the TLP:</p><blockquote id="rfc.section.D.1.1.2.p.2"> <p>This document may not be modified, and derivative works of it may not be created, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><div class="note" id="rfc.section.D.1.1.2.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.3"><a href="#rfc.section.D.1.1.3">D.1.1.3</a>&nbsp;<a id="attribute-ipr-noDerivativesTrust200902" href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></h4><p id="rfc.section.D.1.1.3.p.1">This produces the additional text from Section 6.c.ii of the TLP:</p><blockquote id="rfc.section.D.1.1.3.p.2"> <p>This document may not be modified, and derivative works of it may not be created, and it may not be published except as an Internet-Draft.</p> </blockquote><div class="note" id="rfc.section.D.1.1.3.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.4"><a href="#rfc.section.D.1.1.4">D.1.1.4</a>&nbsp;<a id="attribute-ipr-pre5378Trust200902" href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></h4><p id="rfc.section.D.1.1.4.p.1">This produces the additional text from Section 6.c.iii of the TLP, frequently called the "pre-5378 escape clause":</p><blockquote id="rfc.section.D.1.1.4.p.2"> <p>This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><p id="rfc.section.D.1.1.4.p.3">See Section 4 of &lt;<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>&gt; for further information about when to use this value.</p><div class="note" id="rfc.section.D.1.1.4.p.4"> <p> <b>Note:</b> this text appears under "Copyright Notice", unless the document was published before November 2009, in which case it appears under "Status Of This Memo".</p> </div><h3 id="rfc.section.D.1.2"><a href="#rfc.section.D.1.2">D.1.2</a>&nbsp;<a id="attribute-ipr-historic" href="#attribute-ipr-historic">Historic Values</a></h3><h4 id="rfc.section.D.1.2.1"><a href="#rfc.section.D.1.2.1">D.1.2.1</a>&nbsp;<a id="attribute-ipr-200811" href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></h4><p id="rfc.section.D.1.2.1.p.1">The attribute values "<span id="attribute-ipr-trust200811">trust200811</span>", "<span id="attribute-ipr-noModificationTrust200811">noModificationTrust200811</span>" and "<span id="attribute-ipr-noDerivativesTrust200811">noDerivativesTrust200811</span>" are similar to their "trust200902" counterparts, except that they use text specified in &lt;<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf</a>&gt;.</p><h4 id="rfc.section.D.1.2.2"><a href="#rfc.section.D.1.2.2">D.1.2.2</a>&nbsp;<a id="attribute-ipr-3978" href="#attribute-ipr-3978">Historic Values: '*3978'</a></h4><p id="rfc.section.D.1.2.2.p.1">The attribute values "<span id="attribute-ipr-full3978">full3978</span>", "<span id="attribute-ipr-noModification3978">noModification3978</span>" and "<span id="attribute-ipr-noDerivatives3978">noDerivatives3978</span>" are similar to their counterparts above, except that they use text specified in RFC 3978 (March 2005).</p><h4 id="rfc.section.D.1.2.3"><a href="#rfc.section.D.1.2.3">D.1.2.3</a>&nbsp;<a id="attribute-ipr-3667" href="#attribute-ipr-3667">Historic Values: '*3667'</a></h4><p id="rfc.section.D.1.2.3.p.1">The attribute values "<span id="attribute-ipr-full3667">full3667</span>", "<span id="attribute-ipr-noModification3667">noModification3667</span>" and "<span id="attribute-ipr-noDerivatives3667">noDerivatives3667</span>" are similar to their counterparts above, except that they use text specified in RFC 3667 (February 2004).</p><h4 id="rfc.section.D.1.2.4"><a href="#rfc.section.D.1.2.4">D.1.2.4</a>&nbsp;<a id="attribute-ipr-2026" href="#attribute-ipr-2026">Historic Values: '*2026'</a></h4><p id="rfc.section.D.1.2.4.p.1">The attribute values "<span id="attribute-ipr-full2026">full2026</span>" and "<span id="attribute-ipr-noDerivativeWorks2026">noDerivativeWorks2026</span>" are similar to their counterparts above, except that they use text specified in RFC 2026 (October 1996).</p><p id="rfc.section.D.1.2.4.p.2">The special value "<span id="attribute-ipr-none">none</span>" was also used back then, and denied the IETF any rights beyond publication as Internet Draft.</p><h2 id="rfc.section.D.2"><a href="#rfc.section.D.2">D.2</a>&nbsp;<a id="attribute-category" href="#attribute-category">The /rfc/@category Attribute</a></h2><p id="rfc.section.D.2.p.1">For RFCs, the <samp>category</samp> determines the "maturity level" (see <a href="http://tools.ietf.org/html/rfc2026#section-4">Section 4</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.2"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>). The allowed values are "std" for "Standards Track", "bcp" for "BCP", "info" for "Informational", "exp" for "Experimental", and "historic" for - surprise - "Historic".</p><p id="rfc.section.D.2.p.2">For Internet Drafts, the category attribute is not needed, but <em>will</em> appear on the front page ("Intended Status"). Supplying this information can be useful, because reviewers may want to know.</p><div class="note" id="rfc.section.D.2.p.3"> <p> <b>Note:</b> the Standards Track consists of "Proposed Standard", "Draft Standards", and "Internet Standard". These do not appear in the boilerplate, thus the category attribute doesn't handle them. However, this information can be useful for validity checkers, and thus <samp>rfc2629.xslt</samp> supports an extension attribute for that purpose (see <a href="#ext-rfc2629.rfc" title="Extensions to Xml2rfc <rfc&gt; element">Section&nbsp;11.25</a> for details).</p> </div><h2 id="rfc.section.D.3"><a href="#rfc.section.D.3">D.3</a>&nbsp;<a id="attribute-submissiontype" href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></h2><p id="rfc.section.D.3.p.1">The RFC Editor publishes documents from different "document streams", of which the "IETF stream" of course is the most prominent one. Other streams are the "independent stream" (used for things like administrative information or April 1st RFCs), the "IAB stream" (Internet Architecture Board) and the "IRTF stream" (Internet Research Task Force).</p><p id="rfc.section.D.3.p.2">Not surprisingly, the values for the attribute are "IETF" (the default value), "independent", "IAB", and "IRTF".</p><p id="rfc.section.D.3.p.3">Historically, this did not affect the final appearance of RFCs, except for subtle differences in Copyright notices. Nowadays (as of <a href="#RFC5741" id="rfc.xref.RFC5741.1"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>), the stream name appears in the first line of the front page, and it also affects the text in the "Status Of This Memo" section.</p><p id="rfc.section.D.3.p.4">For current documents, setting <samp>submissionType</samp> attribute will have the following effect: </p><ul><li>For RFCs, the stream name appears in the upper left corner of the first page (in Internet Drafts, this is either "Network Working Group", or the value of the <samp>&lt;workgroup&gt;</samp> element).</li><li>For RFCs, if affects the whole "Status Of This Memo" section (see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.2"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</li><li>For all RFCs and Internet Drafts, it determines whether the "Copyright Notice" mentions the Copyright on Code Components (see TLP, Section "Text To Be Included in IETF Documents").</li></ul><h2 id="rfc.section.D.4"><a href="#rfc.section.D.4">D.4</a>&nbsp;<a id="attribute-consensus" href="#attribute-consensus">The /rfc/@consensus Attribute</a></h2><p id="rfc.section.D.4.p.1">For some of the publication streams (see <a href="#attribute-submissiontype" title="The /rfc/@submissionType Attribute">Appendix&nbsp;D.3</a>), the "Status Of This Memo" section depends on whether there was a consensus to publish (again, see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.3"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</p><p id="rfc.section.D.4.p.2">The <samp>consensus</samp> attribute ("yes"/"no", defaulting to "yes") can be used to supply this information. The effect for the various streams is: </p><ul><li>"independent" and "IAB": none.</li><li>"IETF": mention that there was an IETF consensus.</li><li>"IRTF": mention that there was a research group consensus (where the name of the research group is extracted from the <samp>&lt;workgroup&gt;</samp> element).</li></ul><h2 id="rfc.section.D.5"><a href="#rfc.section.D.5">D.5</a>&nbsp;<a id="attribute-number" href="#attribute-number">The /rfc/@number Attribute</a></h2><p id="rfc.section.D.5.p.1">For RFCs, this attribute supplies the RFC number.</p><h2 id="rfc.section.D.6"><a href="#rfc.section.D.6">D.6</a>&nbsp;<a id="attribute-docname" href="#attribute-docname">The /rfc/@docName Attribute</a></h2><p id="rfc.section.D.6.p.1">For Internet Drafts, this specifies the draft name (which appears below the title). The file extension is <em>not</em> part of the draft, so in general it should end with the current draft number ("-", plus two digits).</p><div class="note" id="rfc.section.D.6.p.2"> <p> <b>Note:</b> "Idnits" (&lt;<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>&gt;) checks the in-document draft name for consistency with the filename of the submitted document.</p> </div><h2 id="rfc.section.D.7"><a href="#rfc.section.D.7">D.7</a>&nbsp;<a id="attribute-obsoletes" href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></h2><p id="rfc.section.D.7.p.1">The RFC Editor maintains a database (&lt;<a href="http://www.rfc-editor.org/rfc.html">http://www.rfc-editor.org/rfc.html</a>&gt;) of all RFCs, including information about which one obsoletes which. Upon publication of an RFC, this database is updated from the data on the front page.</p><p id="rfc.section.D.7.p.2">This attribute takes a list of comma-separated RFC <em>numbers</em>. Do <em>not</em> put the string "RFC" here.</p><h2 id="rfc.section.D.8"><a href="#rfc.section.D.8">D.8</a>&nbsp;<a id="attribute-updates" href="#attribute-updates">The /rfc/@updates Attribute</a></h2><p id="rfc.section.D.8.p.1">This is like <samp>obsoletes</samp>, but for the "updates" relation.</p><hr class="noprint"><h1 id="rfc.section.E" class="np"><a href="#rfc.section.E">E.</a>&nbsp;<a id="license" href="#license">License</a></h1><p id="rfc.section.E.p.1">Copyright (c) 2006-2010, Julian Reschke (julian.reschke@greenbytes.de)</p><p id="rfc.section.E.p.2">All rights reserved.</p><p id="rfc.section.E.p.3">Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: </p><ul><li>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</li><li>Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</li><li>Neither the name of Julian Reschke nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</li></ul><p id="rfc.section.E.p.4">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p><hr class="noprint"><h1 id="rfc.section.F" class="np"><a href="#rfc.section.F">F.</a>&nbsp;Change Logs</h1><h2 id="rfc.section.F.1"><a href="#rfc.section.F.1">F.1</a>&nbsp;Package</h2><dl><dt>2006-01-01</dt><dd>Switch to BSD License.</dd><dt>2007-01-12</dt><dd>Update to xml2rfc v1.33pre2.</dd><dt>2007-03-31</dt><dd>Update to xml2rfc v1.33pre3.</dd><dt>2007-05-01</dt><dd>Add XSLT test cases.</dd><dt>2008-07-18</dt><dd>Experimental support for inlined rdf:Description elements (ignored by the formatter, extracted by rfc2629grddl).</dd><dt>2008-12-04</dt><dd>Update to xml2rfc v1.34pre2.</dd><dt>2009-02-24</dt><dd>Experimental support for February 2009 boilerplate changes, and for the x:boilerplate element.</dd><dt>2009-07-08</dt><dd>Support new boilerplate ordering in RFCs published since July 2009. Fix problems with one-column text tables.</dd><dt>2009-07-19</dt><dd>When possible, calculate the actual Expiry date for Internet Drafts (full date must be available).</dd><dt>2009-08-01</dt><dd>For '$xml2rfc-ext-authors-section='end'", move the index in front of the authors section.</dd><dt>2009-08-04</dt><dd>Consider /rfc/@ipr="pre5378Trust200902" when producing RFCs, not IDs.</dd><dt>2009-08-29</dt><dd>Support alignment for artwork containing images (as opposed to, well, artwork).</dd><dt>2009-09-01</dt><dd>Allow xref in cref (as extension).</dd><dt>2009-09-14</dt><dd>Refactor handling of processing instructions.</dd><dt>2009-09-24</dt><dd>Fix typo in Status Of This Memo, present since November 2008. Fix formatting of iprExtract attribute. Starting with Internet Draft publication dates after 2009-11-30: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Add support for refparent PI. For RFCs: use new TLP text as of September 2009. Incorporate xml2rfc v1.34pre4.</dd><dt>2009-10-06</dt><dd>Starting with Internet Draft publication dates after 2009-10-31: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Incorporate xml2rfc v1.34pre5.</dd><dt>2009-10-27</dt><dd>Upgrade to xml2rfc v1.34.</dd><dt>2010-01-08</dt><dd>For RFC generation (not IDs), experimentally support RFC 5741 headers and boilerplate and Trust Legal Provisions 4.0.</dd><dt>2010-03-31</dt><dd>Upgrade to xml2rfc v1.35.</dd><dt>2010-06-27</dt><dd>Be consistent with xml2rfc.tcl in formatting initials (truncate after the first); see &lt;<a href="http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10">http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10</a>&gt;.</dd><dt>2010-08-31</dt><dd>Experimental support for prose in references.</dd><dt>2011-01-27</dt><dd>Update to xml2rfc v1.36pre1.</dd><dt>2011-04-17</dt><dd>Update to xml2rfc v1.36. Add support for more /rfc/@ipr values when producing RFCs.</dd></dl><h2 id="rfc.section.F.2"><a href="#rfc.section.F.2">F.2</a>&nbsp;amazon-asin.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2005-04-02</dt><dd>Fix two DTD issues.</dd></dl><h2 id="rfc.section.F.3"><a href="#rfc.section.F.3">F.3</a>&nbsp;check-references.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2004-05-11</dt><dd>Add document status; print references type.</dd><dt>2005-01-01</dt><dd>Add experimental check for ID status.</dd><dt>2005-04-01</dt><dd>Add fixes from Bill Fenner.</dd><dt>2005-12-03</dt><dd>Add checks against local copy of &lt;<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>&gt;.</dd><dt>2006-07-22</dt><dd>Add checks for standards levels.</dd><dt>2006-08-06</dt><dd>"check-ietf-references.xslt" replaced by "check-references.xslt".</dd><dt>2007-01-04</dt><dd>Use information online at &lt;<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>&gt; to retrieve Internet-Draft status information.</dd><dt>2007-06-16</dt><dd>Fix bug looking up ref type when inside change markup.</dd><dt>2008-06-14</dt><dd>Enhance output when draft was updated, and then published as RFC.</dd><dt>2008-07-12</dt><dd>Add XSLT2-based link target checking.</dd><dt>2008-08-10</dt><dd>Change keywords for "intended-level" to proposed/draft/internet, optionally extract intended level from /rfc/@x:maturity-level attribute.</dd></dl><h2 id="rfc.section.F.4"><a href="#rfc.section.F.4">F.4</a>&nbsp;gen-reference-graph.xslt</h2><dl><dt>2006-09-03</dt><dd>New.</dd><dt>2007-06-07</dt><dd>Use <a href="http://dpcarlisle.blogspot.com/2007/05/exslt-node-set-function.html">Carlisle method</a> to define exslt:node-set in msxsml (which means that the stylesheet can now be used with MSXML as well).</dd><dt>2007-10-15</dt><dd>Use W3C data from tr.rdf as well (experimental).</dd></dl><h2 id="rfc.section.F.5"><a href="#rfc.section.F.5">F.5</a>&nbsp;rfc2629.xslt</h2><dl><dt>2001-03-28</dt><dd>Code rearranged, generate numbered section anchors for paragraphs (t) as well. Fixes in index handling.</dd><dt>2001-04-12</dt><dd>Moved HTML output into XHTML namespace.</dd><dt>2001-10-02</dt><dd>Fixed default location for RFCs and numbering of section references. Support ?rfc editing processing instruction.</dd><dt>2001-10-07</dt><dd>Made telephone number links active.</dd><dt>2001-10-08</dt><dd>Support for vspace element.</dd><dt>2001-10-09</dt><dd>Experimental support for rfc-issue PI.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-12-17</dt><dd>Support title attribute on references element</dd><dt>2002-01-05</dt><dd>Support for list/@style="@format"</dd><dt>2002-01-09</dt><dd>Display "closed" RFC issues as deleted</dd><dt>2002-01-14</dt><dd>Experimentally and optionally parse XML encountered in artwork elements (requires MSXSL).</dd><dt>2002-01-27</dt><dd>Some cleanup. Moved RFC issues from PIs into namespaced elements.</dd><dt>2002-01-29</dt><dd>Added support for sortrefs PI. Added support for figure names.</dd><dt>2002-02-07</dt><dd>Highlight parts of artwork which are too wide (72 characters).</dd><dt>2002-02-12</dt><dd>Code rearrangement for static texts. Fixes for section numbering. TOC generation rewritten.</dd><dt>2002-02-15</dt><dd>Support for irefs in sections; support iref @primary=true</dd><dt>2002-03-03</dt><dd>Moved anchor prefix into a constant. Added sanity checks on user anchor names.</dd><dt>2002-03-23</dt><dd>Bugfix in detection of matching org names when creating the header. Fixed sorting in subitems.</dd><dt>2002-04-02</dt><dd>Fix TOC link HTML generation when no TOC is generated (created broken HTML table code).</dd><dt>2002-04-03</dt><dd>Made rendering of references more tolerant re: missing parts.</dd><dt>2002-04-08</dt><dd>Fixed reference numbering when references are split into separate sections.</dd><dt>2002-04-16</dt><dd>Fix default namespace (shouldn't be set for HTML output method).</dd><dt>2002-04-19</dt><dd>Lowercase internal CSS selectors for Mozilla compliance. Do not put TOC into ul element.</dd><dt>2002-04-21</dt><dd>Make numbered list inside numbered lists use alphanumeric numbering.</dd><dt>2002-05-05</dt><dd>Updated issue/editing support.</dd><dt>2002-05-15</dt><dd>Bugfix for section numbering after introduction of ed:replace</dd><dt>2002-06-21</dt><dd>When producing private documents, do not include document status, copyright etc.</dd><dt>2002-07-08</dt><dd>Fix xrefs to Appendices.</dd><dt>2002-07-19</dt><dd>Make artwork lightyellow for easier reading. (fielding)</dd><dt>2002-10-09</dt><dd>Translate references title to anchor name to avoid non-uri characters. (fielding)</dd><dt>2002-10-13</dt><dd>Support for tocdepth PI.</dd><dt>2002-11-03</dt><dd>Added temporariry workaround for Mozilla/Transformiix result tree fragment problem. (search for 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')</dd><dt>2002-12-25</dt><dd>xref code: attempt to uppercase "section" and "appendix" when at the start of a sentence.</dd><dt>2003-02-02</dt><dd>fixed code for vspace blankLines="0", enhanced display for list with "format" style, got rid of HTML blockquote elements, added support for "hangIndent"</dd><dt>2003-04-10</dt><dd>experimental support for appendix and spanx elements</dd><dt>2003-04-19</dt><dd>fixed counting of list numbers in "format %" styles (one counter per unique format string). Added more spanx styles.</dd><dt>2003-05-02</dt><dd>experimental texttable support</dd><dt>2003-05-02</dt><dd>Make mailto links optional (default = none) (jre: default and PI name changed) (fielding)</dd><dt>2003-05-04</dt><dd>experimental support for HTML link elements; fix default for table header alignment default</dd><dt>2003-05-06</dt><dd>support for "background" PI.</dd><dt>2003-05-11</dt><dd>change %c format to lowercase alphabetic. add support for keyword elements (generate META tag). fix various HTML conformance problems. added experimental support for role attribute. do not number paragraphs in unnumbered sections. update boilerplate texts. support for "iprnotified" PI. bugfix list numbering. strip whitespace when building tel: URIs.</dd><dt>2003-05-12</dt><dd>more conformance fixes (layout moved into CSS, move lists and figures out of para content, do not use tables for list formatting)</dd><dt>2003-05-13</dt><dd>add DC.Creator meta tag, refactoring</dd><dt>2003-05-16</dt><dd>put nbsps between "section" and section number (xref).</dd><dt>2003-05-18</dt><dd>author summary: add missing comma.</dd><dt>2003-06-06</dt><dd>fix index generation bug (transposed characters in key generation). Enhance sentence start detection (xref starting a section was using lowercase "section").</dd><dt>2003-06-22</dt><dd>exp. support for xref/@format. Add missing support for eref w/o content. exp. support for annotations in reference elements. Code cleanup reference table formatting.</dd><dt>2003-07-09</dt><dd>Another fix for DC.Creator meta tag creation based on RFC2731</dd><dt>2003-07-24</dt><dd>Fix namespace name for DC.Creator.</dd><dt>2003-08-06</dt><dd>Cleanup node-set support (only use exslt (saxon, xalan, libxslt) extension functions; remove Transformix workarounds that stopped to work in Moz 1.4)</dd><dt>2003-08-09</dt><dd>Generate HTML lang tag.</dd><dt>2003-08-10</dt><dd>Map spanx/verb to HTML "samp" element. Fix author name display in references (reverse surname/initials for last author), add "Ed.". Fix internal bookmark generation.</dd><dt>2003-08-17</dt><dd>Add DCMI dates, identifiers and abstract. Add PI to suppress DCMI generation. Do not add TOC entry to Copyright Statement when there is none. Align RFC2629 PI names and parameter names. Change style for inline URIs generated by eref. Add header and footer support. Enhance CSS paging properties. Support topblock PI. Added hooks for proper XHTML generation through separate XSLT. Enhance warning and error messages. Add support for artwork image display. Table formatting fixes (borders, thead continuation).</dd><dt>2003-08-18</dt><dd>Add workaround for MSXML4 node-set and Mozilla node-set issues (fallback just displays are warning).</dd><dt>2003-10-06</dt><dd>Add workaround for broken pre/ins handling in Mozilla (see &lt;<a href="http://bugzilla.mozilla.org/show_bug.cgi?id=204401">http://bugzilla.mozilla.org/show_bug.cgi?id=204401</a>&gt;). Make use of cite attribute on ed:replace. CSS cleanup.</dd><dt>2003-10-08</dt><dd>Fix minor issue detecting the same org for the header (caused by IE's non-standard whitespace handling). Fix default handling for /rfc/@category.</dd><dt>2003-11-09</dt><dd>Inherit ed:entered-by from ancestor elements. Change CSS color for inserted text to green. Generate issues-list anchor. Do not complain about missing targets when the xref element is below ed:del. Remove code that attempted to distinguish section/Section when producing links - always use uppercase. Fix date rendering for issue resolutions.</dd><dt>2003-11-29</dt><dd>Fix color values for table backgrounds for issue rendering. Change rendering of issue links to use inline-styles. Add colored issue markers to issues.</dd><dt>2003-12-13</dt><dd>Fix inheritance of ed:entered-by attribute. Display note elements inside change tracking as well.</dd><dt>2004-01-18</dt><dd>When PI compact = 'yes', make most CSS print page breaks conditional.</dd><dt>2004-02-20</dt><dd>Support for RFC3667 IPR changes (xml2rfc 1.22); see &lt;<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html</a>&gt;.</dd><dt>2004-03-11</dt><dd>Add "(if approved)" to "updates" and "obsoletes" unless the document has an RFC number.</dd><dt>2004-04-01</dt><dd>Fix RFC3667 output, see &lt;<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html</a>&gt;.</dd><dt>2004-04-04</dt><dd>Add support for section/top attribute. Move references into plain section container.</dd><dt>2004-04-06</dt><dd>Do not emit identical para anchors for deleted content.</dd><dt>2004-04-14</dt><dd>Fix references TOC generation when there are no references.</dd><dt>2004-04-24</dt><dd>Fix RFC3667 output, see &lt;<a href="http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html">http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html</a>&gt;.</dd><dt>2004-05-09</dt><dd>Add custom support for generating compound index documents. Add anchors for each Index letter. Add experimental cref support. Fix conditional page breaks before References section.</dd><dt>2004-05-16</dt><dd>Refactor external index generation.</dd><dt>2004-05-20</dt><dd>Rewrite anchor generation for comments.</dd><dt>2004-05-22</dt><dd>Enhance issues rendering (add links to changes).</dd><dt>2004-05-30</dt><dd>Allow single quote as delimiter in processing instructions as well. Move block-level issue pointers to floats. Disable issue pointers for print media. Add "purple numbers". Add hrefs to section headings. Add non-printing index key letter list to start of index.</dd><dt>2004-06-01</dt><dd>Use &amp;#xb6; instead of # for PNs.</dd><dt>2004-07-18</dt><dd>Add support for list style=letters (thanks Roy F.). Make PNs optional; add new PI.</dd><dt>2004-09-05</dt><dd>Fix index links into unnumbered sections. Bring IPR boilerplate in-line with xml2rfc 1.25. Add experimental CSS3 paged media support. Various HTML fixes.</dd><dt>2004-09-21</dt><dd>Enhance checking of artwork width.</dd><dt>2004-09-26</dt><dd>Add check for unused references. Uppercase letters in list style letters when nested into another list.</dd><dt>2004-10-10</dt><dd>Fix internal change track pointers.</dd><dt>2004-11-01</dt><dd>Allow change tracking on references (as a whole). Rewrite artwork handling so that it allows change tracking inside artwork. Also allow a subset of text markup inside artwork, such as xrefs (note this requires post-processing the source to make it compliant to RFC2629bis).</dd><dt>2004-11-03</dt><dd>Enhanced placement of iref anchors.</dd><dt>2004-11-06</dt><dd>Index: display irefs that appeared (with primary=true) inside artwork elements in a monospaced font.</dd><dt>2004-11-14</dt><dd>Add special code so that changes in section titles can be change-tracked.</dd><dt>2005-01-14</dt><dd>Bugfixes for HtmlToXhtml converter.</dd><dt>2005-01-22</dt><dd>Enhance generation of HTML h* elements (for Mozilla Outliner).</dd><dt>2005-01-31</dt><dd>Put vertical space around top-level TOC entries in TOC. Switch to pt-based CSS. Re-arrange top section. Make hr elements reflect new-page settings in TXT output (compact-PI). Fix page number in footer (CSS print) and add some more experimental support for paged media (tested with Prince 4.1 alpha). Rewrite TOC and Index generation to generate HTML lists. Cleanup id generation for paragraphs. Reduce whitespace in output. Fix vspace implementation. Use right/left dqoutes and copyright sign where appropriate.</dd><dt>2005-02-04</dt><dd>Add &lt;link&gt; element to references section. Fix newly introduced bug in references processing.</dd><dt>2005-02-05</dt><dd>Integrate various fixes/enhancements by Roy Fielding: spelling of "Authors' Addresses", comma setting in references, position of "Authors" section, optionally place authors addresses at end (PI), trailing dots in section numbers, switch to verdana default font in CSS. Add experimental support for centered artwork.</dd><dt>2005-02-09</dt><dd>Fixes in spacing and links of references section titles. Enhance sorting in references when change tracking is in place. Re-add figure centering support. Add missing 2nd part of "Author's Adresses" fix.</dd><dt>2005-02-25</dt><dd>Align section number format with xml2rfc1.29.</dd><dt>2005-03-28</dt><dd>Get rid of table elements in Author's section. Add experimental hCard (&lt;<a href="http://developers.technorati.com/wiki/hCard">http://developers.technorati.com/wiki/hCard</a>&gt;) support.</dd><dt>2005-04-03</dt><dd>Add RFC3978-style IPR statement support. (fenner@research.att.com)</dd><dt>2005-04-11</dt><dd>Cleanup author display. hCard related fixes.</dd><dt>2005-05-07</dt><dd>Minor fixes to allow change tracking in doc title. Add experimental support for table border styles. CSS cleanup.</dd><dt>2005-06-18</dt><dd>Implement missing support for references to texttables.</dd><dt>2005-09-25</dt><dd>Use (-moz-)column-count when printing the index.</dd><dt>2005-10-04</dt><dd>Report missing element templates with xsl:message.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2005-10-23</dt><dd>More workarounds for Mozilla's broken del/ins handling (this time for figures).</dd><dt>2005-10-27</dt><dd>lowercase hCard class names</dd><dt>2005-11-22</dt><dd>Enhance diagnostics for XML-in-artwork extension</dd><dt>2005-11-26</dt><dd>Fix formatting of section numbers for sections inserted into &lt;back&gt;.</dd><dt>2005-12-12</dt><dd>Fix some validity problems when change tracking occured inside lists.</dd><dt>2005-12-18</dt><dd>Add change tracking inside the index.</dd><dt>2006-02-04</dt><dd>Add prev/next links to highlighted changes (change tracking extension).</dd><dt>2006-02-10</dt><dd>Catch errors instantiating MSXML component.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-02-27</dt><dd>Fix front matter (lowercase Internet-Draft, say "Intended status" for non-RFC documents). Start work on experimental extension for simplified internal links.</dd><dt>2006-03-19</dt><dd>Tweaks to IESG Copyright stuff; support submissionType attribute. Fix duplicate reference anchors in HTML output. Reduce HTML Tidy warnings. Fix reference to normative ASCII version (now requires trailing ".txt"). Tweaks to hCard generation. Started to move non-issue-tracking extensions into namespace "http://purl.org/net/xml2rfc/ext".</dd><dt>2006-03-27</dt><dd>Moved "simple reference" extension into namespace "http://purl.org/net/xml2rfc/ext" and add documentation. HTML conformance enhancements.</dd><dt>2006-04-02</dt><dd>Cleanup special code for automated XHTML XSLT generation.</dd><dt>2006-04-21</dt><dd>Generate &lt;CITE&gt; elements where appropiate. Introduce x:blockquote, x:dfn, x:h and x:q elements.</dd><dt>2006-05-06</dt><dd>Introduce x:bcp14 element.</dd><dt>2006-05-14</dt><dd>Fix content model for x:blockquote.</dd><dt>2006-06-18</dt><dd>Add box drawing support (x:bt, x:bc, x:bb).</dd><dt>2006-06-20</dt><dd>HTML validity fixes (legal chars in anchors in index).</dd><dt>2006-06-24</dt><dd>Reduce leading empty lines in artwork. Move &lt;dt&gt; style info into CSS.</dd><dt>2006-07-14</dt><dd>Fix rendering of multiple street address entries (missing line break).</dd><dt>2006-07-24</dt><dd>Add extension for deep linking into RFCs, do not generate empty list items in TOC output, avoid empty &lt;dt&gt; elements for list items without hangText attribute.</dd><dt>2006-08-01</dt><dd>Allow @anchor on more elements; start work on Relax NG grammar for extensions. Reduce generated style elements (use CSS classes instead). Consistently use "id" instead of "name". Change default target for RFC links to "http://tools.ietf.org/html/rfcNNNN".</dd><dt>2006-08-06</dt><dd>Include appendices defined in &lt;appendix&gt; elements in TOC (please consider them deprecated anyhow!). Generate links to "http://tools.ietf.org/html/draft-*" for Internet Drafts. Replace x:frag by x:rel, allowing any kind of relative reference instead of just fragments.</dd><dt>2006-08-30</dt><dd>Reduce textual differences between HTML output and what xml2rfc produces in TXT output mode (section refs/reference targets). Add small workaround for Opera 9.0.1's problem with node-set().</dd><dt>2006-10-29</dt><dd>Fix problem generating internal links to change markup within references section. Enhancements when generating numbered references for deleted references. Allow inclusion of references into the index (through include-references-in-index extension). Fix a bug that caused the newer version of the IETF boilerplate to be produced rather than the pre-RFC3667 one. Update to RFC4287 boilerplate.</dd><dt>2006-11-11</dt><dd>Add extension attribute x:for-anchor to &lt;iref&gt; handling.</dd><dt>2006-11-26</dt><dd>Experimental (and limited) support for &lt;x:lt&gt;.</dd><dt>2006-12-04</dt><dd>Fix bugs in processing documents that have both the ipr and the number attribute set on the rfc root element. Add support for x:fmt='none' on xrefs. Add different pre style based on artwork type attributes (experimental).</dd><dt>2006-12-13</dt><dd>Add x:fmt='anchor' for xref elements.</dd><dt>2007-01-07</dt><dd>Fix root template for compatibility for the exslt:node-set implementation in Firefox3.</dd><dt>2007-01-29</dt><dd>Avoid empty table entry in front matter when organization is not specified for an author.</dd><dt>2007-02-10</dt><dd>Allow change tracking in table rows.</dd><dt>2007-03-09</dt><dd>Add hcard profile URI (&lt;<a href="http://www.w3.org/2006/03/hcard">http://www.w3.org/2006/03/hcard</a>&gt;) to head element. Add warning for misplaced &lt;t&gt; elements (after section).</dd><dt>2007-03-21</dt><dd>Fix internal linking from reference entries in index for some xref types. Minor CSS tweaks contributed by MTR. Allow turning on text justification through a PI. Improve iref anchor generation to generate less instable anchors.</dd><dt>2007-03-28</dt><dd>Fixes for numbering of ed:inserted references sections.</dd><dt>2007-05-04</dt><dd>Do not generate anchors for edits in deleted sections. Enhance HTML conformance.</dd><dt>2007-05-19</dt><dd>Enhance diagnostics when using Saxon (needs Saxon's "-l" command line parameter to keep line number information). Add warning when symref PI is missing (default will change in the future). Add support for overriding computed section numbers (when formatting historic documents).</dd><dt>2007-06-07</dt><dd>Change default for symrefs PI to "yes" (see change in xml2rfc 1.33pre4). Warn about docName attributes that appear to contain a file extension.</dd><dt>2007-06-26</dt><dd>Workaround author/@initials values without trailing dot, as in xml2rfc.tcl.</dd><dt>2007-07-14</dt><dd>Enhance index generation for references that use @x:sec attribute.</dd><dt>2007-09-09</dt><dd>Fix: sortrefs is a nop when symrefs=no.</dd><dt>2007-10-17</dt><dd>Work in progress: add support for referencing sections in sibling documents by anchor name.</dd><dt>2007-10-17</dt><dd>Work in progress (continued): support for referencing sections in sibling documents by anchor name.</dd><dt>2007-12-31</dt><dd>Emit warning when updating/obsoleting stuff that's not referenced.</dd><dt>2008-02-03</dt><dd>Support xml2rfc-1.33pre5's suppress-title attribute on texttable and figure.</dd><dt>2008-02-06</dt><dd>Extension: allow &lt;eref&gt; below &lt;cref&gt;.</dd><dt>2008-02-17</dt><dd>Extensions: add x:span and x:length-of.</dd><dt>2008-02-20</dt><dd>Add new RFC boilerplate (as changed in 2007-08).</dd><dt>2008-02-27</dt><dd>Improve diagnostics for artwork width problems; add defaulting of publication dates (requires XSLT processor supporting exslt:date, or msxml).</dd><dt>2008-02-29</dt><dd>Enhance CSS for link elements in the front header, update rules for generating "Acknowledgment" statement.</dd><dt>2008-03-01</dt><dd>Use line numbers in diagnostics in Saxon8/9 as well.</dd><dt>2008-03-02</dt><dd>Fix a bug in the logic choosing the boilerplate, resulting in obsolete text being inserted into IDs.</dd><dt>2008-04-01</dt><dd>Add support for superscript element.</dd><dt>2008-06-28</dt><dd>Add sanity checks for email addresses, allow multiple email elements.</dd><dt>2008-07-06</dt><dd>Add x:abnf-char-sequence.</dd><dt>2008-08-21</dt><dd>Add x:note.</dd><dt>2008-09-06</dt><dd>Add experimental support for SVG images.</dd><dt>2008-09-17</dt><dd>Add experimental support for x:author. Fix xref/@format=none.</dd><dt>2008-10-10</dt><dd>Fix a huge bug, causing text content after an XML comment to be ignored.</dd><dt>2009-02-24</dt><dd>Use table/caption when needed.</dd><dt>2009-03-07</dt><dd>Fix bug that caused text to disappear in the output in presence of processing instructions.</dd><dt>2009-03-12</dt><dd>Make inlined comments bookmarkable.</dd><dt>2009-04-09</dt><dd>Upgrade to DC-HTML from RFC 2731 (affects head/@profile).</dd><dt>2009-07-08</dt><dd>Remove table/@summary in output; the value getting inserted was just repeating stuff that appeared in the preamble.</dd><dt>2009-08-01</dt><dd>Implement table alignment (HTML output only for now).</dd><dt>2009-08-18</dt><dd>Replicate Dublin Core "abstract" metadata into meta/@name=description (search engines do use it).</dd><dt>2009-09-02</dt><dd>Fix default/left alignment of table columns, remove silly table summmary attributes.</dd><dt>2009-09-24</dt><dd>Support double-sided layout using CSS page:left/right selectors.</dd><dt>2009-11-27</dt><dd>Generate unordered lists instead of broken definition lists for list style empty.</dd></dl><h2 id="rfc.section.F.6"><a href="#rfc.section.F.6">F.6</a>&nbsp;rfc2629toFO.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2003-11-29</dt><dd>Enhance handling of unknown list styles.</dd><dt>2004-04-04</dt><dd>Update reference section handling.</dd><dt>2004-04-17</dt><dd>Use XSL-WD-1.1-style fo:bookmark and index handling and add postprocessors for existing implementations. Unify PDF info generation by using XEP (postprocessors) will convert.</dd><dt>2004-04-20</dt><dd>Add experimental cref support.</dd><dt>2004-06-14</dt><dd>Set correct index-item defaults.</dd><dt>2004-07-18</dt><dd>Add list style=letters.</dd><dt>2004-09-03</dt><dd>Make URLs in text break where they are allowed to break by inserting zero-width spaces.</dd><dt>2004-09-26</dt><dd>Fix letter-style inside nested lists.</dd><dt>2004-10-31</dt><dd>Update handling of artwork.</dd><dt>2004-11-13</dt><dd>Fix handling of references inside ed:* markup. Fix whitespace handling in artwork.</dd><dt>2004-11-27</dt><dd>Irefs in artwork generate monospaced entries in index.</dd><dt>2005-01-31</dt><dd>Fix TOC generation that was broken after changes in main XSLT.</dd><dt>2005-02-05</dt><dd>Bring in sync with cosmetic changes in rfc2629.xslt.</dd><dt>2005-05-07</dt><dd>Minor fix for change tracking in document title. Support for table styles.</dd><dt>2005-06-18</dt><dd>Fix references to tables.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd><dt>2007-03-21</dt><dd>Support optional text justification.</dd><dt>2007-05-19</dt><dd>Various improvements in spacing; also allow overriding the automatic list indentation via list/x:indent.</dd><dt>2009-04-08</dt><dd>Fix spacing in headers; add support for formatting for double-sided printing.</dd><dt>2009-08-01</dt><dd>Remove surplus empty pages when not generating double-sided output.</dd></dl><h2 id="rfc.section.F.7"><a href="#rfc.section.F.7">F.7</a>&nbsp;xsl11toAn.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><h2 id="rfc.section.F.8"><a href="#rfc.section.F.8">F.8</a>&nbsp;xsl11toFop.xslt</h2><dl><dt>2010-08-25</dt><dd>Switch to Apache FOP 1.0.</dd><dt>2009-09-12</dt><dd>Support for FOP 0.20.5 and FOP 0.93 removed. Please use FOP 0.95.</dd><dt>2008-03-15</dt><dd>Add a workaround to the fo:inline workaround (sigh).</dd></dl><h2 id="rfc.section.F.9"><a href="#rfc.section.F.9">F.9</a>&nbsp;xsl11toXep.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2004-09-04</dt><dd>Fix xep:index-item attributes.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><hr class="noprint"><h1 id="rfc.index" class="np"><a href="#rfc.index">Index</a></h1><p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.B">B</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.J">J</a> <a href="#rfc.index.K">K</a> <a href="#rfc.index.L">L</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.Q">Q</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.T">T</a> <a href="#rfc.index.X">X</a> </p><div class="print2col"><ul class="ind"><li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul><li>abnf-char-sequence Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.27"><b>11.1</b></a>, <a href="#rfc.iref.a.29">A</a></li><li>allow-markup-in-artwork PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.a.1">3.3</a></li><li>alternate HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.22">6.2</a></li><li>anchor-alias Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.28"><b>11.2</b></a>, <a href="#rfc.iref.a.30">A</a></li><li>Anchors&nbsp;&nbsp;<ul><li>rfc.abstract&nbsp;&nbsp;<a href="#rfc.iref.a.3">4</a></li><li>rfc.authors&nbsp;&nbsp;<a href="#rfc.iref.a.4">4</a></li><li>rfc.copyright&nbsp;&nbsp;<a href="#rfc.iref.a.5">4</a></li><li>rfc.copyrightnotice&nbsp;&nbsp;<a href="#rfc.iref.a.6">4</a></li><li>rfc.figure.n&nbsp;&nbsp;<a href="#rfc.iref.a.7">4</a>, <a href="#rfc.iref.a.18">4</a></li><li>rfc.figure.u.n&nbsp;&nbsp;<a href="#rfc.iref.a.8">4</a>, <a href="#rfc.iref.a.19">4</a></li><li>rfc.index&nbsp;&nbsp;<a href="#rfc.iref.a.9">4</a></li><li>rfc.ipr&nbsp;&nbsp;<a href="#rfc.iref.a.10">4</a></li><li>rfc.iref.n&nbsp;&nbsp;<a href="#rfc.iref.a.11">4</a></li><li>rfc.note.n&nbsp;&nbsp;<a href="#rfc.iref.a.12">4</a></li><li>rfc.references&nbsp;&nbsp;<a href="#rfc.iref.a.13">4</a>, <a href="#rfc.iref.a.14">4</a></li><li>rfc.section.n&nbsp;&nbsp;<a href="#rfc.iref.a.15">4</a></li><li>rfc.section.n.p.m&nbsp;&nbsp;<a href="#rfc.iref.a.16">4</a></li><li>rfc.status&nbsp;&nbsp;<a href="#rfc.iref.a.17">4</a></li><li>rfc.toc&nbsp;&nbsp;<a href="#rfc.iref.a.20">4</a></li><li>rfc.xref.name.n&nbsp;&nbsp;<a href="#rfc.iref.a.21">4</a></li></ul></li><li>AntennaHouse XSL Formatter&nbsp;&nbsp;<a href="#rfc.iref.a.26">9.1</a></li><li>Apache FOP&nbsp;&nbsp;<a href="#rfc.iref.a.25">9.1</a></li><li>appendix HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.23">6.2</a></li><li>assign-section-number Extension Element&nbsp;&nbsp;<a href="#rfc.iref.a.31">A</a></li><li>author HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.a.24">6.2</a></li><li>authors-section PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.a.2">3.3</a></li></ul></li><li><a id="rfc.index.B" href="#rfc.index.B"><b>B</b></a><ul><li>background PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.b.1">3.1</a></li><li>bb Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.3"><b>11.4</b></a>, <a href="#rfc.iref.b.8">A</a></li><li>bc Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.4"><b>11.5</b></a>, <a href="#rfc.iref.b.9">A</a></li><li>bcp14 Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.2"><b>11.3</b></a>, <a href="#rfc.iref.b.10">A</a></li><li><em>BCP97</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP97.1">12.1</a>, <a href="#BCP97"><b>13</b></a></li><li>blockquote Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.5"><b>11.6</b></a>, <a href="#rfc.iref.b.11">A</a></li><li>boilerplate Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.6"><b>11.7</b></a>, <a href="#rfc.iref.b.12">A</a></li><li>bt Extension Element&nbsp;&nbsp;<a href="#rfc.iref.b.7"><b>11.8</b></a>, <a href="#rfc.iref.b.13">A</a></li></ul></li><li><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul><li>chapter HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.3">6.2</a></li><li>CHM format&nbsp;&nbsp;<a href="#rfc.iref.c.7">8</a></li><li>comments PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.c.2">3.1</a></li><li>compact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.c.1">3.1</a></li><li>contents HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.4">6.2</a></li><li>copyright HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.c.5">6.2</a></li><li>Creator DCMI property&nbsp;&nbsp;<a href="#rfc.iref.c.6">6.4</a></li></ul></li><li><a id="rfc.index.D" href="#rfc.index.D"><b>D</b></a><ul><li>Date.Issued DCMI property&nbsp;&nbsp;<a href="#rfc.iref.d.3">6.4</a></li><li><em>DC-HTML</em>&nbsp;&nbsp;<a href="#rfc.xref.DC-HTML.1">6.4</a>, <a href="#DC-HTML"><b>13</b></a></li><li>DCMI properties&nbsp;&nbsp;<ul><li>Creator&nbsp;&nbsp;<a href="#rfc.iref.d.2">6.4</a></li><li>Date.Issued&nbsp;&nbsp;<a href="#rfc.iref.d.4">6.4</a></li><li>Description.Abstract&nbsp;&nbsp;<a href="#rfc.iref.d.6">6.4</a></li><li>Identifier&nbsp;&nbsp;<a href="#rfc.iref.d.7">6.4</a></li><li>isPartOf&nbsp;&nbsp;<a href="#rfc.iref.d.8">6.4</a></li><li>Relation.Replaces&nbsp;&nbsp;<a href="#rfc.iref.d.9">6.4</a></li></ul></li><li>Description.Abstract DCMI property&nbsp;&nbsp;<a href="#rfc.iref.d.5">6.4</a></li><li>dfn Extension Element&nbsp;&nbsp;<a href="#rfc.iref.d.10"><b>11.9</b></a>, <a href="#rfc.iref.d.11">A</a></li><li>duplex PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.d.1">3.3</a></li></ul></li><li><a id="rfc.index.E" href="#rfc.index.E"><b>E</b></a><ul><li>editing PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.e.1">3.1</a></li><li>Extension Elements&nbsp;&nbsp;<ul><li>abnf-char-sequence&nbsp;&nbsp;<a href="#rfc.iref.e.2"><b>11.1</b></a>, <a href="#rfc.iref.e.23">A</a></li><li>anchor-alias&nbsp;&nbsp;<a href="#rfc.iref.e.3"><b>11.2</b></a>, <a href="#rfc.iref.e.24">A</a></li><li>assign-section-number&nbsp;&nbsp;<a href="#rfc.iref.e.26">A</a></li><li>bb&nbsp;&nbsp;<a href="#rfc.iref.e.5"><b>11.4</b></a>, <a href="#rfc.iref.e.27">A</a></li><li>bc&nbsp;&nbsp;<a href="#rfc.iref.e.6"><b>11.5</b></a>, <a href="#rfc.iref.e.28">A</a></li><li>bcp14&nbsp;&nbsp;<a href="#rfc.iref.e.4"><b>11.3</b></a>, <a href="#rfc.iref.e.29">A</a></li><li>blockquote&nbsp;&nbsp;<a href="#rfc.iref.e.7"><b>11.6</b></a>, <a href="#rfc.iref.e.30">A</a></li><li>boilerplate&nbsp;&nbsp;<a href="#rfc.iref.e.8"><b>11.7</b></a>, <a href="#rfc.iref.e.31">A</a></li><li>bt&nbsp;&nbsp;<a href="#rfc.iref.e.9"><b>11.8</b></a>, <a href="#rfc.iref.e.32">A</a></li><li>dfn&nbsp;&nbsp;<a href="#rfc.iref.e.10"><b>11.9</b></a>, <a href="#rfc.iref.e.33">A</a></li><li>h&nbsp;&nbsp;<a href="#rfc.iref.e.11"><b>11.10</b></a>, <a href="#rfc.iref.e.34">A</a></li><li>highlight&nbsp;&nbsp;<a href="#rfc.iref.e.12"><b>11.11</b></a>, <a href="#rfc.iref.e.35">A</a></li><li>include-author&nbsp;&nbsp;<a href="#rfc.iref.e.25">A</a></li><li>length-of&nbsp;&nbsp;<a href="#rfc.iref.e.13"><b>11.12</b></a>, <a href="#rfc.iref.e.36">A</a></li><li>link&nbsp;&nbsp;<a href="#rfc.iref.e.14"><b>11.13</b></a>, <a href="#rfc.iref.e.37">A</a></li><li>lt&nbsp;&nbsp;<a href="#rfc.iref.e.15"><b>11.14</b></a>, <a href="#rfc.iref.e.38">A</a></li><li>note&nbsp;&nbsp;<a href="#rfc.iref.e.16"><b>11.15</b></a>, <a href="#rfc.iref.e.39">A</a></li><li>parse-xml&nbsp;&nbsp;<a href="#rfc.iref.e.17"><b>11.16</b></a>, <a href="#rfc.iref.e.40">A</a></li><li>prose&nbsp;&nbsp;<a href="#rfc.iref.e.18"><b>11.17</b></a>, <a href="#rfc.iref.e.41">A</a></li><li>q&nbsp;&nbsp;<a href="#rfc.iref.e.19"><b>11.18</b></a>, <a href="#rfc.iref.e.42">A</a></li><li>rdf:Description&nbsp;&nbsp;<a href="#rfc.iref.e.48">A</a></li><li>ref&nbsp;&nbsp;<a href="#rfc.iref.e.20"><b>11.19</b></a>, <a href="#rfc.iref.e.43">A</a></li><li>source&nbsp;&nbsp;<a href="#rfc.iref.e.21"><b>11.20</b></a>, <a href="#rfc.iref.e.44">A</a></li><li>span&nbsp;&nbsp;<a href="#rfc.iref.e.46">A</a></li><li>sup&nbsp;&nbsp;<a href="#rfc.iref.e.22"><b>11.21</b></a>, <a href="#rfc.iref.e.45">A</a></li><li>x&nbsp;&nbsp;<a href="#rfc.iref.e.47">A</a></li></ul></li></ul></li><li><a id="rfc.index.F" href="#rfc.index.F"><b>F</b></a><ul><li>Firefox&nbsp;&nbsp;<ul><li>1.*/2.*&nbsp;&nbsp;<a href="#rfc.iref.f.3">5.2</a></li><li>3.*&nbsp;&nbsp;<a href="#rfc.iref.f.2">5.2</a></li></ul></li><li>footer PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.f.1">3.1</a></li></ul></li><li><a id="rfc.index.G" href="#rfc.index.G"><b>G</b></a><ul><li>generator HTML META element&nbsp;&nbsp;<a href="#rfc.iref.g.2">6.3</a></li><li>Google Chrome&nbsp;&nbsp;<a href="#rfc.iref.g.1">5.2</a></li><li>Grammar&nbsp;&nbsp;<a href="#rfc.iref.g.3"><b>A</b></a></li></ul></li><li><a id="rfc.index.H" href="#rfc.index.H"><b>H</b></a><ul><li>h Extension Element&nbsp;&nbsp;<a href="#rfc.iref.h.12"><b>11.10</b></a>, <a href="#rfc.iref.h.14">A</a></li><li>header PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.h.1">3.1</a></li><li>highlight Extension Element&nbsp;&nbsp;<a href="#rfc.iref.h.13"><b>11.11</b></a>, <a href="#rfc.iref.h.15">A</a></li><li><em>HTML</em>&nbsp;&nbsp;<a href="#rfc.xref.HTML.1">6.1</a>, <a href="#rfc.xref.HTML.2">11.6</a>, <a href="#rfc.xref.HTML.3">11.9</a>, <a href="#rfc.xref.HTML.4">11.18</a>, <a href="#rfc.xref.HTML.5">11.21</a>, <a href="#HTML"><b>13</b></a></li><li>HTML compliance&nbsp;&nbsp;<a href="#rfc.iref.h.2">6.1</a></li><li>HTML LINK elements&nbsp;&nbsp;<ul><li>alternate&nbsp;&nbsp;<a href="#rfc.iref.h.3">6.2</a></li><li>appendix&nbsp;&nbsp;<a href="#rfc.iref.h.4">6.2</a></li><li>author&nbsp;&nbsp;<a href="#rfc.iref.h.5">6.2</a></li><li>chapter&nbsp;&nbsp;<a href="#rfc.iref.h.6">6.2</a></li><li>contents&nbsp;&nbsp;<a href="#rfc.iref.h.7">6.2</a></li><li>copyright&nbsp;&nbsp;<a href="#rfc.iref.h.8">6.2</a></li><li>index&nbsp;&nbsp;<a href="#rfc.iref.h.9">6.2</a></li></ul></li><li>HTML META elements&nbsp;&nbsp;<ul><li>generator&nbsp;&nbsp;<a href="#rfc.iref.h.10">6.3</a></li><li>keywords&nbsp;&nbsp;<a href="#rfc.iref.h.11">6.3</a></li></ul></li></ul></li><li><a id="rfc.index.I" href="#rfc.index.I"><b>I</b></a><ul><li>Identifier DCMI property&nbsp;&nbsp;<a href="#rfc.iref.i.12">6.4</a></li><li>include PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.3">3.2</a></li><li>include-author Extension Element&nbsp;&nbsp;<a href="#rfc.iref.i.14">A</a></li><li>include-index PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.4">3.3</a></li><li>include-references-in-index PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.5">3.3</a></li><li>index HTML LINK element&nbsp;&nbsp;<a href="#rfc.iref.i.11">6.2</a></li><li>inline PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.1">3.1</a></li><li>Internet Explorer 5.5&nbsp;&nbsp;<a href="#rfc.iref.i.6">5.2</a></li><li>Internet Explorer 6&nbsp;&nbsp;<a href="#rfc.iref.i.7">5.2</a></li><li>Internet Explorer 7&nbsp;&nbsp;<a href="#rfc.iref.i.8">5.2</a></li><li>Internet Explorer 8&nbsp;&nbsp;<a href="#rfc.iref.i.9">5.2</a></li><li>Internet Explorer 9&nbsp;&nbsp;<a href="#rfc.iref.i.10">5.2</a></li><li>iprnotified PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.i.2">3.1</a></li><li>isPartOf DCMI property&nbsp;&nbsp;<a href="#rfc.iref.i.13">6.4</a></li></ul></li><li><a id="rfc.index.J" href="#rfc.index.J"><b>J</b></a><ul><li>justification PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.j.1">3.3</a></li></ul></li><li><a id="rfc.index.K" href="#rfc.index.K"><b>K</b></a><ul><li>keywords HTML META element&nbsp;&nbsp;<a href="#rfc.iref.k.1">6.3</a></li></ul></li><li><a id="rfc.index.L" href="#rfc.index.L"><b>L</b></a><ul><li>length-of Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.2"><b>11.12</b></a>, <a href="#rfc.iref.l.5">A</a></li><li>link Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.3"><b>11.13</b></a>, <a href="#rfc.iref.l.6">A</a></li><li>linkmailto PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.l.1">3.1</a></li><li>lt Extension Element&nbsp;&nbsp;<a href="#rfc.iref.l.4"><b>11.14</b></a>, <a href="#rfc.iref.l.7">A</a></li></ul></li><li><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul><li>Microsoft Help&nbsp;&nbsp;<a href="#rfc.iref.m.5">8</a></li><li>Mozilla&nbsp;&nbsp;<a href="#rfc.iref.m.3">5.2</a>, <a href="#rfc.iref.m.4">5.2</a></li><li>MSXML3&nbsp;&nbsp;<a href="#rfc.iref.m.1">5.1</a></li><li>MSXML4&nbsp;&nbsp;<a href="#rfc.iref.m.2">5.1</a></li></ul></li><li><a id="rfc.index.N" href="#rfc.index.N"><b>N</b></a><ul><li>needLines PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.n.1">3.2</a></li><li>NoScript&nbsp;&nbsp;<a href="#rfc.iref.n.2">5.2</a></li><li>note Extension Element&nbsp;&nbsp;<a href="#rfc.iref.n.3"><b>11.15</b></a>, <a href="#rfc.iref.n.4">A</a></li></ul></li><li><a id="rfc.index.O" href="#rfc.index.O"><b>O</b></a><ul><li>Opera&nbsp;&nbsp;<a href="#rfc.iref.o.1">5.2</a>, <a href="#rfc.iref.o.2">5.2</a></li></ul></li><li><a id="rfc.index.P" href="#rfc.index.P"><b>P</b></a><ul><li>Parameters&nbsp;&nbsp;<ul><li>xml2rfc-background&nbsp;&nbsp;<a href="#rfc.iref.p.2">3.1</a></li><li>xml2rfc-comments&nbsp;&nbsp;<a href="#rfc.iref.p.6">3.1</a></li><li>xml2rfc-compact&nbsp;&nbsp;<a href="#rfc.iref.p.4">3.1</a></li><li>xml2rfc-editing&nbsp;&nbsp;<a href="#rfc.iref.p.8">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.44">3.3</a></li><li>xml2rfc-ext-authors-section&nbsp;&nbsp;<a href="#rfc.iref.p.46">3.3</a></li><li>xml2rfc-ext-duplex&nbsp;&nbsp;<a href="#rfc.iref.p.48">3.3</a></li><li>xml2rfc-ext-include-index&nbsp;&nbsp;<a href="#rfc.iref.p.50">3.3</a></li><li>xml2rfc-ext-include-references-in-index&nbsp;&nbsp;<a href="#rfc.iref.p.52">3.3</a></li><li>xml2rfc-ext-justification&nbsp;&nbsp;<a href="#rfc.iref.p.54">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.57">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots&nbsp;&nbsp;<a href="#rfc.iref.p.61">3.3</a></li><li>xml2rfc-ext-support-rfc2731&nbsp;&nbsp;<a href="#rfc.iref.p.59">3.3</a></li><li>xml2rfc-footer&nbsp;&nbsp;<a href="#rfc.iref.p.10">3.1</a></li><li>xml2rfc-header&nbsp;&nbsp;<a href="#rfc.iref.p.12">3.1</a></li><li>xml2rfc-inline&nbsp;&nbsp;<a href="#rfc.iref.p.14">3.1</a></li><li>xml2rfc-iprnotified&nbsp;&nbsp;<a href="#rfc.iref.p.16">3.1</a></li><li>xml2rfc-linkmailto&nbsp;&nbsp;<a href="#rfc.iref.p.18">3.1</a></li><li>xml2rfc-private&nbsp;&nbsp;<a href="#rfc.iref.p.21">3.1</a></li><li>xml2rfc-refparent&nbsp;&nbsp;<a href="#rfc.iref.p.23">3.1</a></li><li>xml2rfc-rfcedstyle&nbsp;&nbsp;<a href="#rfc.iref.p.25">3.1</a></li><li>xml2rfc-sortrefs&nbsp;&nbsp;<a href="#rfc.iref.p.27">3.1</a></li><li>xml2rfc-symrefs&nbsp;&nbsp;<a href="#rfc.iref.p.29">3.1</a></li><li>xml2rfc-toc&nbsp;&nbsp;<a href="#rfc.iref.p.31">3.1</a></li><li>xml2rfc-tocdepth&nbsp;&nbsp;<a href="#rfc.iref.p.33">3.1</a></li><li>xml2rfc-topblock&nbsp;&nbsp;<a href="#rfc.iref.p.35">3.1</a></li></ul></li><li>parse-xml Extension Element&nbsp;&nbsp;<a href="#rfc.iref.p.62"><b>11.16</b></a>, <a href="#rfc.iref.p.64">A</a></li><li>parse-xml-in-artwork PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.p.55">3.3</a></li><li>private PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.p.19">3.1</a>, <a href="#rfc.iref.p.66">D</a></li><li>Processing Instruction pseudo attributes&nbsp;&nbsp;<ul><li>allow-markup-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.43">3.3</a></li><li>authors-section&nbsp;&nbsp;<a href="#rfc.iref.p.45">3.3</a></li><li>background&nbsp;&nbsp;<a href="#rfc.iref.p.1">3.1</a></li><li>comments&nbsp;&nbsp;<a href="#rfc.iref.p.5">3.1</a></li><li>compact&nbsp;&nbsp;<a href="#rfc.iref.p.3">3.1</a></li><li>duplex&nbsp;&nbsp;<a href="#rfc.iref.p.47">3.3</a></li><li>editing&nbsp;&nbsp;<a href="#rfc.iref.p.7">3.1</a></li><li>footer&nbsp;&nbsp;<a href="#rfc.iref.p.9">3.1</a></li><li>header&nbsp;&nbsp;<a href="#rfc.iref.p.11">3.1</a></li><li>ijustification&nbsp;&nbsp;<a href="#rfc.iref.p.53">3.3</a></li><li>include&nbsp;&nbsp;<a href="#rfc.iref.p.36">3.2</a></li><li>include-index&nbsp;&nbsp;<a href="#rfc.iref.p.49">3.3</a></li><li>include-references-in-index&nbsp;&nbsp;<a href="#rfc.iref.p.51">3.3</a></li><li>inline&nbsp;&nbsp;<a href="#rfc.iref.p.13">3.1</a></li><li>iprnotified&nbsp;&nbsp;<a href="#rfc.iref.p.15">3.1</a></li><li>linkmailto&nbsp;&nbsp;<a href="#rfc.iref.p.17">3.1</a></li><li>needLines&nbsp;&nbsp;<a href="#rfc.iref.p.37">3.2</a></li><li>parse-xml-in-artwork&nbsp;&nbsp;<a href="#rfc.iref.p.56">3.3</a></li><li>private&nbsp;&nbsp;<a href="#rfc.iref.p.20">3.1</a>, <a href="#rfc.iref.p.67">D</a></li><li>refparent&nbsp;&nbsp;<a href="#rfc.iref.p.22">3.1</a></li><li>rfcedstyle&nbsp;&nbsp;<a href="#rfc.iref.p.24">3.1</a></li><li>sec-no-trailing-dots&nbsp;&nbsp;<a href="#rfc.iref.p.60">3.3</a></li><li>slides&nbsp;&nbsp;<a href="#rfc.iref.p.38">3.2</a></li><li>sortrefs&nbsp;&nbsp;<a href="#rfc.iref.p.26">3.1</a></li><li>strict&nbsp;&nbsp;<a href="#rfc.iref.p.39">3.2</a></li><li>subcompact&nbsp;&nbsp;<a href="#rfc.iref.p.40">3.2</a></li><li>support-rfc2731&nbsp;&nbsp;<a href="#rfc.iref.p.58">3.3</a></li><li>symrefs&nbsp;&nbsp;<a href="#rfc.iref.p.28">3.1</a></li><li>toc&nbsp;&nbsp;<a href="#rfc.iref.p.30">3.1</a></li><li>tocdepth&nbsp;&nbsp;<a href="#rfc.iref.p.32">3.1</a></li><li>tocindent&nbsp;&nbsp;<a href="#rfc.iref.p.41">3.2</a></li><li>tocompact&nbsp;&nbsp;<a href="#rfc.iref.p.42">3.2</a></li><li>topblock&nbsp;&nbsp;<a href="#rfc.iref.p.34">3.1</a></li></ul></li><li>prose Extension Element&nbsp;&nbsp;<a href="#rfc.iref.p.63"><b>11.17</b></a>, <a href="#rfc.iref.p.65">A</a></li></ul></li><li><a id="rfc.index.Q" href="#rfc.index.Q"><b>Q</b></a><ul><li>q Extension Element&nbsp;&nbsp;<a href="#rfc.iref.q.1"><b>11.18</b></a>, <a href="#rfc.iref.q.2">A</a></li></ul></li><li><a id="rfc.index.R" href="#rfc.index.R"><b>R</b></a><ul><li>rdf:Description Extension Element&nbsp;&nbsp;<a href="#rfc.iref.r.26">A</a></li><li>ref Extension Element&nbsp;&nbsp;<a href="#rfc.iref.r.23"><b>11.19</b></a>, <a href="#rfc.iref.r.25">A</a></li><li>refparent PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.r.1">3.1</a></li><li>Relation.Replaces DCMI property&nbsp;&nbsp;<a href="#rfc.iref.r.22">6.4</a></li><li>RELAX NG Compact Schema&nbsp;&nbsp;<a href="#rfc.iref.r.24"><b>A</b></a></li><li>rfc.abstract anchor&nbsp;&nbsp;<a href="#rfc.iref.r.3">4</a></li><li>rfc.authors anchor&nbsp;&nbsp;<a href="#rfc.iref.r.4">4</a></li><li>rfc.copyright anchor&nbsp;&nbsp;<a href="#rfc.iref.r.5">4</a></li><li>rfc.copyrightnotice anchor&nbsp;&nbsp;<a href="#rfc.iref.r.6">4</a></li><li>rfc.figure.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.7">4</a>, <a href="#rfc.iref.r.18">4</a></li><li>rfc.figure.u.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.8">4</a>, <a href="#rfc.iref.r.19">4</a></li><li>rfc.index anchor&nbsp;&nbsp;<a href="#rfc.iref.r.9">4</a></li><li>rfc.ipr anchor&nbsp;&nbsp;<a href="#rfc.iref.r.10">4</a></li><li>rfc.iref.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.11">4</a></li><li>rfc.note.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.12">4</a></li><li>rfc.references anchor&nbsp;&nbsp;<a href="#rfc.iref.r.13">4</a></li><li>rfc.references.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.14">4</a></li><li>rfc.section.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.15">4</a></li><li>rfc.section.n.p.m anchor&nbsp;&nbsp;<a href="#rfc.iref.r.16">4</a></li><li>rfc.status anchor&nbsp;&nbsp;<a href="#rfc.iref.r.17">4</a></li><li>rfc.toc anchor&nbsp;&nbsp;<a href="#rfc.iref.r.20">4</a></li><li>rfc.xref.name.n anchor&nbsp;&nbsp;<a href="#rfc.iref.r.21">4</a></li><li><em>RFC2026</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.1">11.25</a>, <a href="#RFC2026"><b>13</b></a>, <a href="#rfc.xref.RFC2026.2">D.2</a><ul><li><em>Section 4</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.2">D.2</a></li><li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2026.1">11.25</a></li></ul></li><li><em>RFC2119</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2119.1">11.3</a>, <a href="#rfc.xref.RFC2119.2">11.27</a>, <a href="#RFC2119"><b>13</b></a><ul><li><em>Section 5</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2119.2">11.27</a></li></ul></li><li><em>RFC2616</em>&nbsp;&nbsp;<a href="#RFC2616"><b>13</b></a>, <a href="#rfc.xref.RFC2616.1">B.1</a>, <a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a><ul><li><em>Section 2.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2616.1">B.1</a></li><li><em>Section 19.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a></li></ul></li><li><em>RFC2629</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2629.1">1</a>, <a href="#RFC2629"><b>13</b></a></li><li><em>RFC2648</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2648.1">6.4</a>, <a href="#RFC2648"><b>13</b></a></li><li><em>RFC2731</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2731.1">6.4</a>, <a href="#RFC2731"><b>13</b></a></li><li><em>RFC5234</em>&nbsp;&nbsp;<a href="#RFC5234"><b>13</b></a>, <a href="#rfc.xref.RFC5234.1">B.1</a></li><li><em>RFC5741</em>&nbsp;&nbsp;<a href="#RFC5741"><b>13</b></a>, <a href="#rfc.xref.RFC5741.1">D.3</a>, <a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a><ul><li><em>Section 3.2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a></li></ul></li><li>rfcedstyle PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.r.2">3.1</a></li><li><em>RNC</em>&nbsp;&nbsp;<a href="#RNC"><b>13</b></a>, <a href="#rfc.xref.RNC.1">A</a>, <a href="#rfc.xref.RNC.2">B.1</a></li></ul></li><li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul><li>Safari&nbsp;&nbsp;<a href="#rfc.iref.s.9">5.2</a>, <a href="#rfc.iref.s.11">5.2</a><ul><li>3.*&nbsp;&nbsp;<a href="#rfc.iref.s.10">5.2</a></li></ul></li><li>Saxon&nbsp;&nbsp;<a href="#rfc.iref.s.8">5.1</a></li><li>Schema&nbsp;&nbsp;<a href="#rfc.iref.s.14"><b>A</b></a></li><li>sec-no-trailing-dots PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.7">3.3</a></li><li>slides PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.3">3.2</a></li><li>sortrefs PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.1">3.1</a></li><li>source Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.12"><b>11.20</b></a>, <a href="#rfc.iref.s.15">A</a></li><li>span Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.17">A</a></li><li>strict PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.4">3.2</a></li><li>subcompact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.5">3.2</a></li><li>sup Extension Element&nbsp;&nbsp;<a href="#rfc.iref.s.13"><b>11.21</b></a>, <a href="#rfc.iref.s.16">A</a></li><li>support-rfc2731 PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.6">3.3</a></li><li>symrefs PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.s.2">3.1</a></li></ul></li><li><a id="rfc.index.T" href="#rfc.index.T"><b>T</b></a><ul><li>toc PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.1">3.1</a></li><li>tocdepth PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.2">3.1</a></li><li>tocindent PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.4">3.2</a></li><li>tocompact PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.5">3.2</a></li><li>topblock PI pseudo-attribute&nbsp;&nbsp;<a href="#rfc.iref.t.3">3.1</a></li></ul></li><li><a id="rfc.index.X" href="#rfc.index.X"><b>X</b></a><ul><li>x Extension Element&nbsp;&nbsp;<a href="#rfc.iref.x.31">A</a></li><li>Xalan&nbsp;&nbsp;<a href="#rfc.iref.x.28">5.1</a></li><li><em>XHTML2</em>&nbsp;&nbsp;<a href="#rfc.xref.XHTML2.1">11.10</a>, <a href="#XHTML2"><b>13</b></a></li><li><em>XML</em>&nbsp;&nbsp;<a href="#XML"><b>13</b></a>, <a href="#rfc.xref.XML.1">C.1</a><ul><li><em>Section 2.8</em>&nbsp;&nbsp;<a href="#rfc.xref.XML.1">C.1</a></li></ul></li><li>xml-stylesheet PI&nbsp;&nbsp;<a href="#rfc.iref.x.30">6</a></li><li>xml2rfc-background parameter&nbsp;&nbsp;<a href="#rfc.iref.x.2">3.1</a></li><li>xml2rfc-comments parameter&nbsp;&nbsp;<a href="#rfc.iref.x.4">3.1</a></li><li>xml2rfc-editing parameter&nbsp;&nbsp;<a href="#rfc.iref.x.3">3.1</a>, <a href="#rfc.iref.x.5">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork parameter&nbsp;&nbsp;<a href="#rfc.iref.x.19">3.3</a></li><li>xml2rfc-ext-authors-section parameter&nbsp;&nbsp;<a href="#rfc.iref.x.20">3.3</a></li><li>xml2rfc-ext-duplex&nbsp;&nbsp;<a href="#rfc.iref.x.21">3.3</a></li><li>xml2rfc-ext-include-index parameter&nbsp;&nbsp;<a href="#rfc.iref.x.22">3.3</a></li><li>xml2rfc-ext-include-references-in-index parameter&nbsp;&nbsp;<a href="#rfc.iref.x.23">3.3</a></li><li>xml2rfc-ext-justification parameter&nbsp;&nbsp;<a href="#rfc.iref.x.24">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork parameter&nbsp;&nbsp;<a href="#rfc.iref.x.25">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots parameter&nbsp;&nbsp;<a href="#rfc.iref.x.27">3.3</a></li><li>xml2rfc-ext-support-rfc2731 parameter&nbsp;&nbsp;<a href="#rfc.iref.x.26">3.3</a></li><li>xml2rfc-footer parameter&nbsp;&nbsp;<a href="#rfc.iref.x.6">3.1</a></li><li>xml2rfc-header parameter&nbsp;&nbsp;<a href="#rfc.iref.x.7">3.1</a></li><li>xml2rfc-inline parameter&nbsp;&nbsp;<a href="#rfc.iref.x.8">3.1</a></li><li>xml2rfc-iprnotified parameter&nbsp;&nbsp;<a href="#rfc.iref.x.9">3.1</a></li><li>xml2rfc-linkmailto parameter&nbsp;&nbsp;<a href="#rfc.iref.x.10">3.1</a></li><li>xml2rfc-private parameter&nbsp;&nbsp;<a href="#rfc.iref.x.11">3.1</a></li><li>xml2rfc-refparent parameter&nbsp;&nbsp;<a href="#rfc.iref.x.12">3.1</a></li><li>xml2rfc-rfcedstyle parameter&nbsp;&nbsp;<a href="#rfc.iref.x.13">3.1</a></li><li>xml2rfc-sortrefs parameter&nbsp;&nbsp;<a href="#rfc.iref.x.14">3.1</a></li><li>xml2rfc-symrefs parameter&nbsp;&nbsp;<a href="#rfc.iref.x.15">3.1</a></li><li>xml2rfc-toc parameter&nbsp;&nbsp;<a href="#rfc.iref.x.16">3.1</a></li><li>xml2rfc-tocdepth parameter&nbsp;&nbsp;<a href="#rfc.iref.x.17">3.1</a></li><li>xml2rfc-topblock parameter&nbsp;&nbsp;<a href="#rfc.iref.x.18">3.1</a></li><li><em>XSL-FO</em>&nbsp;&nbsp;<a href="#rfc.xref.XSL-FO.1">9.1</a>, <a href="#rfc.xref.XSL-FO.2">9.1</a>, <a href="#XSL-FO"><b>13</b></a></li><li>xsltproc&nbsp;&nbsp;<a href="#rfc.iref.x.29">5.1</a><ul><li>passing parameters&nbsp;&nbsp;<a href="#rfc.iref.x.1">3</a></li></ul></li></ul></li></ul></div></body></html>
  • rfc2629xslt/rfc2629xslt.txt

    r1276 r1303  
    44RFC2629 through XSLT                                          J. Reschke
    55                                                              greenbytes
    6                                                           April 30, 2011
     6                                                            May 30, 2011
    77
    88
     
    5656
    5757
    58 Documentation             RFC2629 through XSLT                April 2011
     58Documentation             RFC2629 through XSLT                  May 2011
    5959
    6060
     
    113113
    114114
    115 Documentation             RFC2629 through XSLT                April 2011
     115Documentation             RFC2629 through XSLT                  May 2011
    116116
    117117
     
    170170
    171171
    172 Documentation             RFC2629 through XSLT                April 2011
     172Documentation             RFC2629 through XSLT                  May 2011
    173173
    174174
     
    227227
    228228
    229 Documentation             RFC2629 through XSLT                April 2011
     229Documentation             RFC2629 through XSLT                  May 2011
    230230
    231231
     
    284284
    285285
    286 Documentation             RFC2629 through XSLT                April 2011
     286Documentation             RFC2629 through XSLT                  May 2011
    287287
    288288
     
    341341
    342342
    343 Documentation             RFC2629 through XSLT                April 2011
     343Documentation             RFC2629 through XSLT                  May 2011
    344344
    345345
     
    398398
    399399
    400 Documentation             RFC2629 through XSLT                April 2011
     400Documentation             RFC2629 through XSLT                  May 2011
    401401
    402402
     
    455455
    456456
    457 Documentation             RFC2629 through XSLT                April 2011
     457Documentation             RFC2629 through XSLT                  May 2011
    458458
    459459
     
    512512
    513513
    514 Documentation             RFC2629 through XSLT                April 2011
     514Documentation             RFC2629 through XSLT                  May 2011
    515515
    516516
     
    545545   |      |                 |                       |      | printing. |
    546546   |      |                 |                       |      |           |
     547   | rfc- | include-index   | xml2rfc-ext-include-i | "yes | When set  |
     548   | ext  |                 | ndex                  | "    | to "no",  |
     549   |      |                 |                       |      | no index  |
     550   |      |                 |                       |      | will be   |
     551   |      |                 |                       |      | generated |
     552   |      |                 |                       |      | .         |
     553   |      |                 |                       |      |           |
    547554   | rfc- | include-referen | xml2rfc-ext-include-r |      | When set  |
    548555   | ext  | ces-in-index    | eferences-in-index    |      | to "yes", |
     
    559566
    560567
    561 
    562 
    563 
    564 
    565 
    566 
    567 
    568568Reschke                                                        [Page 10]
    569569
    570570
    571 Documentation             RFC2629 through XSLT                April 2011
     571Documentation             RFC2629 through XSLT                  May 2011
    572572
    573573
     
    626626
    627627
    628 Documentation             RFC2629 through XSLT                April 2011
     628Documentation             RFC2629 through XSLT                  May 2011
    629629
    630630
     
    683683
    684684
    685 Documentation             RFC2629 through XSLT                April 2011
     685Documentation             RFC2629 through XSLT                  May 2011
    686686
    687687
     
    740740
    741741
    742 Documentation             RFC2629 through XSLT                April 2011
     742Documentation             RFC2629 through XSLT                  May 2011
    743743
    744744
     
    797797
    798798
    799 Documentation             RFC2629 through XSLT                April 2011
     799Documentation             RFC2629 through XSLT                  May 2011
    800800
    801801
     
    805805   exsl:node-set [1]) which is however widely available.  XSLT
    806806   processors that do not support this extension (or a functional
    807    equivalent) currently are not supported.
     807   equivalent, such as msxsl:node-set) currently are not supported.
     808
     809   Input documents do not always specify the date completely.  In this
     810   case, the transformation attempts to let the XSLT engine to compute
     811   the system date, using either scripting in Microsoft's XSLT engine,
     812   or the exsl:date-time [2] extension function.
    808813
    8098145.1.  Standalone Engines
     
    813818   o  Windows: MSXML3 and MSXML4 (<http://msdn.microsoft.com/xml>;
    814819      command line processor "msxsl" is available from Microsoft
    815       Download Center [2])
     820      Download Center [3])
    816821
    817822   o  Java: Saxon (<http://saxon.sourceforge.net/>)
     
    834839
    835840      *  Be aware that XSLT execution can be suppressed using
    836          NoScript [3]
     841         NoScript [4]
    837842
    838843      *  Firefox does not load external DTDs nor external entities, see
    839          Mozilla Bug 22942 [4], thus entities like &nbsp; need to be
     844         Mozilla Bug 22942 [5], thus entities like &nbsp; need to be
    840845         declared in the internal subset (Appendix C.1)
    841846
     
    843848         occasionally does the initial rendering with the wrong width
    844849         (people who can reproduce this problem please comment on
     850
     851
     852
     853Reschke                                                        [Page 15]
     854
     855
     856Documentation             RFC2629 through XSLT                  May 2011
     857
     858
    845859         <https://bugzilla.mozilla.org/show_bug.cgi?id=640390>.
    846860
     861      *  Date computation may become available in Firefox 6 (see
     862         <https://bugzilla.mozilla.org/show_bug.cgi?id=603159>)
     863
    847864   o  Safari 3 (starting with version 3.0.4)
    848865
    849866
    850 
    851 
    852 
    853 Reschke                                                        [Page 15]
    854 
    855 
    856 Documentation             RFC2629 through XSLT                April 2011
    857 
     867      *  Date computation not available (see
     868         <https://bugs.webkit.org/show_bug.cgi?id=4079>)
    858869
    859870   o  Google Chrome
    860871
     872
     873      *  Date computation not available (see
     874         <https://bugs.webkit.org/show_bug.cgi?id=4079>)
     875
    861876   o  Opera (starting with version 10)
    862877
     878
     879      *  Date computation not available
     880
    863881   The following browsers are known not to work properly:
    864882
    865883   o  Firefox 1.*/2.*: (missing extension function - see change request
    866       at Mozilla BugZilla 193678 [5])
     884      at Mozilla BugZilla 193678 [6])
    867885
    868886   o  Opera 9.21: execution fails, potentially to a somewhat complex
     
    890908
    891909
    892 
    893 
    894 
    895 
    896 
    897 
    898 
    899 
    900 
    901 
    902 
    903 
    904 
    905 
    906 
    907 
    908 
    909 
    910910Reschke                                                        [Page 16]
    911911
    912912
    913 Documentation             RFC2629 through XSLT                April 2011
     913Documentation             RFC2629 through XSLT                  May 2011
    914914
    915915
     
    935935   content-independant links inside the document.  Unfortunately, only
    936936   few user agents support this element.  Firefox users may want to
    937    check the Link Widgets [6] extension.
     937   check the Link Widgets [7] extension.
    938938
    939939                 The following LINK elements are produced:
     
    968968
    969969
    970 Documentation             RFC2629 through XSLT                April 2011
     970Documentation             RFC2629 through XSLT                  May 2011
    971971
    972972
     
    101110116.5.  Experimental hCard support
    10121012
    1013    The generated author information is formatted in hCard [7] format.
     1013   The generated author information is formatted in hCard [8] format.
    10141014
    10151015
     
    10251025
    10261026
    1027 Documentation             RFC2629 through XSLT                April 2011
     1027Documentation             RFC2629 through XSLT                  May 2011
    10281028
    10291029
     
    10821082
    10831083
    1084 Documentation             RFC2629 through XSLT                April 2011
     1084Documentation             RFC2629 through XSLT                  May 2011
    10851085
    10861086
     
    11391139
    11401140
    1141 Documentation             RFC2629 through XSLT                April 2011
     1141Documentation             RFC2629 through XSLT                  May 2011
    11421142
    11431143
     
    11711171   +------------+-------------+------------+-------------+-------------+
    11721172   | XSL 1.1    | no, but can |     yes    |   no, but   |     yes     |
    1173    | WD [8]     |      be     |            |   uses XEP  |             |
     1173   | WD [9]     |      be     |            |   uses XEP  |             |
    11741174   |            | auto-genera |            |    output   |             |
    11751175   |            |   ted from  |            |  extensions |             |
     
    11771177   |            |  attributes |            |             |             |
    11781178   |            |             |            |             |             |
    1179    | Antenna    |      no     |  yes [10]  |   yes [10]  |   yes [10]  |
     1179   | Antenna    |      no     |  yes [11]  |   yes [11]  |   yes [11]  |
    11801180   | House XSL  |             |  (from XSL |  (from XEP  |  (just page |
    11811181   | formatter  |             |     1.1    |   document  |  duplicate  |
    1182    | [9]        |             | bookmarks) |    info)    | elimination |
     1182   | [10]       |             | bookmarks) |    info)    | elimination |
    11831183   |            |             |            |             |  , from XSL |
    11841184   |            |             |            |             |   1.1 page  |
     
    11861186   |            |             |            |             |             |
    11871187   | Apache     |     yes     |  yes (from |     yes     |      no     |
    1188    | FOP [11]   |             |   XSL 1.1  |             |             |
     1188   | FOP [12]   |             |   XSL 1.1  |             |             |
    11891189   |            |             | bookmarks) |             |             |
    11901190   |            |             |            |             |             |
     
    11961196
    11971197
    1198 Documentation             RFC2629 through XSLT                April 2011
    1199 
    1200 
    1201    | RenderX    |      no     |  yes [13]  |   yes [13]  |   yes [13]  |
    1202    | XEP [12]   |             |  (from XSL |             |  (from XSL  |
     1198Documentation             RFC2629 through XSLT                  May 2011
     1199
     1200
     1201   | RenderX    |      no     |  yes [14]  |   yes [14]  |   yes [14]  |
     1202   | XEP [13]   |             |  (from XSL |             |  (from XSL  |
    12031203   |            |             |     1.1    |             |   1.1 page  |
    12041204   |            |             | bookmarks) |             |    index)   |
     
    12531253
    12541254
    1255 Documentation             RFC2629 through XSLT                April 2011
     1255Documentation             RFC2629 through XSLT                  May 2011
    12561256
    12571257
     
    13101310
    13111311
    1312 Documentation             RFC2629 through XSLT                April 2011
     1312Documentation             RFC2629 through XSLT                  May 2011
    13131313
    13141314
     
    13671367
    13681368
    1369 Documentation             RFC2629 through XSLT                April 2011
     1369Documentation             RFC2629 through XSLT                  May 2011
    13701370
    13711371
     
    14241424
    14251425
    1426 Documentation             RFC2629 through XSLT                April 2011
     1426Documentation             RFC2629 through XSLT                  May 2011
    14271427
    14281428
     
    14811481
    14821482
    1483 Documentation             RFC2629 through XSLT                April 2011
     1483Documentation             RFC2629 through XSLT                  May 2011
    14841484
    14851485
     
    15381538
    15391539
    1540 Documentation             RFC2629 through XSLT                April 2011
     1540Documentation             RFC2629 through XSLT                  May 2011
    15411541
    15421542
     
    15951595
    15961596
    1597 Documentation             RFC2629 through XSLT                April 2011
     1597Documentation             RFC2629 through XSLT                  May 2011
    15981598
    15991599
     
    16301630   o  grddl:transformation can be used to reference a GRDDL transform.
    16311631
    1632    o  x:maturiy-level can be used to specify the IETF Standards Track
     1632   o  x:maturity-level can be used to specify the IETF Standards Track
    16331633      Maturity Level of "proposed", "draft" or "internet" (see Section
    16341634      4.1 of [RFC2026]).
     
    16521652
    16531653
    1654 Documentation             RFC2629 through XSLT                April 2011
     1654Documentation             RFC2629 through XSLT                  May 2011
    16551655
    16561656
     
    17091709
    17101710
    1711 Documentation             RFC2629 through XSLT                April 2011
     1711Documentation             RFC2629 through XSLT                  May 2011
    17121712
    17131713
     
    17271727   "intended-level" as 'proposed', 'draft' or 'internet'.
    17281728   Alternatively, it can be specified inside the document using the
    1729    attribute x:maturity-level on the <rfc> element.
     1729   attribute x:maturity-level on the <rfc> element (see Section 11.25).
    17301730
    17311731   Note: Downward references should be annotated using the <annotate>
     
    17661766
    17671767
    1768 Documentation             RFC2629 through XSLT                April 2011
     1768Documentation             RFC2629 through XSLT                  May 2011
    17691769
    17701770
     
    18231823
    18241824
    1825 Documentation             RFC2629 through XSLT                April 2011
     1825Documentation             RFC2629 through XSLT                  May 2011
    18261826
    18271827
     
    18801880
    18811881
    1882 Documentation             RFC2629 through XSLT                April 2011
     1882Documentation             RFC2629 through XSLT                  May 2011
    18831883
    18841884
     
    19371937
    19381938
    1939 Documentation             RFC2629 through XSLT                April 2011
     1939Documentation             RFC2629 through XSLT                  May 2011
    19401940
    19411941
     
    19941994
    19951995
    1996 Documentation             RFC2629 through XSLT                April 2011
     1996Documentation             RFC2629 through XSLT                  May 2011
    19971997
    19981998
     
    20512051
    20522052
    2053 Documentation             RFC2629 through XSLT                April 2011
     2053Documentation             RFC2629 through XSLT                  May 2011
    20542054
    20552055
     
    20632063              <http://www.w3.org/TR/2006/REC-xsl11-20061205/>.
    20642064
    2065    [1]   <http://www.exslt.org/exsl/functions/node-set/
    2066          exsl.node-set.html>
    2067 
    2068    [2]   <http://www.microsoft.com/downloads/
     2065   [1]   <http://www.exslt.org/exsl/functions/node-set/index.html>
     2066
     2067   [2]   <http://www.exslt.org/date/functions/date-time/>
     2068
     2069   [3]   <http://www.microsoft.com/downloads/
    20692070         details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41>
    20702071
    2071    [3]   <https://addons.mozilla.org/de/firefox/addon/722>
    2072 
    2073    [4]   <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>
    2074 
    2075    [5]   <http://bugzilla.mozilla.org/show_bug.cgi?id=193678>
    2076 
    2077    [6]   <https://addons.mozilla.org/firefox/2933/>
    2078 
    2079    [7]   <http://microformats.org/wiki/hcard>
    2080 
    2081    [8]   <http://www.w3.org/TR/2003/WD-xsl11-20031217/>
    2082 
    2083    [9]   <http://www.antennahouse.com/>
    2084 
    2085    [10]  <http://www.antennahouse.com/XSL20/axf-extension.htm>
    2086 
    2087    [11]  <http://xml.apache.org/fop/>
    2088 
    2089    [12]  <http://xep.xattic.com/>
    2090 
    2091    [13]  <http://xep.xattic.com/xep/spec.html>
    2092 
    2093    [14]  <http://www.thaiopensource.com/relaxng/jing.html>
    2094 
    2095    [15]  <http://dpcarlisle.blogspot.com/2007/05/
     2072   [4]   <https://addons.mozilla.org/de/firefox/addon/722>
     2073
     2074   [5]   <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>
     2075
     2076   [6]   <http://bugzilla.mozilla.org/show_bug.cgi?id=193678>
     2077
     2078   [7]   <https://addons.mozilla.org/firefox/2933/>
     2079
     2080   [8]   <http://microformats.org/wiki/hcard>
     2081
     2082   [9]   <http://www.w3.org/TR/2003/WD-xsl11-20031217/>
     2083
     2084   [10]  <http://www.antennahouse.com/>
     2085
     2086   [11]  <http://www.antennahouse.com/XSL20/axf-extension.htm>
     2087
     2088   [12]  <http://xml.apache.org/fop/>
     2089
     2090   [13]  <http://xep.xattic.com/>
     2091
     2092   [14]  <http://xep.xattic.com/xep/spec.html>
     2093
     2094   [15]  <http://www.thaiopensource.com/relaxng/jing.html>
     2095
     2096   [16]  <http://dpcarlisle.blogspot.com/2007/05/
    20962097         exslt-node-set-function.html>
    20972098
     
    21042105
    21052106
    2106 
    21072107Reschke                                                        [Page 37]
    21082108
    21092109
    2110 Documentation             RFC2629 through XSLT                April 2011
     2110Documentation             RFC2629 through XSLT                  May 2011
    21112111
    21122112
     
    21142114
    21152115   The RelaxNG schema ([RNC]) below can be used to validate input
    2116    documents (for instance, with Jing [14]).
     2116   documents (for instance, with Jing [15]).
    21172117
    21182118   _Note that this is work in progress, and doesn't yet cover all
     
    21652165
    21662166
    2167 Documentation             RFC2629 through XSLT                April 2011
     2167Documentation             RFC2629 through XSLT                  May 2011
    21682168
    21692169
     
    22222222
    22232223
    2224 Documentation             RFC2629 through XSLT                April 2011
     2224Documentation             RFC2629 through XSLT                  May 2011
    22252225
    22262226
     
    22792279
    22802280
    2281 Documentation             RFC2629 through XSLT                April 2011
     2281Documentation             RFC2629 through XSLT                  May 2011
    22822282
    22832283
     
    23362336
    23372337
    2338 Documentation             RFC2629 through XSLT                April 2011
     2338Documentation             RFC2629 through XSLT                  May 2011
    23392339
    23402340
     
    23932393
    23942394
    2395 Documentation             RFC2629 through XSLT                April 2011
     2395Documentation             RFC2629 through XSLT                  May 2011
    23962396
    23972397
     
    24502450
    24512451
    2452 Documentation             RFC2629 through XSLT                April 2011
     2452Documentation             RFC2629 through XSLT                  May 2011
    24532453
    24542454
     
    25072507
    25082508
    2509 Documentation             RFC2629 through XSLT                April 2011
     2509Documentation             RFC2629 through XSLT                  May 2011
    25102510
    25112511
     
    25642564
    25652565
    2566 Documentation             RFC2629 through XSLT                April 2011
     2566Documentation             RFC2629 through XSLT                  May 2011
    25672567
    25682568
     
    26212621
    26222622
    2623 Documentation             RFC2629 through XSLT                April 2011
     2623Documentation             RFC2629 through XSLT                  May 2011
    26242624
    26252625
     
    26782678
    26792679
    2680 Documentation             RFC2629 through XSLT                April 2011
     2680Documentation             RFC2629 through XSLT                  May 2011
    26812681
    26822682
     
    27352735
    27362736
    2737 Documentation             RFC2629 through XSLT                April 2011
     2737Documentation             RFC2629 through XSLT                  May 2011
    27382738
    27392739
     
    27922792
    27932793
    2794 Documentation             RFC2629 through XSLT                April 2011
     2794Documentation             RFC2629 through XSLT                  May 2011
    27952795
    27962796
     
    28492849
    28502850
    2851 Documentation             RFC2629 through XSLT                April 2011
     2851Documentation             RFC2629 through XSLT                  May 2011
    28522852
    28532853
     
    29062906
    29072907
    2908 Documentation             RFC2629 through XSLT                April 2011
     2908Documentation             RFC2629 through XSLT                  May 2011
    29092909
    29102910
     
    29632963
    29642964
    2965 Documentation             RFC2629 through XSLT                April 2011
     2965Documentation             RFC2629 through XSLT                  May 2011
    29662966
    29672967
     
    30203020
    30213021
    3022 Documentation             RFC2629 through XSLT                April 2011
     3022Documentation             RFC2629 through XSLT                  May 2011
    30233023
    30243024
     
    30773077
    30783078
    3079 Documentation             RFC2629 through XSLT                April 2011
     3079Documentation             RFC2629 through XSLT                  May 2011
    30803080
    30813081
     
    31343134
    31353135
    3136 Documentation             RFC2629 through XSLT                April 2011
     3136Documentation             RFC2629 through XSLT                  May 2011
    31373137
    31383138
     
    31913191
    31923192
    3193 Documentation             RFC2629 through XSLT                April 2011
     3193Documentation             RFC2629 through XSLT                  May 2011
    31943194
    31953195
     
    32483248
    32493249
    3250 Documentation             RFC2629 through XSLT                April 2011
     3250Documentation             RFC2629 through XSLT                  May 2011
    32513251
    32523252
     
    33053305
    33063306
    3307 Documentation             RFC2629 through XSLT                April 2011
     3307Documentation             RFC2629 through XSLT                  May 2011
    33083308
    33093309
     
    33623362
    33633363
    3364 Documentation             RFC2629 through XSLT                April 2011
     3364Documentation             RFC2629 through XSLT                  May 2011
    33653365
    33663366
     
    33833383   2006-09-03  New.
    33843384
    3385    2007-06-07  Use Carlisle method [15] to define exslt:node-set in
     3385   2007-06-07  Use Carlisle method [16] to define exslt:node-set in
    33863386      msxsml (which means that the stylesheet can now be used with MSXML
    33873387      as well).
     
    34193419
    34203420
    3421 Documentation             RFC2629 through XSLT                April 2011
     3421Documentation             RFC2629 through XSLT                  May 2011
    34223422
    34233423
     
    34763476
    34773477
    3478 Documentation             RFC2629 through XSLT                April 2011
     3478Documentation             RFC2629 through XSLT                  May 2011
    34793479
    34803480
     
    35333533
    35343534
    3535 Documentation             RFC2629 through XSLT                April 2011
     3535Documentation             RFC2629 through XSLT                  May 2011
    35363536
    35373537
     
    35903590
    35913591
    3592 Documentation             RFC2629 through XSLT                April 2011
     3592Documentation             RFC2629 through XSLT                  May 2011
    35933593
    35943594
     
    36473647
    36483648
    3649 Documentation             RFC2629 through XSLT                April 2011
     3649Documentation             RFC2629 through XSLT                  May 2011
    36503650
    36513651
     
    37043704
    37053705
    3706 Documentation             RFC2629 through XSLT                April 2011
     3706Documentation             RFC2629 through XSLT                  May 2011
    37073707
    37083708
     
    37613761
    37623762
    3763 Documentation             RFC2629 through XSLT                April 2011
     3763Documentation             RFC2629 through XSLT                  May 2011
    37643764
    37653765
     
    38183818
    38193819
    3820 Documentation             RFC2629 through XSLT                April 2011
     3820Documentation             RFC2629 through XSLT                  May 2011
    38213821
    38223822
     
    38753875
    38763876
    3877 Documentation             RFC2629 through XSLT                April 2011
     3877Documentation             RFC2629 through XSLT                  May 2011
    38783878
    38793879
     
    39323932
    39333933
    3934 Documentation             RFC2629 through XSLT                April 2011
     3934Documentation             RFC2629 through XSLT                  May 2011
    39353935
    39363936
     
    39893989
    39903990
    3991 Documentation             RFC2629 through XSLT                April 2011
     3991Documentation             RFC2629 through XSLT                  May 2011
    39923992
    39933993
     
    40464046
    40474047
    4048 Documentation             RFC2629 through XSLT                April 2011
     4048Documentation             RFC2629 through XSLT                  May 2011
    40494049
    40504050
     
    41034103
    41044104
    4105 Documentation             RFC2629 through XSLT                April 2011
     4105Documentation             RFC2629 through XSLT                  May 2011
    41064106
    41074107
     
    41604160
    41614161
    4162 Documentation             RFC2629 through XSLT                April 2011
     4162Documentation             RFC2629 through XSLT                  May 2011
    41634163
    41644164
     
    42174217
    42184218
    4219 Documentation             RFC2629 through XSLT                April 2011
     4219Documentation             RFC2629 through XSLT                  May 2011
    42204220
    42214221
     
    42744274
    42754275
    4276 Documentation             RFC2629 through XSLT                April 2011
     4276Documentation             RFC2629 through XSLT                  May 2011
    42774277
    42784278
     
    43034303      include PI pseudo-attribute  8
    43044304      include-author Extension Element  38
     4305      include-index PI pseudo-attribute  9
    43054306      include-references-in-index PI pseudo-attribute  9
    43064307      index HTML LINK element  17
     
    43104311      Internet Explorer 7  15
    43114312      Internet Explorer 8  15
     4313      Internet Explorer 9  15
    43124314      iprnotified PI pseudo-attribute  7
    43134315      isPartOf DCMI property  18
     
    43234325      link Extension Element  26, 38
    43244326      linkmailto PI pseudo-attribute  7
     4327
     4328
     4329
     4330Reschke                                                        [Page 76]
     4331
     4332
     4333Documentation             RFC2629 through XSLT                  May 2011
     4334
     4335
    43254336      lt Extension Element  27, 38
    4326 
    4327 
    4328 
    4329 
    4330 Reschke                                                        [Page 76]
    4331 
    4332 
    4333 Documentation             RFC2629 through XSLT                April 2011
    4334 
    43354337
    43364338   M
     
    43574359         xml2rfc-ext-authors-section  9
    43584360         xml2rfc-ext-duplex  9
     4361         xml2rfc-ext-include-index  9
    43594362         xml2rfc-ext-include-references-in-index  9
    43604363         xml2rfc-ext-justification  9
     
    43794382      private PI pseudo-attribute  7, 51
    43804383      Processing Instruction pseudo attributes
     4384
     4385
     4386
     4387Reschke                                                        [Page 77]
     4388
     4389
     4390Documentation             RFC2629 through XSLT                  May 2011
     4391
     4392
    43814393         allow-markup-in-artwork  9
    43824394         authors-section  9
    43834395         background  7
    4384 
    4385 
    4386 
    4387 Reschke                                                        [Page 77]
    4388 
    4389 
    4390 Documentation             RFC2629 through XSLT                April 2011
    4391 
    4392 
    43934396         comments  7
    43944397         compact  7
     
    43994402         ijustification  9
    44004403         include  8
     4404         include-index  9
    44014405         include-references-in-index  9
    44024406         inline  7
     
    44354439      rfc.copyright anchor  14
    44364440      rfc.copyrightnotice anchor  14
     4441
     4442
     4443
     4444Reschke                                                        [Page 78]
     4445
     4446
     4447Documentation             RFC2629 through XSLT                  May 2011
     4448
     4449
    44374450      rfc.figure.n anchor  14
    44384451      rfc.figure.u.n anchor  14
    44394452      rfc.index anchor  14
    44404453      rfc.ipr anchor  14
    4441 
    4442 
    4443 
    4444 Reschke                                                        [Page 78]
    4445 
    4446 
    4447 Documentation             RFC2629 through XSLT                April 2011
    4448 
    4449 
    44504454      rfc.iref.n anchor  14
    44514455      rfc.note.n anchor  14
     
    44604464
    44614465   S
    4462       Safari  15-16
    4463          3.*  15
     4466      Safari  16
     4467         3.*  16
    44644468      Saxon  15
    44654469      Schema  38
     
    44924496      xml2rfc-ext-authors-section parameter  9
    44934497      xml2rfc-ext-duplex  9
     4498
     4499
     4500
     4501Reschke                                                        [Page 79]
     4502
     4503
     4504Documentation             RFC2629 through XSLT                  May 2011
     4505
     4506
     4507      xml2rfc-ext-include-index parameter  9
    44944508      xml2rfc-ext-include-references-in-index parameter  9
    44954509      xml2rfc-ext-justification parameter  9
    44964510      xml2rfc-ext-parse-xml-in-artwork parameter  9
    44974511      xml2rfc-ext-sec-no-trailing-dots parameter  9
    4498 
    4499 
    4500 
    4501 Reschke                                                        [Page 79]
    4502 
    4503 
    4504 Documentation             RFC2629 through XSLT                April 2011
    4505 
    4506 
    45074512      xml2rfc-ext-support-rfc2731 parameter  9
    45084513      xml2rfc-footer parameter  7
     
    45514556
    45524557
    4553 
    4554 
    4555 
    4556 
    4557 
    45584558Reschke                                                        [Page 80]
    45594559
    45604560
    4561 Documentation             RFC2629 through XSLT                April 2011
     4561Documentation             RFC2629 through XSLT                  May 2011
    45624562
    45634563
  • rfc2629xslt/rfc2629xslt.xml

    r1276 r1303  
    3030        </author>
    3131     
    32     <date month="April" year="2011"/>
     32    <date month="May" year="2011"/>
    3333
    3434    <keyword>RFC2629</keyword>
     
    298298
    299299  <c>rfc-ext</c>
     300  <c>include-index<iref item="include-index PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="include-index"/></c>
     301  <c>xml2rfc-ext-include-index<iref item="xml2rfc-ext-include-index parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-include-index"/></c>
     302  <c>"yes"</c>
     303  <c>When set to "no", no index will be generated.</c>
     304
     305  <c>rfc-ext</c>
    300306  <c>include-references-in-index<iref item="include-references-in-index PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="include-references-in-index"/></c>
    301307  <c>xml2rfc-ext-include-references-in-index<iref item="xml2rfc-ext-include-references-in-index parameter"/> <iref item="Parameters" subitem="xml2rfc-ext-include-references-in-index"/></c>
     
    370376<section title="Supported XSLT engines" anchor="xslt.engines">
    371377<t>
    372   The transformation requires a non-standard extension function (see <eref target="http://www.exslt.org/exsl/functions/node-set/exsl.node-set.html">
     378  The transformation requires a non-standard extension function (see <eref target="http://www.exslt.org/exsl/functions/node-set/index.html">
    373379  exsl:node-set</eref>)
    374380  which is however widely available. XSLT processors that do not support this
    375   extension (or a functional equivalent) currently are not supported.
     381  extension (or a functional equivalent, such as msxsl:node-set) currently are not supported.
     382</t>
     383<t anchor="exsl-date-time">
     384  Input documents do not always specify the date completely. In this case, the
     385  transformation attempts to let the XSLT engine to compute the system date,
     386  using either scripting in Microsoft's XSLT engine, or
     387  the  <eref target="http://www.exslt.org/date/functions/date-time/">
     388  exsl:date-time</eref> extension function.
    376389</t>
    377390<section title="Standalone Engines">
     
    397410    </x:lt>
    398411    <x:lt>
    399       <t><iref item="Internet Explorer 6"/><iref item="Internet Explorer 7"/><iref item="Internet Explorer 8"/>Internet Explorer 6 and newer</t>
     412      <t><iref item="Internet Explorer 6"/><iref item="Internet Explorer 7"/><iref item="Internet Explorer 8"/><iref item="Internet Explorer 9"/>Internet Explorer 6 and newer</t>
    400413    </x:lt>
    401414    <x:lt>
     
    411424          this problem please comment on <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=640390"/>.
    412425          </t>
     426          <t>Date computation may become available in Firefox 6 (see <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=603159"/>)</t>
    413427        </list>
    414428      </t>
     
    416430    <x:lt>
    417431      <t><iref item="Safari"/><iref item="Safari" subitem="3.*"/>Safari 3 (starting with version 3.0.4)</t>
     432      <t>
     433        <list style="symbols">
     434          <t>Date computation not available (see <eref target="https://bugs.webkit.org/show_bug.cgi?id=4079"/>)</t>
     435        </list>
     436      </t>
    418437    </x:lt>
    419438    <x:lt>
    420439      <t><iref item="Google Chrome"/>Google Chrome</t>
     440      <t>
     441        <list style="symbols">
     442          <t>Date computation not available (see <eref target="https://bugs.webkit.org/show_bug.cgi?id=4079"/>)</t>
     443        </list>
     444      </t>
    421445    </x:lt>
    422446    <x:lt>
    423447      <t><iref item="Opera"/>Opera (starting with version 10)</t>
     448      <t>
     449        <list style="symbols">
     450          <t>Date computation not available<!--DSK-336575@bugs.opera.com--></t>
     451        </list>
     452      </t>
    424453    </x:lt>
    425454  </list>
     
    11161145  <list style="symbols">
    11171146    <t>grddl:transformation can be used to reference a GRDDL transform.</t>
    1118     <t>x:maturiy-level can be used to specify the IETF Standards Track
     1147    <t>x:maturity-level can be used to specify the IETF Standards Track
    11191148    Maturity Level of "proposed", "draft" or "internet" (see <xref target="RFC2026" x:fmt="of" x:sec="4.1"/>).</t>
    11201149  </list>
     
    11961225  the desired level can be specified using the parameter <spanx style='verb'>intended-level</spanx>
    11971226  as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified
    1198   inside the document using the attribute x:maturity-level on the &lt;rfc> element.
     1227  inside the document using the attribute x:maturity-level on the &lt;rfc> element
     1228  (see <xref target="ext-rfc2629.rfc"/>).
    11991229</t>
    12001230<t>
  • rfc2629xslt/samples/rfc2629.xslt

    r1276 r1303  
    231231</xsl:param>
    232232
     233<!-- extension for excluding the index -->
     234
     235<xsl:param name="xml2rfc-ext-include-index">
     236  <xsl:call-template name="parse-pis">
     237    <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/>
     238    <xsl:with-param name="attr" select="'include-index'"/>
     239    <xsl:with-param name="default" select="'yes'"/>
     240  </xsl:call-template>
     241</xsl:param>
     242
    233243<!-- extension for excluding DCMI properties in meta tag (RFC2731) -->
    234244
     
    425435    <xsl:call-template name="warning">
    426436      <xsl:with-param name="msg" select="concat('/rfc/@consensus meaningless with a /rfc/@submissionType value of ', /rfc/@submissionType)"/>
    427       <xsl:with-param name="inline" select="'no'"/>
    428437    </xsl:call-template>
    429438  </xsl:if>
     
    561570
    562571<!-- will document have an index -->
    563 <xsl:variable name="has-index" select="//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')" />
     572<xsl:variable name="has-index" select="(//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')) and $xml2rfc-ext-include-index!='no'" />
    564573         
    565574<!-- does the document contain edits? -->
     
    737746      <xsl:if test="string-length($content) > 69 + $indent">
    738747        <xsl:call-template name="warning">
    739           <xsl:with-param name="inline" select="'no'"/>
    740748          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$content"/>' (<xsl:value-of select="string-length($content)"/> characters)</xsl:with-param>
    741749        </xsl:call-template>
     
    753761      <xsl:if test="string-length($start) > $max">
    754762        <xsl:call-template name="warning">
    755           <xsl:with-param name="inline" select="'no'"/>
    756763          <xsl:with-param name="msg">artwork line too long: '<xsl:value-of select="$start"/>' (<xsl:value-of select="string-length($start)"/> characters)</xsl:with-param>
    757764        </xsl:call-template>
     
    10631070            <xsl:call-template name="warning">
    10641071              <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should contain the base name, not the filename (thus no file extension).</xsl:with-param>
    1065               <xsl:with-param name="inline" select="'no'"/>
    10661072            </xsl:call-template>
    10671073            <xsl:value-of select="substring-before($docname,'.')"/>
     
    10781084        <xsl:call-template name="warning">
    10791085          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character '<xsl:value-of select="substring($offending,1,1)"/>'.</xsl:with-param>
    1080           <xsl:with-param name="inline" select="'no'"/>
    10811086        </xsl:call-template>
    10821087      </xsl:if>
     
    10861091        <xsl:call-template name="warning">
    10871092          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character sequence '--'.</xsl:with-param>
    1088           <xsl:with-param name="inline" select="'no'"/>
    10891093        </xsl:call-template>
    10901094      </xsl:if>
     
    10931097        <xsl:call-template name="warning">
    10941098          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should start with 'draft-'.</xsl:with-param>
    1095           <xsl:with-param name="inline" select="'no'"/>
    10961099        </xsl:call-template>
    10971100      </xsl:if>
     
    11091112        <xsl:call-template name="warning">
    11101113          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should end with a two-digit sequence number or 'latest'.</xsl:with-param>
    1111           <xsl:with-param name="inline" select="'no'"/>
    11121114        </xsl:call-template>
    11131115      </xsl:if>
     
    11161118        <xsl:call-template name="warning">
    11171119          <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>', excluding sequence number, should have less than 50 characters.</xsl:with-param>
    1118           <xsl:with-param name="inline" select="'no'"/>
    11191120        </xsl:call-template>
    11201121      </xsl:if>
     
    15301531  <xsl:if test="not(ancestor::ed:del) and not(key('xref-item',$anchor))">
    15311532    <xsl:call-template name="warning">
    1532       <xsl:with-param name="inline" select="'no'"/>
    15331533      <xsl:with-param name="msg">unused reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    15341534    </xsl:call-template>
     
    15481548    <xsl:if test="$tst=''">
    15491549      <xsl:call-template name="warning">
    1550         <xsl:with-param name="inline" select="'no'"/>
    15511550        <xsl:with-param name="msg">all references to the normative reference '<xsl:value-of select="@anchor"/>' appear to be informative</xsl:with-param>
    15521551      </xsl:call-template>
     
    16851684        <xsl:if test="(@name='BCP' or @name='FYI' or @name='STD') and preceding-sibling::seriesInfo[@name='RFC']">
    16861685          <xsl:call-template name="warning">
    1687             <xsl:with-param name="inline" select="'no'"/>
    16881686            <xsl:with-param name="msg">RFC number preceding <xsl:value-of select="@name"/> number in reference '<xsl:value-of select="../@anchor"/>'</xsl:with-param>
    16891687          </xsl:call-template>
     
    17011699        <xsl:if test="string(number(front/date/@year)) = 'NaN'">
    17021700          <xsl:call-template name="warning">
    1703             <xsl:with-param name="inline" select="'no'"/>
    17041701            <xsl:with-param name="msg">date/@year should be a number: '<xsl:value-of select="front/date/@year"/>' in reference '<xsl:value-of select="@anchor"/>'</xsl:with-param>
    17051702          </xsl:call-template>
     
    19531950<xsl:template match="t">
    19541951  <xsl:if test="preceding-sibling::section or preceding-sibling::appendix">
    1955     <xsl:call-template name="warning">
     1952    <xsl:call-template name="inline-warning">
    19561953      <xsl:with-param name="msg">The paragraph below is misplaced; maybe a section is closed in the wrong place: </xsl:with-param>
    19571954      <xsl:with-param name="msg2"><xsl:value-of select="."/></xsl:with-param>
     
    20192016  <xsl:if test="@abbrev and string-length(@abbrev) > 40">
    20202017    <xsl:call-template name="warning">
    2021       <xsl:with-param name="inline" select="'no'"/>
    20222018      <xsl:with-param name="msg">title/@abbrev too long (max 40 characters)</xsl:with-param>
    20232019    </xsl:call-template>
     
    20262022  <xsl:if test="string-length(.) > 40 and (not(@abbrev) or @abbrev='')">
    20272023    <xsl:call-template name="warning">
    2028       <xsl:with-param name="inline" select="'no'"/>
    20292024      <xsl:with-param name="msg">title too long, should supply title/@abbrev attribute with less than 40 characters</xsl:with-param>
    20302025    </xsl:call-template>
     
    20602055  <xsl:if test="self::appendix">
    20612056    <xsl:call-template name="warning">
    2062       <xsl:with-param name="inline" select="'no'"/>
    20632057      <xsl:with-param name="msg">The "appendix" element is deprecated, use "section" inside "back" instead.</xsl:with-param>
    20642058    </xsl:call-template>
     
    22942288        <xsl:if test="not($r-is-normative)">
    22952289          <xsl:call-template name="warning">
    2296             <xsl:with-param name="inline" select="'no'"/>
    22972290            <xsl:with-param name="msg" select="concat('Potentially normative reference to ',@target,' not referenced normatively')"/>
    22982291          </xsl:call-template>
     
    24612454            <xsl:for-each select="$xref">
    24622455              <xsl:call-template name="warning">
    2463                 <xsl:with-param name="inline" select="'no'"/>
    24642456                <xsl:with-param name="msg" select="concat('Potentially normative reference to ',$xref/@target,' not referenced normatively')"/>
    24652457              </xsl:call-template>
     
    26692661
    26702662<xsl:template match="/">
     2663  <xsl:apply-templates select="*" mode="validate"/>
    26712664  <xsl:apply-templates select="*" />
    26722665</xsl:template>
     
    28142807      <xsl:call-template name="warning">
    28152808        <xsl:with-param name="msg" select="concat('/rfc/front/date/@day appears to be missing for a historic draft dated ', $pub-yearmonth)"/>
    2816         <xsl:with-param name="inline" select="'no'"/>
    28172809      </xsl:call-template>
    28182810    </xsl:if>
     
    49924984      <xsl:value-of select="$name"/>
    49934985      <xsl:call-template name="warning">
    4994         <xsl:with-param name="inline" select="'no'"/>
    49954986        <xsl:with-param name="msg" select="concat('In metadata obsoletes/updates, RFC number of draft name is expected - found: ',$name)"/>
    49964987      </xsl:call-template>
     
    50275018      <xsl:if test="not(//references//reference/seriesInfo[@name='Internet-Draft' and @value=$name])">
    50285019        <xsl:call-template name="warning">
    5029           <xsl:with-param name="inline" select="'no'"/>
    50305020          <xsl:with-param name="msg" select="concat('front matter mentions I-D ',$name,' for which there is no reference element')"/>
    50315021        </xsl:call-template>
     
    50355025      <xsl:if test="not(//references//reference/seriesInfo[@name='RFC' and @value=$name])">
    50365026        <xsl:call-template name="warning">
    5037           <xsl:with-param name="inline" select="'no'"/>
    50385027          <xsl:with-param name="msg" select="concat('front matter mentions RFC ',$name,' for which there is no reference element')"/>
    50395028        </xsl:call-template>
     
    51155104    <xsl:otherwise>
    51165105      <xsl:call-template name="warning">
    5117         <xsl:with-param name="inline" select="'no'"/>
    51185106        <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' does not exist.</xsl:with-param>
    51195107      </xsl:call-template>
     
    57015689    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2068' or @value='2616')])">
    57025690      <xsl:call-template name="warning">
    5703         <xsl:with-param name="inline">no</xsl:with-param>
    57045691        <xsl:with-param name="msg">document uses HTTP-style ABNF syntax, but doesn't reference RFC 2068 or 2616.</xsl:with-param>
    57055692      </xsl:call-template>
     
    57095696    <xsl:if test="not(//reference/seriesInfo[@name='RFC' and (@value='2234' or @value='4234' or @value='5234')])">
    57105697      <xsl:call-template name="warning">
    5711         <xsl:with-param name="inline">no</xsl:with-param>
    57125698        <xsl:with-param name="msg">document uses ABNF syntax, but doesn't reference RFC 2234, 4234 or 5234.</xsl:with-param>
    57135699      </xsl:call-template>
     
    59535939</xsl:template>
    59545940
     5941<xsl:template name="inline-warning">
     5942  <xsl:param name="msg"/>
     5943  <xsl:param name="msg2"/>
     5944  <xsl:call-template name="emit-message">
     5945    <xsl:with-param name="level">WARNING</xsl:with-param>
     5946    <xsl:with-param name="msg" select="$msg"/>
     5947    <xsl:with-param name="msg2" select="$msg2"/>
     5948    <xsl:with-param name="inline" select="'yes'"/>
     5949  </xsl:call-template>
     5950</xsl:template>
     5951
    59555952<xsl:template name="warning">
    59565953  <xsl:param name="msg"/>
     
    59615958    <xsl:with-param name="msg" select="$msg"/>
    59625959    <xsl:with-param name="msg2" select="$msg2"/>
    5963     <xsl:with-param name="inline" select="$inline"/>
     5960    <xsl:with-param name="inline" select="'no'"/>
    59645961  </xsl:call-template>
    59655962</xsl:template>
     
    60716068                  <xsl:otherwise>
    60726069                    <xsl:call-template name="warning">
    6073                       <xsl:with-param name="inline" select="'no'"/>
    60746070                      <xsl:with-param name="msg">Unknown align attribute on ttcol: <xsl:value-of select="$col/@align"/></xsl:with-param>                     
    60756071                    </xsl:call-template>
     
    63196315    <xsl:text>http://greenbytes.de/tech/webdav/rfc2629.xslt, </xsl:text>
    63206316    <!-- when RCS keyword substitution in place, add version info -->
    6321     <xsl:if test="contains('$Revision: 1.547 $',':')">
    6322       <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.547 $', 'Revision: '),'$','')),', ')" />
     6317    <xsl:if test="contains('$Revision: 1.550 $',':')">
     6318      <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.550 $', 'Revision: '),'$','')),', ')" />
    63236319    </xsl:if>
    6324     <xsl:if test="contains('$Date: 2011-04-17 09:42:41 $',':')">
    6325       <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-04-17 09:42:41 $', 'Date: '),'$','')),', ')" />
     6320    <xsl:if test="contains('$Date: 2011-05-30 14:02:12 $',':')">
     6321      <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2011-05-30 14:02:12 $', 'Date: '),'$','')),', ')" />
    63266322    </xsl:if>
    63276323    <xsl:value-of select="concat('XSLT vendor: ',system-property('xsl:vendor'),' ',system-property('xsl:vendor-url'))" />
     
    63386334    <xsl:if test="contains(.,',')">
    63396335      <xsl:call-template name="warning">
    6340         <xsl:with-param name="inline" select="'no'"/>
    63416336        <xsl:with-param name="msg">keyword element appears to contain a comma-separated list, split into multiple elements instead.</xsl:with-param>
    63426337      </xsl:call-template>
     
    64616456  <xsl:if test="$r!=@initials">
    64626457    <xsl:call-template name="warning">
    6463       <xsl:with-param name="inline" select="'no'"/>
    64646458      <xsl:with-param name="msg">@initials '<xsl:value-of select="@initials"/>': did you mean '<xsl:value-of select="$r"/>'?</xsl:with-param>
    64656459    </xsl:call-template>
     
    65276521  <xsl:if test="string-length($node) != string-length($text)">
    65286522    <xsl:call-template name="warning">
    6529       <xsl:with-param name="inline" select="'no'"/>
    65306523      <xsl:with-param name="msg">excessive whitespace in <xsl:value-of select="$name"/>: '<xsl:value-of select="$node"/>'</xsl:with-param>
    65316524    </xsl:call-template>
     
    65396532  <xsl:if test="string-length(.) != string-length($email) or contains($email,' ')">
    65406533    <xsl:call-template name="warning">
    6541       <xsl:with-param name="inline" select="'no'"/>
    65426534      <xsl:with-param name="msg">excessive whitespace in email address: '<xsl:value-of select="."/>'</xsl:with-param>
    65436535    </xsl:call-template>
     
    65486540      <xsl:when test="starts-with($email,'mailto:')">
    65496541        <xsl:call-template name="warning">
    6550           <xsl:with-param name="inline" select="'no'"/>
    65516542          <xsl:with-param name="msg">email should not include URI scheme: '<xsl:value-of select="."/>'</xsl:with-param>
    65526543        </xsl:call-template>
     
    65676558  <xsl:if test="string-length(.) != string-length($uri) or contains($uri,' ')">
    65686559    <xsl:call-template name="warning">
    6569       <xsl:with-param name="inline" select="'no'"/>
    65706560      <xsl:with-param name="msg">excessive whitespace in URI: '<xsl:value-of select="."/>'</xsl:with-param>
    65716561    </xsl:call-template>
     
    66686658          <xsl:call-template name="warning">
    66696659            <xsl:with-param name="msg">bad PI syntax: <xsl:value-of select="$str2"/></xsl:with-param>
    6670             <xsl:with-param name="inline" select="'no'"/>
    66716660          </xsl:call-template>
    66726661          <xsl:value-of select="$ret"/>
     
    66786667              <xsl:call-template name="warning">
    66796668                <xsl:with-param name="msg">bad PI value syntax: <xsl:value-of select="$remainder"/></xsl:with-param>
    6680                 <xsl:with-param name="inline" select="'no'"/>
    66816669              </xsl:call-template>
    66826670              <xsl:value-of select="$ret"/>
     
    66956683                  <xsl:call-template name="warning">
    66966684                    <xsl:with-param name="msg">pseudo-attribute value needs to be quoted: <xsl:value-of select="$rem"/></xsl:with-param>
    6697                     <xsl:with-param name="inline" select="'no'"/>
    66986685                  </xsl:call-template>
    66996686                  <xsl:value-of select="$ret"/>
     
    67026689                  <xsl:call-template name="warning">
    67036690                    <xsl:with-param name="msg">unmatched quote in: <xsl:value-of select="$rem2"/></xsl:with-param>
    6704                     <xsl:with-param name="inline" select="'no'"/>
    67056691                  </xsl:call-template>
    67066692                  <xsl:value-of select="$ret"/>
     
    67156701                      <xsl:when test="$attrname='authors-section'"/>
    67166702                      <xsl:when test="$attrname='duplex'"/>
     6703                      <xsl:when test="$attrname='include-index'"/>
    67176704                      <xsl:when test="$attrname='include-references-in-index'"/>
    67186705                      <xsl:when test="$attrname='justification'"/>
     
    67246711                        <xsl:call-template name="warning">
    67256712                          <xsl:with-param name="msg">unsupported rfc-ext pseudo-attribute '<xsl:value-of select="$attrname"/>'</xsl:with-param>
    6726                           <xsl:with-param name="inline" select="'no'"/>
    67276713                        </xsl:call-template>
    67286714                      </xsl:otherwise>
     
    67356721                        <xsl:call-template name="warning">
    67366722                          <xsl:with-param name="msg">the rfc include pseudo-attribute is not supported by this processor, see http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#examples.internalsubset for help.</xsl:with-param>
    6737                           <xsl:with-param name="inline" select="'no'"/>
    67386723                        </xsl:call-template>
    67396724                      </xsl:when>
     
    67576742                        <xsl:call-template name="warning">
    67586743                          <xsl:with-param name="msg">duplicate pseudo-attribute <xsl:value-of select="$attr"/>, overwriting value <xsl:value-of select="$ret"/></xsl:with-param>
    6759                           <xsl:with-param name="inline" select="'no'"/>
    67606744                        </xsl:call-template>
    67616745                      </xsl:if>
     
    69486932    <xsl:when test="$current-year!='' and $may-default-dates!='yes'">
    69496933      <xsl:call-template name="warning">
    6950         <xsl:with-param name="inline" select="'no'"/>
    69516934        <xsl:with-param name="msg" select="$may-default-dates"/>
    69526935      </xsl:call-template>
     
    69726955    <xsl:when test="$current-month!='' and $may-default-dates!='yes'">
    69736956      <xsl:call-template name="warning">
    6974         <xsl:with-param name="inline" select="'no'"/>
    69756957        <xsl:with-param name="msg" select="$may-default-dates"/>
    69766958      </xsl:call-template>
     
    70176999    <xsl:otherwise>00</xsl:otherwise>
    70187000  </xsl:choose>
    7019 
    70207001</xsl:param>
    70217002
     7003<!-- simple validation support -->
     7004
     7005<xsl:template match="*" mode="validate">
     7006  <xsl:apply-templates select="@*|*" mode="validate"/>
     7007</xsl:template>
     7008<xsl:template match="@*" mode="validate"/>
     7009
     7010<xsl:template name="warninvalid">
     7011  <xsl:variable name="pname">
     7012    <xsl:if test="namespace-uri(..)!=''">
     7013      <xsl:value-of select="concat('{',namespace-uri(..),'}')"/>
     7014    </xsl:if>
     7015    <xsl:value-of select="local-name(..)"/>
     7016  </xsl:variable>
     7017  <xsl:variable name="cname">
     7018    <xsl:if test="namespace-uri(.)!=''">
     7019      <xsl:value-of select="concat('{',namespace-uri(.),'}')"/>
     7020    </xsl:if>
     7021    <xsl:value-of select="local-name(.)"/>
     7022  </xsl:variable>
     7023  <xsl:call-template name="warning">
     7024    <xsl:with-param name="msg" select="concat($cname,' not allowed inside ',$pname)"/>
     7025  </xsl:call-template>
     7026</xsl:template>
     7027
     7028<!-- figure element -->
     7029<xsl:template match="figure/artwork | figure/ed:replace/ed:*/artwork" mode="validate" priority="9">
     7030  <xsl:apply-templates select="@*|*" mode="validate"/>
     7031</xsl:template>
     7032<xsl:template match="artwork" mode="validate">
     7033  <xsl:call-template name="warninvalid"/>
     7034  <xsl:apply-templates select="@*|*" mode="validate"/>
     7035</xsl:template>
     7036
     7037<!-- list element -->
     7038<xsl:template match="t/list | t/ed:replace/ed:*/list" mode="validate" priority="9">
     7039  <xsl:apply-templates select="@*|*" mode="validate"/>
     7040</xsl:template>
     7041<xsl:template match="list" mode="validate">
     7042  <xsl:call-template name="warninvalid"/>
     7043  <xsl:apply-templates select="@*|*" mode="validate"/>
     7044</xsl:template>
     7045
     7046<!-- t element -->
     7047<xsl:template match="abstract/t | abstract/ed:replace/ed:*/t |
     7048                     list/t | list/ed:replace/ed:*/t |
     7049                     note/t | note/ed:replace/ed:*/t |
     7050                     section/t | section/ed:replace/ed:*/t |
     7051                     x:blockquote/t | x:blockquote/ed:replace/ed:*/t |
     7052                     x:note/t | x:note/ed:replace/ed:*/t |
     7053                     x:lt/t | x:lt/ed:replace/ed:*/t" mode="validate" priority="9">
     7054  <xsl:apply-templates select="@*|*" mode="validate"/>
     7055</xsl:template>
     7056<xsl:template match="t" mode="validate">
     7057  <xsl:call-template name="warninvalid"/>
     7058  <xsl:apply-templates select="@*|*" mode="validate"/>
     7059</xsl:template>
     7060
    70227061</xsl:transform>
  • rfc2629xslt/testcase.html

    r1276 r1303  
    396396    }
    397397}
    398 </style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Lists" href="#rfc.section.1"><link rel="Chapter" title="2 spanx" href="#rfc.section.2"><link rel="Chapter" title="3 Tables" href="#rfc.section.3"><link rel="Chapter" title="4 Figures" href="#rfc.section.4"><link rel="Chapter" title="5 References" href="#rfc.section.5"><link rel="Chapter" title="6 Paragraph formatting" href="#rfc.section.6"><link rel="Chapter" title="7 Sections" href="#rfc.section.7"><link rel="Chapter" title="8 Comments" href="#rfc.section.8"><link rel="Chapter" title="9 Artwork Width" href="#rfc.section.9"><link rel="Chapter" title="10 Extensions" href="#rfc.section.10"><link rel="Chapter" title="11 Blank Lines" href="#rfc.section.11"><link rel="Chapter" title="12 Other" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 References"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.547, 2011-04-17 09:42:41, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, test case, xml2rfc"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 test cases</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right">January 2011</td></tr></tbody></table><p class="title">Test cases for RFC2629 formatting</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1.&nbsp;&nbsp;&nbsp;<a href="#lists">Lists</a><ul><li>1.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.1">hanging list</a></li><li>1.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.2">numbered list</a></li><li>1.3&nbsp;&nbsp;&nbsp;<a href="#ordered.list.letters">ordered list (letters)</a></li><li>1.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.4">no explicit counters</a></li><li>1.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.5">with explicit counters</a></li><li>1.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.6">Nested list</a></li><li>1.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.7">list without style</a></li><li>1.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.8">list with multiple paragraphs in a single list item</a></li></ul></li><li>2.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.2">spanx</a></li><li>3.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3">Tables</a><ul><li>3.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.1">no borders</a></li><li>3.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.2">borders around headers</a></li><li>3.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.3">example from xml2rc README</a></li><li>3.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.4">no column titles</a></li><li>3.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.5">referencing tables</a></li><li>3.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.6">table captions</a></li><li>3.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.7">single column</a></li><li>3.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.8">table alignment</a></li></ul></li><li>4.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4">Figures</a><ul><li>4.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.1">with preamble, no title...</a></li><li>4.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.2">with postamble and title...</a></li><li>4.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.3">Whitespace handling</a></li><li>4.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.4">Whitespace around figures</a></li><li>4.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.5">SVG</a></li><li>4.6&nbsp;&nbsp;&nbsp;<a href="#code.components">Code Components</a></li></ul></li><li>5.&nbsp;&nbsp;&nbsp;<a href="#refs">References</a><ul><li>5.1&nbsp;&nbsp;&nbsp;<a href="#xref.with.no.content">xref with no content</a></li><li>5.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.2">xref to named &lt;t&gt; element</a></li><li>5.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.3">xref to named &lt;spanx&gt; element</a></li><li>5.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.4">xref to named &lt;t&gt; element inside list</a></li><li>5.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.5">xref to named &lt;cref&gt; element</a></li><li>5.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.6">xref to named &lt;t&gt; element inside list</a></li><li>5.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.7">xref with no auto-formatting</a></li><li>5.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.8">xref with content and auto-formatting</a></li><li>5.9&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.9">xref with content and no formatting</a></li><li>5.10&nbsp;&nbsp;&nbsp;<a href="#formatting.none">xref with content and 'none' formatting</a></li><li>5.11&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.11">xref with no content and anchor formatting</a></li><li>5.12&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.12">eref with no content</a></li><li>5.13&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.13">eref with content</a></li><li>5.14&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.14">iref inside paragraph</a></li></ul></li><li>6.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6">Paragraph formatting</a></li><li>7.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7">Sections</a><ul><li>7.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7.1">Subsection with TOC entry</a></li><li class="excluded"><ul><li>7.2.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7.2.1">Sub-subsection with TOC entry</a></li></ul></li></ul></li><li>8.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.8">Comments</a></li><li>9.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9">Artwork Width</a></li><li>10.&nbsp;&nbsp;&nbsp;<a href="#extensions">Extensions</a><ul><li>10.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.1">Markup in figure/artwork</a></li><li>10.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.2">Measuring Lengths</a></li><li>10.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.3">Quotations</a></li><li>10.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.4">Subsections</a></li><li>10.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.5">Box Drawing</a></li><li>10.6&nbsp;&nbsp;&nbsp;<a href="#computed.reference.targets">Computed Reference Targets</a></li><li>10.7&nbsp;&nbsp;&nbsp;<a href="#abnf.support">ABNF Support</a></li></ul></li><li>11.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.11">Blank Lines</a></li><li>12.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12">Other</a><ul><li>12.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.1">Comments in Text</a></li><li>12.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.2">Special Characters</a><ul><li>12.2.1&nbsp;&nbsp;&nbsp;<a href="#nbsp">Non-Breaking Space</a></li><li>12.2.2&nbsp;&nbsp;&nbsp;<a href="#nbhy">Non-Breaking Hyphen</a></li><li>12.2.3&nbsp;&nbsp;&nbsp;<a href="#dashes">Dashes</a></li></ul></li></ul></li><li>13.&nbsp;&nbsp;&nbsp;<a href="#rfc.references">References</a></li><li><a href="#rfc.comments">Editorial Comments</a></li><li><a href="#rfc.authors">Author's Address</a></li><li><a href="#rfc.index">Index</a></li></ul><ul><li><a href="#rfc.figure.1">Figure 1: another figure</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a>&nbsp;<a id="lists" href="#lists">Lists</a></h1><h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a>&nbsp;hanging list</h2><dl><dt>Name:</dt><dd>timeout</dd><dt>Namespace:</dt><dd>DAV:</dd><dt>Purpose:</dt><dd>The timeout associated with a lock</dd><dt>Value:</dt><dd>TimeType ;Defined in section 9.8</dd></dl><h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;numbered list</h2><p id="rfc.section.1.2.p.1">A numbered list: </p><ol><li>one</li><li>two</li><li>three</li></ol><h2 id="rfc.section.1.3"><a href="#rfc.section.1.3">1.3</a>&nbsp;<a id="ordered.list.letters" href="#ordered.list.letters">ordered list (letters)</a></h2><p id="rfc.section.1.3.p.1">An ordered list using letters: </p><ol class="la"><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li id="ordered.list.letters.last">three</li></ol><h2 id="rfc.section.1.4"><a href="#rfc.section.1.4">1.4</a>&nbsp;no explicit counters</h2><p id="rfc.section.1.4.p.1">Example for numbered list with user-defined-format: </p><dl><dt>R1:</dt><dd>R1</dd><dt>R2:</dt><dd>R2</dd></dl><p id="rfc.section.1.4.p.2">Another list: </p><dl><dt>S1:</dt><dd>S1</dd><dt>S2:</dt><dd>S2</dd></dl><p id="rfc.section.1.4.p.3">Next list should continue counting R's: </p><dl><dt>R3:</dt><dd>R3</dd><dt>R4:</dt><dd>R4</dd></dl><p id="rfc.section.1.4.p.4">Same with character-based numbering: </p><dl><dt>c-a:</dt><dd>c-a</dd><dt>c-b:</dt><dd>c-b</dd></dl><h2 id="rfc.section.1.5"><a href="#rfc.section.1.5">1.5</a>&nbsp;with explicit counters</h2><p id="rfc.section.1.5.p.1">A few requirements: </p><dl><dt>R1:</dt><dd>req R1</dd><dt>R2:</dt><dd>req R2</dd></dl><p id="rfc.section.1.5.p.2">More requirements: </p><dl><dt>R3:</dt><dd>req R3</dd><dt>R4:</dt><dd>req R4</dd></dl><p id="rfc.section.1.5.p.3">A few rules: </p><dl><dt>R1:</dt><dd>rule R1</dd><dt>R2:</dt><dd>rule R2</dd><dt>R3:</dt><dd>rule R3</dd></dl><p id="rfc.section.1.5.p.4">Explicit counter with name matching it's format string: </p><dl><dt>c-c:</dt><dd>c-c</dd><dt>c-d:</dt><dd>c-d</dd></dl><p id="rfc.section.1.5.p.5">Same, without counter: </p><dl><dt>c-e:</dt><dd>c-e</dd><dt>c-f:</dt><dd>c-f</dd></dl><h2 id="rfc.section.1.6"><a href="#rfc.section.1.6">1.6</a>&nbsp;Nested list</h2><p id="rfc.section.1.6.p.1"> </p><ol><li>One</li><li>Two <ol class="ua"><li>17</li><li>42</li></ol> </li><li>Three</li></ol><h2 id="rfc.section.1.7"><a href="#rfc.section.1.7">1.7</a>&nbsp;list without style</h2><ul class="empty"><li>One</li><li>Two</li><li>Three</li></ul><h2 id="rfc.section.1.8"><a href="#rfc.section.1.8">1.8</a>&nbsp;list with multiple paragraphs in a single list item</h2><ol><li><p>Simple list item.</p></li><li><p>This one has two paragraphs. This is the first one.</p><p>This one has two paragraphs. This is the second one.</p></li><li><p>Another simple list item.</p></li></ol><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a>&nbsp;spanx</h1><p id="rfc.section.2.p.1">This is <em>default</em>.</p><p id="rfc.section.2.p.2">This is <em>emph(asized)</em>.</p><p id="rfc.section.2.p.3">This is <strong>strong</strong>.</p><p id="rfc.section.2.p.4">This is <samp>verb(atim)</samp>.</p><p id="rfc.section.2.p.5">Here is <samp>a carriage return inside</samp> a spanx element.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a>&nbsp;Tables</h1><div id="rfc.table.u.1"><p>The list of valid keywords are:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="right" style="width: 20%;">keyword</th><th class="center" style="width: 20%;">default</th><th class="left">meaning</th><th class="left">not aligned</th></tr></thead><tbody><tr><td class="right">strict</td><td class="center">no</td><td class="left">try to enforce the ID-nits conventions and DTD validity</td><td class="left">a</td></tr><tr><td class="right">iprnotified</td><td class="center">no</td><td class="left">include boilerplate from Section 10.4(d) of <a href="#RFC2026" id="rfc.xref.RFC2026.1"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a></td><td class="left">bb bb</td></tr><tr><td class="right">compact</td><td class="center">no</td><td class="left">when producing a txt/nroff file, try to conserve vertical whitespace</td><td class="left">ccc ccc ccc</td></tr><tr><td class="right">subcompact</td><td class="center">compact</td><td class="left">if compact is "yes", then setting this to "no" will make things a little less compact</td><td class="left">dddd dddd dddd dddd</td></tr><tr><td class="right">needLines</td><td class="center">n/a</td><td class="left">an integer hint indicating how many contiguous lines are needed at this point in the output</td><td class="left">eeeee eeeee eeeee eeeee eeeee</td></tr><tr><td class="right">here come empty cells</td><td class="center"></td><td class="left"></td><td class="left"></td></tr></tbody></table><p>Remember, that as with everything else in XML, keywords and values are case-sensitive.</p></div><h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;no borders</h2><div id="rfc.table.1"><div id="tablenoborder"></div><p>The table below should appear with no borders.</p><table class="tt none center" cellpadding="3" cellspacing="0"><caption>Table 1: a table with no borders</caption><thead><tr><th class="left">C1</th><th class="left">C2</th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;borders around headers</h2><div id="rfc.table.u.2"><p>The table below should appear with borders just around the headers.</p><table class="tt headers center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">C1</th><th class="left">C2</th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;example from xml2rc README</h2><div id="rfc.table.2"><div id="table_example"></div><p>So, putting it all together, we have, e.g.,</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 2</caption><thead><tr><th class="center">ttcol #1</th><th class="center">ttcol #2</th></tr></thead><tbody><tr><td class="center">c #1</td><td class="center">c #2</td></tr><tr><td class="center">c #3</td><td class="center">c #4</td></tr><tr><td class="center">c #5</td><td class="center">c #6</td></tr></tbody></table><p>which is a very simple example.</p></div><h2 id="rfc.section.3.4"><a href="#rfc.section.3.4">3.4</a>&nbsp;no column titles</h2><div id="rfc.table.3"><div id="tablenotitles"></div><p>The table below should appear with no titles.</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 3: a table with no column titles</caption><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><div id="rfc.table.4"><div id="tableonetitle"></div><p>The table below should appear with column titles (one being non-empty).</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 4: a table with a single column title</caption><thead><tr><th class="left">FOO</th><th class="left"></th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.5"><a href="#rfc.section.3.5">3.5</a>&nbsp;referencing tables</h2><p id="rfc.section.3.5.p.1"> <a href="#tablenoborder">Table&nbsp;1</a> shows a table with no borders.</p><p id="rfc.section.3.5.p.2"> <a href="#tablenoborder">The table above</a> shows a table with no borders.</p><h2 id="rfc.section.3.6"><a href="#rfc.section.3.6">3.6</a>&nbsp;table captions</h2><div id="rfc.table.u.3"><p>No anchor, no title</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">-</td><td class="left">-</td></tr></tbody></table></div><div id="rfc.table.5"><div id="texttable1"></div><p>Anchor (not being referenced), no title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 5</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">yes</td><td class="left">-</td></tr></tbody></table></div><div id="rfc.table.6"><p>No anchor, with title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 6: title</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">-</td><td class="left">"title"</td></tr></tbody></table></div><div id="rfc.table.7"><div id="texttable2"></div><p>Both anchor and title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 7: title</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">yes</td><td class="left">"title"</td></tr></tbody></table></div><h2 id="rfc.section.3.7"><a href="#rfc.section.3.7">3.7</a>&nbsp;single column</h2><div id="rfc.table.u.4"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">title</th></tr></thead><tbody><tr><td class="left">1</td></tr><tr><td class="left">2</td></tr></tbody></table></div><h2 id="rfc.section.3.8"><a href="#rfc.section.3.8">3.8</a>&nbsp;table alignment</h2><div id="rfc.table.u.5"><table class="tt full left" cellpadding="3" cellspacing="0"><thead><tr><th class="left">left</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.6"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">center</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.7"><table class="tt full right" cellpadding="3" cellspacing="0"><thead><tr><th class="left">right</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.8"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">default</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;Figures</h1><h2 id="rfc.section.4.1"><a href="#rfc.section.4.1">4.1</a>&nbsp;with preamble, no title...</h2><div id="rfc.figure.u.1"></div> <p>with preamble, no title...</p>  <pre>  +--+
     398</style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Lists" href="#rfc.section.1"><link rel="Chapter" title="2 spanx" href="#rfc.section.2"><link rel="Chapter" title="3 Tables" href="#rfc.section.3"><link rel="Chapter" title="4 Figures" href="#rfc.section.4"><link rel="Chapter" title="5 References" href="#rfc.section.5"><link rel="Chapter" title="6 Paragraph formatting" href="#rfc.section.6"><link rel="Chapter" title="7 Sections" href="#rfc.section.7"><link rel="Chapter" title="8 Comments" href="#rfc.section.8"><link rel="Chapter" title="9 Artwork Width" href="#rfc.section.9"><link rel="Chapter" title="10 Extensions" href="#rfc.section.10"><link rel="Chapter" title="11 Blank Lines" href="#rfc.section.11"><link rel="Chapter" title="12 Other" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 References"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.550, 2011-05-30 14:02:12, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, test case, xml2rfc"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 test cases</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right">January 2011</td></tr></tbody></table><p class="title">Test cases for RFC2629 formatting</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1.&nbsp;&nbsp;&nbsp;<a href="#lists">Lists</a><ul><li>1.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.1">hanging list</a></li><li>1.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.2">numbered list</a></li><li>1.3&nbsp;&nbsp;&nbsp;<a href="#ordered.list.letters">ordered list (letters)</a></li><li>1.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.4">no explicit counters</a></li><li>1.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.5">with explicit counters</a></li><li>1.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.6">Nested list</a></li><li>1.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.7">list without style</a></li><li>1.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.1.8">list with multiple paragraphs in a single list item</a></li></ul></li><li>2.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.2">spanx</a></li><li>3.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3">Tables</a><ul><li>3.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.1">no borders</a></li><li>3.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.2">borders around headers</a></li><li>3.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.3">example from xml2rc README</a></li><li>3.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.4">no column titles</a></li><li>3.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.5">referencing tables</a></li><li>3.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.6">table captions</a></li><li>3.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.7">single column</a></li><li>3.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.3.8">table alignment</a></li></ul></li><li>4.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4">Figures</a><ul><li>4.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.1">with preamble, no title...</a></li><li>4.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.2">with postamble and title...</a></li><li>4.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.3">Whitespace handling</a></li><li>4.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.4">Whitespace around figures</a></li><li>4.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.4.5">SVG</a></li><li>4.6&nbsp;&nbsp;&nbsp;<a href="#code.components">Code Components</a></li></ul></li><li>5.&nbsp;&nbsp;&nbsp;<a href="#refs">References</a><ul><li>5.1&nbsp;&nbsp;&nbsp;<a href="#xref.with.no.content">xref with no content</a></li><li>5.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.2">xref to named &lt;t&gt; element</a></li><li>5.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.3">xref to named &lt;spanx&gt; element</a></li><li>5.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.4">xref to named &lt;t&gt; element inside list</a></li><li>5.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.5">xref to named &lt;cref&gt; element</a></li><li>5.6&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.6">xref to named &lt;t&gt; element inside list</a></li><li>5.7&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.7">xref with no auto-formatting</a></li><li>5.8&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.8">xref with content and auto-formatting</a></li><li>5.9&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.9">xref with content and no formatting</a></li><li>5.10&nbsp;&nbsp;&nbsp;<a href="#formatting.none">xref with content and 'none' formatting</a></li><li>5.11&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.11">xref with no content and anchor formatting</a></li><li>5.12&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.12">eref with no content</a></li><li>5.13&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.13">eref with content</a></li><li>5.14&nbsp;&nbsp;&nbsp;<a href="#rfc.section.5.14">iref inside paragraph</a></li></ul></li><li>6.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.6">Paragraph formatting</a></li><li>7.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7">Sections</a><ul><li>7.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7.1">Subsection with TOC entry</a></li><li class="excluded"><ul><li>7.2.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.7.2.1">Sub-subsection with TOC entry</a></li></ul></li></ul></li><li>8.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.8">Comments</a></li><li>9.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.9">Artwork Width</a></li><li>10.&nbsp;&nbsp;&nbsp;<a href="#extensions">Extensions</a><ul><li>10.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.1">Markup in figure/artwork</a></li><li>10.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.2">Measuring Lengths</a></li><li>10.3&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.3">Quotations</a></li><li>10.4&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.4">Subsections</a></li><li>10.5&nbsp;&nbsp;&nbsp;<a href="#rfc.section.10.5">Box Drawing</a></li><li>10.6&nbsp;&nbsp;&nbsp;<a href="#computed.reference.targets">Computed Reference Targets</a></li><li>10.7&nbsp;&nbsp;&nbsp;<a href="#abnf.support">ABNF Support</a></li></ul></li><li>11.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.11">Blank Lines</a></li><li>12.&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12">Other</a><ul><li>12.1&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.1">Comments in Text</a></li><li>12.2&nbsp;&nbsp;&nbsp;<a href="#rfc.section.12.2">Special Characters</a><ul><li>12.2.1&nbsp;&nbsp;&nbsp;<a href="#nbsp">Non-Breaking Space</a></li><li>12.2.2&nbsp;&nbsp;&nbsp;<a href="#nbhy">Non-Breaking Hyphen</a></li><li>12.2.3&nbsp;&nbsp;&nbsp;<a href="#dashes">Dashes</a></li></ul></li></ul></li><li>13.&nbsp;&nbsp;&nbsp;<a href="#rfc.references">References</a></li><li><a href="#rfc.comments">Editorial Comments</a></li><li><a href="#rfc.authors">Author's Address</a></li><li><a href="#rfc.index">Index</a></li></ul><ul><li><a href="#rfc.figure.1">Figure 1: another figure</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a>&nbsp;<a id="lists" href="#lists">Lists</a></h1><h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a>&nbsp;hanging list</h2><dl><dt>Name:</dt><dd>timeout</dd><dt>Namespace:</dt><dd>DAV:</dd><dt>Purpose:</dt><dd>The timeout associated with a lock</dd><dt>Value:</dt><dd>TimeType ;Defined in section 9.8</dd></dl><h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;numbered list</h2><p id="rfc.section.1.2.p.1">A numbered list: </p><ol><li>one</li><li>two</li><li>three</li></ol><h2 id="rfc.section.1.3"><a href="#rfc.section.1.3">1.3</a>&nbsp;<a id="ordered.list.letters" href="#ordered.list.letters">ordered list (letters)</a></h2><p id="rfc.section.1.3.p.1">An ordered list using letters: </p><ol class="la"><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li>three</li><li>one</li><li>two</li><li id="ordered.list.letters.last">three</li></ol><h2 id="rfc.section.1.4"><a href="#rfc.section.1.4">1.4</a>&nbsp;no explicit counters</h2><p id="rfc.section.1.4.p.1">Example for numbered list with user-defined-format: </p><dl><dt>R1:</dt><dd>R1</dd><dt>R2:</dt><dd>R2</dd></dl><p id="rfc.section.1.4.p.2">Another list: </p><dl><dt>S1:</dt><dd>S1</dd><dt>S2:</dt><dd>S2</dd></dl><p id="rfc.section.1.4.p.3">Next list should continue counting R's: </p><dl><dt>R3:</dt><dd>R3</dd><dt>R4:</dt><dd>R4</dd></dl><p id="rfc.section.1.4.p.4">Same with character-based numbering: </p><dl><dt>c-a:</dt><dd>c-a</dd><dt>c-b:</dt><dd>c-b</dd></dl><h2 id="rfc.section.1.5"><a href="#rfc.section.1.5">1.5</a>&nbsp;with explicit counters</h2><p id="rfc.section.1.5.p.1">A few requirements: </p><dl><dt>R1:</dt><dd>req R1</dd><dt>R2:</dt><dd>req R2</dd></dl><p id="rfc.section.1.5.p.2">More requirements: </p><dl><dt>R3:</dt><dd>req R3</dd><dt>R4:</dt><dd>req R4</dd></dl><p id="rfc.section.1.5.p.3">A few rules: </p><dl><dt>R1:</dt><dd>rule R1</dd><dt>R2:</dt><dd>rule R2</dd><dt>R3:</dt><dd>rule R3</dd></dl><p id="rfc.section.1.5.p.4">Explicit counter with name matching it's format string: </p><dl><dt>c-c:</dt><dd>c-c</dd><dt>c-d:</dt><dd>c-d</dd></dl><p id="rfc.section.1.5.p.5">Same, without counter: </p><dl><dt>c-e:</dt><dd>c-e</dd><dt>c-f:</dt><dd>c-f</dd></dl><h2 id="rfc.section.1.6"><a href="#rfc.section.1.6">1.6</a>&nbsp;Nested list</h2><p id="rfc.section.1.6.p.1"> </p><ol><li>One</li><li>Two <ol class="ua"><li>17</li><li>42</li></ol> </li><li>Three</li></ol><h2 id="rfc.section.1.7"><a href="#rfc.section.1.7">1.7</a>&nbsp;list without style</h2><ul class="empty"><li>One</li><li>Two</li><li>Three</li></ul><h2 id="rfc.section.1.8"><a href="#rfc.section.1.8">1.8</a>&nbsp;list with multiple paragraphs in a single list item</h2><ol><li><p>Simple list item.</p></li><li><p>This one has two paragraphs. This is the first one.</p><p>This one has two paragraphs. This is the second one.</p></li><li><p>Another simple list item.</p></li></ol><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a>&nbsp;spanx</h1><p id="rfc.section.2.p.1">This is <em>default</em>.</p><p id="rfc.section.2.p.2">This is <em>emph(asized)</em>.</p><p id="rfc.section.2.p.3">This is <strong>strong</strong>.</p><p id="rfc.section.2.p.4">This is <samp>verb(atim)</samp>.</p><p id="rfc.section.2.p.5">Here is <samp>a carriage return inside</samp> a spanx element.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a>&nbsp;Tables</h1><div id="rfc.table.u.1"><p>The list of valid keywords are:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="right" style="width: 20%;">keyword</th><th class="center" style="width: 20%;">default</th><th class="left">meaning</th><th class="left">not aligned</th></tr></thead><tbody><tr><td class="right">strict</td><td class="center">no</td><td class="left">try to enforce the ID-nits conventions and DTD validity</td><td class="left">a</td></tr><tr><td class="right">iprnotified</td><td class="center">no</td><td class="left">include boilerplate from Section 10.4(d) of <a href="#RFC2026" id="rfc.xref.RFC2026.1"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a></td><td class="left">bb bb</td></tr><tr><td class="right">compact</td><td class="center">no</td><td class="left">when producing a txt/nroff file, try to conserve vertical whitespace</td><td class="left">ccc ccc ccc</td></tr><tr><td class="right">subcompact</td><td class="center">compact</td><td class="left">if compact is "yes", then setting this to "no" will make things a little less compact</td><td class="left">dddd dddd dddd dddd</td></tr><tr><td class="right">needLines</td><td class="center">n/a</td><td class="left">an integer hint indicating how many contiguous lines are needed at this point in the output</td><td class="left">eeeee eeeee eeeee eeeee eeeee</td></tr><tr><td class="right">here come empty cells</td><td class="center"></td><td class="left"></td><td class="left"></td></tr></tbody></table><p>Remember, that as with everything else in XML, keywords and values are case-sensitive.</p></div><h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;no borders</h2><div id="rfc.table.1"><div id="tablenoborder"></div><p>The table below should appear with no borders.</p><table class="tt none center" cellpadding="3" cellspacing="0"><caption>Table 1: a table with no borders</caption><thead><tr><th class="left">C1</th><th class="left">C2</th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;borders around headers</h2><div id="rfc.table.u.2"><p>The table below should appear with borders just around the headers.</p><table class="tt headers center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">C1</th><th class="left">C2</th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;example from xml2rc README</h2><div id="rfc.table.2"><div id="table_example"></div><p>So, putting it all together, we have, e.g.,</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 2</caption><thead><tr><th class="center">ttcol #1</th><th class="center">ttcol #2</th></tr></thead><tbody><tr><td class="center">c #1</td><td class="center">c #2</td></tr><tr><td class="center">c #3</td><td class="center">c #4</td></tr><tr><td class="center">c #5</td><td class="center">c #6</td></tr></tbody></table><p>which is a very simple example.</p></div><h2 id="rfc.section.3.4"><a href="#rfc.section.3.4">3.4</a>&nbsp;no column titles</h2><div id="rfc.table.3"><div id="tablenotitles"></div><p>The table below should appear with no titles.</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 3: a table with no column titles</caption><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><div id="rfc.table.4"><div id="tableonetitle"></div><p>The table below should appear with column titles (one being non-empty).</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 4: a table with a single column title</caption><thead><tr><th class="left">FOO</th><th class="left"></th></tr></thead><tbody><tr><td class="left">11</td><td class="left">12</td></tr><tr><td class="left">21</td><td class="left">22</td></tr></tbody></table></div><h2 id="rfc.section.3.5"><a href="#rfc.section.3.5">3.5</a>&nbsp;referencing tables</h2><p id="rfc.section.3.5.p.1"> <a href="#tablenoborder">Table&nbsp;1</a> shows a table with no borders.</p><p id="rfc.section.3.5.p.2"> <a href="#tablenoborder">The table above</a> shows a table with no borders.</p><h2 id="rfc.section.3.6"><a href="#rfc.section.3.6">3.6</a>&nbsp;table captions</h2><div id="rfc.table.u.3"><p>No anchor, no title</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">-</td><td class="left">-</td></tr></tbody></table></div><div id="rfc.table.5"><div id="texttable1"></div><p>Anchor (not being referenced), no title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 5</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">yes</td><td class="left">-</td></tr></tbody></table></div><div id="rfc.table.6"><p>No anchor, with title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 6: title</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">-</td><td class="left">"title"</td></tr></tbody></table></div><div id="rfc.table.7"><div id="texttable2"></div><p>Both anchor and title</p><table class="tt full center" cellpadding="3" cellspacing="0"><caption>Table 7: title</caption><thead><tr><th class="left">Anchor</th><th class="left">Title</th></tr></thead><tbody><tr><td class="left">yes</td><td class="left">"title"</td></tr></tbody></table></div><h2 id="rfc.section.3.7"><a href="#rfc.section.3.7">3.7</a>&nbsp;single column</h2><div id="rfc.table.u.4"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">title</th></tr></thead><tbody><tr><td class="left">1</td></tr><tr><td class="left">2</td></tr></tbody></table></div><h2 id="rfc.section.3.8"><a href="#rfc.section.3.8">3.8</a>&nbsp;table alignment</h2><div id="rfc.table.u.5"><table class="tt full left" cellpadding="3" cellspacing="0"><thead><tr><th class="left">left</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.6"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">center</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.7"><table class="tt full right" cellpadding="3" cellspacing="0"><thead><tr><th class="left">right</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><div id="rfc.table.u.8"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th class="left">default</th></tr></thead><tbody><tr><td class="left">1</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;Figures</h1><h2 id="rfc.section.4.1"><a href="#rfc.section.4.1">4.1</a>&nbsp;with preamble, no title...</h2><div id="rfc.figure.u.1"></div> <p>with preamble, no title...</p>  <pre>  +--+
    399399  |  |
    400400  +--+
Note: See TracChangeset for help on using the changeset viewer.