Merge pull request lightningdevkit#4163 from TheBlueMatt/2025-09-0.2-beta

Add 0.2 changelog (and quick missing spliec doc)

Author: TheBlueMatt

CHANGELOG.md

@@ -1690,6 +1690,9 @@ pub enum Event {
 	/// The offline peer should be awoken if possible on receipt of this event, such as via the LSPS5
 	/// protocol.
 	///
+	/// Once they connect, you should handle the generated [`Event::OnionMessagePeerConnected`] and
+	/// provide the stored message.
+	///
 	/// # Failure Behavior and Persistence
 	/// This event will eventually be replayed after failures-to-handle (i.e., the event handler
 	/// returning `Err(ReplayEvent ())`), but won't be persisted across restarts.
@@ -1701,16 +1704,18 @@ pub enum Event {
 		/// The onion message intended to be forwarded to `peer_node_id`.
 		message: msgs::OnionMessage,
 	},
-	/// Indicates that an onion message supporting peer has come online and it may
-	/// be time to forward any onion messages that were previously intercepted for
-	/// them. This event will only be generated if the `OnionMessenger` was
-	/// initialized with
+	/// Indicates that an onion message supporting peer has come online and any messages previously
+	/// stored for them (from [`Event::OnionMessageIntercepted`]s) should be forwarded to them by
+	/// calling [`OnionMessenger::forward_onion_message`].
+	///
+	/// This event will only be generated if the `OnionMessenger` was initialized with
 	/// [`OnionMessenger::new_with_offline_peer_interception`], see its docs.
 	///
 	/// # Failure Behavior and Persistence
 	/// This event will eventually be replayed after failures-to-handle (i.e., the event handler
 	/// returning `Err(ReplayEvent ())`), but won't be persisted across restarts.
 	///
+	/// [`OnionMessenger::forward_onion_message`]: crate::onion_message::messenger::OnionMessenger::forward_onion_message
 	/// [`OnionMessenger::new_with_offline_peer_interception`]: crate::onion_message::messenger::OnionMessenger::new_with_offline_peer_interception
 	OnionMessagePeerConnected {
 		/// The node id of the peer we just connected to, who advertises support for

lightning/src/events/mod.rs

@@ -4744,6 +4744,9 @@ where
 	/// emitted. At this point, any inputs contributed to the splice can only be re-spent if an
 	/// [`Event::DiscardFunding`] is seen.
 	///
+	/// After initial signatures have been exchanged, [`Event::FundingTransactionReadyForSigning`]
+	/// will be generated and [`ChannelManager::funding_transaction_signed`] should be called.
+	///
 	/// If any failures occur while negotiating the funding transaction, an [`Event::SpliceFailed`]
 	/// will be emitted. Any contributed inputs no longer used will be included here and thus can
 	/// be re-spent.