feature #7834 Added a note about ignoring invalid reference arguments in collection arguments (javiereguiluz)

xabbuh · xabbuh · commit 412fe84df0f0 · 2017-05-12T11:33:10.000+02:00
This PR was submitted for the 3.1 branch but it was merged into the 3.2 branch instead (closes #7834). Discussion ---------- Added a note about ignoring invalid reference arguments in collection arguments This fixes #6550. Commits ------- 0b2d9ba Added a note about ignoring invalid reference arguments in colleciton arguments
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
@@ -116,6 +116,12 @@ call if the service exists and remove the method call if it does not:
             ))
         ;
 
+.. note::
+
+    If the argument to the method call is a collection of arguments and any of
+    them is missing, those elements are removed but the method call is still
+    made with the remaining elements of the collection.
+
 In YAML, the special ``@?`` syntax tells the service container that the dependency
 is optional. Of course, the ``NewsletterManager`` must also be rewritten by
 adding a ``setMailer()`` method::
