From f9a2dec792d9a52e1b9004793cfca9b0a463049a Mon Sep 17 00:00:00 2001 From: "arseny.kapoulkine" Date: Sun, 11 Jul 2010 16:27:23 +0000 Subject: docs: Added generated HTML documentation git-svn-id: http://pugixml.googlecode.com/svn/trunk@596 99668b35-9821-0410-8761-19e4c4f06640 --- docs/manual/changes.html | 574 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 574 insertions(+) create mode 100644 docs/manual/changes.html (limited to 'docs/manual/changes.html') diff --git a/docs/manual/changes.html b/docs/manual/changes.html new file mode 100644 index 0000000..48e8325 --- /dev/null +++ b/docs/manual/changes.html @@ -0,0 +1,574 @@ + + + +Changelog + + + + + + + + + + + +
pugixml 0.9 manual | + Overview | + Installation | + Document: + Object model · Loading · Accessing · Modifying · Saving | + XPath | + API Reference | + Table of Contents +
+PrevUpHomeNext +
+
+
+

+ Changelog +

+
+ + 1.07.2010 - version + 0.9 +
+

+ Major release, featuring extended and improved Unicode support, miscellaneous + performance improvements, bug fixes and more. +

+
    +
  • + Major Unicode improvements: +
      +
    1. + Introduced encoding support (automatic/manual encoding detection + on load, manual encoding selection on save, conversion from/to UTF8, + UTF16 LE/BE, UTF32 LE/BE) +
      2. +
    2. + Introduced wchar_t mode (you can set PUGIXML_WCHAR_MODE define to + switch pugixml internal encoding from UTF8 to wchar_t; all functions + are switched to their Unicode variants) +
      3. +
    3. + Load/save functions now support wide streams +
      4. +
    +
    • +
  • + Bug fixes: +
      +
    1. + Fixed document corruption on failed parsing bug +
      2. +
    2. + XPath string <-> number conversion improvements (increased + precision, fixed crash for huge numbers) +
      3. +
    3. + Improved DOCTYPE parsing: now parser recognizes all well-formed DOCTYPE + declarations +
      4. +
    4. + Fixed xml_attribute::as_uint() for large numbers (i.e. 2^32-1) +
      5. +
    5. + Fixed xml_node::first_element_by_path for path components that are + prefixes of node names, but are not exactly equal to them. +
      6. +
    +
    • +
  • + Specification changes: +
      +
    1. + parse() API changed to load_buffer/load_buffer_inplace/load_buffer_inplace_own; + load_buffer APIs do not require zero-terminated strings. +
      2. +
    2. + Renamed as_utf16 to as_wide +
      3. +
    3. + Changed xml_node::offset_debug return type and xml_parse_result::offset + type to ptrdiff_t +
      4. +
    4. + Nodes/attributes with empty names are now printed as :anonymous +
      5. +
    +
    • +
  • + Performance improvements: +
      +
    1. + Optimized document parsing and saving +
      2. +
    2. + Changed internal memory management: internal allocator is used for + both metadata and name/value data; allocated pages are deleted if + all allocations from them are deleted +
      3. +
    3. + Optimized memory consumption: sizeof(xml_node_struct) reduced from + 40 bytes to 32 bytes on x86 +
      4. +
    4. + Optimized debug mode parsing/saving by order of magnitude +
      5. +
    +
    • +
  • + Miscellaneous: +
      +
    1. + All STL includes except <exception> in pugixml.hpp are replaced + with forward declarations +
      2. +
    2. + xml_node::remove_child and xml_node::remove_attribute now return + the operation result +
      3. +
    +
    • +
  • + Compatibility: +
      +
    1. + parse() and as_utf16 are left for compatibility (these functions + are deprecated and will be removed in version 1.0) +
      2. +
    2. + Wildcard functions, document_order/precompute_document_order functions, + all_elements_by_name function and format_write_bom_utf8 flag are + deprecated and will be removed in version 1.0 +
      3. +
    3. + xpath_type_t enumeration was renamed to xpath_value_type; xpath_type_t + is deprecated and will be removed in version 1.0 +
      4. +
    +
    • +
+
+ + 8.11.2009 - version + 0.5 +
+

+ Major bugfix release. Changes: +

+
    +
  • + XPath bugfixes: +
      +
    1. + Fixed translate(), lang() and concat() functions (infinite loops/crashes) +
      2. +
    2. + Fixed compilation of queries with empty literal strings ("") +
      3. +
    3. + Fixed axis tests: they never add empty nodes/attributes to the resulting + node set now +
      4. +
    4. + Fixed string-value evaluation for node-set (the result excluded some + text descendants) +
      5. +
    5. + Fixed self:: axis (it behaved like ancestor-or-self::) +
      6. +
    6. + Fixed following:: and preceding:: axes (they included descendent + and ancestor nodes, respectively) +
      7. +
    7. + Minor fix for namespace-uri() function (namespace declaration scope + includes the parent element of namespace declaration attribute) +
      8. +
    8. + Some incorrect queries are no longer parsed now (i.e. foo: *) +
      9. +
    9. + Fixed text()/etc. node test parsing bug (i.e. foo[text()] failed + to compile) +
      10. +
    10. + Fixed root step (/) - it now selects empty node set if query is evaluated + on empty node +
      11. +
    11. + Fixed string to number conversion ("123 " converted to + NaN, "123 .456" converted to 123.456 - now the results + are 123 and NaN, respectively) +
      12. +
    12. + Node set copying now preserves sorted type; leads to better performance + on some queries +
      13. +
    +
    • +
  • + Miscellaneous bugfixes: +
      +
    1. + Fixed xml_node::offset_debug for PI nodes +
      2. +
    2. + Added empty attribute checks to xml_node::remove_attribute +
      3. +
    3. + Fixed node_pi and node_declaration copying +
      4. +
    4. + Const-correctness fixes +
      5. +
    +
    • +
  • + Specification changes: +
      +
    1. + xpath_node::select_nodes() and related functions now throw exception + if expression return type is not node set (instead of assertion) +
      2. +
    2. + xml_node::traverse() now sets depth to -1 for both begin() and end() + callbacks (was 0 at begin() and -1 at end()) +
      3. +
    3. + In case of non-raw node printing a newline is output after PCDATA + inside nodes if the PCDATA has siblings +
      4. +
    4. + UTF8 -> wchar_t conversion now considers 5-byte UTF8-like sequences + as invalid +
      5. +
    +
    • +
  • + New features: +
      +
    1. + Added xpath_node_set::operator[] for index-based iteration +
      2. +
    2. + Added xpath_query::return_type() +
      3. +
    3. + Added getter accessors for memory-management functions +
      4. +
    +
    • +
+
+ + 17.09.2009 - version + 0.42 +
+

+ Maintenance release. Changes: +

+
    +
  • + Bug fixes: +
      +
    1. + Fixed deallocation in case of custom allocation functions or if delete[] + / free are incompatible +
      2. +
    2. + XPath parser fixed for incorrect queries (i.e. incorrect XPath queries + should now always fail to compile) +
      3. +
    3. + Const-correctness fixes for find_child_by_attribute +
      4. +
    4. + Improved compatibility (miscellaneous warning fixes, fixed cstring + include dependency for GCC) +
      5. +
    5. + Fixed iterator begin/end and print function to work correctly for + empty nodes +
      6. +
    +
    • +
  • + New features: +
      +
    1. + Added PUGIXML_API/PUGIXML_CLASS/PUGIXML_FUNCTION configuration macros + to control class/function attributes +
      2. +
    2. + Added xml_attribute::set_value overloads for different types +
      3. +
    +
    • +
+
+ + 8.02.2009 - version + 0.41 +
+

+ Maintenance release. Changes: +

+
  • + Bug fixes: +
    1. + Fixed bug with node printing (occasionally some content was not written + to output stream) +
    +
+
+ + 18.01.2009 - version + 0.4 +
+

+ Changes: +

