Just a few comments

OpenSim/Framework/Communications/Capabilities/Caps.cs

@@ -266,8 +266,7 @@ namespace OpenSim.Region.Capabilities
         #endregion
 
         /// <summary>
-        /// Callback for a client request for an upload url for a script task 
-        /// inventory update
+        /// Called by the script task update handler.  Provides a URL to which the client can upload a new asset.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="path"></param>
@@ -320,8 +319,7 @@ namespace OpenSim.Region.Capabilities
         }
 
         /// <summary>
-        /// Callback for a client request for an upload url for a notecard (or script) 
-        /// agent inventory update
+        /// Called by the notecard update handler.  Provides a URL to which the client can upload a new asset.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="path"></param>

OpenSim/Region/Environment/Scenes/Scene.cs

@@ -94,7 +94,11 @@ namespace OpenSim.Region.Environment.Scenes
         protected SceneCommunicationService m_sceneGridService;
         protected SceneXmlLoader m_sceneXmlLoader;
 
+        /// <summary>
+        /// Each agent has its own capabilities handler.
+        /// </summary>
         protected Dictionary<LLUUID, Caps> m_capsHandlers = new Dictionary<LLUUID, Caps>();
+        
         protected BaseHttpServer m_httpListener;
 
         protected Dictionary<string, IRegionModule> Modules = new Dictionary<string, IRegionModule>();
@@ -614,7 +618,7 @@ namespace OpenSim.Region.Environment.Scenes
         }
 
         /// <summary>
-        /// Start the timer which triggers regular scene updates
+        /// 
         /// </summary>
         public void StartTimer()
         {