From 1fc60ebbeb3963b8365f382916051bc35016ede7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Sim=C3=B5es?= <jose.simoes@eclo.solutions>
Date: Wed, 23 Nov 2022 01:18:59 +0000
Subject: [PATCH] Miscelaneous improvements

- Fixes in several comments.
- Change exceptions thrown on stream wrappers.
---
 nanoFramework.System.Net.Http/Http/HttpMessageInvoker.cs        | 2 +-
 nanoFramework.System.Net.Http/Http/System.Net.HttpWebRequest.cs | 2 +-
 .../Http/System.Net._InputNetworkStreamWrapper.cs               | 2 +-
 .../Http/System.Net._OutputNetworkStreamWrapper.cs              | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/nanoFramework.System.Net.Http/Http/HttpMessageInvoker.cs b/nanoFramework.System.Net.Http/Http/HttpMessageInvoker.cs
index ea69471a..877139ab 100644
--- a/nanoFramework.System.Net.Http/Http/HttpMessageInvoker.cs
+++ b/nanoFramework.System.Net.Http/Http/HttpMessageInvoker.cs
@@ -28,7 +28,7 @@ public HttpMessageInvoker(HttpMessageHandler handler)
         /// Initializes an instance of a <see cref="HttpMessageInvoker"/> class with a specific <see cref="HttpMessageHandler"/>.
         /// </summary>
         /// <param name="handler">The <see cref="HttpMessageHandler"/> responsible for processing the HTTP response messages.</param>
-        /// <param name="disposeHandler"><see langword="true"/> if the inner handler should be disposed of by <see cref="Dispose"/>, <see langword="false"/> if you intend to reuse the inner handler.</param>
+        /// <param name="disposeHandler"><see langword="true"/> if the inner handler should be disposed of by <see cref="HttpMessageInvoker.Dispose"/>, <see langword="false"/> if you intend to reuse the inner handler.</param>
         /// <exception cref="ArgumentNullException"></exception>
         public HttpMessageInvoker(
             HttpMessageHandler handler,
diff --git a/nanoFramework.System.Net.Http/Http/System.Net.HttpWebRequest.cs b/nanoFramework.System.Net.Http/Http/System.Net.HttpWebRequest.cs
index f7557d5c..2a25418f 100644
--- a/nanoFramework.System.Net.Http/Http/System.Net.HttpWebRequest.cs
+++ b/nanoFramework.System.Net.Http/Http/System.Net.HttpWebRequest.cs
@@ -404,7 +404,7 @@ public SslProtocols SslProtocols
         /// times out.  The default value is 300,000 milliseconds (5 minutes).
         /// </value>
         /// <remarks>This property is used to control the timeout when calling
-        /// <see cref="Stream.Read"/> and <see cref="Stream.Write"/>.
+        /// <see cref="Stream.Read(byte[], int, int)"/> and <see cref="Stream.Write"/>.
         /// This property affects <itemref>Stream</itemref>s returned from
         /// GetResponse().<see cref="WebResponse.GetResponseStream"/>()
         /// and
diff --git a/nanoFramework.System.Net.Http/Http/System.Net._InputNetworkStreamWrapper.cs b/nanoFramework.System.Net.Http/Http/System.Net._InputNetworkStreamWrapper.cs
index 941d30cf..124cc384 100644
--- a/nanoFramework.System.Net.Http/Http/System.Net._InputNetworkStreamWrapper.cs
+++ b/nanoFramework.System.Net.Http/Http/System.Net._InputNetworkStreamWrapper.cs
@@ -748,7 +748,7 @@ private Chunk GetChunk()
 
         public override int Read(SpanByte buffer)
         {
-            throw new NotImplementedException();
+            throw new NotSupportedException();
         }
 
         private enum ChunkState
diff --git a/nanoFramework.System.Net.Http/Http/System.Net._OutputNetworkStreamWrapper.cs b/nanoFramework.System.Net.Http/Http/System.Net._OutputNetworkStreamWrapper.cs
index 3bb93e6c..37893726 100644
--- a/nanoFramework.System.Net.Http/Http/System.Net._OutputNetworkStreamWrapper.cs
+++ b/nanoFramework.System.Net.Http/Http/System.Net._OutputNetworkStreamWrapper.cs
@@ -290,7 +290,7 @@ public override void Write(byte[] buffer, int offset, int size)
 
         public override int Read(SpanByte buffer)
         {
-            throw new NotImplementedException();
+            throw new NotSupportedException();
         }
     }
 }