Introduction
============

This is the initial release of the OS/2 port of V. It is released at
version 1.17, the same as the current version of V for Windows and X
and should be completely compatible.

Getting Started
===============

The port was completed primarily using Borland C++ for OS/2 v2.0.  A
complete set of project files for all the sample applications included
with V can be found in the directory BORCPP.  You may need to
reconfigure the project directories settings for your particular system.

To get going, it is recommended that you first compile the VOS2.LIB
library file defined in the Borland project called vos2.prj.  After
successfully compiling VOS2.LIB you can then begin compiling and linking
the many sample programs provided with V to get a taste of what V can
do.

The OS/2 port has also been compiled with IBM's VisualAge C++ for os/2.
An incomplete set of make files for the V distribution can be found in
the directory IBMCPP.  It would be apprreciated if VisualAge users would
submit additional make files so that we can offer a more complete set of
make files in future releases.

Debugging
=========

V includes a built-in configurable debugging system that is described
fully in the V users guide.  In the X port, the debugging output is
written to stderr using printf.  In Windows and OS/2, printf does not
work and so it would seem the debugging routines are pretty much
useless.  While this is true for Windows, there is a workaround for
OS/2.  The public domain program PMPRINTF, written by Mike Cowlishaw of
IBM, will allow debug output to be viewed in a separate PM window as
your V program executes.

(NOTE: If you get errors about redefining printf() then you may
have to tweak the printf.c code so that the prototype matches whatever
your standard c lib uses.  The printf.c code allows debugging output
to be displayed using the pmprint.exe application. (Delete printf.c
if it causes too much grief but the V built-in debugging will then cease
to be useful.)


Jon Hacker
V port to OS/2
Feb 24/98.

For technical support join the V users mailing list.
vgui-discuss@attila.apana.org.au