Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Daniel Shahaf
Package: debian-policy Version: 4.5.0.0 Severity: wishlist Tags: patch upstream Dear Maintainer, The documentation of the "Closes: #NN" changelog syntax describes the syntax in terms of a Perl regular expression. However, not all readers know Perl. I suggest to describe the semantics in Eng

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Holger Levsen
Hi Daniel, On Sat, Mar 14, 2020 at 06:14:02PM +, Daniel Shahaf wrote: > The documentation of the "Closes: #NN" changelog syntax describes > the syntax in terms of a Perl regular expression. However, not all > readers know Perl. I suggest to describe the semantics in English, > in additio

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Sean Whitton
Hello Daniel, On Sat 14 Mar 2020 at 06:14PM +00, Daniel Shahaf wrote: > The documentation of the "Closes: #NN" changelog syntax describes > the syntax in terms of a Perl regular expression. However, not all > readers know Perl. I suggest to describe the semantics in English, > in addition t

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Daniel Shahaf
Sean Whitton wrote on Sat, 14 Mar 2020 19:06 +00:00: > Hello Daniel, > > On Sat 14 Mar 2020 at 06:14PM +00, Daniel Shahaf wrote: > > > The documentation of the "Closes: #NN" changelog syntax describes > > the syntax in terms of a Perl regular expression. However, not all > > readers know Per

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Daniel Shahaf
Daniel Shahaf wrote on Sat, 14 Mar 2020 18:14 +00:00: > - :: > - > - /closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i > - > + All of the bug numbers listed must be given on the same physical line > + as the word ``closes:``. Is this newly-added sentence correct? Whether it cor

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Sean Whitton
Hello, On Sat 14 Mar 2020 at 07:50PM +00, Daniel Shahaf wrote: > What shape would this take? Would the Perl definition be authoritative > and the English one informative, or vice versa? (Or something else > altogether?) Well, firstly, we're talking about the contents of a footnote here, so the

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Sean Whitton
Hello, On Sat 14 Mar 2020 at 08:09PM +00, Daniel Shahaf wrote: > Daniel Shahaf wrote on Sat, 14 Mar 2020 18:14 +00:00: >> - :: >> - >> - /closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i >> - >> + All of the bug numbers listed must be given on the same physical line >> + as the

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Daniel Shahaf
Sean Whitton wrote on Sat, 14 Mar 2020 20:39 +00:00: > Hello, > > On Sat 14 Mar 2020 at 08:09PM +00, Daniel Shahaf wrote: > > > Daniel Shahaf wrote on Sat, 14 Mar 2020 18:14 +00:00: > >> - :: > >> - > >> - /closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i > >> - > >> + All of the

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Sean Whitton
Hello, On Sat 14 Mar 2020 at 09:49PM +00, Daniel Shahaf wrote: > I agree that it is probably incorrect, but that doesn't follow from the > semantics of /\s/. Even if /\s/ matched any single byte/character, the > semantics would still depend on what haystack the regexp is matched > against: the e

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Guillem Jover
Hi! On Sat, 2020-03-14 at 21:49:12 +, Daniel Shahaf wrote: > Sean Whitton wrote on Sat, 14 Mar 2020 20:39 +00:00: > > On Sat 14 Mar 2020 at 08:09PM +00, Daniel Shahaf wrote: > > > Daniel Shahaf wrote on Sat, 14 Mar 2020 18:14 +00:00: > > >> - :: > > >> - > > >> - /closes:\s*(?:bug)?\#?

Bug#953911: debian-policy: clarify documentation of "Closes: #NNNNNN" changelog syntax

2020-03-14 Thread Daniel Shahaf
Guillem Jover wrote on Sat, 14 Mar 2020 22:51 +00:00: > Hi! > > On Sat, 2020-03-14 at 21:49:12 +, Daniel Shahaf wrote: > > Sean Whitton wrote on Sat, 14 Mar 2020 20:39 +00:00: > > > On Sat 14 Mar 2020 at 08:09PM +00, Daniel Shahaf wrote: > > > > Daniel Shahaf wrote on Sat, 14 Mar 2020 18:14 +0