Update reference documentation.

doc/reference/annotations.rst

@@ -52,6 +52,28 @@ This annotation can be defined on a property to specifiy to if the property
 should be serialized when only serializing specific groups (see
 :doc:`../cookbook/exclusion_strategies`).
 
+@RecursionGroups
+~~~~~~~~~~~~~~~~
+
+This annotation can be defined on a property to modify the active
+serialization groups when descending into referenced subobjects. You can
+replace the whole list or add and remove groups from the list.
+
+.. code-block :: php
+
+    <?php
+    use JMS\Serializer\Annotation\RecursionGroups
+
+    class User
+    {
+        private $id;
+
+        /** @RecursionGroups(set={"group"}, add={"Default"}, remove={"Default"}) */
+        private $name;
+
+        // ...
+    }
+
 @MaxDepth
 ~~~~~~~~~
 This annotation can be defined on a property to limit the depth to which the

doc/reference/xml_reference.rst

@@ -27,6 +27,9 @@ XML Reference
                       xml-key-value-pairs="true"
                       xml-attribute-map="true"
                       max-depth="2"
+                      recursion-groups-set="foo,bar"
+                      recursion-groups-add="foo,bar"
+                      recursion-groups-remove="foo,bar"
             >
                 <!-- You can also specify the type as element which is necessary if
                      your type contains "<" or ">" characters. -->

doc/reference/yml_reference.rst

@@ -53,6 +53,10 @@ YAML Reference
                     cdata: false
                     namespace: http://www.w3.org/2005/Atom
                 max_depth: 2
+                recursion_groups:
+                    set: [foo, bar]
+                    add: [foo, bar]
+                    remove: [foo, bar]
 
         handler_callbacks:
             serialization: