diff --git a/doc/faq-parse.xml b/doc/faq-parse.xml index 11bea3bc35f86a003a3212eecd1eacbbc4520760..49886ce7b05db720fa1fb4935adbd2cf061c28dd 100644 --- a/doc/faq-parse.xml +++ b/doc/faq-parse.xml @@ -897,5 +897,23 @@ delete parser; </a> </faq> + + <faq title="Why do we have two versions of XMLString::transcode (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> + + <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 + 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. + </p> + + </a> + </faq> </faqs>