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
@@ -15,7 +15,7 @@ import {ValidationErrors} from './validators';
 *
 * Only used internally in the forms module.
 *
- * @stable
+ *
 */
 export abstract class AbstractControlDirective {
  /**
@@ -20,7 +20,7 @@ import {AsyncValidatorFn, ValidatorFn} from './validators';
 /**
 * This is a base class for code shared between `NgModelGroup` and `FormGroupName`.
 *
- * @stable
+ *
 */
 export class AbstractFormGroupDirective extends ControlContainer implements OnInit, OnDestroy {
  /** @internal */
@@ -24,7 +24,7 @@ export const CHECKBOX_VALUE_ACCESSOR: any = {
 *  <input type="checkbox" name="rememberLogin" ngModel>
 *  ```
 *
- *  @stable
+ *
 */
@Directive({
  selector:
@@ -15,7 +15,7 @@ import {Form} from './form_interface';
 *
 * Only used by the forms module.
 *
- * @stable
+ *
 */
 export abstract class ControlContainer extends AbstractControlDirective {
  name: string;
@@ -15,7 +15,7 @@ import {InjectionToken} from '@angular/core';
 * Implement this interface if you want to create a custom form control directive
 * that integrates with Angular forms.
 *
- * @stable
+ *
 */
 export interface ControlValueAccessor {
  /**
@@ -113,6 +113,6 @@ export interface ControlValueAccessor {
 * Used to provide a `ControlValueAccessor` for form controls.
 *
 * See `DefaultValueAccessor` for how to implement one.
- * @stable
+ *
 */
 export const NG_VALUE_ACCESSOR = new InjectionToken<ControlValueAccessor>('NgValueAccessor');
@@ -40,7 +40,7 @@ export const COMPOSITION_BUFFER_MODE = new InjectionToken<boolean>('CompositionE
 *  <input type="text" name="searchQuery" ngModel>
 *  ```
 *
- *  @stable
+ *
 */
@Directive({
  selector:
@@ -18,7 +18,7 @@ import {NgControl} from './ng_control';
 *
 * Only used by the forms module.
 *
- * @stable
+ *
 */
 export interface Form {
  /**
@@ -22,7 +22,7 @@ function unimplemented(): any {
 *
 * Used internally by Angular forms.
 *
- * @stable
+ *
 */
 export abstract class NgControl extends AbstractControlDirective {
  /** @internal */
@@ -49,7 +49,7 @@ export const ngControlStatusHost = {
 * * ng-untouched
 * * ng-touched
 *
- * @stable
+ *
 */
@Directive({selector: '[formControlName],[ngModel],[formControl]', host: ngControlStatusHost})
 export class NgControlStatus extends AbstractControlStatus {
@@ -60,7 +60,7 @@ export class NgControlStatus extends AbstractControlStatus {
 * Directive automatically applied to Angular form groups that sets CSS classes
 * based on control status (valid/invalid/dirty/etc).
 *
- * @stable
+ *
 */
@Directive({
  selector:
@@ -61,7 +61,7 @@ const resolvedPromise = Promise.resolve(null);
 *
 * * **NgModule**: `FormsModule`
 *
- *  @stable
+ *
 */
@Directive({
  selector: 'form:not([ngNoForm]):not([formGroup]),ngForm,[ngForm]',
@@ -101,7 +101,7 @@ const resolvedPromise = Promise.resolve(null);
 *
 * **NgModule**: `FormsModule`
 *
- *  @stable
+ *
 */
@Directive({
  selector: '[ngModel]:not([formControlName]):not([formControl])',
@@ -43,7 +43,7 @@ export const modelGroupProvider: any = {
 *
 * * **NgModule**: `FormsModule`
 *
- * @stable
+ *
 */
@Directive({selector: '[ngModelGroup]', providers: [modelGroupProvider], exportAs: 'ngModelGroup'})
 export class NgModelGroup extends AbstractFormGroupDirective implements OnInit, OnDestroy {
@@ -81,7 +81,7 @@ export class RadioControlRegistry {
 *
 *  * **npm package**: `@angular/forms`
 *
- *  @stable
+ *
 */
@Directive({
  selector:
@@ -134,7 +134,7 @@ export const formControlBinding: any = {
 * pattern with a config value of `"always"`. This may help to track down where in the code
 * the pattern is being used as the code is being updated.
 *
- *  @stable
+ *
 */
@Directive({selector: '[formControl]', providers: [formControlBinding], exportAs: 'ngForm'})

@@ -146,7 +146,7 @@ export const controlNameBinding: any = {
 * pattern with a config value of `"always"`. This may help to track down where in the code
 * the pattern is being used as the code is being updated.
 *
- *  @stable
+ *
 */
@Directive({selector: '[formControlName]', providers: [controlNameBinding]})
 export class FormControlName extends NgControl implements OnChanges, OnDestroy {
@@ -56,7 +56,7 @@ export const formDirectiveProvider: any = {
 *
 * **NgModule**: `ReactiveFormsModule`
 *
- *  @stable
+ *
 */
@Directive({
  selector: '[formGroup]',
@@ -65,7 +65,7 @@ export const formGroupNameProvider: any = {
 *
 * * **NgModule**: `ReactiveFormsModule`
 *
- * @stable
+ *
 */
@Directive({selector: '[formGroupName]', providers: [formGroupNameProvider]})
 export class FormGroupName extends AbstractFormGroupDirective implements OnInit, OnDestroy {
@@ -139,7 +139,7 @@ export const formArrayNameProvider: any = {
 *
 * * **NgModule**: `ReactiveFormsModule`
 *
- * @stable
+ *
 */
@Directive({selector: '[formArrayName]', providers: [formArrayNameProvider]})
 export class FormArrayName extends ControlContainer implements OnInit, OnDestroy {
@@ -87,7 +87,7 @@ function _extractId(valueString: string): string {
 *
 * * **npm package**: `@angular/forms`
 *
- * @stable
+ *
 */
@Directive({
  selector:
@@ -164,7 +164,7 @@ export class SelectControlValueAccessor implements ControlValueAccessor {
 *
 * See docs for `SelectControlValueAccessor` for usage examples.
 *
- * @stable
+ *
 */
@Directive({selector: 'option'})
 export class NgSelectOption implements OnDestroy {
@@ -67,7 +67,7 @@ abstract class HTMLCollection {
 * }
 * ```
 *
- * @stable
+ *
 */
@Directive({
  selector:
@@ -35,7 +35,7 @@ export type ValidationErrors = {
 * }
 * ```
 *
- * @stable
+ *
 */
 export interface Validator {
  validate(c: AbstractControl): ValidationErrors|null;
@@ -70,7 +70,7 @@ export const CHECKBOX_REQUIRED_VALIDATOR: StaticProvider = {
 * <input name="fullName" ngModel required>
 * ```
 *
- * @stable
+ *
 */
@Directive({
  selector:
@@ -167,12 +167,12 @@ export class EmailValidator implements Validator {
 }

 /**
- * @stable
+ *
 */
 export interface ValidatorFn { (c: AbstractControl): ValidationErrors|null; }

 /**
- * @stable
+ *
 */
 export interface AsyncValidatorFn {
  (c: AbstractControl): Promise<ValidationErrors|null>|Observable<ValidationErrors|null>;
@@ -195,7 +195,7 @@ export const MIN_LENGTH_VALIDATOR: any = {
 * A directive which installs the `MinLengthValidator` for any `formControlName`,
 * `formControl`, or control with `ngModel` that also has a `minlength` attribute.
 *
- * @stable
+ *
 */
@Directive({
  selector: '[minlength][formControlName],[minlength][formControl],[minlength][ngModel]',
@@ -245,7 +245,7 @@ export const MAX_LENGTH_VALIDATOR: any = {
 * `formControl`,
 * or control with `ngModel` that also has a `maxlength` attribute.
 *
- * @stable
+ *
 */
@Directive({
  selector: '[maxlength][formControlName],[maxlength][formControl],[maxlength][ngModel]',
@@ -296,7 +296,7 @@ export const PATTERN_VALIDATOR: any = {
 * ```
 * <input [name]="fullName" pattern="[a-zA-Z ]*" ngModel>
 * ```
- * @stable
+ *
 */
@Directive({
  selector: '[pattern][formControlName],[pattern][formControl],[pattern][ngModel]',
@@ -29,7 +29,7 @@ import {AbstractControl, FormArray, FormControl, FormGroup} from './model';
 *
 *  * **NgModule**: `ReactiveFormsModule`
 *
- * @stable
+ *
 */
@Injectable()
 export class FormBuilder {
@@ -16,7 +16,7 @@ import {FormBuilder} from './form_builder';

 /**
 * The ng module for forms.
- * @stable
+ *
 */
@NgModule({
  declarations: TEMPLATE_DRIVEN_DIRECTIVES,
@@ -28,7 +28,7 @@ export class FormsModule {

 /**
 * The ng module for reactive forms.
- * @stable
+ *
 */
@NgModule({
  declarations: [REACTIVE_DRIVEN_DIRECTIVES],
@@ -123,7 +123,7 @@ function isOptionsObj(
 * @see [Forms Guide](/guide/forms)
 * @see [Reactive Forms Guide](/guide/reactive-forms)
 * @see [Dynamic Forms Guide](/guide/dynamic-form)
- * @stable
+ *
 */
 export abstract class AbstractControl {
  /** @internal */
@@ -735,7 +735,7 @@ export abstract class AbstractControl {
 *
 * * **npm package**: `@angular/forms`
 *
- * @stable
+ *
 */
 export class FormControl extends AbstractControl {
  /** @internal */
@@ -978,7 +978,7 @@ export class FormControl extends AbstractControl {
 *
 * * **npm package**: `@angular/forms`
 *
- * @stable
+ *
 */
 export class FormGroup extends AbstractControl {
  constructor(
@@ -1314,7 +1314,7 @@ export class FormGroup extends AbstractControl {
 *
 * * **npm package**: `@angular/forms`
 *
- * @stable
+ *
 */
 export class FormArray extends AbstractControl {
  constructor(
@@ -36,7 +36,7 @@ function isEmptyInputValue(value: any): boolean {
 * }
 * ```
 *
- * @stable
+ *
 */
 export const NG_VALIDATORS = new InjectionToken<Array<Validator|Function>>('NgValidators');

@@ -48,7 +48,7 @@ export const NG_VALIDATORS = new InjectionToken<Array<Validator|Function>>('NgVa
 *
 * See `NG_VALIDATORS` for more details.
 *
- * @stable
+ *
 */
 export const NG_ASYNC_VALIDATORS =
    new InjectionToken<Array<Validator|Function>>('NgAsyncValidators');
@@ -68,7 +68,7 @@ const EMAIL_REGEXP =
 * var loginControl = new FormControl("", Validators.required)
 * ```
 *
- * @stable
+ *
 */
 export class Validators {
  /**
@@ -14,6 +14,6 @@

 import {Version} from '@angular/core';
 /**
- * @stable
+ *
 */
 export const VERSION = new Version('0.0.0-PLACEHOLDER');