honeymoose
/
angular-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: remove unnecessary `@linkDocs` tags (#24000) 

It is cleaner and simpler to use just a straightforward link.

PR Close #24000
This commit is contained in:
Pete Bacon Darwin 2018-05-18 12:19:29 +01:00 committed by Miško Hevery
parent e7b392bf3a
commit 38a0d1fac5
9 changed files with 39 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
packages/common/src/i18n/locale_data.ts
View File

@ -13,7 +13,7 @@ export const LOCALE_DATA: {[localeId: string]: any} = {};
/**
* Register global data to be used internally by Angular. See the
* {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale data.
* ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale data.
*
* @experimental i18n support is experimental.
*/

4
packages/common/src/i18n/locale_data_api.ts
View File

@ -427,7 +427,7 @@ function checkFullData(data: any) {
* You should fallback to AM/PM when there are no rules available.
*
* Note: this is only available if you load the full locale data.
* See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
* See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
* data.
*
* @experimental i18n support is experimental.
@ -452,7 +452,7 @@ export function getLocaleExtraDayPeriodRules(locale: string): (Time | [Time, Tim
* You should fallback to AM/PM when there are no day periods available.
*
* Note: this is only available if you load the full locale data.
* See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
* See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
* data.
*
* @experimental i18n support is experimental.

4
packages/common/src/pipes/date_pipe.ts
View File

@ -82,10 +82,10 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error';
* WARNINGS:
* - this pipe has only access to en-US locale data by default. If you want to localize the dates
* in another language, you will have to import data for other locales.
* See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
* See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
* data.
* - Fields suffixed with * are only available in the extra dataset.
* See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import extra locale
* See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import extra locale
* data.
* - this pipe is marked as pure hence it will not be re-evaluated when the input is mutated.
* Instead users should treat the date as an immutable object and change the reference when the

2
packages/core/src/di/injectable.ts
View File

@ -44,7 +44,7 @@ export interface InjectableDecorator {
* @description
* A marker metadata that marks a class as available to {@link Injector} for creation.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"(guide/dependency-injection).
*
* ### Example
*

2
packages/core/src/di/injector.ts
View File

@ -53,7 +53,7 @@ export class NullInjector implements Injector {
*
* Concrete injectors implement this interface.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*

10
packages/core/src/di/metadata.ts
View File

@ -31,7 +31,7 @@ export interface InjectDecorator {
* @description
* A parameter decorator that specifies a dependency.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -85,7 +85,7 @@ export interface OptionalDecorator {
* A parameter metadata that marks a dependency as optional.
* {@link Injector} provides `null` if the dependency is not found.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -130,7 +130,7 @@ export interface SelfDecorator {
* @description
* Specifies that an {@link Injector} should retrieve a dependency only from itself.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -176,7 +176,7 @@ export interface SkipSelfDecorator {
* @description
* Specifies that the dependency resolution should start from the parent injector.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -222,7 +222,7 @@ export interface HostDecorator {
* Specifies that an injector should retrieve a dependency from any injector until
* reaching the host element of the current component.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*

30
packages/core/src/di/provider.ts
View File

@ -18,7 +18,7 @@ import {Type} from '../type';
* @description
* Configures the `Injector` to return a value for a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -42,7 +42,7 @@ export interface ValueSansProvider {
* @description
* Configures the `Injector` to return a value for a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -77,7 +77,7 @@ export interface ValueProvider extends ValueSansProvider {
* @description
* Configures the `Injector` to return an instance of `useClass` for a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -111,7 +111,7 @@ export interface StaticClassSansProvider {
* @description
* Configures the `Injector` to return an instance of `useClass` for a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -149,7 +149,7 @@ export interface StaticClassProvider extends StaticClassSansProvider {
* @description
* Configures the `Injector` to return an instance of a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* @experimental
*/
@ -173,7 +173,7 @@ export interface ConstructorSansProvider {
* @description
* Configures the `Injector` to return an instance of a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -208,7 +208,7 @@ export interface ConstructorProvider extends ConstructorSansProvider {
* @description
* Configures the `Injector` to return a value of another `useExisting` token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -232,7 +232,7 @@ export interface ExistingSansProvider {
* @description
* Configures the `Injector` to return a value of another `useExisting` token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -269,7 +269,7 @@ export interface ExistingProvider extends ExistingSansProvider {
* @description
* Configures the `Injector` to return a value by invoking a `useFactory` function.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -302,7 +302,7 @@ export interface FactorySansProvider {
* @description
* Configures the `Injector` to return a value by invoking a `useFactory` function.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -337,7 +337,7 @@ export interface FactoryProvider extends FactorySansProvider {
* @description
* Describes how the `Injector` should be configured in a static way (Without reflection).
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
*
*/
@ -360,7 +360,7 @@ export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvi
* Create an instance by invoking the `new` operator and supplying additional arguments.
* This form is a short form of `TypeProvider`;
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -383,7 +383,7 @@ export interface TypeProvider extends Type<any> {}
* @description
* Configures the `Injector` to return a value by invoking a `useClass` function.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -410,7 +410,7 @@ export interface ClassSansProvider {
* @description
* Configures the `Injector` to return an instance of `useClass` for a token.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
* ### Example
*
@ -445,7 +445,7 @@ export interface ClassProvider extends ClassSansProvider {
* @description
* Describes how the `Injector` should be configured.
*
* For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
* For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
*
*
*/

8
packages/core/src/i18n/tokens.ts
View File

@ -13,7 +13,7 @@ import {InjectionToken} from '../di/injection_token';
* It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
* DecimalPipe and PercentPipe) and by ICU expressions.
*
* See the {@linkDocs guide/i18n#setting-up-locale i18n guide} for more information.
* See the [i18n guide](guide/i18n#setting-up-locale) for more information.
*
* ### Example
*
@ -35,7 +35,7 @@ export const LOCALE_ID = new InjectionToken<string>('LocaleId');
* Use this token at bootstrap to provide the content of your translation file (`xtb`,
* `xlf` or `xlf2`) when you want to translate your application in another language.
*
* See the {@linkDocs guide/i18n#merge i18n guide} for more information.
* See the [i18n guide](guide/i18n#merge) for more information.
*
* ### Example
*
@ -60,7 +60,7 @@ export const TRANSLATIONS = new InjectionToken<string>('Translations');
* Provide this token at bootstrap to set the format of your {@link TRANSLATIONS}: `xtb`,
* `xlf` or `xlf2`.
*
* See the {@linkDocs guide/i18n#merge i18n guide} for more information.
* See the [i18n guide](guide/i18n#merge) for more information.
*
* ### Example
*
@ -85,7 +85,7 @@ export const TRANSLATIONS_FORMAT = new InjectionToken<string>('TranslationsForma
* - Warning (default): show a warning in the console and/or shell.
* - Ignore: do nothing.
*
* See the {@linkDocs guide/i18n#missing-translation i18n guide} for more information.
* See the [i18n guide](guide/i18n#missing-translation) for more information.
*
* ### Example
* ```typescript

16
packages/core/src/metadata/lifecycle_hooks.ts
View File

@ -27,7 +27,7 @@ export interface SimpleChanges { [propName: string]: SimpleChange; }
* and content children are checked if at least one of them has changed.
* The `changes` parameter contains the changed properties.
*
* See {@linkDocs guide/lifecycle-hooks#onchanges "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#onchanges).
*
*
*/
@ -45,7 +45,7 @@ export interface OnChanges { ngOnChanges(changes: SimpleChanges): void; }
* first time, and before any of its children have been checked. It is invoked only once when the
* directive is instantiated.
*
* See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
*
*
*/
@ -69,7 +69,7 @@ export interface OnInit { ngOnInit(): void; }
* See {@link KeyValueDiffers} and {@link IterableDiffers} for implementing custom dirty checking
* for collections.
*
* See {@linkDocs guide/lifecycle-hooks#docheck "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#docheck).
*
*
*/
@ -85,7 +85,7 @@ export interface DoCheck { ngDoCheck(): void; }
* `ngOnDestroy` callback is typically used for any custom cleanup that needs to occur when the
* instance is destroyed.
*
* See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
*
*
*/
@ -100,7 +100,7 @@ export interface OnDestroy { ngOnDestroy(): void; }
* Lifecycle hook that is called after a directive's content has been fully
* initialized.
*
* See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
*
*
*/
@ -113,7 +113,7 @@ export interface AfterContentInit { ngAfterContentInit(): void; }
* @description
* Lifecycle hook that is called after every check of a directive's content.
*
* See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
*
*
*/
@ -127,7 +127,7 @@ export interface AfterContentChecked { ngAfterContentChecked(): void; }
* Lifecycle hook that is called after a component's view has been fully
* initialized.
*
* See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
*
*
*/
@ -140,7 +140,7 @@ export interface AfterViewInit { ngAfterViewInit(): void; }
* @description
* Lifecycle hook that is called after every check of a component's view.
*
* See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
* See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
*
*
*/