Final makefile adjustments and compiling instructions.
[xboard.git] / winboard / COMPILING
diff --git a/winboard/COMPILING b/winboard/COMPILING
new file mode 100644 (file)
index 0000000..1ab1906
--- /dev/null
@@ -0,0 +1,46 @@
+Compiling with an Integrated Development Envrionment\r
+\r
+    Microsoft Visual C++\r
+    --\r
+    For MSVC 6.0 IDE, all you need to do is 'File|Open Workspace...' and select\r
+    'winboard.dsw'.  Then to build, choose 'Build|Batch Build...' and select\r
+    the targets you want to build.  This method has full support for Debug and\r
+    Release builds either with or without JAWS support.\r
+\r
+    For later versions of Visual C++, open the same workspace and convert when\r
+    prompted.  Then compile as above.\r
+\r
+\r
+    DevCpp\r
+    --\r
+    For DevCpp, you need to 'File|Open Project or File...' and select either\r
+    'winboard.dev' or 'WB4Jaws.dev'.  After parsing the project, you can 'Execute|\r
+    Compile' to build.  This IDE has no facility for defines in the resource\r
+    compiler, so the version information resource will not indicate JAWS support\r
+    even if it actually has that support.  These projects are not set up for\r
+    debugging, but you can do so by adjusting the 'Compiler' and 'Parameters'\r
+    options in the 'Project|Project Options' dialog.\r
+\r
+\r
+\r
+Compiling from the Command Line\r
+\r
+    GCC -- this includes cygwin, mingw, djgpp and others.\r
+\r
+        make -f makefile.gcc\r
+\r
+        You can modify certain settings in the makefile such as JAWS support,\r
+        debugging support.  If using cygwin, you can select whether or not to\r
+        link with cygwin1.dll instead of the msvcrt runtime.\r
+\r
+\r
+    CL -- this includes MSVC and recent Intel compilers.\r
+\r
+        nmake -f makefile.ms        Note: NMAKE, not MAKE\r
+\r
+        For Visual Studio 2005 and later, set VCVER to 8, otherwise set it to 6.\r
+        You can select JAWS support or debugging just like the GCC makefile.  For\r
+        MSVC 6.0 and earlier, you are going to need the latest SDK from Microsoft.\r
+        After you install it, set the SDK_INC variable appropriately.  It defaults\r
+        to the standard location, but you still need to uncomment the line.\r
+\r