+
    +
  • + Bug fixes: +
      +
    1. + Documentation fix in samples for parse() with manual lifetime control +
      2. +
    2. + Fixed document order sorting in XPath (it caused wrong order of nodes + after xpath_node_set::sort and wrong results of some XPath queries) +
      3. +
    +
    • +
  • + Node printing changes: +
      +
    1. + Single quotes are no longer escaped when printing nodes +
      2. +
    2. + Symbols in second half of ASCII table are no longer escaped when + printing nodes; because of this, format_utf8 flag is deleted as it's + no longer needed and format_write_bom is renamed to format_write_bom_utf8. +
      3. +
    3. + Reworked node printing - now it works via xml_writer interface; implementations + for FILE* and std::ostream are available. As a side-effect, xml_document::save_file + now works without STL. +
      4. +
    +
    • +
  • + New features: +
      +
    1. + Added unsigned integer support for attributes (xml_attribute::as_uint, + xml_attribute::operator=) +
      2. +
    2. + Now document declaration (<?xml ...?>) is parsed as node with + type node_declaration when parse_declaration flag is specified (access + to encoding/version is performed as if they were attributes, i.e. + doc.child("xml").attribute("version").as_float()); + corresponding flags for node printing were also added +
      3. +
    3. + Added support for custom memory management (see set_memory_management_functions + for details) +
      4. +
    4. + Implemented node/attribute copying (see xml_node::insert_copy_* and + xml_node::append_copy for details) +
      5. +
    5. + Added find_child_by_attribute and find_child_by_attribute_w to simplify + parsing code in some cases (i.e. COLLADA files) +
      6. +
    6. + Added file offset information querying for debugging purposes (now + you're able to determine exact location of any xml_node in parsed + file, see xml_node::offset_debug for details) +
      7. +
    7. + Improved error handling for parsing - now load(), load_file() and + parse() return xml_parse_result, which contains error code and last + parsed offset; this does not break old interface as xml_parse_result + can be implicitly casted to bool. +
      8. +
    +
    • +
+
+ + 31.10.2007 - version + 0.34 +
+

+ Maintenance release. Changes: +

+
    +
  • + Bug fixes: +
      +
    1. + Fixed bug with loading from text-mode iostreams +
      2. +
    2. + Fixed leak when transfer_ownership is true and parsing is failing +
      3. +
    3. + Fixed bug in saving (\r and \n are now escaped in attribute values) +
      4. +
    4. + Renamed free() to destroy() - some macro conflicts were reported +
      5. +
    +
    • +
  • + New features: +
      +
    1. + Improved compatibility (supported Digital Mars C++, MSVC 6, CodeWarrior + 8, PGI C++, Comeau, supported PS3 and XBox360) +
      2. +
    2. + PUGIXML_NO_EXCEPTION flag for platforms without exception handling +
      3. +
    +
    • +
+
+ + 21.02.2007 - version + 0.3 +
+

+ Refactored, reworked and improved version. Changes: +

+
    +
  • + Interface: +
      +
    1. + Added XPath +
      2. +
    2. + Added tree modification functions +
      3. +
    3. + Added no STL compilation mode +
      4. +
    4. + Added saving document to file +
      5. +
    5. + Refactored parsing flags +
      6. +
    6. + Removed xml_parser class in favor of xml_document +
      7. +
    7. + Added transfer ownership parsing mode +
      8. +
    8. + Modified the way xml_tree_walker works +
      9. +
    9. + Iterators are now non-constant +
      10. +
    +
    • +
  • + Implementation: +
      +
    1. + Support of several compilers and platforms +
      2. +
    2. + Refactored and sped up parsing core +
      3. +
    3. + Improved standard compliancy +
      4. +
    4. + Added XPath implementation +
      5. +
    5. + Fixed several bugs +
      6. +
    +
    • +
+
+ + 6.11.2006 - version + 0.2 +
+

+ First public release. Changes: +

+
    +
  • + Bug fixes: +
      +
    1. + Fixed child_value() (for empty nodes) +
      2. +
    2. + Fixed xml_parser_impl warning at W4 +
      3. +
    +
    • +
  • + New features: +
      +
    1. + Introduced child_value(name) and child_value_w(name) +
      2. +
    2. + parse_eol_pcdata and parse_eol_attribute flags + parse_minimal optimizations +
      3. +
    3. + Optimizations of strconv_t +
      4. +
    +
    • +
+
+ + 15.07.2006 - version + 0.1 +
+

+ First private release for testing purposes +

+
+ + + +
Copyright © 2010 Arseny Kapoulkine

+ Distributed under the MIT License +

+
+
+ + + +
pugixml 0.9 manual | + Overview | + Installation | + Document: + Object model · Loading · Accessing · Modifying · Saving | + XPath | + API Reference | + Table of Contents +
+PrevUpHomeNext +
+ + -- cgit v1.2.3