summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/changes.txt315
-rw-r--r--docs/manual.qbk35
2 files changed, 172 insertions, 178 deletions
diff --git a/docs/changes.txt b/docs/changes.txt
index 5d62116..82812e9 100644
--- a/docs/changes.txt
+++ b/docs/changes.txt
@@ -1,146 +1,169 @@
-1.07.2010 - v0.9
- Major release, featuring extended and improved Unicode support, miscellaneous performance improvements, bug fixes and more.
-
- Major Unicode improvements:
- Introduced encoding support (automatic/manual encoding detection on load, manual encoding selection on save, conversion from/to UTF8, UTF16 LE/BE, UTF32 LE/BE)
- 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)
- Load/save functions now support wide streams
-
- Bug fixes:
- Fixed document corruption on failed parsing bug
- XPath string <-> number conversion improvements (increased precision, fixed crash for huge numbers)
- Improved DOCTYPE parsing: now parser recognizes all well-formed DOCTYPE declarations
- Fixed xml_attribute::as_uint() for large numbers (i.e. 2^32-1)
-
- Specification changes:
- parse() API changed to load_buffer/load_buffer_inplace/load_buffer_inplace_own; load_buffer APIs do not require zero-terminated strings.
- Renamed as_utf16 to as_wide
- Changed xml_node::offset_debug return type and xml_parse_result::offset type to ptrdiff_t
- Nodes/attributes with empty names are now printed as :anonymous
-
- Performance improvements:
- Optimized document parsing and saving
- 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
- Optimized memory consumption: sizeof(xml_node_struct) reduced from 40 bytes to 32 bytes on x86
- Optimized debug mode parsing/saving by order of magnitude
-
- Miscellaneous:
- All STL includes except <exception> in pugixml.hpp are replaced with forward declarations
-
- Compatibility:
- parse() and as_utf16 are left for compatibility (these functions are deprecated and will be removed in pugixml-1.0)
- Wildcard functions, document_order/precompute_document_order functions, format_write_bom_utf8 and parse_wnorm_attribute flags are deprecated and will be removed in version 1.0
- xpath_type_t enumeration was renamed to xpath_value_type
-
-8.11.2009 - v0.5
- Major bugfix release. Changes:
-
- XPath bugfixes:
- Fixed translate(), lang() and concat() functions (infinite loops/crashes)
- Fixed compilation of queries with empty literal strings ("")
- Fixed axis tests: they never add empty nodes/attributes to the resulting node set now
- Fixed string-value evaluation for node-set (the result excluded some text descendants)
- Fixed self:: axis (it behaved like ancestor-or-self::)
- Fixed following:: and preceding:: axes (they included descendent and ancestor nodes, respectively)
- Minor fix for namespace-uri() function (namespace declaration scope includes the parent element of namespace declaration attribute)
- Some incorrect queries are no longer parsed now (i.e. foo: *)
- Fixed text()/etc. node test parsing bug (i.e. foo[text()] failed to compile)
- Fixed root step (/) - it now selects empty node set if query is evaluated on empty node
- Fixed string to number conversion ("123 " converted to NaN, "123 .456" converted to 123.456 - now the results are 123 and NaN, respectively)
- Node set copying now preserves sorted type; leads to better performance on some queries
-
- Miscellaneous bugfixes:
- Fixed xml_node::offset_debug for PI nodes
- Added empty attribute checks to xml_node::remove_attribute
- Fixed node_pi and node_declaration copying
- Const-correctness fixes
-
- Specification changes:
- xpath_node::select_nodes() and related functions now throw exception if expression return type is not node set (instead of assertion)
- xml_node::traverse() now sets depth to -1 for both begin() and end() callbacks (was 0 at begin() and -1 at end())
- In case of non-raw node printing a newline is output after PCDATA inside nodes if the PCDATA has siblings
- UTF8 -> wchar_t conversion now considers 5-byte UTF8-like sequences as invalid
-
- New features:
- Added xpath_node_set::operator[] for index-based iteration
- Added xpath_query::return_type()
- Added getter accessors for memory-management functions
-
-17.09.2009 - v0.42
- Maintenance release. Changes:
- Fixed deallocation in case of custom allocation functions or if delete[] / free are incompatible
- XPath parser fixed for incorrect queries (i.e. incorrect XPath queries should now always fail to compile)
- Added PUGIXML_API/PUGIXML_CLASS/PUGIXML_FUNCTION configuration macros to control class/function attributes
- Const-correctness fixes for find_child_by_attribute
- Improved compatibility (miscellaneous warning fixes, fixed cstring include dependency for GCC)
- Fixed iterator begin/end and print function to work correctly for empty nodes
- Added xml_attribute::set_value overloads for different types
-
-8.02.2009 - v0.41
- Maintenance release. Changes:
-
- Fixed bug with node printing (occasionally some content was not written to output stream)
-
-18.01.2009 - v0.4
- Changes:
-
- Bugs:
- Documentation fix in samples for parse() with manual lifetime control
- Fixed document order sorting in XPath (it caused wrong order of nodes after xpath_node_set::sort and wrong results of some XPath queries)
-
- Node printing changes:
- Single quotes are no longer escaped when printing nodes
- 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.
- 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.
-
- New features:
- Added unsigned integer support for attributes (xml_attribute::as_uint, xml_attribute::operator=)
- 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
- Added support for custom memory management (see set_memory_management_functions for details)
- Implemented node/attribute copying (see xml_node::insert_copy_* and xml_node::append_copy for details)
- Added find_child_by_attribute and find_child_by_attribute_w to simplify parsing code in some cases (i.e. COLLADA files)
- 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)
- 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.
-
-31.10.2007 - v0.34
- Maintenance release. Changes:
-
- Improved compatibility (supported Digital Mars C++, MSVC 6, CodeWarrior 8, PGI C++, Comeau, supported PS3 and XBox360)
- Fixed bug with loading from text-mode iostreams
- Fixed leak when transfer_ownership is true and parsing is failing
- Fixed bug in saving (\r and \n are now escaped in attribute values)
- PUGIXML_NO_EXCEPTION flag for platforms without exception handling
- Renamed free() to destroy() - some macro conflicts were reported
-
-21.02.2007 - v0.3
- Refactored, reworked and improved version. Changes:
-
- Interface:
- Added XPath
- Added tree modification functions
- Added no STL compilation mode
- Added saving document to file
- Refactored parsing flags
- Removed xml_parser class in favor of xml_document
- Added transfer ownership parsing mode
- Modified the way xml_tree_walker works
- Iterators are now non-constant
-
- Implementation:
- Support of several compilers and platforms
- Refactored and sped up parsing core
- Improved standard compliancy
- Added XPath implementation
- Fixed several bugs
-
-6.11.2006 - v0.2
- First public release. Changes:
-
- Introduced child_value(name) and child_value_w(name)
- Fixed child_value() (for empty nodes)
- Fixed xml_parser_impl warning at W4
- parse_eol_pcdata and parse_eol_attribute flags + parse_minimal optimizations
- Optimizations of strconv_t
-
-15.07.2006 - v0.1
- First private release for testing purposes
+//[changes_last_version```
+
+[clog 1.07.2010 - version 0.9]
+
+Major release, featuring extended and improved Unicode support, miscellaneous performance improvements, bug fixes and more.
+
+* Major Unicode improvements:
+ # Introduced encoding support (automatic/manual encoding detection on load, manual encoding selection on save, conversion from/to UTF8, UTF16 LE/BE, UTF32 LE/BE)
+ # 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)
+ # Load/save functions now support wide streams
+
+* Bug fixes:
+ # Fixed document corruption on failed parsing bug
+ # XPath string <-> number conversion improvements (increased precision, fixed crash for huge numbers)
+ # Improved DOCTYPE parsing: now parser recognizes all well-formed DOCTYPE declarations
+ # Fixed xml_attribute::as_uint() for large numbers (i.e. 2^32-1)
+
+* Specification changes:
+ # parse() API changed to load_buffer/load_buffer_inplace/load_buffer_inplace_own; load_buffer APIs do not require zero-terminated strings.
+ # Renamed as_utf16 to as_wide
+ # Changed xml_node::offset_debug return type and xml_parse_result::offset type to ptrdiff_t
+ # Nodes/attributes with empty names are now printed as :anonymous
+
+* Performance improvements:
+ # Optimized document parsing and saving
+ # 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
+ # Optimized memory consumption: sizeof(xml_node_struct) reduced from 40 bytes to 32 bytes on x86
+ # Optimized debug mode parsing/saving by order of magnitude
+
+* Miscellaneous:
+ # All STL includes except <exception> in pugixml.hpp are replaced with forward declarations
+
+* Compatibility:
+ # parse() and as_utf16 are left for compatibility (these functions are deprecated and will be removed in version 1.0)
+ # Wildcard functions, document_order/precompute_document_order functions, format_write_bom_utf8 and parse_wnorm_attribute flags are deprecated and will be removed in version 1.0
+ # xpath_type_t enumeration was renamed to xpath_value_type; xpath_type_t is deprecated and will be removed in version 1.0
+
+```//]
+
+[clog 8.11.2009 - version 0.5]
+
+Major bugfix release. Changes:
+
+* XPath bugfixes:
+ # Fixed translate(), lang() and concat() functions (infinite loops/crashes)
+ # Fixed compilation of queries with empty literal strings ("")
+ # Fixed axis tests: they never add empty nodes/attributes to the resulting node set now
+ # Fixed string-value evaluation for node-set (the result excluded some text descendants)
+ # Fixed self:: axis (it behaved like ancestor-or-self::)
+ # Fixed following:: and preceding:: axes (they included descendent and ancestor nodes, respectively)
+ # Minor fix for namespace-uri() function (namespace declaration scope includes the parent element of namespace declaration attribute)
+ # Some incorrect queries are no longer parsed now (i.e. foo: *)
+ # Fixed text()/etc. node test parsing bug (i.e. foo[text()] failed to compile)
+ # Fixed root step (/) - it now selects empty node set if query is evaluated on empty node
+ # Fixed string to number conversion ("123 " converted to NaN, "123 .456" converted to 123.456 - now the results are 123 and NaN, respectively)
+ # Node set copying now preserves sorted type; leads to better performance on some queries
+
+* Miscellaneous bugfixes:
+ # Fixed xml_node::offset_debug for PI nodes
+ # Added empty attribute checks to xml_node::remove_attribute
+ # Fixed node_pi and node_declaration copying
+ # Const-correctness fixes
+
+* Specification changes:
+ # xpath_node::select_nodes() and related functions now throw exception if expression return type is not node set (instead of assertion)
+ # xml_node::traverse() now sets depth to -1 for both begin() and end() callbacks (was 0 at begin() and -1 at end())
+ # In case of non-raw node printing a newline is output after PCDATA inside nodes if the PCDATA has siblings
+ # UTF8 -> wchar_t conversion now considers 5-byte UTF8-like sequences as invalid
+
+* New features:
+ # Added xpath_node_set::operator[] for index-based iteration
+ # Added xpath_query::return_type()
+ # Added getter accessors for memory-management functions
+
+[clog 17.09.2009 - version 0.42]
+
+Maintenance release. Changes:
+
+* Bug fixes:
+ # Fixed deallocation in case of custom allocation functions or if delete[] / free are incompatible
+ # XPath parser fixed for incorrect queries (i.e. incorrect XPath queries should now always fail to compile)
+ # Const-correctness fixes for find_child_by_attribute
+ # Improved compatibility (miscellaneous warning fixes, fixed cstring include dependency for GCC)
+ # Fixed iterator begin/end and print function to work correctly for empty nodes
+
+* New features:
+ # Added PUGIXML_API/PUGIXML_CLASS/PUGIXML_FUNCTION configuration macros to control class/function attributes
+ # Added xml_attribute::set_value overloads for different types
+
+8.02.2009 - v0.41
+ Maintenance release. Changes:
+
+* Bug fixes:
+ # Fixed bug with node printing (occasionally some content was not written to output stream)
+
+[clog 18.01.2009 - version 0.4]
+
+Changes:
+
+* Bug fixes:
+ # Documentation fix in samples for parse() with manual lifetime control
+ # Fixed document order sorting in XPath (it caused wrong order of nodes after xpath_node_set::sort and wrong results of some XPath queries)
+
+* Node printing changes:
+ # Single quotes are no longer escaped when printing nodes
+ # 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.
+ # 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.
+
+* New features:
+ # Added unsigned integer support for attributes (xml_attribute::as_uint, xml_attribute::operator=)
+ # 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
+ # Added support for custom memory management (see set_memory_management_functions for details)
+ # Implemented node/attribute copying (see xml_node::insert_copy_* and xml_node::append_copy for details)
+ # Added find_child_by_attribute and find_child_by_attribute_w to simplify parsing code in some cases (i.e. COLLADA files)
+ # 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)
+ # 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.
+
+[clog 31.10.2007 - version 0.34]
+
+Maintenance release. Changes:
+
+* Bug fixes:
+ # Fixed bug with loading from text-mode iostreams
+ # Fixed leak when transfer_ownership is true and parsing is failing
+ # Fixed bug in saving (\r and \n are now escaped in attribute values)
+ # Renamed free() to destroy() - some macro conflicts were reported
+
+* New features:
+ # Improved compatibility (supported Digital Mars C++, MSVC 6, CodeWarrior 8, PGI C++, Comeau, supported PS3 and XBox360)
+ # PUGIXML_NO_EXCEPTION flag for platforms without exception handling
+
+[clog 21.02.2007 - version 0.3]
+
+Refactored, reworked and improved version. Changes:
+
+* Interface:
+ # Added XPath
+ # Added tree modification functions
+ # Added no STL compilation mode
+ # Added saving document to file
+ # Refactored parsing flags
+ # Removed xml_parser class in favor of xml_document
+ # Added transfer ownership parsing mode
+ # Modified the way xml_tree_walker works
+ # Iterators are now non-constant
+
+* Implementation:
+ # Support of several compilers and platforms
+ # Refactored and sped up parsing core
+ # Improved standard compliancy
+ # Added XPath implementation
+ # Fixed several bugs
+
+[clog 6.11.2006 - version 0.2]
+
+First public release. Changes:
+
+* Bug fixes:
+ # Fixed child_value() (for empty nodes)
+ # Fixed xml_parser_impl warning at W4
+
+* New features:
+ # Introduced child_value(name) and child_value_w(name)
+ # parse_eol_pcdata and parse_eol_attribute flags + parse_minimal optimizations
+ # Optimizations of strconv_t
+
+[clog 15.07.2006 - version 0.1]
+
+First private release for testing purposes
diff --git a/docs/manual.qbk b/docs/manual.qbk
index e46756e..d6ef174 100644
--- a/docs/manual.qbk
+++ b/docs/manual.qbk
@@ -52,38 +52,9 @@ If filing an issue is not possible due to privacy or other concerns, you can con
Only changes since version 0.5 are listed here; you can [@changes.txt view the full changelog here].
-Version 0.9:
-
-* Major Unicode improvements:
- # Introduced encoding support (automatic/manual encoding detection on load, manual encoding selection on save, conversion from/to UTF8, UTF16 LE/BE, UTF32 LE/BE)
- # 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)
- # Load/save functions now support wide streams
-
-* Bug fixes:
- # Fixed document corruption on failed parsing bug
- # XPath string <-> number conversion improvements (increased precision, fixed crash for huge numbers)
- # Improved DOCTYPE parsing: now parser recognizes all well-formed DOCTYPE declarations
- # Fixed xml_attribute::as_uint() for large numbers (i.e. 2^32-1)
-
-* Specification changes:
- # parse() API changed to load_buffer/load_buffer_inplace/load_buffer_inplace_own; load_buffer APIs do not require zero-terminated strings.
- # Renamed as_utf16 to as_wide
- # Changed xml_node::offset_debug return type and xml_parse_result::offset type to ptrdiff_t
- # Nodes/attributes with empty names are now printed as :anonymous
-
-* Performance improvements:
- # Optimized document parsing and saving
- # 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
- # Optimized memory consumption: sizeof(xml_node_struct) reduced from 40 bytes to 32 bytes on x86
- # Optimized debug mode parsing/saving by order of magnitude
-
-* Miscellaneous:
- # All STL includes except <exception> in pugixml.hpp are replaced with forward declarations
-
-* Compatibility:
- # parse() and as_utf16 are left for compatibility (these functions are deprecated and will be removed in pugixml-1.0)
- # Wildcard functions, document_order/precompute_document_order functions, format_write_bom_utf8 and parse_wnorm_attribute flags are deprecated and will be removed in version 1.0
- # xpath_type_t enumeration was renamed to xpath_value_type
+[template clog[cont] '''<bridgehead renderas="sect5">'''[cont]'''</bridgehead>''']
+[import changes.txt]
+[changes_last_version]
[endsect] [/changelog]