From dbe3bc80f49e1d320d1794dead1c7bd8661adf05 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ji=C5=99=C3=AD=20Mikul=C3=A1=C5=A1ek?=
 <jiri.mikulasek@smarteon.cz>
Date: Sat, 1 Nov 2025 20:11:43 +0100
Subject: [PATCH] fix: correct javadoc warnings

---
 src/main/java/cz/smarteon/loxone/Loxone.java                  | 2 ++
 src/main/java/cz/smarteon/loxone/calendar/CalEntryBase.java   | 4 +++-
 .../java/cz/smarteon/loxone/calendar/CalendarCommand.java     | 1 +
 src/main/java/cz/smarteon/loxone/user/UserCommand.java        | 1 +
 4 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/main/java/cz/smarteon/loxone/Loxone.java b/src/main/java/cz/smarteon/loxone/Loxone.java
index 3f5a462..b398d88 100644
--- a/src/main/java/cz/smarteon/loxone/Loxone.java
+++ b/src/main/java/cz/smarteon/loxone/Loxone.java
@@ -282,7 +282,9 @@ private void sendCommand(final ControlCommand<?> controlCommand, final boolean s
 
     /**
      * Sends command built by {@link UserCommand} using http.
+     * @param <V> type of the value returned by the command
      * @param userCommand user command
+     * @return response message
      */
     public <V extends LoxoneValue> LoxoneMessage<V> sendUserCommandHttp(final @NotNull UserCommand<V> userCommand) {
         return loxoneHttp.get(userCommand, loxoneAuth);
diff --git a/src/main/java/cz/smarteon/loxone/calendar/CalEntryBase.java b/src/main/java/cz/smarteon/loxone/calendar/CalEntryBase.java
index 0788db7..4200dc0 100644
--- a/src/main/java/cz/smarteon/loxone/calendar/CalEntryBase.java
+++ b/src/main/java/cz/smarteon/loxone/calendar/CalEntryBase.java
@@ -60,7 +60,9 @@ public abstract class CalEntryBase {
      * 2 - One day
      * 3 - Period
      * 4 - Period every year
-     * 5 - A day in a week */
+     * 5 - A day in a week
+     * </pre>
+     */
     protected int calMode;
 
     @JsonCreator
diff --git a/src/main/java/cz/smarteon/loxone/calendar/CalendarCommand.java b/src/main/java/cz/smarteon/loxone/calendar/CalendarCommand.java
index 45444f5..a68b646 100644
--- a/src/main/java/cz/smarteon/loxone/calendar/CalendarCommand.java
+++ b/src/main/java/cz/smarteon/loxone/calendar/CalendarCommand.java
@@ -37,6 +37,7 @@ public static CalendarCommand<CalEntryListValue> getEntries() {
      * Command deletes a calendar entry with the corresponding lox UUID.
      *
      * @param entryUuid - Lox UUID of a calendar entry
+     * @return delete calendar entry command
      */
     @NotNull
     public static CalendarCommand<EmptyValue> deleteEntry(LoxoneUuid entryUuid) {
diff --git a/src/main/java/cz/smarteon/loxone/user/UserCommand.java b/src/main/java/cz/smarteon/loxone/user/UserCommand.java
index 4b9eac8..ea0d349 100644
--- a/src/main/java/cz/smarteon/loxone/user/UserCommand.java
+++ b/src/main/java/cz/smarteon/loxone/user/UserCommand.java
@@ -110,6 +110,7 @@ public static UserCommand<UserGroupListValue> getUserGroups() {
      *
      * @param user User object
      * @return add or edit user command
+     * @throws IOException in case user can't be serialized
      */
     @NotNull
     public static UserCommand<UserValue> addOrEditUser(final @NotNull User user) throws IOException {