[Pkg-bazaar-commits] r212 ./bzr-builddeb/people/jdw/dev: Document that apt is used in trying to find the upstream tarball.

[James Westby]

------------------------------------------------------------
revno: 212
committer: James Westby <jw+debian at jameswestby.net>
branch nick: dev
timestamp: Tue 2007-10-30 19:21:45 +0000
message:
  Document that apt is used in trying to find the upstream tarball.
modified:
  doc/user_manual/upstream_tarballs.rst
-------------- next part --------------
=== modified file 'doc/user_manual/upstream_tarballs.rst'
--- a/doc/user_manual/upstream_tarballs.rst	2007-10-23 21:25:20 +0000
+++ b/doc/user_manual/upstream_tarballs.rst	2007-10-30 19:21:45 +0000
@@ -7,11 +7,16 @@
 tedious to track the correct file down, download it and rename or repack it
 to have the correct name and be in the correct format.
 
-To ease this step a bit the plugin will use ``uscan`` from the
-``devscripts`` package to obtain the file for you if it needs it and your
-branch has a ``debian/watch`` file. The correct file will be downloaded if
-``uscan`` can find it, and it will be renamed or repacked as necessary so
-that it can be used straight away for the build.
+To ease this step the plugin will try different methods to find the tarball
+if it is not already in the required place. Firstly it will use apt to
+download the tarball from the archive if there is one of the correct
+version there.
+
+If that does not find the required package the plugin will use ``uscan``
+from the ``devscripts`` package to obtain the file for you if it needs it
+and your branch has a ``debian/watch`` file. The correct file will be
+downloaded if ``uscan`` can find it, and it will be renamed or repacked
+as necessary so that it can be used straight away for the build.
 
 I also hope to extend this functionality to retrieve the tarball using apt
 if it is in the archive, and from a central location for those who work on