From 60582e7d672a26db4b2a3cd9126f18d7d3ad9c8b Mon Sep 17 00:00:00 2001
From: Andreas Ferber <af+git@chaos-agency.de>
Date: Tue, 15 Oct 2013 15:18:22 +0200
Subject: [PATCH] Update reference documentation.

---
 doc/reference/annotations.rst   | 22 ++++++++++++++++++++++
 doc/reference/xml_reference.rst |  3 +++
 doc/reference/yml_reference.rst |  4 ++++
 3 files changed, 29 insertions(+)

diff --git a/doc/reference/annotations.rst b/doc/reference/annotations.rst
index 25e5f3695..bffd3f7f5 100644
--- a/doc/reference/annotations.rst
+++ b/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
diff --git a/doc/reference/xml_reference.rst b/doc/reference/xml_reference.rst
index 214113d8a..b9a3d30d0 100644
--- a/doc/reference/xml_reference.rst
+++ b/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. -->
diff --git a/doc/reference/yml_reference.rst b/doc/reference/yml_reference.rst
index 05db24bf7..c22e0f634 100644
--- a/doc/reference/yml_reference.rst
+++ b/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: