home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d2xx / d281 / farprint.lha / FarPrint / FarPrint.doc < prev    next >
Text File  |  1989-11-20  |  4KB  |  83 lines
  1.                           - FarPrint v1.3 -
  2.         Debugging functions for programs which don't have any
  3.                      links to their environment.
  4.  
  5.         IMPORTANT! FarPrint NEEDS the Arp.Library, read below!
  6.  
  7.                              BACKGROUND:
  8.                              -----------
  9. Your  compiler usually comes with a set of debugging functions, called
  10. the  debug.lib.   In this collection of routines you will find various
  11. functions  to communicate with a terminal connected to the serial port
  12. of  your  Amiga  at 9600 bps.  A fine idea, but - are you one of those
  13. lucky  guys who own two Amigas or an Amiga and a PC?  If not, FarPrint
  14. may  help  you.  The FarPrint package was created to support debugging
  15. the  fantasy  roleplaying  game  "Legend  of  Faerghail"  and has been
  16. successfully tested with various other projects.
  17.  
  18.                               FEATURES:
  19.                               ---------
  20. FarPrint  consists  of  two  major parts:  one harbour process open to
  21. receive  and  distribute  messages  and  requests  and  a  set  of 'C'
  22. functions  to  be  linked into any program wishing to communicate with
  23. the  FarPrint main process.  Note that the current version of FarPrint
  24. is  a 'C' implementation only, a shared library and a farprint.lib for
  25. both  Lattice  and  Aztec  'C'  compilers  may follow soon.  While the
  26. standard debug.lib functions may even be able to get a message through
  27. when  the Amiga has already gone home to its masters (Guru!), FarPrint
  28. requires  the  standard  program  environment  (exec, dos, intuition &
  29. graphics)  to  be  intact to display messages.  The interface routines
  30. use  the  functions of the exec.library only, so they are safe to call
  31. even  from  low-level tasks.  Since the employed message system lets a
  32. calling  task  wait  for  a  reply,  FarPrint  cannot  be  called from
  33. interrupt  code.   Future  versions of FarPrint may offer functions to
  34. send texts asynchronously.
  35.  
  36. The  FarPrint  main  process  runs as an independent program, since it
  37. detaches  itself  from  the  CLI  process  it  has  been started from.
  38. Gadgets  are provided to scroll through the list of recorded messages.
  39. Menu  selections  can  be  used  to interrupt the activity of FarPrint
  40. (Pause/Continue),  save  the  list of recorded messages and to iconify
  41. the FarPrint window.
  42.  
  43. FarPrint  can  record  up to 128 messages, when the buffer is full the
  44. oldest messages get discarded to make room for the new messages.
  45.  
  46.                             REQUIREMENTS:
  47.                             -------------
  48. To  execute  successfully,  the  FarPrint  main  process  requires the
  49. arp.library.   Any  version  will  do, version 39.1 is best.  FarPrint
  50. uses  the  famous  file requester for message saving.  FarPrint is not
  51. limited to a special amount of memory.
  52.  
  53.                             INSTALLATION:
  54.                             -------------
  55. Put arp.library into LIBS:, FarPrint into C: or SYS: and compile the
  56. supplied FarCom.c routines. Lattice users will have to assemble the
  57. assembly language part separately. The resulting object files will
  58. have to be linked to your program code.
  59.  
  60.                                CREDITS:
  61.                                --------
  62. Credits  go  to  ARP  Programmers  for the phantastic ARP 1.3 release,
  63. Darren  M.   Greenwald  for  the FastText routines, Leo Schwab for the
  64. basic  Iconify  routine,  Justin  V.   McCormick for the printf()-like
  65. formatting  routine  and  to  Jürgen  Haage  whose  R.C.T.  (Requester
  66. Construction  Tool)  was employed to construct the gadget environment.
  67. Thanks to all of you.
  68.  
  69.                    COPY FEE, AUTHORS REQUEST, ETC.:
  70.                    --------------------------------
  71. If you like FarPrint program and wish to contribute any money I urge you
  72. to send at least 5$ to...
  73.  
  74.                           Amnesty International
  75.                           P.O. Box 37137
  76.                           Washington D.C. 20013
  77.  
  78. I  suppose Amnesty International can make better use of the money than
  79. I can.
  80.  
  81. I don't care what happens to FarPrint, copy it, sell it, delete it, it
  82. is meant to be PUBLIC-DOMAIN.  But don't 'fleece' other users for it.
  83.