rwf2
/
Rocket
mirror of https://github.com/rwf2/Rocket.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Revert "Document nightly compatibility issues." 

This reverts commit 4718c0a85a.
This commit is contained in:
Sergio Benitez 2018-01-12 19:04:52 -08:00
parent e836253141
commit f485bb6b04
2 changed files with 13 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -63,12 +63,7 @@ guide.
Rocket requires a nightly version of Rust as it makes heavy use of syntax
extensions. This means that the first two unwieldly lines in the introductory
example above are required. Due to an issue in a Rocket dependency (see [#513]),
you must currently build _released_ versions of Rocket with a nightly between
`nightly-2017-12-18` and `nightly-2017-12-21`. The in-development version of
Rocket compiles with the _latest_ nightly compiler.
[#513]: https://github.com/SergioBenitez/Rocket/issues/513
example above are required.
### Core, Codegen, and Contrib

34
site/guide/getting-started.md
View File

@ -7,16 +7,17 @@ and then run the application.
## Installing Rust
Rocket makes abundant use of Rust's syntax extensions and other advanced,
unstable features. Because of this, we'll need to use a supported _nightly_
version of Rust.
unstable features. Because of this, we'll need to use a nightly version of Rust.
If you already have a working installation of the latest Rust nightly, feel free
to skip to the next section.
To install such a version, we recommend using `rustup`. Install `rustup` by
following the instructions on [its website](https://rustup.rs/). Once `rustup`
is installed, configure Rust nightly as your default toolchain by running the
command:
To install a nightly version of Rust, we recommend using `rustup`. Install
`rustup` by following the instructions on [its website](https://rustup.rs/).
Once `rustup` is installed, configure Rust nightly as your default toolchain by
running the command:
```sh
rustup default nightly-2017-12-21
rustup default nightly
```
If you prefer, once we setup a project directory in the following section, you
@ -24,30 +25,19 @@ can use per-directory overrides to use the nightly version _only_ for your
Rocket project by running the following command in the directory:
```sh
rustup override set nightly-2017-12-21
rustup override set nightly
```
### Minimum Nightly
Rocket generally requires the _latest_ version of Rust nightly. At present,
however, a Rocket dependency fails to build on the latest nightlies, temporarily
grounding Rocket (see [#513] for details). As a result, you'll need to use the
last known working nightly release while the issue is resolved. The commands
above already take this into account by installing the `2017-12-21` nightly.
Once the external issue has been resolved, you can upgrade to the latest nightly
with `rustup default nightly` or `rustup override set nightly`. If your Rocket
application suddenly stops building, it's likely that this issue has been
resolved. If Rocket fails to compile in the future, you should also ensure
you're using the latest version of Rust nightly and Rocket by updating your
toolchain and dependencies with:
Rocket always requires the _latest_ version of Rust nightly. If your Rocket
application suddently stops building, ensure you're using the latest version of
Rust nightly and Rocket by updating your toolchain and dependencies with:
```sh
rustup update && cargo update
```
[#513]: https://github.com/SergioBenitez/Rocket/issues/513
## Hello, world!
Let's write our first Rocket application! Start by creating a new binary-based