Skip to content

Commit

Permalink
Rollup merge of rust-lang#36672 - LinkiTools:master, r=steveklabnik
Browse files Browse the repository at this point in the history
Improve documention troubleshooting missing linker. Fix rust-lang#32208.

@steveklabnik is this in the direction on how you want to see rust-lang#32208 fixed?
  • Loading branch information
Jonathan Turner authored Sep 28, 2016
2 parents 475a41b + cb3b03c commit fe0729d
Showing 1 changed file with 16 additions and 6 deletions.
22 changes: 16 additions & 6 deletions src/doc/book/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,12 +166,22 @@ you can find the Rust executables in a directory like
`"C:\Program Files\Rust stable GNU 1.x\bin"`.

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, consult its
documentation for more details.

If not, there are a number of places where we can get help. The easiest is
[the #rust-beginners IRC channel on irc.mozilla.org][irc-beginners] and for
general discussion [the #rust IRC channel on irc.mozilla.org][irc], which we
installed. Doing so will depend on your specific system. For
Linux-based systems, Rust will attempt to call `cc` for linking. On
`windows-msvc` (Rust built on Windows with Microsoft Visual Studio),
this depends on having [Microsoft Visual C++ Build Tools][msvbt]
installed. These do not need to be in `%PATH%` as `rustc` will find
them automatically. In general, if you have your linker in a
non-traditional location you can call `rustc
linker=/path/to/cc`, where `/path/to/cc` should point to your linker path.

[msvbt]: http://landinghub.visualstudio.com/visual-cpp-build-tools

If you are still stuck, there are a number of places where we can get
help. The easiest is
[the #rust-beginners IRC channel on irc.mozilla.org][irc-beginners]
and for general discussion
[the #rust IRC channel on irc.mozilla.org][irc], which we
can access through [Mibbit][mibbit]. Then we'll be chatting with other
Rustaceans (a silly nickname we call ourselves) who can help us out. Other great
resources include [the user’s forum][users] and [Stack Overflow][stackoverflow].
Expand Down

0 comments on commit fe0729d

Please sign in to comment.