From bb974f64188c6c50db939fbdbd88959d6b1acad7 Mon Sep 17 00:00:00 2001
From: PeiYong Zhang <peiyongz@apache.org>
Date: Tue, 11 Mar 2003 05:01:58 +0000
Subject: [PATCH] Message Loader related documentation update
git-svn-id: https://svn.apache.org/repos/asf/xerces/c/trunk@174848 13f79535-47bb-0310-9956-ffa450edef68
---
doc/faq-build.xml | 16 +++++++++++++---
doc/faq-distrib.xml | 5 ++++-
doc/program-others.xml | 28 ++++++++++++++++++++++++++++
3 files changed, 45 insertions(+), 4 deletions(-)
diff --git a/doc/faq-build.xml b/doc/faq-build.xml
index 1f451d8d1..ffd95398a 100644
--- a/doc/faq-build.xml
+++ b/doc/faq-build.xml
@@ -378,10 +378,20 @@ catch (const XMLException& toCatch) {
<faq title="Cannot load message domain, Xerces Panic Error">
<q>"Cannot load message domain, Xerces Panic Error"?</q>
<a>
- <p>If the parser is built with icu message loader (like IBM XML4C binaries), or message
- catalog loader, you need an environment variable, XERCESC_NLS_HOME to point to
- the directory, $XERCESCROOT/msg, where the message files reside.
+ <p>If the parser is built with icu message loader (like IBM XML4C binaries),
+ you need to make sure that the message library, (for exact name
+ see <jump href="faq-distrib.html#faq-3">FAQ: Which DLL's do I need to distribute with my application?</jump>)
+ is located in a directory which is on the library search path.
+ Or the message resource file, XercesMessages_en_US.res, is in the directory given at the call to
+ XMLPlatformUtils::Initialize(), or is located in the directory pointed to by the environment variable
+ XERCESC_NLS_HOME, or at $XERCESCROOT/msg.
</p>
+ <p>If the parser is built with message catalog loader, you need to make sure that the message
+ catalog file, XercesMessages_en_US.cat, is in the directory given at the call to XMLPlatformUtils::Initialize(),
+ or is located in the directory pointed to by the environment variable XERCESC_NLS_HOME, or
+ at $XERCESCROOT/msg.
+ </p>
+
</a>
</faq>
diff --git a/doc/faq-distrib.xml b/doc/faq-distrib.xml
index 3008dcb1d..c5e472d8c 100644
--- a/doc/faq-distrib.xml
+++ b/doc/faq-distrib.xml
@@ -150,7 +150,10 @@
libicudt*.sl for HP-UX.</li>
<li><em>The &XercesCName; Message file:</em><br></br>
- XercesMessages_en_US.res.</li>
+ XercesMessages*.dll for Windows NT/2000, or<br></br>
+ libXercesMessages*.a for AIX, or<br></br>
+ libXercesMessages*.so for Solaris/Linux, or<br></br>
+ libXercesMessages*.sl for HP-UX.</li>
</ol>
</a>
diff --git a/doc/program-others.xml b/doc/program-others.xml
index c88af184a..fe596d1de 100644
--- a/doc/program-others.xml
+++ b/doc/program-others.xml
@@ -539,6 +539,34 @@ new XERCES_CPP_NAMESPACE_QUALIFIER SAXParser();
..
</source>
+
+ <anchor name="SpecifyLocationForMessageLoader"/>
+ <s2 title="Specify location for message loader">
+
+ <p>The &XercesCName; searches for message files at the default message directory, $XERCESCROOT/msg.
+ </p>
+
+ <p>Application can specify an alternative location for the message files in their
+ very first invocation to XMLPlatformUtils::Initialize() by supplying
+ a parameter for the alternative location intended.
+ </p>
+ </s2>
+
+<source>
+
+...
+ // Initialize the parser system
+ try
+ {
+ XMLPlatformUtils::Initialize("en_US", "/usr/application_root/msg_home");
+ }
+
+ catch ()
+ {
+ }
+..
+</source>
+
<anchor name="UseSpecificScanner"/>
<s2 title="Use Specific Scanner">
--
GitLab