From df585b39921b0a0145f22e1534f423ca9482c845 Mon Sep 17 00:00:00 2001
From: Eileen McNaughton <emcnaughton@wikimedia.org>
Date: Tue, 9 Aug 2022 12:09:38 +1200
Subject: [PATCH] Mark a few functions deprecated for clarity

m
---
 CRM/Import/Parser.php         | 18 ++++++++++++++++++
 CRM/Utils/DeprecatedUtils.php |  2 ++
 2 files changed, 20 insertions(+)

diff --git a/CRM/Import/Parser.php b/CRM/Import/Parser.php
index f50cff2fd1..b4c7bb7d4f 100644
--- a/CRM/Import/Parser.php
+++ b/CRM/Import/Parser.php
@@ -581,6 +581,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
   }
 
   /**
+   * @deprecated
+   *
    * @return array
    */
   public function getDataPatterns():array {
@@ -597,6 +599,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
    * @param array $values
    * @param string $enclosure
    *
+   * @deprecated
+   *
    * @return void
    */
   public static function encloseScrub(&$values, $enclosure = "'") {
@@ -612,6 +616,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
   /**
    * Setter function.
    *
+   * @deprecated
+   *
    * @param int $max
    *
    * @return void
@@ -762,6 +768,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
   /**
    * Determines the file extension based on error code.
    *
+   * @deprecated
+   *
    * @var int $type error code constant
    * @return string
    */
@@ -797,6 +805,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
   /**
    * Determines the file name based on error code.
    *
+   * @deprecated
+   *
    * @var int $type code constant
    * @return string
    */
@@ -831,6 +841,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
    *
    * @param array $formatValues
    *
+   * @deprecated
+   *
    * @return array
    */
   protected function checkContactDuplicate(&$formatValues) {
@@ -917,6 +929,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
    *   The structured parameter list.
    *
    * @return bool|CRM_Utils_Error
+   *
+   * @deprecated
    */
   private function _civicrm_api3_deprecated_add_formatted_param(&$values, &$params) {
     // @todo - like most functions in import ... most of this is cruft....
@@ -1198,6 +1212,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
    *
    * but if not available then see if we have a label that can be converted to a name.
    *
+   * @deprecated
+   *
    * @param string|int|null $submittedValue
    * @param array $fieldSpec
    *   Metadata for the field
@@ -2030,6 +2046,8 @@ abstract class CRM_Import_Parser implements UserJobInterface {
    *   Type of date.
    * @param string $dateParam
    *   Index of params.
+   *
+   * @deprecated
    */
   public static function formatCustomDate(&$params, &$formatted, $dateType, $dateParam) {
     //fix for CRM-2687
diff --git a/CRM/Utils/DeprecatedUtils.php b/CRM/Utils/DeprecatedUtils.php
index 4bfe2c71f4..2727dbc58e 100644
--- a/CRM/Utils/DeprecatedUtils.php
+++ b/CRM/Utils/DeprecatedUtils.php
@@ -25,6 +25,8 @@
 require_once 'api/v3/utils.php';
 
 /**
+ *
+ * @deprecated
  *
  * @param array $params
  *
-- 
2.25.1