===========
JSShell 1.0
===========

What is JSShell?
================

JSShell is a browser-based interactive shell for JavaScript. It presents a
prompt on which the user can enter single-line JavaScript commands and
evaluates those commands. It can be a useful tool for testing small bits of
JavaScript or play around with JavaScript APIs without having to write a
script.

What browsers are supported?
============================

JSShell is known to work on Mozilla based browsers (Mozilla, Netscape 6+),
Konqueror based ones (Konqueror, Safari, tested on Konqueror 3.2.3) and
Internet Explorer based ones (tested on IE 6). There are some small
limitations in Internet Explorer and Konqueror because of the limitations of
the JavaScript engines of those browsers, for instance you can't define local
variables in those browsers and 'sh_import()' and 'sh_load()' are broken in
Konqueror, but apart from that everything works similar on all platforms.

How do I use the library?
=========================

There are two implementations available out-of-the-box: a simple one that uses
window.prompt() to get input, and a more advanced one that uses an input
field. To instantiate the simple variant, call 'startPromptShell()' with the
id of a field to display the contents in (e.g. a <pre>). To instantiate the
variant with the input field, call 'startInputShell()' with the id of an input
field as the first argument and an id to a field to display the contents in as
the second.

An full example HTML file with additional functionality called 'jsshell.html'
is added to the package. This uses the input-field variant to present a nice
prompt (it makes the input field look like part of the content field using
CSS).

License
=======

This package is released under the terms of the General Public License. See
'LICENSE.txt' for more details.

Questions or remarks?
=====================

If you have any questions or remarks about this software, please send an email
to johnny@debris.demon.nl.

Good luck,

Guido Wesdorp