Perl HTML::Tree 5 has backwards-incompatible interface changes. Version 5.00-1 added a NEWS.Debian entry to warn about that. As the entry below shows, it is intended for developers (although it could actually make sense to warn users too that the interface is unversioned). But it also shows for simple users who have the library installed. I was in this case when libhtml-tree-perl migrated to testing and I upgraded my system. The operation was interrupted with a prompt which requested my intervention (I use apt-listchanges). I simply use Gnucash, and find this warning unnecessary. The problem is that this library doesn't have a binary package and a development package; everything is in the same package. The proportion of people with libhtml-tree-perl using the package for development must be very small, and I don't think this entry is worth the noise. On the other hand, it's not completely worthless. Do we have guidance on NEWS.Debian usage, giving advice for such situations?
-------- Original Message --------
libhtml-tree-perl (5.00-1) unstable; urgency=low [THINGS THAT MAY BREAK YOUR CODE OR TESTS] * Use weak references to avoid memory leaks See "Weak References" in HTML::Element for details. * new_from_file now dies if the file cannot be opened. $! records the specific problem. (Previously, you got a tree with a few implicit elements.) * Some methods normally returning a scalar could return the empty list in certain circumstances. This has been corrected. The affected methods are: address, deobjectify_text, detach, is_inside, & pindex. * deprecate the Version sub/method. Use the VERSION method instead. -- gregor herrmann <firstname.lastname@example.org> Fri, 15 Jun 2012 14:50:32 +0200