-f Add more comments

Author: Antoine Riard

lightning/src/ln/channelmanager.rs

@@ -2825,6 +2825,9 @@ impl<Signer: Sign, M: Deref, T: Deref, K: Deref, F: Deref, L: Deref> ChannelMana
 				log_bytes!(chan_id[..]), chan.get_feerate(), new_feerate);
 			return (true, NotifyOption::SkipPersist, Ok(()));
 		}
+		// If the channel is inbound and we detect a relevant feerate increase, we assume
+		// that our counterparty, reasonably implemented, should send us an `update_fee`
+		// soon. Monitoring this situation, we start an autoclose timer.
 		if !chan.is_outbound() {
 			if chan.maybe_trigger_autoclose_timer() {
 				return (true, NotifyOption::DoPersist, Ok(()));
@@ -2876,6 +2879,7 @@ impl<Signer: Sign, M: Deref, T: Deref, K: Deref, F: Deref, L: Deref> ChannelMana
 		(retain_channel, NotifyOption::DoPersist, ret_err)
 	}
 
+	/// Close the channel if the feerate is non-satisfying to ensure efficient confirmation
 	fn check_channel_autoclose(&self, short_to_id: &mut HashMap<u64, [u8; 32]>, chan_id: &[u8; 32], chan: &mut Channel<Signer>) -> (bool, NotifyOption, Result<(), MsgHandleErrInternal>) {
 		let mut retain_channel = true;
 		let mut notify_option = NotifyOption::SkipPersist;