johnson 1.2.0 → 2.0.0.pre0

data/vendor/tracemonkey/liveconnect/LiveConnectShell.dsp

@@ -0,0 +1,120 @@
+# Microsoft Developer Studio Project File - Name="LiveConnectShell" - Package Owner=<4>
+# Microsoft Developer Studio Generated Build File, Format Version 5.00
+# ** DO NOT EDIT **
+
+# TARGTYPE "Win32 (x86) Console Application" 0x0103
+
+CFG=LiveConnectShell - Win32 Debug
+!MESSAGE This is not a valid makefile. To build this project using NMAKE,
+!MESSAGE use the Export Makefile command and run
+!MESSAGE 
+!MESSAGE NMAKE /f "LiveConnectShell.mak".
+!MESSAGE 
+!MESSAGE You can specify a configuration when running NMAKE
+!MESSAGE by defining the macro CFG on the command line. For example:
+!MESSAGE 
+!MESSAGE NMAKE /f "LiveConnectShell.mak" CFG="LiveConnectShell - Win32 Debug"
+!MESSAGE 
+!MESSAGE Possible choices for configuration are:
+!MESSAGE 
+!MESSAGE "LiveConnectShell - Win32 Release" (based on\
+ "Win32 (x86) Console Application")
+!MESSAGE "LiveConnectShell - Win32 Debug" (based on\
+ "Win32 (x86) Console Application")
+!MESSAGE 
+
+# Begin Project
+# PROP Scc_ProjName ""
+# PROP Scc_LocalPath ""
+CPP=cl.exe
+RSC=rc.exe
+
+!IF  "$(CFG)" == "LiveConnectShell - Win32 Release"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 0
+# PROP BASE Output_Dir "LiveConnectShell_"
+# PROP BASE Intermediate_Dir "LiveConnectShell_"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 0
+# PROP Output_Dir "Release"
+# PROP Intermediate_Dir "Release"
+# PROP Ignore_Export_Lib 0
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /YX /FD /c
+# ADD CPP /nologo /MD /W3 /GX /O2 /I "$(JDK)\include" /I "$(JDK)\include\win32" /I "." /D "_WIN32" /D "WIN32" /D "NDEBUG" /D "XP_WIN" /D "_WINDOWS" /D "JSFILE" /D "LIVECONNECT" /YX /FD /c
+# ADD BASE RSC /l 0x409 /d "NDEBUG"
+# ADD RSC /l 0x409 /d "NDEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LINK32=link.exe
+# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386
+# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386 /out:"Release/lcshell.exe"
+# Begin Special Build Tool
+SOURCE=$(InputPath)
+PostBuild_Desc=Copy DLL(s) to build directory
+PostBuild_Cmds=COPY ..\Release\js32.dll .\Release
+# End Special Build Tool
+
+!ELSEIF  "$(CFG)" == "LiveConnectShell - Win32 Debug"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 1
+# PROP BASE Output_Dir "LiveConnectShell0"
+# PROP BASE Intermediate_Dir "LiveConnectShell0"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 1
+# PROP Output_Dir "Debug"
+# PROP Intermediate_Dir "Debug"
+# PROP Ignore_Export_Lib 0
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /W3 /Gm /GX /Zi /Od /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /YX /FD /c
+# ADD CPP /nologo /MDd /W3 /Gm /GX /Zi /Od /I "$(JDK)\include" /I "$(JDK)\include\win32" /I "." /D "LIVECONNECT" /D "_WIN32" /D "WIN32" /D "_DEBUG" /D "DEBUG" /D "XP_WIN" /D "_WINDOWS" /D "JSFILE" /FR /YX /FD /c
+# SUBTRACT CPP /u
+# ADD BASE RSC /l 0x409 /d "_DEBUG"
+# ADD RSC /l 0x409 /d "_DEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LINK32=link.exe
+# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept
+# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib  $(JDK)\lib\javai_g.lib /nologo /subsystem:console /debug /machine:I386 /out:"Debug/lcshell.exe" /pdbtype:sept
+# Begin Special Build Tool
+SOURCE=$(InputPath)
+PostBuild_Desc=Copy DLL(s) to build directory
+PostBuild_Cmds=COPY ..\Debug\js32.dll .\Debug
+# End Special Build Tool
+
+!ENDIF 
+
+# Begin Target
+
+# Name "LiveConnectShell - Win32 Release"
+# Name "LiveConnectShell - Win32 Debug"
+# Begin Source File
+
+SOURCE=..\js.c
+# End Source File
+# Begin Source File
+
+SOURCE=..\Debug\js32.lib
+# End Source File
+# Begin Source File
+
+SOURCE=.\jsj_simpleapi.c
+
+!IF  "$(CFG)" == "LiveConnectShell - Win32 Release"
+
+!ELSEIF  "$(CFG)" == "LiveConnectShell - Win32 Debug"
+
+# ADD CPP /I ".."
+# SUBTRACT CPP /I "."
+
+!ENDIF 
+
+# End Source File
+# End Target
+# End Project

data/vendor/tracemonkey/liveconnect/LiveConnectShell.dsw

@@ -0,0 +1,44 @@
+Microsoft Developer Studio Workspace File, Format Version 5.00
+# WARNING: DO NOT EDIT OR DELETE THIS WORKSPACE FILE!
+
+###############################################################################
+
+Project: "LiveConnect"=.\LiveConnect.dsp - Package Owner=<4>
+
+Package=<5>
+{{{
+}}}
+
+Package=<4>
+{{{
+}}}
+
+###############################################################################
+
+Project: "LiveConnectShell"=.\LiveConnectShell.dsp - Package Owner=<4>
+
+Package=<5>
+{{{
+}}}
+
+Package=<4>
+{{{
+    Begin Project Dependency
+    Project_Dep_Name LiveConnect
+    End Project Dependency
+}}}
+
+###############################################################################
+
+Global:
+
+Package=<5>
+{{{
+}}}
+
+Package=<3>
+{{{
+}}}
+
+###############################################################################
+

data/vendor/tracemonkey/liveconnect/Makefile.in

@@ -0,0 +1,105 @@
+#
+# ***** BEGIN LICENSE BLOCK *****
+# Version: MPL 1.1/GPL 2.0/LGPL 2.1
+#
+# The contents of this file are subject to the Mozilla Public License Version
+# 1.1 (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+# http://www.mozilla.org/MPL/
+#
+# Software distributed under the License is distributed on an "AS IS" basis,
+# WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+# for the specific language governing rights and limitations under the
+# License.
+#
+# The Original Code is Mozilla Communicator client code, released
+# March 31, 1998.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#
+# Alternatively, the contents of this file may be used under the terms of
+# either of the GNU General Public License Version 2 or later (the "GPL"),
+# or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+# in which case the provisions of the GPL or the LGPL are applicable instead
+# of those above. If you wish to allow use of your version of this file only
+# under the terms of either the GPL or the LGPL, and not to allow others to
+# use your version of this file under the terms of the MPL, indicate your
+# decision by deleting the provisions above and replace them with the notice
+# and other provisions required by the GPL or the LGPL. If you do not delete
+# the provisions above, a recipient may use your version of this file under
+# the terms of any one of the MPL, the GPL or the LGPL.
+#
+# ***** END LICENSE BLOCK *****
+
+DEPTH		= ../../..
+topsrcdir	= @top_srcdir@
+srcdir		= @srcdir@
+VPATH		= @srcdir@
+
+include $(DEPTH)/config/autoconf.mk
+
+MODULE		= liveconnect
+LIBRARY_NAME	= jsj
+EXPORT_LIBRARY = 1
+ifeq ($(OS_ARCH)$(MOZ_ENABLE_LIBXUL),WINNT)
+LIBRARY_NAME	= jsj$(MOZ_BITS)$(VERSION_NUMBER)
+MAPFILE		= $(LIBRARY_NAME).map
+endif
+JNI_GEN_DIR	= _jni
+GRE_MODULE	= 1
+LIBXUL_LIBRARY	= 1
+
+REQUIRES	= js \
+		  xpcom \
+		  xpconnect \
+		  java \
+		  caps \
+		  necko \
+		  string \
+		  $(NULL)
+
+CSRCS		= \
+		jsj.c \
+		jsj_JSObject.c \
+		jsj_JavaArray.c \
+		jsj_JavaClass.c \
+		jsj_JavaMember.c \
+		jsj_JavaObject.c \
+		jsj_JavaPackage.c \
+		jsj_array.c \
+		jsj_class.c \
+		jsj_convert.c \
+		jsj_field.c \
+		jsj_hash.c \
+		jsj_method.c \
+		jsj_utils.c \
+		$(NULL)
+
+CPPSRCS		= \
+		nsCLiveconnect.cpp \
+		nsCLiveconnectFactory.cpp \
+		$(NULL)
+
+EXPORTS		= \
+		$(srcdir)/jsjava.h \
+		$(srcdir)/$(JNI_GEN_DIR)/netscape_javascript_JSObject.h \
+		$(srcdir)/$(JNI_GEN_DIR)/netscape_javascript_JSException.h \
+		$(srcdir)/nsILiveconnect.h \
+		$(srcdir)/nsISecureLiveconnect.h \
+		$(srcdir)/nsISecurityContext.h \
+		$(NULL)
+
+EXTRA_DSO_LDOPTS += \
+		$(LIBS_DIR) \
+		$(MOZ_JS_LIBS) \
+		$(MOZ_COMPONENT_LIBS) \
+		$(NULL)
+
+include $(topsrcdir)/config/rules.mk
+
+

data/vendor/tracemonkey/liveconnect/Makefile.ref

@@ -0,0 +1,169 @@
+# -*- Mode: makefile -*-
+#
+# ***** BEGIN LICENSE BLOCK *****
+# Version: MPL 1.1/GPL 2.0/LGPL 2.1
+#
+# The contents of this file are subject to the Mozilla Public License Version
+# 1.1 (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+# http://www.mozilla.org/MPL/
+#
+# Software distributed under the License is distributed on an "AS IS" basis,
+# WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+# for the specific language governing rights and limitations under the
+# License.
+#
+# The Original Code is Mozilla Communicator client code, released
+# March 31, 1998.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#
+# Alternatively, the contents of this file may be used under the terms of
+# either of the GNU General Public License Version 2 or later (the "GPL"),
+# or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+# in which case the provisions of the GPL or the LGPL are applicable instead
+# of those above. If you wish to allow use of your version of this file only
+# under the terms of either the GPL or the LGPL, and not to allow others to
+# use your version of this file under the terms of the MPL, indicate your
+# decision by deleting the provisions above and replace them with the notice
+# and other provisions required by the GPL or the LGPL. If you do not delete
+# the provisions above, a recipient may use your version of this file under
+# the terms of any one of the MPL, the GPL or the LGPL.
+#
+# ***** END LICENSE BLOCK *****
+
+#
+# JSRef GNUmake makefile.
+#
+
+DEPTH = ..
+
+# Create JAR file
+DIRS += classes
+
+#
+# XCFLAGS may be set in the environment or on the gmake command line
+#
+CFLAGS          += $(OPTIMIZER) $(OS_CFLAGS) $(DEFINES) $(INCLUDES) \
+                  -DJSFILE $(XCFLAGS)
+LDFLAGS		+= -lm $(XLDFLAGS)
+
+# For purify
+PURE_CFLAGS     = -DXP_UNIX $(OPTIMIZER) $(PURE_OS_CFLAGS) $(DEFINES) \
+                  $(INCLUDES) $(XCFLAGS)
+
+#
+# LC file lists
+#
+LC_HFILES =		\
+	jsj_hash.h      \
+	jsj_private.h   \
+	jsjava.h        \
+	netscape_javascript_JSObject.h \
+	nsCLiveconnectFactory.h        \
+	nsILiveconnect.h               \
+	nsISecureLiveconnect.h         \
+	nsISecurityContext.h           \
+	$(NULL)
+
+OTHER_HFILES =		\
+	jsj.msg		\
+	$(NULL)
+
+HFILES = $(LC_HFILES) $(OTHER_HFILES)
+
+LC_CFILES =	\
+	jsj.c \
+	jsj_JSObject.c \
+	jsj_JavaArray.c \
+	jsj_JavaClass.c \
+	jsj_JavaMember.c \
+	jsj_JavaObject.c \
+	jsj_JavaPackage.c \
+	jsj_array.c \
+	jsj_class.c \
+	jsj_convert.c \
+	jsj_field.c \
+	jsj_hash.c \
+	jsj_method.c \
+	jsj_utils.c \
+	$(NULL)
+
+LIB_CFILES  = $(LC_CFILES)
+
+PROG_FILE = js
+
+include $(DEPTH)/config.mk
+include config/$(OS_CONFIG).mk
+
+INCLUDES   += -I. -I.. -I../$(OBJDIR)
+
+ifdef USE_MSVC
+OTHER_LIBS += $(DEPTH)/fdlibm/$(OBJDIR)/fdlibm.lib
+else
+OTHER_LIBS += -L$(DEPTH)/fdlibm/$(OBJDIR) -lfdm -L../$(OBJDIR) -ljs
+endif
+
+#
+# Line editing support.
+# Define JS_READLINE or JS_EDITLINE to enable line editing in the
+# lcshell command-line interpreter.
+#
+ifdef JS_READLINE
+# For those platforms with the readline library installed.
+DEFINES += -DEDITLINE
+OTHER_LIBS += -lreadline
+else
+ifdef JS_EDITLINE
+# Use the editline library from ../editline.
+PREDIRS += ../editline
+DEFINES += -DEDITLINE
+OTHER_LIBS += -L../editline/$(OBJDIR) -ledit
+endif
+endif
+
+NSPR_LIBSUFFIX = 4
+
+ifdef JS_THREADSAFE
+DEFINES += -DJS_THREADSAFE
+INCLUDES += -I../../../dist/$(OBJDIR)/include
+ifdef USE_MSVC
+OTHER_LIBS += $(DEPTH)/../../dist/$(OBJDIR)/lib/libnspr${NSPR_LIBSUFFIX}.lib
+else
+OTHER_LIBS += -L$(DEPTH)/../../dist/$(OBJDIR)/lib -lnspr${NSPR_LIBSUFFIX}
+endif
+endif
+
+ifdef USE_MSVC
+LIBRARY = $(OBJDIR)/jsj.lib
+SHARED_LIBRARY = $(OBJDIR)/jsj.dll
+PROGRAM = $(OBJDIR)/lcshell.exe
+else
+LIBRARY = $(OBJDIR)/libjsj.a
+SHARED_LIBRARY = $(OBJDIR)/libjsj.$(SO_SUFFIX)
+PROGRAM = $(OBJDIR)/lcshell
+endif
+
+include $(DEPTH)/rules.mk
+
+ifdef USE_MSVC
+$(OBJDIR)/$(PROG_FILE)_lc.obj: ../$(PROG_FILE).c
+	@$(MAKE_OBJDIR)
+	$(CC) -Fo$@ -c $(CFLAGS) -DLIVECONNECT ../$(PROG_FILE).c
+
+$(PROGRAM): $(OBJDIR)/$(PROG_FILE)_lc.obj $(OBJDIR)/jsj_simpleapi.obj $(LIBRARY)
+	link.exe -out:"$@" $(EXE_LINK_FLAGS) ../$(OBJDIR)/js32.lib $(OTHER_LIBS) $?
+else
+$(OBJDIR)/$(PROG_FILE).o: ../$(PROG_FILE).c
+	@$(MAKE_OBJDIR)
+	$(CC) -o $@ -c $(CFLAGS) -DLIVECONNECT ../$(PROG_FILE).c
+
+$(PROGRAM): $(OBJDIR)/$(PROG_FILE).o $(OBJDIR)/jsj_simpleapi.o
+	@$(MAKE_OBJDIR)
+	$(CC) -o $@ $(CFLAGS) $+ $(LIBRARY) ../$(OBJDIR)/libjs.a $(LDFLAGS) $(OTHER_LIBS)
+endif

