Details

    • Type: Task Task
    • Status: Closed Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 2.1
    • Labels:
      None
    • Number of attachments :
      1

      Activity

      Hide
      Maria Odea Ching added a comment -

      I think "Usage" is better and more descriptive.. I'll just update the docs and apply the comments above. Thanks!

      Show
      Maria Odea Ching added a comment - I think "Usage" is better and more descriptive.. I'll just update the docs and apply the comments above. Thanks!
      Hide
      Maria Odea Ching added a comment -

      Additional review comments in the mailing list from Dennis Lundberg were not applied in the documentation.

      I've read through the docs and here are some comments:

      All

      • The title for all pages is "Maven Javadoc Report", but all references in the text refers to Maven Javadoc Plugin.

      usage.html

      • Do we need to include the configuration section in the sample pom? There is no mention of the max/minmemory settings in the text.

      jar-mojo.html

      • This page is very wide, wider than my 1280 screen. The reason is the "groups" param example code, and also the "tags" example. I see in the source code that there are line breaks inside the pre-tag, but they seem to be ignored. Perhaps a bug in the plugin plugin or the used javadoc parser?
      • finalName param: "Specified the" -> "Specifies the"
      • nocomment param: "Ssee" -> "See"
      • nonavbar param: Seems to be copy-and-pasted from "noindex" + two default values
      • old param: "This option created" -> "This option creates"
      • windowtitle param: two default values

      examples/*.html (except alternate-doclet.html)

      • The poms in these examples have the javadoc plugin configured in the build section. Shouldn't it be the reporting section?


      Dennis Lundberg

      Show
      Maria Odea Ching added a comment - Additional review comments in the mailing list from Dennis Lundberg were not applied in the documentation. I've read through the docs and here are some comments: All The title for all pages is "Maven Javadoc Report", but all references in the text refers to Maven Javadoc Plugin. usage.html Do we need to include the configuration section in the sample pom? There is no mention of the max/minmemory settings in the text. jar-mojo.html This page is very wide, wider than my 1280 screen. The reason is the "groups" param example code, and also the "tags" example. I see in the source code that there are line breaks inside the pre-tag, but they seem to be ignored. Perhaps a bug in the plugin plugin or the used javadoc parser? finalName param: "Specified the" -> "Specifies the" nocomment param: "Ssee" -> "See" nonavbar param: Seems to be copy-and-pasted from "noindex" + two default values old param: "This option created" -> "This option creates" windowtitle param: two default values examples/*.html (except alternate-doclet.html) The poms in these examples have the javadoc plugin configured in the build section. Shouldn't it be the reporting section? – Dennis Lundberg
      Hide
      Maria Odea Ching added a comment -

      Applied the comments above in the plugin docs. The staging site has also been updated http://people.apache.org/~oching/maven-javadoc-plugin
      Thanks

      Show
      Maria Odea Ching added a comment - Applied the comments above in the plugin docs. The staging site has also been updated http://people.apache.org/~oching/maven-javadoc-plugin Thanks
      Hide
      Wendy Smoak added a comment -

      Change the example on the alternate doclet page to one that works with the newly released version of UmlGraph.

      Separate reportsets are no longer necessary, UmlGraphDoc now generates UML diagrams as part of the Javadoc.

      Show
      Wendy Smoak added a comment - Change the example on the alternate doclet page to one that works with the newly released version of UmlGraph. Separate reportsets are no longer necessary, UmlGraphDoc now generates UML diagrams as part of the Javadoc.
      Hide
      Maria Odea Ching added a comment -

      Updated the alternate doclet page and the staging site http://people.apache.org/~oching/maven-javadoc-plugin.

      Show
      Maria Odea Ching added a comment - Updated the alternate doclet page and the staging site http://people.apache.org/~oching/maven-javadoc-plugin .

        People

        • Assignee:
          Maria Odea Ching
          Reporter:
          Maria Odea Ching
        • Votes:
          0 Vote for this issue
          Watchers:
          0 Start watching this issue

          Dates

          • Due:
            Created:
            Updated:
            Resolved:

            Time Tracking

            Estimated:
            Original Estimate - Not Specified
            Not Specified
            Remaining:
            Remaining Estimate - 0 minutes
            0m
            Logged:
            Time Spent - 1 day, 10 hours
            1d 10h