Changeset 10595

Timestamp:

02/07/2008 04:37:01 PM (11 months ago)

Author:

dave

Message:

generated html with fixes from Arvid. Plus refining some text in bep_0008. Fixed makefile.

Location:

dotorg/trunk_fixed/html/beps

Files:

• bep_0000.html (modified) (2 diffs)
• bep_0004.html (modified) (4 diffs)
• bep_0008.html (modified) (2 diffs)
• bep_0009.html (modified) (6 diffs)
• bep_1000.html (modified) (1 diff)
• makefile (modified) (1 diff)

dotorg/trunk_fixed/html/beps/bep_0000.html

@@ -38 +38 @@
 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Index of BitTorrent Enhancement Proposals</td>
 </tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">10528</td>
+<tr class="field"><th class="field-name">Version:</th><td class="field-body">10561</td>
 </tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0000.rst">2008-02-04 16:10:30 -0800 (Mon, 04 Feb 2008)</a></td>
+<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0000.rst">2008-02-06 10:01:00 -0800 (Wed, 06 Feb 2008)</a></td>
 </tr>
 <tr class="field"><th class="field-name">Author:</th><td class="field-body">David Harrison &lt;dave&#32;&#97;t&#32;bittorrent.com&gt;</td>
@@ -107 +107 @@
 <td>Metadata Extension</td>
 </tr>
-<tr><td><span class="raw-html"><A HREF="bep_0009.html">10</A></span></td>
+<tr><td><span class="raw-html"><A HREF="bep_0010.html">10</A></span></td>
 <td>Extension Protocol</td>
 </tr>

dotorg/trunk_fixed/html/beps/bep_0004.html

@@ -38 +38 @@
 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Assigned Numbers</td>
 </tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">10528</td>
+<tr class="field"><th class="field-name">Version:</th><td class="field-body">10561</td>
 </tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0004.rst">2008-02-04 16:10:30 -0800 (Mon, 04 Feb 2008)</a></td>
+<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0004.rst">2008-02-06 10:01:00 -0800 (Wed, 06 Feb 2008)</a></td>
 </tr>
 <tr class="field"><th class="field-name">Author:</th><td class="field-body">David Harrison</td>
@@ -73 +73 @@
 
 reserved[5]
-0x10  LTEP (LibTorrent Extension Protocol)
+0x10  LTEP (Libtorrent Extension Protocol)
 
 reserved[7]
@@ -93 +93 @@
 0x07   piece
 0x08   cancel
+
+DHT Extension:
 0x09   port
 
-Fast Extensions
-
+Fast Extensions:
 0x0D   suggest
 0x0E   have all
@@ -103 +104 @@
 0x11   allowed fast
 
-Additional IDs used in deployed clients
+Additional IDs used in deployed clients:
 0x14   LTEP Handshake (implemented in libtorrent, uTorrent,...)
 </pre>

dotorg/trunk_fixed/html/beps/bep_0008.html

@@ -38 +38 @@
 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Tracker Peer Obfuscation</td>
 </tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">10560</td>
-</tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0008.rst">2008-02-06 02:55:28 -0800 (Wed, 06 Feb 2008)</a></td>
+<tr class="field"><th class="field-name">Version:</th><td class="field-body">10594</td>
+</tr>
+<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0008.rst">2008-02-07 16:25:30 -0800 (Thu, 07 Feb 2008)</a></td>
 </tr>
 <tr class="field"><th class="field-name">Author:</th><td class="field-body">David Harrison &lt;dave&#32;&#97;t&#32;bittorrent.com&gt;, Anthony Ciani &lt;tony&#32;&#97;t&#32;ciani.phy.uic.edu&gt;, Arvid Norberg &lt;arvid&#32;&#97;t&#32;bittorrent.com&gt;, Greg Hazel &lt;greg&#32;&#97;t&#32;bittorrent.com&gt;</td>
