* Update prerequisites, with an eye towards windows
* Address review comments
- Say version of MSVC needed
- Link to more details windows section
- Fix grammar
Previously, 'How to build and run' had a long section on the different
stages of boostrap. But new contributors aren't interested in bootstrap;
they want to start their build (because they heard it takes forever and
want to start it so they aren't waiting more than necessary).
This moves the section on stages into the bootstrapping page, and links
there instead of discussing it on the main page.
Several of the commands on 'how to build' use python.
But we haven't yet told the user how to install it!
Do that first before going into detail on how x.py works.
The Rust codebase is large, not to mention the submodules. It would be helpful for some to have a warning or note about storage required before they spend possible hours to build, only to get a message in some form that they are running out/already out of storage. I did a stage1 build incrementally and it produced a build directory of about 14 gigabytes.
* fix links
* some debugging
* more debugging
* fix git checkout in ci
* try again
* already tests with a merge
* Typo
Co-authored-by: Tshepang Lekhonkhobe <tshepang@gmail.com>
Co-authored-by: Tshepang Lekhonkhobe <tshepang@gmail.com>
* The very first step should be to clone the repository
* Make the command copy-able
By having the plain command users can select and copy the text and paste
it, without needing to fiddle around to remove extra characters.
Now that the previous command switched directories it is not necessary
to be called out here again either.
* Update src/building/how-to-build-and-run.md
Co-authored-by: Yuki Okushi <huyuumi.dev@gmail.com>
* more info about llvm-config
* typo
Co-Authored-By: Santiago Pastorino <spastorino@gmail.com>
Co-authored-by: Santiago Pastorino <spastorino@gmail.com>
Specifically, `> $1` causes it to write into the file $1 if it exist
And `> ./x.py` is particularly bad because it overwrite the script with
empty spaces...
Joshua Nelson
Tshepang Lekhonkhobe
mark
Aleksey Kladov
Yuki Okushi
Jake Goulding
Santiago Pastorino
Nadrieril
Eric Huss
Who? Me?!
Florian Gilcher
ThePuzzlemaker
LeSeulArtichaut
Jade McGough
Jan-Erik Rediger
Paul Daniel Faria
DillionMango
Hanif Bin Ariffin