gccmakedep

gccmakedep(1)							gccmakedep(1)



NAME
       gccmakedep - create dependencies in makefiles using ’gcc -M’

SYNOPSIS
       gccmakedep  [  -sseparator  ]  [ -fmakefile ] [ -a ] [ -- options -- ]
       sourcefile ...

DESCRIPTION
       The gccmakedep  program	calls  ’gcc  -M’  to  output  makefile	rules
       describing  the dependencies of each sourcefile, so that make(1) knows
       which object files must be recompiled when a dependency has changed.

       By default, gccmakedep 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,  gccmakedep 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:
		   gccmakedep -- $(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 gcc(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.

       -fmakefile
	      Filename.	  This allows you to specify an alternate makefile in
	      which gccmakedep 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 gccmakedep to look for in the makefile.
	      The default is “# DO NOT DELETE”.

       -- options --
	      If gccmakedep 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, gccmakedep 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
       gcc(1), make(1), makedepend(1).

AUTHOR
       The  version  of	 the  gccmakedep  included  in	this X.Org Foundation
       release was originally written by the XFree86 Project  based  on	 code
       supplied by Hongjiu Lu.

       Colin  Watson  wrote  this  manual  page,  originally  for  the Debian
       Project, based partly on the manual page for makedepend(1).



X.Org				Version 6.8.2			gccmakedep(1)