Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-9140

Job page no longer has the Javadoc page

    XMLWordPrintable

Details

    • Bug
    • Status: Resolved (View Workflow)
    • Major
    • Resolution: Fixed
    • maven-plugin
    • None

    Description

      We have about 20 Maven 2 builds running under Jenkins 1.401 and Jenkins is archiving target/*/ .
      Previously, our Maven builds created a default site, and the Jenkins project pages contained links to the Maven
      site and to the Javadoc.

      Recently, I updated Jenkins from 1.399 to 1.401, and also updated our Maven parent POM to include the testapidocs
      in the Maven site (see below) and now our Jenkins job page no longer links directly to the Javadoc. The project lists
      these links:

      • Maven-generated site
      • Coverage Report
      • Workspace
      • Last Successful Artifacts
      • Recent Changes
      • Latest Test Result(no failures)

      It does correctly link to the Maven site, which has both the Javadocs and Test Javadocs reports,
      and the Javadoc content is there in the archive.

      Also, I had a disabled project which was last built before these changes; it has the Javadoc link in the job page.
      When I enabled it and rebuilt it, the Javadoc link was not there.

      How do I restore the Javadoc link in the Jenkins job details page?

      How do I include the Test Javadoc link in the Jenkins job details? (http://issues.jenkins-ci.org/browse/JENKINS-1000 ?)
      I don't see any configuration for Javadoc links in the job configuration.

      Details:

      Maven site "Project Reports" contains:

      • Cobertura Test Coverage Cobertura Test Coverage Report.
      • FindBugs Report Generates a source code report with the FindBugs Library.
      • JavaDocs JavaDoc API documentation.
      • Surefire Report Report on the test results of the project.
      • Test JavaDocs Test JavaDoc API documentation.

      Here is an excerpt from the parent pom:

      <reporting> 
              <plugins> 
                  <plugin> 
                      <groupId>org.apache.maven.plugins</groupId> 
                      <artifactId>maven-javadoc-plugin</artifactId> 
                      <version>2.7</version> 
                      <configuration> 
                          <outputDirectory>${project.build.directory}/apidocs</outputDirectory> 
                          <overview>overview.html</overview> 
                          <javadocDirectory>Source/Javadoc</javadocDirectory> 
                          <excludedocfilessubdir>CVS</excludedocfilessubdir> 
                          <docfilessubdirs>true</docfilessubdirs> 
                          <source>1.6</source> 
                      </configuration> 
                      <reportSets> 
                          <reportSet> 
                              <id>html</id> 
                              <configuration> 
                                  <doctitle>API for ${project.name} ${project.version}</doctitle> 
                                  <windowtitle>API for ${project.name} ${project.version}</windowtitle> 
                              </configuration> 
                              <reports> 
                                  <report>javadoc</report> 
                              </reports> 
                          </reportSet> 
                          <reportSet> 
                              <id>test-html</id> 
                              <configuration> 
                                  <testDoctitle>Testware API for ${project.name} ${project.version}</testDoctitle> 
                                  <testWindowtitle>Testware API for ${project.name} ${project.version}</testWindowtitle> 
                              </configuration> 
                              <reports> 
                                  <report>test-javadoc</report> 
                              </reports> 
                          </reportSet> 
                      </reportSets> 
                  </plugin>
        ...
      

      Attachments

        Activity

          jieryn jieryn added a comment -

          I confirm this behavior. I have to drill down to the individual Maven Module before a Javadoc link will be presented on the left panel. ... It is quite useful to have Jenkins automatically aggregate all javadocs for me.....

          jieryn jieryn added a comment - I confirm this behavior. I have to drill down to the individual Maven Module before a Javadoc link will be presented on the left panel. ... It is quite useful to have Jenkins automatically aggregate all javadocs for me.....
          olamy Olivier Lamy added a comment -

          are you using javadoc:aggregate ??

          olamy Olivier Lamy added a comment - are you using javadoc:aggregate ??
          jieryn jieryn added a comment -

          Wow, that fixed it. I don't believe this solves the original issue though, but I'm going to unsubscribe from this defect.

          Nice once, Olivier!

          jieryn jieryn added a comment - Wow, that fixed it. I don't believe this solves the original issue though, but I'm going to unsubscribe from this defect. Nice once, Olivier!
          olamy Olivier Lamy added a comment -

          see JENKINS-9202
          I think we can close it ?

          olamy Olivier Lamy added a comment - see JENKINS-9202 I think we can close it ?
          davidbiesack David Biesack added a comment -

          I think this can be closed.

          davidbiesack David Biesack added a comment - I think this can be closed.

          People

            olamy Olivier Lamy
            davidbiesack David Biesack
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: