Documented buffers

src/dotnet/src/Mil.Navy.Nrl.Norm/Buffers/ByteBuffer.cs

@@ -2,12 +2,23 @@
 
 namespace Mil.Navy.Nrl.Norm.Buffers 
 {
+    /// <summary>
+    /// A byte buffer
+    /// </summary>
     public abstract class ByteBuffer : SafeBuffer
     {
+        /// <summary>
+        /// Creates a new buffer
+        /// </summary>
         protected ByteBuffer() : base(true)
         {       
         }
 
+        /// <summary>
+        /// Allocates a new direct byte buffer
+        /// </summary>
+        /// <param name="capacity">The new buffer's capacity, in bytes</param>
+        /// <returns>The new byte buffer</returns>
         public static ByteBuffer AllocateDirect(int capacity) {
             return new DirectByteBuffer(capacity);
         }

src/dotnet/src/Mil.Navy.Nrl.Norm/Buffers/DirectByteBuffer.cs

@@ -2,14 +2,25 @@
 
 namespace Mil.Navy.Nrl.Norm.Buffers 
 {
+    /// <summary>
+    /// A direct byte buffer
+    /// </summary>
     internal sealed class DirectByteBuffer : ByteBuffer
     {
+        /// <summary>
+        /// Creates a new direct byte buffer with given capacity
+        /// </summary>
+        /// <param name="capacity">The new buffer's capacity, in bytes</param>
         internal DirectByteBuffer(int capacity)
         {
             SetHandle(Marshal.AllocHGlobal(capacity));
             Initialize(Convert.ToUInt64(capacity));
         }
 
+        /// <summary>
+        /// Executes the code required to free the handle
+        /// </summary>
+        /// <returns>true if the handle is released successfully; otherwise, in the event of a catastrophic failure, false</returns>
         protected override bool ReleaseHandle()
         {
             Marshal.FreeHGlobal(handle);