MMBase

javadoc cross-references

Details

  • Type: Sub-task Sub-task
  • Status: Resolved Resolved
  • Priority: Major Major
  • Resolution: Fixed
  • Affects Version/s: 1.9.0
  • Fix Version/s: 1.9.0
  • Component/s: None
  • Description:
    Hide
    We used to generate one giant javadoc for most applications/contributions. This was useful, because that meant you coudl very easily clikc between all kind of mmbase related classes.

    Maven generates seperate javadoc for every application/contribution. It is doubtfull wether indeed this is better, but any way it would be logical if at least references to mmbase classes are clickable.

    As an example. Browse to:
    http://www.mmbase.org/mm/multiproject/mmbase-resources/apidocs/org/mmbase/servlet/AttachmentServlet.html

    IMHO it is absurde that you can click on java.lang.Object, but not on org.mmbase.servlet.BridgeServlet.

    This is the version as produces by ant:
    http://www.mmbase.org/api/org/mmbase/servlet/AttachmentServlet.html

    This also produces linsk to HttpServlet, and also is styled.

    Shortly, the ant generated javadoc was IMHO better in several ways, but the lack of cross-references is the most important one, which I'd like to see fixed.
    Show
    We used to generate one giant javadoc for most applications/contributions. This was useful, because that meant you coudl very easily clikc between all kind of mmbase related classes. Maven generates seperate javadoc for every application/contribution. It is doubtfull wether indeed this is better, but any way it would be logical if at least references to mmbase classes are clickable. As an example. Browse to: http://www.mmbase.org/mm/multiproject/mmbase-resources/apidocs/org/mmbase/servlet/AttachmentServlet.html IMHO it is absurde that you can click on java.lang.Object, but not on org.mmbase.servlet.BridgeServlet. This is the version as produces by ant: http://www.mmbase.org/api/org/mmbase/servlet/AttachmentServlet.html This also produces linsk to HttpServlet, and also is styled. Shortly, the ant generated javadoc was IMHO better in several ways, but the lack of cross-references is the most important one, which I'd like to see fixed.

Activity

Hide
Nico Klasens added a comment - 2008-10-04 19:08
added maven.javadoc.links
added maven.javadoc.stylesheet
Show
Nico Klasens added a comment - 2008-10-04 19:08 added maven.javadoc.links added maven.javadoc.stylesheet

People

Dates

  • Created:
    2008-09-08 12:00
    Updated:
    2008-10-04 19:08
    Resolved:
    2008-10-04 19:08