util functions fix

Author: AndreiKingsley

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/any.kt

@@ -41,6 +41,7 @@ public fun <T> DataColumn<T>.any(predicate: Predicate<T>): Boolean = values.any(
  * @param predicate A [RowFilter] lambda that takes a [DataRow] (as both `this` and `it`)
  * and returns `true` if the row should be considered a match.
  * @return `true` if at least one row satisfies the [predicate], `false` otherwise.
+ * @see [DataFrame.all]
  */
 public inline fun <T> DataFrame<T>.any(predicate: RowFilter<T>): Boolean = rows().any { predicate(it, it) }
 

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/between.kt

@@ -7,7 +7,7 @@ import org.jetbrains.kotlinx.dataframe.impl.between
 
 /**
  * Returns a [DataColumn] of [Boolean] values indicating whether each element
- * lies between [left] and [right].
+ * in this column lies between [left] and [right].
  *
  * If [includeBoundaries] is `true` (default), values equal to [left] or [right] are also considered in range.
  *

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/tail.kt

@@ -1,12 +1,17 @@
 package org.jetbrains.kotlinx.dataframe.api
 
 import org.jetbrains.kotlinx.dataframe.DataFrame
-import org.jetbrains.kotlinx.dataframe.util.TAIL
-import org.jetbrains.kotlinx.dataframe.util.TAIL_REPLACE
 
 // region DataFrame
 
-@Deprecated(TAIL, ReplaceWith(TAIL_REPLACE), DeprecationLevel.ERROR)
+/**
+ * Returns a DataFrame containing the last [numRows] rows.
+ *
+ * Equivalent to [takeLast].
+ *
+ * @param numRows The number of rows to return from the end of the DataFrame. Defaults to 5.
+ * @return A DataFrame containing the last [numRows] rows.
+ */
 public fun <T> DataFrame<T>.tail(numRows: Int = 5): DataFrame<T> = takeLast(numRows)
 
 // endregion

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/util/deprecationMessages.kt

@@ -139,9 +139,6 @@ internal const val COL_TYPE_INSTANT =
     "kotlinx.datetime.Instant is deprecated in favor of kotlin.time.Instant. Either migrate to kotlin.time.Instant and use ColType.StdlibInstant or use ColType.DeprecatedInstant. $MESSAGE_1_0 and migrated to kotlin.time.Instant in 1.1."
 internal const val COL_TYPE_INSTANT_REPLACE = "ColType.DeprecatedInstant"
 
-internal const val TAIL = "This function will be removed in favor of `takeLast()`. $MESSAGE_1_0"
-internal const val TAIL_REPLACE = "this.takeLast(numRows)"
-
 // endregion
 
 // region WARNING in 1.0, ERROR in 1.1

core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Create.kt

@@ -78,19 +78,6 @@ class Create : TestBase() {
         // SampleEnd
     }
 
-    // Not used anymore
-    /*@Test
-    @TransformDataFrameExpressions
-    fun columnAccessorToColumn() {
-        // SampleStart
-        val age by column<Int>()
-        val ageCol1 = age.withValues(15, 20)
-        val ageCol2 = age.withValues(1..10)
-        // SampleEnd
-
-        ageCol2.size() shouldBe 10
-    }*/
-
     @Test
     @TransformDataFrameExpressions
     fun columnAccessorMap() {

examples/kotlin-dataframe-plugin-example/src/main/kotlin/org/jetbrains/kotlinx/dataframe/examples/plugin/Main.kt

@@ -6,11 +6,9 @@ import org.jetbrains.kotlinx.dataframe.api.add
 import org.jetbrains.kotlinx.dataframe.api.convert
 import org.jetbrains.kotlinx.dataframe.api.convertTo
 import org.jetbrains.kotlinx.dataframe.api.filter
-import org.jetbrains.kotlinx.dataframe.api.insert
 import org.jetbrains.kotlinx.dataframe.api.into
 import org.jetbrains.kotlinx.dataframe.api.rename
 import org.jetbrains.kotlinx.dataframe.api.renameToCamelCase
-import org.jetbrains.kotlinx.dataframe.api.under
 import org.jetbrains.kotlinx.dataframe.api.with
 import org.jetbrains.kotlinx.dataframe.io.readCsv
 import org.jetbrains.kotlinx.dataframe.io.writeCsv