From 6e1c1f2a1f265c0aa6038d048b3ed54df1cba8e1 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Fri, 4 Oct 2024 15:26:36 +0100
Subject: [PATCH 1/3] Show nested classes and interfaces in the package summary

---
 .../com/saxonica/xmldoclet/scanners/XmlPackage.java  | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/xmldoclet/src/main/java/com/saxonica/xmldoclet/scanners/XmlPackage.java b/xmldoclet/src/main/java/com/saxonica/xmldoclet/scanners/XmlPackage.java
index e15e196..9e6e913 100644
--- a/xmldoclet/src/main/java/com/saxonica/xmldoclet/scanners/XmlPackage.java
+++ b/xmldoclet/src/main/java/com/saxonica/xmldoclet/scanners/XmlPackage.java
@@ -31,6 +31,11 @@ public void scan(DocTree tree) {
             builder.processList("description", dcTree.getBody());
         }
 
+        recursiveRefs(element);
+        builder.endElement("package");
+    }
+
+    public void recursiveRefs(Element element) {
         for (Element child : element.getEnclosedElements()) {
             switch (child.getKind()) {
                 case CLASS:
@@ -45,12 +50,15 @@ public void scan(DocTree tree) {
                 case ANNOTATION_TYPE:
                     TypeUtils.xmlType(builder, "annotationtyperef", child.asType());
                     break;
+                case FIELD:
+                case METHOD:
+                case CONSTRUCTOR:
+                    break;
                 default:
                     System.err.println("Unexpected element in package: " + child);
                     break;
             }
+            recursiveRefs(child);
         }
-
-        builder.endElement("package");
     }
 }

From 71703e901b0bf0e19fd3ee70822a9ba60190e6e0 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Fri, 4 Oct 2024 15:26:53 +0100
Subject: [PATCH 2/3] Fix some Javadoc comments

---
 .../src/main/java/com/saxonica/xmldoclet/utils/TypeUtils.java  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/xmldoclet/src/main/java/com/saxonica/xmldoclet/utils/TypeUtils.java b/xmldoclet/src/main/java/com/saxonica/xmldoclet/utils/TypeUtils.java
index 6ff8443..0f1dbee 100644
--- a/xmldoclet/src/main/java/com/saxonica/xmldoclet/utils/TypeUtils.java
+++ b/xmldoclet/src/main/java/com/saxonica/xmldoclet/utils/TypeUtils.java
@@ -79,6 +79,7 @@ private static void declaredType(XmlProcessor builder, String wrapper, DeclaredT
     /**
      * Find the element's package.
      * <p>For nested classes, we may have to look up several times.</p>
+     * @param element The starting element
      * @return the package name
      */
     public static String getPackage(Element element) {
@@ -97,7 +98,7 @@ public static String getPackage(Element element) {
 
     /**
      * Find the name of this type; that's our ancestor names if this is a nested class.
-     * @param element The element
+     * @param element The starting Welement
      * @return The type name
      */
     public static String getType(Element element) {

From 62cf0d8e45d32b827f550c377e23169c0d7bb667 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Fri, 4 Oct 2024 15:27:06 +0100
Subject: [PATCH 3/3] Update README and bump version

---
 README.md         | 5 +++++
 gradle.properties | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b460e8c..794adb7 100644
--- a/README.md
+++ b/README.md
@@ -120,6 +120,11 @@ incomplete or incorrect, please [open an issue](https://github.com/Saxonica/xmld
 
 ## Change log
 
+* **0.15.0** Show nested classes and interfaces
+
+    As a convenience, the list of `classref` and `interfaceref` elements in a package
+    now includes nested classes and interfaces.
+
 * **0.14.0** Fixed package name
 
     The package name was sometimes (e.g., in the superclass type)
diff --git a/gradle.properties b/gradle.properties
index ee9c050..d657db1 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -1,4 +1,4 @@
-docletVersion=0.14.0
+docletVersion=0.15.0
 schemaVersion=0.13.0
 docletTitle=XmlDoclet
 docletName=xmldoclet