Compiling XWP

Hi all,

I'm Gabriele Gamba and I first of all want to say that I'm totally ignorant about programming! More: these instructions come from one that is currently not able to successfully compile XWorkplace on his computer, so... use at your risk :-) So, what follows is just a draft, that I hope someone more computer literated than me can correct and extend, and I will be very happy to let him the honours for this page :-)

Information listed here comes from progref.inf file included in the XWP's sources and from Ulrich's page about setting up CVS.

Supposing that you already have a working CVS setup, do this:

go in your CVS root folder (e.g. x:\CVS)
do "SET CVSROOT=:pserver:guest@www.netlabs.org:/netlabs.cvs/xworkplace"
create a subdirectory in your CVS root directory named "xworkplace" (e.g. x:\cvs\xworkplace)
change to xworkplace directory and do "SET USER=guest"
from the same directory, do "CVS login"; enter "readonly" when you are prompted for password
do "cvs checkout -r branch-1-0 ." <-- don't forget the last dot!

This last command will retrieve the most updated stuff from CVS. Now you need the XWorkplace helpers.

go again in your CVS root folder (e.g. x:\CVS)
do "CVSROOT=:pserver:guest@www.netlabs.org:/netlabs.cvs/xwphelpers"
create a subdirectory in your CVS root directory named "xwphelpers" (e.g. x:\cvs\xwphelpers)
change to xwphelpers and do "cvs checkout -r branch-1-0 ."

You just downloaded from CVS all what you need to compile the very latest XWP stuff. Now, the compilation environment:

IBM VisualAge C++ 3.0 with fixpak 8 is reccomended (and it is also the only environment currently supported.
OS/2 Developer's Toolkit for all the SOM header files and the SOM compiler: the ones included in eCS 1.2 CD #2 seems good.

Now, you have on your computer all what is needed to try to compile XWP :-)

first of all, adjust x:\CVS\xworkplace\config.in to your needs
then, from x:\CVS\xworkplace\ run "nmake dep". If you have never built XWorkplace before, "nmake dep" will give you lots of warnings that headers could not be found. This is normal.
After that, run either "nmake all" or "nmake really_all". "nmake all" 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.