We (Svein Erik Løvland and Henrik Holum) have updated the building.txt
document for Derby Trunk. We built the code following every step of the
document, and here are our suggested changes. A review of the changes
would be appresiated.
Removed the empty subsections, and updated the section and subsection
numbers. We also updated the references according to the new subsection
numbers.
Removed 2.2.3 and 2.2.4
Renamed 2.2.5 -> 2.2.3, 2.2.6 -> 2.2.4 and 2.2.7 -> 2.2.5
2.1
Added 3 directories
2.2.1 (1)
Changed the URL so it points directly to a folder were you can find the
correct version.
Can we use Ant 1.7.0, or do we have to use 1.6.x? If 1.7 can be used,
the old link (http://ant.apache.org/bindownload.cgi) can still be used,
but then the text in this section should be updated to indicate that you
don't have to use 1.6.x.
2.2.2 (2) and (4) (Windows)
Updated the URLs to point directly to download pages for the desired
java versions
2.2.3 (Previous 2.2.5)
Can we use Junit 3.8.2 or does it have to be 3.8.1? if Junit 3.8.2 can
be used the link can be replaced with
http://kent.dl.sourceforge.net/sourceforge/junit/junit3.8.2.zip. Also
update the text to indicate these changes (3.8.*)
2.2.5 (Previous 2.2.7)
Moved the Optional tag to be consistent with 2.2.4 (Previous 2.2.6)
We updated references in the note to reflect the new subsection number.
3.3 (3)
Updated the number of jar files with local support to 13 instead of 9.
We have used Windows XP, so we have not checked the *nix or Mac settings.
Hope this is helpfull
-Henrik and Svein Erik
Index: C:/prosjekter/Derby_trunk/BUILDING.txt
===================================================================
--- C:/prosjekter/Derby_trunk/BUILDING.txt (revision 590069)
+++ C:/prosjekter/Derby_trunk/BUILDING.txt (working copy)
@@ -28,11 +28,9 @@
2.2 Download required software
2.2.1 Download and install Apache Ant 1.6.3 or higher
2.2.2 Download and install Java Development Kit release 1.4.x
-2.2.3 section removed - no longer applies
-2.2.4 section removed - no longer applies
-2.2.5 Download and install JUnit 3.8.*
-2.2.6 Download Java 6 Development Kit (Optional)
-2.2.7 Download J2ME/CDC/Foundation 1.0 and JSR169 jars (Optional)
+2.2.3 Download and install JUnit 3.8.*
+2.2.4 Download Java 6 Development Kit (Optional)
+2.2.5 Download J2ME/CDC/Foundation 1.0 and JSR169 jars (Optional)
3 Build instructions
3.1 Set required environmental variables
@@ -101,11 +99,13 @@
there should be the following files and directories:
${derby.source}/build.xml
+${derby.source}/bin
${debry.source}/java
+${derby.source}/maven
+${derby.source}/plugins
${derby.source}/tools
-
2.2 Download required software
This section lists all the required software for Derby
@@ -136,7 +136,7 @@
2.2.1 Download and install Apache Ant 1.6.3 or higher
(1) Download a binary distribution of Ant 1.6.x from:
- http://ant.apache.org/bindownload.cgi
+ http://archive.apache.org/dist/ant/binaries/
(2) Install Ant 1.6.x in any directory. This
directory will be referred to as ${ant.dir}
@@ -150,7 +150,7 @@
(1) Download JDK 1.4.x.
The reference implementation is available at:
- http://java.sun.com/j2se
+ http://java.sun.com/j2se/1.4.2/download.html
For MacOS X, get the latest download from:
http://developer.apple.com/java/download
@@ -168,7 +168,7 @@
(4) Download the Java 5 or later JDK.
The reference implementation is available at:
- http://java.sun.com/javase
+ http://java.sun.com/javase/downloads/index_jdk5.jsp
For MacOS X, get the latest download from:
http://developer.apple.com/java/download
@@ -179,12 +179,8 @@
(6) The directory where you have installed the Java 5 JDK will be
referred to as ${java5.dir} in the rest of this document.
-2.2.3 section removed - no longer applies
+2.2.3 Download and install JUnit 3.8.*
-2.2.4 section removed - no longer applies
-
-2.2.5 Download and install JUnit 3.8.*
-
(1) JUnit is needed for some of Derby's tests. Download a JUnit 3.8.1
from
@@ -198,7 +194,7 @@
${derby.source}/tools/java.
-2.2.6 Optional - Download and install Java 6 Development Kit (JDK)
+2.2.4 Optional - Download and install Java 6 Development Kit (JDK)
Skip steps 1-2 of this section if you already have the Java 6 JDK
@@ -216,10 +212,8 @@
referred to as ${jdk16.dir} in the rest of this document.
-2.2.7 Download J2ME/CDC/Foundation and JSR 169 jars
+2.2.5 Optional - Download J2ME/CDC/Foundation and JSR 169 jars
-This is an optional section.
-
Derby's embeded engine supports J2ME/CDC/Foundation 1.0 using the JDBC
sub-set defined in JSR 169. In order to build Derby to
support this platform, jars are needed for the Foundation 1.0
@@ -236,7 +230,7 @@
-Note: After following the steps in sections 2.2.4-2.2.7 of this
+Note: After following the steps in sections 2.2.3-2.2.5 of this
document, you should have the following:
${derby.source}/tools/java/empty.jar
@@ -402,7 +396,7 @@
- Optional - jsr169compile.classpath
- If you downloaded the J2ME jar files (section 2.2.7) then
+ If you downloaded the J2ME jar files (section 2.2.5) then
setting this property will enable the optional JSR169 targets
for the top-level default, engine or all targets.
The compile classpath needs to include the Foundation 1.0
@@ -475,7 +469,7 @@
set your JAVA_HOME to the Java 6 JDK. Instead, set it
to your standard JDK 1.4 or JDK 1.3 location. In your ant.properties,
make sure you set jdk16 as described in section
- 2.2.4, and that is all you need to do.
+ 3.2 (2), and that is all you need to do.
(3) Run the following command to build all jars:
@@ -486,7 +480,7 @@
- derby.jar (database engine),
- derbytools.jar (utilities: sysinfo, dblook, ij)
- derbynet.jar (network server).
- - derbyLocale_*.jar (9 jar files with locale support).
+ - derbyLocale_*.jar (13 jar files with locale support).
- derbyclient.jar (derby network client)
If the tests were built, the following jar file will also be built:
- derbyTesting.jar (the test framework and related files)
