Fix comments

Author: dkhalanskyjb

core/common/src/LocalDate.kt

@@ -35,6 +35,9 @@ import kotlin.internal.*
  *
  * ### Platform specifics
  *
+ * The range of supported years is unspecified, but at least is enough to represent dates of all instants between
+ * [Instant.DISTANT_PAST] and [Instant.DISTANT_FUTURE].
+ *
  * On the JVM,
  * there are `LocalDate.toJavaLocalDate()` and `java.time.LocalDate.toKotlinLocalDate()`
  * extension functions to convert between `kotlinx.datetime` and `java.time` objects used for the same purpose.

core/common/src/LocalDateTime.kt

@@ -66,7 +66,7 @@ import kotlin.jvm.JvmName
  *
  * ### Platform specifics
  *
- * The range of supported years is platform-dependent, but at least is enough to represent dates of all instants between
+ * The range of supported years is unspecified, but at least is enough to represent dates of all instants between
  * [Instant.DISTANT_PAST] and [Instant.DISTANT_FUTURE].
  *
  * On the JVM, there are `LocalDateTime.toJavaLocalDateTime()` and `java.time.LocalDateTime.toKotlinLocalDateTime()`

core/common/src/YearMonth.kt

@@ -29,7 +29,7 @@ import kotlinx.serialization.Serializable
  *
  * ### Platform specifics
  *
- * The range of supported years is platform-dependent, but at least is enough to represent year-months of all instants
+ * The range of supported years is unspecified, but at least is enough to represent year-months of all instants
  * between [Instant.DISTANT_PAST] and [Instant.DISTANT_FUTURE] in any time zone.
  *
  * On the JVM,
@@ -236,6 +236,7 @@ public val LocalDate.yearMonth: YearMonth get() = YearMonth(year, month)
 /**
  * Combines this year-month with the specified day-of-month into a [LocalDate] value.
  *
+ * @throw IllegalArgumentException if the [day] is out of range for this year-month.
  * @sample kotlinx.datetime.test.samples.YearMonthSamples.onDay
  */
 public fun YearMonth.onDay(day: Int): LocalDate = LocalDate(year, month, day)
@@ -384,4 +385,4 @@ internal fun YearMonth.Companion.fromProlepticMonth(prolepticMonth: Long): YearM
 }
 
 internal val YearMonth.Companion.MAX get() = LocalDate.MAX.yearMonth
-internal val YearMonth.Companion.MIN get() = LocalDate.MIN.yearMonth
+internal val YearMonth.Companion.MIN get() = LocalDate.MIN.yearMonth