home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff396.lha / resident / Resident.doc < prev    next >
Text File  |  1990-10-29  |  4KB  |  76 lines
  1. ============================== Resident ==============================
  2. ======================================================================
  3. A resident startup code for Aztec 'C', written by Olaf 'Olsen' Barthel
  4. of  MXM.   Copyright,  © 1990 by MXM.  Shareware, all rights reserved.
  5. No guarantee of any kind is made that the program(s) described in this
  6. document are 100% reliable.  You use this material on your own risk.
  7.  
  8. ============================== Purpose ===============================
  9. ======================================================================
  10. You  usually  need  Arp to create reentrant programs with Aztec 'C'.
  11. You  may also compile your program with Aztec 'C' 5.0 and use inline
  12. library calls.  Isn't there a different solution?  There is!  I have
  13. created  a  resident startup code which copies the data segment into
  14. public ram thus keeping it from getting modified.  The resident code
  15. can  eat up a whole lot of memory.  Don't worry, it will be freed as
  16. soon as the program exits.
  17.  
  18. =============================== Usage ================================
  19. ======================================================================
  20. Assemble  Resident.asm as usual and link it to your program (must be
  21. last  file  name  before  the linker libraries are included).  Don't
  22. forget to add the pure bit to the program it creates.  An example:
  23.  
  24.         CC Test.c
  25.         AS Resident.asm
  26.         LN -o Test Test.o Resident.o -Lc
  27.  
  28. I  have supplied a demonstration program which draws a vector cube and
  29. moves  and  turns it a few times (double buffered).  'DamagedCube' was
  30. written  by  Dieter  Klimow  who  created  it  as a simple programming
  31. exercise.   I  have  converted  it  to  run on the Amiga (the original
  32. program runs on a 12 MHz PC-Laptop with VGA). Press any key to exit.
  33.  
  34. =============================== Notes ================================
  35. ======================================================================
  36. There  are  some  pitfalls  you  might want  to know of  before  using
  37. 'Resident.o'.  Here is a list:
  38.  
  39. - You  cannot  use the code with programs which are compiled using the
  40.   large code/large data memory model.
  41.  
  42. - Programs  to  use  'Resident.o'  must  not use scatter loading, i.e.
  43.   data/bss must reside in a single hunk.
  44.  
  45. - Data   and   bss   will   reside   in   the   same  type  of  memory
  46.   (chip/public/fast).
  47.  
  48. =============================== Author ===============================
  49. ======================================================================
  50. This  program was written by Olaf Barthel of MXM.  All files have been
  51. placed in the public domain.  You may freely distribute this material,
  52. even  a  small  copy  fee  is  okay  but  everything  which looks like
  53. commercial distribution is forbidden.  Still you may use this material
  54. for software development without giving credit to the original author.
  55. Feel free to use 'Resident.o' in commercial programs.
  56.  
  57. Send   new   program  revisions,  comments,  bug  reports,  donations,
  58. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  59. horoscopes, promising capital investments, etc.  to:
  60.  
  61.                           Olaf Barthel, MXM
  62.                           Brabeckstrasse 35
  63.                           D-3000 Hannover 71
  64.  
  65.                      Federal Republic of Germany
  66.  
  67. ============ Revision history (most recent change first) =============
  68. ======================================================================
  69. V1.0    If works so far. Hope so. Knock on wood.
  70.  
  71.                                   *
  72.  
  73.              Do only its possibilities make it an Amiga?
  74.  
  75.                         WHERE IS THE MAGIC ???
  76.