Fix Sandcastle warnings.

Author: rstam

src/MongoDB.Bson/IO/BsonReader.cs

@@ -145,13 +145,13 @@ public BsonType GetCurrentBsonType()
         /// </returns>
         public abstract bool IsAtEndOfFile();
 
-        /// <inherited/>
+        /// <inheritdoc/>
         public void PopSettings()
         {
             _settings = _settingsStack.Pop();
         }
 
-        /// <inherited/>
+        /// <inheritdoc/>
         public void PushSettings(Action<BsonReaderSettings> configurator)
         {
             var newSettings = _settings.Clone();

src/MongoDB.Bson/IO/IBsonReaderExtensions.cs

@@ -91,8 +91,8 @@ public static BsonBinaryData ReadBinaryData(this IBsonReader reader, string name
         /// <summary>
         /// Reads a BSON binary data element from the reader temporarily setting the GuidRepresentation to Unspecified.
         /// </summary>
-        /// <param name="reader"></param>
-        /// <returns></returns>
+        /// <param name="reader">The reader.</param>
+        /// <returns>A BsonBinaryData.</returns>
         [Obsolete("In V3 mode use ReadBinaryData instead.")]
         public static BsonBinaryData ReadBinaryDataWithGuidRepresentationUnspecified(this IBsonReader reader)
         {

src/MongoDB.Bson/Serialization/BsonSerializerRegistry.cs

@@ -65,7 +65,7 @@ public IBsonSerializer GetSerializer(Type type)
         /// <summary>
         /// Gets the serializer for the specified <typeparamref name="T" />.
         /// </summary>
-        /// <typeparam name="T"></typeparam>
+        /// <typeparam name="T">The value type of the serializer.</typeparam>
         /// <returns>
         /// The serializer.
         /// </returns>

src/MongoDB.Bson/Serialization/IBsonSerializerRegistry.cs

@@ -32,7 +32,7 @@ public interface IBsonSerializerRegistry
         /// <summary>
         /// Gets the serializer for the specified <typeparamref name="T"/>.
         /// </summary>
-        /// <typeparam name="T"></typeparam>
+        /// <typeparam name="T">The value type of the serializer.</typeparam>
         /// <returns>The serializer.</returns>
         IBsonSerializer<T> GetSerializer<T>();
     }

src/MongoDB.Bson/Serialization/Serializers/EnumerableInterfaceImplementerSerializer.cs

@@ -49,7 +49,7 @@ public EnumerableInterfaceImplementerSerializer(IBsonSerializer itemSerializer)
         /// <summary>
         /// Initializes a new instance of the <see cref="EnumerableInterfaceImplementerSerializer{TValue}" /> class.
         /// </summary>
-        /// <param name="serializerRegistry"></param>
+        /// <param name="serializerRegistry">The serializer registry.</param>
         public EnumerableInterfaceImplementerSerializer(IBsonSerializerRegistry serializerRegistry)
             : base(serializerRegistry)
         {

src/MongoDB.Bson/Serialization/Serializers/QueueSerializer.cs

@@ -46,7 +46,7 @@ public QueueSerializer(IBsonSerializer itemSerializer)
         /// <summary>
         /// Initializes a new instance of the <see cref="QueueSerializer" /> class.
         /// </summary>
-        /// <param name="serializerRegistry"></param>
+        /// <param name="serializerRegistry">The serializer registry.</param>
         public QueueSerializer(IBsonSerializerRegistry serializerRegistry)
             : base(serializerRegistry)
         {

src/MongoDB.Bson/Serialization/Serializers/ReadOnlyCollectionSubclassSerializer.cs

@@ -37,7 +37,7 @@ public ReadOnlyCollectionSubclassSerializer()
         /// <summary>
         /// Initializes a new instance of the <see cref="ReadOnlyCollectionSubclassSerializer{TValue, TItem}"/> class.
         /// </summary>
-        /// <param name="itemSerializer"></param>
+        /// <param name="itemSerializer">The item serializer.</param>
         public ReadOnlyCollectionSubclassSerializer(IBsonSerializer<TItem> itemSerializer)
             : base(itemSerializer)
         {

src/MongoDB.Driver.Core/Core/Authentication/SaslPrepHelper.cs

@@ -199,7 +199,7 @@ private static int CharCount(int codepoint)
         /// characters as defined by <a href="https://tools.ietf.org/html/rfc3454#appendix-C.7">RFC 3454, Appendix C.7</a>. 
         /// </summary>
         /// <param name="codepoint">The Unicode character's codepoint.</param>
-        /// <returns></returns>
+        /// <returns>True if the codepoint is inappropriate for canonical.</returns>
         private static bool InappropriateForCanonical(int codepoint)
         {
             return 0x2FF0 <= codepoint && codepoint <= 0x2FFB;
@@ -210,7 +210,7 @@ private static bool InappropriateForCanonical(int codepoint)
         /// by <a href="https://tools.ietf.org/html/rfc3454#appendix-C.6">RFC 3454, Appendix C.6</a>.
         /// </summary>
         /// <param name="codepoint">The Unicode character's codepoint.</param>
-        /// <returns></returns>
+        /// <returns>True if the codepoint is inappropriate for plain text.</returns>
         private static bool InappropriateForPlainText(int codepoint)
         {
             return codepoint == 0xFFF9
@@ -795,7 +795,7 @@ private static bool Surrogatecodepoint(int codepoint)
         /// <a href="https://tools.ietf.org/html/rfc3454#appendix-C.9">RFC 3454, Appendix C.9</a>.
         /// </summary>
         /// <param name="codepoint">The Unicode character's codepoint.</param>
-        /// <returns></returns>
+        /// <returns>True if the codepoint is a tagging character.</returns>
         private static bool Tagging(int codepoint)
         {
             return codepoint == 0xE0001

src/MongoDB.Driver.Core/Core/Authentication/ScramCache.cs

@@ -32,9 +32,9 @@ internal class ScramCache
         /// <summary>
         /// Try to get a cached entry.
         /// </summary>
-        /// <param name="key"></param>
-        /// <param name="entry"></param>
-        /// <returns></returns>
+        /// <param name="key">The key.</param>
+        /// <param name="entry">The entry.</param>
+        /// <returns>True if the cache contained an entry for the key.</returns>
         public bool TryGet(ScramCacheKey key, out ScramCacheEntry entry)
         {
             if (key.Equals(_cacheKey))
@@ -52,8 +52,8 @@ public bool TryGet(ScramCacheKey key, out ScramCacheEntry entry)
         /// <summary>
         /// Add a cached entry.
         /// </summary>
-        /// <param name="key"></param>
-        /// <param name="entry"></param>
+        /// <param name="key">The key.</param>
+        /// <param name="entry">The entry.</param>
         public void Add(ScramCacheKey key, ScramCacheEntry entry)
         {
             _cacheKey = key;

src/MongoDB.Driver.Core/Core/Authentication/Sspi/NativeMethods.cs

@@ -54,7 +54,7 @@ internal static class NativeMethods
         /// </summary>
         /// <param name="errorCode">The error code.</param>
         /// <param name="defaultMessage">The default message.</param>
-        /// <returns></returns>
+        /// <returns>A Win32Exception.</returns>
         public static Win32Exception CreateException(long errorCode, string defaultMessage)
         {
             string message = defaultMessage;