From: Russ Allbery Date: Sat, 8 Aug 2009 03:06:17 +0000 (-0700) Subject: Clarify the description of the Files control field X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=16f98d50b4585ceb8e246ca88581c1a8545e77c2;p=debian%2Fdebian-policy.git Clarify the description of the Files control field Reword a difficult sentence in the Files control field description and add examples of the two versions of the field. Thanks to Jeremiah Foster for the report and wording discussion. --- diff --git a/debian/changelog b/debian/changelog index 675905d..9dafa0e 100644 --- a/debian/changelog +++ b/debian/changelog @@ -60,6 +60,7 @@ debian-policy (3.8.3.0) UNRELEASED; urgency=low * Explain that the copyright dates are for the original Policy manual and that there is no updated list of copyright holders for subsequent revisions available. (Partly addresses #47438) + * Clarify the description of the Files control field and add examples. * Merge the package name syntax requirements between the Package and Source field descriptions. diff --git a/policy.sgml b/policy.sgml index 27deaa7..50d28db 100644 --- a/policy.sgml +++ b/policy.sgml @@ -3308,20 +3308,30 @@ Package: libc6

This field contains a list of files with information about each one. The exact information and syntax varies with - the context. In all cases the part of the field - contents on the same line as the field name is empty. The - remainder of the field is one line per file, each line - being indented by one space and containing a number of - sub-fields separated by spaces. + the context. +

+ +

+ In all cases, Files is a multiline field. The first line of + the field value (the part on the same line as Files:) + is always empty. The content of the field is expressed as + continuation lines, one line per file. Each line must be + indented by one space and contain a number of sub-fields, + separated by spaces, as described below.

In the .dsc file, each line contains the MD5 - checksum, size and filename of the tar file and (if applicable) - diff file which make up the remainder of the source - package - That is, the parts which are not the .dsc. - . + checksum, size and filename of the tar file and (if + applicable) diff file which make up the remainder of the + source package + That is, the parts which are not the .dsc. + . For example: + +Files: + c6f698f19f2a2aa07dbb9bbda90a2754 571925 example_1.2.orig.tar.gz + 938512f08422f3509ff36f125f5873ba 6220 example_1.2-1.diff.gz + The exact forms of the filenames are described in .

@@ -3329,14 +3339,20 @@ Package: libc6

In the .changes file this contains one line per file being uploaded. Each line contains the MD5 checksum, - size, section and priority and the filename. + size, section and priority and the filename. For example: + +Files: + 4c31ab7bfc40d3cf49d7811987390357 1428 text extra example_1.2-1.dsc + c6f698f19f2a2aa07dbb9bbda90a2754 571925 text extra example_1.2.orig.tar.gz + 938512f08422f3509ff36f125f5873ba 6220 text extra example_1.2-1.diff.gz + 7c98fe853b3bbb47a00e5cd129b6cb56 703542 text extra example_1.2-1_i386.deb + The section - and priority - are the values of the corresponding fields in - the main source control file. If no section or priority is - specified then - should be used, though section - and priority values must be specified for new packages to - be installed properly. + and priority are the values of + the corresponding fields in the main source control file. If + no section or priority is specified then - should be + used, though section and priority values must be specified for + new packages to be installed properly.