From 96834d6f4cc690bc07893cd53d95496fa2445bd6 Mon Sep 17 00:00:00 2001
From: Derek Bodin <bodin@users.noreply.github.com>
Date: Wed, 14 Oct 2020 17:56:57 -0500
Subject: [PATCH] Update example for default buildList to not use capacity
 KT-41136 (#3688)

---
 .../samples/test/samples/collections/builders.kt    | 13 +++++++++++++
 .../stdlib/src/kotlin/collections/Collections.kt    |  2 +-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/libraries/stdlib/samples/test/samples/collections/builders.kt b/libraries/stdlib/samples/test/samples/collections/builders.kt
index 29092dd616e..dd253e4309e 100644
--- a/libraries/stdlib/samples/test/samples/collections/builders.kt
+++ b/libraries/stdlib/samples/test/samples/collections/builders.kt
@@ -9,6 +9,19 @@ class Builders {
         fun buildListSample() {
             val x = listOf('b', 'c')
 
+            val y = buildList() {
+                add('a')
+                addAll(x)
+                add('d')
+            }
+
+            assertPrints(y, "[a, b, c, d]")
+        }
+
+        @Sample
+        fun buildListSampleWithCapacity() {
+            val x = listOf('b', 'c')
+
             val y = buildList(x.size + 2) {
                 add('a')
                 addAll(x)
diff --git a/libraries/stdlib/src/kotlin/collections/Collections.kt b/libraries/stdlib/src/kotlin/collections/Collections.kt
index 1493d51d962..8f4b9175960 100644
--- a/libraries/stdlib/src/kotlin/collections/Collections.kt
+++ b/libraries/stdlib/src/kotlin/collections/Collections.kt
@@ -189,7 +189,7 @@ internal expect inline fun <E> buildListInternal(builderAction: MutableList<E>.(
  *
  * @throws IllegalArgumentException if the given [capacity] is negative.
  *
- * @sample samples.collections.Builders.Lists.buildListSample
+ * @sample samples.collections.Builders.Lists.buildListSampleWithCapacity
  */
 @SinceKotlin("1.3")
 @ExperimentalStdlibApi