From a4b8112616066ea6da5a76365f2157ed925922bd Mon Sep 17 00:00:00 2001
From: Konrad Malawski <ktoso@apple.com>
Date: Thu, 9 Apr 2026 13:35:45 +0900
Subject: [PATCH 1/3] Avoid self closing paragraphs, seems some linters don't
 like this

I'd actually want to move to /// style but that's JDK23+ so let's wait
with that for the time being
---
 Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator.swift   | 2 +-
 .../JNI/JNISwift2JavaGenerator+JavaBindingsPrinting.swift   | 2 +-
 .../main/java/org/swift/swiftkit/core/Preconditions.java    | 2 +-
 .../main/java/org/swift/swiftkit/core/SwiftInstance.java    | 6 +++---
 .../main/java/org/swift/swiftkit/core/SwiftLibraries.java   | 2 +-
 .../java/org/swift/swiftkit/core/annotations/Unsigned.java  | 4 ++--
 .../swift/swiftkit/core/collections/SwiftDictionaryMap.java | 6 +++---
 .../java/org/swift/swiftkit/core/collections/SwiftSet.java  | 6 +++---
 .../main/java/org/swift/swiftkit/ffm/FFMSwiftInstance.java  | 2 +-
 .../main/java/org/swift/swiftkit/ffm/SwiftValueLayout.java  | 2 +-
 .../java/org/swift/swiftkit/ffm/SwiftValueWitnessTable.java | 2 +-
 11 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator.swift b/Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator.swift
