home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 529b.lha / BMake_v1.1 / COMPILING < prev    next >
Encoding:
Text File  |  1991-07-03  |  3.6 KB  |  88 lines
  1.  
  2.                        Documentation for Compiling
  3.                        Copyright © 1991 by Ben Eng
  4.  
  5.  
  6. HOW TO MAKE
  7.  
  8. The source code for this program was written for the DICE C compiler,
  9. version 2.06.22, by Matthew Dillon.  The tab size is set to 4.  You will
  10. require the 2.0 Amiga include files from CATS of Commodore-Amiga to compile
  11. this program.  The source code should compile under any ANSI C compiler for
  12. the Amiga, but I wouldn't bet on it.
  13.  
  14. If the executable, `bmake', needs to be recompiled then the following
  15. procedure should be used.
  16.  
  17. First, rename one of the binary executables (either `bigmake' or
  18. `minimake') to the name `make' and move it to a directory in your shell's
  19. execution path.  The Makefile supplied with the program is probably
  20. incompatible with more primitive versions of Make.
  21.  
  22. The `include/scdir.h' header file should be copied to a directory in the
  23. include path for your compiler.  The compiler should be set up to compile
  24. using the Amiga OS 2.0 (or later) include files.
  25.  
  26. The link library `ben.lib' needs to be made first.  Change your directory
  27. to the `ben' directory and type `make'.  If all goes well, then the
  28. `ben.lib' library will be created; it should be moved to the library search
  29. path for your compiler, so that the linker will be able to find it.
  30.  
  31. Change your directory to the main source directory for the make utility and
  32. type `make' to create the binary executable file `bmake'.  This file can be
  33. renamed to the standard `make', and placed in the command search path for
  34. convenience.
  35.  
  36.  
  37. PARAMETERS
  38.  
  39. DEBUG = (1 default) non-zero if debug calls are activated
  40.  
  41.     Defining DEBUG to 0 will disable code generation for the debugging
  42.     option.  The -d command line option will be disabled if DEBUG is 0.
  43.     DEBUG enabled by default (in make.h).  Enabling DEBUG adds about 2400
  44.     bytes to the size of the final executable.
  45.  
  46. FNCALLS = (1 default) non-zero if function calls are activated
  47.  
  48.     If function calls are recognized, this parameter should be defined
  49.     to be non-zero.  Disabling function calls will make the executable
  50.     somewhat smaller, and memory requirements will be lower.  Enabling
  51.     FNCALLS adds about 4600 bytes to the size of the final executable.
  52.  
  53. MAXLINE = (1024 default) the maximum number of characters allowed per line
  54.  
  55.     This parameter limits the maximum size of a line that can be read from
  56.     a Makefile, the maximum size of a line that can be assigned to a
  57.     variable, and the maximum size of a macro expansion.  Effectively,
  58.     MAXLINE is the upper limit on anything manipulated by the Make program.
  59.     Lines of this size are declared in static storage (input.c) and
  60.     dynamically (macro.c, etc.).
  61.  
  62. MAXSUFFIX = (16 default) the maximum number of characters in a suffix
  63.  
  64.     This parameter limits the maximum size of filename extensions
  65.     recognized by the Make program.  This affects suffix rules and other
  66.     operations that operating on suffixes.  Suffixes are allocated on
  67.     the stack and dynamically in this fixed size.
  68.  
  69. MAX_MACRONAME = (256 default) the maximum number of characters in a name
  70.  
  71.     This parameter limits the size of a macro name.
  72.  
  73. MAXPATHNAME    = (108 default) the maximum number of characters in a pathname
  74.  
  75.     This parameter limits the size of a pathname that can be used to
  76.     resolve suffix rules.  Dynamically allocated.
  77.  
  78.  
  79. OPTIONS
  80.  
  81. In the Makefile, the -gs option can added to CFLAGS to enable DICE's
  82. dynamic stack code.  It makes the program grow in size by a couple of
  83. kilobytes, and it slows down execution by a few milliseconds, but it does
  84. make it safe to run the Make program on a huge Makefile that makes
  85. extensive use of recursive macros and rules, without having to worry about
  86. overflowing the stack.
  87.  
  88.