Hi
http://community.haskell.org/~ndm/darcs/hlint/CHANGES.txt
That will now be updated for future HLint releases.
Thanks, Neil
On Thu, Aug 6, 2009 at 3:49 PM, Joachim
Breitner
Hi,
Am Donnerstag, den 06.08.2009, 15:39 +0100 schrieb Neil Mitchell:
So please, package authors, put Changes files in your packages and keep the current for now.
The problem is that this is the kind of dull administration stuff that isn't coding in Haskell, so tends to get neglected. If I know there is a user demand for a changelog I'm happy to provide one, but I don't want to waste time on something that isn't useful. For people who have a near zero-upgrade cost (anyone who is using Cabal) I'd suggest they upgrade to all of my packages immediately. For this change, I'd say it probably isn't worth rolling a new debian binary unless it's particularly easy.
I will start a changelog in hlint - and for some of my projects (tagsoup) I do include a changelog in the user manual.
thanks, a changelog in the manual is at least a start. But the point I’d like to make is that even if everyone provides a changelog somewhere, if you need to keep track of four dozen packages[1], finding out where that is on a per-package base is quite some hassle. And even ordinary users are curious about the improvements that were made between two releases!
If the changelog had a properly specified format and location, cabal upgrade could, if the user wants it, tell him all the downloaded changes. This really helps him to keep up-to-date. It is also a good channel for the authors to talk to his users („see this nice module I added to the package“, „some parts of the API are deprecated now, please move to this part“). Last but not least having documented changes is QA measure that the Haskell platform in the wider sense deserves.
Greetings, Joachim
-- Joachim "nomeata" Breitner mail: mail@joachim-breitner.de | ICQ# 74513189 | GPG-Key: 4743206C JID: nomeata@joachim-breitner.de | http://www.joachim-breitner.de/ Debian Developer: nomeata@debian.org
_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe