From e01bbdfd1f4dbac33a2090b395e0def2fd33b8cd Mon Sep 17 00:00:00 2001
From: Keerti Parthasarathy <keertip@google.com>
Date: Mon, 2 Dec 2024 21:10:21 +0000
Subject: [PATCH] Deprecate completions from plugins api.

Change-Id: I92737e2df4736672c93fc9a08eb7c90a41192afb
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/397882
Commit-Queue: Keerti Parthasarathy <keertip@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Reviewed-by: Samuel Rawlins <srawlins@google.com>
---
 pkg/analyzer_plugin/doc/api.html                                | 2 ++
 .../test/integration/support/integration_test_methods.dart      | 2 ++
 pkg/analyzer_plugin/tool/spec/plugin_spec.html                  | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/pkg/analyzer_plugin/doc/api.html b/pkg/analyzer_plugin/doc/api.html
index 7d8470335b4..6c4271dce65 100644
--- a/pkg/analyzer_plugin/doc/api.html
+++ b/pkg/analyzer_plugin/doc/api.html
@@ -673,6 +673,7 @@ a:focus, a:hover {
         </p>
       </dd></dl></dd></dl>
 <h2 class="domain"><a name="domain_completion">completion domain</a></h2>
+  <p>Deprecated - no longer supported.</p>
   <p>
     The code completion domain contains API's related to getting code completion
     suggestions.
@@ -694,6 +695,7 @@ a:focus, a:hover {
     "<b>results</b>": List&lt;<a href="#type_CompletionSuggestion">CompletionSuggestion</a>&gt;
   }
 }</pre></div>
+    <p>Deprecated - no longer supported.</p>
     <p>
       Used to request that completion suggestions for the given offset in the
       given file be returned.
diff --git a/pkg/analyzer_plugin/test/integration/support/integration_test_methods.dart b/pkg/analyzer_plugin/test/integration/support/integration_test_methods.dart
index 4124b857529..e2658deede2 100644
--- a/pkg/analyzer_plugin/test/integration/support/integration_test_methods.dart
+++ b/pkg/analyzer_plugin/test/integration/support/integration_test_methods.dart
@@ -433,6 +433,8 @@ abstract class IntegrationTestMixin {
   /// Stream controller for [onAnalysisOutline].
   late StreamController<AnalysisOutlineParams> _onAnalysisOutline;
 
+  /// Deprecated - no longer supported.
+  ///
   /// Used to request that completion suggestions for the given offset in the
   /// given file be returned.
   ///
diff --git a/pkg/analyzer_plugin/tool/spec/plugin_spec.html b/pkg/analyzer_plugin/tool/spec/plugin_spec.html
index 006d5f19113..9984810a4c4 100644
--- a/pkg/analyzer_plugin/tool/spec/plugin_spec.html
+++ b/pkg/analyzer_plugin/tool/spec/plugin_spec.html
@@ -542,11 +542,13 @@
   </notification>
 </domain>
 <domain name="completion">
+  <p>Deprecated - no longer supported.</p>
   <p>
     The code completion domain contains API's related to getting code completion
     suggestions.
   </p>
   <request method="getSuggestions">
+    <p>Deprecated - no longer supported.</p>
     <p>
       Used to request that completion suggestions for the given offset in the
       given file be returned.