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

Popular posts from this blog

java - Run a .jar on Heroku -

java - Jtable duplicate Rows -

validation - How to pass paramaters like unix into windows batch file -