Pine 4.56 for OS/2 (Source code patches)
(C) 1989-2003 The University of Washington.
OS/2 Port by Nicholas Sheppard (nps at zeta.org.au)


INTRODUCTION
============

Here is all the source code I had to change to get Pine 4.52 to compile
and work under OS/2. Almost all of the changes are to the OS/2-specific
files; however, the following OS-independent files were also modified:

	./pico/main.c
	./pine/args.c

The first file was only modified to remove the command-line options for
colour which (a) don't work and (b) are inconsistent with the other ports,
so you can safely leave it alone if you like. The second file only needs to
be modified if you use forward slashes with the -p or -P option.

The code is based on David Nugent's 3.9x port and the NT code (for
reading local folders), as well as a few bits and pieces from the Unix
code and my own additions and bug-fixes.


COMPILATION
===========

To compile Pine 4.56 for OS/2, you need

  * the original Pine 4.56 source code, available from
    ftp://ftp.cac.washington.edu.au/pine

  * my OS/2 patches, available from
    http://www.zeta.org.au/~nps/software/pine/en/index.html

  * EMX+GCC, available from the ./os2/dev/emx directory on your
    favourite Hobbes mirror, and no doubt many other places.

  * Some form of the make utility. I used GNU Make; others may or may
    not work.

So far as I know, it is not possible to compile Pine using any compiler
than EMX (but I have never tried because I don't own any commercial
compilers).


To build Pine, first install the original source code tree in the usual
way. You need to delete all of the files in ./imap/src/osdep/os2.

From the root of the Pine source tree, unzip (using -d if you are using
PKUNZIP) the OS/2 patches. This will replace all the old files with new
versions, and create a few new files that don't exist in the original
distribution.

Now type `build os2' in the root of the Pine source tree, and wait until
the executables appear in the ./bin sub-directory.