# HG changeset patch
# User Stefan Marr <stefan.marr@jku.at>
# Date 1447944540 -3600
# Node ID 5938e5eb38674be03c4792071029cb9f4540bd95
# Parent  4e426a6f7990b5cd4ebf347dfce07b32cdf57ed1
Clarify comment of TruffleLanguage.parse() for implementers

diff -r 4e426a6f7990 -r 5938e5eb3867 truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleLanguage.java
--- a/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleLanguage.java	Thu Nov 19 15:46:01 2015 +0100
+++ b/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleLanguage.java	Thu Nov 19 15:49:00 2015 +0100
@@ -157,8 +157,10 @@
 
     /**
      * Parses the provided source and generates appropriate AST. The parsing should execute no user
-     * code, it should only create the {@link Node} tree to represent the source. The parsing may be
-     * performed in a context (specified as another {@link Node}) or without context. The
+     * code, it should only create the {@link Node} tree to represent the source. If the provided
+     * source does not correspond naturally to a call target, the returned call target should create
+     * and if necessary initialize the corresponding language entity and return it. The parsing may
+     * be performed in a context (specified as another {@link Node}) or without context. The
      * {@code argumentNames} may contain symbolic names for actual parameters of the call to the
      * returned value. The result should be a call target with method
      * {@link CallTarget#call(java.lang.Object...)} that accepts as many arguments as were provided