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