Bug#459427: changelog vs. NEWS handling

[Adrian Bunk <bunk@debian.org>]

On Sat, Mar 10, 2018 at 11:03:05PM +0200, Adrian Bunk wrote:
>...
> > > I think
> > > the most valuable starting point would to be to standardize on
> > > /usr/share/doc/package/NEWS.gz for the human-readable summary and
> > > explicitly say to never install that as
> > > /usr/share/doc/package/changelog.gz.  
> 
> On the contents of the proposal I agree with Gregor that I do not 
> consider it a good idea to install a different file to changelog.gz
> than has been in Debian for the past quarter century.
> 
> That's my personal opinion on the contents, others might differ on that.
> 
> Regarding the process, something like that should be decided before 
> installation of the human-readable summary is done by default by 
> debhelper.
> 
> A complete mess would be something like:
> - dh compat >= 12 installs NEWS to /usr/share/doc/package/NEWS.gz
> - dh compat >= 13 no longer installs ChangeLog to /usr/share/doc/package/changelog.gz
> - dh compat >= 14 installs NEWS to /usr/share/doc/package/changelog.gz
>...

Sorry, I messed up and the quoted suggestion above is actually
a different suggestion, where the mess would be like
- dh compat >= 12 installs NEWS to /usr/share/doc/package/NEWS.gz
- dh compat >= 13 no longer installs ChangeLog to /usr/share/doc/package/changelog.gz
- dh compat >= 13 or when policy changes, some packages install a 
  ChangeLog that was previously in /usr/share/doc/package/changelog.gz
  as /usr/share/doc/package/NEWS.gz

cu
Adrian

-- 

       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed