--- /dev/null
+How to build freeglut with CMake:\r
+1. Download CMake (http://www.cmake.org/cmake/resources/software.html).\r
+ Get one of the releases from the binary distribution section.\r
+2. Run the CMake installer, install wherever you like. \r
+3. Launch CMake via Start > Program Files > CMake 2.8 > CMake (GUI)\r
+ (note that the shortcut put by the installer on your desktop does NOT\r
+ point to the CMake GUI program!)\r
+4. In the "Where is the source code" box, type or browse to the root\r
+ directory of your freeglut source (so that's /freeglut, not\r
+ /freeglut/src).\r
+5. In the "Where to build the binaries" box, type or browse to any\r
+ folder you like - this will be where the Visual Studio solution will be\r
+ generated. This folder does not have to exist yet.\r
+6. Hit the Configure button near the bottom of the window. \r
+7. Pick your target compiler, make sure that its installed on your\r
+ system of course!\r
+8. Answer Ok when asked if you want to create the build directory. \r
+9. Wait for the configure process to finish. \r
+10. The screen will now have some configuration options on it, for\r
+ instance specifying whether you want to build static and/or shared\r
+ libraries (see below for a complete list). When you've selected your\r
+ options, click the Configure button again.\r
+11. The Generate button at the bottom will now be enabled. Click Generate.\r
+12. The build files will now be generated in the location you picked. \r
+\r
+You can now navigate to the build directory you specified in step 5.\r
+Open the freeglut.sln file that was generated in your build directory,\r
+and compile as usual\r
+\r
+\r
+\r
+Breakdown of CMake configuration options:\r
+TODO\r