读书笔记之：GNU make中文手册

lyjinger读书笔记之：GNU make中文手册

原书信息：
名称：GNU make中文手册
版本：ver-3.8
作者：
译者：徐海兵

读书笔记：
make默认查找的文件名顺序为：“GNUmakefile”、“makefile”、“Makefile”

每一个命令行必须以[Tab]字符开始，[Tab]字符告诉make此行是一个命令行。make按照命令完成相应的动作。这也是书写Makefile中容易产生，而且比较隐蔽的错误
书写时，可以将一个较长行使用反斜线（/）来分解为多行，这样可以使我们的Makefile书写清晰、容易阅读理解。但需要注意：反斜线之后不能有空格（这也是大家最容易犯的错误，错误比较隐蔽）

make程序会把出现在第一条规则之后的所有以[Tab]字符开始的行都作为命令行来处理
Makefile中把那些没有任何依赖只有执行动作的目标称为“伪目标”（phony targets）

在Makefile中一个规则的目标如果不是“终极目标”所依赖的（或者“终极目标”的依赖文件所依赖的），那么这个规则将不会被执行
在实际工作中大家都比较认同的方法是，使用一个变量“objects”、“OBJECTS”、“objs”、“OBJS”、“obj”或者“OBJ”来作为所有的.o文件的列表的替代

对一个目标文件是“N.o”，倚赖文件是“N.c”的规则，完全可以省略其规则的命令行
显式规则、隐含规则、变量定义、指示符和注释

“include”指示符告诉make暂停读取当前的Makefile，而转去读取“include”指定的一个或者多个文件，完成以后再继续当前Makefile的读取

TARGETS : NORMAL-PREREQUISITES | ORDER-ONLY-PREREQUISITES
“~/bin”代表“/home/username/bin/”（当前用户宿主目录下的bin目录）
“~john/bin”就是代表用户john的宿主目录下的bin目录

自动化变量“$?”表示依赖文件列表中被改变过的所有文件
自动化变量“$<”代表规则的第一个依赖，“$@”代表规则的目标

变量定义中使用的通配符不会被通配处理,“objects = *.o”表示变量“objects”的值是字符串“*.o”
当需要变量“objects”代表所有.o文件列表示，需要使用函数“wildcard”（objects = $(wildcar *.o)）

$(wildcard PATTERN...) 在Makefile中，它被展开为已经存在的、使用空格分开的、匹配此模式的所有文件列表

通过变量“VPATH”可以指定依赖文件的搜索路径
VPATH = src:../headers 为所有规则的依赖指定了两个搜索目录，“src”和“../headers”
另一个设置文件搜索路径的方法是使用make的“vpath”关键字（全小写的）
vpath %.h ../headers 其含义是：Makefile中出现的.h文件；如果不能在当前目录下找到，则到目录“../headers”下寻找

.PHONY: clean
clean:
rm *.o temp

.PHONY: cleanall cleanobj cleandiff
cleanall : cleanobj cleandiff
rm program
cleanobj :
rm *.o
cleandiff :
rm *.diff

make存在一个内嵌隐含变量“RM”，它被定义为：“RM = rm –f”

Makefile的特殊目标：
.PHONY：
目标“.PHONY”的所有的依赖被作为伪目标。伪目标时这样一个目标：当使用make命令行指定此目标时，这个目标所在规则定义的命令、无论目标文件是否存在都会被无条件执行
.SUFFIXES:
特殊目标“SUFFIXES”的所有依赖指出了一系列在后缀规则中需要检查的后缀名（就是当前make需要处理的后缀）
.DEFAULT
一个文件作为某个规则的依赖，但却不是另外一个规则的目标时。Make程序无法找到重建此文件的规则，此种情况时就执行“.DEFAULT”所指定的命令
.PRECIOUS
目标“.PRECIOUS”的所有依赖文件在make过程中会被特殊处理：当命令在执行过程中被中断时，make不会删除它们。而且如果目标的依赖文件是中间过程文件，同样这些文件不会被删除。
另外，目标“.PRECIOUS”的依赖文件也可以是一个模式，例如“%.o”。这样可以保留有规则创建的中间过程文件。
.INTERMEDIATE
目标“.INTERMEDIATE”的依赖文件在make时被作为中间过程文件对待。没有任何依赖文件的目标“.INTERMEDIATE”没有意义。
.SECONDARY
.DELETE_ON_ERROR
.IGNORE
.LOW_RESOLUTION_TIME
.SILENT
.EXPORT_ALL_VARIABLES
.NOTPARALLEL

静态模式
TARGETS ...: TARGET-PATTERN: PREREQ-PATTERNS ...
COMMANDS
从目标模式（TAGET-PATTERN）的目标名字中抽取一部分字符串（称为“茎”）。使用“茎”替代依赖模式（PREREQ-PATTERNS）中的相应部分来产生对应目标的依赖文件
files = foo.elc bar.o lose.o
$(filter %.o,$(files)): %.o: %.c
$(CC) -c $(CFLAGS) $< -o $@
$(filter %.elc,$(files)): %.elc: %.el
emacs -f batch-byte-compile $<

变量赋值：
递归展开式变量 = 在引用的地方是严格的文本替换
直接展开式变量 := 以变量被定义后就是一个实际需要的文本串，其中不再包含任何变量的引用
条件赋值 ?= 只有此变量在之前没有赋值的情况下才会对这个变量进行赋值
追加变量值 +=

make的函数:
调用方式:$(FUNCTION ARGUMENTS)
文本处理函数
$(subst FROM,TO,TEXT)
字符串替换函数—subst:把字串“TEXT”中的“FROM”字符替换为“TO”。
$(subst ee,EE,feet on the street)

$(patsubst PATTERN,REPLACEMENT,TEXT)
模式替换函数—patsubst:搜索“TEXT”中以空格分开的单词，将符合模式“PATTERN”替换为“REPLACEMENT”。
$(patsubst %.c,%.o,x.c bar.c)
$(VAR:PATTERN=REPLACEMENT)相当于：
$(patsubst PATTERN,REPLACEMENT,$(VAR))
$(VAR:SUFFIX=REPLACEMENT) 等于：$(patsubst %SUFFIX,%REPLACEMENT,$(VAR))

$(strip STRINT)
去空格函数—strip:去掉字串（若干单词，使用若干空字符分割）“STRINT”开头和结尾的空字符，并将其中多个连续空字符合并为一个空字符。
STR = a b c
LOSTR = $(strip $(STR))

$(findstring FIND,IN)
查找字符串函数—findstring:搜索字串“IN”，查找“FIND”字串。
$(findstring a,a b c)

$(filter PATTERN…,TEXT)
过滤函数—filter:过滤掉字串“TEXT”中所有不符合模式“PATTERN”的单词，保留所有符合此模式的单词。
sources := foo.c bar.c baz.s ugh.h
foo: $(sources)
cc $(filter %.c %.s,$(sources)) -o foo

$(filter-out PATTERN...,TEXT)
反过滤函数—filter-out:过滤掉字串“TEXT”中所有符合模式“PATTERN”的单词，保留所有不符合此模式的单词。
objects=main1.o foo.o main2.o bar.o
mains=main1.o main2.o
$(filter-out $(mains),$(objects))

$(sort LIST)
排序函数—sort:给字串“LIST”中的单词以首字母为准进行排序（升序），并取掉重复的单词。
$(sort foo bar lose foo)

$(word N,TEXT)
取单词函数—word:取字串“TEXT”中第“N”个单词（“N”的值从1开始）。
$(word 2, foo bar baz)

$(wordlist S,E,TEXT)
取字串函数—wordlist:从字串“TEXT”中取出从“S”开始到“E”的单词串。
$(wordlist 2, 3, foo bar baz)

$(words TEXT)
统计单词数目函数—words:计算字串“TEXT”中单词的数目。
$(words, foo bar)

$(firstword NAMES…)
取首单词函数—firstword:取字串“NAMES…”中的第一个单词。
$(firstword foo bar)

文件名处理函数
$(dir NAMES…)
取目录函数—dir:从文件名序列“NAMES…”中取出各个文件名的目录部分。
$(dir src/foo.c hacks)

$(notdir NAMES…)
取文件名函数——notdir:从文件名序列“NAMES…”中取出非目录部分。
$(notdir src/foo.c hacks)

$(suffix NAMES…)
取后缀函数—suffix:从文件名序列“NAMES…”中取出各个文件名的后缀。
$(suffix src/foo.c src-1.0/bar.c hacks)

$(basename NAMES…)
取前缀函数—basename:从文件名序列“NAMES…”中取出各个文件名的前缀部分（点号之后的部分）。
$(basename src/foo.c src-1.0/bar.c /home/jack/.font.cache-1 hacks)

$(addsuffix SUFFIX,NAMES…)
加后缀函数—addsuffix:为“NAMES…”中的每一个文件名添加后缀“SUFFIX”
$(addsuffix .c,foo bar)

$(addprefix PREFIX,NAMES…)
加前缀函数—addprefix:为“NAMES…”中的每一个文件名添加前缀“PREFIX”
$(addprefix src/,foo bar)

$(join LIST1,LIST2)
单词连接函数——join:将字串“LIST1”和字串“LIST2”各单词进行对应连接。就是将“LIST2”中的第一个单词追加“LIST1”第一个单词字后合并为一个单词；将“LIST2”中的第二个单词追加到“LIST1”的第一个单词之后并合并为一个单词，……依次列推。
$(join a b c , .c .o)

$(wildcard PATTERN)
获取匹配模式文件名函数—wildcard:列出当前目录下所有符合模式“PATTERN”格式的文件名。
$(wildcard *.c)

foreach 函数
$(foreach VAR,LIST,TEXT)
dirs := a b c d
files := $(foreach dir,$(dirs),$(wildcard $(dir)/*))
等价于:
files := $(wildcard a/* b/* c/* d/*)

if 函数
$(if CONDITION,THEN-PART[,ELSE-PART])
SUBDIR += $(if $(SRC_DIR) $(SRC_DIR),/home/src)
函数的结果是：如果“SRC_DIR”变量值不为空，则将变量“SRC_DIR”指定的目录作为一个子目录；否则将目录“/home/src”作为一个子目录。

call函数
$(call VARIABLE,PARAM,PARAM,...)
reverse = $(2) $(1)
foo = $(call reverse,a,b) 变量“foo”的值为“ba”
pathsearch = $(firstword $(wildcard $(addsuffix /$(1),$(subst :, ,$(PATH)))))
LS := $(call pathsearch,ls) 变量“LS”的结果为“/bin/sh”

value函数
eval函数
origin函数

shell函数

自动化变量:
$@ 表示规则的目标文件名
$% 当规则的目标文件是一个静态库文件时，代表静态库的一个成员名
$< 规则的第一个依赖文件名
$? 所有比目标文件更新的依赖文件列表，空格分割
$^ 规则的所有依赖文件列表，使用空格分隔
$+ 类似“$^”，但是它保留了依赖文件中重复出现的文件。主要用在程序链接时库的交叉引用场合
$* 在模式规则和静态模式规则中，代表“茎”
$(@D) 表示目标文件的目录部分（不包括斜杠）
$(@F) 目标文件的完整文件名中除目录以外的部分（实际文件名）
$(*D)
$(*F) 分别代表目标“茎”中的目录部分和文件名部分
$(%D)
$(%F) 当以如“archive(member)”形式静态库为目标时，分别表示库文件成员“member”名中的目录部分和文件名部分。它仅对这种形式的规则目标有效
$(<D)
$(<F) 分别表示规则中第一个依赖文件的目录部分和文件名部分
$(^D)
$(^F) 分别表示所有依赖文件的目录部分和文件部分（不存在同一文件）
$(+D)
$(+F) 分别表示所有依赖文件的目录部分和文件部分（可存在重复文件）
$(?D)
$(?F) 分别表示被更新的依赖文件的目录部分和文件名部分