From 666ab8c6261bafded77002bbb9c911d21e448156 Mon Sep 17 00:00:00 2001
From: Manoj Srivastava
Date: Thu, 16 Jun 2005 05:06:49 +0000
Subject: [PATCH] Julian's versions
Author: srivasta
Date: 1999/12/10 05:45:42
Julian's versions
git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-41
---
debian-policy.desc | 8 +-
debian/changelog | 58 +++
debian/control | 1 +
debian/postinst.in | 98 +++++
debian/prerm.in | 85 ++++
debian/rules | 26 +-
menu-policy.sgml | 2 +-
mime-policy.sgml | 147 +++++++
packaging-manual.desc | 8 +-
packaging.sgml | 183 +++++++--
policy.sgml | 723 +++++++++++++++++++++++----------
proposal.sgml | 4 +-
upgrading-checklist.html | 59 ++-
virtual-package-names-list.txt | 74 ++--
14 files changed, 1182 insertions(+), 294 deletions(-)
create mode 100644 debian/postinst.in
create mode 100644 debian/prerm.in
create mode 100644 mime-policy.sgml
diff --git a/debian-policy.desc b/debian-policy.desc
index 5e375f9..bad21c9 100644
--- a/debian-policy.desc
+++ b/debian-policy.desc
@@ -10,11 +10,11 @@ Abstract: This manual describes the policy requirements for the Debian
Section: Apps/Programming
Format: debiandoc-sgml
-Files: /usr/doc/debian-policy/policy.sgml.gz
+Files: /usr/share/doc/debian-policy/policy.sgml.gz
Format: text
-Files: /usr/doc/debian-policy/policy.text.gz
+Files: /usr/share/doc/debian-policy/policy.text.gz
Format: HTML
-Index: /usr/doc/debian-policy/policy.html/index.html
-Files: /usr/doc/debian-policy/policy.html/*.html
+Index: /usr/share/doc/debian-policy/policy.html/index.html
+Files: /usr/share/doc/debian-policy/policy.html/*.html
diff --git a/debian/changelog b/debian/changelog
index f84469a..49d9bfa 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,61 @@
+debian-policy (3.1.1.1) unstable; urgency=low
+
+ * Correction to typo in packaging manual, section 6.2.
+ * Correction to typo in packaging manual, section 12.2.5 (closes:
+ #50502)
+ * More corrections to packaging manual typos (closes: #50857)
+
+ -- Julian Gilbey Mon, 22 Nov 1999 19:23:31 +0000
+
+debian-policy (3.1.1.0) unstable; urgency=low
+
+ * Correct description of negated architectures in Build-Depends
+ description in Packaging manual (closes: #49901)
+
+ -- Julian Gilbey Tue, 16 Nov 1999 15:03:48 +0000
+
+debian-policy (3.1.0.0) unstable; urgency=low
+
+ * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
+ #45561, #42447, #48570)
+ * Added source dependencies (closes: #41232)
+ * Deprecated /etc/rc.boot (closes: #32448, #32449)
+ * Update-rc.d now only legal way to automatically access /etc/rc?.d
+ directoried (closes: #41547)
+ * FHS compliant location of examples (closes: #42849)
+ * Added ispell-dictionary to virtual-packages.list (following new
+ suggestions: no objections => accept) (closes: #8221)
+ * Added man-browser to virtual-packages.list (closes: #24695)
+ * Added ident-server to virtual-packages.list (closes: #45307)
+ * Alphabeticised virtual packages list ;)
+ * Corrected GPL reference in proposal.sgml
+ * Clarification of "extra" priority (closes: #33076)
+ * Remove buggy and seriously problematic licenses from list of contrib
+ package criteria (closes: #45318)
+ * Move docs to /usr/share/doc with a compatibility symlink (closes:
+ #41829)
+ * Update to FHS 2.1 draft #3 (for /var/state etc. changes).
+ * Correct /var/lib/games -> /var/games (closes: #42358)
+ * Added MIME subpolicy (closes: #46516)
+ * Added support for VISUAL (closes: #41121)
+ * Clarify non-dependence on /usr/local (closes: #44922)
+ * Modified description of mail spool locking (closes: #43651)
+ * Clarified wording of conffiles and configuration files (closes:
+ #40766, #40767)
+ * Changed description of release numbers (closes: #44620)
+ * Added changelog.html -> changelog requirement (closes: $40934)
+ * packaging-manual now correctly installs its docs (closes: #44643)
+ * The packaging manual now discusses version numbers based on dates
+ (closes: #17621)
+ * Mention ls -f for testing order in which files appear on disk (closes:
+ #19179)
+ * Change order of '.' and '+' in description of version numbers (closes:
+ #41095)
+ * s/fields/field names/ in section 4.1 of packaging manual for clarity
+ * Add Build-Depends-Indep: field to control file
+
+ -- Julian Gilbey Thu, 4 Nov 1999 23:50:37 +0000
+
debian-policy (3.0.1.1) unstable; urgency=low
* Typo corrected in packaging manual. closes: Bug#40180
diff --git a/debian/control b/debian/control
index ec066fd..e99f7d4 100644
--- a/debian/control
+++ b/debian/control
@@ -3,6 +3,7 @@ Section: doc
Priority: optional
Maintainer: Debian Policy List
Standards-Version: ${debian-policy:Version}
+Build-Depends-Indep: lynx, debiandoc-sgml, sp, liburi-perl, libpaperg, tetex-bin, tetex-extra, latex2html, libi18n-langtags-perl
Package: debian-policy
Architecture: all
diff --git a/debian/postinst.in b/debian/postinst.in
new file mode 100644
index 0000000..51f814d
--- /dev/null
+++ b/debian/postinst.in
@@ -0,0 +1,98 @@
+#!/bin/sh
+# -*- Mode: Sh -*-
+# postinst ---
+# Author : Manoj Srivastava ( srivasta@tiamat.datasync.com )
+# Created On : Thu Oct 29 15:23:36 1998
+# Created On Node : tiamat.datasync.com
+# Last Modified By : Manoj Srivastava
+# Last Modified On : Thu Oct 29 15:28:24 1998
+# Last Machine Used: tiamat.datasync.com
+# Update Count : 3
+# Status : Unknown, Use with caution!
+# HISTORY :
+# Description :
+#
+#
+
+
+# Abort if any command returns an error value
+set -e
+
+# This is filled in by debian/rules
+PACKAGE=#PACKAGE#
+
+# This script is called as the last step of the installation of the
+# package. All the package's files are in place, dpkg has already done
+# its automatic conffile handling, and all the packages we depend of
+# are already fully installed and configured.
+
+
+case "$1" in
+ configure)
+ # Configure this package. If the package must prompt the user for
+ # information, do it here.
+ :
+
+ if [ -x /usr/sbin/install-docs ]; then
+ /usr/sbin/install-docs -i /usr/share/doc-base/$PACKAGE
+ fi
+
+ # There are three sub-cases:
+ if test "${2+set}" != set; then
+ # We're being installed by an ancient dpkg which doesn't remember
+ # which version was most recently configured, or even whether
+ # there is a most recently configured version.
+ :
+
+ elif test -z "$2" -o "$2" = ""; then
+ # The package has not ever been configured on this system, or was
+ # purged since it was last configured.
+ :
+
+ else
+ # Version $2 is the most recently configured version of this
+ # package.
+ :
+
+ fi
+
+ # FSSTND compatible symlinks
+ if [ -d /usr/doc -a ! -e /usr/doc/$PACKAGE \
+ -a -d /usr/share/doc/$PACKAGE ]; then
+ ln -sf ../share/doc/$PACKAGE /usr/doc/$PACKAGE
+ fi
+ ;;
+ abort-upgrade)
+ # Back out of an attempt to upgrade this package FROM THIS VERSION
+ # to version $2. Undo the effects of "prerm upgrade $2".
+ :
+
+ ;;
+ abort-remove)
+ if test "$2" != in-favour; then
+ echo "$0: undocumented call to \`postinst $*'" 1>&2
+ exit 0
+ fi
+ # Back out of an attempt to remove this package, which was due to
+ # a conflict with package $3 (version $4). Undo the effects of
+ # "prerm remove in-favour $3 $4".
+ :
+
+ ;;
+ abort-deconfigure)
+ if test "$2" != in-favour -o "$5" != removing; then
+ echo "$0: undocumented call to \`postinst $*'" 1>&2
+ exit 0
+ fi
+ # Back out of an attempt to deconfigure this package, which was
+ # due to package $6 (version $7) which we depend on being removed
+ # to make way for package $3 (version $4). Undo the effects of
+ # "prerm deconfigure in-favour $3 $4 removing $6 $7".
+ :
+
+ ;;
+ *) echo "$0: didn't understand being called with \`$1'" 1>&2
+ exit 0;;
+esac
+
+exit 0
diff --git a/debian/prerm.in b/debian/prerm.in
new file mode 100644
index 0000000..d1380b8
--- /dev/null
+++ b/debian/prerm.in
@@ -0,0 +1,85 @@
+#!/bin/sh
+# -*- Mode: Sh -*-
+# prerm ---
+# Author : Manoj Srivastava ( srivasta@tiamat.datasync.com )
+# Created On : Thu Oct 29 15:31:03 1998
+# Created On Node : tiamat.datasync.com
+# Last Modified By : Manoj Srivastava
+# Last Modified On : Thu Oct 29 15:33:43 1998
+# Last Machine Used: tiamat.datasync.com
+# Update Count : 1
+# Status : Unknown, Use with caution!
+# HISTORY :
+# Description :
+#
+#
+
+# Abort if any command returns an error value
+set -e
+
+# This is filled in by debian/rules
+PACKAGE=#PACKAGE#
+
+# This script is called as the first step in removing the package from
+# the system. This includes cases where the user explicitly asked for
+# the package to be removed, upgrade, automatic removal due to conflicts,
+# and deconfiguration due to temporary removal of a depended-on package.
+
+case "$1" in
+ remove)
+ # This package about to be removed.
+ :
+
+ # There are two sub-cases:
+ if test "${2+set}" = set; then
+ if test "$2" != in-favour; then
+ echo "$0: undocumented call to \`prerm $*'" 1>&2
+ exit 0
+ fi
+ # We are being removed because of a conflict with package $3
+ # (version $4), which is now being installed.
+ :
+
+ else
+ # The package is being removed in its own right.
+ :
+
+ fi ;;
+ deconfigure)
+ if test "$2" != in-favour -o "$5" != removing; then
+ echo "$0: undocumented call to \`prerm $*'" 1>&2
+ exit 0
+ fi
+ # Package $6 (version $7) which we depend on is being removed due
+ # to a conflict with package $3 (version $4), and this package is
+ # being deconfigured until $6 can be reinstalled.
+ :
+
+ ;;
+ upgrade)
+ # Prepare to upgrade FROM THIS VERSION of this package to version $2.
+ :
+
+ ;;
+ failed-upgrade)
+ # Prepare to upgrade from version $2 of this package TO THIS VERSION.
+ # This is only used if the old version's prerm couldn't handle it,
+ # and returned non-zero. (Fix old prerm bugs here.)
+ :
+
+ ;;
+ *) echo "$0: didn't understand being called with \`$1'" 1>&2
+ exit 0;;
+esac
+
+# FSSTND compatibility symlinks
+if [ \( "$1" = "upgrade" -o "$1" = "remove" \) \
+ -a -L /usr/doc/$PACKAGE ]; then
+ rm -f /usr/doc/$PACKAGE
+fi
+
+if [ -x /usr/sbin/install-docs ]; then
+ /usr/sbin/install-docs -r $PACKAGE
+fi
+
+exit 0
diff --git a/debian/rules b/debian/rules
index ec65489..91cd6c2 100755
--- a/debian/rules
+++ b/debian/rules
@@ -22,24 +22,27 @@ version := $(shell LC_ALL=C dpkg-parsechangelog | \
ppackage:= packaging-manual
FILES_TO_CLEAN = debian/files debian/buildinfo debian/substvars \
+ debian/postinst debian/prerm \
version.ent policy.lout policy.lout.ld lout.li \
upgrading-checklist.text policy.text.gz \
packaging.lout packaging.text.gz packaging.ps \
- packaging.pdf.gz menu-policy.text.gz \
- proposal.text.gz menu-policy.pdf.gz proposal.pdf.gz
+ packaging.pdf.gz menu-policy.text.gz \
+ proposal.text.gz menu-policy.pdf.gz proposal.pdf.gz \
+ mime-policy.text.gz mime-policy.pdf.gz
STAMPS_TO_CLEAN = stamp-policy stamp-packaging stamp-build stamp-configure
DIRS_TO_CLEAN = debian/tmp policy.html fhs debian/tmp-packaging \
- packaging.html menu-policy.html proposal.html
-SGML_FILES = policy packaging menu-policy proposal
+ packaging.html menu-policy.html mime-policy.html \
+ proposal.html
+SGML_FILES = policy packaging menu-policy mime-policy proposal
# Location of the source dir
SRCTOP := $(shell if [ "$$PWD" != "" ]; then echo $$PWD; else pwd; fi;)
TMPTOP := $(SRCTOP)/debian/tmp
-DOCDIR := $(TMPTOP)/usr/doc/$(package)
+DOCDIR := $(TMPTOP)/usr/share/doc/$(package)
LIBDIR := $(TMPTOP)/usr/share/doc-base
PTMPTOP := $(SRCTOP)/debian/tmp-packaging
-PDOCDIR := $(PTMPTOP)/usr/doc/$(ppackage)
+PDOCDIR := $(PTMPTOP)/usr/share/doc/$(ppackage)
PLIBDIR := $(PTMPTOP)/usr/share/doc-base
FHS_ARCHIVE =$(shell ls -1 fhs*.tar.gz)
@@ -48,9 +51,11 @@ FSSTND_FILES =FSSTND-FAQ fsstnd-1.2.dvi.gz fsstnd-1.2.ps.gz fsstnd-1.2.txt.gz
POLICY_FILES =policy.text.gz policy.sgml virtual-package-names-list.text \
upgrading-checklist.text libc6-migration.text \
version.ent proposal.sgml proposal.text.gz \
- menu-policy.sgml menu-policy.text.gz
+ menu-policy.sgml menu-policy.text.gz \
+ mime-policy.sgml mime-policy.text.gz
BYHAND_FILES =policy.text.gz libc6-migration.text \
- virtual-package-names-list.text menu-policy.text.gz
+ virtual-package-names-list.text menu-policy.text.gz \
+ mime-policy.text.gz
PBYHAND_FILES=packaging.text.gz
install_file = /usr/bin/install -p -o root -g root -m 644
@@ -124,7 +129,10 @@ stamp-policy: build
$(install_file) debian-policy.desc $(LIBDIR)/debian-policy
(tar cf - policy.html) | (cd $(DOCDIR); tar xf -)
(tar cf - menu-policy.html) | (cd $(DOCDIR); tar xf -)
+ (tar cf - mime-policy.html) | (cd $(DOCDIR); tar xf -)
(tar cf - proposal.html) | (cd $(DOCDIR); tar xf -)
+ sed -e 's/#PACKAGE#/$(package)/' debian/postinst.in > debian/postinst
+ sed -e 's/#PACKAGE#/$(package)/' debian/prerm.in > debian/prerm
$(install_program) debian/{postinst,prerm} debian/tmp/DEBIAN/
dpkg-gencontrol -pdebian-policy -Pdebian/tmp -isp
chown -R root.root debian/tmp
@@ -165,6 +173,8 @@ stamp-packaging: build
$(install_file) debian/copyright $(PDOCDIR)/
$(install_file) packaging-manual.desc $(PLIBDIR)/packaging-manual
(tar cf - packaging.html) | (cd $(PDOCDIR); tar xf -)
+ sed -e 's/#PACKAGE#/$(ppackage)/' debian/postinst.in > debian/postinst
+ sed -e 's/#PACKAGE#/$(ppackage)/' debian/prerm.in > debian/prerm
$(install_program) debian/{postinst,prerm} debian/tmp-packaging/DEBIAN/
dpkg-gencontrol -ppackaging-manual -Pdebian/tmp-packaging -isp
chown -R root.root debian/tmp-packaging
diff --git a/menu-policy.sgml b/menu-policy.sgml
index 8ab1ed5..0719edd 100644
--- a/menu-policy.sgml
+++ b/menu-policy.sgml
@@ -98,7 +98,7 @@
The latest copy of this document can be found at
ftp.debian.org
- /debian/doc/package-developer/menu_policy.txt
+ /debian/doc/package-developer/menu-policy.txt
This document has been extracted and separated from the
diff --git a/mime-policy.sgml b/mime-policy.sgml
new file mode 100644
index 0000000..310302f
--- /dev/null
+++ b/mime-policy.sgml
@@ -0,0 +1,147 @@
+
+ %versiondata;
+]>
+
+
+
+
+
+ The Debian MIME support sub-policy
+
+ J.H.M. Dassen (Ray)
+ jdassen@debian.org
+
+
+ The Debian Policy mailing List
+ debian-policy@lists.debian.org
+
+ version &version;, &date;
+
+
+ This manual describes the policy requirements for the MIME support
+ system used in the Debian GNU/Linux distribution. This
+ document is part of the policy package for Debian. The policy
+ package itself is maintained by a group of maintainers that
+ have no editorial powers. At the moment, the list of
+ maintainers is:
+
+ -
+
Michael Alan Dorman mdorman@debian.org
+
+ -
+
Richard Braakman dark@xs4all.nl
+
+ -
+
Philip Hands phil@hands.com
+
+ -
+
Manoj Srivastava srivasta@debian.org
+
+
+
+
+
+
+
+ Copyright ©1999 .
+
+
+ This manual is free software; you may redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ as published by the Free Software Foundation; either version
+ 2, or (at your option) any later version.
+
+
+
+ This is distributed in the hope that it will be useful, but
+ without any warranty; without even the implied
+ warranty of merchantability or fitness for a particular
+ purpose. See the GNU General Public License for more
+ details.
+
+
+ A copy of the GNU General Public License is available as
+ /usr/share/common-licenses/GPL in the Debian GNU/Linux
+ distribution or on the World Wide Web at
+ . You can also obtain it by writing to the
+ Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.
+
+
+
+
+
+
+ About this document
+
+ The latest copy of this document can be found on
+ ftp.debian.org at
+ /debian/doc/package-developer/mime_policy.txt
+
+
+
+ MIME support mechanism
+
+ If you need assistance implementing this sub-policy, please
+ please ask for it on the debian-devel mailing list. If you
+ have proposals for changes or additions to this sub-policy,
+ please bring it up on debian-policy.
+
+
+ Background
+
+ MIME (Multipurpose Internet Mail Extensions, RFC 1521) is
+ a mechanism for encoding files and datastreams and providing
+ meta-information about them, in particular their type (e.g. audio
+ or video) and format (e.g. PNG, HTML, MP3).
+
+
+
+ Registration of MIME type handlers allows programs like mail
+ user agents and web browsers to to invoke these handlers to
+ view, edit or display MIME types they don't support directly.
+
+
+
+
+
+ MIME support implementation
+
+ The mime-support package provides the
+ update-mime program which allows packages to
+ register programs that can show, compose, edit or print
+ MIME types.
+
+
+
+ Packages containing such programs must register them
+ with update-mime as documented in . They should not depend
+ on, recommend, or suggest mime-support. Instead,
+ they should just put something like the following in the
+ postinst and postrm scripts:
+
+
+ if [ -x /usr/sbin/update-mime ]; then
+ update-mime
+ fi
+
+
+
+
+
+
diff --git a/packaging-manual.desc b/packaging-manual.desc
index 434cc2c..1534339 100644
--- a/packaging-manual.desc
+++ b/packaging-manual.desc
@@ -9,11 +9,11 @@ Abstract: This manual describes the technical aspects of creating Debian binary
Section: Apps/Programming
Format: debiandoc-sgml
-Files: /usr/doc/packaging-manual/packaging.sgml.gz
+Files: /usr/share/doc/packaging-manual/packaging.sgml.gz
Format: text
-Files: /usr/doc/packaging-manual/packaging.text.gz
+Files: /usr/share/doc/packaging-manual/packaging.text.gz
Format: HTML
-Index: /usr/doc/packaging-manual/packaging.html/index.html
-Files: /usr/doc/packaging-manual/packaging.html/*.html
+Index: /usr/share/doc/packaging-manual/packaging.html/index.html
+Files: /usr/share/doc/packaging-manual/packaging.html/*.html
diff --git a/packaging.sgml b/packaging.sgml
index c7d0153..00a4cb9 100644
--- a/packaging.sgml
+++ b/packaging.sgml
@@ -1191,6 +1191,12 @@
(classification, mandatory)
+ -
+
+ Build-Depends et
+ al. (source package interrelationships)
+
+
-
Standards-Version
@@ -1223,7 +1229,7 @@
-
Depends et
- al. (package interrelationships)
+ al. (binary package interrelationships)
@@ -1661,6 +1667,12 @@
-
Architecture
+ -
+
+ Build-Depends et
+ al. (source package interrelationships)
+
+
-
Standards-Version
@@ -1916,7 +1928,7 @@
Field names are not case-sensitive, but it is usual to
- capitalise the fields using mixed case as shown below.
+ capitalise the field names using mixed case as shown below.
@@ -1948,7 +1960,7 @@
The characters @ : =
- tt> _ (at, colon, equals, percent
+ % _ (at, colon, equals, percent
and underscore) used to be legal and are still
accepted when found in a package file, but may not be
used in new packages
@@ -2339,8 +2351,8 @@
been frozen for a month of testing. Once the
distribution is stable only major bug fixes
are allowed. When changes are made to this
- distribution, the minor version number is increased
- (for example: 1.2 becomes 1.2.1 then 1.2.2, etc).
+ distribution, the release number is increased
+ (for example: 1.2r1 becomes 1.2r2 then 1.2r3, etc).
@@ -2647,7 +2659,7 @@
The upstream-version may contain only
- alphanumerics and the characters + .
+ alphanumerics and the characters . +
- : (full stop, plus, hyphen, colon)
and should start with a digit. If there is no
debian-revision then hyphens are not allowed;
@@ -2755,6 +2767,37 @@
dpkg --compare-versions .... Type dpkg
--help --> --for details on arguments.
+
+
+ Version numbers based on dates
+
+ In general, Debian packages should use the same version
+ numbers as the upstream sources.
+
+
+ However, in some cases where the upstream version number is
+ based on a date (e.g., a development `snapshot' release)
+ dpkg cannot handle these version numbers currently, without
+ epochs. For example, dpkg will consider `96May01' to be
+ greater than `96Dec24'.
+
+
+ To prevent having to use epochs for every new upstream
+ version, the version number should be changed to the
+ following format in such cases: `19960501', `19961224'. It
+ is up to the maintainer whether he/she wants to bother the
+ upstream maintainer to change the version numbers upstream,
+ too.
+
+
+ Note, that other version formats based on dates which are
+ parsed correctly by dpkg should not be changed.
+
+
+ Native Debian packages (i.e., packages which have been
+ written especially for Debian) whose version numbers include
+ dates should always use the `YYYYMMDD' format.
+
Package maintainer scripts
@@ -2943,8 +2986,8 @@
-
disappearer's-postrm disappear
- r>overwritr>
- new-version
+ overwriter
+ overwriter-version
@@ -3521,6 +3564,18 @@
Replaces control file fields.
+
+ Source packages may declare relationships to binary packages,
+ saying that they require certain binary packages being
+ installed or absent at the time of building the package.
+
+
+
+ This is done using the Build-Depends,
+ Build-Depends-Indep, Build-Conflicts, and
+ Build-Conflicts-Indep control file fields.
+
+
Syntax of relationship fields
@@ -3529,13 +3584,14 @@
package names separated by commas.
-
- In Depends, Recommends, Suggests
- and Pre-Depends (the fields which declare
- dependencies of the package in which they occur on other
- packages) these package names may also be lists of
- alternative package names, separated by vertical bar symbols
- | (pipe symbols).
+
+ In Depends, Recommends, Suggests,
+ Pre-Depends, Build-Depends and
+ Build-Depends-Indep(the fields which declare
+ dependencies of the package in which they occur on other
+ packages) these package names may also be lists of
+ alternative package names, separated by vertical bar symbols
+ | (pipe symbols).
@@ -3578,10 +3634,37 @@
Depends: libc5 (>= 5.2.18-4), mime-support, csh | tcsh
+
+
+ All fields that specify build-time relationships
+ (Build-Depends, Build-Depends-Indep,
+ Build-Conflicts and Build-Conflicts-Indep)
+ may be restricted to a certain set of architectures. This
+ is done in brackets after each individual package name and
+ the optional version specification. The brackets enclose a
+ list of Debian architecture names separated by whitespace.
+ An exclamation mark may be prepended to each name. If the
+ current Debian host architecture is not in this list and
+ there are no exclamation marks in the list, or it is in the
+ list with a prepended exclamation mark, the package name and
+ the associated version specification are ignored completely
+ for the purposes of defining the relationships.
+
+
+
+ For example:
+
+ Source: glibc
+ Build-Depends-Indep: texinfo
+ Build-Depends: kernel-headers-2.2.10 [!hurd-i386],
+ hurd-dev [hurd-i386], gnumach-dev [hurd-i386]
+
+
-
- Dependencies - Depends, Recommends,
- Suggests, Pre-Depends
+
+
+ Binary Dependencies - Depends,
+ Recommends, Suggests, Pre-Depends
@@ -3818,12 +3901,12 @@
- Alternative packages -
+ Alternative binary packages -
Conflicts and Replaces
- When one package declares a conflict with another
+ When one binary package declares a conflict with another
dpkg will refuse to allow them to be installed
on the system at the same time.
@@ -3882,11 +3965,13 @@
Virtual packages - Provides
-
- As well as the names of actual (`concrete') packages, the
- package relationship fields Depends,
- Recommends, Suggests and
- Conflicts may mention virtual packages.
+
+ As well as the names of actual (`concrete') packages, the
+ package relationship fields Depends,
+ Build-Depends, Build-Depends-Indep,
+ Recommends, Suggests, Conflicts,
+ Build-Conflicts and Build-Conflicts-Indep may
+ mention virtual packages.
@@ -4080,8 +4165,49 @@
lightweight standalone info browser.
-
+
+ Relationships between source and binary packages -
+ Build-Depends, Build-Depends-Indep,
+ Build-Conflicts, Build-Conflicts-Indep
+
+
+
+ A source package may declare a dependency or a conflict on a
+ binary package. This is done with the control file fields
+ Build-Depends, Build-Depends-Indep,
+ Build-Conflicts, and Build-Conflicts-Indep. Their
+ semantics is that the dependencies and conflicts they define
+ must be satisfied (as defined earlier for binary packages),
+ when one of the targets in debian/rules that the
+ particular field applies to is invoked.
+
+
+ Build-Depends, Build-Conflicts
+ -
+
+ The Build-Depends and Build-Conflicts fields apply
+ to the targets
+ build, binary, binary-arch
+ and binary-indep.
+
+
+ Build-Depends-Indep, Build-Conflicts-Indep
+ -
+
+ The Build-Depends-Indep and
+ Build-Conflicts-Indep fields apply to the
+ targets binary and binary-indep.
+
+
+
+
+
+
+
+
+
+
Configuration file handling
@@ -4389,7 +4515,8 @@
properly is to install the library in the appropriate
debian/tmp/.../lib directory before creating the
symlink, by putting the commands in the debian/rules
- in the appropriate order.
+ in the appropriate order. Whether this has been done
+ correctly can be checked by performing an ls -f.