harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From telli...@apache.org
Subject svn commit: r492523 - in /harmony/enhanced/classlib/trunk: depends/jars/icu4jni_3.4/ depends/libs/linux.x86_64/ depends/oss/ modules/regex/ modules/rmi/
Date Thu, 04 Jan 2007 11:33:23 GMT
Author: tellison
Date: Thu Jan  4 03:33:15 2007
New Revision: 492523

URL: http://svn.apache.org/viewvc?view=rev&rev=492523
Log:
Update and rationalize the readme and associated files.

Added:
    harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt   (with props)
Removed:
    harmony/enhanced/classlib/trunk/depends/oss/README_ZLIB.txt
    harmony/enhanced/classlib/trunk/modules/rmi/COPYRIGHT
    harmony/enhanced/classlib/trunk/modules/rmi/LICENSE
    harmony/enhanced/classlib/trunk/modules/rmi/NOTICE
    harmony/enhanced/classlib/trunk/modules/rmi/README
Modified:
    harmony/enhanced/classlib/trunk/depends/libs/linux.x86_64/README.txt   (props changed)
    harmony/enhanced/classlib/trunk/depends/oss/README.txt
    harmony/enhanced/classlib/trunk/modules/regex/README.TXT

Added: harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt?view=auto&rev=492523
==============================================================================
--- harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt (added)
+++ harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt Thu Jan  4 03:33:15
2007
@@ -0,0 +1,9 @@
+ICU4JNI version 3.4 with Patch 01
+---------------------------------
+ICU4JNI is a freely available set of JNI wrappers to the ICU4C functionality.
+The ICU4JNI version 3.4 has a bug that causes a memory leak.
+This bug has been fixed and released as an official patch.  The version of
+ICU4JNI included in this set of files has already had the patch applied.
+
+For further information see
+http://www.ibm.com/software/globalization/icu/downloads.jsp#icu4j

Propchange: harmony/enhanced/classlib/trunk/depends/jars/icu4jni_3.4/README.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: harmony/enhanced/classlib/trunk/depends/libs/linux.x86_64/README.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: harmony/enhanced/classlib/trunk/depends/oss/README.txt
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/depends/oss/README.txt?view=diff&rev=492523&r1=492522&r2=492523
==============================================================================
--- harmony/enhanced/classlib/trunk/depends/oss/README.txt (original)
+++ harmony/enhanced/classlib/trunk/depends/oss/README.txt Thu Jan  4 03:33:15 2007
@@ -2,20 +2,18 @@
 ======
 
 This directory contains third party open source software which has been placed
-into three separate source archives. During the build of the contributed class 
-library component native source under <EXTRACT_DIR>/Harmony/native-src, the
-contents of these three archives will be copied to the appropriate part of 
-the native source tree for inclusion in the build process. 
+into three separate source archives. During the build of the class library 
+native source, the contents of these three archives will be copied to the
+appropriate part of the source tree for inclusion in the build process.
 
 Keeping these OSS source files distinct from the rest of the native source tree
-helps distinguish third party content from the source delivered in the
-contribution archive and so should make it easier to analyze and reason about
-the new source. Some small modifications to the included OSS source files were
-required so as not to break this contribution's native build process. These
-changes are discussed below.
+helps distinguish third party content from the source of the project. The OSS files
+may be licensed under terms other than the Apache License V2.  Some small
+modifications to the included OSS source files were required. These changes are
+discussed below.
 
 For information about the licenses of the three OSS libraries discussed in this
-document please refer to the file <EXTRACT_DIR>/Harmony/THIRD_PARTY_NOTICES.txt.
+document please refer to the file THIRD_PARTY_NOTICES.txt.
 
 
 
@@ -25,42 +23,21 @@
 C and C++ applications. The file icu4c-3.4-harmony.zip contains a set of C 
 header files (with .h extension) that come straight from the ICU download
 available on the ICU home page. These have been grouped into a directory 
-called "unicode" which is expanded under the
-<EXTRACT_DIR>/Harmony/modules/text/src/main/native/icu4c/unicode directory
-as part of this contribution's native build. The icu4c-3.4-harmony.zip file
-also contains an ICUUC Windows .lib file which is expanded to the 
-<EXTRACT_DIR>/Harmony/modules/text/src/main/native/icu4c/unicode directory
-during the build where it used during the creation of the hytext dll.
+called "unicode". The icu4c-3.4-harmony.zip file also contains a compiled
+version of the ICU4C Windows .lib file.
 
 The official ICU page is located at
 http://www.ibm.com/software/globalization/icu
 
 
 
