From d10e95df884b0e8d7a0216ff1ad6ca6352a8d40b Mon Sep 17 00:00:00 2001
From: Ladislav Thon <lthon@redhat.com>
Date: Wed, 24 Jan 2024 14:09:32 +0100
Subject: [PATCH] improve javadoc of VoidType and MethodInfo

---
 core/src/main/java/org/jboss/jandex/MethodInfo.java | 5 ++---
 core/src/main/java/org/jboss/jandex/VoidType.java   | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/core/src/main/java/org/jboss/jandex/MethodInfo.java b/core/src/main/java/org/jboss/jandex/MethodInfo.java
index 001394a0..c0fcf4be 100644
--- a/core/src/main/java/org/jboss/jandex/MethodInfo.java
+++ b/core/src/main/java/org/jboss/jandex/MethodInfo.java
@@ -35,9 +35,8 @@
  * However, {@link #descriptorParameterTypes()} and {@link #descriptorParametersCount()}
  * may be used to obtain information about all parameters, including mandated and synthetic.
  * <p>
- * As an exception to the rule above, in case of well known methods where no parameter
- * is declared explicitly, the implicitly declared parameters are included. This currently
- * applies to the implicitly declared parameters of:
+ * As an exception to the rule above, implicitly declared parameters are always included
+ * in case of methods that don't have an explicit parameter list. These are:
  * <ul>
  * <li>the implicitly declared {@code valueOf()} method in enums;</li>
  * <li>the compact constructor in records.</li>
diff --git a/core/src/main/java/org/jboss/jandex/VoidType.java b/core/src/main/java/org/jboss/jandex/VoidType.java
index 237c88ab..982ea9cd 100644
--- a/core/src/main/java/org/jboss/jandex/VoidType.java
+++ b/core/src/main/java/org/jboss/jandex/VoidType.java
@@ -19,7 +19,7 @@
 package org.jboss.jandex;
 
 /**
- * Specifies "void" in a method signature.
+ * Represents the {@code void} pseudo-type, which may appear in a method signature.
  *
  * @since 2.0
  * @author Jason T. Greene