Deprecate join (use joinToString instead)

#KT-6909

libraries/stdlib/test/collections/CollectionTest.kt

@@ -14,13 +14,13 @@ class CollectionTest {
         assertEquals("{foo-bar}", buffer.toString())
     }
 
-    @test fun join() {
+    @test fun joinToString() {
         val data = listOf("foo", "bar")
-        val text = data.join("-", "<", ">")
+        val text = data.joinToString("-", "<", ">")
         assertEquals("<foo-bar>", text)
 
         val big = listOf("a", "b", "c", "d", "e", "f")
-        val text2 = big.join(limit = 3, truncated = "*")
+        val text2 = big.joinToString(limit = 3, truncated = "*")
         assertEquals("a, b, c, *", text2)
     }
 

libraries/stdlib/test/collections/ListSpecificTest.kt

@@ -64,7 +64,7 @@ class ListSpecificTest {
         }
 
         assertEquals(3, list.size())
-        assertEquals("beverage,location,name", list.join(","))
+        assertEquals("beverage,location,name", list.joinToString(","))
     }
 
     @Test

libraries/stdlib/test/collections/MapTest.kt

@@ -83,7 +83,7 @@ class MapTest {
         }
 
         assertEquals(6, list.size())
-        assertEquals("beverage,beer,location,Mells,name,James", list.join(","))
+        assertEquals("beverage,beer,location,Mells,name,James", list.joinToString(","))
     }
 
     @test fun stream() {
@@ -101,7 +101,7 @@ class MapTest {
         }
 
         assertEquals(6, list.size())
-        assertEquals("beverage,beer,location,Mells,name,James", list.join(","))
+        assertEquals("beverage,beer,location,Mells,name,James", list.joinToString(","))
     }
 
     @test fun iterateWithExtraction() {
@@ -113,7 +113,7 @@ class MapTest {
         }
 
         assertEquals(6, list.size())
-        assertEquals("beverage,beer,location,Mells,name,James", list.join(","))
+        assertEquals("beverage,beer,location,Mells,name,James", list.joinToString(","))
     }
 
     @test fun contains() {