Pine 3.91 for Apollo DomainOS
-----------------------------

This archive contains a patch file that can be applied to Pine 3.91
so that it will compile and run under Apollo DomainOS. It has been
tested with DomainOS 10.3.5 and should run with later versions.

Current bugs
------------

The only known bug is that sometimes the terminal state doesn't get
restored when you exit out of Pine. This seems to only happen after
you compose a message.

One workaround is as follows:
    % vt100
    % setenv TERM vt100
    % pine
By running Pine inside the vt100 emulator with the TERM environement
variable set to vt100, the problem doesn't appear. If you leave the
TERM environment variable set to the default, vt132, then,for some
reason, the screen gets confused between insert and overwrite mode.

The other workaround is to run Pine once and leave it going forever.
This is the method I use. You can iconise it with a custom icon
when not in use.

How to build
------------

1) Obtain the GNU patch program, it compiles and runs on the
   Apollo without any changes. It is possible to aplly the patch
   by hand with a little time as not many files are change.

2) Obtain a clean version of Pine 3.91. Then untar it. It should
   normally untar in the 'pine3.91' directory. If not then some of
   the following instructions may be changed to take account of the
   different location.

3) Untar (or copy) the apollo.pch file into the 'pine3.91'
   directory. This is where it normally goes.

4) cd into the 'pine3.91' directory and type the following
   commands:
      % patch -p1 <apollo.pch
      % find . -name "*.rej" -print
   The find command shouldn't find anything if all went well.

5) You may need to edit the following files to customise
   them to your method of reading news and location of files
   relating to news and pine configuration.

   imap/ANSI/c-client/Makefile

      Location of rsh command. Look for the line with apo:
      on it to change variables related to the Apollo.

   imap/ANSI/c-client/os_apo.h

      Location of mail spool dir and news config files.

   pine/osdep/os-apo.h

      Location of pine config files and other tuning
      parameters.

6) Make sure that execute permissions are set for the
   script files. My tar didn't do this by itself.
      % chmod 755 build imap/ANSI/c-client/drivers pine/*.sh
      % chmod 755 imap/ANSI/ms/makeifexists contrib/utils/*.sh

7) Build Pine with the following command:
      % ./build apo
   The binaries are placed in the 'bin' directory.


Good luck,

John Saunders <johns@rd.scitec.com.au>
