minor: docs

lib/mongo/connection.rb

@@ -118,11 +118,11 @@ module Mongo
     # @param opts Takes the same options as Connection.new
     #
     # @example
-    #   Connection.new([["db1.example.com", 27017],
+    #   Connection.paired([["db1.example.com", 27017],
     #                   ["db2.example.com", 27017]])
     #
     # @example
-    #   Connection.new([["db1.example.com", 27017],
+    #   Connection.paired([["db1.example.com", 27017],
     #                   ["db2.example.com", 27017]],
     #                   :pool_size => 20, :timeout => 5)
     #

lib/mongo/gridfs/grid_file_system.rb

@@ -105,7 +105,7 @@ module Mongo
     # Delete the file with the given filename. Note that this will delete
     # all versions of the file.
     #
-    # Note that deleting a GridFS file can result in read errors if another process
+    # Be careful with this. Deleting a GridFS file can result in read errors if another process
     # is attempting to read a file while it's being deleted. While the odds for this
     # kind of race condition are small, it's important to be aware of.
     #