diff --git a/aio/content/guide/angular-compiler-options.md b/aio/content/guide/angular-compiler-options.md index e4f22ec258..caab12c89a 100644 --- a/aio/content/guide/angular-compiler-options.md +++ b/aio/content/guide/angular-compiler-options.md @@ -1,6 +1,6 @@ # Angular compiler options -When you use [AoT compilation](guide/aot-compiler), you can control how your application is compiled by specifying *template* compiler options in the `tsconfig.json` [TypeScript configuration file](guide/typescript-configuration). +When you use [AOT compilation](guide/aot-compiler), you can control how your application is compiled by specifying *template* compiler options in the `tsconfig.json` [TypeScript configuration file](guide/typescript-configuration). The template options object, `angularCompilerOptions`, is a sibling to the `compilerOptions` object that supplies standard options to the TypeScript compiler. @@ -21,7 +21,7 @@ The template options object, `angularCompilerOptions`, is a sibling to the `comp {@a tsconfig-extends} ## Configuration inheritance with extends -Like the TypeScript compiler, The Angular AoT compiler also supports `extends` in the `angularCompilerOptions` section of the TypeScript configuration file, `tsconfig.json`. +Like the TypeScript compiler, The Angular AOT compiler also supports `extends` in the `angularCompilerOptions` section of the TypeScript configuration file, `tsconfig.json`. The `extends` property is at the top level, parallel to `compilerOptions` and `angularCompilerOptions`. A TypeScript configuration can inherit settings from another file using the `extends` property. @@ -48,7 +48,7 @@ For more information, see the [TypeScript Handbook](https://www.typescriptlang.o ## Template options -The following options are available for configuring the AoT template compiler. +The following options are available for configuring the AOT template compiler. ### `allowEmptyCodegenFiles` diff --git a/aio/content/guide/aot-metadata-errors.md b/aio/content/guide/aot-metadata-errors.md index 01b8df44bb..d3c641f3e7 100644 --- a/aio/content/guide/aot-metadata-errors.md +++ b/aio/content/guide/aot-metadata-errors.md @@ -518,7 +518,7 @@ const raw = String.raw`A tagged template ${expression} string`; [`String.raw()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/raw) is a _tag function_ native to JavaScript ES2015. -The AoT compiler does not support tagged template expressions; avoid them in metadata expressions. +The AOT compiler does not support tagged template expressions; avoid them in metadata expressions.
diff --git a/aio/content/guide/creating-libraries.md b/aio/content/guide/creating-libraries.md index d56c3a3c0c..f3e322e337 100644 --- a/aio/content/guide/creating-libraries.md +++ b/aio/content/guide/creating-libraries.md @@ -48,7 +48,7 @@ You can build, test, and lint the project with CLI commands: Notice that the configured builder for the project is different from the default builder for app projects. -This builder, among other things, ensures that the library is always built with the [AoT compiler](guide/aot-compiler), without the need to specify the `--prod` flag. +This builder, among other things, ensures that the library is always built with the [AOT compiler](guide/aot-compiler), without the need to specify the `--prod` flag. To make library code reusable you must define a public API for it. This "user layer" defines what is available to consumers of your library. A user of your library should be able to access public functionality (such as NgModules, service providers and general utility functions) through a single import path. diff --git a/aio/content/guide/universal.md b/aio/content/guide/universal.md index 86dc12a0fa..2e0a2bf77f 100644 --- a/aio/content/guide/universal.md +++ b/aio/content/guide/universal.md @@ -26,7 +26,7 @@ The CLI schematic `@nguniversal/express-engine` performs the required steps, as The [Tour of Heroes tutorial](tutorial) is the foundation for this walkthrough. In this example, the Angular CLI compiles and bundles the Universal version of the app with the -[Ahead-of-Time (AoT) compiler](guide/aot-compiler). +[Ahead-of-Time (AOT) compiler](guide/aot-compiler). A Node Express web server compiles HTML pages with Universal based on client requests. To create the server-side app module, `app.server.module.ts`, run the following CLI command. diff --git a/aio/content/navigation.json b/aio/content/navigation.json index 5e236bc44a..59ecb228eb 100644 --- a/aio/content/navigation.json +++ b/aio/content/navigation.json @@ -594,23 +594,23 @@ "hidden": true }, { - "title": "AoT Compiler", + "title": "AOT Compiler", "tooltip": "Understanding ahead-of-time compilation.", "children": [ { "url": "guide/aot-compiler", "title": "Ahead-of-Time Compilation", - "tooltip": "Learn why and how to use the Ahead-of-Time (AoT) compiler." + "tooltip": "Learn why and how to use the Ahead-of-Time (AOT) compiler." }, { "url": "guide/angular-compiler-options", "title": "Angular Compiler Options", - "tooltip": "Configuring AoT compilation." + "tooltip": "Configuring AOT compilation." }, { "url": "guide/aot-metadata-errors", - "title": "AoT Metadata Errors", - "tooltip": "Troubleshooting AoT compilation." + "title": "AOT Metadata Errors", + "tooltip": "Troubleshooting AOT compilation." }, { "url": "guide/template-typecheck", diff --git a/aio/tools/example-zipper/exampleZipper.js b/aio/tools/example-zipper/exampleZipper.js index ff077b16d3..1dc43f16c6 100644 --- a/aio/tools/example-zipper/exampleZipper.js +++ b/aio/tools/example-zipper/exampleZipper.js @@ -112,7 +112,7 @@ class ExampleZipper { '!**/npm-debug.log', '!**/example-config.json', '!**/wallaby.js', - // AoT related files + // AOT related files '!**/aot/**/*.*', '!**/*-aot.*' ]; diff --git a/packages/compiler/design/architecture.md b/packages/compiler/design/architecture.md index c21ac1399b..d8427a61c8 100644 --- a/packages/compiler/design/architecture.md +++ b/packages/compiler/design/architecture.md @@ -169,7 +169,7 @@ Angular supports the following class decorators: There are also a list of helper decorators that make the `@Component` and `@Directive` easier to use such as `@Input`, `@Output`, etc.; as well as a set of decorators that help `@Injectable` classes customize the injector such as `@Inject` and `@SkipSelf`. -Each of the class decorators can be thought of as class transformers that take the declared class and transform it, possibly using information from the helper decorators, to produce an Angular class. The JIT compiler performs this transformation at runtime. The AoT compiler performs this transformation at compile time. +Each of the class decorators can be thought of as class transformers that take the declared class and transform it, possibly using information from the helper decorators, to produce an Angular class. The JIT compiler performs this transformation at runtime. The AOT compiler performs this transformation at compile time. Each of the class decorators' class transformer creates a corresponding static member on the class that describes to the runtime how to use the class. For example, the `@Component` decorator creates a `ɵcmp` static member, `@Directive` create a `ɵdir`, etc. Internally, these class transformers are called a "Compiler". Most of the compilers are straight forward translations of the metadata specified in the decorator to the information provided in the corresponding definition and, therefore, do not require anything outside the source file to perform the conversion. However, the component, during production builds and for type checking a template require the module scope of the component which requires information from other files in the program. diff --git a/packages/core/src/render3/STATUS.md b/packages/core/src/render3/STATUS.md index c2648c11c5..a1e47a0100 100644 --- a/packages/core/src/render3/STATUS.md +++ b/packages/core/src/render3/STATUS.md @@ -52,7 +52,7 @@ A tool which "upgrades" `node_module` compiled with non-ivy `ngc` into ivy compl ## `@angular/core` changes -The goal is for the `@Component` (and friends) to be the compiler of template. Since decorators are functions which execute during parsing of the `.js` file, the decorator can compile the template into Ivy. The AoT compiler's job is to remove the `@Component` and replace it with call to `ɵɵdefineComponent`. +The goal is for the `@Component` (and friends) to be the compiler of template. Since decorators are functions which execute during parsing of the `.js` file, the decorator can compile the template into Ivy. The AOT compiler's job is to remove the `@Component` and replace it with call to `ɵɵdefineComponent`. - ✅ `@angular/compiler` can patch itself onto: - ✅ `@Injectable` diff --git a/packages/examples/upgrade/static/ts/full/module.ts b/packages/examples/upgrade/static/ts/full/module.ts index 217de1a4d6..2e908f0ed0 100644 --- a/packages/examples/upgrade/static/ts/full/module.ts +++ b/packages/examples/upgrade/static/ts/full/module.ts @@ -6,7 +6,7 @@ * found in the LICENSE file at https://angular.io/license */ // #docplaster -import {Component, Directive, ElementRef, EventEmitter, Inject, Injectable, Injector, Input, NgModule, Output} from '@angular/core'; +import {Component, Directive, ElementRef, EventEmitter, Injectable, Injector, Input, NgModule, Output} from '@angular/core'; import {BrowserModule} from '@angular/platform-browser'; import {platformBrowserDynamic} from '@angular/platform-browser-dynamic'; import {UpgradeComponent, UpgradeModule, downgradeComponent, downgradeInjectable} from '@angular/upgrade/static'; @@ -176,6 +176,6 @@ ng1AppModule.component('exampleApp', { // #docregion bootstrap-ng2 // We bootstrap the Angular module as we would do in a normal Angular app. -// (We are using the dynamic browser platform as this example has not been compiled AoT.) +// (We are using the dynamic browser platform as this example has not been compiled AOT.) platformBrowserDynamic().bootstrapModule(Ng2AppModule); // #enddocregion diff --git a/packages/examples/upgrade/static/ts/lite/module.ts b/packages/examples/upgrade/static/ts/lite/module.ts index dec1613ebb..806c8022e8 100644 --- a/packages/examples/upgrade/static/ts/lite/module.ts +++ b/packages/examples/upgrade/static/ts/lite/module.ts @@ -141,7 +141,7 @@ class MyLazyAngularModule { const ng2BootstrapFn = (extraProviders: StaticProvider[]) => platformBrowserDynamic(extraProviders).bootstrapModule(MyLazyAngularModule); // #enddocregion -// (We are using the dynamic browser platform, as this example has not been compiled AoT.) +// (We are using the dynamic browser platform, as this example has not been compiled AOT.) // #docregion basic-how-to diff --git a/packages/upgrade/src/common/src/downgrade_component.ts b/packages/upgrade/src/common/src/downgrade_component.ts index 1fd75a06d8..139bfdb59e 100644 --- a/packages/upgrade/src/common/src/downgrade_component.ts +++ b/packages/upgrade/src/common/src/downgrade_component.ts @@ -21,7 +21,7 @@ import {LazyModuleRef, UpgradeAppType, controllerKey, getDowngradedModuleCount, * A helper function that allows an Angular component to be used from AngularJS. * * *Part of the [upgrade/static](api?query=upgrade%2Fstatic) - * library for hybrid upgrade apps that support AoT compilation* + * library for hybrid upgrade apps that support AOT compilation* * * This helper function returns a factory function to be used for registering * an AngularJS wrapper directive for "downgrading" an Angular component. diff --git a/packages/upgrade/src/common/src/downgrade_injectable.ts b/packages/upgrade/src/common/src/downgrade_injectable.ts index be5d517aca..a92ef8e086 100644 --- a/packages/upgrade/src/common/src/downgrade_injectable.ts +++ b/packages/upgrade/src/common/src/downgrade_injectable.ts @@ -17,7 +17,7 @@ import {getTypeName, isFunction, validateInjectionKey} from './util'; * A helper function to allow an Angular service to be accessible from AngularJS. * * *Part of the [upgrade/static](api?query=upgrade%2Fstatic) - * library for hybrid upgrade apps that support AoT compilation* + * library for hybrid upgrade apps that support AOT compilation* * * This helper function returns a factory function that provides access to the Angular * service identified by the `token` parameter. diff --git a/packages/upgrade/static/src/downgrade_module.ts b/packages/upgrade/static/src/downgrade_module.ts index 8397a415b8..71e87c671c 100644 --- a/packages/upgrade/static/src/downgrade_module.ts +++ b/packages/upgrade/static/src/downgrade_module.ts @@ -27,7 +27,7 @@ let moduleUid = 0; * instantiated. * * *Part of the [upgrade/static](api?query=upgrade/static) library for hybrid upgrade apps that - * support AoT compilation.* + * support AOT compilation.* * * It allows loading/bootstrapping the Angular part of a hybrid application lazily and not having to * pay the cost up-front. For example, you can have an AngularJS application that uses Angular for diff --git a/packages/upgrade/static/src/upgrade_component.ts b/packages/upgrade/static/src/upgrade_component.ts index 6a75b2ce1c..81fda98163 100644 --- a/packages/upgrade/static/src/upgrade_component.ts +++ b/packages/upgrade/static/src/upgrade_component.ts @@ -33,7 +33,7 @@ class Bindings { * A helper class that allows an AngularJS component to be used from Angular. * * *Part of the [upgrade/static](api?query=upgrade%2Fstatic) - * library for hybrid upgrade apps that support AoT compilation.* + * library for hybrid upgrade apps that support AOT compilation.* * * This helper class should be used as a base class for creating Angular directives * that wrap AngularJS components that need to be "upgraded". @@ -53,7 +53,7 @@ class Bindings { * * In this example you can see that we must derive from the `UpgradeComponent` * base class but also provide an {@link Directive `@Directive`} decorator. This is - * because the AoT compiler requires that this information is statically available at + * because the AOT compiler requires that this information is statically available at * compile time. * * Note that we must do the following: diff --git a/packages/upgrade/static/src/upgrade_module.ts b/packages/upgrade/static/src/upgrade_module.ts index 5301f8748d..fed0a5eb11 100644 --- a/packages/upgrade/static/src/upgrade_module.ts +++ b/packages/upgrade/static/src/upgrade_module.ts @@ -24,10 +24,10 @@ import {NgAdapterInjector} from './util'; * and has an instance method used to bootstrap the hybrid upgrade application. * * *Part of the [upgrade/static](api?query=upgrade/static) - * library for hybrid upgrade apps that support AoT compilation* + * library for hybrid upgrade apps that support AOT compilation* * * The `upgrade/static` package contains helpers that allow AngularJS and Angular components - * to be used together inside a hybrid upgrade application, which supports AoT compilation. + * to be used together inside a hybrid upgrade application, which supports AOT compilation. * * Specifically, the classes and functions in the `upgrade/static` module allow the following: *