This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 157320 - Javadoc is not generated when "@Documented" annotations are used
Summary: Javadoc is not generated when "@Documented" annotations are used
Status: RESOLVED FIXED
Alias: None
Product: apisupport
Classification: Unclassified
Component: Harness (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: Jesse Glick
URL:
Keywords:
Depends on:
Blocks: 137437
  Show dependency tree
 
Reported: 2009-01-22 16:28 UTC by Petr Hejl
Modified: 2009-02-19 20:18 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Petr Hejl 2009-01-22 16:28:55 UTC
When are common annotations are used (api.annotations.common) are used the javadoc is not generated for some reason.
Could be related to @Documented.
Comment 1 Jesse Glick 2009-01-22 18:10:58 UTC
Reproducible:

javadoc-exec-packages:
Generating Javadoc
Javadoc execution
Loading source files for package org.netbeans.api.extexecution...
Loading source files for package org.netbeans.api.extexecution.input...
Loading source files for package org.netbeans.api.extexecution.print...
Constructing Javadoc information...
com.sun.tools.javac.code.Symbol$CompletionFailure: file javax/annotation/Nonnull.class not found
javadoc: error - fatal exception
1 error
Comment 2 Jesse Glick 2009-01-22 19:23:24 UTC
Similar to issue #152562. Javadoc execution fails only on JDK 5; JDK 6 prints a warning but continues:

Loading source files for package org.netbeans.api.extexecution...
Loading source files for package org.netbeans.api.extexecution.input...
Loading source files for package org.netbeans.api.extexecution.print...
Constructing Javadoc information...
org/netbeans/api/annotations/common/NonNull.class(org/netbeans/api/annotations/common:NonNull.class): warning: Cannot
find annotation method 'when()' in type 'javax.annotation.Nonnull': class file for javax.annotation.Nonnull not found
org/netbeans/api/annotations/common/NullAllowed.class(org/netbeans/api/annotations/common:NullAllowed.class): warning:
Cannot find annotation method 'when()' in type 'javax.annotation.Nonnull'
org/netbeans/api/annotations/common/CheckForNull.class(org/netbeans/api/annotations/common:CheckForNull.class): warning:
Cannot find annotation method 'when()' in type 'javax.annotation.Nonnull'
Standard Doclet version 1.6.0_11
....
Comment 3 Jesse Glick 2009-01-22 19:43:33 UTC
core-main #87b569ceac85

Don't forget to readd extexecution to the Javadoc list when in main.
Comment 4 Petr Hejl 2009-01-22 22:39:07 UTC
Extexecution added - main 4f681a1a05af.
Comment 5 Jesse Glick 2009-01-22 23:10:41 UTC
Seems to be working.
Comment 6 Quality Engineering 2009-01-23 07:31:35 UTC
Integrated into 'main-golden', will be available in build *200901230201* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main/rev/87b569ceac85
User: Jesse Glick <jglick@netbeans.org>
Log: #157320: working around JDK 5 javadoc bug involving annotations.
If an annotation is annotated with an annotation from a private package,
JDK 5 javadoc would abort. (JDK 6 javadoc just prints a warning.)
Comment 7 Jesse Glick 2009-01-23 14:36:43 UTC
Working on builder machine too:

http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/javadoc/org-netbeans-modules-extexecution/org/netbeans/api/extexecution/input/InputProcessors.html#printing(org.openide.windows.OutputWriter,%20org.netbeans.api.extexecution.print.LineConvertor,%20boolean)

BTW it seems that api.annotations.common is not in ${config.javadoc.stable}, so references to @NonNull etc. are not
hyperlinked.
Comment 8 Petr Hejl 2009-01-23 20:37:27 UTC
Javadoc updated and marked as stable - main c4244db96109, 6f7b1932bd4d, d767586c251b.
Should work in next pass.
Comment 9 Jesse Glick 2009-01-23 20:50:29 UTC
You might need to put api.annotations.common _before_ extexecution.
Comment 10 Petr Hejl 2009-01-23 20:56:58 UTC
I've just found that out. Thanks Jesse.
main 3801d5fba7b4