Mercurial > hg > truffle
changeset 22391:5938e5eb3867
Clarify comment of TruffleLanguage.parse() for implementers
| author | Stefan Marr <stefan.marr@jku.at> |
|---|---|
| date | Thu, 19 Nov 2015 15:49:00 +0100 |
| parents | 4e426a6f7990 |
| children | 69f871f73009 |
| files | truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleLanguage.java |
| diffstat | 1 files changed, 4 insertions(+), 2 deletions(-) [+] |
line wrap: on
line diff
--- 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