r263 - in /apt-transport-debtorrent/trunk: README debian/control debian/docs debian/rules

Fri Aug 17 17:13:20 UTC 2007

Author: camrdale-guest
Date: Fri Aug 17 17:13:20 2007
New Revision: 263

URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=263
Log:
Added new README file.

Added:
    apt-transport-debtorrent/trunk/README
    apt-transport-debtorrent/trunk/debian/docs
Modified:
    apt-transport-debtorrent/trunk/debian/control
    apt-transport-debtorrent/trunk/debian/rules

Added: apt-transport-debtorrent/trunk/README
URL: http://svn.debian.org/wsvn/debtorrent/apt-transport-debtorrent/trunk/README?rev=263&op=file
==============================================================================

--- apt-transport-debtorrent/trunk/README (added)
+++ apt-transport-debtorrent/trunk/README Fri Aug 17 17:13:20 2007
@@ -1,0 +1,58 @@
+This package contains the APT debtorrent transport. It makes it possible to
+use 'deb debtorrent://localhost:9988/foo distro main' type lines in your
+sources.list file.
+
+For an overview of the DebTorrent program, see the 'debtorrent' package, or
+go to the homepage: http://debtorrent.alioth.debian.org/
+
+You don't actually need this package to use the DebTorrent program, it will
+work fine using the regular http:// transport.
+
+However, using this method has some advantages over HTTP. Unlike the
+traditional HTTP method, this transport will send all possible requests to
+DebTorrent as soon as it receieves them, which will speed up the download
+as peers can be contacted in parallel. This method also allows the
+DebTorrent client to return files to APT in any order, which is important
+since DebTorrent downloads proceed in a random order.
+
+This method uses a very similar protocol to HTTP, and so, like the http
+method, can easily be used to access a DebTorrent client running on another
+host on a local network.
+
+To use the new transport, your /etc/apt/sources.list file needs to be
+modified to use the new method. If your original sources.list had a line
+like this:
+
+deb http://ftp.us.debian.org/debian unstable main contrib non-free
+
+Then to access the DebTorrent client on the local machine using http on
+the default port (9988) you would have changed the line to read this:
+
+deb http://localhost:9988/ftp.us.debian.org/debian unstable main contrib non-free
+
+Now, to use the better debtorrent transport method, change the line to
+this:
+
+deb debtorrent://localhost:9988/ftp.us.debian.org/debian unstable main contrib non-free
+
+The port is unchanged from the one used for the http method. After making
+that change, your downloads from DebTorrent should be faster.
+
+The debtorrent APT transport method recognizes 2 parameters which can be
+set in the standard APT configuration file at /etc/apt/apt.conf. These
+configuration options can be set by adding the following lines to that
+file (the default values are shown):
+
+Acquire::debtorrent::Timeout "300";
+Debug::Acquire::debtorrent "false";
+
+The 'Timeout' value is used as the time to wait for a request from the
+DebTorrent program to complete. It is longer than the default http
+timeout because DebTorrent requests may take longer to begin as the
+whole file needs to be downloaded before it can be transferred to APT.
+Additionally, the debtorrent method will retry the request 3 times
+before it will give up.
+
+Setting the 'Debug' value to 'true' will cause the debtorrent transport
+method to print out the headers sent to and received from the DebTorrent
+client.

Modified: apt-transport-debtorrent/trunk/debian/control
URL: http://svn.debian.org/wsvn/debtorrent/apt-transport-debtorrent/trunk/debian/control?rev=263&op=diff
==============================================================================
--- apt-transport-debtorrent/trunk/debian/control (original)
+++ apt-transport-debtorrent/trunk/debian/control Fri Aug 17 17:13:20 2007
@@ -11,6 +11,7 @@
 Architecture: any
 Depends: ${shlibs:Depends}
 Recommends: debtorrent (>= 0.1.4)
+Conflicts: debtorrent (<< 0.1.4)
 Description: an APT transport for communicating with DebTorrent
  This package contains the APT debtorrent transport. It makes it possible to
  use 'deb debtorrent://localhost:9988/foo distro main' type lines in your

Added: apt-transport-debtorrent/trunk/debian/docs
URL: http://svn.debian.org/wsvn/debtorrent/apt-transport-debtorrent/trunk/debian/docs?rev=263&op=file
==============================================================================
--- apt-transport-debtorrent/trunk/debian/docs (added)
+++ apt-transport-debtorrent/trunk/debian/docs Fri Aug 17 17:13:20 2007
@@ -1,0 +1,1 @@
+README

Modified: apt-transport-debtorrent/trunk/debian/rules
URL: http://svn.debian.org/wsvn/debtorrent/apt-transport-debtorrent/trunk/debian/rules?rev=263&op=diff
==============================================================================
--- apt-transport-debtorrent/trunk/debian/rules (original)
+++ apt-transport-debtorrent/trunk/debian/rules Fri Aug 17 17:13:20 2007
@@ -23,7 +23,6 @@
 
 clean:
 	dh_testdir
-#	dh_testroot
 	rm -f build-stamp
 
 	# Add here commands to clean up after the build process.
@@ -52,7 +51,6 @@
 	dh_testroot
 	dh_installchangelogs 
 	dh_installdocs
-#	dh_install
 	dh_strip
 	dh_compress
 	dh_fixperms


