tng 2002/12/02 10:47:11
Modified: c/doc build-winunix.xml build.xml install.xml
Log:
[Bug 13804] update build and installation docs for cygwin. Patch from Abe Backus.
Revision Changes Path
1.24 +28 -1 xml-xerces/c/doc/build-winunix.xml
Index: build-winunix.xml
===================================================================
RCS file: /home/cvs/xml-xerces/c/doc/build-winunix.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- build-winunix.xml 22 Nov 2002 14:58:15 -0000 1.23
+++ build-winunix.xml 2 Dec 2002 18:47:11 -0000 1.24
@@ -107,6 +107,33 @@
</s3>
</s2>
+ <anchor name="CygWin"/>
+ <s2 title="Building &XercesCName; on Windows using Cygwin">
+ <p><em>Do not jump into the build directly before reading this.</em></p>
+
+ <p>&XercesCName; may be built in the
+ <jump href="http://www.cygwin.com";>Cygwin</jump> environment for use
+ by Cygwin applications. As with the <jump href="#UNIX">UNIX</jump>
+ platforms, &XercesCName; on Cygwin uses
+ <jump href="http://www.gnu.org";>GNU</jump> tools. Therefore, with a
+ couple of notable exceptions, &XercesCName; on Cygwin is built using
+ the same instructions as the UNIX platforms. The build environment
+ variable XERCESCROOT must be set to the proper path containing the
+ &XercesCName; sources and runConfigure must be run with the
+ "-pcygwin -cgcc -xg++" arguments.</p>
+
+ <p>Note that Cygwin is different from the UNIX platforms in the way
+ that it finds libraries at run time. While UNIX platforms may use the
+ environment variable LD_LIBRARY_PATH, Cygwin uses the PATH environment
+ variable.</p>
+
+ <p>There is an issue with the
+ <jump href="http://www.gnu.org/software/gcc/gcc.html";>gcc/g++</jump>
+ compiler version 2.95, where C++ exceptions thrown from a dll will
+ cause the application to crash, regardless of whether there is a
"catch"
+ statement. This bug doesn't occur in tests using gcc 3.1 or 3.2, so it
+ is recommended that you use gcc 3.1 or higher.</p>
+ </s2>
<anchor name="UNIX"/>
<s2 title="Building &XercesCName; on UNIX platforms">
@@ -116,7 +143,7 @@
<jump href="http://www.gnu.org/software/make/make.html";>GNU Make</jump>
to build the system. You must first make sure you
have these tools installed on your system before proceeding.
- If you don not have required tools, ask your system administrator
+ If you do not have required tools, ask your system administrator
to get them for you. These tools are free under the GNU Public License
and may be obtained from the
<jump href="http://www.gnu.org";>Free Software Foundation</jump>.</p>
1.25 +1 -0 xml-xerces/c/doc/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/xml-xerces/c/doc/build.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- build.xml 23 Aug 2002 14:09:37 -0000 1.24
+++ build.xml 2 Dec 2002 18:47:11 -0000 1.25
@@ -10,6 +10,7 @@
<li><jump href="build-winunix.html#WinNT">Building &XercesCName; on Windows
using Microsoft Visual C++</jump></li>
<li><jump href="build-winunix.html#WinIntel">Building &XercesCName; 64 bit
binary on Windows XP using Intel C++ Compiler</jump></li>
<li><jump href="build-winunix.html#WinBorland">Building &XercesCName; on
Windows using Borland C++Builder</jump></li>
+ <li><jump href="build-winunix.html#CygWin">Building &XercesCName; on Windows
using Cygwin</jump></li>
<li><jump href="build-winunix.html#UNIX">Building &XercesCName; on UNIX
platforms</jump></li>
<li><jump href="build-winunix.html#UNIX_SingleThread">Building &XercesCName;
as a single-threaded library on Unix platforms</jump></li>
</ul>
1.9 +44 -1 xml-xerces/c/doc/install.xml
Index: install.xml
===================================================================
RCS file: /home/cvs/xml-xerces/c/doc/install.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- install.xml 22 Nov 2002 21:34:29 -0000 1.8
+++ install.xml 2 Dec 2002 18:47:11 -0000 1.9
@@ -124,4 +124,47 @@
</s3>
</s2>
-</s1>
\ No newline at end of file
+
+ <s2 title="Cygwin">
+ <s3 title="Source distribution">
+ <p>The &XercesCName; source is available in the source distribution.
+ </p>
+ <p>Install the &XercesCName; source distribution
&XercesCSrcInstallDir;.tar.gz by extracting the files
+ from the compressed archive.</p>
+<source>
+tar -xvzf &XercesCSrcInstallDir;.tar.gz
+</source>
+ <p>This creates a '&XercesCSrcInstallDir;' sub-directory
+ containing the &XercesCName; source distribution. </p>
+
+ <p>If you need to build the &XercesCName; source after installation,
+ please follow the <jump href="build.html">Build Instructions</jump>.</p>
+
+ </s3>
+ <s3 title="Binary distribution">
+ <p>Install the binary distribution by running
+ <jump href="http://www.cygwin.com";>Cygwin</jump> setup.exe.
+ When you reach the "Packages" step of the Cygwin Setup
wizard,
+ expand the "Devel" category, then click in the "New" column
next
+ to "xerces-c-devel" until it reads "&XercesCVersion;-X".</p>
+
+ <p>This will install the necessary libraries and include files
+ for the &XercesCName; binary distribution.</p>
+
+ <p>If you wish to run programs linked to &XercesCName; that were
+ built in the Cygwin environment, you need to add your Cygwin
+ "bin" directory to your Windows PATH environment variable.
+ In typical Cygwin installations, the bin directory is in the
+ Cygwin directory on the drive that windows is installed on.
+ For instance, if windows is installed to C:\WINNT\System32,
+ Your Cygwin bin directory may be "C:\cygwin\bin".</p>
+
+ <p>The binary distribution has the built parser library. Sample
+ executables may be available in a future release on the
+ Cygwin platform. In the meantime, they may be built from the
+ source distribution by following the
+ <jump href="build.html">Build Instructions</jump> for
+ "Building samples".</p>
+ </s3>
+ </s2>
+</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