data/vendor/tracemonkey/liveconnect/README.html

@@ -0,0 +1,712 @@
+<!-- ***** BEGIN LICENSE BLOCK *****
+   - Version: MPL 1.1/GPL 2.0/LGPL 2.1
+   -
+   - The contents of this file are subject to the Mozilla Public License Version
+   - 1.1 (the "License"); you may not use this file except in compliance with
+   - the License. You may obtain a copy of the License at
+   - http://www.mozilla.org/MPL/
+   -
+   - Software distributed under the License is distributed on an "AS IS" basis,
+   - WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+   - for the specific language governing rights and limitations under the
+   - License.
+   - 
+   - The Original Code is Mozilla Communicator client code, released
+   - March 31, 1998.
+   - 
+   - The Initial Developer of the Original Code is
+   - Netscape Communications Corporation.
+   - Portions created by the Initial Developer are Copyright (C) 1998-1999
+   - the Initial Developer. All Rights Reserved.
+   - 
+   - Contributor(s):
+   - 
+   - Alternatively, the contents of this file may be used under the terms of
+   - either of the GNU General Public License Version 2 or later (the "GPL"),
+   - or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+   - in which case the provisions of the GPL or the LGPL are applicable instead
+   - of those above. If you wish to allow use of your version of this file only
+   - under the terms of either the GPL or the LGPL, and not to allow others to
+   - use your version of this file under the terms of the MPL, indicate your
+   - decision by deleting the provisions above and replace them with the notice
+   - and other provisions required by the GPL or the LGPL. If you do not delete
+   - the provisions above, a recipient may use your version of this file under
+   - the terms of any one of the MPL, the GPL or the LGPL.
+   -
+   - ***** END LICENSE BLOCK ***** -->
+
+<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
+<html>
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+   <meta name="Author" content="Scott Furman">
+   <meta name="GENERATOR" content="Mozilla/4.5 [en] (WinNT; I) [Netscape]">
+   <title>README for LiveConnect</title>
+</head>
+<body>
+This is the README file for the JavaScript LiveConnect
+Version 3 ("LC3") implementation.
+<h2>
+Table of Contents</h2>
+
+<blockquote><a href="#Introduction">Introduction</a>
+<br><a href="#New_Features">New features</a>
+<br><a href="#Compatibility">Compatibility</a>
+<br><a href="#Limitations">Limitations/Bugs/To-Do</a>
+<br><a href="#Build_conventions">Build conventions</a>
+<br><a href="#coding_conventions">Naming and coding conventions</a>
+<br><a href="#API">The LiveConnect API</a>
+<br><a href="#sample_shell_interaction">Sample LiveConnect shell interactions</a></blockquote>
+
+<h2>
+<a NAME="Introduction"></a>Introduction</h2>
+<span CLASS=LXRLONGDESC> <span CLASS=LXRSHORTDESC>LiveConnect is a library that 
+permits JavaScript and Java virtual machines to interoperate.</span> Specifically, 
+it enables JavaScript to access Java fields, invoke Java methods and enables Java 
+to access JavaScript object properties and evaluate arbitrary JavaScript.</span> 
+LiveConnect was originally an integrated feature of both the Netscape Navigator 
+browser and Netscape's server-side JavaScript. Now, it is a standalone library 
+that can be embedded within other projects, such as the Mozilla browser. More 
+information on LiveConnect can be found by <a href="http://developer.netscape.com/find/find.cgi?scope=LiveConnect&browse-category=&ui=sr&chunk-size=&page=1&taxonomy=DevEdge+Online">searching 
+the index on Netscape's DevEdge site</a>.&nbsp; This README assumes basic familiarity 
+with <a href="http://lxr.mozilla.org/mozilla/source/js/src/README.html">JSRef</a>, 
+the reference implementation of JavaScript, and with the LiveConnect technology. 
+<p>The JSRef project/makefiles (located in another directory) build a library 
+  or DLL containing the JavaScript runtime (compiler, interpreter, decompiler, 
+  garbage collector, atom manager, standard classes).&nbsp; The LiveConnect project/makefiles 
+  build a library that links with both JSRef and any Java Virtual Machine (JVM) 
+  that implements the Java Native Interface (JNI), as specified by JavaSoft.&nbsp; 
+  It then compiles a small "shell" example program and links that with the library 
+  to make an interpreter that can be used interactively and with test scripts.&nbsp; 
+  See the <a href="#sample_shell_interaction">sample shell interactions</a>. 
+<p><i>Scott Furman, 10/31/98</i>
+<h2>
+<a NAME="New_Features"></a>New features</h2>
+The following features were not available in the versions of LiveConnect that 
+were integrated with Netscape Navigator versions 4.x and earlier.&nbsp; For information 
+on LiveConnect version 1, which was used in Navigator versions 3 and 4, and Enterprise 
+Server 3, see <a href="http://developer.netscape.com/find/find.cgi?scope=LiveConnect&browse-category=&ui=sr&chunk-size=&page=1&taxonomy=DevEdge+Online">Netscape's 
+DevEdge site</a> or any number of 3rd-party publications.) 
+<h4> LiveConnect version 3 (8/31/99)</h4>
+
+<ul>
+  <li> In previous versions of LiveConnect, when more than one overloaded Java 
+    method was compatible with the types of arguments in an invocation from JS, 
+    the choice of Java method was made arbitrarily, by using the first one enumerated 
+    by the Java reflection APIs.&nbsp; Unfortunately, the ordering of methods 
+    when enumerating is not governed by any specification, so differences between 
+    JVM vendors could lead to inconsistencies in LiveConnect behavior.&nbsp; Now, 
+    a <a href="http://www.mozilla.org/js/liveconnect/lc3_method_overloading.html">JVM-independent 
+    set of rules</a> is used to choose among a set of overloaded methods.&nbsp;&nbsp; 
+    Informally, the method with Java parameter types that most&nbsp; closely match 
+    the JavaScript types is chosen.<BR>
+    <BR>
+  </li>
+  <li> The weak correspondence between the JS language typing system and Java's 
+    may result in ambiguity and/or shadowing when resolving among overloaded Java 
+    methods, even when using LC3's improved method overload resolution algorithm 
+    (see above).&nbsp; For example, JS's number type can map to a Java method 
+    argument that has any floating-point or integral types: byte, char, short, 
+    int, long, float, double.&nbsp;&nbsp; If necessary, it is now possible to 
+    bypass the method overload resolution process and explicitly specify the method 
+    to be invoked:</li>
+  <BR>
+  <br>
+  &nbsp; 
+  <ul>
+    <tt>myPrintMethod = java.io.PrintStream["print(double)"];</tt> <br>
+    <tt>myPrintMethod(13);</tt> 
+  </ul>
+  <br>
+  <li> Static methods can now be invoked using either the class name or a reference 
+    to an instance of the class.&nbsp; (Older versions of LiveConnect allow only 
+    the former.)<BR>
+    <BR>
+  </li>
+  <li> It is no longer necessary to convert Java Strings to JS strings before 
+    using them as the receivers of JS string methods, which is typically done 
+    by appending an empty string to the Java string, e.g. 
+    <BLOCKQUOTE> 
+      <P> <tt>&nbsp;&nbsp;&nbsp; s = new java.lang.String("foo")</tt> // s contains 
+        a Java string<br>
+        <tt>&nbsp;&nbsp;&nbsp; s = s + "";&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+        </tt>// s is now a JS string <br>
+        <tt>&nbsp;&nbsp;&nbsp; m = s.match(/o?/)</tt> </P>
+    </BLOCKQUOTE>
+  </li>
+  <p>The explicit conversion to a JS string is no longer required because <i>java.lang.String</i> 
+    objects are treated as a special case that "inherit" all the methods of JS 
+    strings, i.e. so that the second statement in the example above is now superfluous.<BR>
+    <BR>
+  <li> Similarly, JavaArray objects "inherit" the methods of JS's <tt>Array.prototype</tt>, 
+    so it is possible to apply many, though not all, of the JS array utility methods 
+    such as <tt>reverse()</tt> and <tt>join()</tt> to JavaArray objects.<BR>
+    <BR>
+  </li>
+  <li> There is now support for the <tt>instanceof</tt> and <tt>in</tt> operators.&nbsp; 
+    These operators are currently proposed for inclusion in the ECMA-2 standard.<BR>
+    <BR>
+  </li>
+  <li> LiveConnect has been extended to take advantage of JavaScript exceptions, 
+    a language feature that debuted in JavaScript 1.4.&nbsp; Now, when JavaScript 
+    calls into Java, any Java exceptions are converted to JS exceptions which 
+    can be caught using JS try-catch statements.&nbsp; Similarly, JS exceptions 
+    are propagated to Java wrapped in an instance of <i>netscape.javascript.JSException</i>.<BR>
+    <BR>
+  </li>
+  <li>JavaScript Array objects can now be passed to Java methods that expect a 
+    Java array as an argument. <BR>
+    LiveConnect will create a new Java array of the appropriate type with a length 
+    equal to that of the JS Array object. Each element of the Java array is filled 
+    in by converting the corresponding element of the JS array, including undefined 
+    elements, to an equivalent Java value. Note: Since the contents of the JS 
+    array are copied, side-effects made by the invoked Java method to the Java 
+    array will not be reflected in the JS array argument. </li>
+</ul>
+
+<h4>
+LiveConnect version 2 (7/31/98)</h4>
+
+<blockquote>
+  <li> The Java methods of <i>java.lang.Object</i> are now invokeable methods 
+    of <tt><font size=+1>JavaArray</font></tt> objects, matching the behavior 
+    of arrays when accessed from Java<i>.</i>&nbsp; (Java arrays are a subclass 
+    of <i>java.lang.Object</i>.) For example, Java's <tt>getClass()</tt> and <tt>hashCode()</tt> 
+    methods can now be called on <tt>JavaArray</tt> objects.&nbsp; (In prior versions 
+    of LiveConnect, the methods of <i>java.lang.Object</i> were only inherited 
+    by non-array Java objects.)</li>
+
+  <p>Note that this change has caused the string representation of JavaArray objects 
+    to change.&nbsp; Previously, the JavaArray toString() method always printed 
+    "<tt><font size=+1>[object JavaArray]"</font></tt> for all <tt>JavaArray</tt>'s.&nbsp; 
+    Now, the Java <tt>java.lang.Object.toString()</tt> method is called to convert 
+    JavaArray objects to strings, just as with other, non-array Java objects that 
+    are accessible via LiveConnect. <tt>java.lang.Object.toString()</tt>is defined 
+    in the <i>Java Language Specification</i> to return the value of the following 
+    expression: 
+  <p><tt><font size=-1>getClass().getName() + '@' + Integer.toHexString(hashCode())</font></tt><BR>
+    <br>
+    &nbsp;
+  <li> A one-character string is now an acceptable match for an argument to a 
+    Java method of type <tt>char</tt>.&nbsp; (In earlier versions of LiveConnect, 
+    the only acceptable match for a <tt>char</tt> had to be a JavaScript value 
+    that was convertible to a number.)&nbsp; For example, the following is now 
+    possible:</li>
+
+  <p><tt><font size=-1>c = new java.lang.Character("F")</font></tt><BR>
+    <br>
+    &nbsp;
+<li>
+A JavaClass object is now an acceptable match for an argument to a Java
+method of type <i>java.lang.Class</i>.&nbsp; For example, you can now write:</li>
+
+<p><tt><font size=-1>java.lang.reflect.Array.newInstance(java.lang.String,
+3)</font></tt>
+<p>instead of the more verbose:
+  <p><tt><font size=-1>jls = java.lang.Class.forName("java.lang.String")</font></tt> 
+    <br>
+    <tt><font size=-1>java.lang.reflect.Array.newInstance(jls, 3)</font></tt> 
+  <p><br>
+    &nbsp;
+</blockquote>
+
+<h2>
+<a NAME="Compatibility"></a>Compatibility</h2>
+Unlike this standalone/component release, all previous versions of LiveConnect 
+appeared only as an integrated feature of Netscape Navigator or the Enterprise 
+Server.&nbsp; The variants of LiveConnect that appeared in Navigator versions 
+3.x and 4.x all behave much the same, modulo bugs.&nbsp; For brevity we refer 
+to this classic version of LiveConnect as "LC1" (LiveConnect version 1) and this 
+most recent release as "LC3".&nbsp; With a few exceptions LC3 provides a superset 
+of LC1 features. (There was an intermediate LiveConnect release known as "LC2" 
+in 7/98, but it was not used in any products.) 
+<ul>
+  <li> As in LC1, JavaScript objects appear to Java as instances of <i>netscape.javascript.JSObject</i>.&nbsp; 
+    In LC1, two <i>JSObject</i>'s could be tested for equality, i.e. to see if 
+    they refer to the same instance, by using the `==' operator.&nbsp; Instead, 
+    developers must now use the <tt>equals()</tt>method of <i>netscape.javascript.JSObject</i> 
+    for comparison, a method that overrides <tt>java.lang.Object.equals()</tt>.&nbsp; 
+    Note that using <tt>equals()</tt> instead of `==' will work the same in all 
+    versions of LiveConnect, including LC3</li>
+  <p>[It is not possible to replicate the identity behavior of the `==' operator 
+    that LC1 provides without the use of "weak" references, i.e. references that 
+    do not contribute to making a Java object reachable for purposes of garbage 
+    collection, but which nonetheless allow reference to an object as long as 
+    it is reachable by other means.&nbsp; The use of weak references is not portable, 
+    however.&nbsp; It is not part of the JNI or JDK 1.1 and it is not provided 
+    on all JVMs.&nbsp; The JDK1.2 release includes standard support for weak references.]<BR>
+    <br>
+    &nbsp; 
+  <li> It's possible that, in a set of overloaded Java methods, more than one 
+    method is compatible with the types of the actual arguments in a call from 
+    JavaScript to Java via LiveConnect.&nbsp; LC1 and LC2 resolved these ambiguities 
+    in a simplistic manner, by simply invoking whatever method was enumerated 
+    first by the JVM.&nbsp; The enumeration order of reflected methods using <i>java.lang.reflect</i>&nbsp; 
+    is not specified by Sun and may differ among vendor's JVMs, i.e. enumeration 
+    could be in order of classfile appearance, hashtable order, etc.&nbsp; Hence, 
+    the Java method chosen when there is more than one compatible method may vary 
+    depending on the JVM.&nbsp; With the Netscape and Sun JVMs, it is possible 
+    to change the behavior of an LC1/LC2 program by changing the order that Java 
+    methods appear in a source file, thus changing the method enumeration order.</li>
+  <p>In LC3, a new method overload resolution algorithm is used.&nbsp; Informally, 
+    the method with Java parameter types that most&nbsp; closely match the JavaScript 
+    types is chosen.&nbsp; You can read all the gorey details in the <a href="http://www.mozilla.org/js/liveconnect/lc3_method_overloading.html">spec</a>.<BR>
+    <br>
+    &nbsp; 
+  <li> There are several minor changes in error handling to make LiveConnect more 
+    conformant to ECMAScript.&nbsp; These include, for example, making any attempt 
+    to delete JavaObject, JavaClass or JavaPackage properties fail silently, rather 
+    than causing an error.&nbsp; Also, some error messages have been changed to 
+    be more informative.&nbsp; These changes should generally be backward-compatible 
+    with LC1 because few programs that use LiveConnect will depend on the exact 
+    behavior of LiveConnect when handling errors.</li>
+</ul>
+
+<h2> <a NAME="Limitations"></a>Limitations/Bugs/To-Do<BR>
+</h2>
+<ul>
+  <li> The efficiency of calling Java methods leaves something to be desired, 
+    due to the convoluted nature of implementing native methods for JS.&nbsp; 
+    JS_CloneFunctionObject() is called for every Java method invocation and the 
+    inability to store private data in a JSFunction object requires that the method 
+    table be searched twice instead of once for every invocation.<BR>
+    <BR>
+  </li>
+  <li> When Java objects are referenced from JS, they are entered into a hash 
+    table, so as to ensure that the same JS Object wrapper is used every time 
+    a particular Java object is reflected into JS.&nbsp; In this way, the behavior 
+    of the JS '==' and '===' operators are preserved.&nbsp; Unfortunately, the 
+    hash table may grow quite large (objects are only removed from the hash table 
+    when finalized).&nbsp; In thread-safe systems, the hash table must be locked 
+    when accessed, leading to slow performance. One alternate solution would be 
+    to make it possible to overload JS's equality-test operators, so that the 
+    hash table would no longer be required.<BR>
+    <BR>
+  </li>
+  <li> Initially, JavaClassDescriptor objectswere reference-counted to permit 
+    free'ing of unused descriptors.&nbsp; However, it's relatively common to develop 
+    cycles in the graph of JavaClassDescriptors, which leads to unused JavaClassDescriptors 
+    that have non-zero reference counts. For that reason, JavaClassDescriptors 
+    are not free'ed until JSJ_Shutdown().&nbsp; Luckily, the amount of memory 
+    used by JavaClassDescriptors tends to be relatively small.<BR>
+    <BR>
+  </li>
+  <li> The LiveConnect API is designed to allow multiple JVMs to be used simultaneously 
+    in the same executable (although each JSContext is limited to interaction 
+    with at most one JVM).&nbsp; However, the API is not fully implemented.&nbsp; 
+    For example, many global variables will need to become members of the JSJavaVM 
+    struct so that they are stored on a per-JVM basis.<BR>
+    <BR>
+  </li>
+  <li> Java and JavaScript use independent garbage collection systems. A reference 
+    between the two worlds must, therefore, take the form of a GC root. It's possible 
+    to create uncollectable objects when cyclic graphs cross the boundary between 
+    JS and Java, e.g. a JS object that refers to a Java object that refers back 
+    to the original JS object. There is no simple solution to this dual-GC problem. 
+    Luckily, such cyclic object graphs are extremely rare. </li>
+</ul>
+
+<h2>
+<a NAME="Build_conventions"></a>Build conventions</h2>
+<P>The following directions are for building the standalone version of LiveConnect. 
+  To build the version that's used in the Mozilla browser, see the <A HREF="http://www.mozilla.org/docs/">Mozilla 
+  build documentation</A>.</P>
+<P>On all platforms, you must update your JVM's <tt>CLASSPATH</tt> to point to 
+  the <tt>js/src/liveconnect/classes</tt> subdirectory.&nbsp; If you do not, LiveConnect 
+  will still operate but with the limitation that JS objects may not be passed 
+  as arguments of Java methods and it will not be possible to call from Java into 
+  JavaScript, i.e. the <i>netscape.javascript.JSObject</i> class will be inaccessible.&nbsp; 
+  Another downside of operating without these classes is that Java error messages 
+  will not include a Java stack trace, when one is available.&nbsp; If your <tt>CLASSPATH</tt> 
+  is set improperly, you will see a message like, "<tt>initialization error: Can't 
+  load class netscape/javascript/JSObject</tt>" when starting a LiveConnect debug 
+  build. </P>
+<p>By default, all platforms build a version of LiveConnect that is <i>not</i> 
+  threadsafe.&nbsp; If you require thread-safety, you must also populate the <tt>mozilla/dist</tt> 
+  directory with <a href="http://www.mozilla.org/docs/tplist/catCode/nsprdesc.htm">NSPR</a> 
+  headers and libraries.&nbsp; (NSPR implements a portable threading library, 
+  among other things.&nbsp; The source is downloadable via <a href="http://www.mozilla.org/cvs.html">CVS</a> 
+  from <tt><a href="http://lxr.mozilla.org/mozilla/source/nsprpub">mozilla/nsprpub</a></tt>.)&nbsp; 
+  Next, you must define <tt>JS_THREADSAFE</tt> when building LiveConnect, either 
+  on the command-line (gmake/nmake) or in a universal header file.&nbsp; Note 
+  that JSRef must also be built with <tt>JS_THREADSAFE</tt>. 
+<p>One important note about building on Windows: There are two independent build 
+  systems (in addition to the Mozilla browser build system). One of them uses 
+  the IDE project files and the other uses gmake and makefiles. The former will 
+  be preferred by most for debugging and the latter is more complete, since it 
+  builds the necessary Java classes in addition to compiling the LiveConnect C 
+  code.
+<ul><b>Windows</b>
+<ul>
+<li>
+Build the JS runtime and interpreter, <tt>js32.dll</tt>, by using the 
+<a href="http://lxr.mozilla.org/mozilla/source/js/src/README.html#Build">normal
+JSRef build procedure</a>.</li>    <li> Set the <tt>JDK</tt> environment variable to point to the top-level JDK directory, 
+      e.g. <tt>D:\jdk1.1.5</tt>.&nbsp; This is used to establish paths for header 
+      file inclusion, linking and execution.&nbsp; If you are not using Sun's 
+      JVM, the project files may require manual tweaking to set these paths correctly.</li>
+
+    <li> Use MSVC 5 or MSVC 6 with the <tt>LiveConnectShell.dsw</tt> project file.&nbsp; 
+      <font color="#993300">NOTE: makefile.win is an nmake file used only for 
+      building the JS-engine in the Mozilla browser.&nbsp; Don't attempt to use 
+      it to build the standalone JS-engine.</font></li>
+
+<li>
+The output files (DLLs and executables) are placed in either the <tt>js\src\liveconnect\Debug</tt>
+or the <tt>js\src\liveconnect\Release</tt> directory.</li>
+
+<li>
+The LiveConnect-enabled shell is named <tt>lcshell.exe</tt> and appears
+in the output directory.</li>
+
+<li>
+You must have the JVM DLL in your <tt><font size=+1>PATH</font></tt> environment
+variable in order to run.&nbsp; If you are using the Sun JDK, the DLL appears
+in the JDK's bin directory, e.g. <tt>D:\jdk1.1.5\bin\javai_g.dll</tt>.</li>
+
+<li>
+Use any Java compiler to compile the java source files in the <tt>js\src\liveconnect\classes\netscape\javascript</tt>
+directory.</li>
+
+    <li> Update your JVM's <tt>CLASSPATH</tt> to point to the <tt>js\src\liveconnect\classes</tt> 
+      subdirectory.&nbsp; (See above)<br>
+<BR></li>
+</ul>
+<b>Mac OS</b>
+<ul>
+<li>
+Using CodeWarrior Pro 3 is recommended, though the project files will probably
+also work with CodeWarrior Pro 4.</li>
+
+<li>
+Install Apple's JVM, MRJ 2.0 (or later), and the <a href="ftp://dev.apple.com/devworld/Java/MRJSDK2.0.1EarlyAccess4.hqx">MRJ
+SDK v2.0.1ea4</a>.&nbsp; Note: You do not need to install MRJ if you are
+running a recent version of MacOS 8, since it is shipped with the OS.</li>
+
+<li>
+Copy the folders <tt>CIncludes</tt> &amp; <tt>Libraries</tt> from the SDK's
+<tt>Interfaces&amp;Libraries</tt> directory to <tt>js:src:liveconnect:macbuild:JavaSession</tt>.</li>
+
+<li>
+Build the LiveConnect test application, <tt>LiveConnectShell</tt>, with
+<tt>js:src:liveconnect:macbuild:LiveConnectShell.mcp</tt>.</li>
+
+<li>
+Build <tt>liveconnect.jar</tt> with <tt>js:src:liveconnect:macbuild:LiveConnect.mcp</tt>.</li>
+
+<li>
+Make an alias to <tt>liveconnect.jar</tt> and place it in "<tt>{SystemFolder}Extensions:MRJ
+Libraries:MRJClasses</tt>".<br>
+<BR></li>
+</ul>
+  <b>Unix</b> (also works on Windows) 
+  <ul>
+    <li> <font color="#000000">Use '<tt>gmake -f Makefile.ref</tt>' to build. 
+      To compile optimized code, pass <tt>BUILD_OPT=1</tt> on the gmake command 
+      line or preset it in the environment or <tt>Makefile.ref</tt>.&nbsp; </font><font color="#990000">NOTE: 
+      Do not attempt to use <tt>Makefile</tt> to build.&nbsp; This file is used 
+      only for building LiveConnect in the Mozilla browser.</font></li>
+    <li> <font color="#000000">Each platform on which LiveConnect is built must 
+      have a *.mk configuration file in the <tt>js/src/liveconnect/config</tt> 
+      directory.&nbsp; The configuration file specifies the JVM headers/libraries 
+      used and allows for customization of command-line options.&nbsp; To date, 
+      the build system has been tested on Solaris, AIX, HP/UX, OSF, IRIX, x86 
+      Linux and Windows NT. Most platforms will work with either the vendor compiler 
+      or gcc.</font></li>
+    <li>Update your JVM's <tt><font size=+1>CLASSPATH</font></tt> to point to 
+      the <tt>js/src/liveconnect/classes</tt> subdirectory.&nbsp; (See above)</li>
+  </ul>
+</ul>
+
+<h2>
+<a NAME="coding_conventions"></a>Naming and coding conventions:</h2>
+
+<ul>
+<li>
+Public function names begin with JSJ_ followed by capitalized "intercaps",&nbsp;
+e.g. JSJ_ConnectToJavaVM.</li>
+
+<li>
+Extern but library-private function names use a jsj_ prefix and mixed case,
+e.g. jsj_LookupSymbol.</li>
+
+<li>
+Most static function names have unprefixed, underscore-separated names:
+get_char.</li>
+
+<li>
+But static native methods of JS objects have intercaps names, e.g., JavaObject_getProperty().</li>
+
+<li>
+And library-private and static data use underscores, not intercaps (but
+library-private data do use a js_ prefix).</li>
+
+<li>
+Scalar type names are lowercase and js-prefixed: jsdouble.</li>
+
+<li>
+Aggregate type names are JS-prefixed and mixed-case: JSObject.</li>
+
+<li>
+Macros are generally ALL_CAPS and underscored, to call out potential side
+effects, multiple uses of a formal argument, etc.</li>
+
+<li>
+Four spaces of indentation per statement nesting level.&nbsp; The files
+are space-filled, so adjusting of your tab setting should be unnecessary.</li>
+
+<li>
+I don't bow down to the ancient "80 columns per line" gods, since most
+of us are not using vt100's to read source code.&nbsp; My rule of thumb
+is to use no more than 95 columns per line, but exceptions are made to
+format tables or table-like code.</li>
+
+<li>
+DLL entry points have their return type expanded within a JS_EXPORT_API()&nbsp;
+macro call, to get the right Windows secret type qualifiers in the right
+places for both 16- and 32-bit builds.</li>
+
+<h2>
+<a NAME="API"></a>The LiveConnect API</h2>
+All public LiveConnect entry points and callbacks are documented in 
+<A HREF=http://lxr.mozilla.org/mozilla/source/js/src/liveconnect/jsjava.h>jsjava.h</A>,
+the header file that exports those functions.
+<br>&nbsp;
+<h2>
+<a NAME="File_walkthrough"></a>File walk-through</h2>
+&nbsp;
+<table BORDER=3 CELLSPACING=0 CELLPADDING=4 >
+<tr>
+<td>jsjava.h</td>
+
+<td>LiveConnect's only public header file.&nbsp; Defines all public API
+entry points, callbacks and types.&nbsp;</td>
+</tr>
+
+<tr>
+<td>jsj_private.h</td>
+
+<td>LiveConnect internal header file for intra-module sharing of functions
+and types.</td>
+</tr>
+
+<tr>
+<td>jsj.c</td>
+
+<td>Public LiveConnect API entry points and initialization code. Handling
+of multiple threads and multiple JVMs.</td>
+</tr>
+
+<tr>
+<td>jsj_array.c</td>
+
+<td>Read and write elements of a Java array, performing needed conversions
+to/from JS types.</td>
+</tr>
+
+<tr>
+<td>jsj_class.c</td>
+
+<td>Construct and manipulate JavaClassDescriptor structs, which are the
+native representation for Java classes.&nbsp; JavaClassDescriptors are
+used to describe the methods and fields of a class, including their type
+signatures, and include a reference to the peer <i>java.lang.Class</i>
+object.&nbsp; Since each Java object has a class, there is a JavaClassDescriptor
+associated with the JavaScript reflection of each Java Object.</td>
+</tr>
+
+<tr>
+<td>jsj_convert.c</td>
+
+<td>Convert between Java and JavaScript values of all types, which may
+require calling routines in other files to wrap JS objects as Java objects
+and vice-versa.</td>
+</tr>
+
+<tr>
+<td>jsj_field.c</td>
+
+<td>Reflect Java fields as properties of JavaObject objects and implement
+getter/setter access to those fields.</td>
+</tr>
+
+<tr>
+<td>jsj_JavaArray.c</td>
+
+<td>Implementation of the JavaScript JavaArray class.&nbsp; Instances of
+JavaArray are used to reflect Java arrays.</td>
+</tr>
+
+<tr>
+<td>jsj_JavaClass.c</td>
+
+<td>Implementation of the JavaScript JavaClass class.&nbsp;&nbsp; Instances
+of JavaClass are used to reflect Java classes.</td>
+</tr>
+
+<tr>
+<td>jsj_JavaObject.c</td>
+
+<td>Implementation of the JavaScript JavaObject class.&nbsp;&nbsp; Instances
+of JavaObject are used to reflect Java objects, except for Java arrays,
+although some of the code in this file is used by the JavaArray code.</td>
+</tr>
+
+<tr>
+<td>jsj_JavaMember.c</td>
+
+<td>Implementation of the JavaScript JavaMember class.&nbsp; JavaMember's
+are a strange beast required only to handle the special case of a public
+field and a public method that appear in the same Java class and which
+have the same name.</td>
+</tr>
+
+<tr>
+<td>jsj_JavaPackage.c</td>
+
+<td>Implementation of the JavaScript JavaPackage class.&nbsp;&nbsp; Instances
+of JavaPackage are used to reflect Java packages.&nbsp; The JS properties
+of a JavaPackage are either nested JavaPackage objects or a JavaClass object.</td>
+</tr>
+
+<tr>
+<td>jsj_JSObject.c</td>
+
+<td>Implementation of the native methods for the&nbsp; <i>netscape.javascript.JSObject</i>
+Java class, which are used for calling into JavaScript from Java.&nbsp;
+It also contains the code that wraps JS objects as instances of&nbsp; <i>netscape.javascript.JSObject
+</i>and
+the code that handles propagation of exceptions both into and out of Java.</td>
+</tr>
+
+<tr>
+<td>jsj_method.c</td>
+
+<td>Reflect Java methods as properties of JavaObject objects and make it
+possible to invoke those methods.&nbsp; Includes overloaded method resolution
+and argument/return-value conversion code.</td>
+</tr>
+
+<tr>
+<td>jsj_utils.c</td>
+
+<td>Low-level utility code for reporting errors, etc.</td>
+</tr>
+</table>
+
+<h2>
+<a NAME="sample_shell_interaction"></a>Sample LiveConnect shell interactions</h2>
+
+<h4>
+Java packages, classes and constructors</h4>
+<tt>js> java</tt>
+<br><tt>[JavaPackage java]</tt>
+<br><tt>js> awt = java.awt</tt>
+<br><tt>[JavaPackage java.awt]</tt>
+<br><tt>js> Rectangle = awt.Rectangle</tt>
+<br><tt>[JavaClass java.awt.Rectangle]</tt>
+<h4>
+Java instance fields and methods</h4>
+<tt>js> r = new java.awt.Rectangle(34, 23)</tt>
+<br><tt>java.awt.Rectangle[x=0,y=0,width=34,height=23]</tt>
+<br><tt>js> r.width - r.height</tt>
+<br><tt>11</tt>
+<br><tt>js> r.x = 7; r.y = 4</tt>
+<br><tt>4</tt>
+<br><tt>js> r</tt>
+<br><tt>java.awt.Rectangle[x=7,y=4,width=34,height=23]</tt>
+<br><tt>js> r.grow(3)</tt>
+<br><tt>There is no Java method java.awt.Rectangle.grow that matches JavaScript
+argument types (number).</tt>
+<br><tt>Candidate methods with the same name are:</tt>
+<br><tt>&nbsp;&nbsp; void grow(int, int)</tt>
+<p><tt>js> r.grow(3, 3)</tt>
+<br><tt>js> r</tt>
+<br><tt>java.awt.Rectangle[x=4,y=1,width=40,height=29]</tt>
+<h4>
+Java arrays</h4>
+<tt>js> s = new java.lang.String("mastiff")</tt>
+<br><tt>mastiff</tt>
+<br><tt>js> c = s.toCharArray()</tt>
+<br><tt>[C@298e9b</tt>
+<br><tt>js> c[0] = "b"; c[4] = "a"; c[5] = "r"; c[6] = "d"</tt>
+<br><tt>d</tt>
+<br><tt>js> s2 = new java.lang.String(c)</tt>
+<br><tt>bastard</tt>
+<h4>
+Java static fields and methods</h4>
+<tt>js> java.lang.reflect.Modifier.ABSTRACT</tt>
+<br><tt>1024</tt>
+<br><tt>js> java.lang.Math.sin(3) + 2</tt>
+<br><tt>2.1411200080598674</tt>
+<h4>
+Explicit resolution of overloaded Java methods</h4>
+<tt>js> x = "23"</tt>
+<br><tt>23</tt>
+<br><tt>js> java.lang.Math.abs(x)</tt>
+<br><tt>The choice of static Java method java.lang.Math.abs matching JavaScript
+argument types (string) is ambiguous.</tt>
+<br><tt>Candidate methods are:</tt>
+<br><tt>&nbsp;&nbsp; long abs(long)</tt>
+<br><tt>&nbsp;&nbsp; float abs(float)</tt>
+<br><tt>&nbsp;&nbsp; double abs(double)</tt>
+<br><tt>&nbsp;&nbsp; int abs(int)</tt>
+<br><tt>js> abs = java.lang.Math["abs(int)"]</tt>
+<p><tt>function abs(int)() {</tt>
+<br><tt>&nbsp;&nbsp;&nbsp; [native code]</tt>
+<br><tt>}</tt>
+<p><tt>js> abs(x)</tt>
+<br><tt>23</tt>
+<h4>
+Public Method/field enumeration</h4>
+<tt>js> out = java.lang.System.out</tt>
+<br><tt>java.io.PrintStream@2980f5</tt>
+<br><tt>js> for (m in out) print(m)</tt>
+<br><tt>println</tt>
+<br><tt>print</tt>
+<br><tt>checkError</tt>
+<br><tt>close</tt>
+<br><tt>flush</tt>
+<br><tt>write</tt>
+<br><tt>wait</tt>
+<br><tt>notifyAll</tt>
+<br><tt>notify</tt>
+<br><tt>toString</tt>
+<br><tt>equals</tt>
+<br><tt>hashCode</tt>
+<br><tt>getClass</tt>
+<br><tt>js> for (m in java.lang.String) print(m)</tt>
+<br><tt>copyValueOf</tt>
+<br><tt>valueOf</tt>
+<h4>
+'instanceof' and 'in' operators</h4>
+<tt>js> s = new java.lang.String("foop")</tt>
+<br><tt>foop</tt>
+<br><tt>js> s instanceof java.lang.Class</tt>
+<br><tt>false</tt>
+<br><tt>js> s instanceof java.lang.Object</tt>
+<br><tt>true</tt>
+<br><tt>js> "valueOf" in s</tt>
+<br><tt>true</tt>
+<br><tt>js> "NoSuchThing" in s</tt>
+<br><tt>false</tt>
+<h4>
+Applying JavaScript string methods to Java strings</h4>
+<tt>js> s = new java.lang.String("The rain in Spain falls mainly on my
+head.")</tt>
+<br><tt>The rain in Spain falls mainly on my head.</tt>
+<br><tt>js> s.match(/Spain.*my/)</tt>
+<br><tt>Spain falls mainly on my</tt>
+<h4>
+Applying JavaScript array methods to Java arrays</h4>
+<tt>js> s = new java.lang.String("JavaScript")</tt>
+<br><tt>JavaScript</tt>
+<br><tt>js> c = s.toCharArray()</tt>
+<br><tt>[C@298aef</tt>
+<br><tt>js> c.reverse()</tt>
+<br><tt>[C@298aef</tt>
+<br><tt>js> new java.lang.String(c)</tt>
+<br><tt>tpircSavaJ</tt>
+<br>&nbsp;
+</body>
+</html>