@@ -409 +409 @@
 <div class="section" id="example-python-code">
 <h1>Example Python Code</h1>
-<p>Dummy tracker implementing tracker peer obfuscation:</p>
+<p>Request handling in a dummy tracker implementing tracker peer obfuscation:</p>
 <pre class="literal-block">
 from sha import sha

dotorg/trunk_fixed/html/beps/bep_0009.html

@@ -38 +38 @@
 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Metadata Extension</td>
 </tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">10528</td>
-</tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0009.rst">2008-02-04 16:10:30 -0800 (Mon, 04 Feb 2008)</a></td>
+<tr class="field"><th class="field-name">Version:</th><td class="field-body">10561</td>
+</tr>
+<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_0009.rst">2008-02-06 10:01:00 -0800 (Wed, 06 Feb 2008)</a></td>
 </tr>
 <tr class="field"><th class="field-name">Author:</th><td class="field-body">Greg Hazel &lt;greg&#32;&#97;t&#32;bittorrent.com&gt;, Arvid Norberg &lt;arvid&#32;&#97;t&#32;bittorrent.com&gt;</td>
@@ -58 +58 @@
 <p class="topic-title first">Contents</p>
 <ul class="simple">
-<li><a class="reference internal" href="#metadata" id="id4">metadata</a></li>
-<li><a class="reference internal" href="#extension-header" id="id5">extension header</a></li>
-<li><a class="reference internal" href="#extension-message" id="id6">extension message</a><ul>
-<li><a class="reference internal" href="#request" id="id7">request</a></li>
-<li><a class="reference internal" href="#data" id="id8">data</a></li>
-<li><a class="reference internal" href="#reject" id="id9">reject</a></li>
+<li><a class="reference internal" href="#metadata" id="id7">metadata</a></li>
+<li><a class="reference internal" href="#extension-header" id="id8">extension header</a></li>
+<li><a class="reference internal" href="#extension-message" id="id9">extension message</a><ul>
+<li><a class="reference internal" href="#request" id="id10">request</a></li>
+<li><a class="reference internal" href="#data" id="id11">data</a></li>
+<li><a class="reference internal" href="#reject" id="id12">reject</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#magnet-uri-format" id="id10">magnet URI format</a></li>
-<li><a class="reference internal" href="#id1" id="id11">References</a></li>
+<li><a class="reference internal" href="#magnet-uri-format" id="id13">magnet URI format</a></li>
+<li><a class="reference internal" href="#id2" id="id14">References</a></li>
 </ul>
 </div>
@@ -81 +81 @@
 file. This part can be validated by the info-hash. In this document, that
 part of the .torrent file is referred to as <em>the metadata</em>.</p>
-<p>The metadata is plit up in 16kiB pieces. The pieces are indexed starting
-from 0 for the first 16kiB of metadata.</p>
+<p>The metadata is handled in bocks of 16KiB (65536 Bytes). The metadata blocks
+are indexed starting at 0. All blocks are 16KiB except the last block which may
+be smaller.</p>
 </div>
 <div class="section" id="extension-header">
 <h1>extension header</h1>
-<p>The metadata extension uses the <a class="reference external" href="extension_protocol.html">extension protocol</a> <a class="footnote-reference" href="#id2" id="id3">[1]</a> to advertize its
-existence. It adds the &quot;ut_metadata&quot; entry to the &quot;m&quot; dictionary in the
-extension header hand-shake message. This identifies the message code
-used for this message. It also adds &quot;metadata_size&quot; to the handshake
-message (not the &quot;m&quot; dictionary) specifying an integer value of the
+<p>The metadata extension uses the extension protocol (specified in <a class="reference external" href="http://www.bittorrent.org/beps/bep_0010.html">BEP 0010</a> <a class="footnote-reference" href="#id3" id="id4">[2]</a>
+) to advertize its existence. It adds the &quot;ut_metadata&quot; entry to the &quot;m&quot;
+dictionary in the extension header hand-shake message. This identifies the
+message code used for this message. It also adds &quot;metadata_size&quot; to the
+handshake message (not the &quot;m&quot; dictionary) specifying an integer value of the
 number of bytes of the metadata.</p>
 <p>Example extension handshake message:</p>
