You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@uima.apache.org by ea...@apache.org on 2007/07/16 20:15:10 UTC
svn commit: r556686 - in /incubator/uima/uimacpp/trunk: README.4sdk
README.4src RELEASE_NOTES.html buildSrcTree.cmd buildSrcTree.sh
docs/overview_and_setup.html src/readme.tobuild
Author: eae
Date: Mon Jul 16 11:15:09 2007
New Revision: 556686
URL: http://svn.apache.org/viewvc?view=rev&rev=556686
Log:
UIMA-275
Modified:
incubator/uima/uimacpp/trunk/README.4sdk
incubator/uima/uimacpp/trunk/README.4src
incubator/uima/uimacpp/trunk/RELEASE_NOTES.html
incubator/uima/uimacpp/trunk/buildSrcTree.cmd
incubator/uima/uimacpp/trunk/buildSrcTree.sh
incubator/uima/uimacpp/trunk/docs/overview_and_setup.html
incubator/uima/uimacpp/trunk/src/readme.tobuild
Modified: incubator/uima/uimacpp/trunk/README.4sdk
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/README.4sdk?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/README.4sdk (original)
+++ incubator/uima/uimacpp/trunk/README.4sdk Mon Jul 16 11:15:09 2007
@@ -1,5 +1,5 @@
- Apache UIMA C++ (Unstructured Information Management Architecture) v2.1.0
+ Apache UIMA C++ (Unstructured Information Management Architecture) v2.2.0
-------------------------------------------------------------------------
Getting Started
Modified: incubator/uima/uimacpp/trunk/README.4src
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/README.4src?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/README.4src (original)
+++ incubator/uima/uimacpp/trunk/README.4src Mon Jul 16 11:15:09 2007
@@ -20,62 +20,81 @@
pointing at the root of each. If APR version 1.x is used on Windows,
an additional parameter must be set: APR_VER=-1
+
Building, testing and packaging on Linux:
-----------------------------------------
Set up your environment as described above. Assuming you have unpacked
-the source into $HOME/uimacpp-2.1.0-incubating
+the source into $HOME/uimacpp-2.X.Y-incubating
This step can be skipped if building from a source tarball.
When building from SVN, the GNU automake scripts must first be created.
To create the automake scripts:
- cd $HOME/uimacpp-2.1.0-incubating/src
+ cd $HOME/uimacpp-2.X.Y-incubating/src
make -f Makefile.prebuild
Build the UIMA shared library and test routines:
- cd $HOME/uimacpp-2.1.0-incubating/src
+ cd $HOME/uimacpp-2.X.Y-incubating/src
make -f Makefile.unix install
Run the test suite:
- cd $HOME/uimacpp-2.1.0-incubating/src/test
+ cd $HOME/uimacpp-2.X.Y-incubating/src/test
./fvt.sh
Build the documentation:
- cd $HOME/uimacpp-2.1.0-incubating/docs
+ cd $HOME/uimacpp-2.X.Y-incubating/docs
./builddocs.sh
Build the SDK tree:
- cd $HOME/uimacpp-2.1.0-incubating
+ cd $HOME/uimacpp-2.X.Y-incubating
./buildsdk.sh target_dir
Package the SDK tarball:
cd target_dir
- tar czf uimacpp-2.1.0-incubating-bin.tgz uimacpp
+ tar czf uimacpp-2.X.Y-incubating-bin.tgz uimacpp
Building, testing and packaging on Windows:
-----------------------------
Set up your environment as described above. Assuming you have unpacked
-the source into \uimacpp-2.1.0-incubating
+the source into \uimacpp-2.X.Y-incubating
+
+ cd \uimacpp-2.X.Y-incubating\src
+ winmake /build release
+ winmake /build debug
- cd \uimacpp-2.1.0-incubating\src
- winmake
Build and run the test suite:
- cd \uimacpp-2.1.0-incubating\src\test
+ cd \uimacpp-2.X.Y-incubating\src\test
devenv test.sln /build release
fvt
Build the documentation:
- cd \uimacpp-2.1.0-incubating\docs
+ cd \uimacpp-2.X.Y-incubating\docs
builddocs
Build the SDK tree:
set MSVCRT_HOME to the directory with the msvc*.dll files required.
- cd \uimacpp-2.1.0-incubating
+ cd \uimacpp-2.X.Y-incubating
buildsdk target_dir
Package the SDK zipfile by creating a compressed folder of target_dir\uimacpp
-into uimacpp-2.1.0-incubating-bin.zip
+into uimacpp-2.X.Y-incubating-bin.zip
+
+
+Building, testing and packaging on Mac OSX:
+-------------------------------------------
+Except for one problem with APR, building is the same here as on Linux.
+For the Intel-based Mac OSX machines I have tested with, the APR function
+to dynamically load shared libraries does not respect DYLD_LIBRARY_PATH.
+
+A fix is to patch dso/unix/dso.c as follows:
+
+26a27,31
+>#if defined(DSO_USE_DYLD)
+>#define DSO_USE_DLFCN
+>#undef DSO_USE_DYLD
+>#endif
+>
Disclaimer
Modified: incubator/uima/uimacpp/trunk/RELEASE_NOTES.html
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/RELEASE_NOTES.html?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/RELEASE_NOTES.html (original)
+++ incubator/uima/uimacpp/trunk/RELEASE_NOTES.html Mon Jul 16 11:15:09 2007
@@ -1,9 +1,9 @@
<html>
<head>
- <title>Apache UIMA C++ v2.1.0 Releate Notes</title>
+ <title>Apache UIMA C++ v2.2.0 Releate Notes</title>
</head>
<body>
-<h1>Apache UIMA C++ (Unstructured Information Management Architecture) v2.1.0 Release Notes</h1>
+<h1>Apache UIMA C++ (Unstructured Information Management Architecture) v2.2.0 Release Notes</h1>
<h2>Contents</h2>
<p>
@@ -12,6 +12,7 @@
<a href="#migrating">3. Migrating from IBM UIMA C++ to Apache UIMA C++</a><br/>
<a href="#get.involved">4. How to Get Involved</a><br/>
<a href="#report.issues">5. How to Report Issues</a><br/>
+<a href="#more.info">6. More Documentation on Apache UIMA C++</a><br/>
</p>
<h2><a name="what.is.uima">1. What is UIMA?</a></h2>
@@ -194,6 +195,11 @@
The Apache UIMA project uses JIRA for issue tracking. Please report any
issues you find at
<a href="http://issues.apache.org/jira/browse/uima">http://issues.apache.org/jira/browse/uima</a>
+</p>
+
+<h2><a name="more.info">6. More Documentation on Apache UIMA C++</a></h2>
+<p>
+Please see <a href="docs/overview_and_setup.html">C++ Overview and Setup</a>
</p>
</body>
Modified: incubator/uima/uimacpp/trunk/buildSrcTree.cmd
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/buildSrcTree.cmd?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/buildSrcTree.cmd (original)
+++ incubator/uima/uimacpp/trunk/buildSrcTree.cmd Mon Jul 16 11:15:09 2007
@@ -19,7 +19,7 @@
REM under the License.
REM For now, update version in line below
-set srcName=uimacpp-2.1.0-incubating
+set srcName=uimacpp-2.2.0-incubating
REM check args
if "%~1" == "" (
Modified: incubator/uima/uimacpp/trunk/buildSrcTree.sh
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/buildSrcTree.sh?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/buildSrcTree.sh (original)
+++ incubator/uima/uimacpp/trunk/buildSrcTree.sh Mon Jul 16 11:15:09 2007
@@ -18,7 +18,7 @@
# under the License.
# for now, change versionnumber in line below
-srcName=uimacpp-2.1.0-incubating
+srcName=uimacpp-2.2.0-incubating
if [ "$1" = 'TRACE' ]
then set -vx ;shift
Modified: incubator/uima/uimacpp/trunk/docs/overview_and_setup.html
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/docs/overview_and_setup.html?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/docs/overview_and_setup.html (original)
+++ incubator/uima/uimacpp/trunk/docs/overview_and_setup.html Mon Jul 16 11:15:09 2007
@@ -6,7 +6,7 @@
<title>C++ Overview and Setup</title>
<link rel="stylesheet" href="css/stylesheet.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.70.0">
</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" lang="en" id="d0e2"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Overview & Setup</h1></div><div><div class="authorgroup"><h3 class="corpauthor">Authors: The Apache UIMA Development Community</h3></div></div><div><p class="releaseinfo">Version 2.1</p></div><div><p class="copyright">Copyright © 2006, 2007 The Apache Software Foundation</p></div><div><p class="copyright">Copyright © 2004, 2006 International Business Machines Corporation</p></div><div><div class="legalnotice"><a name="d0e15"></a><p> </p><p><b>Incubation Notice and Disclaimer. </b>Apache UIMA is an effort undergoing incubation at the Apache Software Foundation (ASF).
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" lang="en" id="d0e2"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>C++ Overview & Setup</h1></div><div><div class="authorgroup"><h3 class="corpauthor">Authors: The Apache UIMA Development Community</h3></div></div><div><p class="releaseinfo">Version 2.2</p></div><div><p class="copyright">Copyright © 2006, 2007 The Apache Software Foundation</p></div><div><p class="copyright">Copyright © 2004, 2006 International Business Machines Corporation</p></div><div><div class="legalnotice"><a name="d0e15"></a><p> </p><p><b>Incubation Notice and Disclaimer. </b>Apache UIMA is an effort undergoing incubation at the Apache Software Foundation (ASF).
Incubation is required of all newly accepted projects until a further review indicates that
the infrastructure, communications, and decision making process have stabilized in a manner
consistent with other successful ASF projects. While incubation status is not necessarily
Modified: incubator/uima/uimacpp/trunk/src/readme.tobuild
URL: http://svn.apache.org/viewvc/incubator/uima/uimacpp/trunk/src/readme.tobuild?view=diff&rev=556686&r1=556685&r2=556686
==============================================================================
--- incubator/uima/uimacpp/trunk/src/readme.tobuild (original)
+++ incubator/uima/uimacpp/trunk/src/readme.tobuild Mon Jul 16 11:15:09 2007
@@ -1,15 +1,17 @@
---------------------------------------------------
-Building the UIMA C++ Framework for version 2.1
+Building the UIMA C++ Framework for version 2.X
---------------------------------------------------
The library has dependencies on the APR, ICU and Xerces-C++ libraries.
The simplest way to resolve these dependencies is to use the binaries
-included in the UIMACPP 2.1 SDK package from Apache. Install the
+included in the UIMACPP 2.X SDK package from Apache. Install the
appropriate SDK image and set the UIMACPP_HOME environmental parameter to
the location of the installed runtime.
There is also a dependency on JNI headers from a Java JDK. The build
-looks for these headers off the JAVA_INCLUDE parameter.
+looks for these headers off the JAVA_INCLUDE parameter. A typical
+setting for JAVA_INCLUDE on Linux or Windows would be $JAVA_HOME/include;
+on MacOSX jni.h and the other headers will be in a "Headers" directory.
To replace one or more of the dependent libraries with different
versions, download and build the component(s) and specify their use
@@ -17,6 +19,11 @@
pointing at the install directory for each component. That is, under each
should be lib and include directories.
+Download and build information for these libraries are at:
+ APR - http://apr.apache.org/
+ ICU - http://www.icu-project.org/
+ XERCES - http://xml.apache.org/xerces-c/
+
Building of libuima.so & uima.dll has been tested with levels of APR up
to v1.2.7, levels of Xerces-C++ up to v2.7.0, and levels of ICU up to
v3.4. There is a problem on Windows with ICU v3.6 because of a compiler
@@ -35,11 +42,11 @@
Graphviz 1.8.10 installed and in the PATH.
Set up your environment as described above. Assuming you have unpacked
-the tarball source into $HOME/uimacpp-2.1
+the tarball source into $HOME/uimacpp-2.X
- cd $HOME/uimacpp-2.1/src
+ cd $HOME/uimacpp-2.X/src
make -f Makefile.unix install
- cd $HOME/uimacpp-2.1/docs
+ cd $HOME/uimacpp-2.X/docs
./builddocs.sh
If building from an svn extract, a prebuild is required from src
@@ -53,9 +60,9 @@
installed and in the PATH.
Set up your environment as described above. Assuming you have unpacked
-the source into c:\uimacpp-2.1
+the source into c:\uimacpp-2.X
- cd \uimacpp-2.1\src
+ cd \uimacpp-2.X\src
winmake
Creating an SDK:
@@ -63,13 +70,13 @@
With the builds completed and the environment still setup as above,
on Unix:
- cd $HOME/uimacpp-2.1/src
+ cd $HOME/uimacpp-2.X/src
./buildsdk.sh targetDirectory
create tar file from targetDirectory
On Windows:
- cd \uimacpp-2.1
+ cd \uimacpp-2.X
buildsdk targetDirectory
create zipfile from targetDirectory