Index: ossp-pkg/js/README
RCS File: /v/ossp/cvs/ossp-pkg/js/README,v
rcsdiff -q -kk '-r1.5' '-r1.6' -u '/v/ossp/cvs/ossp-pkg/js/README,v' 2>/dev/null
--- README	2006/07/22 19:43:48	1.5
+++ README	2006/07/22 20:02:43	1.6
@@ -10,19 +10,44 @@
 
   ABSTRACT
 
-  OSSP js is a stand-alone repackaging of the JavaScript (JS)
-  programming language reference implementation from Mozilla (aka
-  "JSRef" or "SpiderMonkey"). The reason for this distribution is
-  to provide a small and fully stand-alone distribution providing a
-  portable and more flexible build environment based on GNU autoconf,
-  GNU libtool and GNU shtool, including support for easy JavaScript
-  build-time feature set selection (ECMA-3, JS-1.5, JS-1.6) and optional
-  line editing and JS-to-Perl binding support during building the
-  command line interface. Additionally, the C API in "libjs" contains
-  both the JavaScript engine and its required Sun math library and with
-  all internal symbols protected under the "js" namespace. Finally,
-  a pkg-config(1) specification is provided to allow applications to
-  easily build with the JavaScript C API.
+  OSSP js is a stand-alone distribution of the JavaScript (JS)
+  programming language reference implementation from Mozilla -- aka
+  "JSRef" or "SpiderMonkey". The reason for this distribution is to
+  provide a smart, stand-alone and portable distribution of Mozilla
+  JavaScript through a build environment based on GNU autoconf, GNU
+  libtool and GNU shtool, including support for easy JavaScript
+  build-time feature set selection (ECMA-3, JS-1.5, JS-1.6) and
+  optional line editing and JS-to-Perl binding support during building
+  the command line interface. Additionally, the C API in "libjs"
+  contains both the JavaScript engine and the required Sun math library
+  ("fdlibm") and with all internal symbols carefully protected under the
+  "js" namespace. Finally, a pkg-config(1) specification is provided to
+  allow applications to easily build with the JavaScript C API.
+
+  JUSTIFICATION
+
+  OSSP js was created because for OSSP and similar pedantic C coding
+  projects a smart, stand-alone, portable, clean, powerful and
+  robust scripting language engine is required. JavaScript is a
+  great programming language and Mozilla JavaScript "SpiderMonkey"
+  definitely is an acceptable clean, powerful and robust implementation.
+  Unfortunately there is just a stand-alone distribution released from
+  time to time by Mozilla and it is far away from really being smart,
+  stand-alone and portable. At least for OSSP it was not acceptable
+  having to tell the community that for small and stand-alone C
+  components like the OSSP components they either have to install the
+  great but large Mozilla Firefox application (where Mozilla JavaScript
+  is included) or have to fiddle around theirself with an older
+  stand-alone JavaScript distribution and its weak build environment.
+  OSSP js combines the best from two worlds: the 1:1 repackaged
+  JavaScript code base from Mozilla and the usual amount of GNU
+  autoconf, GNU libtool and GNU shtool wrappers as always used by OSSP.
+
+  VERSIONING
+
+  The version of OSSP js is M.N.YYYYMMDD where M.N is the JavaScript
+  branch and YYYYMMDD is the date where the JavaScript code was
+  extracted from the Mozilla CVS repository.
 
   COPYRIGHT AND LICENSE