[docs] Document the lazyness of assert argument

 #KT-7540

libraries/stdlib/jvm/src/kotlin/util/AssertionsJVM.kt

diff --git a/libraries/stdlib/jvm/src/kotlin/util/AssertionsJVM.kt b/libraries/stdlib/jvm/src/kotlin/util/AssertionsJVM.kt
index 26f3c0d..02be994 100644
--- a/libraries/stdlib/jvm/src/kotlin/util/AssertionsJVM.kt
+++ b/libraries/stdlib/jvm/src/kotlin/util/AssertionsJVM.kt
@@ -17,6 +17,12 @@
 /**
  * Throws an [AssertionError] if the [value] is false
  * and runtime assertions have been enabled on the JVM using the *-ea* JVM option.
+ *
+ * Depending on value of `-Xassertions` compiler flag, argument [value] is either
+ * evaluated or accessed lazily. When `-Xassertions=legacy` or
+ * `-Xassertions=always-enable` the argument is evaluated regardless of whether
+ * runtime assertions are enabled, to make it lazy, use `-Xassertions=jvm`. When
+ * `-Xassertions=always-disable`, the [value] is ignored and not evaluated.
  */
 @kotlin.internal.InlineOnly
 public inline fun assert(value: Boolean) {
@@ -26,6 +32,12 @@
 /**
  * Throws an [AssertionError] calculated by [lazyMessage] if the [value] is false
  * and runtime assertions have been enabled on the JVM using the *-ea* JVM option.
+ *
+ * Depending on value of `-Xassertions` compiler flag, argument [value] is either
+ * evaluated or accessed lazily. When `-Xassertions=legacy` or
+ * `-Xassertions=always-enable` the argument is evaluated regardless of whether
+ * runtime assertions are enabled, to make it lazy, use `-Xassertions=jvm`. When
+ * `-Xassertions=always-disable`, the [value] is ignored and not evaluated.
  */
 @kotlin.internal.InlineOnly
 public inline fun assert(value: Boolean, lazyMessage: () -> Any) {