Chapter 9. Format specific documentation

Table of Contents

Watcom format extended functionality
Install and uninstall support on Windows

Depending on the format there are some additional steps required to get extra functionality specific to this format.

Watcom format extended functionality

Open Watcom compiler has possibility of crossplatform building for many platforms. MS Windows binaries are the most common used output of this compiler but it has also possibility of building for DOS, OS/2 and other operating systems. Because of that by default watcom makefiles are outputed with settings for building windows binaries. This default setting can be changed by defining additional platform variable.

# generate makefile.wat dedicated to windows development
bakefile file.bkl -f watcom

# generate makefile.wat dedicated to DOS development in extended 32-bit mode
bakefile file.bkl -f watcom -DPLATFORM_MSDOS=1

# generate makefile.wat dedicated to OS/2 development
bakefile file.bkl -f watcom -DPLATFORM_OS2=1

PLATFORM_MSDOS note

Only 32-bit DOS mode with dedicated extender is supported. Generated makefile contains additional DOS32 variable which points to desired extender. Expected values: X32VM, X32, PMODEW, CAUSEWAY, DOS32A and default DOS4GW .

Install and uninstall support on Windows

By default the install-to and install-headers-to tags won't have any effect on Windows since the install and uninstall MAKE targets are not very common there (unlike in the Unix world).

However you may find it useful to have (un)installation targets under Windows as well. In this case you can enable this feature by defining the FORMAT_HAS_MAKE_INSTALL variable and setting it to 1:

# enable install and uninstall support also under Windows: 
bakefile file.bkl -f msvc -DFORMAT_HAS_MAKE_INSTALL=1

When enabling the install/uninstall support for Windows, you should also set the desired PREFIX and EXEC_PREFIX in your bakefile:

<set var="PREFIX">%MYPROJECTROOT%</set>
<set var="EXEC_PREFIX">%MYPROJECTROOT%</set>