f - Document lock reentrancy

Author: jkczyz

lightning/src/util/events.rs

@@ -381,7 +381,12 @@ pub trait MessageSendEventsProvider {
 	fn get_and_clear_pending_msg_events(&self) -> Vec<MessageSendEvent>;
 }
 
-/// A trait indicating an object may generate events
+/// A trait indicating an object may generate events.
+///
+/// Events are processed by a handler given to [`process_pending_events`]. Therefore, implementors
+/// should be mindful to avoid lock reentrancy if a handler may call back into the provider.
+///
+/// [`process_pending_events`]: Self::process_pending_events
 pub trait EventsProvider {
 	/// Processes any generated events with the given event handler.
 	fn process_pending_events<H: Deref>(&self, handler: H) where H::Target: EventHandler;