f - Reword docs

Author: jkczyz

lightning-invoice/src/payment.rs

@@ -17,7 +17,8 @@
 //! [`InvoicePayer`] caches each [`Invoice`] by its `payment_hash` so that it can retry the payment
 //! if it fails. It accomplishes this by implementing [`EventHandler`] which decorates a
 //! user-provided handler. It will intercept any [`Event::PaymentPathFailed`] events and retry the
-//! payment a fixed number of times before failing or succeeding as appropriate.
+//! failed paths for a fixed number of total attempts or until retry is no longer possible. In such
+//! a situation, [`InvoicePayer`] will pass along the events to the user-provided handler.
 //!
 //! # Example
 //!
@@ -243,8 +244,8 @@ where
 
 	/// Removes the [`Invoice`] cached by the given payment hash.
 	///
-	/// Should be called once a payment has failed or succeeded. This is taken care of when
-	/// [`InvoicePayer`] is used as an [`EventHandler`] but can be called independently as well.
+	/// Should be called once a payment has failed or succeeded if not using [`InvoicePayer`] as an
+	/// [`EventHandler`]. Otherwise, calling this method is unnecessary.
 	pub fn remove_cached_invoice(&self, payment_hash: &PaymentHash) {
 		self.invoice_cache.lock().unwrap().remove(payment_hash);
 	}