f clarifications

Author: TheBlueMatt

lightning/src/chain/channelmonitor.rs

@@ -147,8 +147,7 @@ pub enum ChannelMonitorUpdateErr {
 	/// [`ChannelManager::channel_monitor_updated`]: crate::ln::channelmanager::ChannelManager::channel_monitor_updated
 	TemporaryFailure,
 	/// Used to indicate no further channel monitor updates will be allowed (likely a disk failure
-	/// or, e.g. we've moved on to a different watchtower and cannot update with all watchtowers
-	/// that were previously informed of this channel).
+	/// or a remote copy of this [`ChannelMonitor`] is no longer reachable and thus not updatable).
 	///
 	/// When this is returned, [`ChannelManager`] will force-close the channel but *not* broadcast
 	/// our current commitment transaction. This avoids a dangerous case where a local disk failure
@@ -164,8 +163,9 @@ pub enum ChannelMonitorUpdateErr {
 	/// we do as long as blocks are connected).
 	///
 	/// In order to broadcast the latest local commitment transaction, you'll need to call
-	/// [`ChannelMonitor::get_latest_holder_commitment_txn`] once you've safely ensured no further
-	/// off-chain updates to the channel can occur.
+	/// [`ChannelMonitor::get_latest_holder_commitment_txn`] and broadcast the resulting
+	/// transactions once you've safely ensured no further channel updates can be generated by your
+	/// [`ChannelManager`].
 	///
 	/// Note that at least one final [`ChannelMonitorUpdate`] may still be provided, which must
 	/// still be processed by a running [`ChannelMonitor`]. This final update will mark the