home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / language / slperl / explain < prev    next >
Encoding:
Text File  |  1993-10-23  |  2.8 KB  |  78 lines
  1. Here is a brief explaination of the diffs in perl.diffs. If anything
  2. is unclear please just ask:
  3.  
  4. General:
  5.   Many of the  #ifdef MSDOS where required for the atari too. In order
  6. to avoid cluttering up the source, upfront in perl.h we #define
  7. MSDOS_OR_ATARI if either defined(MSDOS) or defined(atarist).
  8.  
  9.  Some of the diffs that i felt were universally applicable are not protected
  10. with #ifdef's. In the explainations below i has indicated all such
  11. changes.
  12.  
  13. perl.h:
  14.   -- define MSDOS_OR_ATARI if appro.
  15.   -- typedef size_t - assume its there in <stddef.h> if STANDARD_C otherwise
  16.      typedef it to unsigned int (i would have ideally liked unsigned long,
  17.      but we get into trouble with half-assed headers from sun etc)
  18. (this change not protected with a #ifdef since hopefully its universally appli)
  19.  
  20.   -- make the type of STRLEN size_t for all systems
  21. (this change not protected with a #ifdef since hopefully its universally appli)
  22.  
  23.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  24.  
  25. arg.h:
  26.   -- in the atari headers we already have O_PIPE. Change all instances of
  27.      O_PIPE to PERL_O_PIPE. All such changes protected with #ifdef atarist.
  28.  
  29. handy.h:
  30.   -- make MEM_SIZE size_t like STRLEN.
  31. (this change not protected with a #ifdef since hopefully its universally appli)
  32.  
  33. doarg.c:
  34.   -- accomodate the large number of args needed for the atari syscall().
  35.   -- do the 9 thru 14 arg versions of syscall for the atarist.
  36.  
  37. doio.c:
  38.   -- mode[] needed to be  initialized.
  39. (this change not protected with a #ifdef since hopefully its universally appli)
  40.  
  41.   -- you may find this strange, we do not define STDSTDIO, because even
  42.      though we have the "standard" field in FILE, the semantics are
  43.      different. However, some contexts will work correctly, and there
  44.      you will see #if defined(STDSTDIO) || defined(atarist)
  45.  
  46.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  47.  
  48. eval.c:
  49.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  50.  
  51. malloc.c::
  52.   -- instead of bashfully using ints to hold sizes use MEM_SIZE.
  53.      adjust some casts and printf format specifiers due to this.
  54.      (atarigcc can run in two modes, with 16 or 32 bit ints, so...)
  55. (this change not protected with a #ifdef since hopefully its universally appli)
  56.  
  57.   -- atarist changes sometimes ||'ed with I286 as appro.
  58.  
  59. perl.c:
  60.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  61.  
  62. regcomp.c:
  63.   -- like O_PIPE the atarist headers already has META defined. Change all
  64.      instances of META to PERL_META. All such changes protected with
  65.      #ifdef atarist.
  66.  
  67. str.c:
  68.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  69.  
  70. token.c::
  71.   -- META -> PERL_META renaming for atari
  72.  
  73. util.c::
  74.   -- more adjustments for memory sizes being MEM_SIZE instead of int.
  75.   -- more #ifdef MSDOS -> #ifdef MSDOS_OR_ATARI changes.
  76.  
  77. ++jrb  bammi@cadence.com
  78.