Skip to content

Commit fe0729d

Browse files
author
Jonathan Turner
authored
Rollup merge of #36672 - LinkiTools:master, r=steveklabnik
Improve documention troubleshooting missing linker. Fix #32208. @steveklabnik is this in the direction on how you want to see #32208 fixed?
2 parents 475a41b + cb3b03c commit fe0729d

File tree

1 file changed

+16
-6
lines changed

1 file changed

+16
-6
lines changed

src/doc/book/getting-started.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -166,12 +166,22 @@ you can find the Rust executables in a directory like
166166
`"C:\Program Files\Rust stable GNU 1.x\bin"`.
167167

168168
Rust does not do its own linking, and so you’ll need to have a linker
169-
installed. Doing so will depend on your specific system, consult its
170-
documentation for more details.
171-
172-
If not, there are a number of places where we can get help. The easiest is
173-
[the #rust-beginners IRC channel on irc.mozilla.org][irc-beginners] and for
174-
general discussion [the #rust IRC channel on irc.mozilla.org][irc], which we
169+
installed. Doing so will depend on your specific system. For
170+
Linux-based systems, Rust will attempt to call `cc` for linking. On
171+
`windows-msvc` (Rust built on Windows with Microsoft Visual Studio),
172+
this depends on having [Microsoft Visual C++ Build Tools][msvbt]
173+
installed. These do not need to be in `%PATH%` as `rustc` will find
174+
them automatically. In general, if you have your linker in a
175+
non-traditional location you can call `rustc
176+
linker=/path/to/cc`, where `/path/to/cc` should point to your linker path.
177+
178+
[msvbt]: http://landinghub.visualstudio.com/visual-cpp-build-tools
179+
180+
If you are still stuck, there are a number of places where we can get
181+
help. The easiest is
182+
[the #rust-beginners IRC channel on irc.mozilla.org][irc-beginners]
183+
and for general discussion
184+
[the #rust IRC channel on irc.mozilla.org][irc], which we
175185
can access through [Mibbit][mibbit]. Then we'll be chatting with other
176186
Rustaceans (a silly nickname we call ourselves) who can help us out. Other great
177187
resources include [the user’s forum][users] and [Stack Overflow][stackoverflow].

0 commit comments

Comments
 (0)