Bug#963524: debian-policy: Binary and Description fields not mandatory in .changes on source-only uploads
- To: Guillem Jover <guillem@debian.org>
- Cc: 963524@bugs.debian.org
- Subject: Bug#963524: debian-policy: Binary and Description fields not mandatory in .changes on source-only uploads
- From: Russ Allbery <rra@debian.org>
- Date: Sun, 10 Sep 2023 10:30:41 -0700
- Message-id: <[🔎] 87r0n6vsu6.fsf@hope.eyrie.org>
- Reply-to: Russ Allbery <rra@debian.org>, 963524@bugs.debian.org
- In-reply-to: <Yyzag8H1sw1cauiL@thunder.hadrons.org> (Guillem Jover's message of "Thu, 22 Sep 2022 23:58:27 +0200")
- References: <CAFHYt56kKxmKETnOih55OJ7V-v154sUXh+E9TOqEPprBJEFxzg@mail.gmail.com> <CAFHYt56kKxmKETnOih55OJ7V-v154sUXh+E9TOqEPprBJEFxzg@mail.gmail.com> <20200623025558.GA1373896@thunder.hadrons.org> <CAFHYt56kKxmKETnOih55OJ7V-v154sUXh+E9TOqEPprBJEFxzg@mail.gmail.com> <87k05xfjcs.fsf@hope.eyrie.org> <CAFHYt56kKxmKETnOih55OJ7V-v154sUXh+E9TOqEPprBJEFxzg@mail.gmail.com> <Yyzag8H1sw1cauiL@thunder.hadrons.org> <CAFHYt56kKxmKETnOih55OJ7V-v154sUXh+E9TOqEPprBJEFxzg@mail.gmail.com>
Here is an updated proposed change for this bug, incorporating Guillem's
suggestions. It is ready for seconds.
--
Russ Allbery (rra@debian.org) <https://www.eyrie.org/~eagle/>
>From 66175d3775f238a5ce3a2254388ad974e81d462f Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@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
Reply to: