From 7c7f2316faa36fbdd6044ae27e05823e317d167f Mon Sep 17 00:00:00 2001
From: Tommaso Stocchi <tommasostocchi@outlook.com>
Date: Tue, 15 Dec 2020 21:06:47 +0100
Subject: [PATCH] Added comments

---
 .../HttpServer/Security/AuthorizationContext.cs            | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/Emby.Server.Implementations/HttpServer/Security/AuthorizationContext.cs b/Emby.Server.Implementations/HttpServer/Security/AuthorizationContext.cs
index 74a678aa62..855c616826 100644
--- a/Emby.Server.Implementations/HttpServer/Security/AuthorizationContext.cs
+++ b/Emby.Server.Implementations/HttpServer/Security/AuthorizationContext.cs
@@ -285,6 +285,11 @@ namespace Emby.Server.Implementations.HttpServer.Security
             return string.IsNullOrEmpty(value) ? value : WebUtility.UrlDecode(value);
         }
 
+        /// <summary>
+        /// Get the authorization header components.
+        /// </summary>
+        /// <param name="authtorizationHeader">The authorization header.</param>
+        /// <returns>string</returns>
         public static string[] GetParts(string authtorizationHeader)
         {
             var result = new List<string>();
@@ -301,6 +306,7 @@ namespace Emby.Server.Implementations.HttpServer.Security
                 }
                 else
                 {
+                    // Applying a XOR logic to evaluate wether it is opening or closing a value
                     escaped = (!escaped) == (authtorizationHeaderChars[i] == '"');
                     if(authtorizationHeaderChars[i] == ',')
                     {
@@ -310,6 +316,7 @@ namespace Emby.Server.Implementations.HttpServer.Security
                         }
                         else
                         {
+                            // Meeting a comma after a closing escape char means the value is complete
                             result.Add(new string(value.ToArray()));
                             value = new List<char>();
                         }