Suggestion for cmake docs for building FLTK with Visual Studio (e.g. VS7 shown)

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12213 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 63 insertions, 4 deletions

diff --git a/README.CMake.txt b/README.CMake.txt
index 84a128757..c4c202183 100644
--- a/README.CMake.txt
+++ b/README.CMake.txt
@@ -10,8 +10,9 @@ README.CMake.txt - Building and using FLTK with CMake
     2.1   Prerequisites
     2.2   Options
     2.3   Building under Linux with Unix Makefiles
-    2.4   Building under Windows with MinGW using Makefiles
-    2.5   Crosscompiling
+    2.4   Building under Windows with Visual Studio [SUGGESTED DOCS -erco]
+    2.5   Building under Windows with MinGW using Makefiles
+    2.6   Crosscompiling
   3	Using CMake with FLTK
     3.1   Library Names
     3.2   Using Fluid Files
@@ -190,7 +191,65 @@ then use subdirectories in the build directory, like this:
     sudo make install (optional)
 
 
- 2.4  Building under Windows with MinGW using Makefiles
+ 2.4  Building under Windows with Visual Studio
+------------------------------------------------
+
+Building with CMake under Visual Studio requires the CMake generator
+with the -G command line switch. 
+
+     2.4.1 Visual Studio 7 / .NET
+    ------------------------------
+
+    1) Open a "Visual Studio .NET command prompt" window, e.g.
+
+        Start > All Programs > Microsoft Visual Studio .NET >
+                Visual Studio .NET Tools > Command Prompt
+
+    2) In the DOS window created above, change the current directory
+       to where you've extracted an fltk distribution tar file (or
+       snapshot tar file), and run the following commands:
+
+           cd C:\fltk-1.4.x		<-- change to your FLTK directory
+           mkdir build			<-- create an empty directory
+           cd build
+           cmake -G "Visual Studio 7" -D CMAKE_BUILD_TYPE=Release ..
+
+	This will create the file FLTK.sln in the current 'build' directory.
+
+    3) Open Visual Studio 7, and choose File -> Open -> Project,
+       and pick the "FLTK.sln" created by step #2 in the 'build' directory.
+
+       (Or, if only one version of the Visual Studio compiler is installed,
+       you can just run from DOS: .\FLTK.sln)
+
+    4) Make sure the pulldown menu has either "Release" or "Debug" selected
+       in the "Solution Configurations" pulldown menu.
+
+    5) In the "Solution Explorer", right click on:
+
+	    Solution 'FLTK' (## projects)
+
+       ..and in the popup menu, choose "Build Solution"
+
+    5) That's it, that should build FLTK.
+       The test programs (*.exe) can be found in e.g.
+
+	    Release: C:\fltk-1.4.x\build\bin\examples\release\*.exe
+	      Debug: C:\fltk-1.4.x\build\bin\examples\debug\*.exe
+
+       ..and the FLTK include files (*.H & *.h) your own apps can
+       compile with can be found in:
+       
+	    Release & Debug: C:\fltk-1.4.x\build\FL
+
+       ..and the FLTK library files (*.lib) which your own apps can
+       link with can be found in:
+
+	    Release: C:\fltk-1.4.x\build\lib\release\*.lib
+	      Debug: C:\fltk-1.4.x\build\lib\debug\*.lib
+
+
+ 2.5  Building under Windows with MinGW using Makefiles
 --------------------------------------------------------
 
 Building with CMake under MinGW requires you to specify the CMake Generator
@@ -214,7 +273,7 @@ Note the path to FLTK ".." in the last command line. Depending on where you
 installed CMake you may need to adjust the path's in the alias commands.
 
 
- 2.5  Crosscompiling
+ 2.6  Crosscompiling
 ---------------------
 
 Once you have a crosscompiler going, to use CMake to build FLTK you need