From c9a983a85e5abf111eeda5fcb169489785294f1d Mon Sep 17 00:00:00 2001
From: Justin Clarke Casey <jjustincc@googlemail.com>
Date: Sat, 14 Jun 2008 20:52:42 +0000
Subject: [PATCH] * minor: A few miscellaneous doc comments before I break and
 start on something else

---
 OpenSim/Framework/Statistics/SimExtraStatsCollector.cs | 2 ++
 OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs   | 2 +-
 OpenSim/Region/Communications/OGS1/OGS1GridServices.cs | 4 ++--
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/OpenSim/Framework/Statistics/SimExtraStatsCollector.cs b/OpenSim/Framework/Statistics/SimExtraStatsCollector.cs
index 968ed3f818..d4d1f9d1d4 100644
--- a/OpenSim/Framework/Statistics/SimExtraStatsCollector.cs
+++ b/OpenSim/Framework/Statistics/SimExtraStatsCollector.cs
@@ -149,6 +149,8 @@ namespace OpenSim.Framework.Statistics
         {
             lock (packetQueueStatsCollectors)
             {
+                // FIXME: If the region service is providing more than one region, then the child and root agent
+                // queues are wrongly replacing each other here.
                 packetQueueStatsCollectors[uuid] = new PacketQueueStatsCollector(provider);
             }
         }
diff --git a/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs b/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
index 0b2aa52f47..ea2831ca96 100644
--- a/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
+++ b/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
@@ -1139,7 +1139,7 @@ namespace OpenSim.Region.ClientStack.LindenUDP
         }
 
         /// <summary>
-        ///
+        /// Tell the client that the given neighbour region is ready to receive a child agent. 
         /// </summary>
         /// <param name="neighbourHandle"></param>
         /// <param name="neighbourIP"></param>
diff --git a/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs b/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs
index cbb99dc360..bbb31635da 100644
--- a/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs
+++ b/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs
@@ -642,7 +642,7 @@ namespace OpenSim.Region.Communications.OGS1
         #region m_interRegion Comms
 
         /// <summary>
-        ///
+        /// Start listening for .net remoting calls from other regions.
         /// </summary>
         private void StartRemoting()
         {
@@ -789,7 +789,7 @@ namespace OpenSim.Region.Communications.OGS1
         }
 
         /// <summary>
-        ///
+        /// Inform a region that a child agent will be on the way from a client.
         /// </summary>
         /// <param name="regionHandle"></param>
         /// <param name="agentData"></param>