Author: bhavani
Date: Fri Aug 3 04:49:12 2012
New Revision: 1368794
URL: http://svn.apache.org/viewvc?rev=1368794&view=rev
Log:
Added web page for UIMA C++ build information
Added:
uima/site/trunk/uima-website/docs/doc-uimacpp-build.html
Added: uima/site/trunk/uima-website/docs/doc-uimacpp-build.html
URL:
http://svn.apache.org/viewvc/uima/site/trunk/uima-website/docs/doc-uimacpp-build.html?rev=1368794&view=auto
==============================================================================
--- uima/site/trunk/uima-website/docs/doc-uimacpp-build.html (added)
+++ uima/site/trunk/uima-website/docs/doc-uimacpp-build.html Fri Aug 3
04:49:12 2012
@@ -0,0 +1,327 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+
+
+ <!--
====================================================================== -->
+ <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
+ <!--
====================================================================== -->
+ <html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
+ <style type="text/css">@import "stylesheets/base.css";</style>
+ <meta name="author" value="
+ Apache UIMA Documentation Team
+ ">
+ <meta name="email" value="d...@uima.apache.org">
+
+
+
+ <title>Apache UIMA - Apache UIMA C++ Framework</title>
+ </head>
+
+ <body>
+ <div class="topLogos">
+ <table border="0" width="100%" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td align='LEFT'>
+ <a href="index.html">
+ <img style="border: 1px solid black;"
src="./images/UIMA_banner2tlpTm.png" alt="UIMA project logo" border="0"/>
+ </a>
+ </td>
+ <td align='CENTER'>
+ <div class="pageBanner">Apache UIMA C++
Framework</div>
+ </td>
+ <td align='RIGHT'>
+ <a href="http://www.apache.org";>
+ <img src="./images/asf-logo-on-white-smallTm.png" alt="Apache UIMA"
border="0"/>
+ </a>
+ </td>
+ </tr>
+ </table>
+ <hr noshade="" size="1"/>
+ </div>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <td align='RIGHT' colspan="2">
+ <form method="get" action="http://www.google.com/search";>
+ Search the site
+ <input type="text" name="q" size="25" maxlength="255"
value="" />
+ <input type="hidden" name="sitesearch"
value="http://uima.apache.org/"; />
+ <input name="Search" value="Search Site" type="submit"/>
+ </form>
+ </td>
+ </tr>
+ <tr> <!-- LEFT SIDE NAVIGATION -->
+ <td width="20%" valign="top">
+
+
+
+
+
+
+ <!-- regular menu -->
+ <div class="navBar">
+ <br/>
+ <div class="navBarItem"> <div
class="navPartHeading">General</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a href="./index.html">Home</a>
+ </div>
+ <div class="navBarItem"> <a
href="./downloads.cgi">Downloads</a>
+ </div>
+ <div class="navBarItem"> <a
href="./documentation.html">Documentation</a>
+ </div>
+ <div class="navBarItem"> <a
href="./news.html">News</a>
+ </div>
+ <br style="line-height: .5em"/>
+ <div class="navBarItem"> <a
href="./mail-lists.html">Mailing Lists</a>
+ </div>
+ <div class="navBarItem"> <a
href="./mail-lists.html#Apache_UIMA_Forums">Forums</a>
+ <a
href="http://news.gmane.org/gmane.comp.apache.uima.general";
target="_blank"><em> Users</em> <img src="images/offsitelink.png" /></a>
+ <a href="http://news.gmane.org/gmane.comp.apache.uima.devel";
target="_blank"><em>Dev</em> <img src="images/offsitelink.png" /></a>
+ </div>
+ <div class="navBarItem"> <a
href="http://cwiki.apache.org/UIMA/powered-by-apache-uima.html";
target="_blank">Powered By UIMA <img src="images/offsitelink.png"/></a>
+ </div>
+ <br style="line-height: .5em"/>
+ <div class="navBarItem"> <a
href="http://issues.apache.org/jira/browse/uima"; target="_blank">Issue tracker
<img src="images/offsitelink.png"/></a>
+ </div>
+ <div class="navBarItem"> <a
href="http://cwiki.apache.org/UIMA/"; target="_blank">Wiki <img
src="images/offsitelink.png"/></a>
+ </div>
+ </div>
+ <br/>
+ <div class="navBarItem"> <div
class="navPartHeading">Components & Tools</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a
href="./sandbox.html#uima-addons-annotators">Annotators</a>
+ </div>
+ <div class="navBarItem"> <a
href="./toolsServers.html">Tools & Servers</a>
+ </div>
+ <div class="navBarItem"> <a
href="./sandbox.html">Addons and Sandbox</a>
+ </div>
+ <div class="navBarItem"> <a
href="./external-resources.html">External Resources</a>
+ </div>
+ </div>
+ <br/>
+ <div class="navBarItem"> <div
class="navPartHeading">Community</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a
href="./get-involved.html">Get Involved</a>
+ </div>
+ <div class="navBarItem"> <a
href="./contribution-policy.html">Contribution Policies</a>
+ </div>
+ <div class="navBarItem"> <a
href="./faq.html">FAQ</a>
+ </div>
+ <div class="navBarItem"> <a
href="./project-guidelines.html">Project Guidelines</a>
+ </div>
+ </div>
+ <br/>
+ <div class="navBarItem"> <div
class="navPartHeading">Development</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a
href="./dev-quick.html">Quick Start: building</a>
+ </div>
+ <div class="navBarItem"> <a
href="./building-uima.html">Building from Source</a>
+ </div>
+ <div class="navBarItem"> <a
href="./one-time-setup.html">One-time setups</a>
+ </div>
+ <div class="navBarItem"> <a
href="./svn.html">Source Code</a>
+ </div>
+ <div class="navBarItem"> <a
href="./distribution.html">Creating a Distribution</a>
+ </div>
+ <div class="navBarItem"> <a
href="./release.html">Doing a UIMA release</a>
+ </div>
+ <div class="navBarItem"> <a
href="./codeConventions.html">Code Conventions</a>
+ </div>
+ <div class="navBarItem"> <a
href="./uima-specification.html">UIMA Specification (OASIS)</a>
+ </div>
+ <div class="navBarItem"> <a
href="./team-list.html">Project Team</a>
+ </div>
+ <div class="navBarItem"> <a
href="./maven-design.html">Maven Use</a>
+ </div>
+ </div>
+ <br/>
+ <div class="navBarItem"> <div class="navPartHeading">Events
and Conferences</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a href="./iks09.html">IKS
2009</a>
+ </div>
+ <div class="navBarItem"> <a
href="./gscl09.html">GSCL 2009</a>
+ </div>
+ <div class="navBarItem"> <a
href="./lsm09.html">LSM 2009</a>
+ </div>
+ <div class="navBarItem"> <a
href="./lrec08.html">LREC 2008</a>
+ </div>
+ <div class="navBarItem"> <a
href="./gldv07.html">GLDV 2007</a>
+ </div>
+ </div>
+ <br/>
+ <div class="navBarItem"> <div class="navPartHeading">ASF</div>
+ </div>
+ <div class="navBar">
+ <div class="navBarItem"> <a
href="http://www.apache.org/licenses/"; target="_blank">License <img
src="images/offsitelink.png"/></a>
+ </div>
+ <div class="navBarItem"> <a
href="http://www.apache.org/foundation/thanks.html"; target="_blank">ASF
Sponsors <img src="images/offsitelink.png"/></a>
+ </div>
+ <div class="navBarItem"> <a
href="http://www.apache.org/foundation/sponsorship.html"; target="_blank">ASF
Sponsorship <img src="images/offsitelink.png"/></a>
+ </div>
+ <div class="navBarItem"> <a
href="http://www.apache.org/security"; target="_blank">Security <img
src="images/offsitelink.png"/></a>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td width="80%" align="left" valign="top">
+ <div
class="sectionTable">
+ <table class="sectionTable">
+ <tr><td>
+ <a name="Building and Packaging: Apache UIMA C++ Framework"><h1><img
src="images/UIMA_4sq50tightCropSolid.png"/> Building and Packaging: Apache
UIMA C++ Framework</h1></a>
+ </td></tr>
+ <tr><td>
+ <blockquote class="sectionBody">
+ <p>
+ Here you will find more detailed information on platform specific issues
and on building the Apache UIMA™ C++ dependencies.
+ </p>
+ <p>
+ The Apache UIMA C++ SDK has been built and tested in 32-bit mode on
+Linux systems with gcc version 3.4.6 and on Windows using MSVC version 8.
+64-bit builds have only been tested on Linux with gcc 4.3.2 and 4.4.6.
+ </p>
+ <p>
+The UIMA C++ SDK has been built with the following versions of these
dependencies:
+<ul>
+<li>APR 1.3.8</li>
+<li>ICU 3.6</li>
+<li>XERCES 2.8.0</li>
+<li>ACTIVEMQ CPP 3.4.1</li>
+<li>APR-UTIL 1.3.8</li>
+</ul>
+</p>
+ <p>
+ If changes are made to configure.ac or Makefile.am, then configure
+needs to be re-generated by running <code>./autogen.sh</code> in the root of
the SVN extract.
+</p>
+ <p>
+<code>autogen.sh</code> requires GNU tools at or above the following versions:
+automake v1.9.6, autoconf v2.59 and libtool v1.5.24.
+</p>
+ <table
class="subsectionTable">
+ <tr><td>
+
+
+
+ <a name="Building the dependencies: APR, APR-Util, ICU, Xerses-c and
Activemq-cpp">
+ <h2>Building the dependencies: APR, APR-Util, ICU, Xerses-c and
Activemq-cpp
+ </h2>
+ </a>
+ </td></tr>
+ <tr><td>
+ <blockquote class="subsectionBody">
+ <p>
+ Download and build information for these libraries are at:
+ <ul>
+ <li>APR - <a class="external"
href="http://apr.apache.org/";>http://apr.apache.org/</a></li>
+ <li>APR-Util - <a class="external"
href="http://apr.apache.org/";>http://apr.apache.org/</a></li>
+ <li>ICU - <a class="external"
href="http://www.icu-project.org/";>http://www.icu-project.org/</a></li>
+ <li>XERCES - <a class="external"
href="http://xml.apache.org/xerces-c/";>http://xml.apache.org/xerces-c/</a></li>
+ <li>ACTIVEMQ - <a class="external"
href="http://activemq.apache.org/cms/download.html";>http://activemq.apache.org/cms/download.html/</a></li>
+ </ul>
+</p>
+ <p>
+ACTIVEMQ CPP library version 3.2 or higher is required to support
+the ActiveMQ failover protocol and to support multi-byte payload data.
+ACTIVEMQ CPP 3.2 and higher has a dependency on APR at version 1.3.8
+or higher and APR-Util 1.3.8.
+</p>
+ </blockquote>
+ </td></tr>
+ </table>
+ <table
class="subsectionTable">
+ <tr><td>
+
+
+
+ <a name="Building, testing and packaging on Mac OSX">
+ <h2>Building, testing and packaging on Mac OSX
+ </h2>
+ </a>
+ </td></tr>
+ <tr><td>
+ <blockquote class="subsectionBody">
+ <p>
+These instructions should work on the Max OSX but have not been tested.
+<p>
+Except for one problem with APR, building is the same here as on Linux.
+For the Intel-based Mac OSX machines we have tested with, the APR function
+to dynamically load shared libraries does not respect DYLD_LIBRARY_PATH.
+</p>
+<p>
+A fix is to patch dso/unix/dso.c as follows:
+</p>
+<p>
+<pre>
+<code>
+26a27,31
+>#if defined(DSO_USE_DYLD)
+>#define DSO_USE_DLFCN
+>#undef DSO_USE_DYLD
+>#endif
+</code>
+</pre>
+</p>
+<p>
+Packaging UIMA C++ annotators:
+</p>
+<p>
+On Mac OSX, the install names are embedded in the binaries. Run the
+following steps manually post build to neutralize the embedded name in
+the UIMA C++ binary and to change the dependency path in the
+annotator:
+</p>
+<ol>
+<li>changing the install name in libuima, to neutralize it:
+<pre>
+<code>
+install_name_tool -id libuima.dylib $UIMACPP_HOME/install/lib/libuima.dylib
+</code>
+</pre>
+</li>
+<li>changing the dependency path in the annotator:
+<pre>
+<code>
+install_name_tool -change "/install/lib/libuima.dylib"
+"/absolute_path_to_uimacpp_home/install/lib/libuima.dylib" MyAnnotator.dylib
+</code>
+</pre>
+</li>
+</ol>
+</p>
+ </blockquote>
+ </td></tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ </table>
+ </td>
+ </tr>
+ <!-- FOOTER -->
+ <tr><td colspan="2">
+ <hr noshade="" size="1"/>
+ </td></tr>
+ <tr><td colspan="2">
+ <table class="pageFooter">
+ <tr>
+ <td><a href="index.html">Home</a></td>
+ <td><a href="privacy-policy.html">Privacy Policy</a></td>
+ <td style="font-size:75%">
+ Copyright © 2006-2011, The Apache Software
Foundation.<br/>
+ Apache UIMA, UIMA, the Apache UIMA logo and the Apache Feather
logo are trademarks of The Apache Software Foundation.<br/>
+ All other marks mentioned may be trademarks or registered
trademarks of their respective owners.
+ </td>
+ <td><a href="mailto:d...@uima.apache.org";>Contact
us</a></td>
+ </tr>
+ </table>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+
