Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-29 Thread Sean Whitton
Hello Mattia, Russ, Thank you both for your input on this. On Mon 27 Dec 2021 at 09:51PM +01, Mattia Rizzolo wrote: > In my mind I was mostly focusing on being able to provide a > **description for the source package** (that is, then, relevant to > everything that source package builds); said

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Russ Allbery
Simon McVittie writes: > I believe the intention is to automate this pattern, which a lot of > packages with shared libraries are already using: > Source: dbus > Package: dbus > Description: simple interprocess messaging system (system message bus) > D-Bus is a message bus,

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Russ Allbery
Nicholas D Steeves writes: > The following is only Informational level, but the existence of > Lintian's "duplicate-long-description" tag suggests that producing > duplicate bin:Descriptions in bin:libfoo and bin:foo packages is not > ideal, thus a straight copy from src:Description is not

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Simon McVittie
On Mon, 27 Dec 2021 at 15:08:03 -0700, Nicholas D Steeves wrote: > The following is only Informational level, but the existence of > Lintian's "duplicate-long-description" tag suggests that producing > duplicate bin:Descriptions in bin:libfoo and bin:foo packages is not > ideal, thus a straight

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Nicholas D Steeves
Hi! Reply follows inline, Mattia Rizzolo writes: > On Mon, Dec 27, 2021 at 01:20:14PM -0700, Sean Whitton wrote: >> In that case, returning to Mattia's patch, it is probably not correct to >> say that the source Description is relevant for all binary packages, >> because perhaps the substvar

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Russ Allbery
Mattia Rizzolo writes: > |+When used in a source control file in the general paragraph (i.e., the > |+first one, for the source package), the text in this field is used to > |+describe the source package itself, and consequently all of the binary > |+packages built from itself. What if we just

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Mattia Rizzolo
On Mon, Dec 27, 2021 at 01:20:14PM -0700, Sean Whitton wrote: > In that case, returning to Mattia's patch, it is probably not correct to > say that the source Description is relevant for all binary packages, > because perhaps the substvar is used for some but not all of them? Mh, we probably

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-27 Thread Sean Whitton
Hello Guillem, Mattia, On Fri 24 Dec 2021 at 01:42PM +01, Guillem Jover wrote: > On Tue, 2021-12-21 at 17:53:31 -0700, Sean Whitton wrote: >> >> Is there really no name for the first paragraph other than "general >> paragraph"? > > That's how the dpkg documentation (man and perl modules POD)

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-24 Thread Guillem Jover
On Tue, 2021-12-21 at 17:53:31 -0700, Sean Whitton wrote: > On Sun 12 Dec 2021 at 06:47PM +01, Mattia Rizzolo wrote: > > > |--- a/policy/ch-controlfields.rst > > |+++ b/policy/ch-controlfields.rst > > |@@ -652,9 +654,14 @@ orderings. [#]_ > > | ~~~ > > | > > | In a source or binary

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-24 Thread Mattia Rizzolo
On Tue, Dec 21, 2021 at 05:53:31PM -0700, Sean Whitton 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 > >

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-21 Thread Sean Whitton
Hello Mattia, Thanks for the patch. On Sun 12 Dec 2021 at 06:47PM +01, Mattia Rizzolo 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``

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-14 Thread Mattia Rizzolo
On Sun, Dec 12, 2021 at 10:51:43PM +, 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 > >

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-12 Thread Holger Levsen
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,

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-12-12 Thread Mattia Rizzolo
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

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-11-04 Thread Mattia Rizzolo
On Wed, Nov 03, 2021 at 11:40:02PM +0100, Bill Allombert wrote: > Could you clarify what source packages that produce several binary > packages should do ? Maybe give an example ? Sure. Here is how I would use it, for example. --- a/debian/control +++ b/debian/control @@ -25,6 +25,13 @@

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-11-03 Thread Bill Allombert
On Sun, Oct 31, 2021 at 11:18:35AM +0100, Mattia Rizzolo wrote: > Package: debian-policy > Version 4.6.0.0 > > Hi! > > dpkg 1.19.0 introduced, following the request in #555743, a bunch of new > substvars. Notably, it now handles ${source:Synopsis} and > ${source:Extended-Description} that are

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-11-03 Thread Mattia Rizzolo
On Mon, Nov 01, 2021 at 05:32:19PM -0700, Sean Whitton wrote: > > The main "bad" consequence would be that Description would be exported > > in the .dsc and as such end up in the Sources index. This is probably > > what we want anyway, but with all the people complaining about how big > > the

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-11-01 Thread Sean Whitton
Hello, On Sun 31 Oct 2021 at 11:18AM +01, Mattia Rizzolo wrote: > Package: debian-policy > Version 4.6.0.0 > > Hi! > > dpkg 1.19.0 introduced, following the request in #555743, a bunch of new > substvars. Notably, it now handles ${source:Synopsis} and > ${source:Extended-Description} that are

Bug#998165: debian-policy: document and allow Description in the source paragraph

2021-10-31 Thread Mattia Rizzolo
Package: debian-policy Version 4.6.0.0 Hi! dpkg 1.19.0 introduced, following the request in #555743, a bunch of new substvars. Notably, it now handles ${source:Synopsis} and ${source:Extended-Description} that are described as follow: source:Synopsis The source package