f rewrite confusing docs

Author: TheBlueMatt

lightning/src/ln/channelmanager.rs

@@ -3942,9 +3942,8 @@ where
 	///
 	/// This method is guaranteed to ensure the payment has been claimed but only if the current
 	/// height is strictly below [`Event::PaymentClaimable::claim_deadline`]. To avoid race
-	/// conditions, you should wait for an [`Event::PaymentClaimed`] event which upon a
-	/// successful claim will be provided to your [`EventHandler`] when
-	/// [`process_pending_events`] is next called.
+	/// conditions, you should wait for an [`Event::PaymentClaimed`] before considering the payment
+	/// successful. It will generally be available in the next [`process_pending_events`] call.
 	///
 	/// Note that if you did not set an `amount_msat` when calling [`create_inbound_payment`] or
 	/// [`create_inbound_payment_for_hash`] you must check that the amount in the `PaymentClaimable`