LIBOMV-686 Implements new event patterns based on the Microsoft Framework Design Guidelines in DirectoryManager

* Completes Full documentation of DirectoryManager class
* Cleaned up Search Methods in DirectoryManager to be more developer friendly
* Adds Several TestClient commands related to DirectoryManager: searchgroups, searchland, searchpeople
* Adds a StructToString method to helpers to simplify parsing and printing Structs for debugging purposes
* Many other code cleanups
* BREAKING - this is a major shift in the way events are internally handled, Take a look at the newly added TestClient commands for example code that implement this pattern.

git-svn-id: http://libopenmetaverse.googlecode.com/svn/libopenmetaverse/trunk@3139 52acb1d6-8a22-11de-b505-999d5b087335

Programs/examples/TestClient/Commands/Directory/SearchPeopleCommand.cs

@@ -0,0 +1,69 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace OpenMetaverse.TestClient.Commands
+{
+    class SearchPeopleCommand : Command
+    {
+        System.Threading.AutoResetEvent waitQuery = new System.Threading.AutoResetEvent(false);
+        int resultCount = 0;
+
+        public SearchPeopleCommand(TestClient testClient)
+        {
+            Name = "searchpeople";
+            Description = "Searches for other avatars. Usage: searchpeople [search text]";
+            Category = CommandCategory.Friends;
+        }
+
+        public override string Execute(string[] args, UUID fromAgentID)
+        {
+            // process command line arguments
+            if (args.Length < 1)
+                return "Usage: searchpeople [search text]";
+
+            string searchText = string.Empty;
+            for (int i = 0; i < args.Length; i++)
+                searchText += args[i] + " ";
+            searchText = searchText.TrimEnd();
+
+            waitQuery.Reset();
+
+            
+            Client.Directory.DirPeopleReply += Directory_DirPeople;
+
+            // send the request to the directory manager
+            Client.Directory.StartPeopleSearch(searchText, 0);
+            
+            string result;
+            if (waitQuery.WaitOne(20000, false) && Client.Network.Connected)
+            {
+                result = "Your query '" + searchText + "' matched " + resultCount + " People. ";
+            }
+            else
+            {
+                result = "Timeout waiting for simulator to respond.";
+            }
+
+            Client.Directory.DirPeopleReply -= Directory_DirPeople;
+
+            return result;
+        }
+
+        void Directory_DirPeople(object sender, DirPeopleReplyEventArgs e)
+        {
+            if (e.MatchedPeople.Count > 0)
+            {
+                foreach (DirectoryManager.AgentSearchData agent in e.MatchedPeople)
+                {
+                    Console.WriteLine("{0} {1} ({2})", agent.FirstName, agent.LastName, agent.AgentID);                   
+                }
+            }
+            else
+            {
+                Console.WriteLine("Didn't find any people that matched your query :(");
+            }
+            waitQuery.Set();
+        }
+    }
+}