Change:
Specifically at , and recommend for Windows too, right? We've , but in the meantime, the old book should recommend the new recommended toolchain :) If it's too soon to do this because isn't stable enough yet, consider this a reminder issue to make this change once it is :)
wants to wait a bit, and we'd need to then make sure to update the website in sync (see )
Maybe the big red warning "this is beta software" should be removed from the website?
This will be fixed by

Discussion:
# An optional number to put after the label, e.g. '.2' -> '-beta.2' # NB Make sure it starts with a dot to conform to semver pre-release # versions (section 9) <del> CFG_PRERELEASE_VERSION=.4 </del> <ins> CFG_PRERELEASE_VERSION=.5 </ins> ifeq ($(CFG_RELEASE_CHANNEL),stable) # This is the normal semver version string, e.g. "0.12.0", "0.12.0-nightly"

Note that this table can be expanded over time, this isn't the exhaustive set of tier 3 platforms that will ever be! <del> ## Installing on Linux or Mac </del> <ins> ## Installing Rust </ins> <del> If we're on Linux or a Mac, all we need to do is open a terminal and type this: </del> <ins> All you need to do on Unix systems like Linux and macOS is open a terminal and type this: </ins> ```bash <del> $ curl -sSf https://static.rust-lang.org/rustup.sh | sh </del> <ins> $ curl https://sh.rustup.rs -sSf | sh </ins> ``` <del> This will download a script, and start the installation. If it all goes well, you’ll see this appear: </del> <ins> It will download a script, and start the installation. If everything goes well, you’ll see this appear: </ins> ```text <del> Rust is ready to roll. </del> <ins> Rust is installed now. Great! </ins> ``` <del> From here, press `y` for ‘yes’, and then follow the rest of the prompts. </del> <ins> Installing on Windows is nearly as easy: download and run [rustup-init.exe]. It will start the installation in a console and present the above message on success. </ins> <del> ## Installing on Windows </del> <ins> For other installation options and information, visit the [install] page of the Rust website. </ins> <del> If you're on Windows, please download the appropriate [installer][install-page]. [install-page]: https://www.rust-lang.org/install.html </del> <ins> [rustup-init.exe]: https://win.rustup.rs [install]: https://www.rust-lang.org/install.html </ins> ## Uninstalling <del> Uninstalling Rust is as easy as installing it. On Linux or Mac, run the uninstall script: </del> <ins> Uninstalling Rust is as easy as installing it: </ins> ```bash <del> $ sudo /usr/local/lib/rustlib/uninstall.sh </del> <ins> $ rustup self uninstall </ins> ``` <del> If we used the Windows installer, we can re-run the `.msi` and it will give us an uninstall option. </del> ## Troubleshooting If we've got Rust installed, we can open up a shell, and type this:

If you do, Rust has been installed successfully! Congrats! <del> If you don't and you're on Windows, check that Rust is in your %PATH% system variable: `$ echo %PATH%`. If it isn't, run the installer again, select "Change" on the "Change, repair, or remove installation" page and ensure "Add to PATH" is installed on the local hard drive.  If you need to configure your path manually, you can find the Rust executables in a directory like `"C:Program FilesRust stable GNU 1.xbin"`. </del> <ins> If you don't, that probably means that the `PATH` environment variable doesn't include Cargo's binary directory, `~/.cargo/bin` on Unix, or `%USERPROFILE%.cargobin` on Windows. This is the directory where Rust development tools live, and most Rust developers keep it in their `PATH` environment variable, which makes it possible to run `rustc` on the command line. Due to differences in operating systems, command shells, and bugs in installation, you may need to restart your shell, log out of the system, or configure `PATH` manually as appropriate for your operating environment. </ins> Rust does not do its own linking, and so you’ll need to have a linker installed. Doing so will depend on your specific system. For

[stackoverflow]: http://stackoverflow.com/questions/tagged/rust This installer also installs a copy of the documentation locally, so we can <del> read it offline. On UNIX systems, `/usr/local/share/doc/rust` is the location. On Windows, it's in a `share/doc` directory, inside the directory to which Rust was installed. </del> <ins> read it offline. It's only a `rustup doc` away! </ins> # Hello, world!