[debhelper-devel] [debhelper] 14/28: Update documentation of dh_builddeb and dh_gencontrol

[Niels Thykier]

This is an automated email from the git hooks/post-receive script.

nthykier pushed a commit to branch master
in repository debhelper.

commit 4f3d84e3b2c1b7a56c411c4951252dea2fa5d426
Author: Niels Thykier <niels at thykier.net>
Date:   Wed May 20 21:24:12 2015 +0200

    Update documentation of dh_builddeb and dh_gencontrol
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 dh_builddeb   |  3 ++-
 dh_gencontrol | 13 ++++++++++---
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/dh_builddeb b/dh_builddeb
index 3eb0811..3be83df 100755
--- a/dh_builddeb
+++ b/dh_builddeb
@@ -16,7 +16,8 @@ B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] [B<--filena
 =head1 DESCRIPTION
 
 B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or
-packages.
+packages.  It will also build packages for ddebs when L<dh_strip(1)>
+and L<dh_gencontrol(1)> have prepared them.
 
 It supports building multiple binary packages in parallel, when enabled by
 DEB_BUILD_OPTIONS.
diff --git a/dh_gencontrol b/dh_gencontrol
index 702f547..01e897f 100755
--- a/dh_gencontrol
+++ b/dh_gencontrol
@@ -19,9 +19,16 @@ B<dh_gencontrol> is a debhelper program that is responsible for generating
 control files, and installing them into the I<DEBIAN> directory with the
 proper permissions.
 
-This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls
-it once for each package being acted on, and passes in some additional
-useful flags.
+This program is merely a wrapper around L<dpkg-gencontrol(1)>, which
+calls it once for each package being acted on (plus related ddebs),
+and passes in some additional useful flags.
+
+B<Note> that if you use B<dh_gencontrol>, you must also use
+L<dh_builddeb(1)> to build the packages.  Otherwise, your build may
+fail to build as B<dh_gencontrol> (via L<dpkg-gencontrol(1)>) declares
+which packages are built.  As debhelper automatically generates ddebs,
+it some times adds additional packages, which will be built by L<dh_builddeb(1)>.
+
 
 =head1 OPTIONS
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debhelper/debhelper.git