DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

ccmakedep(1)





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 depen-
       dencies.   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  begin-
       ning 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  exist-
              ing 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  spe-
              cial  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).

X Version 11                      imake 1.0.2                     ccmakedep(1)

Man(1) output converted with man2html