- FarPrint v1.3 -
        Debugging functions for programs which don't have any
                     links to their environment.

        IMPORTANT! FarPrint NEEDS the Arp.Library, read below!

                             BACKGROUND:
                             -----------
Your  compiler usually comes with a set of debugging functions, called
the  debug.lib.   In this collection of routines you will find various
functions  to communicate with a terminal connected to the serial port
of  your  Amiga  at 9600 bps.  A fine idea, but - are you one of those
lucky  guys who own two Amigas or an Amiga and a PC?  If not, FarPrint
may  help  you.  The FarPrint package was created to support debugging
the  fantasy  roleplaying  game  "Legend  of  Faerghail"  and has been
successfully tested with various other projects.

                              FEATURES:
                              ---------
FarPrint  consists  of  two  major parts:  one harbour process open to
receive  and  distribute  messages  and  requests  and  a  set  of 'C'
functions  to  be  linked into any program wishing to communicate with
the  FarPrint main process.  Note that the current version of FarPrint
is  a 'C' implementation only, a shared library and a farprint.lib for
both  Lattice  and  Aztec  'C'  compilers  may follow soon.  While the
standard debug.lib functions may even be able to get a message through
when  the Amiga has already gone home to its masters (Guru!), FarPrint
requires  the  standard  program  environment  (exec, dos, intuition &
graphics)  to  be  intact to display messages.  The interface routines
use  the  functions of the exec.library only, so they are safe to call
even  from  low-level tasks.  Since the employed message system lets a
calling  task  wait  for  a  reply,  FarPrint  cannot  be  called from
interrupt  code.   Future  versions of FarPrint may offer functions to
send texts asynchronously.

The  FarPrint  main  process  runs as an independent program, since it
detaches  itself  from  the  CLI  process  it  has  been started from.
Gadgets  are provided to scroll through the list of recorded messages.
Menu  selections  can  be  used  to interrupt the activity of FarPrint
(Pause/Continue),  save  the  list of recorded messages and to iconify
the FarPrint window.

FarPrint  can  record  up to 128 messages, when the buffer is full the
oldest messages get discarded to make room for the new messages.

                            REQUIREMENTS:
                            -------------
To  execute  successfully,  the  FarPrint  main  process  requires the
arp.library.   Any  version  will  do, version 39.1 is best.  FarPrint
uses  the  famous  file requester for message saving.  FarPrint is not
limited to a special amount of memory.

                            INSTALLATION:
                            -------------
Put arp.library into LIBS:, FarPrint into C: or SYS: and compile the
supplied FarCom.c routines. Lattice users will have to assemble the
assembly language part separately. The resulting object files will
have to be linked to your program code.

                               CREDITS:
                               --------
Credits  go  to  ARP  Programmers  for the phantastic ARP 1.3 release,
Darren  M.   Greenwald  for  the FastText routines, Leo Schwab for the
basic  Iconify  routine,  Justin  V.   McCormick for the printf()-like
formatting  routine  and  to  Jürgen  Haage  whose  R.C.T.  (Requester
Construction  Tool)  was employed to construct the gadget environment.
Thanks to all of you.

                   COPY FEE, AUTHORS REQUEST, ETC.:
                   --------------------------------
If you like FarPrint program and wish to contribute any money I urge you
to send at least 5$ to...

                          Amnesty International
                          P.O. Box 37137
                          Washington D.C. 20013

I  suppose Amnesty International can make better use of the money than
I can.

I don't care what happens to FarPrint, copy it, sell it, delete it, it
is meant to be PUBLIC-DOMAIN.  But don't 'fleece' other users for it.