chiark / gitweb /
dgit-sponsorship(7): Suggest pristine-tar(1)
authorSean Whitton <spwhitton@spwhitton.name>
Sat, 29 Oct 2016 14:26:24 +0000 (07:26 -0700)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 30 Oct 2016 17:14:31 +0000 (17:14 +0000)
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
dgit-sponsorship.7.pod

index 71fb205..e6c7730 100644 (file)
@@ -110,8 +110,23 @@ in their handover email.
 If there are any .origs that are not in the archive already,
 the sponsor will need them as part of the upload.
 
 If there are any .origs that are not in the archive already,
 the sponsor will need them as part of the upload.
 
-The sponsee can put them on a suitable webserver,
-or attach to an email.
+The simplest approach is to
+commit them with pristine-tar(1), e.g.
+
+=over 4
+
+    % pristine-tar commit ../foo_1.2.3.orig.tar.xz upstream/1.2.3
+
+=back
+
+and be sure to push the pristine-tar branch.
+If you are using git-buildpackage(1), just pass
+I<--git-pristine-tar> and I<--git-pristine-tar-commit>.
+
+Alternatively,
+the sponsee can put them on a suitable webserver,
+or attach to the e-mail,
+if they are small.
 
 The sponsee should quote sha256sums of the .origs in their
 handoff email.
 
 The sponsee should quote sha256sums of the .origs in their
 handoff email.
@@ -137,7 +152,9 @@ You should check the signature on the email.
 
 Use C<git fetch> to fetch the git branch
 prepared by your sponsee,
 
 Use C<git fetch> to fetch the git branch
 prepared by your sponsee,
-and obtain any .origs mentioned by the sponsee.
+and obtain any .origs mentioned by the sponsee
+(to extract .origs committed with pristine-tar,
+you can use origtargz(1).)
 
 Check the git commit ID of the sponsee's branch tip,
 and the sha256sums of the .origs,
 
 Check the git commit ID of the sponsee's branch tip,
 and the sha256sums of the .origs,