Lots of XML comments added; documentation rebuilt

Lidgren.Network/Lidgren.Network.csproj

@@ -54,6 +54,7 @@
     <Reference Include="System.Xml" />
   </ItemGroup>
   <ItemGroup>
+    <Compile Include="NamespaceDoc.cs" />
     <Compile Include="NetBitVector.cs" />
     <Compile Include="NetBitWriter.cs" />
     <Compile Include="NetClient.cs" />

Lidgren.Network/NetBitVector.cs

@@ -151,6 +151,9 @@ namespace Lidgren.Network
 			m_numBitsSet = 0;
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			StringBuilder bdr = new StringBuilder(m_capacity + 2);

Lidgren.Network/NetClient.cs

@@ -114,6 +114,9 @@ namespace Lidgren.Network
 			return serverConnection.SendMessage(msg, method, sequenceChannel);
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			return "[NetClient " + ServerConnection + "]";

Lidgren.Network/NetConnection.Handshake.cs

@@ -343,6 +343,10 @@ namespace Lidgren.Network
 			return true;
 		}
 		
+		/// <summary>
+		/// Disconnect from the remote peer
+		/// </summary>
+		/// <param name="byeMessage">the message to send with the disconnect message</param>
 		public void Disconnect(string byeMessage)
 		{
 			// user or library thread

Lidgren.Network/NetConnection.cs

@@ -416,6 +416,9 @@ namespace Lidgren.Network
 			ExecuteDisconnect(reason, true);
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			return "[NetConnection to " + m_remoteEndpoint + "]";

Lidgren.Network/NetConnectionStatistics.cs

@@ -106,6 +106,9 @@ namespace Lidgren.Network
 			m_resentMessages++;
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			StringBuilder bdr = new StringBuilder();

Lidgren.Network/NetEncryption.cs

@@ -23,6 +23,9 @@ using System.Security;
 
 namespace Lidgren.Network
 {
+	/// <summary>
+	/// Methods to encrypt and decrypt data using the XTEA algorith
+	/// </summary>
 	public sealed class NetXtea
 	{
 		private const int m_blockSize = 8;

Lidgren.Network/NetIncomingMessage.cs

@@ -111,6 +111,9 @@ namespace Lidgren.Network
 			m_data = result;
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			return "[NetIncomingMessage #" + m_sequenceNumber + " " + this.LengthBytes + " bytes]";

Lidgren.Network/NetOutgoingMessage.cs

@@ -41,7 +41,7 @@ namespace Lidgren.Network
 		{
 		}
 
-		public void Reset()
+		internal void Reset()
 		{
 			m_messageType = NetMessageType.LibraryError;
 			m_bitLength = 0;
@@ -114,6 +114,9 @@ namespace Lidgren.Network
 			return retval;
 		}
 
+		/// <summary>
+		/// Encrypt this message using the XTEA algorithm; no more writing can be done before sending it
+		/// </summary>
 		public void Encrypt(NetXtea tea)
 		{
 			// need blocks of 8 bytes
@@ -130,6 +133,9 @@ namespace Lidgren.Network
 			m_data = result;
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			return "[NetOutgoingMessage " + m_messageType + " " + this.LengthBytes + " bytes]";

Lidgren.Network/NetPeerStatistics.cs

@@ -117,6 +117,9 @@ namespace Lidgren.Network
 			m_receivedMessages += numMessages;
 		}
 
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
 		public override string ToString()
 		{
 			StringBuilder bdr = new StringBuilder();

Lidgren.Network/NetPeerStatus.cs

@@ -26,9 +26,24 @@ namespace Lidgren.Network
 	/// </summary>
 	public enum NetPeerStatus
 	{
+		/// <summary>
+		/// NetPeer is not running; socket is not bound
+		/// </summary>
 		NotRunning = 0,
+
+		/// <summary>
+		/// NetPeer is in the process of starting up
+		/// </summary>
 		Starting = 1,
+
+		/// <summary>
+		/// NetPeer is bound to socket and listening for packets
+		/// </summary>
 		Running = 2,
+
+		/// <summary>
+		/// Shutdown has been requested and will be executed shortly
+		/// </summary>
 		ShutdownRequested = 3,
 	}
 }

Lidgren.Network/NetQueue.cs

@@ -23,7 +23,7 @@ using System.Diagnostics;
 namespace Lidgren.Network
 {
 	/// <summary>
-	/// Thread safe (blocking) queue with TryDequeue() and EnqueueFirst()
+	/// Thread safe (blocking) expanding queue with TryDequeue() and EnqueueFirst()
 	/// </summary>
 	[DebuggerDisplay("Count={Count} Capacity={Capacity}")]
 	public sealed class NetQueue<T>
@@ -47,18 +47,22 @@ namespace Lidgren.Network
 		private int m_size;
 		private int m_head;
 
+		/// <summary>
+		/// Gets the number of items in the queue
+		/// </summary>
 		public int Count { get { return m_size; } }
 
 		public int Capacity { get { return m_items.Length; } }
 
 		public NetQueue(int initialCapacity)
 		{
+			System.Collections.Generic.Queue<int> a;
 			m_lock = new object();
 			m_items = new T[initialCapacity];
 		}
 
 		/// <summary>
-		/// Places an item last/tail of the queue
+		/// Adds an item last/tail of the queue
 		/// </summary>
 		public void Enqueue(T item)
 		{
@@ -163,6 +167,9 @@ namespace Lidgren.Network
 			}
 		}
 
+		/// <summary>
+		/// Determines whether an item is in the queue
+		/// </summary>
 		public bool Contains(T item)
 		{
 			lock (m_lock)
@@ -186,6 +193,9 @@ namespace Lidgren.Network
 			return false;
 		}
 
+		/// <summary>
+		/// Copies the queue items to a new array
+		/// </summary>
 		public T[] ToArray()
 		{
 			lock (m_lock)
@@ -202,6 +212,9 @@ namespace Lidgren.Network
 			}
 		}
 
+		/// <summary>
+		/// Removes all objects from the queue
+		/// </summary>
 		public void Clear()
 		{
 			lock (m_lock)

Lidgren.Network/NetServer.cs

@@ -12,5 +12,13 @@ namespace Lidgren.Network
 		{
 			config.AcceptIncomingConnections = true;
 		}
+
+		/// <summary>
+		/// Returns a string that represents this object
+		/// </summary>
+		public override string ToString()
+		{
+			return "[NetServer " + ConnectionsCount + " connections]";
+		}
 	}
 }

Lidgren.Network/NetTime.cs

@@ -46,6 +46,9 @@ namespace Lidgren.Network
 		public static double Now { get { return (double)Environment.TickCount / 1000.0; } }
 #endif
 
+		/// <summary>
+		/// Given seconds it will output a human friendly readable string (milliseconds if less than 60 seconds)
+		/// </summary>
 		public static string ToReadable(double seconds)
 		{
 			if (seconds > 60)