= Building the drivers =

The original build instructions are at
[http://svn.netlabs.org/repos/uniaud/GPL/trunk/howtobuild.txt]

The new build instructions are here.

== Install !OpenWatcom ==

The first thing you need to do is install [http://www.openwatcom.org/ OpenWatcom].  You need to install at least the 16-bit and 32-bit OS/2 targets.  It is assumed that you will be installing the OS/2 hosted version of  Open Watcom.

== Install the DDK ==

If you are going to build uniaud16, you need to install the IBM Driver Development Kit (DDK) Toolkit.  IBM no longer makes this toolkit publically available, so if you need a copy TBD.  The long term plan is to implement open source versions of the DDK headers in !OpenWatcom and this will eliminate the need for the DDK to build uniaud.

If you are only building uniaud32, you do not need the DDK.

== Configure the build environment ==

Now you need to build Makefile.inc.  This file configures the uniaud makefiles for your specific directory layout.  Assuming directory layout described in [WikiStart#Gettingthesources Getting the sources], run

{{{
cd uniaud32_workspace
trunk\configure
}}}

and answer the questions.  If you don't have a copy of the DDK, enter a syntatically valid path.

Review the generated Makefile.inc and verify that the pathnames are correct.  This script has some issues.

Once you are satisfied, copy Makefile.inc to the root of your uniaud16 workspace.  This is the uniaud16_workspace referred to in the example [WikiStart#Gettingthesources Getting the Sources].  There really should need to be only one instance of Makefile.inc file, but this will have to wait until the makefiles get some needed rework.

== Build uniaud32 ==

To build uniaud32, do whatever you do that make the !OpenWatcom available in the current command line session and then

{{{
cd uniaud32_workspace\trunk
!m_kee.cmd
}}}

!m_kee.cmd is a simple wmake front-end.

A full build should take less than 15? minutes on reasonably capable hardware and should complete without errors or warnings.

It is considered bad practice to commit sources that do not build error and warning free to the subversion repository.  However, when multiple developers are making concurrent changes, this can happen.

== Build uniaud16 ==


To build uniaud16

{{{
cd uniaud16_workspace\trunk
wmake -ms -f makefile.os2
}}}

A full build should take less than 5? minutes on reasonably capable hardware and should complete without errors or warnings