| 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 |