| <?xml version="1.0" ?> |
| <!DOCTYPE faqs SYSTEM "sbk:/style/dtd/faqs.dtd"> |
| |
| <faqs title="Distributing &XercesCName;"> |
| |
| <faq title="What platforms / compilers are being used to build the binary distribution kits?"> |
| |
| <q>What platforms / compilers are being used to build the binary distribution kits?</q> |
| |
| <a> |
| |
| <p>&XercesCProjectName; binaries has been built on the following platforms with |
| these compilers</p> |
| |
| <table> |
| <tr> |
| <th><em>Operating System</em></th> |
| <th><em>Compiler</em></th> |
| </tr> |
| <tr> |
| <th><em>32-bit binary</em></th> |
| <td></td> |
| </tr> |
| <tr> |
| <td>Windows NT 4.0 SP5</td> |
| <td>MSVC 6.0 SP3</td> |
| </tr> |
| <tr> |
| <td>Redhat Linux 7.2</td> |
| <td>g++ 3.1</td> |
| </tr> |
| <tr> |
| <td>AIX 5.1</td> |
| <td>xlC_r 5.0.2</td> |
| </tr> |
| <tr> |
| <td>Solaris 2.7</td> |
| <td>Forte C++ Version 6 Update 2</td> |
| </tr> |
| <tr> |
| <td>HP-UX 11.0</td> |
| <td>aCC A.03.13 with pthreads</td> |
| </tr> |
| <tr> |
| <th><em>64-bit binary</em></th> |
| <td></td> |
| </tr> |
| <tr> |
| <td>Windows XP, IA64</td> |
| <td>Intel C++ Compiler v6, ecl</td> |
| </tr> |
| <tr> |
| <td>Redhat Linux 7.2, IA64</td> |
| <td>Intel C++ Compiler v6, ecc</td> |
| </tr> |
| <tr> |
| <td>AIX 5.1</td> |
| <td>xlC_r 5.0.2</td> |
| </tr> |
| <tr> |
| <td>Solaris 2.7</td> |
| <td>Forte C++ Version 6 Update 2</td> |
| </tr> |
| <tr> |
| <td>HP-UX 11.0</td> |
| <td>aCC A.03.13 with pthreads</td> |
| </tr> |
| </table> |
| |
| </a> |
| </faq> |
| |
| <faq title="What are the differences between Xerces-C and XML4C?"> |
| <q>What are the differences between Xerces-C and XML4C?</q> |
| <a> |
| |
| <p>Xerces-C has intrinsic support for ASCII, UTF-8, UTF-16 |
| (Big/Small Endian), UCS4 (Big/Small Endian), EBCDIC code pages IBM037 and |
| IBM1140 encodings, ISO-8859-1 (aka Latin1) and Windows-1252. This means that it can parse |
| input XML files in these above mentioned encodings.</p> |
| |
| <p>However, if you wish to parse XML files in any other |
| encodings, say in Shift-JIS, Big5 etc., then you cannot |
| use Xerces-C. XML4C addresses this need. It combines Xerces-C |
| and <jump |
| href="http://oss.software.ibm.com/icu/"> |
| International Components for Unicode (ICU)</jump> and |
| provides support for over 100 different encodings.</p> |
| |
| <p>ICU is also an open source project but is licensed |
| under the <jump |
| href="http://www.x.org/terms.htm"> |
| X License</jump>. XML4C is published by IBM and |
| can be downloaded from their <jump |
| href="http://www.alphaworks.ibm.com/tech/xml4c">Alphaworks</jump> |
| site. The license to use XML4C is simply to comply with |
| the Apache license (because of Xerces-C) and X License (because of ICU).</p> |
| |
| <p>XML4C binaries are published for the same set of platforms / compilers |
| as Xerces-C++, see <jump href="faq-distrib.html#faq-1">FAQ: |
| What platforms / compilers are being used to build the binary distribution kits?</jump> |
| and the documentation in |
| <jump href="http://www.alphaworks.ibm.com/tech/xml4c">Alphaworks</jump>.</p> |
| |
| </a> |
| </faq> |
| |
| <faq title="Which DLL's do I need to distribute with my application?"> |
| <q>Which DLL's do I need to distribute with my application?</q> |
| <a> |
| <p>As mentioned above, there are two configurations in |
| which Xerces-C binaries are shipped. One is from the <jump |
| href="http://xml.apache.org/xerces-c/index.html">Apache |
| site</jump>, while the other is from IBM |
| published at <jump |
| href="http://www.alphaworks.ibm.com/tech/xml4c">IBM's |
| Alphaworks Site</jump>.</p> |
| |
| <p>If you are using the binaries from the <jump |
| href="http://xml.apache.org/dist/xerces-c/">Apache download |
| site</jump> site, then you only need to distribute |
| <em>one</em> file:<br></br> |
| |
| &XercesCWindowsDLL;.dll for Windows NT/2000, or<br/> |
| &XercesCUnixLib;&XercesCUnixSoName;.so for AIX, or<br/> |
| &XercesCUnixLib;.so.&XercesCUnixSoName; for Solaris/Linux, or<br/> |
| &XercesCUnixLib;.sl.&XercesCUnixSoName; for HP-UX.</p> |
| |
| <p>However, if you are using the XML4C binaries then in |
| <em>addition</em> to the library file |
| mentioned above, you also need to ship:</p> |
| |
| <ol> |
| <li><em>ICU shared library file</em>:<br></br> |
| icuuc.dll for Windows NT/2000, or<br></br> |
| libicuuc.a for AIX, or<br></br> |
| libicuuc.so for Solaris/Linux, or<br></br> |
| libicuuc.sl for HP-UX.</li> |
| |
| <li><em>ICU converter data shared library file:</em><br></br> |
| icudata.dll for Windows NT/2000, or<br></br> |
| libicudata.a for AIX, or<br></br> |
| libicudata.so for Solaris/Linux, or<br></br> |
| libicudata.sl for HP-UX.</li> |
| </ol> |
| </a> |
| </faq> |
| |
| <faq title="How do I package the sources to create a binary drop?"> |
| |
| <q>How do I package the sources to create a binary drop?</q> |
| |
| <a> |
| <p>You have to first compile the sources inside your IDE to |
| create the required DLLs and EXEs. Then you need to copy |
| over the binaries to another directory for the binary |
| drop. A perl script has been provided to give you a jump |
| start. You need to install perl on your machine for the script to work. |
| If you have changed your source tree, you have to modify the script to suit |
| your current directory structure. To invoke the |
| script, go to the \<&XercesCProjectName;>\scripts directory, and type:</p> |
| <source>perl packageBinaries.pl</source> |
| |
| <p>You will get a message that somewhat looks like this (changes always happen, |
| we are evolving you see!): </p> |
| |
| <source>Usage is: packageBinaries <options> |
| options are: -s <source_directory> |
| -o <target_directory> |
| -c <C compiler name> (e.g. gcc or xlc_r) |
| -x <C++ compiler name> (e.g. g++ or xlC_r) |
| -m <message loader> can be 'inmem', 'icu' or 'iconv' |
| -n <net accessor> can be 'fileonly' or 'libwww' |
| -t <transcoder> can be 'icu' or 'native' |
| -r <thread option> can be 'pthread' or 'dce' (only used on HP-11) |
| -h to get help on these commands |
| Example: perl packageBinaries.pl -s$HOME/&XercesCSrcInstallDir; |
| -o$HOME/&XercesCInstallDir; |
| -cgcc -xg++ -minmem |
| -nfileonly -tnative</source> |
| |
| <p>Make sure that your compiler can be invoked from the command line and |
| follow the instructions to produce a binary drop.</p> |
| </a> |
| </faq> |
| |
| <faq title="I do not see binaries for my platform. When will they be available?"> |
| |
| <q>I do not see binaries for my platform. When will they be available?"></q> |
| |
| <a> |
| <p>The reason why you see binaries only for some specific |
| platforms is that we have had the maximum requests for |
| them. Moreover, we have limited resources and hence cannot |
| publish binaries for every platform. If you wish to |
| contribute your time and effort in building binaries for a |
| specific platform/environment then please send a mail to the |
| <jump href="mailto:&XercesCEmailAddress;">&XercesCName; mailing list</jump>. |
| We can definitely use any extra help in this open source |
| project</p> |
| </a> |
| </faq> |
| |
| |
| <faq title="When will a port to my platform be available?"> |
| |
| <q>When will a port to my platform be available?</q> |
| |
| <a> |
| <p>We would like to see &XercesCProjectName; ported to as |
| many platforms as there are. Again, due to limited resources |
| we cannot do all the ports. We will help you make this port |
| happen. Here are some <jump |
| href="build-misc.html#faq-4">Porting |
| Guidelines</jump>.</p> |
| |
| <p>We strongly encourage you to submit the changes that |
| are required to make it work on another platform. We will |
| incorporate these changes in the source code base and make |
| them available in the future releases.</p> |
| |
| <p>All porting changes may be sent to the |
| <jump href="mailto:&XercesCEmailAddress;">&XercesCName; mailing list</jump> |
| .</p> |
| </a> |
| </faq> |
| |
| |
| <faq title="How can I port &XercesCProjectName; to my favourite platform?"> |
| <q>How can I port &XercesCProjectName; to my favourite platform?</q> |
| <a> |
| <p>Some porting information is mentioned on the <jump |
| href="build-misc.html#faq-4">build</jump> page.</p> |
| </a> |
| </faq> |
| |
| |
| |
| <faq title="What application do you use to create the documentation?"> |
| <q>What application do you use to create the documentation?</q> |
| <a> |
| <p>We have used an internal XML based application to create the |
| documentation. The documentation files are all written in XML and the |
| application, internally codenamed StyleBook, makes use of XSL to transform |
| it into an HTML document that you are seeing right now. |
| It is currently available on the |
| <jump href="http://xml.apache.org/">Apache</jump> open source website as |
| <jump href="http://xml.apache.org/cocoon/index.html">Cocoon</jump>.</p> |
| |
| <p>The API documentation is automatically generated using |
| <jump href="http://www.stack.nl/~dimitri/doxygen/">Doxygen</jump> and |
| <jump href="http://www.research.att.com/sw/tools/graphviz/">GraphViz</jump>.</p> |
| |
| </a> |
| </faq> |
| |
| |
| <faq title="Can I use &XercesCProjectName; in my product?"> |
| <q>Can I use &XercesCProjectName; in my product?</q> |
| <a> |
| <p>Yes! Read the license agreement first and if you still |
| have further questions, then please address them to the |
| <jump href="mailto:&XercesCEmailAddress;">&XercesCName; mailing list</jump> |
| .</p> |
| |
| </a> |
| </faq> |
| |
| |
| <faq title="How do I uninstall &XercesCName;?"> |
| <q>How do I uninstall &XercesCName;?</q> |
| <a> |
| <p>&XercesCName; only installs itself in a single directory and does not |
| set any registry entries. Thus, to uninstall, you only need to remove the |
| directory where you installed it, and all &XercesCName; related files will be |
| removed.</p> |
| </a> |
| </faq> |
| <faq title="I am getting a tar checksum error on Solaris. What's the problem?"> |
| <q>I am getting a tar checksum error on Solaris. What's the problem?</q> |
| <a> |
| <p>The problem is caused by a limitation in the original tar spec, which |
| prevented it from archiving files with long pathnames. Unfortunately, |
| various current versions of tar use different extensions for eliminating |
| this restriction which are incompatible with each other (or they do not |
| remove the restriction at all). Rather than altering the pathnames for |
| the &XercesCName; package, which would make them compatible with the original |
| tar spec but make it more difficult to know what was where, it was |
| decided to use GNU tar (gtar), which handles arbitrarily long pathnames |
| and is freely available on every platform on which &XercesCName; is |
| supported. If you don't already have GNU tar installed on your system, |
| you can obtain it from the Free Software Foundation |
| <jump href="http://www.gnu.org/software/tar/tar.html"> |
| http://www.gnu.org/software/tar/tar.html</jump>. For additional |
| background information on this problem, see the online manual |
| <jump href="http://www.gnu.org/manual/tar/html_node/tar_117.html#SEC112"> |
| GNU tar and POSIX tar </jump> for the utility. |
| </p> |
| </a> |
| </faq> |
| </faqs> |
| |