Bug#1071669: Document that Dl-Limit=9M is actually the same as 9K

[Dan Jacobson <jidanni@jidanni.org>]

Package: apt
Version: 2.9.3
Severity: minor

apt-transport-http
apt-transport-https
both say

       The used bandwidth can be limited with Acquire::http::Dl-Limit which
       accepts integer values in kilobytes per second.

Well many people use e.g., Dl-Limit=20K and no error is caused.

That's very unfortunate. As it gives the false impression that
Dl-Limit=20M will be 1000 times faster than Dl-Limit=20K,
but the sad truth is they both simply just mean Dl-Limit=20 !

Therefore those man pages (and anywhere else Dl-Limit is mentioned)
should say that such letters are ignored.

Indeed if you started all over again, you should have
1. Respected the letters. Or,
2. Raised an error on encountering the letters.

But in the interest of not breaking scripts, at least you can now
3. Document that the letters are actually ignored!

Thanks.