generate kdocs

src/jvmMain/kotlin/ActualLogger.kt

@@ -4,11 +4,33 @@ import dev.inmo.kslog.common.filter.filtered
 import java.util.logging.Level
 import java.util.logging.Logger
 
+/**
+ * Default Java Logger instance used by KSLog on JVM platform
+ *
+ * Initialized lazily with the name "KSLog"
+ */
 internal val defaultKSLogLogger by lazy {
     Logger.getLogger("KSLog")
 }
+
+/**
+ * Extension function to log with KSLog levels using Java Logger
+ *
+ * Maps KSLog [LogLevel] to Java [Level]:
+ * - [LogLevel.TRACE] → [Level.FINEST]
+ * - [LogLevel.DEBUG] → [Level.FINER]
+ * - [LogLevel.VERBOSE] → [Level.FINE]
+ * - [LogLevel.INFO] → [Level.INFO]
+ * - [LogLevel.WARNING] → [Level.WARNING]
+ * - [LogLevel.ERROR] → [Level.SEVERE]
+ * - [LogLevel.ASSERT] → [Level.SEVERE]
+ *
+ * @param l KSLog log level
+ * @param m Message string
+ * @param e Optional throwable
+ */
 internal fun Logger.doLog(
-    l: LogLevel, t: String, m: String, e: Throwable?
+    l: LogLevel, m: String, e: Throwable?
 ) = log(
     when(l) {
         LogLevel.TRACE -> Level.FINEST
@@ -32,18 +54,35 @@ fun KSLog(
 ) = KSLog { l, t, m, e ->
     if (!filter(l, t, e)) return@KSLog
     val text = messageFormatter(l,t ?: defaultTag,m.toString(),e)
-    logger.doLog(l, t ?: defaultTag, text, e)
+    logger.doLog(l, text, e)
 }
 
+/**
+ * Creates a KSLog that uses a specific Java [Logger] instance
+ * 
+ * @param defaultTag Default tag to use when tag is not specified
+ * @param logger The Java Logger instance to use for logging
+ * @param messageFormatter Formatter for log messages (defaults to [defaultMessageFormatter])
+ * @return A new [CallbackKSLog] instance wrapping the Java logger
+ */
 fun KSLog(
     defaultTag: String,
     logger: Logger,
     messageFormatter: MessageFormatter = defaultMessageFormatter
 ) = KSLog { l, t, m, e ->
     val text = messageFormatter(l,t ?: defaultTag,m.toString(),e)
-    logger.doLog(l, t ?: defaultTag, text, e)
+    logger.doLog(l, text, e)
 }
 
+/**
+ * Creates a filtered KSLog using a Java [Logger] that only logs specific levels
+ * 
+ * @param defaultTag Default tag to use when tag is not specified
+ * @param logger The Java Logger instance to use for logging
+ * @param levels Collection of log levels to include
+ * @param messageFormatter Formatter for log messages (defaults to [defaultMessageFormatter])
+ * @return A new filtered [KSLog] instance
+ */
 fun KSLog(
     defaultTag: String,
     logger: Logger,
@@ -54,6 +93,17 @@ fun KSLog(
     return KSLog (defaultTag, logger, messageFormatter).filtered { l, _, _ -> l in levelsSet }
 }
 
+/**
+ * Creates a filtered KSLog using a Java [Logger] with specific log levels
+ * 
+ * @param defaultTag Default tag to use when tag is not specified
+ * @param logger The Java Logger instance to use for logging
+ * @param firstLevel First log level to include
+ * @param secondLevel Second log level to include
+ * @param otherLevels Additional log levels to include
+ * @param messageFormatter Formatter for log messages (defaults to [defaultMessageFormatter])
+ * @return A new filtered [KSLog] instance
+ */
 fun KSLog(
     defaultTag: String,
     logger: Logger,
@@ -63,6 +113,17 @@ fun KSLog(
     messageFormatter: MessageFormatter = defaultMessageFormatter,
 ): KSLog = KSLog (defaultTag, logger, setOf(firstLevel, secondLevel, *otherLevels), messageFormatter)
 
+/**
+ * Creates a filtered KSLog using a Java [Logger] with a minimum log level
+ * 
+ * Only logs messages at or above the specified minimum level.
+ * 
+ * @param defaultTag Default tag to use when tag is not specified
+ * @param logger The Java Logger instance to use for logging
+ * @param minLoggingLevel Minimum log level to include (defaults to TRACE - the first level)
+ * @param messageFormatter Formatter for log messages (defaults to [defaultMessageFormatter])
+ * @return A new filtered [KSLog] instance
+ */
 fun KSLog(
     defaultTag: String,
     logger: Logger,