f further doc tweaks

Author: TheBlueMatt

lightning/src/ln/peer_handler.rs

@@ -179,11 +179,11 @@ pub struct MessageHandler<CM: Deref, RM: Deref> where
 /// For efficiency, Clone should be relatively cheap for this type.
 ///
 /// Two descriptors may compare equal (by [`cmp::Eq`] and [`hash::Hash`]) as long as the original
-/// has been disconnected, the [`PeerManager`] informed of the disconnection (either by it having
-/// triggered the disconnection or a call to [`PeerManager::socket_disconnected`]), and no further
-/// calls to the [`PeerManager`] related to the original socket occur. This allows you to use a
-/// file descriptor for your SocketDescriptor directly, however for simplicity you may wish to
-/// simply use another value which is guaranteed to be globally unique instead.
+/// has been disconnected, the [`PeerManager`] has been informed of the disconnection (either by it
+/// having triggered the disconnection or a call to [`PeerManager::socket_disconnected`]), and no
+/// further calls to the [`PeerManager`] related to the original socket occur. This allows you to
+/// use a file descriptor for your SocketDescriptor directly, however for simplicity you may wish
+/// to simply use another value which is guaranteed to be globally unique instead.
 pub trait SocketDescriptor : cmp::Eq + hash::Hash + Clone {
 	/// Attempts to send some data from the given slice to the peer.
 	///
@@ -628,10 +628,10 @@ impl<Descriptor: SocketDescriptor, CM: Deref, RM: Deref, L: Deref> PeerManager<D
 	///
 	/// May return an Err to indicate that the connection should be closed.
 	///
-	/// May call [`send_data`] on the descriptor passed in (or another provided descriptor) before
+	/// May call [`send_data`] on the descriptor passed in (or an equal descriptor) before
 	/// returning. Thus, be very careful with reentrancy issues! The invariants around calling
 	/// [`write_buffer_space_avail`] in case a write did not fully complete must still hold - be
-	/// ready to call `[write_buffer_space_avail`] again if a write call generated here isnt'
+	/// ready to call `[write_buffer_space_avail`] again if a write call generated here isn't
 	/// sufficient!
 	///
 	/// [`send_data`]: SocketDescriptor::send_data
@@ -1381,7 +1381,7 @@ impl<Descriptor: SocketDescriptor, CM: Deref, RM: Deref, L: Deref> PeerManager<D
 	/// It will send pings to each peer and disconnect those which did not respond to the last
 	/// round of pings.
 	///
-	/// May call [`send_data`] all [`SocketDescriptor`]s. Thus, be very careful with reentrancy
+	/// May call [`send_data`] on all [`SocketDescriptor`]s. Thus, be very careful with reentrancy
 	/// issues!
 	///
 	/// [`send_data`]: SocketDescriptor::send_data