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

Handling type arguments from outer classes for inner class in javadoc

    XMLWordPrintable

Details

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

    Backports

      Description

        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.

        Attachments

          Issue Links

            Activity

              People

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

                Dates

                  Created:
                  Updated:
                  Resolved: