src/tools/build-manifest/README.md

   1 # build-manifest
   2
   3 This tool generates the manifests uploaded to static.rust-lang.org and used by
   4 rustup. The tool is invoked by the bootstrap tool.
   5
   6 ## Testing changes locally
   7
   8 In order to test the changes locally you need to have a valid dist directory
   9 available locally. If you don't want to build all the compiler, you can easily
  10 create one from the nightly artifacts with:
  11
  12 ```
  13 #!/bin/bash
  14 for cmpn in rust rustc rust-std rust-docs cargo; do
  15     wget https://static.rust-lang.org/dist/${cmpn}-nightly-x86_64-unknown-linux-gnu.tar.gz
  16 done
  17 ```
  18
  19 Then, you can generate the manifest and all the packages from `path/to/dist` to
  20 `path/to/output` with:
  21
  22 ```
  23 $ BUILD_MANIFEST_DISABLE_SIGNING=1 cargo +nightly run \
  24     path/to/dist path/to/output 1970-01-01 \
  25     nightly nightly nightly nightly nightly nightly nightly \
  26     http://example.com
  27 ```
  28
  29 In the future, if the tool complains about missing arguments just add more
  30 `nightly`s in the middle.