glassfish
  1. glassfish
  2. GLASSFISH-540

maven javadoc cannot resolve JDK references

    Details

    • Type: Bug Bug
    • Status: Open
    • Priority: Minor Minor
    • Resolution: Unresolved
    • Affects Version/s: 9.0pe
    • Fix Version/s: not determined
    • Component/s: build_system
    • Labels:
      None
    • Environment:

      Operating System: All
      Platform: Sun

      Description

      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

        Activity

        Hide
        dpatil added a comment -

        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.

        Show
        dpatil added a comment - 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.
        Hide
        dpatil added a comment -

        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

        Show
        dpatil added a comment - 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
        Hide
        dpatil added a comment -

        Assigning it to Prasad

        Show
        dpatil added a comment - Assigning it to Prasad
        Hide
        marina vatkina added a comment -

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

        Show
        marina vatkina added a comment - Internal generation of javadocs is not an option for an open source project. It should be possible to generate javadocs from each GlassFish module.
        Hide
        tcng added a comment -

        related to build infrastructure

        Show
        tcng added a comment - related to build infrastructure
        Hide
        gfbugbridge added a comment -

        <BT6443394>

        Show
        gfbugbridge added a comment - <BT6443394>
        Hide
        sridatta added a comment -

        Not a v2 stopper

        Show
        sridatta added a comment - Not a v2 stopper
        Hide
        prasads added a comment -

        Excluding these issues from v3.1

        Show
        prasads added a comment - Excluding these issues from v3.1
        Hide
        Tom Mueller added a comment -

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

        Show
        Tom Mueller added a comment - Bulk update to change fix version to "not determined" for all issues still open but with a fix version for a released version.

          People

          • Assignee:
            prasads
            Reporter:
            marina vatkina
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated: