update_README

java/README

@@ -1,36 +1,55 @@
-Here lies the code that comprises the java enhancers to mozilla.
+20030713
 
-Authors: see the README files for each individual subdirectory
+This README documents the Java Enhancers to the Mozilla web browser.
+
+Currently, the only active sub-project is the Webclient Java API to the
+Mozilla web browser.  This project also leverages the JavaDOM
+sub-project.
 
 Requirements:
 
-* JDK1.2 or greater (may work with lower versions, haven't checked).
+* J2SDK 1.3.1 or later
 
-* Successfully built MOZ_DEBUG=1 Mozilla M13 tree.
+* Apache ant 
 
-* Perl 5 perl.exe must be in your path
+* Successfully built debug enabled Mozilla 1.4 tree
 
 How To Build:
 
-* make it so the directory in which this file resides is a child of your
-  top level Mozilla M13 directory
+* cd to the directory above your top level mozilla directory and cvs
+  checkout the Webclient module.
 
-* make sure the environment var JDKHOME is set to your jdk installation
-  directory, ie SET JDKHOME=C:\jdk1.2.2
+* Modify mozilla/allmakefiles.sh and prepend the contents of the file
+  "makefiles", in this directory, to add_makefiles section after the
+  "Common makfiles used by everyone" comment.
 
-* type "nmake /f makefile.win all" and hope for the best
+* re-run ./configure to generate the java makefiles
 
-* this should compile the clasess into %MOZ_SRC%\dist\classes
+* put the "mozilla/dist/bin" directory in your LD_LIBRARY_PATH on Unix,
+  or PATH on Win32.
 
-Problems:
+* set the value of the environment var MOZ_JDKHOME to be your J2SDK
+  directory.
 
-* clobber_all doesn't remove the .class files from dist\classes.  You
-  have to do this manually.
+* Create a build.properties file in the mozilla/java directory with the
+  following contents.
+
+######
+build.unix.classes=true
+build.home=/home/edburns/Projects/mozilla/MOZILLA_1_4/mozilla/dist/classes
+compile.debug=true
+######
+
+  Of course, set the values of the above properties correctly according
+  to your system.
+
+* run "ant" in the mozilla/java directory.  This will build webclient
+  and all dependent libraries.  
+
+* cd to mozilla/java/webclient/src_moz and run the "runem" batch file to
+  run the test browser.
+
+Problems?
 
 * post to netscape.public.mozilla.java newsgroup
 
-General notes:
-
-* Please update the ChangeLog (changelo) files in the subdirectories when
-  you make changes.
-