From 59549a89e40c8ee9b4083ec33f21d2c6a5ded13a Mon Sep 17 00:00:00 2001
From: Jennifer Hodgdon <yahgrp@poplarware.com>
Date: Sat, 10 Nov 2012 07:12:06 -0800
Subject: [PATCH] Issue #1822708 by penyaskito, asaal: Remove references to
 removed function user_save() in docs

---
 .../lib/Drupal/user/Tests/UserSaveTest.php    |  2 +-
 core/modules/user/user.api.php                | 22 ++++++++++---------
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/core/modules/user/lib/Drupal/user/Tests/UserSaveTest.php b/core/modules/user/lib/Drupal/user/Tests/UserSaveTest.php
index 6f975c219e7..be96d7ade49 100644
--- a/core/modules/user/lib/Drupal/user/Tests/UserSaveTest.php
+++ b/core/modules/user/lib/Drupal/user/Tests/UserSaveTest.php
@@ -10,7 +10,7 @@ namespace Drupal\user\Tests;
 use Drupal\simpletest\WebTestBase;
 
 /**
- * Tests user_save() behavior.
+ * Tests \Drupal\user\UserStorageController::save() behavior.
  */
 class UserSaveTest extends WebTestBase {
 
diff --git a/core/modules/user/user.api.php b/core/modules/user/user.api.php
index 8a21ef276a0..648cc0f82d1 100644
--- a/core/modules/user/user.api.php
+++ b/core/modules/user/user.api.php
@@ -257,11 +257,12 @@ function hook_user_presave($account) {
  *
  * Note that when this hook is invoked, the changes have not yet been written to
  * the database, because a database transaction is still in progress. The
- * transaction is not finalized until the save operation is entirely completed
- * and user_save() goes out of scope. You should not rely on data in the
- * database at this time as it is not updated yet. You should also note that any
- * write/update database queries executed from this hook are also not committed
- * immediately. Check user_save() and db_transaction() for more info.
+ * transaction is not finalized until the insert operation is entirely completed
+ * and \Drupal\user\DataStorageController::save() goes out of scope. You should
+ * not rely on data in the database at this time as it is not updated yet. You
+ * should also note that any write/update database queries executed from this hook
+ * are also not committed immediately. Check \Drupal\user\DataStorageController::save()
+ * and db_transaction() for more info.
  *
  * @param $account
  *   The user account object.
@@ -283,11 +284,12 @@ function hook_user_insert($account) {
  *
  * Note that when this hook is invoked, the changes have not yet been written to
  * the database, because a database transaction is still in progress. The
- * transaction is not finalized until the save operation is entirely completed
- * and user_save() goes out of scope. You should not rely on data in the
- * database at this time as it is not updated yet. You should also note that any
- * write/update database queries executed from this hook are also not committed
- * immediately. Check user_save() and db_transaction() for more info.
+ * transaction is not finalized until the update operation is entirely completed
+ * and \Drupal\user\DataStorageController::save() goes out of scope. You should not
+ * rely on data in the database at this time as it is not updated yet. You should
+ * also note that any write/update database queries executed from this hook are
+ * also not committed immediately. Check \Drupal\user\DataStorageController::save()
+ * and db_transaction() for more info.
  *
  * @param $account
  *   The user account object.