doc: Add instructions on how to build only source packages

In the CI, it's better to build the source package only once and then
instead of checking out the whole repository, only distribute the source
packages to the individual jobs.

Signed-off-by: Ondřej Surý <ondrej@sury.org>
(cherry picked from commit 4c65fb08f7a6b3bfafdadc6cd8b6dc0e95e13649)

diff --git a/doc/developer/packaging-debian.rst b/doc/developer/packaging-debian.rst
index 1cca5758fdcf06f3f7596e1895d427f179083ee3..0bc3700cb43938e5500de7ffb54220d66b7a1dc3 100644 (file)
--- a/doc/developer/packaging-debian.rst
+++ b/doc/developer/packaging-debian.rst
@@ -44,7 +44,7 @@ buster.)
 5. (optional) Append a distribution identifier if needed (see below under
    :ref:`multi-dist`.)
 
-6. Build Debian Package:
+6. Build Debian Binary and/or Source Packages:
 
    .. code-block:: shell
 
@@ -78,6 +78,14 @@ buster.)
      (git builds of the `master` or `stable/X.X` branches won't be signed by
      default since their target release is set to ``UNRELEASED``.)
 
+   * the ``--build=type`` accepts following options (see ``dpkg-buildpackage`` manual page):
+
+     * ``source`` builds the source package
+     * ``any`` builds the architecture specific binary packages
+     * ``all`` build the architecture independent binary packages
+     * ``binary`` build the architecture specific and independent binary packages (alias for ``any,all``)
+     * ``full`` builds everything (alias for ``source,any,all``)
+
 7. Done!
 
    If all worked correctly, then you should end up with the Debian packages in