From 59e66f72f2a681dcf5cd69118bf94215bc9fab82 Mon Sep 17 00:00:00 2001
From: Dan Walmsley <dan@walms.co.uk>
Date: Fri, 10 Sep 2021 11:39:22 +0100
Subject: [PATCH] add some documentation.

---
 src/Avalonia.Controls/TrayIcon.cs | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/src/Avalonia.Controls/TrayIcon.cs b/src/Avalonia.Controls/TrayIcon.cs
index bdfea40b5e..73f1fcb006 100644
--- a/src/Avalonia.Controls/TrayIcon.cs
+++ b/src/Avalonia.Controls/TrayIcon.cs
@@ -71,11 +71,13 @@ namespace Avalonia.Controls
         {
             foreach(var icon in icons)
             {
-                icon.Remove();
+                icon.Dispose();
             }
         }
 
-
+        /// <summary>
+        /// Defines the <see cref="TrayIcons"/> attached property.
+        /// </summary>
         public static readonly AttachedProperty<TrayIcons> TrayIconsProperty
             = AvaloniaProperty.RegisterAttached<TrayIcon, Application, TrayIcons>("TrayIcons");
 
@@ -85,29 +87,22 @@ namespace Avalonia.Controls
         public static readonly StyledProperty<WindowIcon> IconProperty =
             Window.IconProperty.AddOwner<TrayIcon>();
 
-
+        /// <summary>
+        /// Defines the <see cref="ToolTipText"/> property.
+        /// </summary>
         public static readonly StyledProperty<string?> ToolTipTextProperty =
             AvaloniaProperty.Register<TrayIcon, string?>(nameof(ToolTipText));
 
         /// <summary>
-        /// Defines the <see cref="IsVisibleProperty"/> property.
+        /// Defines the <see cref="IsVisible"/> property.
         /// </summary>
         public static readonly StyledProperty<bool> IsVisibleProperty =
             Visual.IsVisibleProperty.AddOwner<TrayIcon>();
-        private bool _disposedValue;
 
         public static void SetTrayIcons(AvaloniaObject o, TrayIcons trayIcons) => o.SetValue(TrayIconsProperty, trayIcons);
 
         public static TrayIcons GetTrayIcons(AvaloniaObject o) => o.GetValue(TrayIconsProperty);
 
-        /// <summary>
-        /// Removes the notify icon from the taskbar notification area.
-        /// </summary>
-        public void Remove()
-        {
-
-        }
-
 
         public new ITrayIconImpl PlatformImpl => _impl;
 
@@ -158,6 +153,9 @@ namespace Avalonia.Controls
             }
         }
 
+        /// <summary>
+        /// Disposes the tray icon (removing it from the tray area).
+        /// </summary>
         public void Dispose() => _impl.Dispose();
     }
 }