Bug 1113877

Description of problem:

I am not sure if this is a real bug or just misconfiguration, but javadoc tool seems to behave improperly in some certain situations. To be more specific, when serializable classes are involved.

I have a simple project with only one class:

$ cat src/com/example/MyClass.java
package com.example;
import java.io.Serializable;
public class MyClass implements Serializable {
}

Note the fact that the class is serializable is important here.

Now I have some other class, which is not part of the project, but it accidentally resides in same package as class above. This class will later get on javadoc's classpath:

$ cat lib/com/example/MyServlet.java
package com.example;
import javax.servlet.http.HttpServlet;
public class MyServlet extends HttpServlet {
}

The class is also serializable.

Now I will build my project and try to generate javadocs for it:

$ javac -d classes src/com/example/MyClass.java
$ javadoc -classpath classes/:lib/ -sourcepath src/ -d apidocs com.example

Note the lib/ directory contains compiled "MyServlet" class. I am also putting compiled MyClass on classpath. It may seem strange, but maven-javadoc-plugin does just that. Another important thing here is that compiled class MyClass from my project is on classpath *before* lib/ directory. If I put it at the end, the problem will not occur.
The output from command above is:

Loading source files for package com.example...
Constructing Javadoc information...
Creating destination directory: "apidocs/"
Standard Doclet version 1.8.0_05
Building tree for all the packages and classes...
Generating apidocs/com/example/MyClass.html...
Generating apidocs/com/example/package-frame.html...
Generating apidocs/com/example/package-summary.html...
Generating apidocs/com/example/package-tree.html...
Generating apidocs/constant-values.html...
Generating apidocs/serialized-form.html...
javadoc: error - com.sun.tools.doclets.internal.toolkit.util.DocletAbortException: com.sun.tools.javac.code.Symbol$CompletionFailure: class file for javax.servlet.http.HttpServlet not found
1 error

It seems that javadoc considers MyServlet class as part of the project from some reason and tries to include it in "serialized-form" page. If I add servlet-api JAR to classpath:

$ javadoc -classpath src/:lib/:`build-classpath glassfish-servlet-api` -sourcepath src/ -d apidocs com.example

javadoc will indeed generate serialized-form.html with following line:

"Class com.example.MyServlet extends javax.servlet.http.HttpServlet implements Serializable"

Note only serialized-form page seems to be affected, rest of the html pages seems correct. No mention of MyServlet elsewhere.

To sum it up, the problem occurs if:
- project contains at least one serializable class
- another serializable class which resides in same package as project's classes is on classpath
- compiled project classes are also on classpath and they are before class(es) from previous point

Version-Release number of selected component (if applicable):
java-1.8.0-openjdk-1.8.0.5-13.b13.fc21.x86_64

How reproducible:
100%

Steps to Reproduce:
1. download and unpack reproducer.tar.gz
2. yum install -y glassfish-servlet-api
3. javac -d classes src/com/example/MyClass.java
4. javac -cp `build-classpath glassfish-servlet-api` lib/com/example/MyServlet.java
5. javadoc -classpath classes/:lib/ -sourcepath src/ -d apidocs com.example

Actual results:
javadoc fails or generates incorrect serialized-form.html

Expected results:
no fail and serialized-form.html without elements which shouldn't be there

Additional info:
javadoc in openjdk7 behaves similarly, but it's less strict and it doesn't fail. It just prints warning about missing class file for javax.servlet.http.HttpServlet and continues. The serialized-form.html page is then completely empty (at least MyClass should be there).