From 7746f956a89ed00cb7495dcd218cab6af182b822 Mon Sep 17 00:00:00 2001
From: Dan Walmsley <dan@walms.co.uk>
Date: Thu, 2 Jul 2020 12:51:40 -0300
Subject: [PATCH] add xml comments

---
 .../Platform/ExtendClientAreaChromeHints.cs   | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/src/Avalonia.Controls/Platform/ExtendClientAreaChromeHints.cs b/src/Avalonia.Controls/Platform/ExtendClientAreaChromeHints.cs
index deb9e417ab..de3f58886b 100644
--- a/src/Avalonia.Controls/Platform/ExtendClientAreaChromeHints.cs
+++ b/src/Avalonia.Controls/Platform/ExtendClientAreaChromeHints.cs
@@ -2,13 +2,37 @@
 
 namespace Avalonia.Platform
 {
+    /// <summary>
+    /// Hint for Window Chrome when ClientArea is Extended.
+    /// </summary>
     [Flags]
     public enum ExtendClientAreaChromeHints
     {
+        /// <summary>
+        /// The will be no chrome at all.
+        /// </summary>
         NoChrome,
-        Default = SystemChrome,        
+
+        /// <summary>
+        /// The default for the platform.
+        /// </summary>
+        Default = SystemChrome,
+
+        /// <summary>
+        /// Use SystemChrome
+        /// </summary>
         SystemChrome = 0x01,
+
+        /// <summary>
+        /// Use system chrome where possible. OSX system chrome is used, Windows managed chrome is used.
+        /// This is because Windows Chrome can not be shown ontop of user content.
+        /// </summary>
         PreferSystemChrome = 0x02,
+
+        /// <summary>
+        /// On OSX the titlebar is the thicker toolbar kind. Causes traffic lights to be positioned
+        /// slightly lower than normal.
+        /// </summary>
         OSXThickTitleBar = 0x08,               
     }
 }