home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / MAWK113.ZIP / mawk113 / INSTALL < prev    next >
Text File  |  1992-01-21  |  2KB  |  72 lines
  1.  
  2. how to install mawk on Unix like OS
  3. --------------------
  4.  
  5. STEP 0:  Read the file UCONFIG.  If your system is there or
  6. something close enough you only need run
  7.  
  8.        build_mawk  your_system  [CC=your_compiler]
  9.  
  10.     
  11. (Build_mawk is a shell script with a first line of #!/bin/sh ; on 
  12. some systems, csh users may need to
  13.  
  14.     /bin/sh build_mawk your_system [CC=your_compiler]
  15. )
  16.  
  17.  
  18. Build_mawk will produce from Makefile.in a Makefile for your_system
  19. and then execute make which will make the mawk executable.
  20.  
  21.     make install
  22.  
  23. is a separate step with user settable macros for the target
  24. directories inside the Makefile.
  25.  
  26.  
  27. else
  28.  
  29.  
  30. how to install on a new system
  31. ------------------------------
  32.  
  33. STEP 1:
  34. You need to link or copy a .h file in mawk/config, that describes your 
  35. configuration, to the mawk directory and name it config.h.  
  36.  
  37. First look at the file mawk/config/generic.h.  This file describes the 
  38. most common situations.  If it describes your machine and system, then 
  39. use it.  If not, you need to make a .h for your system.  You only need 
  40. to make defines that describe how you differ from the description in 
  41. generic.h.  The other .h's in config should serve as sufficient 
  42. examples.  Also look at template.h 
  43.  
  44. STEP2:
  45. In the mawk directory, run build_mawk MF.  This will give you a
  46. generic Makefile which you can adjust the user macros.
  47.  
  48. STEP3:
  49. Run make.  If mawk successfully compiles, two tests will be run on mawk.
  50. The first, in the shell script test/mawk_test, will see if mawk is 
  51. running correctly under normal conditions and the second, test/fpe_test,
  52. will produce floating point exceptions to see if mawk handles things 
  53. like division by zero correctly.  
  54.  
  55. Failing the first test means your source files are corrupted,
  56. or mawk has a bug uncovered by the new environment.
  57.  
  58. Failing the second means adjustments need to be made to floating point 
  59. definitions in your config.h.  
  60.  
  61.  
  62. If you make a new config.h or add a new machine to an existing config.h,
  63. send me the new or cdiffs for the old.  If things just won't work, send 
  64. me the config.h and the error messages and I'll try to figure out what's
  65. wrong.  
  66.  
  67. Mike Brennan
  68. brennan@boeing.com
  69. 24048 146 PL SE
  70. Kent WA 98042
  71.  
  72.