home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
324.lha
/
FarPrint_v1.3
/
FarPrint.doc
< prev
next >
Wrap
Text File
|
1989-12-12
|
4KB
|
83 lines
- 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.