@@ -164 +165 @@
 <dl class="docutils">
 <dt>&lt;info-hash&gt;</dt>
-<dd>Is the info-hash encoded as base32.</dd>
+<dd>Is the info-hash encoded as base32 <a class="footnote-reference" href="#base32" id="id1">[1]</a></dd>
 </dl>
 <p><tt class="docutils literal"><span class="pre">xt</span></tt> is the only mandatory parameter. <tt class="docutils literal"><span class="pre">dn</span></tt> is the display name that may be
@@ -171 +172 @@
 may be included.</p>
 <p>Both <tt class="docutils literal"><span class="pre">dn</span></tt> and <tt class="docutils literal"><span class="pre">tr</span></tt> are optional.</p>
-<p>If no tracker is specified, the client SHOULD use the DHT to acquire peers.</p>
+<p>If no tracker is specified, the client SHOULD use the DHT (<a class="reference external" href="bep_0005.html">BEP 0005</a> <a class="footnote-reference" href="#id5" id="id6">[3]</a>) to acquire peers.</p>
+<table class="docutils footnote" frame="void" id="base32" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><a class="reference external" href="http://www.ietf.org/rfc/rfc3548.txt">http://www.ietf.org/rfc/rfc3548.txt</a></td></tr>
+</tbody>
+</table>
 <!-- Local Variables:
 mode: indented-text
@@ -180 +187 @@
 End: -->
 </div>
-<div class="section" id="id1">
+<div class="section" id="id2">
 <h1>References</h1>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
+<table class="docutils footnote" frame="void" id="id3" rules="none">
 <colgroup><col class="label" /><col /></colgroup>
 <tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id3">[1]</a></td><td><a class="reference external" href="extension_protocol.html">extension_protocol.html</a></td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id4">[2]</a></td><td><a class="reference external" href="http://www.bittorrent.org/beps/bep_0010.html">http://www.bittorrent.org/beps/bep_0010.html</a></td></tr>
+</tbody>
+</table>
+<table class="docutils footnote" frame="void" id="id5" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id6">[3]</a></td><td><a class="reference external" href="bep_0005.html">bep_0005.html</a></td></tr>
 </tbody>
 </table>

dotorg/trunk_fixed/html/beps/bep_1000.html

@@ -38 +38 @@
 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Pending Standards Track Documents</td>
 </tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">10517</td>
+<tr class="field"><th class="field-name">Version:</th><td class="field-body">10579</td>
 </tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_1000.rst">2008-02-04 15:53:01 -0800 (Mon, 04 Feb 2008)</a></td>
+<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="https://svn.bittorrent.com/trac.cgi/browser/dotorg/trunk/html/beps/bep_1000.rst">2008-02-07 02:58:49 -0800 (Thu, 07 Feb 2008)</a></td>
 </tr>
 <tr class="field"><th class="field-name">Author:</th><td class="field-body">David Harrison &lt;dave&#32;&#97;t&#32;bittorrent.com&gt;</td>

dotorg/trunk_fixed/html/beps/makefile

@@ -17 +17 @@
 
 %.html:%.rst_post
-        rstbep2html.py --template=../template.txt --pep-base-url=http://www.bittorrent.org/beps/ --cloak-email-addresses --link-stylesheet --stylesheet=../css/bep.css --no-toc-backlinks $? >$@ --traceback
+        rstbep2html.py --template=template.txt --pep-base-url=http://www.bittorrent.org/beps/ --cloak-email-addresses --link-stylesheet --stylesheet=../css/bep.css --no-toc-backlinks $? >$@ --traceback
 
 %.rst_post: %.rst