+++ /dev/null
-
-
-
-User Commands MAKEDEPEND(1)
-
-
-
-N\bNA\bAM\bME\bE
- makedepend - create dependencies in makefiles
-
-S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd [ -\b-D\bDn\bna\bam\bme\be=\b=d\bde\bef\bf ] [ -\b-D\bDn\bna\bam\bme\be ] [ -\b-I\bIi\bin\bnc\bcl\blu\bud\bde\bed\bdi\bir\br ] [
- -\b-Y\bYi\bin\bnc\bcl\blu\bud\bde\bed\bdi\bir\br ] [ -\b-a\ba ] [ -\b-f\bfm\bma\bak\bke\bef\bfi\bil\ble\be ] [ -\b-o\boo\bob\bbj\bjs\bsu\buf\bff\bfi\bix\bx ] [ -\b-p\bpo\bob\bb-\b-
- j\bjp\bpr\bre\bef\bfi\bix\bx ] [ -\b-s\bss\bst\btr\bri\bin\bng\bg ] [ -\b-w\bww\bwi\bid\bdt\bth\bh ] [ -\b-v\bv ] [ -\b-m\bm ] [ -- o\bot\bth\bh-\b-
- e\ber\bro\bop\bpt\bti\bio\bon\bns\bs -- ] sourcefile ...
-
-D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
- M\bMa\bak\bke\bed\bde\bep\bpe\ben\bnd\bd reads each _\bs_\bo_\bu_\br_\bc_\be_\bf_\bi_\bl_\be in sequence and parses it
- like a C-preprocessor, processing all _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be_\b, _\b#_\bd_\be_\bf_\bi_\bn_\be_\b,
- _\b#_\bu_\bn_\bd_\be_\bf_\b, _\b#_\bi_\bf_\bd_\be_\bf_\b, _\b#_\bi_\bf_\bn_\bd_\be_\bf_\b, _\b#_\be_\bn_\bd_\bi_\bf_\b, _\b#_\bi_\bf and _\b#_\be_\bl_\bs_\be directives so
- that it can correctly tell which _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be_\b, directives would
- be used in a compilation. Any _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be_\b, directives can ref-
- erence files having other _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be directives, and parsing
- will occur in these files as well.
-
- Every file that a _\bs_\bo_\bu_\br_\bc_\be_\bf_\bi_\bl_\be includes, directly or indi-
- rectly, is what m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd calls a "dependency". These
- dependencies are then written to a _\bm_\ba_\bk_\be_\bf_\bi_\bl_\be in such a way
- that m\bma\bak\bke\be(\b(1\b1)\b) will know which object files must be recompiled
- when a dependency has changed.
-
- By default, m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd places its output in the file named
- _\bm_\ba_\bk_\be_\bf_\bi_\bl_\be if it exists, otherwise _\bM_\ba_\bk_\be_\bf_\bi_\bl_\be_\b. An alternate
- makefile may be specified with the -\b-f\bf option. It first
- searches the makefile for the line
-
- # DO NOT DELETE THIS LINE -- make depend depends on it.
-
- or one provided with the -\b-s\bs option, as a delimiter for the
- dependency output. If it finds it, it will delete every-
- thing following this 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 end of the makefile and place
- the output following that. For each _\bs_\bo_\bu_\br_\bc_\be_\bf_\bi_\bl_\be appearing on
- the command line, m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd puts lines in the makefile of
- the form
-
- sourcefile.o: dfile ...
-
- Where "sourcefile.o" is the name from the command line with
- its suffix replaced with ".o", and "dfile" is a dependency
- discovered in a _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be directive while parsing _\bs_\bo_\bu_\br_\bc_\be_\bf_\bi_\bl_\be
- or one of the files it included.
-
-E\bEX\bXA\bAM\bMP\bPL\bLE\bE
- Normally, m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd 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 ...
-
-
-
-X Version 11 Last change: Release 6 1
-
-
-
-
-
-
-User Commands MAKEDEPEND(1)
-
-
-
- CFLAGS = -O -DHACK -I../foobar -xyz
- depend:
- makedepend -- $(CFLAGS) -- $(SRCS)
-
-O\bOP\bPT\bTI\bIO\bON\bNS\bS
- M\bMa\bak\bke\bed\bde\bep\bpe\ben\bnd\bd will ignore any option that it does not under-
- stand so that you may use the same arguments that you would
- for c\bcc\bc(\b(1\b1)\b).\b.
-
- -\b-D\bDn\bna\bam\bme\be=\b=d\bde\bef\bf o\bor\br -\b-D\bDn\bna\bam\bme\be
- Define. This places a definition for _\bn_\ba_\bm_\be in m\bma\bak\bke\bed\bde\be-\b-
- p\bpe\ben\bnd\bd'\b's\bs symbol table. Without _\b=_\bd_\be_\bf the symbol becomes
- defined as "1".
-
- -\b-I\bIi\bin\bnc\bcl\blu\bud\bde\bed\bdi\bir\br
- Include directory. This option tells m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd to
- prepend _\bi_\bn_\bc_\bl_\bu_\bd_\be_\bd_\bi_\br to its list of directories to search
- when it encounters a _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be directive. By default,
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd only searches the standard include directo-
- ries (usually /usr/include and possibly a compiler-
- dependent directory).
-
- -\b-Y\bYi\bin\bnc\bcl\blu\bud\bde\bed\bdi\bir\br
- Replace all of the standard include directories with
- the single specified include directory; you can omit
- the _\bi_\bn_\bc_\bl_\bu_\bd_\be_\bd_\bi_\br to simply prevent searching the standard
- include directories.
-
- -\b-a\ba Append the dependencies to the end of the file instead
- of replacing them.
-
- -\b-f\bfm\bma\bak\bke\bef\bfi\bil\ble\be
- Filename. This allows you to specify an alternate
- makefile in which m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd can place its output.
-
- -\b-o\boo\bob\bbj\bjs\bsu\buf\bff\bfi\bix\bx
- Object file suffix. Some systems may have object files
- whose suffix is something other than ".o". This option
- allows you to specify another suffix, such as ".b" with
- _\b-_\bo_\b._\bb or ":obj" with _\b-_\bo_\b:_\bo_\bb_\bj and so forth.
-
- -\b-p\bpo\bob\bbj\bjp\bpr\bre\bef\bfi\bix\bx
- Object file prefix. The prefix is prepended to the
- name of the object file. This is usually used to desig-
- nate a different directory for the object file. The
- default is the empty string.
-
- -\b-s\bss\bst\btr\bri\bin\bng\bg
- Starting string delimiter. This option permits you to
- specify a different string for m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd to look for
- in the makefile.
-
-
-
-
-X Version 11 Last change: Release 6 2
-
-
-
-
-
-
-User Commands MAKEDEPEND(1)
-
-
-
- -\b-w\bww\bwi\bid\bdt\bth\bh
- Line width. Normally, m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd will ensure that
- every output line that it writes will be no wider than
- 78 characters for the sake of readability. This option
- enables you to change this width.
-
- -\b-v\bv Verbose operation. This option causes m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd to
- emit the list of files included by each input file on
- standard output.
-
- -\b-m\bm Warn about multiple inclusion. This option causes
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd to produce a warning if any input file
- includes another file more than once. In previous ver-
- sions of m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd this was the default behavior; the
- default has been changed to better match the behavior
- of the C compiler, which does not consider multiple
- inclusion to be an error. This option is provided for
- backward compatibility, and to aid in debugging prob-
- lems related to multiple inclusion.
-
- -\b--\b- o\bop\bpt\bti\bio\bon\bns\bs -\b--\b-
- If m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd encounters a double hyphen (--) in the
- argument list, then any unrecognized argument following
- it will be silently ignored; a second double hyphen
- terminates this special treatment. In this way,
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd can be made to safely ignore esoteric com-
- piler arguments that might normally be found in a
- CFLAGS m\bma\bak\bke\be macro (see the E\bEX\bXA\bAM\bMP\bPL\bLE\bE section above). All
- options that m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd recognizes and appear between
- the pair of double hyphens are processed normally.
-
-A\bAL\bLG\bGO\bOR\bRI\bIT\bTH\bHM\bM
- The approach used in this program enables it to run an order
- of magnitude faster than any other "dependency generator" I
- have ever seen. Central to this performance are two assump-
- tions: that all files compiled by a single makefile will be
- compiled with roughly the same _\b-_\bI and _\b-_\bD options; and that
- most files in a single directory will include largely the
- same files.
-
- Given these assumptions, m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd expects to be called
- once for each makefile, with all source files that are main-
- tained by the makefile appearing on the command line. It
- parses each source and include file exactly once, maintain-
- ing an internal symbol table for each. Thus, the first file
- on the command line will take an amount of time proportional
- to the amount of time that a normal C preprocessor takes.
- But on subsequent files, if it encounter's an include file
- that it has already parsed, it does not parse it again.
-
- For example, imagine you are compiling two files, _\bf_\bi_\bl_\be_\b1_\b._\bc
- and _\bf_\bi_\bl_\be_\b2_\b._\bc_\b, they each include the header file _\bh_\be_\ba_\bd_\be_\br_\b._\bh_\b, and
-
-
-
-X Version 11 Last change: Release 6 3
-
-
-
-
-
-
-User Commands MAKEDEPEND(1)
-
-
-
- the file _\bh_\be_\ba_\bd_\be_\br_\b._\bh in turn includes the files _\bd_\be_\bf_\b1_\b._\bh and
- _\bd_\be_\bf_\b2_\b._\bh_\b. When you run the command
-
- makedepend file1.c file2.c
-
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd will parse _\bf_\bi_\bl_\be_\b1_\b._\bc and consequently, _\bh_\be_\ba_\bd_\be_\br_\b._\bh and
- then _\bd_\be_\bf_\b1_\b._\bh and _\bd_\be_\bf_\b2_\b._\bh_\b. It then decides that the dependen-
- cies for this file are
-
- file1.o: header.h def1.h def2.h
-
- But when the program parses _\bf_\bi_\bl_\be_\b2_\b._\bc and discovers that it,
- too, includes _\bh_\be_\ba_\bd_\be_\br_\b._\bh_\b, it does not parse the file, but sim-
- ply adds _\bh_\be_\ba_\bd_\be_\br_\b._\bh_\b, _\bd_\be_\bf_\b1_\b._\bh and _\bd_\be_\bf_\b2_\b._\bh to the list of depen-
- dencies for _\bf_\bi_\bl_\be_\b2_\b._\bo_\b.
-
-S\bSE\bEE\bE A\bAL\bLS\bSO\bO
- cc(1), make(1)
-
-B\bBU\bUG\bGS\bS
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd parses, but does not currently evaluate, the SVR4
- #predicate(token-list) preprocessor expression; such expres-
- sions are simply assumed to be true. This may cause the
- wrong _\b#_\bi_\bn_\bc_\bl_\bu_\bd_\be directives to be evaluated.
-
- Imagine you are parsing two files, say _\bf_\bi_\bl_\be_\b1_\b._\bc and _\bf_\bi_\bl_\be_\b2_\b._\bc_\b,
- each includes the file _\bd_\be_\bf_\b._\bh_\b. The list of files that _\bd_\be_\bf_\b._\bh
- includes might truly be different when _\bd_\be_\bf_\b._\bh is included by
- _\bf_\bi_\bl_\be_\b1_\b._\bc than when it is included by _\bf_\bi_\bl_\be_\b2_\b._\bc_\b. But once
- m\bma\bak\bke\bed\bde\bep\bpe\ben\bnd\bd arrives at a list of dependencies for a file, it
- is cast in concrete.
-
-A\bAU\bUT\bTH\bHO\bOR\bR
- Todd Brunhoff, Tektronix, Inc. and MIT Project Athena
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-X Version 11 Last change: Release 6 4
-
-
-
projects / feisty_meow.git / blobdiff