minor #11708 [DI] Add deprecation info for !tagged (jschaedl)

This PR was submitted for the master branch but it was squashed and merged into the 4.4 branch instead (closes #11708).

Discussion
----------

[DI] Add deprecation info for !tagged

Fixes #11706

Feature PR: symfony/symfony#31321

Commits
-------

65263e1 [DI] Add deprecation info for !tagged

Author: OskarStark

service_container/tags.rst

@@ -456,6 +456,10 @@ compiler pass just for that.
 In the following example, all services tagged with ``app.handler`` are passed as
 first  constructor argument to the ``App\HandlerCollection`` service:
 
+.. deprecated:: 4.4
+
+    ``tagged`` has been deprecated since version 4.4 and will be removed in 5.0. Use ``tagged_iterator`` instead.
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -470,7 +474,7 @@ first  constructor argument to the ``App\HandlerCollection`` service:
 
             App\HandlerCollection:
                 # inject all services tagged with app.handler as first argument
-                arguments: [!tagged app.handler]
+                arguments: [!tagged_iterator app.handler]
 
     .. code-block:: xml
 
@@ -492,7 +496,7 @@ first  constructor argument to the ``App\HandlerCollection`` service:
 
                 <service id="App\HandlerCollection">
                     <!-- inject all services tagged with app.handler as first argument -->
-                    <argument type="tagged" tag="app.handler"/>
+                    <argument type="tagged_iterator" tag="app.handler"/>
                 </service>
             </services>
         </container>