Bug#824841: libgtk-3-0: Properly include upstream changelog

[Ximin Luo]

Michael Biebl:
> Am 20.05.2016 um 12:15 schrieb Ximin Luo:
>> Package: libgtk-3-0
>> Version: 3.20.4-1
>> Severity: important
>>
>> Dear Maintainer,
>>
>> Whilst investigating a bug involving GTK themes, I found that the contents of
>> the upstream bug is useless:
>>
>> $ zcat /usr/share/doc/libgtk-3-0/changelog.gz 
>> A git checkout and git-log is required to generate this file
>>
>> Please fix this - if necessary by generating the changelog from git and
>> repacking the Debian "orig" tarball to include this generated version.
>>
>> Otherwise it makes bug tracking much harder.
> 
> All bugs are mentioned in the NEWS file.
> For a complete and more detailed list, a git checkout is much, much
> better anyway.
> 

The NEWS file contains a list of bugs that have just been fixed, but doesn't contain details of major changes that might have resulted in new bugs. Obviously the latter is what I'm interested in - I wouldn't be trying to read about bugs that were just fixed, since I hopefully wouldn't be experiencing them in the first place.

Where is the upstream git? It would be helpful to include the address of this repository in changelog.gz, as well as the actual commands I need to run (including its dependencies) to generate it. Saving people time really helps to avoid user frustration, especially if upstream is prone to making backward-incompatible changes that break everything.

X

-- 
GPG: ed25519/56034877E1F87C35
GPG: rsa4096/1318EFAC5FBBDBCE
git://github.com/infinity0/pubkeys.git