hg: jdk7/tl/langtools: 7003550: Loosen modeling requirements for annotation processing erroneous code

[Bruce Chapman]

On 9/12/2010 6:17 p.m., joe.darcy at oracle.com wrote:
> Changeset: 23fc45d3a572
> Author:    darcy
> Date:      2010-12-08 21:21 -0800
> URL:       http://hg.openjdk.java.net/jdk7/tl/langtools/rev/23fc45d3a572
>
> 7003550: Loosen modeling requirements for annotation processing erroneous code
> Reviewed-by: jjg
>
> ! src/share/classes/javax/lang/model/element/package-info.java
>
>

+ * code is not syntactically well-formed or has some other
+ * irrecoverable error that could not be removed by the generation of
+ * new types, a model may or may not be provided as a quality of
+ * implementation issue.
+ * If a program is syntactically valid but erroneous in some other
+ * fashion, any returned model must have no less information than if
+ * all the method bodies in the program were replaced by {@code "throw
+ * new RuntimeException();"}. If a program refers to a missing type 
XYZ, A wee nit. Either the sentence starting at "If a program is 
syntactically.." is part of the preceding paragraph in which case it 
ought not start on a new line, OR it is the start of a new paragraph so 
should be preceded by </p><p> - at present it looks like a new paragraph 
in source code, but won't in the javadoc. Bruce