From 29c06756cbb0e35731dbf35796c167b70fa62bce Mon Sep 17 00:00:00 2001
From: Eileen McNaughton <emcnaughton@wikimedia.org>
Date: Wed, 1 Nov 2023 16:09:07 +1300
Subject: [PATCH] Standardise deprecations

---
 CRM/Contact/BAO/Relationship.php        | 8 ++++++--
 CRM/Contact/Page/AJAX.php               | 4 +++-
 CRM/Contact/Page/View/Relationship.php  | 4 +++-
 CRM/Contact/Page/View/UserDashBoard.php | 2 +-
 4 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/CRM/Contact/BAO/Relationship.php b/CRM/Contact/BAO/Relationship.php
index dacab11fcf58..9d231e0fe40e 100644
--- a/CRM/Contact/BAO/Relationship.php
+++ b/CRM/Contact/BAO/Relationship.php
@@ -1807,7 +1807,9 @@ public static function membershipTypeToRelationshipTypes(&$params, $direction =
   }
 
   /**
-   * DELETEME only-used-by-user-dashboard
+   * @deprecated since 5.68. Will be removed around 5.74.
+   *
+   * Only-used-by-user-dashboard.
    */
   public static function getContactRelationshipSelector(&$params) {
     // format the params
@@ -1950,7 +1952,9 @@ public static function getContactRelationshipSelector(&$params) {
   }
 
   /**
-   * DELETEME only-used-by-user-dashboard
+   * @deprecated since 5.68. Will be removed around 5.74.
+   *
+   * Only-used-by-user-dashboard.
    */
   public static function getColumnHeaders() {
     return [
diff --git a/CRM/Contact/Page/AJAX.php b/CRM/Contact/Page/AJAX.php
index c90aa00f829c..9cacb36776d2 100644
--- a/CRM/Contact/Page/AJAX.php
+++ b/CRM/Contact/Page/AJAX.php
@@ -979,7 +979,9 @@ public static function toggleDedupeSelect() {
   }
 
   /**
-   * DELETEME only-used-by-user-dashboard
+   * @deprecated since 5.68. Will be removed around 5.74.
+   *
+   * Only-used-by-user-dashboard.
    */
   public static function getContactRelationships() {
     $contactID = CRM_Utils_Type::escape($_GET['cid'], 'Integer');
diff --git a/CRM/Contact/Page/View/Relationship.php b/CRM/Contact/Page/View/Relationship.php
index 0b0bb7eb8cfb..ec6ad2f88de7 100644
--- a/CRM/Contact/Page/View/Relationship.php
+++ b/CRM/Contact/Page/View/Relationship.php
@@ -227,7 +227,9 @@ public function delete() {
   }
 
   /**
-   * DELETEME only-used-by-user-dashboard
+   * @deprecated since 5.68. Will be removed around 5.74.
+   *
+   * Only-used-by-user-dashboard.
    *
    * @return array
    *   (reference) of action links
diff --git a/CRM/Contact/Page/View/UserDashBoard.php b/CRM/Contact/Page/View/UserDashBoard.php
index 5ac3aa23bced..5eee298b7536 100644
--- a/CRM/Contact/Page/View/UserDashBoard.php
+++ b/CRM/Contact/Page/View/UserDashBoard.php
@@ -129,7 +129,7 @@ public function buildUserDashBoard() {
     // Relationship section
     // FIXME - this used to share code with the contact summary "Relationships" tab
     // now that tab has been switched to use SearchKit, and this ought to be switched as well;
-    // then remove all code commented with "DELETEME only-used-by-user-dashboard"
+    // then remove all code commented with "only-used-by-user-dashboard"
     if (!empty($dashboardOptions['Permissioned Orgs']) && CRM_Core_Permission::check('view my contact')) {
       $columnHeaders = CRM_Contact_BAO_Relationship::getColumnHeaders();
       $contactRelationships = $selector = NULL;