From 466e40428b626b1b2a0c707aacea072c0cf635b5 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sun, 3 Jan 2016 09:05:11 +0100
Subject: [PATCH] add back updateUserSecurityIdentity() hint

---
 cookbook/security/acl_advanced.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/cookbook/security/acl_advanced.rst b/cookbook/security/acl_advanced.rst
index d4f18265d82..13f3636076a 100644
--- a/cookbook/security/acl_advanced.rst
+++ b/cookbook/security/acl_advanced.rst
@@ -45,6 +45,14 @@ Security Identities
 This is analog to the object identity, but represents a user, or a role in
 your application. Each role, or user has its own security identity.
 
+.. caution::
+
+    For users, the security identity is based on the username. This means that,
+    if for any reason, a user's username was to change, you must ensure its
+    security identity is updated too. The
+    :method:`MutableAclProvider::updateUserSecurityIdentity() <Symfony\\Component\\Security\\Acl\\Dbal\\MutableAclProvider::updateUserSecurityIdentity>`
+    method is there to handle the update.
+
 Database Table Structure
 ------------------------