ICookieManager - Update xml doc

Updated to reflect upstream changes see https://magpcss.org/ceforum/apidocs3/projects/(default)/CefCookieManager.html

Resolves cefsharp#2855

Author: amaitland

CefSharp/ICookieManager.cs

@@ -12,32 +12,32 @@ namespace CefSharp
     public interface ICookieManager : IDisposable
     {
         /// <summary>
-        /// Deletes all cookies that matches all the provided parameters. If both <paramref name="url"/> and <paramref name="name"/> are empty, all cookies will be deleted.
-        /// Cookies can alternately be deleted using the Visit*Cookies() methods. 
-        /// This method will be executed on the CEF UI thread in an async fashion, to be notified upon completion implement <see cref="IDeleteCookiesCallback"/>
-        /// and pass in as <paramref name="callback"/>
+        /// Delete all cookies that match the specified parameters.
+        /// If both <paramref name="url"/> and <paramref name="name"/> values are specified all host and domain cookies matching both will be deleted.
+        /// If only <paramref name="url"/> is specified all host cookies (but not domain cookies) irrespective of path will be deleted.
+        /// If <paramref name="url"/> is empty all cookies for all hosts and domains will be deleted.
+        /// Cookies can alternately be deleted using the Visit*Cookies() methods.
         /// </summary>
-        /// <param name="url">The cookie URL. If an empty string is provided, any URL will be matched.</param>
-        /// <param name="name">The name of the cookie. If an empty string is provided, any URL will be matched.</param>
+        /// <param name="url">The cookie URL.</param>
+        /// <param name="name">The name of the cookie.</param>
         /// <param name="callback">If non-NULL it will be executed asnychronously on the CEF UI thread after the cookies have been deleted.</param>
-        /// <returns>Returns false if a non-empty invalid URL is specified, or if cookies cannot be accessed; otherwise, true.</returns>
+        /// <returns>Returns false if a non-empty invalid URL is specified or if cookies cannot be accessed; otherwise, true.</returns>
         bool DeleteCookies(string url = null, string name = null, IDeleteCookiesCallback callback = null);
 
         /// <summary>
         /// Sets a cookie given a valid URL and explicit user-provided cookie attributes. This function expects each attribute to be well-formed. It will check for disallowed
-        /// characters (e.g. the ';' character is disallowed within the cookie value attribute) and will return false without setting
-        /// the cookie if such characters are found.
+        /// characters (e.g. the ';' character is disallowed within the cookie value attribute) and fail without setting the cookie if such characters are found.
         /// This method will be executed on the CEF UI thread in an async fashion, to be notified upon completion implement <see cref="ISetCookieCallback"/>
         /// and pass in as <paramref name="callback"/>
         /// </summary>
         /// <param name="url">The cookie URL</param>
         /// <param name="cookie">The cookie</param>
         /// <param name="callback">If non-NULL it will be executed asnychronously on the CEF UI thread after the cookie has been set.</param>
-        /// <returns>returns false if the cookie cannot be set (e.g. if illegal charecters such as ';' are used); otherwise true.</returns>
+        /// <returns>Returns false if an invalid URL is specified or if cookies cannot be accessed.</returns>
         bool SetCookie(string url, Cookie cookie, ISetCookieCallback callback = null);
 
         /// <summary>
-        /// Set the schemes supported by this manager.  Calling this method with an empty <paramref name="schemes"/> value and <paramref name="includeDefaults"/>
+        /// Set the schemes supported by this manager. Calling this method with an empty <paramref name="schemes"/> value and <paramref name="includeDefaults"/>
         /// set to false will disable all loading and saving of cookies for this manager. Must be called before any cookies are accessed.
         /// </summary>
         /// <param name="schemes">The list of supported schemes.</param>
@@ -47,19 +47,19 @@ public interface ICookieManager : IDisposable
         void SetSupportedSchemes(string[] schemes, bool includeDefaults, ICompletionCallback callback = null);
 
         /// <summary>
-        /// Visits all cookies using the provided Cookie Visitor. The returned cookies are sorted by longest path, then by earliest creation date.
+        /// Visit all cookies on the UI thread. The returned cookies are ordered by longest path, then by earliest creation date.
         /// </summary>
         /// <param name="visitor">A user-provided Cookie Visitor implementation.</param>
         /// <returns>Returns false if cookies cannot be accessed; otherwise, true.</returns>
         bool VisitAllCookies(ICookieVisitor visitor);
 
         /// <summary>
-        /// Visits a subset of the cookies. The results are filtered by the given url scheme, host, domain and path. 
-        /// If <paramref name="includeHttpOnly"/> is true, HTTP-only cookies will also be included in the results. The returned cookies 
-        /// are sorted by longest path, then by earliest creation date.
+        /// Visit a subset of cookies on the CEF UI thread.
+        /// The results are filtered by the given url scheme, host, domain and path.
+        /// The returned cookies are ordered by longest path, then by earliest creation date. 
         /// </summary>
         /// <param name="url">The URL to use for filtering a subset of the cookies available.</param>
-        /// <param name="includeHttpOnly">A flag that determines whether HTTP-only cookies will be shown in results.</param>
+        /// <param name="includeHttpOnly">If true HTTP-only cookies will also be included in the results.</param>
         /// <param name="visitor">A user-provided Cookie Visitor implementation.</param>
         /// <returns>Returns false if cookies cannot be accessed; otherwise, true.</returns>
         bool VisitUrlCookies(string url, bool includeHttpOnly, ICookieVisitor visitor);