f - clean-up docs

Author: jkczyz

lightning/src/ln/chan_utils.rs

@@ -121,8 +121,13 @@ const MULTISIG_SCRIPT_SIZE: u64 = 1 + // OP_2
 	bitcoin::secp256k1::constants::PUBLIC_KEY_SIZE as u64 + // pubkey2
 	1 + // OP_2
 	1; // OP_CHECKMULTISIG
-/// The weight of a funding transaction input (2-of-2 P2WSH)
-/// See https://github.com/lightning/bolts/blob/master/03-transactions.md#expected-weight-of-the-commitment-transaction
+
+/// The weight of a funding transaction input (2-of-2 P2WSH).
+///
+/// Unlike in the [spec], 72 WU is used for the max signature size since 73 WU signatures are
+/// non-standard.
+///
+/// [spec]: https://github.com/lightning/bolts/blob/master/03-transactions.md#expected-weight-of-the-commitment-transaction
 pub const FUNDING_TRANSACTION_WITNESS_WEIGHT: u64 = 1 + // number_of_witness_elements
 	1 + // nil_len
 	1 + // sig len