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

Document nightly compatibility issues. 

Closes #519.
This commit is contained in:
Sergio Benitez 2017-12-26 20:50:56 -08:00
parent 804d2b6603
commit 6f35ccb9c9
2 changed files with 27 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

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

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

@ -7,17 +7,16 @@ and then run the application.
## Installing Rust ## Installing Rust
Rocket makes abundant use of Rust's syntax extensions and other advanced, Rocket makes abundant use of Rust's syntax extensions and other advanced,
unstable features. Because of this, we'll need to use a nightly version of Rust. unstable features. Because of this, we'll need to use a supported _nightly_
If you already have a working installation of the latest Rust nightly, feel free version of Rust.
to skip to the next section.
To install a nightly version of Rust, we recommend using `rustup`. Install To install such a version, we recommend using `rustup`. Install `rustup` by
`rustup` by following the instructions on [its website](https://rustup.rs/). following the instructions on [its website](https://rustup.rs/). Once `rustup`
Once `rustup` is installed, configure Rust nightly as your default toolchain by is installed, configure Rust nightly as your default toolchain by running the
running the command: command:
```sh ```sh
rustup default nightly rustup default nightly-2017-12-21
``` ```
If you prefer, once we setup a project directory in the following section, you If you prefer, once we setup a project directory in the following section, you
@ -25,19 +24,30 @@ can use per-directory overrides to use the nightly version _only_ for your
Rocket project by running the following command in the directory: Rocket project by running the following command in the directory:
```sh ```sh
rustup override set nightly rustup override set nightly-2017-12-21
``` ```
### Minimum Nightly ### Minimum Nightly
Rocket always requires the _latest_ version of Rust nightly. If your Rocket Rocket generally requires the _latest_ version of Rust nightly. At present,
application suddently stops building, ensure you're using the latest version of however, a Rocket dependency fails to build on the latest nightlies, temporarily
Rust nightly and Rocket by updating your toolchain and dependencies with: 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:
```sh ```sh
rustup update && cargo update rustup update && cargo update
``` ```
[#513]: https://github.com/SergioBenitez/Rocket/issues/513
## Hello, world! ## Hello, world!
Let's write our first Rocket application! Start by creating a new binary-based Let's write our first Rocket application! Start by creating a new binary-based