Deprecate createTempFile/createTempDir functions

Document their potential permission problems.
Suppress this deprecation in tests.

libraries/stdlib/jvm/test/io/FileTreeWalks.kt

@@ -16,7 +16,7 @@ class FileTreeWalkTest {
         val referenceFilenames =
                 listOf("1", "1/2", "1/3", "1/3/4.txt", "1/3/5.txt", "6", "7.txt", "8", "8/9.txt")
         fun createTestFiles(): File {
-            val basedir = createTempDir()
+            val basedir = @Suppress("DEPRECATION") createTempDir()
             for (name in referenceFilenames) {
                 val file = basedir.resolve(name)
                 if (file.extension.isEmpty())
@@ -52,7 +52,7 @@ class FileTreeWalkTest {
     }
 
     @Test fun singleFile() {
-        val testFile = createTempFile()
+        val testFile = @Suppress("DEPRECATION") createTempFile()
         val nonExistantFile = testFile.resolve("foo")
         try {
             for (walk in listOf(File::walkTopDown, File::walkBottomUp)) {
@@ -437,6 +437,7 @@ class FileTreeWalkTest {
         }
     }
 
+    @Suppress("DEPRECATION")
     @Test fun streamFileTree() {
         val dir = createTempDir()
         try {

libraries/stdlib/jvm/test/io/Files.kt

@@ -17,12 +17,14 @@ class FilesTest {
     private val isBackslashSeparator = File.separatorChar == '\\'
 
 
+    @Suppress("DEPRECATION")
     @Test fun testPath() {
         val fileSuf = System.currentTimeMillis().toString()
         val file1 = createTempFile("temp", fileSuf)
         assertTrue(file1.path.endsWith(fileSuf), file1.path)
     }
 
+    @Suppress("DEPRECATION")
     @Test fun testCreateTempDir() {
         val dirSuf = System.currentTimeMillis().toString()
         val dir1 = createTempDir("temp", dirSuf)
@@ -42,6 +44,7 @@ class FilesTest {
         dir3.delete()
     }
 
+    @Suppress("DEPRECATION")
     @Test fun testCreateTempFile() {
         val fileSuf = System.currentTimeMillis().toString()
         val file1 = createTempFile("temp", fileSuf)
@@ -61,6 +64,7 @@ class FilesTest {
         file3.delete()
     }
 
+    @Suppress("DEPRECATION")
     @Test fun listFilesWithFilter() {
         val dir = createTempDir("temp")
 
@@ -366,7 +370,7 @@ class FilesTest {
     }
 
     @Test fun writeReadText() {
-        val file = createTempFile()
+        val file = @Suppress("DEPRECATION") createTempFile()
         try {
             val expected = String(CharArray(DEFAULT_BUFFER_SIZE * 2) { Random.nextInt(0, 1024).toChar() })
             file.writeText(expected)
@@ -391,7 +395,7 @@ class FilesTest {
     }
 
     @Test fun writeReadBytes() {
-        val file = createTempFile()
+        val file = @Suppress("DEPRECATION") createTempFile()
         try {
             val expected = Random.nextBytes(DEFAULT_BUFFER_SIZE * 4)
             file.writeBytes(expected)
@@ -427,8 +431,8 @@ class FilesTest {
     }
 
     @Test fun testCopyTo() {
-        val srcFile = createTempFile()
-        val dstFile = createTempFile()
+        val srcFile = @Suppress("DEPRECATION") createTempFile()
+        val dstFile = @Suppress("DEPRECATION") createTempFile()
         try {
             srcFile.writeText("Hello, World!")
             assertFailsWith(FileAlreadyExistsException::class, "copy do not overwrite existing file") {
@@ -493,8 +497,8 @@ class FilesTest {
 
     @Test fun copyToNameWithoutParent() {
         val currentDir = File("").absoluteFile!!
-        val srcFile = createTempFile()
-        val dstFile = createTempFile(directory = currentDir)
+        val srcFile = @Suppress("DEPRECATION") createTempFile()
+        val dstFile = @Suppress("DEPRECATION") createTempFile(directory = currentDir)
         try {
             srcFile.writeText("Hello, World!", Charsets.UTF_8)
             dstFile.delete()
@@ -512,7 +516,7 @@ class FilesTest {
     }
 
     @Test fun deleteRecursively() {
-        val dir = createTempDir()
+        val dir = @Suppress("DEPRECATION") createTempDir()
         dir.delete()
         dir.mkdir()
         val subDir = File(dir, "subdir");
@@ -563,6 +567,7 @@ class FilesTest {
         }
     }
 
+    @Suppress("DEPRECATION")
     @Test fun copyRecursively() {
         val src = createTempDir()
         val dst = createTempDir()
@@ -629,6 +634,7 @@ class FilesTest {
         }
     }
 
+    @Suppress("DEPRECATION")
     @Test fun copyRecursivelyWithOverwrite() {
         val src = createTempDir()
         val dst = createTempDir()
@@ -675,7 +681,7 @@ class FilesTest {
     }
 
     @Test fun helpers2() {
-        val file = createTempFile()
+        val file = @Suppress("DEPRECATION") createTempFile()
         val writer = file.printWriter()
         val str1 = "Hello, world!"
         val str2 = "Everything is wonderful!"

libraries/stdlib/jvm/test/io/IOStreams.kt

@@ -12,7 +12,7 @@ import kotlin.random.Random
 
 class IOStreamsTest {
     @Test fun testGetStreamOfFile() {
-        val tmpFile = createTempFile()
+        val tmpFile = @Suppress("DEPRECATION") createTempFile()
         var writer: Writer? = null
         try {
             writer = tmpFile.outputStream().writer()
@@ -46,7 +46,7 @@ class IOStreamsTest {
     }
 
     @Test fun readWriteBytes() {
-        val file = createTempFile("temp", Random.nextLong().toString())
+        val file = @Suppress("DEPRECATION") createTempFile("temp", Random.nextLong().toString())
         try {
             val bytes = Random.nextBytes(256_000)