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

javadoc behavior does not match javadoc docs

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 8
    • 7
    • docs
    • None
    • generic
    • generic

      From: http://download.oracle.com/javase/7/docs/technotes/tools/solaris/javadoc.html#javadoctags (same for windows):

           If any method or constructor is entered as a name with no
           parentheses, such as getValue, and if there is no field with the
           same name, the Javadoc tool will correctly create a link to it, but
           will print a warning message reminding you to add the parentheses
           and arguments.

      I didn't get such a warning message. Either the doc needs updating, or the javadoc isn't throwing the warning. Filing in tools first, may need to transfer to tooldocs.

      /**
       * This is Bar class.
       */
      public class Bar {

          /**
           * Hello world.
           *
           * @see Foo#hello
           */
          public static void hello() {
          }
      }

      /**
       * This is Foo class.
       */
      public class Foo {

          /**
           * Hello world.
           */
          public static void hello() {
          }
      }

            azhebel Alexey Zhebel (Inactive)
            wetmore Bradford Wetmore
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: