# HG changeset patch
# User Jaroslav Tulach <jaroslav.tulach@oracle.com>
# Date 1450079195 -3600
# Node ID cff4a9d3e72a05da1799ac973a3edcc28f74176a
# Parent  1cb72700c10e580a9270d792ff746a7846cdb7ce
Enumerating allowed interop types

diff -r 1cb72700c10e -r cff4a9d3e72a truffle/com.oracle.truffle.api.interop/src/com/oracle/truffle/api/interop/package-info.java
--- 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>
diff -r 1cb72700c10e -r cff4a9d3e72a truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java
--- 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