Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4158957

Doc comments: Run checklinks and fix all broken links for 1.4.0

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.2.0
    • tools
    • beta3
    • sparc
    • solaris_2.5
    • Verified

      Run Dr. Html on the javadoc output and see if javadoc has generated
      any broken links.

      Well, I ran mom-spider, since Dr. HTML was broken, and the results are at:

      http://javaweb.eng/docs/bin/links/results/dkramer-checklinksdir.html

      NOTE: NEED TO DO THE SAME THING FOR 1.1 DOCS

      The broken links are due to many things:

       - swing.plaf.basic package is missing
         Javadoc bug where it was generating links to this
         non-existent package (since fixed)

       - Images were moved to a new directory and never
         put into the proper image directory
         (java/awt/images-awt/GridLayout-1.gif)

       - Images never put into the proper image directory:
         (/com/sun/java/accessibility/top-hat.gif)

       - @see hard-coding in org.omg.*
         (jidlExceptions.html need to go up higher: ../../../guide/)

         Bug 4134304 overlooked these packages. Only handled java.*
         and com.sun.java.*

       - External absolute links that have moved
         (ftp://ds.internic.net/rfc)

       - Hard-coded links instead of using @link
         (<a href="../../../../java.io.InputStream">mark</a>
          in CertificateFactory)


      NOTE: If you run checklinks without the "guide" directory
      set up as follows, you will get broken links because the
      guide directory is missing:

             docs
              |
           --------
           | |
          guide api

        For example, SecureRandom.html links into guide/CryptoSpec.html

            dkramersunw Douglas Kramer (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: