about summary refs log tree commit diff
path: root/library/std/src/os/unix/io/mod.rs
diff options
context:
space:
mode:
authorDan Gohman <dev@sunfishcode.online>2021-07-28 09:00:18 -0700
committerDan Gohman <dev@sunfishcode.online>2021-08-19 12:02:40 -0700
commit18a9f4628a44b2962dc8bd4b9b0026514effba2d (patch)
tree1da059d8e96ce42d9ec8b961c18e3ebf5f776862 /library/std/src/os/unix/io/mod.rs
parent1dbd6d60f011dd048355ddb229bc78c366598746 (diff)
downloadrust-18a9f4628a44b2962dc8bd4b9b0026514effba2d.tar.gz
rust-18a9f4628a44b2962dc8bd4b9b0026514effba2d.zip
Don't encourage migration until io_safety is stablized.
Diffstat (limited to 'library/std/src/os/unix/io/mod.rs')
-rw-r--r--library/std/src/os/unix/io/mod.rs7
1 files changed, 4 insertions, 3 deletions
diff --git a/library/std/src/os/unix/io/mod.rs b/library/std/src/os/unix/io/mod.rs
index 5a7682b5079..0fd9591b016 100644
--- a/library/std/src/os/unix/io/mod.rs
+++ b/library/std/src/os/unix/io/mod.rs
@@ -17,9 +17,10 @@
 //! Like raw pointers, `RawFd` values are primitive values. And in new code,
 //! they should be considered unsafe to do I/O on (analogous to dereferencing
 //! them). Rust did not always provide this guidance, so existing code in the
-//! Rust ecosystem often doesn't mark `RawFd` usage as unsafe. Libraries are
-//! encouraged to migrate, either by adding `unsafe` to APIs that dereference
-//! `RawFd` values, or by using to `BorrowedFd` or `OwnedFd` instead.
+//! Rust ecosystem often doesn't mark `RawFd` usage as unsafe. Once the
+//! `io_safety` feature is stable, libraries will be encouraged to migrate,
+//! either by adding `unsafe` to APIs that dereference `RawFd` values, or by
+//! using to `BorrowedFd` or `OwnedFd` instead.
 //!
 //! Like references, `BorrowedFd` values are tied to a lifetime, to ensure
 //! that they don't outlive the resource they point to. These are safe to