NAME
ccmakedep - create dependencies in makefiles using a C compiler
SYNOPSIS
ccmakedep [ cpp-flags ] [ -wwidth ] [ -smagic-string ] [ -fmakefile ] [
-oobject-suffix ] [ -v ] [ -a ] [ -cccompiler ] [ -- options -- ]
sourcefile ...
DESCRIPTION
The ccmakedep program calls a C compiler to preprocess each sourcefile,
and uses the output to construct makefile rules describing their
dependencies. These rules instruct make(1) on which object files must
be recompiled when a dependency has changed.
By default, ccmakedep places its output in the file named makefile if
it exists, otherwise Makefile. An alternate makefile may be specified
with the -f option. It first searches the makefile for a line
beginning with
# DO NOT DELETE
or one provided with the -s option, as a delimiter for the dependency
output. If it finds it, it will delete everything following this up to
the end of the makefile and put the output after this line. If it
doesn’t find it, the program will append the string to the makefile and
place the output after that.
EXAMPLE
Normally, ccmakedep will be used in a makefile target so that typing
’make depend’ will bring the dependencies up to date for the makefile.
For example,
SRCS = file1.c file2.c ...
CFLAGS = -O -DHACK -I../foobar -xyz
depend:
ccmakedep -- $(CFLAGS) -- $(SRCS)
OPTIONS
The program will ignore any option that it does not understand, so you
may use the same arguments that you would for cc(1), including -D and
-U options to define and undefine symbols and -I to set the include
path.
-a Append the dependencies to the file instead of replacing
existing dependencies.
-cccompiler
Use this compiler to generate dependencies.
-fmakefile
Filename. This allows you to specify an alternate makefile in
which ccmakedep can place its output. Specifying “-” as the
file name (that is, -f-) sends the output to standard output
instead of modifying an existing file.
-sstring
Starting string delimiter. This option permits you to specify a
different string for ccmakedep to look for in the makefile. The
default is “# DO NOT DELETE”.
-v Be verbose: display the C compiler command before running it.
-- options --
If ccmakedep encounters a double hyphen (--) in the argument
list, then any unrecognized arguments following it will be
silently ignored. A second double hyphen terminates this
special treatment. In this way, ccmakedep can be made to safely
ignore esoteric compiler arguments that might normally be found
in a CFLAGS make macro (see the EXAMPLE section above). -D, -I,
and -U options appearing between the pair of double hyphens are
still processed normally.
SEE ALSO
cc(1), make(1), makedepend(1), ccmakedep(1).
AUTHOR
ccmakedep was written by the X Consortium.
Colin Watson wrote this manual page, originally for the Debian Project,
based partly on the manual page for makedepend(1).