document the Acquire::http::Dl-Limit option in the manpage

diff --git a/debian/changelog b/debian/changelog
index 90e5f8de1661f8314d3c9b3285f2cc8145567138..4bf13236768f396f4f3daae02f96e1773eb38d49 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -27,6 +27,8 @@ apt (0.7.24) UNRELEASED; urgency=low
   * apt-pkg/aptconfiguration.cc, doc/apt.conf.5.xml:
     - add an order subgroup to the compression types to simplify reordering
       a bit and improve the documentation for this option group.
   * apt-pkg/aptconfiguration.cc, doc/apt.conf.5.xml:
     - add an order subgroup to the compression types to simplify reordering
       a bit and improve the documentation for this option group.

+  * doc/apt.conf.5.xml:
+    - document the Acquire::http::Dl-Limit option

   * doc/apt.ent, all man pages:
     - move the description of files to globally usable entities
   * doc/apt_preferences.5.xml:
   * doc/apt.ent, all man pages:
     - move the description of files to globally usable entities
   * doc/apt_preferences.5.xml:

diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index 67aa933cceb2970f2d2726c87411bea22bc6b3b5..11c086bf2c13fd9d9fe073a8f116e9d2ee6e3f9b 100644 (file)
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -227,7 +227,12 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
      indicating how many outstanding requests APT should send. A value of
      zero MUST be specified if the remote host does not properly linger
      on TCP connections - otherwise data corruption will occur. Hosts which
      indicating how many outstanding requests APT should send. A value of
      zero MUST be specified if the remote host does not properly linger
      on TCP connections - otherwise data corruption will occur. Hosts which

-     require this are in violation of RFC 2068.</para></listitem>
+     require this are in violation of RFC 2068.</para>
+
+     <para>The used bandwidth can be limited with <literal>Acquire::http::Dl-Limit</literal>
+     which accepts integer values in kilobyte. The default value is 0 which deactivates
+     the limit and tries uses as much as possible of the bandwith (Note that this option implicit
+     deactivates the download from multiple servers at the same time.)</para></listitem>

      </varlistentry>
 
      <varlistentry><term>https</term>
      </varlistentry>
 
      <varlistentry><term>https</term>