Making (Building) XWorkplace

Starting the build process. Starting with V0.9.12, this is a two-step process. After opening a command line in the main XWorkplace directory (the parent of src and include), do this:

Run nmake dep. This examines all source files for dependencies (#include statements) and writes a .depend file into each source directory which is then used by the makefiles to rebuild things properly.
Note: You only need to run nmake dep before building for the first time, or if source dependencies (#include statements) have changed. To be on the safe side, re-run nmake dep once after you have checked out new sources from the CVS server.
nmake dep uses the fantastic fastdep utility by Knut Stange Osmundsen, which I have stolen from the Odin sources. This should be in the root directory of your xwphelpers repository.
Note: If you have never built XWorkplace before, nmake dep will give you lots of warnings that headers could not be found. This is normal because the SOM headers for the XWorkplace classes will only be produced during the first full build.
After that, run either nmake all or nmake really_all to build. This will produce lots of object files in bin\ and the executables in bin\modules. At the same time, those executables are copied to the proper locations in your XWorkplace installation directory as specified in config.in.
After that, restart the WPS to have XFLDR.DLL reloaded.
nmake all (or just nmake) will only rebuild XFLDR.DLL, XWPDAEMN.EXE, and XWPHOOK.DLL, while nmake really_all will produce the full set of XWorkplace executables plus the NLS files.

Rebuilding the whole thing. To rebuild everything, you have three options:

Delete the entire bin\ tree. This is not part of the CVS repository at Netlabs and recreated dynamically for all files that have been created. Deleting it will cause all target object files to become outdated and thus be recompiled, which will then also invoke the linker.
Use nmake -a on the main makefile. This will even re-invoke the SOM compiler on all .IDL files.
Open and save (or touch) include/setup.h to make it newer than the target files. This is #include'd in all XWorkplace C files, and the makefiles' inference rules will then enforce recompilation of all C files.