Bug#641153: document Built-Using field for binary packages

[Ansgar Burchardt <ansgar@debian.org>]

Package: debian-policy
Severity: normal

Hi,

some months ago support for the Built-Using field was added to the
archive software.  It is used by binary packages to refer to additional
source packages that were used during the build and need to stay in the
archive to have the full source available.

I would like to have this field documented in policy, a first patch is
attached.

Regards,
Ansgar
>From be15241200d6dfa13afa9fa8e36944d1599cc6e3 Mon Sep 17 00:00:00 2001
From: Ansgar Burchardt

Date: Sat, 10 Sep 2011 22:40:07 +0200 Subject: [PATCH] Document Built-Using field. --- policy.sgml | 45 +++++++++++++++++++++++++++++++++++++++++++-- 1 files changed, 43 insertions(+), 2 deletions(-) diff --git a/policy.sgml b/policy.sgml index 38f2096..93e8660 100644 --- a/policy.sgml +++ b/policy.sgml @@ -3061,7 +3061,8 @@ Package: libc6 Depends, Pre-Depends, Recommends, Suggests, Breaks, Conflicts, - Provides, Replaces, Enhances + Provides, Replaces, Enhances, + Built-Using

@@ -4568,7 +4569,8 @@ fi

In the Depends, Recommends, Suggests, Pre-Depends, - Build-Depends and Build-Depends-Indep + Build-Depends, Build-Depends-Indep + and Built-Using control fields of the package, which declare dependencies on other packages, the package names listed may also include lists of alternative package names, separated @@ -5317,6 +5319,45 @@ Replaces: mail-transport-agent + + Additional source packages used to build the binary + - Built-Using + + +

+ Additional source packages might be involved in creating a + binary package. These must be listed in + the Built-Using field to enable the archive + software to keep the full source code. +

+ +

+ For every source package, the version used must be + specified using an "exactly equal" ("=") relation. + + The archive software might reject packages that refer to + non-existant sources. + +

+ +

+ A package using the source code from the gcc-4.6-source + binary package built from the gcc-4.6 source package would + have this field in its control file: + +Built-Using: gcc-4.6 (= 4.6.0-11) + +

+ +

+ A package including binaries from grub2 and loadlin would + have this field in its control file: + +Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) + +

+ + Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, -- 1.7.5.4