[dpkg] 109/200: man, Dpkg::Control::FieldsCore: Add new Auto-Built-Package field

[Ximin Luo]

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

infinity0 pushed a commit to branch master
in repository dpkg.

commit 6c8203440bf443d3031ee2ab8485b16c1b6da3b6
Author: Guillem Jover <guillem at debian.org>
Date:   Mon Jan 2 16:29:49 2017 +0100

    man, Dpkg::Control::FieldsCore: Add new Auto-Built-Package field
    
    This field is used to distinguish packages that have been automatically
    injected by some build tool, and are not present in the debian/control
    file.
---
 debian/changelog                   | 2 ++
 man/deb-control.man                | 8 ++++++++
 scripts/Dpkg/Control/FieldsCore.pm | 6 +++++-
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index 6c27c88..bd8ea27 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -17,10 +17,12 @@ dpkg (1.18.19) UNRELEASED; urgency=medium
       instead of getting into an infinite loop. Closes: #851441
     - Call anonymous subs via -> operator instead of casting with &, and fix
       bogus POD documentation to match the code.
+    - Add new Auto-Built-Package field to Dpkg::Control::Fields.
   * Documentation:
     - Cleanup software requirements in README.
     - Move control member file references from dpkg(1) to deb(5).
     - Fix typos in docs and code comments.
+    - Document Auto-Built-Package field in deb-control(5).
   * Packaging:
     - Add debsig-verify to dpkg Suggests. The code optionally supports this
       specific signed .deb verification program.
diff --git a/man/deb-control.man b/man/deb-control.man
index ff1ebc2..0cdfafb 100644
--- a/man/deb-control.man
+++ b/man/deb-control.man
@@ -323,6 +323,14 @@ this binary packages was built with (since dpkg 1.17.2 until 1.18.18).
 The information previously found in this field can now be found in the
 \fB.buildinfo\fP file, which supersedes it.
 .
+.TP
+.BI Auto\-Built\-Package: " reason-list"
+This field specifies a whitespace separated list of reasons why this package
+was auto-generated.
+Binary packages marked with this field will not appear in the
+\fIdebian/control\fP master source control file.
+The only currently used reason is \fBdebug\-symbols\fP.
+.
 .SH EXAMPLE
 .\" .RS
 .nf
diff --git a/scripts/Dpkg/Control/FieldsCore.pm b/scripts/Dpkg/Control/FieldsCore.pm
index 7c7e759..8eeddad 100644
--- a/scripts/Dpkg/Control/FieldsCore.pm
+++ b/scripts/Dpkg/Control/FieldsCore.pm
@@ -73,6 +73,10 @@ our %FIELDS = (
         allowed => CTRL_REPO_RELEASE,
         separator => FIELD_SEP_SPACE,
     },
+    'Auto-Built-Package' => {
+        allowed => ALL_PKG & ~CTRL_INFO_PKG,
+        separator => FIELD_SEP_SPACE,
+    },
     'Binary' => {
         allowed => CTRL_PKG_SRC | CTRL_FILE_BUILDINFO | CTRL_FILE_CHANGES,
         # XXX: This field values are separated either by space or comma
@@ -459,7 +463,7 @@ my @sum_fields = map { $_ eq 'md5' ? 'MD5sum' : &field_capitalize($_) }
 our %FIELD_ORDER = (
     CTRL_PKG_DEB() => [
         qw(Package Package-Type Source Version Built-Using Kernel-Version
-        Built-For-Profiles Architecture Subarchitecture
+        Built-For-Profiles Auto-Built-Package Architecture Subarchitecture
         Installer-Menu-Item Essential Origin Bugs
         Maintainer Installed-Size), &field_list_pkg_dep(),
         qw(Section Priority Multi-Arch Homepage Description Tag Task)

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