From 3899003c4e063f895d149926fe476777e2af4b5d Mon Sep 17 00:00:00 2001
From: Bartek Pacia <bartek.pacia@jetbrains.com>
Date: Tue, 25 Nov 2025 14:23:56 +0100
Subject: [PATCH] [platform] IDEA-382389 deprecate for removal:
 ProblemDescriptorUtil.LOC_REFERENCE

Also add some Javadoc.

GitOrigin-RevId: 5c70094f085babf7c526fcbb4c83b0b881bd6716
---
 .../intellij/codeInspection/ProblemDescriptorUtil.java    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/platform/analysis-impl/src/com/intellij/codeInspection/ProblemDescriptorUtil.java b/platform/analysis-impl/src/com/intellij/codeInspection/ProblemDescriptorUtil.java
index f092e5e785e3..2cdd23827656 100644
--- a/platform/analysis-impl/src/com/intellij/codeInspection/ProblemDescriptorUtil.java
+++ b/platform/analysis-impl/src/com/intellij/codeInspection/ProblemDescriptorUtil.java
@@ -37,7 +37,15 @@ public final class ProblemDescriptorUtil {
   static final int APPEND_LINE_NUMBER = 0x00000001;
   public static final int TRIM_AT_TREE_END = 0x00000004;
 
+  /**
+   * @see CommonProblemDescriptor#getDescriptionTemplate
+   * @deprecated See IDEA-382389 for discussion and reasons for removal.
+   */
+  @Deprecated(forRemoval = true)
   public static final @NonNls String LOC_REFERENCE = "#loc";
+  /**
+   * @see CommonProblemDescriptor#getDescriptionTemplate
+   */
   public static final @NonNls String REF_REFERENCE = "#ref";
 
   @MagicConstant(flags = {NONE, APPEND_LINE_NUMBER, TRIM_AT_TREE_END})