Skip to content

Commit 5b87225

Browse files
committed
Auto merge of #29509 - vadimcn:readme, r=alexcrichton
The current readme provides critical information about gcc versions too late in the flow. r? @steveklabnik
2 parents eacd359 + 363deb0 commit 5b87225

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

README.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,8 @@ Read ["Installing Rust"] from [The Book].
6868
# Update package mirrors (may be needed if you have a fresh install of MSYS2)
6969
$ pacman -Sy pacman-mirrors
7070
71-
# Choose one based on platform:
71+
# Choose one based on platform:
72+
# *** see the note below ***
7273
$ pacman -S mingw-w64-i686-toolchain
7374
$ pacman -S mingw-w64-x86_64-toolchain
7475
@@ -89,9 +90,12 @@ Read ["Installing Rust"] from [The Book].
8990
```
9091
> ***Note:*** gcc versions >= 5 currently have issues building LLVM on Windows
9192
> resulting in a segmentation fault when building Rust. In order to avoid this
92-
> it may be necessary to obtain an earlier version of gcc such as 4.9.x.
93-
> Installers for earlier Windows builds of gcc are available at the
94-
> [Mingw-Builds] project. For more information on this see issue #28260.
93+
> it may be necessary to obtain an earlier version of gcc such as 4.9.x.
94+
> Msys's `pacman` will install the latest version, so for the time being it is
95+
> recommended to skip gcc toolchain installation step above and use [Mingw-Builds]
96+
> project's installer instead. Be sure to add gcc `bin` directory to the path
97+
> before running `configure`.
98+
> For more information on this see issue #28260.
9599

96100
[Mingw-Builds]: http://sourceforge.net/projects/mingw-w64/
97101

0 commit comments

Comments
 (0)