src/doc/trpl/nightly-rust.md

   1 % Nightly Rust
   2
   3 Rust provides three distribution channels for Rust: nightly, beta, and stable.
   4 Unstable features are only available on nightly Rust. For more details on this
   5 process, see ‘[Stability as a deliverable][stability]’.
   6
   7 [stability]: http://blog.rust-lang.org/2014/10/30/Stability.html
   8
   9 To install nightly Rust, you can use `rustup.sh`:
  10
  11 ```bash
  12 $ curl -s https://static.rust-lang.org/rustup.sh | sh -s -- --channel=nightly
  13 ```
  14
  15 If you're concerned about the [potential insecurity][insecurity] of using `curl
  16 | sh`, please keep reading and see our disclaimer below. And feel free to
  17 use a two-step version of the installation and examine our installation script:
  18
  19 ```bash
  20 $ curl -f -L https://static.rust-lang.org/rustup.sh -O
  21 $ sh rustup.sh --channel=nightly
  22 ```
  23
  24 [insecurity]: http://curlpipesh.tumblr.com
  25
  26 If you're on Windows, please download either the [32-bit installer][win32] or
  27 the [64-bit installer][win64] and run it.
  28
  29 [win32]: https://static.rust-lang.org/dist/rust-nightly-i686-pc-windows-gnu.msi
  30 [win64]: https://static.rust-lang.org/dist/rust-nightly-x86_64-pc-windows-gnu.msi
  31
  32 ## Uninstalling
  33
  34 If you decide you don't want Rust anymore, we'll be a bit sad, but that's okay.
  35 Not every programming language is great for everyone. Just run the uninstall
  36 script:
  37
  38 ```bash
  39 $ sudo /usr/local/lib/rustlib/uninstall.sh
  40 ```
  41
  42 If you used the Windows installer, just re-run the `.msi` and it will give you
  43 an uninstall option.
  44
  45 Some people, and somewhat rightfully so, get very upset when we tell you to
  46 `curl | sh`. Basically, when you do this, you are trusting that the good
  47 people who maintain Rust aren't going to hack your computer and do bad things.
  48 That's a good instinct! If you're one of those people, please check out the
  49 documentation on [building Rust from Source][from-source], or [the official
  50 binary downloads][install-page].
  51
  52 [from-source]: https://github.com/rust-lang/rust#building-from-source
  53 [install-page]: http://www.rust-lang.org/install.html
  54
  55 Oh, we should also mention the officially supported platforms:
  56
  57 * Windows (7, 8, Server 2008 R2)
  58 * Linux (2.6.18 or later, various distributions), x86 and x86-64
  59 * OSX 10.7 (Lion) or greater, x86 and x86-64
  60
  61 We extensively test Rust on these platforms, and a few others, too, like
  62 Android. But these are the ones most likely to work, as they have the most
  63 testing.
  64
  65 Finally, a comment about Windows. Rust considers Windows to be a first-class
  66 platform upon release, but if we're honest, the Windows experience isn't as
  67 integrated as the Linux/OS X experience is. We're working on it! If anything
  68 does not work, it is a bug. Please let us know if that happens. Each and every
  69 commit is tested against Windows just like any other platform.
  70
  71 If you've got Rust installed, you can open up a shell, and type this:
  72
  73 ```bash
  74 $ rustc --version
  75 ```
  76
  77 You should see the version number, commit hash, commit date and build date:
  78
  79 ```bash
  80 rustc 1.0.0-nightly (f11f3e7ba 2015-01-04) (built 2015-01-06)
  81 ```
  82
  83 If you did, Rust has been installed successfully! Congrats!
  84
  85 This installer also installs a copy of the documentation locally, so you can
  86 read it offline. On UNIX systems, `/usr/local/share/doc/rust` is the location.
  87 On Windows, it's in a `share/doc` directory, inside wherever you installed Rust
  88 to.
  89
  90 If not, there are a number of places where you can get help. The easiest is
  91 [the #rust IRC channel on irc.mozilla.org][irc], which you can access through
  92 [Mibbit][mibbit]. Click that link, and you'll be chatting with other Rustaceans
  93 (a silly nickname we call ourselves), and we can help you out. Other great
  94 resources include [the user’s forum][users], and [Stack Overflow][stackoverflow].
  95
  96 [irc]: irc://irc.mozilla.org/#rust
  97 [mibbit]: http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust
  98 [users]: http://users.rust-lang.org/
  99 [stackoverflow]: http://stackoverflow.com/questions/tagged/rust