f - Fix ChannelMonitor::update_best_block docs

Author: jkczyz

lightning/src/chain/channelmonitor.rs

@@ -1337,7 +1337,7 @@ impl<Signer: Sign> ChannelMonitor<Signer> {
 	///
 	/// Used instead of [`block_disconnected`] by clients that are notified of transactions rather
 	/// than blocks. May be called before or after [`update_best_block`] for transactions in the
-	/// corresponding block. See [`update_best_block`] for further calling expectations. 
+	/// corresponding block. See [`update_best_block`] for further calling expectations.
 	///
 	/// [`block_disconnected`]: Self::block_disconnected
 	/// [`update_best_block`]: Self::update_best_block
@@ -1364,12 +1364,14 @@ impl<Signer: Sign> ChannelMonitor<Signer> {
 	/// block.
 	///
 	/// Must be called after new blocks become available for the most recent block. Intermediary
-	/// blocks, however, may be safely skipped. For a chain reorganization, this must be called at
-	/// least at the fork point and then again for the most recent block; intermediary blocks may be
-	/// skipped as before.
+	/// blocks, however, may be safely skipped. For a chain reorganization, must either be:
+	/// * called at at the fork point and then again for the most recent block -- intermediary
+	///   blocks may be skipped as before -- or
+	/// * not called in favor of calling [`transaction_unconfirmed`] for any affected transactions.
 	///
 	/// [`block_connected`]: Self::block_connected
 	/// [`transactions_confirmed`]: Self::transactions_confirmed
+	/// [`transaction_unconfirmed`]: Self::transaction_unconfirmed
 	pub fn update_best_block<B: Deref, F: Deref, L: Deref>(
 		&self,
 		header: &BlockHeader,