Index: docs/old_windows_build_instructions.md |
diff --git a/docs/old_windows_build_instructions.md b/docs/old_windows_build_instructions.md |
deleted file mode 100644 |
index 58ad8b2e6c9a46a2fa2c12336c6d594869587919..0000000000000000000000000000000000000000 |
--- a/docs/old_windows_build_instructions.md |
+++ /dev/null |
@@ -1,111 +0,0 @@ |
-# Windows Build Instructions |
- |
-**Generally, this page is obsolete and you should look at |
-[the new page instead](windows_build_instructions.md).** |
- |
-## Common checkout instructions |
- |
-This page covers Windows-specific setup and configuration. The |
-[general checkout |
-instructions](http://dev.chromium.org/developers/how-tos/get-the-code) cover |
-installing depot tools and checking out the code via git. |
- |
-## Setting up Windows |
- |
-You must set your Windows system locale to English, or else you may get |
-build errors about "The file contains a character that cannot be |
-represented in the current code page." |
- |
-### Setting up the environment for Visual Studio |
- |
-You must build with Visual Studio 2015 Update 3; no other version is |
-supported. |
- |
-You must have Windows 7 x64 or later. x86 OSs are unsupported. |
- |
-## Getting the compiler toolchain |
- |
-Follow the appropriate path below: |
- |
-### Open source contributors |
- |
-As of March 11, 2016 Chromium requires Visual Studio 2015 to build. |
- |
-Install Visual Studio 2015 Update 3 or later - Community Edition |
-should work if its license is appropriate for you. Use the Custom Install option |
-and select: |
- |
-- Visual C++, which will select three sub-categories including MFC |
-- Universal Windows Apps Development Tools > Tools |
-- Universal Windows Apps Development Tools > Windows 10 SDK (10.0.10586) |
- |
-You must have the 10586 SDK installed or else you will hit compile errors such |
-as redefined macros. |
- |
-Install Windows Driver Kit (WDK) 10, or use some other method to get the |
-Debugging Tools for Windows. |
- |
-Run `set DEPOT_TOOLS_WIN_TOOLCHAIN=0`, or set that variable in your |
-global environment. |
- |
-Compilation is done through ninja, **not** Visual Studio. |
- |
-### Google employees |
- |
-Run: `download_from_google_storage --config` and follow the |
-authentication instructions. **Note that you must authenticate with your |
-@google.com credentials**, not @chromium.org. Enter "0" if asked for a |
-project-id. |
- |
-Run: `gclient sync` again to download and install the toolchain automatically. |
- |
-The toolchain will be in `depot_tools\win_toolchain\vs_files\<hash>`, and windbg |
-can be found in `depot_tools\win_toolchain\vs_files\<hash>\win_sdk\Debuggers`. |
- |
-If you want the IDE for debugging and editing, you will need to install |
-it separately, but this is optional and not needed to build Chromium. |
- |
-## Using the Visual Studio IDE |
- |
-If you want to use the Visual Studio IDE, use the `--ide` command line |
-argument to `gn gen` when you generate your output directory (as described on |
-the [get the code](http://dev.chromium.org/developers/how-tos/get-the-code) |
-page): |
- |
-```gn gen --ide=vs out\Default |
-devenv out\Default\all.sln |
-``` |
- |
-GN will produce a file `all.sln` in your build directory. It will internally |
-use Ninja to compile while still allowing most IDE functions to work (there is |
-no native Visual Studio compilation mode). If you manually run "gen" again you |
-will need to resupply this argument, but normally GN will keep the build and |
-IDE files up to date automatically when you build. |
- |
-The generated solution will contain several thousand projects and will be very |
-slow to load. Use the `--filters` argument to restrict generating project files |
-for only the code you're interested in, although this will also limit what |
-files appear in the project explorer. A minimal solution that will let you |
-compile and run Chrome in the IDE but will not show any source files is: |
- |
-```gn gen --ide=vs --filters=//chrome out\Default``` |
- |
-There are other options for controlling how the solution is generated, run `gn |
-help gen` for the current documentation. |
- |
-## Performance tips |
- |
-1. Have a lot of fast CPU cores and enough RAM to keep them all busy. |
- (Minimum recommended is 4-8 fast cores and 16-32 GB of RAM) |
-2. Reduce file system overhead by excluding build directories from |
- antivirus and indexing software. |
-3. Store the build tree on a fast disk (preferably SSD). |
-4. If you are primarily going to be doing debug development builds, you |
- should use the component build. Set the [build |
- arg](https://www.chromium.org/developers/gn-build-configuration) |
- `is_component_build = true`. |
- This will generate many DLLs and enable incremental linking, which makes |
- linking **much** faster in Debug. |
- |
-Still, expect build times of 30 minutes to 2 hours when everything has to |
-be recompiled. |