- /// The preimage to the payment hash. If provided, this can be handed directly to
- /// [`ChannelManager::claim_funds`].
+ /// The preimage to the payment hash. When handling [`Event::PaymentClaimable`], this can be
+ /// passed directly to [`ChannelManager::claim_funds`], if provided. No action is needed
+ /// when seen in [`Event::PaymentClaimed`].