db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From fuzzylo...@apache.org
Subject svn commit: r171003 - /incubator/derby/code/trunk/BUILDING.txt
Date Thu, 19 May 2005 22:14:27 GMT
Author: fuzzylogic
Date: Thu May 19 15:14:25 2005
New Revision: 171003

URL: http://svn.apache.org/viewcvs?rev=171003&view=rev
Add information on building and using Derby for Mac OS X. Original patch by
Craig Russell <Craig.Russell@sun.com>.


Modified: incubator/derby/code/trunk/BUILDING.txt
URL: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/BUILDING.txt?rev=171003&r1=171002&r2=171003&view=diff
--- incubator/derby/code/trunk/BUILDING.txt (original)
+++ incubator/derby/code/trunk/BUILDING.txt Thu May 19 15:14:25 2005
@@ -29,6 +29,7 @@
 4.2   Derby source code upgrade
 4.3   Derby build flow
+5     MacOS X Requirements
 1     About this document
@@ -63,7 +64,8 @@
     If there is any problem with any url, notify it
     via derby mailing list.
+(4) There are specific requirements for MacOS X that you
+    should read prior to doing anything else. See section 5.
@@ -133,6 +135,9 @@
     The reference implementation is available at:
+    For MacOS X, get the latest download from:
+       http://developer.apple.com/java/download
 (2) Install JDK 1.4.x according to the instructions included 
     with the release in any directory. 
@@ -144,7 +149,7 @@
 2.2.3 Download and install Java Development Kit (JDK) release 1.3.x
 Skip steps 1-2 of this section if you already have JDK 1.3.x 
-installed on your system.  
+installed on your system or if you are on MacOS X.  
 (1) Download JDK 1.3.x. 
     The reference implementation is available at:
@@ -282,7 +287,7 @@
 (2) Create a file called "ant.properties" in user home 
     directory and define the following variables in 
-    "ant.properties":
+    "ant.properties". For MacOS X, see section 5.
     NOTE TO WINDOWS USERS: *use forward slashes* ("/") in your
     path specifications.  Backward-slashes ("\") confuse Ant.
@@ -574,3 +579,73 @@
 At the end of the build, the properties files containing the 
 message files are copied into the output directory and the 
 version information properties files are generated.
+5   Mac OS X Requirements
+With Mac OS X, Java is now distributed as core technology, so no 
+downloads are needed except to upgrade to the latest release. The
+distribution includes both JDK 1.4 and JDK 1.3. Beginning with
+Mac OS X 10.4, JDK 1.5 may also be included as a supplemental
+download. However, only the JDK 1.4 and JDK 1.3 Java runtime
+libraries are needed to compile or run Derby.
+5.1   Mac OS X ant.properties
+For MacOS X, ant.properties is different from other environments,
+and should contain the following. Note that for readability, multiple
+jar files are shown as part of the classpath values, but they need
+to be entered on a single line in the properties file.
+5.2   Handling of RandomAccessFiles in Mac OS X 10.3
+MacOS X 10.3 with JDK 1.4.2 has a bug in the handling of RandomAccessFiles
+that causes problems with Derby. This bug causes an exception to be thrown
+when reopening a file using specific RandomAccessFile modes for write sync
+behavior, preventing Derby from creating or modifying a database on 
+Mac OS X 10.3 without the use of the following workaround. This bug has 
+been fixed in Mac OS X 10.4.
+For full details, please see DERBY-1 in JIRA:
+The workaround is to provide a derby.properties file with the entry:
+The derby.properties file should be located in your derby.system.home 
+directory. For more information, see:
+While this bug has been fixed in Mac OS X 10.4, please be aware that
+Derby applications that may be deployed on Mac OS X 10.3 will need the
+workaround described above to create or modify a Derby database.

View raw message