From 214c222b79ea9ac78fab0d7126085ec3cdc4ecb5 Mon Sep 17 00:00:00 2001
From: QPotato <federicobadaloni@hotmail.com>
Date: Thu, 21 Jul 2022 21:14:54 -0300
Subject: [PATCH] Add documentation on public method

---
 lightning/src/chain/channelmonitor.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lightning/src/chain/channelmonitor.rs b/lightning/src/chain/channelmonitor.rs
index b550d94afce..756ccbe638e 100644
--- a/lightning/src/chain/channelmonitor.rs
+++ b/lightning/src/chain/channelmonitor.rs
@@ -1187,6 +1187,7 @@ impl<Signer: Sign> ChannelMonitor<Signer> {
 			payment_hash, payment_preimage, broadcaster, fee_estimator, logger)
 	}
 
+	// Broadcasts the latest commitment transaction only if it's safe to do so.
 	pub(crate) fn maybe_broadcast_latest_holder_commitment_txn<B: Deref, L: Deref>(
 		&self,
 		broadcaster: &B,
@@ -1198,6 +1199,8 @@ impl<Signer: Sign> ChannelMonitor<Signer> {
 		self.inner.lock().unwrap().maybe_broadcast_latest_holder_commitment_txn(broadcaster, logger)
 	}
 
+	// Broadcasts the latest commitment transaction, even if we can't ensure it's safe to do so
+	// due to missing information.
 	pub fn force_broadcast_latest_holder_commitment_txn_unsafe<B: Deref, L: Deref>(
 		&self,
 		broadcaster: &B,