f update comment to note both usages

Author: TheBlueMatt

lightning/src/chain/package.rs

@@ -736,10 +736,13 @@ pub struct PackageTemplate {
 	// Untractable packages have been counter-signed and thus imply that we can't aggregate
 	// them without breaking signatures. Fee-bumping strategy will also rely on CPFP.
 	malleability: PackageMalleability,
-	// Block height at which our counterparty can potentially claim this output as well (assuming
-	// they have the keys or information required to do so).
-	// For HTLCs we're claiming with a preimage and revoked outputs, we need to get our spend
-	// on-chain before this height.
+	/// Block height at which our counterparty can potentially claim this output as well (assuming
+	/// they have the keys or information required to do so).
+	///
+	/// This is used primarily by external consumers to decide when an output becomes "pinnable"
+	/// because the counterparty can potentially spend it. It is also used internally by
+	/// [`Self::get_height_timer`] to identify when an output must be claimed by, depending on the
+	/// type of output.
 	counterparty_spendable_height: u32,
 	// Determines if this package can be aggregated.
 	// Timelocked outputs belonging to the same transaction might have differing