@@ -6,7 +6,7 @@ use crate::fs;
66use crate :: io;
77use crate :: net;
88#[ cfg( doc) ]
9- use crate :: os:: windows:: io:: { AsHandle , AsSocket , FromHandle , FromSocket , IntoHandle , IntoSocket } ;
9+ use crate :: os:: windows:: io:: { AsHandle , AsSocket } ;
1010use crate :: os:: windows:: io:: { OwnedHandle , OwnedSocket } ;
1111use crate :: os:: windows:: raw;
1212use crate :: sys;
@@ -48,8 +48,9 @@ pub trait FromRawHandle {
4848 /// will take responsibility for closing it when the object goes out of
4949 /// scope.
5050 ///
51- /// However, consuming ownership is not strictly required. See
52- /// [`FromHandle::from_handle`] for an API which strictly consumes ownership.
51+ /// However, consuming ownership is not strictly required. Use a
52+ /// `From<OwnedHandle>::from` implementation for an API which strictly
53+ /// consumes ownership.
5354 ///
5455 /// # Safety
5556 ///
@@ -79,8 +80,9 @@ pub trait IntoRawHandle {
7980 /// handle to the caller. When used in this way, callers are then the unique
8081 /// owners of the handle and must close it once it's no longer needed.
8182 ///
82- /// However, transferring ownership is not strictly required. See
83- /// [`IntoHandle::into_handle`] for an API which strictly transfers ownership.
83+ /// However, transferring ownership is not strictly required. Use a
84+ /// `Into<OwnedHandle>::into` implementation for an API which strictly
85+ /// transfers ownership.
8486 #[ stable( feature = "into_raw_os" , since = "1.4.0" ) ]
8587 fn into_raw_handle ( self ) -> RawHandle ;
8688}
@@ -181,8 +183,9 @@ pub trait FromRawSocket {
181183 /// will take responsibility for closing it when the object goes out of
182184 /// scope.
183185 ///
184- /// However, consuming ownership is not strictly required. See
185- /// [`FromSocket::from_socket`] for an API which strictly consumes ownership.
186+ /// However, consuming ownership is not strictly required. Use a
187+ /// `From<OwnedSocket>::from` implementation for an API which strictly
188+ /// consumes ownership.
186189 ///
187190 /// # Safety
188191 ///
@@ -205,8 +208,9 @@ pub trait IntoRawSocket {
205208 /// socket to the caller. When used in this way, callers are then the unique
206209 /// owners of the socket and must close it once it's no longer needed.
207210 ///
208- /// However, transferring ownership is not strictly required. See
209- /// [`IntoSocket::into_socket`] for an API which strictly transfers ownership.
211+ /// However, transferring ownership is not strictly required. Use a
212+ /// `Into<OwnedSocket>::into` implementation for an API which strictly
213+ /// transfers ownership.
210214 #[ stable( feature = "into_raw_os" , since = "1.4.0" ) ]
211215 fn into_raw_socket ( self ) -> RawSocket ;
212216}
0 commit comments