-ICU4JNI version 3.4 with Patch 01
----------------------------------
-ICU4JNI is a freely available set of JNI wrappers to the ICU4C functionality
-described above.  The ICU4JNI version 3.4 has a bug that causes a memory leak.
-This bug has been fixed and released as an official patch.  The version of
-ICU4JNI included in this set of files has already had the patch applied.
-
-For further information see
-http://www.ibm.com/software/globalization/icu/downloads.jsp#icu4j
-
-
-
 FDLIBM version 5.2
 ------------------
-FDLIBM (Freely Distributable LIBM) is a C math library for machines that
-can support IEEE 754 floating-point arithmetic. File fdlibm_5.2.zip mostly 
-contains the original source as downloaded from the FDLIBM home page with the
-exception of a few files whose names clashed with others in the original
-native-src folder under <EXTRACT_DIR>/Harmony. In the zip file these files 
-have all been given the ".orig" suffix. The modified versions of the files
-are to be found (with no such extra suffix) under
-<EXTRACT_DIR>/Harmony/native-src/<target platform>/fdlibm. As part of the 
-native build process the contents of this zip file are expanded to the
-<EXTRACT_DIR>/Harmony/native-src/<target platform>/fdlibm directory. 
+FDLIBM (Freely Distributable LIBM) is a C math library for supporting IEEE 754
+floating-point arithmetic. File fdlibm_5.2.zip mostly contains the original
+source as downloaded from the FDLIBM home page with the
+exception of a few files whose names clashed with others in Harmony. In the
+zip file these files have all been given the ".orig" suffix.
 
 The official FDLIBM page is located at http://www.netlib.org/fdlibm/
 
@@ -72,9 +49,6 @@
 contains almost the original source for version 1.2.3 as downloaded from the
 zlib home page. So as not to cause confusion with the makefile developed for
 this original code contribution the original Makefile from zlib 1.2.3 has been
-renamed Makefile.orig. During the native build of the shared libraries which 
-support the class library component jars the contents of this zip get expanded
-to the directory <EXTRACT_DIR>/Harmony/native-src/<target platform>/zlib.
+renamed Makefile.orig.  The original /contrib directory has been removed.
 
 The official zlib home page is located at http://www.gzip.org/zlib
-

