Javadoc and @see tag - unexpected content on quoted strings?

[Jonathan Gibbons]

Both seem odd.

I will investigate.  Thanks for the reports.

You can probably work around the issues by disabling doclint for now, 
-Xdoclint:none.

-- Jon

On 04/10/2013 06:31 AM, Dawid Weiss wrote:
> Hi there,
>
> I've switched to the latest 1.8 snapshot (b84) and javadoc went nuts
> about the following:
>
> 1)
>
> /**
>   * @see "http://www.google.com"
>   */
> public class Main {}
>
> C:\carrot2\carrotsearch.lingo3g\carrot2\tmp>javadoc -quiet  Main.java
> Main.java:3: error: unexpected content
>   * @see "http://www.google.com"
>     ^
> 1 error
>
> This seems odd. Then there's this thing which I didn't try to reproduce yet:
>
> 2)
>
>    [javadoc] C:\carrot2\carrotsearch.lingo3g\carrot2\core\carrot2-core\src\org\carrot2\core\Cluster.java:543:
> error: missing method body, or declare abstract
>    [javadoc]         .nullsFirst().onResultOf(new Function<Cluster, Integer>(){
>    [javadoc]                                                                  ^
>
> on a snippet of code that creates an inner class (and compiles cleanly).
>
>      public static final Comparator<Cluster> BY_SIZE_COMPARATOR =
> Ordering.natural()
>          .nullsFirst().onResultOf(new Function<Cluster, Integer>(){
>              public Integer apply(Cluster cluster)
>              {
>                  return cluster.size();
>              }
>          });
>
> Like I said, I couldn't reproduce it on a small example but it's
> definitely deterministic. Any clues? Are these known issues or should
> I file a bug (and try to write a reproducible snippet)?
>
> Dawid