The following options are useful for debugging makefiles that do not work correctly:
The -#1 option displays each makefile line as it is parsed. Blank and comment lines are removed, and conditional directives are shown in normal, expanded, and evaluated forms.
The -p option displays omake's internal information. With this option, you can examine the following:
The values of all macros, to see where they were defined. Make sure they have the correct values.
All targets, their attributes, and their build scripts, to see where they were defined. This list also shows which target is the default target.
The inference rules, to see the rules known to omake.
The -d option prints a run-time trace of omake. With this option, you can do the following:
Ensure that the correct initialization file and makefile are being read.
Watch omake use configuration lookup to compare the target to each dependency.
Watch omake search for inferred dependencies by using inference rules. Ensure that omake attempts the inference rules you have defined. Cross-check with the -p flag.
For additional help with macros, the .DEBUG : 2 directive (-#2 option) causes omake to print a warning if a macro is used without being defined.
Finally, the .DEBUG : 4 directive (-#4 option) warns about makefile lines that omake does not know how to handle. This can catch misspellings of directives that you may have a hard time detecting. This directive is especially useful if you are trying to use a makefile from some other make utility.
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |