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

Handling type arguments from outer classes for inner class in javadoc

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 17
    • 16
    • tools
    • None

        From javadoc-dev

        Hello,
        When I was creating tests for JDK-8259216 (namely this example), I encountered another problem, where instance inner class parameterized types (generics) in javadoc omit outer classes' generic information.

        An example:
        Tree.java
        public class Tree<T> {
            public class Node {
                T data;
                Node left;
                Node right;
                // etc..
            }
            Node root;
            // etc..
        }

        User.java
        public class User {
            public void take(Tree<Integer>.Node now, Tree<String>.Node other) {}
            public void take(Tree<Integer> now, Tree<String> other) {}
        }

        Observe the javadoc method summaries (same for details) are
        void take(Tree.Node now, Tree.Node other)
        void take(Tree<java.lang.Integer> now, Tree<java.lang.String> other)
        while it's the most reasonable from the test code above that both should include the generic information.

              hannesw Hannes Wallnoefer
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

                Created:
                Updated:
                Resolved: