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

stddoclet: should use "nested classes" rather than "inner classes"

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.2.0
    • tools
    • beta
    • sparc
    • solaris_2.6

      Gilad writes, from JLS 2nd edition draft:

      - A nested class is any class whose declaration occurs within the body of
        another class or interface.
      - A top-level class is class that is not a nested class.
      - An inner class is a nested class that is not declared (implicitly or
        explicitly) static.

      "Nested class" is the more general term, as it applies to both
      static and non-static classes. Therefore, wherever javadoc uses "inner class", it should be replaced by "nested class"

      For example, "Inner Class Summary" should become "Nested Class Summary"
      since it can contain both static and non-static classes:

      http://java.sun.com/products/jdk/1.2/docs/api/javax/swing/Box.html

      See suggested fix for particular places this change needs to be made.

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

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: