From 81a4d96b7444408da550b11b7ec402ac7dfabfa0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Cant=C3=BA?= <dacantu@microsoft.com>
Date: Tue, 17 Sep 2024 01:51:52 -0600
Subject: [PATCH] Add missing documentation for new 9.0 APIs in System.IO
 (#107376)

---
 src/libraries/System.Private.CoreLib/src/System/IO/File.cs      | 2 ++
 .../System.Private.CoreLib/src/System/IO/FileStream.cs          | 1 +
 2 files changed, 3 insertions(+)

diff --git a/src/libraries/System.Private.CoreLib/src/System/IO/File.cs b/src/libraries/System.Private.CoreLib/src/System/IO/File.cs
index 9f0476350464c..87f0bae47348f 100644
--- a/src/libraries/System.Private.CoreLib/src/System/IO/File.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/IO/File.cs
@@ -819,6 +819,7 @@ public static void AppendAllBytes(string path, ReadOnlySpan<byte> bytes)
         /// <param name="path">The file to append to.</param>
         /// <param name="bytes">The bytes to append to the file.</param>
         /// <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="CancellationToken.None"/>.</param>
+        /// <returns>A task that represents the asynchronous append operation.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="path"/> is null.</exception>
         /// <exception cref="ArgumentNullException"><paramref name="bytes"/> is null.</exception>
         /// <exception cref="ArgumentException"><paramref name="path"/> is empty.</exception>
@@ -837,6 +838,7 @@ public static Task AppendAllBytesAsync(string path, byte[] bytes, CancellationTo
         /// <param name="path">The file to append to.</param>
         /// <param name="bytes">The bytes to append to the file.</param>
         /// <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="CancellationToken.None"/>.</param>
+        /// <returns>A task that represents the asynchronous append operation.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="path"/> is null.</exception>
         /// <exception cref="ArgumentException"><paramref name="path"/> is empty.</exception>
         /// <exception cref="OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
diff --git a/src/libraries/System.Private.CoreLib/src/System/IO/FileStream.cs b/src/libraries/System.Private.CoreLib/src/System/IO/FileStream.cs
index a7f6aaecb5b85..cee3482ea9357 100644
--- a/src/libraries/System.Private.CoreLib/src/System/IO/FileStream.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/IO/FileStream.cs
@@ -536,6 +536,7 @@ public override void CopyTo(Stream destination, int bufferSize)
             _strategy.CopyTo(destination, bufferSize);
         }
 
+        /// <inheritdoc />
         public override Task CopyToAsync(Stream destination, int bufferSize, CancellationToken cancellationToken)
         {
             ValidateCopyToArguments(destination, bufferSize);