diff --git a/doc/faq-parse.xml b/doc/faq-parse.xml index 49886ce7b05db720fa1fb4935adbd2cf061c28dd..e65edaf76d8b9bccf5bbfc89e30eeac6bc111664 100644 --- a/doc/faq-parse.xml +++ b/doc/faq-parse.xml @@ -898,19 +898,20 @@ delete parser; </a> </faq> - <faq title="Why do we have two versions of XMLString::transcode (one with memory manager and one without)?"> + <faq title="Why do we have two versions of some XMLString methods (one with memory manager and one without)?"> - <q>Why do we have two versions of XMLString::transcode (one with memory manager and one without)?</q> + <q>Why do we have two versions of some XMLString methods (one with memory manager and one without)?</q> <a> - <p>With the introdcution of the configurable memory manager, we didn't want to break users by - changing the signature of the method. Also, we did not want to provide a default memory + <p>With the introduction of the configurable memory manager, we didn't want to break users by + changing the signature of the existing methods (for example, transcode and replicate). Also, + we did not want to provide a default memory manager as it would introduce a side effect with users experiencing some strange core dumps. The latter will occur when the scope of the string allocated is beyond that of XMLPlatformUtils::Terminate (i.e. a string is allocated using the default memory manager which is deleted when XMLPlatformUtils::Terminate is called, but the allocated string is - deleted later). We plan to deprecate the transcode method with no parameters in later releases. + deleted later). We plan to deprecate the methods without a memory manager in a later release. </p> </a> diff --git a/doc/program-sax2.xml b/doc/program-sax2.xml index b5f5a11f954fd96106edb54f2a7ecb0f0396052c..6b770966ba665084e812b0519ae0fbad5739c2bc 100644 --- a/doc/program-sax2.xml +++ b/doc/program-sax2.xml @@ -114,8 +114,8 @@ MySAX2Handler::fatalError(const SAXParseException& exception) char* xmlFile = "x1.xml"; SAX2XMLReader* parser = XMLReaderFactory::createXMLReader(); - parser->setFeature(XMLUni::fgSAX2CoreValidation, true) // optional - parser->setFeature(XMLUni::fgSAX2CoreNameSpaces, true) // optional + parser->setFeature(XMLUni::fgSAX2CoreValidation, true); // optional + parser->setFeature(XMLUni::fgSAX2CoreNameSpaces, true); // optional DefaultHandler* defaultHandler = new DefaultHandler(); parser->setContentHandler(defaultHandler);