Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / libxml2 / e0854c3f8328d06177b2026e59c51ed146180023 / . / TODO
blob: 1fd2e445086d97acaac26eb554259bf9965ab367 [file] [log] [blame]
Daniel Veillard01791d51998-07-24 19:24:09 +0000[diff] [blame]1
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]2 TODO for the XML parser and stuff:
3 ==================================
Daniel Veillard01791d51998-07-24 19:24:09 +0000[diff] [blame]4
Daniel Veillard361d8452000-04-03 19:48:13 +0000[diff] [blame]5
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]6TODO:
7=====
8
Daniel Veillarde0854c32000-08-27 21:12:29 +0000[diff] [blame^]9- cleanup the mess with URI references when composing entities.
10- performances: there is still improvements needed when parsing Docbook DTD
11 a single function to optimize/avoid.
12- Moving all deprecated functions to a different module, allow to compile
13 it out.
Daniel Veillard5d211f42000-04-07 17:00:24 +0000[diff] [blame]14- DOM needs
Daniel Veillard5d211f42000-04-07 17:00:24 +0000[diff] [blame]15 int xmlPruneProp(xmlNodePtr node, xmlAtttrPtr attr);
Daniel Veillarde0854c32000-08-27 21:12:29 +0000[diff] [blame^]16- listing all attributes in a node.
Daniel Veillardbe803962000-06-28 23:40:59 +0000[diff] [blame]17- General checking of DTD validation in presence of namespaces ... hairy
18 mostly done
Daniel Veillard5d211f42000-04-07 17:00:24 +0000[diff] [blame]19- Fix DTD + namespace validity problem
20 "Not valid: root and DtD name do not match 'ROOT' and 'prefix:ROOT'"
Daniel Veillardbe803962000-06-28 23:40:59 +0000[diff] [blame]21 mostly done
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]22- Correct standalone checking/emitting (hard)
23 2.9 Standalone Document Declaration
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]24- Better checking of external parsed entities TAG 1234
25- Find way of representing PERefs in the Dtd so that %entity; can
26 be saved back.
27- Go through erratas and do the cleanup.
Daniel Veillarde0854c32000-08-27 21:12:29 +0000[diff] [blame^]28 http://www.w3.org/XML/xml-19980210-errata ... started ...
Daniel Veillard361d8452000-04-03 19:48:13 +0000[diff] [blame]29- Handle undefined namespaces in entity contents better ... at least
30 issue a warning
Daniel Veillard06047432000-04-24 11:33:38 +0000[diff] [blame]31- fix --disable-corba configure switch handling, and use XML_WITHOUT_CORBA
32 not WITHOUT_CORBA flag
Daniel Veillardf0cc7cc2000-08-26 21:40:43 +0000[diff] [blame]33- reported by Michael, update of doc node when pasting on a new document
34 There can be far more than simply the doc pointer which refers to
35 the old document, for example namespace declarations or entities
36 references can also be a nasty problem, far more than updating the
37 doc values.
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]38
39TODO:
40=====
41
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]42- Get OASIS testsuite to a more friendly result, check all the results
Daniel Veillard496a1cf2000-05-03 14:20:55 +0000[diff] [blame]43 once stable. Current state at:
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]44 http://xmlsoft.org/conf/result.html
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]45
Daniel Veillard3dd82e72000-03-20 11:48:04 +0000[diff] [blame]46- Optimization of tag strings allocation ?
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]47
48- maintain coherency of namespace when doing cut'n paste operations
49 => the functions are coded, but need testing
50
Daniel Veillard3dd82e72000-03-20 11:48:04 +0000[diff] [blame]51- function to rebuild the ID table
52- functions to rebuild the DTD hash tables (after DTD changes).
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]53
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]54
55EXTENSIONS:
56===========
Daniel Veillard3dd82e72000-03-20 11:48:04 +0000[diff] [blame]57
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]58- Tools to produce man pages from the SGML docs.
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]59- Finish XPath
60 => attributes addressing troubles
61 => defaulted attributes handling
62 => namespace axis ?
63
64- Add Xpointer recognition/API
65
66- Add Xlink recognition/API
67 => started adding an xlink.[ch] with a unified API for XML and HTML.
Daniel Veillard496a1cf2000-05-03 14:20:55 +0000[diff] [blame]68 it's crap :-(
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]69
70- Implement XSLT
71 => seems that someone volunteered ?!?
72
73- Implement XSchemas
Daniel Veillard496a1cf2000-05-03 14:20:55 +0000[diff] [blame]74 => Really need to be done <grin/>
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]75
76- O2K parsing;
77 => this is a somewhat ugly mix of HTML and XML, adding a specific
78 routine in the comment parsing code of HTML and plug the XML
79 parsing one in-there should not be too hard. Key point is to get
80 XSL to transform all this to something decent ...
81
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]82- extend the shell with:
83 - edit
84 - load/save
85 - mv (yum, yum, but it's harder because directories are ordered in
86 our case, mvup and mvdown would be required)
87
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]88- Add HTML validation using the XHTML DTD
89 - problem: do we want to keep and maintain the code for handling
90 DTD/System ID cache directly in libxml ?
91
92- Add a DTD cache prefilled with xhtml DTDs and entities and a program to
93 manage them -> like the /usr/bin/install-catalog from SGML
94 right place seems $datadir/xmldtds
Daniel Veillard361d8452000-04-03 19:48:13 +0000[diff] [blame]95 Maybe this is better left to user apps
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]96
97- Add output to XHTML in case of HTML documents.
98
Daniel Veillarde3d88ef2000-01-24 13:55:06 +0000[diff] [blame]99
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]100Done:
101=====
102
Daniel Veillarde0854c32000-08-27 21:12:29 +0000[diff] [blame^]103- DOM needs
104 xmlAttrPtr xmlNewDocProp(xmlDocPtr doc, const xmlChar *name, const xmlChar *value)
Daniel Veillard2f2bf412000-08-20 15:11:02 +0000[diff] [blame]105- problem when parsing hrefs with & with the HTML parser (IRC ac)
106- If the internal encoding is not UTF8 saving to a given encoding doesn't
107 work => fix to force UTF8 encoding ...
108 done, added documentation too
Daniel Veillard32bc74e2000-07-14 14:49:25 +0000[diff] [blame]109- Add an ASCII I/O encoder (asciiToUTF8 and UTF8Toascii)
110- Issue warning when using non-absolute namespaces URI.
111- the html parser should add <head> and <body> if they don't exist
112 started, not finished.
113 Done, the automatic closing is added and 3 testcases were inserted
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000[diff] [blame]114- Command to force the parser to stop parsing and ignore the rest of the file.
Daniel Veillard32bc74e2000-07-14 14:49:25 +0000[diff] [blame]115 xmlStopParser() should allow this, mostly untested
Daniel Veillardbe803962000-06-28 23:40:59 +0000[diff] [blame]116- support for HTML empty attributes like <hr noshade>
117- plugged iconv() in for support of a large set of encodings.
118- xmlSwitchToEncoding() rewrite done
Daniel Veillard496a1cf2000-05-03 14:20:55 +0000[diff] [blame]119- URI checkings (no fragments) rfc2396.txt
Daniel Veillard5d211f42000-04-07 17:00:24 +0000[diff] [blame]120- Added a clean mechanism for overload or added input methods:
121 xmlRegisterInputCallbacks()
Daniel Veillard361d8452000-04-03 19:48:13 +0000[diff] [blame]122- dynamically adapt the alloc entry point to use g_alloc()/g_free()
123 if the programmer wants it:
124 - use xmlMemSetup() to reset the routines used.
125- Check attribute normalization especially xmlGetProp()
126- Validity checking problems for NOTATIONS attributes
127- Validity checking problems for ENTITY ENTITIES attributes
128- Parsing of a well balanced chunk xmlParseBalancedChunkMemory()
129- URI module: validation, base, etc ... see uri.[ch]
130- turn tester into a generic program xmllint installed with libxml
Daniel Veillardec303412000-03-24 13:41:54 +0000[diff] [blame]131- extend validity checks to go through entities content instead of
132 just labelling them PCDATA
Daniel Veillard75c29212000-03-14 18:33:47 +0000[diff] [blame]133- Save Dtds using the children list instead of dumping the tables,
134 order is preserved as well as comments and PIs
135- Wrote a notice of changes requires to go from 1.x to 2.x
136- make sure that all SAX callbacks are disabled if a WF error is detected
137- checking/handling of newline normalization
138 http://localhost/www.xml.com/axml/target.html#sec-line-ends
139- correct checking of '&' '%' on entities content.
140- checking of PE/Nesting on entities declaration
141- checking/handling of xml:space
142 - checking done.
143 - handling done, not well tested
144- Language identification code, productions [33] to [38]
145 => done, the check has been added and report WFness errors
146- Conditional sections in DTDs [61] to [65]
147 => should this crap be really implemented ???
148 => Yep OASIS testsuite uses them
149- Allow parsed entities defined in the internal subset to override
150 the ones defined in the external subset (DtD customization).
151 => This mean that the entity content should be computed only at
152 use time, i.e. keep the orig string only at parse time and expand
153 only when referenced from the external subset :-(
154 Needed for complete use of most DTD from Eve Maler
155- Add regression tests for all WFC errors
156 => did some in test/WFC
157 => added OASIS testsuite routines
158 http://xmlsoft.org/conf/result.html
159
160- I18N: http://wap.trondheim.com/vaer/index.phtml is not XML and accepted
161 by the XML parser, UTF-8 should be checked when there is no "encoding"
162 declared !
163- Support for UTF-8 and UTF-16 encoding
164 => added some convertion routines provided by Martin Durst
165 patched them, got fixes from @@@
166 I plan to keep everything internally as UTF-8 (or ISO-Latin-X)
167 this is slightly more costly but more compact, and recent processors
168 efficiency is cache related. The key for good performances is keeping
169 the data set small, so will I.
170 => the new progressive reading routines call the detection code
171 is enabled, tested the ISO->UTF-8 stuff
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]172- External entities loading:
173 - allow override by client code
174 - make sure it is alled for all external entities referenced
175 Done, client code should use xmlSetExternalEntityLoader() to set
176 the default loading routine. It will be called each time an external
177 entity entity resolution is triggered.
178- maintain ID coherency when removing/changing attributes
179 The function used to deallocate attributes now check for it being an
180 ID and removes it from the table.
181- push mode parsing i.e. non-blocking state based parser
182 done, both for XML and HTML parsers. Use xmlCreatePushParserCtxt()
183 and xmlParseChunk() and html counterparts.
184 The tester program now has a --push option to select that parser
185 front-end. Douplicated tests to use both and check results are similar.
186
187- Most of XPath, still see some troubles and occasionnal memleaks.
188- an XML shell, allowing to traverse/manipulate an XML document with
189 a shell like interface, and using XPath for the anming syntax
190 - use of readline and history added when available
191 - the shell interface has been cleanly separated and moved to debugXML.c
192- HTML parser, should be fairly stable now
193- API to search the lang of an attribute
194- Collect IDs at parsing and maintain a table.
195 PBM: maintain the table coherency
196 PBM: how to detect ID types in absence of DtD !
197- Use it for XPath ID support
198- Add validity checking
199 Should be finished now !
200- Add regression tests with entity substitutions
201
202- External Parsed entities, either XML or external Subset [78] and [79]
203 parsing the xmllang DtD now works, so it should be sufficient for
204 most cases !
205
206- progressive reading. The entity support is a first step toward
Daniel Veillard260a68f1998-08-13 03:39:55 +0000[diff] [blame]207 asbtraction of an input stream. A large part of the context is still
208 located on the stack, moving to a state machine and putting everyting
209 in the parsing context should provide an adequate solution.
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]210 => Rather than progressive parsing, give more power to the SAX-like
211 interface. Currently the DOM-like representation is built but
212 => it should be possible to define that only as a set of SAX callbacks
213 and remove the tree creation from the parser code.
214 DONE
Daniel Veillard01791d51998-07-24 19:24:09 +0000[diff] [blame]215
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]216- DOM support, instead of using a proprietary in memory
217 format for the document representation, the parser should
218 call a DOM API to actually build the resulting document.
219 Then the parser becomes independent of the in-memory
220 representation of the document. Even better using RPC's
221 the parser can actually build the document in another
222 program.
223 => Work started, now the internal representation is by default
224 very near a direct DOM implementation. The DOM glue is implemented
225 as a separate module. See the GNOME gdome module.
226
Daniel Veillard01791d51998-07-24 19:24:09 +0000[diff] [blame]227- C++ support : John Ehresman <jehresma@dsg.harvard.edu>
228- Updated code to follow more recent specs, added compatibility flag
Daniel Veillard260a68f1998-08-13 03:39:55 +0000[diff] [blame]229- Better error handling, use a dedicated, overridable error
230 handling function.
231- Support for CDATA.
232- Keep track of line numbers for better error reporting.
233- Support for PI (SAX one).
Daniel Veillardad8f99d2000-01-15 14:20:03 +0000[diff] [blame]234- Support for Comments (bad, should be in ASAP, they are parsed
235 but not stored), should be configurable.
236- Improve the support of entities on save (+SAX).
Daniel Veillard01791d51998-07-24 19:24:09 +0000[diff] [blame]237