Fixes in documentation comments

Author: josesimoes

System.IO.Streams/MemoryStream.cs

@@ -54,7 +54,7 @@ public MemoryStream()
         /// Initializes a new non-resizable instance of the <see cref="MemoryStream"/> class based on the specified byte array.
         /// </summary>
         /// <param name="buffer">The array of unsigned bytes from which to create the current stream.</param>
-        /// <exception cref="ArgumentNullException"><paramref name="buffer"/> is <see langword="null"/>./exception>
+        /// <exception cref="ArgumentNullException"><paramref name="buffer"/> is <see langword="null"/>.</exception>
         /// <remarks>
         /// <para>
         /// The <see cref="CanRead"/>, <see cref="CanSeek"/>, and <see cref="CanWrite"/> properties are all set to <see langword="true"/>.

System.IO.Streams/StreamReader.cs

@@ -47,9 +47,13 @@ public class StreamReader : TextReader
         /// <summary>
         /// Gets the current character encoding that the current <see cref="StreamReader"/> object is using.
         /// </summary>
-        /// <value>The current character encoding used by the current reader. The value can be different after the first call to any <see cref="Read"/> method of <see cref="StreamReader"/>, since encoding autodetection is not done until the first call to a <see cref="Read"/> method.</value>
+        /// <value>The current character encoding used by the current reader. The value can be different after the first call to any <see cref="Read()"/> method of <see cref="StreamReader"/>, since encoding autodetection is not done until the first call to a <see cref="Read()"/> method.</value>
         public virtual Encoding CurrentEncoding => System.Text.Encoding.UTF8;
 
+        /// <summary>
+        /// Gets a value that indicates whether the current stream position is at the end of the stream.
+        /// </summary>
+        /// <value><see langword="true"/> if the current stream position is at the end of the stream; otherwise <see langword="false"/>.</value>
         public bool EndOfStream
         {
             get
@@ -198,13 +202,12 @@ public override int Peek()
         /// </summary>
         /// <returns>The next character from the input stream represented as an <see cref="int"/> object, or -1 if no more characters are available.</returns>
         /// <remarks>
-        /// This method overrides <see cref="TextReader.Read"/>.
+        /// This method overrides <see cref="TextReader.Read()"/>.
         /// This method returns an integer so that it can return -1 if the end of the stream has been reached. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer.To reset the internal buffer, call the DiscardBufferedData method; however, this method slows performance and should be called only when absolutely necessary.
         /// </remarks>
         public override int Read()
         {
             int byteUsed, charUsed;
-            bool completed = false;
 
             while (true)
             {
@@ -270,7 +273,7 @@ public override int Read()
         /// This method overrides TextReader.Read.
         /// This method returns an integer so that it can return 0 if the end of the stream has been reached.
         /// When using the Read method, it is more efficient to use a buffer that is the same size as the internal buffer of the stream, where the internal buffer is set to your desired block size, and to always read less than the block size.If the size of the internal buffer was unspecified when the stream was constructed, its default size is 4 kilobytes(4096 bytes). If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer.To reset the internal buffer, call the DiscardBufferedData method; however, this method slows performance and should be called only when absolutely necessary.
-        /// This method returns after either the number of characters specified by the count parameter are read, or the end of the file is reached. <see cref="ReadBlock"/> is a blocking version of <see cref="Read"/>.
+        /// This method returns after either the number of characters specified by the count parameter are read, or the end of the file is reached. <see cref="TextReader.ReadBlock(char[], int, int)"/> is a blocking version of <see cref="Read(char[], int, int)"/>.
         /// </remarks>
         public override int Read(
             char[] buffer,

System.IO.Streams/StreamWriter.cs

@@ -144,7 +144,7 @@ public override void Flush()
         /// </summary>
         /// <param name="value"></param>
         /// <remarks>
-        /// This method overrides <see cref="TextWriter.Write"/>.
+        /// This method overrides <see cref="TextWriter.Write(char)"/>.
         /// The specified character is written to the underlying stream unless the end of the stream is reached prematurely.
         /// </remarks>
         public override void Write(char value)
@@ -168,7 +168,7 @@ public override void WriteLine()
         /// Writes a string to the stream, followed by a line terminator.
         /// </summary>
         /// <remarks>
-        /// This overload is equivalent to the <see cref="TextWriter.Write"/> overload.
+        /// This overload is equivalent to the <see cref="TextWriter.Write(string)"/> overload.
         /// The line terminator is defined by the CoreNewLine field.
         /// This method does not search the specified string for individual newline characters(hexadecimal 0x000a) and replace them with NewLine.
         /// </remarks>

System.IO.Streams/TextReader.cs

@@ -27,7 +27,7 @@ protected TextReader() { }
         /// Closes the <see cref="TextReader"/> and releases any system resources associated with the <see cref="TextReader"/>.
         /// </summary>
         /// <remarks>
-        /// This implementation of <see cref="Close"/> calls the <see cref="TextReader.Dispose"/>(Boolean) method and passes it a true value.
+        /// This implementation of <see cref="Close"/> calls the <see cref="TextReader.Dispose(bool)"/> method and passes it a true value.
         /// </remarks>
         public virtual void Close()
         {
@@ -48,8 +48,8 @@ public void Dispose()
         /// </summary>
         /// <param name="disposing"><see langword="true"/> to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
         /// <remarks>
-        /// This method is called by the public <see cref="Dispose"/> method and the Finalize method. By default, this method specifies the disposing parameter as <see langword="true"/>. Finalize specifies the disposing parameter as false.
-        /// When the disposing parameter is true, this method releases all resources held by any managed objects that this TextReader references. This method invokes the <see cref="Dispose"/> method of each referenced object.
+        /// This method is called by the public <see cref="Dispose()"/> method and the Finalize method. By default, this method specifies the disposing parameter as <see langword="true"/>. Finalize specifies the disposing parameter as false.
+        /// When the disposing parameter is true, this method releases all resources held by any managed objects that this TextReader references. This method invokes the <see cref="Dispose()"/> method of each referenced object.
         /// </remarks>
         protected virtual void Dispose(bool disposing)
         {
@@ -98,7 +98,7 @@ public virtual int Read()
         /// This method returns after either count characters are read or the end of the file is reached. <see cref="ReadBlock"/> is a blocking version of this method.
         /// </para>
         /// <para>
-        /// The <see cref="TextReader"/> class is an abstract class. Therefore, you do not instantiate it in your code.For an example of using the <see cref="Read"/> method, see the StreamReader.Read method.
+        /// The <see cref="TextReader"/> class is an abstract class. Therefore, you do not instantiate it in your code.For an example of using the <see cref="Read(char[], int , int )"/> method, see the StreamReader.Read method.
         /// </para>
         /// </remarks>
         public virtual int Read(char[] buffer, int index, int count)
@@ -118,7 +118,7 @@ public virtual int Read(char[] buffer, int index, int count)
         /// The position of the underlying text reader is advanced by the number of characters that were read into buffer.
         /// </para>
         /// <para>
-        /// The method blocks until either count characters are read, or all characters have been read.This is a blocking version of <see cref="Read"/>.
+        /// The method blocks until either count characters are read, or all characters have been read.This is a blocking version of <see cref="Read(char[], int, int)"/>.
         /// </para>
         /// </remarks>
         public virtual int ReadBlock(char[] buffer, int index, int count)

System.IO.Streams/TextWriter.cs

@@ -222,7 +222,7 @@ public virtual void Write(string value)
         }
 
         /// <summary>
-        /// Writes the text representation of an object to the text stream by calling the <see cref="ToString"/> method on that object.
+        /// Writes the text representation of an object to the text stream by calling the <see cref="object.ToString"/> method on that object.
         /// </summary>
         /// <param name="value">The object to write.</param>
         public virtual void Write(object value)
@@ -359,7 +359,7 @@ public virtual void WriteLine(string value)
         }
 
         /// <summary>
-        /// Writes the text representation of an object to the text stream by calling the <see cref="ToString"/> method on that object, followed by a line terminator.
+        /// Writes the text representation of an object to the text stream by calling the <see cref="object.ToString"/> method on that object, followed by a line terminator.
         /// </summary>
         /// <param name="value">The object to write.</param>
         public virtual void WriteLine(object value)