docs: add a note about the ngc command and command line options (#42373)

It turns out that we don't document anywhere how ngc works and what options we support.
I added a brief section, without going too much into details because most users should not need to use ngc directly.

I also came across some bug in `ngc` and filed #42372.

Fixes #29623

PR Close #42373
This commit is contained in:
Igor Minar 2021-05-26 15:32:29 -07:00 committed by Andrew Kushnir
parent 74186c36de
commit 141791e070
1 changed files with 11 additions and 0 deletions

View File

@ -221,3 +221,14 @@ When you use the CLI command `ng new --strict`, it is set to `true` in the gener
### `trace`
When `true`, prints extra information while compiling templates. Default is `false`.
{@a cli-options}
## Command Line Options
While most of the time you interact with the Angular Compiler indirectly using Angular CLI, when debugging certain issues, you might find it useful to invoke the Angular Compiler directly.
You can use the `ngc` command provided by the `@angular/compiler-cli` npm package to call the compiler from the command line.
The `ngc` command is just a wrapper around TypeScript's `tsc` compiler command and is primarily configured via the `tsconfig.json` configuration options documented in [the previous sections](#angular-compiler-options).
In addition to the configuration file, you can also use [`tsc` command line options](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to configure `ngc`.