[languages] deprecated language contribution points

Use VS Code extensions instead. Signed-off-by: Anton Kosyakov <anton.kosyakov@typefox.io>
eclipse-theia · Jun 30, 2020 · b2856fd · b2856fd
1 parent f069ff7
commit b2856fd
Show file tree

Hide file tree

Showing 4 changed files with 20 additions and 2 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,11 +6,15 @@
 
 Breaking Changes:
 
-- <a name="1_4_0_replace_json">[json]</a> replaced `@theia/json` Theia extension with `vscode.json-language-features` VS Code extension [#7972](https://github.com/eclipse-theia/theia/pull/7972)
+<a name="1_4_0_replace_json"></a>
+- [[json]](#1_4_0_replace_json) replaced `@theia/json` Theia extension with `vscode.json-language-features` VS Code extension [#8112](https://github.com/eclipse-theia/theia/pull/8112)
   - You can register JSON validations at application startup by implementing `JsonSchemaContribution` Theia contribution point.
   - Alternatively you can provide JSON validations using VS Code [contributes.jsonValidation](https://code.visualstudio.com/api/references/contribution-points#contributes.jsonValidation) contribution point.
-- <a name="1_4_0_absolute_user_storage_uri">[user-storage]</a> settings URI must be an absolute to satisfy expectations of `vscode.json-language-features` [#7972](https://github.com/eclipse-theia/theia/pull/7972)
+<a name="1_4_0_absolute_user_storage_uri"></a>
+- [[user-storage]](#1_4_0_absolute_user_storage_uri) settings URI must be an absolute to satisfy expectations of `vscode.json-language-features` [#8112](https://github.com/eclipse-theia/theia/pull/8112)
   - If you imlpement a custom user storage make sure to check old relaitve locations, otherwise it can cause user data loss.
+<a name="1_4_0_deprecate_languages"></a>
+- [[languages]](#1_4_0_deprecate_languages) `@theia/languages` extension is deprecated, use VS Code extensions to provide language smartness [#8112](https://github.com/eclipse-theia/theia/pull/8112)
 
 ## v1.3.0
 

diff --git a/packages/languages/README.md b/packages/languages/README.md
@@ -1,3 +1,5 @@
+> Deprecated since 1.4.0 - use VS Code extensions to contribute language smartness
+
 <div align='center'>
 
 <br />

diff --git a/packages/languages/src/browser/language-client-contribution.ts b/packages/languages/src/browser/language-client-contribution.ts
@@ -31,6 +31,9 @@ import { WorkspaceService } from '@theia/workspace/lib/browser';
 import { InitializeParams } from 'monaco-languageclient';
 import { Deferred } from '@theia/core/lib/common/promise-util';
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness
+ */
 export const LanguageClientContribution = Symbol('LanguageClientContribution');
 export interface LanguageClientContribution extends LanguageContribution {
     readonly running: boolean;
@@ -41,6 +44,9 @@ export interface LanguageClientContribution extends LanguageContribution {
     restart(): void;
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness
+ */
 @injectable()
 export abstract class BaseLanguageClientContribution implements LanguageClientContribution {
 

diff --git a/packages/languages/src/node/language-server-contribution.ts b/packages/languages/src/node/language-server-contribution.ts
@@ -42,11 +42,17 @@ export interface LanguageServerStartOptions {
     parameters?: any
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness
+ */
 export const LanguageServerContribution = Symbol('LanguageServerContribution');
 export interface LanguageServerContribution extends LanguageContribution {
     start(clientConnection: IConnection, options: LanguageServerStartOptions): MaybePromise<void>;
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness
+ */
 @injectable()
 export abstract class BaseLanguageServerContribution implements LanguageServerContribution {