home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / dmake40.zip / readme / apple.mac next >
Text File  |  1994-10-23  |  3KB  |  61 lines
  1. MAC specific information for dmake.  This information is provided in the
  2. hope that it makes it easier to install and recompile dmake in a MAC
  3. environment.  I do not own a Mac (and never wish to).  As a result I rely
  4. on others to insure that this version of dmake works as advertized.  If you
  5. have any problems with it please fix them and send me the differences so that
  6. I can incorporate them into future releases and patches.
  7.  
  8.  
  9. 1. ENVIRONMENT VARIABLE SETTINGS
  10.  
  11. Only a single set of settings is available for the macintosh.  There are no
  12. sub-selections for specific OS release and/or environment.
  13.  
  14.    OS         - mac
  15.    OSRELEASE     - NULL
  16.    OSENVIRONMENT - NULL
  17.  
  18.  
  19. 2. IMPLEMENTATION NOTES
  20.  
  21. This port for the Macintosh is specifically designed to be run
  22. under MPW.
  23.  
  24. I had to make a couple of changes to dmake in order to get it to work
  25. on the Mac.  First, MPW provides no documented way to run a
  26. subprocess, so when you use dmake, you MUST use the -n option and
  27. execute the output.  Typically, you will probably want to write a
  28. simple script file to do these operations for you.
  29.  
  30. I added some code so that the Macintosh version of dmake can
  31. use UNIX-style directories to specify include paths and target
  32. and dependency file names.  I.e., if you specify a file "/dir/file",
  33. dmake will look at the file "dir:file".  However, Mac dmake does not
  34. do any translation from files specified by UNIX-style directories
  35. in the recipe line that gets executed.  If you need to translate,
  36. you can use substitution commands.  (For example,
  37. ":$(RELATIVEUNIXFILE:s,/,:,)".)  This code was added so one could
  38. execute dmake's makefile, and also so one would have an easier time
  39. porting other UNIX makefiles.  I would suggest you stick with
  40. Macintosh-style directories for all other makefiles.
  41.  
  42. I was getting memory trashing errors when I was reading in
  43. environmental variables >4K with the -e option.  I had trouble
  44. tracking down exactly what was causing the problem, so decided it
  45. was easier to just clip the length before sending it to the dmake
  46. parser.  I arbitrarily picked 1K as the maximum length, figuring
  47. it was highly unlikely anyone really needed a variable longer than
  48. that from within a makefile.  (This error may be related to the
  49. value you set for MAXLINELENGTH, so to be safe, you should keep
  50. it >1K.)
  51.  
  52. In order to run dmake, you must set (and export) the environmental
  53. variable "OS" to "mac".
  54.  
  55. Finally, dmake looks for the file startup.mk in
  56. "{MPW}tools:{DMSTARTUPDIR}".  "DMSTARTUPDIR" can be defined if you
  57. want to override the default tools directory location.
  58.  
  59. Micah Doyle
  60. micah@leland.Stanford.EDU
  61.