Description Markus Keller 2006-02-19 18:56:05 EST

I20060217-1115

The javadoc of ITypeBinding#isAssignmentCompatible() is not as crystal clear as it could be. The term "compatible" suggests that the relation is bidirectional, which is clearly not the case. Furthermore, JLS3 5.2 only defines assignment "conversion", not "compatibility".

A definition like this would make things much clearer (and would correct the typo in "assigment"):

/**
 * Returns whether an expression of this type can be assigned to a variable
 * of the given type, as specified in section 5.2 of <em>The Java Language 
 * Specification, Third Edition</em> (JLS3).
 * 
 * @param variableType the type of a variable to check compatibility against
 * @return <code>true</code> if an expression of this type can be assigned to a
 *   variable of the given type, and <code>false</code> otherwise
 * @since 3.1
 */
public boolean isAssignmentCompatible(ITypeBinding variableType);