Power-Programmierung

home *** CD-ROM | disk | FTP | other *** search

/ Power-Programmierung / CD1.mdf / lisp / interpre / xlispplu / ndmake / make.doc next >

Wrap

Text File | 1987-11-29 | 52.2 KB | 1,585 lines

NDMAKE version 4.3 ------------------ Copyright (C) 1985, 1986 D. G. Kneller All rights reserved. Table of contents ----------------- Introduction....................................................2 Requirements....................................................2 Synopsis........................................................3 Make description files..........................................3 Dependency and command lines....................................3 Macros..........................................................5 Default rules...................................................7 "dot targets" .IGNORE, .PRECIOUS, .SILENT, .SUFFIXES............8 Command prefixes -, @, !, >, >>.................................8 The loop prefix `!'.........................................9 Output to files `>' and `>>'................................9 VPATH..........................................................10 Options........................................................12 DOS commands, batch files, redirection and error codes.........13 Response files -- special handling of LINK and LIB.............14 1) LINK response files.....................................14 2) LIB response files......................................14 UNIX features..................................................15 Additional notes and technical information.....................16 Sample session.................................................17 Use of flags -t, -i, -n, -d, and -p............................19 Using MAKE without a makefile..................................20 Changes since version 3.0......................................21 Changes since version 4.0......................................21 Future directions for NDMAKE...................................22 USER-SUPPORTED SOFTWARE NOTIFICATION...........................23 Registration form for NDMAKE...................................24 NDMAKE v4.3 page 2 Introduction ------------ NDMAKE is an implementation of the UNIX(tm) program maintenance utility called `make'. It has the same syntax and all of the capability. If you are familiar with UNIX `make' you should have no difficulties with NDMAKE. Please note that NDMAKE is user supported software. Some advanced features have been disabled in the demo version of NDMAKE. Details for registering your copy are at the end of this documentation. In the rest of this documentation, NDMAKE will often be referred to simply as MAKE. MAKE is a utility that helps you maintain programs, particularly programs that are composed of several modules (files). MAKE has several features that make it very useful for software development: 1) Once you describe the relationships between modules, MAKE will keep track of them and only `make' those that are out of date with respect to their sources. You don't waste time figuring out which files you've changed, which have to be recompiled, how to link them, ... 2) Automatic response files for LINK and LIB. Under MSDOS(tm), commands must be shorter than the command line limit of 128 characters. Since LINK is used often when doing modular programming, MAKE knows about it specially and will automatically generate a response file if the LINK command is longer than the limit. MAKE will do a similar thing with LIB. See the section entitled "Response files" for details. 3) Detection of errors when running internal DOS commands. Previous versions of NDMAKE couldn't detect errors when DOS commands were run or when IO redirection occurred because COMMAND.COM doesn't return a proper error code (for DOS < 3.0). 4) VPATH. Often when doing program development you want to create several slightly different versions of a program, but keep a common set of sources. For example, you may have to create machine specific or memory model specific modules. Using the VPATH feature of MAKE it is possible to have sources in directories different from the current directory and have MAKE find them. Actually, VPATH is more powerful (and complex) then that, so please see the VPATH section for details. Requirements ------------ MAKE requires at least DOS 2.0 and uses a minimum of about 42000 bytes of memory. Since MAKE executes other programs from within itself, this memory will be unavailable to them while MAKE is running. Also, MAKE uses the file time to determine which files are newer than others so it is imperative that you either have a real-time clock or are diligent about setting the time and date when you boot up. NDMAKE v4.3 page 3 Synopsis -------- make [ -f makefile ] [ options ] [ macros ] [ targets ] The [ ] delimit optional parameters. [ options ] and [ macros ] will be discussed later. MAKE executes commands in a MAKE description file to update one or more targets. The targets are typically the names of programs. If no -f option is present, the MAKE description file called `MAKEFILE' is tried. If makefile is `-', the keyboard (standard input) is used as the makefile. More than one -f option may appear. Make updates a target if it is older than the files it depends on, or if the target does not exist. If no targets are given on the command line, the first target in the makefile is `made'. MAKE description files ---------------------- MAKE uses 2 description files: MAKE.INI and makefile. The description files consist of several entries: 1) dependency and command lines 2) macro definitions 3) default rules 4) "dot commands" When MAKE starts up, it looks for an initialization file called MAKE.INI. This file usually contains only default rules and macro definitions that you don't want to put in every makefile. The current directory is searched first, followed by directories along the PATH. You customize your copy of MAKE by changing MAKE.INI. 1) Dependency and command lines ------------------------------- These are lines that specify the relationship between targets and prerequisites, and how to update the targets. The general form is: target [ target ... ] : [ prerequisites ] [ <tab>command ] .... where <tab> is the tab character. The first line of an entry is a blank-separated list of targets, then a colon, then a list of prerequisite files. All following lines that begin with a tab are commands to be executed to update the target. A NDMAKE v4.3 page 4 target with no prerequisites is considered up to date if it exists and out of date if it doesn't exist. When you do the `make' without any arguments, the first target in makefile gets made. A dummy target (a file that never exists so is always out of date) is often used as the first target when you wish to make several targets. Consider this makefile: all : target1.exe target2.exe target1.exe : .... commands target2.exe : .... commands Executing `make' with no arguments results in both target1.exe and target2.exe being made. This happens because MAKE always ensures all prerequisites are up to date before it makes a target. Here, the target ALL has two prerequisite files - TARGET1.EXE and TARGET2.EXE. First TARGET1.EXE then TARGET2.EXE get made, then MAKE checks if either of these files are more current than ALL. Since ALL doesn't exist, both are newer than it, and the commands to update ALL will be executed. There are no commands for this example. As an further example, assume you have a program TEST.EXE that is composed of modules MAIN.OBJ and SUB.OBJ. Each of these depend on a common include file, INCL.H, and on their respective `.c' files. The makefile might look like: test.exe : main.obj sub.obj link main.obj sub.obj, test; main.obj : main.c incl.h msc -AL main.c; sub.obj : sub.c incl.h msc -AL sub.c; A target may appear on the left of more than one `colon' line, and it will depend on all of the names on the right of the colon on those lines, but only one command sequence may be specified for it. An example a little further down will show this. NDMAKE v4.3 page 5 2) Macros --------- Makefile entries of the form: name = [value] are macro definitions. Macros allow the association of a name and a value. Subsequent appearances of $(name) or ${name} are replaced by value. If name is a single character, the parentheses or braces are optional. Spaces between name and =, and between = and value are ignored. If value is not given, the macro value is a null string. MAKE warns you if you use a macro that hasn't been defined. The previous example could have had: OBJS = main.obj sub.obj test.exe : $(OBJS) link $(OBJS), test; $(OBJS) : incl.h # main.obj and sub.obj depend on incl.h main.obj : main.c # As well, main.obj depends on main.c msc -AL main.c; # There is only one command sequence which echo Done # may of course be several lines long. sub.obj : sub.c # sub.obj depends on sub.c msc -AL sub.c; MAKE evaluates macros only when needed, and the order in which macros appear in a description file is insignificant. Conventionally, all definitions appear at the top of the description file. If the same name is defined more than once, the most recent definition is used. The precedence of definitions is: 1. command line definition (highest) 2. makefile definition 3. MAKE.INI definition 4. environment definition (lowest) If make.ini has macros MODEL=S and CFLAGS=-A$(MODEL) -Od, but you do: A> make MODEL=L then when it comes time to use CFLAGS, MAKE will expand CFLAGS as `-AL -Od'. This is because command line macros have the highest precedence. For command line macros that include spaces, place the macro value in double quotes "": A> make CFLAGS="-Od -Zi" The lowest precedence of macro is the environment definition. This refers to the environment variables put into the DOS environment with the `SET variable = value' DOS command. For example, you could refer to the ${PATH} macro without defining it in make.ini or makefile. Its value comes out of the DOS environment. NDMAKE v4.3 page 6 MAKE will let you define a recursive macro: macro1 = $(macro2) # macro1 = the value of macro2 macro2 = $(macro1) # macro2 = the value of macro1 but signals a `recursive macro' error if it tries to use it. Predefined macros: There are 4 "run-time" macros. These are: $@ - stands for the full target name $? - stands for the list of prerequisites that are newer than the target. $* - stands for the root of the target name. This is the part after any path separators and before any extension. $< - stands for the complete name of the file that satisfied the default rule. $< is only valid within default rules. $@, $? and $* can be used at any time. $(OBJS) : $*.c Macros $< and $@ can be modified with a `D' or an `F'. `D' specifies the directory part, and `F' the file part. So if $< evaluates to ..\make.c, ${<D} is ".." and ${<F} is "make.c". In conjunction with `D' and `F', $@ tells you everything about the target being made (its full name, the directory it's in, and its name), and $< tells you everything about the file being used to make the target. The macro `MFLAGS' gets filled in with the initial command line options supplied to MAKE. This can be used to invoke MAKE on makefiles in subdirectories and pass along the options. The macro `CWD' gets filled in with the current working directory. The macro `$$' evaluates to the dollar sign, $. Macro `MAKE_TMP' has special meaning. MAKE_TMP is the name of the directory MAKE will use for temporary files (response files, batch files, and error files). If you wish, you can define MAKE_TMP in terms of other macros or environment variables. eg: MAKE_TMP = $(TMP) A RAMdisk would be the best place for MAKE_TMP. If you're running DOS 2.x, MAKE_TMP can't have any backslashes (path separators) in it. This is because COMMAND.COM is incapable of executing batch files (or for that matter, any executable files) if the filename contains path separators. DOS 3.x doesn't have this problem and there is no restriction on MAKE_TMP. NDMAKE v4.3 page 7 3) Default rules ---------------- MAKE can use default rules to specify commands for files for which the makefile gives no explicit commands. A default rule tells MAKE how to create a file with a particular extension from a file with the same root name but another extension. Default rules take the form: .from_extension.to_extension : command [command] ... For example, to produce a `.obj' file from a `.c' file, the default rule could be: .c.obj : msc ${CFLAGS} $<; When MAKE finds a target with no commands, it looks for the first possible name for which both a rule and a file exist. There may be several ways to produce a `.obj' file (eg from a compiler or from MASM), and the order in which rules are attempted is specified by the `.SUFFIXES' list. This is a special target with a list of extensions. For example: .SUFFIXES: .exe .obj .c .asm .for If MAKE was trying to make a TEST.OBJ file using a default rule, it would first look for a `.c.obj' rule (since `.c' follows `.obj' in the .SUFFIXES list). If found it would check for the file TEST.C. If the file didn't exist, MAKE would look for a `.asm.obj' rule (and TEST.ASM file), and finally a `.for.obj' rule (and TEST.FOR file). Assuming MAKE.INI contained the .c.obj rule and .SUFFIXES as defined above, our previous example could be written more succinctly as: OBJS = main.obj sub.obj test.exe : $(OBJS) link $(OBJS), test; $(OBJS) : incl.h Because of the default rules, MAIN.OBJ and SUB.OBJ implicitly depend on files MAIN.C and SUB.C, respectively, as well as explicitly depending on INCL.H. NDMAKE v4.3 page 8 4) "dot targets" ---------------- Besides the special target `.SUFFIXES' mentioned above, there are a few other special targets that can be put in MAKE description files. .IGNORE - Commands returning nonzero status (ie. the errorlevel) cause MAKE to terminate unless the special target `.IGNORE' is in makefile or the command begins with `-' (hyphen). The `-i' option gives the same effect. .NOIG - Normally, MAKE ignores the case of file names and macros. This target tells MAKE to consider case important. .PRECIOUS - Break (control-C) and command errors cause the target being worked on to be deleted if it's been changed unless it's a prerequisite of the target `.PRECIOUS'. For example: .PRECIOUS: nerase.exe .SILENT - Commands to be executed are printed when executed unless the special entry `.SILENT' is in makefile, or the first character of the command is `@'. Equivalent to the `-s' option. For example: all.exe : 1.obj 2.obj 3.obj - link 1 2 3, tmp.exe; # ignore any errors @ erase tmp.exe # don't echo this line .SUFFIXES - As mentioned above, this gives the order in which to try default rules. Suffixes accumulate, so if we have the same .SUFFIXES as listed above in make.ini, and the makefile had: .SUFFIXES : .obj .pas the combined suffix list would look like: .obj .pas .exe .obj .c .asm .for. A .SUFFIXES target with no suffixes clears the list of suffixes. A common source of errors when using default rules is getting the order of .SUFFIXES wrong. The default rule looks like .from.to but the .SUFFIXES entry looks like .to ... .from. Note the reversal in order! Command prefixes -, @, !, >, >> ------------------------------- Commands may be prefixed with special characters. `@' before a command means not to print the command before executing it, `-' means ignore the exit status (a number testable by "if errorlevel ...") that is returned from the command. Normally MAKE stops when a command returns a non-zero error code. `!' indicates the command will be executed in a loop. `>' and `>>' allow lines to be copied to a file. NDMAKE v4.3 page 9 The loop prefix `!' ------------------- MAKE performs a loop over a command if the command is prefixed with `!'. The command is executed once for each element of the macro $?, and during execution the macro $? is set to that element. Example: x: 1 2 3 ! echo $? If 2 and 3 are more recent than x, then $? will initially have the value "2 3". The "echo $?" command will be executed twice, once with $? equal to 2 and once with $? equal to 3. The commands would be: echo 2 echo 3 Output to files `>' and `>>' ---------------------------- MAKE can write to files or devices by: >filename line1, line2, line3 # or >>filename line1, ... Commas demark the lines of the file. For `>', the file is opened as a new file (old contents are destroyed), for `>>' the file is opened in append mode. For comma *not* to mean "make a new line", quote it with a backslash (ie. \, will be a comma, not a new line). "filename" can also be the name of a device. >con will cause output to go to the console. >prn will cause the lines to show up on your printer. There is a bug in DOS 2.x which often won't allow the console to be opened for output. To compensate, MAKE understands "stdout" and "stderr". Stdout and stderr both go to the screen, but DOS can redirect stdout whereas stderr cannot be redirected. The prefixes are used like this: @ echo Testing 1, 2, 3 # command isn't printed -! echo Hi there # ignore status and loop @-!>> filename looping... # silent, ignore, loop, and output `>' and`>>' must appear as the right-most prefixes (just before the filename). This is to allow macros to be used to change where output will go -- macro expansion happens after checking for `-', `@' and `!'. You can do something like: -$(out) Compiling ... where "out" can be defined as ">stdout" for output to screen, ">prn" for output to printer, or "echo" for echoing through COMMAND.COM. NDMAKE v4.3 page 10 VPATH ----- The VPATH macro specifies the directory names NDMAKE will use to try to find files that don't have a path specification. Where is this useful? One example is when you have a set of sources that are conditionally compiled for different target machines or for different memory modules. You want to keep only 1 set of sources, but want to compile them a variety of ways. What you'd usually do is create subdirectories for each different target machine and put a makefile in each subdirectory with VPATH referring to the parent directory (.. in MSDOS). Then when NDMAKE looked for the sources, it would look in the parent directory. If VPATH isn't defined, only the current directory is searched for files. A sample VPATH is: VPATH = .;.. This means ".", the current directory, is the first to be searched and "..", the parent directory, is to be searched next. A semi-colon separates directory names. In UNIX make, a colon is used, but for compatability with DOS PATH, in NDMAKE a semicolon is used. When NDMAKE tries to find a file like "test.obj", it will look first for ".\test.obj", then "..\test.obj". The first file found is used. When NDMAKE is trying to find an implicit dependency, it constructs a particular file (eg "test.c"), then tries each directory in order to find the file. As an example, assume VPATH is as above, "test.c" is in the parent directory and your default rule for .c.obj is: .c.obj:; cl -c $< When you type "make" from this directory, you would get: cl -c ..\test.c So far so good. It turns out that Microsoft C is good about putting the directory part of the file it's compiling on the include path. If that were not the case, and test.c included any "local" files (eg "header.h"), then the compile might fail because header.h is not in the current directory -- it's in the parent directory with the sources. For other compilers, you may want to use the new macro "<D" which selects the directory component of <. Your default rule could be written as: .c.obj:; cl -c $< -I$(<D) and the compilation would be: cl -c ..\test.c -I.. # -I adds .. to the include path There are a few other new macros: "<F", the file name component of <; @D and @F, the directory and file components of @. If VPATH is NDMAKE v4.3 page 11 not specified, <D will be "." and @D will be the directory component of @ ("." if there is no directory component). Also, <F will be the same as < and @F will be the file component of @. Still with me? It gets worse! VPATH has to be a little trickier than this. What if you have many machine-INdependent files, and only a few machine-DEpendent files? You would like to keep the DEpendent .obj files in the subdirectories and all sources and INdependent .obj files in the parent directory. Now your makefile in each subdirectory looks something like: VPATH = .;.. OBJS = dep.obj main.obj indep.obj DEFS = -DIBMMONO CFLAGS = $(DEFS) -AL ibmmono.exe: $(OBJS) link $(OBJS), $@; Main.obj and indep.obj are found in ".."; dep.obj is found here in "."; all source files are found in ".." The compilation goes smoothly, but when it comes time for the link, $(OBJS) expands to: dep.obj main.obj indep.obj which fails since several of the .objs are in "..". What we want is: dep.obj ..\main.obj ..\indep.obj Therefore, NDMAKE *translates* each command to include the actual path to the file!! This could lead to confusion, but I think you'll agree it's a powerful necessity. To prevent wierdness, macros @, @D, @F, <, <D, <F, and * are never translated. Otherwise some of them wouldn't be much use. So now the link proceeds with: link dep.obj ..\main.obj ..\indep.obj, ibmmono.exe; Punctuation may prevent NDMAKE from translating a name. If a name should be translated but it isn't, try separating the name from any punctuation with whitespace. For example, when using overlays with Microsoft Link the object modules go in parenthesis -- NDMAKE won't translate a name like (main.obj) but does fine on ( main.obj ). | The demo version of NDMAKE, MAKE43D.EXE, only accepts 1 directory | name for use in VPATH. This is to allow you to see what it can do but | encourage you to register. NDMAKE v4.3 page 12 Options ------- Options (also known as flags) are entered on the command line with a `-' or `/'. Options can be grouped together after a single `-', so -dp is equivalent to -d -p. -d Debug mode. Traces MAKE as it executes, printing the time difference between each file and the target that has it as a prerequisite. Also, automatically generated batch and response files will not be deleted. -h Prints a help screen. -i Ignore errors. Equivalent to the special entry .IGNORE. Causes a nonzero exit status to be ignored. Doing `make -i > errs' collects all error messages into 1 file. Interrupting `make -i' may require several control-Cs. -k Keep going. When a command returns nonzero status, abandon work on the current target, but continue on branches that do not depend on the current target. -n No execute. Display but do not execute the commands needed to update the targets. -p Print information on macros, dependencies, and *available* default rules. A rule is available if it is defined in a .from.to target and there are .to and .from extensions in .SUFFIXES in the correct order (.to to the left of .from). -q Query. Sets MAKE's exit status to 1 if there are things to be made and 0 if there aren't. -r Remove default rules. Actually clears .SUFFIXES after MAKE.INI has been read. The effect of this is to prevent MAKE from using default rules other than those in makefile. -s Silent mode. Equivalent to the special entry .SILENT. Commands are not displayed before being executed. -t Touch, i.e. set the file time of the out of date targets to the current time without executing any commands. This will create target files of length zero if they do not exist. MAKE `touches' files just like the included TOUCH.EXE program. The small tutorial included later in this documentation shows how to use this flag. -u Unconditional make. All specified targets are made whether they are out of date or not. NDMAKE v4.3 page 13 DOS commands, batch files, redirection and error codes ------------------------------------------------------ Skip this section if you are running DOS 3.0 or higher. MAKE depends on a program's exit status (a number testable with the "if errorlevel ..." command in DOS) to determine whether or not an error has occurred. An exit status of 0 means no error. In order for MAKE to execute internal DOS commands (like copy, chdir, ...), run batch files, or perform IO redirection (with >, >>, |, or <), MAKE must start a second copy of COMMAND.COM and have that copy execute the command. For DOS versions older than 3.0, COMMAND.COM *always* reports an exit status of zero, implying no error has occurred. MAKE compensates for this by using an error file to communicate the exit status back to MAKE. The error file's name is put into the environment so your batch files can refer to it as %MAKE_ERR%. When MAKE needs to start up another copy of COMMAND.COM it builds a batch file and has COMMAND.COM execute the file. If you interrupt the batch file with CONTROL-BREAK you may get the prompt "Terminate BATCH file ? (y/n)". Answer `y' and MAKE will know an error has occurred. After MAKE gets control back from the batch file, it detects an error by checking for the error file. If the file exists, an error has occurred; if the file is absent, the batch file finished successfully. If you use your own batch files from MAKE they have to be modified slightly to send the exit status back to MAKE. This is because DOS won't return to MAKE's batch file after your's has finished. The following line, placed at the end of your batchfile, is needed: if exist %MAKE_ERR% do erase %MAKE_ERR% To get a little fancier, your batch file could look like: command1 if errorlevel 1 goto end command2 if errorlevel 1 goto end if exist %MAKE_ERR% do erase %MAKE_ERR% :end As you can see, the error file gets erased only if command1 and command2 execute without error. | The demo version of NDMAKE, MAKE43D.EXE, does not have this feature. NDMAKE v4.3 page 14 Response files -- special handling of LINK and LIB -------------------------------------------------- Some programs (notable LINK and LIB) can receive their input from a file called a response file. Usually a response file is used when the length of the command line becomes longer than DOS allows. In program development, the LINK and LIB commands are used very often and MAKE generates a response file automatically when required. 1) LINK response files ---------------------- When a program name has the root name "LINK" and a command line longer than DOS allows, MAKE generates a response file and has LINK use the response file. Your command: link $(OBJS), test.exe,, $(LIBS) will work without modification no matter how long the line becomes. 2) LIB response files --------------------- Similar to a LINK response file, but slightly more complex to compensate for LIB's syntax. MAKE takes the LIB command: lib libname [/pagesize] operations ... [, listing] [, newlib] and generates a response file with the most recent operation placed between each object module. For example: lib my.lib -+ main.obj sub1.obj sub2.obj + sub3.obj ; becomes: lib @responsefile where the response file has the contents: my.lib -+ main.obj -+ sub1.obj -+ sub2.obj + sub3.obj ; This is most useful when you want to update a library when some of its modules have been recompiled. For example, if "my.lib" depends on modules LIBOBJS then the following updates the library with only those modules which have been changed since the library was last written: my.lib: $(LIBOBJS) lib my.lib -+ $? ; # $? expands to the prerequisites more recent # than the target When a library doesn't exist yet, MAKE will tell LIB to create it. Note that the `>' prefix can be used to write response files for commands other than LIB and LINK. NDMAKE v4.3 page 15 UNIX features ------------- As with UNIX `make', dependency lines and default rules can have a command on the same line as the `colon' line, provided the command follows a semicolon: .c.obj:; msc $<; test.exe: $(OBJS); link $(OBJS) , test; @echo done # are equivalent to .c.obj: msc $<; test.exe: $(OBJS) link $(OBJS) , test; @echo done If a name appears on a line with a double colon, `::', then the command sequence following that line is performed only if the name is out of date with respect to the names to the right of the double colon, and is not affected by other double colon lines on which that name may appear. Consider the following makefile: 1:: 2; echo 2 1:: 3; echo 3 If 2 and 3 are more recent than 1, then "make -n 1" will result in: echo 2 echo 3 If 1 is more recent than 3, but 2 is newer than 1 the response is: echo 2 If 1 is more recent than both 2 and 3, the response will be: Make: `1' is up to date. MAKE supports multiple commands on a single line if the command is enclosed in parentheses () and the commands are separated by semi- colons (use \; if you need a semi-colon to *not* be interpreted as a command separator). In fact, since each command line is executed in its own shell, this is the only way to use DOS commands like "set" and "chdir" so that they have any effect. For example, doing "make x" where the makefile looks like: x: chdir \tmp copy *.* a: will copy the contents of the *current* directory, not \tmp, to drive A. This is because MAKE starts each command in the current directory. The correct way to write this is: x: (chdir \tmp; copy *.* a:) NDMAKE v4.3 page 16 A batch file is always used to execute commands surrounded by (), even if there's only one command. Thus, you can force MAKE to use COMMAND.COM for any command by putting the command in parentheses. One very interesting use of the () syntax is to create macros that expand to multiple-line commands! Additional notes and technical information ------------------------------------------ Lines in a MAKE description file that are too long to fit on one line can be extended to the next line by putting backslash, `\', followed be <RETURN> as the last two characters of the line. If you need a `\' as the last character, put a space or comment character somewhere after it on that line. The longest single line MAKE can handle is 512 bytes, but by using `\' to break up the line into shorter pieces, there is no limit to line length (except available memory). By default, case is unimportant, so `test.obj' and `TEST.OBJ' are the same. If .NOIG is present these will no longer by the same. Everything on a line after the comment character, `#', is ignored. The character separating targets and dependents, `:', is also the character used for the drive separator in MSDOS. To distinguish this colon from the drive separator, it must be followed by space or tab (eg: ), semicolon (eg:;), colon (eg::), or nothing (eg:<return>). If you consistently use at least one space you will have no problem. If you type in a makefile from the keyboard (by using the command `make -f -'), put a ^Z (control-Z) followed by a <RETURN> as the last two characters. This tells MAKE to stop reading from the keyboard. Targets defined in makefile take precedence over targets of the same name defined in MAKE.INI. Targets defined in MAKE.INI can never be default targets. "dot targets" can never be default targets. MAKE is stupid -- after the commands to update a target have been executed without error, MAKE assumes the target is up to date. If you give commands that don't really update a target, MAKE doesn't know. When MAKE executes commands, such as `link', it checks if it's a DOS internal command, if it's a batch file, or if it involves IO redirection. If so, MAKE loads a second copy of COMMAND.COM and passes it the command line. Otherwise, MAKE tries to execute the command as a program (a .exe or .com file). This is done to prevent loading COMMAND.COM unless absolutely necessary. Also, MAKE uses environment variable "COMSPEC" to find COMMAND.COM so you can copy COMMAND.COM to your RAMdisk and set COMSPEC to point to that copy. NDMAKE v4.3 page 17 Sample session - what MAKE does when it's running ------------------------------------------------- Assume you have the following MAKE.INI file and MAKEFILE. make.ini -------- .SUFFIXES : .exe .obj .c .for .asm M = S CFLAGS = -A$M .c.obj:; cl ${CFLAGS} -c $< .obj.exe:; link $<, $@; .c.exe: cl ${CFLAGS} -c $< link $*.obj, $@; erase $*.obj makefile -------- OBJS = main.obj sub.obj test.exe: $(OBJS) link $(OBJS), $@,, \lib\local; $(OBJS): incl.h sub.obj: sub.c cl $(CFLAGS) -Od -c sub.c install: test.exe copy test.exe $(BIN) # BIN comes from the environment ---------- Assume the following files are in your directory: MAIN.C, SUB.C, INCL.H. When you type: A> make MAKE first reads MAKE.INI then MAKEFILE. It sees the first target TEST.EXE and tries to make it. But first, MAKE must know if the files that TEST.EXE depends on are up to date. As TEST.EXE depends on several `.obj' files, and these `.obj' files also have dependents, the detailed procedure MAKE undergoes looks like this: NDMAKE v4.3 page 18 -Make TEST.EXE - there are explicit commands for making TEST.EXE so don't bother looking for implicit prerequisites. - TEST.EXE depends on MAIN.OBJ and SUB.OBJ. Make these. - Make MAIN.OBJ - Since there are no explicit commands for MAIN.OBJ, check for implicit prerequisites based on default rules. - Find rule `.c.obj' and file `main.c'. - Add MAIN.C to the prerequisites of MAIN.OBJ. - MAIN.OBJ depends on INCL.H and MAIN.C. Make these. - Make INCL.H - Since there are no explicit commands for making INCL.H, check for implicit prerequisites. - Since there is no `.h' suffix in .SUFFIXES, there are no implicit prerequisites. - There are no prerequisites, so INCL.H is up to date. - Make MAIN.C - Since there are no explicit commands for making MAIN.C, check for implicit prerequisites. - Since there are no `.from_extension.c' rules, there are no implicit prerequisites. - There are no prerequisites, so MAIN.C is up to date. - Compare MAIN.OBJ with INCL.H and MAIN.C. Since MAIN.OBJ doesn't exist, it is out of date with respect to its prerequisites, so execute the (default) command: cl -AS -c main.c - MAIN.OBJ is up to date. - Make SUB.OBJ - There are explicit commands for making SUB.OBJ so don't bother looking for implicit prerequisites. - SUB.OBJ depends on INCL.H and SUB.C. Make these. - Make INCL.H - MAKE already knows that INCL.H is up to date. - Make SUB.C - Since there are no explicit commands to make SUB.C, check for implicit prerequisites. - Since there are no `.from_extension.c' rules, there are no implicit prerequisites. - There are no prerequisites, so SUB.C is up to date. - Compare SUB.OBJ with INCL.H and SUB.C. Since SUB.OBJ doesn't exist, it is out of date with respect to its prerequisites, so execute the (explicit) command: cl -AS -Od -c sub.c - SUB.OBJ is up to date. - Compare TEST.EXE with MAIN.OBJ and SUB.OBJ. Since TEST.EXE doesn't exist, execute the command: link main.obj sub.obj, test.exe,,\lib\local; - TEST.EXE is up to date. NDMAKE v4.3 page 19 Assuming no errors occurred, when you now type `make' you will get the message that TEST.EXE is up to date. If you edit SUB.C and change it, when you next type `make', MAKE will see that SUB.C is more recent than SUB.OBJ and recompile SUB.C. MAKE will then see that SUB.OBJ is more recent than TEST.EXE and relink the files. If you type `make install', MAKE will ensure TEST.EXE is up to date, then copy it to your BIN directory. BIN was assumed to be defined in your environment. Use of flags -t, -i, -n, -d, and -p ----------------------------------- Now assume you edit INCL.H and make changes that only affect SUB.C (for example, you change the value of a #define but you don't have to edit SUB.C). If you were now to type `make', MAKE would compile both SUB.C and MAIN.C. To have MAKE only recompile SUB.C you do three things. First, `make -t' to touch (update) all files. You will see that MAKE touches MAIN.OBJ and SUB.OBJ, then TEST.EXE. Now, `touch sub.c'. This results in SUB.C being newer than SUB.OBJ. Finally, `make' again. Now MAKE will compile only SUB.OBJ, then link the files. The process of editing a common include file to change something that only affects one file occurs often enough that the `make -t' + `touch' + `make' procedure can save a lot of time. If you are changing an include file and also changing some of the `.c' files, then usually you edit the include file, do `make -t', edit the `.c' files, then do `make'. The `i' flag is useful for collecting all errors into a single file without stopping MAKE. This is helpful when you're porting software and expect a lot of errors or when you make global changes that may produce a lot of errors (for example, changing a structure definition in an include file or changing from small to large code models). The `n' flag is used when you just want to see what MAKE will be doing. This is useful if you've changed several modules, but forget which ones. `make -n' shows which ones will be compiled. `d' and `p' are usually used in debugging. If your MAKE doesn't seem to be doing what you think it should, use `d' to watch it compare each file with its prerequisites. The time listed is relative to the target. A time that begins with - means the prerequisite is older than the target; + means the prerequisite is newer. Usually `d' is used in conjunction with `n' and sometimes with `p'. `p' prints the values of MAKE's macros, targets, and default rules. The `p' flag causes MAKE to list only those rules that are reachable. If a rule you defined isn't listed and you think it should be, chances are you forgot to update .SUFFIXES. NDMAKE v4.3 page 20 Using MAKE without a makefile ----------------------------- MAKE can be used in a limited fashion without having a makefile because it always reads MAKE.INI. Assume you have a file called XYZZY.C and using the same MAKE.INI file described above, you type: A> make xyzzy.exe MAKE uses its default rule `.exe.c' to compile XYZZY.C ($<), link XYZZY.OBJ ($*.obj) to form XYZZY.EXE ($@), then erases XYZZY.OBJ. If several `.exe' files exist in a directory and you have just finished editing some of their `.c' files, you could type: A> make *.exe and update only the `.exe' files that are out of date. By adding more default rules to MAKE.INI, MAKE could invoke the FORTRAN compiler for `.for' files or MASM for `.asm' files. In this way, MAKE can do the right thing for each type of file. NDMAKE v4.3 page 21 Changes since version 3.0 ------------------------- - The addition of LIB response files and of VPATH. - MAKE's ability to get back error codes for DOS internal commands and batch files. - Multiple commands on a single line. This allows macros which expand into multiple line commands and also because: - Make always starts each separate command in the current directory with a separate shell. This means "chdir" and "set" have to be used inside of multiple commands for them to have *any* effect. - Touch (the -t flag) was made to act exactly like the UNIX version. Previously it did not create a file if it did not exist. - Space can be used instead of tab before command lines. This is compensation for some editors which do not do tabs. - MAKE_TMP was added for fast batch execution. - The prefix `+' (to tell MAKE to start up COMMAND.COM) was removed. For the same purposes, use parenthesis instead. Since MAKE keeps an internal table of DOS commands the use of `+' for speed is no longer necessary. - Addition of -q (query flag). - Addition of D and F modifiers for macros @, and <. Changes since version 4.0 ------------------------- - Addition of: `>' and `!' prefixes for output to files and looping. -u flag for unconditional make. .NOIG to make macros and filenames case sensitive. - Bugfixes: VPATH was finding nonexisting files. Invalid complaining by VPATH for directories on another disk. / was used in filenames on calls to LINK when switchar was -. (LINK has / hardcoded for switches). Incorrect parsing of LIB commands caused MAKE to write garbage for the list file. No MAKE_TMP causing problems with batch files under DOS 2.0 - Others: No batch file is used if ignoring errors when execking COMSPEC. Use findfirst rather than open to check for files and get their times. This is much faster on networks. NDMAKE v4.3 page 22 Future directions for NDMAKE ---------------------------- With the addition of VPATH, NDMAKE has taken a great step forward from other PC version of MAKE. No doubt there will be bugs in the current implementation. I anticipate adding much faster directory lookup when VPATH is in effect. I may add a true batch mode (as opposed to "make -n" which doesn't generate response files). As well, an automatic dependency generator is in the works. System V UNIX just got an updated version of make and I will be bringing the most useful features to NDMAKE. I'm currently testing a method to reduce the amount of memory NDMAKE uses from 42000 to about 2000(!) bytes. This will be useful for recursive makes and where memory is short. I'm still considering adding archive support (especially ARC), but haven't decided how to do it quite yet. As always, I will entertain any suggestions from registered users. NDMAKE v4.3 page 23 USER-SUPPORTED SOFTWARE NOTIFICATION ------------------------------------ If you like and use this program, I ask you to consider registering it. The benefits of registration include the first update free. Registered owners will get a response to any questions they may have. Also, if you're registered I will consider any suggestions you may have. I want NDMAKE to be the best MSDOS make available. The registration fee is $35. To date, about 50 people have registered, so please consider registering your copy. Commercial use of this program requires registration. If you use NDMAKE in your work, you are required to register it. Many thanks to those of you who have registered. Regardless of whether you register or not, you may freely copy and distribute this program for noncommercial purposes. The programs, MAKE.EXE and TOUCH.EXE, the documentation, MAKE.DOC and TOUCH.DOC, and the initialization file, MAKE.INI, must all be distributed together. If you post this program to a public bulletin board, please put all the files in an ARChive called NDMAKE43.ARC. I hope you enjoy NDMAKE and find it a useful addition to your programming tools. If you have any questions you can reach me at: US MAIL: D. G. Kneller 1468 8th Ave San Francisco, CA 94122 PHONE: (415) 476-8291 (days) 731-3108 (home) UUCP: ...ucbvax!ucsfcgl!kneller ARPANET: kneller@cgl.ucsf.edu BITNET: kneller@ucsfcgl.BITNET ---------- UNIX is a registered trademark of Bell Laboratories. MSDOS is a registered trademark of Microsoft Corp. NDMAKE v4.3 page 24 --------------------------------------------------------------------- Registration form for NDMAKE v4.3 Name: _________________________________________________ Address: _________________________________________________ City, State, Zip: _________________________________________________ Country: _________________________________________________ OPTIONAL: System description (computer, memory, DOS version) _____________________________________________________________________ _____________________________________________________________________ COMMENTS: Please feel free to add your thoughts or suggestions! _____________________________________________________________________ _____________________________________________________________________ _____________________________________________________________________ _____________________________________________________________________ Mail to: D. G. Kneller 1468 8th Ave San Francisco, CA 94122 U.S.A