Merge pull request #1842 from jkczyz/2022-11-channel-monitor-docs

Fix outdated `ChannelMonitor` docs

Author: TheBlueMatt

lightning/src/chain/channelmonitor.rs

@@ -1305,9 +1305,11 @@ impl<Signer: Sign> ChannelMonitor<Signer> {
 	/// Gets the list of pending events which were generated by previous actions, clearing the list
 	/// in the process.
 	///
-	/// This is called by ChainMonitor::get_and_clear_pending_events() and is equivalent to
-	/// EventsProvider::get_and_clear_pending_events() except that it requires &mut self as we do
-	/// no internal locking in ChannelMonitors.
+	/// This is called by the [`EventsProvider::process_pending_events`] implementation for
+	/// [`ChainMonitor`].
+	///
+	/// [`EventsProvider::process_pending_events`]: crate::util::events::EventsProvider::process_pending_events
+	/// [`ChainMonitor`]: crate::chain::chainmonitor::ChainMonitor
 	pub fn get_and_clear_pending_events(&self) -> Vec<Event> {
 		self.inner.lock().unwrap().get_and_clear_pending_events()
 	}