Index: docs/windows_build_instructions.md |
diff --git a/docs/windows_build_instructions.md b/docs/windows_build_instructions.md |
index 61b59da8fd0f71ab170ccabf5c468c0161b0fb49..acf167517d7a1bf3aa303332bddd4d62f8b262b6 100644 |
--- a/docs/windows_build_instructions.md |
+++ b/docs/windows_build_instructions.md |
@@ -88,47 +88,57 @@ using gn - see [crbug.com/611087](https://crbug.com/611087). |
## Get the code |
-Create a chromium directory for the checkout and change to it (you can call |
+Create a `chromium` directory for the checkout and change to it (you can call |
this whatever you like and put it wherever you like, as |
long as the full path has no spaces): |
- |
- $ mkdir chromium |
- $ cd chromium |
-Run the `fetch` tool from depot_tools to check out the code and its |
+```shell |
+$ mkdir chromium && cd chromium |
+``` |
+ |
+Run the `fetch` tool from `depot_tools` to check out the code and its |
dependencies. |
- $ fetch chromium |
+```shell |
+$ fetch ios |
+``` |
If you don't want the full repo history, you can save a lot of time by |
-adding the `--no-history` flag to fetch. Expect the command to take |
-30 minutes on even a fast connection, and many hours on slower ones. |
+adding the `--no-history` flag to `fetch`. |
-When fetch completes, it will have created a directory called `src`. |
-The remaining instructions assume you are now in that directory: |
+Expect the command to take 30 minutes on even a fast connection, and many |
+hours on slower ones. |
- $ cd src |
+When `fetch` completes, it will have created a hidden `.gclient` file and a |
+directory called `src` in the working directory. The remaining instructions |
+assume you have switched to the `src` directory: |
-### (optional) Install API keys |
+```shell |
+$ cd src |
+``` |
-You can also [instaldl API keys](https://www.chromium.org/developers/how-tos/api-keys) |
-if you want to talk to some of the Google services, but this is not necessary |
-for most development and testing purposes. |
+*Optional*: You can also [install API |
+keys](https://www.chromium.org/developers/how-tos/api-keys) if you want your |
+build to talk to some Google services, but this is not necessary for most |
+development and testing purposes. |
-## Seting up the Build |
+## Building |
-Chromium uses [Ninja](https://ninja-build.org) as its main build tool, and |
-a tool called [GN](../tools/gn/docs/quick_start.md) to generate |
-the .ninja files to do the build. To create a build directory: |
+Chromium uses [Ninja](https://ninja-build.org) as its main build tool along |
+with a tool called [GN](../tools/gn/docs/quick_start.md) to generate `.ninja` |
+files. You can create any number of *build directories* with different |
+configurations. To create a build directory: |
- $ gn gen out/Default |
+```shell |
+$ gn gen out/Default |
+``` |
-* You only have to do run this command once, it will self-update the build |
- files as needed after that. |
-* You can replace `out/Default` with another directory name, but we recommend |
- it should still be a subdirectory of `out`. |
-* To specify build parameters for GN builds, including release settings, |
- see [GN build configuration](https://www.chromium.org/developers/gn-build-configuration). |
+* You only have to run this once for each new build directory, Ninja will |
+ update the build files as needed. |
+* You can replace `Default` with another name, but |
+ it should be a subdirectory of `out`. |
+* For other build arguments, including release settings, see [GN build |
+ configuration](https://www.chromium.org/developers/gn-build-configuration). |
The default will be a debug component build matching the current host |
operating system and CPU. |
* For more info on GN, run `gn help` on the command line or read the |