diff --git a/library/std/src/fs.rs b/library/std/src/fs.rs
index 1f8aac48a9a8..75d1fcc166a1 100644
--- a/library/std/src/fs.rs
+++ b/library/std/src/fs.rs
@@ -2284,8 +2284,8 @@ impl AsInner<fs_imp::DirEntry> for DirEntry {
 ///
 /// # Platform-specific behavior
 ///
-/// This function currently corresponds to the `unlink` function on Unix
-/// and the `DeleteFile` function on Windows.
+/// This function currently corresponds to the `unlink` function on Unix.
+/// On Windows, `DeleteFile` is used or `CreateFileW` and `SetInformationByHandle` for readonly files.
 /// Note that, this [may change in the future][changes].
 ///
 /// [changes]: io#platform-specific-behavior