Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2023-09-10 Thread Edward Little
Please remove the following email address: e.little...@gmail.com On Sun, Sep 10, 2023 at 2:33 PM Russ Allbery wrote: > Guillem Jover writes: > > > Seems I missed another file: > > > * .changes: > > policy → «upload control file» / «Debian changes file» > > dpkg → «upload control

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2023-09-10 Thread Russ Allbery
Guillem Jover writes: > Seems I missed another file: > * .changes: > policy → «upload control file» / «Debian changes file» > dpkg → «upload control file» / «.changes control file» / > «Debian .changes file» / «Debian changes file» [...] > For changes I think

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-20 Thread Russ Allbery
Guillem Jover writes: > Ok, I've prepared the attached incremental patch, which only switches > from paragraph(s) to stanza(s) all over the place. Thanks, applied. > I've updated all the specs for consistency. I've updated the footnote to > swap the preference and to mention paragraph is now

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-19 Thread Guillem Jover
Hi! On Sun, 2022-09-18 at 17:34:57 -0700, Russ Allbery wrote: > Sean Whitton writes: > > On Mon 19 Sep 2022 at 12:45AM +02, Guillem Jover wrote: > >> So, personally, I'd be happy to fully switch to stanza TBH, because it > >> seems more specific to our use, probably easier to search for, and >

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Sean Whitton
Hello, On Sun 18 Sep 2022 at 05:34PM -07, Russ Allbery wrote: > Sean Whitton writes: >> On Mon 19 Sep 2022 at 12:45AM +02, Guillem Jover wrote: > >>> So, personally, I'd be happy to fully switch to stanza TBH, because it >>> seems more specific to our use, probably easier to search for, and >>>

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Russ Allbery
Guillem Jover writes: > I've been considering naming debian/control something like > «Debian template source package control file», as that is used to > generate both the source and binary control files. And always > prefixing with Debian, so that would end up as: > * debian/control: «Debian

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Russ Allbery
Sean Whitton writes: > On Mon 19 Sep 2022 at 12:45AM +02, Guillem Jover wrote: >> So, personally, I'd be happy to fully switch to stanza TBH, because it >> seems more specific to our use, probably easier to search for, and >> it's shorter. > I think this is fine for Policy to do. I vote for

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Sean Whitton
Hello, On Mon 19 Sep 2022 at 12:45AM +02, Guillem Jover wrote: > I went for paragraph, because dpkg has some instances of it already in > docs and code (and stanza only in code), and mainly because the Debian > policy uses almost exclusively paragraph for this with a single > mention of "stanza"

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Guillem Jover
On Sun, 2022-09-18 at 14:53:30 -0700, Sean Whitton wrote: > On Sun 18 Sep 2022 at 10:28PM +02, Guillem Jover wrote: > > > So, how does «source package paragraph» and «binary package paragraph» > > (of the «template control file») sound instead? > > Can we standardise on 'stanza', please? > > I

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Sean Whitton
Hello, On Sun 18 Sep 2022 at 10:28PM +02, Guillem Jover wrote: > So, how does «source package paragraph» and «binary package paragraph» > (of the «template control file») sound instead? Can we standardise on 'stanza', please? I thought that was already standard, and "paragraph" is for prose.

Bug#1020248: debian-policy: Clarifying nomenclature for control file names

2022-09-18 Thread Guillem Jover
Package: debian-policy Version: 4.6.1.1 Severity: wishlist Hi! This is a followup from my comment at: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=998165#43 To summarize, we have IMO confusing naming and nomenclature for the various control files and paragraphs/stanzas, and this is even