dgit-user(7): Recommend mk-build-deps rather than apt-get build-dep.

Closes:#863361.

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

diff --git a/debian/changelog b/debian/changelog
index e85192f8be70adbd6b43a97fb4778fdddda754f1..b2b512f8df77d3fd286ea90415d5765a5bc620c7 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,8 @@
 dgit (4.2~) experimental; urgency=medium
 
   Documentation improvements:
+  * Recommend mk-build-deps rather than apt-get build-dep.
+    Suggestion from Nikolaus Rath.  Closes:#863361.
   * dgit-maint-merge(7): many updates.  [Sean Whitton]
     Closes:#864873,#878433.
   * dgit-*(7): Mention first upload trick.  [Andrew Shadura,

diff --git a/dgit-user.7.pod b/dgit-user.7.pod
index c33cf300e36b096c7b9bd0717f6374b81ba91ef0..c74396a56954d2ff176c2032cb022b1d71447921 100644 (file)
--- a/dgit-user.7.pod
+++ b/dgit-user.7.pod
@@ -35,7 +35,7 @@ or L<dgit(1)> and L<dgit(7)>.
     % curl 'https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=28250;mbox=yes;msg=89' | patch -p1 -u
     % git commit -a -m 'Fix libc lost output bug'
     % gbp dch -S --since=dgit/dgit/sid --ignore-branch --commit
-    % sudo apt-get build-dep glibc
+    % mk-build-deps --root-cmd=sudo --install
     % dpkg-buildpackage -uc -b
     % sudo dpkg -i ../libc6_*.deb
 
@@ -288,15 +288,11 @@ a complete treatment is beyond the scope of this tutorial.
 
 =over 4
 
-    % sudo apt-get build-dep glibc
+    % mk-build-deps --root-cmd=sudo --install
     % dpkg-buildpackage -uc -b
 
 =back
 
-apt-get build-dep installs the build dependencies according to the
-official package, not your modified one.  So if you've changed the
-build dependencies you might have to install some of them by hand.
-
 dpkg-buildpackage is the primary tool for building a Debian source
 package.
 C<-uc> means not to pgp-sign the results.