Changeset 10561

Timestamp:

02/06/2008 10:01:00 AM (11 months ago)

Author:

arvid

Message:

updates to make file to refer to the tempalte.txt. Fixed broken links in bep 0000. Updated wording and added references to metadata extension. Fixed layout of bep 0004

Location:

dotorg/trunk_fixed/html/beps

Files:

• bep_0000.rst (modified) (1 diff)
• bep_0004.rst (modified) (3 diffs)
• bep_0009.rst (modified) (3 diffs)
• makefile (modified) (1 diff)

dotorg/trunk_fixed/html/beps/bep_0000.rst

@@ -56 +56 @@
 .. |8| replace:: :raw-html:`<A HREF="bep_0008.html">8</A>`
 .. |9| replace:: :raw-html:`<A HREF="bep_0009.html">9</A>`
-.. |10| replace:: :raw-html:`<A HREF="bep_0009.html">10</A>`
+.. |10| replace:: :raw-html:`<A HREF="bep_0010.html">10</A>`
 .. |1000| replace:: :raw-html:`<A HREF="bep_1000.html">1000</A>`

dotorg/trunk_fixed/html/beps/bep_0004.rst

@@ -24 +24 @@
 
  reserved[5]
- 0x10  LTEP (LibTorrent Extension Protocol)
+ 0x10  LTEP (Libtorrent Extension Protocol)
 
  reserved[7]
@@ -45 +45 @@
  0x07   piece
  0x08   cancel
+
+ DHT Extension:
  0x09   port
 
- Fast Extensions
-
+ Fast Extensions:
  0x0D   suggest
  0x0E   have all
@@ -55 +56 @@
  0x11   allowed fast
 
- Additional IDs used in deployed clients
+ Additional IDs used in deployed clients:
  0x14   LTEP Handshake (implemented in libtorrent, uTorrent,...)
+
 
 

dotorg/trunk_fixed/html/beps/bep_0009.rst

@@ -23 +23 @@
 part of the .torrent file is referred to as *the metadata*.
 
-The metadata is plit up in 16kiB pieces. The pieces are indexed starting
-from 0 for the first 16kiB of metadata.
+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.
 
 extension header
 ================
 
-The metadata extension uses the `extension protocol`_ to advertize its
-existence. It adds the "ut_metadata" entry to the "m" dictionary in the
-extension header hand-shake message. This identifies the message code
-used for this message. It also adds "metadata_size" to the handshake
-message (not the "m" dictionary) specifying an integer value of the
+The metadata extension uses the extension protocol (specified in `BEP 0010`_
+) to advertize its existence. It adds the "ut_metadata" entry to the "m"
+dictionary in the extension header hand-shake message. This identifies the
+message code used for this message. It also adds "metadata_size" to the
+handshake message (not the "m" dictionary) specifying an integer value of the
 number of bytes of the metadata.
 
-.. _`extension protocol`: extension_protocol.html
+.. _`BEP 0010`: http://www.bittorrent.org/beps/bep_0010.html
 
 Example extension handshake message::
@@ -120 +121 @@
 
 <info-hash>
-        Is the info-hash encoded as base32.
+        Is the info-hash encoded as base32 [#base32]_
 
 ``xt`` is the only mandatory parameter. ``dn`` is the display name that may be
@@ -129 +130 @@
 Both ``dn`` and ``tr`` are optional.
 
-If no tracker is specified, the client SHOULD use the DHT to acquire peers.
+If no tracker is specified, the client SHOULD use the DHT (`BEP 0005`_) to acquire peers.
 
+.. [#base32] http://www.ietf.org/rfc/rfc3548.txt
+.. _`BEP 0005`: bep_0005.html
 
 

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
-        postprocess.py $? > $@ 
+        python postprocess.py $? > $@ 
 
 #%.html:%.rst