docs: remove all deprecated @stable jsdoc tags (#23210)

These are no longer needed as stable docs are computed as those that do not have `@experimental` or `@deprecated` tags. PR Close #23210
2018-04-05 22:31:44 +01:00
parent ee145790d7
commit 4b96a58c5a
155 changed files with 363 additions and 643 deletions
--- a/packages/core/src/di/injectable.ts
+++ b/packages/core/src/di/injectable.ts
@ -30,7 +30,7 @@ export type InjectableProvider = ValueSansProvider | ExistingSansProvider |
 /**
 * Type of the Injectable decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface InjectableDecorator {
  /**
@ -54,7 +54,7 @@ export interface InjectableDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='InjectableThrows'}
   *
-   * @stable
+   *
   */
  (): any;
  (options?: {providedIn: Type<any>| 'root' | null}&InjectableProvider): any;
@ -113,7 +113,7 @@ export function convertInjectableProviderToFactory(
 /**
 * Injectable decorator and metadata.
 *
-* @stable
+*
 * @Annotation
 */
 export const Injectable: InjectableDecorator = makeDecorator(
--- a/packages/core/src/di/injection_token.ts
+++ b/packages/core/src/di/injection_token.ts
@ -46,7 +46,7 @@ import {InjectableDef, defineInjectable} from './defs';
 *
 * {@example core/di/ts/injector_spec.ts region='InjectionToken'}
 *
- * @stable
+ *
 */
 export class InjectionToken<T> {
  /** @internal */
--- a/packages/core/src/di/injector.ts
+++ b/packages/core/src/di/injector.ts
@ -58,7 +58,7 @@ export class NullInjector implements Injector {
 * `Injector` returns itself when given `Injector` as a token:
 * {@example core/di/ts/injector_spec.ts region='injectInjector'}
 *
- * @stable
+ *
 */
 export abstract class Injector {
  static THROW_IF_NOT_FOUND = _THROW_IF_NOT_FOUND;
@ -412,7 +412,7 @@ function getClosureSafeProperty<T>(objWithPropertyToExtract: T): string {
 /**
 * Injection flags for DI.
 *
- * @stable
+ *
 */
 export const enum InjectFlags {
  Default = 0,
--- a/packages/core/src/di/metadata.ts
+++ b/packages/core/src/di/metadata.ts
@ -16,7 +16,7 @@ import {EMPTY_ARRAY} from '../view/util';
 /**
 * Type of the Inject decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface InjectDecorator {
  /**
@ -44,7 +44,7 @@ export interface InjectDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='InjectWithoutDecorator'}
   *
-   * @stable
+   *
   */
  (token: any): any;
  new (token: any): Inject;
@ -53,14 +53,14 @@ export interface InjectDecorator {
 /**
 * Type of the Inject metadata.
 *
- * @stable
+ *
 */
 export interface Inject { token: any; }

 /**
 * Inject decorator and metadata.
 *
- * @stable
+ *
 * @Annotation
 */
 export const Inject: InjectDecorator = makeParamDecorator('Inject', (token: any) => ({token}));
@ -69,7 +69,7 @@ export const Inject: InjectDecorator = makeParamDecorator('Inject', (token: any)
 /**
 * Type of the Optional decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface OptionalDecorator {
  /**
@ -91,7 +91,7 @@ export interface OptionalDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='Optional'}
   *
-   * @stable
+   *
   */
  (): any;
  new (): Optional;
@ -100,14 +100,14 @@ export interface OptionalDecorator {
 /**
 * Type of the Optional metadata.
 *
- * @stable
+ *
 */
 export interface Optional {}

 /**
 * Optional decorator and metadata.
 *
- * @stable
+ *
 * @Annotation
 */
 export const Optional: OptionalDecorator = makeParamDecorator('Optional');
@ -115,7 +115,7 @@ export const Optional: OptionalDecorator = makeParamDecorator('Optional');
 /**
 * Type of the Self decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface SelfDecorator {
  /**
@ -136,7 +136,7 @@ export interface SelfDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='Self'}
   *
-   * @stable
+   *
   */
  (): any;
  new (): Self;
@ -145,14 +145,14 @@ export interface SelfDecorator {
 /**
 * Type of the Self metadata.
 *
- * @stable
+ *
 */
 export interface Self {}

 /**
 * Self decorator and metadata.
 *
- * @stable
+ *
 * @Annotation
 */
 export const Self: SelfDecorator = makeParamDecorator('Self');
@ -161,7 +161,7 @@ export const Self: SelfDecorator = makeParamDecorator('Self');
 /**
 * Type of the SkipSelf decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface SkipSelfDecorator {
  /**
@ -182,7 +182,7 @@ export interface SkipSelfDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='SkipSelf'}
   *
-   * @stable
+   *
   */
  (): any;
  new (): SkipSelf;
@ -191,14 +191,14 @@ export interface SkipSelfDecorator {
 /**
 * Type of the SkipSelf metadata.
 *
- * @stable
+ *
 */
 export interface SkipSelf {}

 /**
 * SkipSelf decorator and metadata.
 *
- * @stable
+ *
 * @Annotation
 */
 export const SkipSelf: SkipSelfDecorator = makeParamDecorator('SkipSelf');
@ -206,7 +206,7 @@ export const SkipSelf: SkipSelfDecorator = makeParamDecorator('SkipSelf');
 /**
 * Type of the Host decorator / constructor function.
 *
- * @stable
+ *
 */
 export interface HostDecorator {
  /**
@ -228,7 +228,7 @@ export interface HostDecorator {
   *
   * {@example core/di/ts/metadata_spec.ts region='Host'}
   *
-   * @stable
+   *
   */
  (): any;
  new (): Host;
@ -237,14 +237,14 @@ export interface HostDecorator {
 /**
 * Type of the Host metadata.
 *
- * @stable
+ *
 */
 export interface Host {}

 /**
 * Host decorator and metadata.
 *
- * @stable
+ *
 * @Annotation
 */
 export const Host: HostDecorator = makeParamDecorator('Host');
--- a/packages/core/src/di/provider.ts
+++ b/packages/core/src/di/provider.ts
@ -48,7 +48,7 @@ export interface ValueSansProvider {
 *
 * {@example core/di/ts/provider_spec.ts region='ValueProvider'}
 *
- * @stable
+ *
 */
 export interface ValueProvider extends ValueSansProvider {
  /**
@ -120,7 +120,7 @@ export interface StaticClassSansProvider {
 * Note that following two providers are not equal:
 * {@example core/di/ts/provider_spec.ts region='StaticClassProviderDifference'}
 *
- * @stable
+ *
 */
 export interface StaticClassProvider extends StaticClassSansProvider {
  /**
@ -183,7 +183,7 @@ export interface ConstructorSansProvider {
 *
 * {@example core/di/ts/provider_spec.ts region='ConstructorProvider'}
 *
- * @stable
+ *
 */
 export interface ConstructorProvider extends ConstructorSansProvider {
  /**
@ -218,7 +218,7 @@ export interface ConstructorProvider extends ConstructorSansProvider {
 *
 * {@example core/di/ts/provider_spec.ts region='ExistingSansProvider'}
 *
- * @stable
+ *
 */
 export interface ExistingSansProvider {
  /**
@ -242,7 +242,7 @@ export interface ExistingSansProvider {
 *
 * {@example core/di/ts/provider_spec.ts region='ExistingProvider'}
 *
- * @stable
+ *
 */
 export interface ExistingProvider extends ExistingSansProvider {
  /**
@ -315,7 +315,7 @@ export interface FactorySansProvider {
 * Dependencies can also be marked as optional:
 * {@example core/di/ts/provider_spec.ts region='FactoryProviderOptionalDeps'}
 *
- * @stable
+ *
 */
 export interface FactoryProvider extends FactorySansProvider {
  /**
@ -343,7 +343,7 @@ export interface FactoryProvider extends FactorySansProvider {
 *
 * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
 *
- * @stable
+ *
 */
 export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvider |
    ConstructorProvider | FactoryProvider | any[];
@ -370,7 +370,7 @@ export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvi
 *
 * {@example core/di/ts/provider_spec.ts region='TypeProvider'}
 *
- * @stable
+ *
 */
 export interface TypeProvider extends Type<any> {}

@ -423,7 +423,7 @@ export interface ClassSansProvider {
 * Note that following two providers are not equal:
 * {@example core/di/ts/provider_spec.ts region='ClassProviderDifference'}
 *
- * @stable
+ *
 */
 export interface ClassProvider extends ClassSansProvider {
  /**
@ -451,7 +451,7 @@ export interface ClassProvider extends ClassSansProvider {
 *
 * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
 *
- * @stable
+ *
 */
 export type Provider =
    TypeProvider | ValueProvider | ClassProvider | ExistingProvider | FactoryProvider | any[];
--- a/packages/core/src/di/reflective_errors.ts
+++ b/packages/core/src/di/reflective_errors.ts
@ -187,7 +187,7 @@ export function invalidProviderError(provider: any) {
 *
 * expect(() => Injector.resolveAndCreate([A,B])).toThrowError();
 * ```
- * @stable
+ *
 */
 export function noAnnotationError(typeOrFunc: Type<any>| Function, params: any[][]): Error {
  const signature: string[] = [];
@ -218,7 +218,7 @@ export function noAnnotationError(typeOrFunc: Type<any>| Function, params: any[]
 *
 * expect(() => injector.getAt(100)).toThrowError();
 * ```
- * @stable
+ *
 */
 export function outOfBoundsError(index: number) {
  return Error(`Index ${index} is out-of-bounds.`);