From 59d4deb7894569cb944c31ea02b0ed7136477ba0 Mon Sep 17 00:00:00 2001
From: Aina Niemetz <aina.niemetz@gmail.com>
Date: Mon, 4 Apr 2022 18:53:35 -0700
Subject: [PATCH] api: Fix OptionInfo docs for java API. (#8569)

---
 src/api/java/io/github/cvc5/OptionInfo.java | 39 ++++++++++++++-------
 1 file changed, 27 insertions(+), 12 deletions(-)

diff --git a/src/api/java/io/github/cvc5/OptionInfo.java b/src/api/java/io/github/cvc5/OptionInfo.java
index bd8edc8b0..974d0bcca 100644
--- a/src/api/java/io/github/cvc5/OptionInfo.java
+++ b/src/api/java/io/github/cvc5/OptionInfo.java
@@ -20,19 +20,34 @@ import java.math.BigInteger;
 /**
  * Holds some description about a particular option, including its name, its
  * aliases, whether the option was explicitly set by the user, and information
- * concerning its value. The `valueInfo` member holds any of the following
+ * concerning its value. The {@code valueInfo} member holds any of the following
  * alternatives:
- * - VoidInfo if the option holds no value (or the value has no native type)
- * - ValueInfo if the option is of type boolean or String, holds the
- *   current value and the default value.
- * - NumberInfo if the option is of type BigInteger or double, holds
- *   the current and default value, as well as the minimum and maximum.
- * - ModeInfo if the option is a mode option, holds the current and default
- *   values, as well as a list of valid modes.
+ * <ul>
+ *   <li>
+ *     {@link OptionInfo.VoidInfo} if the option holds no value (or the value
+ *     has no native type)
+ *   </li>
+ *   <li>
+ *     {@link OptionInfo.ValueInfo} if the option is of type boolean or String,
+ *     holds the current value and the default value.
+ *   </li>
+ *   <li>
+ *     {@link OptionInfo.NumberInfo} if the option is of type BigInteger or
+ *     double, holds the current and default value, as well as the minimum and
+ *     maximum.
+ *   </li>
+ *   <li>
+ *     {@link OptionInfo.ModeInfo} if the option is a mode option, holds the
+ *     current and default values, as well as a list of valid modes.
+ *   </li>
+ * </ul>
+ *
  * Additionally, this class provides convenience functions to obtain the
- * current value of an option in a type-safe manner using boolValue(),
- * stringValue(), intValue(), and doubleValue(). They assert that
- * the option has the respective type and return the current value.
+ * current value of an option in a type-safe manner using
+ * {@link OptionInfo#booleanValue()}, {@link OptionInfo#stringValue()},
+ * {@link OptionInfo#intValue()}, and {@link OptionInfo#doubleValue()}.
+ * They assert that the option has the respective type and return the current
+ * value.
  */
 public class OptionInfo extends AbstractPointer
 {
@@ -59,7 +74,7 @@ public class OptionInfo extends AbstractPointer
   }
 
   /**
-   * @return a string representation of this optionInfo.
+   * @return a String representation of this optionInfo.
    */
   protected native String toString(long pointer);
 
-- 
2.30.2