Skip to content

Commit b85fc37

Browse files
ednixmark-i-m
authored andcommitted
Clarify line about RLS being unable to handle rustc
I based this clarification on this [answer](https://www.reddit.com/r/rust/comments/a8mk33/question_about_a_line_from_the_rust_compiler_book/ecbx1ma/) to my question on Reddit.
1 parent 451f009 commit b85fc37

File tree

1 file changed

+14
-16
lines changed

1 file changed

+14
-16
lines changed

src/how-to-build-and-run.md

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,10 @@ debuginfo-lines = true
4545

4646
### What is x.py?
4747

48-
x.py is the script used to orchestrate the tooling in the rustc repository.
49-
It is the script that can build docs, run tests, and compile rustc.
50-
It is the now preferred way to build rustc and it replaces the old makefiles
51-
from before. Below are the different ways to utilize x.py in order to
48+
x.py is the script used to orchestrate the tooling in the rustc repository.
49+
It is the script that can build docs, run tests, and compile rustc.
50+
It is the now preferred way to build rustc and it replaces the old makefiles
51+
from before. Below are the different ways to utilize x.py in order to
5252
effectively deal with the repo for various common tasks.
5353

5454
### Running x.py and building a stage1 compiler
@@ -86,8 +86,8 @@ compiling `rustc` is done in stages:
8686

8787
#### Build Flags
8888

89-
There are other flags you can pass to the build portion of x.py that can be
90-
beneficial to cutting down compile times or fitting other things you might
89+
There are other flags you can pass to the build portion of x.py that can be
90+
beneficial to cutting down compile times or fitting other things you might
9191
need to change. They are:
9292

9393
```bash
@@ -180,9 +180,9 @@ build`) has quite a few more steps:
180180
> ./x.py build src/libcore --stage 1
181181
```
182182

183-
Sometimes you might just want to test if the part you’re working on can
184-
compile. Using these commands you can test that it compiles before doing
185-
a bigger build to make sure it works with the compiler. As shown before
183+
Sometimes you might just want to test if the part you’re working on can
184+
compile. Using these commands you can test that it compiles before doing
185+
a bigger build to make sure it works with the compiler. As shown before
186186
you can also pass flags at the end such as --stage.
187187

188188

@@ -260,7 +260,7 @@ The sequence of commands you want is as follows:
260260
stage1 compiler
261261
- Subsequent builds: `./x.py build -i --stage 1 src/libstd --keep-stage 1`
262262
- Note that we added the `--keep-stage 1` flag here
263-
263+
264264
The effect of `--keep-stage 1` is that we just *assume* that the old
265265
standard library can be re-used. If you are editing the compiler, this
266266
is almost always true: you haven't changed the standard library, after
@@ -300,9 +300,7 @@ in other sections:
300300

301301
### ctags
302302

303-
One of the challenges with rustc is that the RLS can't handle it, making code
304-
navigation difficult. One solution is to use `ctags`. The following script can
305-
be used to set it up: [https://github.com/nikomatsakis/rust-etags][etags].
303+
One of the challenges with rustc is that the RLS can't handle it, making code navigation difficult. One solution is to use ctags. The following script can be used to set it up: https://github.com/nikomatsakis/rust-etags.
306304

307305
CTAGS integrates into emacs and vim quite easily. The following can then be
308306
used to build and generate tags:
@@ -318,9 +316,9 @@ you last built, which is ridiculously useful.
318316

319317
### Cleaning out build directories
320318

321-
Sometimes you need to start fresh, but this is normally not the case.
322-
If you need to run this then rustbuild is most likely not acting right and
323-
you should file a bug as to what is going wrong. If you do need to clean
319+
Sometimes you need to start fresh, but this is normally not the case.
320+
If you need to run this then rustbuild is most likely not acting right and
321+
you should file a bug as to what is going wrong. If you do need to clean
324322
everything up then you only need to run one command!
325323

326324
```bash

0 commit comments

Comments
 (0)