X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=74f94e8c4665de20ad3cd09454f50943c70791b7;hb=6b5ecb49b116555668ebdfc97d9586d5697bb6a8;hp=f2d81e8a3a7f736ffb29c86c211e45fe2720bc36;hpb=1f7643d5603cd26efd9b8f58fd72f2803afdc194;p=debian%2Fdebian-policy.git diff --git a/policy.sgml b/policy.sgml index f2d81e8..74f94e8 100644 --- a/policy.sgml +++ b/policy.sgml @@ -1788,7 +1788,7 @@ The build target should perform all the configuration and compilation of the package. If a package has an interactive pre-build - configuration routine, the Debianized source package + configuration routine, the Debian source package must either be built after this has taken place (so that the binary package can be built without rerunning the configuration) or the configuration routine @@ -2534,6 +2534,11 @@ Package: libc6 (and version-dependent) information about a binary package.

+

+ The structure of the Debian changes files is versionned, and + this document describes the format 1.8. +

+

The fields in this file are: @@ -2615,10 +2620,10 @@ Package: libc6 Version (mandatory) Distribution (mandatory) Urgency (recommended) - Maintainer (mandatory) - Changed-By + Maintainer (mandatory) The meaning of that field changed in version 1.7. + Changed-By Introduced in format 1.7. Description (mandatory) - Closes + Closes Introduced in format 1.6. Changes (mandatory) Checksums-Sha1 and Checksums-Sha256 (recommended) @@ -3027,9 +3032,10 @@ Package: libc6 It is optional; if it isn't present then the upstream_version may not contain a hyphen. This format represents the case where a piece of - software was written specifically to be turned into a - Debian package, and so there is only one "debianisation" - of it and therefore no revision indication is required. + software was written specifically to be a Debian + package, where the Debian package source must always + be identical to the pristine source and therefore no + revision indication is required.

@@ -3258,13 +3264,25 @@ Package: libc6 Format

- This field specifies a format revision for the file. - The most current format described in the Policy Manual - is version 1.5. The syntax of the + In changes files, this field + specifies a format revision for the file. The syntax of the format value is the same as that of a package version number except that no epoch or Debian revision is allowed - see .

+ +

+ In Debian source control + files, this field specifies a format revision for the source package. + The syntax of the format value is the same as that of a package version + number, except that no epoch or Debian revision is allowed + and that it can optionally be followed by a parenthesis with a name + dpkg-source uses the major number and the content of the + parenthesis to decide which perl module to use to build or unpack + the source package. For instance, Dpkg::Source::Package::V1 for format + 1.0 and Dpkg::Source::Package::V3::quilt for format 3.0 (quilt) + . +

@@ -3525,6 +3543,26 @@ Checksums-Sha256:

+ + Checksums-Sha1 + +

+ This field is similar to the Files + field, except that it uses the Sha1 algorithm instead of MD5 + for the checksums. +

+ + + + Checksums-Sha256 + +

+ This field is similar to the Files + field, except that it uses the Sha1 algorithm instead of MD5 + for the checksums. +

+ + @@ -10203,23 +10241,23 @@ END-INFO-DIR-ENTRY - The Debianised source tree + The Debian package source tree

The source archive scheme described later is intended to - allow a Debianised source tree with some associated control - information to be reproduced and transported easily. The - Debianised source tree is a version of the original program - with certain files added for the benefit of the - Debianisation process, and with any other changes required + allow a Debian package source tree with some associated + control information to be reproduced and transported easily. + The Debian package source tree is a version of the original + program with certain files added for the benefit of the + packaging process, and with any other changes required made to the rest of the source code and installation scripts.

The extra files created for Debian are in the subdirectory - debian of the top level of the Debianised source - tree. They are described below. + debian of the top level of the Debian package + source tree. They are described below.

@@ -10309,7 +10347,7 @@ END-INFO-DIR-ENTRY - Debianisation diff - + Debian package diff - package_upstream_version-revision.diff.gz @@ -10378,7 +10416,7 @@ END-INFO-DIR-ENTRY

Apply the diff using patch -p0.

Untar the tarfile again if you want a copy of the original - source code alongside the Debianised version.

+ source code alongside the Debian version.

 @@ -10412,10 +10450,10 @@ END-INFO-DIR-ENTRY

The source packaging tools manage the changes between the - original and Debianised source using diff and + original and Debian source using diff and patch. Turning the original source tree as - included in the .orig.tar.gz into the debianised - source must not involve any changes which cannot be + included in the .orig.tar.gz into the Debian + package source must not involve any changes which cannot be handled by these tools. Problematic changes which cause dpkg-source to halt with an error when building the source package are: