Package: dpkg-dev
Version: 1.21.22
Severity: normal
Tags: patch
X-Debbugs-Cc: skay...@tutanota.com

Dear Maintainer,

the man page for dpkg-buildpackage only includes a subset of supported flags
for DEB_BUILD_OPTIONS and the description for the "nocheck" flags seems to
be incorrect.

The currently supported, full list of flags is available at 

https://www.debian.org/doc/debian-policy/ch-source.html#debian-rules-and-deb-build-options

I've attached an example patch to include the supported flags list in
dpkg-buildpackage(1).

All the best,

Sebastian


-- Package-specific info:
This system uses merged-usr-via-aliased-dirs, going behind dpkg's
back, breaking its core assumptions. This can cause silent file
overwrites and disappearances, and its general tools misbehavior.
See <https://wiki.debian.org/Teams/Dpkg/FAQ#broken-usrmerge>.

-- System Information:
Debian Release: 12.0
  APT prefers stable-security
  APT policy: (500, 'stable-security'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 6.1.0-9-amd64 (SMP w/1 CPU thread; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages dpkg-dev depends on:
ii  binutils      2.40-2
ii  bzip2         1.0.8-5+b1
ii  libdpkg-perl  1.21.22
ii  make          4.3-4.1
ii  patch         2.7.6-7
ii  perl          5.36.0-7
ii  tar           1.34+dfsg-1.2
ii  xz-utils      5.4.1-0.2

Versions of packages dpkg-dev recommends:
ii  build-essential          12.9
ii  fakeroot                 1.31-1.2
ii  gcc [c-compiler]         4:12.2.0-3
ii  gcc-12 [c-compiler]      12.2.0-14
ii  gnupg                    2.2.40-1.1
ii  gpgv                     2.2.40-1.1
ii  libalgorithm-merge-perl  0.08-5

Versions of packages dpkg-dev suggests:
pn  debian-keyring  <none>

-- no debconf information
>From 4249055007018502b5981ad06b019fd56619ed64 Mon Sep 17 00:00:00 2001
From: skayser <skay...@tutanota.com>
Date: Thu, 22 Jun 2023 17:31:23 +0200
Subject: [PATCH] dpkg-buildpackage.pod: include full list of DEB_BUILD_OPTIONS

---
 man/dpkg-buildpackage.pod | 43 +++++++++++++++++++++++++++++++++++----
 1 file changed, 39 insertions(+), 4 deletions(-)

diff --git a/man/dpkg-buildpackage.pod b/man/dpkg-buildpackage.pod
index 3da341992..9abcc4a3a 100644
--- a/man/dpkg-buildpackage.pod
+++ b/man/dpkg-buildpackage.pod
@@ -740,13 +740,48 @@ Overridden by the B<--sign-keyfile> option.
 
 =item B<DEB_BUILD_OPTIONS>
 
-If set, it will contain a space-separated list of options that might
+If set, it will contain a space-separated list of tags that might
 affect the build process in I<debian/rules>, and the behavior of some
 dpkg commands.
 
-With B<nocheck> the B<DEB_CHECK_COMMAND> variable will be ignored.
-With B<parallel=>I<N> the parallel jobs will be set to I<N>,
-overridden by the B<--jobs-try> option.
+The meaning of the following tags has been standardized:
+
+=over
+
+=item B<nocheck>
+
+This tag says to not run any build-time test suite provided by the package.
+
+=item B<nodoc>
+
+This tag says to skip any build steps that only generate package
+documentation.
+
+=item B<noopt>
+
+The presence of this tag means that the package should be compiled with a
+minimum of optimization.
+
+=item B<nostrip>
+
+This tag means that the debugging symbols should not be stripped from the
+binary during installation, so that debugging information may be included
+in the package.
+
+=item B<parallel=N>
+
+This tag means that the package should be built using up to I<N> parallel
+processes if the package build system supports this. Overridable with the
+B<--jobs-try> option.
+
+=item B<terse>
+
+This tag means that the package build will be less verbose than default.
+
+=back
+
+See also 
L<https://www.debian.org/doc/debian-policy/ch-source.html#debian-rules-and-deb-build-options>
 for an extended description as well as an example
+B<debian/rules> file that implements these tags.
 
 =item B<DEB_BUILD_PROFILES>
 
-- 
2.39.2

Reply via email to