On Sun, Dec 12, 2021 at 10:51:43PM +0000, Holger Levsen wrote: > > |--- a/policy/ch-controlfields.rst > > |+++ b/policy/ch-controlfields.rst > > |@@ -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.
Mh, not really? However indeed it might be clearer this other way:
When used in the general paragraph of a source control file [...]
> > |+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.
That's not proper: the place this text is placed (§5.6.13 "Description")
talks about the "Description" and it's linked to from the various places
this field is used (a source control file, a binary control file, a
changes control file); it's not describing the source control file (i.e.
d/control). Furthermore, note that the wording "general paragraph"
comes from §5.2 "Source package control files – debian/control":
The first paragraph of the control file contains information about
the source package in general. [...]
The fields in the general paragraph (the first one, for the source
package) are: [...]
Of course I'm happy to use a different expression (like, "first
paragraph of a source control file") if I'm recommended to.
--
regards,
Mattia Rizzolo
GPG Key: 66AE 2B4A FCCF 3F52 DA18 4D18 4B04 3FCD B944 4540 .''`.
More about me: https://mapreri.org : :' :
Launchpad user: https://launchpad.net/~mapreri `. `'`
Debian QA page: https://qa.debian.org/developer.php?login=mattia `-
signature.asc
Description: PGP signature