Modified: harmony/enhanced/classlib/trunk/modules/regex/README.TXT
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/regex/README.TXT?view=diff&rev=492523&r1=492522&r2=492523
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/regex/README.TXT (original)
+++ harmony/enhanced/classlib/trunk/modules/regex/README.TXT Thu Jan  4 03:33:15 2007
@@ -1,189 +1,5 @@
-INTEL CONTRIBUTION TO APACHE HARMONY
-          January 19, 2006
-======================================
-
-
-This archive contains the contribution to the Apache 
-Harmony project from Intel. The contribution consists 
-of the following components: 
-
-    - BEANS
-    - REGEX
-    - MATH
-
-See http://wiki.apache.org/harmony/ClassLibrary for a
-definition of components. 
-
-NOTE: This contribution includes the stubs for the certain classes from the
-java.awt and java.applet packages to enable compilation of java.beans.
-The stub classes do not yet include the complete method signatures
-or their fully-functional implementaions.
-
-1. ARCHIVE CONTENTS
--------------------
-
-The archive contains the source files, the building environment, 
-and the unit tests' source for testing the provided implementation.
-
-After extracting the archive, the following directories appear under 
-<EXTRACT_DIR>/Harmony, where EXTRACT_DIR is the location of the 
-archive content:
-
-  doc      - Regex framework description
-  make     - Files required to build the class libraries and tests
-  src      - Source files that can be compiled into the class libraries            
-  test     - Unit tests' source files
-
-
-2. TOOLS AND ENVIRONMENT VARIABLES REQUIRED FOR THE BUILD
------------------------------------------------------------
-
-To build the Java* sources contained in the src/ directory, 
-install and configure the following tools in the user environment:
-
-+ Apache Ant     - Build tool: Ant 1.6.4 or higher, from 
-                   http://ant.apache.org
-
-+ Eclipse* compiler - Eclipse* SDK 3.0.1 or higher, from 
-                   http://download.eclipse.org/eclipse/downloads/index.php
-
-+ Virtual machine - Apache Harmony Execution Environment, from
-                   http://www-128.ibm.com/developerworks/java/jdk/harmony
-
-+ Class libraries - Harmony Class Libraries, from
-                   https://svn.apache.org/repos/asf/incubator/harmony/enhanced/classlib/trunk
-
-+ Xerces J        - Xerces2 Java Parser 2.7.1, from 
-                   http://xerces.apache.org/xerces2-j
-    
-
-To build the unit test sources contained in the test directory and 
-run unit tests, additionally install and configure the following tools:
-
-+ JUnit          - Testing framework 3.8.1 or higher, from http://junit.org 
-
-
-3. BUILDING CLASS LIBRARIES
----------------------------
-
-Build the Harmony class libraries. For building instructions, see the README.txt
-file deployed with the class libraries bundle.
-
-Copy the contents of the deploy\jre directory of the class libraries into deploy\jre
- directory of the Harmony execution environment.
-
-Set up the environment variables in the following way: 
-
-+ PATH must point to the location of Ant. 
-+ CLASSPATH must point to the Eclipse* compiler .jar files, to the Harmony class libraries,
and to kernel.jar
-  from the Harmony execution environment. An example of the CLASSPATH variable on Windows*:
-
-      CLASSPATH=%ECLIPSE_HOME%\plugins\org.eclipse.jdt.core_3.0.1\jdtCompilerAdapter.jar;
\
-          %ECLIPSE_HOME%\plugins\org.eclipse.jdt.core_3.0.1\jdtcore.jar; \
-          %JAVA_HOME%\bin\default\kernel.jar;C:\Harmony\bin;C:\junit3.8.1\junit.jar
-
-NOTE: All paths must be absolute. 
-
-To start the build, change the directory into <EXTRACT_DIR>/Harmony/make 
-and run Apache Ant by typing: 
-    
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter 
-
-Ant runs against the default target and compiles all Java* sources from the 
-<EXTRACT_DIR>/Harmony/src folder.
-
-You can also build sources of individual components by using the following 
-commands:  
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter jar.beans
-        for BEANS component
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter jar.regex
-        for REGEX component
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter jar.math
-        for MATH component
-
-The build produces a set of .class and .jar files.
-These files are placed in the following directory 
-tree structure:
-
-<EXTRACT_DIR>/Harmony/build
-       |
-       +---classes                  compiled class files
-       |
-       +---deploy
-             |
-             \---jdk
-                 \---jre
-                      |
-                      |
-                      \---lib
-                          |
-                          +---boot
-                                 |
-                                 +--- beans.jar
-                                 +--- math.jar
-                                 \--- regex.jar
-       
-
-NOTE: To build regex and math packages in a self-hosting environment on Linux*, you also
need 
-to set up the LD_LIBRARY_PATH variable to point to the bin directory of the Harmony JRE.
Make sure
-that all environment variables are exported
-
-
-4. RUNNING CLASS LIBRARIES WITH AN EXTERNAL VM
-----------------------------------------------
-
-To run an application on a third-party JRE using the classes provided with this 
-contribution, prepend the bootclasspath with beans.jar, regex.jar and math.jar. 
-
-Example:
-java -Xbootclasspath/p:c:\jre\lib\boot\beans.jar;c:\jre\lib\boot\regex.jar;c:\jre\lib\boot\math.jar
MyApp
-
-NOTE: Certain third-party environments have internal dependencies on their 
-beans, regex or math classes. As a workaround for these errors, 
-try removing classes with such dependencies.
-
-
-5. BUILDING AND RUNNING TESTS
------------------------------
-
-Verify the values for the following environment variables: 
-
-+ PATH must point to the location of Ant. 
-+ CLASSPATH must point to the location of JUnit classes (normally, junit.jar).
-+ <EXTRACT_DIR>/Harmony/make/external_tools.properties must contain valid
-paths to JUnit and Xerces implementation classes (normally "junit.jar", "xercesImpl.jar"
and "xml-apis.jar").
-
-NOTE: All paths must be absolute.
-
-To build and run all tests in the <EXTRACT_DIR>/Harmony/make directory, run 
-
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter tests.run 
-
-Running this target compiles all api and tests sources (if necessary) and runs tests. 
-
-You can also run all unit test suites for individual components by using
-the following commands:
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter test.beans
-        for BEANS component
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter test.regex
-        for REGEX component
-    ant -Dbuild.compiler=org.eclipse.jdt.core.JDTCompilerAdapter test.math
-        for MATH component
-
-The build produces a set of unit tests' class files and test results. 
-These files are in the following directory tree structure:
-
-<EXTRACT_DIR>/Harmony/build
-       |
-       |
-       +--- tests                          compiled unit tests
-       |
-       +--- test-reports                   test results
-
-
-
-6. KNOWN ISSUES
----------------
+KNOWN ISSUES
+------------
 
 - Unit tests for the beans package may fail in the Harmony self-hosting 
   environment due to the incomplete functionality of stub classes in awt
@@ -204,8 +20,8 @@
 although they work rather efficiently. These methods might be rewritten in a more comprehensive
form.  
 
 
-7. TODO
---------
+TODO
+----
 
 - Implement canonical equivalence support in regex.
 
@@ -223,9 +39,3 @@
 multiplication by using BigInteger.TEN. These mechanisms are widely used in the BigDecimal
implementation.
 
 - Optimize the BigInteger.toString() method.
-
-
-8. DISCLAIMER AND LEGAL INFORMATION
-------------------------------------
-
-*) Other brands and names are the property of their respective owners.



Mime
View raw message