Return-Path: 
 <bsf-dev-return-1527-apmail-jakarta-bsf-dev-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-bsf-dev-archive@www.apache.org
Received: (qmail 65297 invoked from network); 13 Aug 2009 22:58:59 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 13 Aug 2009 22:58:59 -0000
Received: (qmail 29013 invoked by uid 500); 13 Aug 2009 22:59:06 -0000
Delivered-To: apmail-jakarta-bsf-dev-archive@jakarta.apache.org
Received: (qmail 28947 invoked by uid 500); 13 Aug 2009 22:59:06 -0000
Mailing-List: contact bsf-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:bsf-dev-unsubscribe@jakarta.apache.org>
List-Help: <mailto:bsf-dev-help@jakarta.apache.org>
List-Post: <mailto:bsf-dev@jakarta.apache.org>
List-Id: "Bean Scripting Framework developers" <bsf-dev.jakarta.apache.org>
Reply-To: "Bean Scripting Framework developers" <bsf-dev@jakarta.apache.org>
Delivered-To: mailing list bsf-dev@jakarta.apache.org
Received: (qmail 28929 invoked by uid 500); 13 Aug 2009 22:59:06 -0000
Received: (qmail 28926 invoked by uid 99); 13 Aug 2009 22:59:06 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 13 Aug 2009 22:59:06 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 13 Aug 2009 22:58:56 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id C9118238889D; Thu, 13 Aug 2009 22:58:35 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r804053 - /jakarta/bsf/trunk/xdocs/index.xml
Date: Thu, 13 Aug 2009 22:58:35 -0000
To: bsf-cvs@jakarta.apache.org
From: sebb@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20090813225835.C9118238889D@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: sebb
Date: Thu Aug 13 22:58:35 2009
New Revision: 804053

URL: http://svn.apache.org/viewvc?rev=804053&view=rev
Log:
Add some preliminary info on BSF 3.0

Modified:
    jakarta/bsf/trunk/xdocs/index.xml

Modified: jakarta/bsf/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewvc/jakarta/bsf/trunk/xdocs/index.xml?rev=804053&r1=804052&r2=804053&view=diff
==============================================================================
--- jakarta/bsf/trunk/xdocs/index.xml (original)
+++ jakarta/bsf/trunk/xdocs/index.xml Thu Aug 13 22:58:35 2009
@@ -43,12 +43,25 @@
                 Java objects to these scripting language engines.
         </p>
 
+<p>
+There are now two different versions of Apache BSF. These have different APIs. 
+The original version of BSF is represented by the BSF 2.x releases (current version 2.4), 
+and uses an API which was originally developed at IBM.
+The new version of Apache BSF is represent by the 3.x release (current version 3.0)
+The 3.x version uses the API defined as part of JSR-223 (javax.script),
+which is included in Java 1.6 onwards.
+However BSF 3.0 will run on Java 1.4+, allowing access to JSR-223 scripting
+for Java 1.4 and Java 1.5. 
+Apache BSF 3.0 is also useful for Java 1.6 as it contains a command-line utility for
+testing JSR-223 scripts, and it also contains a set of factory implementations for many
+languages.
+</p>
   </section>
 
-  <section name="Supported Languages">
+  <section name="Supported Languages - 2.x">
 
 <p>
-BSF supports several scripting languages currently:
+BSF 2.x supports several scripting languages currently:
 
 <ul>
    <li>
@@ -123,11 +136,28 @@
 
   </section>
 
-  <section name="Documentation">
+  <section name="Documentation (2.x)">
 
 <p>
-You can view the documentation for the current release (Jakarta BSF 2.4)
-<a href="manual.html">online</a>
+You can view the <a href="manual.html">documentation for BSF 2.4</a>.
+</p>
+
+<p>
+Documentation and examples are included in the source and binary distributions.
+</p>
+
+  </section>
+
+  <section name="Documentation (3.x)">
+
+<p>
+The following references describe the standard API (javax.script) which is implemented by BSF 3.0:
+<ul>
+<li><a href="http://jcp.org/aboutJava/communityprocess/final/jsr223/index.html">JSR-000223 Scripting for the Java Platform</a> - specification (PDF)</li>
+<li><a href="http://java.sun.com/javase/6/docs/api/javax/script/package-summary.html">Javadoc for javax.script classes</a> in Java 1.6</li>
+<li><a href="http://java.sun.com/developer/technicalArticles/J2SE/Desktop/scripting/">Scripting for the Java platform (Sun technical article)</a></li>
+</ul>
+Documentation on BSF 3.0 utilities and engines TBA.
 </p>
 
 <p>
@@ -142,71 +172,18 @@
     </p>
     <ul>
         <li>
-<!--
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/release/v2.3/bin/"></a>
--->
             <a href="http://jakarta.apache.org/site/downloads/downloads_bsf.cgi">
                         Download the binary release
              </a>
        </li>
 
         <li>
-<!--
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/release/v2.3/src/"></a>
--->
             <a href="http://jakarta.apache.org/site/downloads/downloads_bsf.cgi">
                          Download the source release
             </a>
         </li>
-
-
-<!--
-        <li>
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/release/v2.3/rpms/"></a>
-            Download source or binary RPMs</li>
--->
-
     </ul>
   </section>
-<!--
-  <section name="Development Release">
-    <p>
-    You can download the latest development release:
-    </p>
-    <ul>
-        <li>
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/dev/v2.4.0/bin/">
-            Download the development binary release</a>
-        </li>
-        <li>
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/dev/v2.4.0/src/">
-            Download the development source release</a>
-        </li>
-
-
-        <li>
-<a href="http://www.apache.org/dist/jakarta/jakarta-bsf/dev/v2.3.0/rpms/"></a>
-            Download development source or binary RPMs
-        </li>
-
-    </ul>
-  </section>
--->
-  <section name="Nightly Builds">
-    <p>
-    If you wish to use the latest BSF features, you can try downloading a nightly
-    build from <a href="http://jakarta.apache.org/builds/jakarta-bsf/nightly/">here</a>
-    </p>
-
-  </section>
-
-  <section name="Towards BSF 3.0">
-    <p>
-    We are beginning to discuss design details for BSF 3.0. Please
-    read the latest <a href="bsfnews.html">BSF news</a> for more details.
-    </p>
-  </section>
-
   <section name="Get Involved">
 <ul>
 <li><a href="http://jakarta.apache.org/getinvolved/getinvolvedindex.html">Get Involved</a></li>



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