194 lines
6.9 KiB
Text
194 lines
6.9 KiB
Text
DMAKE Version 4.1
|
|
=================
|
|
FINAL FREE RELEASE OF DMAKE, REPLACES VERSION 4.0
|
|
|
|
Nature: This distribution advances dmake to Version 4.1, patch level 0.
|
|
------- This release adds significant functionality and eliminates
|
|
bugs that were introduced with release 4.0.
|
|
|
|
|
|
DETAILS OF ENHANCEMENTS/TWEAKS:
|
|
===============================
|
|
|
|
BUG FIXES:
|
|
----------
|
|
|
|
1. General clean up all over to fix small incompatibilities and obvious
|
|
typos.
|
|
|
|
2. Fixed bug in getinp.c where buffer was being erroneously overwritten,
|
|
this caused the invalidation of the return address on the stack on
|
|
DOS systems.
|
|
|
|
3. Fixed a bug that caused the "<target> is up to date" message to be
|
|
suppressed.
|
|
|
|
4. Fixed a bug involving the value of $@ in conjunction with dynamic
|
|
prerequisites.
|
|
|
|
5. Relegated the warning associated with duplicate entries in prerequisite
|
|
lists to a non-essential warning. Added an option flag -Vw to display
|
|
it if you wish to check your makefile for duplicate entries. Either way
|
|
the parser ignores duplicates.
|
|
|
|
6. Better default action on checking out RCS targets. If an RCS target has
|
|
no directory prefix of its own it is checked out into the directory
|
|
which contains the RCS subdirectory, otherwise it ends up in its directory
|
|
qualified location.
|
|
|
|
7. Improved the speed of lookups in the directory cache; handle mixed case
|
|
file name entries on OS/2 and Win95/NT.
|
|
|
|
8. Improved prerequisite list generation for long prerequisite lists.
|
|
|
|
9. Rearanged startup macro files to form an architectural hierarchy.
|
|
This greatly simplifies the maintenance of the startup files. They
|
|
might even be right at some point in the future. Please let me know if
|
|
you encounter difficulties, as I don't have access to all possible
|
|
platforms, this sub-hierarchy is bound to have ommisions at this release
|
|
and hence is intended to be evolutionary over time.
|
|
|
|
10. A build that only touches targets (-t) uses the same algorithm to decide
|
|
valid names as a normal build.
|
|
|
|
11. Conditional macro assignments fixed, and now work for builtin macro
|
|
variables as well.
|
|
|
|
|
|
NEW FEATURES:
|
|
-------------
|
|
|
|
0. Complete reorganization of Dmake STARTUP scripts. Please refer to the
|
|
installation notes for details. THIS ONE IS IMPORTANT!!!
|
|
|
|
1. Support for long archive member names if Elf is available, plus better
|
|
support for archivers that truncate member names (see comments in
|
|
unix/arlib.c for details).
|
|
|
|
2. Added variable MAKEVERSION which contains a string indicating the current
|
|
version of dmake.
|
|
|
|
3. Added the .EXECUTE attribute, see man page for details.
|
|
|
|
4. Added the .ERRREMOVE attribute, see man page for details.
|
|
|
|
5. Added support for gmake style if/else/endif, but only if not part of
|
|
a Group recipe.
|
|
|
|
6. Added initial build target for Coherent version 4.2 UNIX
|
|
and for Windows-NT/Windows-95 32-bit app using Borland C++ 4.0,4.5, 5.0,
|
|
and Microsoft Visual C++ 4.0.
|
|
|
|
7. MSDOS version now supports two builtin runtime commands, noop, and echo.
|
|
|
|
8. Added new macro $(uniq list) which returns a sorted version of the
|
|
white space separated tokens in list such that there are no repetitions.
|
|
|
|
9. Added the function macro $(echo list) which simply returns list.
|
|
This is most useful in conjunction with the new $(foreach ...)
|
|
function macro.
|
|
|
|
10. Added gmake style function macro
|
|
|
|
$(foreach,var,list data)
|
|
|
|
where var and list are expanded, and the result is the concatenation of
|
|
expanding data with var being set to each white space separated token in
|
|
list in turn. For example:
|
|
|
|
list = a b c
|
|
all :
|
|
echo [$(foreach,i,$(list) [$i])]
|
|
|
|
will output
|
|
|
|
[[a] [b] [c]]
|
|
|
|
The iterator variable is defined as a local variable to this foreach
|
|
instance. The following expression illustrates this:
|
|
|
|
$(foreach,i,$(foreach,i,$(sort c a b) root/$i) [$i/f.h])
|
|
|
|
when evaluated the result is:
|
|
|
|
[root/a/f.h] [root/b/f.h] [root/c/f.h]
|
|
|
|
The specification of list must be a valid macro expression, such as:
|
|
|
|
$($(assign list=a b c))
|
|
$(sort d a b c)
|
|
$(echo a b c)
|
|
|
|
and cannot just be the list itself. That is, the following foreach
|
|
expression:
|
|
|
|
$(foreach,i,a b c [$i])
|
|
|
|
yields:
|
|
|
|
"b c [a]"
|
|
|
|
when evaluated.
|
|
|
|
11. Added the macro $(and list).
|
|
|
|
12. Added the macro $(or list).
|
|
|
|
13. Added the macro $(not term).
|
|
|
|
14. Added the .NOINFER attribute to the .INCLUDE directive. When specified
|
|
any prerequisite of the .INCLUDE directive which cannot be found in
|
|
the .INCLUDEDIRS search list is not automatically made.
|
|
|
|
15. Improved the handling of internal macros for proper functioning of the *=
|
|
and *:= assignment constructs. Macros that are internally initially
|
|
defined are considered to be undefined for the purpose of *= and *:=
|
|
assignment until they are the target of an explicit assignment operation.
|
|
|
|
16. Improved the caching of file names, and their matching on case insensitive
|
|
file systems. Two control macros help to manage the functionality:
|
|
|
|
.DIRCACHE := yes
|
|
|
|
Implies that the directory cache will be used. This is on by default for
|
|
systems that support the reading of directories. Setting the value of this
|
|
macro to 'no' is equivalent to supplying the '-d' command line switch.
|
|
|
|
.DIRCACHERESPCASE := yes
|
|
|
|
Causes dmake to respect the case of the directory entries when the cache
|
|
is enabled, thereby treating directory entries in a case sensitive manner.
|
|
Setting this to 'no' disables the matching of case. This macro has effect
|
|
only if .DIRCACHE := yes. Otherwise the facilities provided by the native
|
|
OS are used to match file names using 'stat'.
|
|
|
|
17. Added parameterized user defined function macros. Yes it's true
|
|
you may now define your own parametized function macros. Here is
|
|
how it works. Any macro that is not a predefined function macro and
|
|
is invoked with parameters is looked up as a user defined function
|
|
macro. A new macro scope is created. The n'th argument to the
|
|
macro is then assigned to the value of the the macro $n where n is 0
|
|
for the first argument, 1 for the second argument and so on. The
|
|
argument is expanded before it is assigned. The original macro is
|
|
then expanded. For example:
|
|
|
|
FOO = a $0 b $1 c $2 d
|
|
echo :; $(FOO x y z)
|
|
|
|
Will produce the result string "a z b y c z d". The
|
|
expansion of $(FOO) on it's own behaves as expected and returns the
|
|
string "a b c d" (assuming that each of $0, $1, $2
|
|
are undefined). The only restriction when specifying function
|
|
macro arguments is as before: they cannot contain spaces
|
|
themselves.
|
|
|
|
|
|
ACKNOWLEDGEMENTS:
|
|
=================
|
|
Thanks to all who submitted code for new features, suggestions for
|
|
improvements, and bug fixes. I have tried to make sure no gotchas
|
|
remain, if you encounter problems installing or running dmake please
|
|
let me know. As always, I am always happy to receive e-mail.
|
|
|
|
Many have contributed suggestions and bug fixes that make this
|
|
release possible. The NET thanks you.
|