Here is an updated proposed change for this bug, incorporating Guillem's suggestions. It is ready for seconds.
-- Russ Allbery (r...@debian.org) <https://www.eyrie.org/~eagle/>
>From 66175d3775f238a5ce3a2254388ad974e81d462f Mon Sep 17 00:00:00 2001 From: Russ Allbery <r...@debian.org> Date: Tue, 20 Sep 2022 21:17:55 -0700 Subject: [PATCH] Binary and Description optional in .changes In .changes files for source-only uploads, the Binary and Description fields are not present. Document this, and be clearer in the description of the Description field for .changes files that only descriptions of binary packages are included. --- policy/ch-controlfields.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/policy/ch-controlfields.rst b/policy/ch-controlfields.rst index 4bab7df..904fa52 100644 --- a/policy/ch-controlfields.rst +++ b/policy/ch-controlfields.rst @@ -278,7 +278,7 @@ The fields in this file are: - :ref:`Source <s-f-Source>` (mandatory) -- :ref:`Binary <s-f-Binary>` (mandatory) +- :ref:`Binary <s-f-Binary>` (mandatory in some cases) - :ref:`Architecture <s-f-Architecture>` (mandatory) @@ -292,7 +292,7 @@ The fields in this file are: - :ref:`Changed-By <s-f-Changed-By>` -- :ref:`Description <s-f-Description>` (mandatory) +- :ref:`Description <s-f-Description>` (mandatory in some cases) - :ref:`Closes <s-f-Closes>` @@ -812,10 +812,11 @@ See :ref:`s-descriptions` for further information on this. In a ``.changes`` file, the ``Description`` field contains a summary of -the descriptions for the packages being uploaded. For this case, the -first line of the field value (the part on the same line as -``Description:``) is always empty. It is a multiline field, with one -line per package. Each line is indented by one space and contains the +the descriptions of the binary packages being uploaded. If no binary +packages are being uploaded, this field will not be present. For this +case, the first line of the field value (the part on the same line as +``Description:``) is always empty. It is a multiline field, with one line +per binary package. Each line is indented by one space and contains the name of a binary package, a space, a hyphen (``-``), a space, and the short description line from that package. @@ -927,7 +928,8 @@ every architecture. The source control file doesn't contain details of which architectures are appropriate for which of the binary packages. When it appears in a ``.changes`` file, it lists the names of the binary -packages being uploaded, separated by whitespace (not commas). +packages being uploaded, separated by whitespace (not commas). If no +binary packages are being uploaded, this field will not be present. .. _s-f-Installed-Size: -- 2.40.1