Documenation clarification in IEventReceiver (thx teto) and ISceneCollisionManager (thx aanderse).

git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/trunk@3008 dfc29bdd-3216-0410-991c-e03cc46cb475

include/IEventReceiver.h

@@ -431,7 +431,11 @@ public:
 	virtual ~IEventReceiver() {}
 
 	//! Called if an event happened.
-	/** \return True if the event was processed. */
+	/** Please take care that you should only return 'true' when you want to _prevent_ Irrlicht
+	* from processing the event any further. So 'true' does mean that an event is completely done.
+	* Therefore your return value for all unprocessed events should be 'false'.
+	\return True if the event was processed.
+	*/
 	virtual bool OnEvent(const SEvent& event) = 0;
 };
 

include/ISceneCollisionManager.h

@@ -25,14 +25,14 @@ namespace scene
 	{
 	public:
 
-		//! Finds the collision point of a line and lots of triangles, if there is one.
+		//! Finds the nearest collision point of a line and lots of triangles, if there is one.
 		/** \param ray: Line with which collisions are tested.
 		\param selector: TriangleSelector containing the triangles. It
 		can be created for example using
 		ISceneManager::createTriangleSelector() or
 		ISceneManager::createTriangleOctTreeSelector().
 		\param outCollisionPoint: If a collision is detected, this will
-		contain the position of the nearest collision.
+		contain the position of the nearest collision to the line-start.
 		\param outTriangle: If a collision is detected, this will
 		contain the triangle with which the ray collided.
 		\param outNode: If a collision is detected, this will contain