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
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
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 s
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
>
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
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
>
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
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
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``.
>
> ..
[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
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
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
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
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
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"
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
> >
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
> >
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
>
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
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
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
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``.
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
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.
24 matches
Mail list logo