docs/engines.md engines/browser/inline.js engines/browser/lib/binary.js engines/browser/lib/modules.js engines/browser/lib/reactor.js engines/browser/lib/system.js engines/default/lib/array.js engines/default/lib/binary-engine.js engines/default/lib/binary.js engines/default/lib/date.js engines/default/lib/file-engine.js engines/default/lib/function.js engines/default/lib/global.js engines/default/lib/io-engine.js engines/default/lib/json.js engines/default/lib/object.js engines/default/lib/os-engine.js engines/default/lib/reactor.js engines/default/lib/string.js engines/default/lib/system.js engines/helma/bin/narwhal-helma engines/helma/bootstrap.js engines/jaxer/README.md engines/jaxer/bootstrap.js engines/jaxer/lib/logger.js engines/k7/bin/narwhal-k7 engines/k7/bootstrap.js engines/k7/lib/binary.js engines/k7/lib/file-engine.js engines/k7/lib/io-engine.js engines/k7/lib/system.js engines/rhino/bin/narwhal-rhino engines/rhino/bin/narwhal-rhino.cmd engines/rhino/bootstrap.js engines/rhino/jars/jline.jar engines/rhino/jars/js.jar engines/rhino/lib/binary-engine.js engines/rhino/lib/file-engine.js engines/rhino/lib/http-engine.js engines/rhino/lib/io-engine.js engines/rhino/lib/md5.js engines/rhino/lib/os-engine.js engines/rhino/lib/packages-engine.js engines/rhino/lib/process.js engines/rhino/lib/sandbox-engine.js engines/rhino/lib/system.js engines/rhino/lib/zip.js engines/secure/lib/file.js engines/secure/lib/system.js engines/template/bin/narwhal-engine-name engines/template/bootstrap.js engines/template/lib/file-engine.js engines/template/lib/system.js engines/v8cgi/bootstrap.js engines/xulrunner/.gitignore engines/xulrunner/LICENSE engines/xulrunner/README.md engines/xulrunner/apps/firenarwhal/application.ini engines/xulrunner/apps/firenarwhal/chrome/branding/about.png engines/xulrunner/apps/firenarwhal/chrome/branding/aboutCredits.png engines/xulrunner/apps/firenarwhal/chrome/branding/aboutFooter.png engines/xulrunner/apps/firenarwhal/chrome/branding/icon48.png engines/xulrunner/apps/firenarwhal/chrome/branding/icon64.png engines/xulrunner/apps/firenarwhal/chrome/chrome.manifest engines/xulrunner/apps/firenarwhal/chrome/content/main.xul engines/xulrunner/apps/firenarwhal/chrome/locale/branding/brand.dtd engines/xulrunner/apps/firenarwhal/chrome/locale/branding/brand.properties engines/xulrunner/apps/firenarwhal/defaults/preferences/prefs.js engines/xulrunner/apps/firenarwhal/extensions/mozrepl@hyperstruct.net engines/xulrunner/apps/firenarwhal/extensions/narwhal@narwhaljs.org engines/xulrunner/apps/firenarwhal/firenarwhal engines/xulrunner/bin/narwhal-xulrunner engines/xulrunner/bootstrap.js engines/xulrunner/extensions/narwhal@narwhaljs.org/chrome.manifest engines/xulrunner/extensions/narwhal@narwhaljs.org/chrome/content/narwhal.js engines/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.idl engines/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.js engines/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.xpt engines/xulrunner/extensions/narwhal@narwhaljs.org/defaults/preferences/prefs.js engines/xulrunner/extensions/narwhal@narwhaljs.org/install.rdf engines/xulrunner/extensions/narwhal@narwhaljs.org/modules/narwhal.js engines/xulrunner/extensions/narwhal@narwhaljs.org/narwhal engines/xulrunner/lib/file-engine.js engines/xulrunner/lib/io-engine.js engines/xulrunner/lib/os-engine.js engines/xulrunner/lib/system.js engines/xulrunner/post-commit lib/narwhal/tusk/engine.js @@ -4,9 +4,9 @@ Narwhal A general purpose JavaScript platform ------------------------------------- -Narwhal is a cross-platform, multi-interpreter, general purpose JavaScript platform. It aims to provide a solid foundation for building JavaScript applications, primarily outside the web browser. Narwhal includes a package manager, module system, and standard library for multiple JavaScript interpreters. Currently Narwhal's [Rhino](http://www.mozilla.org/rhino/) support is the most complete, but [other platforms](platforms.html) are available too. +Narwhal is a cross-platform, multi-interpreter, general purpose JavaScript platform. It aims to provide a solid foundation for building JavaScript applications, primarily outside the web browser. Narwhal includes a package manager, module system, and standard library for multiple JavaScript interpreters. Currently Narwhal's [Rhino](http://www.mozilla.org/rhino/) support is the most complete, but [other engines](engines.html) are available too. -Narwhal's standard library conforms to the [ServerJS standard](https://wiki.mozilla.org/ServerJS). It is designed to work with multiple JavaScript interpreters, and to be easy to add support for new interpreters. Wherever possible, it is implemented in pure JavaScript to maximize reuse of code among platforms. +Narwhal's standard library conforms to the [ServerJS standard](https://wiki.mozilla.org/ServerJS). It is designed to work with multiple JavaScript interpreters, and to be easy to add support for new interpreters. Wherever possible, it is implemented in pure JavaScript to maximize reuse of code among engines. Combined with [Jack](http://jackjs.org/), a [Rack](http://rack.rubyforge.org/)-like [JSGI](http://jackjs.org/jsgi-spec.html) compatible library, Narwhal provides a platform for creating server-side JavaScript web applications and frameworks such as [Nitro](http://www.nitrojs.org/). @@ -37,7 +37,7 @@ Documentation * [How to Build Packages](packages-howto.html) * [Modules](modules.html) * [Virtual Environments / Seas](sea.html) -* [How to Build Platforms](platforms.html) +* [How to Build Engines](engines.html) * [How Narwhal Works](narwhal.html) README.md @@ -41,7 +41,7 @@ fi if [ -f "$PACKAGE_HOME"/narwhal.conf ]; then source "$PACKAGE_HOME"/narwhal.conf - export NARWHAL_DEFAULT_PLATFORM + export NARWHAL_DEFAULT_ENGINE fi if [ "$NARWHAL" ]; then bin/activate.bash @@ -14,35 +14,35 @@ done NARWHAL_HOME=$(dirname -- "$(dirname -- "$SELF_PATH")") # use Rhino as the default if none is specified in narwhal.conf -NARWHAL_DEFAULT_PLATFORM="rhino" +NARWHAL_DEFAULT_ENGINE="rhino" # load narwhal.conf if it exists if [ -f "$NARWHAL_HOME/narwhal.conf" ]; then source "$NARWHAL_HOME"/narwhal.conf fi -# if NARWHAL_PLATFORM isn't yet set, set it to the default platform, and export it -if [ -z "$NARWHAL_PLATFORM" ]; then - NARWHAL_PLATFORM=$NARWHAL_DEFAULT_PLATFORM +# if NARWHAL_ENGINE isn't yet set, set it to the default engine, and export it +if [ -z "$NARWHAL_ENGINE" ]; then + NARWHAL_ENGINE=$NARWHAL_DEFAULT_ENGINE fi export NARWHAL_HOME -# build the executable name for the platform -EXECUTABLE_NAME="narwhal-$NARWHAL_PLATFORM" +# build the executable name for the engine +EXECUTABLE_NAME="narwhal-$NARWHAL_ENGINE" -# search for the platform home directory +# search for the engine home directory # try narwhal.conf setting -if [ "$NARWHAL_PLATFORM_HOME" ]; then - export NARWHAL_PLATFORM_HOME +if [ "$NARWHAL_ENGINE_HOME" ]; then + export NARWHAL_ENGINE_HOME # try relative -elif [ -f "$NARWHAL_HOME/platforms/$NARWHAL_PLATFORM/bin/$EXECUTABLE_NAME" ]; then - export NARWHAL_PLATFORM_HOME="$NARWHAL_HOME/platforms/$NARWHAL_PLATFORM" +elif [ -f "$NARWHAL_HOME/engines/$NARWHAL_ENGINE/bin/$EXECUTABLE_NAME" ]; then + export NARWHAL_ENGINE_HOME="$NARWHAL_HOME/engines/$NARWHAL_ENGINE" # try $PATH elif which -s "$EXECUTABLE_NAME"; then - export NARWHAL_PLATFORM_HOME=$(dirname -- "$(dirname -- "$EXECUTABLE_NAME")") + export NARWHAL_ENGINE_HOME=$(dirname -- "$(dirname -- "$EXECUTABLE_NAME")") else - echo "Can't find executable for $NARWHAL_PLATFORM" + echo "Can't find executable for $NARWHAL_ENGINE" exit 1 fi -exec "$NARWHAL_PLATFORM_HOME"/bin/"$EXECUTABLE_NAME" "$@" +exec "$NARWHAL_ENGINE_HOME"/bin/"$EXECUTABLE_NAME" "$@" bin/narwhal @@ -5,25 +5,25 @@ setlocal set NARWHAL_HOME=%~dp0.. :: use Rhino as the default if none is specified in narwhal.conf -set NARWHAL_DEFAULT_PLATFORM=rhino +set NARWHAL_DEFAULT_ENGINE=rhino :: TODO: load narwhal.conf if it exists -:: if NARWHAL_PLATFORM isn't yet set, set it to the default platform, and export it -if "%NARWHAL_PLATFORM%" == "" ( - set NARWHAL_PLATFORM=%NARWHAL_DEFAULT_PLATFORM% +:: if NARWHAL_ENGINE isn't yet set, set it to the default engine, and export it +if "%NARWHAL_ENGINE%" == "" ( + set NARWHAL_ENGINE=%NARWHAL_DEFAULT_ENGINE% ) -:: build the executable name for the platform -set EXECUTABLE_NAME=narwhal-%NARWHAL_PLATFORM%.cmd +:: build the executable name for the engine +set EXECUTABLE_NAME=narwhal-%NARWHAL_ENGINE%.cmd -:: search for the platform home directory +:: search for the engine home directory :: TODO: look for more, including ".exe"? -if exist %NARWHAL_HOME%\platforms\%NARWHAL_PLATFORM%. ( - set NARWHAL_PLATFORM_HOME=%NARWHAL_HOME%\platforms\%NARWHAL_PLATFORM% +if exist %NARWHAL_HOME%\engines\%NARWHAL_ENGINE%. ( + set NARWHAL_ENGINE_HOME=%NARWHAL_HOME%\engines\%NARWHAL_ENGINE% ) else ( - echo "Can't find executable for %NARWHAL_PLATFORM%" + echo "Can't find executable for %NARWHAL_ENGINE%" exit ) -call %NARWHAL_PLATFORM_HOME%\bin\%EXECUTABLE_NAME% %* +call %NARWHAL_ENGINE_HOME%\bin\%EXECUTABLE_NAME% %* bin/narwhal.cmd @@ -1,4 +1,4 @@ -All platforms must support two types for interacting with binary data: ByteArray and ByteString. The ByteArray type resembles the interface of Array in that it is mutable, extensible, and indexing will return number values for the byte in the given position, zero by default, or undefined if the index is out of bounds. The ByteString type resembles the interface of String in that it is immutable and indexing returns a ByteString of length 1. These types are exported by the 'binary' top-level module and both types are subtypes of Binary, which is not instantiable but exists only for the convenience of referring to both ByteArray and ByteString. (The idea of using these particular two types and their respective names originated with Jason Orendorff in the [http://groups.google.com/group/serverjs/msg/89808c05d46b92d0 Binary API Brouhaha] discussion.) +All engines must support two types for interacting with binary data: ByteArray and ByteString. The ByteArray type resembles the interface of Array in that it is mutable, extensible, and indexing will return number values for the byte in the given position, zero by default, or undefined if the index is out of bounds. The ByteString type resembles the interface of String in that it is immutable and indexing returns a ByteString of length 1. These types are exported by the 'binary' top-level module and both types are subtypes of Binary, which is not instantiable but exists only for the convenience of referring to both ByteArray and ByteString. (The idea of using these particular two types and their respective names originated with Jason Orendorff in the [http://groups.google.com/group/serverjs/msg/89808c05d46b92d0 Binary API Brouhaha] discussion.) = Philosophy = @@ -6,7 +6,7 @@ This proposal is not an object oriented variation on pack and unpack with notion This proposal also does not provide named member functions for any particular subset of the possible charsets, codecs, compression algorithms, or consistent hash digests that might operate on a byte string or array. Instead, convenience member functions are provided for interfacing with any named charset, with the IANA charset name space, and with the possibility of eventually employing a system of modular extensions for other codecs or digests, requiring that the given module exports a specified interface. (As supported originally by Robert Schultz, Davey Waterson, Ross Boucher, and tacitly myself, Kris Kowal, on the [http://groups.google.com/group/serverjs/browse_thread/thread/be72ef3d8146731d/06c27162b698eef5?lnk=gst First proposition] thread on the mailing list). This proposal does not address the need for stream objects to support pipelined codecs and hash digests (mentioned by Tom Robinson and Robert Schultz in the same conversation). -This proposal also reflects both group sentiment and a pragmatic point about properties. This isn't a decree that properties like "length" should be consistently used throughout the ServerJS APIs. However, given that all platforms support properties at the native level (to host String and Array objects) and that byte strings and arrays will require support at the native level, pursuing client-side interoperability is beyond the scope of this proposal and therefore properties have been specified. (See comments by Kris Zyp about the implementability of properties in all platforms, comments by Davey Waterson from Aptana about the counter-productivity of attempting to support this API in browsers, and support properties over accessor and mutator functions by Ionut Gabriel Stand and Cameron McCormack on the [http://groups.google.com/group/serverjs/browse_thread/thread/be72ef3d8146731d/06c27162b698eef5?lnk=gst mailing list]). +This proposal also reflects both group sentiment and a pragmatic point about properties. This isn't a decree that properties like "length" should be consistently used throughout the ServerJS APIs. However, given that all engines support properties at the native level (to host String and Array objects) and that byte strings and arrays will require support at the native level, pursuing client-side interoperability is beyond the scope of this proposal and therefore properties have been specified. (See comments by Kris Zyp about the implementability of properties in all engines, comments by Davey Waterson from Aptana about the counter-productivity of attempting to support this API in browsers, and support properties over accessor and mutator functions by Ionut Gabriel Stand and Cameron McCormack on the [http://groups.google.com/group/serverjs/browse_thread/thread/be72ef3d8146731d/06c27162b698eef5?lnk=gst mailing list]). The byte types provide functions for encoding, decoding, and transcoding, but they are all shallow interfaces that defer to a charset manager module, and may in turn use a system level charset or use a pair of pure JavaScript modules to transcode through an array or stream of canonical Unicode code points. This behavior may be specified further in the future. docs/lib/binary.wiki @@ -140,7 +140,7 @@ The current working directory is used by all routines that resolve relative path :numeric id of the owner user ;; rdev Number :the device identifier for special files -;; size NUmber +;; size Number :total size in bytes ;; blockSize Number :preferred block size for file system IO, in bytes docs/lib/file.wiki @@ -6,7 +6,7 @@ This document provides information on how to use `bin/narwhal` through its command line options, environment variables, and configuration files, then descends into the exact maddenning details of how it goes about bootstrapping -and configuraing itself. +and configuring itself. Glossary @@ -100,22 +100,22 @@ Command Line Options Environment Variables --------------------- -* `NARWHAL_DEFAULT_PLATFORM` may be set in `narwhal.conf` to a - platform name like `rhino`, `v8`, or `xulrunner`. Use - `tusk platforms` for a complete list and consult the `README` in - that platform directory for details about its function and +* `NARWHAL_DEFAULT_ENGINE` may be set in `narwhal.conf` to a + engine name like `rhino`, `v8`, or `xulrunner`. Use + `tusk engines` for a complete list and consult the `README` in + that engine directory for details about its function and readiness for use. -* `NARWHAL_PLATFORM` may be set at the command line, but is - otherwise set to `NARWHAL_DEFAULT_PLATFORM` by `bin/narwhal` - and exposed in JavaScript as `system.platform`. This +* `NARWHAL_ENGINE` may be set at the command line, but is + otherwise set to `NARWHAL_DEFAULT_ENGINE` by `bin/narwhal` + and exposed in JavaScript as `system.engine`. This is the name of the JavaScript engine in use. * `NARWHAL_HOME` is the path to the `narwhal` directory and is available in JavaScript as `system.prefix`. -* `NARWHAL_PLATFORM_HOME` is the path to the narwhal - platform directory, where `bootstrap.js` may be found, +* `NARWHAL_ENGINE_HOME` is the path to the narwhal + engine directory, where `bootstrap.js` may be found, and is set by `bin/narwhal`. * `NARWHAL_PATH` and `JS_PATH` can be used to add @@ -164,10 +164,10 @@ Configuration Files * `narwhal.conf` may be provided to configure site-specific or virtual-environment (sea) specific environment - variables like `NARWHAL_DEFAULT_PLATFORM`. You can - also opt to specify `NARWHAL_PLATFORM`, but that obviates + variables like `NARWHAL_DEFAULT_ENGINE`. You can + also opt to specify `NARWHAL_ENGINE`, but that obviates the possibility of allowing the user to override - the narwhal platform at the command line. `narwhal.conf` + the narwhal engine at the command line. `narwhal.conf` follows the BSD convention of using shell scripts as configuration files, so you may use any `bash` syntax in this file. A `narwhal.conf.template` exists for @@ -211,7 +211,7 @@ Configuration Files Bootstrapping Narwhal --------------------- -Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` script, a platform specific `bash` script, a platform specific JavaScript, then the common JavaScript. +Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` script, an engine specific `bash` script, an engine specific JavaScript, then the common JavaScript. * `bin/narwhal` @@ -219,44 +219,44 @@ Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` for configuration. This script discovers its own location on the file system and sources `narwhal.conf` as a shell script to load any system-level configuration - variables like `NARWHAL_DEFAULT_PLATFORM`. From there, - it discerns and exports the `NARWHAL_PLATFORM` and - `NARWHAL_PLATFORM_HOME` environment variables. + variables like `NARWHAL_DEFAULT_ENGINE`. From there, + it discerns and exports the `NARWHAL_ENGINE` and + `NARWHAL_ENGINE_HOME` environment variables. It then executes the - platform-specific script, - `$NARWHAL_PLATFORM_HOME/bin/narwhal-$NARWHAL_PLATFORM`. + engine-specific script, + `$NARWHAL_ENGINE_HOME/bin/narwhal-$NARWHAL_ENGINE`. -* `platforms/{platform}/bin/narwhal-{platform}` +* `engines/{engine}/bin/narwhal-{engine}` - This `bash` script performs some platform-specific + This `bash` script performs some engine-specific configuration, like augmenting the Java `CLASSPATH` - for the Rhino platform, and executes the - platform-specific bootstrap JavaScript using the - JavaScript engine for the platform. + for the Rhino engine, and executes the + engine-specific bootstrap JavaScript using the + JavaScript engine for the engine. - Some platforms, like `k7` require the JavaScript engine - to be on the `PATH`. The Rhino platform just expects + Some engines, like `k7` require the JavaScript engine + to be on the `PATH`. The Rhino engine just expects Java to be on the `PATH`, and uses the `js.jar` included in the repository. -* `platforms/{platform}/bootstrap.js` +* `engines/{engine}/bootstrap.js` - This platform-specific JavaScript uses whatever + This engine-specific JavaScript uses whatever minimal mechanisms the JavaScript engine provides for reading files and environment variables to read and evaluate `narwhal.js`. `narwhal.js` evaluates to a function expression that accepts a zygotic `system` `Object`, to be replaced later by loading the `system` module proper. `bootstrap.js` provides a - `system` object with `global`, `evalGlobal`, `platform`, - a `platforms` Array, `print`, `fs.read`, `fs.isFile`, + `system` object with `global`, `evalGlobal`, `engine`, + a `engines` Array, `print`, `fs.read`, `fs.isFile`, `prefix`, `packagePrefixes`, and optionally `evaluate`, `debug`, or `verbose`. * `global` is the `global` `Object`. This is passed explicitly in anticipation of times when it will be much harder to grab this - object in platforms where its name varies + object in engines where its name varies (like `window`, or `this`) and where it will be unsafe to assume that `this` defaults to `global` for functions called anonymously. @@ -269,8 +269,8 @@ Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` it will be harder to call `eval` in a pristine scope chain. - * `platform` is a synonym for the `NARWHAL_PLATFORM` - environment variable, the name of the platform. + * `engine` is a synonym for the `NARWHAL_ENGINE` + environment variable, the name of the engine. This variable is informational. * `prefix` is a synonym for the `NARWHAL_HOME` @@ -288,18 +288,18 @@ Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` prefix appears first so that virtual environments can load their own package versions. - * `platforms` is an Array of platform names, used + * `engines` is an Array of engine names, used to extend the module search path at various stages - to include platform specific libraries. There will - usually be more than one platform in this Array. + to include engine specific libraries. There will + usually be more than one engine in this Array. For Rhino, it is `['rhino', 'default']`. The - `default` platform contains many "catch-all" modules - that, while being platform-specific, are also + `default` engine contains many "catch-all" modules + that, while being engine-specific, are also general enough to be shared among almost all - platforms. Other platforms are likely to share - dynamically linked C modules in a "c" platform, - and the "rhino" platform itself is useful for - the "helma" platform. + engines. Other engines are likely to share + dynamically linked C modules in a "c" engine, + and the "rhino" engine itself is useful for + the "helma" engine. * `print` is a temporary shortcut for writing a line to a logging console or standard output, favoring @@ -309,10 +309,10 @@ Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` which will be loaded later. The module loader uses `read` and `isFile` to load the initial modules. - * `evaluate` is a module evaluator. If the platform + * `evaluate` is a module evaluator. If the engine does not provide an evaluator, the `sandbox` module - has a suitable default, but some platforms provide - their own. For example, the "secure" platform + has a suitable default, but some engines provide + their own. For example, the "secure" engine injects a safe, hermetic evaluator. `evaluate` accepts a module as a String, and optionally a file name and line number for debugging purposes. @@ -341,15 +341,15 @@ Narwhal launches in stages. On UNIX-like systems, Narwhal starts with a `bash` * `narwhal.js` This is the common script that creates a module loader, - makes the global scope consistent across platforms, + makes the global scope consistent across engines, finishes the `system` module, parses command line arguments, loads packages, executes the desired program, and finally calls the unload event for cleanup or running a daemon event loop. -When Narwhal is embedded, the recommended practice is to load the `bootstrap.js` platform script directly, skipping the shell script phases. +When Narwhal is embedded, the recommended practice is to load the `bootstrap.js` engine script directly, skipping the shell script phases. -Some platforms, like Helma or GPSEE, may provide their own module loader implementation. In that case, they may bypass all of this bootstrapping business and simply include Narwhal as if it were a mere package. +Some engines, like Helma or GPSEE, may provide their own module loader implementation. In that case, they may bypass all of this bootstrapping business and simply include Narwhal as if it were a mere package. No system has been constructed for Windows systems yet. @@ -363,7 +363,7 @@ The `narwhal.js` script is the next layer of blubber. provides the means to construct a `require` function so all other modules can be loaded. * `global` module, monkey patches the transitive globals - so that every platform receives the same ServerJS + so that every engine receives the same ServerJS and EcmaScript 5 global object, or as near to that as possible. * `system` module, including the `file` and `logger` @@ -371,7 +371,7 @@ The `narwhal.js` script is the next layer of blubber. variable in all modules. * `narwhal` module parses arguments. * `packages` module loads packages. - * `packages-platform` loads jars for Java/Rhino. + * `packages-engine` loads jars for Java/Rhino. * run command * `unload` module sends an `unload` signal to any observers, usually for cleanup or to kick off event loops. @@ -394,11 +394,11 @@ only go to disk when the underlying module text has changed. Global Module ------------- -The global module is platform-specific, and there is sharable -version in the default platform. The purpose of the global +The global module is engine-specific, and there is sharable +version in the default engine. The purpose of the global module is to load modules like "json", "string", "array", and "binary", that monkey patch the globals if necessary to -bring every platform up to speed with EcmaScript 5 and +bring every engine up to speed with EcmaScript 5 and the ServerJS standard. @@ -427,7 +427,7 @@ for Narwhal, and an Easter egg. Packages Module --------------- -The packages module analyzes and installs packages, such that their libraries are available in the module search path, and also installs some platform-specific package components like Java archives at run-time. The package loader uses a five pass algorithm: +The packages module analyzes and installs packages, such that their libraries are available in the module search path, and also installs some engine-specific package components like Java archives at run-time. The package loader uses a five pass algorithm: * find and read package.json for every accessible package, collating them into a catalog. This involves a breadth @@ -444,13 +444,13 @@ The packages module analyzes and installs packages, such that their libraries ar in the module search path. * "analyze" the packages in order. This involves finding the library directories in each package, including - platform-specific libraries for all of the - `system.platforms`, and performing platform-specific + engine-specific libraries for all of the + `system.engines`, and performing engine-specific analysis like finding the Java archives (`jars`) installed in each package. * "synthesize" a configuration from the analysis. This involves setting the module search path, and performing - platform-specific synthesis, like installing a Java + engine-specific synthesis, like installing a Java class loader for the Java archives, and creating a new, global `Packages` object. docs/narwhal.md @@ -13,16 +13,16 @@ A package directory might have the following files and directories: * "src" for all buildable source code, including C and Java source code. * "jars" for Java class trees and archives. * "packages/{name}" for installed sub-packages. -* "platforms/{platform}" for platform-specific packages. +* "engines/{engine}" for engine-specific packages. * "parent" for an inherited package tree, like the "narwhal" package installed by the system administrator or OS package management system. "package.json" and "local.json" may contain the following attributes: * "name" - the name of the package. The package system will only load one package with a given name. The name defaults to the name of the parent directory. * "lib" - a path or array of paths to top-level module directories provided in this package. Defaults to ["lib"]. -* "jars" - for Rhino platforms, a path or array of paths to directories to add to the Java CLASSPATH (uses a Java URLClassLoader, so accepts ".jar" paths and directory paths ending with "/"). +* "jars" - for Rhino engines, a path or array of paths to directories to add to the Java CLASSPATH (uses a Java URLClassLoader, so accepts ".jar" paths and directory paths ending with "/"). * "packages" - a path or array of paths to directories containing additional packages, defaults to ["packages"]. -* "platforms" - a path or array of paths to directories containing platform-specific packages, defaults to ["platforms"]. These platform packages will be loaded if and in the prioritized order they appear in the "system.platforms" array, and with higher priority that those in this package's generic "js" path so that they can override platform-specific modules. +* "engines" - a path or array of paths to directories containing engine-specific packages, defaults to ["engines"]. These engine packages will be loaded if and in the prioritized order they appear in the "system.engines" array, and with higher priority that those in this package's generic "js" path so that they can override engine-specific modules. * "main" - a path to a main program if the package is run with "bin/narwhal" and its directory instead of a specific script. * "author" - may be a comment on the package's author and email in angle brackets. * "contributors" - may be an array of additional author names and email addresses in angle brackets. docs/packages-howto.md @@ -15,5 +15,5 @@ Check out the [quick start guide](http://narwhaljs.org/quick-start.html) for ins * Complete [securable modules](https://wiki.mozilla.org/ServerJS/Modules/SecurableModules) implementation, in JavaScript, with hooks for native module loading. * Various modules, including `file`, `binary`, `os`, `system`, `args`, and many others. * The "tusk" package manager, currently using [Github](http://github.com/) as a package repository. -* Full support for the Rhino interpreter, and partial support for numerous other [platforms](http://narwhaljs.org/platforms.html). +* Full support for the Rhino interpreter, and partial support for numerous other [engines](http://narwhaljs.org/engines.html). * Full support for Mac OS X, Linux, and other Unixes. Preliminary support for Windows. docs/posts/2009-07-29-hello-0.1.md @@ -10,9 +10,9 @@ Download Narwhal. Put Narwhal on your PATH environment variable. * `export PATH=$PATH:~/narwhal/bin`, or -* execute `narwhal/bin/sea` for a quick Narwhal subshell +* `source narwhal/bin/activate` -Run `narwhal` or `js` (they're equivalent). +Run `narwhal` or `js` (they are equivalent). * `js narwhal/examples/hello` @@ -30,8 +30,9 @@ Create a project "hello-web". tusk init hello-web cd hello-web -Enter your project as a "virtual environment" using `sea` so that its libraries, binaries, and packages get automatically installed when you run Narwhal. +Enter your project as a "virtual environment" using `activate` or `sea` so that its libraries, binaries, and packages get automatically installed when you run Narwhal. + source bin/activate bin/sea Install some packages you will need, like Jack, the JSGI standard library for interoperable web services. docs/quick-start.md @@ -2,13 +2,13 @@ Narwhal, Tusk, and Sea ====================== -Narwhal is your JavaScript interpreter. It is executable with "narwhal" or "js". See "narwhal --help" for a list of its options. It is comparable to your shell, Python or Ruby/IRB. +Narwhal is your JavaScript interpreter. It is executable with `narwhal` or `js`. See `narwhal --help` for a list of its options. It is comparable to your shell, Python or Ruby/IRB. -Tusk is your package manager. Tusk by default installs packages whereever "narwhal" is installed. See "tusk help" for a list of options. It is comparable to "apt" or "gem". You can also use "tusk" to create new "packages", application project scaffolds, or "virtual environments", which are all the same thing. +Tusk is your package manager. Tusk by default installs packages whereever `narwhal` is installed. See `tusk help` for a list of options. It is comparable to `apt` or `gem`. You can also use `tusk` to create new "packages", application project scaffolds, or "virtual environments", which are all share a common structure. -"sea" is a tool for entering a Narwhal "virtual environment". It executes a command or reexecutes your shell inside a "virtual environment". There is a version of "sea" that comes packed with "Narwhal", which you can use to "enter" your system "narwhal" environment, which is handy if "narwhal/bin" is not on your path. You can also source "activate.sh" if your current working directory is the package root you want to use for your Sea. +`sea` is a tool for entering a Narwhal "virtual environment". It executes a command or reexecutes your shell inside a "virtual environment". There is a version of `sea` that comes packed with "Narwhal", that you can use to "enter" your system `narwhal` environment, which is handy if `narwhal/bin` is not on your path. You can also `source bin/activate`, as long as your version of bash supports the `${BASH_ARGV[0]}` notation, or if your current working directory contains `bin/activate`. -You can use "narwhal", "tusk", and "sea" to create multiple, independent, reproducable Narwhal project installations. Assuming that "narwhal" and "tusk" are on your path, you can use "tusk init" to create two application projects. +You can use `narwhal`, `tusk`, and `sea` to create multiple, independent, reproducable Narwhal project installations. Assuming that `narwhal` and `tusk` are on your path, you can use `tusk init` to create two application projects. $ tusk init foo $ tusk init bar @@ -36,13 +36,13 @@ You can use "narwhal", "tusk", and "sea" to create multiple, independent, reprod When you are in a Sea, Narwhal loads all of the packages installed in that Sea and Tusk installs packages in your Sea. While you can manipulate the NARWHAL_PATH and JS_PATH environment variables manually, Seas obviate the need. -Each sea can also have a different JavaScript engine. Edit narwhal.conf in your Sea to use a different engine. +Each sea can also have a different JavaScript engine. Edit `narwhal.conf` in your Sea to use a different engine. - $ js -e 'print(system.platform)' + $ js -e 'print(system.engine)' rhino $ cat bar/narwhal.conf NARWHAL_DEFAULT_PLATFORM=v8 - $ bar/bin/sea 'js -e "print(system.platform)"' + $ bar/bin/sea 'js -e "print(system.engine)"' v8 PATH=/bin SEALVL=0 docs/sea.md @@ -1,5 +1,5 @@ -// NOTE: portions of the "file" module are implemented in "file-bootstrap" and "file-platform", +// NOTE: portions of the "file" module are implemented in "file-bootstrap" and "file-engine", // which are loaded at the bottom of this file to allow for overriding default implementations var io = require('io'); @@ -84,7 +84,7 @@ exports.open = function (path, mode, options) { // abstraction var lineBuffering = buffering == 1 || buffering === undefined && raw.isatty && raw.isatty(); - // leaving buffering undefined is a signal to the platform implementation + // leaving buffering undefined is a signal to the engine implementation // that it ought to pick a good size on its own. if (buffering < 0) { throw new Error("invalid buffering size"); @@ -441,7 +441,7 @@ for (var i = 0; i < trivia.length; i++) { })(name); } -// load "file-bootstrap" and "file-platform", which in turn load "file" and modify it's module object. -// "platform" gets priority so it's loaded last. +// load "file-bootstrap" and "file-engine", which in turn load "file" and modify it's module object. +// "engine" gets priority so it's loaded last. require("file-bootstrap"); -require("file-platform"); +require("file-engine"); lib/file.js @@ -1,5 +1,5 @@ -var implementation = require('http-platform'); +var implementation = require('http-engine'); exports.open = function (url, mode, options) { // todo mode negotiation, particularly for binary vs text buffering lib/http.js @@ -1,10 +1,10 @@ -// IO: platform independent +// IO: engine independent -var implementation = require("io-platform"); +var engine = require("io-engine"); -for (var name in implementation) { - if (Object.prototype.hasOwnProperty.call(implementation, name)) { - exports[name] = implementation[name]; +for (var name in engine) { + if (Object.prototype.hasOwnProperty.call(engine, name)) { + exports[name] = engine[name]; } }; lib/io.js @@ -12,10 +12,10 @@ exports.Bundler = function (system) { var self = {}; system = util.copy(system); - system.platforms = util.copy(system.platforms); - system.platforms.unshift('browser'); + system.engines = util.copy(system.engines); + system.engines.unshift('browser'); var paths = util.copy(require.paths); - paths.unshift(system.prefix + '/platforms/browser/lib'); + paths.unshift(system.prefix + '/engines/browser/lib'); var loader = AttenuatedLoader(Loader({"paths": paths})); var sandbox = Sandbox({'loader': loader, 'system': system}); @@ -79,12 +79,12 @@ exports.Bundler = function (system) { }; self.bundle = function (id) { - var bootstrap = fs.path(module.path).resolve('../../platforms/browser/bootstrap.js').read(); + var bootstrap = fs.path(module.path).resolve('../../engines/browser/bootstrap.js').read(); return exports.jsmin(bootstrap).replace(/\s*$/, '') + '.call(this,' + self.factories(id) + ')'; }; self.inline = function (id, path) { - var inline = fs.path(module.path).resolve('../../platforms/browser/inline.js').read().replace(/\s*$/, ''); + var inline = fs.path(module.path).resolve('../../engines/browser/inline.js').read().replace(/\s*$/, ''); var ids = self.transitiveDependencies(id).concat(['sandbox']); util.sort(ids, util.by(function (id) { return -self.factory(id).length; lib/narwhal/server.js @@ -31,7 +31,7 @@ parser.command('search', null) parser.command('init', module.id + '/init'); -parser.command('platform', module.id + '/platform'); +parser.command('engine', module.id + '/engine'); parser.command('freeze', null) .help('writes a freeze.json file'); lib/narwhal/tusk.js @@ -28,9 +28,9 @@ parser.action(function (options, parentOptions) { path.join('.tusk').mkdirs(); path.join('bin').mkdirs(); path.join('lib').mkdirs(); - system.platforms.forEach(function (platform) { - platform = path.join('platforms', platform); - platform.join('lib').mkdirs(); + system.engines.forEach(function (engine) { + engine = path.join('engines', engine); + engine.join('lib').mkdirs(); }); path.join('packages').mkdirs(); @@ -45,7 +45,7 @@ parser.action(function (options, parentOptions) { path.join('README').touch(); path.join('narwhal.conf') - .write('NARWHAL_DEFAULT_PLATFORM=' + system.platform); + .write('NARWHAL_DEFAULT_ENGINE=' + system.engine); var packagePath = path.join('package.json'); if (packagePath.isFile()) util.complete( lib/narwhal/tusk/init.js @@ -1,8 +1,8 @@ -var platform = require('os-platform'); -for (var name in platform) { - if (Object.prototype.hasOwnProperty.call(platform, name)) { - exports[name] = platform[name]; +var engine = require('os-engine'); +for (var name in engine) { + if (Object.prototype.hasOwnProperty.call(engine, name)) { + exports[name] = engine[name]; } } lib/os.js @@ -9,13 +9,13 @@ exports.main = function main() { // to the loader and system. // this involves a breadth first search for packages // and packages within packages (readPackages), - // and performing platform-specific analysis and + // and performing engine-specific analysis and // synthesis. if (system.packagePrefixes === undefined) throw new Error( "system.packagePrefix is undefined in packages loader. " + - "(platform=" + system.platform + ")" + "(engine=" + system.engine + ")" ); exports.load(system.packagePrefixes); @@ -24,11 +24,11 @@ exports.main = function main() { exports.load = function (packagePrefixes) { - // the packages platform module, if it exists, - // performs platform-specific actions on each package. - var packagesPlatform; + // the packages engine module, if it exists, + // performs engine-specific actions on each package. + var packagesEngine; try { - packagesPlatform = require('packages-platform'); + packagesEngine = require('packages-engine'); } catch (exception) { } @@ -39,22 +39,22 @@ exports.load = function (packagePrefixes) { exports.verify(catalog); // a topological sort of the packages based on their - // stated dependencies and contained platform-specific + // stated dependencies and contained engine-specific // components var packageOrder = exports.sortedPackages(catalog); // analysis var analysis = {}; exports.analyze(analysis, packageOrder); - // platform-specific analysis - if (packagesPlatform) - packagesPlatform.analyze(analysis, packageOrder); + // engine-specific analysis + if (packagesEngine) + packagesEngine.analyze(analysis, packageOrder); // synthesis exports.synthesize(analysis); - // platform-specific synthesis - if (packagesPlatform) - packagesPlatform.synthesize(analysis); + // engine-specific synthesis + if (packagesEngine) + packagesEngine.synthesize(analysis); // preload modules analysis.preloadModules.forEach(function(id) { @@ -291,18 +291,18 @@ exports.analyze = function analyze(analysis, catalog) { if (!packageData.lib) packageData.lib = ['lib']; - // platforms - var platforms = 'platforms'; - var platformLibs = []; - if (packageData.platforms) - platforms = packageData.platforms; - system.platforms.forEach(function (platform) { - var platformDir = packageData.directory.join(platforms, platform, 'lib'); - if (platformDir.isDirectory()) - platformLibs.push(platformDir); + // engines + var engines = 'engines'; + var engineLibs = []; + if (packageData.engines) + engines = packageData.engines; + system.engines.forEach(function (engine) { + var engineDir = packageData.directory.join(engines, engine, 'lib'); + if (engineDir.isDirectory()) + engineLibs.push(engineDir); }); - packageData.lib = platformLibs.concat(packageData.lib); + packageData.lib = engineLibs.concat(packageData.lib); for (var i = 0; i < packageData.lib.length; i++) { packageData.lib[i] = packageData.directory.resolve(packageData.lib[i]); } lib/packages.js @@ -165,7 +165,7 @@ parser.command('search', exports.search) parser.command('init', module.id + '/init'); -parser.command('platform', module.id + '/platform'); +parser.command('engine', module.id + '/engine'); parser.command('freeze', exports.freeze) .help('writes a freeze.json file'); lib/tusk.js @@ -1,9 +1,9 @@ # Rhino -NARWHAL_DEFAULT_PLATFORM="rhino" +NARWHAL_DEFAULT_ENGINE="rhino" # k7 -#NARWHAL_DEFAULT_PLATFORM="k7" +#NARWHAL_DEFAULT_ENGINE="k7" -#NARWHAL_PLATFORM_HOME="." +#NARWHAL_ENGINE_HOME="." narwhal.conf.template @@ -46,58 +46,58 @@ Gem::Specification.new do |s| "lib/uri.js", "lib/util.js", "lib/xregexp.js", - "platforms", - "platforms/browser", - "platforms/browser/lib", - "platforms/browser/lib/reactor.js", - "platforms/default", - "platforms/default/lib", - "platforms/default/lib/array.js", - "platforms/default/lib/file-platform.js", - "platforms/default/lib/function.js", - "platforms/default/lib/global.js", - "platforms/default/lib/io-platform.js", - "platforms/default/lib/object.js", - "platforms/default/lib/reactor.js", - "platforms/default/lib/system.js", - "platforms/k7", - "platforms/k7/bin", - "platforms/k7/bin/narwhal-k7", - "platforms/k7/bootstrap.js", - "platforms/k7/lib", - "platforms/k7/lib/file-platform.js", - "platforms/k7/lib/system.js", - "platforms/rhino", - "platforms/rhino/bin", - "platforms/rhino/bin/narwhal-rhino", - "platforms/rhino/bootstrap.js", - "platforms/rhino/jars", - "platforms/rhino/jars/jline.jar", - "platforms/rhino/jars/js.jar", - "platforms/rhino/lib", - "platforms/rhino/lib/binary.js", - "platforms/rhino/lib/file-platform.js", - "platforms/rhino/lib/http-platform.js", - "platforms/rhino/lib/io-platform.js", - "platforms/rhino/lib/os.js", - "platforms/rhino/lib/packages-platform.js", - "platforms/rhino/lib/process.js", - "platforms/rhino/lib/sandbox-platform.js", - "platforms/rhino/lib/system.js", - "platforms/rhino/lib/zip.js", - "platforms/secure", - "platforms/secure/lib", - "platforms/secure/lib/file.js", - "platforms/secure/lib/system.js", - "platforms/template", - "platforms/template/bin", - "platforms/template/bin/narwhal-platform-name", - "platforms/template/bootstrap.js", - "platforms/template/lib", - "platforms/template/lib/file-platform.js", - "platforms/template/lib/system.js", - "platforms/v8cgi", - "platforms/v8cgi/bootstrap.js" + "engines", + "engines/browser", + "engines/browser/lib", + "engines/browser/lib/reactor.js", + "engines/default", + "engines/default/lib", + "engines/default/lib/array.js", + "engines/default/lib/file-engine.js", + "engines/default/lib/function.js", + "engines/default/lib/global.js", + "engines/default/lib/io-engine.js", + "engines/default/lib/object.js", + "engines/default/lib/reactor.js", + "engines/default/lib/system.js", + "engines/k7", + "engines/k7/bin", + "engines/k7/bin/narwhal-k7", + "engines/k7/bootstrap.js", + "engines/k7/lib", + "engines/k7/lib/file-engine.js", + "engines/k7/lib/system.js", + "engines/rhino", + "engines/rhino/bin", + "engines/rhino/bin/narwhal-rhino", + "engines/rhino/bootstrap.js", + "engines/rhino/jars", + "engines/rhino/jars/jline.jar", + "engines/rhino/jars/js.jar", + "engines/rhino/lib", + "engines/rhino/lib/binary.js", + "engines/rhino/lib/file-engine.js", + "engines/rhino/lib/http-engine.js", + "engines/rhino/lib/io-engine.js", + "engines/rhino/lib/os.js", + "engines/rhino/lib/packages-engine.js", + "engines/rhino/lib/process.js", + "engines/rhino/lib/sandbox-engine.js", + "engines/rhino/lib/system.js", + "engines/rhino/lib/zip.js", + "engines/secure", + "engines/secure/lib", + "engines/secure/lib/file.js", + "engines/secure/lib/system.js", + "engines/template", + "engines/template/bin", + "engines/template/bin/narwhal-engine-name", + "engines/template/bootstrap.js", + "engines/template/lib", + "engines/template/lib/file-engine.js", + "engines/template/lib/system.js", + "engines/v8cgi", + "engines/v8cgi/bootstrap.js" ] s.require_paths = ["lib"] s.rubygems_version = %q{1.3.3} narwhal.gemspec @@ -48,9 +48,9 @@ system.fs = fs; // construct the initial paths var paths = []; -for (var i = 0; i < system.platforms.length; i++) { - var platform = system.platforms[i]; - paths.push(system.prefix + '/platforms/' + platform + '/lib'); +for (var i = 0; i < system.engines.length; i++) { + var engine = system.engines[i]; + paths.push(system.prefix + '/engines/' + engine + '/lib'); } paths.push(system.prefix + '/lib'); narwhal.js @@ -9,5 +9,5 @@ ], "main": "examples/narwhal", "lib": ["lib"], - "lean": ["lib", "platforms"] + "lean": ["lib", "engines"] } package.json docs/platforms.md lib/narwhal/tusk/platform.js platforms/browser/inline.js platforms/browser/lib/binary.js platforms/browser/lib/modules.js platforms/browser/lib/reactor.js platforms/browser/lib/system.js platforms/default/lib/array.js platforms/default/lib/binary-platform.js platforms/default/lib/binary.js platforms/default/lib/date.js platforms/default/lib/file-platform.js platforms/default/lib/function.js platforms/default/lib/global.js platforms/default/lib/io-platform.js platforms/default/lib/json.js platforms/default/lib/object.js platforms/default/lib/os-platform.js platforms/default/lib/reactor.js platforms/default/lib/string.js platforms/default/lib/system.js platforms/helma/bin/narwhal-helma platforms/helma/bootstrap.js platforms/jaxer/README.md platforms/jaxer/bootstrap.js platforms/jaxer/lib/logger.js platforms/k7/bin/narwhal-k7 platforms/k7/bootstrap.js platforms/k7/lib/binary.js platforms/k7/lib/file-platform.js platforms/k7/lib/io-platform.js platforms/k7/lib/system.js platforms/rhino/bin/narwhal-rhino platforms/rhino/bin/narwhal-rhino.cmd platforms/rhino/bootstrap.js platforms/rhino/jars/jline.jar platforms/rhino/jars/js.jar platforms/rhino/lib/binary-platform.js platforms/rhino/lib/file-platform.js platforms/rhino/lib/http-platform.js platforms/rhino/lib/io-platform.js platforms/rhino/lib/md5.js platforms/rhino/lib/os-platform.js platforms/rhino/lib/packages-platform.js platforms/rhino/lib/process.js platforms/rhino/lib/sandbox-platform.js platforms/rhino/lib/system.js platforms/rhino/lib/zip.js platforms/secure/lib/file.js platforms/secure/lib/system.js platforms/template/bin/narwhal-platform-name platforms/template/bootstrap.js platforms/template/lib/file-platform.js platforms/template/lib/system.js platforms/v8cgi/bootstrap.js platforms/xulrunner/.gitignore platforms/xulrunner/LICENSE platforms/xulrunner/README.md platforms/xulrunner/apps/firenarwhal/application.ini platforms/xulrunner/apps/firenarwhal/chrome/branding/about.png platforms/xulrunner/apps/firenarwhal/chrome/branding/aboutCredits.png platforms/xulrunner/apps/firenarwhal/chrome/branding/aboutFooter.png platforms/xulrunner/apps/firenarwhal/chrome/branding/icon48.png platforms/xulrunner/apps/firenarwhal/chrome/branding/icon64.png platforms/xulrunner/apps/firenarwhal/chrome/chrome.manifest platforms/xulrunner/apps/firenarwhal/chrome/content/main.xul platforms/xulrunner/apps/firenarwhal/chrome/locale/branding/brand.dtd platforms/xulrunner/apps/firenarwhal/chrome/locale/branding/brand.properties platforms/xulrunner/apps/firenarwhal/defaults/preferences/prefs.js platforms/xulrunner/apps/firenarwhal/extensions/mozrepl@hyperstruct.net platforms/xulrunner/apps/firenarwhal/extensions/narwhal@narwhaljs.org platforms/xulrunner/apps/firenarwhal/firenarwhal platforms/xulrunner/bin/narwhal-xulrunner platforms/xulrunner/bootstrap.js platforms/xulrunner/extensions/narwhal@narwhaljs.org/chrome.manifest platforms/xulrunner/extensions/narwhal@narwhaljs.org/chrome/content/narwhal.js platforms/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.idl platforms/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.js platforms/xulrunner/extensions/narwhal@narwhaljs.org/components/nsINarwhal.xpt platforms/xulrunner/extensions/narwhal@narwhaljs.org/defaults/preferences/prefs.js platforms/xulrunner/extensions/narwhal@narwhaljs.org/install.rdf platforms/xulrunner/extensions/narwhal@narwhaljs.org/modules/narwhal.js platforms/xulrunner/extensions/narwhal@narwhaljs.org/narwhal platforms/xulrunner/lib/file-platform.js platforms/xulrunner/lib/io-platform.js platforms/xulrunner/lib/os-platform.js platforms/xulrunner/lib/system.js platforms/xulrunner/post-commit 82e7d5932eeefd9c5b52dd639dd51aff52da5a42 kriskowal kris.kowal@cixar.com http://github.com/tlrobinson/narwhal/commit/a18eaf5eb105fb5a93957e2950962a6aa3decbd7 a18eaf5eb105fb5a93957e2950962a6aa3decbd7 2009-07-30T21:50:42-07:00 2009-07-30T21:50:42-07:00 s/platform/engine/gi 7ef313e0126c115a6c97bd95473a876c589605de kriskowal kris.kowal@cixar.com