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

stddoclet: Should know where home is -- docs should link to java.sun.com

    XMLWordPrintable

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P4
    • Resolution: Won't Fix
    • Affects Version/s: 1.4.0
    • Fix Version/s: None
    • Component/s: tools

      Description



      Name: nt126004 Date: 04/19/2002


      FULL PRODUCT VERSION :
      java version "1.3.1_02"
      Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1_02-b02)
      Java HotSpot(TM) Client VM (build 1.3.1_02-b02, mixed mode)

      FULL OPERATING SYSTEM VERSION : All

      A DESCRIPTION OF THE PROBLEM :
      javadoc should know where "home" is. It should be
      implicitly aware of where the javadoc and package-list
      for standard packages provided with the JSDK distribution
      come from and have a "-link" directive pointing there. For
      example, the javadoc that comes with the JDK 1.3.1_02
      should implicitly do this:

      -link http://java.sun.com/j2se/1.3/docs/api

      Of course, this link should come last in the list. javadoc
      should first check user supplied -link and -linkoffline
      directives, and then lastly look at its own internal link.

      And finally, this feature should be on by default, and a
      flag to disable it should be able to be specified on the
      command-line (like -nohome).


      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      Run javadoc without -link
      http://java.sun.com/j2se/1.3/docs/api

      This bug can be reproduced always.

      CUSTOMER WORKAROUND :
      Add "-link http://java.sun.com/j2se/1.3/docs/api" to your
      javadoc line. Also, whenever you upgrade JDK versions,
      remember to update this as well.
      (Review ID: 145076)
      ======================================================================

        Attachments

          Activity

            People

            Assignee:
            bpatel Bhavesh Patel (Inactive)
            Reporter:
            nthompsosunw Nathanael Thompson (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: