From bdbde79b7c4be98f9ecddaeaf45fafa008c34ebf Mon Sep 17 00:00:00 2001
From: "nboyd%atg.com" <nboyd%atg.com@18797224-902f-48f8-a5cc-f745e15eee43>
Date: Tue, 10 Oct 2000 14:58:47 +0000
Subject: [PATCH] More javadoc.

git-svn-id: svn://10.0.0.236/trunk@80834 18797224-902f-48f8-a5cc-f745e15eee43
---
 mozilla/js/rhino/org/mozilla/javascript/Scriptable.java     | 6 +++++-
 mozilla/js/rhino/src/org/mozilla/javascript/Scriptable.java | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/mozilla/js/rhino/org/mozilla/javascript/Scriptable.java b/mozilla/js/rhino/org/mozilla/javascript/Scriptable.java
index a45f15fa0f4..c64d7ef7c3d 100644
--- a/mozilla/js/rhino/org/mozilla/javascript/Scriptable.java
+++ b/mozilla/js/rhino/org/mozilla/javascript/Scriptable.java
@@ -187,7 +187,10 @@ public interface Scriptable {
      * <LI>org.mozilla.javascript.Scriptable objects</LI>
      * <LI>null</LI>
      * <LI>The value returned by Context.getUndefinedValue()</LI> 
-     * </UL><p>    
+     * </UL><p> 
+     * Arbitrary Java objects may be wrapped in a Scriptable by first calling
+     * <code>Context.toObject</code>. This allows the property of a JavaScript
+     * object to contain an arbitrary Java object as a value.<p> 
      * Note that <code>has</code> will be called by the runtime first before
      * <code>set</code> is called to determine in which object the
      * property is defined.
@@ -199,6 +202,7 @@ public interface Scriptable {
      * @see org.mozilla.javascript.Scriptable#has
      * @see org.mozilla.javascript.Scriptable#get
      * @see org.mozilla.javascript.ScriptableObject#putProperty
+     * @see org.mozilla.javascript.Context#toObject
      */
     public void put(String name, Scriptable start, Object value);
 
diff --git a/mozilla/js/rhino/src/org/mozilla/javascript/Scriptable.java b/mozilla/js/rhino/src/org/mozilla/javascript/Scriptable.java
index a45f15fa0f4..c64d7ef7c3d 100644
--- a/mozilla/js/rhino/src/org/mozilla/javascript/Scriptable.java
+++ b/mozilla/js/rhino/src/org/mozilla/javascript/Scriptable.java
@@ -187,7 +187,10 @@ public interface Scriptable {
      * <LI>org.mozilla.javascript.Scriptable objects</LI>
      * <LI>null</LI>
      * <LI>The value returned by Context.getUndefinedValue()</LI> 
-     * </UL><p>    
+     * </UL><p> 
+     * Arbitrary Java objects may be wrapped in a Scriptable by first calling
+     * <code>Context.toObject</code>. This allows the property of a JavaScript
+     * object to contain an arbitrary Java object as a value.<p> 
      * Note that <code>has</code> will be called by the runtime first before
      * <code>set</code> is called to determine in which object the
      * property is defined.
@@ -199,6 +202,7 @@ public interface Scriptable {
      * @see org.mozilla.javascript.Scriptable#has
      * @see org.mozilla.javascript.Scriptable#get
      * @see org.mozilla.javascript.ScriptableObject#putProperty
+     * @see org.mozilla.javascript.Context#toObject
      */
     public void put(String name, Scriptable start, Object value);