home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gawk-2.15.6-base.tgz / gawk-2.15.6-base.tar / fsf / gawk / README.amiga < prev    next >
Internet Message Format  |  1993-06-01  |  4KB
  1. From:    "Lars Hecking" <ST000002@hrz1.hrz.th-darmstadt.de>
  2. Date:    Thu, 3 Dec 1992 17:56:24 -0400
  3. Subject:      Gawk-2.14 -- Amiga-Port, the 2nd
  4.  
  5. Gawk on the Amiga has been compiled and tested using the Amiga port
  6. of gcc by Markus Wild (wild@nessie.cs.id.ethz.ch). I recommend the use
  7. of this compiler (at least v2.2.2) because the provided environment
  8. (includes, libs, binutils) allows straight-forward porting of BSD/UNIX
  9. programs. Gcc compiled programs access/emulate UNIX syscalls via a
  10. shared library (ixemul.library); thus, only minimal changes to the
  11. source are necessary. That release also provides a `sh'- command. If
  12. no `sh'-command is available or another compiler is being used,
  13. `config.h' and `Makefile' are to be created by hand. Since I'm afraid
  14. that none of the Amiga-specific make-commands handles UNIX-style
  15. makefiles correctly I suggest the use of Dennis Vadura's`dmake',
  16. which is available on the Amiga (v3.6). I'm currently using dmake v3.8
  17. (a hack) or GNU make v3.62 (another hack :), which even allows
  18. to start multiple make jobs! Thanx to Markus!).
  19.  
  20. Machine Configuration    (obsoleted by gawk 2.16)
  21. ---------------------
  22. Only copy the following into config/amiga:
  23.  
  24. Amiga under AmigaOS with gcc
  25. DOPRNT_MISSING 1
  26. ENVSEP ','
  27. DEFPATH  ".,/usr/local/lib"
  28. HAVE_UNDERSCORE_SETJMP 1
  29. SRANDOM_PROTO 1
  30. STDC_HEADERS 1
  31.  
  32. The gcc compiler and the compiled executables are working under
  33. AmigaOS 1.2/1.3 as well as AmigaOS 2.x. However, some very special
  34. functions of ixemul.library currently require AmigaOS 2.x to work
  35. properly.
  36.  
  37.  
  38. How to compile (obsoleted by gawk 2.16)
  39. --------------
  40. Compiling and installing on the Amiga rather clones the UNIX-
  41. installation:
  42.  
  43. After you have extracted the `gawk' distribution, `cd' to `gawk-
  44. 2.14'. Look in the `config' subdirectory for a file that matches your
  45. machine (in this case: `amiga', if the gawk maintainers put it there
  46. :).
  47.  
  48.    If you find such a file, run the command:
  49.  
  50.      sh configure amiga
  51.  
  52.    This produces a `Makefile' and `config.h' tailored to your system.
  53.    You may wish to edit the `Makefile' to use a different C compiler,
  54.    such as `gcc', the GNU C compiler (recommended), if you have it.
  55.    You may also wish to change the `CFLAGS' variable, which controls
  56.    the command line options that are passed to the C compiler (such as
  57.    optimization levels, or producing `resident'-able code)
  58.  
  59.    After you have configured `Makefile' and `config.h', type:
  60.  
  61.      make
  62.  
  63. and shortly thereafter (a little bit longer on a 7MHz machine >:->,
  64. you should have an executable version of `gawk'. That's all there is
  65. to it!
  66.  
  67. Testing
  68. -------
  69. Gawk succeeds in all tests, but not with 'make test'. When executing
  70. the tests by hand (e.g. 'make swaplns' and so on) gawk runs all tests
  71. ok except for the following:
  72. - argarray, awkpath: these do not work due to insufficient environment
  73.                      variable handling by pdksh ('bin:sh')
  74. - poundbang, regtest: pdksh refuses to handle the #! statement
  75.                       properly
  76. Modifying these tests in a way that only *gawk-features, not *sh-
  77. features are tested, it is found that gawk succeeds here too.
  78. - manyfiles: (error: too many open files) ixemul.library v39.45 uses
  79.              OPEN_MAX=64; manyfiles required at least OPEN_MAX=106
  80. This may only be overcome when mwild releases a new ixemul.library.
  81. Changing the number '100' in the 'manyfiles::'-target in
  82. 'test/Makefile' to some value <= 58 (depends on the number of
  83. currently open files in ixemul.library) gawk tests successfully, too.
  84.