From e92bfa4f76054e0e3c266dc2bf83229a60e7d073 Mon Sep 17 00:00:00 2001
From: Rootie <rootie232@googlemail.com>
Date: Fri, 8 Aug 2014 07:54:47 +0200
Subject: [PATCH 1/3] Don't use deprecated functions in Callback.rst

The addViolationAt function is marked as deprecated and should be replaced by buildViolation according to the Symfony update guides.
---
 reference/constraints/Callback.rst | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 36b55e97910..2491419f1c8 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -114,12 +114,9 @@ those errors should be attributed::
 
             // check if the name is actually a fake name
             if (in_array($this->getFirstName(), $fakeNames)) {
-                $context->addViolationAt(
-                    'firstName',
-                    'This name sounds totally fake!',
-                    array(),
-                    null
-                );
+                $context->buildViolation('This name sounds totally fake!')
+                    ->atPath('firstName')
+                    ->addViolation();
             }
         }
     }
@@ -137,12 +134,9 @@ have access to the object instance, they receive the object as the first argumen
 
         // check if the name is actually a fake name
         if (in_array($object->getFirstName(), $fakeNames)) {
-            $context->addViolationAt(
-                'firstName',
-                'This name sounds totally fake!',
-                array(),
-                null
-            );
+                $context->buildViolation('This name sounds totally fake!')
+                    ->atPath('firstName')
+                    ->addViolation();
         }
     }
 

From ea9a16b5db0a0b23a2c7e244587a23b59475e257 Mon Sep 17 00:00:00 2001
From: Rootie <rootie232@googlemail.com>
Date: Sat, 9 Aug 2014 00:02:22 +0200
Subject: [PATCH 2/3] Update custom_contraint.rst to meet the new 2.5 api

---
 cookbook/validation/custom_constraint.rst | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/cookbook/validation/custom_constraint.rst b/cookbook/validation/custom_constraint.rst
index 1aa828b76a0..2dc1d4d03d6 100644
--- a/cookbook/validation/custom_constraint.rst
+++ b/cookbook/validation/custom_constraint.rst
@@ -65,9 +65,9 @@ The validator class is also simple, and only has one required method ``validate(
         public function validate($value, Constraint $constraint)
         {
             if (!preg_match('/^[a-zA-Za0-9]+$/', $value, $matches)) {
-                $this->context->addViolation(
-                    $constraint->message,
-                    array('%string%' => $value)
+                $this->context->buildViolation($constraint->message)
+                    ->setParameter('%string%', $value)
+                    ->addViolation();
                 );
             }
         }
@@ -76,11 +76,17 @@ The validator class is also simple, and only has one required method ``validate(
 .. note::
 
     The ``validate`` method does not return a value; instead, it adds violations
-    to the validator's ``context`` property with an ``addViolation`` method
-    call if there are validation failures. Therefore, a value could be considered
-    as being valid if it causes no violations to be added to the context.
-    The first parameter of the ``addViolation`` call is the error message to
-    use for that violation.
+    to the validator's ``context`` property. Therefore, a value could be considered
+    as being valid if it causes no violations to be added to the context.The
+    violation is constructed and added to the context using a
+    ``ConstraintViolationBuilder`` returned by the ``buildViolation`` method
+    call. The parameter given to the ``buildViolation`` call is the error message
+    to use for that violation. The ``addViolation`` method call finally adds the
+    violation to the context.
+
+.. versionadded:: 2.5
+    The ``buildViolation`` method was added in Symfony 2.5. For usage examples with
+    older Symfony versions, see the corresponding versions of this documentation page.
 
 Using the new Validator
 -----------------------

From 1e27862fb1d0eb94536e65ddd0d46cc229fd1fd2 Mon Sep 17 00:00:00 2001
From: Rootie <rootie232@googlemail.com>
Date: Sat, 9 Aug 2014 00:05:33 +0200
Subject: [PATCH 3/3] added a versionadded comment to Callback.rst

---
 reference/constraints/Callback.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 2491419f1c8..e9b8b423fae 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -121,6 +121,10 @@ those errors should be attributed::
         }
     }
 
+.. versionadded:: 2.5
+    The ``buildViolation`` method was added in Symfony 2.5. For usage examples with
+    older Symfony versions, see the corresponding versions of this documentation page.
+
 Static Callbacks
 ----------------