db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bernt M. Johnsen" <Bernt.John...@Sun.COM>
Subject Re: Suggested changes to Building.txt trunk
Date Wed, 31 Oct 2007 08:41:30 GMT
Great work! But, as Rick said, please create a jira issue and upload a
patch for the change there. Then, one of the committers can review and
apply the patch and commit the changes. See
http://wiki.apache.org/db-derby/DerbyDev and and
http://db.apache.org/derby/derby_comm.html for details.


>>>>>>>>>>>> Henrik Holum wrote (2007-10-30 16:21:16):
> 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.

You don't have to use 1.6. I use 1.7 myself (thorugh Netbeans).

> 
> 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)


-- 
Bernt Marius Johnsen, Database Technology Group, 
Staff Engineer, Derby/Java DB
Sun Microsystems, Trondheim, Norway

Mime
View raw message