CSHARP-970: Correct doc comments for GetDatabase.

Author: rstam

Diff for: MongoDB.Driver/MongoDatabase.cs

@@ -88,9 +88,8 @@ public MongoDatabase(MongoServer server, string name, MongoDatabaseSettings sett
 
         // factory methods
         /// <summary>
-        /// Creates a new instance or returns an existing instance of MongoDatabase. Only one instance
-        /// is created for each combination of database settings. Automatically creates an instance
-        /// of MongoServer if needed.
+        /// Creates an instance of a MongoDatabase.
+        /// Automatically creates an instance of MongoServer if needed.
         /// </summary>
         /// <param name="builder">Server and database settings in the form of a MongoConnectionStringBuilder.</param>
         /// <returns>
@@ -105,9 +104,8 @@ public static MongoDatabase Create(MongoConnectionStringBuilder builder)
         }
 
         /// <summary>
-        /// Creates a new instance or returns an existing instance of MongoDatabase. Only one instance
-        /// is created for each combination of database settings. Automatically creates an instance
-        /// of MongoServer if needed.
+        /// Creates an instance of a MongoDatabase.
+        /// Automatically creates an instance of MongoServer if needed.
         /// </summary>
         /// <param name="serverSettings">The server settings for the server that contains this database.</param>
         /// <param name="databaseName">The name of this database (will be accessed using default settings).</param>
@@ -126,9 +124,8 @@ public static MongoDatabase Create(MongoServerSettings serverSettings, string da
         }
 
         /// <summary>
-        /// Creates a new instance or returns an existing instance of MongoDatabase. Only one instance
-        /// is created for each combination of database settings. Automatically creates an instance
-        /// of MongoServer if needed.
+        /// Creates an instance of a MongoDatabase.
+        /// Automatically creates an instance of MongoServer if needed.
         /// </summary>
         /// <param name="url">Server and database settings in the form of a MongoUrl.</param>
         /// <returns>
@@ -143,9 +140,8 @@ public static MongoDatabase Create(MongoUrl url)
         }
 
         /// <summary>
-        /// Creates a new instance or returns an existing instance of MongoDatabase. Only one instance
-        /// is created for each combination of database settings. Automatically creates an instance
-        /// of MongoServer if needed.
+        /// Creates an instance of a MongoDatabase.
+        /// Automatically creates an instance of MongoServer if needed.
         /// </summary>
         /// <param name="connectionString">Server and database settings in the form of a connection string.</param>
         /// <returns>
@@ -167,9 +163,8 @@ public static MongoDatabase Create(string connectionString)
         }
 
         /// <summary>
-        /// Creates a new instance or returns an existing instance of MongoDatabase. Only one instance
-        /// is created for each combination of database settings. Automatically creates an instance
-        /// of MongoServer if needed.
+        /// Creates an instance of a MongoDatabase.
+        /// Automatically creates an instance of MongoServer if needed.
         /// </summary>
         /// <param name="uri">Server and database settings in the form of a Uri.</param>
         /// <returns>

Diff for: MongoDB.Driver/MongoServer.cs

@@ -426,8 +426,7 @@ internal MongoServerProxyType ProxyType
 
         // public indexers
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseName">The name of the database.</param>
         /// <returns>A new or existing instance of MongoDatabase.</returns>
@@ -438,8 +437,7 @@ public virtual MongoDatabase this[string databaseName]
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseSettings">The settings to use with this database.</param>
         /// <returns>A new or existing instance of MongoDatabase.</returns>
@@ -450,8 +448,7 @@ public virtual MongoDatabase this[MongoDatabaseSettings databaseSettings]
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseName">The name of the database.</param>
         /// <param name="writeConcern">The write concern to use with this database.</param>
@@ -624,8 +621,7 @@ public virtual object FetchDBRefAs(Type documentType, MongoDBRef dbRef)
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseSettings">The settings to use with this database.</param>
         /// <returns>A new or existing instance of MongoDatabase.</returns>
@@ -636,8 +632,7 @@ public virtual MongoDatabase GetDatabase(MongoDatabaseSettings databaseSettings)
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseName">The name of the database.</param>
         /// <returns>A new or existing instance of MongoDatabase.</returns>
@@ -648,8 +643,7 @@ public virtual MongoDatabase GetDatabase(string databaseName)
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseName">The name of the database.</param>
         /// <param name="writeConcern">The write concern to use with this database.</param>
@@ -665,8 +659,7 @@ public virtual MongoDatabase GetDatabase(string databaseName, WriteConcern write
         }
 
         /// <summary>
-        /// Gets a MongoDatabase instance representing a database on this server. Only one instance
-        /// is created for each combination of database settings.
+        /// Gets a MongoDatabase instance representing a database on this server.
         /// </summary>
         /// <param name="databaseName">The name of the database.</param>
         /// <param name="databaseSettings">The settings to use with this database.</param>