src/doc/rustc-guide/src/building/build-install-distribution-artifacts.md

   1 # Build distribution artifacts
   2
   3 You might want to build and package up the compiler for distribution.
   4 You’ll want to run this command to do it:
   5
   6    ```bash
   7    ./x.py dist
   8    ```
   9
  10 # Install distribution artifacts
  11
  12 If you’ve built a distribution artifact you might want to install it and
  13 test that it works on your target system. You’ll want to run this command:
  14
  15    ```bash
  16    ./x.py install
  17    ```
  18
  19    Note: If you are testing out a modification to a compiler, you
  20    might want to use it to compile some project.
  21    Usually, you do not want to use ./x.py install for testing.
  22    Rather, you should create a toolchain as discussed in
  23    [here][create-rustup-toolchain].
  24
  25    For example, if the toolchain you created is called foo, you
  26    would then invoke it with `rustc +foo ...` (where ... represents
  27    the rest of the arguments).
  28
  29 [create-rustup-toolchain]: ./how-to-build-and-run.md#creating-a-rustup-toolchain