diff --git a/Build/README.md b/Build/README.md index 932a6fffcc..7d42d4d178 100644 --- a/Build/README.md +++ b/Build/README.md @@ -9,26 +9,27 @@ Install CMake At first, you have to install CMake. +All OSes +=== + +The common way of installing CMake is to go to [CMake's download page](http://www.cmake.org/download/). At this time of writing, the latest versions are 3.3.0-rc3 and 3.2.3. Either version will work: the minimum version supported at this time is 2.8.12. + +If this approach is used, consider using the binary distributions. Most should also provide a friendly GUI interface. + Windows === -Describe Later. +For those that prefer package manager systems, [Chocolatey](https://chocolatey.org/) has a CMake package. Run `choco install cmake` to get the latest stable version. -Mac OS X +Mac OS X Specific === -install by Homebrew: - - $brew install cmake - -install by MacPorts: - - $port install cmake +For those that prefer package manager systems, both [Homebrew](http://brew.sh/) and [MacPorts](https://www.macports.org/) offer CMake as part of their offerings. Run `brew install cmake` or `port install cmake` respectively to get the latest stable version. Linux === -Describe Later. +There are many package managers available for Linux. Look at your manual for more details. Either that, or utilize the All OS specific approach. CMake Installation @@ -48,15 +49,11 @@ For the first setup, you will want to run this command: `cmake -G {YourGeneratorHere} .. && cmake ..` -Replace {YourGeneratorHere} with one of the generator choices from `cmake --help`. +Replace {YourGeneratorHere} with one of the generator choices from `cmake --help`. As an example, Mac OS X users that want to have Xcode used would run `cmake -G Xcode .. && cmake ..` on their Terminal program. If any cmake project file changes, you can just run `cmake .. && cmake ..` to get up to date. If this by itself doesn't work, you may have to clean the cmake cache. -Use `rm -rf CMakeCache.txt CMakeScripts/ CMakeFiles/ cmake_install.txt` to do that, and then run the generator command again. - -for example(Use Xcode): - - $cmake -G Xcode .. && cmake .. +Use `rm -rf CMakeCache.txt CMakeScripts/ CMakeFiles/ cmake_install.txt` to do that, and then run the generator command again as specified above. The reason for running cmake at least twice is to make sure that all of the variables get set up appropriately. @@ -84,9 +81,9 @@ If you are generating makefiles with cmake, you will also need to specify your b Most users will want to use `RELEASE` while some developers may want to use `DEBUG`. When generating your cmake files for the first time (or after any cache delete), -pass in `-DCMAKE_BUILD_TYPE=Debug` for a debug build. We have `RelWithDbgInfo` and `MinSizeRel` available as well. +pass in `-DCMAKE_BUILD_TYPE=Debug` for a debug build. We have `RelWithDbgInfo` and `MinSizeRel` builds available as well. -It is advised to clean your cmake cache if you switch builds. +It is advised to clean your cmake cache if you switch build types. Note that if you use an IDE like Visual Studio or Xcode, you do not need to worry about setting the build type. You can edit the build type directly in the IDE.