fix: documenting configuration properties uses correct syntax

Author: afranken

server/src/main/kotlin/com/adobe/testing/s3mock/S3MockProperties.kt

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2017-2025 Adobe.
+ *  Copyright 2017-2026 Adobe.
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -20,8 +20,10 @@ import org.springframework.boot.context.properties.ConfigurationProperties
 @ConfigurationProperties("com.adobe.testing.s3mock")
 @JvmRecord
 data class S3MockProperties(
-  // Property name for passing the HTTPS port to use. Defaults to
-  // {@value S3MockApplication#DEFAULT_HTTPS_PORT}. If set to
-  // {@value S3MockApplication#RANDOM_PORT}, a random port will be chosen.
+  /**
+   * Property name for passing the HTTPS port to use. Defaults to
+   * {@value S3MockApplication#DEFAULT_HTTPS_PORT}. If set to
+   * {@value S3MockApplication#RANDOM_PORT}, a random port will be chosen.
+   */
   val httpPort: Int
 )

server/src/main/kotlin/com/adobe/testing/s3mock/controller/ControllerProperties.kt

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2017-2025 Adobe.
+ *  Copyright 2017-2026 Adobe.
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -20,9 +20,11 @@ import org.springframework.boot.context.properties.bind.DefaultValue
 
 @ConfigurationProperties("com.adobe.testing.s3mock.controller")
 @JvmRecord
-data class ControllerProperties( // Property name for passing the global context path to use.
-  // Defaults to "".
-  // For example if set to `s3-mock` all endpoints will be available at
-  // `http://host:port/s3-mock` instead of `http://host:port/`
+data class ControllerProperties(
+  /**
+   * Property name for passing the global context path to use.
+   * Defaults to "".
+   * For example if set to `s3-mock` all endpoints will be available at `http://host:port/s3-mock` instead of `http://host:port/`
+   */
   @param:DefaultValue("") val contextPath: String
 )

server/src/main/kotlin/com/adobe/testing/s3mock/store/StoreProperties.kt

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2017-2025 Adobe.
+ *  Copyright 2017-2026 Adobe.
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -23,15 +23,26 @@ import software.amazon.awssdk.regions.Region
 @JvmRecord
 @ConfigurationProperties("com.adobe.testing.s3mock.store")
 data class StoreProperties(
-// True if files should be retained when S3Mock exits gracefully.
-  // False to let S3Mock delete all files when S3Mock exits gracefully.
+  /**
+   * True if files should be retained when S3Mock exits gracefully.
+   * False to let S3Mock delete all files when S3Mock exits gracefully.
+   */
   @param:DefaultValue("false") val retainFilesOnExit: Boolean,
-  // The root directory to use. If omitted a default temp-dir will be used.
+  /**
+   * The root directory to use. If omitted a default temp-dir will be used.
+   */
   @param:DefaultValue("") val root: String,
+  /**
+   * A set of KMS keys that S3Mock should treat as valid.
+   */
   @param:DefaultValue("") val validKmsKeys: Set<String>,
-  // A comma separated list of buckets that are to be created at startup.
+  /**
+   * A comma separated list of buckets that are to be created at startup.
+   */
   @param:DefaultValue("") val initialBuckets: List<String>,
-  // Region is S3Mock is supposed to mock.
-  // Must be an official AWS region string like "us-east-1"
+  /**
+   * Region is S3Mock is supposed to mock.
+   * Must be an official AWS region string like "us-east-1"
+   */
   @param:DefaultValue("us-east-1") val region: Region
 )