On Sun, Dec 12, 2021 at 06:47:21PM +0100, Mattia Rizzolo wrote: > On Sun, Oct 31, 2021 at 11:18:35AM +0100, Mattia Rizzolo wrote: > > If I get no pushbacks I'll also propose some text later on when I'm > > freer (unless somebody beats me to it!). > > I'm hereby seeking seconds (or, well, suggestions for improvements) for > the following diff, which is based on > daa7d69fbffc1c438002993860f0df407e4aaeb1 (4.6.0.1): > > |--- a/policy/ch-controlfields.rst > |+++ b/policy/ch-controlfields.rst > |@@ -131,6 +131,8 @@ package) are: > | > | - :ref:`Rules-Requires-Root <s-f-Rules-Requires-Root>` > | > |+- :ref:`Description <s-f-Description>` > |+ > | The fields in the binary package paragraphs are: > | > | - :ref:`Package <s-f-Package>` (mandatory) > |@@ -652,9 +654,14 @@ orderings. [#]_ > | ~~~~~~~~~~~~~~~ > | > | In a source or binary control file, the ``Description`` field contains a > |-description of the binary package, consisting of two parts, the synopsis > |-or the short description, and the long description. It is a multiline > |-field with the following format: > |+description of the package, consisting of two parts, the synopsis or the > short > |+description, and the long description. > |+ > |+When used in a source control file in the general paragraph (i.e., the first
I believe the 2nd "in" in this line is too much.
> |+one, for the source package), the text in this field is relevant for all
> binary
> |+packages built by the given source package.
and then I'd rewrite "the general paragraph (i.e., the first one, for
the source package)" into "the first paragraph" and the whole paragraph into
When used in a source control file the first paragraph is used as the first
paragraph for all binary packages built by the given source package.
> |+
> |+It is a multiline field with the following format:
I'd second this change too.
--
cheers,
Holger
⢀⣴⠾⠻⢶⣦⠀
⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org
⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
⠈⠳⣄
This is the year of gpg on the desktop! (Gunnar Wolf)
signature.asc
Description: PGP signature
