NEWS.Debian entries intended for developers - backwards-incompatible changes in Perl HTML::Tree (Fwd: apt-listchanges news for vinci)

[Filipus Klutiero]

Hi,
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<gregoa at debian.org>   Fri, 15 Jun 2012 14:50:32 +0200


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alioth.debian.org/pipermail/pkg-perl-maintainers/attachments/20120715/0f5127be/attachment-0001.html>