Time to cull the changelog file

Francois Gouget fgouget at free.fr
Mon May 26 04:21:46 CDT 2008


On Sat, 24 May 2008, Alexandre Julliard wrote:
[...]
> Actually I was thinking of simply no longer maintaining a Changelog
> file. It made sense in the days of CVS to store changeset information,
> but now with git the same information and more can be retrieved
> trivially with git-log, and the linear log format won't work so well
> once we start having multiple branches.
> 
> Objections?  Does anybody feel a strong need for a Changelog file?

Users who get Wine as a precompiled package, maybe through their 
distribution, won't be able to easily run git-log or git-whatchanged. I 
know I often check the changelog in /usr/share/doc/<packagename> when I 
have trouble with a Debian package. So I think a changelog should still 
be included in the Wine packages.

It does not have to, and probably shouldn't, list all changes made in 
the past 15 years though. I'll leave determining the best cutoff date to 
others. Also this could potentially be handled by the Wine packager 
rather than being part of the Wine sources. Finally, the individual 
commit messages may not be the easiest thing to understand for 
non-developpers either. I think this is more true of Wine than of other 
packages. That could argue for a changelog that's not just a collection 
of the commit messages. Maybe something culled from the ANNOUNCE 
messages, though these tend to be too terse, imho. Of course the trouble 
is that this would require quite a bit of work.


Anyway, these were just my 2 EuroCents.

-- 
Francois Gouget <fgouget at free.fr>              http://fgouget.free.fr/
  Good judgment comes from experience, and experience comes from bad judgment
                               -- Barry LePatner



More information about the wine-devel mailing list