Add gentle deprecation to debug_log_message

diff --git a/CRM/Core/Error.php b/CRM/Core/Error.php
index 1e0a7184013a62d7947eada062f638ebd72515df..92f14f1d9a62a8bbb83826fc56c37158c2444ea2 100644 (file)
--- a/CRM/Core/Error.php
+++ b/CRM/Core/Error.php
@@ -566,6 +566,10 @@ class CRM_Core_Error extends PEAR_ErrorStack {
    * Provided the user has the 'view debug output' the output should be displayed. In all
    * cases it should be logged.
    *
+   * @deprecated see https://docs.civicrm.org/dev/en/latest/framework/logging/
+   *
+   * Use (e.g) `Civi::log()->error()` (priority dependent).
+   *
    * @param string $message
    * @param bool $out
    *   Should we log or return the output.