From 82889b8c061ae6debb21d46506feba1d1ef09482 Mon Sep 17 00:00:00 2001 From: Martin Prokoph Date: Mon, 21 Apr 2025 10:43:40 +0200 Subject: [PATCH] docs: improve JavaDocs --- .../eu/midnightdust/lib/config/MidnightConfig.java | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/common/src/main/java/eu/midnightdust/lib/config/MidnightConfig.java b/common/src/main/java/eu/midnightdust/lib/config/MidnightConfig.java index 588b1dd..355e2b8 100755 --- a/common/src/main/java/eu/midnightdust/lib/config/MidnightConfig.java +++ b/common/src/main/java/eu/midnightdust/lib/config/MidnightConfig.java @@ -530,7 +530,7 @@ public abstract class MidnightConfig { * - width: The maximum character length of the {@link String}, {@link Identifier} or String/Identifier {@link List<>} field
* - min: The minimum value of the int, float or double field
* - max: The maximum value of the int, float or double field
- * - name: The name of the field in the config screen
+ * - name: Will be used instead of the default translation key, if not empty
* - selectionMode: The selection mode of the file picker button for {@link String} fields, * -1 for none, {@link JFileChooser#FILES_ONLY} for files, {@link JFileChooser#DIRECTORIES_ONLY} for directories, * {@link JFileChooser#FILES_AND_DIRECTORIES} for both (default: -1). Remember to set the translation key @@ -580,11 +580,10 @@ public abstract class MidnightConfig { /** * Comment Annotation
- * - {@link Comment#centered()}: If the comment should be centered (default: false)
- * - {@link Comment#category()}: The category of the comment in the config screen (default - * "default")
- * - {@link Comment#name()}: The name of the comment in the config screen (default: "")
- * - {@link Comment#url()}: The url of the comment in the config screen, empty or blank means no url (default: "")
+ * - {@link Comment#centered()}: If the comment should be centered
+ * - {@link Comment#category()}: The category of the comment in the config screen
+ * - {@link Comment#name()}: Will be used instead of the default translation key, if not empty
+ * - {@link Comment#url()}: The url of the comment should link to in the config screen (none if left empty)
* */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface Comment { boolean centered() default false;