doc: Use dpkg-buildpackage to build packages (add note about debuild)

The debuild command fails when we are doing source package only build
because it expects the arch-dependent .changes file to be present.  Thus
in the instructions we switch to using dpkg-buildpackage directly and
add a note about using debuild in more complicated scenarios.

Signed-off-by: Ondřej Surý <ondrej@sury.org>

diff --git a/doc/developer/packaging-debian.rst b/doc/developer/packaging-debian.rst
index 0bc3700cb43938e5500de7ffb54220d66b7a1dc3..968e960267054857428c0a2dc31bf28b070c62b3 100644 (file)
--- a/doc/developer/packaging-debian.rst
+++ b/doc/developer/packaging-debian.rst
@@ -48,7 +48,7 @@ buster.)
 
    .. code-block:: shell
 
-      gbp buildpackage --git-builder=debuild --git-debian-branch="$(git rev-parse --abbrev-ref HEAD)" $options
+      gbp buildpackage --git-builder=dpkg-buildpackage --git-debian-branch="$(git rev-parse --abbrev-ref HEAD)" $options
 
    Where `$options` may contain any or all of the following items:
 
@@ -86,6 +86,10 @@ buster.)
      * ``binary`` build the architecture specific and independent binary packages (alias for ``any,all``)
      * ``full`` builds everything (alias for ``source,any,all``)
 
+   Alternatively, you might want to replace ``dpkg-buildpackage`` with
+   ``debuild`` wrapper that also runs ``lintian`` and ``debsign`` on the final
+   packages.
+
 7. Done!
 
    If all worked correctly, then you should end up with the Debian packages in