Add doc comments

Author: comandeo-mongo

lib/mongo/collection.rb

@@ -1049,6 +1049,11 @@ def parallel_scan(cursor_count, options = {})
     #   May be specified as a Hash (e.g. { _id: 1 }) or a String (e.g. "_id_").
     # @option options [ Hash ] :let Mapping of variables to use in the command.
     #   See the server documentation for details.
+    # @option opts [ Hash ] :sort Specifies which document the operation
+    #   replaces if the query matches multiple documents. The first document
+    #   matched by the sort order will be replaced.
+    #   This option is only supported by servers >= 8.0. Older servers will
+    #   report an error for using this option.
     #
     # @return [ Result ] The response from the database.
     #
@@ -1115,6 +1120,11 @@ def update_many(filter, update, options = {})
     #   May be specified as a Hash (e.g. { _id: 1 }) or a String (e.g. "_id_").
     # @option options [ Hash ] :let Mapping of variables to use in the command.
     #   See the server documentation for details.
+    # @option opts [ Hash ] :sort Specifies which document the operation
+    #   updates if the query matches multiple documents. The first document
+    #   matched by the sort order will be updated.
+    #   This option is only supported by servers >= 8.0. Older servers will
+    #   report an error for using this option.
     #
     # @return [ Result ] The response from the database.
     #

lib/mongo/collection/view/writable.rb

@@ -389,6 +389,11 @@ def delete_one(opts = {})
         # @option opts [ true, false ] :upsert Whether to upsert if the
         #   document doesn't exist.
         #   Can be :w => Integer, :fsync => Boolean, :j => Boolean.
+        # @option opts [ Hash ] :sort Specifies which document the operation
+        #   replaces if the query matches multiple documents. The first document
+        #   matched by the sort order will be replaced.
+        #   This option is only supported by servers >= 8.0. Older servers will
+        #   report an error for using this option.
         #
         # @return [ Result ] The response from the database.
         #
@@ -550,6 +555,11 @@ def update_many(spec, opts = {})
         #   document doesn't exist.
         # @option opts [ Hash ] :write_concern The write concern options.
         #   Can be :w => Integer, :fsync => Boolean, :j => Boolean.
+        # @option opts [ Hash ] :sort Specifies which document the operation
+        #   updates if the query matches multiple documents. The first document
+        #   matched by the sort order will be updated.
+        #   This option is only supported by servers >= 8.0. Older servers will
+        #   report an error for using this option.
         #
         # @return [ Result ] The response from the database.
         #