refactor(ngcc): fix typos in comments (#37040)

This is a follow-up to #36944, because I didn't manage to finish my
review before the PR got merged.

PR Close #37040
This commit is contained in:
George Kalpakas 2020-06-08 22:04:20 +03:00 committed by Misko Hevery
parent 31796e8e2f
commit 469d2b4640
2 changed files with 13 additions and 12 deletions

View File

@ -64,13 +64,14 @@ ts_library(
], ],
) )
# As of version 10, the release packages do not contain esm2015 output anymore. The ngcc # As of version 10, the release packages do not contain esm5 output anymore. The ngcc integration
# integration tests intend to test ES5 features though, so we downlevel the flat esm2015 # tests intend to test ES5 features though, so we downlevel the flat esm2015 file to ES5 using
# file to ES5 using Babel. We can then link that into the mock file system as if the Angular # Babel. We can then link that into the mock file system as if the Angular core package is still
# core package is still built with previous APF versions where esm5 output was shipped. This # built with previous APF versions where esm5 output was shipped. This allows us to ensure that ngcc
# allows us to ensure that ngcc properly processes libraries with esm5 output. **Note**: We are # properly processes libraries with esm5 output.
# using Babel instead of `tsc` as TypeScript does not allow us to downlevel the file without # **Note**: We are using Babel instead of `tsc` as TypeScript does not allow us to downlevel the
# setting the module resolution to either `amd` or `system`. We want to preserve ES modules. # file without setting the module resolution to either `amd` or `system`. We want to preserve ES
# modules.
babel( babel(
name = "fesm5_angular_core", name = "fesm5_angular_core",
outs = ["fesm5_angular_core.js"], outs = ["fesm5_angular_core.js"],

View File

@ -20,8 +20,8 @@ export type PackageSources = {
/** /**
* Instead of writing packaged code by hand, and manually describing the layout of the package, this * Instead of writing packaged code by hand, and manually describing the layout of the package, this
* function transpiles the TypeScript sources into a flat file structure using the ES5 format. In * function transpiles the TypeScript sources into a flat file structure using the ES5 format. In
* this package layout, all compiled sources are at the root of the package, with .d.ts files next * this package layout, all compiled sources are at the root of the package, with `.d.ts` files next
* to the .js files. Each .js also has a corresponding .metadata.js file alongside with it. * to the `.js` files. Each `.js` also has a corresponding `.metadata.json` file alongside with it.
* *
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use * All generated code is written into the `node_modules` in the top-level filesystem, ready for use
* in testing ngcc. * in testing ngcc.
@ -41,7 +41,7 @@ export function compileIntoFlatEs5Package(pkgName: string, sources: PackageSourc
* Instead of writing packaged code by hand, and manually describing the layout of the package, * Instead of writing packaged code by hand, and manually describing the layout of the package,
* this function transpiles the TypeScript sources into a flat file structure using the ES2015 * this function transpiles the TypeScript sources into a flat file structure using the ES2015
* format. In this package layout, all compiled sources are at the root of the package, with * format. In this package layout, all compiled sources are at the root of the package, with
* `.d.ts` files next to the `.js` files. Each `.js` also has a corresponding `.metadata.js` * `.d.ts` files next to the `.js` files. Each `.js` also has a corresponding `.metadata.json`
* file alongside with it. * file alongside with it.
* *
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use * All generated code is written into the `node_modules` in the top-level filesystem, ready for use
@ -78,8 +78,8 @@ export interface FlatLayoutOptions {
/** /**
* Instead of writing packaged code by hand, and manually describing the layout of the package, this * Instead of writing packaged code by hand, and manually describing the layout of the package, this
* function transpiles the TypeScript sources into a flat file structure using a single format. In * function transpiles the TypeScript sources into a flat file structure using a single format. In
* this package layout, all compiled sources are at the root of the package, with .d.ts files next * this package layout, all compiled sources are at the root of the package, with `.d.ts` files next
* to the .js files. Each .js also has a corresponding .metadata.js file alongside with it. * to the `.js` files. Each `.js` also has a corresponding `.metadata.json` file alongside with it.
* *
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use * All generated code is written into the `node_modules` in the top-level filesystem, ready for use
* in testing ngcc. * in testing ngcc.