home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff353.lzh / AztecArp / ArpReadMe! < prev    next >
Text File  |  1990-06-02  |  5KB  |  109 lines
  1. ================== Arp 'wrapper' for Manx Aztec 'C' 5.0 ==================
  2. ==========================================================================
  3. Arp  is  Copyright  (c)  1987,88,89  by ARP Authors.  All Rights Reserved.
  4. Wrapper for Manx Aztec 'C' 5.0 updated by Olaf 'Olsen' Barthel of MXM.
  5.  
  6. ================================ Purpose =================================
  7. ==========================================================================
  8. The  5.0  update  to  the  Aztec  'C'  compiler  comes  with  the  new Arp
  9. distribution  files.   That's  fine,  you  may  think,  but:   the  linker
  10. libraries  do not work.  Since Manx once more decided to change the format
  11. of  the  object  files all modules have to be recompiled.  And there's the
  12. second  'trap':   you  can't  recompile  the  libraries using the supplied
  13. files.   Furthermore  the  original Arp distribution disk includes special
  14. startup  code  which  allows  the creation of programs to be made resident
  15. ('pure').   Is  this  code  included with the 5.0 release?  I think you've
  16. guessed  it  -  it  isn't.   Some  files  wouldn't  work properly (missing
  17. INT32s), some wouldn't work at all (scdir.c).
  18.  
  19. These  are  the reasons why we at MXM have taken the opportunity to update
  20. the original wrapper code as well as to add the missing files.
  21.  
  22. ================================ Contents ================================
  23. ==========================================================================
  24. This  distribution  includes  26  main  files which are listed below.  The
  25. single  library glue routines have been placed in the 'glue' subdirectory.
  26. To  recompile  the package the contents of the 'glue' subdirectory have to
  27. be moved to the main directory ('Move Glue /').
  28.  
  29.     a.lib           = Arp interface library (no startup code)
  30.     arp.lib         = Arp interface library with startup code
  31.  
  32.     arpdetach.o     = Arp compatible detach.??? replacement
  33.     gads.o          = Arp replacement for _cli_parse()
  34.     rstart.o        = Resident module startup code
  35.  
  36.     arpbase.h       = Arp base main include file
  37.     arp.h           = Arp function prototypes (Manx/Lattice)
  38.  
  39.     clihelp.c       = CLI Help string definition
  40.     cliparse.c      = Standard CLI parsing module (with Arp flavour)
  41.     clitemp.c       = CLI argument template
  42.     exit.c          = Exit subroutine
  43.     fmalloc.c       = Arp replacements for malloc, etc.
  44.     gads.c          = Arp compatible replacement for cliparse.c
  45.     makefile        = File needed to rebuild the libraries
  46.     pragma.c        = File to be precompiled
  47.     scdir.c         = Arp replacement for scdir()
  48.     vars.c          = Arp global program variables
  49.     wbparse.c       = Arp workbench parsing routine
  50.  
  51.     _exit.c         = Arp exit routine
  52.     _main.c         = Arp main routine (calls your custom main())
  53.  
  54.     aztecglue.asm   = Arp library interface stubs (obsolete)
  55.     crt0.asm        = Arp Aztec 'C' startup code
  56.     dospkt.asm      = Arp replacement for dos_packet()
  57.     lvo.asm         = Arp library vector offsets
  58.     rstart.asm      = Source code for resident module startup code
  59.     tracker.asm     = Arp item tracker source code
  60.  
  61.     glue        = Subdirectory containing 'C' glue code
  62.  
  63. ================================= Usage ==================================
  64. ==========================================================================
  65. The  Arp libraries are linked just like the standard libraries.  Note that
  66. the  default  are 32 bit integers.  If you want to build resident programs
  67. all  modules  have  to  be  compiled  with the -m0b switch (to disable the
  68. creation of the .begin statement).
  69.  
  70. Examples:    CC -so Test.c
  71.         LN Test.o -Larp -Lc
  72.  
  73.         CC -so -m0b Test.c
  74.         LN -o Test rstart.o Test.o -Larp -lc
  75.  
  76. Note  that  it  is  not recommended to use the arpdetach.o module together
  77. with  the rstart.o module unless you check the Arp resident list if you're
  78. already on it (-> a resident program shouldn't do the segment split).
  79.  
  80. ================================= Author =================================
  81. ==========================================================================
  82. The  files  in  this  distribution  were  put together and updated by Olaf
  83. 'Olsen' Barthel of MXM.  The author can be reached via standard mail at:
  84.  
  85.                                Olaf Barthel
  86.                             Brabeckstrasse 35
  87.                              3000 Hannover 71
  88.  
  89.                        Federal Republic of Germany
  90.  
  91.                         Or via electronic mail at:
  92.  
  93.                        Olaf Barthel@Fido 2:247/200
  94.                   Digital Fantasy II (05 11 / 39 22 74)
  95.  
  96. ============== Revision history (most recent change first) ===============
  97. ==========================================================================
  98. V1.4    Fixed missing macros in scdir.c (ARRGH!).
  99.  
  100. V1.3    Split aztecglue.asm into single files (long file still included).
  101.  
  102. V1.2    Introduced  new  variable  '__sloppy__'  set  TRUE  if DOSBase was
  103.     initialized by startup code.
  104.  
  105. V1.1    Changes  to  vars.c,  _main.c  and  rstart.asm to support resident
  106.     programs which don't use Arp.
  107.  
  108. V1.0    Initial update.
  109.