update from master

Jolanrensen · Jolanrensen · commit 76c84a35bbd4 · 2023-04-07T16:37:16.000+02:00
diff --git a/core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/update.kt b/core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/update.kt
@@ -1,6 +1,7 @@
 package org.jetbrains.kotlinx.dataframe.api
 
 import org.jetbrains.kotlinx.dataframe.*
+import org.jetbrains.kotlinx.dataframe.ColumnExpression
 import org.jetbrains.kotlinx.dataframe.api.Update.Usage
 import org.jetbrains.kotlinx.dataframe.columns.ColumnGroup
 import org.jetbrains.kotlinx.dataframe.columns.ColumnReference
@@ -60,16 +61,16 @@ public data class Update<T, C>(
     /** The columns to update need to be selected. See [Selecting Columns][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns] for all the selecting options. */
     public interface Columns
 
-    /** @param columns The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame] to update. */
+    /** @param [columns\] The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame] to update. */
     internal interface DslParam
 
-    /** @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame] to update. */
+    /** @param [columns\] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame] to update. */
     internal interface ColumnAccessorsParam
 
-    /** @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame] to update. */
+    /** @param [columns\] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame] to update. */
     internal interface KPropertiesParam
 
-    /** @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame] to update. */
+    /** @param [columns\] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame] to update. */
     internal interface ColumnNamesParam
 }
 
