Open Watcom Developer's Guide - HEAnet Mirror Service

Building
3.11 Include Paths
The inc_path macro is composed of several other variables. Projects are able to hook any
of these variables by redefining them after cproj.mif is included. The current structure looks
like this:
inc_path = inc_dirs | inc_dirs_$(host_os) |
inc_dirs_sys
inc_dirs_sys = inc_dirs_lang | inc_dirs_sys_$(host_os)
inc_dirs_lang = $(lang_root)\h
So, a project should put any include directories it needs into inc_dirs — note that this does not
include $(watcom_dir)\h which is part of the default include directory set.
If it needs to, a project can override any and all of these — for instance, the clib needs to be
built with the next release header files, and so would redefine inc_dirs_lang.
Any OS-specific header files needed by the project can be set in inc_dirs_$(host_os)
— again, this should not include the standard system header files, which will be defined in
inc_dirs_sys_$(host_os).
Note that the build system previously used to set the INCLUDE environment variable to hold
the contents of inc_dirs macro. This mechanism is now considered obsolete and should no
longer used. Instead, include paths are passed directly on the command line. This also means
that all include paths must be prepended with a -I switch, for example:
inc_dirs_sys_nt
= -I$(lang_root)\h\nt
3.12 Executive Summary
In order to convert a project to this new structure or create a new (and conforming) project, do
the following:
1. Create an object file directory for each combination of host_os/host_cpu under your
project.
2. Give your project a name, for instance Foo.
3. Create a master.mif in the root of your project.
4. Put all the normal makefile gear in this master.mif.
22 Executive Summary