Index: src/Common/SharpMap.UI/Forms/IMapControl.cs
===================================================================
diff -u -r8f6ae890fed8e8eae3a32f9c0498a10f82e0ddf9 -r685868ff25d1872c06c286a66dff024a1476dd31
--- src/Common/SharpMap.UI/Forms/IMapControl.cs	(.../IMapControl.cs)	(revision 8f6ae890fed8e8eae3a32f9c0498a10f82e0ddf9)
+++ src/Common/SharpMap.UI/Forms/IMapControl.cs	(.../IMapControl.cs)	(revision 685868ff25d1872c06c286a66dff024a1476dd31)
@@ -20,7 +20,13 @@
         SelectTool SelectTool { get; }
         
         SnapTool SnapTool { get; }
-        
+
+        /// <summary>
+        /// Gets the name of the tool by.
+        /// </summary>
+        /// <param name="toolName">Name of the tool.</param>
+        /// <returns>An instance of IMapTool matching the given name, or null if no match was found.</returns>
+        /// <remarks>Do not throw ArgumentOutOfRangeException UI handlers (button checked) can ask for not existing tool</remarks>
         IMapTool GetToolByName(string toolName);
 
         T GetToolByType<T>() where T : class;