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

javadoc tool: Full qualification in @see required in package.html

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Won't Fix
    • Icon: P4 P4
    • None
    • 1.2.2, 1.4.2
    • tools
    • generic, x86
    • generic, windows_xp



      Name: mc57594 Date: 11/15/99


      related to : 4232157 Have javadoc use import statements to find related classes in other pkgs
      [chamness]
      ---------------------------------------------------
      JavaDoc apparently requires class names to be fully qualified
      in the package.html file for a package, inconsistently with how
      it works for class source files.

      For example, in file package.html in the source directory for
      package a.b.c, the reference
         {@link X#m()}
      does not link to the documentation for class a.b.c.X. The
      reference
         {@link a.b.c.X#m()}
      is apparently required.

      This is inconsistent with how JavaDoc works in a source file
      for a class. For example, in any class source file in
      package a.b.c, the reference
         {@link X#m()}
      _is_ sufficient to link to the documentation for class a.b.c.X.


      DSB/DFI
      (Review ID: 97002)
      ======================================================================

            Unassigned Unassigned
            mchamnessunw Mark Chamness (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: