gmake.txt

gnu make 的使用说明

1.7 另一种风格 
　　如果makefile 中的目标都是以隐含规则生成，可以将规则按照依赖关系分组： 
　　---------------------------------------------------------------------------- 
　　objects = main.o kbd.o command.o display.o insert.o search.o files.o utils.o 

　　edit : $(objects) 
　　 cc -o edit $(objects) 
　　$(objects) : defs.h 
　　kbd.o command.o files.o : command.h 
　　display.o insert.o search.o files.o : buffer.h 
　　---------------------------------------------------------------------------- 

　　这里"defs.h"作为所有目标文件的依赖。这种风格是好是坏取决于个人喜好，它非常紧凑，但是将每个目标的依赖信息放在一起看起来更清楚一些。 

1.8 清理 
　　编写规则不至于编译程序。Makefile 通常描述如何做其它事情：比如删除目录中的目标文件和可执行文件来清理目录。例子中是这样写的： 
　　clean: 
rm edit $(objects) 
　　实际情况是，我们需要处理一些意外事件：存在一个叫做"clean"的文件；如果rm 出错，并不希望make 过程停止下来，修改过的版本如下： 
　　.PHONY : clean 
　　clean : 
rm edit $(objects) 

　　这样的规则当然不能放在makefile 的开始，因为这并不是我们缺省要做的工作。由于"clean"并不是"edit"的依赖，在运行make 时没有参数时，这条规则不会执行；要执行这个规则，必须运行"make clean"。 

Makefile 
　 Makefile 中包含五种内容：显式规则，隐式规则，变量定义，指令（directive）和注释。 

　 显式规则描述如何生成规则的目标，它列出了目标依赖的文件，指定了产生或更新目标的命令 
　 隐式规则描述如何生成基于文件名的一类文件，说明目标可能依赖于和其文件名类似的文件，指定了相应的命令。 
　 指令类似与编译器的伪指令，包含：指示make 读入另一个makefile;决定是否忽略makefile 中的一部分;定义一个变量;一行中‘#"开始是注释，直到行末，除非遇到续行符号。在"define"和命令中不能有注释，其它情况下注释可出现在任何地方。 

2.1 makefile 名字 
　 缺省情况下，make 以下列名字查找makefile："GNUmakefile"，"makefile" 和 "Makefile"（注意大小写）。通常你的makefile 应叫做"makefile"或"Makefile"。"GNUmakefile"不推荐，除非你的makefile 是为GNU 的make 定制的，其它的make 不认为该名字是一个makefile 的名字。如果你使用非标准命名的makefile，必须用命令开关"-f" 或 "-file"。参数 "-f NAME" 或 "--file NAME"告诉make 读入NAME 作为makefile。如果使用多个该开关，所有的文件将按顺序连接起来。如果使用该选项，标准的makefile 名字不会自动检测。 

2.2 包含 
　　"include"指令告诉make 暂停处理余下的内容，读入其它makefile。语法如下： 
　　include FILENAMES 
　　这一行起始可以有空格，但TAB 字符不允许。如果文件名包含变量或函数，这些将被扩展。 

2.3‘MAKEFILE"变量 
　　如果环境变量"MAKEFILE"已定义，make 认为它的值是一系列空格隔开的文件名，这些文件在处理其它makefile 前被make 程序读入。这类似于include 指令；这些文件中的目标不会影响缺省目标，而且如果文件未找到的话，make 并不认为是错误。这个变量的主要用途是递归引用make 程序时通讯。 

2.4 如何重新生成makefile 
　　有时候makefile 是从其它文件生成的，比如RCS 或SCCS 文件。如果makefile 是由其它文件生成的，需要make读入最新版本的makefile。 
　　在读入所有makefile 之后，make 认为每个makefile 是一个目标，试图去更新它；如果makefile 中有一条如何更新它的规则，或者有适用的隐式规则，需要的更新会进行。所有的makefile 检查完之后，如果有的改变了，make 重新开始再读入（make 会试图再做更新，但通常不会再改变了，因为已经是最新的了）。 

　　如果一个文件使用双冒号规则，提供了命令但没有依赖关系，文件始终会被更新。在makefile 的情况下，如果makefile 双冒号规则，提供了命令但没有依赖关系，这样makefile 始终会重新生成，这会导致循环：make 只是在不断更新makefile，却不干活。为避免这种情况，make 不会重新生成那些只有命令没有依赖关系的双冒号规则的makefile。 

　　如果没有使用"-f"或"--file"选项，make 会尝试缺省的makefile 文件名。和指明"-f"或"--file"选项不同，make 不能确定这些文件是否应当存在。然而，如果缺省makefile 不存在但可以通过运行make 规则生成，你可能希望这些规则被运行使得makefile 可以使用。 

　　因此，如果没有缺省makefile，make 试图按照makefile 名查找的顺序生成它，直到成功或名字用完。注意如果make 不能找到或生成makefile，这并不是错误；makefile 不总是必需的。 

　　当使用"-t"或"--touch"选项时，不希望使用过时的makefile 来决定那个目标来touch。所以"-t"选项对makefile 更新不起作用；类似"-q"（or ‘-question"）和"-n"（or "-just-print"）不阻止makefile 的更新，因为过时的makefile 会产生错误的输出。这样"make -f mfile -n foo"会更新"mfile"，读入它，打印出更新"foo"需要执行的命令但不运行这些命令。与"foo"有关的命令是更新过的"mfile"中的内容。 

　　但是有时不希望更新makefile，可以将makefile 作为命令行的目标，当makefile被显式指定为目标时，"-t"选项也适用于它们。 
　　这样"make -f mfile -n mfile foo"会读入"mfile"，打印出更新执行的命令，"foo"的命令是当前的"mfile"中的内容。 

2.5 重载makefile 

　　可以使用"include"指令来包含其它makefile，增加目标的变量定义。然而，make 不允许同一个目标有不同的命令，有其它的途径可以达到目的。 
　　假设有"makefile" 和"mfile"，"makfile"要包含"mfile"，但都有对于目标"foo"的规则。这是可以在"makefile"中写一条匹配任意模式的规则，指明当make 在"makefile"中未找到目标时，搜索"mfile"： 
　　foo: 
frobnicate > foo 
　　%: force 
　 @$(MAKE) -f mfile $@ 
　　force: ; 

　　当执行"make foo"时，make 找到"makefile"，执行命令" frobnicate > foo"；执行"make bar"时，在"makefile"中未找到相应的规则，这时模式规则适用，执行命令"make -f mfile bar"，"makefile"中未提及的其它目标也是类似的。 
　　 
　　这种方法之所有工作是因为模式规则的模式是"%"，可以匹配任何的目标；这条规则的依赖是"force"，保证即使目标存在命令也会执行；"force"规则的命令为空防止"make"为其搜索隐式规则－这样会导致依赖循环。 

3 规则 
　　makefile 中的规则描述如何生成特定的文件，即规则的目标。规则列出了目标的依赖文件，指定生成或更新目标的命令。规则的次序是不重要的，除非是确定缺省目标：缺省目标是第一个makefile 中的第一个规则；如果第一个规则有多个目标，第一个目标是缺省的。有两个例外：以"."开头的目标不是缺省目标；模式规则对缺省目标没有影响。 
　　通常我们所写的第一个规则是编译整个或makefile 中指定的所有程序。 

3.1 例子 
　　foo.o : foo.c defs.h　　　　　 # module for twiddling the frobs 
cc -c -g foo.c 
　　它的目标是"foo.o"，依赖于"foo.c"和"defs.h"，有一个命令"cc -c -g foo.c"。命令行以TAB 字符开始标识它是一个命令。 
这条规则说明两件事：如何决定"foo.o"是旧的：如果它不存在，或者"foo.c"或者"defs.h"比它新。如何更新"foo.o"文件：通过运行"cc"程序。命令未提及"defs.h"，但可以猜想"foo.c"包含了它，这是"defs.h"被置于依赖关系中的理由。 

3.2 规则的语法 
　 语法如下： 
　 TARGETS : DEPENDENCIES 
　 COMMAND 
　 ... 
　 或者 
　 TARGETS : DEPENDENCIES ; COMMAND 
　 COMMAND 
　 ... 

　 TARGETS 是以空格隔开的文件名，统配符可以使用。通常一个规则只有一个目标，偶尔也有多个。命令行以TAB 键开始。第一条命令可在依赖关系的下一行；或者在同一行，在分号后面；两种方式效果相同。 

　 因为"$"符号被用做变量引用，如果要在规则中使用"$"符号，必须写两个："$$"。可以用"\"符号来分割一个长行，这不是必须的，因为make 对行的长度没有限制。 

3.3 通配符 
　　规则中的文件名可以包含统配符，如"*"，"?"。 文件名前的字符"~"有特殊的含义。单独使用，或跟随一个"/"，代表用户的 
home 目录，比如"~/bin"扩展为/home/you/bin"；如果"~"跟随一个单词，表示单词指示的那个用户的home 目录，如"~john/bin"扩展为"/home/john/bin"。通配符在目标，依赖关系，命令中自动扩展，其它情况下，统配符的扩展除非显式使用"wildcard"函数。通配符的特殊意义可以使用"\"符号关闭。 
　　例子： 
　　clean: 
　　rm -f *.o 
　　和 
　　print: *.c 
　　lpr -p $? 
　　touch print 
　　通配符在定义变量时并不扩展，例如：objects = *.o 则objects 的值是字符串"*.o"；但是如果你将objects 用于目标，依赖或命令中，扩展会进行。要将objects 设置成扩展过的内容，使用：objects := $(wildcard *.o) 

3.3.1 通配符的缺陷 
　　这是一个使用通配符的例子，但结果不是你所期望的。假设可执行文件"foo" 是从当前目录中的所有".o"文件生成的： 
　　objects = *.o 
　　 foo : $(objects) 
　　 cc -o foo $(CFLAGS) $(objects) 
　　objects 变量的值是字符串"*.o"。通配符扩展在规则"foo"中进行，于是所有存在的".o"文件成为"foo"的依赖而且在需要时重新编译。 
但如果删除了所有的".o"文件呢？当通配符不匹配任何文件时，一切都保持原样：则"foo"依赖于一个叫做"*.o"的文件；由于这个文件不大可能存在，"make"程序会报告一个无法生成"*.o"文件的错误，这不是期待的结果。实际上可以用通配符获得期望结果，但是需要复杂的技术，包括"wildcard"函数和字符串替换函数。 

3.3.2wildcard 函数 
　　通配符自动在规则中进行。但是在变量赋值的和函数的参数中通配符不会扩展，如果在这些情况下需要通配符扩展，必须使用"wildcard"函数。语法如下：$(wildcard PATTERN...) 
　　这个在makefile 任何地方出现的字符串，会被匹配任何一个文件名格式的以空格隔开的现有文件列表替换。如果没有任何文件匹配一个模式，这个模式从"wildcard"的输出中忽略，注意，这和上述的通配符的处理是不一样的。"wildcard"函数的一个功能是找出目录中所有的".c"文件：$(wildcard *.c)，可以通过替换后缀".c"为".o"从C 文件列表得到目标文件的列表： 
　　$(patsubst %.c,%.o,$(wildcard *.c)) 
　　这样，上节中的makefile 改写为： 
　　objects := $(patsubst %.c,%.o,$(wildcard *.c)) 
　　foo : $(objects) 
　　 cc -o foo $(objects) 
　　这个makefile 利用了编译C 程序的隐含规则，所以不需要对编译写出显式的规则。（":="是"="的一个变体） 
　　注意："PATTERN"是大小写敏感的。 

3.4 目录搜索 
　　对于大的系统，通常将源文件和目标文件放在不同的目录中。目录搜索功能可以让make 自动在多个目录中搜寻依赖文件，当你将文件重新分布是，不需要改变规则，更改搜索路径即可。 

3.4.1‘VPATH" 
　　make 变量"VPATH"列出make 应当搜索的目录列表。很多情况下，当前目录不包含依赖文件，"VPATH"描述一个对所有文件的搜索列表，包含那些是规则的目标的文件。如果一个目标或者依赖文件在当前目录没找到的话，"make"在"VPATH"中列出的目录中查找同名的文件。如果找到的话，那个文件成为依赖文件；规则可以象这些文件在当前目录中一样来使用他们。 
　　"VPATH"变量中，目录名以冒号或空格隔开；目录列出的顺序决定make查找的顺序。（注：在pSOSystem 2.5 移植到Win32 的GNU make 目录名必须使用分号隔开，以下均简称Win32 GNU make）。举例说明： 
　　VPATH = src:../headers 则规则 
　　foo.o : foo.c 
　　被解释为 
　　foo.o : src/foo.c 
　　假设"foo.c"在当前目录不存在，在"src"目录中可以找到。 

3.4.2 选择性搜索