Issue Details (XML | Word | Printable)

Key: GLASSFISH-540
Type: Bug Bug
Status: Open Open
Priority: Minor Minor
Assignee: prasads
Reporter: marina vatkina
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
glassfish

maven javadoc cannot resolve JDK references

Created: 04/Apr/06 07:02 PM   Updated: 06/Mar/12 09:56 PM
Component/s: build_system
Affects Version/s: 9.0pe
Fix Version/s: not determined

Time Tracking:
Not Specified

Environment:

Operating System: All
Platform: Sun


Issuezilla Id: 540
Status Whiteboard:

as9-na

Tags: 3_1-exclude
Participants: dpatil, gfbugbridge, marina vatkina, prasads, sridatta, tcng and Tom Mueller


 Description  « Hide

Tested on the latest code in trunk in persistence-api:
% maven -o javadoc
...
[javadoc] Building tree for all the packages and classes...
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Basic.java:54:
warning - Tag @link: reference not found: java.math.BigInteger java.math.BigInteger
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Basic.java:54:
warning - Tag @link: reference not found: java.math.BigDecimal java.math.BigDecimal
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Basic.java:54:
warning - Tag @link: reference not found: java.sql.Date java.sql.Date
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Basic.java:54:
warning - Tag @link: reference not found: java.sql.Time java.sql.Time
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Basic.java:54:
warning - Tag @link: reference not found: java.sql.Timestamp java.sql.Timestamp
[javadoc]
/faith4/gf/glassfish/persistence-api/src/java/javax/persistence/Version.java:64:
warning - Tag @link: reference not found: java.sql.Timestamp Timestamp



dpatil added a comment - 05/Apr/06 11:08 AM

Email Conversation with Prasad:

As per the scope of javadocs, we would generate javadocs from sources ,
internally. For folks on glassfish.dev.java.net , we would be staging these
generated javadocs. Hence generating javadocs from modules in Glassfish is not
supported.

Try following to generate javadocs from appserv module where Prasad may have
fixed this issue already.
> cvs co appserv
> cd appserv; maven checkout bootstrap javadoc | tee log

This should generate correct javadocs for all modules including source and
binary modules. log file in above commands should not show those warning msgs.

Also I just confirmed it by running above command and no warning messages in
persistence-api module, although there are still 217 warning messages in other
modules which needs to be fixed.

Assigning it to Prasad for further fixes.


dpatil added a comment - 05/Apr/06 11:10 AM

Need to fix the rest of the warning and variable ${s1as-javadocs.publish.home}
value.

[copy] Copying 31 files to
/export/tinderbox/dinesh/ws45/m_jws/appserv/${s1as-javadocs.publish.home}/javax/xml/registry/images


dpatil added a comment - 05/Apr/06 11:11 AM

Assigning it to Prasad


marina vatkina added a comment - 05/Apr/06 12:07 PM

Internal generation of javadocs is not an option for an open source project.
It should be possible to generate javadocs from each GlassFish module.


tcng added a comment - 28/Apr/06 10:02 PM

related to build infrastructure


gfbugbridge added a comment - 26/Jun/06 09:27 AM

<BT6443394>


sridatta added a comment - 15/May/07 11:33 AM

Not a v2 stopper


prasads added a comment - 07/Oct/10 05:24 AM

Excluding these issues from v3.1


Tom Mueller added a comment - 06/Mar/12 09:56 PM

Bulk update to change fix version to "not determined" for all issues still open but with a fix version for a released version.