index 41c063048..297a39e6b 100644
--- a/Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator.swift
+++ b/Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator.swift
@@ -299,7 +299,7 @@ extension FFMSwift2JavaGenerator {
 
           /**
            * Assume that the passed {@code MemorySegment} represents a memory address of a {@link \(self.javaClassName(for: decl))}.
-           * <p/>
+           * <p>
            * Warnings:
            * <ul>
            *   <li>No checks are performed about the compatibility of the pointed at memory and the actual \(self.javaClassName(for: decl)) types.</li>
diff --git a/Sources/JExtractSwiftLib/JNI/JNISwift2JavaGenerator+JavaBindingsPrinting.swift b/Sources/JExtractSwiftLib/JNI/JNISwift2JavaGenerator+JavaBindingsPrinting.swift
index 05d4b5b9d..d645fe505 100644
--- a/Sources/JExtractSwiftLib/JNI/JNISwift2JavaGenerator+JavaBindingsPrinting.swift
+++ b/Sources/JExtractSwiftLib/JNI/JNISwift2JavaGenerator+JavaBindingsPrinting.swift
@@ -262,7 +262,7 @@ extension JNISwift2JavaGenerator {
         """
         /**
          * Assume that the passed {@code long} represents a memory address of a {@link \(javaName)}.
-         * <p/>
+         * <p>
          * Warnings:
          * <ul>
          *   <li>No checks are performed about the compatibility of the pointed at memory and the actual \(javaName) types.</li>
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/Preconditions.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/Preconditions.java
index bd1e52b07..cf324542c 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/Preconditions.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/Preconditions.java
@@ -32,7 +32,7 @@
 
 /**
  * Collection of convenience functions to check argument preconditions.
- * <p/>
+ * <p>
  * Partially based on {@code com.google.common.base.Preconditions}.
  */
 public final class Preconditions {
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
index 3ab07ffb4..a0084c3b7 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
@@ -28,14 +28,14 @@ public interface SwiftInstance {
 
     /**
      * Called when the arena has decided the value should be destroyed.
-     * <p/>
+     * <p>
      * <b>Warning:</b> The cleanup action must not capture {@code this}.
      */
     SwiftInstanceCleanup $createCleanup();
 
     /**
      * Exposes a boolean value which can be used to indicate if the object was destroyed.
-     * <p/>
+     * <p>
      * This is exposing the object, rather than performing the action because we don't want to accidentally
      * form a strong reference to the {@code SwiftInstance} which could prevent the cleanup from running,
      * if using an GC managed instance (e.g. using an {@code AutoSwiftMemorySession}.
@@ -43,7 +43,7 @@ public interface SwiftInstance {
     AtomicBoolean $statusDestroyedFlag();
     /**
      * Ensures that this instance has not been destroyed.
-     * <p/>
+     * <p>
      * If this object has been destroyed, calling this method will cause an {@link IllegalStateException}
      * to be thrown. This check should be performed before accessing {@code $memorySegment} to prevent
      * use-after-free errors.
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftLibraries.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftLibraries.java
index b20437e8c..e5c06a9e0 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftLibraries.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftLibraries.java
@@ -32,7 +32,7 @@ public final class SwiftLibraries {
 
     /** 
      * Allows for configuration if jextracted types should automatically attempt to load swiftCore and the library type is from.
-     * <p/>
+     * <p>
      * If all libraries you need to load are available in paths passed to {@code -Djava.library.path} this should work correctly,
      * however if attempting to load libraries from e.g. the jar as a resource, you may want to disable this.
      */
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/annotations/Unsigned.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/annotations/Unsigned.java
index 93906c51f..f7f49a7cf 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/annotations/Unsigned.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/annotations/Unsigned.java
@@ -26,13 +26,13 @@
 
 /**
  * Value is of an unsigned numeric type.
- * <p/>
+ * <p>
  * This annotation is used to annotate java integer primitives when their
  * corresponding Swift type was actually unsigned, e.g. an {@code @Unsigned long}
  * in a method signature corresponds to a Swift {@code UInt64} type, and therefore
  * negative values reported by the signed {@code long} should instead be interpreted positive values,
  * larger than {@code Long.MAX_VALUE} that are just not representable using a signed {@code long}.
- * <p/>
+ * <p>
  * If this annotation is used on a method, it refers to the return type using an unsigned integer.
  */
 @Documented
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftDictionaryMap.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftDictionaryMap.java
index 97bec9783..58489557d 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftDictionaryMap.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftDictionaryMap.java
@@ -22,9 +22,9 @@
 /**
  * A Java {@link java.util.Map} backed by a Swift Dictionary living in Swift's native heap memory.
  * This avoids un-necessary copying of the whole collection in case we're interested only in a few of its elements.
- * <p/>
+ * <p>
  * Methods on this type are implemented as JNI downcalls into the native Swift dictionary, unless specified otherwise.
- * <p/>
+ * <p>
  * You can use {@link #toJavaMap()} to obtain a copy of the data structure on the Java heap.
  *
  * @param <K> the key type, must be a value representable in Swift
@@ -106,7 +106,7 @@ public Set<Entry<K, V>> entrySet() {
      * Make a copy of the dictionary into a Java heap {@link java.util.Map}, 
      * which may be preferable if you are going to perform many operations on the map 
      * and don't expect the changes to be reflected in Swift.
-     * <p/>
+     * <p>
      * This operation DOES NOT perform a deep copy. I.e. if the dictionary contained reference types,
      * the new map will keep pointing at the same objects in the Swift heap.
      * 
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftSet.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftSet.java
index a793530e0..6779ba199 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftSet.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/collections/SwiftSet.java
@@ -22,9 +22,9 @@
 /**
  * A Java {@link java.util.Set} backed by a Swift Set living in Swift's native heap memory.
  * This avoids un-necessary copying of the whole collection in case we're interested only in a few of its elements.
- * <p/>
+ * <p>
  * Methods on this type are implemented as JNI downcalls into the native Swift set, unless specified otherwise.
- * <p/>
+ * <p>
  * You can use {@link #toJavaSet()} to obtain a copy of the data structure on the Java heap.
  *
  * @param <E> the element type, must be a value representable in Swift
@@ -108,7 +108,7 @@ public E next() {
      * Make a copy of the set into a Java heap {@link java.util.Set},
      * which may be preferable if you are going to perform many operations on the set
      * and don't expect the changes to be reflected in Swift.
-     * <p/>
+     * <p>
      * This operation DOES NOT perform a deep copy. I.e. if the set contained reference types,
      * the new set will keep pointing at the same objects in the Swift heap.
      *
diff --git a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/FFMSwiftInstance.java b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/FFMSwiftInstance.java
index 70324c942..c17c8ca19 100644
--- a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/FFMSwiftInstance.java
+++ b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/FFMSwiftInstance.java
@@ -59,7 +59,7 @@ protected FFMSwiftInstance(MemorySegment segment, AllocatingSwiftArena arena) {
 
     /**
      * Exposes a boolean value which can be used to indicate if the object was destroyed.
-     * <p/>
+     * <p>
      * This is exposing the object, rather than performing the action because we don't want to accidentally
      * form a strong reference to the {@code SwiftInstance} which could prevent the cleanup from running,
      * if using an GC managed instance (e.g. using an {@code AutoSwiftMemorySession}.
diff --git a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueLayout.java b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueLayout.java
index 0c09cca4d..83fdbee60 100644
--- a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueLayout.java
+++ b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueLayout.java
@@ -65,7 +65,7 @@ public static long addressByteSize() {
     /**
      * The value layout for Swift's {@code UInt} type, which is an unsigned type that follows
      * the size of a pointer (aka C's {@code size_t}).
-     * <p/>
+     * <p>
      * Java does not have unsigned integer types, so we use the layout for Swift's {@code Int}.
      */
     public static ValueLayout SWIFT_UINT = SWIFT_INT;
diff --git a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueWitnessTable.java b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueWitnessTable.java
index 2b918523d..bf03648f6 100644
--- a/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueWitnessTable.java
+++ b/SwiftKitFFM/src/main/java/org/swift/swiftkit/ffm/SwiftValueWitnessTable.java
@@ -266,7 +266,7 @@ static MethodHandle handle(SwiftAnyType ty) {
     /**
      * Given an invalid object of this type, initialize it as a copy of
      * the source object.
-     * <p/>
+     * <p>
      * Returns the dest object.
      */
     public static MemorySegment initializeWithCopy(SwiftAnyType type, MemorySegment dest, MemorySegment src) {

From f91af97c44d77b23eec86dfc33a4ec9d95d97c18 Mon Sep 17 00:00:00 2001
From: Konrad Malawski <ktoso@apple.com>
Date: Thu, 9 Apr 2026 13:43:22 +0900
Subject: [PATCH 2/3] fix some doclint warnings

---
 .../swift/swiftkit/core/SwiftInstance.java    |  6 ++---
 .../org/swift/swiftkit/core/tuple/Tuple1.java |  1 +
 .../swift/swiftkit/core/tuple/Tuple10.java    | 10 ++++++++
 .../swift/swiftkit/core/tuple/Tuple11.java    | 11 +++++++++
 .../swift/swiftkit/core/tuple/Tuple12.java    | 12 ++++++++++
 .../swift/swiftkit/core/tuple/Tuple13.java    | 13 ++++++++++
 .../swift/swiftkit/core/tuple/Tuple14.java    | 14 +++++++++++
 .../swift/swiftkit/core/tuple/Tuple15.java    | 15 ++++++++++++
 .../swift/swiftkit/core/tuple/Tuple16.java    | 16 +++++++++++++
 .../swift/swiftkit/core/tuple/Tuple17.java    | 17 +++++++++++++
 .../swift/swiftkit/core/tuple/Tuple18.java    | 18 ++++++++++++++
 .../swift/swiftkit/core/tuple/Tuple19.java    | 19 +++++++++++++++
 .../org/swift/swiftkit/core/tuple/Tuple2.java |  2 ++
 .../swift/swiftkit/core/tuple/Tuple20.java    | 20 ++++++++++++++++
 .../swift/swiftkit/core/tuple/Tuple21.java    | 21 ++++++++++++++++
 .../swift/swiftkit/core/tuple/Tuple22.java    | 22 +++++++++++++++++
 .../swift/swiftkit/core/tuple/Tuple23.java    | 23 ++++++++++++++++++
 .../swift/swiftkit/core/tuple/Tuple24.java    | 24 +++++++++++++++++++
 .../org/swift/swiftkit/core/tuple/Tuple3.java |  3 +++
 .../org/swift/swiftkit/core/tuple/Tuple4.java |  4 ++++
 .../org/swift/swiftkit/core/tuple/Tuple5.java |  5 ++++
 .../org/swift/swiftkit/core/tuple/Tuple6.java |  6 +++++
 .../org/swift/swiftkit/core/tuple/Tuple7.java |  7 ++++++
 .../org/swift/swiftkit/core/tuple/Tuple8.java |  8 +++++++
 .../org/swift/swiftkit/core/tuple/Tuple9.java |  9 +++++++
 25 files changed, 303 insertions(+), 3 deletions(-)

diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
index a0084c3b7..145af3769 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/SwiftInstance.java
@@ -20,9 +20,9 @@ public interface SwiftInstance {
     /**
      * Pointer to the {@code self} of the underlying Swift object or value.
      *
-     * @apiNote When using this pointer one must ensure that the underlying object
-     *          is kept alive using some means (e.g. a class remains retained), as
-     *          this function does not ensure safety of the address in any way.
+     * <b>API Note:</b> When using this pointer one must ensure that the underlying object
+     * is kept alive using some means (e.g. a class remains retained), as
+     * this function does not ensure safety of the address in any way.
      */
     long $memoryAddress();
 
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple1.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple1.java
index 6629c500b..db1baa8e4 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple1.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple1.java
@@ -17,6 +17,7 @@
 /**
  * Corresponds to Swift's built-in 1-element tuple type <code>(T0)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
  */
 public class Tuple1<T0> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple10.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple10.java
index 7adc90d94..f5f3ae588 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple10.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple10.java
@@ -17,6 +17,16 @@
 /**
  * Corresponds to Swift's built-in 10-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
  */
 public class Tuple10<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple11.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple11.java
index 5e6520a5d..6443f2ec0 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple11.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple11.java
@@ -17,6 +17,17 @@
 /**
  * Corresponds to Swift's built-in 11-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
  */
 public class Tuple11<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple12.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple12.java
index a916665e3..497771adc 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple12.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple12.java
@@ -17,6 +17,18 @@
 /**
  * Corresponds to Swift's built-in 12-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
  */
 public class Tuple12<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple13.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple13.java
index dc31991ea..5dc61d956 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple13.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple13.java
@@ -17,6 +17,19 @@
 /**
  * Corresponds to Swift's built-in 13-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
  */
 public class Tuple13<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple14.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple14.java
index dca55eb54..27027f4fb 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple14.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple14.java
@@ -17,6 +17,20 @@
 /**
  * Corresponds to Swift's built-in 14-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
  */
 public class Tuple14<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple15.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple15.java
index 9f8edd9a8..333041b74 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple15.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple15.java
@@ -17,6 +17,21 @@
 /**
  * Corresponds to Swift's built-in 15-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
  */
 public class Tuple15<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple16.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple16.java
index ba76df9e3..c5f0a41a0 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple16.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple16.java
@@ -17,6 +17,22 @@
 /**
  * Corresponds to Swift's built-in 16-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
  */
 public class Tuple16<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple17.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple17.java
index 557d26706..af25af2af 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple17.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple17.java
@@ -17,6 +17,23 @@
 /**
  * Corresponds to Swift's built-in 17-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
  */
 public class Tuple17<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple18.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple18.java
index 1324e0efa..619b5cd56 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple18.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple18.java
@@ -17,6 +17,24 @@
 /**
  * Corresponds to Swift's built-in 18-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
  */
 public class Tuple18<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple19.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple19.java
index c7651ed19..d2cab6368 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple19.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple19.java
@@ -17,6 +17,25 @@
 /**
  * Corresponds to Swift's built-in 19-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
  */
 public class Tuple19<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple2.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple2.java
index 9bb14bbbe..aa2fa5915 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple2.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple2.java
@@ -17,6 +17,8 @@
 /**
  * Corresponds to Swift's built-in 2-element tuple type <code>(T0, T1)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
  */
 public class Tuple2<T0, T1> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple20.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple20.java
index a65c7fb6e..8211b5570 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple20.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple20.java
@@ -17,6 +17,26 @@
 /**
  * Corresponds to Swift's built-in 20-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
+ * @param <T19> the type of element 19
  */
 public class Tuple20<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple21.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple21.java
index 061128d0b..bcdb09ad1 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple21.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple21.java
@@ -17,6 +17,27 @@
 /**
  * Corresponds to Swift's built-in 21-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
+ * @param <T19> the type of element 19
+ * @param <T20> the type of element 20
  */
 public class Tuple21<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple22.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple22.java
index 1e3a1bfd0..a7907dcab 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple22.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple22.java
@@ -17,6 +17,28 @@
 /**
  * Corresponds to Swift's built-in 22-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
+ * @param <T19> the type of element 19
+ * @param <T20> the type of element 20
+ * @param <T21> the type of element 21
  */
 public class Tuple22<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple23.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple23.java
index d0c981d06..a12e6a984 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple23.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple23.java
@@ -17,6 +17,29 @@
 /**
  * Corresponds to Swift's built-in 23-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
+ * @param <T19> the type of element 19
+ * @param <T20> the type of element 20
+ * @param <T21> the type of element 21
+ * @param <T22> the type of element 22
  */
 public class Tuple23<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple24.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple24.java
index 62923bef7..2587ba118 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple24.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple24.java
@@ -17,6 +17,30 @@
 /**
  * Corresponds to Swift's built-in 24-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
+ * @param <T9> the type of element 9
+ * @param <T10> the type of element 10
+ * @param <T11> the type of element 11
+ * @param <T12> the type of element 12
+ * @param <T13> the type of element 13
+ * @param <T14> the type of element 14
+ * @param <T15> the type of element 15
+ * @param <T16> the type of element 16
+ * @param <T17> the type of element 17
+ * @param <T18> the type of element 18
+ * @param <T19> the type of element 19
+ * @param <T20> the type of element 20
+ * @param <T21> the type of element 21
+ * @param <T22> the type of element 22
+ * @param <T23> the type of element 23
  */
 public class Tuple24<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple3.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple3.java
index 0717c65c8..2e231a181 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple3.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple3.java
@@ -17,6 +17,9 @@
 /**
  * Corresponds to Swift's built-in 3-element tuple type <code>(T0, T1, T2)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
  */
 public class Tuple3<T0, T1, T2> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple4.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple4.java
index 781bc3561..d356b10c2 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple4.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple4.java
@@ -17,6 +17,10 @@
 /**
  * Corresponds to Swift's built-in 4-element tuple type <code>(T0, T1, T2, T3)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
  */
 public class Tuple4<T0, T1, T2, T3> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple5.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple5.java
index 173b9ba72..a5b60dc91 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple5.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple5.java
@@ -17,6 +17,11 @@
 /**
  * Corresponds to Swift's built-in 5-element tuple type <code>(T0, T1, T2, T3, T4)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
  */
 public class Tuple5<T0, T1, T2, T3, T4> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple6.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple6.java
index ebe44ecd0..fcda78e2c 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple6.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple6.java
@@ -17,6 +17,12 @@
 /**
  * Corresponds to Swift's built-in 6-element tuple type <code>(T0, T1, T2, T3, T4, T5)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
  */
 public class Tuple6<T0, T1, T2, T3, T4, T5> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple7.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple7.java
index d40fc1799..67151b76f 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple7.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple7.java
@@ -17,6 +17,13 @@
 /**
  * Corresponds to Swift's built-in 7-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
  */
 public class Tuple7<T0, T1, T2, T3, T4, T5, T6> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple8.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple8.java
index 10261c8ca..088cfb763 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple8.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple8.java
@@ -17,6 +17,14 @@
 /**
  * Corresponds to Swift's built-in 8-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
  */
 public class Tuple8<T0, T1, T2, T3, T4, T5, T6, T7> {
     public final T0 $0;
diff --git a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple9.java b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple9.java
index d4ba4c253..507bea8e7 100644
--- a/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple9.java
+++ b/SwiftKitCore/src/main/java/org/swift/swiftkit/core/tuple/Tuple9.java
@@ -17,6 +17,15 @@
 /**
  * Corresponds to Swift's built-in 9-element tuple type <code>(T0, T1, T2, T3, T4, T5, T6, T7, T8)</code>.
  * Elements are accessed via public final fields <code>$0</code>, <code>$1</code>, etc.
+ * @param <T0> the type of element 0
+ * @param <T1> the type of element 1
+ * @param <T2> the type of element 2
+ * @param <T3> the type of element 3
+ * @param <T4> the type of element 4
+ * @param <T5> the type of element 5
+ * @param <T6> the type of element 6
+ * @param <T7> the type of element 7
+ * @param <T8> the type of element 8
  */
 public class Tuple9<T0, T1, T2, T3, T4, T5, T6, T7, T8> {
     public final T0 $0;

From b320ce5da30306faa2dfeaece28e59fdd5463d65 Mon Sep 17 00:00:00 2001
From: Konrad Malawski <ktoso@apple.com>
Date: Thu, 9 Apr 2026 13:44:41 +0900
Subject: [PATCH 3/3] doclint ignore 'nocomment'

---
 .../kotlin/build-logic.java-common-conventions.gradle.kts    | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/BuildLogic/src/main/kotlin/build-logic.java-common-conventions.gradle.kts b/BuildLogic/src/main/kotlin/build-logic.java-common-conventions.gradle.kts
index 556ec7fb7..199a3b633 100644
--- a/BuildLogic/src/main/kotlin/build-logic.java-common-conventions.gradle.kts
+++ b/BuildLogic/src/main/kotlin/build-logic.java-common-conventions.gradle.kts
@@ -101,3 +101,8 @@ tasks.withType<Test> {
         this.showStandardStreams = true
     }
 }
+
+// Validate javadoc for html/syntax/reference correctness but skip "missing" (no comment) warnings
+tasks.withType<Javadoc> {
+    (options as StandardJavadocDocletOptions).addStringOption("Xdoclint:all,-missing", "-quiet")
+}