summaryrefslogtreecommitdiffstats
path: root/src/doc/rustc-dev-guide/src/building/build-install-distribution-artifacts.md
blob: 4ec3f958a05dd1e2dd1c65a705e2f3430bbc0c69 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# Build distribution artifacts

You might want to build and package up the compiler for distribution.
You’ll want to run this command to do it:

   ```bash
   ./x.py dist
   ```

# Install distribution artifacts

If you’ve built a distribution artifact you might want to install it and
test that it works on your target system. You’ll want to run this command:

   ```bash
   ./x.py install
   ```

   Note: If you are testing out a modification to a compiler, you
   might want to use it to compile some project.
   Usually, you do not want to use `./x.py install` for testing.
   Rather, you should create a toolchain as discussed in
   [here][create-rustup-toolchain].

   For example, if the toolchain you created is called foo, you
   would then invoke it with `rustc +foo ...` (where ... represents
   the rest of the arguments).

[create-rustup-toolchain]: ./how-to-build-and-run.md#creating-a-rustup-toolchain