Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-08-17 Thread Sean Whitton
Hello Ian, On Tue 14 Aug 2018 at 05:48PM +0100, Ian Jackson wrote: > I think part of the difficulty we are having with this is by failing > to have a kind of contextual introduction. I see what you are trying to do, but there are two immediate difficulties: - Debian itself uses the term 'change

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling [and 1 more messages]

2018-08-14 Thread Ian Jackson
Simon McVittie writes ("Bug#459427: Patch seeking seconds on changelog vs. NEWS handling"): > Debian packages have a Debian changelog and (when the source package > is included, without which we are not GPL-compliant anyway) a Debian > diff/tar, so there is certainly a promi

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-08-14 Thread Ian Jackson
Sean Whitton writes ("Bug#459427: Patch seeking seconds on changelog vs. NEWS handling"): > +If an upstream release notes file is available, containing a summary > +of changes between upstream releases intended for end users of the > +package and often called ``NEWS``, it shou

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-08-01 Thread Sean Whitton
Hello Bill, On Fri 27 Jul 2018 at 12:31PM +0200, Bill Allombert wrote: > I am fine with the removal of source-level changelogs, with the provisio > that the concept of source-level changelog be clearly defined in policy. > This needs to be worded carefully so that maintainers do not start > remov

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-27 Thread Bill Allombert
On Thu, Jul 26, 2018 at 08:09:48PM -0700, Russ Allbery wrote: > Sean Whitton writes: > > > It's become clear that we do not have consensus on recommending that > > only the release notes be installed, and not also the changelog. > > I'm happy to see this go into Policy, but I find it unfortunate

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-27 Thread David Bremner
Sean Whitton writes: > > diff --git a/policy/ch-docs.rst b/policy/ch-docs.rst > index 1de221f..e990f34 100644 > --- a/policy/ch-docs.rst > +++ b/policy/ch-docs.rst > @@ -255,32 +255,45 @@ files may be installed into ``/usr/share/doc/package``. > > .. _s-changelogs: > > -Changelog files > ---

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-26 Thread Russ Allbery
Sean Whitton writes: > It's become clear that we do not have consensus on recommending that > only the release notes be installed, and not also the changelog. I'm happy to see this go into Policy, but I find it unfortunate that we're unwilling to take a stance against this. The source-level Cha

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-26 Thread Simon McVittie
On Wed, 25 Jul 2018 at 20:57:41 -0700, Jonathan Nieder wrote: > a) The work must carry prominent notices stating that you modified >it, and giving a relevant date. I don't think this is normally interpreted as requiring that *all* modifications be listed, only that the existence of mod

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Holger Levsen
On Thu, Jul 26, 2018 at 01:05:16PM +0800, Sean Whitton wrote: > diff --git a/policy/ch-docs.rst b/policy/ch-docs.rst > index 1de221f..e990f34 100644 > --- a/policy/ch-docs.rst > +++ b/policy/ch-docs.rst > @@ -255,32 +255,45 @@ files may be installed into ``/usr/share/doc/package``. > > .. _s-cha

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Sean Whitton
[if you were CCed on this e-mail: this was because you seconded a previous version of the patch which included a recommendation which I have now dropped, and I hope you'll second the revised patch, further down this e-mail] Hello Jonathan, On Wed 25 Jul 2018 at 08:57PM -0700, Jonathan Nieder wrot

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Jonathan Nieder
Sean Whitton wrote: > On Wed 25 Jul 2018 at 07:01PM -0700, Jonathan Nieder wrote: >> I share gregor's discomfort: I don't think we've thought this through. > > I too want Policy to be as correct as possible, but this bug has been > open for ten years and one thing upon which there is certainly con

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Sean Whitton
Hello, On Wed 25 Jul 2018 at 07:01PM -0700, Jonathan Nieder wrote: > I share gregor's discomfort: I don't think we've thought this through. I too want Policy to be as correct as possible, but this bug has been open for ten years and one thing upon which there is certainly consensus is that the c

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Jonathan Nieder
Hi, Sean Whitton wrote: > On Mon 23 Jul 2018 at 01:40PM +0200, gregor herrmann wrote: >> Let me see if I got this right, and apply it to the typical pkg-perl >> package: >> >> CPAN distributions usually contain no NEWS file, and do contain a >> Changes/ChangeLog/... file which is "an upstream rel

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Sean Whitton
Hello Bill, On Mon 23 Jul 2018 at 12:29PM +0200, Bill Allombert wrote: > The issue is that the recommendation does not include a rationale, and > it seems to me the rationale is based on an implicit definition of > changelog which is not communicated either (or more precisely, it is > based on th

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-25 Thread Sean Whitton
Hello gregor, On Mon 23 Jul 2018 at 01:40PM +0200, gregor herrmann wrote: > Let me see if I got this right, and apply it to the typical pkg-perl > package: > > CPAN distributions usually contain no NEWS file, and do contain a > Changes/ChangeLog/... file which is "an upstream release notes file"

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-23 Thread gregor herrmann
On Sun, 22 Jul 2018 11:35:48 +0800, Sean Whitton wrote: > > +If an upstream release notes file is available, containing a summary > > +of changes between upstream releases intended for end users of the > > +package and often called ``NEWS``, it should be accessible as > > +``/usr/share/doc/package

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-23 Thread Bill Allombert
On Mon, Jul 23, 2018 at 07:50:59AM +0800, Sean Whitton wrote: > Hello Bill, > > On Sun 22 Jul 2018 at 07:45PM +0200, Bill Allombert wrote: > > > I have to disagree with that recommendation. It all depends on how the > > changelog is worded. Since we do not include a definition of changelog > > an

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-22 Thread Sean Whitton
Hello Bill, On Sun 22 Jul 2018 at 07:45PM +0200, Bill Allombert wrote: > I have to disagree with that recommendation. It all depends on how the > changelog is worded. Since we do not include a definition of changelog > and NEWS file, we cannot assume that one of them is useless without the > sour

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-22 Thread Bill Allombert
On Sun, Jul 22, 2018 at 11:35:48AM +0800, Sean Whitton wrote: > control: tag -1 +patch > > - I have chosen to include the recommendation not to install both the > changelog and the release notes if both are available. I've done this > using the term 'recommended', which is the weakest require

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-22 Thread Yuri D'Elia
On Sun, Jul 22 2018, Sean Whitton wrote: > The argument for including the recommendation is that a changelog is > not very useful in a binary package, except as a fallback when no > release notes are available. If you're going to dig into an upstream > changelog you will do so alongside a

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-22 Thread Andreas Henriksson
On Sun, Jul 22, 2018 at 11:35:48AM +0800, Sean Whitton wrote: > control: tag -1 +patch > > Hello all, [...] Thanks for working on this and thanks for including your rationale about the tradeoffs you had to make. While I still retain my aging view on this which isn't perfectly described by your p

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-22 Thread Andrey Rahmatullin
On Sun, Jul 22, 2018 at 11:35:48AM +0800, Sean Whitton wrote: > > diff --git a/policy/ch-docs.rst b/policy/ch-docs.rst > > index 1de221f..1503ed8 100644 > > --- a/policy/ch-docs.rst > > +++ b/policy/ch-docs.rst > > @@ -255,32 +255,48 @@ files may be installed into > > ``/usr/share/doc/package``. >

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-21 Thread David Bremner
Sean Whitton writes: >> diff --git a/policy/ch-docs.rst b/policy/ch-docs.rst >> index 1de221f..1503ed8 100644 >> --- a/policy/ch-docs.rst >> +++ b/policy/ch-docs.rst >> @@ -255,32 +255,48 @@ files may be installed into ``/usr/share/doc/package``. >> >> .. _s-changelogs: >> >> -Changelog files >

Bug#459427: Patch seeking seconds on changelog vs. NEWS handling

2018-07-21 Thread Sean Whitton
control: tag -1 +patch Hello all, David Bremner and I took a look at this bug this morning at DebCamp and I realised that I had been missing something (which Russ had actually pointed out in an older message): lots of packages already install a package's NEWS file as /usr/share/doc/foo/NEWS.gz.