@@ -22,8 +22,9 @@ Read ["Installation"] from [The Book].
22
22
23
23
The Rust build system uses a Python script called ` x.py ` to build the compiler,
24
24
which manages the bootstrapping process. It lives at the root of the project.
25
- It also uses a file named ` config.toml ` to determine various configuration settings for the build.
26
- You can see a full list of options in ` config.example.toml ` .
25
+ It also uses a file named ` config.toml ` to determine various configuration
26
+ settings for the build. You can see a full list of options in
27
+ ` config.example.toml ` .
27
28
28
29
The ` x.py ` command can be run directly on most Unix systems in the following
29
30
format:
@@ -33,7 +34,8 @@ format:
33
34
```
34
35
35
36
This is how the documentation and examples assume you are running ` x.py ` .
36
- See the [ rustc dev guide] [ rustcguidebuild ] if this does not work on your platform.
37
+ See the [ rustc dev guide] [ rustcguidebuild ] if this does not work on your
38
+ platform.
37
39
38
40
More information about ` x.py ` can be found by running it with the ` --help ` flag
39
41
or reading the [ rustc dev guide] [ rustcguidebuild ] .
@@ -105,24 +107,26 @@ See [the rustc-dev-guide for more info][sysllvm].
105
107
106
108
When complete, ` ./x.py install ` will place several programs into
107
109
` $PREFIX/bin ` : ` rustc ` , the Rust compiler, and ` rustdoc ` , the
108
- API-documentation tool. By default, it will also include [ Cargo] , Rust's package manager.
109
- You can disable this behavior by passing ` --set build.extended=false ` to ` ./configure ` .
110
+ API-documentation tool. By default, it will also include [ Cargo] , Rust's
111
+ package manager. You can disable this behavior by passing
112
+ ` --set build.extended=false ` to ` ./configure ` .
110
113
111
114
[ Cargo ] : https://github.com/rust-lang/cargo
112
115
113
116
#### Configure and Make
114
117
115
- This project provides a configure script and makefile (the latter of which just invokes ` x.py ` ).
116
- ` . /configure` is the recommended way to programatically generate a ` config.toml ` . ` make ` is not
117
- recommended (we suggest using ` x.py ` directly), but it is supported and we try not to break it
118
- unnecessarily.
118
+ This project provides a configure script and makefile (the latter of which just
119
+ invokes ` x.py ` ). ` . /configure` is the recommended way to programatically
120
+ generate a ` config.toml ` . ` make ` is not recommended ( we suggest using ` x.py `
121
+ directly), but it is supported and we try not to break it unnecessarily.
119
122
120
123
``` sh
121
124
./configure
122
125
make && sudo make install
123
126
```
124
127
125
- ` configure ` generates a ` config.toml ` which can also be used with normal ` x.py ` invocations.
128
+ ` configure ` generates a ` config.toml ` which can also be used with normal ` x.py `
129
+ invocations.
126
130
127
131
### Building on Windows
128
132
@@ -193,7 +197,7 @@ toolchain.
193
197
#### MSVC
194
198
195
199
MSVC builds of Rust additionally require an installation of Visual Studio 2017
196
- (or later) so ` rustc ` can use its linker. The simplest way is to get
200
+ (or later) so ` rustc ` can use its linker. The simplest way is to get
197
201
[ Visual Studio] , check the "C++ build tools" and "Windows 10 SDK" workload.
198
202
199
203
[ Visual Studio ] : https://visualstudio.microsoft.com/downloads/
@@ -234,7 +238,8 @@ Windows build triples are:
234
238
235
239
The build triple can be specified by either specifying ` --build=<triple> ` when
236
240
invoking ` x.py ` commands, or by creating a ` config.toml ` file (as described in
237
- [ Building on a Unix-like system] ( #building-on-a-unix-like-system ) ), and passing ` --set build.build=<triple> ` to ` ./configure ` .
241
+ [ Building on a Unix-like system] ( #building-on-a-unix-like-system ) ), and passing
242
+ ` --set build.build=<triple> ` to ` ./configure ` .
238
243
239
244
## Building Documentation
240
245
0 commit comments