Added better NDoc documentation

git-svn-id: https://svn.apache.org/repos/asf/incubator/activemq/trunk@427051 13f79535-47bb-0310-9956-ffa450edef68

activemq-dotnet/src/main/csharp/NMS/IConnection.cs

@@ -16,6 +16,9 @@
  */
 namespace NMS
 {
+	/// <summary>
+	/// The mode used to acknowledge messages after they are consumed
+	/// </summary>
 	public enum AcknowledgementMode
     {
 		/**

activemq-dotnet/src/main/csharp/NMS/IDestination.cs

@@ -16,6 +16,9 @@
  */
 namespace NMS
 {
+	/// <summary>
+	/// Represents the type of the destination such as a queue or topic.
+	/// </summary>
 	public enum DestinationType
 	{
 		Queue,
@@ -26,7 +29,7 @@ namespace NMS
 	
 	
 	/// <summary>
-	/// Summary description for Destination.
+	/// A base interface for destinations such as queues or topics
 	/// </summary>
 	public interface IDestination
 	{

activemq-dotnet/src/main/csharp/NMS/IQueue.cs

@@ -17,7 +17,8 @@
 namespace NMS
 {
 	/// <summary>
-	/// Summary description for IQueue.
+	/// Represents a queue in a message broker. A message sent to a queue is delivered
+        /// to at most one consumer on the queue.
 	/// </summary>
 	public interface IQueue : IDestination
 	{

activemq-dotnet/src/main/csharp/NMS/IStartable.cs

@@ -17,7 +17,7 @@
 namespace NMS
 {
 	/// <summary>
-	/// Implemented by NMS objects that can be started.
+	/// A lifecycle for NMS objects to indicate they can be started
 	/// </summary>
 	public interface IStartable
     {

activemq-dotnet/src/main/csharp/NMS/IStoppable.cs

@@ -17,7 +17,7 @@
 namespace NMS
 {
 	/// <summary>
-	/// Implemented by NMS objects that can be started.
+	/// A lifecycle for NMS objects to indicate they can be stopped
 	/// </summary>
 	public interface IStoppable
 	{

activemq-dotnet/src/main/csharp/NMS/ITemporaryQueue.cs

@@ -17,7 +17,8 @@
 namespace NMS
 {
 	/// <summary>
-	/// Summary description for ITemporaryQueue.
+	/// Represents a temporary queue which exists for the duration 
+        /// of the IConnection which created it.
 	/// </summary>
 	public interface ITemporaryQueue : IDestination
 	{

activemq-dotnet/src/main/csharp/NMS/ITemporaryTopic.cs

@@ -17,7 +17,8 @@
 namespace NMS
 {
 	/// <summary>
-	/// Summary description for TemporaryTopic.
+	/// Represents a temporary topic which exists for the duration 
+        /// of the IConnection which created it.
 	/// </summary>
 	public interface ITemporaryTopic : IDestination
 	{

activemq-dotnet/src/main/csharp/NMS/ITopic.cs

@@ -17,7 +17,8 @@
 namespace NMS
 {
 	/// <summary>
-	/// Summary description for ITopic.
+	/// Represents a topic in a message broker. A message sent to a topic
+        /// is delivered to all consumers on the topic who are interested in the message.
 	/// </summary>
 	public interface ITopic : IDestination
 	{