Debian Codegraph @

CHANGES

raw
1
2 = Release 1.4 =
3
4 == New Features ==
5
6 * Document: New method iterator()
7 * New tools to map a document to a Java class
8
9 == Bug Fixes ==
10
11 == Breaking Changes ==
12
13 == Planned Features ==
14
15 * Pass all tests of the "XML W3C Conformance Test Suite" (and not only the
16 "standalone+valid" ones).
17 * Allow to specify a resolver for external resources (DTDs, XML Schema, etc).
18 * Better API to create and modify DTD structures
19 * Raise test coverage to the max, again (it's currently "only" 89.5% mostly due
20 to the incomplete DTD API).
21 * Extract code to parse DTDs into an independent class (currently, it's in
22 XMLParser where it doesn't really belong). That would also be a nice test
23 case for how to extend the standard XML parser.
24 * Create an API to verify the structure of a document or a subtree against
25 a DTD or using custom code.
26
27 = Release 1.3 =
28
29 == New Features ==
30
31 * Element: New methods to set and remove attributes
32 * Copying of nodes (like clone() but without a checked exception)
33 * Support for namespaces
34 * Text: New methods getTrimmedText() and getNormalizedText()
35 * Token: New method getPrefixWhiteSpace()
36 * XMLParser: New method `static parse(File)`
37 * XMLWriter can now format (a.k.a pretty print) the document on the fly
38
39 == Bug Fixes ==
40
41 == Breaking Changes ==
42
43 * Attribute instances can now store the whitespace before the name
44 and around the equals sign
45 * XMLTokenizer.Type.ELEMENT_WHITESPACE is now DTD_WHITESPACE
46 * Attribute.getValue() and setValue() now work on the attribute value
47 instead of the XML output. Attribute.getAttributeValue()
48 * Static helper Attribute.toXML(name,value,quoteChar) has been deleted.
49
50 = Release 1.2 =
51
52 == New Features ==
53
54 * Support for DTDs (reading and writing; there is no verifier, yet).
55 * Sorted tests into different files to make it easier to find them again
56 * Added a couple of helper methods to XMLUtils to check if a node is
57 a text, an element or an attribute.
58 * To allow to extend Element and Attribute in custom classes,
59 setType() is now protected.
60 * New method: Parent.clearNodes() to clear all child nodes
61 * New method: Element.childIndexOf() to get the index of a child element
62 * You can now chose to parse entities, resolve them or treat them as
63 plain text.
64 * There is a class which can expand all HTML entities (HTML 2.0 - 4.0 and XHTML).
65 * Nodes which contain text now offer getText() and setText().
66 * ProcessingInstruction is now modeled more closely after the XML spec. It
67 has a target and an optional text.
68 * Moved code to handle the XML declaration into a new class
69 XMLDeclaration
70 * New class Location which can figure out the line and column of a node
71 * New class XMLWriter which keeps track of the node that is currently being
72 written. This is used in Location to find the position of a node in the
73 resulting XML document or partial tree.
74 * Improved error messages to show the best location info possible. In many
75 cases, the information in XMLParseException is good enough to use it in
76 an online editor.
77 * DecentXML can now parse simple DTDs. Most of the information is ignored and
78 just stuffed into lists of nodes, though.
79 * Switched to JUnit 4.4 and maven-javadoc-plugin 2.5.
80 * DecentXML passes all tests of the "XML W3C Conformance Test Suite"
81 (http://www.w3.org/XML/Test/xmlconf-20031210.html) which are marked as
82 "valid" and "standalone" (i.e. no external references).
83 It probably also passes all the other "valid" tests but since they
84 refer to external DTD files (which DecentXML doesn't currently load),
85 running them would be futile.
86 * Improved error messages. Many of them now contain a piece of the XML
87 where the error occurred to make it easier to locate this spot without
88 an editor which shows line and column numbers.
89
90 == Bug fixes ==
91
92 * Element.clearChildNodes() now only deletes elements; it used to
93 delete all nodes.
94
95 == Breaking Changes ==
96
97 * Removed XMLParser.escapeXML(). Use XMLUtils.escapeXML() instead.
98 * Extracted Token into a top level class
99 * Deleted XMLTokenizer.isXMLIdentifier() and replaced it with several
100 helper methods: XMLTokenizer.isNameChar(), XMLTokenizer.isNameStartChar()
101 and XMLTokenizer.parseName()
102
103 == Deprecations ==
104
105 * Element.getNodePath() renamed to Element.getChildPath().
106 getNodePath() is now deprecated.
107 * Element.clearChildNodes() is deprecated, use Element.clearChildren() instead
108
109 = Release 1.1 =
110
111 == New Features ==
112
113 * Added copyright notice
114 * Added documentation
115 * Support to manipulate the XML declaration in the document
116 * Added Eclipse project files
117 * There is an unescapeXML() method in XMLUtils.
118 * Code in BasicNode is better protected against NPEs
119 * A lot of private methods have been made public or at
120 least protected to allow better reuse.
121 * Added more methods to Document to manipulate nodes.
122 * Added parent/child relations
123 * Elements can be asked for their path in the document and
124 you can search elements by path
125 * Code cleanup
126
127 == Breaking Changes ==
128
129 * Element.getChild() was renamed to Element.getNode() to make the API
130 naming more consistent. A "node" is something derived from Node,
131 while a child is always an instance of Element.
132 * The text for the type PROCESSING_INSTRUCTION has changed from
133 "PI" to "PROCESSING_INSTRUCTION".
134 * If a token has no type, toString() will now contain "null" instead
135 of "***".
136 * XMLTokenizer.Token.typeToString() was deleted. Use Token.getType().toString()
137 if you must.
138
139 == Deprecations ==
140
141 * XMLParser.escapeXML() has moved to XMLUtils.escapeXML()
142
143 = Release 1.0 =
144
145 Initial release.