Re: need some advice: upstream has several changelogs
On Fri, Dec 14, 2001 at 01:50:52AM +0100, Nicolas Boullis wrote:
> I'm currently packaging a Mah-Jong game (see ITP #123146), but I have a
> problem since upstream has several changelogs...
>
> The first one is in a file called CHANGES, and contains stuff like that:
> ----------------------------------------------------------------------
> 1.2.3 2001-09-06
> Bugfix.
> Gui: fix stupid bug introduced in last release causing
> crash after about five hands.
This file would be more accurately named NEWS.
> 1.2.2 2001-09-04
> Feature enhancements.
> Graphical client: add Tileset and Tileset search path options.
> Allow display option changes to take immediate effect.
> ----------------------------------------------------------------------
>
> The second one is in a file called ChangeLog, and contains stuff like
> that:
> ----------------------------------------------------------------------
> 2001-09-06 Julian Bradfield <jcb@dcs.ed.ac.uk>
And this is correctly called ChangeLog. Check the GNU standards for some
useful guidelines regarding these files.
> The debian package should contain the upstream changelog, but I don't
> know which one to use.
You should include both.
> What I currently did is set the CHANGES file as changelog, and include
> ChangeLog without changing its name. Hence, I have to changelog files
> (with different capitalization); this might not be good.
>
> Could someone please give me some advice ?
I would recommend getting upstream to rename CHANGES to NEWS, and use
ChangeLog as the upstream changelog.
--
- mdz
Reply to: