gecko-dev/java/plugins/test/README

To build and test the Pluglet tests
======================================

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

* built org.mozilla.pluglet java classes (See NOTE)
 
========================================================================
Win32 Directions:
========================================================================
How To Build and Run :
 
*  make sure the following  environment var are set

   -  JDKHOME is set to your jdk installation directory, 
    ie  SET JDKHOME=C:\jdk1.3.

   - MOZILLA_FIVE_HOME

   - add C:\jdk1.3\jre\lib\ext to your classpath.

* Edit <TEST_TOP_DIR>/config/CommonProperties file

   - Comment /uncomment the appropriate FSEP variable

  - Modify TEST_TOP_DIR. Set it to The root directory of this pluglet 
     API test suite
     eg: <top>/mozilla/java/plugins/test

  - Modify HTML_ROOT .Set it to
     The URL of directory where the htmls of tests are placed
     eg: http://machine:port/<some-test-dir>

 
*  Edit <TEST_TOP_DIR>/config/set_env.bat

    - Modify HTML_ROOT_DIR var
        eg: set HTML_ROOT_DIR=c:\some-webserver\public_html\<some-test-dir>

    - run set_env.bat

*  Edit <TEST_TOP_DIR>/config/SecurityTests.keys
   
    - Replace every occurance of Host sirius with your Host name
      and port with your active port number.

* cd <TEST_TOP_DIR>/src/org/mozilla/pluglet/test/basic

    type nmake -f makefile.win  

* Once build is successful

   run this using the perl script

   perl autorun.pl -f BWTest.lst

*  Results of the tests are recorded  under <TEST_TOP_DIR>/log/


=========================================================================
Unix  Directions:
=========================================================================

How To Build and Run :
 
*  make sure the following  environment var are set

   -  JDKHOME is set to your jdk installation directory, 
    ie setenv JDKHOME /usr/local/java/jdk1.3/solaris

   - MOZILLA_FIVE_HOME 
     ie setenv MOZILLA_FIVE_HOME <..>/mozilla/dist/bin

   -LD_LIBRARY_PATH is set to
    setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${MOZILLA_FIVE_HOME}:${JDKHOME}/jre/lib/sparc/native_threads:${JDKHOME}/jre/lib/sparc/classic:${JDKHOME}/jre/lib/sparc

   -CLASSPATH is set to
   setenv CLASSPATH ${CLASSPATH}:<..>/mozilla/dist/classes 

  - HTML_ROOT_DIR is set to
    setenv HTML_ROOT_DIR /<webserver-rootdir>/public_html/<some-test-dir>
  

* Edit <TEST_TOP_DIR>/config/CommonProperties file

   - Comment /uncomment the appropriate FSEP variable

  - Modify TEST_TOP_DIR. Set it to The root directory of this pluglet 
     API test suite
     eg: <top>/mozilla/java/plugins/test

  - Modify HTML_ROOT .Set it to
     The URL of directory where the htmls of tests are placed
     eg: http://machine:port/<some-test-dir>

*  Edit <TEST_TOP_DIR>/config/SecurityTests.keys
   
    - Replace every occurance of Host sirius with your Host name
      and port with your active port number.

* cd <TEST_TOP_DIR>/src/org/mozilla/pluglet/test/basic

    type make .. and hope for the best

* Once build is successful

   run this using the perl script

   perl autorun.pl -f BWTest.lst

*  Results of the tests are recorded  under <TEST_TOP_DIR>/log/

NOTE
=====
 Pluglets must be successfully built before these tests can be run.
 To build Pluglets follow instructions under /mozilla/java/plugins/README