svn commit: r950841 - in /jakarta/bsf/branches/bsf3.x: README distribution/src/bin/README

[se...@apache.org]

Author: sebb
Date: Thu Jun  3 00:58:38 2010
New Revision: 950841

URL: http://svn.apache.org/viewvc?rev=950841&view=rev
Log:
Move to top-level directory

Added:
    jakarta/bsf/branches/bsf3.x/README
      - copied, changed from r947292, jakarta/bsf/branches/bsf3.x/distribution/src/bin/README
Removed:
    jakarta/bsf/branches/bsf3.x/distribution/src/bin/README

Copied: jakarta/bsf/branches/bsf3.x/README (from r947292, jakarta/bsf/branches/bsf3.x/distribution/src/bin/README)
URL: http://svn.apache.org/viewvc/jakarta/bsf/branches/bsf3.x/README?p2=jakarta/bsf/branches/bsf3.x/README&p1=jakarta/bsf/branches/bsf3.x/distribution/src/bin/README&r1=947292&r2=950841&rev=950841&view=diff
==============================================================================
--- jakarta/bsf/branches/bsf3.x/distribution/src/bin/README (original)
+++ jakarta/bsf/branches/bsf3.x/README Thu Jun  3 00:58:38 2010
@@ -1,7 +1,7 @@
 BSF 3.1
 -------
 
-The BSF 3.1 binary release contains several jars:
+The BSF 3.1 binary release contains 3 jars:
 
 bsf-api-3.1.jar
 - this contains all the javax.script classes as defined in the
@@ -9,20 +9,27 @@ bsf-api-3.1.jar
   dependency when the application is using javax.script classes
   in a version of Java prior to 1.6 (which includes the classes)
 
-bsf-engines-3.1.jar
-- this contains several JSR-223 script engine factories 
-  which enable a script language to be used via the javax.script
-  APIs. This jar does not include the actual script language 
-  implementations, these need to be obtained separately.
-
 bsf-utils-3.1.jar
 - this contains various BSF specific utilities which aid using
   script languages from Java applications. 
 
 bsf-all-3.1.jar
-- this contains all the other BSF jars merged into a single jar for 
+- this contains both the other BSF jars merged into a single jar for 
   ease of use. If you're not sure which jar to use then use this one.
 
 BSF 3.1 is compatible with Java 1.4.2 and above. Specific script 
 languages may have further requirements on the Java version.  
 
+IMPORTANT
+=========
+Note that BSF 3.1 does not contain bsf-engines.jar, which was a repackaging
+of the JSR-223 factories from https://scripting.dev.java.net/.
+
+This is because:
+- the jar contained all the engine factories as a single bundle. It was not
+  possible to select individual factories, and this could lead to clashes with
+  other factories on the classpath.
+- the jar did not contain any implementations, so it was still necessary to download
+  the engine.
+Many engines contain their own factories now; for those that don't the factory can
+still be downloaded from https://scripting.dev.java.net/.



---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@jakarta.apache.org
For additional commands, e-mail: notifications-help@jakarta.apache.org