Skip to content

Commit 92c13f5

Browse files
committed
Add documentation for RUSTC_EMIT
1 parent ce834a2 commit 92c13f5

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

src/building/bootstrapping.md

+10
Original file line numberDiff line numberDiff line change
@@ -365,6 +365,16 @@ 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`.
369+
You can specify which `--emit` formats which are used with a comma separated list prefixed with
370+
a crate name and `=`, for example: `rustc_arena=llvm-ir,asm`.
371+
You can also substitute `*` for the crate name to apply it to all crates.
372+
You can combine multiple such specifiers by seperating them with semi-colons like
373+
`rustc_arena=llvm-ir,asm;rustc_span=asm;*=llvm-bc`.
374+
The emitted files will be stored inside the `emit` directory in the target specific build directory.
375+
`RUSTC_EMIT` will not cause `bootstrap` to rebuild any crates so you may need to modify the crates
376+
you're interested in.
377+
368378
`--test-args` will pass arguments through to the test runner. For `tests/ui`, this is
369379
compiletest; for unit tests and doctests this is the `libtest` runner. Most test runner accept
370380
`--help`, which you can use to find out the options accepted by the runner.

0 commit comments

Comments
 (0)