doc(bdk): Clarify the absolute_fee docs

Fixes #1066

diff --git a/src/wallet/tx_builder.rs b/src/wallet/tx_builder.rs
index 16488ac2adadee75b08495a6a480eb99e23df933..9ce101217844ca1fd5c27c87070c00d1f8457d80 100644 (file)
--- a/src/wallet/tx_builder.rs
+++ b/src/wallet/tx_builder.rs
@@ -189,6 +189,16 @@ impl<'a, D: BatchDatabase, Cs: CoinSelectionAlgorithm<D>, Ctx: TxBuilderContext>
     }
 
     /// Set an absolute fee
+    ///
+    /// The fee_absolute method refers to the absolute transaction fee in satoshis (sats).
+    ///
+    /// If anyone sets both the [`fee_absolute`](TxBuilder::fee_absolute) method
+    /// and the [`fee_rate`](TxBuilder::fee_rate) method, the fee policy will
+    /// be set by whichever method was called last, as the two are mutually exclusive.
+    ///
+    /// Note that this is really a minimum absolute fee -- it's possible to
+    /// overshoot it slightly since adding a change output to drain the remaining
+    /// excess might not be viable.
     pub fn fee_absolute(&mut self, fee_amount: u64) -> &mut Self {
         self.params.fee_policy = Some(FeePolicy::FeeAmount(fee_amount));
         self