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

javadoc tool: @see should be condition on access

    XMLWordPrintable

Details

    • Enhancement
    • Status: Closed
    • P4
    • Resolution: Won't Fix
    • 1.2.0, 1.3.0
    • None
    • tools
    • x86, sparc
    • solaris_2.5.1, windows_nt

    Description

      Consider the following file:

      /** @see #foo
      */
      public class t {
          /** foo */
          private void foo() { }
      }

      If I run javadoc -private, then javadoc is happy. If I run javadoc normally,
      javadoc complains about not being able to find foo(). This makes it harder to
      use javadoc for documenting the code to people who need the -private stuff. I
      should only be warned if foo does not exist at all. If it does exist, but is
      inaccesible at my current javadoc level (-private, -package, etc.) the @see
      should just be silently ignored.

      Attachments

        Issue Links

          Activity

            People

              Unassigned Unassigned
              karnoldsunw Kenneth Arnold (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: