f improve external docs on ClaimableBalance

Author: TheBlueMatt

lightning/src/chain/channelmonitor.rs

@@ -525,12 +525,15 @@ impl_writeable_tlv_based_enum_upgradable!(ChannelMonitorUpdateStep,
 	},
 );
 
-/// Details about the balance available for claim once the channel appears on chain.
+/// Details about the balance(s) available for spending once the channel appears on chain.
+///
+/// See [`ChannelMonitor::get_claimable_balances`] for more details on when these will or will not
+/// be provided.
 #[derive(Clone, Debug, PartialEq, Eq)]
 #[cfg_attr(test, derive(PartialOrd, Ord))]
 pub enum ClaimableBalance {
-	/// The channel is not yet closed (or the initial commitment or closing transaction has not yet
-	/// been confirmed). The given balance is claimable (less on-chain fees) if the channel is
+	/// The channel is not yet closed (or the commitment or closing transaction has not yet
+	/// appeared in a block). The given balance is claimable (less on-chain fees) if the channel is
 	/// force-closed now.
 	ClaimableOnChannelClose {
 		/// The amount available to claim, in satoshis, ignoring the on-chain fees which will be