[GLASSFISH-11405] extand javadoc to include usage info... Created: 07/Jan/10  Updated: 06/Mar/12

Status: Open
Project: glassfish
Component/s: webpages
Affects Version/s: V3
Fix Version/s: not determined

Type: Improvement Priority: Critical
Reporter: vince kraemer Assignee: Alexis MP
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Operating System: All
Platform: Sun

Issuezilla Id: 11,405


The Usage info in the Java SE docs is pretty useful for learning and using an
API. It would be nice to see that kind of info included in the javadoc for

To see what I mean, compare the headers of this page


with this page


Comment by Alexis MP [ 01/Sep/10 ]

Trying to clarify the request - is this related to specific classes which should have more javadoc data or to
the way the javadocs are generated? (I don't see a big difference between the two javadoc pages you

Comment by vince kraemer [ 01/Sep/10 ]

There is a link labeled 'Use' at the top of the javadoc page for DragSource.

That link is not present on the javadoc page for DomainRoot.

The data on that 'Use' page can be very helpful when you are learning an API/SPI.

Comment by Tom Mueller [ 06/Mar/12 ]

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

[GLASSFISH-15505] [UB]docs: need to represent partial Connector Architecture Specification support in Web Profile Created: 10/Jan/11  Updated: 29/Mar/11

Status: In Progress
Project: glassfish
Component/s: webpages
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Major
Reporter: Jagadish Assignee: Alexis MP
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Tags: 3_1-release-note-added, 3_1-release-notes


Raising this issue based on the forum discussion :

In section titled "Java EE 6 standards" of Release Notes (3.1) please make the following changes.
Also applicable for the following pages :

  • In the row for "Connector Architecture 1.6", indicate yes against web
    profile but with an footnote that indicates "Standalone Connector 1.6
    Container only". Against Full Profile, retain the current value.

Comment by Scott Fordin [ 25/Mar/11 ]

Added 3_1-release-notes tag for tracking purposes.

Comment by Scott Fordin [ 25/Mar/11 ]

Updated table in 3.1 Release Notes, and added "3_1-release-note-added" tag. Reassigned to Paul Davies because I don't own the public Web pages for which the change also needs to be made. Paul may know who owns these pages. If not, to whom should this issue be reassigned?

Comment by Paul Davies [ 29/Mar/11 ]

Reassigned to alexismp, who is responsible for the GF site web pages.

Comment by Alexis MP [ 29/Mar/11 ]

Taking over the issue but missing some context (the forum link is now a 404).
Are you saying 3.0.1 and 3.0 download pages need to be changed but not http://glassfish.java.net/downloads/3.1-final.html ?
The table rows maps to IPS packages installed in the distro. Which connector package is in the Web profile distro?

Generated at Thu Sep 29 07:54:32 UTC 2016 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.