Skip to content

Commit d5a8118

Browse files
committed
Add documentation for RUSTC_EMIT
1 parent ce834a2 commit d5a8118

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

src/building/bootstrapping.md

+2
Original file line numberDiff line numberDiff line change
@@ -365,6 +365,8 @@ recompiling all dependencies.
365365
`CARGOFLAGS` will pass arguments to cargo itself (e.g. `--timings`). `CARGOFLAGS_BOOTSTRAP` and
366366
`CARGOFLAGS_NOT_BOOTSTRAP` work analogously to `RUSTFLAGS_BOOTSTRAP`.
367367

368+
`RUSTC_EMIT` will cause `bootstrap` to pass `--emit` arguments on to `rustc`. You can specify which `--emit` formats which are used with a comma separated list prefixed with a crate name and `=`, for example: `rustc_arena=llvm-ir,asm`. You can also substitute `*` for the crate name to apply it to all crates. You can combine multiple such specifiers by seperating them with semi-colons like `rustc_arena=llvm-ir,asm;rustc_span=asm;*=llvm-bc`. The emitted files will be stored inside the `emit` directory in the target specific build directory. `RUSTC_EMIT` will not cause `bootstrap` to rebuild any crates so you may need to modify the crates you're interested in.
369+
368370
`--test-args` will pass arguments through to the test runner. For `tests/ui`, this is
369371
compiletest; for unit tests and doctests this is the `libtest` runner. Most test runner accept
370372
`--help`, which you can use to find out the options accepted by the runner.

0 commit comments

Comments
 (0)