MONGOID-5415: Add splats to code docs (#5400)

johnnyshields · web-flow · commit 94fdc7d0350e · 2022-07-29T12:07:28.000-04:00
* Correct splats in docs.

* Requested fixes

* Line wrap

Co-authored-by: shields &lt;shields@tablecheck.com&gt;
diff --git a/lib/mongoid/association/accessors.rb b/lib/mongoid/association/accessors.rb
@@ -251,7 +251,7 @@ def without_autobuild
       # @example Parse the args.
       #   doc.parse_args(:name => "Joe")
       #
-      # @param [ Array ] args The arguments.
+      # @param [ Hash... ] *args The arguments.
       #
       # @return [ Array<Hash> ] The attributes and options.
       def parse_args(*args)
diff --git a/lib/mongoid/association/builders.rb b/lib/mongoid/association/builders.rb
@@ -27,7 +27,7 @@ module Builders
       # @example Parse the args.
       #   doc.parse_args(:name => "Joe")
       #
-      # @param [ Array ] args The arguments.
+      # @param [ Hash... ] *args The arguments.
       #
       # @return [ Array<Hash> ] The attributes and options.
       def parse_args(*args)
diff --git a/lib/mongoid/association/embedded/embeds_many/proxy.rb b/lib/mongoid/association/embedded/embeds_many/proxy.rb
@@ -19,7 +19,7 @@ class Proxy < Association::Many
           # @example Push a document.
           #   person.addresses.push(address)
           #
-          # @param [ Document | Array<Document> ] args Any number of documents.
+          # @param [ Document... ] *args Any number of documents.
           def <<(*args)
             docs = args.flatten
             return concat(docs) if docs.size > 1
@@ -117,7 +117,7 @@ def clear
           # @example Use #persisted? inside block to count persisted documents.
           #   person.addresses.count { |a| a.persisted? && a.country == "FR" }
           #
-          # @param [ Object | Array<Object> ] args Args to delegate to the target.
+          # @param [ Object... ] *args Args to delegate to the target.
           #
           # @return [ Integer ] The total number of persisted embedded docs, as
           #   flagged by the #persisted? method.
@@ -235,7 +235,7 @@ def exists?
           # @example Finds the first matching document using a block.
           #   person.addresses.find { |addr| addr.state == 'CA' }
           #
-          # @param [ Array<Object> ] args Various arguments.
+          # @param [ Object... ] *args Various arguments.
           # @param [ Proc ] block Optional block to pass.
           #
           # @return [ Document | Array<Document> | nil ] A document or matching documents.
@@ -430,10 +430,10 @@ def integrate(document)
           # If the method exists on the array, use the default proxy behavior.
           #
           # @param [ Symbol | String ] name The name of the method.
-          # @param [ Array ] args The method args
+          # @param [ Object... ] *args The method args.
           # @param [ Proc ] block Optional block to pass.
           #
-          # @return [ Criteria, Object ] A Criteria or return value from the target.
+          # @return [ Criteria | Object ] A Criteria or return value from the target.
           ruby2_keywords def method_missing(name, *args, &block)
             return super if _target.respond_to?(name)
             klass.send(:with_scope, criteria) do
diff --git a/lib/mongoid/association/proxy.rb b/lib/mongoid/association/proxy.rb
@@ -118,7 +118,7 @@ def characterize_one(document)
       # to the target of the proxy. This can be overridden in special cases.
       #
       # @param [ String | Symbol ] name The name of the method.
-      # @param [ Array ] args The arguments passed to the method.
+      # @param [ Object... ] *args The arguments passed to the method.
       ruby2_keywords def method_missing(name, *args, &block)
         _target.send(name, *args, &block)
       end
diff --git a/lib/mongoid/association/referenced/counter_cache.rb b/lib/mongoid/association/referenced/counter_cache.rb
@@ -13,7 +13,7 @@ module CounterCache
         # @example Reset the given counter cache
         #   post.reset_counters(:comments)
         #
-        # @param [ Symbol | Array ] counters One or more counter caches to reset
+        # @param [ Symbol... ] *counters One or more counter caches to reset.
         def reset_counters(*counters)
           self.class.with(persistence_context) do |_class|
             _class.reset_counters(self, *counters)
@@ -30,7 +30,7 @@ module ClassMethods
           #   Post.reset_counters('50e0edd97c71c17ea9000001', :comments)
           #
           # @param [ String ] id The id of the object that will be reset.
-          # @param [ Symbol | Array ] counters One or more counter caches to reset
+          # @param [ Symbol... ] *counters One or more counter caches to reset.
           def reset_counters(id, *counters)
             document = id.is_a?(Document) ? id : find(id)
             counters.each do |name|
diff --git a/lib/mongoid/association/referenced/has_and_belongs_to_many/proxy.rb b/lib/mongoid/association/referenced/has_and_belongs_to_many/proxy.rb
@@ -21,7 +21,7 @@ class Proxy < Referenced::HasMany::Proxy
           # @example Concat with other documents.
           #   person.posts.concat([ post_one, post_two ])
           #
-          # @param [ Document | Array<Document> ] args Any number of documents.
+          # @param [ Document... ] *args Any number of documents.
           #
           # @return [ Array<Document> ] The loaded docs.
           def <<(*args)
diff --git a/lib/mongoid/association/referenced/has_many/enumerable.rb b/lib/mongoid/association/referenced/has_many/enumerable.rb
@@ -215,13 +215,13 @@ def empty?
           # completely depending on whether it is iterated to completion.
           #
           # This method can take a parameter and a block. The behavior with
-          # either the paramater or the block is delegated to the standard
+          # either the parameter or the block is delegated to the standard
           # library Enumerable module.
           #
           # Note that when Enumerable's any? method is invoked with both
           # a block and a pattern, it only uses the pattern.
           #
-          # @param [ Object ] condition The condition that documents
+          # @param [ Object... ] *args The condition that documents
           #   must satisfy. See Enumerable documentation for details.
           #
           # @return [ true | false ] If the association has any documents.
diff --git a/lib/mongoid/association/referenced/has_many/proxy.rb b/lib/mongoid/association/referenced/has_many/proxy.rb
@@ -25,7 +25,7 @@ class Proxy < Association::Many
           # @example Concat with other documents.
           #   person.posts.concat([ post_one, post_two ])
           #
-          # @param [ Document | Array<Document> ] args Any number of documents.
+          # @param [ Document... ] *args Any number of documents.
           #
           # @return [ Array<Document> ] The loaded docs.
           def <<(*args)
@@ -199,7 +199,7 @@ def exists?
           # @note This will keep matching documents in memory for iteration
           #   later.
           #
-          # @param [ Object | Array<Object> ] *args The ids.
+          # @param [ [ Object | Array<Object> ]... ] *args The ids.
           # @param [ Proc ] block Optional block to pass.
           #
           # @return [ Document | Array<Document> | nil ] A document or matching documents.
@@ -414,7 +414,7 @@ def cascade!(document)
           # If the method exists on the array, use the default proxy behavior.
           #
           # @param [ Symbol | String ] name The name of the method.
-          # @param [ Array ] args The method args
+          # @param [ Object... ] *args The method args
           # @param [ Proc ] block Optional block to pass.
           #
           # @return [ Criteria | Object ] A Criteria or return value from the target.
diff --git a/lib/mongoid/association/reflections.rb b/lib/mongoid/association/reflections.rb
@@ -25,7 +25,7 @@ def reflect_on_association(name)
       # @example Find multiple association metadata by macro.
       #   person.reflect_on_all_associations(:embeds_many)
       #
-      # @param [ Array<Symbol> ] macros The association macros.
+      # @param [ Symbol... ] *macros The association macros.
       #
       # @return [ Array<Association> ] The matching association metadata.
       def reflect_on_all_association(*macros)
@@ -51,7 +51,7 @@ def reflect_on_association(name)
         # @example Find multiple association metadata by macro.
         #   Person.reflect_on_all_associations(:embeds_many)
         #
-        # @param [ Array<Symbol> ] macros The association macros.
+        # @param [ Symbol... ] *macros The association macros.
         #
         # @return [ Array<Association> ] The matching association metadata.
         def reflect_on_all_associations(*macros)
diff --git a/lib/mongoid/attributes/dynamic.rb b/lib/mongoid/attributes/dynamic.rb
@@ -115,7 +115,7 @@ def inspect_dynamic_fields
       #   document.method_missing(:test)
       #
       # @param [ String | Symbol ] name The name of the method.
-      # @param [ Array ] args The arguments to the method.
+      # @param [ Object... ] *args The arguments to the method.
       #
       # @return [ Object ] The result of the method call.
       def method_missing(name, *args)
diff --git a/lib/mongoid/attributes/nested.rb b/lib/mongoid/attributes/nested.rb
@@ -33,8 +33,8 @@ module ClassMethods
         #     accepts_nested_attributes_for :addresses, :game, :posts
         #   end
         #
-        # @param [ Array<Symbol> | Hash ] args A list of association names, followed
-        #   by a hash of options.
+        # @param [ Symbol..., Hash ] *args A list of association names, followed
+        #   by an optional hash of options.
         #
         # @option *args [ true | false ] :allow_destroy Can deletion occur?
         # @option *args [ Proc | Symbol ] :reject_if Block or symbol pointing
diff --git a/lib/mongoid/attributes/readonly.rb b/lib/mongoid/attributes/readonly.rb
@@ -61,7 +61,7 @@ module ClassMethods
         #     attr_readonly :name, :genre
         #   end
         #
-        # @param [ Array<Symbol> ] names The names of the fields.
+        # @param [ Symbol... ] *names The names of the fields.
         def attr_readonly(*names)
           names.each do |name|
             readonly_attributes << database_field_name(name)
diff --git a/lib/mongoid/contextual/atomic.rb b/lib/mongoid/contextual/atomic.rb
@@ -150,7 +150,7 @@ def set(sets)
       # @example Unset the field on the matches.
       #   context.unset(:name)
       #
-      # @param [ String | Symbol | Array<String | Symbol> | Hash ] args
+      # @param [ [ String | Symbol | Array<String | Symbol> | Hash ]... ] *args
       #   The name(s) of the field(s) to unset.
       #   If a Hash is specified, its keys will be used irrespective of what
       #   each key's value is, even if the value is nil or false.
diff --git a/lib/mongoid/contextual/memory.rb b/lib/mongoid/contextual/memory.rb
@@ -237,7 +237,7 @@ def limit(value)
       # @example Get the values in memory.
       #   context.pluck(:name)
       #
-      # @param [ String | Symbol ] *fields Field(s) to pluck.
+      # @param [ [ String | Symbol ]... ] *fields Field(s) to pluck.
       #
       # @return [ Array<Object> | Array<Array<Object>> ] The plucked values.
       def pluck(*fields)
@@ -255,9 +255,9 @@ def pluck(*fields)
       # @example Get the values in memory.
       #   context.pick(:name)
       #
-      # @param [ String | Symbol ] *fields Field(s) to pick.
+      # @param [ [ String | Symbol ]... ] *fields Field(s) to pick.
       #
-      # @return [ Object, Array<Object> ] The picked values.
+      # @return [ Object | Array<Object> ] The picked values.
       def pick(*fields)
         if doc = documents.first
           pluck_from_doc(doc, *fields)
@@ -742,9 +742,9 @@ def retrieve_value_at_path(document, field_path)
       # Pluck the field values from the given document.
       #
       # @param [ Document ] doc The document to pluck from.
-      # @param [ String | Symbol ] *fields Field(s) to pluck.
+      # @param [ [ String | Symbol ]... ] *fields Field(s) to pluck.
       #
-      # @return [ Object, Array<Object> ] The plucked values.
+      # @return [ Object | Array<Object> ] The plucked values.
       def pluck_from_doc(doc, *fields)
         if fields.length == 1
           retrieve_value_at_path(doc, fields.first)
diff --git a/lib/mongoid/contextual/mongo.rb b/lib/mongoid/contextual/mongo.rb
@@ -321,7 +321,7 @@ def map_reduce(map, reduce)
       # @example Pluck a field.
       #   context.pluck(:_id)
       #
-      # @param [ String | Symbol ] *fields Field(s) to pluck,
+      # @param [ [ String | Symbol ]... ] *fields Field(s) to pluck,
       #   which may include nested fields using dot-notation.
       #
       # @return [ Array<Object> | Array<Array<Object>> ] The plucked values.
@@ -362,7 +362,7 @@ def pluck(*fields)
       # @example Pick a field.
       #   context.pick(:_id)
       #
-      # @param [ String | Symbol ] *fields Field(s) to pick.
+      # @param [ [ String | Symbol ]... ] *fields Field(s) to pick.
       #
       # @return [ Object | Array<Object> ] The picked values.
       def pick(*fields)
@@ -519,7 +519,7 @@ def sort(values = nil, &block)
       # @option opts [ Array ] :array_filters A set of filters specifying to which array elements
       #   an update should apply.
       #
-      # @return [ nil, false ] False if no attributes were provided.
+      # @return [ nil | false ] False if no attributes were provided.
       def update(attributes = nil, opts = {})
         update_documents(attributes, :update_one, opts)
       end
@@ -535,7 +535,7 @@ def update(attributes = nil, opts = {})
       # @option opts [ Array ] :array_filters A set of filters specifying to which array elements
       #   an update should apply.
       #
-      # @return [ nil, false ] False if no attributes were provided.
+      # @return [ nil | false ] False if no attributes were provided.
       def update_all(attributes = nil, opts = {})
         update_documents(attributes, :update_many, opts)
       end
diff --git a/lib/mongoid/contextual/none.rb b/lib/mongoid/contextual/none.rb
@@ -88,7 +88,7 @@ def exists?; false; end
       # @example Get the values for null context.
       #   context.pluck(:name)
       #
-      # @param [ String | Symbol ] *_fields Field(s) to pluck.
+      # @param [ [ String | Symbol ]... ] *_fields Field(s) to pluck.
       #
       # @return [ Array ] An empty Array.
       def pluck(*_fields)
@@ -100,9 +100,9 @@ def pluck(*_fields)
       # @example Get the value for null context.
       #   context.pick(:name)
       #
-      # @param [ String | Symbol ] *_fields Field or fields to pick.
+      # @param [ [ String | Symbol ]... ] *_fields Field(s) to pick.
       #
-      # @return [ nil ] Always reeturn nil.
+      # @return [ nil ] Always return nil.
       def pick(*_fields)
         nil
       end
diff --git a/lib/mongoid/criteria.rb b/lib/mongoid/criteria.rb
@@ -88,7 +88,7 @@ def ==(other)
     # @example Tries to find a document whose _id is the stringification of the provided Proc, typically failing.
     #   enumerator = criteria.find(-> { "Default Band" })
     #
-    # @param [ Object | Array<Object> ] *args The ids.
+    # @param [ [ Object | Array<Object> ]... ] *args The id(s).
     # @param [ Proc ] block Optional block to pass.
     #
     # @return [ Document | Array<Document> | nil ] A document or matching documents.
@@ -284,7 +284,7 @@ def empty_and_chainable?
     # @example Limit the fields returned from the database.
     #   Band.only(:name)
     #
-    # @param [ Array<Symbol> ] args The names of the fields.
+    # @param [ [ Symbol | Array<Symbol> ]... ] *args The field name(s).
     #
     # @return [ Criteria ] The cloned criteria.
     def only(*args)
@@ -318,7 +318,7 @@ def read(value = nil)
     # @example Exclude fields returned from the database.
     #   Band.without(:name)
     #
-    # @param [ Array<Symbol> ] args The names of the fields.
+    # @param [ Symbol... ] *args The field name(s).
     #
     # @return [ Criteria ] The cloned criteria.
     def without(*args)
@@ -385,7 +385,8 @@ def type(types)
     # @example Add a javascript selection.
     #   criteria.where("this.name == 'syd'")
     #
-    # @param [ String | Hash ] expression The javascript or standard selection.
+    # @param [ [ Hash | String ]... ] *args The standard selection
+    #   or javascript string.
     #
     # @raise [ UnsupportedJavascript ] If provided a string and the criteria
     #   is embedded.
@@ -495,7 +496,7 @@ def initialize_copy(other)
     #   criteria.method_missing(:name)
     #
     # @param [ Symbol ] name The method name.
-    # @param [ Array ] args The arguments.
+    # @param [ Object... ] *args The arguments.
     #
     # @return [ Object ] The result of the method call.
     ruby2_keywords def method_missing(name, *args, &block)
diff --git a/lib/mongoid/criteria/findable.rb b/lib/mongoid/criteria/findable.rb
@@ -21,7 +21,7 @@ def execute_or_raise(ids, multi)
         multi ? result : result.first
       end
 
-      # Find the matchind document(s) in the criteria for the provided ids.
+      # Find the matching document(s) in the criteria for the provided id(s).
       #
       # @note Each argument can be an individual id, an array of ids or
       #   a nested array. Each array will be flattened.
@@ -32,7 +32,7 @@ def execute_or_raise(ids, multi)
       # @example Find by multiple ids.
       #   criteria.find([ BSON::ObjectId.new, BSON::ObjectId.new ])
       #
-      # @param [ Object | Array<Object> ] *args The ids to search for.
+      # @param [ [ Object | Array<Object> ]... ] *args The id(s) to find.
       #
       # @return [ Document | Array<Document> ] The matching document(s).
       def find(*args)
diff --git a/lib/mongoid/criteria/includable.rb b/lib/mongoid/criteria/includable.rb
@@ -21,8 +21,8 @@ module Includable
       # @example Eager load the provided associations.
       #   Person.includes(:posts, :game)
       #
-      # @param [ Array<Symbol>, Array<Hash> ] relations The names of the associations to eager
-      #   load.
+      # @param [ [ Symbol | Hash ]... ] *relations The names of the association(s)
+      #   to eager load.
       #
       # @return [ Criteria ] The cloned criteria.
       def includes(*relations)
@@ -70,7 +70,8 @@ def add_inclusion(association, parent = nil)
       #   association originates.
       # @param [ String ] parent The name of the association above this one in
       #   the inclusion tree, if it is a nested inclusion.
-      # @param relations_list The names of the associations to eager load.
+      # @param [ [ Symbol | Hash | Array<Symbol | Hash> ]... ] *relations_list
+      #   The names of the association(s) to eager load.
       def extract_includes_list(_parent_class, parent, *relations_list)
         relations_list.flatten.each do |relation_object|
           if relation_object.is_a?(Hash)
diff --git a/lib/mongoid/criteria/queryable/optional.rb b/lib/mongoid/criteria/queryable/optional.rb
diff --git a/lib/mongoid/criteria/queryable/selectable.rb b/lib/mongoid/criteria/queryable/selectable.rb
diff --git a/lib/mongoid/deprecable.rb b/lib/mongoid/deprecable.rb
diff --git a/lib/mongoid/extensions/object.rb b/lib/mongoid/extensions/object.rb
diff --git a/lib/mongoid/findable.rb b/lib/mongoid/findable.rb
diff --git a/lib/mongoid/interceptable.rb b/lib/mongoid/interceptable.rb
diff --git a/lib/mongoid/persistable/unsettable.rb b/lib/mongoid/persistable/unsettable.rb
diff --git a/lib/mongoid/validatable.rb b/lib/mongoid/validatable.rb
diff --git a/lib/mongoid/validatable/macros.rb b/lib/mongoid/validatable/macros.rb

Original file line number	Diff line number	Diff line change
`@@ -251,7 +251,7 @@ def without_autobuild`
`251`	`251`	`# @example Parse the args.`
`252`	`252`	`# doc.parse_args(:name => "Joe")`
`253`	`253`	`#`
`254`		`- # @param [ Array ] args The arguments.`
	`254`	`+ # @param [ Hash... ] *args The arguments.`
`255`	`255`	`#`
`256`	`256`	`# @return [ Array<Hash> ] The attributes and options.`
`257`	`257`	`def parse_args(*args)`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ module Builders`
`27`	`27`	`# @example Parse the args.`
`28`	`28`	`# doc.parse_args(:name => "Joe")`
`29`	`29`	`#`
`30`		`- # @param [ Array ] args The arguments.`
	`30`	`+ # @param [ Hash... ] *args The arguments.`
`31`	`31`	`#`
`32`	`32`	`# @return [ Array<Hash> ] The attributes and options.`
`33`	`33`	`def parse_args(*args)`
Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ class Proxy < Association::Many`
`19`	`19`	`# @example Push a document.`
`20`	`20`	`# person.addresses.push(address)`
`21`	`21`	`#`
`22`		`- # @param [ Document \| Array<Document> ] args Any number of documents.`
	`22`	`+ # @param [ Document... ] *args Any number of documents.`
`23`	`23`	`def <<(*args)`
`24`	`24`	`docs = args.flatten`
`25`	`25`	`return concat(docs) if docs.size > 1`
`@@ -117,7 +117,7 @@ def clear`
`117`	`117`	`# @example Use #persisted? inside block to count persisted documents.`
`118`	`118`	`# person.addresses.count { \|a\| a.persisted? && a.country == "FR" }`
`119`	`119`	`#`
`120`		`- # @param [ Object \| Array<Object> ] args Args to delegate to the target.`
	`120`	`+ # @param [ Object... ] *args Args to delegate to the target.`
`121`	`121`	`#`
`122`	`122`	`# @return [ Integer ] The total number of persisted embedded docs, as`
`123`	`123`	`# flagged by the #persisted? method.`
`@@ -235,7 +235,7 @@ def exists?`
`235`	`235`	`# @example Finds the first matching document using a block.`
`236`	`236`	`# person.addresses.find { \|addr\| addr.state == 'CA' }`
`237`	`237`	`#`
`238`		`- # @param [ Array<Object> ] args Various arguments.`
	`238`	`+ # @param [ Object... ] *args Various arguments.`
`239`	`239`	`# @param [ Proc ] block Optional block to pass.`
`240`	`240`	`#`
`241`	`241`	`# @return [ Document \| Array<Document> \| nil ] A document or matching documents.`
`@@ -430,10 +430,10 @@ def integrate(document)`
`430`	`430`	`# If the method exists on the array, use the default proxy behavior.`
`431`	`431`	`#`
`432`	`432`	`# @param [ Symbol \| String ] name The name of the method.`
`433`		`- # @param [ Array ] args The method args`
	`433`	`+ # @param [ Object... ] *args The method args.`
`434`	`434`	`# @param [ Proc ] block Optional block to pass.`
`435`	`435`	`#`
`436`		`- # @return [ Criteria, Object ] A Criteria or return value from the target.`
	`436`	`+ # @return [ Criteria \| Object ] A Criteria or return value from the target.`
`437`	`437`	`ruby2_keywords def method_missing(name, *args, &block)`
`438`	`438`	`return super if _target.respond_to?(name)`
`439`	`439`	`klass.send(:with_scope, criteria) do`
Original file line number	Diff line number	Diff line change
`@@ -118,7 +118,7 @@ def characterize_one(document)`
`118`	`118`	`# to the target of the proxy. This can be overridden in special cases.`
`119`	`119`	`#`
`120`	`120`	`# @param [ String \| Symbol ] name The name of the method.`
`121`		`- # @param [ Array ] args The arguments passed to the method.`
	`121`	`+ # @param [ Object... ] *args The arguments passed to the method.`
`122`	`122`	`ruby2_keywords def method_missing(name, *args, &block)`
`123`	`123`	`_target.send(name, *args, &block)`
`124`	`124`	`end`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@ class Proxy < Referenced::HasMany::Proxy`
`21`	`21`	`# @example Concat with other documents.`
`22`	`22`	`# person.posts.concat([ post_one, post_two ])`
`23`	`23`	`#`
`24`		`- # @param [ Document \| Array<Document> ] args Any number of documents.`
	`24`	`+ # @param [ Document... ] *args Any number of documents.`
`25`	`25`	`#`
`26`	`26`	`# @return [ Array<Document> ] The loaded docs.`
`27`	`27`	`def <<(*args)`
Original file line number	Diff line number	Diff line change
`@@ -215,13 +215,13 @@ def empty?`
`215`	`215`	`# completely depending on whether it is iterated to completion.`
`216`	`216`	`#`
`217`	`217`	`# This method can take a parameter and a block. The behavior with`
`218`		`- # either the paramater or the block is delegated to the standard`
	`218`	`+ # either the parameter or the block is delegated to the standard`
`219`	`219`	`# library Enumerable module.`
`220`	`220`	`#`
`221`	`221`	`# Note that when Enumerable's any? method is invoked with both`
`222`	`222`	`# a block and a pattern, it only uses the pattern.`
`223`	`223`	`#`
`224`		`- # @param [ Object ] condition The condition that documents`
	`224`	`+ # @param [ Object... ] *args The condition that documents`
`225`	`225`	`# must satisfy. See Enumerable documentation for details.`
`226`	`226`	`#`
`227`	`227`	`# @return [ true \| false ] If the association has any documents.`
Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ class Proxy < Association::Many`
`25`	`25`	`# @example Concat with other documents.`
`26`	`26`	`# person.posts.concat([ post_one, post_two ])`
`27`	`27`	`#`
`28`		`- # @param [ Document \| Array<Document> ] args Any number of documents.`
	`28`	`+ # @param [ Document... ] *args Any number of documents.`
`29`	`29`	`#`
`30`	`30`	`# @return [ Array<Document> ] The loaded docs.`
`31`	`31`	`def <<(*args)`
`@@ -199,7 +199,7 @@ def exists?`
`199`	`199`	`# @note This will keep matching documents in memory for iteration`
`200`	`200`	`# later.`
`201`	`201`	`#`
`202`		`- # @param [ Object \| Array<Object> ] *args The ids.`
	`202`	`+ # @param [ [ Object \| Array<Object> ]... ] *args The ids.`
`203`	`203`	`# @param [ Proc ] block Optional block to pass.`
`204`	`204`	`#`
`205`	`205`	`# @return [ Document \| Array<Document> \| nil ] A document or matching documents.`
`@@ -414,7 +414,7 @@ def cascade!(document)`
`414`	`414`	`# If the method exists on the array, use the default proxy behavior.`
`415`	`415`	`#`
`416`	`416`	`# @param [ Symbol \| String ] name The name of the method.`
`417`		`- # @param [ Array ] args The method args`
	`417`	`+ # @param [ Object... ] *args The method args`
`418`	`418`	`# @param [ Proc ] block Optional block to pass.`
`419`	`419`	`#`
`420`	`420`	`# @return [ Criteria \| Object ] A Criteria or return value from the target.`
Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ def reflect_on_association(name)`
`25`	`25`	`# @example Find multiple association metadata by macro.`
`26`	`26`	`# person.reflect_on_all_associations(:embeds_many)`
`27`	`27`	`#`
`28`		`- # @param [ Array<Symbol> ] macros The association macros.`
	`28`	`+ # @param [ Symbol... ] *macros The association macros.`
`29`	`29`	`#`
`30`	`30`	`# @return [ Array<Association> ] The matching association metadata.`
`31`	`31`	`def reflect_on_all_association(*macros)`
`@@ -51,7 +51,7 @@ def reflect_on_association(name)`
`51`	`51`	`# @example Find multiple association metadata by macro.`
`52`	`52`	`# Person.reflect_on_all_associations(:embeds_many)`
`53`	`53`	`#`
`54`		`- # @param [ Array<Symbol> ] macros The association macros.`
	`54`	`+ # @param [ Symbol... ] *macros The association macros.`
`55`	`55`	`#`
`56`	`56`	`# @return [ Array<Association> ] The matching association metadata.`
`57`	`57`	`def reflect_on_all_associations(*macros)`
Original file line number	Diff line number	Diff line change
`@@ -115,7 +115,7 @@ def inspect_dynamic_fields`
`115`	`115`	`# document.method_missing(:test)`
`116`	`116`	`#`
`117`	`117`	`# @param [ String \| Symbol ] name The name of the method.`
`118`		`- # @param [ Array ] args The arguments to the method.`
	`118`	`+ # @param [ Object... ] *args The arguments to the method.`
`119`	`119`	`#`
`120`	`120`	`# @return [ Object ] The result of the method call.`
`121`	`121`	`def method_missing(name, *args)`