[Pkg-bazaar-commits] r157 ./bzr-builddeb/people/jdw/merge_upstream: Briefly document the upstream tarball fetching with uscan.

[James Westby]

------------------------------------------------------------
revno: 157
committer: James Westby <jw+debian at jameswestby.net>
branch nick: merge_upstream
timestamp: Tue 2007-07-10 22:36:23 +0100
message:
  Briefly document the upstream tarball fetching with uscan.
added:
  doc/user_manual/upstream_tarballs.rst
modified:
  doc/user_manual/index.rst
-------------- next part --------------
=== added file 'doc/user_manual/upstream_tarballs.rst'
--- a/doc/user_manual/upstream_tarballs.rst	1970-01-01 00:00:00 +0000
+++ b/doc/user_manual/upstream_tarballs.rst	2007-07-10 21:36:23 +0000
@@ -0,0 +1,21 @@
+Upstream tarballs
+-----------------
+
+When you are building a version of a package that uses a version of the
+upstream package that you have not used in a build before the upstream
+tarball for that version needs to be fetched from somewhere. It can be
+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.
+
+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
+packaging teams.
+
+.. : vim: set ft=rst tw=76 :
+

=== modified file 'doc/user_manual/index.rst'
--- a/doc/user_manual/index.rst	2007-07-10 20:52:45 +0000
+++ b/doc/user_manual/index.rst	2007-07-10 21:36:23 +0000
@@ -58,9 +58,11 @@
 
   * `Configuration Files`_
   * `Building a package`_
+  * `Upstream tarballs`_
 
 .. _Configuration Files: configuration.html
 .. _Building a package: building.html 
+.. _Upstream tarballs: upstream_tarballs.html
 
 Appendices