August 2017 - tor-commits - lists.torproject.org

[translation/tails-greeter_completed] Update translations for tails-greeter_completed
by translation＠torproject.org 06 Aug '17

06 Aug '17

commit ed3ffbb7ffe1d929ae4b7dc667b7e77ff04ca2b3 Author: Translation commit bot <translation(a)torproject.org> Date: Sun Aug 6 03:46:08 2017 +0000 Update translations for tails-greeter_completed --- zh_TW/zh_TW.po | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh_TW/zh_TW.po b/zh_TW/zh_TW.po index 21423a82a..0a18598b7 100644 --- a/zh_TW/zh_TW.po +++ b/zh_TW/zh_TW.po @@ -15,7 +15,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-06-10 12:27+0200\n" -"PO-Revision-Date: 2017-06-18 01:51+0000\n" +"PO-Revision-Date: 2017-08-06 03:31+0000\n" "Last-Translator: Agustín Wu <losangwuyts(a)gmail.com>\n" "Language-Team: Chinese (Taiwan) (http://www.transifex.com/otf/torproject/language/zh_TW/)\n" "MIME-Version: 1.0\n"

1 0

[translation/tails-greeter] Update translations for tails-greeter
by translation＠torproject.org 06 Aug '17

06 Aug '17

commit 9965597ab0ec78c9da6ec6dd1b4902eb7f16bc4b Author: Translation commit bot <translation(a)torproject.org> Date: Sun Aug 6 03:46:03 2017 +0000 Update translations for tails-greeter --- zh_TW/zh_TW.po | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh_TW/zh_TW.po b/zh_TW/zh_TW.po index 21423a82a..0a18598b7 100644 --- a/zh_TW/zh_TW.po +++ b/zh_TW/zh_TW.po @@ -15,7 +15,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-06-10 12:27+0200\n" -"PO-Revision-Date: 2017-06-18 01:51+0000\n" +"PO-Revision-Date: 2017-08-06 03:31+0000\n" "Last-Translator: Agustín Wu <losangwuyts(a)gmail.com>\n" "Language-Team: Chinese (Taiwan) (http://www.transifex.com/otf/torproject/language/zh_TW/)\n" "MIME-Version: 1.0\n"

1 0

[translation/https_everywhere_completed] Update translations for https_everywhere_completed
by translation＠torproject.org 06 Aug '17

06 Aug '17

commit 0a72f8e79ebbc2404d23238f7fcb68aaa485eb88 Author: Translation commit bot <translation(a)torproject.org> Date: Sun Aug 6 03:45:42 2017 +0000 Update translations for https_everywhere_completed --- zh_TW/https-everywhere.dtd | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/zh_TW/https-everywhere.dtd b/zh_TW/https-everywhere.dtd index 3cde59d0b..823f26ed1 100644 --- a/zh_TW/https-everywhere.dtd +++ b/zh_TW/https-everywhere.dtd @@ -24,9 +24,22 @@ <!ENTITY https-everywhere.menu.showCounter "顯示計數器"> <!ENTITY https-everywhere.menu.viewAllRules "檢視所有規則"> +<!ENTITY https-everywhere.options.importSettings "匯入設定值"> +<!ENTITY https-everywhere.options.import "匯入"> +<!ENTITY https-everywhere.options.imported "您的設定值已匯入"> + <!ENTITY https-everywhere.prefs.title "HTTPS Everywhere 偏好設定"> <!ENTITY https-everywhere.prefs.enable_all "全部啟用"> <!ENTITY https-everywhere.prefs.disable_all "全部停用"> +<!ENTITY https-everywhere.prefs.export_settings "匯出設定值"> +<!ENTITY https-everywhere.prefs.settings_warning "警告："> +<!ENTITY https-everywhere.prefs.settings_warning_delete "您有部份的 HTTPS Everywhere 設定值將被刪除！"> +<!ENTITY https-everywhere.prefs.settings_warning_explain "此擴充元件將在近期內被升級更新，若您未將現有設定值匯出的話，底下幾項資料可能會遺失："> +<!ENTITY https-everywhere.prefs.settings_global "全域設定"> +<!ENTITY https-everywhere.prefs.settings_toggle "個別站台之啟動與關閉設定"> +<!ENTITY https-everywhere.prefs.settings_custom "個人化站台規則"> +<!ENTITY https-everywhere.prefs.settings_click_ok "請點選「確定」"> +<!ENTITY https-everywhere.prefs.settings_warning_closing "為確保您的設定值能被保存，一旦 HTTPS Everywhere 升級更新後，您必需要利用該擴充元件的選項功能，將設定值匯入。"> <!ENTITY https-everywhere.prefs.reset_defaults "重設成預設值"> <!ENTITY https-everywhere.prefs.search "搜尋"> <!ENTITY https-everywhere.prefs.site "網站">

1 0

[translation/https_everywhere] Update translations for https_everywhere
by translation＠torproject.org 06 Aug '17

06 Aug '17

commit 1415c77df320409deeffa19e33fcda6058812f62 Author: Translation commit bot <translation(a)torproject.org> Date: Sun Aug 6 03:45:33 2017 +0000 Update translations for https_everywhere --- zh_TW/https-everywhere.dtd | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/zh_TW/https-everywhere.dtd b/zh_TW/https-everywhere.dtd index 1e1084c6b..823f26ed1 100644 --- a/zh_TW/https-everywhere.dtd +++ b/zh_TW/https-everywhere.dtd @@ -24,22 +24,22 @@ <!ENTITY https-everywhere.menu.showCounter "顯示計數器"> <!ENTITY https-everywhere.menu.viewAllRules "檢視所有規則"> -<!ENTITY https-everywhere.options.importSettings "Import Settings"> -<!ENTITY https-everywhere.options.import "Import"> -<!ENTITY https-everywhere.options.imported "Your settings have been imported."> +<!ENTITY https-everywhere.options.importSettings "匯入設定值"> +<!ENTITY https-everywhere.options.import "匯入"> +<!ENTITY https-everywhere.options.imported "您的設定值已匯入"> <!ENTITY https-everywhere.prefs.title "HTTPS Everywhere 偏好設定"> <!ENTITY https-everywhere.prefs.enable_all "全部啟用"> <!ENTITY https-everywhere.prefs.disable_all "全部停用"> -<!ENTITY https-everywhere.prefs.export_settings "Export Settings"> -<!ENTITY https-everywhere.prefs.settings_warning "Warning:"> -<!ENTITY https-everywhere.prefs.settings_warning_delete "Some of your HTTPS Everywhere settings are about to be deleted!"> -<!ENTITY https-everywhere.prefs.settings_warning_explain "This extension will be upgraded substantially in the near future. If you do not export your settings, you could lose one or more of the following:"> -<!ENTITY https-everywhere.prefs.settings_global "Global preferences"> -<!ENTITY https-everywhere.prefs.settings_toggle "Per-site on/off setting"> -<!ENTITY https-everywhere.prefs.settings_custom "Custom site rules"> -<!ENTITY https-everywhere.prefs.settings_click_ok "Please click 'OK'"> -<!ENTITY https-everywhere.prefs.settings_warning_closing "below to ensure your settings are saved. Once HTTPS Everywhere is upgraded, you will later have to import these settings in the extension options section."> +<!ENTITY https-everywhere.prefs.export_settings "匯出設定值"> +<!ENTITY https-everywhere.prefs.settings_warning "警告："> +<!ENTITY https-everywhere.prefs.settings_warning_delete "您有部份的 HTTPS Everywhere 設定值將被刪除！"> +<!ENTITY https-everywhere.prefs.settings_warning_explain "此擴充元件將在近期內被升級更新，若您未將現有設定值匯出的話，底下幾項資料可能會遺失："> +<!ENTITY https-everywhere.prefs.settings_global "全域設定"> +<!ENTITY https-everywhere.prefs.settings_toggle "個別站台之啟動與關閉設定"> +<!ENTITY https-everywhere.prefs.settings_custom "個人化站台規則"> +<!ENTITY https-everywhere.prefs.settings_click_ok "請點選「確定」"> +<!ENTITY https-everywhere.prefs.settings_warning_closing "為確保您的設定值能被保存，一旦 HTTPS Everywhere 升級更新後，您必需要利用該擴充元件的選項功能，將設定值匯入。"> <!ENTITY https-everywhere.prefs.reset_defaults "重設成預設值"> <!ENTITY https-everywhere.prefs.search "搜尋"> <!ENTITY https-everywhere.prefs.site "網站">

1 0

[translation/https_everywhere] Update translations for https_everywhere
by translation＠torproject.org 06 Aug '17

06 Aug '17

commit fa3d980a9e3a959a51ff22b3110000daeddf70eb Author: Translation commit bot <translation(a)torproject.org> Date: Sun Aug 6 00:15:31 2017 +0000 Update translations for https_everywhere --- da/https-everywhere.dtd | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/da/https-everywhere.dtd b/da/https-everywhere.dtd index 6667ebe69..5dd8d50b7 100644 --- a/da/https-everywhere.dtd +++ b/da/https-everywhere.dtd @@ -24,21 +24,21 @@ <!ENTITY https-everywhere.menu.showCounter "Vis tæller"> <!ENTITY https-everywhere.menu.viewAllRules "Se samtlige regler"> -<!ENTITY https-everywhere.options.importSettings "Import Settings"> -<!ENTITY https-everywhere.options.import "Import"> -<!ENTITY https-everywhere.options.imported "Your settings have been imported."> +<!ENTITY https-everywhere.options.importSettings "Importér indstillinger"> +<!ENTITY https-everywhere.options.import "Importér"> +<!ENTITY https-everywhere.options.imported "Dine indstillinger er blevet importeret."> <!ENTITY https-everywhere.prefs.title "Præferencer for HTTPS Everywhere"> <!ENTITY https-everywhere.prefs.enable_all "Aktivér alle"> <!ENTITY https-everywhere.prefs.disable_all "Deaktivér alle"> -<!ENTITY https-everywhere.prefs.export_settings "Export Settings"> -<!ENTITY https-everywhere.prefs.settings_warning "Warning:"> -<!ENTITY https-everywhere.prefs.settings_warning_delete "Some of your HTTPS Everywhere settings are about to be deleted!"> +<!ENTITY https-everywhere.prefs.export_settings "Eksportér indstillinger"> +<!ENTITY https-everywhere.prefs.settings_warning "Advarsel:"> +<!ENTITY https-everywhere.prefs.settings_warning_delete "Nogle af dine HTTPS Everywhere-indstillinger er ved at blive slettet!"> <!ENTITY https-everywhere.prefs.settings_warning_explain "This extension will be upgraded substantially in the near future. If you do not export your settings, you could lose one or more of the following:"> -<!ENTITY https-everywhere.prefs.settings_global "Global preferences"> +<!ENTITY https-everywhere.prefs.settings_global "Globale præferencer"> <!ENTITY https-everywhere.prefs.settings_toggle "Per-site on/off setting"> -<!ENTITY https-everywhere.prefs.settings_custom "Custom site rules"> -<!ENTITY https-everywhere.prefs.settings_click_ok "Please click 'OK'"> +<!ENTITY https-everywhere.prefs.settings_custom "Tilpasset stedregler"> +<!ENTITY https-everywhere.prefs.settings_click_ok "Klik venligst på 'OK'"> <!ENTITY https-everywhere.prefs.settings_warning_closing "below to ensure your settings are saved. Once HTTPS Everywhere is upgraded, you will later have to import these settings in the extension options section."> <!ENTITY https-everywhere.prefs.reset_defaults "Nulstil til standardindstillinger"> <!ENTITY https-everywhere.prefs.search "Søg">

1 0

[nyx/master] Discuss our nyxrc in the FAQ
by atagar＠torproject.org 06 Aug '17

06 Aug '17

commit 01f33401f593ebcee4dfb3b991370d571b2d6c56 Author: Damian Johnson <atagar(a)torproject.org> Date: Sat Aug 5 17:12:15 2017 -0700 Discuss our nyxrc in the FAQ I'd put good money that just about nobody even knows nyx *can* have a nyxrc. On one hand this is a pity, but on the other 98% of users really wouldn't find it useful. As such the FAQ is probably the right spot. --- setup.py | 2 +- web/index.html | 16 ++++++++++++++++ nyxrc.sample => web/nyxrc.sample | 0 3 files changed, 17 insertions(+), 1 deletion(-) diff --git a/setup.py b/setup.py index e9a0fa5..f47f915 100644 --- a/setup.py +++ b/setup.py @@ -44,7 +44,7 @@ class NyxInstaller(install): self.install_bin_script('run_nyx', os.path.join(self.install_scripts, 'nyx')) self.install_file('man page', 'nyx.1', self.man_page) - self.install_file('nyxrc sample', 'nyxrc.sample', self.sample_path) + self.install_file('web/nyxrc sample', 'nyxrc.sample', self.sample_path) def install_bin_script(self, source, dest): # Install our bin script. We do this ourselves rather than with the setup() diff --git a/web/index.html b/web/index.html index 5c2ab82..a010ed4 100644 --- a/web/index.html +++ b/web/index.html @@ -144,6 +144,22 @@ </div> </li> + <li id="nyxrc"> + <span>How can I configure Nyx?</span> + <div class="answer"> + <p>Like most terminal applications Nyx can be customized through a configuration file. By default <b>~/.nyx/nyxrc</b>, though you can specify one with <b>nyx --config /path/to/nyxrc</b>.</p> + <p>Configurations are a simple series of key/value pairs. For example...</p> + + <pre> +acs_support false +color_override blue # make our UI predominately blue +logged_events BW, NOTICE, WARN, ERR + </pre> + + <p>For available options see <b><a href="nyxrc.sample">our sample nyxrc</a></b>.</p> + </div> + </li> + <li id="report_bug"> <span>How can I report a bug?</span> <div class="answer"> diff --git a/nyxrc.sample b/web/nyxrc.sample similarity index 100% rename from nyxrc.sample rename to web/nyxrc.sample

1 0

[nyx/master] Change graphed default to bytes
by atagar＠torproject.org 06 Aug '17

06 Aug '17

commit d0f8702a25517ae44a09a3e7bd4e768c613cadf9 Author: Damian Johnson <atagar(a)torproject.org> Date: Sat Aug 5 09:33:30 2017 -0700 Change graphed default to bytes Not the first time we've changed this. Unfortunately regardless of if we go with bits or bytes somebody will be confused, but from irc contacts over the years it's clear most folks expect measurements to be in bytes. Most other tools choose bytes so lets be consistent with them. --- nyx/panel/graph.py | 4 ++-- nyxrc.sample | 2 +- web/changelog/index.html | 1 + web/index.html | 11 ++++++++++- 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/nyx/panel/graph.py b/nyx/panel/graph.py index 8271b06..fc1e7cb 100644 --- a/nyx/panel/graph.py +++ b/nyx/panel/graph.py @@ -81,7 +81,7 @@ CONFIG = conf.config_dict('nyx', { 'graph_stat': GraphStat.BANDWIDTH, 'max_graph_width': 300, # we need some sort of max size so we know how much graph data to retain 'show_accounting': True, - 'show_bytes': False, + 'show_bits': False, 'show_connections': True, }, conf_handler) @@ -708,4 +708,4 @@ def _size_label(byte_count, decimal = 1): or bytes. """ - return str_tools.size_label(byte_count, decimal, is_bytes = CONFIG['show_bytes']) + return str_tools.size_label(byte_count, decimal, is_bytes = not CONFIG['show_bits']) diff --git a/nyxrc.sample b/nyxrc.sample index 508c87f..8b87bca 100644 --- a/nyxrc.sample +++ b/nyxrc.sample @@ -8,7 +8,7 @@ data_directory ~/.nyx # Caching location, can be set to 'disabled'. tor_chroot /path # Chroot jail tor resides within if there is one. (*) -show_bytes false # Bandwidth rate as bytes if true, bits otherwise. +show_bits false # Bandwidth rate as bits if true, bytes otherwise. confirm_quit true # Confirm before quitting. color_interface true # Uses color in our interface. color_override none # Replaces instances of color with this hue. diff --git a/web/changelog/index.html b/web/changelog/index.html index b0ee9b7..e623751 100644 --- a/web/changelog/index.html +++ b/web/changelog/index.html @@ -66,6 +66,7 @@ <li><span class="component">Graph</span> <ul> <li>Graph prepopulation no longer requires shifting to 15 minute intervals</li> + <li>Graphing bandwith as bytes by default, rather than bits</li> </ul> </li> diff --git a/web/index.html b/web/index.html index d330554..5c2ab82 100644 --- a/web/index.html +++ b/web/index.html @@ -212,13 +212,22 @@ </div> </li> + <li id="bits_or_bytes"> + <span>Is bandwidth graphed in bits or bytes?</span> + <div class="answer"> + <p><b>Bytes</b>. Most tools measure in bytes so for consistency we do the same. Unfortunately hosting providers advertise in bits to inflate their numbers ("5 Mbit connection"). If graphs show just one eighth of what you expect this is why.</p> + <p>To graph in bits rather than bytes add the following to your nyxrc...</p> + <pre>show_bits true</pre> + </div> + </li> + <li id="broken_borders"> <span>Why are there borders like 'mwqqqqqqqqj'?</span> <div class="answer"> <a class="acs-img" href="images/screenshots/acs_failure.png"><img src="images/faq/acs_failure.png" alt="acs display failure"></a> <p>When alternate character support (ACS) <a href="http://invisible-island.net/ncurses/ncurses.faq.html#no_line_drawing">is unavailable</a> borders become characters like the picture above. This is a terminal bug.</p> <p>Unfortunately there doesn't seem to be a way for Nyx to automatically detect this. However, when it happens this <b>can</b> be easily corrected. Simply run <i>reset</i>. To tell Nyx not to use ACS borders simply add the following to your nyxrc...</p> - <pre>features.acsSupport false</pre> + <pre>acs_support false</pre> </div> </li>

1 0

[metrics-web/master] Put RFC 2629 files under version control.
by karsten＠torproject.org 05 Aug '17

05 Aug '17

commit 28ccc14c38ad707ede277674600e4d6bf5a680f8 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Tue Aug 1 21:38:26 2017 +0200 Put RFC 2629 files under version control. These files are required to compile specification documents from XML to JSP. --- website/src/main/resources/spec/rfc2629-other.ent | 61 + website/src/main/resources/spec/rfc2629-xhtml.ent | 165 + website/src/main/resources/spec/rfc2629.dtd | 312 + website/src/main/resources/spec/rfc2629.xslt | 10329 ++++++++++++++++++++ 4 files changed, 10867 insertions(+) diff --git a/website/src/main/resources/spec/rfc2629-other.ent b/website/src/main/resources/spec/rfc2629-other.ent new file mode 100755 index 0000000..0da80b7 --- /dev/null +++ b/website/src/main/resources/spec/rfc2629-other.ent @@ -0,0 +1,61 @@ + + + + + + +<!ENTITY excl "!"> +<!ENTITY num "#"> +<!ENTITY dollar "$"> +<!ENTITY percnt "%"> +<!ENTITY lpar "("> +<!ENTITY rpar ")"> +<!ENTITY ast "*"> +<!ENTITY plus "+"> +<!ENTITY comma ","> +<!ENTITY hyphen "-"> +<!ENTITY period "."> +<!ENTITY sol "/"> +<!ENTITY colon ":"> +<!ENTITY semi ";"> +<!ENTITY equals "="> +<!ENTITY quest "?"> +<!ENTITY commat "@"> +<!ENTITY lsqb "["> +<!ENTITY bsol "\"> +<!ENTITY rsqb "]"> +<!ENTITY circ "^"> +<!ENTITY lowbar "_"> +<!ENTITY grave "`"> +<!ENTITY lcub "{"> +<!ENTITY verbar "|"> +<!ENTITY rcub "}"> + + +<!ENTITY Zcaron "Ž"> +<!ENTITY zcaron "ž"> +<!ENTITY dash "‐"> +<!ENTITY nbhy "‑"> +<!ENTITY wj "⁠"> + + diff --git a/website/src/main/resources/spec/rfc2629-xhtml.ent b/website/src/main/resources/spec/rfc2629-xhtml.ent new file mode 100755 index 0000000..3d4a07d --- /dev/null +++ b/website/src/main/resources/spec/rfc2629-xhtml.ent @@ -0,0 +1,165 @@ + + + +<!ENTITY nbsp " "> +<!ENTITY iexcl "¡"> +<!ENTITY cent "¢"> +<!ENTITY pound "£"> +<!ENTITY curren "¤"> +<!ENTITY yen "¥"> +<!ENTITY brvbar "¦"> +<!ENTITY sect "§"> +<!ENTITY uml "¨"> +<!ENTITY copy "©"> +<!ENTITY ordf "ª"> +<!ENTITY laquo "«"> +<!ENTITY not "¬"> +<!ENTITY shy ""> +<!ENTITY reg "®"> +<!ENTITY macr "¯"> +<!ENTITY deg "°"> +<!ENTITY plusmn "±"> +<!ENTITY sup2 "²"> +<!ENTITY sup3 "³"> +<!ENTITY acute "´"> +<!ENTITY micro "µ"> +<!ENTITY para "¶"> +<!ENTITY middot "·"> +<!ENTITY cedil "¸"> +<!ENTITY sup1 "¹"> +<!ENTITY ordm "º"> +<!ENTITY raquo "»"> +<!ENTITY frac14 "¼"> +<!ENTITY frac12 "½"> +<!ENTITY frac34 "¾"> +<!ENTITY iquest "¿"> +<!ENTITY Agrave "À"> +<!ENTITY Aacute "Á"> +<!ENTITY Acirc "Â"> +<!ENTITY Atilde "Ã"> +<!ENTITY Auml "Ä"> +<!ENTITY Aring "Å"> +<!ENTITY AElig "Æ"> +<!ENTITY Ccedil "Ç"> +<!ENTITY Egrave "È"> +<!ENTITY Eacute "É"> +<!ENTITY Ecirc "Ê"> +<!ENTITY Euml "Ë"> +<!ENTITY Igrave "Ì"> +<!ENTITY Iacute "Í"> +<!ENTITY Icirc "Î"> +<!ENTITY Iuml "Ï"> +<!ENTITY ETH "Ð"> +<!ENTITY Ntilde "Ñ"> +<!ENTITY Ograve "Ò"> +<!ENTITY Oacute "Ó"> +<!ENTITY Ocirc "Ô"> +<!ENTITY Otilde "Õ"> +<!ENTITY Ouml "Ö"> +<!ENTITY times "×"> +<!ENTITY Oslash "Ø"> +<!ENTITY Ugrave "Ù"> +<!ENTITY Uacute "Ú"> +<!ENTITY Ucirc "Û"> +<!ENTITY Uuml "Ü"> +<!ENTITY Yacute "Ý"> +<!ENTITY THORN "Þ"> +<!ENTITY szlig "ß"> +<!ENTITY agrave "à"> +<!ENTITY aacute "á"> +<!ENTITY acirc "â"> +<!ENTITY atilde "ã"> +<!ENTITY auml "ä"> +<!ENTITY aring "å"> +<!ENTITY aelig "æ"> +<!ENTITY ccedil "ç"> +<!ENTITY egrave "è"> +<!ENTITY eacute "é"> +<!ENTITY ecirc "ê"> +<!ENTITY euml "ë"> +<!ENTITY igrave "ì"> +<!ENTITY iacute "í"> +<!ENTITY icirc "î"> +<!ENTITY iuml "ï"> +<!ENTITY eth "ð"> +<!ENTITY ntilde "ñ"> +<!ENTITY ograve "ò"> +<!ENTITY oacute "ó"> +<!ENTITY ocirc "ô"> +<!ENTITY otilde "õ"> +<!ENTITY ouml "ö"> +<!ENTITY divide "÷"> +<!ENTITY oslash "ø"> +<!ENTITY ugrave "ù"> +<!ENTITY uacute "ú"> +<!ENTITY ucirc "û"> +<!ENTITY uuml "ü"> +<!ENTITY yacute "ý"> +<!ENTITY thorn "þ"> +<!ENTITY yuml "ÿ"> + + +<!ENTITY OElig "Œ"> +<!ENTITY oelig "œ"> +<!ENTITY Scaron "Š"> +<!ENTITY scaron "š"> +<!ENTITY Yuml "Ÿ"> + + +<!ENTITY fnof "ƒ"> +<!ENTITY tilde "˜"> +<!ENTITY ensp " "> +<!ENTITY emsp " "> +<!ENTITY thinsp " "> +<!ENTITY ndash "–"> +<!ENTITY mdash "—"> +<!ENTITY lsquo "‘"> +<!ENTITY rsquo "’"> +<!ENTITY sbquo "‚"> +<!ENTITY ldquo "“"> +<!ENTITY rdquo "”"> +<!ENTITY bdquo "„"> +<!ENTITY dagger "†"> +<!ENTITY Dagger "‡"> +<!ENTITY bull "•"> +<!ENTITY hellip "…"> +<!ENTITY permil "′"> +<!ENTITY prime "′"> +<!ENTITY Prime "″"> +<!ENTITY lsaquo "‹"> +<!ENTITY rsaquo "›"> +<!ENTITY frasl "⁄"> +<!ENTITY euro "€"> +<!ENTITY trade "™"> +<!ENTITY larr "←"> +<!ENTITY rarr "→"> +<!ENTITY harr "↔"> +<!ENTITY lArr "⇐"> +<!ENTITY rArr "⇒"> +<!ENTITY hArr "⇔"> +<!ENTITY minus "−"> +<!ENTITY lowast "∗"> +<!ENTITY le "≤"> +<!ENTITY ge "≥"> +<!ENTITY lang "〈"> +<!ENTITY rang "〉"> + + diff --git a/website/src/main/resources/spec/rfc2629.dtd b/website/src/main/resources/spec/rfc2629.dtd new file mode 100644 index 0000000..11334ae --- /dev/null +++ b/website/src/main/resources/spec/rfc2629.dtd @@ -0,0 +1,312 @@ + + + + + + + + + + + + +<!ENTITY % rfc2629-xhtml + PUBLIC "-//IETF//ENTITIES XHTML subset for RFC 2629//EN" + "rfc2629-xhtml.ent"> +%rfc2629-xhtml; + +<!ENTITY % rfc2629-other + PUBLIC "-//IETF//ENTITIES Other for RFC 2629//EN" + "rfc2629-other.ent"> +%rfc2629-other; + + + + + +<!ENTITY % NUMBER "CDATA"> +<!ENTITY % NUMBERS "CDATA"> + +<!ENTITY % DAY "CDATA"> +<!ENTITY % MONTH "CDATA"> +<!ENTITY % YEAR "CDATA"> + +<!ENTITY % URI "CDATA"> + +<!ENTITY % ATEXT "CDATA"> +<!ENTITY % CTEXT "#PCDATA"> + +<!ENTITY % TEXT "#PCDATA"> + +<!ENTITY rfc.number "XXXX"> + + + + + + +<!ELEMENT rfc (front,middle,back?)> +<!ATTLIST rfc + number %NUMBER; #IMPLIED + obsoletes %NUMBERS; "" + updates %NUMBERS; "" + category (std|bcp|info|exp|historic) + #IMPLIED + consensus (no|yes) #IMPLIED + seriesNo %NUMBER; #IMPLIED + ipr (full2026|noDerivativeWorks2026|none + |full3667|noModification3667|noDerivatives3667 + |full3978|noModification3978|noDerivatives3978 + |trust200811|noModificationTrust200811|noDerivativesTrust200811 + |trust200902|noModificationTrust200902|noDerivativesTrust200902 + |pre5378Trust200902) + #IMPLIED + iprExtract IDREF #IMPLIED + submissionType + (IETF|IAB|IRTF|independent) "IETF" + docName %ATEXT; #IMPLIED + xml:lang %ATEXT; "en"> + + + + + +<!ELEMENT front (title,author+,date,area*,workgroup*,keyword*, + abstract?,note*)> + + +<!ELEMENT title (%CTEXT;)> +<!ATTLIST title + abbrev %ATEXT; #IMPLIED> + +<!ELEMENT author (organization?,address?)> +<!ATTLIST author + initials %ATEXT; #IMPLIED + surname %ATEXT; #IMPLIED + fullname %ATEXT; #IMPLIED + role (editor) #IMPLIED> + +<!ELEMENT organization + (%CTEXT;)> +<!ATTLIST organization + abbrev %ATEXT; #IMPLIED> + +<!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)> + + +<!ELEMENT postal (street+,(city|region|code|country)*)> +<!ELEMENT street (%CTEXT;)> +<!ELEMENT city (%CTEXT;)> +<!ELEMENT region (%CTEXT;)> +<!ELEMENT code (%CTEXT;)> +<!ELEMENT country (%CTEXT;)> +<!ELEMENT phone (%CTEXT;)> +<!ELEMENT facsimile (%CTEXT;)> +<!ELEMENT email (%CTEXT;)> +<!ELEMENT uri (%CTEXT;)> + +<!ELEMENT date EMPTY> +<!ATTLIST date + day %DAY; #IMPLIED + month %MONTH; #IMPLIED + year %YEAR; #IMPLIED> + + +<!ELEMENT area (%CTEXT;)> +<!ELEMENT workgroup (%CTEXT;)> +<!ELEMENT keyword (%CTEXT;)> + +<!ELEMENT abstract (t)+> +<!ELEMENT note (t)+> +<!ATTLIST note + title %ATEXT; #REQUIRED> + + + + + +<!ELEMENT middle (section+)> + +<!ELEMENT section ((t|figure|texttable|iref)*,section*)> +<!ATTLIST section + anchor ID #IMPLIED + title %ATEXT; #REQUIRED + toc (include|exclude|default) + "default"> + + + + +<!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|cref|spanx|vspace)*> +<!ATTLIST t + anchor ID #IMPLIED + hangText %ATEXT; #IMPLIED> + + +<!ELEMENT list (t+)> +<!ATTLIST list + style %ATEXT; #IMPLIED + hangIndent %NUMBER; #IMPLIED + counter %ATEXT; #IMPLIED> + +<!ELEMENT xref (%CTEXT;)> +<!ATTLIST xref + target IDREF #REQUIRED + pageno (true|false) "false" + format (counter|title|none|default) + "default"> + +<!ELEMENT eref (%CTEXT;)> +<!ATTLIST eref + target %URI; #REQUIRED> + +<!ELEMENT iref EMPTY> +<!ATTLIST iref + item %ATEXT; #REQUIRED + subitem %ATEXT; "" + primary (true|false) "false"> + +<!ELEMENT cref (%CTEXT;)> +<!ATTLIST cref + anchor ID #IMPLIED + source %ATEXT; #IMPLIED> + +<!ELEMENT spanx (%CTEXT;)> +<!ATTLIST spanx + xml:space (default|preserve) "preserve" + style %ATEXT; "emph"> + +<!ELEMENT vspace EMPTY> +<!ATTLIST vspace + blankLines %NUMBER; "0"> + +<!ELEMENT figure (iref*,preamble?,artwork,postamble?)> +<!ATTLIST figure + anchor ID #IMPLIED + title %ATEXT; "" + suppress-title (true|false) "false" + src %URI; #IMPLIED + align (left|center|right) "left" + alt %ATEXT; "" + width %ATEXT; "" + height %ATEXT; ""> + +<!ELEMENT preamble (%TEXT;|xref|eref|iref|cref|spanx)*> +<!ELEMENT artwork (%TEXT;)*> +<!ATTLIST artwork + xml:space (default|preserve) "preserve" + name %ATEXT; "" + type %ATEXT; "" + src %URI; #IMPLIED + align (left|center|right) "left" + alt %ATEXT; "" + width %ATEXT; "" + height %ATEXT; ""> + +<!ELEMENT postamble (%TEXT;|xref|eref|iref|cref|spanx)*> + +<!ELEMENT texttable (preamble?,ttcol+,c*,postamble?)> +<!ATTLIST texttable + anchor ID #IMPLIED + title %ATEXT; "" + suppress-title (true|false) "false" + align (left|center|right) "center" + style (all|none|headers|full) "full"> +<!ELEMENT ttcol (%CTEXT;)> +<!ATTLIST ttcol + width %ATEXT; #IMPLIED + align (left|center|right) "left"> +<!ELEMENT c (%TEXT;|xref|eref|iref|cref|spanx)*> + + + + + + +<!ELEMENT back (references*,section*)> + +<!ELEMENT references (reference+)> +<!ATTLIST references + title %ATEXT; "References"> +<!ELEMENT reference (front,seriesInfo*,format*,annotation*)> +<!ATTLIST reference + anchor ID #IMPLIED + target %URI; #IMPLIED> +<!ELEMENT seriesInfo EMPTY> +<!ATTLIST seriesInfo + name %ATEXT; #REQUIRED + value %ATEXT; #REQUIRED> +<!ELEMENT format EMPTY> +<!ATTLIST format + target %URI; #IMPLIED + type %ATEXT; #REQUIRED + octets %NUMBER; #IMPLIED> +<!ELEMENT annotation (%TEXT;|xref|eref|iref|cref|spanx)*> diff --git a/website/src/main/resources/spec/rfc2629.xslt b/website/src/main/resources/spec/rfc2629.xslt new file mode 100644 index 0000000..7a7d284 --- /dev/null +++ b/website/src/main/resources/spec/rfc2629.xslt @@ -0,0 +1,10329 @@ + + +<xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="2.0" + + xmlns:date="http://exslt.org/dates-and-times" + xmlns:ed="http://greenbytes.de/2002/rfcedit" + xmlns:exslt="http://exslt.org/common" + xmlns:msxsl="urn:schemas-microsoft-com:xslt" + xmlns:myns="mailto:julian.reschke@greenbytes.de?subject=rcf2629.xslt" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:saxon="http://saxon.sf.net/" + xmlns:saxon-old="http://icl.com/saxon" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:x="http://purl.org/net/xml2rfc/ext" + xmlns:xi="http://www.w3.org/2001/XInclude" + xmlns:xhtml="http://www.w3.org/1999/xhtml" + + exclude-result-prefixes="date ed exslt msxsl myns rdf saxon saxon-old svg x xi xhtml" + > + +<xsl:strip-space elements="abstract address author back figure front list middle note postal reference references rfc section table tbody thead tr texttable"/> + +<xsl:output method="html" encoding="utf-8" doctype-system="about:legacy-compat" indent="no"/> + + +<xsl:variable name="global-std-pis" select="/processing-instruction('rfc') | /*/processing-instruction('rfc')[following-sibling::front]"/> + + + +<xsl:param name="xml2rfc-authorship"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'authorship'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-comments"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'comments'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-compact"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'compact'"/> + <xsl:with-param name="default" select="$xml2rfc-rfcedstyle"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-footer"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'footer'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-header"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'header'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-inline"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'inline'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-toc"> + <xsl:variable name="default"> + <xsl:choose> + <xsl:when test="/rfc/@version >= 3">yes</xsl:when> + <xsl:otherwise>no</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="/rfc/@tocInclude='false'">no</xsl:when> + <xsl:when test="/rfc/@tocInclude='true'">yes</xsl:when> + <xsl:otherwise> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'toc'"/> + <xsl:with-param name="default" select="$default"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +<xsl:param name="xml2rfc-tocdepth"> + <xsl:choose> + <xsl:when test="/rfc/@tocDepth"> + <xsl:value-of select="/rfc/@tocDepth"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'tocdepth'"/> + <xsl:with-param name="default" select="'3'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + +<xsl:variable name="parsedTocDepth"> + <xsl:choose> + <xsl:when test="$xml2rfc-tocdepth='1'">1</xsl:when> + <xsl:when test="$xml2rfc-tocdepth='2'">2</xsl:when> + <xsl:when test="$xml2rfc-tocdepth='3'">3</xsl:when> + <xsl:when test="$xml2rfc-tocdepth='4'">4</xsl:when> + <xsl:when test="$xml2rfc-tocdepth='5'">5</xsl:when> + <xsl:otherwise>99</xsl:otherwise> + </xsl:choose> +</xsl:variable> + + + +<xsl:param name="xml2rfc-topblock"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'topblock'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-rfcedstyle"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'rfcedstyle'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-refparent"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'refparent'"/> + <xsl:with-param name="default" select="'References'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-symrefs"> + <xsl:choose> + <xsl:when test="/rfc/@symRefs='false'">no</xsl:when> + <xsl:when test="/rfc/@symRefs='true'">yes</xsl:when> + <xsl:otherwise> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'symrefs'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +<xsl:param name="xml2rfc-sortrefs"> + <xsl:choose> + <xsl:when test="/rfc/@sortRefs='true'">yes</xsl:when> + <xsl:when test="/rfc/@sortRefs='false'">no</xsl:when> + <xsl:otherwise> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'sortrefs'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +<xsl:param name="xml2rfc-editing"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'editing'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-private"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'private'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-background"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'background'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-maxwidth"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'maxwidth'"/> + <xsl:with-param name="default" select="'1000'"/> + </xsl:call-template> +</xsl:param> + +<xsl:variable name="parsedMaxwidth"> + <xsl:choose> + <xsl:when test="string(number($xml2rfc-ext-maxwidth)) != 'NaN'"> + <xsl:value-of select="$xml2rfc-ext-maxwidth"/> + </xsl:when> + <xsl:when test="$xml2rfc-ext-maxwidth='none'"></xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('Unsupported value of rfc-ext maxwidth PI: ', $xml2rfc-ext-maxwidth)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> + + + +<xsl:param name="xml2rfc-ext-styles">fft-sans-serif ffb-serif ff-cleartype</xsl:param> + +<xsl:variable name="styles" select="concat(' ',normalize-space($xml2rfc-ext-styles),' ')"/> + +<xsl:param name="xml2rfc-ext-ff-body"> + <xsl:variable name="t"> + <xsl:if test="contains($styles,' ff-noto ')"> + <xsl:if test="contains($styles,' ffb-serif ')"> + 'Noto Serif', + </xsl:if> + <xsl:if test="contains($styles,' ffb-sans-serif ')"> + 'Noto Sans', + </xsl:if> + </xsl:if> + <xsl:if test="contains($styles,' ff-cleartype ')"> + <xsl:if test="contains($styles,' ffb-serif ')"> + cambria, georgia, + </xsl:if> + <xsl:if test="contains($styles,' ffb-sans-serif ')"> + candara, calibri, + </xsl:if> + </xsl:if> + <xsl:if test="contains($styles,' ffb-sans-serif ')"> + segoe, optima, arial, sans-serif, + </xsl:if> + serif + </xsl:variable> + <xsl:call-template name="ff-list"> + <xsl:with-param name="s" select="normalize-space($t)"/> + </xsl:call-template> +</xsl:param> + +<xsl:param name="xml2rfc-ext-ff-title"> + <xsl:variable name="t"> + <xsl:if test="contains($styles,' ff-noto ')"> + <xsl:if test="contains($styles,' fft-serif ')"> + 'Noto Serif', + </xsl:if> + <xsl:if test="contains($styles,' fft-sans-serif ')"> + 'Noto Sans', + </xsl:if> + </xsl:if> + <xsl:if test="contains($styles,' ff-cleartype ')"> + <xsl:if test="contains($styles,' fft-serif ')"> + cambria, georgia, + </xsl:if> + <xsl:if test="contains($styles,' fft-sans-serif ')"> + candara, calibri, + </xsl:if> + </xsl:if> + <xsl:if test="contains($styles,' fft-serif ')"> + serif, + </xsl:if> + <xsl:if test="contains($styles,' fft-sans-serif ')"> + segoe, optima, arial, + </xsl:if> + sans-serif + </xsl:variable> + <xsl:call-template name="ff-list"> + <xsl:with-param name="s" select="normalize-space($t)"/> + </xsl:call-template> +</xsl:param> + +<xsl:param name="xml2rfc-ext-ff-pre"> + <xsl:variable name="t"> + <xsl:if test="contains($styles,' ff-noto ')"> + 'Roboto Mono', + </xsl:if> + <xsl:if test="contains($styles,' ff-cleartype ')"> + consolas, monaco, + </xsl:if> + monospace + </xsl:variable> + <xsl:call-template name="ff-list"> + <xsl:with-param name="s" select="normalize-space($t)"/> + </xsl:call-template> +</xsl:param> + +<xsl:param name="xml2rfc-ext-webfonts"> + <xsl:if test="contains($styles,' ff-noto ')"> + <xsl:if test="contains($styles,' ffb-sans-serif ') or contains($styles,' fft-sans-serif ')"> + <xsl:text>@import url('https://fonts.googleapis.com/css?family=Noto+Sans:r,b,i,bi');
</xsl:text> + </xsl:if> + <xsl:if test="contains($styles,' ffb-serif ') or contains($styles,' fft-serif ')"> + <xsl:text>@import url('https://fonts.googleapis.com/css?family=Noto+Serif:r,b,i,bi');
</xsl:text> + </xsl:if> + <xsl:text>@import url('https://fonts.googleapis.com/css?family=Roboto+Mono:r,b,i,bi');
</xsl:text> + </xsl:if> +</xsl:param> + +<xsl:template name="ff-list"> + <xsl:param name="s"/> + <xsl:choose> + <xsl:when test="not(contains($s,','))"> + <xsl:value-of select="normalize-space($s)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(substring-before($s,','))"/> + <xsl:text>, </xsl:text> + <xsl:call-template name="ff-list"> + <xsl:with-param name="s" select="substring-after($s,',')"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + +<xsl:template name="getIncludes"> + <xsl:param name="nodes"/> + <xsl:for-each select="$nodes"> + <xsl:variable name="include"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="."/> + <xsl:with-param name="attr" select="'include'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="doc"> + <xsl:choose> + <xsl:when test="$include=''"/> + <xsl:when test="substring($include, string-length($include) - 3) != '.xml'"> + <xsl:copy-of select="document(concat($include,'.xml'))"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="document($include)"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="count(exslt:node-set($doc)) = 1"> + <myns:include from="{$include}" in="{generate-id(..)}"> + <xsl:copy-of select="$doc"/> + </myns:include> + </xsl:if> + </xsl:for-each> +</xsl:template> + +<xsl:template name="getXIncludes"> + <xsl:param name="nodes"/> + <xsl:for-each select="$nodes"> + <xsl:choose> + <xsl:when test="(@parse and @parse!='xml') or @xpointer"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'Unsupported attributes on x:include element'"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="doc"> + <xsl:copy-of select="document(@href)"/> + </xsl:variable> + <xsl:if test="count(exslt:node-set($doc)) = 1"> + <myns:include from="{@href}" in="{generate-id(..)}"> + <xsl:copy-of select="$doc"/> + </myns:include> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> +</xsl:template> + +<xsl:variable name="includeDirectives"> + <xsl:call-template name="getIncludes"> + <xsl:with-param name="nodes" select="/rfc/back/references/processing-instruction('rfc')"/> + </xsl:call-template> + <xsl:call-template name="getXIncludes"> + <xsl:with-param name="nodes" select="/rfc/back/references/xi:include"/> + </xsl:call-template> +</xsl:variable> + + + +<xsl:param name="xml2rfc-ext-html-pretty-print"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'html-pretty-print'"/> + </xsl:call-template> +</xsl:param> + +<xsl:variable name="prettyprint-class"> + <xsl:if test="$xml2rfc-ext-html-pretty-print"> + <xsl:value-of select="substring-before(normalize-space($xml2rfc-ext-html-pretty-print),' ')"/> + </xsl:if> +</xsl:variable> + +<xsl:variable name="prettyprint-script"> + <xsl:if test="$xml2rfc-ext-html-pretty-print"> + <xsl:value-of select="substring-after(normalize-space($xml2rfc-ext-html-pretty-print),' ')"/> + </xsl:if> +</xsl:variable> + + +<xsl:param name="xml2rfc-ext-errata"/> +<xsl:variable name="errata-parsed" select="document($xml2rfc-ext-errata)//erratum[@status!='Rejected']"/> + + +<xsl:variable name="note-removeInRFC">This note is to be removed before publishing as an RFC.</xsl:variable> +<xsl:variable name="section-removeInRFC">This section is to be removed before publishing as an RFC.</xsl:variable> + + + + +<xsl:param name="xml2rfc-ext-css-map"/> + +<xsl:template name="generate-css-class"> + <xsl:param name="name"/> + <xsl:variable name="cssmap" select="document($xml2rfc-ext-css-map)"/> + <xsl:variable name="entry" select="$cssmap/*/map[@from=$name]"/> + <xsl:choose> + <xsl:when test="$entry"> + <xsl:value-of select="$entry/@css"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$name"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:variable name="css-artwork"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'artwork'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-art-svg"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'art-svg'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-docstatus"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'docstatus'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-center"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'center'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-erratum"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'erratum'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-error"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'error'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-fbbutton"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'fbbutton'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-feedback"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'feedback'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-header"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'header'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-left"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'left'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-noprint"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'noprint'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-publishedasrfc"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'publishedasrfc'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-reference"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'reference'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-right"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'right'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-tcenter"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'tcenter'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-tleft"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'tleft'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-tright"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'tright'"/></xsl:call-template></xsl:variable> +<xsl:variable name="css-tt"><xsl:call-template name="generate-css-class"><xsl:with-param name="name" select="'tt'"/></xsl:call-template></xsl:variable> + + + + +<xsl:param name="xml2rfc-ext-link-rfc-to-info-page"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'link-rfc-to-info-page'"/> + <xsl:with-param name="default"> + <xsl:choose> + <xsl:when test="$pub-yearmonth >= 201503">yes</xsl:when> + <xsl:otherwise>no</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-insert-doi"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'insert-doi'"/> + <xsl:with-param name="default"> + <xsl:choose> + <xsl:when test="$pub-yearmonth >= 201505">yes</xsl:when> + <xsl:otherwise>no</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-multiple-initials"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc')"/> + <xsl:with-param name="attr" select="'multiple-initials'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-paragraph-links"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'paragraph-links'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-parse-xml-in-artwork"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'parse-xml-in-artwork'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + +<xsl:param name="xml2rfc-ext-trace-parse-xml"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'trace-parse-xml'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-include-index"> + <xsl:choose> + <xsl:when test="/rfc/@indexInclude='false'">no</xsl:when> + <xsl:when test="/rfc/@indexInclude='true'">yes</xsl:when> + <xsl:otherwise> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'include-index'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-insert-metadata"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'insert-metadata'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-support-rfc2731"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'support-rfc2731'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-vspace-pagebreak"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'vspace-pagebreak'"/> + <xsl:with-param name="default" select="'100'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-allow-markup-in-artwork"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'allow-markup-in-artwork'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-include-references-in-index"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'include-references-in-index'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-authors-section"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'authors-section'"/> + <xsl:with-param name="default" select="'end'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-justification"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'justification'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-duplex"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'duplex'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-sec-no-trailing-dots"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'sec-no-trailing-dots'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-ext-check-artwork-width"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'check-artwork-width'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-linkmailto"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'linkmailto'"/> + <xsl:with-param name="default" select="'yes'"/> + </xsl:call-template> +</xsl:param> + + + +<xsl:param name="xml2rfc-iprnotified"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$global-std-pis"/> + <xsl:with-param name="attr" select="'iprnotified'"/> + <xsl:with-param name="default" select="'no'"/> + </xsl:call-template> +</xsl:param> + + + + + +<xsl:param name="rfcUrlFragSection" select="'section-'" /> +<xsl:param name="rfcUrlFragAppendix" select="'appendix-'" /> +<xsl:param name="internetDraftUrlFragSection" select="'section-'" /> +<xsl:param name="internetDraftUrlFragAppendix" select="'appendix-'" /> + + + +<xsl:param name="xml2rfc-ext-isbn-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'isbn-uri'"/> + <xsl:with-param name="default">https://www.worldcat.org/search?q=isbn:{isbn}</xsl:with-param> + </xsl:call-template> +</xsl:param> + +<xsl:template name="compute-isbn-uri"> + <xsl:param name="isbn"/> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-isbn-uri"/> + <xsl:with-param name="replace" select="'{isbn}'"/> + <xsl:with-param name="by" select="translate($isbn,'-','')"/> + </xsl:call-template> +</xsl:template> + +<xsl:param name="xml2rfc-ext-rfc-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'rfc-uri'"/> + <xsl:with-param name="default">https://tools.ietf.org/html/rfc{rfc}</xsl:with-param> + </xsl:call-template> +</xsl:param> + +<xsl:template name="compute-rfc-uri"> + <xsl:param name="rfc"/> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-rfc-uri"/> + <xsl:with-param name="replace" select="'{rfc}'"/> + <xsl:with-param name="by" select="$rfc"/> + </xsl:call-template> +</xsl:template> + +<xsl:param name="xml2rfc-ext-internet-draft-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'internet-draft-uri'"/> + <xsl:with-param name="default">https://tools.ietf.org/html/{internet-draft}</xsl:with-param> + </xsl:call-template> +</xsl:param> + +<xsl:template name="compute-internet-draft-uri"> + <xsl:param name="internet-draft"/> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-internet-draft-uri"/> + <xsl:with-param name="replace" select="'{internet-draft}'"/> + <xsl:with-param name="by" select="$internet-draft"/> + </xsl:call-template> +</xsl:template> + +<xsl:param name="xml2rfc-ext-doi-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'doi-uri'"/> + <xsl:with-param name="default">http://dx.doi.org/{doi}</xsl:with-param> + </xsl:call-template> +</xsl:param> + +<xsl:template name="compute-doi-uri"> + <xsl:param name="doi"/> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-doi-uri"/> + <xsl:with-param name="replace" select="'{doi}'"/> + <xsl:with-param name="by" select="$doi"/> + </xsl:call-template> +</xsl:template> + +<xsl:param name="xml2rfc-ext-rfc-erratum-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'rfc-erratum-uri'"/> + <xsl:with-param name="default">https://www.rfc-editor.org/errata/eid{eid}</xsl:with-param> + </xsl:call-template> +</xsl:param> + +<xsl:template name="compute-rfc-erratum-uri"> + <xsl:param name="eid"/> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-rfc-erratum-uri"/> + <xsl:with-param name="replace" select="'{eid}'"/> + <xsl:with-param name="by" select="$eid"/> + </xsl:call-template> +</xsl:template> + +<xsl:param name="xml2rfc-ext-rfc-errata-uri"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'rfc-errata-uri'"/> + <xsl:with-param name="default">https://www.rfc-editor.org/errata_search.php?rfc={rfc}</xsl:with-param> + </xsl:call-template> +</xsl:param> + + +<xsl:param name="outputExtension" select="'html'"/> + + +<xsl:param name="xml2rfc-ext-refresh-from"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'refresh-from'"/> + <xsl:with-param name="default" select="''"/> + </xsl:call-template> +</xsl:param> + + +<xsl:param name="xml2rfc-ext-refresh-xslt"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'refresh-xslt'"/> + <xsl:with-param name="default" select="'rfc2629.xslt'"/> + </xsl:call-template> +</xsl:param> + + +<xsl:param name="xml2rfc-ext-refresh-interval"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="/processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'refresh-interval'"/> + <xsl:with-param name="default" select="10"/> + </xsl:call-template> +</xsl:param> + + +<xsl:variable name="node-set-warning"> + This stylesheet requires either an XSLT-1.0 processor with node-set() + extension function, or an XSLT-2.0 processor. Therefore, parts of the + document couldn't be displayed. +</xsl:variable> + + +<xsl:variable name="lcase" select="'abcdefghijklmnopqrstuvwxyz'" /> +<xsl:variable name="ucase" select="'ABCDEFGHIJKLMNOPQRSTUVWXYZ'" /> +<xsl:variable name="digits" select="'0123456789'" /> +<xsl:variable name="alpha" select="concat($lcase,$ucase)"/> +<xsl:variable name="alnum" select="concat($alpha,$digits)"/> + + +<xsl:key name="index-first-letter" + match="iref|reference" + use="translate(substring(concat(@anchor,@item),1,1),'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')" /> + +<xsl:key name="index-item" + match="iref" + use="@item" /> + +<xsl:key name="index-item-subitem" + match="iref" + use="concat(@item,'..',@subitem)" /> + +<xsl:key name="index-xref-by-sec" + match="xref[@x:sec|@section]" + use="concat(@target,'..',@x:sec,@section)" /> + +<xsl:key name="index-xref-by-anchor" + match="xref[@x:rel|@relative]" + use="concat(@target,'..',@x:rel,@relative)" /> + +<xsl:key name="anchor-item" + match="//*[@anchor]" + use="@anchor"/> + +<xsl:key name="xref-item" + match="//xref" + use="@target"/> + +<xsl:key name="extref-item" + match="//x:ref" + use="."/> + + +<xsl:variable name="anchor-pref" select="'rfc.'" /> + + +<xsl:variable name="ipr-rfc3667" select="( + /rfc/@number > 3708) or + not( + (/rfc/@ipr = 'full2026') or + (/rfc/@ipr = 'noDerivativeWorks2026') or + (/rfc/@ipr = 'noDerivativeWorksNow') or + (/rfc/@ipr = 'none') or + (/rfc/@ipr = '') or + not(/rfc/@ipr) + )" /> + +<xsl:variable name="rfcno" select="/rfc/@number"/> + +<xsl:variable name="submissionType"> + <xsl:choose> + <xsl:when test="/rfc/@submissionType='IETF' or not(/rfc/@submissionType) or /rfc/submissionType=''">IETF</xsl:when> + <xsl:when test="/rfc/@submissionType='IAB' or /rfc/@submissionType='IRTF' or /rfc/@submissionType='independent'"> + <xsl:value-of select="/rfc/@submissionType"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('(UNSUPPORTED SUBMISSION TYPE: ',/rfc/@submissionType,')')"/> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported value for /rfc/@submissionType: ', /rfc/@submissionType)"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +  + <xsl:if test="/rfc/@consensus and /rfc/@submissionType='independent'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('/rfc/@consensus meaningless with a /rfc/@submissionType value of ', /rfc/@submissionType)"/> + </xsl:call-template> + </xsl:if> +</xsl:variable> + +<xsl:variable name="consensus"> + <xsl:choose> + <xsl:when test="/rfc/@consensus='yes' or /rfc/@consensus='true' or not(/rfc/@consensus)">yes</xsl:when> + <xsl:when test="/rfc/@consensus='no' or /rfc/@consensus='false'">no</xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('(UNSUPPORTED VALUE FOR CONSENSUS: ',/rfc/@consensus,')')"/> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported value for /rfc/@consensus: ', /rfc/@consensus)"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> + + +<xsl:variable name="header-format"> + <xsl:choose> + <xsl:when test="$pub-yearmonth >= 201001 or + ($rfcno=5741 or $rfcno=5742 or $rfcno=5743)" + >2010</xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="rfc-boilerplate"> + <xsl:choose> +  + <xsl:when test="$pub-yearmonth >= 201001 or + ($rfcno=5741 or $rfcno=5742 or $rfcno=5743)" + >2010</xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + + +<xsl:variable name="hab-reference"> + <xsl:choose> + <xsl:when test="$pub-yearmonth >= 201606 or ($rfcno=7846 or $rfcno=7865 or $rfcno=7866 or $rfcno=7873 or $rfcno=7879 or $rfcno=7892)">Section 2 of RFC 7841</xsl:when> + <xsl:otherwise>Section 2 of RFC 5741</xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="id-boilerplate"> + <xsl:choose> +  + <xsl:when test="$pub-yearmonth >= 201004" + >2010</xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="ipr-rfc4748" select="( + $ipr-rfc3667 and + ( $rfcno >= 4715 and ( $rfcno != 4718 and $rfcno != 4735 and $rfcno != 4749 )) + or + ( $rfcno=4578 or $rfcno=4582 or $rfcno=4583 or $rfcno=4628 or $rfcno=4629 or $rfcno=4639 or $rfcno=4651 or $rfcno=4682 or $rfcno=4684 or $rfcno=4695 or $rfcno=4696 ) + or + ( not(/rfc/@number) and $pub-yearmonth >= 200611) + )" /> + +<xsl:variable name="ipr-2007-08" select="( + $ipr-rfc4748 and + ( + ($rfcno > 5000 + and $rfcno != 5020 + and $rfcno != 5021 + and $rfcno != 5034 + and $rfcno != 5052 + and $rfcno != 5065 + and $rfcno != 5094) or + ($xml2rfc-ext-pub-year >= 2008) or + (not(/rfc/@number) and $pub-yearmonth >= 200709) + ) + )" /> + +<xsl:variable name="ipr-2008-11" select="( + /rfc/@number and $pub-yearmonth >= 200811 + ) + or + ( + /rfc/@ipr = 'trust200811' or + /rfc/@ipr = 'noModificationTrust200811' or + /rfc/@ipr = 'noDerivativesTrust200902' or + /rfc/@ipr = 'trust200902' or + /rfc/@ipr = 'noModificationTrust200902' or + /rfc/@ipr = 'noDerivativesTrust200902' or + /rfc/@ipr = 'pre5378Trust200902' + )" /> + +<xsl:variable name="ipr-2009-02" select="( + $ipr-2008-11 and $pub-yearmonth >= 200902 + )" /> + + +<xsl:variable name="ipr-2009-09" select="( + ( not(/rfc/@number) and $pub-yearmonth >= 200911 ) + or + ( + /rfc/@number and $pub-yearmonth >= 200909 and + $rfcno!=5582 and $rfcno!=5621 and $rfcno!=5632 and $rfcno!=5645 and $rfcno!=5646 and $rfcno!=5681 + ) + )" /> + + +<xsl:variable name="ipr-2010-01" select="( + ( not(/rfc/@number) and $pub-yearmonth >= 201004 ) + or + ( + /rfc/@number and ($pub-yearmonth >= 201001 or + $rfcno=5741 or $rfcno=5742 or $rfcno=5743) + ) + )" /> + + + +<xsl:variable name="abstract-first" select="( + (/rfc/@number and $pub-yearmonth >= 200907) + or + (not(/rfc/@number) and $pub-yearmonth >= 200911) + )" /> + + +<xsl:variable name="notes-follow-abstract" select="( + (/rfc/@number and /rfc/@number >= 7200) + or + ($pub-yearmonth >= 201409) + )" /> + + +<xsl:variable name="funding0" select="( + $rfcno > 2499) or + (not(/rfc/@number) and /rfc/@docName and $xml2rfc-ext-pub-year >= 1999 + )" /> + +<xsl:variable name="funding1" select="( + $rfcno > 4320) or + (not(/rfc/@number) and /rfc/@docName and $xml2rfc-ext-pub-year >= 2006 + )" /> + +<xsl:variable name="no-funding" select="$ipr-2007-08"/> + +<xsl:variable name="no-copylong" select="$ipr-2008-11"/> + + +<xsl:variable name="has-index" select="(//iref or (//xref and $xml2rfc-ext-include-references-in-index='yes')) and $xml2rfc-ext-include-index!='no'" /> + + +<xsl:variable name="has-edits" select="//ed:ins | //ed:del | //ed:replace" /> + + +<xsl:variable name="published-as-rfc" select="/*/x:link[@rel='Alternate' and starts-with(@title,'RFC')]"/> + + +<xsl:template match="text()[not(ancestor::artwork) and not(ancestor::sourcecode)]"> + <xsl:variable name="ws" select="'	
 '"/> + <xsl:variable name="starts-with-ws" select="'' = translate(substring(.,1,1),$ws,'')"/> + <xsl:variable name="ends-with-ws" select="'' = translate(substring(.,string-length(.),1),$ws,'')"/> + <xsl:variable name="normalized" select="normalize-space(.)"/> +  + <xsl:if test="$starts-with-ws and (preceding-sibling::node() | parent::ed:ins | parent::ed:del)"> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:value-of select="$normalized"/> + <xsl:if test="$ends-with-ws and $normalized!='' and (following-sibling::node() | parent::ed:ins | parent::ed:del)"> + <xsl:text> </xsl:text> + </xsl:if> +</xsl:template> + + +<xsl:template match="abstract"> + <xsl:call-template name="check-no-text-content"/> + <section id="{$anchor-pref}abstract"> + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="'abstract'"/> + </xsl:call-template> + <h2><a href="#{$anchor-pref}abstract">Abstract</a></h2> + <xsl:apply-templates /> + </section> +</xsl:template> + +<msxsl:script language="JScript" implements-prefix="myns"> + function parseXml(str) { + try { + var doc = new ActiveXObject("MSXML2.DOMDocument"); + doc.async = false; + if (doc.loadXML(str)) { + return ""; + } + else { + return doc.parseError.reason + "\n" + doc.parseError.srcText + " (" + doc.parseError.line + "/" + doc.parseError.linepos + ")"; + } + } + catch(e) { + return ""; + } + } +</msxsl:script> + +<xsl:template name="add-artwork-class"> + <xsl:variable name="v"> + <xsl:choose> + <xsl:when test="@type='abnf' or @type='abnf2045' or @type='abnf2616' or @type='abnf7230' or @type='application/xml-dtd' or @type='inline' or @type='application/relax-ng-compact-syntax'">inline</xsl:when> + <xsl:when test="starts-with(@type,'message/http') and contains(@type,'msgtype="request"')">text2</xsl:when> + <xsl:when test="starts-with(@type,'message/http')">text</xsl:when> + <xsl:when test="starts-with(@type,'drawing')">drawing</xsl:when> + <xsl:when test="starts-with(@type,'text/plain') or @type='example' or @type='code' or @type='application/xml-dtd' or @type='application/json'">text</xsl:when> + <xsl:otherwise/> + </xsl:choose> + <xsl:if test="@x:lang and $prettyprint-class!=''"> + <xsl:value-of select="concat(' ',$prettyprint-class)"/> + <xsl:if test="@x:lang!=''"> + <xsl:value-of select="concat(' lang-',@x:lang)"/> + </xsl:if> + </xsl:if> + </xsl:variable> + <xsl:if test="normalize-space($v)!=''"> + <xsl:attribute name="class"><xsl:value-of select="normalize-space($v)"/></xsl:attribute> + </xsl:if> +</xsl:template> + +<xsl:template name="insert-begin-code"> + <xsl:if test="@x:is-code-component='yes'"> + <pre class="ccmarker cct"><span><CODE BEGINS></span></pre> + </xsl:if> +</xsl:template> + +<xsl:template name="insert-end-code"> + <xsl:if test="@x:is-code-component='yes'"> + <pre class="ccmarker ccb"><span><CODE ENDS></span></pre> + </xsl:if> +</xsl:template> + +<xsl:template match="artwork|sourcecode"> + <xsl:if test="not(ancestor::ed:del) and $xml2rfc-ext-parse-xml-in-artwork='yes' and function-available('myns:parseXml')" use-when="function-available('myns:parseXml')"> + <xsl:if test="contains(.,'<?xml')"> + <xsl:variable name="body" select="substring-after(substring-after(.,'<?xml'),'?>')" /> + <xsl:if test="$body!='' and myns:parseXml($body)!=''"> + <table style="background-color: red; border-width: thin; border-style: solid; border-color: black;"> + <tr><td> + XML PARSE ERROR; parsed the body below: + <pre> + <xsl:value-of select="$body"/> + </pre> + resulting in: + <pre> + <xsl:value-of select="myns:parseXml($body)" /> + </pre> + </td></tr></table> + </xsl:if> + </xsl:if> + <xsl:if test="@ed:parse-xml-after"> + <xsl:if test="myns:parseXml(string(.))!=''"> + <table style="background-color: red; border-width: thin; border-style: solid; border-color: black;"> + <tr><td> + XML PARSE ERROR: + <pre><xsl:value-of select="myns:parseXml(string(.))" /></pre> + </td></tr></table> + </xsl:if> + </xsl:if> + </xsl:if> + <xsl:if test="contains(.,'	')"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'artwork contains HTAB character'"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:if> + <xsl:variable name="display"> + <xsl:choose> + <xsl:when test="$xml2rfc-ext-allow-markup-in-artwork='yes'"> + <xsl:apply-templates/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="@align='right'"> + <div style="display:table; margin-left: auto; margin-right: 0em;"> + <xsl:call-template name="insert-begin-code"/> + <pre style="margin-left: 0em;"> + <xsl:call-template name="add-artwork-class"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:copy-of select="$display"/> + </pre> + <xsl:call-template name="insert-end-code"/> + </div> + </xsl:when> + <xsl:when test="@align='center'"> + <div style="display:table; margin-left: auto; margin-right: auto;"> + <xsl:call-template name="insert-begin-code"/> + <pre style="margin-left: 0em;"> + <xsl:call-template name="add-artwork-class"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:copy-of select="$display"/> + </pre> + <xsl:call-template name="insert-end-code"/> + </div> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="insert-begin-code"/> + <pre> + <xsl:call-template name="add-artwork-class"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:copy-of select="$display"/> + </pre> + <xsl:call-template name="insert-end-code"/> + </xsl:otherwise> + </xsl:choose> + <xsl:call-template name="check-artwork-width"> + <xsl:with-param name="content"><xsl:apply-templates/></xsl:with-param> + <xsl:with-param name="indent"><xsl:value-of select="string-length(@x:indent-with)"/></xsl:with-param> + </xsl:call-template> +</xsl:template> + + +<xsl:template match="artwork/text()[1]"> + <xsl:choose> + <xsl:when test="starts-with(.,'
')"> +  + <xsl:value-of select="substring(.,2)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template name="check-artwork-width"> + <xsl:param name="content"/> + <xsl:param name="indent"/> + <xsl:choose> + <xsl:when test="$xml2rfc-ext-check-artwork-width='no'"> +  + </xsl:when> + <xsl:when test="not(contains($content,'
'))"> + <xsl:if test="string-length($content) > 69 + number($indent)"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="start" select="substring-before($content,'
')"/> + <xsl:variable name="end" select="substring-after($content,'
')"/> + <xsl:variable name="max"> + <xsl:choose> + <xsl:when test="$indent!=''"><xsl:value-of select="69 + $indent"/></xsl:when> + <xsl:otherwise>69</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="string-length($start) > $max"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="check-artwork-width"> + <xsl:with-param name="content" select="$end"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="artwork[@src and starts-with(@type,'image/') or @type='svg']|artwork[svg:svg]"> + <xsl:variable name="class"> + <xsl:value-of select="$css-artwork"/> + <xsl:text> </xsl:text> + <xsl:if test="svg:svg"> + <xsl:value-of select="$css-art-svg"/> + </xsl:if> + <xsl:choose> + <xsl:when test="@align='center'"><xsl:text> </xsl:text><xsl:value-of select="$css-center"/></xsl:when> + <xsl:when test="@align='right'"><xsl:text> </xsl:text><xsl:value-of select="$css-right"/></xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + <div class="{normalize-space($class)}"> + <xsl:choose> + <xsl:when test="svg:svg"> + <xsl:copy-of select="svg:svg"/> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="alt"> + <xsl:choose> + <xsl:when test="@alt!=''"> + <xsl:value-of select="@alt"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <img src="{@src}"> + <xsl:if test="normalize-space($alt)!=''"> + <xsl:attribute name="alt"><xsl:value-of select="$alt"/></xsl:attribute> + </xsl:if> + <xsl:if test="@width and @width!=''"> + <xsl:copy-of select="@width"/> + </xsl:if> + <xsl:if test="@height and @height!=''"> + <xsl:copy-of select="@height"/> + </xsl:if> + </img> + </xsl:otherwise> + </xsl:choose> + </div> +</xsl:template> + +<xsl:template match="author|x:contributor"> + <xsl:call-template name="check-no-text-content"/> + + <address> + <xsl:call-template name="emit-author"/> + + <xsl:if test="@asciiFullname!='' or organization/@ascii!='' or postal/*/@ascii"> + <br/><br/> + <em>Additional contact information:</em> + <br/> + <xsl:call-template name="emit-author"> + <xsl:with-param name="ascii" select="false()"/> + </xsl:call-template> + </xsl:if> + </address> +</xsl:template> + +<xsl:template name="emit-author"> + <xsl:param name="ascii" select="true()"/> + <b> + <xsl:choose> + <xsl:when test="@asciiFullname!='' and $ascii"> + <xsl:value-of select="@asciiFullname" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@fullname" /> + </xsl:otherwise> + </xsl:choose> + </b> + <xsl:if test="@role"> + <xsl:text> (</xsl:text> + <xsl:value-of select="@role" /> + <xsl:text>)</xsl:text> + </xsl:if> +  + <xsl:if test="@x:annotation"> + <xsl:text> </xsl:text> + <i><xsl:value-of select="@x:annotation"/></i> + </xsl:if> + + <xsl:if test="normalize-space(concat(organization,organization/@ascii)) != ''"> + <br/> + <xsl:choose> + <xsl:when test="organization/@ascii!='' and $ascii"> + <xsl:value-of select="organization/@ascii" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="organization" /> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="address/postal"> + <xsl:for-each select="address/postal/street"> + <xsl:variable name="street"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="name" select="'street'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$street!=''"> + <br/> + <xsl:value-of select="$street"/> + </xsl:if> + </xsl:for-each> + <xsl:for-each select="address/postal/postalLine"> + <xsl:variable name="line"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="name" select="'postalLine'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$line!=''"> + <br/> + <xsl:value-of select="$line"/> + </xsl:if> + </xsl:for-each> + <xsl:if test="address/postal/city|address/postal/region|address/postal/code"> + <br/> + <xsl:variable name="city"> + <xsl:if test="address/postal/city"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/postal/city"/> + <xsl:with-param name="name" select="'address/postal/city'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:if> + </xsl:variable> + <xsl:variable name="region"> + <xsl:if test="address/postal/region"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/postal/region"/> + <xsl:with-param name="name" select="'address/postal/region'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:if> + </xsl:variable> + <xsl:variable name="code"> + <xsl:if test="address/postal/code"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/postal/code"/> + <xsl:with-param name="name" select="'address/postal/code'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:if> + </xsl:variable> + + <xsl:if test="$city!=''"> + <xsl:value-of select="$city"/> + </xsl:if> + + <xsl:variable name="region-and-code"> + <xsl:value-of select="$region"/> + <xsl:if test="$region!='' and $code!=''"> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:value-of select="$code"/> + </xsl:variable> + + <xsl:if test="$region-and-code!=''"> + <xsl:if test="$city!=''"> + <xsl:text>, </xsl:text> + </xsl:if> + <xsl:value-of select="$region-and-code"/> + </xsl:if> + </xsl:if> + <xsl:if test="address/postal/country"> + <xsl:variable name="country"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/postal/country"/> + <xsl:with-param name="name" select="'address/postal/country'"/> + <xsl:with-param name="ascii" select="$ascii"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$country!=''"> + <br/> + <xsl:value-of select="$country"/> + </xsl:if> + </xsl:if> + </xsl:if> + <xsl:if test="address/phone"> + <xsl:variable name="phone"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/phone"/> + <xsl:with-param name="name" select="'address/phone'"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$phone!=''"> + <br/> + <xsl:text>Phone: </xsl:text> + <a href="tel:{translate($phone,' ','')}"><xsl:value-of select="$phone" /></a> + </xsl:if> + </xsl:if> + <xsl:if test="address/facsimile"> + <xsl:variable name="facsimile"> + <xsl:call-template name="extract-normalized"> + <xsl:with-param name="node" select="address/facsimile"/> + <xsl:with-param name="name" select="'address/facsimile'"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$facsimile!=''"> + <br/> + <xsl:text>Fax: </xsl:text> + <a href="fax:{translate($facsimile,' ','')}"><xsl:value-of select="$facsimile" /></a> + </xsl:if> + </xsl:if> + <xsl:for-each select="address/email"> + <xsl:variable name="email"> + <xsl:call-template name="extract-email"/> + </xsl:variable> + + <br/> + <xsl:choose> + <xsl:when test="$xml2rfc-rfcedstyle='yes'">Email: </xsl:when> + <xsl:otherwise>EMail: </xsl:otherwise> + </xsl:choose> + <xsl:choose> + <xsl:when test="$xml2rfc-linkmailto!='no'"> + <a href="mailto:{$email}"><xsl:value-of select="$email" /></a> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$email" /> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + <xsl:for-each select="address/uri"> + <xsl:variable name="uri"> + <xsl:call-template name="extract-uri"/> + </xsl:variable> + <xsl:if test="$uri!=''"> + <br/> + <xsl:text>URI: </xsl:text> + <a href="{$uri}"><xsl:value-of select="$uri" /></a> + <xsl:if test="@x:annotation"> + <xsl:text> </xsl:text> + <i><xsl:value-of select="@x:annotation"/></i> + </xsl:if> + </xsl:if> + </xsl:for-each> +</xsl:template> + + +<xsl:template name="back"> + <xsl:call-template name="check-no-text-content"/> + +  + <xsl:if test="//cref and $xml2rfc-comments='yes' and $xml2rfc-inline!='yes'"> + <xsl:call-template name="insertComments" /> + </xsl:if> + +  + <xsl:if test="$xml2rfc-ext-authors-section='before-appendices'"> + <xsl:call-template name="insertAuthors" /> + </xsl:if> + +  + <xsl:apply-templates select="back/*[not(self::references) and not(self::ed:replace and .//references)]" /> + +  +  + <xsl:if test="$has-index"> + <xsl:call-template name="insertIndex" /> + </xsl:if> + +  + <xsl:if test="$xml2rfc-ext-authors-section='end'"> + <xsl:call-template name="insertAuthors" /> + </xsl:if> + + <xsl:if test="$xml2rfc-private=''"> +  + <xsl:variable name="copyright"> + <xsl:call-template name="insertCopyright" /> + </xsl:variable> + +  + <xsl:choose> + <xsl:when test="function-available('exslt:node-set')"> + <xsl:apply-templates select="exslt:node-set($copyright)" /> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="$node-set-warning"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + +</xsl:template> + +<xsl:template match="eref[node()]"> + <a href="{@target}"><xsl:apply-templates /></a> +</xsl:template> + +<xsl:template match="eref[not(node())]"> + <xsl:text><</xsl:text> + <a href="{@target}"><xsl:value-of select="@target" /></a> + <xsl:text>></xsl:text> +</xsl:template> + +<xsl:template match="figure"> + <xsl:call-template name="check-no-text-content"/> +  + <xsl:for-each select="@*[local-name()!='title' and local-name()!='suppress-title' and local-name()!='anchor' and local-name()!='pn' and normalize-space(.)!='']"> + <xsl:if test="local-name(.)!='align' or normalize-space(.)!='left'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('unsupported attribute ',local-name(.),' on figure element')"/> + </xsl:call-template> + </xsl:if> + </xsl:for-each> + <xsl:variable name="anch-container"> + <xsl:choose> + <xsl:when test="ancestor::t">span</xsl:when> + <xsl:otherwise>div</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="@anchor!=''"> + <xsl:call-template name="check-anchor"/> + <xsl:element name="{$anch-container}"> + <xsl:attribute name="id"><xsl:value-of select="@anchor"/></xsl:attribute> + </xsl:element> + </xsl:if> + <xsl:variable name="anch"> + <xsl:call-template name="get-figure-anchor"/> + </xsl:variable> + <xsl:element name="{$anch-container}"> + <xsl:attribute name="id"><xsl:value-of select="$anch"/></xsl:attribute> + <xsl:apply-templates select="*[not(self::name)]"/> + </xsl:element> + <xsl:if test="(@title!='' or name) or (@anchor!='' and not(@suppress-title='true'))"> + <xsl:variable name="n"><xsl:call-template name="get-figure-number"/></xsl:variable> + <p class="figure"> + <xsl:if test="not(starts-with($n,'u'))"> + <xsl:text>Figure </xsl:text> + <xsl:value-of select="$n"/> + <xsl:if test="@title!='' or name">: </xsl:if> + </xsl:if> + <xsl:call-template name="insertTitle"/> + </p> + </xsl:if> +</xsl:template> + +<xsl:variable name="all-notes" select="/rfc/front/note"/> +<xsl:variable name="all-edited-notes" select="/rfc/front/ed:replace[.//note]"/> +<xsl:variable name="notes-not-in-boilerplate" select="$all-notes[@title!='IESG Note' or $xml2rfc-private!='' or $notes-follow-abstract]"/> +<xsl:variable name="edited-notes-not-in-boilerplate" select="$all-edited-notes[.//note/@title!='IESG Note' or $xml2rfc-private!='' or $notes-follow-abstract]"/> +<xsl:variable name="notes-in-boilerplate" select="$all-notes[not(@title!='IESG Note' or $xml2rfc-private!='' or $notes-follow-abstract)]"/> +<xsl:variable name="edited-notes-in-boilerplate" select="$all-edited-notes[not(.//note/@title!='IESG Note' or $xml2rfc-private!='' or $notes-follow-abstract)]"/> + +<xsl:template match="front"> + <xsl:call-template name="check-no-text-content"/> + <header> + <xsl:if test="$xml2rfc-topblock!='no'"> +  + <xsl:variable name="leftColumn"> + <xsl:call-template name="collectLeftHeaderColumn" /> + </xsl:variable> +  + <xsl:variable name="rightColumn"> + <xsl:call-template name="collectRightHeaderColumn" /> + </xsl:variable> +  + <table class="{$css-header}" id="{$anchor-pref}headerblock"> + <xsl:choose> + <xsl:when test="function-available('exslt:node-set')"> + <xsl:call-template name="emitheader"> + <xsl:with-param name="lc" select="exslt:node-set($leftColumn)" /> + <xsl:with-param name="rc" select="exslt:node-set($rightColumn)" /> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="$node-set-warning"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </table> + </xsl:if> + + <div id="{$anchor-pref}title"> +  + <h1><xsl:apply-templates select="title"/></h1> + <xsl:if test="/rfc/@docName"> + <xsl:variable name="docname" select="/rfc/@docName"/> + <xsl:choose> + <xsl:when test="$rfcno!=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' is ignored because an RFC number is specified as well.</xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <div class="filename"><xsl:value-of select="$docname"/></div> + </xsl:otherwise> + </xsl:choose> + + <xsl:variable name="docname-noext"> + <xsl:choose> + <xsl:when test="contains($docname,'.')"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + <xsl:value-of select="substring-before($docname,'.')"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$docname"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + +  + <xsl:variable name="offending" select="translate($docname,concat($lcase,$digits,'-.'),'')"/> + <xsl:if test="$offending != ''"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + + <xsl:if test="contains($docname,'--')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should not contain the character sequence '--'.</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:if test="not(starts-with($docname,'draft-'))"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">The @docName attribute '<xsl:value-of select="$docname"/>' should start with 'draft-'.</xsl:with-param> + </xsl:call-template> + </xsl:if> + +  + <xsl:variable name="seq"> + <xsl:choose> + <xsl:when test="substring($docname-noext,string-length($docname-noext) + 1 - string-length('-latest'))='-latest'">latest</xsl:when> + <xsl:when test="substring($docname-noext,string-length($docname-noext) - 2, 1)='-'"><xsl:value-of select="substring($docname-noext,string-length($docname-noext)-1)"/></xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + + <xsl:if test="$seq='' or ($seq!='latest' and translate($seq,$digits,'')!='')"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + + <xsl:if test="string-length($docname)-string-length($seq) > 50"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + + </xsl:if> + </div> + </header> + +  + <xsl:if test="$published-as-rfc"> + <p class="{$css-publishedasrfc}"> + <b>Note:</b> a later version of this document has been published as <a href="{$published-as-rfc/@href}"><xsl:value-of select="$published-as-rfc/@title"/></a>. + </p> + </xsl:if> + +  + <xsl:choose> + <xsl:when test="not(/rfc/@ipr)"> + <xsl:if test="not(/rfc/@number) and $xml2rfc-private=''"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Either /rfc/@ipr or /rfc/@number is required</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:when test="/rfc/@ipr = 'full2026'" /> + <xsl:when test="/rfc/@ipr = 'noDerivativeWorks'" /> + <xsl:when test="/rfc/@ipr = 'noDerivativeWorksNow'" /> + <xsl:when test="/rfc/@ipr = 'none'" /> + <xsl:when test="/rfc/@ipr = 'full3667'" /> + <xsl:when test="/rfc/@ipr = 'noModification3667'" /> + <xsl:when test="/rfc/@ipr = 'noDerivatives3667'" /> + <xsl:when test="/rfc/@ipr = 'full3978'" /> + <xsl:when test="/rfc/@ipr = 'noModification3978'" /> + <xsl:when test="/rfc/@ipr = 'noDerivatives3978'" /> + <xsl:when test="/rfc/@ipr = 'trust200811'" /> + <xsl:when test="/rfc/@ipr = 'noModificationTrust200811'" /> + <xsl:when test="/rfc/@ipr = 'noDerivativesTrust200811'" /> + <xsl:when test="/rfc/@ipr = 'trust200902'" /> + <xsl:when test="/rfc/@ipr = 'noModificationTrust200902'" /> + <xsl:when test="/rfc/@ipr = 'noDerivativesTrust200902'" /> + <xsl:when test="/rfc/@ipr = 'pre5378Trust200902'" /> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unknown value for /rfc/@ipr: ', /rfc/@ipr)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="'boilerplate'"/> + </xsl:call-template> + + <xsl:if test="not($abstract-first)"> + <xsl:if test="$xml2rfc-private=''"> + <xsl:call-template name="emit-ietf-preamble"> + <xsl:with-param name="notes" select="$notes-in-boilerplate|$edited-notes-in-boilerplate"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:apply-templates select="abstract" /> + <xsl:if test="$notes-follow-abstract"> + <xsl:apply-templates select="$notes-not-in-boilerplate|$edited-notes-not-in-boilerplate" /> + </xsl:if> + + <xsl:if test="$abstract-first"> + <xsl:if test="$xml2rfc-private=''"> + <xsl:call-template name="emit-ietf-preamble"> + <xsl:with-param name="notes" select="$notes-in-boilerplate|$edited-notes-in-boilerplate"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:if test="not($notes-follow-abstract)"> + <xsl:apply-templates select="$notes-not-in-boilerplate|$edited-notes-not-in-boilerplate" /> + </xsl:if> + + <xsl:if test="$xml2rfc-toc='yes'"> + <xsl:apply-templates select="/" mode="toc" /> + <xsl:call-template name="insertTocAppendix" /> + </xsl:if> + +</xsl:template> + +<xsl:template name="emit-ietf-preamble"> + <xsl:param name="notes"/> + +  + <xsl:variable name="preamble"> + <xsl:for-each select="/rfc"> + <xsl:call-template name="insertPreamble"> + <xsl:with-param name="notes" select="$notes"/> + </xsl:call-template> + </xsl:for-each> + </xsl:variable> + +  + <xsl:variable name="userboiler" select="/rfc/front/boilerplate"/> + +  + <xsl:choose> + <xsl:when test="function-available('exslt:node-set')"> + <xsl:variable name="differ" select="$userboiler and translate(normalize-space(string($userboiler)),' ','')!=translate(normalize-space(string($preamble)),' ','')"/> +  + <xsl:apply-templates select="exslt:node-set($preamble)" /> + <xsl:if test="$differ"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'user-supplied boilerplate differs from auto-generated boilerplate (inserting auto-generated)'"/> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="$node-set-warning"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="iref"> + <xsl:variable name="anchor"><xsl:call-template name="compute-iref-anchor"/></xsl:variable> + <xsl:choose> + <xsl:when test="parent::figure"> + <div id="{$anchor}"/> + </xsl:when> + <xsl:when test="ancestor::t or ancestor::artwork or ancestor::preamble or ancestor::postamble"> + <span id="{$anchor}"/> + </xsl:when> + <xsl:otherwise> + <div id="{$anchor}"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="compute-iref-anchor"> + <xsl:variable name="first" select="translate(substring(@item,1,1),$ucase,$lcase)"/> + <xsl:variable name="nkey" select="translate($first,$alnum,'')"/> + <xsl:choose> + <xsl:when test="count(.|$section-level-irefs)=count($section-level-irefs)"> + <xsl:for-each select=".."> + <xsl:value-of select="$anchor-pref"/>section.<xsl:call-template name="get-section-number"/> + </xsl:for-each> + </xsl:when> + <xsl:when test="$nkey=''"> + <xsl:value-of select="$anchor-pref"/>iref.<xsl:value-of select="$first"/>.<xsl:number level="any" count="iref[starts-with(translate(@item,$ucase,$lcase),$first) and count(.|$section-level-irefs)!=count($section-level-irefs)]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$anchor-pref"/>iref.<xsl:number level="any" count="iref[translate(substring(@item,1,1),$alnum,'')!='' and count(.|$section-level-irefs)!=count($section-level-irefs)]"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="compute-extref-anchor"> + <xsl:variable name="first" select="translate(substring(.,1,1),$ucase,$lcase)"/> + <xsl:variable name="nkey" select="translate($first,$lcase,'')"/> + <xsl:choose> + <xsl:when test="$nkey=''"> + <xsl:value-of select="$anchor-pref"/>extref.<xsl:value-of select="$first"/>.<xsl:number level="any" count="x:ref[starts-with(translate(.,$ucase,$lcase),$first)]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$anchor-pref"/>extref.<xsl:number level="any" count="x:ref[translate(substring(.,1,1),concat($lcase,$ucase),'')='']"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + +<xsl:template name="list-empty"> + <ul class="empty"> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </ul> +</xsl:template> + +<xsl:template name="list-format"> + <dl> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </dl> +</xsl:template> + +<xsl:template name="list-hanging"> + <xsl:variable name="compact"> + <xsl:call-template name="get-compact-setting"/> + </xsl:variable> +  + <xsl:if test="ancestor::list and normalize-space(preceding-sibling::text())=''"> + <xsl:text> </xsl:text> + </xsl:if> + <dl> + <xsl:if test="$compact='yes'"> + <xsl:attribute name="class">compact</xsl:attribute> + </xsl:if> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </dl> +</xsl:template> + +<xsl:template name="list-numbers"> + <ol> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </ol> +</xsl:template> + +<xsl:template name="check-no-hangindent"> + <xsl:if test="@hangIndent"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="'hangIndent attribute not supported for this list style'"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template name="list-letters"> + <xsl:variable name="style"> + <xsl:choose> +  + <xsl:when test="0=(count(ancestor::list[@style='letters']) mod 2)">la</xsl:when> +  + <xsl:otherwise>ua</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <ol class="{$style}"> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </ol> +</xsl:template> + +<xsl:template name="list-symbols"> + <ul> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:apply-templates /> + </ul> +</xsl:template> + +<xsl:template match="list"> + <xsl:variable name="style" select="ancestor-or-self::list[@style][1]/@style"/> + <xsl:call-template name="check-no-text-content"/> + <xsl:choose> + <xsl:when test="not($style) or $style='empty'"> + <xsl:call-template name="check-no-hangindent"/> + <xsl:call-template name="list-empty"/> + </xsl:when> + <xsl:when test="starts-with($style, 'format ')"> + <xsl:call-template name="list-format"/> + </xsl:when> + <xsl:when test="$style='hanging'"> + <xsl:call-template name="list-hanging"/> + </xsl:when> + <xsl:when test="$style='letters'"> + <xsl:call-template name="check-no-hangindent"/> + <xsl:call-template name="list-letters"/> + </xsl:when> + <xsl:when test="$style='numbers'"> + <xsl:call-template name="check-no-hangindent"/> + <xsl:call-template name="list-numbers"/> + </xsl:when> + <xsl:when test="$style='symbols'"> + <xsl:call-template name="check-no-hangindent"/> + <xsl:call-template name="list-symbols"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported style attribute: ', $style)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + +<xsl:template match="ol[string-length(@type)>1]"> + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + <xsl:variable name="start"> + <xsl:choose> + <xsl:when test="@group"> + <xsl:call-template name="ol-start"> + <xsl:with-param name="node" select="."/> + </xsl:call-template> + </xsl:when> + <xsl:when test="@start"> + <xsl:value-of select="@start"/> + </xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="$p!='' and not(ancestor::list) and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <div id="{$anchor-pref}section.{$p}"> + <dl> + <xsl:call-template name="copy-anchor"/> + <xsl:for-each select="li"> + <xsl:variable name="label"> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="../@type"/> + <xsl:with-param name="pos" select="$start - 1 + position()"/> + </xsl:call-template> + </xsl:variable> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:value-of select="$label"/> + </dt> + <dd> + <xsl:apply-templates/> + </dd> + </xsl:for-each> + </dl> + </div> + </xsl:when> + <xsl:otherwise> + <dl> + <xsl:call-template name="copy-anchor"/> + <xsl:for-each select="li"> + <xsl:variable name="label"> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="../@type"/> + <xsl:with-param name="pos" select="$start - 1 + position()"/> + </xsl:call-template> + </xsl:variable> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:value-of select="$label"/> + </dt> + <dd> + <xsl:apply-templates/> + </dd> + </xsl:for-each> + </dl> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="dl"> + <xsl:variable name="hang" select="@hanging"/> + <xsl:variable name="spac" select="@spacing"/> + <xsl:variable name="class"> + <xsl:if test="$spac='compact'">compact </xsl:if> + <xsl:if test="$hang='false'">nohang </xsl:if> + </xsl:variable> + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + <div> + <xsl:if test="$p!='' and not(ancestor::list) and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="concat($anchor-pref,'section.',$p)"/></xsl:attribute> + </xsl:if> + <dl> + <xsl:call-template name="copy-anchor"/> + <xsl:if test="normalize-space($class)!=''"> + <xsl:attribute name="class"><xsl:value-of select="normalize-space($class)"/></xsl:attribute> + </xsl:if> + <xsl:for-each select="dt"> + <xsl:apply-templates select="."/> + <xsl:apply-templates select="following-sibling::dd[1]"/> + </xsl:for-each> + </dl> + </div> +</xsl:template> + +<xsl:template match="dt"> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </dt> +</xsl:template> + +<xsl:template match="dd"> + <dd> + <xsl:variable name="block-level-children" select="t | dl"/> + <xsl:choose> + <xsl:when test="$block-level-children"> +  + <xsl:for-each select="$block-level-children"> + <xsl:choose> + <xsl:when test="self::t"> + <p> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </p> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="."/> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </dd> +</xsl:template> + + +<xsl:template name="get-compact-setting"> + <xsl:variable name="t1"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="preceding::processing-instruction('rfc')"/> + <xsl:with-param name="attr" select="'subcompact'"/> + <xsl:with-param name="default" select="'?'"/> + <xsl:with-param name="duplicate-warning" select="'no'"/> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="$t1='?'"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="preceding::processing-instruction('rfc')"/> + <xsl:with-param name="attr" select="'compact'"/> + <xsl:with-param name="default" select="'?'"/> + <xsl:with-param name="duplicate-warning" select="'no'"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$t1"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="ol-start"> + <xsl:param name="node"/> + <xsl:variable name="group" select="$node/@group"/> + <xsl:variable name="prec" select="$node/preceding::ol[@group=$group]"/> + <xsl:choose> + <xsl:when test="$node/@start"> + <xsl:value-of select="$node/@start"/> + </xsl:when> + <xsl:when test="$prec"> + <xsl:variable name="s"> + <xsl:call-template name="ol-start"> + <xsl:with-param name="node" select="$prec[last()]"/> + </xsl:call-template> + </xsl:variable> + <xsl:value-of select="$s + count($prec[last()]/li)"/> + </xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="ol[not(@type) or string-length(@type)=1]"> + <xsl:call-template name="check-no-text-content"/> + + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + <xsl:variable name="start"> + <xsl:choose> + <xsl:when test="@group"> + <xsl:call-template name="ol-start"> + <xsl:with-param name="node" select="."/> + </xsl:call-template> + </xsl:when> + <xsl:when test="@start"> + <xsl:value-of select="@start"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + <div> + <xsl:if test="$p!='' and not(ancestor::list) and not(ancestor::ul) and not(ancestor::dl) and not(ancestor::ol) and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="concat($anchor-pref,'section.',$p)"/></xsl:attribute> + </xsl:if> + <ol> + <xsl:if test="$start!=''"> + <xsl:attribute name="start"><xsl:value-of select="$start"/></xsl:attribute> + </xsl:if> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:copy-of select="@type"/> + <xsl:apply-templates /> + </ol> + </div> +</xsl:template> + +<xsl:template match="ul"> + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + <div> + <xsl:call-template name="insertInsDelClass"/> + <xsl:if test="$p!='' and not(ancestor::list) and not(ancestor::ul) and not(ancestor::dl) and not(ancestor::ol) and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="concat($anchor-pref,'section.',$p)"/></xsl:attribute> + </xsl:if> + <ul> + <xsl:call-template name="copy-anchor"/> + <xsl:if test="@empty='true'"> + <xsl:attribute name="class">empty</xsl:attribute> + </xsl:if> + <xsl:apply-templates /> + </ul> + </div> +</xsl:template> + +<xsl:template match="li"> + <li> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates /> + <xsl:if test="not(following-sibling::li)"> + <xsl:variable name="l"> + <xsl:for-each select=".."> + <xsl:call-template name="get-paragraph-number"/> + </xsl:for-each> + </xsl:variable> + <xsl:if test="$l!=''"> + <a class='self' href='#{$anchor-pref}section.{$l}'>¶</a> + </xsl:if> + </xsl:if> + </li> +</xsl:template> + + + +<xsl:template name="list-item-generic"> + <li> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:for-each select="../.."> + <xsl:call-template name="insert-issue-pointer"/> + </xsl:for-each> + <xsl:apply-templates /> + </li> +</xsl:template> + +<xsl:template name="list-item-hanging"> + <xsl:if test="@hangText!=''"> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:if test="count(preceding-sibling::t)=0"> + <xsl:variable name="del-node" select="ancestor::ed:del"/> + <xsl:variable name="rep-node" select="ancestor::ed:replace"/> + <xsl:variable name="deleted" select="$del-node and ($rep-node/ed:ins)"/> + <xsl:for-each select="../.."> + <xsl:call-template name="insert-issue-pointer"> + <xsl:with-param name="deleted-anchor" select="$deleted"/> + </xsl:call-template> + </xsl:for-each> + </xsl:if> + <xsl:value-of select="@hangText" /> + </dt> + </xsl:if> + + <xsl:variable name="dd-content"> + <xsl:apply-templates/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$dd-content!=''"> + <dd> + <xsl:call-template name="insertInsDelClass"/> +  + <xsl:if test="../@hangIndent"> + <xsl:attribute name="style">margin-left: <xsl:value-of select="format-number(../@hangIndent * 0.7,'#.#')"/>em</xsl:attribute> + </xsl:if> + <xsl:apply-templates /> + </dd> + </xsl:when> + <xsl:otherwise> + <dd> </dd> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="list-item-format"> + <xsl:variable name="list" select=".." /> + <xsl:variable name="format" select="substring-after(../@style,'format ')" /> + <xsl:variable name="pos"> + <xsl:choose> + <xsl:when test="$list/@counter"> + <xsl:number level="any" count="list[@counter=$list/@counter or (not(@counter) and @style=concat('format ',$list/@counter))]/t" /> + </xsl:when> + <xsl:otherwise> + <xsl:number level="any" count="list[concat('format ',@counter)=$list/@style or (not(@counter) and @style=$list/@style)]/t" /> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="$format"/> + <xsl:with-param name="pos" select="$pos"/> + </xsl:call-template> + </dt> + <dd> + <xsl:apply-templates/> + </dd> +</xsl:template> + +<xsl:template match="list/t | list/ed:replace/ed:*/t"> + <xsl:variable name="style" select="ancestor::list[@style][1]/@style"/> + <xsl:choose> + <xsl:when test="not($style) or $style='empty' or $style='letters' or $style='numbers' or $style='symbols'"> + <xsl:if test="@hangText"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="'t/@hangText used on unstyled list'"/> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="list-item-generic"/> + </xsl:when> + <xsl:when test="starts-with($style, 'format ')"> + <xsl:call-template name="list-item-format"/> + </xsl:when> + <xsl:when test="$style='hanging'"> + <xsl:call-template name="list-item-hanging"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported style attribute: ', $style)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="list-lt-generic"> + <li> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="t" /> + </li> +</xsl:template> + +<xsl:template name="list-lt-format"> + <xsl:variable name="list" select=".." /> + <xsl:variable name="format" select="substring-after(../@style,'format ')" /> + <xsl:variable name="pos"> + <xsl:choose> + <xsl:when test="$list/@counter"> + <xsl:number level="any" count="list[@counter=$list/@counter or (not(@counter) and @style=concat('format ',$list/@counter))]/t" /> + </xsl:when> + <xsl:otherwise> + <xsl:number level="any" count="list[concat('format ',@counter)=$list/@style or (not(@counter) and @style=$list/@style)]/t" /> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="$format"/> + <xsl:with-param name="pos" select="$pos"/> + </xsl:call-template> + </dt> + <dd> + <xsl:apply-templates select="t" /> + </dd> +</xsl:template> + +<xsl:template name="list-lt-hanging"> + <xsl:if test="@hangText!=''"> + <dt> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:variable name="del-node" select="ancestor::ed:del"/> + <xsl:variable name="rep-node" select="ancestor::ed:replace"/> + <xsl:variable name="deleted" select="$del-node and ($rep-node/ed:ins)"/> + <xsl:for-each select="../.."> + <xsl:call-template name="insert-issue-pointer"> + <xsl:with-param name="deleted-anchor" select="$deleted"/> + </xsl:call-template> + </xsl:for-each> + <xsl:value-of select="@hangText" /> + </dt> + </xsl:if> + <dd> + <xsl:call-template name="insertInsDelClass"/> +  + <xsl:if test="../@hangIndent"> + <xsl:attribute name="style">margin-left: <xsl:value-of select="format-number(../@hangIndent * 0.7,'#.#')"/>em</xsl:attribute> + </xsl:if> + <xsl:apply-templates select="t" /> + </dd> +</xsl:template> + +<xsl:template match="list/x:lt"> + <xsl:variable name="style" select="ancestor::list[@style][1]/@style"/> + <xsl:choose> + <xsl:when test="$style='letters' or $style='numbers' or $style='symbols'"> + <xsl:call-template name="list-lt-generic"/> + </xsl:when> + <xsl:when test="starts-with($style, 'format ')"> + <xsl:call-template name="list-lt-format"/> + </xsl:when> + <xsl:when test="$style='hanging'"> + <xsl:call-template name="list-lt-hanging"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported style attribute: ', $style)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="expand-format-percent"> + <xsl:param name="format"/> + <xsl:param name="pos"/> + + <xsl:choose> + <xsl:when test="$format=''"></xsl:when> + <xsl:when test="substring($format,1,1)!='%' or string-length($format)=1"> + <xsl:value-of select="substring($format,1,1)"/> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="substring($format,2)"/> + <xsl:with-param name="pos" select="$pos"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="f" select="substring($format,2,1)"/> + <xsl:choose> + <xsl:when test="$f='%'">%</xsl:when> + <xsl:when test="$f='c'"><xsl:number value="$pos" format="a"/></xsl:when> + <xsl:when test="$f='C'"><xsl:number value="$pos" format="A"/></xsl:when> + <xsl:when test="$f='d'"><xsl:number value="$pos"/></xsl:when> + <xsl:when test="$f='i'"><xsl:number value="$pos" format="i"/></xsl:when> + <xsl:when test="$f='I'"><xsl:number value="$pos" format="I"/></xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported % format: ', $f)"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="substring($format,3)"/> + <xsl:with-param name="pos" select="$pos"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template match="middle"> + <xsl:apply-templates /> + <xsl:apply-templates select="../back//references"/> +</xsl:template> + +<xsl:template match="note"> + <xsl:call-template name="check-no-text-content"/> + <xsl:variable name="classes"> + <xsl:text>note</xsl:text> + <xsl:text> </xsl:text> + <xsl:if test="@removeInRFC='true'">rfcEditorRemove</xsl:if> + </xsl:variable> + <xsl:variable name="num"><xsl:number/></xsl:variable> + <section id="{$anchor-pref}note.{$num}" class="{normalize-space($classes)}"> + <h2> + <xsl:call-template name="insertInsDelClass"/> + <a href="#{$anchor-pref}note.{$num}"> + <xsl:call-template name="insertTitle" /> + </a> + </h2> + <xsl:if test="@removeInRFC='true' and t[1]!=$note-removeInRFC"> + <xsl:variable name="t"> + <t><xsl:value-of select="$note-removeInRFC"/></t> + </xsl:variable> + <xsl:variable name="link" select="concat($anchor-pref,'note.',$num,'.p.1')"/> + <div id="{$link}"> + <xsl:apply-templates mode="t-content" select="exslt:node-set($t)//text()"> + <xsl:with-param name="inherited-self-link" select="$link"/> + </xsl:apply-templates> + </div> + </xsl:if> + <xsl:apply-templates /> + </section> +</xsl:template> + +<xsl:template match="postamble"> + <xsl:if test="normalize-space(.) != ''"> + <p> + <xsl:call-template name="insertInsDelClass"/> + <xsl:call-template name="editingMark" /> + <xsl:apply-templates /> + </p> + </xsl:if> +</xsl:template> + +<xsl:template match="preamble"> + <xsl:if test="normalize-space(.) != ''"> + <p> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:call-template name="editingMark" /> + <xsl:apply-templates /> + </p> + </xsl:if> +</xsl:template> + +<xsl:template name="computed-auto-target"> + <xsl:param name="bib"/> + <xsl:param name="ref"/> + + <xsl:variable name="sec"> + <xsl:choose> + <xsl:when test="$ref and starts-with($ref/@x:rel,'#') and not($ref/@x:sec) and not($ref/@section)"> + <xsl:variable name="extdoc" select="document($bib/x:source/@href)"/> + <xsl:for-each select="$extdoc//*[@anchor=substring-after($ref/@x:rel,'#')]"> + <xsl:call-template name="get-section-number"/> + </xsl:for-each> + </xsl:when> + <xsl:when test="$ref and $ref/@section"> + <xsl:value-of select="$ref/@section"/> + </xsl:when> + <xsl:when test="$ref"> + <xsl:value-of select="$ref/@x:sec"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$ref and $bib/x:source/@href and $bib/x:source/@basename and $ref/@x:rel"> + <xsl:value-of select="concat($bib/x:source/@basename,'.',$outputExtension,$ref/@x:rel)" /> + </xsl:when> + <xsl:when test="$ref and $bib/x:source/@href and $bib/x:source/@basename and $ref/@anchor"> + <xsl:value-of select="concat($bib/x:source/@basename,'.',$outputExtension,'#',$ref/@anchor)" /> + </xsl:when> +  + <xsl:when test="$bib//seriesInfo/@name='Internet-Draft' and $bib/x:source/@href and $bib/x:source/@basename and substring($bib/x:source/@basename, (string-length($bib/x:source/@basename) - string-length('-latest')) + 1)='-latest'"> + <xsl:value-of select="concat($bib/x:source/@basename,'.',$outputExtension)" /> + </xsl:when> +  + <xsl:when test="$bib//seriesInfo/@name='RFC'"> + <xsl:variable name="rfcEntries" select="$bib//seriesInfo[@name='RFC']"/> + <xsl:if test="count($rfcEntries)!=1"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('seriesInfo/@name=RFC encountered multiple times for reference ',$bib/@anchor,', will generate link to first entry only')"/> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="compute-rfc-uri"> + <xsl:with-param name="rfc" select="$rfcEntries[1]/@value"/> + </xsl:call-template> + <xsl:if test="$ref and $sec!='' and $rfcUrlFragSection and $rfcUrlFragAppendix"> + <xsl:choose> + <xsl:when test="translate(substring($sec,1,1),$ucase,'')=''"> + <xsl:value-of select="concat('#',$rfcUrlFragAppendix,$sec)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('#',$rfcUrlFragSection,$sec)"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:when> + <xsl:when test="$bib//seriesInfo/@name='Internet-Draft'"> + <xsl:call-template name="compute-internet-draft-uri"> + <xsl:with-param name="internet-draft" select="$bib//seriesInfo[@name='Internet-Draft']/@value"/> + </xsl:call-template> + <xsl:if test="$ref and $sec!='' and $internetDraftUrlFragSection and $internetDraftUrlFragAppendix"> + <xsl:choose> + <xsl:when test="translate(substring($sec,1,1),$ucase,'')=''"> + <xsl:value-of select="concat('#',$internetDraftUrlFragAppendix,$sec)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('#',$internetDraftUrlFragSection,$sec)"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:when> + <xsl:otherwise /> + </xsl:choose> +</xsl:template> + +<xsl:template name="compute-section-number"> + <xsl:param name="bib"/> + <xsl:param name="ref"/> + + <xsl:variable name="anch" select="substring-after($ref/@x:rel,'#')"/> + + <xsl:choose> + <xsl:when test="$anch=''"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Not a fragment identifier: <xsl:value-of select="$ref/@x:rel"/></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="extdoc" select="document($bib/x:source/@href)"/> + <xsl:variable name="nodes" select="$extdoc//*[@anchor=$anch]"/> + <xsl:if test="not($nodes)"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Anchor '<xsl:value-of select="$anch"/>' in <xsl:value-of select="$bib/@anchor"/> not found in source file '<xsl:value-of select="$bib/x:source/@href"/>'.</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:for-each select="$nodes"> + <xsl:call-template name="get-section-number"/> + </xsl:for-each> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="computed-target"> + <xsl:param name="bib"/> + <xsl:param name="ref"/> + + <xsl:variable name="bibtarget"> + <xsl:choose> + <xsl:when test="starts-with($bib/@target,'http://www.rfc-editor.org/info/rfc') or starts-with($bib/@target,'https://www.rfc-editor.org/info/rfc') and $ref and ($ref/@x:sec or $ref/@x:rel or $ref/@section or $ref/@relative)"> +  + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$bib/@target"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$bibtarget!=''"> + <xsl:if test="$ref and $ref/@x:sec"> + <xsl:choose> + <xsl:when test="$ref/@x:rel"> + <xsl:value-of select="concat($bib/@target,$ref/@x:rel)"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Can't generate section link for to <xsl:value-of select="$bib/@anchor"/>; no @x:rel specified</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + <xsl:if test="$ref and $ref/@section"> + <xsl:choose> + <xsl:when test="$ref/@relative"> + <xsl:value-of select="concat($bib/@target,$ref/@relative)"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Can't generate section link for to <xsl:value-of select="$bib/@anchor"/>; no @relative specified</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="computed-auto-target"> + <xsl:with-param name="bib" select="$bib"/> + <xsl:with-param name="ref" select="$ref"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="compute-doi"> + <xsl:choose> +  + <xsl:when test=".//seriesInfo[@name='BCP'] and starts-with(@anchor, 'BCP')" /> + <xsl:when test=".//seriesInfo[@name='RFC'] and not(.//organization='RFC Errata') and not(@target='http://www.rfc-editor.org' or @target='https://www.rfc-editor.org')"> + <xsl:variable name="rfc" select=".//seriesInfo[@name='RFC'][1]/@value"/> + <xsl:value-of select="concat('10.17487/RFC', format-number($rfc,'#0000'))"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:template> + + +<xsl:template match="displayreference"> + <xsl:variable name="t" select="@to"/> + <xsl:if test="//reference/@anchor=$t or count(//displayreference[@to=$t])!=1"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">displayreference <xsl:value-of select="$t"/> will create non-unique reference name.</xsl:with-param> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template name="displayname-for-author"> + <xsl:param name="not-reversed"/> + + <xsl:variable name="initials"> + <xsl:call-template name="format-initials"/> + </xsl:variable> + <xsl:variable name="truncated-initials"> + <xsl:call-template name="truncate-initials"> + <xsl:with-param name="initials" select="$initials"/> + </xsl:call-template> + </xsl:variable> + +  + <xsl:choose> + <xsl:when test="$truncated-initials='' and @surname"> + <xsl:value-of select="@surname"/> + </xsl:when> + <xsl:when test="position()=last() and position()!=1"> + <xsl:value-of select="concat($truncated-initials,' ',@surname)" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat(@surname,', ',$truncated-initials)" /> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="@asciiSurname!='' or @asciiInitials!=''"> + <xsl:text> (</xsl:text> + <xsl:variable name="i"> + <xsl:choose> + <xsl:when test="@asciiInitials!=''"> + <xsl:value-of select="@asciiInitials"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$truncated-initials"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="s"> + <xsl:choose> + <xsl:when test="@asciiSurname!=''"> + <xsl:value-of select="@asciiSurname"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@surname"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="$i=''"> + <xsl:value-of select="$s"/> + </xsl:when> + <xsl:when test="$not-reversed"> + <xsl:value-of select="concat($i,' ',$s)" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat($s,', ',$i)" /> + </xsl:otherwise> + </xsl:choose> + <xsl:text>)</xsl:text> + </xsl:if> + <xsl:if test="@role='editor'"> + <xsl:text>, Ed.</xsl:text> + </xsl:if> +</xsl:template> + +<xsl:template name="link-ref-title-to"> + <xsl:choose> + <xsl:when test="starts-with(@target,'http://www.rfc-editor.org/info/rfc') or starts-with(@target,'https://www.rfc-editor.org/info/rfc')"> + <xsl:call-template name="info"> + <xsl:with-param name="msg">Ignoring @target <xsl:value-of select="@target"/> in link calculation</xsl:with-param> + </xsl:call-template> + <xsl:call-template name="computed-auto-target"> + <xsl:with-param name="bib" select="."/> + </xsl:call-template> + </xsl:when> + <xsl:when test=".//seriesInfo/@name='RFC' and (@target='http://www.rfc-editor.org' or @target='https://www.rfc-editor.org') and starts-with(front/title,'Errata ID ') and front/author/organization='RFC Errata'"> +  + <xsl:variable name="eid" select="normalize-space(substring(front/title,string-length('Errata ID ')))"/> + <xsl:call-template name="compute-rfc-erratum-uri"> + <xsl:with-param name="eid" select="$eid"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="@target"> + <xsl:if test="normalize-space(@target)=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">invalid (empty) target attribute in reference '<xsl:value-of select="@anchor"/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="normalize-space(@target)" /> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="computed-auto-target"> + <xsl:with-param name="bib" select="."/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="reference"> + <xsl:call-template name="check-no-text-content"/> + +  + <xsl:variable name="anchor" select="@anchor"/> + <xsl:choose> + <xsl:when test="not(@anchor)"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">missing anchor on reference: <xsl:value-of select="."/></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:when test="not(ancestor::ed:del) and (ancestor::rfc and not(key('xref-item',$anchor)))"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unused reference '<xsl:value-of select="@anchor"/>'</xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:when test="not(ancestor::ed:del) and (not(ancestor::rfc) and not($src//xref[@target=$anchor]))"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unused (included) reference '<xsl:value-of select="@anchor"/>'</xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + +  + <xsl:variable name="t-r-is-normative" select="ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="r-is-normative" select="$t-r-is-normative/@x:nrm='true'"/> + <xsl:if test="$r-is-normative and not(ancestor::ed:del)"> + <xsl:variable name="tst"> + <xsl:for-each select="key('xref-item',$anchor)"> + <xsl:variable name="t-is-normative" select="ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="is-normative" select="$t-is-normative/@x:nrm='true'"/> + <xsl:if test="$is-normative">OK</xsl:if> + </xsl:for-each> + </xsl:variable> + <xsl:if test="$tst=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">all references to the normative reference '<xsl:value-of select="@anchor"/>' appear to be informative</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:call-template name="check-anchor"/> + + <xsl:variable name="target"> + <xsl:call-template name="link-ref-title-to"/> + </xsl:variable> + + <dt id="{@anchor}"> + <xsl:call-template name="insertInsDelClass"/> + <xsl:variable name="del-node" select="ancestor::ed:del"/> + <xsl:variable name="rep-node" select="ancestor::ed:replace"/> + <xsl:variable name="deleted" select="$del-node and ($rep-node/ed:ins)"/> + <xsl:for-each select="../.."> + <xsl:call-template name="insert-issue-pointer"> + <xsl:with-param name="deleted-anchor" select="$deleted"/> + </xsl:call-template> + </xsl:for-each> + <xsl:call-template name="reference-name"/> + </dt> + + <dd> + <xsl:call-template name="insertInsDelClass"/> + <xsl:for-each select="front/author"> + <xsl:choose> + <xsl:when test="@surname and @surname!=''"> + <xsl:variable name="displayname"> + <xsl:call-template name="displayname-for-author"> + <xsl:with-param name="not-reversed" select="position()=last() and position()!=1"/> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="address/email and $xml2rfc-linkmailto!='no'"> + <a href="mailto:{address/email}"><xsl:value-of select="$displayname" /></a> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$displayname" /> + </xsl:otherwise> + </xsl:choose> + + <xsl:choose> + <xsl:when test="position()=last() - 1"> + <xsl:if test="last() > 2">,</xsl:if> + <xsl:text> and </xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>, </xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="organization/text()"> + <xsl:choose> + <xsl:when test="address/uri"> + <a href="{address/uri}"><xsl:value-of select="organization" /></a> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="organization" /> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="organization/@ascii"> + <xsl:value-of select="concat(' (',normalize-space(organization/@ascii),')')"/> + </xsl:if> + <xsl:choose> + <xsl:when test="position()=last() - 1"> + <xsl:if test="last() > 2">,</xsl:if> + <xsl:text> and </xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>, </xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise /> + </xsl:choose> + </xsl:for-each> + + <xsl:variable name="quoted" select="not(front/title/@x:quotes='false') and not(@quoteTitle='false')"/> + <xsl:if test="$quoted">“</xsl:if> + <xsl:choose> + <xsl:when test="string-length($target) > 0"> + <a href="{$target}"><xsl:value-of select="normalize-space(front/title)" /></a> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(front/title)" /> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="$quoted">”</xsl:if> + + <xsl:if test="front/title/@ascii!=''"> + <xsl:text> (</xsl:text> + <xsl:if test="$quoted">“</xsl:if> + <xsl:value-of select="normalize-space(front/title/@ascii)" /> + <xsl:if test="$quoted">”</xsl:if> + <xsl:text>)</xsl:text> + </xsl:if> + + <xsl:variable name="si" select="seriesInfo|front/seriesInfo"/> + <xsl:if test="seriesInfo and front/seriesInfo"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">seriesInfo present both on reference and reference/front</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:variable name="rfcs" select="count($si[@name='RFC'])"/> + + <xsl:variable name="doi"> + <xsl:call-template name="compute-doi"/> + </xsl:variable> + + <xsl:for-each select="$si"> + <xsl:text>, </xsl:text> + <xsl:choose> + <xsl:when test="not(@name) and not(@value) and ./text()"><xsl:value-of select="." /></xsl:when> + <xsl:when test="@name='RFC' and $rfcs > 1"> + <xsl:variable name="uri"> + <xsl:call-template name="compute-rfc-uri"> + <xsl:with-param name="rfc" select="@value"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}"> + <xsl:value-of select="@name" /> + <xsl:if test="@value!=''"> <xsl:value-of select="@value" /></xsl:if> + </a> + </xsl:when> + <xsl:when test="@name='DOI'"> + <xsl:variable name="uri"> + <xsl:call-template name="compute-doi-uri"> + <xsl:with-param name="doi" select="@value"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}"> + <xsl:value-of select="@name" /> + <xsl:if test="@value!=''"> <xsl:value-of select="@value" /></xsl:if> + </a> + <xsl:if test="$doi!='' and $doi!=@value"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Unexpected DOI for RFC, found <xsl:value-of select="@value"/>, expected <xsl:value-of select="$doi"/></xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:when test="@name='ISBN'"> + <xsl:variable name="uri"> + <xsl:call-template name="compute-isbn-uri"> + <xsl:with-param name="isbn" select="@value"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}"> + <xsl:value-of select="@name" /> + <xsl:if test="@value!=''"> <xsl:value-of select="@value" /></xsl:if> + </a> + </xsl:when> + <xsl:when test="@name='Internet-Draft' and $rfcno > 7375"> +  + <xsl:text>Work in Progress, </xsl:text> + <xsl:value-of select="@value" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@name" /> + <xsl:if test="@value!=''"> <xsl:value-of select="@value" /></xsl:if> + <xsl:if test="translate(@name,$ucase,$lcase)='internet-draft'"> (work in progress)</xsl:if> + </xsl:otherwise> + </xsl:choose> + +  + <xsl:if test="(@name='BCP' or @name='FYI' or @name='STD') and preceding-sibling::seriesInfo[@name='RFC']"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">RFC number preceding <xsl:value-of select="@name"/> number in reference '<xsl:value-of select="../@anchor"/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + + </xsl:for-each> + +  + <xsl:if test="$xml2rfc-ext-insert-doi='yes' and $doi!='' and not($si[@name='DOI'])"> + <xsl:text>, </xsl:text> + <xsl:variable name="uri"> + <xsl:call-template name="compute-doi-uri"> + <xsl:with-param name="doi" select="$doi"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}">DOI <xsl:value-of select="$doi"/></a> + </xsl:if> + +  + <xsl:for-each select="x:prose|refcontent"> + <xsl:text>, </xsl:text> + <xsl:apply-templates/> + </xsl:for-each> + + <xsl:if test="not(front/date)"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg"><date> missing in reference '<xsl:value-of select="@anchor"/>' (note that it can be empty)</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:if test="front/date/@year != ''"> + <xsl:if test="string(number(front/date/@year)) = 'NaN'"> + <xsl:call-template name="warning"> + <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> + </xsl:call-template> + </xsl:if> + <xsl:text>, </xsl:text> + <xsl:if test="front/date/@month!=''"><xsl:value-of select="front/date/@month" /> </xsl:if> + <xsl:value-of select="front/date/@year" /> + </xsl:if> + + <xsl:choose> + <xsl:when test="string-length(normalize-space(@target)) > 0"> + <xsl:text>, <</xsl:text> + <a href="{normalize-space(@target)}"><xsl:value-of select="normalize-space(@target)"/></a> + <xsl:text>></xsl:text> + </xsl:when> + <xsl:when test="$xml2rfc-ext-link-rfc-to-info-page='yes' and $si[@name='BCP'] and starts-with(@anchor, 'BCP')"> + <xsl:text>, <</xsl:text> + <xsl:variable name="uri" select="concat('http://www.rfc-editor.org/info/bcp',$si[@name='BCP']/@value)"/> + <a href="{$uri}"><xsl:value-of select="$uri"/></a> + <xsl:text>></xsl:text> + </xsl:when> + <xsl:when test="$xml2rfc-ext-link-rfc-to-info-page='yes' and $si[@name='RFC']"> + <xsl:text>, <</xsl:text> + <xsl:variable name="uri" select="concat('http://www.rfc-editor.org/info/rfc',$si[@name='RFC']/@value)"/> + <a href="{$uri}"><xsl:value-of select="$uri"/></a> + <xsl:text>></xsl:text> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + + <xsl:text>.</xsl:text> + + <xsl:for-each select="annotation"> + <br /> + <xsl:apply-templates /> + </xsl:for-each> + + </dd> + +</xsl:template> + +<xsl:template match="references"> + <xsl:call-template name="check-no-text-content"/> + + <xsl:variable name="refseccount" select="count(/rfc/back/references)+count(/rfc/back/ed:replace/ed:ins/references)"/> + + <xsl:choose> +  + <xsl:when test="not(preceding::references) and $refseccount!=1"> + <xsl:call-template name="insert-conditional-hrule"/> + <section id="{$anchor-pref}references"> + <xsl:call-template name="insert-conditional-pagebreak"/> + <xsl:variable name="sectionNumber"> + <xsl:call-template name="get-references-section-number"/> + </xsl:variable> + <xsl:if test="$sectionNumber!=''"> + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="$sectionNumber"/> + </xsl:call-template> + </xsl:if> + <h2 id="{$anchor-pref}section.{$sectionNumber}"> + <a href="#{$anchor-pref}section.{$sectionNumber}"> + <xsl:call-template name="emit-section-number"> + <xsl:with-param name="no" select="$sectionNumber"/> + </xsl:call-template> + </a> + <xsl:text> </xsl:text> + <xsl:value-of select="$xml2rfc-refparent"/> + </h2> + <xsl:for-each select=".|following-sibling::references"> + <xsl:call-template name="make-references"> + <xsl:with-param name="nested" select="true()"/> + </xsl:call-template> + </xsl:for-each> + </section> + </xsl:when> + <xsl:when test="preceding::references"> +  + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="make-references"> + <xsl:with-param name="nested" select="false()"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="make-references"> + <xsl:param name="nested"/> + + <xsl:variable name="name"> + <xsl:if test="ancestor::ed:del"> + <xsl:text>del-</xsl:text> + </xsl:if> + <xsl:number level="any"/> + </xsl:variable> + + <xsl:variable name="elemtype"> + <xsl:choose> + <xsl:when test="$nested">h3</xsl:when> + <xsl:otherwise>h2</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="name"> + <xsl:if test="@title"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">both @title attribute and name child node present</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="render-name"> + <xsl:with-param name="n" select="name/node()"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="not(@title) or @title=''"><xsl:value-of select="$xml2rfc-refparent"/></xsl:when> + <xsl:otherwise><xsl:value-of select="@title"/></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="sectionNumber"> + <xsl:call-template name="get-section-number"/> + </xsl:variable> + + <xsl:variable name="anchorpostfix"> + <xsl:if test="$nested">.<xsl:value-of select="$name"/></xsl:if> + </xsl:variable> + + <section id="{$anchor-pref}references{$anchorpostfix}"> + <xsl:if test="$name='1'"> + <xsl:call-template name="insert-conditional-pagebreak"/> + </xsl:if> + <xsl:if test="$sectionNumber!=''"> + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="$sectionNumber"/> + </xsl:call-template> + </xsl:if> + <xsl:element name="{$elemtype}"> + <xsl:attribute name="id"><xsl:value-of select="concat($anchor-pref,'section.',$sectionNumber)"/></xsl:attribute> + <a href="#{$anchor-pref}section.{$sectionNumber}"> + <xsl:call-template name="emit-section-number"> + <xsl:with-param name="no" select="$sectionNumber"/> + </xsl:call-template> + </a> + <xsl:text> </xsl:text> + <xsl:copy-of select="$title"/> + </xsl:element> + + <xsl:variable name="included" select="exslt:node-set($includeDirectives)/myns:include[@in=generate-id(current())]/reference"/> + <dl class="{$css-reference}"> + <xsl:choose> + <xsl:when test="$xml2rfc-sortrefs='yes' and $xml2rfc-symrefs!='no'"> + <xsl:apply-templates select="*|$included"> + <xsl:sort select="concat(/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor,.//ed:ins//reference/@anchor)" /> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="*|$included"/> + </xsl:otherwise> + </xsl:choose> + </dl> + </section> +</xsl:template> + +<xsl:template match="xi:include"> + <xsl:choose> + <xsl:when test="not(parent::references)"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'Support for x:include is restricted to child elements of <references>'"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> +  + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template match="references/name"/> + +<xsl:template match="rfc"> + <xsl:call-template name="check-no-text-content"/> + <xsl:variable name="ignored"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="//processing-instruction('rfc-ext')"/> + <xsl:with-param name="attr" select="'SANITYCHECK'"/> + </xsl:call-template> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="//processing-instruction('rfc')"/> + <xsl:with-param name="attr" select="'SANITYCHECK'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="lang"> + <xsl:call-template name="get-lang" /> + </xsl:variable> + + <html lang="{$lang}"> + <head> + <title> + <xsl:apply-templates select="front/title" mode="get-text-content" /> + </title> + <xsl:call-template name="insertScripts" /> + <xsl:call-template name="insertCss" /> +  + +  + <xsl:if test="$xml2rfc-toc='yes'"> + <link rel="Contents" href="#{$anchor-pref}toc" /> + </xsl:if> + <xsl:if test="$xml2rfc-authorship!='no'"> + <link rel="Author" href="#{$anchor-pref}authors" /> + </xsl:if> + <xsl:if test="$xml2rfc-private=''"> + <xsl:choose> + <xsl:when test="$no-copylong"> + <link rel="Copyright" href="#{$anchor-pref}copyrightnotice" /> + </xsl:when> + <xsl:otherwise> + <link rel="Copyright" href="#{$anchor-pref}copyright" /> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + <xsl:if test="$has-index"> + <link rel="Index" href="#{$anchor-pref}index" /> + </xsl:if> + <xsl:apply-templates select="/" mode="links" /> + <xsl:for-each select="x:link|link"> + <link> + <xsl:choose> + <xsl:when test="self::x:link and @basename"> + <xsl:attribute name="href"> + <xsl:value-of select="concat(@basename,'.',$outputExtension)"/> + </xsl:attribute> + <xsl:copy-of select="@rel|@title" /> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="@*" /> + </xsl:otherwise> + </xsl:choose> + </link> + </xsl:for-each> + <xsl:if test="@number"> + <link rel="Alternate" title="Authoritative ASCII Version" href="http://www.ietf.org/rfc/rfc{@number}.txt" /> + <link rel="Help" title="RFC-Editor's Status Page" href="http://www.rfc-editor.org/info/rfc{@number}" /> + <link rel="Help" title="Additional Information on tools.ietf.org" href="https://tools.ietf.org/html/rfc{@number}"/> + </xsl:if> + +  + <xsl:variable name="gen"> + <xsl:call-template name="get-generator" /> + </xsl:variable> + <meta name="generator" content="{$gen}" /> + +  + <xsl:if test="front/keyword"> + <xsl:variable name="keyw"> + <xsl:call-template name="get-keywords" /> + </xsl:variable> + <meta name="keywords" content="{$keyw}" /> + </xsl:if> + + <xsl:if test="$xml2rfc-ext-support-rfc2731!='no'"> +  + <link rel="schema.dcterms" href="http://purl.org/dc/terms/" /> + +  + <xsl:for-each select="front/author"> + <xsl:variable name="initials"> + <xsl:call-template name="format-initials"/> + </xsl:variable> + <meta name="dcterms.creator" content="{concat(@surname,', ',$initials)}" /> + </xsl:for-each> + + <xsl:if test="$xml2rfc-private=''"> + <xsl:choose> + <xsl:when test="@number"> + <meta name="dcterms.identifier" content="urn:ietf:rfc:{@number}" /> + </xsl:when> + <xsl:when test="@docName"> + <meta name="dcterms.identifier" content="urn:ietf:id:{@docName}" /> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + <meta name="dcterms.issued"> + <xsl:attribute name="content"> + <xsl:value-of select="concat($xml2rfc-ext-pub-year,'-',$pub-month-numeric)"/> + <xsl:if test="$xml2rfc-ext-pub-day != '' and not(@number)"> + <xsl:value-of select="concat('-',format-number($xml2rfc-ext-pub-day,'00'))"/> + </xsl:if> + </xsl:attribute> + </meta> + + <xsl:if test="@obsoletes!=''"> + <xsl:call-template name="rfclist-for-dcmeta"> + <xsl:with-param name="list" select="@obsoletes"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:if test="front/abstract"> + <meta name="dcterms.abstract" content="{normalize-space(front/abstract)}" /> + </xsl:if> + + <xsl:if test="@number"> + <meta name="dcterms.isPartOf" content="urn:issn:2070-1721" /> + </xsl:if> + + </xsl:if> + +  + <xsl:if test="front/abstract"> + <meta name="description" content="{normalize-space(front/abstract)}" /> + </xsl:if> + </head> + + <xsl:call-template name="body" /> + </html> +</xsl:template> + +<xsl:template name="body"> + <body> +  + <xsl:variable name="onload"> + <xsl:if test="$xml2rfc-ext-insert-metadata='yes' and /rfc/@number">getMeta(<xsl:value-of select="/rfc/@number"/>,"rfc.meta");</xsl:if> + <xsl:if test="/rfc/x:feedback">initFeedback();</xsl:if> + <xsl:if test="$xml2rfc-ext-refresh-from!=''">RfcRefresh.initRefresh()</xsl:if> + </xsl:variable> + <xsl:if test="$onload!=''"> + <xsl:attribute name="onload"> + <xsl:value-of select="$onload"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="add-start-material" /> + +  + <xsl:call-template name="insert-diagnostics"/> + + <xsl:apply-templates select="front" /> + <xsl:apply-templates select="middle" /> + <xsl:call-template name="back" /> + + <xsl:call-template name="add-end-material" /> + </body> +</xsl:template> + +<xsl:template match="t"> + <xsl:param name="inherited-self-link"/> + + <xsl:variable name="textcontent" select="normalize-space(.)"/> + <xsl:variable name="endswith" select="substring($textcontent,string-length($textcontent))"/> + <xsl:variable name="keepwithnext" select="$endswith=':'"/> + + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + + <xsl:variable name="stype"> + <xsl:choose> + <xsl:when test="ancestor::abstract">abstract</xsl:when> + <xsl:when test="ancestor::note">note</xsl:when> + <xsl:when test="ancestor::boilerplate">boilerplate</xsl:when> + <xsl:otherwise>section</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:if test="preceding-sibling::section or preceding-sibling::appendix"> + <xsl:call-template name="inline-warning"> + <xsl:with-param name="msg">The paragraph below is misplaced; maybe a section is closed in the wrong place: </xsl:with-param> + <xsl:with-param name="msg2"><xsl:value-of select="."/></xsl:with-param> + </xsl:call-template> + </xsl:if> + + <div> + <xsl:if test="$p!='' and not(ancestor::list) and not(ancestor::ol) and not(ancestor::ul) and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="concat($anchor-pref,$stype,'.',$p)"/></xsl:attribute> + </xsl:if> + <xsl:if test="$keepwithnext"> + <xsl:attribute name="class">avoidbreakafter</xsl:attribute> + </xsl:if> + <xsl:apply-templates mode="t-content" select="node()[1]"> + <xsl:with-param name="inherited-self-link" select="$inherited-self-link"/> + <xsl:with-param name="anchor" select="@anchor"/> + </xsl:apply-templates> + </div> +</xsl:template> + + +<xsl:template mode="t-content" match="list|figure|texttable"> +  + <xsl:apply-templates select="." /> + <xsl:apply-templates select="following-sibling::node()[1]" mode="t-content" /> +</xsl:template> + + +<xsl:template mode="t-content" match="*|node()"> + <xsl:param name="inherited-self-link"/> + <xsl:param name="anchor"/> + + <xsl:variable name="p"> + <xsl:choose> + <xsl:when test="self::text()"> + <xsl:for-each select=".."> + <xsl:call-template name="get-paragraph-number" /> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="get-paragraph-number" /> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + +  + <xsl:if test="not(self::text() and normalize-space(.)='' and not(following-sibling::node()))"> + <xsl:variable name="textcontent"> + <xsl:apply-templates mode="t-content2" select="." /> + </xsl:variable> + + <xsl:if test="normalize-space($textcontent)!=''"> + <p> + <xsl:if test="$anchor!=''"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:variable name="stype"> + <xsl:choose> + <xsl:when test="ancestor::abstract">abstract</xsl:when> + <xsl:when test="ancestor::note">note</xsl:when> + <xsl:when test="ancestor::boilerplate">boilerplate</xsl:when> + <xsl:otherwise>section</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="anch"> + <xsl:if test="$p!='' and not(ancestor::ed:del) and not(ancestor::ed:ins) and not(ancestor::li) and not(ancestor::x:lt) and not(preceding-sibling::node())"> + <xsl:value-of select="concat($anchor-pref,$stype,'.',$p)"/> + </xsl:if> + </xsl:variable> + <xsl:call-template name="insertInsDelClass"/> + <xsl:call-template name="editingMark" /> + <xsl:apply-templates mode="t-content2" select="." /> + <xsl:if test="$xml2rfc-ext-paragraph-links='yes'"> + <xsl:if test="$anch!=''"> + <a class='self' href='#{$anch}'>¶</a> + </xsl:if> + <xsl:if test="$inherited-self-link!=''"> + <a class='self' href='#{$inherited-self-link}'>¶</a> + </xsl:if> + </xsl:if> + </p> + </xsl:if> + </xsl:if> + <xsl:apply-templates mode="t-content" select="following-sibling::*[self::list or self::figure or self::texttable][1]" /> +</xsl:template> + +<xsl:template mode="t-content2" match="*"> + <xsl:apply-templates select="." /> + <xsl:if test="not(following-sibling::node()[1] [self::list or self::figure or self::texttable])"> + <xsl:apply-templates select="following-sibling::node()[1]" mode="t-content2" /> + </xsl:if> +</xsl:template> + +<xsl:template mode="t-content2" match="text()"> + <xsl:apply-templates select="." /> + <xsl:if test="not(following-sibling::node()[1] [self::list or self::figure or self::texttable])"> + <xsl:apply-templates select="following-sibling::node()[1]" mode="t-content2" /> + </xsl:if> +</xsl:template> + +<xsl:template mode="t-content2" match="comment()|processing-instruction()"> + <xsl:apply-templates select="." /> + <xsl:if test="not(following-sibling::node()[1] [self::list or self::figure or self::texttable])"> + <xsl:apply-templates select="following-sibling::node()[1]" mode="t-content2" /> + </xsl:if> +</xsl:template> + +<xsl:template match="title"> + <xsl:variable name="t" select="normalize-space(.)"/> + <xsl:variable name="tlen" select="string-length($t)"/> + <xsl:variable name="alen" select="string-length(@abbrev)"/> + + <xsl:if test="@abbrev and $alen > 40"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">title/@abbrev too long (max 40 characters)</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:if test="$tlen > 40 and (not(@abbrev) or @abbrev='')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">title too long, should supply title/@abbrev attribute with less than 40 characters</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:if test="$tlen <= 40 and @abbrev!=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">title/@abbrev was specified despite the title being short enough (<xsl:value-of select="$tlen"/>)</xsl:with-param> + <xsl:with-param name="msg2">Title: '<xsl:value-of select="normalize-space($t)"/>', abbreviated title='<xsl:value-of select="@abbrev"/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:apply-templates /> +</xsl:template> + +<xsl:template name="insertTitle"> + <xsl:choose> + <xsl:when test="@ed:old-title"> + <del> + <xsl:if test="ancestor-or-self::*[@ed:entered-by] and @ed:datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@ed:datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="@ed:old-title"/> + </del> + <ins> + <xsl:if test="ancestor-or-self::*[@ed:entered-by] and @ed:datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@ed:datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="@title"/> + </ins> + </xsl:when> + <xsl:when test="name"> + <xsl:if test="@title"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">both @title attribute and name child node present</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="render-name"> + <xsl:with-param name="n" select="name/node()"/> + <xsl:with-param name="strip-links" select="not(ancestor-or-self::figure)"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:variable name="section-level-irefs" select="//section/iref[count(preceding-sibling::*[not(self::iref) and not(self::x:anchor-alias) and not(self::name)])=0]"/> + +<xsl:template match="section|appendix"> + <xsl:call-template name="check-no-text-content"/> + + <xsl:if test="self::appendix"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">The "appendix" element is deprecated, use "section" inside "back" instead.</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:variable name="sectionNumber"> + <xsl:choose> + <xsl:when test="ancestor::boilerplate"></xsl:when> + <xsl:otherwise><xsl:call-template name="get-section-number" /></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:if test="not(ancestor::section) and not(ancestor::boilerplate)"> + <xsl:call-template name="insert-conditional-hrule"/> + </xsl:if> + + <xsl:variable name="elemtype"> + <xsl:choose> + <xsl:when test="count(ancestor::section) <= 3">h<xsl:value-of select="2 + count(ancestor::section)"/></xsl:when> + <xsl:otherwise>h6</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:if test="$xml2rfc-ext-insert-metadata='yes' and $rfcno!='' and @anchor='rfc.status'"> + <aside id="{$anchor-pref}meta" class="{$css-docstatus}"></aside> + </xsl:if> + + <xsl:variable name="classes"><xsl:if test="@removeInRFC='true'">rfcEditorRemove</xsl:if></xsl:variable> + + <section> + <xsl:call-template name="copy-anchor"/> + + <xsl:if test="normalize-space($classes)!=''"> + <xsl:attribute name="class"><xsl:value-of select="normalize-space($classes)"/></xsl:attribute> + </xsl:if> + + <xsl:if test="$sectionNumber!=''"> + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="$sectionNumber"/> + </xsl:call-template> + </xsl:if> + + <xsl:element name="{$elemtype}"> + <xsl:if test="$sectionNumber!=''"> + <xsl:attribute name="id"><xsl:value-of select="$anchor-pref"/>section.<xsl:value-of select="$sectionNumber"/></xsl:attribute> + </xsl:if> + <xsl:choose> + <xsl:when test="$sectionNumber='1' or $sectionNumber='A'"> +  + <xsl:attribute name="class">np</xsl:attribute> + </xsl:when> + <xsl:when test="not(ancestor::section) and not(ancestor::boilerplate)"> + <xsl:call-template name="insert-conditional-pagebreak"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + + <xsl:call-template name="insertInsDelClass" /> + + <xsl:if test="$sectionNumber!='' and not(contains($sectionNumber,'unnumbered-'))"> + <a href="#{$anchor-pref}section.{$sectionNumber}"> + <xsl:call-template name="emit-section-number"> + <xsl:with-param name="no" select="$sectionNumber"/> + </xsl:call-template> + </a> + <xsl:text> </xsl:text> + </xsl:if> + +  + <xsl:if test="@ed:resolves"> + <xsl:call-template name="insert-issue-pointer"/> + </xsl:if> + + <xsl:call-template name="check-anchor"/> + <xsl:variable name="anchor"> + <xsl:choose> + <xsl:when test="@anchor"><xsl:value-of select="@anchor"/></xsl:when> + <xsl:otherwise><xsl:call-template name="sluggy-anchor"/></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$anchor!=''"> + <a href="#{$anchor}"><xsl:call-template name="insertTitle"/></a> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="insertTitle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:element> + + <xsl:if test="@removeInRFC='true' and t[1]!=$section-removeInRFC"> + <xsl:variable name="t"> + <t><xsl:value-of select="$section-removeInRFC"/></t> + </xsl:variable> + <xsl:variable name="link" select="concat($anchor-pref,'section.',$sectionNumber,'.p.1')"/> + <div id="{$link}"> + <xsl:apply-templates mode="t-content" select="exslt:node-set($t)//text()"> + <xsl:with-param name="inherited-self-link" select="$link"/> + </xsl:apply-templates> + </div> + </xsl:if> + +  + <xsl:for-each select="*"> + <xsl:if test="count(.|$section-level-irefs)!=count($section-level-irefs)"> + <xsl:apply-templates select="."/> + </xsl:if> + </xsl:for-each> + </section> +</xsl:template> + + +<xsl:template name="insert-errata"> + <xsl:param name="section"/> + <xsl:variable name="es" select="$errata-parsed[section=$section or (not(section) and $section='1')]"/> + <xsl:if test="$es"> + <aside class="{$css-erratum}"> + <xsl:for-each select="$es"> + <xsl:sort select="@eid" data-type="number"/> + <div> + <xsl:variable name="tooltip"> + <xsl:value-of select="@reported-by"/> + <xsl:text>, </xsl:text> + <xsl:value-of select="@reported"/> + <xsl:if test="@type"> (<xsl:value-of select="@type"/>)</xsl:if> + </xsl:variable> + <xsl:variable name="uri"> + <xsl:call-template name="compute-rfc-erratum-uri"> + <xsl:with-param name="eid" select="@eid"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}" title="{$tooltip}">Erratum <xsl:value-of select="@eid"/></a> + <xsl:choose> + <xsl:when test="@status='Verified'"><xsl:text> </xsl:text><span title="verified">✔</span></xsl:when> + <xsl:when test="@status='Reported'"><xsl:text> </xsl:text><span title="reported">✉</span></xsl:when> + <xsl:when test="@status='Held for Document Update'"><xsl:text> </xsl:text><span title="held for update">✀</span></xsl:when> + <xsl:otherwise/> + </xsl:choose> + </div> + </xsl:for-each> + </aside> + </xsl:if> +</xsl:template> + + +<xsl:template match="note/name"/> +<xsl:template match="section/name"/> + +<xsl:template match="spanx[@style='emph' or not(@style)]|em"> + <em> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates /> + </em> +</xsl:template> + +<xsl:template match="spanx[@style='verb' or @style='vbare']|tt"> + <span class="tt"> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates /> + </span> +</xsl:template> + +<xsl:template match="spanx[@style='strong']|strong"> + <strong> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates /> + </strong> +</xsl:template> + +<xsl:template match="spanx[@style!='']" priority="0.1"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unknown spanx style attribute '<xsl:value-of select="@style"/>' ignored</xsl:with-param> + </xsl:call-template> + <span> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates /> + </span> +</xsl:template> + +<xsl:template name="insert-blank-lines"> + <xsl:param name="no"/> + <xsl:choose> + <xsl:when test="$no >= $xml2rfc-ext-vspace-pagebreak"> + <br/> +  + </xsl:when> + <xsl:when test="$no <= 0"> + <br/> +  + </xsl:when> + <xsl:otherwise> + <br/> + <xsl:call-template name="insert-blank-lines"> + <xsl:with-param name="no" select="$no - 1"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="vspace[not(@blankLines)]"> + <br /> +</xsl:template> + +<xsl:template match="vspace"> + <xsl:call-template name="insert-blank-lines"> + <xsl:with-param name="no" select="@blankLines"/> + </xsl:call-template> +</xsl:template> + + +<xsl:variable name="src" select="/" /> + +<xsl:template name="render-section-ref"> + <xsl:param name="from" /> + <xsl:param name="to" /> + + <xsl:variable name="refname"> + <xsl:for-each select="$to"> + <xsl:call-template name="get-section-type"> + <xsl:with-param name="prec" select="$from/preceding-sibling::node()[1]" /> + </xsl:call-template> + </xsl:for-each> + </xsl:variable> + <xsl:variable name="refnum"> + <xsl:for-each select="$to"> + <xsl:call-template name="get-section-number" /> + </xsl:for-each> + </xsl:variable> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="$to/name"> + <xsl:value-of select="$to/name"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$to/@title"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:attribute name="title"> + <xsl:value-of select="$title" /> + </xsl:attribute> + <xsl:choose> + <xsl:when test="$from/@format='counter'"> + <xsl:value-of select="$refnum"/> + </xsl:when> + <xsl:when test="$from/@format='title'"> + <xsl:choose> + <xsl:when test="$to/name"> + <xsl:apply-templates select="$to/name/node()"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$to/@title"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$from/@format='none'"> +  + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(concat($refname,' ',$refnum))"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-section-xref-format"> + <xsl:param name="default"/> + <xsl:choose> + <xsl:when test="@sectionFormat"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">@sectionFormat is deprecated, use @x:fmt instead</xsl:with-param> + </xsl:call-template> + <xsl:if test="@x:fmt"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">both @x:fmt and @sectionFormat specified</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:choose> + <xsl:when test="@sectionFormat='parens' or @sectionFormat='of' or @sectionFormat='comma' or @sectionFormat='section' or @sectionFormat='number-only'"> + <xsl:value-of select="@sectionFormat"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unknown format for @sectionFormat</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="@x:fmt"> + <xsl:choose> + <xsl:when test="@x:fmt='()'">parens</xsl:when> + <xsl:when test="@x:fmt='of'">of</xsl:when> + <xsl:when test="@x:fmt=','">comma</xsl:when> + <xsl:when test="@x:fmt='none'">none</xsl:when> + <xsl:when test="@x:fmt='sec'">section</xsl:when> + <xsl:when test="@x:fmt='number'">number-only</xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unknown format for @x:fmt</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-section-xref-section"> + <xsl:choose> + <xsl:when test="@section"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">@section is deprecated, use @x:sec instead</xsl:with-param> + </xsl:call-template> + <xsl:if test="@x:sec"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">both @x:sec and @section specified</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="@section"/> + </xsl:when> + <xsl:when test="@x:sec"> + <xsl:value-of select="@x:sec"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:template> + +<xsl:template match="xref[node()]"> + + <xsl:variable name="target" select="@target" /> + <xsl:variable name="node" select="key('anchor-item',$target)" /> + <xsl:variable name="anchor"><xsl:value-of select="$anchor-pref"/>xref.<xsl:value-of select="@target"/>.<xsl:number level="any" count="xref[@target=$target]"/></xsl:variable> + + <xsl:variable name="sfmt"> + <xsl:call-template name="get-section-xref-format"/> + </xsl:variable> + + <xsl:variable name="ssec"> + <xsl:call-template name="get-section-xref-section"/> + </xsl:variable> + + <xsl:choose> +  + <xsl:when test="$sfmt='none'"> + <xsl:choose> + <xsl:when test="$node/self::reference"> + <cite title="{normalize-space($node/front/title)}"> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> +  + <xsl:if test="//iref[@x:for-anchor=$target] | //iref[@x:for-anchor='' and ../@anchor=$target]"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates/> + </cite> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + +  + <xsl:when test="$sfmt!='' and $sfmt!='none'"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('unknown xref section format extension: ',$sfmt)"/> + </xsl:call-template> + </xsl:when> + +  + <xsl:when test="$node/self::section or $node/self::appendix"> + <xsl:choose> + <xsl:when test="@format='none'"> + <a href="#{@target}"> +  + <xsl:if test="//iref[@x:for-anchor=$target] | //iref[@x:for-anchor='' and ../@anchor=$target]"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + <xsl:text> (</xsl:text> + <a href="#{@target}"> +  + <xsl:if test="//iref[@x:for-anchor=$target] | //iref[@x:for-anchor='' and ../@anchor=$target]"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:call-template name="render-section-ref"> + <xsl:with-param name="from" select="."/> + <xsl:with-param name="to" select="$node"/> + </xsl:call-template> + </a> + <xsl:text>)</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="$node/self::cref and $xml2rfc-comments='no'"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">xref to cref, but comments aren't included in the output</xsl:with-param> + </xsl:call-template> + </xsl:when> + + <xsl:otherwise> +  + <xsl:variable name="t-is-normative" select="ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="is-normative" select="$t-is-normative/@x:nrm='true'"/> + <xsl:if test="count($node)=1 and $is-normative"> + <xsl:variable name="t-r-is-normative" select="$node/ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="r-is-normative" select="$t-r-is-normative/@x:nrm='true'"/> + <xsl:if test="not($r-is-normative)"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('Potentially normative reference to ',@target,' not referenced normatively')"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <a href="#{$target}"> + <xsl:if test="@format='none'"> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + </xsl:if> + + <xsl:apply-templates /> + </a> + <xsl:if test="not(@format='none')"> + <xsl:for-each select="$src/rfc/back/references//reference[@anchor=$target]"> + <xsl:text> </xsl:text> + <cite title="{normalize-space(front/title)}"> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:call-template name="reference-name"/> + </cite> + </xsl:for-each> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:key name="iref-xanch" match="iref[@x:for-anchor]" use="@x:for-anchor"/> + +<xsl:template match="xref[not(node())]"> + + <xsl:variable name="xref" select="."/> + <xsl:variable name="anchor"><xsl:value-of select="$anchor-pref"/>xref.<xsl:value-of select="$xref/@target"/>.<xsl:number level="any" count="xref[@target=$xref/@target]"/></xsl:variable> + + <xsl:variable name="sfmt"> + <xsl:call-template name="get-section-xref-format"> + <xsl:with-param name="default"> + <xsl:choose> + <xsl:when test="ancestor::artwork">comma</xsl:when> + <xsl:otherwise>of</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="ssec"> + <xsl:call-template name="get-section-xref-section"/> + </xsl:variable> + +  + <xsl:for-each select="$src"> + + <xsl:variable name="node" select="key('anchor-item',$xref/@target)|exslt:node-set($includeDirectives)//reference[@anchor=$xref/@target]"/> + <xsl:if test="count($node)=0 and not($node/ancestor::ed:del)"> + <xsl:for-each select="$xref"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Undefined target: ',$xref/@target)"/> + </xsl:call-template> + </xsl:for-each> + </xsl:if> + + <xsl:choose> + +  + <xsl:when test="$node/self::section or $node/self::appendix"> + <a href="#{$xref/@target}"> +  + <xsl:if test="key('iref-xanch',$xref/@target) | key('iref-xanch','')[../@anchor=$xref/@target]"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:call-template name="render-section-ref"> + <xsl:with-param name="from" select="$xref"/> + <xsl:with-param name="to" select="$node"/> + </xsl:call-template> + </a> + </xsl:when> + +  + <xsl:when test="$node/self::figure"> + <a href="#{$xref/@target}"> + <xsl:variable name="figcnt"> + <xsl:for-each select="$node"> + <xsl:call-template name="get-figure-number"/> + </xsl:for-each> + </xsl:variable> + <xsl:choose> + <xsl:when test="$xref/@format='counter'"> + <xsl:value-of select="$figcnt" /> + </xsl:when> + <xsl:when test="$xref/@format='none'"> +  + </xsl:when> + <xsl:when test="$xref/@format='title'"> + <xsl:value-of select="$node/@title" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(concat('Figure ',$figcnt))"/> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:when> + +  + <xsl:when test="$node/self::texttable or $node/self::table"> + <a href="#{$xref/@target}"> + <xsl:variable name="tabcnt"> + <xsl:for-each select="$node"> + <xsl:call-template name="get-table-number"/> + </xsl:for-each> + </xsl:variable> + <xsl:choose> + <xsl:when test="$xref/@format='counter'"> + <xsl:value-of select="$tabcnt" /> + </xsl:when> + <xsl:when test="$xref/@format='none'"> +  + </xsl:when> + <xsl:when test="$xref/@format='title'"> + <xsl:choose> + <xsl:when test="$node/self::table"> + <xsl:call-template name="render-name-ref"> + <xsl:with-param name="n" select="$node/name/node()"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$node/@title" /> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(concat('Table ',$tabcnt))"/> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:when> + +  + <xsl:when test="$node/self::t or $node/self::aside or $node/self::blockquote or $node/self::dl or $node/self::ol or $node/self::ul or $node/self::dt or $node/self::li"> + <a href="#{$xref/@target}"> + <xsl:variable name="tcnt"> + <xsl:for-each select="$node"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:for-each> + </xsl:variable> + <xsl:variable name="pparent" select="$node/.."/> + <xsl:variable name="listtype"> + <xsl:choose> + <xsl:when test="$pparent/self::list"> + <xsl:value-of select="$pparent/@style"/> + </xsl:when> + <xsl:when test="$pparent/self::dl">definition</xsl:when> + <xsl:when test="$pparent/self::ol[@type='a']">letters</xsl:when> + <xsl:when test="$pparent/self::ol[@type='A']">Letters</xsl:when> + <xsl:when test="$pparent/self::ol[@type='i']">rnumbers</xsl:when> + <xsl:when test="$pparent/self::ol[@type='I']">Rnumbers</xsl:when> + <xsl:when test="$pparent/self::ol[string-length(@type)>1]">format <xsl:value-of select="$pparent/self::ol/@type"/></xsl:when> + <xsl:when test="$pparent/self::ol">numbers</xsl:when> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="s"> + <xsl:choose> + <xsl:when test="$pparent/@group"> + <xsl:call-template name="ol-start"> + <xsl:with-param name="node" select="$pparent"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pparent/@start"> + <xsl:value-of select="$pparent/@start"/> + </xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="n"> + <xsl:for-each select="$node"> + <xsl:number/> + </xsl:for-each> + </xsl:variable> + <xsl:variable name="format"> + <xsl:choose> + <xsl:when test="$listtype='letters'">a</xsl:when> + <xsl:when test="$listtype='Letters'">A</xsl:when> + <xsl:when test="$listtype='rnumbers'">i</xsl:when> + <xsl:when test="$listtype='Rnumbers'">I</xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="listindex"> + <xsl:choose> + <xsl:when test="starts-with($listtype,'format ')"> + <xsl:call-template name="expand-format-percent"> + <xsl:with-param name="format" select="substring-after($listtype,'format ')"/> + <xsl:with-param name="pos" select="$n + $s - 1"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:number value="$n + $s - 1" format="{$format}"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="$xref/@format='counter'"> + <xsl:choose> + <xsl:when test="$listtype!='' and $listindex!=''"> + <xsl:value-of select="$listindex"/> + </xsl:when> + <xsl:when test="$listtype!='' and $listindex=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('Use of format=counter for unsupported list type ',$listtype)"/> + </xsl:call-template> + <xsl:value-of select="$tcnt"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$tcnt"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$xref/@format='none'"> +  + </xsl:when> + <xsl:when test="$xref/@format='title'"> + <xsl:choose> + <xsl:when test="$node/self::dt"> + <xsl:apply-templates select="$node/node()"/> + </xsl:when> + <xsl:when test="$node/@hangText"> + <xsl:value-of select="$node/@hangText"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$node/@title" /> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="pn" select="normalize-space(substring-after($tcnt,'p.'))"/> + <xsl:text>Paragraph </xsl:text> + <xsl:choose> + <xsl:when test="$pn=''"> + <xsl:text>?</xsl:text> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('No paragraph number for link target ',$xref/@target)"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$pn"/></xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:when> + +  + <xsl:when test="$node/self::cref"> + <xsl:choose> + <xsl:when test="$xml2rfc-comments!='no'"> + <a href="#{$xref/@target}"> + <xsl:variable name="name"> + <xsl:for-each select="$node"> + <xsl:call-template name="get-comment-name" /> + </xsl:for-each> + </xsl:variable> + <xsl:choose> + <xsl:when test="$xref/@format='counter'"> + <xsl:value-of select="$name" /> + </xsl:when> + <xsl:when test="$xref/@format='none'"> +  + </xsl:when> + <xsl:when test="$xref/@format='title'"> + <xsl:value-of select="$node/@title" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="normalize-space(concat('Comment ',$name))"/> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:for-each select="$xref"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">xref to cref, but comments aren't included in the output</xsl:with-param> + </xsl:call-template> + </xsl:for-each> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + +  + <xsl:when test="$node/self::reference"> + +  + <xsl:variable name="t-is-normative" select="$xref/ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="is-normative" select="$t-is-normative/@x:nrm='true'"/> + <xsl:if test="count($node)=1 and $is-normative"> + <xsl:variable name="t-r-is-normative" select="$node/ancestor-or-self::*[@x:nrm][1]"/> + <xsl:variable name="r-is-normative" select="$t-r-is-normative/@x:nrm='true'"/> + <xsl:if test="not($r-is-normative)"> + <xsl:for-each select="$xref"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('Potentially normative reference to ',$xref/@target,' not referenced normatively')"/> + </xsl:call-template> + </xsl:for-each> + </xsl:if> + </xsl:if> + + <xsl:variable name="href"> + <xsl:call-template name="computed-target"> + <xsl:with-param name="bib" select="$node"/> + <xsl:with-param name="ref" select="$xref"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="sec"> + <xsl:choose> + <xsl:when test="starts-with($xref/@x:rel,'#') and $ssec=''"> + <xsl:call-template name="compute-section-number"> + <xsl:with-param name="bib" select="$node"/> + <xsl:with-param name="ref" select="$xref"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$xref/@x:rel and not(starts-with($xref/@x:rel,'#')) and $ssec=''"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">x:rel attribute '<xsl:value-of select="$xref/@x:rel"/>' in reference to <xsl:value-of select="$node/@anchor"/> is expected to start with '#'.</xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$ssec"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="secterm"> + <xsl:choose> +  + <xsl:when test="translate(substring($sec,1,1),$ucase,'')=''">Appendix</xsl:when> + <xsl:otherwise>Section</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="starts-with($xref/@x:rel,'#') and $ssec='' and $node/x:source/@href"> + <xsl:variable name="extdoc" select="document($node/x:source/@href)"/> + <xsl:variable name="nodes" select="$extdoc//*[@anchor=substring-after($xref//@x:rel,'#')]"/> + <xsl:if test="not($nodes)"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Anchor '<xsl:value-of select="substring-after($xref//@x:rel,'#')"/>' not found in <xsl:value-of select="$node/x:source/@href"/>.</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:for-each select="$nodes"> + <xsl:value-of select="@title"/> + </xsl:for-each> + </xsl:when> + <xsl:otherwise /> + </xsl:choose> + </xsl:variable> + +  + + <xsl:if test="$sfmt!='' and not($sfmt='of' or $sfmt='section' or $sfmt='number-only' or $sfmt='parens' or $sfmt='comma')"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('unknown xref section format extension: ',$sfmt)"/> + </xsl:call-template> + </xsl:if> + + <xsl:if test="$sec!=''"> + + <xsl:choose> + <xsl:when test="$sfmt='of' or $sfmt='section'"> + <xsl:choose> + <xsl:when test="$href!=''"> + <a href="{$href}"> + <xsl:if test="$title!=''"> + <xsl:attribute name="title"><xsl:value-of select="$title"/></xsl:attribute> + </xsl:if> + <xsl:if test="$sfmt='section' and $xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="$secterm"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$sec"/> + </a> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$secterm"/><xsl:text> </xsl:text><xsl:value-of select="$sec"/></xsl:otherwise> + </xsl:choose> + <xsl:if test="$sfmt='of'"> + <xsl:text> of </xsl:text> + </xsl:if> + </xsl:when> + <xsl:when test="$sfmt='number-only'"> + <xsl:choose> + <xsl:when test="$href!=''"> + <a href="{$href}"> + <xsl:if test="$title!=''"> + <xsl:attribute name="title"><xsl:value-of select="$title"/></xsl:attribute> + </xsl:if> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="$sec"/> + </a> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$sec"/></xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise /> + </xsl:choose> + </xsl:if> + + <xsl:if test="$sec='' or ($sfmt!='section' and $sfmt!='number-only')"> + <xsl:choose> + <xsl:when test="$xref/@format='none'"> +  + </xsl:when> + <xsl:otherwise> + <a href="#{$xref/@target}"> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes'"> + <xsl:attribute name="id"><xsl:value-of select="$anchor"/></xsl:attribute> + </xsl:if> + <cite title="{normalize-space($node/front/title)}"> + <xsl:variable name="val"> + <xsl:call-template name="reference-name"> + <xsl:with-param name="node" select="$node" /> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="$xref/@format='counter'"> +  + <xsl:value-of select="substring($val,2,string-length($val)-2)"/> + </xsl:when> + <xsl:when test="$xref/@format='title'"> + <xsl:value-of select="$node/front/title"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$val"/> + </xsl:otherwise> + </xsl:choose> + </cite> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="$sec!=''"> + <xsl:choose> + <xsl:when test="$sfmt='parens'"> + <xsl:text> (</xsl:text> + <xsl:choose> + <xsl:when test="$href!=''"> + <a href="{$href}"><xsl:value-of select="$secterm"/><xsl:text> </xsl:text><xsl:value-of select="$sec"/></a> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$secterm"/><xsl:text> </xsl:text><xsl:value-of select="$sec"/></xsl:otherwise> + </xsl:choose> + <xsl:text>)</xsl:text> + </xsl:when> + <xsl:when test="$sfmt='comma'"> + <xsl:text>, </xsl:text> + <xsl:choose> + <xsl:when test="$href!=''"> + <a href="{$href}"> + <xsl:if test="$title!=''"> + <xsl:attribute name="title"><xsl:value-of select="$title"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="$secterm"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$sec"/> + </a> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$secterm"/><xsl:text> </xsl:text><xsl:value-of select="$sec"/></xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:if> + </xsl:when> + + <xsl:otherwise> + <xsl:if test="$node"> +  + <xsl:for-each select="$xref"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('xref to unknown element: ',name($node))"/> + </xsl:call-template> + </xsl:for-each> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> +</xsl:template> + + + + +<xsl:template match="*"> + <xsl:call-template name="error"> + <xsl:with-param name="inline" select="'no'"/> + <xsl:with-param name="msg">no XSLT template for element '<xsl:value-of select="name()"/>'</xsl:with-param> + </xsl:call-template> + <span class="tt {$css-error}"><<xsl:value-of select="name()" />></span> + <xsl:copy><xsl:apply-templates select="node()|@*" /></xsl:copy> + <span class="tt {$css-error}"></<xsl:value-of select="name()" />></span> +</xsl:template> + +<xsl:template match="/"> + <xsl:apply-templates select="*" mode="validate"/> + <xsl:apply-templates select="*" /> +</xsl:template> + + + +<xsl:template name="collectLeftHeaderColumn"> +  + <xsl:if test="$xml2rfc-private=''"> + <xsl:choose> + <xsl:when test="/rfc/@number and $header-format='2010' and $submissionType='independent'"> + <myns:item>Independent Submission</myns:item> + </xsl:when> + <xsl:when test="/rfc/@number and $header-format='2010' and $submissionType='IETF'"> + <myns:item>Internet Engineering Task Force (IETF)</myns:item> + </xsl:when> + <xsl:when test="/rfc/@number and $header-format='2010' and $submissionType='IRTF'"> + <myns:item>Internet Research Task Force (IRTF)</myns:item> + </xsl:when> + <xsl:when test="/rfc/@number and $header-format='2010' and $submissionType='IAB'"> + <myns:item>Internet Architecture Board (IAB)</myns:item> + </xsl:when> + <xsl:when test="/rfc/front/workgroup and (not(/rfc/@number) or /rfc/@number='')"> + <xsl:choose> + <xsl:when test="starts-with(/rfc/@docName,'draft-ietf-') and $submissionType='IETF'"/> + <xsl:when test="starts-with(/rfc/@docName,'draft-irft-') and $submissionType='IRTF'"/> + <xsl:otherwise> + <xsl:call-template name="info"> + <xsl:with-param name="msg">The /rfc/front/workgroup should only be used for Working/Research Group drafts</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + <xsl:for-each select="/rfc/front/workgroup"> + <xsl:variable name="v" select="normalize-space(.)"/> + <xsl:variable name="tmp" select="translate($v, $ucase, $lcase)"/> + <xsl:if test="contains($tmp,' research group') or contains($tmp,' working group')"> + <xsl:call-template name="info"> + <xsl:with-param name="msg">No need to include 'Working Group' or 'Research Group' postfix in /rfc/front/workgroup value '<xsl:value-of select="$v"/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:variable name="h"> +  + <xsl:choose> + <xsl:when test="not(contains($v, ' ')) and starts-with(/rfc/@docName,'draft-ietf-') and $submissionType='IETF'"> + <xsl:value-of select="concat($v, ' Working Group')"/> + </xsl:when> + <xsl:when test="not(contains($v, ' ')) and starts-with(/rfc/@docName,'draft-irtf-') and $submissionType='IRTF'"> + <xsl:value-of select="concat($v, ' Research Group')"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$v"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <myns:item> + <xsl:value-of select="$h"/> + </myns:item> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:if test="starts-with(/rfc/@docName,'draft-ietf-') and not(/rfc/front/workgroup)"> + <xsl:call-template name="info"> + <xsl:with-param name="msg">WG submissions should include a /rfc/front/workgroup element</xsl:with-param> + </xsl:call-template> + </xsl:if> + <myns:item>Network Working Group</myns:item> + </xsl:otherwise> + </xsl:choose> +  + <xsl:for-each select="/rfc/front/area"> + <xsl:variable name="area" select="normalize-space(.)"/> + <xsl:variable name="rallowed"> + <xsl:if test="$pub-yearmonth < 201509"> + <ed:v>Applications</ed:v> + <ed:v>app</ed:v> + </xsl:if> + <xsl:if test="$pub-yearmonth > 201505"> + <ed:v>Applications and Real-Time</ed:v> + <ed:v>art</ed:v> + </xsl:if> + <ed:v>General</ed:v> + <ed:v>gen</ed:v> + <ed:v>Internet</ed:v> + <ed:v>int</ed:v> + <ed:v>Operations and Management</ed:v> + <ed:v>ops</ed:v> + <xsl:if test="$pub-yearmonth < 201509"> + <ed:v>Real-time Applications and Infrastructure</ed:v> + <ed:v>rai</ed:v> + </xsl:if> + <ed:v>Routing</ed:v> + <ed:v>rtg</ed:v> + <ed:v>Security</ed:v> + <ed:v>sec</ed:v> + <ed:v>Transport</ed:v> + <ed:v>tsv</ed:v> + </xsl:variable> + <xsl:variable name="allowed" select="exslt:node-set($rallowed)"/> + <xsl:choose> + <xsl:when test="$allowed/ed:v=$area"> +  + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Unknown IETF area: "<xsl:value-of select="$area"/>" - should be one of: <xsl:for-each select="$allowed/ed:v"> + <xsl:text>"</xsl:text> + <xsl:value-of select="."/> + <xsl:text>"</xsl:text> + <xsl:if test="position()!=last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + <xsl:text> (as of the publication date of </xsl:text> + <xsl:value-of select="$pub-yearmonth"/> + <xsl:text>)</xsl:text> + </xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + <myns:item> + <xsl:choose> + <xsl:when test="/rfc/@ipr and not(/rfc/@number)">Internet-Draft</xsl:when> + <xsl:otherwise>Request for Comments: <xsl:value-of select="/rfc/@number"/></xsl:otherwise> + </xsl:choose> + </myns:item> + <xsl:if test="/rfc/@obsoletes!=''"> + <myns:item> + <xsl:text>Obsoletes: </xsl:text> + <xsl:call-template name="rfclist"> + <xsl:with-param name="list" select="normalize-space(/rfc/@obsoletes)" /> + </xsl:call-template> + <xsl:if test="not(/rfc/@number)"> (if approved)</xsl:if> + </myns:item> + </xsl:if> + <xsl:if test="/rfc/@seriesNo"> + <myns:item> + <xsl:choose> + <xsl:when test="/rfc/@category='bcp'">BCP: <xsl:value-of select="/rfc/@seriesNo" /></xsl:when> + <xsl:when test="/rfc/@category='info'">FYI: <xsl:value-of select="/rfc/@seriesNo" /></xsl:when> + <xsl:when test="/rfc/@category='std'">STD: <xsl:value-of select="/rfc/@seriesNo" /></xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">There is no IETF document series called '<xsl:value-of select="/rfc/@category"/>'</xsl:with-param> + </xsl:call-template> + <xsl:value-of select="concat(translate(/rfc/@category,$lcase,$ucase),': ',/rfc/@seriesNo)" /> + </xsl:otherwise> + </xsl:choose> + </myns:item> + </xsl:if> + <xsl:if test="/rfc/@updates!=''"> + <myns:item> + <xsl:text>Updates: </xsl:text> + <xsl:call-template name="rfclist"> + <xsl:with-param name="list" select="normalize-space(/rfc/@updates)" /> + </xsl:call-template> + <xsl:if test="not(/rfc/@number)"> (if approved)</xsl:if> + </myns:item> + </xsl:if> + <myns:item> + <xsl:choose> + <xsl:when test="/rfc/@number"> + <xsl:text>Category: </xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>Intended status: </xsl:text> + </xsl:otherwise> + </xsl:choose> + <xsl:call-template name="get-category-long" /> + </myns:item> + <xsl:if test="/rfc/@ipr and not(/rfc/@number)"> + <myns:item>Expires: <xsl:call-template name="expirydate" /></myns:item> + </xsl:if> + </xsl:if> + +  + <xsl:if test="$xml2rfc-private!=''"> + <myns:item><xsl:value-of select="$xml2rfc-private" /></myns:item> + </xsl:if> + + <xsl:if test="$header-format='2010' and /rfc/@number"> + <myns:item>ISSN: 2070-1721</myns:item> + </xsl:if> +</xsl:template> + +<xsl:template name="collectRightHeaderColumn"> + <xsl:for-each select="author"> + <xsl:variable name="initials"> + <xsl:call-template name="format-initials"/> + </xsl:variable> + <xsl:variable name="truncated-initials"> + <xsl:call-template name="truncate-initials"> + <xsl:with-param name="initials" select="$initials"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="@surname"> + <myns:item> + <xsl:value-of select="$truncated-initials"/> + <xsl:if test="$truncated-initials!=''"> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:value-of select="@surname" /> + <xsl:if test="@asciiInitials!='' or @asciiSurname!=''"> + <xsl:text> (</xsl:text> + <xsl:value-of select="@asciiInitials"/> + <xsl:if test="@asciiInitials!='' and @asciiSurname!=''"> </xsl:if> + <xsl:value-of select="@asciiSurname"/> + <xsl:text>)</xsl:text> + </xsl:if> + <xsl:if test="@role"> + <xsl:choose> + <xsl:when test="@role='editor'"> + <xsl:text>, Editor</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>, </xsl:text><xsl:value-of select="@role" /> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </myns:item> + </xsl:if> + <xsl:variable name="org"> + <xsl:choose> + <xsl:when test="organization/@abbrev"><xsl:value-of select="organization/@abbrev" /></xsl:when> + <xsl:otherwise><xsl:value-of select="organization" /></xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="orgOfFollowing"> + <xsl:choose> + <xsl:when test="following-sibling::*[1]/organization/@abbrev"><xsl:value-of select="following-sibling::*[1]/organization/@abbrev" /></xsl:when> + <xsl:otherwise><xsl:value-of select="following-sibling::*/organization" /></xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="$org != $orgOfFollowing and $org != ''"> + <myns:item> + <xsl:value-of select="$org"/> + <xsl:if test="organization/@ascii"> + <xsl:value-of select="concat(' (',organization/@ascii,')')"/> + </xsl:if> + </myns:item> + </xsl:if> + </xsl:for-each> + <myns:item> + <xsl:if test="$xml2rfc-ext-pub-month!=''"> + <xsl:value-of select="$xml2rfc-ext-pub-month" /> + <xsl:if test="$xml2rfc-ext-pub-day!='' and /rfc/@ipr and not(/rfc/@number)"> + <xsl:text> </xsl:text> + <xsl:value-of select="number($xml2rfc-ext-pub-day)" /> + <xsl:text>,</xsl:text> + </xsl:if> + </xsl:if> + <xsl:if test="$xml2rfc-ext-pub-month='' and $rfcno!=''"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'month missing but is required for RFCs'"/> + </xsl:call-template> + </xsl:if> + <xsl:if test="$xml2rfc-ext-pub-day='' and /rfc/@docName and not(substring(/rfc/@docName, string-length(/rfc/@docName) - string-length('-latest') + 1) = '-latest')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('/rfc/front/date/@day appears to be missing for a historic draft dated ', $pub-yearmonth)"/> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="concat(' ',$xml2rfc-ext-pub-year)" /> + </myns:item> +</xsl:template> + + +<xsl:template name="emitheader"> + <xsl:param name="lc" /> + <xsl:param name="rc" /> + + <tbody> + <xsl:for-each select="$lc/myns:item | $rc/myns:item"> + <xsl:variable name="pos" select="position()" /> + <xsl:if test="$pos < count($lc/myns:item) + 1 or $pos < count($rc/myns:item) + 1"> + <tr> + <td class="{$css-left}"><xsl:call-template name="copynodes"><xsl:with-param name="nodes" select="$lc/myns:item[$pos]/node()" /></xsl:call-template></td> + <td class="{$css-right}"><xsl:call-template name="copynodes"><xsl:with-param name="nodes" select="$rc/myns:item[$pos]/node()" /></xsl:call-template></td> + </tr> + </xsl:if> + </xsl:for-each> + </tbody> +</xsl:template> + + +<xsl:template name="copynodes"> + <xsl:param name="nodes" /> + <xsl:for-each select="$nodes"> + <xsl:choose> + <xsl:when test="namespace-uri()='http://www.w3.org/1999/xhtml'"> + <xsl:element name="{name()}" namespace="{namespace-uri()}"> + <xsl:copy-of select="@*|node()" /> + </xsl:element> + </xsl:when> + <xsl:when test="self::*"> + <xsl:element name="{name()}"> + <xsl:copy-of select="@*|node()" /> + </xsl:element> + </xsl:when> +  + <xsl:when test="self::text()"> + <xsl:value-of select="."/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="." /> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> +</xsl:template> + + +<xsl:template name="expirydate"> + <xsl:param name="in-prose"/> + <xsl:choose> + <xsl:when test="number($xml2rfc-ext-pub-day) >= 1"> +  + <xsl:if test="$in-prose"> + <xsl:text>on </xsl:text> + </xsl:if> + <xsl:call-template name="normalize-date"> + <xsl:with-param name="year" select="$xml2rfc-ext-pub-year"/> + <xsl:with-param name="month" select="$pub-month-numeric"/> + <xsl:with-param name="day" select="$xml2rfc-ext-pub-day + 185"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$in-prose"> + <xsl:text>in </xsl:text> + </xsl:if> + <xsl:variable name="month"> + <xsl:call-template name="get-month-as-num"> + <xsl:with-param name="month" select="$xml2rfc-ext-pub-month"/> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="string(number($month))!='NaN' and number($month) > 0 and number($month) < 7"> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="number($month) + 6"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:value-of select="$xml2rfc-ext-pub-year" /> + </xsl:when> + <xsl:when test="string(number($month))!='NaN' and number($month) > 6 and number($month) < 13"> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="number($month) - 6"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:value-of select="$xml2rfc-ext-pub-year + 1" /> + </xsl:when> + <xsl:otherwise>WRONG SYNTAX FOR MONTH</xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="normalize-date"> + <xsl:param name="year"/> + <xsl:param name="month"/> + <xsl:param name="day"/> + + <xsl:variable name="isleap" select="(($year mod 4) = 0 and ($year mod 100 != 0)) or ($year mod 400) = 0" /> + +  + + <xsl:variable name="dim"> + <xsl:choose> + <xsl:when test="$month=1 or $month=3 or $month=5 or $month=7 or $month=8 or $month=10 or $month=12">31</xsl:when> + <xsl:when test="$month=2 and $isleap">29</xsl:when> + <xsl:when test="$month=2 and not($isleap)">28</xsl:when> + <xsl:otherwise>30</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$day > $dim and $month=12"> + <xsl:call-template name="normalize-date"> + <xsl:with-param name="year" select="$year + 1"/> + <xsl:with-param name="month" select="1"/> + <xsl:with-param name="day" select="$day - $dim"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$day > $dim"> + <xsl:call-template name="normalize-date"> + <xsl:with-param name="year" select="$year"/> + <xsl:with-param name="month" select="$month + 1"/> + <xsl:with-param name="day" select="$day - $dim"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="$month"/> + </xsl:call-template> + <xsl:value-of select="concat(' ',$day,', ',$year)"/> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="get-month-as-num"> + <xsl:param name="month" /> + <xsl:choose> + <xsl:when test="$month='January'">01</xsl:when> + <xsl:when test="$month='February'">02</xsl:when> + <xsl:when test="$month='March'">03</xsl:when> + <xsl:when test="$month='April'">04</xsl:when> + <xsl:when test="$month='May'">05</xsl:when> + <xsl:when test="$month='June'">06</xsl:when> + <xsl:when test="$month='July'">07</xsl:when> + <xsl:when test="$month='August'">08</xsl:when> + <xsl:when test="$month='September'">09</xsl:when> + <xsl:when test="$month='October'">10</xsl:when> + <xsl:when test="$month='November'">11</xsl:when> + <xsl:when test="$month='December'">12</xsl:when> + <xsl:otherwise>WRONG SYNTAX FOR MONTH</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-month-as-name"> + <xsl:param name="month"/> + <xsl:choose> + <xsl:when test="$month=1">January</xsl:when> + <xsl:when test="$month=2">February</xsl:when> + <xsl:when test="$month=3">March</xsl:when> + <xsl:when test="$month=4">April</xsl:when> + <xsl:when test="$month=5">May</xsl:when> + <xsl:when test="$month=6">June</xsl:when> + <xsl:when test="$month=7">July</xsl:when> + <xsl:when test="$month=8">August</xsl:when> + <xsl:when test="$month=9">September</xsl:when> + <xsl:when test="$month=10">October</xsl:when> + <xsl:when test="$month=11">November</xsl:when> + <xsl:when test="$month=12">December</xsl:when> + <xsl:otherwise>WRONG SYNTAX FOR MONTH</xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template name="get-authors-section-title"> + <xsl:choose> + <xsl:when test="count(/rfc/front/author)=1">Author's Address</xsl:when> + <xsl:otherwise>Authors' Addresses</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-authors-section-number"> + <xsl:if test="/*/x:assign-section-number[@builtin-target='authors']"> + <xsl:value-of select="/*/x:assign-section-number[@builtin-target='authors']/@number"/> + </xsl:if> +</xsl:template> + +<xsl:template name="insertAuthors"> + + <xsl:variable name="number"> + <xsl:call-template name="get-authors-section-number"/> + </xsl:variable> + + <xsl:if test="$number!='suppress' and $xml2rfc-authorship!='no'"> + <xsl:call-template name="insert-conditional-hrule"/> + + <section id="{$anchor-pref}authors" class="avoidbreakinside"> + <xsl:call-template name="insert-conditional-pagebreak"/> + <h2> + <xsl:if test="$number != ''"> + <a href="#{$anchor-pref}section.{$number}" id="{$anchor-pref}section.{$number}"><xsl:value-of select="$number"/>.</a> + <xsl:text> </xsl:text> + </xsl:if> + <a href="#{$anchor-pref}authors"><xsl:call-template name="get-authors-section-title"/></a> + </h2> + + <xsl:apply-templates select="/rfc/front/author" /> + </section> + </xsl:if> +</xsl:template> + + + + + +<xsl:template name="insertCopyright" myns:namespaceless-elements="xml2rfc"> + +<boilerplate> + <xsl:if test="not($no-copylong)"> + <section title="Full Copyright Statement" anchor="{$anchor-pref}copyright" x:fixed-section-number="3"> + <xsl:choose> + <xsl:when test="$ipr-rfc3667"> + <t> + <xsl:choose> + <xsl:when test="$ipr-rfc4748"> + Copyright © The IETF Trust (<xsl:value-of select="$xml2rfc-ext-pub-year" />). + </xsl:when> + <xsl:otherwise> + Copyright © The Internet Society (<xsl:value-of select="$xml2rfc-ext-pub-year" />). + </xsl:otherwise> + </xsl:choose> + </t> + <t> + This document is subject to the rights, licenses and restrictions + contained in BCP 78<xsl:if test="$submissionType='independent'"> and at <eref target="http://www.rfc-editor.org/copyright.html">http://www.rfc-editor.org/copyright.html</eref></xsl:if>, and except as set forth therein, the authors + retain all their rights. + </t> + <t> + This document and the information contained herein are provided + on an “AS IS” basis and THE CONTRIBUTOR, + THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), + THE INTERNET SOCIETY<xsl:if test="$ipr-rfc4748">, THE IETF TRUST</xsl:if> + AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, + EXPRESS OR IMPLIED, + INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE + INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED + WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + </t> + </xsl:when> + <xsl:otherwise> +  + <t> + Copyright © The Internet Society (<xsl:value-of select="$xml2rfc-ext-pub-year" />). All Rights Reserved. + </t> + <t> + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published and + distributed, in whole or in part, without restriction of any kind, + provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + </t> + <t> + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + </t> + <t> + This document and the information contained herein is provided on an + “AS IS” basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + </t> + </xsl:otherwise> + </xsl:choose> + </section> + + <section title="Intellectual Property" anchor="{$anchor-pref}ipr" x:fixed-section-number="4"> + <xsl:choose> + <xsl:when test="$ipr-rfc3667"> + <t> + The IETF takes no position regarding the validity or scope of any + Intellectual Property Rights or other rights that might be claimed to + pertain to the implementation or use of the technology described in + this document or the extent to which any license under such rights + might or might not be available; nor does it represent that it has + made any independent effort to identify any such rights. Information + on the procedures with respect to rights in RFC documents + can be found in BCP 78 and BCP 79. + </t> + <t> + Copies of IPR disclosures made to the IETF Secretariat and any + assurances of licenses to be made available, or the result of an + attempt made to obtain a general license or permission for the use + of such proprietary rights by implementers or users of this + specification can be obtained from the IETF on-line IPR repository + at <eref target="http://www.ietf.org/ipr">http://www.ietf.org/ipr</eref>. + </t> + <t> + The IETF invites any interested party to bring to its attention any + copyrights, patents or patent applications, or other proprietary + rights that may cover technology that may be required to implement + this standard. Please address the information to the IETF at + <eref target="mailto:ietf-ipr@ietf.org">ietf-ipr(a)ietf.org</eref>. + </t> + </xsl:when> + <xsl:otherwise> + <t> + The IETF takes no position regarding the validity or scope of + any intellectual property or other rights that might be claimed + to pertain to the implementation or use of the technology + described in this document or the extent to which any license + under such rights might or might not be available; neither does + it represent that it has made any effort to identify any such + rights. Information on the IETF's procedures with respect to + rights in standards-track and standards-related documentation + can be found in BCP-11. Copies of claims of rights made + available for publication and any assurances of licenses to + be made available, or the result of an attempt made + to obtain a general license or permission for the use of such + proprietary rights by implementors or users of this + specification can be obtained from the IETF Secretariat. + </t> + <t> + The IETF invites any interested party to bring to its + attention any copyrights, patents or patent applications, or + other proprietary rights which may cover technology that may be + required to practice this standard. Please address the + information to the IETF Executive Director. + </t> + <xsl:if test="$xml2rfc-iprnotified='yes'"> + <t> + The IETF has been notified of intellectual property rights + claimed in regard to some or all of the specification contained + in this document. For more information consult the online list + of claimed rights. + </t> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </section> + + <xsl:choose> + <xsl:when test="$no-funding"/> + <xsl:when test="$funding1 and /rfc/@number"> + <section x:fixed-section-number="5"> + <xsl:attribute name="title"> + <xsl:choose> + <xsl:when test="$xml2rfc-rfcedstyle='yes'">Acknowledgement</xsl:when> + <xsl:otherwise>Acknowledgment</xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <t> + Funding for the RFC Editor function is provided by the IETF + Administrative Support Activity (IASA). + </t> + </section> + </xsl:when> + <xsl:when test="$funding0 and /rfc/@number"> + <section x:fixed-section-number="5"> + <xsl:attribute name="title"> + <xsl:choose> + <xsl:when test="$xml2rfc-rfcedstyle='yes'">Acknowledgement</xsl:when> + <xsl:otherwise>Acknowledgment</xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <t> + Funding for the RFC Editor function is currently provided by + the Internet Society. + </t> + </section> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:if> +</boilerplate> +</xsl:template> + + +<xsl:template name="insertScripts"> +<xsl:if test="$xml2rfc-ext-refresh-from!=''"> +<script type="application/javascript"> +var RfcRefresh = {}; +RfcRefresh.NS_XHTML = "http://www.w3.org/1999/xhtml"; +RfcRefresh.NS_MOZERR = "http://www.mozilla.org/newlayout/xml/parsererror.xml"; +RfcRefresh.lastTxt = ""; +RfcRefresh.lastEtag = ""; +RfcRefresh.xslt = null; +RfcRefresh.xmlsource = "<xsl:value-of select='$xml2rfc-ext-refresh-from'/>"; +RfcRefresh.xsltsource = "<xsl:value-of select='$xml2rfc-ext-refresh-xslt'/>"; +RfcRefresh.interval = "<xsl:value-of select='number($xml2rfc-ext-refresh-interval)'/>"; + +RfcRefresh.getXSLT = function() { + if (! window.XSLTProcessor) { + var err = document.createElement("pre"); + err.className = "refreshbrowsererror <xsl:value-of select="$css-noprint"/>"; + var msg = "This browser does not support the window.XSLTProcessor functionality."; + err.appendChild(document.createTextNode(msg)); + RfcRefresh.showMessage("refreshxmlerror", err); + } + else { + try { + var xhr = new XMLHttpRequest(); + xhr.open("GET", RfcRefresh.xsltsource, true); + xhr.onload = function (e) { + if (xhr.readyState === 4) { + RfcRefresh.xslt = new XSLTProcessor(); + RfcRefresh.xslt.importStylesheet(xhr.responseXML); + } + } + xhr.onerror = function (e) { + console.error(xhr.status + " " + xhr.statusText); + }; + xhr.send(null); + } + catch (e) { + var err = document.createElement("pre"); + err.className = "refreshbrowsererror <xsl:value-of select="$css-noprint"/>"; + var msg = "Failed to load XSLT code from <" + RfcRefresh.xsltsource + ">.\n"; + msg += "Your browser might not support loading from a file: URI.\n"; + msg += "Error details: " + e; + err.appendChild(document.createTextNode(msg)); + RfcRefresh.showMessage("refreshxmlerror", err); + } + } +} + +RfcRefresh.findAndUpdate = function(olddoc, elem) { + var changed = ""; + var children = elem.childNodes; + for (var i = 0; i != children.length; i++) { + var n = children[i]; + if (n.nodeType == 1) { + var c = RfcRefresh.findAndUpdate(olddoc, n); + if (changed == '') { + changed = c; + } + var id = n.id; + if (id != "") { + var old = olddoc.getElementById(id); + var newtext = n.innerHTML; + if (!old) { + console.debug("new " + id); + } else { + var oldtext = old.innerHTML; + if (oldtext != newtext) { + console.debug("updating " + id); + old.innerHTML = n.innerHTML; + if (changed == '') { + changed = id; + } + } + } + } + } + } + return changed; +} + +RfcRefresh.findDifferences = function(olddoc, newdoc) { + var changed = RfcRefresh.findAndUpdate(olddoc, newdoc.documentElement); + if (changed != "") { + console.debug("changed: " + changed); + document.location = "#" + changed; + } + // final check for changes; if those were not processed earlier, + // we refresh the whole document + var oldtext = olddoc.documentElement.getElementsByTagName("body")[0].innerHTML; + var newtext = newdoc.documentElement.getElementsByTagName("body")[0].innerHTML; + if (oldtext != newtext) { + console.debug("full refresh: " + newtext); + olddoc.documentElement.innerHTML = newdoc.documentElement.innerHTML; + } +} + +RfcRefresh.getNodeText = function(elem) { + var result = ""; + var children = elem.childNodes; + for (var i = 0; i != children.length; i++) { + if (children[i].nodeType == 3) { + result += children[i].nodeValue; + } + } + return result; +} + +RfcRefresh.getParserError = function(dom) { + // FIREFOX + if ("parsererror" == dom.documentElement.nodeName && RfcRefresh.NS_MOZERR == dom.documentElement.namespaceURI) { + var errmsg = new Object(); + errmsg.msg = ""; + errmsg.src = ""; + var children = dom.documentElement.childNodes; + for (var i = 0; i != children.length; i++) { + if (children[i].nodeType == 3) { + errmsg.msg += children[i].nodeValue; + } else if (children[i].nodeName == "sourcetext") { + errmsg.src = RfcRefresh.getNodeText(children[i]); + } + } + return errmsg; + } + + var list = dom.getElementsByTagNameNS(RfcRefresh.NS_XHTML, "parsererror"); + if (list.length != 0) { + // Webkit + var errmsg = new Object(); + errmsg.msg = "XML parse error"; + list = dom.getElementsByTagNameNS(RfcRefresh.NS_XHTML, "div"); + if (list.length != 0) { + errmsg.msg = RfcRefresh.getNodeText(list[0]); + } + return errmsg; + } + + + return null; +} + +RfcRefresh.showMessage = function(cls, node) { + // remove previous message + var list = document.getElementsByClassName(cls); + if (list.length != 0) { + list[0].parentNode.removeChild(list[0]); + } + document.body.appendChild(node); +} + +RfcRefresh.refresh = function(txt) { + if (txt != RfcRefresh.lastTxt) { + RfcRefresh.lastTxt = txt; + // try to parse + var parser = new DOMParser(); + var dom = parser.parseFromString(txt, "text/xml"); + var errmsg = RfcRefresh.getParserError(dom); + + if (errmsg != null) { + var err = document.createElement("pre"); + err.className = "refreshxmlerror <xsl:value-of select="$css-noprint"/>"; + err.appendChild(document.createTextNode(errmsg.msg)); + if (errmsg.src != null) { + err.appendChild(document.createElement("hr")); + err.appendChild(document.createTextNode(errmsg.src)); + } + RfcRefresh.showMessage("refreshxmlerror", err); + } else { + // find new refresh + var children = dom.childNodes; + for (var i = 0; i != children.length; i++) { + if (children[i].nodeType == 7 && children[i].target == "rfc-ext") { + var s = "<foo " + children[i].data + "/>"; + var sd = parser.parseFromString(s, "text/xml"); + var refresh = sd.documentElement.getAttribute("refresh-interval"); + if (refresh != null && refresh != "") { + refresh = parseInt(refresh, 10); + if (RfcRefresh.interval != refresh) { + if (Number.isNaN(refresh) || refresh < 5) { + console.debug("refresh requested to be: " + refresh + " - ignored, using 5 instead."); + RfcRefresh.interval = 5; + } else { + RfcRefresh.interval = refresh; + console.debug("refresh changed to: " + refresh); + } + } + } + } + } + + var html = RfcRefresh.xslt.transformToDocument(dom); + RfcRefresh.findDifferences(document, html); + } + } +} + +RfcRefresh.initRefresh = function() { + RfcRefresh.getXSLT(); + + window.setTimeout(function(){ + if (RfcRefresh.xslt != null) { + var xhr = new XMLHttpRequest(); + xhr.open("GET", RfcRefresh.xmlsource, true); + if (RfcRefresh.lastEtag != "") { + xhr.setRequestHeader("If-None-Match", RfcRefresh.lastEtag); + } + xhr.onload = function (e) { + if (xhr.readyState === 4) { + console.debug(xhr.status + " " + xhr.statusText); + if (xhr.status != 304) { + RfcRefresh.refresh(xhr.responseText); + } + RfcRefresh.lastEtag = xhr.getResponseHeader("ETag"); + } + } + xhr.onerror = function (e) { + console.error(xhr.status + " " + xhr.statusText); + }; + xhr.send(null); + setTimeout(arguments.callee, RfcRefresh.interval * 1000); + } + }, RfcRefresh.interval * 1000); +} +</script> +</xsl:if> +<xsl:if test="/rfc/x:feedback"> +<script type="application/javascript"> +var buttonsAdded = false; + +function initFeedback() { + var fb = document.createElement("div"); + fb.className = "<xsl:value-of select="concat($css-feedback,' ',$css-noprint)"/>"; + fb.setAttribute("onclick", "feedback();"); + fb.appendChild(document.createTextNode("feedback")); + + document.body.appendChild(fb); +} + +function feedback() { + toggleButtonsToElementsByName("h2"); + toggleButtonsToElementsByName("h3"); + toggleButtonsToElementsByName("h4"); + toggleButtonsToElementsByName("h5"); + + buttonsAdded = !buttonsAdded; +} + +function toggleButtonsToElementsByName(name) { + var list = document.getElementsByTagName(name); + for (var i = 0; i < list.length; i++) { + toggleButton(list.item(i)); + } +} + +function toggleButton(node) { + if (! buttonsAdded) { + + // docname + var template = "<xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="/rfc/x:feedback/@template"/> + <xsl:with-param name="replace">"</xsl:with-param> + <xsl:with-param name="by">\"</xsl:with-param> +</xsl:call-template>"; + + var id = node.getAttribute("id"); + // try also parent + if (id == null || id == "") { + var id = node.parentNode.getAttribute("id"); + } + // better id available? + var titlelinks = node.getElementsByTagName("a"); + for (var i = 0; i < titlelinks.length; i++) { + var tl = titlelinks.item(i); + if (tl.getAttribute("id")) { + id = tl.getAttribute("id"); + } + } + + // ref + var ref = window.location.toString(); + var hash = ref.indexOf("#"); + if (hash != -1) { + ref = ref.substring(0, hash); + } + if (id != null && id != "") { + ref += "#" + id; + } + + // docname + var docname = "<xsl:value-of select="/rfc/@docName"/>"; + + // section + var section = node.textContent; + section = section.replace("\u00a0", " ").trim(); + + // build URI from template + var uri = template.replace("{docname}", encodeURIComponent(docname)); + uri = uri.replace("{section}", encodeURIComponent(section)); + uri = uri.replace("{ref}", encodeURIComponent(ref)); + + var button = document.createElement("a"); + button.className = "<xsl:value-of select="concat($css-fbbutton,' ',$css-noprint)"/>"; + button.setAttribute("href", uri); + button.appendChild(document.createTextNode("send feedback")); + node.appendChild(button); + } + else { + var buttons = node.getElementsByTagName("a"); + for (var i = 0; i < buttons.length; i++) { + var b = buttons.item(i); + if (b.className == "<xsl:value-of select="concat($css-fbbutton,' ',$css-noprint)"/>") { + node.removeChild(b); + } + } + } +}</script> +</xsl:if> +<xsl:if test="$xml2rfc-ext-insert-metadata='yes' and $rfcno!=''"> +<script type="application/javascript"> +function getMeta(rfcno, container) { + + var xhr = new XMLHttpRequest(); + xhr.open("GET", "https://tools.ietf.org/draft/rfc" + rfcno + "/state.xml", true); + xhr.onload = function (e) { + if (xhr.readyState === 4) { + if (xhr.status === 200) { + var doc = xhr.responseXML; + var info = getChildByName(doc.documentElement, "info"); + + var cont = document.getElementById(container); + // empty the container + while (cont.firstChild) { + cont.removeChild(myNode.firstChild); + } + + var c = getChildByName(info, "stdstatus"); + if (c !== null) { + var bld = newElementWithText("b", c.textContent); + cont.appendChild(bld); + } + + c = getChildByName(info, "updatedby"); + if (c !== null) { + cont.appendChild(newElement("br")); + cont.appendChild(newText("Updated by: ")); + appendRfcLinks(cont, c.textContent); + } + + c = getChildByName(info, "obsoletedby"); + if (c !== null) { + cont.appendChild(newElement("br")); + cont.appendChild(newText("Obsoleted by: ")); + appendRfcLinks(cont, c.textContent); + } + + c = getChildByName(info, "errata"); + if (c !== null) { + var template = "<xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-rfc-errata-uri"/> + <xsl:with-param name="replace">"</xsl:with-param> + <xsl:with-param name="by">\"</xsl:with-param> + </xsl:call-template>"; + + cont.appendChild(newElement("br")); + var link = newElementWithText("a", "errata"); + link.setAttribute("href", template.replace("{rfc}", rfcno)); + var errata = newElementWithText("i", "This document has "); + errata.appendChild(link); + errata.appendChild(newText(".")); + cont.appendChild(errata); + } + + cont.style.display = "block"; + } else { + console.error(xhr.statusText); + } + } + }; + xhr.onerror = function (e) { + console.error(xhr.status + " " + xhr.statusText); + }; + xhr.send(null); +} + +// DOM helpers +function newElement(name) { + return document.createElement(name); +} +function newElementWithText(name, txt) { + var e = document.createElement(name); + e.appendChild(newText(txt)); + return e; +} +function newText(text) { + return document.createTextNode(text); +} + +function getChildByName(parent, name) { + if (parent === null) { + return null; + } + else { + for (var c = parent.firstChild; c !== null; c = c.nextSibling) { + if (name == c.nodeName) { + return c; + } + } + return null; + } +} + +function appendRfcLinks(parent, text) { + var template = "<xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="$xml2rfc-ext-rfc-uri"/> + <xsl:with-param name="replace">"</xsl:with-param> + <xsl:with-param name="by">\"</xsl:with-param> +</xsl:call-template>"; + var updates = text.split(","); + for (var i = 0; i < updates.length; i++) { + var rfc = updates[i].trim(); + if (rfc.substring(0, 3) == "rfc") { + var no = rfc.substring(3); + var link = newElement("a"); + link.setAttribute("href", template.replace("{rfc}", no)); + link.appendChild(newText(no)); + parent.appendChild(link); + } else { + parent.appendChild(newText(rfc)); + } + if (i != updates.length - 1) { + parent.appendChild(newText(", ")); + } + } +} +</script> +</xsl:if> +<script type="application/javascript"> +function anchorRewrite() { +<xsl:text> map = { </xsl:text> + <xsl:for-each select="//x:anchor-alias"> + <xsl:text>"</xsl:text> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="@value"/> + <xsl:with-param name="replace">"</xsl:with-param> + <xsl:with-param name="by">\"</xsl:with-param> + </xsl:call-template> + <xsl:text>": "</xsl:text> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="ancestor::*[@anchor][1]/@anchor"/> + <xsl:with-param name="replace">"</xsl:with-param> + <xsl:with-param name="by">\"</xsl:with-param> + </xsl:call-template> + <xsl:text>"</xsl:text> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:for-each> +<xsl:text>};</xsl:text> + if (window.location.hash.length >= 1) { + var fragid = window.location.hash.substr(1); + if (fragid) { + if (! document.getElementById(fragid)) { + var prefix = "<xsl:value-of select="$anchor-pref"/>"; + var mapped = map[fragid]; + if (mapped) { + window.location.hash = mapped; + } else if (fragid.indexOf("section-") == 0) { + window.location.hash = prefix + "section." + fragid.substring(8); + } else if (fragid.indexOf("appendix-") == 0) { + window.location.hash = prefix + "section." + fragid.substring(9); + } else if (fragid.indexOf("s-") == 0) { + var postfix = fragid.substring(2); + if (postfix.startsWith("abstract")) { + window.location.hash = prefix + postfix; + } else if (postfix.startsWith("note-")) { + window.location.hash = prefix + "note." + postfix.substring(5); + } else { + window.location.hash = prefix + "section." + postfix; + } + } else if (fragid.indexOf("p-") == 0) { + var r = fragid.substring(2); + var p = r.indexOf("-"); + if (p >= 0) { + window.location.hash = prefix + "section." + r.substring(0, p) + ".p." + r.substring(p + 1); + } + } + } + } + } +} +window.addEventListener('hashchange', anchorRewrite); +window.addEventListener('DOMContentLoaded', anchorRewrite); +</script><xsl:if test="$prettyprint-script!=''"> +<script src="{$prettyprint-script}"/></xsl:if> +</xsl:template> + + + +<xsl:template name="insertCss"> +<style type="text/css" title="rfc2629.xslt"> +<xsl:value-of select="$xml2rfc-ext-webfonts"/> +a { + text-decoration: none; +} +a.smpl { + color: black; +} +a:hover { + text-decoration: underline; +} +a:active { + text-decoration: underline; +} +address { + margin-top: 1em; + margin-left: 2em; + font-style: normal; +}<xsl:if test="//x:blockquote|//blockquote"> +blockquote { + border-style: solid; + border-color: gray; + border-width: 0 0 0 .25em; + font-style: italic; + padding-left: 0.5em; +}</xsl:if> +body {<xsl:if test="$xml2rfc-background!=''"> + background: url(<xsl:value-of select="$xml2rfc-background" />) #ffffff left top;</xsl:if> + color: black; + font-family: <xsl:value-of select="$xml2rfc-ext-ff-body"/>; + font-size: 12pt; + margin: 10px 0px 10px 10px; +}<xsl:if test="$parsedMaxwidth!=''"> +@media screen and (min-width: <xsl:value-of select="number($parsedMaxwidth + 40)"/>px) { + body { + margin: 10px auto; + max-width: <xsl:value-of select="$parsedMaxwidth"/>px; + } +}</xsl:if> +samp, span.tt, code, pre { + font-family: <xsl:value-of select="$xml2rfc-ext-ff-pre"/>; +}<xsl:if test="//xhtml:p"> +br.p { + line-height: 150%; +}</xsl:if> +cite { + font-style: normal; +}<xsl:if test="//x:note|//aside"> +aside { + margin-left: 2em; +}</xsl:if> +dl { + margin-left: 2em; +} +dl > dt { + float: left; + margin-right: 1em; +} +dl.nohang > dt { + float: none; +} +dl > dd { + margin-bottom: .5em; +} +dl.compact > dd { + margin-bottom: .0em; +} +dl > dd > dl { + margin-top: 0.5em; +} +ul.empty { + list-style-type: none; +} +ul.empty li { + margin-top: .5em; +} +dl p { + margin-left: 0em; +} +dl.<xsl:value-of select="$css-reference"/> > dt { + font-weight: bold; +} +dl.<xsl:value-of select="$css-reference"/> > dd { + margin-left: <xsl:choose><xsl:when test="$xml2rfc-symrefs='no'">3.5</xsl:when><xsl:otherwise>6</xsl:otherwise></xsl:choose>em; +} +h1 { + color: green; + font-size: 150%; + line-height: 18pt; + font-weight: bold; + text-align: center; + margin-top: 36pt; + margin-bottom: 0pt; +} +h2 { + font-size: 130%; + line-height: 21pt; + page-break-after: avoid; +} +h2.np { + page-break-before: always; +} +h3 { + font-size: 120%; + line-height: 15pt; + page-break-after: avoid; +} +h4 { + font-size: 110%; + page-break-after: avoid; +} +h5, h6 { + page-break-after: avoid; +} +h1 a, h2 a, h3 a, h4 a, h5 a, h6 a { + color: black; +} +img { + margin-left: 3em; +} +li { + margin-left: 2em; +} +ol { + margin-left: 2em; +} +ol.la { + list-style-type: lower-alpha; +} +ol.ua { + list-style-type: upper-alpha; +} +ol p { + margin-left: 0em; +}<xsl:if test="//xhtml:q"> +q { + font-style: italic; +}</xsl:if> +p { + margin-left: 2em; +} +pre { + font-size: 11pt; + margin-left: 3em; + background-color: lightyellow; + padding: .25em; + page-break-inside: avoid; +}<xsl:if test="//artwork[@x:is-code-component='yes']"> +pre.ccmarker { + background-color: white; + color: gray; +} +pre.ccmarker > span { + font-size: small; +} +pre.cct { + margin-bottom: -1em; +} +pre.ccb { + margin-top: -1em; +}</xsl:if> +pre.text2 { + border-style: dotted; + border-width: 1px; + background-color: #f0f0f0; +} +pre.inline { + background-color: white; + padding: 0em; + page-break-inside: auto;<xsl:if test="$prettyprint-script!=''"> + border: none !important;</xsl:if> +} +pre.text { + border-style: dotted; + border-width: 1px; + background-color: #f8f8f8; +} +pre.drawing { + border-style: solid; + border-width: 1px; + background-color: #f8f8f8; + padding: 2em; +}<xsl:if test="//x:q"> +q { + font-style: italic; +}</xsl:if> +<xsl:if test="//x:sup|sup"> +sup { + font-size: 60%; +}</xsl:if><xsl:if test="sub"> +sub { + font-size: 60%; +}</xsl:if> +table { + margin-left: 2em; +}<xsl:if test="//texttable|//table"> +div.<xsl:value-of select="$css-tt"/> { + margin-left: 2em; +} +table.<xsl:value-of select="$css-tt"/> { + border-collapse: collapse; + border-color: gray; + border-spacing: 0; + vertical-align: top; + } +table.<xsl:value-of select="$css-tt"/> th { + border-color: gray; + padding: 3px; +} +table.<xsl:value-of select="$css-tt"/> td { + border-color: gray; + padding: 3px; +} +table.all { + border-style: solid; + border-width: 2px; +} +table.full { + border-style: solid; + border-width: 2px; +} +table.<xsl:value-of select="$css-tt"/> td { + vertical-align: top; +} +table.all td { + border-style: solid; + border-width: 1px; +} +table.full td { + border-style: none solid; + border-width: 1px; +} +table.<xsl:value-of select="$css-tt"/> th { + vertical-align: top; +} +table.all th { + border-style: solid; + border-width: 1px; +} +table.full th { + border-style: solid; + border-width: 1px 1px 2px 1px; +} +table.headers th { + border-style: none none solid none; + border-width: 2px; +} +table.<xsl:value-of select="$css-tleft"/> { + margin-right: auto; +} +table.<xsl:value-of select="$css-tright"/> { + margin-left: auto; +} +table.<xsl:value-of select="$css-tcenter"/> { + margin-left: auto; + margin-right: auto; +} +caption { + caption-side: bottom; + font-weight: bold; + font-size: 10pt; + margin-top: .5em; +} +<xsl:if test="//@x:caption-side"> +caption.caption-top { + caption-side: top; +} +</xsl:if> +<xsl:if test="//table"> +table:not([class]) th { + background-color: #e9e9e9; +} +table:not([class]) tr:nth-child(2n) > td { + background-color: #f5f5f5; +} +tr p { + margin-left: 0em; +} +tr pre { + margin-left: 1em; +} +tr ol { + margin-left: 1em; +} +tr ul { + margin-left: 1em; +} +tr dl { + margin-left: 1em; +} +</xsl:if> +</xsl:if> +table.<xsl:value-of select="$css-header"/> { + border-spacing: 1px; + width: 95%; + font-size: 11pt; + color: white; +} +td.top { + vertical-align: top; +} +td.topnowrap { + vertical-align: top; + white-space: nowrap; +} +table.<xsl:value-of select="$css-header"/> td { + background-color: gray; + width: 50%; +}<xsl:if test="/rfc/@obsoletes | /rfc/@updates"> +table.<xsl:value-of select="$css-header"/> a { + color: white; +}</xsl:if> +ul.toc, ul.toc ul { + list-style: none; + margin-left: 1.5em; + padding-left: 0em; +} +ul.toc li { + line-height: 150%; + font-weight: bold; + margin-left: 0em; +} +ul.toc li li { + line-height: normal; + font-weight: normal; + font-size: 11pt; + margin-left: 0em; +} +li.excluded { + font-size: 0pt; +} +ul p { + margin-left: 0em; +} +.filename, h1, h2, h3, h4 { + font-family: <xsl:value-of select="$xml2rfc-ext-ff-title"/>; +} +<xsl:if test="$has-index">ul.ind, ul.ind ul { + list-style: none; + margin-left: 1.5em; + padding-left: 0em; + page-break-before: avoid; +} +ul.ind li { + font-weight: bold; + line-height: 200%; + margin-left: 0em; +} +ul.ind li li { + font-weight: normal; + line-height: 150%; + margin-left: 0em; +}<xsl:if test="//svg:svg"> +@namespace svg url(http://www.w3.org/2000/svg); +svg|svg { + margin-left: 3em; +} +svg { + margin-left: 3em; +}</xsl:if> +.avoidbreakinside { + page-break-inside: avoid; +} +.avoidbreakafter { + page-break-after: avoid; +} +</xsl:if><xsl:if test="//*[@removeInRFC='true']">.rfcEditorRemove div:first-of-type { + font-style: italic; +}</xsl:if><xsl:if test="//x:bcp14|//bcp14">.bcp14 { + font-style: normal; + text-transform: lowercase; + font-variant: small-caps; +}</xsl:if><xsl:if test="//x:blockquote|//blockquote"> +blockquote > * .bcp14 { + font-style: italic; +}</xsl:if> +.comment { + background-color: yellow; +}<xsl:if test="$xml2rfc-editing='yes'"> +.editingmark { + background-color: khaki; +}</xsl:if> +.<xsl:value-of select="$css-center"/> { + text-align: center; +} +.<xsl:value-of select="$css-error"/> { + color: red; + font-style: italic; + font-weight: bold; +} +.figure { + font-weight: bold; + text-align: center; + font-size: 10pt; +} +.filename { + color: #333333; + font-size: 112%; + font-weight: bold; + line-height: 21pt; + text-align: center; + margin-top: 0pt; +} +.fn { + font-weight: bold; +} +.<xsl:value-of select="$css-left"/> { + text-align: left; +} +.<xsl:value-of select="$css-right"/> { + text-align: right; +} +.warning { + font-size: 130%; + background-color: yellow; +}<xsl:if test="$xml2rfc-ext-paragraph-links='yes'"> +.self { + color: #999999; + margin-left: .3em; + text-decoration: none; + visibility: hidden; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; +} +.self:hover { + text-decoration: none; +} +li:hover > a.self, p:hover > a.self { + visibility: visible; +}</xsl:if><xsl:if test="$has-edits">del { + color: red; + text-decoration: line-through; +} +.del { + color: red; + text-decoration: line-through; +} +ins { + color: green; + text-decoration: underline; +} +.ins { + color: green; + text-decoration: underline; +} +div.issuepointer { + float: left; +}</xsl:if><xsl:if test="//ed:issue"> +table.openissue { + background-color: khaki; + border-width: thin; + border-style: solid; + border-color: black; +} +table.closedissue { + background-color: white; + border-width: thin; + border-style: solid; + border-color: gray; + color: gray; +} +thead th { + text-align: left; +} +.bg-issue { + border: solid; + border-width: 1px; + font-size: 8pt; +} +.closed-issue { + border: solid; + border-width: thin; + background-color: lime; + font-size: smaller; + font-weight: bold; +} +.open-issue { + border: solid; + border-width: thin; + background-color: red; + font-size: smaller; + font-weight: bold; +} +.editor-issue { + border: solid; + border-width: thin; + background-color: yellow; + font-size: smaller; + font-weight: bold; +}</xsl:if><xsl:if test="$xml2rfc-ext-refresh-from!=''">.refreshxmlerror { + position: fixed; + top: 1%; + right: 1%; + padding: 5px 5px; + color: yellow; + background: black; +} +.refreshbrowsererror { + position: fixed; + top: 1%; + left: 1%; + padding: 5px 5px; + color: red; + background: black; +}</xsl:if><xsl:if test="/rfc/x:feedback">.<xsl:value-of select="$css-feedback"/> { + position: fixed; + bottom: 1%; + right: 1%; + padding: 3px 5px; + color: white; + border-radius: 5px; + background: #006400; + border: 1px solid silver; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; +} +.<xsl:value-of select="$css-fbbutton"/> { + margin-left: 1em; + color: #303030; + font-size: small; + font-weight: normal; + background: #d0d000; + padding: 1px 4px; + border: 1px solid silver; + border-radius: 5px; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; +}</xsl:if><xsl:if test="$xml2rfc-ext-justification='always'"> +dd, li, p { + text-align: justify; +}</xsl:if><xsl:if test="$xml2rfc-ext-insert-metadata='yes' and $rfcno!=''"> +.<xsl:value-of select="$css-docstatus"/> { + border: 1px solid black; + display: none; + float: right; + margin: 2em; + padding: 1em; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; +}</xsl:if><xsl:if test="$errata-parsed"> +.<xsl:value-of select="$css-erratum"/> { + border: 1px solid orangered; + border-left: 0.75em solid orangered; + float: right; + padding: 0.5em; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; +}<xsl:if test="$parsedMaxwidth!=''"> +@media screen and (min-width: <xsl:value-of select="number($parsedMaxwidth + 350)"/>px) { + .<xsl:value-of select="$css-erratum"/> { + margin-right: -150px; + } +}</xsl:if></xsl:if><xsl:if test="$published-as-rfc"> +.<xsl:value-of select="$css-publishedasrfc"/> { + background-color: yellow; + color: green; + font-size: 14pt; + text-align: center; +}</xsl:if> + +@media screen { + pre.text, pre.text2 { + width: 69em; + } +} + +@media print { + .<xsl:value-of select="$css-noprint"/> { + display: none; + } + + a { + color: black; + text-decoration: none; + } + + table.<xsl:value-of select="$css-header"/> { + width: 90%; + } + + td.<xsl:value-of select="$css-header"/> { + width: 50%; + color: black; + background-color: white; + vertical-align: top; + font-size: 110%; + } + + ul.toc a:last-child::after { + content: leader('.') target-counter(attr(href), page); + } + + ul.ind li li a { + content: target-counter(attr(href), page); + } + + pre { + font-size: 10pt; + } + + .print2col { + column-count: 2; + -moz-column-count: 2; + column-fill: auto; + } +<xsl:if test="$xml2rfc-ext-justification='print'"> + dd, li, p { + text-align: justify; + } +</xsl:if>} +@page<xsl:if test="$xml2rfc-ext-duplex='yes'">:right</xsl:if> { + font-family: <xsl:value-of select="$xml2rfc-ext-ff-body"/>; + @top-left { + content: "<xsl:call-template name="get-header-left"/>"; + } + @top-right { + content: "<xsl:call-template name="get-header-right"/>"; + } + @top-center { + content: "<xsl:call-template name="get-header-center"/>"; + } + @bottom-left { + content: "<xsl:call-template name="get-author-summary"/>"; + } + @bottom-center { + content: "<xsl:call-template name="get-bottom-center"/>"; + } + @bottom-right { + content: "[Page " counter(page) "]"; + } +}<xsl:if test="$xml2rfc-ext-duplex='yes'"> +@page:left { + font-family: <xsl:value-of select="$xml2rfc-ext-ff-body"/>; + @top-left { + content: "<xsl:call-template name="get-header-right"/>"; + } + @top-right { + content: "<xsl:call-template name="get-header-left"/>"; + } + @top-center { + content: "<xsl:call-template name="get-header-center"/>"; + } + @bottom-left { + content: "[Page " counter(page) "]"; + } + @bottom-center { + content: "<xsl:call-template name="get-bottom-center"/>"; + } + @bottom-right { + content: "<xsl:call-template name="get-author-summary"/>"; + } +} +</xsl:if> +@page:first { + @top-left { + content: normal; + } + @top-right { + content: normal; + } + @top-center { + content: normal; + } +} +</style> +</xsl:template> + + + + +<xsl:template name="insertSingleIref"> + <xsl:choose> + <xsl:when test="@ed:xref"> +  + <xsl:text>[</xsl:text> + <a href="#{@ed:xref}"><xsl:value-of select="@ed:xref"/></a> + <xsl:text>, </xsl:text> + <a> + <xsl:variable name="htmluri" select="//reference[@anchor=current()/@ed:xref]/format[@type='HTML']/@target"/> + <xsl:if test="$htmluri"> + <xsl:attribute name="href"><xsl:value-of select="concat($htmluri,'#',@ed:frag)"/></xsl:attribute> + </xsl:if> + <xsl:choose> + <xsl:when test="@primary='true'"><b><xsl:value-of select="@ed:label" /></b></xsl:when> + <xsl:otherwise><xsl:value-of select="@ed:label" /></xsl:otherwise> + </xsl:choose> + </a> + <xsl:text>]</xsl:text> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="_n"> + <xsl:call-template name="get-section-number" /> + </xsl:variable> + <xsl:variable name="n"> + <xsl:choose> + <xsl:when test="$_n!=''"> + <xsl:value-of select="$_n"/> + </xsl:when> + <xsl:otherwise>§</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="backlink"> + <xsl:choose> + <xsl:when test="self::xref"> + <xsl:variable name="target" select="@target"/> + <xsl:comment>workaround for Saxon 9.1 bug; force evaluation of: <xsl:value-of select="$target"/></xsl:comment> + <xsl:variable name="no"><xsl:number level="any" count="xref[@target=$target]"/></xsl:variable> + <xsl:text>#</xsl:text> + <xsl:value-of select="$anchor-pref"/> + <xsl:text>xref.</xsl:text> + <xsl:value-of select="@target"/> + <xsl:text>.</xsl:text> + <xsl:value-of select="$no"/> + </xsl:when> + <xsl:when test="self::iref"> + <xsl:text>#</xsl:text> + <xsl:call-template name="compute-iref-anchor"/> + </xsl:when> + <xsl:when test="self::x:ref"> + <xsl:text>#</xsl:text> + <xsl:call-template name="compute-extref-anchor"/> + </xsl:when> + <xsl:otherwise> + <xsl:message>Unsupported element type for insertSingleIref</xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <a href="{$backlink}"> + <xsl:call-template name="insertInsDelClass"/> + <xsl:choose> + <xsl:when test="@primary='true'"><b><xsl:value-of select="$n"/></b></xsl:when> + <xsl:otherwise><xsl:value-of select="$n"/></xsl:otherwise> + </xsl:choose> + </a> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="insertSingleXref"> + <xsl:variable name="_n"> + <xsl:call-template name="get-section-number" /> + </xsl:variable> + <xsl:variable name="n"> + <xsl:choose> + <xsl:when test="$_n!=''"> + <xsl:value-of select="$_n"/> + </xsl:when> + <xsl:otherwise>§</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="self::reference"> + <a href="#{@anchor}"> + <xsl:call-template name="insertInsDelClass"/> + <b><xsl:value-of select="$n"/></b> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="target" select="@target"/> + <xsl:variable name="backlink">#<xsl:value-of select="$anchor-pref"/>xref.<xsl:value-of select="$target"/>.<xsl:number level="any" count="xref[@target=$target]"/></xsl:variable> + <a href="{$backlink}"> + <xsl:call-template name="insertInsDelClass"/> + <xsl:value-of select="$n"/> + </a> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="position()!=last()">, </xsl:if> +</xsl:template> + +<xsl:template name="insertIndex"> + + <xsl:call-template name="insert-conditional-hrule"/> + + <section id="{$anchor-pref}index"> + <xsl:call-template name="insert-conditional-pagebreak"/> + <h2> + <a href="#{$anchor-pref}index">Index</a> + </h2> + +  + <p class="{$css-noprint}"> + <xsl:variable name="irefs" select="//iref[generate-id(.) = generate-id(key('index-first-letter',translate(substring(@item,1,1),$lcase,$ucase))[1])]"/> + <xsl:variable name="xrefs" select="//reference[not(starts-with(@anchor,'deleted-'))][generate-id(.) = generate-id(key('index-first-letter',translate(substring(concat(/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),1,1),$lcase,$ucase))[1])]"/> + + <xsl:for-each select="$irefs | $xrefs"> + + <xsl:sort select="translate(concat(@item,/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),$lcase,$ucase)" /> + + <xsl:variable name="letter" select="translate(substring(concat(@item,/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),1,1),$lcase,$ucase)"/> + +  + <xsl:if test="translate($letter,concat($lcase,$ucase,'0123456789'),'')=''"> + + <xsl:variable name="showit" select="$xml2rfc-ext-include-references-in-index='yes' or $irefs[starts-with(translate(@item,$lcase,$ucase),$letter)]"/> + + <xsl:if test="$showit"> + <a href="#{$anchor-pref}index.{$letter}"> + <xsl:value-of select="$letter" /> + </a> + <xsl:text> </xsl:text> + </xsl:if> + </xsl:if> + </xsl:for-each> + </p> + +  + <div class="print2col"> + <ul class="ind"> + <xsl:variable name="irefs2" select="//iref[generate-id(.) = generate-id(key('index-first-letter',translate(substring(@item,1,1),$lcase,$ucase))[1])]"/> + <xsl:variable name="xrefs2" select="//reference[not(starts-with(@anchor,'deleted-'))][generate-id(.) = generate-id(key('index-first-letter',translate(substring(concat(/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),1,1),$lcase,$ucase))[1])]"/> + + <xsl:for-each select="$irefs2 | $xrefs2"> + <xsl:sort select="translate(concat(@item,/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),$lcase,$ucase)" /> + <xsl:variable name="letter" select="translate(substring(concat(@item,/rfc/back/displayreference[@target=current()/@anchor]/@to,@anchor),1,1),$lcase,$ucase)"/> + + <xsl:variable name="showit" select="$xml2rfc-ext-include-references-in-index='yes' or $irefs2[starts-with(translate(@item,$lcase,$ucase),$letter)]"/> + + <xsl:if test="$showit"> + <li> + +  + <xsl:choose> + <xsl:when test="translate($letter,concat($lcase,$ucase,'0123456789'),'')=''"> + <a id="{$anchor-pref}index.{$letter}" href="#{$anchor-pref}index.{$letter}"> + <b><xsl:value-of select="$letter" /></b> + </a> + </xsl:when> + <xsl:otherwise> + <b><xsl:value-of select="$letter" /></b> + </xsl:otherwise> + </xsl:choose> + + <ul> + <xsl:for-each select="key('index-first-letter',translate(substring(concat(@item,@anchor),1,1),$lcase,$ucase))"> + + <xsl:sort select="translate(concat(@item,@anchor),$lcase,$ucase)" /> + + <xsl:choose> + <xsl:when test="self::reference"> + <xsl:if test="$xml2rfc-ext-include-references-in-index='yes' and not(starts-with(@anchor,'deleted-'))"> + <li> + <xsl:variable name="val"> + <xsl:call-template name="reference-name"/> + </xsl:variable> + <em> + <xsl:value-of select="substring($val,2,string-length($val)-2)"/> + </em> + <xsl:text>  </xsl:text> + + <xsl:variable name="rs" select="key('xref-item',current()/@anchor) | . | key('anchor-item',concat('deleted-',current()/@anchor))"/> + + <xsl:for-each select="$rs"> + <xsl:call-template name="insertSingleXref" /> + </xsl:for-each> + + <xsl:variable name="rs2" select="$rs[@x:sec|@section]"/> + + <xsl:if test="$rs2"> + <ul> + <xsl:for-each select="$rs2"> + <xsl:sort select="substring-before(concat(@x:sec,@section,'.'),'.')" data-type="number"/> + <xsl:sort select="substring(concat(@x:sec,@section),2+string-length(substring-before(concat(@x:sec,@section),'.')))" data-type="number"/> + + <xsl:if test="generate-id(.) = generate-id(key('index-xref-by-sec',concat(@target,'..',@x:sec,@section))[1])"> + <li> + <em> + <xsl:choose> + <xsl:when test="translate(substring(concat(@x:sec,@section),1,1),$ucase,'')=''"> + <xsl:text>Appendix </xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>Section </xsl:text> + </xsl:otherwise> + </xsl:choose> + <xsl:value-of select="@x:sec|@section"/> + </em> + <xsl:text>  </xsl:text> + <xsl:for-each select="key('index-xref-by-sec',concat(@target,'..',@x:sec,@section))"> + <xsl:call-template name="insertSingleXref" /> + </xsl:for-each> + </li> + </xsl:if> + </xsl:for-each> + </ul> + </xsl:if> + + <xsl:if test="current()/x:source/@href"> + <xsl:variable name="rs3" select="$rs[not(@x:sec) and @x:rel]"/> + <xsl:variable name="doc" select="document(current()/x:source/@href)"/> + <xsl:if test="$rs3"> + <ul> + <xsl:for-each select="$rs3"> + <xsl:sort select="count($doc//*[@anchor and following::*/@anchor=substring-after(current()/@x:rel,'#')])" order="ascending" data-type="number"/> + <xsl:if test="generate-id(.) = generate-id(key('index-xref-by-anchor',concat(@target,'..',@x:rel))[1])"> + <li> + <em> + <xsl:variable name="sec"> + <xsl:for-each select="$doc//*[@anchor=substring-after(current()/@x:rel,'#')]"> + <xsl:call-template name="get-section-number"/> + </xsl:for-each> + </xsl:variable> + <xsl:choose> + <xsl:when test="translate(substring($sec,1,1),$ucase,'')=''"> + <xsl:text>Appendix </xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>Section </xsl:text> + </xsl:otherwise> + </xsl:choose> + <xsl:value-of select="$sec"/> + </em> + <xsl:text>  </xsl:text> + <xsl:for-each select="key('index-xref-by-anchor',concat(@target,'..',@x:rel))"> + <xsl:call-template name="insertSingleXref" /> + </xsl:for-each> + </li> + </xsl:if> + </xsl:for-each> + </ul> + </xsl:if> + </xsl:if> + </li> + </xsl:if> + </xsl:when> + <xsl:otherwise> +  + <xsl:if test="generate-id(.) = generate-id(key('index-item',concat(@item,@anchor))[1])"> + <xsl:variable name="item" select="@item"/> + <xsl:variable name="in-artwork" select="key('index-item',$item)[@primary='true' and ancestor::artwork]"/> + + <li> + <xsl:choose> + <xsl:when test="$in-artwork"> + <span class="tt"><xsl:value-of select="@item" /></span> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@item" /> + </xsl:otherwise> + </xsl:choose> + <xsl:text>  </xsl:text> + + <xsl:variable name="irefs3" select="key('index-item',@item)[not(@subitem) or @subitem='']"/> + <xsl:variable name="xrefs3" select="key('xref-item',$irefs3[@x:for-anchor='']/../@anchor) | key('xref-item',$irefs3/@x:for-anchor)"/> + <xsl:variable name="extrefs3" select="key('extref-item',$irefs3[@x:for-anchor='']/../@anchor) | key('extref-item',$irefs3/@x:for-anchor)"/> + + <xsl:for-each select="$irefs3|$xrefs3|$extrefs3"> +  + <xsl:call-template name="insertSingleIref" /> + </xsl:for-each> + + <xsl:variable name="s2" select="key('index-item',@item)[@subitem and @subitem!='']"/> + <xsl:if test="$s2"> + <ul> + <xsl:for-each select="$s2"> + <xsl:sort select="translate(@subitem,$lcase,$ucase)" /> + + <xsl:if test="generate-id(.) = generate-id(key('index-item-subitem',concat(@item,'..',@subitem))[1])"> + + <xsl:variable name="in-artwork2" select="key('index-item-subitem',concat(@item,'..',@subitem))[@primary='true' and ancestor::artwork]" /> + + <li> + + <xsl:choose> + <xsl:when test="$in-artwork2"> + <span class="tt"><xsl:value-of select="@subitem" /></span> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@subitem" /> + </xsl:otherwise> + </xsl:choose> + <xsl:text>  </xsl:text> + + <xsl:variable name="irefs4" select="key('index-item-subitem',concat(@item,'..',@subitem))"/> + <xsl:variable name="xrefs4" select="key('xref-item',$irefs4[@x:for-anchor='']/../@anchor) | key('xref-item',$irefs4/@x:for-anchor)"/> + <xsl:variable name="extrefs4" select="key('extref-item',$irefs4[@x:for-anchor='']/../@anchor) | key('extref-item',$irefs4/@x:for-anchor)"/> + + <xsl:for-each select="$irefs4|$xrefs4|$extrefs4"> +  + <xsl:call-template name="insertSingleIref" /> + </xsl:for-each> + + </li> + </xsl:if> + </xsl:for-each> + </ul> + </xsl:if> + </li> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + + + </xsl:for-each> + </ul> + </li> + </xsl:if> + + </xsl:for-each> + </ul> + </div> + </section> +</xsl:template> + +<xsl:template name="insertPreamble" myns:namespaceless-elements="xml2rfc"> + + <xsl:param name="notes"/> + +<boilerplate> +  + <xsl:variable name="pre5378EscapeClause"> + 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. + </xsl:variable> + +  + <xsl:variable name="noModificationTrust200811Clause"> + This document may not be modified, and derivative works of it may not be + created, except to format it for publication as an RFC and to translate it + into languages other than English. + </xsl:variable> + +  + <xsl:variable name="noModificationTrust200902Clause"> + 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. + </xsl:variable> + +  + <xsl:variable name="noDerivativesTrust200___Clause"> + 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. + </xsl:variable> + + <section anchor="{$anchor-pref}status"> + <name> + <xsl:choose> + <xsl:when test="$xml2rfc-rfcedstyle='yes'">Status of This Memo</xsl:when> + <xsl:otherwise>Status of this Memo</xsl:otherwise> + </xsl:choose> + </name> + + <xsl:choose> + <xsl:when test="@ipr and not(@number)"> + <t> + <xsl:choose> + +  + <xsl:when test="@ipr = 'full2026'"> + This document is an Internet-Draft and is + in full conformance with all provisions of Section 10 of RFC2026. + </xsl:when> + <xsl:when test="@ipr = 'noDerivativeWorks2026'"> + This document is an Internet-Draft and is + in full conformance with all provisions of Section 10 of RFC2026 + except that the right to produce derivative works is not granted. + </xsl:when> + <xsl:when test="@ipr = 'noDerivativeWorksNow'"> + This document is an Internet-Draft and is + in full conformance with all provisions of Section 10 of RFC2026 + except that the right to produce derivative works is not granted. + (If this document becomes part of an IETF working group activity, + then it will be brought into full compliance with Section 10 of RFC2026.) + </xsl:when> + <xsl:when test="@ipr = 'none'"> + This document is an Internet-Draft and is + NOT offered in accordance with Section 10 of RFC2026, + and the author does not provide the IETF with any rights other + than to publish as an Internet-Draft. + </xsl:when> + +  + <xsl:when test="@ipr = 'full3667'"> + This document is an Internet-Draft and is subject to all provisions + of section 3 of RFC 3667. By submitting this Internet-Draft, each + author represents that any applicable patent or other IPR claims of + which he or she is aware have been or will be disclosed, and any of + which he or she become aware will be disclosed, in accordance with + RFC 3668. + </xsl:when> + <xsl:when test="@ipr = 'noModification3667'"> + This document is an Internet-Draft and is subject to all provisions + of section 3 of RFC 3667. By submitting this Internet-Draft, each + author represents that any applicable patent or other IPR claims of + which he or she is aware have been or will be disclosed, and any of + which he or she become aware will be disclosed, in accordance with + RFC 3668. This document may not be modified, and derivative works of + it may not be created, except to publish it as an RFC and to + translate it into languages other than English<xsl:if test="@iprExtract">, + other than to extract <xref target="{@iprExtract}"/> as-is + for separate use</xsl:if>. + </xsl:when> + <xsl:when test="@ipr = 'noDerivatives3667'"> + This document is an Internet-Draft and is subject to all provisions + of section 3 of RFC 3667 except for the right to produce derivative + works. By submitting this Internet-Draft, each author represents + that any applicable patent or other IPR claims of which he or she + is aware have been or will be disclosed, and any of which he or she + become aware will be disclosed, in accordance with RFC 3668. This + document may not be modified, and derivative works of it may + not be created<xsl:if test="@iprExtract">, other than to extract + <xref target="{@iprExtract}"/> as-is for separate use</xsl:if>. + </xsl:when> + +  + <xsl:when test="@ipr = 'full3978'"> + By submitting this Internet-Draft, each + author represents that any applicable patent or other IPR claims of + which he or she is aware have been or will be disclosed, and any of + which he or she becomes aware will be disclosed, in accordance with + Section 6 of BCP 79. + </xsl:when> + <xsl:when test="@ipr = 'noModification3978'"> + By submitting this Internet-Draft, each + author represents that any applicable patent or other IPR claims of + which he or she is aware have been or will be disclosed, and any of + which he or she becomes aware will be disclosed, in accordance with + Section 6 of BCP 79. This document may not be modified, and derivative works of + it may not be created, except to publish it as an RFC and to + translate it into languages other than English<xsl:if test="@iprExtract">, + other than to extract <xref target="{@iprExtract}"/> as-is + for separate use</xsl:if>. + </xsl:when> + <xsl:when test="@ipr = 'noDerivatives3978'"> + By submitting this Internet-Draft, each author represents + that any applicable patent or other IPR claims of which he or she + is aware have been or will be disclosed, and any of which he or she + becomes aware will be disclosed, in accordance with Section 6 of BCP 79. This + document may not be modified, and derivative works of it may + not be created<xsl:if test="@iprExtract">, other than to extract + <xref target="{@iprExtract}"/> as-is for separate use</xsl:if>. + </xsl:when> + +  + <xsl:when test="$ipr-2010-01 and (@ipr = 'trust200902' + or @ipr = 'noModificationTrust200902' + or @ipr = 'noDerivativesTrust200902' + or @ipr = 'pre5378Trust200902')"> + This Internet-Draft is submitted in full conformance with + the provisions of BCP 78 and BCP 79. + </xsl:when> + +  + <xsl:when test="@ipr = 'trust200811' + or @ipr = 'noModificationTrust200811' + or @ipr = 'noDerivativesTrust200811' + or @ipr = 'trust200902' + or @ipr = 'noModificationTrust200902' + or @ipr = 'noDerivativesTrust200902' + or @ipr = 'pre5378Trust200902'"> + This Internet-Draft is submitted to IETF in full conformance with + the provisions of BCP 78 and BCP 79. + </xsl:when> + <xsl:otherwise> + CONFORMANCE UNDEFINED. + </xsl:otherwise> + </xsl:choose> + +  + <xsl:if test="@iprExtract and (@ipr != 'noModification3667' and @ipr != 'noDerivatives3667' and @ipr != 'noModification3978' and @ipr != 'noDerivatives3978')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('/rfc/@iprExtract does not have any effect for /rfc/@ipr=',@ipr)"/> + </xsl:call-template> + </xsl:if> + +  + <xsl:choose> + <xsl:when test="@ipr = 'noModificationTrust200811'"> + <xsl:value-of select="$noModificationTrust200811Clause"/> + </xsl:when> + <xsl:when test="@ipr = 'noDerivativesTrust200811'"> + <xsl:value-of select="$noDerivativesTrust200___Clause"/> + </xsl:when> + <xsl:when test="@ipr = 'noModificationTrust200902'"> + <xsl:value-of select="$noModificationTrust200902Clause"/> + </xsl:when> + <xsl:when test="@ipr = 'noDerivativesTrust200902'"> + <xsl:value-of select="$noDerivativesTrust200___Clause"/> + </xsl:when> +  + <xsl:when test="@ipr = 'pre5378Trust200902' and $pub-yearmonth < 200911"> + <xsl:value-of select="$pre5378EscapeClause"/> + </xsl:when> + + <xsl:otherwise /> + </xsl:choose> + </t> + <xsl:choose> + <xsl:when test="$id-boilerplate='2010'"> + <t> + Internet-Drafts are working documents of the Internet Engineering + Task Force (IETF). Note that other groups may also distribute + working documents as Internet-Drafts. The list of current + Internet-Drafts is at <eref target='http://datatracker.ietf.org/drafts/current/'>http://datatracker.ietf.org/drafts/current/</eref>. + </t> + </xsl:when> + <xsl:otherwise> + <t> + Internet-Drafts are working documents of the Internet Engineering + Task Force (IETF), its areas, and its working groups. + Note that other groups may also distribute working documents as + Internet-Drafts. + </t> + </xsl:otherwise> + </xsl:choose> + <t> + Internet-Drafts are draft documents valid for a maximum of six months + and may be updated, replaced, or obsoleted by other documents at any time. + It is inappropriate to use Internet-Drafts as reference material or to cite + them other than as “work in progress”. + </t> + <xsl:if test="$id-boilerplate=''"> + <t> + The list of current Internet-Drafts can be accessed at + <eref target='http://www.ietf.org/ietf/1id-abstracts.txt'>http://www.ietf.org/ietf/1id-abstracts.txt</eref>. + </t> + <t> + The list of Internet-Draft Shadow Directories can be accessed at + <eref target='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</eref>. + </t> + </xsl:if> + <t> + This Internet-Draft will expire <xsl:call-template name="expirydate"><xsl:with-param name="in-prose" select="true()"/></xsl:call-template>. + </t> + </xsl:when> + + <xsl:when test="@category='bcp' and $rfc-boilerplate='2010'"> + <t> + This memo documents an Internet Best Current Practice. + </t> + </xsl:when> + <xsl:when test="@category='bcp'"> + <t> + This document specifies an Internet Best Current Practices for the Internet + Community, and requests discussion and suggestions for improvements. + Distribution of this memo is unlimited. + </t> + </xsl:when> + <xsl:when test="@category='exp' and $rfc-boilerplate='2010'"> + <t> + This document is not an Internet Standards Track specification; it is + published for examination, experimental implementation, and evaluation. + </t> + </xsl:when> + <xsl:when test="@category='exp'"> + <t> + This memo defines an Experimental Protocol for the Internet community. + It does not specify an Internet standard of any kind. + Discussion and suggestions for improvement are requested. + Distribution of this memo is unlimited. + </t> + </xsl:when> + <xsl:when test="@category='historic' and $rfc-boilerplate='2010'"> + <t> + This document is not an Internet Standards Track specification; it is + published for the historical record. + </t> + </xsl:when> + <xsl:when test="@category='historic'"> + <t> + This memo describes a historic protocol for the Internet community. + It does not specify an Internet standard of any kind. + Distribution of this memo is unlimited. + </t> + </xsl:when> + <xsl:when test="@category='std' and $rfc-boilerplate='2010'"> + <t> + This is an Internet Standards Track document. + </t> + </xsl:when> + <xsl:when test="@category='std'"> + <t> + This document specifies an Internet standards track protocol for the Internet + community, and requests discussion and suggestions for improvements. + Please refer to the current edition of the “Internet Official Protocol + Standards” (STD 1) for the standardization state and status of this + protocol. Distribution of this memo is unlimited. + </t> + </xsl:when> + <xsl:when test="(@category='info' or not(@category)) and $rfc-boilerplate='2010'"> + <t> + This document is not an Internet Standards Track specification; it is + published for informational purposes. + </t> + </xsl:when> + <xsl:when test="@category='info' or not(@category)"> + <t> + This memo provides information for the Internet community. + It does not specify an Internet standard of any kind. + Distribution of this memo is unlimited. + </t> + </xsl:when> + <xsl:otherwise> + <t> + UNSUPPORTED CATEGORY. + </t> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unsupported value for /rfc/@category: ', @category)"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +  + <xsl:if test="$rfc-boilerplate='2010' and @number"> + <t> + <xsl:if test="@category='exp'"> + This document defines an Experimental Protocol for the Internet + community. + </xsl:if> + <xsl:if test="@category='historic'"> + This document defines a Historic Document for the Internet community. + </xsl:if> + <xsl:choose> + <xsl:when test="$submissionType='IETF'"> + This document is a product of the Internet Engineering Task Force + (IETF). + <xsl:choose> + <xsl:when test="$consensus='yes'"> + It represents the consensus of the IETF community. It has + received public review and has been approved for publication by + the Internet Engineering Steering Group (IESG). + </xsl:when> + <xsl:otherwise> + It has been approved for publication by the Internet Engineering + Steering Group (IESG). +  + <xsl:if test="@category='std' or @category='bcp'"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'IETF BCPs and Standards Track documents require IETF consensus, check values of @category and @consensus!'"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$submissionType='IAB'"> + This document is a product of the Internet Architecture Board (IAB) + and represents information that the IAB has deemed valuable to + provide for permanent record. + <xsl:if test="$consensus='yes'"> + It represents the consensus of the Internet Architecture Board (IAB). + </xsl:if> + </xsl:when> + <xsl:when test="$submissionType='IRTF'"> + This document is a product of the Internet Research Task Force (IRTF). + The IRTF publishes the results of Internet-related research and + development activities. These results might not be suitable for + deployment. + <xsl:choose> + <xsl:when test="$consensus='yes' and front/workgroup!=''"> + This RFC represents the consensus of the + <xsl:value-of select="front/workgroup"/> Research Group of the Internet + Research Task Force (IRTF). + </xsl:when> + <xsl:when test="$consensus='no' and front/workgroup!=''"> + This RFC represents the individual opinion(s) of one or more + members of the <xsl:value-of select="front/workgroup"/> Research Group of the + Internet Research Task Force (IRTF). + </xsl:when> + <xsl:otherwise> +  + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$submissionType='independent'"> + This is a contribution to the RFC Series, independently of any other + RFC stream. The RFC Editor has chosen to publish this document at + its discretion and makes no statement about its value for + implementation or deployment. + </xsl:when> + <xsl:otherwise> +  + <xsl:value-of select="$submissionType"/> + </xsl:otherwise> + </xsl:choose> + <xsl:choose> + <xsl:when test="$submissionType='IETF'"> + <xsl:choose> + <xsl:when test="@category='bcp'"> + Further information on BCPs is available in <xsl:value-of select="$hab-reference"/>. + </xsl:when> + <xsl:when test="@category='std'"> + Further information on Internet Standards is available in <xsl:value-of select="$hab-reference"/>. + </xsl:when> + <xsl:otherwise> + Not all documents approved by the IESG are a candidate for any + level of Internet Standard; see <xsl:value-of select="$hab-reference"/>. + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="approver"> + <xsl:choose> + <xsl:when test="$submissionType='IAB'">IAB</xsl:when> + <xsl:when test="$submissionType='IRTF'">IRSG</xsl:when> + <xsl:otherwise>RFC Editor</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + Documents approved for publication by the + <xsl:value-of select="$approver"/> are not a candidate for any level + of Internet Standard; see <xsl:value-of select="$hab-reference"/>. + </xsl:otherwise> + </xsl:choose> + </t> + <t> + Information about the current status of this document, any errata, and + how to provide feedback on it may be obtained at + <eref target="http://www.rfc-editor.org/info/rfc{@number}">http://www.rfc-editor.org/info/rfc<xsl:value-of select="@number"/></eref>. + </t> + </xsl:if> + + </section> + +  + <xsl:copy-of select="$notes"/> + + <xsl:choose> + <xsl:when test="$ipr-2008-11"> + <section anchor="{$anchor-pref}copyrightnotice"> + <name>Copyright Notice</name> + <t> + Copyright © <xsl:value-of select="$xml2rfc-ext-pub-year" /> IETF Trust and the persons identified + as the document authors. All rights reserved. + </t> + <xsl:choose> + <xsl:when test="$ipr-2010-01"> + <t> + This document is subject to BCP 78 and the IETF Trust's Legal + Provisions Relating to IETF Documents (<eref target="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</eref>) + in effect on the date of publication of this document. Please + review these documents carefully, as they describe your rights + and restrictions with respect to this document. + <xsl:if test="$submissionType='IETF'"> + Code Components extracted from this document must include + Simplified BSD License text as described in Section 4.e of the + Trust Legal Provisions and are provided without warranty as + described in the Simplified BSD License. + </xsl:if> + </t> + </xsl:when> + <xsl:when test="$ipr-2009-09"> + <t> + This document is subject to BCP 78 and the IETF Trust's Legal + Provisions Relating to IETF Documents (<eref target="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</eref>) + in effect on the date of publication of this document. Please + review these documents carefully, as they describe your rights + and restrictions with respect to this document. Code Components + extracted from this document must include Simplified BSD License + text as described in Section 4.e of the Trust Legal Provisions + and are provided without warranty as described in the BSD License. + </t> + </xsl:when> + <xsl:when test="$ipr-2009-02"> + <t> + This document is subject to BCP 78 and the IETF Trust's Legal + Provisions Relating to IETF Documents in effect on the date of + publication of this document + (<eref target="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</eref>). + Please review these documents carefully, as they describe your rights and restrictions with + respect to this document. + </t> + </xsl:when> + <xsl:otherwise> + <t> + This document is subject to BCP 78 and the IETF Trust's Legal + Provisions Relating to IETF Documents + (<eref target="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</eref>) in effect on the date of + publication of this document. Please review these documents + carefully, as they describe your rights and restrictions with respect + to this document. + </t> + </xsl:otherwise> + </xsl:choose> + +  + <xsl:variable name="stds-rfc-compatible-ipr" + select="@ipr='pre5378Trust200902' or @ipr='trust200902' or @ipr='trust200811' or @ipr='full3978' or @ipr='full3667' or @ipr='full2026'"/> + + <xsl:variable name="rfc-compatible-ipr" + select="$stds-rfc-compatible-ipr or @ipr='noModificationTrust200902' or @ipr='noDerivativesTrust200902' or @ipr='noModificationTrust200811' or @ipr='noDerivativesTrust200811'"/> +  + + <xsl:variable name="is-stds-track" + select="$submissionType='IETF' and @category='std'"/> + + <xsl:variable name="status-diags"> + <xsl:choose> + <xsl:when test="$is-stds-track and @number and @ipr and not($stds-rfc-compatible-ipr)"> + <xsl:value-of select="concat('The /rfc/@ipr attribute value of ',@ipr,' is not allowed on standards-track RFCs.')"/> + </xsl:when> + <xsl:when test="@number and @ipr and not($rfc-compatible-ipr)"> + <xsl:value-of select="concat('The /rfc/@ipr attribute value of ',@ipr,' is not allowed on RFCs.')"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$status-diags!=''"> + <t> + <spanx><xsl:value-of select="$status-diags"/></spanx> + </t> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="$status-diags"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="(@number or $pub-yearmonth >= 200911) and @ipr = 'pre5378Trust200902'"> +  +  + <t> + <xsl:value-of select="$pre5378EscapeClause"/> + </t> + </xsl:when> + <xsl:when test="not(@number)"> +  + </xsl:when> + <xsl:when test="not(@ipr)"> +  + </xsl:when> + <xsl:when test="@ipr='trust200902' or @ipr='trust200811' or @ipr='full3978' or @ipr='full3667' or @ipr='full2026'"> +  + </xsl:when> + <xsl:when test="@ipr='noModificationTrust200811'"> + <t> + <xsl:value-of select="$noModificationTrust200811Clause"/> + </t> + </xsl:when> + <xsl:when test="@ipr='noModificationTrust200902'"> + <t> + <xsl:value-of select="$noModificationTrust200902Clause"/> + </t> + </xsl:when> + <xsl:when test="@ipr='noDerivativesTrust200902' or @ipr='noDerivativesTrust200811'"> + <t> + <xsl:value-of select="$noDerivativesTrust200___Clause"/> + </t> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="msg" select="concat('unexpected value of /rfc/@ipr for this type of document: ',@ipr)"/> + <t> + <spanx><xsl:value-of select="$msg"/></spanx> + </t> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="inline" select="'no'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + + </section> + </xsl:when> + <xsl:when test="$ipr-2007-08"> +  + </xsl:when> + <xsl:when test="$ipr-rfc4748"> + <section anchor="{$anchor-pref}copyrightnotice"> + <name>Copyright Notice</name> + <t> + Copyright © The IETF Trust (<xsl:value-of select="$xml2rfc-ext-pub-year" />). All Rights Reserved. + </t> + </section> + </xsl:when> + <xsl:otherwise> + <section anchor="{$anchor-pref}copyrightnotice"> + <name>Copyright Notice</name> + <t> + Copyright © The Internet Society (<xsl:value-of select="$xml2rfc-ext-pub-year" />). All Rights Reserved. + </t> + </section> + </xsl:otherwise> + </xsl:choose> +</boilerplate> + +</xsl:template> + + + +<xsl:template match="/" mode="toc"> + <hr class="{$css-noprint}"/> + + <nav id="{$anchor-pref}toc"> + <xsl:call-template name="insert-errata"> + <xsl:with-param name="section" select="'toc'"/> + </xsl:call-template> + + <h2 class="np">  + <a href="#{$anchor-pref}toc">Table of Contents</a> + </h2> + + <ul class="toc"> + <xsl:apply-templates mode="toc" /> + </ul> + </nav> +</xsl:template> + +<xsl:template name="insert-toc-line"> + <xsl:param name="number" /> + <xsl:param name="target" /> + <xsl:param name="title" /> + <xsl:param name="name" /> + <xsl:param name="tocparam" /> + <xsl:param name="oldtitle" /> + <xsl:param name="waschanged" /> + + <xsl:variable name="depth"> +  + <xsl:choose> + <xsl:when test="starts-with($number,'unnumbered-')"> + <xsl:value-of select="string-length(translate(substring-after($number,'unnumbered-'),'.ABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890§','.'))"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="string-length(translate($number,'.ABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890§','.'))"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + +  + <xsl:choose> + <xsl:when test="(not($tocparam) or $tocparam='' or $tocparam='default') and $depth >= $parsedTocDepth"> +  + <xsl:attribute name="class">excluded</xsl:attribute> + </xsl:when> + <xsl:when test="$tocparam='exclude'"> +  + <xsl:attribute name="class">excluded</xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="starts-with($number,'del-')"> + <del> + <xsl:value-of select="$number" /> + <a href="#{$target}"><xsl:value-of select="$title"/></a> + </del> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$number != '' and not(contains($number,'unnumbered-'))"> + <a href="#{$anchor-pref}section.{$number}"> + <xsl:call-template name="emit-section-number"> + <xsl:with-param name="no" select="$number"/> + </xsl:call-template> + </a> + <xsl:text>   </xsl:text> + </xsl:if> + <a href="#{$target}"> + <xsl:choose> + <xsl:when test="$waschanged!=''"> + <ins><xsl:value-of select="$title"/></ins> + <del><xsl:value-of select="$oldtitle"/></del> + </xsl:when> + <xsl:when test="$name"> + <xsl:call-template name="render-name-ref"> + <xsl:with-param name="n" select="$name/node()"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$title"/> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="back-toc"> + + <xsl:if test="//cref and $xml2rfc-comments='yes' and $xml2rfc-inline!='yes'"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="target" select="concat($anchor-pref,'comments')"/> + <xsl:with-param name="title" select="'Editorial Comments'"/> + </xsl:call-template> + </li> + </xsl:if> + + <xsl:if test="$xml2rfc-ext-authors-section='before-appendices'"> + <xsl:apply-templates select="/rfc/front" mode="toc" /> + </xsl:if> + <xsl:apply-templates select="back/*[not(self::references)]" mode="toc" /> + +  + <xsl:if test="$has-index"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="target" select="concat($anchor-pref,'index')"/> + <xsl:with-param name="title" select="'Index'"/> + </xsl:call-template> + </li> + </xsl:if> + + <xsl:if test="$xml2rfc-ext-authors-section='end'"> + <xsl:apply-templates select="/rfc/front" mode="toc" /> + </xsl:if> + +  + <xsl:if test="$xml2rfc-private='' and not($no-copylong)"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="target" select="concat($anchor-pref,'ipr')"/> + <xsl:with-param name="title" select="'Intellectual Property and Copyright Statements'"/> + </xsl:call-template> + </li> + </xsl:if> + +</xsl:template> + +<xsl:template match="front" mode="toc"> + + <xsl:variable name="authors-title"> + <xsl:call-template name="get-authors-section-title"/> + </xsl:variable> + <xsl:variable name="authors-number"> + <xsl:call-template name="get-authors-section-number"/> + </xsl:variable> + + <xsl:if test="$authors-number!='suppress' and $xml2rfc-authorship!='no'"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="target" select="concat($anchor-pref,'authors')"/> + <xsl:with-param name="title" select="$authors-title"/> + <xsl:with-param name="number" select="$authors-number"/> + </xsl:call-template> + </li> + </xsl:if> + +</xsl:template> + +<xsl:template name="references-toc"> + +  + + <xsl:variable name="refsecs" select="/rfc/back/references|/rfc/back/ed:replace/ed:ins/references"/> + + <xsl:choose> + <xsl:when test="count($refsecs) = 0"> +  + </xsl:when> + <xsl:when test="count($refsecs) = 1"> + <xsl:for-each select="$refsecs"> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="@title!=''"><xsl:value-of select="@title" /></xsl:when> + <xsl:otherwise><xsl:value-of select="$xml2rfc-refparent"/></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="number"> + <xsl:call-template name="get-references-section-number"/> + </xsl:with-param> + <xsl:with-param name="target" select="concat($anchor-pref,'references')"/> + <xsl:with-param name="title" select="$title"/> + <xsl:with-param name="name" select="name"/> + </xsl:call-template> + </li> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <li> +  + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="number"> + <xsl:call-template name="get-references-section-number"/> + </xsl:with-param> + <xsl:with-param name="target" select="concat($anchor-pref,'references')"/> + <xsl:with-param name="title" select="$xml2rfc-refparent"/> + </xsl:call-template> + + <ul> +  + <xsl:for-each select="$refsecs"> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="@title!=''"><xsl:value-of select="@title" /></xsl:when> + <xsl:otherwise><xsl:value-of select="$xml2rfc-refparent"/></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="sectionNumber"> + <xsl:call-template name="get-section-number" /> + </xsl:variable> + + <xsl:variable name="num"> + <xsl:number level="any"/> + </xsl:variable> + + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="number" select="$sectionNumber"/> + <xsl:with-param name="target" select="concat($anchor-pref,'references','.',$num)"/> + <xsl:with-param name="title" select="$title"/> + <xsl:with-param name="name" select="name"/> + </xsl:call-template> + </li> + </xsl:for-each> + </ul> + </li> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="section|appendix" mode="toc"> + <xsl:variable name="sectionNumber"> + <xsl:call-template name="get-section-number" /> + </xsl:variable> + + <xsl:variable name="target"> + <xsl:choose> + <xsl:when test="@anchor"><xsl:value-of select="@anchor" /></xsl:when> + <xsl:otherwise><xsl:value-of select="$anchor-pref"/>section.<xsl:value-of select="$sectionNumber" /></xsl:otherwise> + </xsl:choose> + </xsl:variable> + +  + <xsl:variable name="content"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="number" select="$sectionNumber"/> + <xsl:with-param name="target" select="$target"/> + <xsl:with-param name="title" select="@title"/> + <xsl:with-param name="name" select="name"/> + <xsl:with-param name="tocparam" select="@toc"/> + <xsl:with-param name="oldtitle" select="@ed:old-title"/> + <xsl:with-param name="waschanged" select="@ed:resolves"/> + </xsl:call-template> + + <ul> + <xsl:apply-templates mode="toc" /> + </ul> + </li> + </xsl:variable> + + <xsl:if test="$content!=''"> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="number" select="$sectionNumber"/> + <xsl:with-param name="target" select="$target"/> + <xsl:with-param name="title" select="@title"/> + <xsl:with-param name="name" select="name"/> + <xsl:with-param name="tocparam" select="@toc"/> + <xsl:with-param name="oldtitle" select="@ed:old-title"/> + <xsl:with-param name="waschanged" select="@ed:resolves"/> + </xsl:call-template> + +  + <xsl:variable name="nested-content"> + <ul> + <xsl:apply-templates mode="toc" /> + </ul> + </xsl:variable> + +  + <xsl:if test="$nested-content!=''"> + <ul> + <xsl:apply-templates mode="toc" /> + </ul> + </xsl:if> + </li> + </xsl:if> +</xsl:template> + +<xsl:template match="middle" mode="toc"> + <xsl:apply-templates mode="toc" /> + <xsl:call-template name="references-toc" /> +</xsl:template> + +<xsl:template match="rfc" mode="toc"> + <xsl:apply-templates select="middle" mode="toc" /> + <xsl:call-template name="back-toc" /> +</xsl:template> + +<xsl:template match="ed:del|ed:ins|ed:replace" mode="toc"> + <xsl:apply-templates mode="toc" /> +</xsl:template> + +<xsl:template match="*|text()" mode="toc" /> + + +<xsl:template name="insertTocAppendix"> + + <xsl:if test="//figure[@title!='' or @anchor!='']"> + <ul class="toc"> + <li>Figures + <ul> + <xsl:for-each select="//figure[@title!='' or @anchor!='']"> + <xsl:variable name="n"><xsl:call-template name="get-figure-number"/></xsl:variable> + <xsl:variable name="title"> + <xsl:if test="not(starts-with($n,'u'))"> + <xsl:text>Figure </xsl:text> + <xsl:value-of select="$n"/> + <xsl:if test="@title!=''">: </xsl:if> + </xsl:if> + <xsl:if test="@title"><xsl:value-of select="@title"/></xsl:if> + </xsl:variable> + <li> + <xsl:call-template name="insert-toc-line"> + <xsl:with-param name="target" select="concat($anchor-pref,'figure.',$n)" /> + <xsl:with-param name="title" select="$title" /> + </xsl:call-template> + </li> + </xsl:for-each> + </ul> + </li> + </ul> + </xsl:if> + +  + <xsl:if test="//ed:issue"> + <xsl:call-template name="insertIssuesList" /> + </xsl:if> + +</xsl:template> + +<xsl:template name="reference-name"> + <xsl:param name="node" select="."/> + + <xsl:for-each select="$node"> + <xsl:choose> + <xsl:when test="$xml2rfc-symrefs!='no' and ancestor::ed:del"> + <xsl:variable name="unprefixed" select="substring-after(@anchor,'deleted-')"/> + <xsl:choose> + <xsl:when test="$unprefixed!=''"> + <xsl:value-of select="concat('[',$unprefixed,']')"/> + </xsl:when> + <xsl:otherwise> + <xsl:if test="count(//reference[@anchor=current()/@anchor])!=1"> + <xsl:message>Deleted duplicate anchors should have the prefix "deleted-": <xsl:value-of select="@anchor"/></xsl:message> + </xsl:if> + <xsl:value-of select="concat('[',@anchor,']')"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$xml2rfc-symrefs!='no'"> + <xsl:text>[</xsl:text> + <xsl:choose> + <xsl:when test="/rfc/back/displayreference[@target=current()/@anchor]"> + <xsl:value-of select="/rfc/back/displayreference[@target=current()/@anchor]/@to"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@anchor"/> + </xsl:otherwise> + </xsl:choose> + <xsl:text>]</xsl:text> + </xsl:when> + <xsl:when test="ancestor::ed:del"> + <xsl:text>[del]</xsl:text> + </xsl:when> + <xsl:otherwise>[<xsl:number level="any" count="reference[not(ancestor::ed:del)]"/>]</xsl:otherwise> + </xsl:choose> + </xsl:for-each> +</xsl:template> + + + +<xsl:template name="replace-substring"> + <xsl:param name="string" /> + <xsl:param name="replace" /> + <xsl:param name="by" /> + + <xsl:choose> + <xsl:when test="contains($string,$replace)"> + <xsl:value-of select="concat(substring-before($string, $replace),$by)" /> + <xsl:call-template name="replace-substring"> + <xsl:with-param name="string" select="substring-after($string,$replace)" /> + <xsl:with-param name="replace" select="$replace" /> + <xsl:with-param name="by" select="$by" /> + </xsl:call-template> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$string" /></xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="rfc-or-id-link"> + <xsl:param name="name" /> + + <xsl:choose> + <xsl:when test="starts-with($name,'draft-')"> + <xsl:variable name="uri"> + <xsl:call-template name="compute-internet-draft-uri"> + <xsl:with-param name="internet-draft" select="$name"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}"><xsl:value-of select="$name"/></a> + <xsl:call-template name="check-front-matter-ref"> + <xsl:with-param name="name" select="$name"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="string(number($name))=$name"> + <xsl:variable name="uri"> + <xsl:call-template name="compute-rfc-uri"> + <xsl:with-param name="rfc" select="$name"/> + </xsl:call-template> + </xsl:variable> + <a href="{$uri}"><xsl:value-of select="$name"/></a> + <xsl:call-template name="check-front-matter-ref"> + <xsl:with-param name="name" select="$name"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$name"/> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('In metadata obsoletes/updates, RFC number of draft name is expected - found: ',$name)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="rfclist"> + <xsl:param name="list" /> + <xsl:choose> + <xsl:when test="contains($list,',')"> + <xsl:variable name="rfcNo" select="substring-before($list,',')" /> + <xsl:call-template name="rfc-or-id-link"> + <xsl:with-param name="name" select="$rfcNo"/> + </xsl:call-template> + <xsl:text>, </xsl:text> + <xsl:call-template name="rfclist"> + <xsl:with-param name="list" select="normalize-space(substring-after($list,','))" /> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="rfcNo" select="$list" /> + <xsl:call-template name="rfc-or-id-link"> + <xsl:with-param name="name" select="$rfcNo"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="check-front-matter-ref"> + <xsl:param name="name"/> + <xsl:choose> + <xsl:when test="starts-with($name,'draft-')"> + <xsl:if test="not(//references//reference//seriesInfo[@name='Internet-Draft' and @value=$name])"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('front matter mentions I-D ',$name,' for which there is no reference element')"/> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:if test="not(//references//reference//seriesInfo[@name='RFC' and @value=$name])"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat('front matter mentions RFC ',$name,' for which there is no reference element')"/> + </xsl:call-template> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="check-anchor"> + <xsl:if test="@anchor and @anchor!=''"> +  + <xsl:variable name="t" select="@anchor"/> + <xsl:variable name="tstart" select="substring($t,1,1)"/> + +  + <xsl:variable name="not-namestartchars">	
 !"#$%&'()*+,-./0123456789;<=>?@[\]^`[|}~</xsl:variable> + + <xsl:if test="$tstart!=translate($tstart,$not-namestartchars,'')"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('anchor "',$t,'" can not start with character "',$tstart,'"')"/> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="check-anchor-non-start"> + <xsl:with-param name="f" select="$t"/> + <xsl:with-param name="t" select="$t"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template name="check-anchor-non-start"> + <xsl:param name="f"/> + <xsl:param name="t"/> + + <xsl:variable name="not-namechars">	
 !"#$%&'()*+,/;<=>?@[\]^`[|}~</xsl:variable> + + <xsl:choose> + <xsl:when test="$t=''"> +  + </xsl:when> + <xsl:otherwise> + <xsl:variable name="s" select="substring($t,1,1)"/> + <xsl:choose> + <xsl:when test="$s!=translate($s,$not-namechars,'')"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('anchor "',$f,'" contains invalid character "',$s,'" at position ',string-length($f) - string-length($t))"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="check-anchor-non-start"> + <xsl:with-param name="f" select="$f"/> + <xsl:with-param name="t" select="substring($t,2)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="sluggy-anchor"> + <xsl:if test="self::section and (not(@anchor) or @anchor='')"> + <xsl:variable name="fr">ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789.()+-_ :%,/=@<></xsl:variable> + <xsl:variable name="to">abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz0123456789.----_---------</xsl:variable> + <xsl:variable name="canslug" select="translate(normalize-space(concat(@title,name)),$fr,'')=''"/> + <xsl:if test="$canslug"> + <xsl:variable name="slug" select="translate(normalize-space(concat(@title,name)),$fr,$to)"/> + <xsl:variable name="conflicts" select="//section[not(@anchor) and $slug=translate(normalize-space(concat(@title,name)),$fr,$to)]"/> + <xsl:choose> + <xsl:when test="count($conflicts)>1"> + <xsl:variable name="c" select="preceding::*[not(@anchor) and $slug=translate(normalize-space(concat(@title,name)),$fr,$to)]"/> + <xsl:value-of select="concat('n-',$slug,'_',(1+count($c)))"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('n-',$slug)"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:if> +</xsl:template> + +<xsl:template name="copy-anchor"> + <xsl:call-template name="check-anchor"/> + <xsl:choose> + <xsl:when test="@anchor and @anchor!=''"> + <xsl:attribute name="id"><xsl:value-of select="@anchor"/></xsl:attribute> + </xsl:when> + <xsl:when test="self::section"> + <xsl:variable name="slug"> + <xsl:call-template name="sluggy-anchor"/> + </xsl:variable> + <xsl:if test="$slug!=''"> + <xsl:attribute name="id"><xsl:value-of select="$slug"/></xsl:attribute> + </xsl:if> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:template> + +<xsl:template name="rfclist-for-dcmeta"> + <xsl:param name="list" /> + <xsl:choose> + <xsl:when test="contains($list,',')"> + <xsl:variable name="rfcNo" select="substring-before($list,',')" /> + <meta name="dct.replaces" content="urn:ietf:rfc:{$rfcNo}" /> + <xsl:call-template name="rfclist-for-dcmeta"> + <xsl:with-param name="list" select="normalize-space(substring-after($list,','))" /> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="rfcNo" select="$list" /> + <meta name="dct.replaces" content="urn:ietf:rfc:{$rfcNo}" /> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-paragraph-number"> +  + <xsl:if test="not(ancestor::ul) and not(ancestor::dl) and not(ancestor::ol)"> + + <xsl:choose> + <xsl:when test="parent::blockquote or parent::x:blockquote"> +  + <xsl:for-each select="parent::blockquote|parent::x:blockquote"><xsl:call-template name="get-paragraph-number" />.</xsl:for-each> + <xsl:number count="t|x:blockquote|blockquote|x:note|aside|ul|dl|ol"/> + </xsl:when> + + <xsl:when test="parent::aside or parent::x:note"> +  + <xsl:for-each select="parent::aside|parent::x:note"><xsl:call-template name="get-paragraph-number" />.</xsl:for-each> + <xsl:number count="t|x:blockquote|blockquote|x:note|aside|ul|dl|ol"/> + </xsl:when> + + <xsl:when test="ancestor::section"> +  + <xsl:for-each select="ancestor::section[1]"><xsl:call-template name="get-section-number" />.p.</xsl:for-each> + <xsl:variable name="b"><xsl:number count="t|x:blockquote|blockquote|x:note|aside|ul|dl|ol"/></xsl:variable> + <xsl:choose> + <xsl:when test="parent::section and ../@removeInRFC='true' and ../t[1]!=$section-removeInRFC"> + <xsl:value-of select="1 + $b"/> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$b"/></xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="ancestor::note"> +  + <xsl:for-each select="ancestor::note[1]"><xsl:call-template name="get-section-number" />.p.</xsl:for-each> + <xsl:variable name="b"><xsl:number count="t|x:blockquote|blockquote|x:note|aside|ul|dl|ol"/></xsl:variable> + <xsl:choose> + <xsl:when test="parent::note and ../@removeInRFC='true' and ../t[1]!=$note-removeInRFC"> + <xsl:value-of select="1 + $b"/> + </xsl:when> + <xsl:otherwise><xsl:value-of select="$b"/></xsl:otherwise> + </xsl:choose> + </xsl:when> + +  + <xsl:when test="ancestor::abstract"> + <xsl:text>p.</xsl:text> + <xsl:number count="t|x:blockquote|blockquote|x:note|aside|ul|dl|ol"/> + </xsl:when> + + <xsl:otherwise/> + </xsl:choose> + </xsl:if> +</xsl:template> + +<xsl:template name="editingMark"> + <xsl:if test="$xml2rfc-editing='yes' and ancestor::rfc"> + <sup class="editingmark"><span><xsl:number level="any" count="postamble|preamble|t"/></span> </sup> + </xsl:if> +</xsl:template> + + +<xsl:key name="anchor-item-alias" match="//*[@anchor and (x:anchor-alias/@value or ed:replace/ed:ins/x:anchor-alias)]" use="x:anchor-alias/@value | ed:replace/ed:ins/x:anchor-alias/@value"/> + +<xsl:template match="x:ref"> + <xsl:variable name="val" select="normalize-space(.)"/> + <xsl:variable name="target" select="key('anchor-item',$val) | key('anchor-item-alias',$val) | //reference/x:source[x:defines=$val]"/> + <xsl:if test="count($target)>1"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' is ambiguous; picking first.</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:choose> + <xsl:when test="$target[1]/@anchor"> + <a href="#{$target[1]/@anchor}" class="smpl"> + <xsl:call-template name="copy-anchor"/> +  + <xsl:if test="//iref[@x:for-anchor=$val] | //iref[@x:for-anchor='' and ../@anchor=$val]"> + <xsl:attribute name="id"><xsl:call-template name="compute-extref-anchor"/></xsl:attribute> + </xsl:if> + <xsl:value-of select="."/> + </a> + </xsl:when> + <xsl:when test="$target[1]/self::x:source"> + <xsl:variable name="extdoc" select="document($target[1]/@href)"/> + <xsl:variable name="nodes" select="$extdoc//*[@anchor and (x:anchor-alias/@value=$val)]"/> + <xsl:if test="not($nodes)"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Anchor '<xsl:value-of select="$val"/>' not found in source file '<xsl:value-of select="$target[1]/@href"/>'.</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:variable name="t"> + <xsl:call-template name="computed-auto-target"> + <xsl:with-param name="bib" select="$target[1]/.."/> + <xsl:with-param name="ref" select="$nodes[1]"/> + </xsl:call-template> + </xsl:variable> + <a href="{$t}" class="smpl"> + <xsl:value-of select="."/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">internal link target for '<xsl:value-of select="."/>' does not exist.</xsl:with-param> + </xsl:call-template> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template match="x:anchor-alias" /> + + +<xsl:template match="x:q"> + <q> + <xsl:copy-of select="@cite"/> + <xsl:apply-templates/> + </q> +</xsl:template> + + +<xsl:template match="x:note|aside"> + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + + <div> + <xsl:if test="$p!='' and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="$anchor-pref"/>section.<xsl:value-of select="$p"/></xsl:attribute> + </xsl:if> + <aside> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="*"/> + </aside> + </div> +</xsl:template> + +<xsl:template match="x:bcp14|bcp14"> +  + <xsl:variable name="c" select="normalize-space(.)"/> + <xsl:choose> + <xsl:when test="$c='MUST' or $c='REQUIRED' or $c='SHALL'"> + <em class="bcp14"><xsl:value-of select="."/></em> + </xsl:when> + <xsl:when test="$c='MUST NOT' or $c='SHALL NOT'"> + <em class="bcp14"><xsl:value-of select="."/></em> + </xsl:when> + <xsl:when test="$c='SHOULD' or $c='RECOMMENDED'"> + <em class="bcp14"><xsl:value-of select="."/></em> + </xsl:when> + <xsl:when test="$c='SHOULD NOT' or $c='NOT RECOMMENDED'"> + <em class="bcp14"><xsl:value-of select="."/></em> + </xsl:when> + <xsl:when test="$c='MAY' or $c='OPTIONAL'"> + <em class="bcp14"><xsl:value-of select="."/></em> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Unknown BCP14 keyword: ',.)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="x:blockquote|blockquote"> + <xsl:variable name="p"> + <xsl:call-template name="get-paragraph-number" /> + </xsl:variable> + <div> + <xsl:call-template name="insertInsDelClass"/> + <xsl:call-template name="editingMark" /> + <xsl:if test="string-length($p) > 0 and not(ancestor::ed:del) and not(ancestor::ed:ins)"> + <xsl:attribute name="id"><xsl:value-of select="$anchor-pref"/>section.<xsl:value-of select="$p"/></xsl:attribute> + </xsl:if> + <blockquote> + <xsl:call-template name="copy-anchor"/> + <xsl:copy-of select="@cite"/> + <xsl:choose> + <xsl:when test="t|ul|ol|dl|artwork|figure|sourcecode"> + <xsl:apply-templates/> + </xsl:when> + <xsl:otherwise> + <p> + <xsl:apply-templates/> + </p> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="@quotedFrom"> + <cite> + <xsl:text>— </xsl:text> + <xsl:choose> + <xsl:when test="@cite"><a href="{@cite}"><xsl:value-of select="@quotedFrom"/></a></xsl:when> + <xsl:otherwise><xsl:value-of select="@quotedFrom"/></xsl:otherwise> + </xsl:choose> + </cite> + </xsl:if> + </blockquote> + </div> +</xsl:template> + + +<xsl:template match="x:dfn"> + <dfn> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </dfn> +</xsl:template> + + +<xsl:template match="x:h"> + <b> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </b> +</xsl:template> + + +<xsl:template match="x:sup|sup"> + <sup> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </sup> +</xsl:template> + + +<xsl:template match="sub"> + <sub> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </sub> +</xsl:template> + + +<xsl:template match="x:highlight"> + <b> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </b> +</xsl:template> + + +<xsl:template match="x:length-of"> + <xsl:variable name="target" select="//*[@anchor=current()/@target]"/> + <xsl:if test="count($target)!=1"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('@target ',@target,' defined ',count($target),' times.')"/> + </xsl:call-template> + </xsl:if> + <xsl:variable name="content"> + <xsl:apply-templates select="$target"/> + </xsl:variable> + <xsl:variable name="lineends" select="string-length($content) - string-length(translate($content,'
',''))"/> + <xsl:variable name="indents"> + <xsl:choose> + <xsl:when test="@indented"> + <xsl:value-of select="number(@indented) * $lineends"/> + </xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:value-of select="string-length($content) + $lineends - $indents"/> +</xsl:template> + + +<xsl:template match="x:span"> + <xsl:choose> + <xsl:when test="@x:lang and $prettyprint-class!=''"> + <code class="{$prettyprint-class}"> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </code> + </xsl:when> + <xsl:otherwise> + <span> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates/> + </span> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="x:parse-xml"> + <xsl:apply-templates/> + + <xsl:if test="function-available('exslt:node-set')"> + <xsl:variable name="cleaned"> + <xsl:apply-templates mode="cleanup-edits"/> + </xsl:variable> + <xsl:if test="$xml2rfc-ext-trace-parse-xml='yes'"> + <xsl:call-template name="trace"> + <xsl:with-param name="msg" select="concat('Parsing XML: ', $cleaned)"/> + </xsl:call-template> + </xsl:if> + <xsl:choose> + <xsl:when test="function-available('myns:parseXml')" use-when="function-available('myns:parseXml')"> + <xsl:if test="myns:parseXml(concat($cleaned,''))!=''"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('Parse error in XML: ', myns:parseXml(concat($cleaned,'')))"/> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:when test="function-available('saxon:parse')" use-when="function-available('saxon:parse')"> + <xsl:variable name="parsed" select="saxon:parse(concat($cleaned,''))"/> + <xsl:if test="$parsed='foo'"> + <xsl:comment>should not get here</xsl:comment> + </xsl:if> + </xsl:when> + <xsl:when test="false()"></xsl:when> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + + +<xsl:template match="rdf:Description"> +  +</xsl:template> + + + +<xsl:template match="comment()|@*" mode="cleanup-edits"><xsl:copy/></xsl:template> + +<xsl:template match="text()" mode="cleanup-edits"><xsl:copy/></xsl:template> + +<xsl:template match="/" mode="cleanup-edits"> + <xsl:copy><xsl:apply-templates select="node()" mode="cleanup-edits" /></xsl:copy> +</xsl:template> + +<xsl:template match="ed:del" mode="cleanup-edits"/> + +<xsl:template match="ed:replace" mode="cleanup-edits"> + <xsl:apply-templates mode="cleanup-edits"/> +</xsl:template> + +<xsl:template match="ed:ins" mode="cleanup-edits"> + <xsl:apply-templates mode="cleanup-edits"/> +</xsl:template> + + + +<xsl:template name="to-abnf-char-sequence"> + <xsl:param name="chars"/> + + <xsl:variable name="asciistring">  !"#$%&'()*+,-./<xsl:value-of select="$digits"/>:;<=>?@<xsl:value-of select="$ucase"/>[\]^_`<xsl:value-of select="$lcase"/>{|}~</xsl:variable> + <xsl:variable name="hex">0123456789ABCDEF</xsl:variable> + + <xsl:variable name="c" select="substring($chars,1,1)"/> + <xsl:variable name="r" select="substring($chars,2)"/> + <xsl:variable name="pos" select="string-length(substring-before($asciistring,$c))"/> + + <xsl:choose> + <xsl:when test="$pos >= 1"> + <xsl:variable name="ascii" select="$pos + 31"/> + <xsl:variable name="h" select="floor($ascii div 16)"/> + <xsl:variable name="l" select="floor($ascii mod 16)"/> + <xsl:value-of select="concat(substring($hex,1 + $h,1),substring($hex,1 + $l,1))"/> + </xsl:when> + <xsl:otherwise> + <xsl:text>??</xsl:text> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="concat('unexpected character in ABNF char sequence: ',substring($chars,1,1))" /> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + + <xsl:if test="$r!=''"> + <xsl:text>.</xsl:text> + <xsl:call-template name="to-abnf-char-sequence"> + <xsl:with-param name="chars" select="$r"/> + </xsl:call-template> + </xsl:if> + +</xsl:template> + +<xsl:template match="x:abnf-char-sequence"> + <xsl:choose> + <xsl:when test="substring(.,1,1) != '"' or substring(.,string-length(.),1) != '"'"> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'contents of x:abnf-char-sequence needs to be quoted.'" /> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:text>%x</xsl:text> + <xsl:call-template name="to-abnf-char-sequence"> + <xsl:with-param name="chars" select="substring(.,2,string-length(.)-2)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + +<xsl:template match="x:x"/> + + +<xsl:template match="x:bt"> + <xsl:text>┌</xsl:text> + <xsl:value-of select="translate(substring(.,2,string-length(.)-2),'-','─')"/> + <xsl:text>┐</xsl:text> +</xsl:template> + + +<xsl:template match="x:bc"> + <xsl:variable name="first" select="substring(.,1)"/> + <xsl:variable name="content" select="substring(.,2,string-length(.)-2)"/> + <xsl:variable name="is-delimiter" select="translate($content,'-','')=''"/> + + <xsl:choose> + <xsl:when test="$is-delimiter"> + <xsl:text>├</xsl:text> + <xsl:value-of select="translate($content,'-','─')"/> + <xsl:text>┤</xsl:text> + </xsl:when> + <xsl:when test="*"> + <xsl:for-each select="node()"> + <xsl:choose> + <xsl:when test="position()=1"> + <xsl:text>│</xsl:text> + <xsl:value-of select="substring(.,2)"/> + </xsl:when> + <xsl:when test="position()=last()"> + <xsl:value-of select="substring(.,1,string-length(.)-1)"/> + <xsl:text>│</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="."/> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:text>│</xsl:text> + <xsl:value-of select="$content"/> + <xsl:text>│</xsl:text> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + + +<xsl:template match="x:bb"> + <xsl:text>└</xsl:text> + <xsl:value-of select="translate(substring(.,2,string-length(.)-2),'-','─')"/> + <xsl:text>┘</xsl:text> +</xsl:template> + + +<xsl:template match="x:include-author"> + <xsl:for-each select="/*/front/author[@anchor=current()/@target]"> + <xsl:apply-templates select="."/> + </xsl:for-each> +</xsl:template> + + +<xsl:template match="boilerplate"> + <xsl:apply-templates/> +</xsl:template> + + + +<xsl:template match="ed:issueref"> + <xsl:choose> + <xsl:when test=".=//ed:issue/@name"> + <a href="#{$anchor-pref}issue.{.}"> + <xsl:apply-templates/> + </a> + </xsl:when> + <xsl:when test="@href"> + <a href="{@href}" id="{$anchor-pref}issue.{.}"> + <xsl:apply-templates/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Dangling ed:issueref: <xsl:value-of select="."/></xsl:with-param> + </xsl:call-template> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="ed:issue"> + <xsl:variable name="class"> + <xsl:choose> + <xsl:when test="@status='closed'">closedissue</xsl:when> + <xsl:otherwise>openissue</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <table class="{$class}"> + <tr> + <td colspan="3"> + <a id="{$anchor-pref}issue.{@name}"> + <xsl:choose> + <xsl:when test="@status='closed'"> + <xsl:attribute name="class">closed-issue</xsl:attribute> + </xsl:when> + <xsl:when test="@status='editor'"> + <xsl:attribute name="class">editor-issue</xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="class">open-issue</xsl:attribute> + </xsl:otherwise> + </xsl:choose> + <xsl:text> I </xsl:text> + </a> + <xsl:text> </xsl:text> + <xsl:choose> + <xsl:when test="@href"> + <em><a href="{@href}"><xsl:value-of select="@name" /></a></em> + </xsl:when> + <xsl:when test="@alternate-href"> + <em>[<a href="{@alternate-href}">alternate link</a>]</em> + </xsl:when> + <xsl:otherwise> + <em><xsl:value-of select="@name" /></em> + </xsl:otherwise> + </xsl:choose> +   + (type: <xsl:value-of select="@type"/>, status: <xsl:value-of select="@status"/>) + </td> + </tr> + + <xsl:apply-templates select="ed:item"/> + <xsl:apply-templates select="ed:resolution"/> + + <xsl:variable name="changes" select="//*[@ed:resolves=current()/@name or ed:resolves=current()/@name]" /> + <xsl:if test="$changes"> + <tr> + <td class="top" colspan="3"> + Associated changes in this document: + <xsl:variable name="issue" select="@name"/> + <xsl:for-each select="$changes"> + <a href="#{$anchor-pref}change.{$issue}.{position()}"> + <xsl:variable name="label"> + <xsl:call-template name="get-section-number"/> + </xsl:variable> + <xsl:choose> + <xsl:when test="$label!=''"><xsl:value-of select="$label"/></xsl:when> + <xsl:otherwise><<xsl:value-of select="concat('#',$anchor-pref,'change.',$issue,'.',position())"/>></xsl:otherwise> + </xsl:choose> + </a> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:for-each> + <xsl:text>.</xsl:text> + </td> + </tr> + </xsl:if> + </table> + +</xsl:template> + +<xsl:template match="ed:item"> + <tr> + <td class="top"> + <xsl:if test="@entered-by"> + <a href="mailto:{@entered-by}?subject={/rfc/@docName},%20{../@name}"> + <i><xsl:value-of select="@entered-by"/></i> + </a> + </xsl:if> + </td> + <td class="topnowrap"> + <xsl:value-of select="@date"/> + </td> + <td class="top"> + <xsl:apply-templates select="node()" mode="issuehtml"/> + </td> + </tr> +</xsl:template> + +<xsl:template match="ed:resolution"> + <tr> + <td class="top"> + <xsl:if test="@entered-by"> + <a href="mailto:{@entered-by}?subject={/rfc/@docName},%20{../@name}"><i><xsl:value-of select="@entered-by"/></i></a> + </xsl:if> + </td> + <td class="topnowrap"> + <xsl:value-of select="@datetime"/> + </td> + <td class="top"> + <em>Resolution:</em> + <xsl:apply-templates select="node()" mode="issuehtml"/> + </td> + </tr> +</xsl:template> + +<xsl:template match="ed:annotation"> + <em> + <xsl:apply-templates/> + </em> +</xsl:template> + + +<xsl:template match="text()" mode="issuehtml"> + <xsl:value-of select="."/> +</xsl:template> + +<xsl:template match="*|@*" mode="issuehtml"> + <xsl:message terminate="yes">Unexpected node in issue HTML: <xsl:value-of select="name(.)"/></xsl:message> +</xsl:template> + +<xsl:template match="xhtml:a|xhtml:b|xhtml:br|xhtml:cite|xhtml:del|xhtml:em|xhtml:i|xhtml:ins|xhtml:q|xhtml:pre|xhtml:tt" mode="issuehtml"> + <xsl:element name="{local-name()}"> + <xsl:apply-templates select="@*|node()" mode="issuehtml"/> + </xsl:element> +</xsl:template> + +<xsl:template match="xhtml:p" mode="issuehtml"> + <xsl:apply-templates select="node()" mode="issuehtml"/> + <br class="p"/> +</xsl:template> + +<xsl:template match="xhtml:a/@href|xhtml:q/@cite" mode="issuehtml"> + <xsl:attribute name="{local-name(.)}"> + <xsl:value-of select="."/> + </xsl:attribute> +</xsl:template> + +<xsl:template match="ed:issueref" mode="issuehtml"> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="ed:eref" mode="issuehtml"> + <xsl:text><</xsl:text> + <a href="{.}"><xsl:value-of select="."/></a> + <xsl:text>></xsl:text> +</xsl:template> + +<xsl:template name="insertIssuesList"> + + <h2 id="{$anchor-pref}issues-list" ><a href="#{$anchor-pref}issues-list">Issues list</a></h2> + <table> + <thead> + <tr> + <th>Id</th> + <th>Type</th> + <th>Status</th> + <th>Date</th> + <th>Raised By</th> + </tr> + </thead> + <tbody> + <xsl:for-each select="//ed:issue"> + <xsl:sort select="@status" /> + <xsl:sort select="@name" /> + <tr> + <td><a href="#{$anchor-pref}issue.{@name}"><xsl:value-of select="@name" /></a></td> + <td><xsl:value-of select="@type" /></td> + <td><xsl:value-of select="@status" /></td> + <td><xsl:value-of select="ed:item[1]/@date" /></td> + <td><a href="mailto:{ed:item[1]/@entered-by}?subject={/rfc/@docName},%20{@name}"><xsl:value-of select="ed:item[1]/@entered-by" /></a></td> + </tr> + </xsl:for-each> + </tbody> + </table> + +</xsl:template> + +<xsl:template name="insert-diagnostics"> + +  + + <xsl:variable name="badAnchors" select="//*[starts-with(@anchor,$anchor-pref)]" /> + <xsl:if test="$badAnchors"> + <xsl:variable name="text"> + <xsl:text>The following anchor names may collide with internally generated anchors because of their prefix "</xsl:text> + <xsl:value-of select="$anchor-pref" /> + <xsl:text>": </xsl:text> + <xsl:for-each select="$badAnchors"> + <xsl:value-of select="@anchor"/> + <xsl:call-template name="lineno"/> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:for-each> + </xsl:variable> + <xsl:call-template name="warning"> + <xsl:with-param name="msg"><xsl:value-of select="normalize-space($text)"/></xsl:with-param> + <xsl:with-param name="lineno" select="false()"/> + </xsl:call-template> + </xsl:if> + + <xsl:variable name="badV3Anchors" select="//*[substring(@anchor,2,1)='-' and translate(substring(@anchor,1,1),$lcase,'')='']" /> + <xsl:if test="$badV3Anchors"> + <xsl:variable name="text"> + <xsl:text>The following anchor names may collide with internally generated anchors in XML2RFCV3 mode because: </xsl:text> + <xsl:for-each select="$badV3Anchors"> + <xsl:value-of select="@anchor"/> + <xsl:call-template name="lineno"/> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:for-each> + </xsl:variable> + <xsl:call-template name="warning"> + <xsl:with-param name="msg"><xsl:value-of select="normalize-space($text)"/></xsl:with-param> + <xsl:with-param name="lineno" select="false()"/> + </xsl:call-template> + </xsl:if> + +  + <xsl:if test="//artwork[@type='abnf2616' or @type='abnf7230']"> + <xsl:if test="not(//reference//seriesInfo[@name='RFC' and (@value='2068' or @value='2616' or @value='7230')]) and not(//reference//seriesInfo[@name='Internet-Draft' and (starts-with(@value, 'draft-ietf-httpbis-p1-messaging-'))])"> +  + <xsl:call-template name="warning"> + <xsl:with-param name="msg">document uses HTTP-style ABNF syntax, but doesn't reference RFC 2068, RFC 2616, or RFC 7230.</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:if> + <xsl:if test="//artwork[@type='abnf']"> + <xsl:if test="not(//reference//seriesInfo[@name='RFC' and (@value='2234' or @value='4234' or @value='5234')])"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">document uses ABNF syntax, but doesn't reference RFC 2234, 4234 or 5234.</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:if> + +  + <xsl:variable name="badTargets" select="//xref[not(@target=//@anchor) and not(@target=exslt:node-set($includeDirectives)//@anchor) and not(ancestor::ed:del)]" /> + <xsl:if test="$badTargets"> + <xsl:variable name="text"> + <xsl:text>The following target names do not exist: </xsl:text> + <xsl:for-each select="$badTargets"> + <xsl:value-of select="@target"/> + <xsl:if test="not(@target)">(@target attribute missing)</xsl:if> + <xsl:call-template name="lineno"/> + <xsl:if test="position()!=last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </xsl:variable> + <xsl:call-template name="warning"> + <xsl:with-param name="msg"><xsl:value-of select="$text"/></xsl:with-param> + </xsl:call-template> + </xsl:if> + + +</xsl:template> + + + +<xsl:template match="@ed:*" /> + +<xsl:template match="ed:del"> + <xsl:call-template name="insert-issue-pointer"/> + <del> + <xsl:copy-of select="@*[namespace-uri()='']"/> + <xsl:if test="not(@title) and ancestor-or-self::*[@ed:entered-by] and @datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates /> + </del> +</xsl:template> + +<xsl:template match="ed:ins"> + <xsl:call-template name="insert-issue-pointer"/> + <ins> + <xsl:copy-of select="@*[namespace-uri()='']"/> + <xsl:if test="not(@title) and ancestor-or-self::*[@ed:entered-by] and @datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates /> + </ins> +</xsl:template> + +<xsl:template name="insert-issue-pointer"> + <xsl:param name="deleted-anchor"/> + <xsl:variable name="change" select="."/> + <xsl:for-each select="@ed:resolves|ed:resolves"> + <xsl:variable name="resolves" select="."/> +  + <xsl:variable name="count"><xsl:for-each select=".."><xsl:number level="any" count="*[@ed:resolves=$resolves or ed:resolves=$resolves]" /></xsl:for-each></xsl:variable> + <xsl:variable name="total" select="count(//*[@ed:resolves=$resolves or ed:resolves=$resolves])" /> + <xsl:variable name="id"> + <xsl:value-of select="$anchor-pref"/>change.<xsl:value-of select="$resolves"/>.<xsl:value-of select="$count" /> + </xsl:variable> + <xsl:choose> +  + <xsl:when test="not(ancestor::t) and not(ancestor::title) and not(ancestor::figure) and not($change/@ed:old-title)"> + <div class="issuepointer {$css-noprint}"> + <xsl:if test="not($deleted-anchor)"> + <xsl:attribute name="id"><xsl:value-of select="$id"/></xsl:attribute> + </xsl:if> + <xsl:if test="$count > 1"> + <a class="bg-issue" title="previous change for {$resolves}" href="#{$anchor-pref}change.{$resolves}.{$count - 1}">↑</a> + </xsl:if> + <a class="open-issue" href="#{$anchor-pref}issue.{$resolves}" title="resolves: {$resolves}"> + <xsl:choose> + <xsl:when test="//ed:issue[@name=$resolves and @status='closed']"> + <xsl:attribute name="class">closed-issue</xsl:attribute> + </xsl:when> + <xsl:when test="//ed:issue[@name=$resolves and @status='editor']"> + <xsl:attribute name="class">editor-issue</xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="class">open-issue</xsl:attribute> + </xsl:otherwise> + </xsl:choose> + <xsl:text> I </xsl:text> + </a> + <xsl:if test="$count < $total"> + <a class="bg-issue" title="next change for {$resolves}" href="#{$anchor-pref}change.{$resolves}.{$count + 1}">↓</a> + </xsl:if> + <xsl:text> </xsl:text> + </div> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$count > 1"> + <a class="bg-issue" title="previous change for {$resolves}" href="#{$anchor-pref}change.{$resolves}.{$count - 1}">↑</a> + </xsl:if> + <a title="resolves: {$resolves}" href="#{$anchor-pref}issue.{$resolves}"> + <xsl:if test="not($deleted-anchor)"> + <xsl:attribute name="id"><xsl:value-of select="$id"/></xsl:attribute> + </xsl:if> + <xsl:choose> + <xsl:when test="//ed:issue[@name=$resolves and @status='closed']"> + <xsl:attribute name="class">closed-issue <xsl:value-of select="$css-noprint"/></xsl:attribute> + </xsl:when> + <xsl:when test="//ed:issue[@name=$resolves and @status='editor']"> + <xsl:attribute name="class">editor-issue <xsl:value-of select="$css-noprint"/></xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="class">open-issue <xsl:value-of select="$css-noprint"/></xsl:attribute> + </xsl:otherwise> + </xsl:choose> + <xsl:text> I </xsl:text> + </a> + <xsl:if test="$count < $total"> + <a class="bg-issue" title="next change for {$resolves}" href="#{$anchor-pref}change.{$resolves}.{$count + 1}">↓</a> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> +</xsl:template> + +<xsl:template match="ed:replace"> +  + <xsl:choose> + <xsl:when test="parent::list"> + <xsl:apply-templates select="ed:del/node()" /> + <xsl:apply-templates select="ed:ins/node()" /> + </xsl:when> + <xsl:when test="parent::references"> + <xsl:apply-templates select="ed:del/node()" /> + <xsl:apply-templates select="ed:ins/node()" /> + </xsl:when> + <xsl:otherwise> + <xsl:if test="@cite"> + <a class="editor-issue" href="{@cite}" target="_blank" title="see {@cite}"> + <xsl:text> i </xsl:text> + </a> + </xsl:if> + <xsl:call-template name="insert-issue-pointer"/> + <xsl:if test="ed:del"> + <del> + <xsl:copy-of select="@*[namespace-uri()='']"/> + <xsl:if test="not(@title) and ancestor-or-self::xsl:template[@ed:entered-by] and @datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates select="ed:del/node()" /> + </del> + </xsl:if> + <xsl:if test="ed:ins"> + <ins> + <xsl:copy-of select="@*[namespace-uri()='']"/> + <xsl:if test="not(@title) and ancestor-or-self::*[@ed:entered-by] and @datetime"> + <xsl:attribute name="title"><xsl:value-of select="concat(@datetime,', ',ancestor-or-self::*[@ed:entered-by][1]/@ed:entered-by)"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates select="ed:ins/node()" /> + </ins> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template name="insertInsDelClass"> + <xsl:if test="ancestor::ed:del"> + <xsl:attribute name="class">del</xsl:attribute> + </xsl:if> + <xsl:if test="ancestor::ed:ins"> + <xsl:attribute name="class">ins</xsl:attribute> + </xsl:if> +</xsl:template> + + +<xsl:template name="sectionnumberAndEdits"> + <xsl:choose> + <xsl:when test="ancestor::ed:del"> + <xsl:text>del-</xsl:text> + <xsl:number count="ed:del//section" level="any"/> + </xsl:when> + <xsl:when test="@x:fixed-section-number and @x:fixed-section-number!=''"> + <xsl:value-of select="@x:fixed-section-number"/> + </xsl:when> + <xsl:when test="(@x:fixed-section-number and @x:fixed-section-number='') or @numbered='false'"> + <xsl:text>unnumbered-</xsl:text> + <xsl:number count="section[@x:fixed-section-number='' or @numbered='false']" level="any"/> + </xsl:when> + <xsl:when test="self::section and parent::ed:ins and local-name(../..)='replace'"> + <xsl:for-each select="../.."><xsl:call-template name="sectionnumberAndEdits" /></xsl:for-each> + <xsl:for-each select=".."> + <xsl:if test="parent::ed:replace"> + <xsl:for-each select=".."> + <xsl:if test="parent::section">.</xsl:if> + <xsl:variable name="cnt" select="1+count(preceding-sibling::section|preceding-sibling::ed:ins/section|preceding-sibling::ed:replace/ed:ins/section)" /> + <xsl:choose> + <xsl:when test="ancestor::back and not(ancestor::section)"><xsl:number format="A" value="$cnt"/></xsl:when> + <xsl:otherwise><xsl:value-of select="$cnt"/></xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:if> + </xsl:for-each> + </xsl:when> + <xsl:when test="self::section[parent::ed:ins]"> + <xsl:for-each select="../.."><xsl:call-template name="sectionnumberAndEdits" /></xsl:for-each> + <xsl:for-each select=".."> + <xsl:if test="parent::section">.</xsl:if><xsl:value-of select="1+count(preceding-sibling::section|preceding-sibling::ed:ins/section|preceding-sibling::ed:replace/ed:ins/section)" /> + </xsl:for-each> + </xsl:when> + <xsl:when test="self::section"> + <xsl:for-each select=".."><xsl:call-template name="sectionnumberAndEdits" /></xsl:for-each> + <xsl:if test="parent::section">.</xsl:if> + <xsl:choose> + <xsl:when test="parent::back"> + <xsl:number format="A" value="1+count(preceding-sibling::section|preceding-sibling::ed:ins/section|preceding-sibling::ed:replace/ed:ins/section)" /> + </xsl:when> + <xsl:otherwise> + <xsl:number value="1+count(preceding-sibling::section|preceding-sibling::ed:ins/section|preceding-sibling::ed:replace/ed:ins/section)" /> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="self::references"> + <xsl:choose> + <xsl:when test="count(/*/back/references)+count(/*/back/ed:replace/ed:ins/references)=1"><xsl:call-template name="get-references-section-number"/></xsl:when> + <xsl:otherwise><xsl:call-template name="get-references-section-number"/>.<xsl:number level="any"/></xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="self::middle or self::back"></xsl:when> + <xsl:otherwise> +  + <xsl:for-each select=".."><xsl:call-template name="sectionnumberAndEdits" /></xsl:for-each> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + +<xsl:template name="trace"> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="inline"/> + <xsl:param name="lineno" select="true()"/> + <xsl:call-template name="emit-message"> + <xsl:with-param name="level">TRACE</xsl:with-param> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="msg2" select="$msg2"/> + <xsl:with-param name="inline" select="$inline"/> + <xsl:with-param name="lineno" select="$lineno"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="inline-warning"> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="lineno" select="true()"/> + <xsl:call-template name="emit-message"> + <xsl:with-param name="level">WARNING</xsl:with-param> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="msg2" select="$msg2"/> + <xsl:with-param name="inline" select="'yes'"/> + <xsl:with-param name="lineno" select="$lineno"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="warning"> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="lineno" select="true()"/> + <xsl:call-template name="emit-message"> + <xsl:with-param name="level">WARNING</xsl:with-param> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="msg2" select="$msg2"/> + <xsl:with-param name="inline" select="'no'"/> + <xsl:with-param name="lineno" select="$lineno"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="info"> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="lineno" select="true()"/> + <xsl:call-template name="emit-message"> + <xsl:with-param name="level">INFO</xsl:with-param> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="msg2" select="$msg2"/> + <xsl:with-param name="inline" select="'no'"/> + <xsl:with-param name="lineno" select="$lineno"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="error"> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="inline"/> + <xsl:param name="lineno" select="true()"/> + <xsl:call-template name="emit-message"> + <xsl:with-param name="level">ERROR</xsl:with-param> + <xsl:with-param name="msg" select="$msg"/> + <xsl:with-param name="msg2" select="$msg2"/> + <xsl:with-param name="inline" select="$inline"/> + <xsl:with-param name="lineno" select="$lineno"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="emit-message"> + <xsl:param name="level"/> + <xsl:param name="msg"/> + <xsl:param name="msg2"/> + <xsl:param name="inline"/> + <xsl:param name="lineno" select="true()"/> + <xsl:variable name="message"><xsl:value-of select="$level"/>: <xsl:value-of select="$msg"/><xsl:if test="$msg2!=''"> - <xsl:value-of select="$msg2"/></xsl:if><xsl:if test="$lineno"><xsl:call-template name="lineno"/></xsl:if></xsl:variable> + <xsl:choose> + <xsl:when test="$inline!='no'"> + <xsl:choose> + <xsl:when test="ancestor::t"> + <span class="{$css-error}"><xsl:value-of select="$message"/></span> + </xsl:when> + <xsl:otherwise> + <div class="{$css-error}"><xsl:value-of select="$message"/></div> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> +  +  + </xsl:otherwise> + </xsl:choose> + <xsl:message><xsl:value-of select="$message"/></xsl:message> +</xsl:template> + + + +<xsl:template match="table"> + <div> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="iref"/> + <table> + <xsl:if test="name or @anchor!=''"> + <xsl:variable name="n"><xsl:call-template name="get-table-number"/></xsl:variable> + <caption> + <xsl:if test="not(starts-with($n,'u'))"> + <xsl:text>Table </xsl:text> + <xsl:value-of select="$n"/> + <xsl:if test="name">: </xsl:if> + </xsl:if> + <xsl:if test="name"> + <xsl:apply-templates select="name/node()"/> + </xsl:if> + </caption> + </xsl:if> + <xsl:apply-templates select="*[not(self::iref)]"/> + </table> + </div> +</xsl:template> + +<xsl:template match="table/name"/> + +<xsl:template match="tbody"> + <tbody> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="*"/> + </tbody> +</xsl:template> + +<xsl:template match="tfoot"> + <tfoot> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="*"/> + </tfoot> +</xsl:template> + +<xsl:template match="thead"> + <thead> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="*"/> + </thead> +</xsl:template> + +<xsl:template match="tr"> + <tr> + <xsl:call-template name="copy-anchor"/> + <xsl:apply-templates select="*"/> + </tr> +</xsl:template> + +<xsl:template name="t-alignment"> + <xsl:if test="@align and @align!=''"> + <xsl:attribute name="class"> + <xsl:choose> + <xsl:when test="@align='left'"><xsl:value-of select="$css-left"/></xsl:when> + <xsl:when test="@align='right'"><xsl:value-of select="$css-right"/></xsl:when> + <xsl:when test="@align='center'">center</xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Unknown align attribute: <xsl:value-of select="@align"/></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </xsl:if> +</xsl:template> + +<xsl:template match="td"> + <td> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="t-alignment"/> + <xsl:copy-of select="@colspan|@rowspan"/> + <xsl:apply-templates select="node()"/> + </td> +</xsl:template> + +<xsl:template match="th"> + <th> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="t-alignment"/> + <xsl:copy-of select="@colspan|@rowspan"/> + <xsl:apply-templates select="node()"/> + </th> +</xsl:template> + +<xsl:template match="td/br|th/br"> + <br/> +</xsl:template> + +<xsl:template match="texttable"> + <xsl:call-template name="check-no-text-content"/> + + <xsl:variable name="anch"> + <xsl:call-template name="get-table-anchor"/> + </xsl:variable> + + <div id="{$anch}" class="{$css-tt}"> + + <xsl:if test="@anchor!=''"> + <div id="{@anchor}"/> + </xsl:if> + <xsl:apply-templates select="preamble" /> + + <xsl:variable name="style"> + <xsl:value-of select="$css-tt"/> + <xsl:text> </xsl:text> + <xsl:choose> + <xsl:when test="@style!=''"> + <xsl:value-of select="@style"/> + </xsl:when> + <xsl:otherwise>full</xsl:otherwise> + </xsl:choose> + <xsl:choose> + <xsl:when test="@align='left'"><xsl:text> </xsl:text><xsl:value-of select="$css-tleft"/></xsl:when> + <xsl:when test="@align='right'"><xsl:text> </xsl:text><xsl:value-of select="$css-tright"/></xsl:when> + <xsl:when test="@align='center' or not(@align) or @align=''"><xsl:text> </xsl:text><xsl:value-of select="$css-tcenter"/></xsl:when> + <xsl:otherwise/> + </xsl:choose> + </xsl:variable> + + <table class="{$style}"> + <xsl:if test="(@title!='') or (@anchor!='' and not(@suppress-title='true'))"> + <xsl:variable name="n"><xsl:call-template name="get-table-number"/></xsl:variable> + <caption> + <xsl:if test="@x:caption-side='top'"> + <xsl:attribute name="class">caption-top</xsl:attribute> + </xsl:if> + <xsl:if test="not(starts-with($n,'u'))"> + <xsl:text>Table </xsl:text> + <xsl:value-of select="$n"/> + <xsl:if test="@title!=''">: </xsl:if> + </xsl:if> + <xsl:if test="@title!=''"> + <xsl:value-of select="@title" /> + </xsl:if> + </caption> + </xsl:if> + + <xsl:if test="ttcol!=''"> +  + <thead> + <tr> + <xsl:apply-templates select="ttcol" /> + </tr> + </thead> + </xsl:if> + <tbody> + <xsl:variable name="columns" select="count(ttcol)" /> + <xsl:variable name="fields" select="c | ed:replace/ed:ins/c | ed:replace/ed:del/c" /> + <xsl:for-each select="$fields[$columns=1 or (position() mod $columns) = 1]"> + <tr> + <xsl:for-each select=". | following-sibling::c[position() < $columns]"> + <td> + <xsl:call-template name="copy-anchor"/> + <xsl:call-template name="insertInsDelClass"/> + <xsl:variable name="pos" select="position()" /> + <xsl:variable name="col" select="../ttcol[position() = $pos]" /> + <xsl:choose> + <xsl:when test="$col/@align='right' or $col/@align='center'"> + <xsl:attribute name="class"><xsl:value-of select="$col/@align"/></xsl:attribute> + </xsl:when> + <xsl:when test="$col/@align='left' or not($col/@align)"> + <xsl:attribute name="class"><xsl:value-of select="$css-left"/></xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">Unknown align attribute on ttcol: <xsl:value-of select="$col/@align"/></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + <xsl:apply-templates select="node()" /> + </td> + </xsl:for-each> + </tr> + </xsl:for-each> + </tbody> + </table> + <xsl:apply-templates select="postamble" /> + </div> + +</xsl:template> + +<xsl:template match="ttcol"> + <th> + + <xsl:choose> + <xsl:when test="@align='right' or @align='center' or @align='left'"> + <xsl:attribute name="class"><xsl:value-of select="@align"/></xsl:attribute> + </xsl:when> + <xsl:when test="not(@align)"> +  + </xsl:when> + <xsl:otherwise> + <xsl:message>Unknown align attribute on ttcol: <xsl:value-of select="@align"/></xsl:message> + </xsl:otherwise> + </xsl:choose> + + <xsl:if test="@width"> + <xsl:attribute name="style">width: <xsl:value-of select="@width" />;</xsl:attribute> + </xsl:if> + + <xsl:apply-templates /> + </th> +</xsl:template> + + + +<xsl:template name="get-comment-name"> + <xsl:choose> + <xsl:when test="@anchor"> + <xsl:value-of select="@anchor"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$anchor-pref"/> + <xsl:text>comment.</xsl:text> + <xsl:number count="cref[not(@anchor)]" level="any"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="cref"> + <xsl:if test="$xml2rfc-comments!='no'"> + <xsl:variable name="cid"> + <xsl:call-template name="get-comment-name"/> + </xsl:variable> + + <span class="comment"> + <xsl:choose> + <xsl:when test="$xml2rfc-inline='yes'"> + <xsl:attribute name="id"> + <xsl:value-of select="$cid"/> + </xsl:attribute> + <xsl:text>[</xsl:text> + <a href="#{$cid}" class="smpl"> + <xsl:value-of select="$cid"/> + </a> + <xsl:text>: </xsl:text> + <xsl:apply-templates select="text()|eref|xref"/> + <xsl:if test="@source"> --<xsl:value-of select="@source"/></xsl:if> + <xsl:text>]</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="title"> + <xsl:if test="@source"><xsl:value-of select="@source"/>: </xsl:if> + <xsl:variable name="content"> + <xsl:apply-templates select="text()|eref|xref"/> + </xsl:variable> + <xsl:value-of select="$content"/> + </xsl:attribute> + <xsl:text>[</xsl:text> + <a href="#{$cid}"> + <xsl:value-of select="$cid"/> + </a> + <xsl:text>]</xsl:text> + </xsl:otherwise> + </xsl:choose> + </span> + </xsl:if> +</xsl:template> + +<xsl:template name="insertComments"> + + <xsl:call-template name="insert-conditional-hrule"/> + + <h2> + <xsl:call-template name="insert-conditional-pagebreak"/> + <a id="{$anchor-pref}comments" href="#{$anchor-pref}comments">Editorial Comments</a> + </h2> + + <dl> + <xsl:for-each select="//cref"> + <xsl:variable name="cid"> + <xsl:choose> + <xsl:when test="@anchor"> + <xsl:value-of select="@anchor"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$anchor-pref"/> + <xsl:text>comment.</xsl:text> + <xsl:number count="cref[not(@anchor)]" level="any"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <dt id="{$cid}"> + [<xsl:value-of select="$cid"/>] + </dt> + <dd> + <xsl:apply-templates select="node()"/> + <xsl:if test="@source"> --<xsl:value-of select="@source"/></xsl:if> + </dd> + </xsl:for-each> + </dl> +</xsl:template> + + + + +<xsl:template match="*" mode="links"><xsl:apply-templates mode="links"/></xsl:template> +<xsl:template match="text()" mode="links" /> + +<xsl:template match="/*/middle//section[not(ancestor::section)]" mode="links"> + <xsl:variable name="sectionNumber"><xsl:call-template name="get-section-number" /></xsl:variable> + <xsl:variable name="title"> + <xsl:if test="$sectionNumber!='' and not(contains($sectionNumber,'unnumbered-'))"> + <xsl:value-of select="$sectionNumber"/> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:choose> + <xsl:when test="name"> + <xsl:variable name="hold"> + <xsl:apply-templates select="name/node()"/> + </xsl:variable> + <xsl:value-of select="normalize-space($hold)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@title"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <link rel="Chapter" title="{$title}" href="#{$anchor-pref}section.{$sectionNumber}"/> + <xsl:apply-templates mode="links" /> +</xsl:template> + +<xsl:template match="/*/back//section[not(ancestor::section)]" mode="links"> + <xsl:variable name="sectionNumber"><xsl:call-template name="get-section-number" /></xsl:variable> + <xsl:variable name="title"> + <xsl:if test="$sectionNumber!='' and not(contains($sectionNumber,'unnumbered-'))"> + <xsl:value-of select="$sectionNumber"/> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:choose> + <xsl:when test="name"> + <xsl:variable name="hold"> + <xsl:apply-templates select="name/node()"/> + </xsl:variable> + <xsl:value-of select="normalize-space($hold)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@title"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <link rel="Appendix" title="{$title}" href="#{$anchor-pref}section.{$sectionNumber}"/> + <xsl:apply-templates mode="links" /> +</xsl:template> + +<xsl:template match="/*/back/references[position()=1]" mode="links"> + <xsl:variable name="sectionNumber"><xsl:call-template name="get-references-section-number" /></xsl:variable> + <link rel="Chapter" href="#{$anchor-pref}section.{$sectionNumber}"> + <xsl:choose> + <xsl:when test="@title and count(/*/back/references)=1"> + <xsl:attribute name="title"> + <xsl:call-template name="get-references-section-number"/> + <xsl:text> </xsl:text> + <xsl:value-of select="@title"/> + </xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="title"> + <xsl:call-template name="get-references-section-number"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$xml2rfc-refparent"/> + </xsl:attribute> + </xsl:otherwise> + </xsl:choose> + </link> +</xsl:template> + + + +<xsl:template name="get-author-summary"> + <xsl:choose> + <xsl:when test="count(/rfc/front/author)=1"> + <xsl:value-of select="/rfc/front/author[1]/@surname" /> + </xsl:when> + <xsl:when test="count(/rfc/front/author)=2"> + <xsl:value-of select="concat(/rfc/front/author[1]/@surname,' & ',/rfc/front/author[2]/@surname)" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat(/rfc/front/author[1]/@surname,', et al.')" /> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-bottom-center"> + <xsl:choose> + <xsl:when test="/rfc/@docName"> +  + <xsl:text>Expires </xsl:text><xsl:call-template name="expirydate" /> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="get-category-long"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-category-long"> + <xsl:choose> + <xsl:when test="$xml2rfc-footer!=''"><xsl:value-of select="$xml2rfc-footer" /></xsl:when> + <xsl:when test="$xml2rfc-private!=''"/>  + <xsl:when test="/rfc/@category='bcp'">Best Current Practice</xsl:when> + <xsl:when test="/rfc/@category='historic'">Historic</xsl:when> + <xsl:when test="/rfc/@category='info' or not(/rfc/@category)">Informational</xsl:when> + <xsl:when test="/rfc/@category='std'">Standards Track</xsl:when> + <xsl:when test="/rfc/@category='exp'">Experimental</xsl:when> + <xsl:otherwise>(category unknown)</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-header-center"> + <xsl:choose> + <xsl:when test="string-length(/rfc/front/title/@abbrev) > 0"> + <xsl:value-of select="/rfc/front/title/@abbrev" /> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/rfc/front/title" mode="get-text-content" /> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-header-left"> + <xsl:choose> + <xsl:when test="$xml2rfc-header!=''"><xsl:value-of select="$xml2rfc-header" /></xsl:when> + <xsl:when test="$xml2rfc-private!=''"/>  + <xsl:when test="/rfc/@ipr and not(/rfc/@number)">Internet-Draft</xsl:when> + <xsl:otherwise>RFC <xsl:value-of select="/rfc/@number"/></xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-generator"> + <xsl:variable name="gen"> + <xsl:text>http://greenbytes.de/tech/webdav/rfc2629.xslt, </xsl:text> +  + <xsl:if test="contains('$Revision: 1.920 $',':')"> + <xsl:value-of select="concat('Revision ',normalize-space(translate(substring-after('$Revision: 1.920 $', 'Revision: '),'$','')),', ')" /> + </xsl:if> + <xsl:if test="contains('$Date: 2017/07/09 19:39:24 $',':')"> + <xsl:value-of select="concat(normalize-space(translate(substring-after('$Date: 2017/07/09 19:39:24 $', 'Date: '),'$','')),', ')" /> + </xsl:if> + <xsl:value-of select="concat('XSLT vendor: ',system-property('xsl:vendor'),' ',system-property('xsl:vendor-url'))" /> + </xsl:variable> + <xsl:value-of select="$gen" /> +</xsl:template> + +<xsl:template name="get-header-right"> + <xsl:value-of select="concat($xml2rfc-ext-pub-month, ' ', $xml2rfc-ext-pub-year)" /> +</xsl:template> + +<xsl:template name="get-keywords"> + <xsl:for-each select="/rfc/front/keyword"> + <xsl:if test="contains(.,',')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">keyword element appears to contain a comma-separated list, split into multiple elements instead.</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="normalize-space(.)" /> + <xsl:if test="position()!=last()">, </xsl:if> + </xsl:for-each> +</xsl:template> + + +<xsl:template name="get-lang"> + <xsl:choose> + <xsl:when test="ancestor-or-self::*[@xml:lang]"><xsl:value-of select="ancestor-or-self::*/@xml:lang" /></xsl:when> + <xsl:otherwise>en</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-section-number"> + <xsl:variable name="anchor" select="@anchor"/> + <xsl:choose> + <xsl:when test="self::note"> + <xsl:number count="note"/> + </xsl:when> + <xsl:when test="@x:fixed-section-number and @x:fixed-section-number!=''"> + <xsl:value-of select="@x:fixed-section-number"/> + </xsl:when> + <xsl:when test="(@x:fixed-section-number and @x:fixed-section-number='') or @numbered='false'"> + <xsl:text>unnumbered-</xsl:text> + <xsl:number count="section[@x:fixed-section-number='' or @numbered='false']" level="any"/> +  + <xsl:if test="@numbered='false'"> + <xsl:if test="ancestor::section or ancestor::section"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Only top-level sections can be unnumbered</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:if test="following-sibling::section[not(@numbered) or @numberer!='false'] or following-sibling::references"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">Unnumbered section is followed by numbered sections</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:if> + </xsl:when> + <xsl:when test="$has-edits or ancestor::*/@x:fixed-section-number"> + <xsl:call-template name="sectionnumberAndEdits" /> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="self::references"> + <xsl:choose> + <xsl:when test="count(/*/back/references)=1"> + <xsl:call-template name="get-references-section-number"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="get-references-section-number"/>.<xsl:number count="references"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="self::reference"> + <xsl:for-each select="parent::references"> + <xsl:choose> + <xsl:when test="count(/*/back/references)=1"> + <xsl:call-template name="get-references-section-number"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="get-references-section-number"/>.<xsl:number count="references"/> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:when> + <xsl:when test="ancestor::reference"> + <xsl:for-each select="ancestor::reference"> + <xsl:call-template name="get-section-number"/> + </xsl:for-each> + </xsl:when> + <xsl:when test="ancestor::back"><xsl:number count="section|appendix" level="multiple" format="A.1.1.1.1.1.1.1" /></xsl:when> + <xsl:when test="self::appendix"><xsl:number count="appendix" level="multiple" format="A.1.1.1.1.1.1.1" /></xsl:when> + <xsl:otherwise><xsl:number count="section" level="multiple"/></xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + +<xsl:template name="get-references-section-number"> + <xsl:value-of select="count(/rfc/middle/section) + count(/rfc/middle/ed:replace/ed:ins/section) + 1"/> +</xsl:template> + +<xsl:template name="emit-section-number"> + <xsl:param name="no"/> + <xsl:value-of select="$no"/><xsl:if test="not(contains($no,'.')) or $xml2rfc-ext-sec-no-trailing-dots!='no'">.</xsl:if> +</xsl:template> + +<xsl:template name="get-section-type"> + <xsl:param name="prec" />  + <xsl:choose> + <xsl:when test="ancestor::back">Appendix</xsl:when> + <xsl:otherwise>Section</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-table-number"> + <xsl:choose> + <xsl:when test="@anchor!=''"> + <xsl:number level="any" count="texttable[@anchor!='']|table[@anchor!='']" /> + </xsl:when> + <xsl:otherwise> + <xsl:text>u.</xsl:text> + <xsl:number level="any" count="texttable[not(@anchor) or @anchor='']|table[not(@anchor) or @anchor='']" /> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-table-anchor"> + <xsl:value-of select="$anchor-pref"/> + <xsl:text>table.</xsl:text> + <xsl:call-template name="get-table-number"/> +</xsl:template> + +<xsl:template name="get-figure-number"> + <xsl:choose> + <xsl:when test="@anchor!=''"> + <xsl:number level="any" count="figure[@anchor!='']" /> + </xsl:when> + <xsl:otherwise> + <xsl:text>u.</xsl:text> + <xsl:number level="any" count="figure[not(@anchor) or @anchor='']" /> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="get-figure-anchor"> + <xsl:value-of select="$anchor-pref"/> + <xsl:text>figure.</xsl:text> + <xsl:call-template name="get-figure-number"/> +</xsl:template> + + +<xsl:template name="format-initials"> + <xsl:variable name="normalized" select="normalize-space(@initials)"/> + + <xsl:choose> + <xsl:when test="$normalized=''"> +  + </xsl:when> + <xsl:otherwise> + <xsl:variable name="r"> + <xsl:call-template name="t-format-initials"> + <xsl:with-param name="remainder" select="$normalized"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="$r!=@initials"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">@initials '<xsl:value-of select="@initials"/>': did you mean '<xsl:value-of select="$r"/>'?</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:value-of select="$r"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="t-format-initials"> + <xsl:param name="have"/> + <xsl:param name="remainder"/> + + <xsl:variable name="first" select="substring($remainder,1,1)"/> + <xsl:variable name="prev" select="substring($have,string-length($have))"/> + + + + <xsl:choose> + <xsl:when test="$remainder='' and $prev!='.'"> + <xsl:value-of select="concat($have,'.')"/> + </xsl:when> + <xsl:when test="$remainder=''"> + <xsl:value-of select="$have"/> + </xsl:when> + <xsl:when test="$prev='.' and $first='.'"> +  + <xsl:call-template name="t-format-initials"> + <xsl:with-param name="have" select="$have"/> + <xsl:with-param name="remainder" select="substring($remainder,2)"/> + </xsl:call-template> + </xsl:when> +  + +  + + <xsl:otherwise> + <xsl:call-template name="t-format-initials"> + <xsl:with-param name="have" select="concat($have,$first)"/> + <xsl:with-param name="remainder" select="substring($remainder,2)"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="truncate-initials"> + <xsl:param name="initials"/> + <xsl:variable name="local-multiple-initials"> + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="../../processing-instruction('rfc')|../processing-instruction('rfc')|./processing-instruction('rfc')"/> + <xsl:with-param name="attr" select="'multiple-initials'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="use-multiple-initials"> + <xsl:choose> + <xsl:when test="$local-multiple-initials!=''"> + <xsl:value-of select="$local-multiple-initials"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$xml2rfc-multiple-initials"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="normalize-space($initials)=''"/> + <xsl:when test="$use-multiple-initials='yes'"> + <xsl:value-of select="$initials"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat(substring-before($initials,'.'),'.')"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="extract-normalized"> + <xsl:param name="node" select="."/> + <xsl:param name="name"/> + <xsl:param name="ascii" select="false()"/> + + <xsl:variable name="n"> + <xsl:choose> + <xsl:when test="$ascii and $node/@ascii!=''"> + <xsl:value-of select="$node/@ascii"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$node"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="text" select="normalize-space($n)"/> + <xsl:if test="string-length($n) != string-length($text)"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">excessive whitespace in <xsl:value-of select="$name"/>: '<xsl:value-of select="$n"/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:if test="$text=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">missing text in <xsl:value-of select="$name"/></xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="$text"/> +</xsl:template> + + +<xsl:template name="extract-email"> + <xsl:variable name="email" select="normalize-space(.)"/> + <xsl:if test="contains($email,' ')"> + <xsl:call-template name="error"> + <xsl:with-param name="msg">whitespace in email address: '<xsl:value-of select="."/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:variable name="email2"> + <xsl:choose> + <xsl:when test="starts-with($email,'mailto:')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">email should not include URI scheme: '<xsl:value-of select="."/>'</xsl:with-param> + </xsl:call-template> + <xsl:value-of select="substring($email, 1 + string-length('mailto:'))"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$email"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:value-of select="$email2"/> +</xsl:template> + + +<xsl:template name="extract-uri"> + <xsl:variable name="uri" select="normalize-space(.)"/> + <xsl:if test="string-length(.) != string-length($uri) or contains($uri,' ')"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">excessive whitespace in URI: '<xsl:value-of select="."/>'</xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:if test="$uri=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">URI is empty</xsl:with-param> + </xsl:call-template> + </xsl:if> + + <xsl:value-of select="$uri"/> +</xsl:template> + +<xsl:template name="insert-conditional-pagebreak"> + <xsl:if test="$xml2rfc-compact!='yes'"> + <xsl:attribute name="class">np</xsl:attribute> + </xsl:if> +</xsl:template> + +<xsl:template name="insert-conditional-hrule"> + <xsl:if test="$xml2rfc-compact!='yes'"> + <hr class="{$css-noprint}" /> + </xsl:if> +</xsl:template> + + + +<xsl:template match="text()" mode="get-text-content"> + <xsl:value-of select="."/> +</xsl:template> + +<xsl:template match="*" mode="get-text-content"> + <xsl:apply-templates mode="get-text-content"/> +</xsl:template> + +<xsl:template match="ed:del" mode="get-text-content"> +</xsl:template> + + +<xsl:template name="parse-pis"> + <xsl:param name="nodes"/> + <xsl:param name="attr"/> + <xsl:param name="sep"/> + <xsl:param name="ret"/> + <xsl:param name="default"/> + <xsl:param name="duplicate-warning" select="'yes'"/> + + <xsl:choose> + <xsl:when test="count($nodes)=0"> + <xsl:choose> + <xsl:when test="$ret!=''"> + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="ret2"> + <xsl:for-each select="$nodes[1]"> + <xsl:call-template name="parse-one-pi"> + <xsl:with-param name="str" select="."/> + <xsl:with-param name="attr" select="$attr"/> + <xsl:with-param name="sep" select="$sep"/> + <xsl:with-param name="ret" select="$ret"/> + <xsl:with-param name="duplicate-warning" select="$duplicate-warning"/> + </xsl:call-template> + </xsl:for-each> + </xsl:variable> + + <xsl:call-template name="parse-pis"> + <xsl:with-param name="nodes" select="$nodes[position()!=1]"/> + <xsl:with-param name="attr" select="$attr"/> + <xsl:with-param name="sep" select="$sep"/> + <xsl:with-param name="ret" select="$ret2"/> + <xsl:with-param name="default" select="$default"/> + <xsl:with-param name="duplicate-warning" select="$duplicate-warning"/> + </xsl:call-template> + + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="parse-one-pi"> + <xsl:param name="str"/> + <xsl:param name="attr"/> + <xsl:param name="sep"/> + <xsl:param name="ret"/> + <xsl:param name="duplicate-warning"/> + + <xsl:variable name="str2"> + <xsl:call-template name="eat-leading-whitespace"> + <xsl:with-param name="str" select="$str"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$str2=''"> +  + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="attrname" select="substring-before($str2,'=')"/> + + <xsl:choose> + <xsl:when test="$attrname=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">bad PI syntax: <xsl:value-of select="$str2"/></xsl:with-param> + </xsl:call-template> + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="remainder" select="substring($str2,2+string-length($attrname))"/> + <xsl:choose> + <xsl:when test="string-length($remainder) < 2"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">bad PI value syntax: <xsl:value-of select="$remainder"/></xsl:with-param> + </xsl:call-template> + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="rem"> + <xsl:call-template name="eat-leading-whitespace"> + <xsl:with-param name="str" select="$remainder"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="qchars">'"</xsl:variable> + <xsl:variable name="qchar" select="substring($rem,1,1)"/> + <xsl:variable name="rem2" select="substring($rem,2)"/> + <xsl:choose> + <xsl:when test="not(contains($qchars,$qchar))"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">pseudo-attribute value needs to be quoted: <xsl:value-of select="$rem"/></xsl:with-param> + </xsl:call-template> + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:when test="not(contains($rem2,$qchar))"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unmatched quote in: <xsl:value-of select="$rem2"/></xsl:with-param> + </xsl:call-template> + <xsl:value-of select="$ret"/> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="value" select="substring-before($rem2,$qchar)"/> + +  + <xsl:if test="name()='rfc-ext' and $attr='SANITYCHECK'"> + <xsl:choose> + <xsl:when test="$attrname='allow-markup-in-artwork'"/> + <xsl:when test="$attrname='authors-section'"/> + <xsl:when test="$attrname='check-artwork-width'"/> + <xsl:when test="$attrname='duplex'"/> + <xsl:when test="$attrname='html-pretty-print'"/> + <xsl:when test="$attrname='include-index'"/> + <xsl:when test="$attrname='include-references-in-index'"/> + <xsl:when test="$attrname='justification'"/> + <xsl:when test="$attrname='paragraph-links'"/> + <xsl:when test="$attrname='parse-xml-in-artwork'"/> + <xsl:when test="$attrname='refresh-from'"/> + <xsl:when test="$attrname='refresh-interval'"/> + <xsl:when test="$attrname='refresh-xslt'"/> + <xsl:when test="$attrname='sec-no-trailing-dots'"/> + <xsl:when test="$attrname='trace-parse-xml'"/> + <xsl:when test="$attrname='vspace-pagebreak'"/> + <xsl:when test="$attrname='xml2rfc-backend'"/> + <xsl:otherwise> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">unsupported rfc-ext pseudo-attribute '<xsl:value-of select="$attrname"/>'</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="name()='rfc' and $attr='SANITYCHECK'"> + <xsl:choose> + <xsl:when test="$attrname='authorship'"/> + <xsl:when test="$attrname='comments'"/> + <xsl:when test="$attrname='compact'"/> + <xsl:when test="$attrname='docmapping'"> + <xsl:if test="$value!='yes'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">the rfc docmapping pseudo-attribute with values other than 'yes' in not supported by this processor.</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:when test="$attrname='editing'"/> + <xsl:when test="$attrname='footer'"/> + <xsl:when test="$attrname='header'"/> + <xsl:when test="$attrname='include'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">the rfc include pseudo-attribute is only partially supported by this processor, see http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#examples.inte… for alternative syntax.</xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:when test="$attrname='inline'"/> + <xsl:when test="$attrname='iprnotified'"/> + <xsl:when test="$attrname='linefile'"/> + <xsl:when test="$attrname='linkmailto'"/> + <xsl:when test="$attrname='multiple-initials'"/> + <xsl:when test="$attrname='private'"/> + <xsl:when test="$attrname='rfcedstyle'"/> + <xsl:when test="$attrname='sortrefs'"/> + <xsl:when test="$attrname='subcompact'"/> + <xsl:when test="$attrname='strict'"/> + <xsl:when test="$attrname='symrefs'"/> + <xsl:when test="$attrname='toc'"/> + <xsl:when test="$attrname='tocdepth'"/> + <xsl:when test="$attrname='tocindent'"> + <xsl:if test="$value!='yes'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">the rfc tocindent pseudo-attribute with values other than 'yes' in not supported by this processor.</xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="info"> + <xsl:with-param name="msg">unsupported rfc pseudo-attribute '<xsl:value-of select="$attrname"/>'</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:choose> + <xsl:when test="$attrname != $attr"> +  + <xsl:call-template name="parse-one-pi"> + <xsl:with-param name="str" select="substring($rem2, 2 + string-length($value))"/> + <xsl:with-param name="attr" select="$attr"/> + <xsl:with-param name="sep" select="$sep"/> + <xsl:with-param name="ret" select="$ret"/> + <xsl:with-param name="duplicate-warning" select="$duplicate-warning"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$sep='' and $ret!=''"> +  + <xsl:if test="$ret != $value and $duplicate-warning='yes'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">duplicate pseudo-attribute <xsl:value-of select="$attr"/>, overwriting value <xsl:value-of select="$ret"/></xsl:with-param> + </xsl:call-template> + </xsl:if> + <xsl:call-template name="parse-one-pi"> + <xsl:with-param name="str" select="substring($rem2, 2 + string-length($value))"/> + <xsl:with-param name="attr" select="$attr"/> + <xsl:with-param name="sep" select="$sep"/> + <xsl:with-param name="ret" select="$value"/> + <xsl:with-param name="duplicate-warning" select="$duplicate-warning"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> +  + <xsl:call-template name="parse-one-pi"> + <xsl:with-param name="str" select="substring($rem2, 2 + string-length($value))"/> + <xsl:with-param name="attr" select="$attr"/> + <xsl:with-param name="sep" select="$sep"/> + <xsl:with-param name="duplicate-warning" select="$duplicate-warning"/> + <xsl:with-param name="ret"> + <xsl:choose> + <xsl:when test="$ret!=''"> + <xsl:value-of select="concat($ret,$sep,$value)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$value"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + + </xsl:choose> + + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<xsl:template name="eat-leading-whitespace"> + <xsl:param name="str"/> + + <xsl:choose> + <xsl:when test="$str=''"> + </xsl:when> + <xsl:when test="translate(substring($str,1,1),' 
	',' ')=' '"> + <xsl:call-template name="eat-leading-whitespace"> + <xsl:with-param name="str" select="substring($str,2)"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$str"/> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + + +<xsl:template name="lineno"> + <xsl:if test="function-available('saxon-old:line-number')" use-when="function-available('saxon-old:line-number')"> + <xsl:if test="saxon-old:line-number() > 0"> + <xsl:text> (at line </xsl:text> + <xsl:value-of select="saxon-old:line-number()"/> + <xsl:if test="function-available('saxon-old:systemId')"> + <xsl:variable name="rootsys"> + <xsl:for-each select="/*"> + <xsl:value-of select="saxon-old:systemId()"/> + </xsl:for-each> + </xsl:variable> + <xsl:if test="$rootsys != saxon-old:systemId()"> + <xsl:text> of </xsl:text> + <xsl:value-of select="saxon-old:systemId()"/> + </xsl:if> + </xsl:if> + <xsl:text>)</xsl:text> + </xsl:if> + </xsl:if> + <xsl:if test="function-available('saxon:line-number')" use-when="function-available('saxon:line-number')"> + <xsl:if test="saxon:line-number() > 0"> + <xsl:text> (at line </xsl:text> + <xsl:value-of select="saxon:line-number()"/> + <xsl:if test="function-available('saxon:systemId')"> + <xsl:variable name="rootsys"> + <xsl:for-each select="/*"> + <xsl:value-of select="saxon:systemId()"/> + </xsl:for-each> + </xsl:variable> + <xsl:if test="$rootsys != saxon:systemId()"> + <xsl:text> of </xsl:text> + <xsl:value-of select="saxon:systemId()"/> + </xsl:if> + </xsl:if> + <xsl:text>)</xsl:text> + </xsl:if> + </xsl:if> +</xsl:template> + + +<msxsl:script language="JScript" implements-prefix="exslt"> + this['node-set'] = function (x) { + return x; + } +</msxsl:script> + + + +<msxsl:script language="JScript" implements-prefix="date"> + function twodigits(s) { + return s < 10 ? "0" + s : s; + } + + this['date-time'] = function (x) { + var now = new Date(); + var offs = now.getTimezoneOffset(); + return now.getFullYear() + "-" + + twodigits(1 + now.getMonth()) + "-" + + twodigits(now.getDate()) + "T" + + twodigits(now.getHours()) + ":" + + twodigits(now.getMinutes()) + ":" + + twodigits(now.getSeconds()) + + (offs >= 0 ? "-" : "+") + + twodigits(Math.abs(offs) / 60) + ":" + + twodigits(Math.abs(offs) % 60); + } +</msxsl:script> + +<xsl:variable name="current-year"> + <xsl:choose> + <xsl:when test="function-available('date:date-time')" use-when="function-available('date:date-time')"> + <xsl:value-of select="substring-before(date:date-time(),'-')"/> + </xsl:when> + <xsl:when test="function-available('current-date')"> + <xsl:value-of select="substring-before(string(current-date()),'-')"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="current-month"> + <xsl:choose> + <xsl:when test="function-available('date:date-time')" use-when="function-available('date:date-time')"> + <xsl:value-of select="substring-before(substring-after(date:date-time(),'-'),'-')"/> + </xsl:when> + <xsl:when test="function-available('current-date')"> + <xsl:value-of select="substring-before(substring-after(string(current-date()),'-'),'-')"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="current-day"> + <xsl:choose> + <xsl:when test="function-available('date:date-time')" use-when="function-available('date:date-time')"> + <xsl:value-of select="substring-after(substring-after(substring-before(date:date-time(),'T'),'-'),'-')"/> + </xsl:when> + <xsl:when test="function-available('current-dateTime')"> + <xsl:value-of select="substring-after(substring-after(substring-before(string(current-dateTime()),'T'),'-'),'-')"/> + </xsl:when> + <xsl:otherwise/> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="may-default-dates"> + <xsl:choose> + <xsl:when test="$current-year!='' and $current-month!='' and $current-day!=''"> + <xsl:variable name="year-specified" select="/rfc/front/date/@year and /rfc/front/date/@year!=''"/> + <xsl:variable name="month-specified" select="/rfc/front/date/@month and /rfc/front/date/@month!=''"/> + <xsl:variable name="day-specified" select="/rfc/front/date/@day and /rfc/front/date/@day!=''"/> + <xsl:variable name="system-month"> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="$current-month"/> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="$year-specified and /rfc/front/date/@year!=$current-year">Specified year <xsl:value-of select="/rfc/front/date/@year"/> does not match system date (<xsl:value-of select="$current-year"/>)</xsl:when> + <xsl:when test="$month-specified and /rfc/front/date/@month!=$system-month">Specified month <xsl:value-of select="/rfc/front/date/@month"/> does not match system date (<xsl:value-of select="$system-month"/>)</xsl:when> + <xsl:when test="$day-specified and /rfc/front/date/@day!=$current-day">Specified day does not match system date</xsl:when> + <xsl:when test="not($year-specified) and ($month-specified or $day-specified)">Can't default year when month or day is specified</xsl:when> + <xsl:when test="not($month-specified) and $day-specified">Can't default month when day is specified</xsl:when> + <xsl:otherwise>yes</xsl:otherwise> + </xsl:choose> + </xsl:when> +  + <xsl:otherwise>yes</xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<xsl:param name="xml2rfc-ext-pub-year"> + <xsl:choose> + <xsl:when test="/rfc/front/date/@year and /rfc/front/date/@year!=''"> + <xsl:value-of select="/rfc/front/date/@year"/> + </xsl:when> + <xsl:when test="$current-year!='' and $may-default-dates='yes'"> + <xsl:value-of select="$current-year"/> + </xsl:when> + <xsl:when test="$current-year!='' and $may-default-dates!='yes'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="$may-default-dates"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'/rfc/front/date/@year missing (and XSLT processor cannot compute the system date)'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + +<xsl:param name="xml2rfc-ext-pub-month"> + <xsl:choose> + <xsl:when test="/rfc/front/date/@month and /rfc/front/date/@month!=''"> + <xsl:variable name="m" select="/rfc/front/date/@month"/> + <xsl:choose> + <xsl:when test="string(number($m))!='NaN' and number($m) > 0 and number($m) < 13"> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="$m"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$m"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$current-month!='' and $may-default-dates='yes'"> + <xsl:call-template name="get-month-as-name"> + <xsl:with-param name="month" select="$current-month"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$current-month!='' and $may-default-dates!='yes'"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="$may-default-dates"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="error"> + <xsl:with-param name="msg" select="'/rfc/front/date/@month missing (and XSLT processor cannot compute the system date)'"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + +<xsl:param name="pub-month-numeric"> + <xsl:call-template name="get-month-as-num"> + <xsl:with-param name="month" select="$xml2rfc-ext-pub-month" /> + </xsl:call-template> +</xsl:param> + +<xsl:param name="xml2rfc-ext-pub-day"> + <xsl:choose> + <xsl:when test="/rfc/front/date/@day and /rfc/front/date/@day!=''"> + <xsl:value-of select="/rfc/front/date/@day"/> + </xsl:when> + <xsl:when test="$current-day!='' and $may-default-dates='yes'"> + <xsl:value-of select="$current-day"/> + </xsl:when> + <xsl:otherwise />  + </xsl:choose> +</xsl:param> + +<xsl:param name="pub-yearmonth"> +  + <xsl:choose> + <xsl:when test="$xml2rfc-ext-pub-year!=''"> + <xsl:value-of select="format-number($xml2rfc-ext-pub-year,'0000')"/> + </xsl:when> + <xsl:otherwise>0000</xsl:otherwise> + </xsl:choose> +  + <xsl:choose> + <xsl:when test="number($pub-month-numeric) > 0"> + <xsl:value-of select="format-number($pub-month-numeric,'00')"/> + </xsl:when> + <xsl:otherwise>00</xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +<xsl:template match="*" mode="validate"> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> +<xsl:template match="@*" mode="validate"/> + +<xsl:template name="warninvalid"> + <xsl:param name="additionalDiagnostics"/> + <xsl:variable name="pname"> + <xsl:if test="namespace-uri(..)!=''"> + <xsl:value-of select="concat('{',namespace-uri(..),'}')"/> + </xsl:if> + <xsl:value-of select="local-name(..)"/> + </xsl:variable> + <xsl:variable name="cname"> + <xsl:if test="namespace-uri(.)!=''"> + <xsl:value-of select="concat('{',namespace-uri(.),'}')"/> + </xsl:if> + <xsl:value-of select="local-name(.)"/> + </xsl:variable> + <xsl:call-template name="warning"> + <xsl:with-param name="msg" select="concat($cname,' not allowed inside ',$pname,$additionalDiagnostics)"/> + </xsl:call-template> +</xsl:template> + + +<xsl:template match="figure/artwork | figure/ed:replace/ed:*/artwork" mode="validate" priority="9"> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> +<xsl:template match="artwork" mode="validate"> + <xsl:call-template name="warninvalid"/> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> + + +<xsl:template match="ol/li | ul/li" mode="validate" priority="9"> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> +<xsl:template match="li" mode="validate"> + <xsl:call-template name="warninvalid"/> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> + + +<xsl:template match="t/list | t/ed:replace/ed:*/list" mode="validate" priority="9"> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> +<xsl:template match="list" mode="validate"> + <xsl:call-template name="warninvalid"/> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> + + +<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 | + blockquote/t | + x:blockquote/t | x:blockquote/ed:replace/ed:*/t | + x:note/t | x:note/ed:replace/ed:*/t | + aside/t | + td/t | th/t | + x:lt/t | li/t | x:lt/ed:replace/ed:*/t | dd/t" mode="validate" priority="9"> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> +<xsl:template match="t" mode="validate"> + <xsl:call-template name="warninvalid"/> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> + + +<xsl:template match="abstract//xref" mode="validate"> + <xsl:call-template name="warninvalid"> + <xsl:with-param name="additionalDiagnostics"> (inside <abstract>)</xsl:with-param> + </xsl:call-template> + <xsl:apply-templates select="@*|*" mode="validate"/> +</xsl:template> + +<xsl:template name="check-no-text-content"> + <xsl:for-each select="text()"> + <xsl:if test="normalize-space(.)!=''"> + <xsl:call-template name="warning"> + <xsl:with-param name="msg">No text content allowed inside <<xsl:value-of select="local-name(..)"/>>, but found: <xsl:value-of select="."/></xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:for-each> +</xsl:template> + +<xsl:template name="render-name"> + <xsl:param name="n"/> + <xsl:param name="strip-links" select="true()"/> + <xsl:variable name="t"> + <xsl:apply-templates select="$n"/> + </xsl:variable> + <xsl:choose> + <xsl:when test="not($strip-links)"> + <xsl:copy-of select="exslt:node-set($t)"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="exslt:node-set($t)" mode="strip-links"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="render-name-ref"> + <xsl:param name="n"/> + <xsl:variable name="t"> + <xsl:call-template name="render-name"> + <xsl:with-param name="n" select="$n"/> + </xsl:call-template> + </xsl:variable> + <xsl:apply-templates select="exslt:node-set($t)" mode="strip-ids"/> +</xsl:template> + + +<xsl:template match="comment()|@*" mode="strip-links"><xsl:copy/></xsl:template> +<xsl:template match="text()" mode="strip-links"><xsl:copy/></xsl:template> +<xsl:template match="*" mode="strip-links"> + <xsl:element name="{local-name()}"> + <xsl:apply-templates select="@*|node()" mode="strip-links" /> + </xsl:element> +</xsl:template> +<xsl:template match="a|xhtml:a" mode="strip-links" xmlns:xhtml="http://www.w3.org/1999/xhtml"> + <xsl:apply-templates select="node()" mode="strip-links" /> +</xsl:template> +<xsl:template match="node()|@*" mode="strip-ids"> + <xsl:copy> + <xsl:apply-templates select="node()|@*" mode="strip-ids" /> + </xsl:copy> +</xsl:template> +<xsl:template match="@id" mode="strip-ids"/> + + + +<xsl:template name="add-start-material"/> +<xsl:template name="add-end-material"/> + +</xsl:transform>

1 0

[metrics-web/master] Add bridge descriptors specification.
by karsten＠torproject.org 05 Aug '17

05 Aug '17

commit adba0625df154720be6e36c699b336ff588a5179 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Sat Jul 22 14:48:31 2017 +0200 Add bridge descriptors specification. Implements #22827. --- .../torproject/metrics/web/DataSourceServlet.java | 43 + website/src/main/resources/etc/web.xml | 11 + website/src/main/resources/spec/README.txt | 15 + .../src/main/resources/spec/bridge-descriptors.xml | 700 ++++++++++++++++ website/src/main/resources/spec/convert.awk | 46 ++ website/src/main/resources/spec/convert.sh | 6 + .../resources/web/WEB-INF/bridge-descriptors.jsp | 913 +++++++++++++++++++++ 7 files changed, 1734 insertions(+) diff --git a/website/src/main/java/org/torproject/metrics/web/DataSourceServlet.java b/website/src/main/java/org/torproject/metrics/web/DataSourceServlet.java new file mode 100644 index 0000000..f6605c1 --- /dev/null +++ b/website/src/main/java/org/torproject/metrics/web/DataSourceServlet.java @@ -0,0 +1,43 @@ +/* Copyright 2017 The Tor Project + * See LICENSE for licensing information */ + +package org.torproject.metrics.web; + +import java.io.IOException; +import java.util.HashMap; +import java.util.Map; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +public class DataSourceServlet extends AnyServlet { + + private static final long serialVersionUID = -8220752089313109128L; + + private Map<String, String[]> specFiles = new HashMap<>(); + + @Override + public void init() throws ServletException { + super.init(); + this.specFiles.put("/bridge-descriptors.html", + new String[] { "/bridge-descriptors.jsp", "Tor Bridge Descriptors" }); + } + + @Override + public void doGet(HttpServletRequest request, + HttpServletResponse response) throws IOException, ServletException { + String requestedPage = request.getRequestURI(); + for (Map.Entry<String, String[]> specFile : this.specFiles.entrySet()) { + if (requestedPage.endsWith(specFile.getKey())) { + request.setAttribute("categories", this.categories); + request.setAttribute("breadcrumb", specFile.getValue()[1]); + request.getRequestDispatcher("WEB-INF" + specFile.getValue()[0]) + .forward(request, response); + return; + } + } + response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); + } +} + diff --git a/website/src/main/resources/etc/web.xml b/website/src/main/resources/etc/web.xml index d19777f..38a30bb 100644 --- a/website/src/main/resources/etc/web.xml +++ b/website/src/main/resources/etc/web.xml @@ -284,6 +284,17 @@ </servlet-mapping> <servlet> + <servlet-name>DataSourceServlet</servlet-name> + <servlet-class> + org.torproject.metrics.web.DataSourceServlet + </servlet-class> + </servlet> + <servlet-mapping> + <servlet-name>DataSourceServlet</servlet-name> + <url-pattern>/bridge-descriptors.html</url-pattern> + </servlet-mapping> + + <servlet> <servlet-name>CollecTorServlet</servlet-name> <servlet-class> org.torproject.metrics.web.CollecTorServlet diff --git a/website/src/main/resources/spec/README.txt b/website/src/main/resources/spec/README.txt new file mode 100644 index 0000000..652eb7b --- /dev/null +++ b/website/src/main/resources/spec/README.txt @@ -0,0 +1,15 @@ +This directory contains data source specifications. + +The notation used in these documents is still less formal than it could be. +Maybe we can use ABNF which is even supported to some extend by xml2rfc. But +even then we may want to introduce a set of (standard) operations for +binary/string/crypto operations. + +It might be useful to focus on formats that can easily be processed by grammar +based parser generators like ANTLR. We tried that and spent a day or two on +ANTLR, and then gave up, figuring there are lower-hanging fruit on this +specification tree. Maybe later. + +We might even be able to reuse that set in other specifications like +dir-spec.txt or the yet-to-be-written original bridge descriptors specification. + diff --git a/website/src/main/resources/spec/bridge-descriptors.xml b/website/src/main/resources/spec/bridge-descriptors.xml new file mode 100644 index 0000000..f30056f --- /dev/null +++ b/website/src/main/resources/spec/bridge-descriptors.xml @@ -0,0 +1,700 @@ +<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> + +<?rfc private="sanitized-bridge-descriptors"?> + +<?rfc compact="yes"?> + +<?rfc authorship="no"?> + +<?rfc-ext include-index="no" ?> +<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [ + <!ENTITY nbsp " "> + <!ENTITY thinsp " "> + <!ENTITY nbhy "‑"> + <!ENTITY ndash "–"> + <!ENTITY mdash "—"> +]> +<rfc xmlns:x="http://purl.org/net/xml2rfc/ext"> + <front> + <title>Tor bridge descriptors</title> + </front> + <middle> + <section title="Purpose of this document"> + <t>Bridges and the bridge authority publish bridge descriptors that are + used by censored clients to connect to the network. + We aim for publishing all network directory data for informational and + statistical purposes. + We cannot, however, make bridge descriptors publicly available in the same + way as we publish relay descriptors, because that would defeat the purpose + of making bridges hard to enumerate for censors. + We therefore sanitize bridge descriptors by removing all potentially + identifying information and then publish sanitized versions.</t> + <t>The purpose of this document is to specify the document format of + sanitized bridge descriptors. + These descriptors are based on original, non-sanitized bridge descriptors + after sanitizing any parts that would make it easier to enumerate + bridges. + Unless stated otherwise, the + <eref target="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt#n193"> + document meta-format</eref> of the Tor directory protocol, version 3 + is used.</t> + </section> + <section title="Sanitizing potentially sensitive descriptor items"> + <t>The following sanitizing steps are applied to original, non-sanitized + bridge descriptors.</t> + <section anchor="type-annotation" title="Prefix with @type annotation"> + <t>"@type" SP DescriptorType SP Version + <list> + <t>DescriptorType is a fixed string that identifies the sanitized + bridge descriptor type. + Known strings are listed in the sections below.</t> + <t>Version is set by the sanitizer to indicate changes in the + sanitizing process. + The version string consist of a major version number for + backward-incompatible changes and a minor version number for + backward-compatible changes.</t> + </list> + </t> + </section> + <section anchor="fingerprint" title="Replace RSA fingerprints"> + <t>HashedFingerprint = SHA1(Fingerprint) + <list> + <t>Fingerprint is the decoded binary representation of the SHA-1 + hash of an ASN.1 encoded RSA public key.</t> + <t>The (non-sanitized) Fingerprint of a bridge could, in theory, be + used quite easily to uniquely identify the bridge. + However, clients can request a bridge's current descriptor by + sending its Fingerprint to the bridge authority. + This is a feature to make bridges on dynamic IP addresses more + useful, but it would also allow for trivial enumeration of bridges. + Therefore, the original Fingerprint (and anything that could be used + to derive it) is removed from descriptors and replaced with + something else that can be used to uniquely identify the bridge. + The approach taken here is to replace the Fingerprint with its SHA-1 + hash.</t> + </list> + </t> + </section> + <section anchor="master-key-ed25519" title="Replace ed25519 master keys"> + <t>HashedMasterKeyEd25519 = SHA256(MasterKeyEd25519) + <list> + <t>MasterKeyEd25519 is the decoded binary representation of an + ed25519 master key.</t> + <t>Similar to (non-sanitized) <xref target="fingerprint">RSA + fingerprints</xref>, ed25519 master keys could be used to uniquely + identify bridges and to request a current descriptor from the + bridge authority. + That is why they are replaced with their SHA-256 hashes. + In cases where a descriptor only contains an ed25519 certificate and + no ed25519 master key, the (non-sanitized) master key is first + extracted from the certificate before sanitizing it.</t> + </list> + </t> + </section> + <section anchor="crypto" + title="Remove public keys, certificates, and signatures"> + <t>[Removed.] + <list> + <t>Some of the public keys and certificates could be used to derive + key fingerprints, hence they need to be replaced or removed. + However, replacing them seemed unnecessary and overly complex with + respect to keeping state on the sanitizing host. + That is why most public keys, certificates, and signatures are + simply removed in the sanitizing process.</t> + </list> + </t> + </section> + <section anchor="ipv4-address" title="Replace IPv4 addresses"> + <t>SanitizedIpv4Address = "10." | KeyedHash</t> + <t>KeyedHash = SHA256(Ipv4Address | Fingerprint | Secret)[:3] + <list> + <t>Address is the 4-byte long binary representation of the + (non-sanitized) IPv4 address.</t> + <t>Fingerprint is the 20-byte long binary representation of the + (non-sanitized) long-term identity fingerprint.</t> + <t>Secret is a 31-byte long secure random string that changes once + per month for all descriptors and statuses published in that + month.</t> + <t>The [:3] operator picks the first three bytes from the left of the + result and encodes it as three dot-separated decimal numbers. + </t> + <t>Sanitizing IPv4 addresses is obviously required to prevent + enumeration of bridges. + The approach taken is here is to replace IPv4 addresses with + syntactical valid addresses in the private IPv4 address space 10/8 + based on a keyed hash function that produces the same sanitized + address for a given bridge, IPv4 address, and month.</t> + </list> + </t> + </section> + <section anchor="ipv6-address" title="Replace IPv6 addresses"> + <t>SanitizedIpv6Address = "[fd9f:2e19:3bcf::" | KeyedHash | "]"</t> + <t>KeyedHash = SHA256(Ipv6Address | Fingerprint | Secret)[:3] + <list> + <t>Address is the 16-byte long binary representation of the + (non-sanitized) IPv6 address.</t> + <t>Fingerprint is the 20-byte long binary representation of the + (non-sanitized) long-term identity fingerprint.</t> + <t>Secret is a 19-byte long secure random string that changes once + per month for all descriptors and statuses published in that + month.</t> + <t>The [:3] operator picks the first three bytes from the left of the + result and encodes it as two lower-case hexadecimal numbers, a + colon, and another four lower-case hexadecimal numbers. + </t> + <t>Similar to <xref target="ipv4-address">IPv4 addresses</xref>, + IPv6 addresses are replaced with syntactical valid addresses in the + address range [fd9f:2e19:3bcf::/116] based on a keyed hash function + that produces the same sanitized address for a given bridge, IPv6 + address, and month.</t> + </list> + </t> + </section> + <section anchor="tcp-port" title="Replace TCP ports"> + <t>SanitizedPort = KeyedHash / 2^2 + 2^15 + 2^14</t> + <t>KeyedHash = SHA256(Port | Fingerprint | Secret)[:2] + <list> + <t>Port is the 2-byte long binary representation of the TCP + port.</t> + <t>Fingerprint is the 20-byte long binary representation of the + bridge's long-term identity fingerprint.</t> + <t>Secret is a 33-byte long secure random string that changes once + per month for all descriptors and statuses published in that + month.</t> + <t>The [:2] operator means that we pick the first two bytes from the + left of the result, and the /, ^, and + operators are all integer + operators. + </t> + <t>TCP ports that are 0 in the original are left unchanged.</t> + <t>It may be less obvious that TCP ports need to be sanitized, but an + unusual TCP port used by a high-value bridge might still stand out and + provide yet another way to locate and block the bridge. + Therefore, each non-zero TCP port is replaced with a port number in + the range from 49152 to 65535, which is reserved for private services, + based on a keyed hash function that produces the same sanitized port + for a given bridge, TCP port, and month.</t> + </list> + </t> + </section> + <section anchor="contact" title="Remove contact information"> + <t>SanitizedContact = "somebody" + <list> + <t>If there is contact information in a descriptor, it is replaced by + the constant string "somebody". + (Note that this sanitizing step is subject to change and maybe be + changed in a future version towards retaining the original contact + information.)</t> + </list> + </t> + </section> + <section anchor="transport" + title="Remove extraneous transport information"> + <t>[Removed.] + <list> + <t>Bridges may provide transports in addition to the OR protocol and + include information about these transports for the bridge + distribution service. + In that case, any IP addresses, TCP ports, or additional arguments + are removed, only leaving in the supported transport names.</t> + </list> + </t> + </section> + <section anchor="replaced-digest" + title="Replace digests in referencing descriptors"> + <t>SanitizedSha1Digest = SHA1(Sha1Digest)</t> + <t>SanitizedSha256Digest = SHA256(Sha256Digest) + <list> + <t>Sha1Digest is the 20-byte long binary representation of a + descriptor's SHA-1 digest.</t> + <t>Sha256Digest is the 32-byte long binary representation of a + descriptor's SHA-256 digest.</t> + <t>Some descriptors reference other descriptors by their digest. + However, these digests are also somewhat sensitive, because it + shouldn't be possible to reconstruct the original descriptor with + help of these digests. + That is why digests in referencing descriptors are replaced with + either the hex-encoded SHA-1 hash or the base64-encoded SHA-256 hash + of the original digest, depending on which hash algorithm was used + to generate the original digest. + The resulting digest string in a referencing descriptor can then be + matched to an <xref target="appended-digest">appended digest</xref> + in a referenced descriptor.</t> + </list> + </t> + </section> + <section anchor="appended-digest" + title="Append digests to referenced descriptors"> + <t>SanitizedSha1Digest = SHA1(Sha1Digest)</t> + <t>SanitizedSha256Digest = SHA256(Sha256Digest) + <list> + <t>Sha1Digest is the 20-byte long binary representation of a + descriptor's SHA-1 digest.</t> + <t>Sha256Digest is the 32-byte long binary representation of a + descriptor's SHA-256 digest.</t> + <t>As stated <xref target="replaced-digest">above</xref>, some + descriptors are referenced by others by their digest. + But in contrast to non-sanitized descriptors, it's neither possible + to compute the digest of a sanitized descriptor nor is it desirable + to include the original digest. + The reason is that it shouldn't be possible to reconstruct the + original descriptor with help of the original digest. + That is why descriptors that are typically referenced from others + may contain additional lines with the hex-encoded SHA-1 hash or the + base64-encoded SHA-256 hash of the original digest, depending on + which hash algorithm would have been used to generate the original + digest. + The resulting digest string can then be matched to a + <xref target="replaced-digest">sanitized digest</xref> in a + referencing descriptor.</t> + </list> + </t> + </section> + </section> + <section title="Server descriptor document format"> + <t>The document format of sanitized bridge server descriptors resembles + the document format of (non-sanitized) server descriptors as much as + possible. + Also refer to the + <eref target="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt"> + Tor directory protocol, version 3 specification</eref>, as the following + sections only specify items that differ from their non-sanitized counterparts.</t> + <section title="Annotations"> + <t>The bridge authority may prefix descriptors with one or more + annotation lines containing metadata, and the sanitizer may add + annotation lines with metadata about the sanitizing process.</t> + <t>"@purpose" SP Purpose NL + <list> + <t>[Removed.]</t> + </list> + </t> + <t>"@type" SP "bridge-server-descriptor" SP Version + <list> + <t>[Exactly once.]</t> + <t>Version can be one of the following numbers: + <list style="symbols"> + <t>"1.0" was the first version. + There was supposed to be a newer version indicating added + "ntor-onion-key" lines, but due to a mistake only the version + number of sanitized bridge extra-info descriptors was raised. + As a result, there may be sanitized bridge server descriptors + with version 1.0 with and without those lines.</t> + <t>"1.1" added "master-key-ed25519" and "router-digest-sha256" + lines to server descriptors published by bridges using an + ed25519 master key.</t> + <t>"1.2" introduced sanitized TCP ports.</t> + </list> + </t> + </list> + </t> + </section> + <section title="Descriptor body"> + <t>The body of a sanitized bridge server descriptor contains several + sanitized items as specified in the following:</t> + <t>"router" SP Nickname SP SanitizedAddress SP SanitizedORPort SP + SOCKSPort SP SanitizedDirPort NL + <list> + <t>[At start, exactly once.]</t> + <t>Nickname is the bridge's original, unchanged nickname.</t> + <t>SanitizedAddress is the bridge's + <xref target="ipv4-address">sanitized IP address</xref>.</t> + <t>SanitizedORPort is the bridge's + <xref target="tcp-port">sanitized OR port</xref> (since version 1.2) + or the original OR port (until version 1.1).</t> + <t>SOCKSPort is deprecated and always 0, as in the original, + non-sanitized server descriptor.</t> + <t>SanitizedDirPort is the bridge's + <xref target="tcp-port">sanitized directory port</xref> (since + version 1.2) or the original directory port (until version 1.1).</t> + </list> + </t> + <t>"or-address" SP SanitizedAddress ":" SanitizedPort NL + <list> + <t>[Any number.]</t> + <t>SanitizedAddress is either an additional + <xref target="ipv4-address">sanitized IPv4 address</xref> or + <xref target="ipv6-address">sanitized IPv6 address</xref>.</t> + <t>SanitizedPort is an additional + <xref target="tcp-port">sanitized OR port</xref> (since version 1.2) + or original OR port (until version 1.1).</t> + </list> + </t> + <t>"identity-ed25519" NL CertificateBlock NL + <list> + <t>[Removed.]</t> + </list> + </t> + <t>"master-key-ed25519" SP SanitizedMasterKey NL + <list> + <t>[At most once.]</t> + <t>SanitizedMasterKey is the bridge's + <xref target="master-key-ed25519">sanitized ed25519 master + key</xref>. + (Introduced in version 1.1, not present in earlier versions.)</t> + </list> + </t> + <t>"fingerprint" SP SanitizedFingerprint NL + <list> + <t>[At most once.]</t> + <t>SanitizedFingerprint is the bridge's + <xref target="fingerprint">sanitized fingerprint</xref>, formatted + with a single SP after every 4 characters.</t> + </list> + </t> + <t>"contact" SP SanitizedContact NL + <list> + <t>[At most once.]</t> + <t>SanitizedContact is the bridge's <xref target="contact">sanitized + contact information</xref>.</t> + </list> + </t> + <t>"reject" SP ExitPattern NL + <list> + <t>[Any number.]</t> + <t>ExitPattern contains the bridge's + <xref target="ipv4-address">sanitized IPv4 address</xref>, if the + original line contained the bridge's primary IP address, and is + otherwise unchanged. + (Note that "accept" lines are exempt from this sanitizing step, + which doesn't really make sense and which might change in the + future.)</t> + </list> + </t> + <t>"extra-info-digest" SP SanitizedSha1Digest [SP + SanitizedSha256Digest] NL + <list> + <t>[At most once.]</t> + <t>SanitizedSha1Digest is the + <xref target="replaced-digest">sanitized SHA-1 digest</xref> of the + corresponding extra-info descriptor.</t> + <t>SanitizedSha256Digest is the + <xref target="replaced-digest">sanitized SHA-256 digest</xref> of + corresponding extra-info descriptor and is only included if the + original line contained a SHA-256 digest.</t> + </list> + </t> + <t>"family" (SP Name)* NL + <list> + <t>[At most once.]</t> + <t>Name is either the <xref target="fingerprint">sanitized + fingerprint</xref> or unchanged nickname of another relay or bridge + that is purportedly in the same family as this bridge.</t> + </list> + </t> + <t>"onion-key" NL PublicKeyBlock NL + <list> + <t>[Removed.]</t> + <t>The bridge's medium-term RSA key is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"signing-key" NL PublicKeyBlock NL + <list> + <t>[Removed.]</t> + <t>The bridge's long-term RSA key is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"onion-key-crosscert" NL SignatureBlock NL + <list> + <t>[Removed.]</t> + <t>This cross signature created with the onion-key is removed together + with most other <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"ntor-onion-key-crosscert" SP PublicKey NL + <list> + <t>[Removed.]</t> + <t>This cross signature created with the ntor-onion-key is removed + together with most other <xref target="crypto">public keys, + certificates, and signatures</xref>.</t> + </list> + </t> + <t>"ntor-onion-key" SP NtorOnionKey NL + <list> + <t>[At most once.]</t> + <t>The curve25519 public key used for the ntor circuit extended + handshake is included without modification in most sanitized + descriptors. + This key was originally missing in version 1.0, and there was + supposed to be a newer version indicating added "ntor-onion-key" + lines. + But due to a mistake only the version number of sanitized bridge + extra-info descriptors was raised. + As a result, there are sanitized bridge server descriptors with + version 1.0 with and without this line. + All subsequent versions contain this line</t> + </list> + </t> + <t>"router-sig-ed25519" SP Signature NL + <list> + <t>[Removed.]</t> + <t>The ed25519 signature is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"router-signature" NL SignatureBlock NL + <list> + <t>[Removed.]</t> + <t>The RSA signature is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"router-digest-sha256" SP SanitizedSha256Digest NL + <list> + <t>[At most once.]</t> + <t>SanitizedSha256Digest is the + <xref target="appended-digest">sanitized SHA-256 digest</xref> of + this descriptor and is only included if the original descriptor + contained an ed25519 signature of the descriptor's SHA-256 digest. + (Introduced in version 1.1, not present in earlier versions.)</t> + </list> + </t> + <t>"router-digest" SP SanitizedSha1Digest NL + <list> + <t>[At end, exactly once.]</t> + <t>SanitizedSha1Digest is the + <xref target="appended-digest">sanitized SHA-1 digest</xref> of + this descriptor.</t> + </list> + </t> + </section> + </section> + <section title="Extra-info descriptor document format"> + <t>The document format of sanitized extra-info descriptors follows the + same approach as sanitized server descriptors by changing as few items as + possible in their original, non-sanitized counterpart. + The original format is specified in the + <eref target="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt">Tor + directory protocol, version 3</eref>. + Only the changes to that specification are listed below.</t> + <section title="Annotations"> + <t>"@type" SP "bridge-extra-info" SP Version + <list> + <t>[Exactly once.]</t> + <t>Version can be one of the following numbers: + <list style="symbols"> + <t>"1.0" was the first version.</t> + <t>"1.1" added sanitized "transport" lines.</t> + <t>"1.2" was supposed to indicate added "ntor-onion-key" lines, + but those changes only affected bridge server descriptors, not + extra-info descriptors. + So, nothing has changed as compared to version 1.1.</t> + <t>"1.3" added "master-key-ed25519" and "router-digest-sha256" + lines to extra-info descriptors published by bridges using an + ed25519 master key.</t> + </list> + </t> + </list> + </t> + </section> + <section title="Descriptor body"> + <t>Several items in the extra-info descriptor body are changed or + removed as compared to original, non-sanitized descriptors:</t> + <t>"extra-info" SP Nickname SP SanitizedFingerprint NL + <list> + <t>[At start, exactly once.]</t> + <t>Nickname is the bridge's original, unchanged nickname.</t> + <t>SanitizedFingerprint is the bridge's + <xref target="fingerprint">sanitized fingerprint</xref>.</t> + </list> + </t> + <t>"transport" SP TransportName NL + <list> + <t>[Any number.]</t> + <t>TransportName is the transport name as found in the original + line.</t> + <t>Any further details about this + <xref target="transport">transport</xref>, including any IP + addresses, TCP ports, or additional arguments are removed, only + leaving in the supported transport names. + (Introduced in version 1.1, not present in earlier versions.)</t> + </list> + </t> + <t>"transport-info SP TransportInfo NL + <list> + <t>[Removed.]</t> + <t>Any lines containing <xref target="transport">extraneous transport + information</xref> are removed. + (Note that these lines are not even specified for original, + non-sanitized descriptors.)</t> + </list> + </t> + <t>"identity-ed25519" NL CertificateBlock NL + <list> + <t>[Removed.]</t> + <t>The RSA signature is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"master-key-ed25519" SP SanitizedMasterKey NL + <list> + <t>[At most once.]</t> + <t>SanitizedMasterKey is the bridge's + <xref target="master-key-ed25519">sanitized ed25519 master + key</xref>. + (Introduced in version 1.3, not present in earlier versions.)</t> + </list> + </t> + <t>"router-sig-ed25519" SP Signature NL + <list> + <t>[Removed.]</t> + <t>The ed25519 signature is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"router-signature" NL SignatureBlock NL + <list> + <t>[Removed.]</t> + <t>The RSA signature is removed together with most other + <xref target="crypto">public keys, certificates, and + signatures</xref>.</t> + </list> + </t> + <t>"router-digest-sha256" SP SanitizedSha256Digest NL + <list> + <t>[At most once.]</t> + <t>SanitizedSha256Digest is the + <xref target="appended-digest">sanitized SHA-256 digest</xref> of + this descriptor and is only included if the original descriptor + contained an ed25519 signature of the descriptor's SHA-256 digest. + (Introduced in version 1.3, not present in earlier versions.)</t> + </list> + </t> + <t>"router-digest" SP SanitizedSha1Digest NL + <list> + <t>[At end, exactly once.]</t> + <t>SanitizedSha1Digest is the + <xref target="appended-digest">sanitized SHA-1 digest</xref> of + this descriptor.</t> + </list> + </t> + </section> + </section> + <section title="Network status document format"> + <t>The document format of bridge network statuses is loosely based on the + network status format specified in the + <eref target="https://gitweb.torproject.org/torspec.git/tree/attic/dir-spec-v2.txt">Tor + directory protocol, version 2</eref>. + However, the preamble of bridge network statuses contains far fewer items + than that of (relay) network statuses, and the ones that are similar + differ in some of the details. + That's why all preamble lines that exist in sanitized bridge network + statuses are specified below, not just the ones that differ.</t> + <section title="Annotations"> + <t>Sanitized bridge network statuses start with one or more + annotations:</t> + <t>"@type" SP "bridge-network-status" SP Version NL + <list> + <t>[Exactly once.]</t> + <t>Version can be one of the following numbers: + <list style="symbols"> + <t>"1.0" was the first version.</t> + <t>"1.1" introduced sanitized TCP ports.</t> + <t>"1.2" introduced the "fingerprint" line, containing the + fingerprint of the bridge authority which produced the document, + to the header.</t> + </list> + </t> + </list> + </t> + </section> + <section title="Preamble"> + <t>The preamble contains zero or more of the following items in no + predefined order:</t> + <t>"published" SP Publication NL + <list> + <t>[Exactly once.]</t> + <t>Publication is the publication time for this document, which is + left unchanged in the sanitizing process.</t> + </list> + </t> + <t>"flag-thresholds" SP Thresholds NL + <list> + <t>[At most once.]</t> + <t>Thresholds are internal performance thresholds that the bridge + directory authority had at the moment it was forming a status, which + are left unchanged in the sanitizing process. + This item was first introduced in + <eref target="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt">Tor + directory protocol, version 3</eref>.</t> + </list> + </t> + <t>"fingerprint" SP Fingerprint NL; + <list> + <t>[At most once.]</t> + <t>Fingerprint is the (non-sanitized) SHA-1 hash of the bridge + authority's long-term signing key, encoded as 40 upper-case + hexadecimal characters, which is either added or left unchanged in + the sanitizing process. + (Introduced in version 1.2, not present in earlier versions.)</t> + </list> + </t> + </section> + <section title="Router entries"> + <t>For each bridge, there is one router entry containing one or more + items. + Similar to the preamble specification, the following specification + lists all lines known in sanitized bridge network statuses, including + those that are left unchanged in the sanitizing process.</t> + <t>"r" SP Nickname SP SanitizedFingerprint SP SanitizedSha1Digest SP + Publication SP SanitizedAddress SP SanitizedORPort SP SanitizedDirPort + NL + <list> + <t>[At start, exactly once.]</t> + <t>Nickname is the bridge's original, unchanged nickname.</t> + <t>SanitizedFingerprint is the bridge's + <xref target="fingerprint">sanitized fingerprint</xref>.</t> + <t>SanitizedSha1Digest is the + <xref target="replaced-digest">sanitized SHA-1 digest</xref> of + the corresponding server descriptor.</t> + <t>Publication is the publication time for the corresponding + server descriptor, which is left unchanged in the sanitizing + process.</t> + <t>SanitizedAddress is the bridge's + <xref target="ipv4-address">sanitized IP address</xref>.</t> + <t>SanitizedORPort is the bridge's + <xref target="tcp-port">sanitized OR port</xref> (since version 1.1) + or the original OR port (until version 1.0).</t> + <t>SanitizedDirPort is the bridge's + <xref target="tcp-port">sanitized directory port</xref> (since + version 1.1) or the original directory port (until version 1.0).</t> + </list> + </t> + <t>"a" SP SanitizedAddress ":" SanitizedPort NL + <list> + <t>[Any number.]</t> + <t>SanitizedAddress is either an additional + <xref target="ipv4-address">sanitized IPv4 address</xref> or + <xref target="ipv6-address">sanitized IPv6 address</xref>.</t> + <t>SanitizedPort is an additional <xref target="tcp-port">sanitized + OR port</xref>.</t> + </list> + </t> + <t>"s" ... NL + <list> + <t>[Unchanged.]</t> + </list> + </t> + <t>"w" ... NL + <list> + <t>[Unchanged.]</t> + </list> + </t> + <t>"p" ... NL + <list> + <t>[Unchanged.]</t> + </list> + </t> + </section> + </section> + </middle> + <back/> +</rfc> + diff --git a/website/src/main/resources/spec/convert.awk b/website/src/main/resources/spec/convert.awk new file mode 100644 index 0000000..ab26121 --- /dev/null +++ b/website/src/main/resources/spec/convert.awk @@ -0,0 +1,46 @@ +#!/usr/bin/awk -f + +# Skip everything before <body> including generated header, script, and style. +BEGIN { + insidebody = 0; +} + +# Skip any lines after </body>, and include our footer. +/<\/body>/ { + insidebody = 2 + printf("<jsp:include page=\"bottom.jsp\"/>\n") +} + +# Prepend <header> and <section> with <div class="container">. +/<(header|section).*>/ { + printf("<div class=\"container\">\n") +} + +# Copy over all lines between <body> and </body> (exclusive). +{ + if (insidebody == 1) { + print + } +} + +# Append </div> to </header> and </section>. +/<\/(header|section)>/ { + printf("</div> \n") +} + +# Start copying at <body>, but first include our header. +/<body>/ { + insidebody = 1; + printf("<jsp:include page=\"top.jsp\">\n") + printf("<jsp:param name=\"pageTitle\" value=\"Sources – Tor Metrics\"/>\n") + printf("<jsp:param name=\"navActive\" value=\"Sources\"/>\n") + printf("</jsp:include>\n") + printf("<div class=\"container\">\n") + printf("<ul class=\"breadcrumb\">\n") + printf("<li><a href=\"/\">Home</a></li>\n") + printf("<li><a href=\"sources.html\">Sources</a></li>\n") + printf("<li class=\"active\">${breadcrumb}</li>\n") + printf("</ul>\n") + printf("</div>\n") +} + diff --git a/website/src/main/resources/spec/convert.sh b/website/src/main/resources/spec/convert.sh new file mode 100755 index 0000000..5b32f9a --- /dev/null +++ b/website/src/main/resources/spec/convert.sh @@ -0,0 +1,6 @@ +#!/bin/bash +for specfile in "bridge-descriptors"; do + saxon-xslt $specfile.xml rfc2629.xslt xml2rfc-topblock=no | \ + tidy -q | awk -f convert.awk > ../web/WEB-INF/$specfile.jsp +done + diff --git a/website/src/main/resources/web/WEB-INF/bridge-descriptors.jsp b/website/src/main/resources/web/WEB-INF/bridge-descriptors.jsp new file mode 100644 index 0000000..db7aaa2 --- /dev/null +++ b/website/src/main/resources/web/WEB-INF/bridge-descriptors.jsp @@ -0,0 +1,913 @@ +<jsp:include page="top.jsp"> +<jsp:param name="pageTitle" value="Sources – Tor Metrics"/> +<jsp:param name="navActive" value="Sources"/> +</jsp:include> +<div class="container"> +<ul class="breadcrumb"> +<li><a href="/">Home</a></li> +<li><a href="sources.html">Sources</a></li> +<li class="active">${breadcrumb}</li> +</ul> +</div> +<div class="container"> +<header> +<div id="rfc.title"> +<h1>Tor bridge descriptors</h1> +</div> +</header> +</div>  +<div class="container"> +<section id="n-purpose-of-this-document"> +<h2 id="rfc.section.1" class="np"><a href= +"#rfc.section.1">1.</a> <a href= +"#n-purpose-of-this-document">Purpose of this document</a></h2> +<div id="rfc.section.1.p.1"> +<p>Bridges and the bridge authority publish bridge descriptors that +are used by censored clients to connect to the network. We aim for +publishing all network directory data for informational and +statistical purposes. We cannot, however, make bridge descriptors +publicly available in the same way as we publish relay descriptors, +because that would defeat the purpose of making bridges hard to +enumerate for censors. We therefore sanitize bridge descriptors by +removing all potentially identifying information and then publish +sanitized versions.</p> +</div> +<div id="rfc.section.1.p.2"> +<p>The purpose of this document is to specify the document format +of sanitized bridge descriptors. These descriptors are based on +original, non-sanitized bridge descriptors after sanitizing any +parts that would make it easier to enumerate bridges. Unless stated +otherwise, the <a href= +"https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt#n193">document +meta-format</a> of the Tor directory protocol, version 3 is +used.</p> +</div> +</section> +</div>  +<div class="container"> +<section id="n-sanitizing-potentially-sensitive-descriptor-items"> +<h2 id="rfc.section.2"><a href= +"#rfc.section.2">2.</a> <a href="#n-sanitizing-potentially-sensitive-descriptor-items">Sanitizing +potentially sensitive descriptor items</a></h2> +<div id="rfc.section.2.p.1"> +<p>The following sanitizing steps are applied to original, +non-sanitized bridge descriptors.</p> +</div> +<div class="container"> +<section id="type-annotation"> +<h3 id="rfc.section.2.1"><a href= +"#rfc.section.2.1">2.1.</a> <a href="#type-annotation">Prefix +with @type annotation</a></h3> +<div id="rfc.section.2.1.p.1"> +<p>"@type" SP DescriptorType SP Version</p> +<ul class="empty"> +<li>DescriptorType is a fixed string that identifies the sanitized +bridge descriptor type. Known strings are listed in the sections +below.</li> +<li>Version is set by the sanitizer to indicate changes in the +sanitizing process. The version string consist of a major version +number for backward-incompatible changes and a minor version number +for backward-compatible changes.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="fingerprint"> +<h3 id="rfc.section.2.2"><a href= +"#rfc.section.2.2">2.2.</a> <a href="#fingerprint">Replace RSA +fingerprints</a></h3> +<div id="rfc.section.2.2.p.1"> +<p>HashedFingerprint = SHA1(Fingerprint)</p> +<ul class="empty"> +<li>Fingerprint is the decoded binary representation of the SHA-1 +hash of an ASN.1 encoded RSA public key.</li> +<li>The (non-sanitized) Fingerprint of a bridge could, in theory, +be used quite easily to uniquely identify the bridge. However, +clients can request a bridge's current descriptor by sending its +Fingerprint to the bridge authority. This is a feature to make +bridges on dynamic IP addresses more useful, but it would also +allow for trivial enumeration of bridges. Therefore, the original +Fingerprint (and anything that could be used to derive it) is +removed from descriptors and replaced with something else that can +be used to uniquely identify the bridge. The approach taken here is +to replace the Fingerprint with its SHA-1 hash.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="master-key-ed25519"> +<h3 id="rfc.section.2.3"><a href= +"#rfc.section.2.3">2.3.</a> <a href= +"#master-key-ed25519">Replace ed25519 master keys</a></h3> +<div id="rfc.section.2.3.p.1"> +<p>HashedMasterKeyEd25519 = SHA256(MasterKeyEd25519)</p> +<ul class="empty"> +<li>MasterKeyEd25519 is the decoded binary representation of an +ed25519 master key.</li> +<li>Similar to (non-sanitized) RSA fingerprints (<a href= +"#fingerprint" title= +"Replace RSA fingerprints">Section 2.2</a>), ed25519 master +keys could be used to uniquely identify bridges and to request a +current descriptor from the bridge authority. That is why they are +replaced with their SHA-256 hashes. In cases where a descriptor +only contains an ed25519 certificate and no ed25519 master key, the +(non-sanitized) master key is first extracted from the certificate +before sanitizing it.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="crypto"> +<h3 id="rfc.section.2.4"><a href= +"#rfc.section.2.4">2.4.</a> <a href="#crypto">Remove public +keys, certificates, and signatures</a></h3> +<div id="rfc.section.2.4.p.1"> +<p>[Removed.]</p> +<ul class="empty"> +<li>Some of the public keys and certificates could be used to +derive key fingerprints, hence they need to be replaced or removed. +However, replacing them seemed unnecessary and overly complex with +respect to keeping state on the sanitizing host. That is why most +public keys, certificates, and signatures are simply removed in the +sanitizing process.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="ipv4-address"> +<h3 id="rfc.section.2.5"><a href= +"#rfc.section.2.5">2.5.</a> <a href="#ipv4-address">Replace +IPv4 addresses</a></h3> +<div id="rfc.section.2.5.p.1"> +<p>SanitizedIpv4Address = "10." | KeyedHash</p> +</div> +<div id="rfc.section.2.5.p.2"> +<p>KeyedHash = SHA256(Ipv4Address | Fingerprint | Secret)[:3]</p> +<ul class="empty"> +<li>Address is the 4-byte long binary representation of the +(non-sanitized) IPv4 address.</li> +<li>Fingerprint is the 20-byte long binary representation of the +(non-sanitized) long-term identity fingerprint.</li> +<li>Secret is a 31-byte long secure random string that changes once +per month for all descriptors and statuses published in that +month.</li> +<li>The [:3] operator picks the first three bytes from the left of +the result and encodes it as three dot-separated decimal +numbers.</li> +<li>Sanitizing IPv4 addresses is obviously required to prevent +enumeration of bridges. The approach taken is here is to replace +IPv4 addresses with syntactical valid addresses in the private IPv4 +address space 10/8 based on a keyed hash function that produces the +same sanitized address for a given bridge, IPv4 address, and +month.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="ipv6-address"> +<h3 id="rfc.section.2.6"><a href= +"#rfc.section.2.6">2.6.</a> <a href="#ipv6-address">Replace +IPv6 addresses</a></h3> +<div id="rfc.section.2.6.p.1"> +<p>SanitizedIpv6Address = "[fd9f:2e19:3bcf::" | KeyedHash | "]"</p> +</div> +<div id="rfc.section.2.6.p.2"> +<p>KeyedHash = SHA256(Ipv6Address | Fingerprint | Secret)[:3]</p> +<ul class="empty"> +<li>Address is the 16-byte long binary representation of the +(non-sanitized) IPv6 address.</li> +<li>Fingerprint is the 20-byte long binary representation of the +(non-sanitized) long-term identity fingerprint.</li> +<li>Secret is a 19-byte long secure random string that changes once +per month for all descriptors and statuses published in that +month.</li> +<li>The [:3] operator picks the first three bytes from the left of +the result and encodes it as two lower-case hexadecimal numbers, a +colon, and another four lower-case hexadecimal numbers.</li> +<li>Similar to IPv4 addresses (<a href="#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>), IPv6 addresses are +replaced with syntactical valid addresses in the address range +[fd9f:2e19:3bcf::/116] based on a keyed hash function that produces +the same sanitized address for a given bridge, IPv6 address, and +month.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="tcp-port"> +<h3 id="rfc.section.2.7"><a href= +"#rfc.section.2.7">2.7.</a> <a href="#tcp-port">Replace TCP +ports</a></h3> +<div id="rfc.section.2.7.p.1"> +<p>SanitizedPort = KeyedHash / 2^2 + 2^15 + 2^14</p> +</div> +<div id="rfc.section.2.7.p.2"> +<p>KeyedHash = SHA256(Port | Fingerprint | Secret)[:2]</p> +<ul class="empty"> +<li>Port is the 2-byte long binary representation of the TCP +port.</li> +<li>Fingerprint is the 20-byte long binary representation of the +bridge's long-term identity fingerprint.</li> +<li>Secret is a 33-byte long secure random string that changes once +per month for all descriptors and statuses published in that +month.</li> +<li>The [:2] operator means that we pick the first two bytes from +the left of the result, and the /, ^, and + operators are all +integer operators.</li> +<li>TCP ports that are 0 in the original are left unchanged.</li> +<li>It may be less obvious that TCP ports need to be sanitized, but +an unusual TCP port used by a high-value bridge might still stand +out and provide yet another way to locate and block the bridge. +Therefore, each non-zero TCP port is replaced with a port number in +the range from 49152 to 65535, which is reserved for private +services, based on a keyed hash function that produces the same +sanitized port for a given bridge, TCP port, and month.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="contact"> +<h3 id="rfc.section.2.8"><a href= +"#rfc.section.2.8">2.8.</a> <a href="#contact">Remove contact +information</a></h3> +<div id="rfc.section.2.8.p.1"> +<p>SanitizedContact = "somebody"</p> +<ul class="empty"> +<li>If there is contact information in a descriptor, it is replaced +by the constant string "somebody". (Note that this sanitizing step +is subject to change and maybe be changed in a future version +towards retaining the original contact information.)</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="transport"> +<h3 id="rfc.section.2.9"><a href= +"#rfc.section.2.9">2.9.</a> <a href="#transport">Remove +extraneous transport information</a></h3> +<div id="rfc.section.2.9.p.1"> +<p>[Removed.]</p> +<ul class="empty"> +<li>Bridges may provide transports in addition to the OR protocol +and include information about these transports for the bridge +distribution service. In that case, any IP addresses, TCP ports, or +additional arguments are removed, only leaving in the supported +transport names.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="replaced-digest"> +<h3 id="rfc.section.2.10"><a href= +"#rfc.section.2.10">2.10.</a> <a href= +"#replaced-digest">Replace digests in referencing +descriptors</a></h3> +<div id="rfc.section.2.10.p.1"> +<p>SanitizedSha1Digest = SHA1(Sha1Digest)</p> +</div> +<div id="rfc.section.2.10.p.2"> +<p>SanitizedSha256Digest = SHA256(Sha256Digest)</p> +<ul class="empty"> +<li>Sha1Digest is the 20-byte long binary representation of a +descriptor's SHA-1 digest.</li> +<li>Sha256Digest is the 32-byte long binary representation of a +descriptor's SHA-256 digest.</li> +<li>Some descriptors reference other descriptors by their digest. +However, these digests are also somewhat sensitive, because it +shouldn't be possible to reconstruct the original descriptor with +help of these digests. That is why digests in referencing +descriptors are replaced with either the hex-encoded SHA-1 hash or +the base64-encoded SHA-256 hash of the original digest, depending +on which hash algorithm was used to generate the original digest. +The resulting digest string in a referencing descriptor can then be +matched to an appended digest (<a href="#appended-digest" title= +"Append digests to referenced descriptors">Section 2.11</a>) +in a referenced descriptor.</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="appended-digest"> +<h3 id="rfc.section.2.11"><a href= +"#rfc.section.2.11">2.11.</a> <a href= +"#appended-digest">Append digests to referenced +descriptors</a></h3> +<div id="rfc.section.2.11.p.1"> +<p>SanitizedSha1Digest = SHA1(Sha1Digest)</p> +</div> +<div id="rfc.section.2.11.p.2"> +<p>SanitizedSha256Digest = SHA256(Sha256Digest)</p> +<ul class="empty"> +<li>Sha1Digest is the 20-byte long binary representation of a +descriptor's SHA-1 digest.</li> +<li>Sha256Digest is the 32-byte long binary representation of a +descriptor's SHA-256 digest.</li> +<li>As stated above (<a href="#replaced-digest" title= +"Replace digests in referencing descriptors">Section 2.10</a>), +some descriptors are referenced by others by their digest. But in +contrast to non-sanitized descriptors, it's neither possible to +compute the digest of a sanitized descriptor nor is it desirable to +include the original digest. The reason is that it shouldn't be +possible to reconstruct the original descriptor with help of the +original digest. That is why descriptors that are typically +referenced from others may contain additional lines with the +hex-encoded SHA-1 hash or the base64-encoded SHA-256 hash of the +original digest, depending on which hash algorithm would have been +used to generate the original digest. The resulting digest string +can then be matched to a sanitized digest (<a href= +"#replaced-digest" title= +"Replace digests in referencing descriptors">Section 2.10</a>) +in a referencing descriptor.</li> +</ul> +</div> +</section> +</div>  +</section> +</div>  +<div class="container"> +<section id="n-server-descriptor-document-format"> +<h2 id="rfc.section.3"><a href= +"#rfc.section.3">3.</a> <a href="#n-server-descriptor-document-format">Server +descriptor document format</a></h2> +<div id="rfc.section.3.p.1"> +<p>The document format of sanitized bridge server descriptors +resembles the document format of (non-sanitized) server descriptors +as much as possible. Also refer to the <a href= +"https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt">Tor +directory protocol, version 3 specification</a>, as the following +sections only specify items that differ from their non-sanitized +counterparts.</p> +</div> +<div class="container"> +<section id="n-annotations_1"> +<h3 id="rfc.section.3.1"><a href= +"#rfc.section.3.1">3.1.</a> <a href= +"#n-annotations_1">Annotations</a></h3> +<div id="rfc.section.3.1.p.1"> +<p>The bridge authority may prefix descriptors with one or more +annotation lines containing metadata, and the sanitizer may add +annotation lines with metadata about the sanitizing process.</p> +</div> +<div id="rfc.section.3.1.p.2"> +<p>"@purpose" SP Purpose NL</p> +<ul class="empty"> +<li>[Removed.]</li> +</ul> +</div> +<div id="rfc.section.3.1.p.3"> +<p>"@type" SP "bridge-server-descriptor" SP Version</p> +<ul class="empty"> +<li>[Exactly once.]</li> +<li>Version can be one of the following numbers: +<ul> +<li>"1.0" was the first version. There was supposed to be a newer +version indicating added "ntor-onion-key" lines, but due to a +mistake only the version number of sanitized bridge extra-info +descriptors was raised. As a result, there may be sanitized bridge +server descriptors with version 1.0 with and without those +lines.</li> +<li>"1.1" added "master-key-ed25519" and "router-digest-sha256" +lines to server descriptors published by bridges using an ed25519 +master key.</li> +<li>"1.2" introduced sanitized TCP ports.</li> +</ul> +</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="n-descriptor-body_1"> +<h3 id="rfc.section.3.2"><a href= +"#rfc.section.3.2">3.2.</a> <a href= +"#n-descriptor-body_1">Descriptor body</a></h3> +<div id="rfc.section.3.2.p.1" class="avoidbreakafter"> +<p>The body of a sanitized bridge server descriptor contains +several sanitized items as specified in the following:</p> +</div> +<div id="rfc.section.3.2.p.2"> +<p>"router" SP Nickname SP SanitizedAddress SP SanitizedORPort SP +SOCKSPort SP SanitizedDirPort NL</p> +<ul class="empty"> +<li>[At start, exactly once.]</li> +<li>Nickname is the bridge's original, unchanged nickname.</li> +<li>SanitizedAddress is the bridge's sanitized IP address (<a href= +"#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>).</li> +<li>SanitizedORPort is the bridge's sanitized OR port (<a href= +"#tcp-port" title="Replace TCP ports">Section 2.7</a>) (since +version 1.2) or the original OR port (until version 1.1).</li> +<li>SOCKSPort is deprecated and always 0, as in the original, +non-sanitized server descriptor.</li> +<li>SanitizedDirPort is the bridge's sanitized directory port +(<a href="#tcp-port" title= +"Replace TCP ports">Section 2.7</a>) (since version 1.2) or +the original directory port (until version 1.1).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.3"> +<p>"or-address" SP SanitizedAddress ":" SanitizedPort NL</p> +<ul class="empty"> +<li>[Any number.]</li> +<li>SanitizedAddress is either an additional sanitized IPv4 address +(<a href="#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>) or sanitized IPv6 +address (<a href="#ipv6-address" title= +"Replace IPv6 addresses">Section 2.6</a>).</li> +<li>SanitizedPort is an additional sanitized OR port (<a href= +"#tcp-port" title="Replace TCP ports">Section 2.7</a>) (since +version 1.2) or original OR port (until version 1.1).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.4"> +<p>"identity-ed25519" NL CertificateBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +</ul> +</div> +<div id="rfc.section.3.2.p.5"> +<p>"master-key-ed25519" SP SanitizedMasterKey NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedMasterKey is the bridge's sanitized ed25519 master key +(<a href="#master-key-ed25519" title= +"Replace ed25519 master keys">Section 2.3</a>). (Introduced in +version 1.1, not present in earlier versions.)</li> +</ul> +</div> +<div id="rfc.section.3.2.p.6"> +<p>"fingerprint" SP SanitizedFingerprint NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedFingerprint is the bridge's sanitized fingerprint +(<a href="#fingerprint" title= +"Replace RSA fingerprints">Section 2.2</a>), formatted with a +single SP after every 4 characters.</li> +</ul> +</div> +<div id="rfc.section.3.2.p.7"> +<p>"contact" SP SanitizedContact NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedContact is the bridge's sanitized contact information +(<a href="#contact" title= +"Remove contact information">Section 2.8</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.8"> +<p>"reject" SP ExitPattern NL</p> +<ul class="empty"> +<li>[Any number.]</li> +<li>ExitPattern contains the bridge's sanitized IPv4 address +(<a href="#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>), if the original +line contained the bridge's primary IP address, and is otherwise +unchanged. (Note that "accept" lines are exempt from this +sanitizing step, which doesn't really make sense and which might +change in the future.)</li> +</ul> +</div> +<div id="rfc.section.3.2.p.9"> +<p>"extra-info-digest" SP SanitizedSha1Digest [SP +SanitizedSha256Digest] NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedSha1Digest is the sanitized SHA-1 digest (<a href= +"#replaced-digest" title= +"Replace digests in referencing descriptors">Section 2.10</a>) +of the corresponding extra-info descriptor.</li> +<li>SanitizedSha256Digest is the sanitized SHA-256 digest (<a href= +"#replaced-digest" title= +"Replace digests in referencing descriptors">Section 2.10</a>) +of corresponding extra-info descriptor and is only included if the +original line contained a SHA-256 digest.</li> +</ul> +</div> +<div id="rfc.section.3.2.p.10"> +<p>"family" (SP Name)* NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>Name is either the sanitized fingerprint (<a href= +"#fingerprint" title= +"Replace RSA fingerprints">Section 2.2</a>) or unchanged +nickname of another relay or bridge that is purportedly in the same +family as this bridge.</li> +</ul> +</div> +<div id="rfc.section.3.2.p.11"> +<p>"onion-key" NL PublicKeyBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The bridge's medium-term RSA key is removed together with most +other public keys, certificates, and signatures (<a href="#crypto" +title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.12"> +<p>"signing-key" NL PublicKeyBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The bridge's long-term RSA key is removed together with most +other public keys, certificates, and signatures (<a href="#crypto" +title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.13"> +<p>"onion-key-crosscert" NL SignatureBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>This cross signature created with the onion-key is removed +together with most other public keys, certificates, and signatures +(<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.14"> +<p>"ntor-onion-key-crosscert" SP PublicKey NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>This cross signature created with the ntor-onion-key is removed +together with most other public keys, certificates, and signatures +(<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.15"> +<p>"ntor-onion-key" SP NtorOnionKey NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>The curve25519 public key used for the ntor circuit extended +handshake is included without modification in most sanitized +descriptors. This key was originally missing in version 1.0, and +there was supposed to be a newer version indicating added +"ntor-onion-key" lines. But due to a mistake only the version +number of sanitized bridge extra-info descriptors was raised. As a +result, there are sanitized bridge server descriptors with version +1.0 with and without this line. All subsequent versions contain +this line</li> +</ul> +</div> +<div id="rfc.section.3.2.p.16"> +<p>"router-sig-ed25519" SP Signature NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The ed25519 signature is removed together with most other +public keys, certificates, and signatures (<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.17"> +<p>"router-signature" NL SignatureBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The RSA signature is removed together with most other public +keys, certificates, and signatures (<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.3.2.p.18"> +<p>"router-digest-sha256" SP SanitizedSha256Digest NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedSha256Digest is the sanitized SHA-256 digest (<a href= +"#appended-digest" title= +"Append digests to referenced descriptors">Section 2.11</a>) +of this descriptor and is only included if the original descriptor +contained an ed25519 signature of the descriptor's SHA-256 digest. +(Introduced in version 1.1, not present in earlier versions.)</li> +</ul> +</div> +<div id="rfc.section.3.2.p.19"> +<p>"router-digest" SP SanitizedSha1Digest NL</p> +<ul class="empty"> +<li>[At end, exactly once.]</li> +<li>SanitizedSha1Digest is the sanitized SHA-1 digest (<a href= +"#appended-digest" title= +"Append digests to referenced descriptors">Section 2.11</a>) +of this descriptor.</li> +</ul> +</div> +</section> +</div>  +</section> +</div>  +<div class="container"> +<section id="n-extra-info-descriptor-document-format"> +<h2 id="rfc.section.4"><a href= +"#rfc.section.4">4.</a> <a href="#n-extra-info-descriptor-document-format">Extra-info +descriptor document format</a></h2> +<div id="rfc.section.4.p.1"> +<p>The document format of sanitized extra-info descriptors follows +the same approach as sanitized server descriptors by changing as +few items as possible in their original, non-sanitized counterpart. +The original format is specified in the <a href= +"https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt">Tor +directory protocol, version 3</a>. Only the changes to that +specification are listed below.</p> +</div> +<div class="container"> +<section id="n-annotations_2"> +<h3 id="rfc.section.4.1"><a href= +"#rfc.section.4.1">4.1.</a> <a href= +"#n-annotations_2">Annotations</a></h3> +<div id="rfc.section.4.1.p.1"> +<p>"@type" SP "bridge-extra-info" SP Version</p> +<ul class="empty"> +<li>[Exactly once.]</li> +<li>Version can be one of the following numbers: +<ul> +<li>"1.0" was the first version.</li> +<li>"1.1" added sanitized "transport" lines.</li> +<li>"1.2" was supposed to indicate added "ntor-onion-key" lines, +but those changes only affected bridge server descriptors, not +extra-info descriptors. So, nothing has changed as compared to +version 1.1.</li> +<li>"1.3" added "master-key-ed25519" and "router-digest-sha256" +lines to extra-info descriptors published by bridges using an +ed25519 master key.</li> +</ul> +</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="n-descriptor-body_2"> +<h3 id="rfc.section.4.2"><a href= +"#rfc.section.4.2">4.2.</a> <a href= +"#n-descriptor-body_2">Descriptor body</a></h3> +<div id="rfc.section.4.2.p.1" class="avoidbreakafter"> +<p>Several items in the extra-info descriptor body are changed or +removed as compared to original, non-sanitized descriptors:</p> +</div> +<div id="rfc.section.4.2.p.2"> +<p>"extra-info" SP Nickname SP SanitizedFingerprint NL</p> +<ul class="empty"> +<li>[At start, exactly once.]</li> +<li>Nickname is the bridge's original, unchanged nickname.</li> +<li>SanitizedFingerprint is the bridge's sanitized fingerprint +(<a href="#fingerprint" title= +"Replace RSA fingerprints">Section 2.2</a>).</li> +</ul> +</div> +<div id="rfc.section.4.2.p.3"> +<p>"transport" SP TransportName NL</p> +<ul class="empty"> +<li>[Any number.]</li> +<li>TransportName is the transport name as found in the original +line.</li> +<li>Any further details about this transport (<a href="#transport" +title= +"Remove extraneous transport information">Section 2.9</a>), +including any IP addresses, TCP ports, or additional arguments are +removed, only leaving in the supported transport names. (Introduced +in version 1.1, not present in earlier versions.)</li> +</ul> +</div> +<div id="rfc.section.4.2.p.4"> +<p>"transport-info SP TransportInfo NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>Any lines containing extraneous transport information (<a href= +"#transport" title= +"Remove extraneous transport information">Section 2.9</a>) are +removed. (Note that these lines are not even specified for +original, non-sanitized descriptors.)</li> +</ul> +</div> +<div id="rfc.section.4.2.p.5"> +<p>"identity-ed25519" NL CertificateBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The RSA signature is removed together with most other public +keys, certificates, and signatures (<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.4.2.p.6"> +<p>"master-key-ed25519" SP SanitizedMasterKey NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedMasterKey is the bridge's sanitized ed25519 master key +(<a href="#master-key-ed25519" title= +"Replace ed25519 master keys">Section 2.3</a>). (Introduced in +version 1.3, not present in earlier versions.)</li> +</ul> +</div> +<div id="rfc.section.4.2.p.7"> +<p>"router-sig-ed25519" SP Signature NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The ed25519 signature is removed together with most other +public keys, certificates, and signatures (<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.4.2.p.8"> +<p>"router-signature" NL SignatureBlock NL</p> +<ul class="empty"> +<li>[Removed.]</li> +<li>The RSA signature is removed together with most other public +keys, certificates, and signatures (<a href="#crypto" title= +"Remove public keys, certificates, and signatures">Section 2.4</a>).</li> +</ul> +</div> +<div id="rfc.section.4.2.p.9"> +<p>"router-digest-sha256" SP SanitizedSha256Digest NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>SanitizedSha256Digest is the sanitized SHA-256 digest (<a href= +"#appended-digest" title= +"Append digests to referenced descriptors">Section 2.11</a>) +of this descriptor and is only included if the original descriptor +contained an ed25519 signature of the descriptor's SHA-256 digest. +(Introduced in version 1.3, not present in earlier versions.)</li> +</ul> +</div> +<div id="rfc.section.4.2.p.10"> +<p>"router-digest" SP SanitizedSha1Digest NL</p> +<ul class="empty"> +<li>[At end, exactly once.]</li> +<li>SanitizedSha1Digest is the sanitized SHA-1 digest (<a href= +"#appended-digest" title= +"Append digests to referenced descriptors">Section 2.11</a>) +of this descriptor.</li> +</ul> +</div> +</section> +</div>  +</section> +</div>  +<div class="container"> +<section id="n-network-status-document-format"> +<h2 id="rfc.section.5"><a href= +"#rfc.section.5">5.</a> <a href="#n-network-status-document-format">Network +status document format</a></h2> +<div id="rfc.section.5.p.1"> +<p>The document format of bridge network statuses is loosely based +on the network status format specified in the <a href= +"https://gitweb.torproject.org/torspec.git/tree/attic/dir-spec-v2.txt"> +Tor directory protocol, version 2</a>. However, the preamble of +bridge network statuses contains far fewer items than that of +(relay) network statuses, and the ones that are similar differ in +some of the details. That's why all preamble lines that exist in +sanitized bridge network statuses are specified below, not just the +ones that differ.</p> +</div> +<div class="container"> +<section id="n-annotations_3"> +<h3 id="rfc.section.5.1"><a href= +"#rfc.section.5.1">5.1.</a> <a href= +"#n-annotations_3">Annotations</a></h3> +<div id="rfc.section.5.1.p.1" class="avoidbreakafter"> +<p>Sanitized bridge network statuses start with one or more +annotations:</p> +</div> +<div id="rfc.section.5.1.p.2"> +<p>"@type" SP "bridge-network-status" SP Version NL</p> +<ul class="empty"> +<li>[Exactly once.]</li> +<li>Version can be one of the following numbers: +<ul> +<li>"1.0" was the first version.</li> +<li>"1.1" introduced sanitized TCP ports.</li> +<li>"1.2" introduced the "fingerprint" line, containing the +fingerprint of the bridge authority which produced the document, to +the header.</li> +</ul> +</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="n-preamble"> +<h3 id="rfc.section.5.2"><a href= +"#rfc.section.5.2">5.2.</a> <a href= +"#n-preamble">Preamble</a></h3> +<div id="rfc.section.5.2.p.1" class="avoidbreakafter"> +<p>The preamble contains zero or more of the following items in no +predefined order:</p> +</div> +<div id="rfc.section.5.2.p.2"> +<p>"published" SP Publication NL</p> +<ul class="empty"> +<li>[Exactly once.]</li> +<li>Publication is the publication time for this document, which is +left unchanged in the sanitizing process.</li> +</ul> +</div> +<div id="rfc.section.5.2.p.3"> +<p>"flag-thresholds" SP Thresholds NL</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>Thresholds are internal performance thresholds that the bridge +directory authority had at the moment it was forming a status, +which are left unchanged in the sanitizing process. This item was +first introduced in <a href= +"https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt">Tor +directory protocol, version 3</a>.</li> +</ul> +</div> +<div id="rfc.section.5.2.p.4"> +<p>"fingerprint" SP Fingerprint NL;</p> +<ul class="empty"> +<li>[At most once.]</li> +<li>Fingerprint is the (non-sanitized) SHA-1 hash of the bridge +authority's long-term signing key, encoded as 40 upper-case +hexadecimal characters, which is either added or left unchanged in +the sanitizing process. (Introduced in version 1.2, not present in +earlier versions.)</li> +</ul> +</div> +</section> +</div>  +<div class="container"> +<section id="n-router-entries"> +<h3 id="rfc.section.5.3"><a href= +"#rfc.section.5.3">5.3.</a> <a href="#n-router-entries">Router +entries</a></h3> +<div id="rfc.section.5.3.p.1"> +<p>For each bridge, there is one router entry containing one or +more items. Similar to the preamble specification, the following +specification lists all lines known in sanitized bridge network +statuses, including those that are left unchanged in the sanitizing +process.</p> +</div> +<div id="rfc.section.5.3.p.2"> +<p>"r" SP Nickname SP SanitizedFingerprint SP SanitizedSha1Digest +SP Publication SP SanitizedAddress SP SanitizedORPort SP +SanitizedDirPort NL</p> +<ul class="empty"> +<li>[At start, exactly once.]</li> +<li>Nickname is the bridge's original, unchanged nickname.</li> +<li>SanitizedFingerprint is the bridge's sanitized fingerprint +(<a href="#fingerprint" title= +"Replace RSA fingerprints">Section 2.2</a>).</li> +<li>SanitizedSha1Digest is the sanitized SHA-1 digest (<a href= +"#replaced-digest" title= +"Replace digests in referencing descriptors">Section 2.10</a>) +of the corresponding server descriptor.</li> +<li>Publication is the publication time for the corresponding +server descriptor, which is left unchanged in the sanitizing +process.</li> +<li>SanitizedAddress is the bridge's sanitized IP address (<a href= +"#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>).</li> +<li>SanitizedORPort is the bridge's sanitized OR port (<a href= +"#tcp-port" title="Replace TCP ports">Section 2.7</a>) (since +version 1.1) or the original OR port (until version 1.0).</li> +<li>SanitizedDirPort is the bridge's sanitized directory port +(<a href="#tcp-port" title= +"Replace TCP ports">Section 2.7</a>) (since version 1.1) or +the original directory port (until version 1.0).</li> +</ul> +</div> +<div id="rfc.section.5.3.p.3"> +<p>"a" SP SanitizedAddress ":" SanitizedPort NL</p> +<ul class="empty"> +<li>[Any number.]</li> +<li>SanitizedAddress is either an additional sanitized IPv4 address +(<a href="#ipv4-address" title= +"Replace IPv4 addresses">Section 2.5</a>) or sanitized IPv6 +address (<a href="#ipv6-address" title= +"Replace IPv6 addresses">Section 2.6</a>).</li> +<li>SanitizedPort is an additional sanitized OR port (<a href= +"#tcp-port" title="Replace TCP ports">Section 2.7</a>).</li> +</ul> +</div> +<div id="rfc.section.5.3.p.4"> +<p>"s" ... NL</p> +<ul class="empty"> +<li>[Unchanged.]</li> +</ul> +</div> +<div id="rfc.section.5.3.p.5"> +<p>"w" ... NL</p> +<ul class="empty"> +<li>[Unchanged.]</li> +</ul> +</div> +<div id="rfc.section.5.3.p.6"> +<p>"p" ... NL</p> +<ul class="empty"> +<li>[Unchanged.]</li> +</ul> +</div> +</section> +</div>  +</section> +</div>  +<jsp:include page="bottom.jsp"/>

1 0

[metrics-web/master] Link to new Tor bridge descriptors specification.
by karsten＠torproject.org 05 Aug '17

05 Aug '17

commit 8e15643cbcce09add914fe98905ec2117cf58b7d Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Sat Aug 5 22:23:04 2017 +0200 Link to new Tor bridge descriptors specification. --- .../src/main/resources/web/WEB-INF/collector.jsp | 83 +--------------------- website/src/main/resources/web/WEB-INF/sources.jsp | 11 +++ 2 files changed, 13 insertions(+), 81 deletions(-) diff --git a/website/src/main/resources/web/WEB-INF/collector.jsp b/website/src/main/resources/web/WEB-INF/collector.jsp index 4b37e5e..f57ccb8 100644 --- a/website/src/main/resources/web/WEB-INF/collector.jsp +++ b/website/src/main/resources/web/WEB-INF/collector.jsp @@ -366,89 +366,10 @@ descriptors, because that would defeat the purpose of making bridges hard to enumerate for censors. We therefore sanitize bridge descriptors by removing all potentially identifying information and publish sanitized versions here. -The sanitizing steps are as follows: +The sanitizing steps are specified in detail on a separate +<a href="bridge-descriptors.html">page</a>. </p> -<ol> -<li><b>Replace bridge identities with their digests:</b> Clients -can request a bridge's current descriptor by sending its identity string -to the bridge authority. -This is a feature to make bridges on dynamic IP addresses useful. -Therefore, the original identities (and anything that could be used to -derive them) need to be removed from the descriptors. -The bridge's RSA-based identity fingerprint is replaced with its SHA-1 -hash value, and the bridge's optional base64-encoded Ed25519 master key is -replaced with its SHA-256 digest. -The idea is to have a consistent replacement that remains stable over -months or even years (without keeping a secret for a keyed hash -function).</li> -<li><b>Remove most cryptographic keys and signatures:</b> It would be -straightforward to learn about the bridge identity from the bridge's -public key. -Replacing keys by newly generated ones seemed to be unnecessary (and would -involve keeping a state over months/years), so that most cryptographic -keys and signatures have simply been removed.</li> -<li><b>Replace IP address with IP address hash:</b> Of course, IP -addresses need to be sanitized, too. -<ul><li>IPv4 addresses are replaced with <code>10.x.x.x</code> with -<code>x.x.x</code> being the 3 byte output of -<code>H(IP address | bridge identity | secret)[:3]</code>. -The input <code>IP address</code> is the 4-byte long binary representation of -the bridge's current IP address. -The <code>bridge identity</code> is the 20-byte long binary representation of -the bridge's long-term identity fingerprint. -The <code>secret</code> is a 31-byte long secure random string that changes -once per month for all descriptors and statuses published in that month. -<code>H()</code> is SHA-256. -The <code>[:3]</code> operator means that we pick the 3 most significant bytes -of the result.</li> -<li>IPv6 addresses are replaced with <code>[fd9f:2e19:3bcf::xx:xxxx]</code> -with <code>xx:xxxx</code> being the hex-formatted 3 byte output of a similar -hash function as described for IPv4 addresses. -The only differences are that the input <code>IP address</code> is 16 bytes -long and the <code>secret</code> is only 19 bytes long.</li></ul></li> -<li><b>Replace TCP port with TCP port hash:</b> It may be less obvious -that TCP ports need to be sanitized, but an unusual TCP port used by a -high-value bridge might still stand out and provide yet another way to -locate and block the bridge. -Therefore, each non-zero TCP port is replaced with a number in the range -from 49152 to 65535 that is the result of -<code>H(port | bridge identity | secret)[:2] / 2^2 + 2^15 + 2^14</code> -written as decimal number. -The input <code>port</code> is the 2-byte long binary representation of the -TCP port. -The <code>bridge identity</code> is the 20-byte long binary representation of -the bridge's long-term identity fingerprint. -The <code>secret</code> is a 33-byte long secure random string that changes -once per month for all descriptors and statuses published in that month. -<code>H()</code> is SHA-256. -The <code>[:2]</code> operator means that we pick the 2 most significant bytes -of the result. -The subsequent integer division and additions make sure that sanitized -ports are in the range from 49152 to 65535 which is reserved for private -services. -All operations assume inputs to be in network byte order. -TCP ports that are 0 in the original descriptor are left unchanged.</li> -<li><b>Replace contact information:</b> If there is contact information in -a descriptor, the contact line is changed to -<code>somebody</code>.</li> -<li><b>Remove pluggable transport addresses and arguments:</b> Bridges may -provide transports in addition to the onion-routing protocol and include -information about these transports in their extra-info descriptors for -BridgeDB. -In that case, any IP addresses, TCP ports, or additional arguments are -removed, only leaving in the supported transport names.</li> -<li><b>Append descriptor digests:</b> Descriptors are often referenced by -their digest, but that is not possible anymore once their content has -changed. -As a workaround, sanitized descriptors contain a new line -<code>router-digest</code> with the hex representation of the SHA-1 of the -original descriptor digest excluding RSA signature and—if the bridge -uses an Ed25519 identity—a new line <code>router-digest-sha256</code> -with the base64-encoded SHA-256 of the SHA-256 digest of the original -descriptor including all signatures.</li> -</ol> - <h3 id="type-bridge-network-status" class="hover">Bridge Network Statuses <small><code>@type bridge-network-status 1.2</code></small> <a href="https://collector.torproject.org/recent/bridge-descriptors/statuses/" target="_blank" class="btn btn-primary btn-xs"><i class="fa fa-chevron-right" aria-hidden="true"></i> recent</a> diff --git a/website/src/main/resources/web/WEB-INF/sources.jsp b/website/src/main/resources/web/WEB-INF/sources.jsp index 43a926b..a0f5460 100644 --- a/website/src/main/resources/web/WEB-INF/sources.jsp +++ b/website/src/main/resources/web/WEB-INF/sources.jsp @@ -41,5 +41,16 @@ </ul> </div> + <div class="container"> + <h2>Specifications <a href="#specifications" name="specifications" class="anchor">#</a></h2> + <p>The following specification documents are available for Tor network data.</p> + <ul> + <li><a href="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt" target="_blank">Tor directory protocol, version 3</a></li> + <li><a href="https://gitweb.torproject.org/torspec.git/tree/attic/dir-spec-v2.txt" target="_blank">Tor directory protocol, version 2</a></li> + <li><a href="https://gitweb.torproject.org/torspec.git/tree/attic/dir-spec-v1.txt" target="_blank">Tor directory protocol, version 1</a></li> + <li><a href="bridge-descriptors.html">Tor bridge descriptors</a></li> + </ul> + </div> + <jsp:include page="bottom.jsp"/>

1 0