java - Eclipse complaining about Javadoc even after Disabling javadoc in compiler options, and inconsistent -
i've got open source code using {@code annotation eclipse complaining about. since don't care turned off javadoc in compiler options, it's still complaining , not compile compile.
error is: "javadoc: missing closing brace inline tag"
actually closing brace present. in cases it's few lines down, in others it's on same line!
even stranger: same code in smaller project in different workspace works ok. i've compared 2 projects' settings couple times , appear same. in many cases options set not allow project specific settings.
i did other things doing project clean, , trying java 1.5 vs. 1.7 compiler options, etc.
other details:
- java 7 on mac
 - eclipse kepler
 - code guice 2.0 (i know that's old, , should use jar, long story)
 - one example key.java line 107, see below
 
example guice code (though wouldn't care since it's comments)
  /**     ...    * <p>{@code new key<foo>() {}}.      
@code tag has few caveats (see: multiple line code example in javadoc comment)... 1 of need avoid mixing tag braces , actual content braces in same line.
with in mind rewrite javadoc as:
 <p><pre><code>new key{@literal<foo>}(){}</code><pre>.</p>   you use @code prevent <foo> being interpreted html tag.
i'm using @literal since contents wrapped <code> tag. <pre> tag used retain spaces , line breaks. 
about javadoc configuration, if want sweep dirt under rug, go to:
windows -> preferences -> java -> compiler -> javadoc   and set malformed javadoc comments ignore. apply, rebuild , should ready go (also make sure specific project settings under project -> properties-> java compiler -> javadoc not messing setup). 
Comments
Post a Comment