[QrackyDev]

A newline inside @YamlComment previously left subsequent lines without a # prefix. Split each argument on LF, CRLF, or CR and emit every resulting line as a YAML comment.

Preserve indentation, blank lines, and trailing spaces, including existing annotations that pass one string per line. Literal backslash sequences remain literal text. Whitespace normalization belongs to the caller; the writer does not call trimIndent().

@YamlComment("Example:\n  parent:\n    child: value")
val enabled: Boolean = true

# Example:
#   parent:
#     child: value
enabled: true

Raw multiline strings are supported with their whitespace preserved. Kotlin and the supported target set remain unchanged.

Validation: six focused regression tests cover separate indented arguments, LF/CRLF/CR, blank lines, raw multiline strings, and literal backslashes. The JVM writing suite and Spotless checks pass.

[IRus]

@QrackyDev thanks, I've just removed trimIndent since it's broking already existing comments:

@YamlComment(
    "Example:",
    "  parent:",
    "    child: value",
)

Before:

# Example:
#   parent:
#     child: value

After:

# Example:
# parent:
# child: value

in Kotlin 2.5.0 this would work just fine:

@YamlComment(
    """
    |Example:
    |  parent:
    |    child: value
    """.trimMargin(),
)
val enabled: Boolean

// yaml:

# Example:
#   parent:
#     child: value
enabled: true