dgit-user(7): Provide information about how to use sbuild

Quite ugly due to #868527.  Closes:#868526.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/debian/changelog b/debian/changelog
index 02b359848ffb66c85e2a407e3d88086fac104e14..e2c37a212d66af2706caa8c87bbdb040053dd254 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,8 @@
 dgit (4.1~) experimental; urgency=medium
 
   Documentation:
+  * dgit-user(7): Provide information about how to use sbuild.
+    Quite ugly due to #868527.  Closes:#868526.
   * dgit-user(7): Fixed example rune to use curl (which prints
     to stdout, as the rune expects).  [reported by Simon Tatham]
 

diff --git a/dgit-user.7.pod b/dgit-user.7.pod
index 51a1fa35ed5769c6ad8fc5e604cff46935650246..c33cf300e36b096c7b9bd0717f6374b81ba91ef0 100644 (file)
--- a/dgit-user.7.pod
+++ b/dgit-user.7.pod
@@ -303,6 +303,26 @@ C<-uc> means not to pgp-sign the results.
 C<-b> means build all binary packages,
 but not to build a source package.
 
+=head2 Using sbuild
+
+You can build in an schroot chroot, with sbuild, instead of in your
+main environment.  (sbuild is used by the Debian build daemons.)
+
+=over 4
+
+    % git clean -xdf
+    % sbuild -c jessie -A --no-clean-source \
+             --dpkg-source-opts='-Zgzip -z1 --format=1.0 -sn'
+
+=back
+
+Note that this will seem to leave a "source package"
+(.dsc and .tar.gz)
+in the parent directory,
+but that source package should not be used.
+It is likely to be broken.
+For more information see Debian bug #868527.
+
 =head1 INSTALLING
 
 =head2 Debian Jessie or older