Hi! On Sun, 2023-09-10 at 10:30:41 -0700, Russ Allbery wrote: > 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 > @@ -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.
Hmm, the "For this case" comes just after the "no binary packages" which to me reads as being somewhat referring to it, perhaps the "no binary packages" sentence should be put at the end of the paragraph to avoid confusion, or the "For this case" moved instead after the "It is a multiline field" one or something along those lines? > 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. > Thanks, Guillem
