Update SP.PhysicsCollisionUpdate() doc.

It might be inefficient, but there are collisions every frame if the avatar is walking/standing on the ground or a prim surface

1 files changed, 5 insertions, 2 deletions

diff --git a/OpenSim/Region/Framework/Scenes/ScenePresence.cs b/OpenSim/Region/Framework/Scenes/ScenePresence.cs
index 1fe8048..5b9438b 100644
--- a/OpenSim/Region/Framework/Scenes/ScenePresence.cs
+++ b/OpenSim/Region/Framework/Scenes/ScenePresence.cs
@@ -3283,8 +3283,11 @@ namespace OpenSim.Region.Framework.Scenes
         /// Event called by the physics plugin to tell the avatar about a collision.
         /// </summary>
         /// <remarks>
-        /// This function is called continuously, even when there are no collisions which might be very inefficient.
-        /// However, we can't avoid this yet since some of this method might currently rely on being called every frame.
+        /// This function is called continuously, even when there are no collisions.  If the avatar is walking on the
+        /// ground or a prim then there will be collision information between the avatar and the surface.
+        ///
+        /// FIXME: However, we can't safely avoid calling this yet where there are no collisions without analyzing whether
+        /// any part of this method is relying on an every-frame call.
         /// </remarks>
         /// <param name="e"></param>
         public void PhysicsCollisionUpdate(EventArgs e)