[Reproducible-commits] [dpkg] 07/74: man: Improve dpkg-buildpackage(1) on environment expectations

[Mattia Rizzolo]

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

mattia pushed a commit to annotated tag 1.18.8
in repository dpkg.

commit b4682659183bc8faaf092a28b6b22647a765efa5
Author: Guillem Jover <guillem at debian.org>
Date:   Fri May 13 02:42:12 2016 +0200

    man: Improve dpkg-buildpackage(1) on environment expectations
---
 debian/changelog        |  4 ++++
 man/dpkg-buildpackage.1 | 15 ++++++++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 42bcd0c..7242dfa 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,5 +1,9 @@
 dpkg (1.18.8) UNRELEASED; urgency=medium
 
+  [ Guillem Jover ]
+  * Documentation:
+    - Improve dpkg-buildpackage(1) on environment expectations.
+
   [ Updated programs translations ]
   * German (Sven Joachim).
   * Simplified Chinese (Zhou Mo). Closes: #824873
diff --git a/man/dpkg-buildpackage.1 b/man/dpkg-buildpackage.1
index eb26413..45bb166 100644
--- a/man/dpkg-buildpackage.1
+++ b/man/dpkg-buildpackage.1
@@ -390,6 +390,7 @@ Show the usage message and exit.
 Show the version and exit.
 .
 .SH ENVIRONMENT
+.SS External environment
 .TP
 .B DEB_CHECK_COMMAND
 If set, it will be used as the command to check the \fB.changes\fP file
@@ -416,11 +417,19 @@ Sets the color mode (since dpkg 1.18.5).
 The currently accepted values are: \fBauto\fP, \fBalways\fP and
 \fBnever\fP (default).
 
-.SS Reliance on exported environment flags
+.SS Internal environment
 Even if \fBdpkg\-buildpackage\fP exports some variables, \fBdebian/rules\fP
 should not rely on their presence and should instead use the
-respective interface to retrieve the needed values.
-.SS Variables set by dpkg\-architecture
+respective interface to retrieve the needed values, because that
+file is the main entry point to build packages and running it
+standalone should be supported.
+
+.TP
+.B DEB_BUILD_*
+.TQ
+.B DEB_HOST_*
+.TQ
+.B DEB_TARGET_*
 \fBdpkg\-architecture\fP is called with the \fB\-a\fP and \fB\-t\fP
 parameters forwarded. Any variable that is output by its \fB\-s\fP
 option is integrated in the build environment.

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