# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1315657257 -7200
# Node ID 5ab1d0de62a2bd183f3f1d118549c7480bc0dfec
# Parent  902fe3a8890f5311d30549c72680fe7d0376b034
Added notes on using the watch file, plus some headings.

diff -r 902fe3a8890f -r 5ab1d0de62a2 README.txt
--- a/README.txt	Sat Sep 10 13:53:13 2011 +0200
+++ b/README.txt	Sat Sep 10 14:20:57 2011 +0200
@@ -3,9 +3,20 @@
 
 Firstly, download the latest upstream source release. Although it might be
 desirable to get the latest code from the repository, Debian will eventually
-be using the actual source releases specified in the watch file.
+be using the actual source releases specified in the watch file. Here's how
+to download using the watch file:
+
+uscan --force-download --destdir=..
 
-However, one can try and persuade Gitorious to yield a file by visiting the
+The --force-download option is required when --download indicates that the
+package is up-to-date. This will make the necessary symbolic link for the
+shedskin_0.9.orig.tar.gz archive that must be present when building the
+package.
+
+Using the Upstream Repository
+-----------------------------
+
+One can also try and persuade Gitorious to yield a file by visiting the
 following address:
 
 http://gitorious.org/shedskin/mainline/archive-tarball/31b8214
@@ -26,6 +37,9 @@
 
 tar zcf shedskin_0.9.orig.tar.gz shedskin_0.9
 
+Building the Package
+--------------------
+
 Move into the sources directory:
 
 cd shedskin_0.9