You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

209 lines
8.3 KiB

  1. <?xml version="1.0" standalone="no"?>
  2. <!--
  3. * Licensed to the Apache Software Foundation (ASF) under one or more
  4. * contributor license agreements. See the NOTICE file distributed with
  5. * this work for additional information regarding copyright ownership.
  6. * The ASF licenses this file to You under the Apache License, Version 2.0
  7. * (the "License"); you may not use this file except in compliance with
  8. * the License. You may obtain a copy of the License at
  9. *
  10. * http://www.apache.org/licenses/LICENSE-2.0
  11. *
  12. * Unless required by applicable law or agreed to in writing, software
  13. * distributed under the License is distributed on an "AS IS" BASIS,
  14. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. * See the License for the specific language governing permissions and
  16. * limitations under the License.
  17. -->
  18. <!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
  19. <s1 title="Installation">
  20. <anchor name="Windows"/>
  21. <s2 title="Windows">
  22. <p>This section contains installation instructions for the Windows
  23. platform.</p>
  24. <s3 title="Source distribution">
  25. <p>The &XercesCName; source is available in the source distribution:
  26. &XercesC3SrcInstallDir;.zip.</p>
  27. <p>Install the &XercesCName; source distribution by using <code>unzip</code>
  28. on the &XercesC3SrcInstallDir;.zip archive in the Windows environment. You can
  29. use WinZip, or any other UnZip utility:</p>
  30. <source>
  31. unzip &XercesC3SrcInstallDir;.zip
  32. </source>
  33. <p>This creates the &apos;&XercesC3SrcInstallDir;&apos; sub-directory
  34. containing the &XercesCName; source distribution. </p>
  35. <p>To build the &XercesCName; source after installation,
  36. please follow the <jump href="build-&XercesC3Series;.html">Build Instructions</jump>.</p>
  37. </s3>
  38. <!--
  39. <s3 title="Binary distribution">
  40. <p>Install the &XercesCName; binary distribution by using <code>unzip</code>
  41. on the &XercesC3InstallDir;-{arch}-windows-{compiler}.zip archive in
  42. the Windows environment. Here {arch} denotes the CPU architecture
  43. and {compiler} denotes the C++ compiler of your choice. You can use
  44. WinZip, or any other UnZip utility. For example:</p>
  45. <source>
  46. unzip &XercesC3InstallDir;-x86-windows-vc-8.0.zip
  47. </source>
  48. <p>This creates a &apos;&XercesC3InstallDir;-x86-windows-vc-8.0&apos;
  49. sub-directory containing the &XercesCName; binary distribution.</p>
  50. <p>You need to add the &apos;&XercesC3InstallDir;-{arch}-windows-{compiler}\bin&apos;
  51. directory to your path.
  52. To do this go to the start menu, click the settings menu and
  53. select control panel. When the control panel opens, double
  54. click on System and select the &apos;Environment&apos; tab.
  55. Locate the PATH variable under system variables and add
  56. &lt;full-path-to-&XercesC3InstallDir;-{arch}-windows-{compiler}>\bin
  57. to the PATH variable.</p>
  58. <p>Additionally, if you don't have the corresponding version of
  59. Microsoft Visual C++ installed, you may need to download and
  60. install the C/C++ runtime libraries from the Microsoft website.
  61. For example, for Visual Studio 2008 (9.0) the package is called
  62. "Microsoft Visual C++ 2008 Redistributable Package".</p>
  63. <p>The binary distribution contains the pre-built parser libraries
  64. and sample executables. Please refer to the
  65. <jump href="samples-&XercesC3Series;.html">Samples</jump> for how to run the
  66. samples.</p>
  67. </s3>
  68. -->
  69. </s2>
  70. <anchor name="Unix"/>
  71. <s2 title="UNIX">
  72. <p>This section contains installation instructions for the UNIX,
  73. Linux, and Mac OS X platforms.</p>
  74. <s3 title="Source distribution">
  75. <p>The &XercesCName; source is available in the source distribution:
  76. &XercesC3SrcInstallDir;.tar.gz (other formats also available).</p>
  77. <p>Install the &XercesCName; source distribution
  78. &XercesC3SrcInstallDir;.tar.gz by extracting the files
  79. from the compressed archive:</p>
  80. <source>
  81. gzip -d &XercesC3SrcInstallDir;.tar.gz
  82. tar -xf &XercesC3SrcInstallDir;.tar
  83. </source>
  84. <p>This creates the &apos;&XercesC3SrcInstallDir;&apos; sub-directory
  85. containing the &XercesCName; source distribution. </p>
  86. <p>To build the &XercesCName; source after installation,
  87. please follow the <jump href="build-&XercesC3Series;.html">Build Instructions</jump>.</p>
  88. </s3>
  89. <!--
  90. <s3 title="Binary distribution">
  91. <p>Install the binary distribution &XercesC3InstallDir;-{arch}-{os}-{compiler}.tar.gz
  92. by extracting the files from the compressed archive. Here {arch}
  93. denotes the CPU architecture, {os} denotes the operating system,
  94. and {compiler} denotes the C++ compiler of your choice.
  95. For example:</p>
  96. <source>
  97. gzip -d &XercesC3InstallDir;-x86-linux-gcc-3.4.tar.gz
  98. tar -xf &XercesC3InstallDir;-x86-linux-gcc-3.4.tar
  99. </source>
  100. <p>This will create an '&XercesC3InstallDir;-x86-linux-gcc-3.4'
  101. sub-directory containing the &XercesCName; binary distribution.</p>
  102. <p>You will need to add the
  103. &XercesC3InstallDir;-{arch}-{os}-{compiler}/bin directory to your
  104. PATH environment variable:</p>
  105. <p>For Bourne Shell, K Shell or Bash, type: </p>
  106. <source>
  107. export PATH="$PATH:&lt;full-path-to-&XercesC3InstallDir;-{arch}-{os}-{compiler}>/bin"
  108. </source>
  109. <p>For C Shell, type:</p>
  110. <source>
  111. setenv PATH "$PATH:&lt;full-path-to-&XercesC3InstallDir;-{arch}-{os}-{compiler}>/bin"
  112. </source>
  113. <p>If you wish to make this setting permanent, you need to change
  114. your profile by changing your setup files which can be either
  115. .profile or .kshrc.</p>
  116. <p>In addition, you will also need to set the library search path.
  117. (LIBPATH on AIX, LD_LIBRARY_PATH on Solaris and Linux,
  118. SHLIB_PATH on HP-UX, and DYLD_LIBRARY_PATH on Mac OS X).</p>
  119. <p>In the following shell commands, the &lt;xerces-path>
  120. denotes the full path to the
  121. &XercesC3InstallDir;-{arch}-{os}-{compiler} directory. For
  122. Bourne Shell, K Shell or Bash, type:</p>
  123. <source>
  124. export LIBPATH=&lt;xerces-path>/lib:$LIBPATH (AIX)
  125. export LD_LIBRARY_PATH=&lt;xerces-path>/lib:$LD_LIBRARY_PATH (Solaris, Linux)
  126. export SHLIB_PATH=&lt;xerces-path>/lib:$SHLIB_PATH (HP-UX)
  127. export DYLD_LIBRARY_PATH=&lt;xerces-path>/lib:$DYLD_LIBRARY_PATH (Mac OS X)
  128. </source>
  129. <p>For C Shell, type:</p>
  130. <source>
  131. setenv LIBPATH "&lt;xerces-path>/lib:$LIBPATH" (AIX)
  132. setenv LD_LIBRARY_PATH "&lt;xerces-path>/lib:$LD_LIBRARY_PATH" (Solaris, Linux)
  133. setenv SHLIB_PATH "&lt;xerces-path>/lib:$SHLIB_PATH" (HP-UX)
  134. setenv DYLD_LIBRARY_PATH "&lt;xerces-path>/lib:$DYLD_LIBRARY_PATH" (Mac OS X)
  135. </source>
  136. <p>The binary distribution contains the pre-built parser libraries
  137. and sample executables. Please refer to the
  138. <jump href="samples-&XercesC3Series;.html">Samples</jump> for how to run the
  139. samples.</p>
  140. </s3>
  141. -->
  142. </s2>
  143. <anchor name="Cygwin"/>
  144. <s2 title="Cygwin">
  145. <p>This section contains installation instructions for the Cygwin
  146. platform.</p>
  147. <s3 title="Source distribution">
  148. <p>The &XercesCName; source is available in the source distribution:
  149. &XercesC3SrcInstallDir;.tar.gz (other formats available).</p>
  150. <p>Install the &XercesCName; source distribution
  151. &XercesC3SrcInstallDir;.tar.gz by extracting the files
  152. from the compressed archive:</p>
  153. <source>
  154. tar -xfz &XercesC3SrcInstallDir;.tar.gz
  155. </source>
  156. <p>This creates the &apos;&XercesC3SrcInstallDir;&apos; sub-directory
  157. containing the &XercesCName; source distribution. </p>
  158. <p>To build the &XercesCName; source after installation,
  159. please follow the <jump href="build-&XercesC3Series;.html">Build Instructions</jump>.
  160. </p>
  161. </s3>
  162. <s3 title="Binary distribution">
  163. <p>Precompiled Xerces-C++ libraries for Cygwin are provide as
  164. part of the Cygwin package repository. To install the binary
  165. distribution run Cygwin setup.exe.
  166. When you reach the Packages step of the Cygwin Setup wizard,
  167. expand the Devel category, then click in the New column next
  168. to "xerces-c-devel" until it reads "&XercesC3Version;-X".</p>
  169. </s3>
  170. </s2>
  171. </s1>