Merge pull request #1533 from Kotlin/groupby_kdocs

groupBy Kdocs

Author: AndreiKingsley

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/aggregation/AggregateDsl.kt

@@ -1,6 +1,7 @@
 package org.jetbrains.kotlinx.dataframe.aggregation
 
 import org.jetbrains.kotlinx.dataframe.DataFrame
+import org.jetbrains.kotlinx.dataframe.annotations.AccessApiOverload
 import org.jetbrains.kotlinx.dataframe.annotations.HasSchema
 import org.jetbrains.kotlinx.dataframe.annotations.Interpretable
 import org.jetbrains.kotlinx.dataframe.api.ColumnSelectionDsl
@@ -9,6 +10,7 @@ import org.jetbrains.kotlinx.dataframe.columns.ColumnAccessor
 import org.jetbrains.kotlinx.dataframe.impl.aggregation.ValueWithDefault
 import org.jetbrains.kotlinx.dataframe.impl.aggregation.receivers.internal
 import org.jetbrains.kotlinx.dataframe.impl.columnName
+import org.jetbrains.kotlinx.dataframe.util.DEPRECATED_ACCESS_API
 import kotlin.reflect.KProperty
 import kotlin.reflect.typeOf
 
@@ -21,9 +23,13 @@ public abstract class AggregateDsl<out T> :
     public inline infix fun <reified R> R.into(name: String): NamedValue =
         internal().yield(pathOf(name), this, typeOf<R>())
 
+    @Deprecated(DEPRECATED_ACCESS_API)
+    @AccessApiOverload
     public inline infix fun <reified R> R.into(column: ColumnAccessor<R>): NamedValue =
         internal().yield(pathOf(column.name()), this, typeOf<R>())
 
+    @Deprecated(DEPRECATED_ACCESS_API)
+    @AccessApiOverload
     public inline infix fun <reified R> R.into(column: KProperty<R>): NamedValue =
         internal().yield(pathOf(column.columnName), this, typeOf<R>())
 

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

@@ -24,7 +24,8 @@ import kotlin.reflect.KProperty
 // region DataFrame
 
 /**
- * Groups the specified [columns\] within the [DataFrame].
+ * Groups the specified [columns\] within the [DataFrame] into
+ * [column group][ColumnGroup].
  *
  * This function does not immediately group the columns but instead select columns to group and
  * returns a [GroupClause],