@@ -126,7 +127,7 @@ private interface UpdateWithNote
  *
  * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { `[colsOf][org.jetbrains.kotlinx.dataframe.api.colsOf]`<`[Double][Double]`>() }`
  *  
- * @param columns The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [columns] The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
  */
 public fun <T, C> DataFrame<T>.update(columns: ColumnsSelector<T, C>): Update<T, C> =
     Update(this, null, columns)
@@ -153,7 +154,7 @@ public fun <T, C> DataFrame<T>.update(columns: ColumnsSelector<T, C>): Update<T,
  * ## Optional
  * Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
  * into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
- * @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [columns] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
  */
 public fun <T> DataFrame<T>.update(vararg columns: String): Update<T, Any?> = update { columns.toColumnSet() }
 
@@ -181,7 +182,7 @@ public fun <T> DataFrame<T>.update(vararg columns: String): Update<T, Any?> = up
  * ## Optional
  * Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
  * into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
- * @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [columns] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
  */
 public fun <T, C> DataFrame<T>.update(vararg columns: KProperty<C>): Update<T, C> = update { columns.toColumnSet() }
 
@@ -211,7 +212,7 @@ public fun <T, C> DataFrame<T>.update(vararg columns: KProperty<C>): Update<T, C
  * ## Optional
  * Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
  * into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
- * @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [columns] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
  */
 public fun <T, C> DataFrame<T>.update(vararg columns: ColumnReference<C>): Update<T, C> =
     update { columns.toColumnSet() }
@@ -242,7 +243,7 @@ public fun <T, C> DataFrame<T>.update(columns: Iterable<ColumnReference<C>>): Up
  *
  *
  *
- * @param predicate The [row value filter][RowValueFilter] to select the rows to update.
+ * @param [predicate] The [row value filter][RowValueFilter] to select the rows to update.
  */
 public fun <T, C> Update<T, C>.where(predicate: RowValueFilter<T, C>): Update<T, C> =
     copy(filter = filter and predicate)
@@ -282,7 +283,7 @@ private interface CommonUpdateAtFunctionDoc {
  *
  * Provide a [Collection]<[Int]> of row indices to update.
  *
- * @param rowIndices The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
+ * @param [rowIndices] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
  */
 public fun <T, C> Update<T, C>.at(rowIndices: Collection<Int>): Update<T, C> = where { index in rowIndices }
 
@@ -302,7 +303,7 @@ public fun <T, C> Update<T, C>.at(rowIndices: Collection<Int>): Update<T, C> = w
  *
  * Provide a `vararg` of [Ints][Int] of row indices to update.
  *
- * @param rowIndices The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
+ * @param [rowIndices] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
  */
 public fun <T, C> Update<T, C>.at(vararg rowIndices: Int): Update<T, C> = at(rowIndices.toSet())
 
@@ -322,7 +323,7 @@ public fun <T, C> Update<T, C>.at(vararg rowIndices: Int): Update<T, C> = at(row
  *
  * Provide an [IntRange] of row indices to update.
  *
- * @param rowRange The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
+ * @param [rowRange] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
  */
 public fun <T, C> Update<T, C>.at(rowRange: IntRange): Update<T, C> = where { index in rowRange }
 
@@ -331,19 +332,19 @@ public fun <T, C> Update<T, C>.at(rowRange: IntRange): Update<T, C> = where { in
  *
  * For example:
  *
- * `df.`[update][update]` { age ` { row, col ->`
+ * `df.`[update][update]` { age }.`[perRowCol][perRowCol]` { row, col ->`
  *
  * `row.age / col.`[mean][org.jetbrains.kotlinx.dataframe.DataColumn.mean]`(skipNA = true)`
  *
  * `}`
  *
  *
- * .`[perRowCol][perRowCol]}
+ *
  *
  * ## See Also
  *  - [Update with][org.jetbrains.kotlinx.dataframe.api.Update.with] to provide a new value for every selected cell giving its row.
  *  - [Update per col][org.jetbrains.kotlinx.dataframe.api.Update.perCol] to provide a new value for every selected cell giving its column.
- * @param expression The [Row Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRowAndColumn.RowColumnExpression] to provide a new value for every selected cell giving its row and column.
+ * @param [expression] The [Row Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRowAndColumn.RowColumnExpression] to provide a new value for every selected cell giving its row and column.
  */
 public fun <T, C> Update<T, C>.perRowCol(expression: RowColumnExpression<T, C, C>): DataFrame<T> =
     updateImpl { row, column, _ -> expression(row, column) }
@@ -377,7 +378,7 @@ public typealias UpdateExpression<T, C, R> = AddDataRow<T>.(C) -> R
  * ## See Also
  * - [Update per col][org.jetbrains.kotlinx.dataframe.api.Update.perCol] to provide a new value for every selected cell giving its column.
  * - [Update per row col][org.jetbrains.kotlinx.dataframe.api.Update.perRowCol] to provide a new value for every selected cell giving its row and column.
- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
  */
 public fun <T, C> Update<T, C>.with(expression: UpdateExpression<T, C, C?>): DataFrame<T> =
     updateImpl { row, _, value ->
@@ -397,7 +398,7 @@ private interface SeeAlsoWith
  *
  * `df.`[update][update]` { name ` { `[select][org.jetbrains.kotlinx.dataframe.DataFrame.select]` { lastName } }`
  * .`[asFrame][asFrame]}
- * @param expression The [Data Frame Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenDataFrame.DataFrameExpression] to replace the selected column group with.
+ * @param [expression] The [Data Frame Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenDataFrame.DataFrameExpression] to replace the selected column group with.
  */
 public fun <T, C, R> Update<T, DataRow<C>>.asFrame(expression: DataFrameExpression<C, DataFrame<R>>): DataFrame<T> =
     asFrameImpl(expression)
@@ -447,7 +448,7 @@ private interface UpdatePerColMap
  *
  * `df.`[update][update]` { name and age }.`[where][Update.where]` { ... }.`[perCol][perCol]`(defaults)`
  *
- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values\].
+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values\].
  */
 private interface CommonUpdatePerColMapDoc
 
@@ -472,10 +473,10 @@ private interface CommonUpdatePerColMapDoc
  *
  * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
  *
- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values].
+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values].
  *
  *
- * @param values The [Map]<[String], Value> to provide a new value for every selected cell.
+ * @param [values] The [Map]<[String], Value> to provide a new value for every selected cell.
  *   For each selected column, there must be a value in the map with the same name.
  */
 public fun <T, C> Update<T, C>.perCol(values: Map<String, C>): DataFrame<T> = updateWithValuePerColumnImpl {
@@ -501,18 +502,18 @@ public fun <T, C> Update<T, C>.perCol(values: Map<String, C>): DataFrame<T> = up
  *
  * `val defaults = df.`[getRows][DataFrame.getRows]`(`[listOf][listOf]`(0))`
  *
- *   `.`[update][update]` { name `
+ *   `.`[update][update]` { name }.`[with][Update.with]` { "Empty" }`
  *
- * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
+ *   `.`[update][update]` { age }.`[with][Update.with]` { 0 }`
  *
- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values].
- * .`[with][Update.with]` { "Empty" }`
+ *   `.first()`
  *
- *   `.`[update][update]` { age }.`[with][Update.with]` { 0 }`
+ * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
+ *
+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values].
  *
- *   `.first()}
  *
- * @param values The [DataRow] to provide a new value for every selected cell.
+ * @param [values] The [DataRow] to provide a new value for every selected cell.
  */
 public fun <T, C> Update<T, C>.perCol(values: AnyRow): DataFrame<T> = perCol(values.toMap() as Map<String, C>)
 
@@ -538,7 +539,7 @@ public fun <T, C> Update<T, C>.perCol(values: AnyRow): DataFrame<T> = perCol(val
  *
  * .`[perCol][perCol]}
  *
- * @param valueSelector The [Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenColumn.ColumnExpression] to provide a new value for every selected cell giving its column.
+ * @param [valueSelector] The [Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenColumn.ColumnExpression] to provide a new value for every selected cell giving its column.
  */
 public fun <T, C> Update<T, C>.perCol(valueSelector: ColumnExpression<C, C>): DataFrame<T> =
     updateWithValuePerColumnImpl(valueSelector)
@@ -627,8 +628,8 @@ public fun <T, C> Update<T, C?>.notNull(expression: UpdateExpression<T, C, C>):
  *
  *
  *
- * @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
+ * @param [columns] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
  */
 public fun <T, C> DataFrame<T>.update(
     firstCol: ColumnReference<C>,
@@ -664,8 +665,8 @@ public fun <T, C> DataFrame<T>.update(
  *
  *
  *
- * @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
+ * @param [columns] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
  */
 public fun <T, C> DataFrame<T>.update(
     firstCol: KProperty<C>,
@@ -702,8 +703,8 @@ public fun <T, C> DataFrame<T>.update(
  *
  *
  *
- * @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
+ * @param [columns] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.
+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.
  */
 public fun <T> DataFrame<T>.update(
     firstCol: String,
@@ -761,6 +762,6 @@ public fun <T, C> Update<T, C>.withZero(): DataFrame<T> = updateWithValuePerColu
  *
  *
  *
- * @param value The value to set the selected rows to. In contrast to [with][Update.with], this must be the same exact type.
+ * @param [value] The value to set the selected rows to. In contrast to [with][Update.with], this must be the same exact type.
  */
 public fun <T, C> Update<T, C>.withValue(value: C): DataFrame<T> = with { value }

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,7 @@`
`1`	`1`	`package org.jetbrains.kotlinx.dataframe.api`
`2`	`2`
`3`	`3`	`import org.jetbrains.kotlinx.dataframe.*`
	`4`	`+import org.jetbrains.kotlinx.dataframe.ColumnExpression`
`4`	`5`	`import org.jetbrains.kotlinx.dataframe.api.Update.Usage`
`5`	`6`	`import org.jetbrains.kotlinx.dataframe.columns.ColumnGroup`
`6`	`7`	`import org.jetbrains.kotlinx.dataframe.columns.ColumnReference`
`@@ -60,16 +61,16 @@ public data class Update<T, C>(`
`60`	`61`	`/** The columns to update need to be selected. See [Selecting Columns][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns] for all the selecting options. */`
`61`	`62`	`public interface Columns`
`62`	`63`
`63`		`- /** @param columns The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame] to update. */`
	`64`	`+ /** @param [columns\] The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame] to update. */`
`64`	`65`	`internal interface DslParam`
`65`	`66`
`66`		`- /** @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame] to update. */`
	`67`	`+ /** @param [columns\] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame] to update. */`
`67`	`68`	`internal interface ColumnAccessorsParam`
`68`	`69`
`69`		`- /** @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame] to update. */`
	`70`	`+ /** @param [columns\] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame] to update. */`
`70`	`71`	`internal interface KPropertiesParam`
`71`	`72`
`72`		`- /** @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame] to update. */`
	`73`	`+ /** @param [columns\] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame] to update. */`
`73`	`74`	`internal interface ColumnNamesParam`
`74`	`75`	`}`
`75`	`76`
`@@ -126,7 +127,7 @@ private interface UpdateWithNote`
`126`	`127`	`*`
`127`	`128`	* `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { `[colsOf][org.jetbrains.kotlinx.dataframe.api.colsOf]`<`[Double][Double]`>() }`
`128`	`129`	`*`
`129`		`- * @param columns The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`130`	`+ * @param [columns] The [Columns selector DSL][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.Dsl.WithExample] used to select the columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`130`	`131`	`*/`
`131`	`132`	`public fun <T, C> DataFrame<T>.update(columns: ColumnsSelector<T, C>): Update<T, C> =`
`132`	`133`	`Update(this, null, columns)`
`@@ -153,7 +154,7 @@ public fun <T, C> DataFrame<T>.update(columns: ColumnsSelector<T, C>): Update<T,`
`153`	`154`	`* ## Optional`
`154`	`155`	* Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
`155`	`156`	* into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
`156`		`- * @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`157`	`+ * @param [columns] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`157`	`158`	`*/`
`158`	`159`	`public fun <T> DataFrame<T>.update(vararg columns: String): Update<T, Any?> = update { columns.toColumnSet() }`
`159`	`160`
`@@ -181,7 +182,7 @@ public fun <T> DataFrame<T>.update(vararg columns: String): Update<T, Any?> = up`
`181`	`182`	`* ## Optional`
`182`	`183`	* Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
`183`	`184`	* into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
`184`		`- * @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`185`	`+ * @param [columns] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`185`	`186`	`*/`
`186`	`187`	`public fun <T, C> DataFrame<T>.update(vararg columns: KProperty<C>): Update<T, C> = update { columns.toColumnSet() }`
`187`	`188`
`@@ -211,7 +212,7 @@ public fun <T, C> DataFrame<T>.update(vararg columns: KProperty<C>): Update<T, C`
`211`	`212`	`* ## Optional`
`212`	`213`	* Combine `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...).`[with][org.jetbrains.kotlinx.dataframe.api.Update.with]` { ... }`
`213`	`214`	* into `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]`(...) { ... }`
`214`		`- * @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`215`	`+ * @param [columns] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`215`	`216`	`*/`
`216`	`217`	`public fun <T, C> DataFrame<T>.update(vararg columns: ColumnReference<C>): Update<T, C> =`
`217`	`218`	`update { columns.toColumnSet() }`
`@@ -242,7 +243,7 @@ public fun <T, C> DataFrame<T>.update(columns: Iterable<ColumnReference<C>>): Up`
`242`	`243`	`*`
`243`	`244`	`*`
`244`	`245`	`*`
`245`		`- * @param predicate The [row value filter][RowValueFilter] to select the rows to update.`
	`246`	`+ * @param [predicate] The [row value filter][RowValueFilter] to select the rows to update.`
`246`	`247`	`*/`
`247`	`248`	`public fun <T, C> Update<T, C>.where(predicate: RowValueFilter<T, C>): Update<T, C> =`
`248`	`249`	`copy(filter = filter and predicate)`
`@@ -282,7 +283,7 @@ private interface CommonUpdateAtFunctionDoc {`
`282`	`283`	`*`
`283`	`284`	`* Provide a [Collection]<[Int]> of row indices to update.`
`284`	`285`	`*`
`285`		- * @param rowIndices The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
	`286`	+ * @param [rowIndices] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
`286`	`287`	`*/`
`287`	`288`	`public fun <T, C> Update<T, C>.at(rowIndices: Collection<Int>): Update<T, C> = where { index in rowIndices }`
`288`	`289`
`@@ -302,7 +303,7 @@ public fun <T, C> Update<T, C>.at(rowIndices: Collection<Int>): Update<T, C> = w`
`302`	`303`	`*`
`303`	`304`	* Provide a `vararg` of [Ints][Int] of row indices to update.
`304`	`305`	`*`
`305`		- * @param rowIndices The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
	`306`	+ * @param [rowIndices] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
`306`	`307`	`*/`
`307`	`308`	`public fun <T, C> Update<T, C>.at(vararg rowIndices: Int): Update<T, C> = at(rowIndices.toSet())`
`308`	`309`
`@@ -322,7 +323,7 @@ public fun <T, C> Update<T, C>.at(vararg rowIndices: Int): Update<T, C> = at(row`
`322`	`323`	`*`
`323`	`324`	`* Provide an [IntRange] of row indices to update.`
`324`	`325`	`*`
`325`		- * @param rowRange The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
	`326`	+ * @param [rowRange] The indices of the rows to update. Either a [Collection]<[Int]>, an [IntRange], or just `vararg` indices.
`326`	`327`	`*/`
`327`	`328`	`public fun <T, C> Update<T, C>.at(rowRange: IntRange): Update<T, C> = where { index in rowRange }`
`328`	`329`
`@@ -331,19 +332,19 @@ public fun <T, C> Update<T, C>.at(rowRange: IntRange): Update<T, C> = where { in`
`331`	`332`	`*`
`332`	`333`	`* For example:`
`333`	`334`	`*`
`334`		- * `df.`[update][update]` { age ` { row, col ->`
	`335`	+ * `df.`[update][update]` { age }.`[perRowCol][perRowCol]` { row, col ->`
`335`	`336`	`*`
`336`	`337`	* `row.age / col.`[mean][org.jetbrains.kotlinx.dataframe.DataColumn.mean]`(skipNA = true)`
`337`	`338`	`*`
`338`	`339`	* `}`
`339`	`340`	`*`
`340`	`341`	`*`
`341`		- * .`[perRowCol][perRowCol]}
	`342`	`+ *`
`342`	`343`	`*`
`343`	`344`	`* ## See Also`
`344`	`345`	`* - [Update with][org.jetbrains.kotlinx.dataframe.api.Update.with] to provide a new value for every selected cell giving its row.`
`345`	`346`	`* - [Update per col][org.jetbrains.kotlinx.dataframe.api.Update.perCol] to provide a new value for every selected cell giving its column.`
`346`		`- * @param expression The [Row Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRowAndColumn.RowColumnExpression] to provide a new value for every selected cell giving its row and column.`
	`347`	`+ * @param [expression] The [Row Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRowAndColumn.RowColumnExpression] to provide a new value for every selected cell giving its row and column.`
`347`	`348`	`*/`
`348`	`349`	`public fun <T, C> Update<T, C>.perRowCol(expression: RowColumnExpression<T, C, C>): DataFrame<T> =`
`349`	`350`	`updateImpl { row, column, _ -> expression(row, column) }`
`@@ -377,7 +378,7 @@ public typealias UpdateExpression<T, C, R> = AddDataRow<T>.(C) -> R`
`377`	`378`	`* ## See Also`
`378`	`379`	`* - [Update per col][org.jetbrains.kotlinx.dataframe.api.Update.perCol] to provide a new value for every selected cell giving its column.`
`379`	`380`	`* - [Update per row col][org.jetbrains.kotlinx.dataframe.api.Update.perRowCol] to provide a new value for every selected cell giving its row and column.`
`380`		`- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
	`381`	`+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
`381`	`382`	`*/`
`382`	`383`	`public fun <T, C> Update<T, C>.with(expression: UpdateExpression<T, C, C?>): DataFrame<T> =`
`383`	`384`	`updateImpl { row, _, value ->`
`@@ -397,7 +398,7 @@ private interface SeeAlsoWith`
`397`	`398`	`*`
`398`	`399`	* `df.`[update][update]` { name ` { `[select][org.jetbrains.kotlinx.dataframe.DataFrame.select]` { lastName } }`
`399`	`400`	* .`[asFrame][asFrame]}
`400`		`- * @param expression The [Data Frame Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenDataFrame.DataFrameExpression] to replace the selected column group with.`
	`401`	`+ * @param [expression] The [Data Frame Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenDataFrame.DataFrameExpression] to replace the selected column group with.`
`401`	`402`	`*/`
`402`	`403`	`public fun <T, C, R> Update<T, DataRow<C>>.asFrame(expression: DataFrameExpression<C, DataFrame<R>>): DataFrame<T> =`
`403`	`404`	`asFrameImpl(expression)`
`@@ -447,7 +448,7 @@ private interface UpdatePerColMap`
`447`	`448`	`*`
`448`	`449`	* `df.`[update][update]` { name and age }.`[where][Update.where]` { ... }.`[perCol][perCol]`(defaults)`
`449`	`450`	`*`
`450`		`- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values\].`
	`451`	`+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values\].`
`451`	`452`	`*/`
`452`	`453`	`private interface CommonUpdatePerColMapDoc`
`453`	`454`
`@@ -472,10 +473,10 @@ private interface CommonUpdatePerColMapDoc`
`472`	`473`	`*`
`473`	`474`	* `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
`474`	`475`	`*`
`475`		`- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values].`
	`476`	`+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values].`
`476`	`477`	`*`
`477`	`478`	`*`
`478`		`- * @param values The [Map]<[String], Value> to provide a new value for every selected cell.`
	`479`	`+ * @param [values] The [Map]<[String], Value> to provide a new value for every selected cell.`
`479`	`480`	`* For each selected column, there must be a value in the map with the same name.`
`480`	`481`	`*/`
`481`	`482`	`public fun <T, C> Update<T, C>.perCol(values: Map<String, C>): DataFrame<T> = updateWithValuePerColumnImpl {`
`@@ -501,18 +502,18 @@ public fun <T, C> Update<T, C>.perCol(values: Map<String, C>): DataFrame<T> = up`
`501`	`502`	`*`
`502`	`503`	* `val defaults = df.`[getRows][DataFrame.getRows]`(`[listOf][listOf]`(0))`
`503`	`504`	`*`
`504`		- * `.`[update][update]` { name `
	`505`	+ * `.`[update][update]` { name }.`[with][Update.with]` { "Empty" }`
`505`	`506`	`*`
`506`		- * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
	`507`	+ * `.`[update][update]` { age }.`[with][Update.with]` { 0 }`
`507`	`508`	`*`
`508`		`- * @throws IllegalArgumentException if a value for a selected cell's column is not defined in [values].`
`509`		- * .`[with][Update.with]` { "Empty" }`
	`509`	+ * `.first()`
`510`	`510`	`*`
`511`		- * `.`[update][update]` { age }.`[with][Update.with]` { 0 }`
	`511`	+ * `df.`[update][org.jetbrains.kotlinx.dataframe.api.update]` { name and age }.`[where][org.jetbrains.kotlinx.dataframe.api.Update.where]` { ... }.`[perCol][org.jetbrains.kotlinx.dataframe.api.perCol]`(defaults)`
	`512`	`+ *`
	`513`	`+ * @throws [IllegalArgumentException] if a value for a selected cell's column is not defined in [values].`
`512`	`514`	`*`
`513`		- * `.first()}
`514`	`515`	`*`
`515`		`- * @param values The [DataRow] to provide a new value for every selected cell.`
	`516`	`+ * @param [values] The [DataRow] to provide a new value for every selected cell.`
`516`	`517`	`*/`
`517`	`518`	`public fun <T, C> Update<T, C>.perCol(values: AnyRow): DataFrame<T> = perCol(values.toMap() as Map<String, C>)`
`518`	`519`
`@@ -538,7 +539,7 @@ public fun <T, C> Update<T, C>.perCol(values: AnyRow): DataFrame<T> = perCol(val`
`538`	`539`	`*`
`539`	`540`	* .`[perCol][perCol]}
`540`	`541`	`*`
`541`		`- * @param valueSelector The [Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenColumn.ColumnExpression] to provide a new value for every selected cell giving its column.`
	`542`	`+ * @param [valueSelector] The [Column Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenColumn.ColumnExpression] to provide a new value for every selected cell giving its column.`
`542`	`543`	`*/`
`543`	`544`	`public fun <T, C> Update<T, C>.perCol(valueSelector: ColumnExpression<C, C>): DataFrame<T> =`
`544`	`545`	`updateWithValuePerColumnImpl(valueSelector)`
`@@ -627,8 +628,8 @@ public fun <T, C> Update<T, C?>.notNull(expression: UpdateExpression<T, C, C>):`
`627`	`628`	`*`
`628`	`629`	`*`
`629`	`630`	`*`
`630`		`- * @param columns The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`631`		`- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
	`631`	`+ * @param [columns] The [Column references][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnAccessors.WithExample] of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`632`	`+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
`632`	`633`	`*/`
`633`	`634`	`public fun <T, C> DataFrame<T>.update(`
`634`	`635`	`firstCol: ColumnReference<C>,`
`@@ -664,8 +665,8 @@ public fun <T, C> DataFrame<T>.update(`
`664`	`665`	`*`
`665`	`666`	`*`
`666`	`667`	`*`
`667`		`- * @param columns The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`668`		`- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
	`668`	`+ * @param [columns] The [KProperties][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.KProperties.WithExample] corresponding to columns of this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`669`	`+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
`669`	`670`	`*/`
`670`	`671`	`public fun <T, C> DataFrame<T>.update(`
`671`	`672`	`firstCol: KProperty<C>,`
`@@ -702,8 +703,8 @@ public fun <T, C> DataFrame<T>.update(`
`702`	`703`	`*`
`703`	`704`	`*`
`704`	`705`	`*`
`705`		`- * @param columns The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
`706`		`- * @param expression The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
	`706`	`+ * @param [columns] The [Column names][org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns.ColumnNames.WithExample] belonging to this [DataFrame][org.jetbrains.kotlinx.dataframe.DataFrame] to update.`
	`707`	`+ * @param [expression] The [Row Value Expression][org.jetbrains.kotlinx.dataframe.documentation.ExpressionsGivenRow.RowValueExpression.WithExample] to update the rows with.`
`707`	`708`	`*/`
`708`	`709`	`public fun <T> DataFrame<T>.update(`
`709`	`710`	`firstCol: String,`
`@@ -761,6 +762,6 @@ public fun <T, C> Update<T, C>.withZero(): DataFrame<T> = updateWithValuePerColu`
`761`	`762`	`*`
`762`	`763`	`*`
`763`	`764`	`*`
`764`		`- * @param value The value to set the selected rows to. In contrast to [with][Update.with], this must be the same exact type.`
	`765`	`+ * @param [value] The value to set the selected rows to. In contrast to [with][Update.with], this must be the same exact type.`
`765`	`766`	`*/`
`766`	`767`	`public fun <T, C> Update<T, C>.withValue(value: C): DataFrame<T> = with { value }`