f clearer docs

Author: TheBlueMatt

lightning/src/ln/channel.rs

@@ -776,9 +776,9 @@ pub(super) struct ChannelContext<SP: Deref> where SP::Target: SignerProvider {
 
 	/// If we remove an HTLC (or fee update), commit, and receive our counterparty's
 	/// `revoke_and_ack`, we remove all knowledge of said HTLC (or fee update). However, the latest
-	/// local commitment transaction that we can broadcast still contains the HTLC (or old fee),
-	/// thus we are not eligible for initiating the `closing_signed` negotiation if we're shutting
-	/// down and are generally expecting a counterparty `commitment_signed` immediately.
+	/// local commitment transaction that we can broadcast still contains the HTLC (or old fee)
+	/// until we receive a further `commitment_signed`. Thus we are not eligible for initiating the
+	/// `closing_signed` negotiation if we're expecting a counterparty `commitment_signed`.
 	///
 	/// To ensure we don't send a `closing_signed` too early, we track this state here, waiting
 	/// until we see a `commitment_signed` before doing so.