pjs/java/plugins/README

Java-Implemented Plug-ins.
================================
http://www.mozilla.org/projects/blackwood/java-plugins/
--------------------------------
This directory contains the beginnings of the Java-Implemented plug-uns.

The sources is divided into four directories

	classes
	       Java source files
	src 
	       Native code (c++/c)
	jni
	       Implamentations of java native methods
	test
	       Test code, including simple pluglet.

========================================================================
Win32 Directions:
========================================================================
Requirements:

* current mozilla built tree

* JDK1.3 or JDK1.2 if you are not using OJI

* Perl 5 perl.exe must be in your path

How To Build:

*  make sure the environment var JDKHOME is set to your jdk installation
   directory, ie SET JDKHOME=C:\jdk1.2

* if you do not have working OJI set OJI_DISABLE to 1
  (You can do it in your command prompt, or you can set it in 
   mozilla/java/plugins/src/makefile.win).

* type "nmake /f makefile.win"

How to Run:

* Add following directories to to your path:
  %MOZILLA_FIVE_HOME%
  In case OJI_DISABLE add %JDKHOME%\jre\bin\client to your path

* Copy class files from mozilla/dist/classes to your JRE/lib/ext directory and
add JRE/lib/ext to your classpath
 
How to build and run test
* go to the test directory and type "nmake /f makefile.win"

* Set PLUGLET environment to the  directory you have test.jar

* Run mozilla and load page test.html from test directory and if everething is ok you will see
  some awt demo.


=========================================================================
Unix (Sparc Solaris and i386 Linux) Directions:
=========================================================================

Requirements:

* current mozilla built tree

* JDK1.3 

* Perl 5 must be in your path

How To Build:

*  make sure the environment var JDKHOME is set to your jdk installation
   directory, ie export  JDKHOME=/usr/local/jdk1.3

* Add following directories to to your LD_LIBRARY_PATH:

$MOZILLA_FIVE_HOME:$JDKHOME/jre/lib/$HOSTTYPE/native_threads:$JDKHOME/jre/lib/$HOSTTYPE/client:
$JDKHOME/jre/lib/$HOSTTYPE/:

* type "gmake"
     
How to Run:
	 
* Add $MOZILLA_FILE_HOME/../classes to your CLASSPATH

How to build and run test

* go to the test directory and type "gmake"
  test.jar will be placed  in mozilla/dist/bin/plugins directory

* set LD_PRELOAD to libXm.so (to libawt.so on linux platform)

* Run mozilla and load page resource:///res/javadev/pluglets/test.html and if everething is ok you will see  some awt demo.
  
  
========================================================================

Problems:

* post to netscape.public.mozilla.java newsgroup