Comments and debug functions

crypt/Crypt.cs

@@ -56,6 +56,9 @@ public int GetSize()
         }
     }
 
+    /// <summary>
+    /// provides File encryption and decryption capabilities
+    /// </summary>
     public class Crypt
     {
         [Flags]
@@ -134,6 +137,12 @@ public enum CryptResult : int
         /// </summary>
         public const string HEADER = "ACRYPT";
 
+#if DEBUG
+        /// <summary>
+        /// Creates the Hash of a stream.
+        /// </summary>
+        /// <param name="S">Input stream</param>
+        /// <returns>SHA256</returns>
         public static byte[] Hash(Stream S)
         {
             using (var Hasher = (SHA256)HashAlgorithm.Create(HASHALG))
@@ -142,6 +151,7 @@ public static byte[] Hash(Stream S)
                 return Hash;
             }
         }
+#endif
 
         /// <summary>
         /// Encrypts a file

crypt/Program.cs

@@ -143,6 +143,11 @@ static void Main(string[] args)
 #endif
         }
 
+        /// <summary>
+        /// Reads a password from STDIN and masks it.
+        /// It's incompatible with stream redirection.
+        /// </summary>
+        /// <returns>User supplied password</returns>
         private static string ReadPassword()
         {
 #if DEBUG
@@ -186,6 +191,9 @@ private static string ReadPassword()
 #endif
         }
 
+        /// <summary>
+        /// Prints the help
+        /// </summary>
         private static void ShowHelp()
         {
             Console.Error.WriteLine(@"crypt {/e|/d} <input>