changeset 22494:cff4a9d3e72a

Enumerating allowed interop types
author Jaroslav Tulach <jaroslav.tulach@oracle.com>
date Mon, 14 Dec 2015 08:46:35 +0100
parents 1cb72700c10e
children bfc98cc37934
files truffle/com.oracle.truffle.api.interop/src/com/oracle/truffle/api/interop/package-info.java truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java
diffstat 2 files changed, 18 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/truffle/com.oracle.truffle.api.interop/src/com/oracle/truffle/api/interop/package-info.java	Sat Dec 12 13:34:49 2015 +0100
+++ b/truffle/com.oracle.truffle.api.interop/src/com/oracle/truffle/api/interop/package-info.java	Mon Dec 14 08:46:35 2015 +0100
@@ -33,8 +33,17 @@
  * This package provides inter-operability between different
  * {@link com.oracle.truffle.api.TruffleLanguage Truffle languages}.
  * <p>
- * Languages can exchange primitive Java type wrapper objects (e.g., {@link java.lang.Integer},
- * {@link java.lang.Double}, {@link java.lang.String}, etc) as well as any type implementing
+ * Languages can exchange primitive Java type wrapper objects (e.g., 
+ * {@link java.lang.Byte},
+ * {@link java.lang.Short},
+ * {@link java.lang.Integer},
+ * {@link java.lang.Long},
+ * {@link java.lang.Float},
+ * {@link java.lang.Double},
+ * {@link java.lang.Character},
+ * {@link java.lang.Boolean},
+ * and {@link java.lang.String}) 
+ * as well as any type implementing 
  * {@link com.oracle.truffle.api.interop.TruffleObject}. Foreign objects are precisely those
  * implementing {@link com.oracle.truffle.api.interop.TruffleObject}.
  * <p>
--- a/truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java	Sat Dec 12 13:34:49 2015 +0100
+++ b/truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java	Mon Dec 14 08:46:35 2015 +0100
@@ -678,7 +678,13 @@
          * should set the value to the field; the return value should be the actual value of the
          * field when the <code>invoke</code> method returns.
          *
-         * @param args arguments to pass when invoking the symbol
+         * @param args arguments to pass when invoking the symbol; either wrappers of Java primitive
+         *            types (e.g. {@link java.lang.Byte}, {@link java.lang.Short},
+         *            {@link java.lang.Integer}, {@link java.lang.Long}, {@link java.lang.Float},
+         *            {@link java.lang.Double}, {@link java.lang.Character},
+         *            {@link java.lang.Boolean}, and {@link java.lang.String}) or a
+         *            {@link TruffleObject object created} by one of the languages)
+         * 
          * @return symbol wrapper around the value returned by invoking the symbol, never
          *         <code>null</code>
          * @throws IOException signals problem during execution