Changes between Version 14 and Version 15 of BuildingFm2

Timestamp:

Sep 21, 2009, 4:14:49 PM (15 years ago)

Author:

Steven Levine

Comment:

Document current build options

BuildingFm2

@@ -41 +41 @@
 Build the release version with
 {{{
+  set HIMEM=
   set DEBUG=
   set FORTIFY=
+  set USE_RC=
   wmake
 }}}
 
-The set statements may be omitted if you have not defined DEBUG or FORTIFY in the environment.
+The set statements may be omitted if you have not defined the variables in the environment.
 
 Build the debug version with
@@ -63 +65 @@
 Once you are familiar with the build process, you can speed up the switch by deleting fm3dll.lrf and the .obj files that you want rebuilt.  This will give wmake enough information to do a proper rebuild without the -a switch.
 
-Build options such as DEBUG and FORTIFY may be specified either in the environment or on the command line.  Choose one method and use it consistently or you may be get unexpected results.
+Build options such as DEBUG and FORTIFY may be specified either in the environment or on the command line.  Choose one method and use it consistently or you may get unexpected results.
 
 The build outputs are:
@@ -94 +96 @@
 Lxlite.exe needs to be in a directory listed in the PATH statement of your config.sys or build enviroment cmd file.
 
-To compress exe/dlls, run
+To compress the executables run
 {{{
 wmake lxlite
@@ -118 +120 @@
 Save the file naming it possibly Build_FM2.cmd.  Copy the file to the root of your fm/2 workspace.  The script must be run from  this directory or it will not find the required files.  After the script finishes, open the warpin subdirectory and you should find the WarpIN file in this directory.
 
+== Build options ==
+
+=== HIMEM ===
+
+If not defined, fm/2 will be built to use low memory only.
+If defined, fm/2 will use upper memory for both code and data.
+
+=== DEBUG ===
+
+If not defined, a release build will be built.  If defined a debug build with be built.
+Debug builds include support for symbolic debugging.
+
+=== WARNALL ===
+
+If not defined, do default compile-time error checking.
+If defined, do more compile-time error checking.
+Errors reported by WARNALL are rarely a problem, but it is recommend that WARNALL be used
+before releasing a production binary.
+
+=== FORTIFY ===
+
+If not defined FORTIFY support is omitted.
+If defined FORTIFY support is enabled.
+FORTIFY added runtime heap corruption and leak checking.
+Be sure to use wmake -a when changing this option.
+
+=== USE_RC  ===
+
+If not defined, build with wrc.exe.
+If defined, build with rc.exe.
+wrc.rc is the preferred resource compiler.