[Reproducible-commits] [dpkg] 04/26: man: Document missing fields

[Jérémy Bobbio]

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

lunar pushed a commit to branch pu/reproducible_builds
in repository dpkg.

commit 38ac205718000f455113269eb835db3d6312ce20
Author: Guillem Jover <guillem at debian.org>
Date:   Wed Oct 7 16:06:00 2015 +0200

    man: Document missing fields
    
    Add information about the Install-Size, Built-For-Profiles and
    Build-Profiles fields.
---
 debian/changelog      |  2 ++
 man/deb-control.5     | 10 ++++++++++
 man/deb-src-control.5 | 15 +++++++++++++++
 3 files changed, 27 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 4c01cb2..26a134e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -4,6 +4,8 @@ dpkg (1.18.5) UNRELEASED; urgency=medium
     - Say value instead of option in deb-control(5).
     - Mark debian changelog format in bold in dpkg-parsechangelog(1).
     - Add references to man pages describing file formats.
+    - Document missing Install-Size, Built-For-Profiles and Build-Profiles
+      fields in man pages.
 
  -- Guillem Jover <guillem at debian.org>  Fri, 25 Dec 2015 14:20:16 +0100
 
diff --git a/man/deb-control.5 b/man/deb-control.5
index 82d8542..d72bc6b 100644
--- a/man/deb-control.5
+++ b/man/deb-control.5
@@ -88,6 +88,11 @@ fields have a defined set of accepted values based on the Policy Manual.
 A list of these values can be obtained from the latest version of the
 .B debian\-policy
 package.
+.
+.TP
+.BR Installed\-Size: " size"
+The approximate total size of the package's installed files, in KiB units.
+.
 .TP
 .BR Essential: " \fByes\fP|\fBno\fP"
 This field is usually only needed when the answer is \fByes\fP. It denotes
@@ -298,6 +303,11 @@ refuse to accept an upload which declares a
 .B Built\-Using
 relationship which cannot be satisfied within the archive.
 .
+.TP
+.BI Built\-For\-Profiles: " profile-list"
+This field specifies a whitespace separated list of build profiles that this
+binary packages was built with.
+.
 .SH EXAMPLE
 .\" .RS
 .nf
diff --git a/man/deb-src-control.5 b/man/deb-src-control.5
index 495c25e..1dfa2cb 100644
--- a/man/deb-src-control.5
+++ b/man/deb-src-control.5
@@ -278,6 +278,21 @@ architecture wildcards in that list (see
 for more information about them).
 
 .TP
+.BR Build\-Profiles: " \fIrestriction-formula\fP"
+This field specifies the conditions for which this binary package does or
+does not build.
+To express that condition, the same restriction formula syntax from the
+\fBBuild\-Depends\fP field is used.
+
+If a binary package paragraph does not contain this field, then it implicitly
+means that it builds with all build profiles (including none at all).
+
+In other words, if a binary package paragraph is annotated with a non-empty
+\fBBuild\-Profiles\fP field, then this binary package is generated if and
+only if the condition expressed by the conjunctive normal form expression
+evaluates to true.
+
+.TP
 .BR Package\-Type: " \fBdeb\fP|\fBudeb\fP"
 This field defines the type of the package.
 \fBudeb\fP is for size-constrained packages used by the debian installer.

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