This class is thread-safe. * + *
Warning for Windows users: This class is one of the Guava APIs known to not work + * under Windows. Note that we do not run our + * CI under Windows, we know that some of + * our tests fail under Windows, and we warn + * about using some features of Guava under Windows, especially I/O features, and that warning + * applies even to APIs whose documentation doesn't include individual warnings like this one. + * * @author Chris Nokleberg * @since 1.0 */ diff --git a/android/guava/src/com/google/common/io/Files.java b/android/guava/src/com/google/common/io/Files.java index 2a25d2fcd896..ffa92f6bfc58 100644 --- a/android/guava/src/com/google/common/io/Files.java +++ b/android/guava/src/com/google/common/io/Files.java @@ -412,13 +412,20 @@ public static boolean equal(File file1, File file2) throws IOException { *
This method assumes that the temporary volume is writable, has free inodes and free blocks, * and that it will not be called thousands of times per second. * + *
Warning for Windows users: This method is one of the Guava APIs known to not + * work under Windows. Note that we do not + * run our CI under Windows, we know + * that some of our tests fail under Windows, and we warn about using some features of Guava under + * Windows, especially I/O features, and that warning applies even to APIs whose documentation + * doesn't include individual warnings like this one. + * *
{@link java.nio.file.Path} equivalent: {@link * java.nio.file.Files#createTempDirectory}. * * @return the newly-created directory - * @throws IllegalStateException if the directory could not be created - * @throws UnsupportedOperationException if the system does not support creating temporary - * directories securely + * @throws IllegalStateException if the directory could not be created, such as if the system does + * not support creating temporary directories securely * @deprecated For Android users, see the Data and File * Storage overview to select an appropriate temporary directory (perhaps {@code diff --git a/android/guava/src/com/google/common/io/TempFileCreator.java b/android/guava/src/com/google/common/io/TempFileCreator.java index a28a0af927a3..03c5ae99cec6 100644 --- a/android/guava/src/com/google/common/io/TempFileCreator.java +++ b/android/guava/src/com/google/common/io/TempFileCreator.java @@ -42,8 +42,7 @@ abstract class TempFileCreator { /** * @throws IllegalStateException if the directory could not be created (to implement the contract - * of {@link Files#createTempDir()} - * @throws UnsupportedOperationException if the system does not support creating temporary + * of {@link Files#createTempDir()}, such as if the system does not support creating temporary * directories securely */ abstract File createTempDir(); diff --git a/guava/src/com/google/common/io/FileBackedOutputStream.java b/guava/src/com/google/common/io/FileBackedOutputStream.java index dd297e90a8b2..51b279971ef7 100644 --- a/guava/src/com/google/common/io/FileBackedOutputStream.java +++ b/guava/src/com/google/common/io/FileBackedOutputStream.java @@ -58,6 +58,13 @@ * *
This class is thread-safe. * + *
Warning for Windows users: This class is one of the Guava APIs known to not work + * under Windows. Note that we do not run our + * CI under Windows, we know that some of + * our tests fail under Windows, and we warn + * about using some features of Guava under Windows, especially I/O features, and that warning + * applies even to APIs whose documentation doesn't include individual warnings like this one. + * * @author Chris Nokleberg * @since 1.0 */ diff --git a/guava/src/com/google/common/io/Files.java b/guava/src/com/google/common/io/Files.java index 2a25d2fcd896..ffa92f6bfc58 100644 --- a/guava/src/com/google/common/io/Files.java +++ b/guava/src/com/google/common/io/Files.java @@ -412,13 +412,20 @@ public static boolean equal(File file1, File file2) throws IOException { *
This method assumes that the temporary volume is writable, has free inodes and free blocks, * and that it will not be called thousands of times per second. * + *
Warning for Windows users: This method is one of the Guava APIs known to not + * work under Windows. Note that we do not + * run our CI under Windows, we know + * that some of our tests fail under Windows, and we warn about using some features of Guava under + * Windows, especially I/O features, and that warning applies even to APIs whose documentation + * doesn't include individual warnings like this one. + * *
{@link java.nio.file.Path} equivalent: {@link * java.nio.file.Files#createTempDirectory}. * * @return the newly-created directory - * @throws IllegalStateException if the directory could not be created - * @throws UnsupportedOperationException if the system does not support creating temporary - * directories securely + * @throws IllegalStateException if the directory could not be created, such as if the system does + * not support creating temporary directories securely * @deprecated For Android users, see the Data and File * Storage overview to select an appropriate temporary directory (perhaps {@code diff --git a/guava/src/com/google/common/io/TempFileCreator.java b/guava/src/com/google/common/io/TempFileCreator.java index a28a0af927a3..03c5ae99cec6 100644 --- a/guava/src/com/google/common/io/TempFileCreator.java +++ b/guava/src/com/google/common/io/TempFileCreator.java @@ -42,8 +42,7 @@ abstract class TempFileCreator { /** * @throws IllegalStateException if the directory could not be created (to implement the contract - * of {@link Files#createTempDir()} - * @throws UnsupportedOperationException if the system does not support creating temporary + * of {@link Files#createTempDir()}, such as if the system does not support creating temporary * directories securely */ abstract File createTempDir();