CODEWITHSUNDEEP
javaeclipsejavadoc
John Hascall
John Hascall

Reputation: 9416

Only first constructor showing up in javadoc (run from eclipse)?

Why is only the first constructor showing up in the javadoc?

Code excerpt:

/**
 * Returns a <code>Config</code> object resulting from parsing a
 * configuration file.
 * 
 * @param p a <code>Path</code> object representing the configuration file.
 */
public Config(Path p) {
    ...code elided here...
}

/**
 * Returns a <code>Config</code> object resulting from parsing a
 * configuration file.
 * 
 * @param filename a <code>String</code> naming the configuration file.
 */
public Config(String filename) {
    this(Paths.get(filename));
}

Javadoc excerpt:

There can be only one

(similarly only the one shows up in the "Constructor Detail" as well)

Details for posterity: OS X 10.8.5, Eclipse EE Juno SR2, Java 1.7.0_72(but see accepted answer)

Upvotes: 3

Views: 203

Answers (1)

nyname00
nyname00

Reputation: 2566

I could reproduce the issue with 1.6.0_21, using javadoc command-line tool directly. It, understandably, complains that package java.nio.file does not exist buts still manages to create the files (with only one of your constructors).

It looks like you're using a 1.6 (or older) javadoc tool to generate docs for 1.7+ sources (this would also explain why your screenshot looks kinda ... 'old')

Upvotes: 1

Related Questions