This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=3e430c1f2fdf4b27ca4050ea4cb53dfec7206d76 The following commit(s) were added to refs/heads/main by this push: new 3e430c1f2 man: Document DEB_BUILD_ARCH and DEB_HOST_ARCH usage in commands 3e430c1f2 is described below commit 3e430c1f2fdf4b27ca4050ea4cb53dfec7206d76 (HEAD -> main) Author: Guillem Jover <[email protected]> AuthorDate: Tue Apr 2 02:40:48 2024 +0200 man: Document DEB_BUILD_ARCH and DEB_HOST_ARCH usage in commands These variables affect the operation of several tools in the dpkg toolset. Make this clear in the ENVIRONMENT section for these tools as otherwise it is not obvious how to modify these values, for example when wanting to enable cross-compilation mode, or when wanting to operate on foreign architectures. Prompted-by: Thorsten Glaser <[email protected]> --- man/dpkg-buildflags.pod | 7 +++++++ man/dpkg-checkbuilddeps.pod | 6 ++++++ man/dpkg-genbuildinfo.pod | 12 ++++++++++++ man/dpkg-genchanges.pod | 4 ++++ man/dpkg-gencontrol.pod | 4 ++++ man/dpkg-gensymbols.pod | 4 ++++ man/dpkg-name.pod | 5 +++++ man/dpkg-shlibdeps.pod | 6 ++++++ 8 files changed, 48 insertions(+) diff --git a/man/dpkg-buildflags.pod b/man/dpkg-buildflags.pod index cc78f6b6e..c3482e879 100644 --- a/man/dpkg-buildflags.pod +++ b/man/dpkg-buildflags.pod @@ -922,6 +922,13 @@ This variable sets the build path (since dpkg 1.18.8) to use in features such as B<fixdebugpath> so that they can be controlled by the caller. This variable is currently Debian and derivatives-specific. +=item B<DEB_HOST_ARCH> + +Sets the host architecture. +This affects the build flags that are emitted, +which is typically relevant when cross-compiling, +where B<DEB_HOST_ARCH> is different to B<DEB_BUILD_ARCH>. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). diff --git a/man/dpkg-checkbuilddeps.pod b/man/dpkg-checkbuilddeps.pod index 9097e7e32..691d25245 100644 --- a/man/dpkg-checkbuilddeps.pod +++ b/man/dpkg-checkbuilddeps.pod @@ -102,6 +102,12 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. +This affects the dependency resolution logic, +which might then not match what the system dpkg considers satisfiable. + =item B<DEB_BUILD_PROFILES> If set, it will be used as the active build profile(s) for the package diff --git a/man/dpkg-genbuildinfo.pod b/man/dpkg-genbuildinfo.pod index c8106d14a..f7b3e5323 100644 --- a/man/dpkg-genbuildinfo.pod +++ b/man/dpkg-genbuildinfo.pod @@ -183,6 +183,18 @@ features. The feature “B<path>” controls whether to unconditionally include the B<Build-Path> field. +=item B<DEB_BUILD_ARCH> + +Sets the build architecture. +This affects the value for the B<Build-Architecture> field, +and the check for the cross-compilation mode. + +=item B<DEB_HOST_ARCH> + +Sets the host architecture. +This affects the filename used for the .buildinfo file, +and the check for the cross-compilation mode. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). diff --git a/man/dpkg-genchanges.pod b/man/dpkg-genchanges.pod index 5710a286c..2ca50fa0c 100644 --- a/man/dpkg-genchanges.pod +++ b/man/dpkg-genchanges.pod @@ -241,6 +241,10 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). diff --git a/man/dpkg-gencontrol.pod b/man/dpkg-gencontrol.pod index 992552528..52ac120f3 100644 --- a/man/dpkg-gencontrol.pod +++ b/man/dpkg-gencontrol.pod @@ -180,6 +180,10 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). diff --git a/man/dpkg-gensymbols.pod b/man/dpkg-gensymbols.pod index f430bead4..86e2d815d 100644 --- a/man/dpkg-gensymbols.pod +++ b/man/dpkg-gensymbols.pod @@ -314,6 +314,10 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture if the B<--arch> option has not be specified. + =item B<DPKG_GENSYMBOLS_CHECK_LEVEL> Overrides the command check level, even if the B<-c> command-line diff --git a/man/dpkg-name.pod b/man/dpkg-name.pod index 6c9c2214e..0e63f2304 100644 --- a/man/dpkg-name.pod +++ b/man/dpkg-name.pod @@ -102,6 +102,11 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. +This affects the architecture name used in the package filename. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). diff --git a/man/dpkg-shlibdeps.pod b/man/dpkg-shlibdeps.pod index 3d04e7970..5602010bd 100644 --- a/man/dpkg-shlibdeps.pod +++ b/man/dpkg-shlibdeps.pod @@ -343,6 +343,12 @@ Show the version and exit. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. +This affects the objects and symbols files searched for and +their default search pathnames. + =item B<DPKG_COLORS> Sets the color mode (since dpkg 1.18.5). -- Dpkg.Org's dpkg
