Skip to content

Commit cb3b03c

Browse files
Paulo Matossteveklabnik
Paulo Matos
authored andcommitted
Improve documention troubleshooting missing linker. Fix #32208.
1 parent ea65ab6 commit cb3b03c

File tree

1 file changed

+16
-6
lines changed

1 file changed

+16
-6
lines changed

src/doc/book/getting-started.md

+16-6
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)