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

Handling type arguments from outer classes for inner class in javadoc

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 16
    • Fix Version/s: 17
    • Component/s: tools
    • Labels:
      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

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

                  Dates

                  Created:
                  Updated:
                  Resolved: