Better document relation with Factory10 interface and UnsupportedMessageException about graal HOT 6 CLOSED

Indeed, we should add a @GeneratedBy annotation. This also helps with navigating from the generated class to the source class in an IDE.

from graal.

Using @GeneratedBy is OK. Other option is to generate Javadoc and include @link references. Those are good for navigation as well.

from graal.

Where does SL throw such an exception?
AFAIK, SL is using Interop-DSL, which generates a Factory10 implementation (which throws an UnsupportedMessageException).

@jtulach returning null is not a good idea - I think the JavaDoc of Factory10 is wrong.
One has to raise an UnsupportedMessageException (i.e., doing UnsupportedMessageException.raise(Message.XXX); ).

from graal.

@grimmerm you can see throwing of these exception in the com.oracle.truffle.sl.runtime.SLxxxxMessageResolutionForeign classes. It's not clear that these are generated automatically -- nothing in the source indicate that, there's no @GeneratedBy or header comment telling so.

from graal.

@grimmerm please fix this.

from graal.

There are currently no plans to fix this minor issue.

from graal.