From e571ff926d9736f48bb37948e29db90e7c6e68d5 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Tue, 9 Feb 2010 22:05:54 +0200 Subject: Cosmetic changes --- NEWS | 57 +++++++++++++++++++++++++++++---------------------------- 1 file changed, 29 insertions(+), 28 deletions(-) (limited to 'NEWS') diff --git a/NEWS b/NEWS index 9e7b878..7cad774 100644 --- a/NEWS +++ b/NEWS @@ -3,21 +3,22 @@ Version 3.3.0 * New option, --char-encoding, allows to specify the character encoding that should be used in the generated code. Valid values for the 'char' character type are 'utf8' (default), 'iso8859-1' (new), 'lcp' (Xerces-C++ - local code page), and 'custom' (allows to support custom encodings). Note - that if you use a non-default character encoding and include some libxsd - headers (e.g., xsd/cxx/xml/string.hxx) directly, then you will need to - fist include the correct xsd/cxx/xml/char-.hxx header, where - is iso8859-1, lcp, etc. This mechanism replaces the XSD_USE_LCP macro. + local code page), and 'custom' (provides support for custom encodings). + Note that if you use a non-default character encoding and include some + libxsd headers (e.g., xsd/cxx/xml/string.hxx) directly, then you will + need to fist include the correct xsd/cxx/xml/char-.hxx header, + where is iso8859-1, lcp, etc. This mechanism replaces the + XSD_USE_LCP macro. For the wchar_t character type the only valid value for this option is 'auto' and the encoding is automatically selected between UTF-16 and UTF-32, depending on the wchar_t type size. - * When the XSD compiler is built with Xerces-C++ 3.1.0 or later, enable - handling of multiple imports for the same namespace. Before all - subsequent imports for a namespace were ignored which caused errors + * When the XSD compiler is built with Xerces-C++ 3.1.0 or later, the + handling of multiple imports for the same namespace is enabled. Before, + all subsequent imports for a namespace were ignored which caused errors in some schemas. Note that if your application has XML Schema validation - enabled then you will also need to build it with Xerces-C++ 3.1.0 or + enabled, then you will also need to build it with Xerces-C++ 3.1.0 or later to take advantage of this feature. * Automatic mapping for the urn-style XML namespaces. The last component @@ -27,46 +28,46 @@ Version 3.3.0 component issuing the warning. F - compiler frontend, D - compiler driver, P - C++/Parser mapping, T - C++/Tree mapping. - * Strings used to match regular expression supplied with the + * Strings used to match regular expressions supplied with the --namespace-regex and --anonymous-regex options now include the file component for the schema being compiled. C++/Tree - * New option, --generate-element-type, triggers generation of types + * New option, --generate-element-type, triggers the generation of types instead of parsing/serialization functions for root elements. This is primarily useful to distinguish object models with the same root - type but with different root elements. For more information refer + type but with different root elements. For more information, refer to the messaging example and Section 2.9.1, "Element Types" in the - C++/Tree Mapping User Manual. To support customization of the + C++/Tree Mapping User Manual. To support the customization of the element type naming the --element-type-regex option has been added. See the NAMING CONVENTION section in the compiler command line manual (man pages) for details. - * New option, --generate-element-map, triggers generation of a root + * New option, --generate-element-map, triggers the generation of a root element map. The element map allows uniform parsing and serialization of multiple root elements. This option can only be used together with - --generate-element-type. For more information refer to the messaging + --generate-element-type. For more information, refer to the messaging example and Section 2.9.2, "Element Map" in the C++/Tree Mapping User Manual. - * Prior to this version when the --generate-polymorphic option is + * Prior to this version, if the --generate-polymorphic option is specified the compiler treats all types as potentially polymorphic. Now by default only type hierarchies used in substitution groups and those explicitly declared polymorphic with the new --polymorphic-type option are treated as polymorphic. This results in smaller and faster generated code. If you would like to continue using the old behavior, - you will need to specify --polymorphic-type-all. For more information + you will need to specify --polymorphic-type-all. For more information, on this change see Section 2.11, "Mapping for xsi:type and Substitution Groups" in the C++/Tree Mapping User Manual. - * New option, --generate-detach, triggers generation of detach functions - for required elements and attributes. For optional and sequence - cardinalities the detach functions are now provided by the respective - containers even without this option. These functions, for example, - allow one to move sub-trees in the object model either within the - same tree or between different trees without copying. For more - information refer to Section 2.8 "Mapping for Local Elements and + * New option, --generate-detach, triggers the generation of detach + functions for required elements and attributes. For optional and + sequence cardinalities the detach functions are now provided by the + respective containers even without this option. These functions, for + example, allow one to move sub-trees in the object model either within + the same tree or between different trees without copying. For more + information, refer to Section 2.8 "Mapping for Local Elements and Attributes" in the C++/Tree Mapping User Manual. * New option, --export-xml-schema, causes the compiler to export/import @@ -83,7 +84,7 @@ Version 3.3.0 * New example, custom/mixed, shows how to use type customization to parse and serialize mixed content. - * The streaming example has been extended to shows how to perform stream- + * The streaming example has been extended to show how to perform stream- oriented, partially in-memory XML processing using the C++/Tree mapping. With the partially in-memory parsing and serialization only a part of the object model is in memory at any given time. With this approach one @@ -92,9 +93,9 @@ Version 3.3.0 * New default/fixed value initialization code. Now the default/fixed values are parsed by the XSD compiler at compile time instead of the standard - parsing code at runtime. This will allow compiling schemas that use the - default/fixed values without support for XML parsing (--suppress-parsing - option). + parsing code at runtime. This will allow the compilation of schemas that + use the default/fixed values without support for XML parsing + (--suppress-parsing option). * Empty XML Schema enumeration values are now mapped to the 'empty' C++ enumerator name instead of 'cxx'. -- cgit v1.1