Update comments

Include/RmlUi/Core/EventListenerInstancer.h

@@ -51,8 +51,12 @@ public:
 	virtual ~EventListenerInstancer();
 
 	/// Instance an event listener object.
-	/// @param value Value of the event.
-	/// @param element Element that triggers the events.
+	/// @param value Value of the inline event.
+	/// @param element Element that triggers this call to the instancer.
+	/// @return An event listener which will be attached to the element.
+	/// @lifetime The returned event listener must be kept alive until the call to `EventListener::OnDetach` on the
+	///           returned listener, and then cleaned up by the user. The detach function is called when the listener
+	///           is detached manually, or automatically when the element is destroyed.
 	virtual EventListener* InstanceEventListener(const String& value, Element* element) = 0;
 };
 

Include/RmlUi/Core/Factory.h

@@ -167,7 +167,7 @@ public:
 	/// @return The instanced event.
 	static EventPtr InstanceEvent(Element* target, EventId id, const String& type, const Dictionary& parameters, bool interruptible);
 
-	/// Register the instancer to be used for all event listeners.
+	/// Register the instancer to be used for all event listeners, or nullptr to clear an existing instancer.
 	/// @lifetime The instancer must be kept alive until after the call to Rml::Shutdown, or until a new instancer is set.
 	static void RegisterEventListenerInstancer(EventListenerInstancer* instancer);
 	/// Instance an event listener with the given string. This is used for instancing listeners for the on* events from RML.