web: add help for compiling check using Visual Studios

git-svn-id: svn+ssh://svn.code.sf.net/p/check/code/trunk@1033 64e312b2-a51f-0410-8e61-82d0ca0eb02a

diff --git a/web/install.html b/web/install.html
index 4a215fdfcb0a61f71cb2122676ae3b1c237e2dea..e14f7981f3e98a899a11fa3964f6ecd42744fa7e 100644 (file)
--- a/web/install.html
+++ b/web/install.html
@@ -86,6 +86,7 @@ a package manager or compile from source on one's platform.
         <li><a href="#cygwinpackage">Cygwin via Package Manager</a></li>\r
         <li><a href="#cygwinsource">Cygwin From Source</a></li>\r
         <li><a href="#mingwsource">MinGW/MinGW-w64 From Source</a></li>\r
+        <li><a href="#visualstudios">Visual Studios From Source</a></li>\r
     </ul>\r
 </ul>\r
 \r
@@ -325,6 +326,51 @@ and give details as to the failure so it may be investigated and fixed.
 <br></br>\r
 \r
 \r
+<a name="visualstudios"></a>\r
+<h3>Visual Studios From Source</h3>\r
+<p>\r
+Check must be compiled from source for Windows. Note that no fork()\r
+call is available, and Check's fork mode will be disabled. The CMake build system\r
+is supported for compiling Check with Visual Studios, so download\r
+<a href="http://www.cmake.org/cmake/resources/software.html">CMake</a> first.\r
+</p>\r
+<p>\r
+After the\r
+<a href="http://sourceforge.net/projects/check/files/latest/download">latest Check source</a>\r
+has been downloaded and unpacked, open the CMake GUI program. Fill in the\r
+"Where is the source code" and "Where to build the binaries" fields to\r
+point to the unpacked location of the Check source, and press the\r
+Configure button. Select the version of Visual Studios to use, and click\r
+"OK". Once the configuration completes, CMake will highlight two settings,\r
+CMAKE_CONFIGURATION_TYPES and CMAKE_INSTALL_PREFIX. You may leave them as\r
+their defaults or modify them. Finally, click "Generate" to create the\r
+Visual Studio project files.\r
+</p>\r
+<p>\r
+Open Visual Studios and load the generated project files. The following\r
+is a summary of the important build targets:\r
+<ul>\r
+    <li><b>ALL_BUILD</b>: Build Check and all unit tests</li>\r
+    <li><b>RUN_TESTS</b>: Execute Check's unit tests</li>\r
+    <li><b>INSTALL</b>: Install Check to the CMAKE_INSTALL_PREFIX location\r
+                        listed from the CMake GUI</li>\r
+</ul>\r
+</p>\r
+<p>\r
+To compile, validate, and install Check, run these three targets from\r
+Visual Studios. Note that the RUN_TESTS target only runs Check's unit\r
+tests which do not require a shell interpreter. The remaining tests must\r
+be run in a MSYS or comparable environment.\r
+</p>\r
+<p>\r
+If any of the build targets fail, including the RUN_TESTS target, \r
+please send an email to Check's\r
+<a href="https://lists.sourceforge.net/lists/listinfo/check-devel">mailing list</a>\r
+and give details as to the failure so it may be investigated and fixed.\r
+</p>\r
+<br></br>\r
+\r
+\r
 \r
 </div>\r
 \r