Debian Codegraph @

Changes

raw
1 Revision history for Perl extension XML::Grove.
2
3 Backwards incompatible changes are marked with a `*'.
4
5 Changes in Version 1.0
6
7 Version 1.0 is virtually a complete rewrite. The summary below
8 presents the changes as a bullet list, but you should probably reread
9 the POD docs because they have been updated and should be much clearer
10 than before (let me know if you don't think so!).
11
12
13 * XML::Grove REQUIRES Perl 5.005
14
15 * The class structure of XML::Grove changes somewhat.
16
17 * XML::Grove::Document now contains the document information where
18 XML::Grove itself used to hold that information.
19
20 * The class XML::Grove is now the common superclass of all classes
21 in the XML::Grove module, and XML::Grove isa Data::Grove (in
22 libxml-perl).
23
24 * Internal class XML::Grove::_Common is gone.
25
26 If you had created extensions to XML::Grove and added methods to
27 XML::Grove::_Common, you should move them to XML::Grove.
28
29 * You now access grove properties directly, i.e.
30
31 $element_name = $element->{Name};
32
33 instead of using methods to access the properties.
34
35 * XML::Grove objects all now appear to have Parent references.
36
37 * This is done using tied hashes and arrays, see Data::Grove::Tied
38 if you see any wierd problems. Use
39
40 $real_object = $node->{Raw};
41
42 to get the real object behind the tied hash.
43
44 * No More XML::Grove::Iter!!
45
46 * all scalars are now XML::Grove::Characters objects, if you store a
47 scalar value into element content it will be converted to an
48 XML::Grove::Characters object.
49
50 * visit_grove is now visit_document.
51
52 * visit_scalar is now visit_characters. The object you receive is an
53 XML::Grove::Characters object and $characters->{Data} gives you the
54 text.
55
56 * XML::Grove::Visitor is now Data::Grove::Visitor in libxml-perl
57
58 * Visitor now checks the visitor object for methods it supports and
59 silently ignores undefined methods. If the visited object has a
60 `Contents' property, Visitor will call `children_accept' or
61 `children_accept_name' if there is no defined method.
62
63 * All properties are mixed case, see XML::Grove(3) and the
64 grove builder and parser man pages for attribute names.
65
66 * FIXME check all places where Iter, visit_scalar, and delegate occur.
67
68 * XML::Parser::Grove is replaced by by using XML::Parser::PerlSAX (in
69 libxml-perl) and XML::Grove::Builder. See XML::Grove::Builder for usage.
70
71 * added more tests and a `t' directory