regenerated html

docs/building.html

@@ -657,10 +657,6 @@ when <tt class="docutils literal">link=shared</tt> is set).</td>
 <td>If this is defined, the support for trackerless
 torrents will be disabled.</td>
 </tr>
-<tr><td><tt class="docutils literal">TORRENT_DHT_VERBOSE_LOGGING</tt></td>
-<td>This will enable verbose logging of the DHT
-protocol traffic.</td>
-</tr>
 <tr><td><tt class="docutils literal">TORRENT_DISABLE_ENCRYPTION</tt></td>
 <td>This will disable any encryption support and
 the dependencies of a crypto library.

docs/index.html

@@ -46,7 +46,7 @@
 </tbody>
 </table>
 <div id="librarySidebar"><ul class="simple">
-<li><a class="reference external" href="https://sourceforge.net/projects/libtorrent/files/libtorrent/">download</a></li>
+<li><a class="reference external" href="https://github.com/arvidn/libtorrent/releases">download</a></li>
 <li><a class="reference external" href="https://sourceforge.net/projects/libtorrent/files/py-libtorrent/">download python binding</a></li>
 <li><a class="reference external" href="features.html">features</a></li>
 <li><a class="reference external" href="contributing.html">contributing</a></li>
@@ -59,8 +59,8 @@
 <li><a class="reference external" href="client_test.png">screenshot</a></li>
 <li><a class="reference external" href="http://lists.sourceforge.net/lists/listinfo/libtorrent-discuss">mailing list</a> (<a class="reference external" href="http://dir.gmane.org/gmane.network.bit-torrent.libtorrent">archive</a>)</li>
 <li><a class="reference external" href="projects.html">who's using libtorrent?</a></li>
-<li><a class="reference external" href="http://code.google.com/p/libtorrent/issues/entry">report bugs</a></li>
-<li><a class="reference external" href="http://sourceforge.net/projects/libtorrent">sourceforge page</a></li>
+<li><a class="reference external" href="https://github.com/arvidn/libtorrent/issues">report bugs</a></li>
+<li><a class="reference external" href="http:/github.com/arvidn/libtorrent">github page</a></li>
 <li><a class="reference external" href="http://blog.libtorrent.org">blog</a></li>
 </ul>
 <hr class="docutils" />
@@ -121,16 +121,15 @@ to the author of the library by including the libtorrent license in your
 software or documentation.</p>
 <p>It is however greatly appreciated if additional features are contributed
 back to the open source project. Patches can be emailed to the mailing
-list or posted to the <a class="reference external" href="https://code.google.com/p/libtorrent/issues/list">bug tracker</a>.</p>
+list or posted to the <a class="reference external" href="https://github.com/arvidn/libtorrent/issues">bug tracker</a>.</p>
 </div>
 <div class="section" id="acknowledgements">
 <h2>Acknowledgements</h2>
-<p>Written by Arvid Norberg. Copyright © 2003-2014</p>
+<p>Written by Arvid Norberg. Copyright © 2003-2015</p>
 <p>Contributions by Magnus Jonsson, Daniel Wallin and Cory Nelson</p>
 <p>Thanks to Reimond Retz for bugfixes, suggestions and testing</p>
 <p>Thanks to <a class="reference external" href="http://www.cs.umu.se">Umeå University</a> for providing development and test hardware.</p>
-<p>Project is hosted by sourceforge.</p>
-<p><a class="reference external" href="http://sourceforge.net"><img alt="sf_logo" src="http://sourceforge.net/sflogo.php?group_id=7994" /></a></p>
+<p>Project is hosted by <a class="reference external" href="https://www.github.com/arvidn/libtorrent">github</a>.</p>
 </div></div>
 </div>
 

docs/settings.rst

@@ -1828,7 +1828,7 @@ disconnected.
 +------------------------------+------+------------+
 | name                         | type | default    |
 +==============================+======+============+
-| send_buffer_low_watermark    | int  | 512        |
+| send_buffer_low_watermark    | int  | 10 * 1024  |
 +------------------------------+------+------------+
 | send_buffer_watermark        | int  | 500 * 1024 |
 +------------------------------+------+------------+
@@ -2296,28 +2296,6 @@ It defaults to 3 pieces, which means that when seeding, any peer
 we've sent more than this number of pieces to will be unchoked in
 favour of a choked peer.
 
-.. _max_sparse_regions:
-
-.. raw:: html
-
-	<a name="max_sparse_regions"></a>
-
-+--------------------+------+---------+
-| name               | type | default |
-+====================+======+=========+
-| max_sparse_regions | int  | 0       |
-+--------------------+------+---------+
-
-``max_sparse_regions`` is a limit of the number of *sparse regions*
-in a torrent. A sparse region is defined as a hole of pieces we
-have not yet downloaded, in between pieces that have been
-downloaded. This is used as a hack for windows vista which has a
-bug where you cannot write files with more than a certain number of
-sparse regions. This limit is not hard, it will be exceeded. Once
-it's exceeded, pieces that will maintain or decrease the number of
-sparse regions are prioritized. To disable this functionality, set
-this to 0. It defaults to 0 on all platforms except windows.
-
 .. _max_rejects:
 
 .. raw:: html
@@ -2762,7 +2740,7 @@ replace existing ones.
 +=====================+======+=========+
 | utp_target_delay    | int  | 100     |
 +---------------------+------+---------+
-| utp_gain_factor     | int  | 1500    |
+| utp_gain_factor     | int  | 3000    |
 +---------------------+------+---------+
 | utp_min_timeout     | int  | 500     |
 +---------------------+------+---------+
@@ -2770,7 +2748,7 @@ replace existing ones.
 +---------------------+------+---------+
 | utp_fin_resends     | int  | 2       |
 +---------------------+------+---------+
-| utp_num_resends     | int  | 6       |
+| utp_num_resends     | int  | 3       |
 +---------------------+------+---------+
 | utp_connect_timeout | int  | 3000    |
 +---------------------+------+---------+
@@ -2902,8 +2880,7 @@ fill up to this level.
 +-------------------+------+------------------+
 
 ``max_metadata_size`` is the maximum allowed size (in bytes) to be
-received by the metadata extension, i.e. magnet links. It defaults
-to 1 MiB.
+received by the metadata extension, i.e. magnet links.
 
 .. _hashing_threads:
 
@@ -3184,6 +3161,17 @@ kinds of alerts to receive
 
 control the settings for incoming and outgoing connections
 respectively. see enc_policy enum for the available options.
+Keep in mind that protocol encryption degrades performance in
+several respects:
+1. It prevents "zero copy" disk buffers being sent to peers, since
+   each peer needs to mutate the data (i.e. encrypt it) the data
+   must be copied per peer connection rather than sending the same
+   buffer to multiple peers.
+2. The encryption itself requires more CPU than plain bittorrent
+   protocol. The highest cost is the Diffie Hellman exchange on
+   connection setup.
+3. The encryption handshake adds several round-trips to the
+connection setup, and delays transferring data.
 
 .. _allowed_enc_level: