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

Dawid Weiss dawid.weiss at gmail.com
Wed Apr 10 06:31:59 PDT 2013


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


More information about the javadoc-dev mailing list