From b4e11b227d325871ff80c4b8bcbf8aad5ff3773c Mon Sep 17 00:00:00 2001
From: Giuseppe Lippolis <workgroupengineering@outlook.com>
Date: Fri, 25 Jun 2021 10:09:15 +0200
Subject: [PATCH] fixes: code documentation

---
 src/Avalonia.Controls/Grid.cs                                 | 1 +
 src/Avalonia.Controls/SplitView.cs                            | 2 +-
 src/Avalonia.Visuals/Animation/CrossFade.cs                   | 1 +
 .../Rendering/SceneGraph/BitmapBlendModeNode.cs               | 4 ++--
 src/Skia/Avalonia.Skia/DrawingContextImpl.cs                  | 2 +-
 src/Skia/Avalonia.Skia/Gpu/ISkiaGpu.cs                        | 3 ++-
 tests/Avalonia.Controls.UnitTests/TreeViewTests.cs            | 2 +-
 7 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/src/Avalonia.Controls/Grid.cs b/src/Avalonia.Controls/Grid.cs
index c7d598006d..229fa674f0 100644
--- a/src/Avalonia.Controls/Grid.cs
+++ b/src/Avalonia.Controls/Grid.cs
@@ -978,6 +978,7 @@ namespace Avalonia.Controls
         /// width is not registered in columns.</param>
         /// <param name="forceInfinityV">Passed through to MeasureCell.
         /// When "true" cells' desired height is not registered in rows.</param>
+        /// <param name="hasDesiredSizeUChanged">return true when desired size has ghanged</param>
         private void MeasureCellsGroup(
             int cellsHead,
             Size referenceSize,
diff --git a/src/Avalonia.Controls/SplitView.cs b/src/Avalonia.Controls/SplitView.cs
index 4500d52484..0e35c610b2 100644
--- a/src/Avalonia.Controls/SplitView.cs
+++ b/src/Avalonia.Controls/SplitView.cs
@@ -133,7 +133,7 @@ namespace Avalonia.Controls
             AvaloniaProperty.Register<SplitView, object?>(nameof(Pane));
 
         /// <summary>
-        /// Defines the <see cref="HeaderTemplate"/> property.
+        /// Defines the <see cref="PaneTemplate"/> property.
         /// </summary>
         public static readonly StyledProperty<IDataTemplate?> PaneTemplateProperty =
             AvaloniaProperty.Register<HeaderedContentControl, IDataTemplate?>(nameof(PaneTemplate));
diff --git a/src/Avalonia.Visuals/Animation/CrossFade.cs b/src/Avalonia.Visuals/Animation/CrossFade.cs
index 9ff0d99b23..5eaa920b32 100644
--- a/src/Avalonia.Visuals/Animation/CrossFade.cs
+++ b/src/Avalonia.Visuals/Animation/CrossFade.cs
@@ -147,6 +147,7 @@ namespace Avalonia.Animation
         /// <param name="forward">
         /// Unused for cross-fades.
         /// </param>
+        /// <param name="cancellationToken">allowed cancel transition</param>
         /// <returns>
         /// A <see cref="Task"/> that tracks the progress of the animation.
         /// </returns>
diff --git a/src/Avalonia.Visuals/Rendering/SceneGraph/BitmapBlendModeNode.cs b/src/Avalonia.Visuals/Rendering/SceneGraph/BitmapBlendModeNode.cs
index 0a5c1f8db6..45b62b843b 100644
--- a/src/Avalonia.Visuals/Rendering/SceneGraph/BitmapBlendModeNode.cs
+++ b/src/Avalonia.Visuals/Rendering/SceneGraph/BitmapBlendModeNode.cs
@@ -19,7 +19,7 @@ namespace Avalonia.Rendering.SceneGraph
         }
 
         /// <summary>
-        /// Initializes a new instance of the <see cref="BitmapBlendNode"/> class that represents an
+        /// Initializes a new instance of the <see cref="BitmapBlendModeNode"/> class that represents an
         /// <see cref="BitmapBlendingMode"/> pop.
         /// </summary>
         public BitmapBlendModeNode()
@@ -40,7 +40,7 @@ namespace Avalonia.Rendering.SceneGraph
         /// <summary>
         /// Determines if this draw operation equals another.
         /// </summary>
-        /// <param name="opacity">The opacity of the other draw operation.</param>
+        /// <param name="blendingMode">the <see cref="BitmapBlendModeNode"/> how to compare</param>
         /// <returns>True if the draw operations are the same, otherwise false.</returns>
         /// <remarks>
         /// The properties of the other draw operation are passed in as arguments to prevent
diff --git a/src/Skia/Avalonia.Skia/DrawingContextImpl.cs b/src/Skia/Avalonia.Skia/DrawingContextImpl.cs
index d8bd0607d1..2352b8b076 100644
--- a/src/Skia/Avalonia.Skia/DrawingContextImpl.cs
+++ b/src/Skia/Avalonia.Skia/DrawingContextImpl.cs
@@ -591,7 +591,7 @@ namespace Avalonia.Skia
         /// Configure paint wrapper for using gradient brush.
         /// </summary>
         /// <param name="paintWrapper">Paint wrapper.</param>
-        /// <param name="targetSize">Target size.</param>
+        /// <param name="targetRect">Target bound rect.</param>
         /// <param name="gradientBrush">Gradient brush.</param>
         private void ConfigureGradientBrush(ref PaintWrapper paintWrapper, Rect targetRect, IGradientBrush gradientBrush)
         {
diff --git a/src/Skia/Avalonia.Skia/Gpu/ISkiaGpu.cs b/src/Skia/Avalonia.Skia/Gpu/ISkiaGpu.cs
index aa86df7c23..32818dfdd2 100644
--- a/src/Skia/Avalonia.Skia/Gpu/ISkiaGpu.cs
+++ b/src/Skia/Avalonia.Skia/Gpu/ISkiaGpu.cs
@@ -16,11 +16,12 @@ namespace Avalonia.Skia
         /// <param name="surfaces">Surfaces.</param>
         /// <returns>Created render target or <see langword="null"/> if it fails.</returns>
         ISkiaGpuRenderTarget TryCreateRenderTarget(IEnumerable<object> surfaces);
-        
+
         /// <summary>
         /// Creates an offscreen render target surface
         /// </summary>
         /// <param name="size">size in pixels</param>
+        /// <param name="session">current Skia render session</param>
         ISkiaSurface TryCreateSurface(PixelSize size, ISkiaGpuRenderSession session);
     }
     
diff --git a/tests/Avalonia.Controls.UnitTests/TreeViewTests.cs b/tests/Avalonia.Controls.UnitTests/TreeViewTests.cs
index cea77bb7c9..72ba3ab273 100644
--- a/tests/Avalonia.Controls.UnitTests/TreeViewTests.cs
+++ b/tests/Avalonia.Controls.UnitTests/TreeViewTests.cs
@@ -1066,7 +1066,7 @@ namespace Avalonia.Controls.UnitTests
         [Fact]
         public void Auto_Expanding_In_Style_Should_Not_Break_Range_Selection()
         {
-            /// Issue #2980.
+            // Issue #2980.
             using (Application())
             {
                 var target = new DerivedTreeView