Minor Route/RouteHop doc updates

Author: valentinewallace

lightning/src/routing/router.rs

@@ -226,8 +226,7 @@ pub struct RouteHop {
 	/// to reach this node.
 	pub channel_features: ChannelFeatures,
 	/// The fee taken on this hop (for paying for the use of the *next* channel in the path).
-	/// For the last hop, this should be the full value of the payment (might be more than
-	/// requested if we had to match htlc_minimum_msat).
+	/// For the last hop, this should be the full value of this path's part of the payment.
 	pub fee_msat: u64,
 	/// The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
 	/// expected at the destination, in excess of the current block height.
@@ -247,8 +246,8 @@ impl_writeable_tlv_based!(RouteHop, {
 /// it can take multiple paths. Each path is composed of one or more hops through the network.
 #[derive(Clone, Hash, PartialEq, Eq)]
 pub struct Route {
-	/// The list of routes taken for a single (potentially-)multi-part payment. The pubkey of the
-	/// last RouteHop in each path must be the same. Each entry represents a list of hops, NOT
+	/// The list of paths taken for a single (potentially-)multi-part payment. The pubkey of the
+	/// last [`RouteHop`] in each path must be the same. Each entry represents a list of hops, NOT
 	/// INCLUDING our own, where the last hop is the destination. Thus, this must always be at
 	/// least length one. While the maximum length of any given path is variable, keeping the length
 	/// of any path less or equal to 19 should currently ensure it is viable.
@@ -283,7 +282,8 @@ impl Route {
 		self.paths.iter().map(|path| path.get_path_fees()).sum()
 	}
 
-	/// Returns the total amount paid on this [`Route`], excluding the fees.
+	/// Returns the total amount paid on this [`Route`], excluding the fees. Might be more than
+	/// requested if we had to reach htlc_minimum_msat.
 	pub fn get_total_amount(&self) -> u64 {
 		return self.paths.iter()
 			.map(|path| path.split_last().map(|(hop, _)| hop.fee_msat).unwrap_or(0))